RT-Thread(RTT)之SPI设备使用(以驱动nrf24l01模块为例)

2023-12-28 20:02:52

前言

本文目的,了解SPI和如何使用RT-Thread的SPI设备,通过SPI向nrf24l01模块中的寄存器写数据,再把数据读出来,验证数据是否一致,以验证SPI设备配置正确,是否能够正常使用


一、SPI简介

1、SPI是Serial Peripherl Interface的缩写,中文意思是串行外围设备接口

2、SPI主要应用于EEPROM、FLASH、实时时钟、AD转换器,数字信号处理器、数字信号解码器
在这里插入图片描述

3、SPI采用主从工作方式,总线上有一个主设备多个从设备
在这里插入图片描述
4、SPI传输数据时需要最多四根信号线分别是:
串行时钟信号SCLK由主设备产生发送给从设备;
MOSI主出从入引脚,主设备输出数据从设备接收数据;
MISO主入从出引脚,主设备接收数据从设备输出数据;
CS片选信号,由主设备输出的使能信号,用来选择与主设备通信的从设备
在这里插入图片描述

5、SPI总线有四种工作方式,取决于时钟极性CPOL和时钟相位CPHA

  • CPOL定义了SCLK空闲时的状态电平

在这里插入图片描述

  • CPHA定义了数据采集边沿

在这里插入图片描述

  • 因此SPI通信有四种不同的工作模式,由时钟极性CPOL和时钟相位CPHA的组合决定

在这里插入图片描述

  • 模式0:当CPOL=0CPHA=0时,空闲时时钟为低电平,第一个时钟沿采样,因此模式0是在时钟上升沿进行采样

在这里插入图片描述

  • 模式1:当CPOL=0CPHA=1时,空闲时时钟为低电平,第二个时钟沿采样,因此模式1是在时钟下降沿进行采样

在这里插入图片描述

  • 模式2:当CPOL=1CPHA=0时,空闲时时钟为高电平,第一个时钟沿采样,因此模式2是在时钟下降沿采样

在这里插入图片描述

  • 模式3:当CPOL=1CPHA=1时,空闲时钟为高电平,第二个时钟沿采样,因此模式3是在时钟上升沿采样

在这里插入图片描述

  • 在使用到SPI通信时,在确定CPOL和CPHA时,要以数据手册中的时序图为准,举个例子,下图是彩色OLED控制器SSD1351数据手册中关于SPI通信的时序图描述,可以看到手册中规定了时钟上升沿采样,所以我们配置SPI工作方式时只能选择模式0模式3

在这里插入图片描述

6、SPI通信的优点缺点

在这里插入图片描述

二、通过SPI向NRF24L01模块写数据再读出来,验证数据是否一致

1、创建一个工程

在这里插入图片描述

2、在board.h中打开SPI的注释,使用SPI几需要查看你自己板子上的硬件连接图

在这里插入图片描述

3、在RT-Thread Settings中打开SPI驱动程序使能

在这里插入图片描述

4、打开SPI模块使能注释

在这里插入图片描述

5、打开CubeMX进行配置

在这里插入图片描述

6、使用外部高速晶振作为时钟源

在这里插入图片描述

7、配置一下时钟线,频率直接拉满

在这里插入图片描述

8、配置调试接口

在这里插入图片描述

9、打开串口一,因为在创建工程的使用默认使用了串口一,所以这里也配置一下

在这里插入图片描述

10、配置SPI,二线全双工主模式

在这里插入图片描述

11、SPI参数配置

在这里插入图片描述

12、生成代码

在这里插入图片描述

13、点击Close

在这里插入图片描述

14、关掉CubeMX

在这里插入图片描述

15、点击确定

在这里插入图片描述

16、复制CubeMX自动生成的HAL_SPI_MspInit这段代码

在这里插入图片描述

17、粘贴到board.c的末尾

在这里插入图片描述

18、复制CubeMX自动生成的MX_SPI2_Init这段代码

在这里插入图片描述

19、粘贴到board.c的末尾,记得把static关键字去掉

在这里插入图片描述

20、编译一下,有如下报错

