NRF24L01
一、代码编写
1.nrf24l01.c
#include "nrf24l01.h"
#include "spi.h"
#include "oled.h"
#include "delay.h"
uint8_t TX_ADDRESS[TX_ADR_WIDTH]={0x34,0x43,0x10,0x10,0x01}; //发送地址
uint8_t RX_ADDRESS[RX_ADR_WIDTH]={0x34,0x43,0x10,0x10,0x01}; //发送地址
void SPINRF24L01_Select(void) //选中NRF24L01
{
NRF24L01_CSN_ON;
}
void SPINRF24L01_DeSelect(void) //取消选中NRF24L01
{
NRF24L01_CSN_DOWN;
}
/*SPIx 读写一个字节
TxData:要写入的字节
返回值:读取到的字节*/
static uint8_t SPIx_WriteReadByte(SPI_HandleTypeDef* hspi,uint8_t TxData)
{
uint8_t RxData = 0;
if( HAL_SPI_TransmitReceive(hspi,&TxData,&RxData,1,1000) != HAL_OK)
{
RxData = 0xFF;
}
return RxData;
}
/*SPI写寄存器
reg:指定寄存器地址
value:写入的值*/
static uint8_t NRF24L01_Write_Reg(uint8_t reg,uint8_t value)
{
uint8_t status;
SPINRF24L01_Select(); //使能SPI传输
status =SPIx_WriteReadByte(&hspi2,reg);//发送寄存器号
SPIx_WriteReadByte(&hspi2,value); //写入寄存器值
SPINRF24L01_DeSelect(); //禁止SPI传输
return status; //返回状态值
}
/*读取SPI寄存器值
reg:要读的寄存器*/
static uint8_t NRF24L01_Read_Reg(uint8_t reg)
{
uint8_t reg_val;
SPINRF24L01_Select(); //使能SPI传输
SPIx_WriteReadByte(&hspi2,reg); //发送寄存器号
reg_val=SPIx_WriteReadByte(&hspi2,NOP);//读取寄存器内容
SPINRF24L01_DeSelect(); //禁止SPI传输
return reg_val; //返回状态值
}
/*在指定位置写指定长度的数据
reg:寄存器(位置)
*pBuf:数据指针
len:数据长度
返回值,此次读到的状态寄存器值*/
static uint8_t NRF24L01_Write_Buf(uint8_t reg, uint8_t *pBuf, uint8_t len)
{
uint8_t status,u8_ctr;
SPINRF24L01_Select(); //使能SPI传输
status = SPIx_WriteReadByte(&hspi2,reg);//发送寄存器号,并返回
for(u8_ctr = 0;u8_ctr<len;u8_ctr++)
{
SPIx_WriteReadByte(&hspi2,*pBuf++);
}
SPINRF24L01_DeSelect(); //关闭SPI传输
return status; //返回寄存器号
}
/*在指定位置读出指定长度的数据
reg:寄存器(位置)
*pBuf:数据指针
len:数据长度
返回值,此次读到的状态寄存器值*/
static uint8_t NRF24L01_Read_Buf(uint8_t reg,uint8_t *pBuf,uint8_t len)
{
uint8_t status,u8_ctr;
SPINRF24L01_Select(); //使能SPI传输
status=SPIx_WriteReadByte(&hspi2,reg);//发送寄存器值(位置),并读取状态值
for(u8_ctr = 0;u8_ctr<len;u8_ctr++)
{
pBuf[u8_ctr] = SPIx_WriteReadByte(&hspi2,0xFF);
}
SPINRF24L01_DeSelect(); //关闭SPI传输
return status; //返回读到的状态值
}
//检测24L01是否存在
//返回值:0,成功;1,失败
uint8_t NRF24L01_Check(void)
{
uint8_t check_in_buf[5] = {0xA5, 0xA5, 0xA5, 0xA5, 0xA5};
uint8_t check_out_buf[5] = {0x00};
NRF24L01_Write_Buf(NRF_WRITE_REG + TX_ADDR, check_in_buf, 5);
NRF24L01_Read_Buf(NRF_READ_REG + TX_ADDR, check_out_buf, 5);
if((check_out_buf[0] == 0xA5) &&
(check_out_buf[1] == 0xA5) &&
(check_out_buf[2] == 0xA5) &&
(check_out_buf[3] == 0xA5) &&
(check_out_buf[4] == 0xA5))
{ return 0; }
else { return 1; }
}
/*NRF24L01接口初始化*/
void NRF24L01_Init(void)
{
NRF24L01_CE_DOWN;
NRF24L01_CSN_DOWN;
delay_ms(200);
}
/*NRF24L01发送端初始化*/
void NRF24L01_TX_Init(void)
{
NRF24L01_Init();
while(NRF24L01_Check())//检测24L01
{
OLED_PrintString(0,0,"Check Failed!");
delay_ms(100);
OLED_PrintString(0,2,"Please Check!");
delay_ms(100);
}
OLED_PrintString(0,0,"24L01 Ready!");
OLED_PrintString(0,2,"24L01 TX_Mode!");
NRF24L01_TX_Mode();
}
/*NRF24L01接收端初始化*/
void NRF24L01_RX_Init(void)
{
NRF24L01_Init();
while(NRF24L01_Check())//检测24L01
{
OLED_PrintString(0,0,"Check Failed!");
delay_ms(100);
OLED_PrintString(0,2,"Please Check!");
delay_ms(100);
}
OLED_PrintString(0,0,"24L01 Ready!");
OLED_PrintString(0,2,"24L01 RX_Mode!");
NRF24L01_RX_Mode();
}
/*Enhanced ShockBurstTM发送流程
1)把地址和要发送的数据按时序送入NRF24L01;
2)配置CONFIG寄存器,使之进入发送模式;
3)微控制器把CE置高(至少10us),激发Enhanced ShockBurstTM发射;
4)Enhanced ShockBurstTM发射:① 给射频前端供电;②射频数据打包(加字头、CRC校验码); ③ 高速发射数据包; ④发射完成,NRF24L01进入空闲状态。
启动NRF24L01发送一次数据
txbuf:待发送数据首地址
返回值:发送完成状况*/
uint8_t NRF24L01_TxPacket(uint8_t *txbuf)
{
uint8_t sta;
NRF24L01_CE_DOWN;
NRF24L01_Write_Buf(FLUSH_TX,(uint8_t*)0xff,1);//清除TX FIFO寄存器
NRF24L01_Write_Buf(WR_TX_PLOAD,txbuf,TX_PLOAD_WIDTH);//写数据到TX BUF 32个字节
NRF24L01_CE_ON;//启动发送
HAL_Delay(20);
while(NRF24L01_IRQ);//等待发送完成
sta=NRF24L01_Read_Reg(STATUS); //读取状态寄存器的值
OLED_PrintHex(0,4,sta,4);
NRF24L01_Write_Reg(NRF_WRITE_REG+STATUS,sta); //清除TX_DS或MAX_RT中断标志
if(sta&MAX_TX)//达到最大重发次数
{
NRF24L01_Write_Reg(FLUSH_TX,0xff);//清除TX FIFO寄存器
return MAX_TX;
}
if(sta&TX_OK)//发送完成
{
return TX_OK;
}
return 0xff;//其他原因发送失败
}
/*Enhanced ShockBurstTM接收流程
1)配置接收地址和要接收的数据包大小;
2)配置CONFIG寄存器,使之进入接收模式,把CE置高。
3)130us后,NRF24L01进入监视状态,等待数据包的到来;
4)当接收到正确的数据包(正确的地址和CRC校验码),NRF2401自动把字头、地址和CRC校验位移去;
5)NRF24L01通过把STATUS寄存器的RX_DR置位(STATUS一般引起微控制器中断)通知微控制器;
6)微控制器把数据从FIFO读出(0X61指令);
7)所有数据读取完毕后,可以清除STATUS寄存器。NRF2401可以进入
四种主要的模式之一;
启动NRF24L01发送一次数据
txbuf:待发送数据首地址
返回值:0,接收完成;其他,错误代码*/
uint8_t NRF24L01_RxPacket(uint8_t *rxbuf)
{
uint8_t sta;
sta=NRF24L01_Read_Reg(STATUS); //读取状态寄存器的值
OLED_PrintHex(0,4,sta,4);
NRF24L01_Write_Reg(NRF_WRITE_REG+STATUS,sta); //清除TX_DS或MAX_RT中断标志
if(sta&RX_OK)//接收到数据
{
NRF24L01_Read_Buf(RD_RX_PLOAD,rxbuf,RX_PLOAD_WIDTH);//读取数据
NRF24L01_Write_Reg(FLUSH_RX,0xff);//清除RX FIFO寄存器
return 0;
}
return 1;//没收到任何数据
}
/*Enhanced ShockBurstTM发送模式初始化
1)写Tx 节点的地址 TX_ADDR
2)写Rx 节点的地址(主要是为了使能Auto Ack) RX_ADDR_P0
3)使能AUTO ACK EN_AA
4)使能PIPE 0 EN_RXADDR
5)配置自动重发次数 SETUP_RETR
6)选择通信频率 RF_CH
7)配置发射参数(低噪放大器增益、发射功率、无线速率) RF_SETUP
8)配置24L01 的基本参数以及切换工作模式 CONFIG。
该函数初始化NRF24L01到TX模式
设置TX地址,写TX数据宽度,设置RX自动应答的地址,填充TX发送数据,选择RF频道,波特率和LNA HCURR
PWR_UP,CRC使能
当CE变高后,即进入RX模式,并可以接收数据了
CE为高大于10us,则启动发送. */
void NRF24L01_TX_Mode(void)
{
NRF24L01_CE_DOWN;
NRF24L01_Write_Buf(NRF_WRITE_REG+TX_ADDR,(uint8_t*)TX_ADDRESS,TX_ADR_WIDTH);//写TX节点地址
NRF24L01_Write_Buf(NRF_WRITE_REG+RX_ADDR_P0,(uint8_t*)TX_ADDRESS,TX_ADR_WIDTH); //设置TX节点地址,主要为了使能ACK
NRF24L01_Write_Reg(NRF_WRITE_REG+EN_AA,0x01); //使能通道0的自动应答
NRF24L01_Write_Reg(NRF_WRITE_REG+EN_RXADDR,0x01); //使能通道0的接收地址
NRF24L01_Write_Reg(NRF_WRITE_REG+SETUP_RETR,0x1a);//设置自动重发间隔时间:500us + 86us;最大自动重发次数:10次
NRF24L01_Write_Reg(NRF_WRITE_REG+RF_CH,40); //设置通信频率
NRF24L01_Write_Reg(NRF_WRITE_REG+RF_SETUP,0x0f); //设置TX发射参数,0db增益,2Mbps,低噪声增益开启
NRF24L01_Write_Reg(NRF_WRITE_REG+CONFIG,0x0e); //配置基本工作模式的参数;PWR_UP,EN_CRC,16BIT_CRC,接收模式,开启所有中断
NRF24L01_CE_ON;//CE为高,10us后启动发送
HAL_Delay(1);
}
/*
Enhanced ShockBurstTM接收模式初始化
1)写Rx 节点的地址 RX_ADDR_P0
2)使能AUTO ACK EN_AA
3)使能PIPE 0 EN_RXADDR
4)选择通信频率 RF_CH
5)选择通道0 有效数据宽度 RX_PW_P0
6)配置发射参数(低噪放大器增益、发射功率、无线速率) RF_SETUP
7)配置24L01 的基本参数以及切换工作模式 CONFIG。
该函数初始化NRF24L01到RX模式
设置RX地址,写RX数据宽度,选择RF频道,波特率和LNA HCURR
当CE变高后,即进入RX模式,并可以接收数据了 */
void NRF24L01_RX_Mode(void)
{
NRF24L01_CE_DOWN;
NRF24L01_Write_Buf(NRF_WRITE_REG+RX_ADDR_P0,(uint8_t*)RX_ADDRESS,RX_ADR_WIDTH);//写RX节点地址
NRF24L01_Write_Reg(NRF_WRITE_REG+EN_AA,0x01); //使能通道0的自动应答
NRF24L01_Write_Reg(NRF_WRITE_REG+EN_RXADDR,0x01);//使能通道0的接收地址
NRF24L01_Write_Reg(NRF_WRITE_REG+RF_CH,40); //设置RF通信频率
NRF24L01_Write_Reg(NRF_WRITE_REG+RX_PW_P0,RX_PLOAD_WIDTH);//选择通道0的有效数据宽度
NRF24L01_Write_Reg(NRF_WRITE_REG+RF_SETUP,0x0f);//设置TX发射参数,0db增益,2Mbps,低噪声增益开启
NRF24L01_Write_Reg(NRF_WRITE_REG+CONFIG, 0x0f);//配置基本工作模式的参数;PWR_UP,EN_CRC,16BIT_CRC,接收模式
NRF24L01_CE_ON; //CE为高,进入接收模式
HAL_Delay(1);
}
/**
* 函数功能: 该函数NRF24L01进入低功耗模式
* 输入参数: 无
* 返 回 值: 无
* 说 明:无
*/
void NRF_LowPower_Mode(void)
{
NRF24L01_CE_DOWN;
NRF24L01_Write_Reg(NRF_WRITE_REG+CONFIG, 0x00); //配置工作模式:掉电模式
}
2.nrf24l01.h
#ifndef __24L01_H
#define __24L01_H
#include "main.h"
//NRF24L01寄存器操作命令
#define NRF_READ_REG 0x00 //读配置寄存器,低5位为寄存器地址
#define NRF_WRITE_REG 0x20 //写配置寄存器,低5位为寄存器地址
#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 CONFIG 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 //设置地址宽度(所有数据通道):0x01,3字节;0x02,4字节;0x03,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 RSSI 0x09 //接收信号强度检测
#define TX_ADDR 0x10 //发送地址(低字节在前),ShockBurstTM模式下,RX_ADDR_P0与此地址相等
#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 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,不循环;
#define FEATURE 0x1D //特征寄存器
#define DYNPD 0x1C //使能动态负载长度
//
//24L01操作线
#define NRF24L01_CE_ON HAL_GPIO_WritePin(CE_GPIO_Port,CE_Pin,GPIO_PIN_SET) //使能24L01
#define NRF24L01_CE_DOWN HAL_GPIO_WritePin(CE_GPIO_Port,CE_Pin,GPIO_PIN_RESET) //关闭24L01
#define NRF24L01_CSN_DOWN HAL_GPIO_WritePin(CSN_GPIO_Port,CSN_Pin,GPIO_PIN_SET) //SPI片选取消
#define NRF24L01_CSN_ON HAL_GPIO_WritePin(CSN_GPIO_Port,CSN_Pin,GPIO_PIN_RESET) //SPI片选选中
#define NRF24L01_IRQ HAL_GPIO_ReadPin(IRQ_GPIO_Port,IRQ_Pin) //IRQ主机数据输入
//24L01发送接收数据宽度定义
#define TX_ADR_WIDTH 5 //5字节的地址宽度
#define RX_ADR_WIDTH 5 //5字节的地址宽度
#define TX_PLOAD_WIDTH 32 //20字节的用户数据宽度
#define RX_PLOAD_WIDTH 32 //20字节的用户数据宽度
void NRF24L01_Init(void);//初始化
void NRF24L01_RX_Mode(void);//配置为接收模式
void NRF24L01_TX_Mode(void);//配置为发送模式
uint8_t NRF24L01_TxPacket(uint8_t *txbuf);
uint8_t NRF24L01_RxPacket(uint8_t *rxbuf);
uint8_t NRF24L01_Check(void);//检查24L01是否存在
void NRF24L01_TX_Init(void);
void NRF24L01_RX_Init(void);
void SPINRF24L01_Select(void); //选中NRF24L01
void SPINRF24L01_DeSelect(void); //取消选中NRF24L01
void NRF_LowPower_Mode(void);//低功耗模式
void NRF_TX_TEST(void);
#endif
3.发送端main.c
int main(void)
{
/* USER CODE BEGIN 1 */
/* USER CODE END 1 */
/* MCU Configuration--------------------------------------------------------*/
/* Reset of all peripherals, Initializes the Flash interface and the Systick. */
HAL_Init();
/* USER CODE BEGIN Init */
/* USER CODE END Init */
/* Configure the system clock */
SystemClock_Config();
/* USER CODE BEGIN SysInit */
/* USER CODE END SysInit */
/* Initialize all configured peripherals */
MX_GPIO_Init();
MX_DMA_Init();
MX_I2C1_Init();
MX_SPI2_Init();
/* USER CODE BEGIN 2 */
OLED_Init();
NRF24L01_TX_Init();
/* USER CODE END 2 */
/* Infinite loop */
/* USER CODE BEGIN WHILE */
// NRF_TX_TEST();
while (1)
{
/* USER CODE END WHILE */
/* USER CODE BEGIN 3 */
data[0] = 4;
data[1] = 0x78;
data[2] = 0x79;
data[3] = 0x80;
data[4] = 0x81;
if(NRF24L01_TxPacket(data) == TX_OK)
{
OLED_ClearLine(2,6);
OLED_PrintString(2,6,"OK");
}
else
{
OLED_PrintString(2,6,"NOOK");
}
}
/* USER CODE END 3 */
}
4.接收端main.c
int main(void)
{
/* USER CODE BEGIN 1 */
/* USER CODE END 1 */
/* MCU Configuration--------------------------------------------------------*/
/* Reset of all peripherals, Initializes the Flash interface and the Systick. */
HAL_Init();
/* USER CODE BEGIN Init */
/* USER CODE END Init */
/* Configure the system clock */
SystemClock_Config();
/* USER CODE BEGIN SysInit */
/* USER CODE END SysInit */
/* Initialize all configured peripherals */
MX_GPIO_Init();
MX_DMA_Init();
MX_I2C1_Init();
MX_SPI2_Init();
/* USER CODE BEGIN 2 */
OLED_Init();
NRF24L01_RX_Init();
/* USER CODE END 2 */
/* Infinite loop */
/* USER CODE BEGIN WHILE */
while (1)
{
/* USER CODE END WHILE */
/* USER CODE BEGIN 3 */
if(NRF24L01_RxPacket(RxBuf)==0)
{
OLED_ClearLine(2,6);
OLED_PrintString(2, 6, "REOK");
}
else
{
OLED_PrintString(2, 6, "RENOOK");
}
}
/* USER CODE END 3 */
}
二、调试期间遇到的问题
发送端一直发送不成功,最后发现是硬件的问题,换了一块模块就成功了
三、自动应答
如果分开调试发送端和接收端,则需失能自动应答,因为自动应答一旦开启,发送端就会等待接收端的应答信号,而当接收端还未调试成功时,会导致发送端也调试不通。