在这里插入图片描述

21、回到cubemx文件夹下的main.c文件中复制spi2句柄

在这里插入图片描述

22、粘贴到board.c文件的前面,并加上extern关键字

在这里插入图片描述

23、再编译一下,报错说函数重定义

在这里插入图片描述

24、双击错误,跳转进去后在cubemx文件夹下刚刚CubeMX自动生成的HAL_SPI_Msp_Init函数注释掉

在这里插入图片描述

25、再编译,无报错

在这里插入图片描述

26、在man.c主函数中输入如下代码

/*
 * Copyright (c) 2006-2023, RT-Thread Development Team
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Change Logs:
 * Date           Author       Notes
 * 2023-12-21     RT-Thread    first version
 */

#include <rtthread.h>
#include <rtdevice.h>
#include <drv_common.h>
#include <board.h>
#include "drv_spi.h"

//NRF24L01寄存器操作命令
#define SPI_READ_REG    0x00  //读配置寄存器,低5位为寄存器地址
#define SPI_WRITE_REG   0x20  //写配置寄存器,低5位为寄存器地址
#define R_RX_PL_WID     0x60
#define RD_RX_PLOAD     0x61  //读RX有效数据,1~32字节
#define WR_TX_PLOAD     0xA0  //写TX有效数据,1~32字节
#define FLUSH_TX        0xE1  //清除TX FIFO寄存器.发射模式下用
#define FLUSH_RX        0xE2  //清除RX FIFO寄存器.接收模式下用
#define REUSE_TX_PL     0xE3  //重新使用上一包数据,CE为高,数据包被不断发送.
#define NOP             0xFF  //空操作,可以用来读状态寄存器
//SPI(NRF24L01)寄存器地址
#define NCONFIG          0x00  //配置寄存器地址;bit0:1接收模式,0发射模式;bit1:电选择;bit2:CRC模式;bit3:CRC使能;
                              //bit4:中断MAX_RT(达到最大重发次数中断)使能;bit5:中断TX_DS使能;bit6:中断RX_DR使能
#define EN_AA           0x01  //使能自动应答功能  bit0~5,对应通道0~5
#define EN_RXADDR       0x02  //接收地址允许,bit0~5,对应通道0~5
#define SETUP_AW        0x03  //设置地址宽度(所有数据通道):bit1,0:00,3字节;01,4字节;02,5字节;
#define SETUP_RETR      0x04  //建立自动重发;bit3:0,自动重发计数器;bit7:4,自动重发延时 250*x+86us
#define RF_CH           0x05  //RF通道,bit6:0,工作通道频率;
#define RF_SETUP        0x06  //RF寄存器;bit3:传输速率(0:1Mbps,1:2Mbps);bit2:1,发射功率;bit0:低噪声放大器增益
#define STATUS          0x07  //状态寄存器;bit0:TX FIFO满标志;bit3:1,接收数据通道号(最大:6);bit4,达到最多次重发
                              //bit5:数据发送完成中断;bit6:接收数据中断;
#define MAX_TX          0x10  //达到最大发送次数中断
#define TX_OK           0x20  //TX发送完成中断
#define RX_OK           0x40  //接收到数据中断

#define OBSERVE_TX      0x08  //发送检测寄存器,bit7:4,数据包丢失计数器;bit3:0,重发计数器
#define CD              0x09  //载波检测寄存器,bit0,载波检测;
#define RX_ADDR_P0      0x0A  //数据通道0接收地址,最大长度5个字节,低字节在前
#define RX_ADDR_P1      0x0B  //数据通道1接收地址,最大长度5个字节,低字节在前
#define RX_ADDR_P2      0x0C  //数据通道2接收地址,最低字节可设置,高字节,必须同RX_ADDR_P1[39:8]相等;
#define RX_ADDR_P3      0x0D  //数据通道3接收地址,最低字节可设置,高字节,必须同RX_ADDR_P1[39:8]相等;
#define RX_ADDR_P4      0x0E  //数据通道4接收地址,最低字节可设置,高字节,必须同RX_ADDR_P1[39:8]相等;
#define RX_ADDR_P5      0x0F  //数据通道5接收地址,最低字节可设置,高字节,必须同RX_ADDR_P1[39:8]相等;
#define TX_ADDR         0x10  //发送地址(低字节在前),ShockBurstTM模式下,RX_ADDR_P0与此地址相等
#define RX_PW_P0        0x11  //接收数据通道0有效数据宽度(1~32字节),设置为0则非法
#define RX_PW_P1        0x12  //接收数据通道1有效数据宽度(1~32字节),设置为0则非法
#define RX_PW_P2        0x13  //接收数据通道2有效数据宽度(1~32字节),设置为0则非法
#define RX_PW_P3        0x14  //接收数据通道3有效数据宽度(1~32字节),设置为0则非法
#define RX_PW_P4        0x15  //接收数据通道4有效数据宽度(1~32字节),设置为0则非法
#define RX_PW_P5        0x16  //接收数据通道5有效数据宽度(1~32字节),设置为0则非法
#define FIFO_STATUS     0x17  //FIFO状态寄存器;bit0,RX FIFO寄存器空标志;bit1,RX FIFO满标志;bit2,3,保留
                              //bit4,TX FIFO空标志;bit5,TX FIFO满标志;bit6,1,循环发送上一数据包.0,不循环;

//配对密码
const uint8_t TX_ADDRESS[]= {0xAA,0xBB,0xCC,0x00,0x01}; //本地地址
const uint8_t RX_ADDRESS[]= {0xAA,0xBB,0xCC,0x00,0x01}; //接收地址RX_ADDR_P0 == RX_ADDR

//NRF24L01发送接收数据宽度定义
#define TX_ADR_WIDTH    5                               //5字节的地址宽度
#define RX_ADR_WIDTH    5                               //5字节的地址宽度
#define TX_PLOAD_WIDTH  32                              //20字节的用户数据宽度
#define RX_PLOAD_WIDTH  32                              //20字节的用户数据宽度


#define NRF24L01_CSN_PIN GET_PIN(B,12)  //片选引脚
#define NRF24L01_CE_PIN GET_PIN(A,11)   //激活RX或TX模式
#define NRF24L01_IRQ_PIN GET_PIN(A,12)  //中断信号引脚,低电平有效


//24L01操作线
#define Set_NRF24L01_CSN    rt_pin_write(NRF24L01_CSN_PIN,PIN_HIGH)      //拉高CSN
#define Clr_NRF24L01_CSN    rt_pin_write(NRF24L01_CSN_PIN,PIN_LOW)      // 拉低CSN
#define Set_NRF24L01_CE     rt_pin_write(NRF24L01_CE_PIN,PIN_HIGH)  // 拉高CE
#define Clr_NRF24L01_CE     rt_pin_write(NRF24L01_CE_PIN,PIN_LOW)   // 拉低CE
#define READ_NRF24L01_IRQ   rt_pin_read(NRF24L01_IRQ_PIN)                          //读中断引脚

#define NRF24L01_SPI_BUS "spi2"     //spi2总线
#define NRF24L01_SPI_DEV_NAME "spi20"        //总线上的设备名,0号设备
static struct rt_spi_device *spi_dev_nrf24l01;    //spi设备句柄

//nrf204l01模块初始化
static void nrf24ll01_spi_init(void)
{
    //将spi设备挂载到总线
       rt_hw_spi_device_attach(NRF24L01_SPI_BUS,NRF24L01_SPI_DEV_NAME,GPIOB,GPIO_PIN_12);
    /* 查找 spi 设备获取设备句柄 */
    spi_dev_nrf24l01 = (struct rt_spi_device *)rt_device_find(NRF24L01_SPI_DEV_NAME);
    //配置spi参数
    struct rt_spi_configuration cfg;
    cfg.data_width = 8;//数据宽度为八位
    cfg.mode = RT_SPI_MASTER | RT_SPI_MODE_0 | RT_SPI_MSB;
    cfg.max_hz = 5*1000*1000;            //最大波特率,因为在cubemx配置分频后,spi2的波特率是4.5M,所以这里最大就写5了
    rt_spi_configure(spi_dev_nrf24l01, &cfg);


}

//初始化24L01的IO口
static void NRF24L01_Configuration(void)
{
    rt_pin_mode(NRF24L01_CE_PIN,PIN_MODE_OUTPUT);
    rt_pin_mode(NRF24L01_IRQ_PIN,PIN_MODE_INPUT_PULLUP);//中断引脚上拉输入
    rt_pin_mode(NRF24L01_CSN_PIN,PIN_MODE_OUTPUT);     //片选引脚推挽输出

    Set_NRF24L01_CE;                                    //初始化时先拉高
    Set_NRF24L01_CSN;                                   //初始化时先拉高

    nrf24ll01_spi_init();         //配置spi

    Clr_NRF24L01_CE;                                    //使能24L01
    Set_NRF24L01_CSN;                                   //SPI片选取消

}

//通过SPI写寄存器
rt_uint8_t NRF24L01_Write_Reg(rt_uint8_t regaddr,rt_uint8_t data)
{
    rt_uint8_t status;

    status = rt_spi_send_then_send(spi_dev_nrf24l01,&regaddr,1,&data,1);

    return(status);                      //返回状态值

}


//在指定位置写指定长度的数据
//*pBuf:数据指针
rt_uint8_t NRF24L01_Write_Buf(rt_uint8_t regaddr, rt_uint8_t *pBuf, rt_uint8_t datalen)
{
    rt_uint8_t status;

    status = rt_spi_send_then_send(spi_dev_nrf24l01,&regaddr,1,pBuf,datalen);
    return status;                        //返回读到的状态值
}


//在指定位置读出指定长度的数据
//*pBuf:数据指针
//返回值,此次读到的状态寄存器值
rt_uint8_t NRF24L01_Read_Buf(rt_uint8_t regaddr,rt_uint8_t *pBuf,rt_uint8_t datalen)
{
    rt_uint8_t status;
    status = rt_spi_send_then_recv(spi_dev_nrf24l01,&regaddr,1,pBuf,datalen);

    return status;                        //返回读到的状态值

}

//上电检测NRF24L01是否在位
//写5个数据然后再读回来进行比较,
//相同时返回值:0,表示在位;否则返回1,表示不在位
rt_uint8_t NRF24L01_Check(void)
{
    rt_uint8_t buf[5]={0XA5,0XA5,0XA5,0XA5,0XA5};
    rt_uint8_t buf1[5];
    rt_uint8_t i;
    NRF24L01_Write_Buf(SPI_WRITE_REG+TX_ADDR,buf,5);//写入5个字节的地址.
    NRF24L01_Read_Buf(TX_ADDR,buf1,5);              //读出写入的地址
    for(i=0;i<5;i++)if(buf1[i]!=0XA5)break;
    if(i!=5)return 1;                               //NRF24L01不在位
    return 0;                                           //NRF24L01在位
}
void ANO_NRF_Init(rt_uint8_t model, rt_uint8_t ch)
{
    rt_uint8_t a = 0x50;
    rt_uint8_t b = 0x73;

    Clr_NRF24L01_CE;

    NRF24L01_Write_Buf(SPI_WRITE_REG+RX_ADDR_P0,(rt_uint8_t*)RX_ADDRESS,RX_ADR_WIDTH);  //写RX节点地址
    NRF24L01_Write_Buf(SPI_WRITE_REG+TX_ADDR,(rt_uint8_t*)TX_ADDRESS,TX_ADR_WIDTH);         //写TX节点地址
    NRF24L01_Write_Reg(SPI_WRITE_REG+EN_AA,0x01);                                          //使能通道0的自动应答
    NRF24L01_Write_Reg(SPI_WRITE_REG+EN_RXADDR,0x01);                                   //使能通道0的接收地址
    NRF24L01_Write_Reg(SPI_WRITE_REG+SETUP_RETR,0x1a);                                //设置自动重发间隔时间:500us;最大自动重发次数:10次 2M波特率下
    NRF24L01_Write_Reg(SPI_WRITE_REG+RF_CH,ch);                                        //设置RF通道为CHANAL
    NRF24L01_Write_Reg(SPI_WRITE_REG+RF_SETUP,0x0f);                                   //设置TX发射参数,0db增益,2Mbps,低噪声增益开启

    if(model==1)                //RX
    {
        NRF24L01_Write_Reg(SPI_WRITE_REG+RX_PW_P0,RX_PLOAD_WIDTH);                              //选择通道0的有效数据宽度
        NRF24L01_Write_Reg(SPI_WRITE_REG + NCONFIG, 0x0f);                                      // IRQ收发完成中断开启,16位CRC,主接收
    }
    else if(model==3)       //RX2
    {
        NRF24L01_Write_Reg(FLUSH_TX,0xff);
        NRF24L01_Write_Reg(FLUSH_RX,0xff);
        NRF24L01_Write_Reg(SPI_WRITE_REG + NCONFIG, 0x0f);                                          // IRQ收发完成中断开启,16位CRC,主接收

        rt_spi_send(spi_dev_nrf24l01,&(a),1);
        rt_spi_send(spi_dev_nrf24l01,&(b),1);

        NRF24L01_Write_Reg(SPI_WRITE_REG+0x1c,0x01);
        NRF24L01_Write_Reg(SPI_WRITE_REG+0x1d,0x06);
    }

    Set_NRF24L01_CE;

}

int main(void)
{

    NRF24L01_Configuration();     //初始化io口,配置spi

    //进行nrf24l01在位检测
    do
      {
          ANO_NRF_Init(3,0);
      }while(NRF24L01_Check());

   //检测通过后,串口循环打印ok
    while(1)
    {
         rt_kprintf("ok\n");
         rt_thread_mdelay(500);

    }

    return RT_EOK;
}

27、对代码进行一些解释,在主函数里调用NRF24L01_Check()进行模块的在位检测,检测成功后,才能通过do-while循环,进入输出ok的循环,所以如果能够成功输出ok的话,说明SPI配置没问题,能够成功通信

在这里插入图片描述

28、这是在位检测的代码,就是通过SPI向nrf24l01模块中的特定寄存器输入5个一样的值,然后再通过SPI从该寄存器中读出这五个值,如果输入的值和读出的值都一样,说明咱的SPI发送跟接收都没问题

在这里插入图片描述

29、还值得一提的是,通过SPI发送数据时,咱调用的是rt_spi_send_then_send()这个RTT官方提供的库函数,这是连续两次发送数据,本函数适合向 SPI 设备中写入一块数据,第一次先发送命令和地址等数据,第二次再发送指定长度的数据。之所以分两次发送而不是合并成一个数据块发送,或调用两次 rt_spi_send(),是因为在大部分的数据写操作中,都需要先发命令和地址,长度一般只有几个字节。如果与后面的数据合并在一起发送,将需要进行内存空间申请和大量的数据搬运。而如果调用两次 rt_spi_send(),那么在发送完命令和地址后,片选会被释放,大部分 SPI 设备都依靠设置片选一次有效为命令的起始,所以片选在发送完命令或地址数据后被释放,则此次操作被丢弃。

在这里插入图片描述

30、读取数据时,咱调用的是rt_spi_send_then_recv()这个RTT官方库函数

rt_err_t rt_spi_send_then_recv(struct rt_spi_device *device,
                               const void           *send_buf,
                               rt_size_t             send_length,
                               void                 *recv_buf,
                               rt_size_t             recv_length);

此函数发送第一条数据时开始片选,此时忽略接收到的数据,然后发送第二条数据,此时主设备会发送数据 0XFF,接收到的数据保存在 recv_buf 里,函数返回时释放片选。
本函数适合从 SPI 从设备中读取一块数据,第一次会先发送一些命令和地址数据,然后再接收指定长度的数据
在这里插入图片描述

31、编译下载后,查看串口,能够成功输出ok,说明spi配置正确,能够跟设备进行正常通讯

在这里插入图片描述

文章来源:https://blog.csdn.net/qq_52251819/article/details/135127665
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。