356 lines
8.9 KiB
C
356 lines
8.9 KiB
C
#ifndef NRF24L01_H_
|
||
#define NRF24L01_H_
|
||
|
||
#include "nrf24l01_hal.h"
|
||
|
||
typedef struct {
|
||
void *private;
|
||
} nrf_init_t;
|
||
|
||
#define REG_CONFIG 0x00
|
||
// 屏蔽因RX_DR触发的中断
|
||
// 0 不屏蔽， 1 屏蔽
|
||
#define MASK_RX_DR 6
|
||
// 屏蔽因TX_DS触发的中断
|
||
// 0 不屏蔽， 1 屏蔽
|
||
#define MASK_TX_DS 5
|
||
// 屏蔽因MAX_RT触发的中断
|
||
// 0 不屏蔽， 1 屏蔽
|
||
#define MASK_MAX_RT 4
|
||
// 启用CRC
|
||
// 如果EN_AA有一个比特为1，就会被强制置1
|
||
#define EN_CRC 3
|
||
// CRC编码方式
|
||
// 0 一字节，1 二字节
|
||
#define CRCO 2
|
||
// 0 POWER DOWN, 1 POWER UP
|
||
#define PWR_UP 1
|
||
// 收发控制
|
||
// 0 PTX, 1 PRX
|
||
#define PRIM_RX 0
|
||
|
||
|
||
#define REG_EN_AA 0x01
|
||
// Enable相应data pipe的自动Ack
|
||
#define ENAA_P5 5
|
||
#define ENAA_P4 4
|
||
#define ENAA_P3 3
|
||
#define ENAA_P2 2
|
||
#define ENAA_P1 1
|
||
#define ENAA_P0 0
|
||
|
||
|
||
#define REG_EN_RXADDR 0x02
|
||
// Enable相应的data pipe
|
||
#define ERX_P5 5
|
||
#define ERX_P4 4
|
||
#define ERX_P3 3
|
||
#define ERX_P2 2
|
||
#define ERX_P1 1
|
||
#define ERX_P0 0
|
||
|
||
|
||
#define REG_SETUP_AW 0x03
|
||
// RX、TX地址宽度, AW占两个比特位
|
||
// 00 illegal
|
||
// 01 3字节
|
||
// 10 4字节
|
||
// 11 5字节
|
||
#define AW 0
|
||
#define AW_3BYTES 1
|
||
#define AW_4BYTES 2
|
||
#define AW_5BYTES 3
|
||
|
||
|
||
|
||
#define REG_SETUP_RETR 0x04
|
||
// ARD, Auto Retransmit Delay占7:4共4个比特位
|
||
// 0000 250us
|
||
// 0001 500us
|
||
// 0010 750us
|
||
// ...
|
||
// 1111 4000us
|
||
#define ARD 4
|
||
#define ARD_250us 0
|
||
#define ARD_500us 1
|
||
#define ARD_750us 2
|
||
#define ARD_1000us 3
|
||
#define ARD_1250us 4
|
||
#define ARD_1500us 5
|
||
#define ARD_1750us 6
|
||
#define ARD_2000us 7
|
||
#define ARD_2250us 8
|
||
#define ARD_2500us 9
|
||
#define ARD_2750us 10
|
||
#define ARD_3000us 11
|
||
#define ARD_3250us 12
|
||
#define ARD_3500us 13
|
||
#define ARD_3750us 14
|
||
#define ARD_4000us 15
|
||
|
||
// ARC, Auto Retransmit Count占3:0共4个比特
|
||
// 0000 Re-Transmit disabled
|
||
// 0001 最多重试一次
|
||
// ...
|
||
// 1111 最多重度15次
|
||
#define ARC 0
|
||
#define ARC_0 0
|
||
#define ARC_1 1
|
||
#define ARC_2 2
|
||
#define ARC_3 3
|
||
#define ARC_4 4
|
||
#define ARC_5 5
|
||
#define ARC_6 6
|
||
#define ARC_7 7
|
||
#define ARC_8 8
|
||
#define ARC_9 9
|
||
#define ARC_10 10
|
||
#define ARC_11 11
|
||
#define ARC_12 12
|
||
#define ARC_13 13
|
||
#define ARC_14 14
|
||
#define ARC_15 15
|
||
|
||
|
||
// RF Channel选择
|
||
// 占6:0共7个比特
|
||
#define REG_RF_CH 0x05
|
||
|
||
|
||
#define REG_RF_SETUP 0x06
|
||
#define PLL_LOCK 4 // 仅用在测试
|
||
|
||
// Air Data Rate
|
||
// 0 1Mbps
|
||
// 1 2Mbps
|
||
#define RF_DR 3
|
||
#define NRF_1Mbps 0
|
||
#define NRF_2Mbps 1
|
||
// 对于250Kbps的配置需要特别注意
|
||
// 因为nRF24L01P(也就是nRF24L01+)和nRF24L01在这里不一样
|
||
// nRF24L01P只定义了第3比特位的RF_DR，0为1Mbps,1为2Mbps
|
||
// nRF24L01则定义了第3比特位的RF_DR_HIGH和第5比特位的RF_DR_LOW，当RF_DR_HIGH==0 && RF_DR_LOW == 1时设置为250Kbps
|
||
// 然而nRF24L01的第5比特位只允许为0，所以无法发送250Kbps
|
||
// 因此为了避免两个不同的产品在250Kbps不能通信带来的疑惑和调式程序的麻烦，本程序直接删除了NRF_250Kbps的定义
|
||
// 如果确实想用250Kbps，可以自己手动设置
|
||
|
||
|
||
// 仅用在nRF24L01P芯片上
|
||
#define RF_DR_LOW 5
|
||
#define RF_DR_HIGH 3
|
||
|
||
// PWR, 占2:1共2个比特，仅nRF24L01P、nRF24L01有效
|
||
// 00 -18dBm
|
||
// 01 -12dBm
|
||
// 10 -6dBm
|
||
// 11 0dBm
|
||
#define RF_PWR 1
|
||
#define RF_PWR_n18dBm 0
|
||
#define RF_PWR_n12dBm 1
|
||
#define RF_PWR_n6dBm 2
|
||
#define RF_PWR_0dBm 3
|
||
|
||
// 仅nRF24L01有效，nRF24L01P没有这位定义
|
||
#define LNA_HCURR 0
|
||
|
||
// 在SI24R1中，针对nRF24L01P没有使用这一位就直接拿来扩充RF_PWR的位数了
|
||
// 因此在SI24R1中 RF_PWR == 0 占用0:2共3个比特位
|
||
// 与nRF24L01P的对应关系如下
|
||
// [2:0] SI24R1 nRF24L01P
|
||
// 000 -12dBm -18dBm
|
||
// 001 -6dBm
|
||
// 010 -4dBm -12dBm
|
||
// 011 0dBm
|
||
// 100 1dBm -6dBm
|
||
// 101 3dBm
|
||
// 110 4dBm 0dBm
|
||
// 111 7dBm
|
||
// 以下定义仅SI24R1芯片有效
|
||
#define SI24R1_PWR 0
|
||
#define SI24R1_PWR_n12dBm 0
|
||
#define SI24R1_PWR_n6dBm 1
|
||
#define SI24R1_PWR_n4dBm 2
|
||
#define SI24R1_PWR_0dBm 3
|
||
#define SI24R1_PWR_1dBm 4
|
||
#define SI24R1_PWR_3dBm 5
|
||
#define SI24R1_PWR_4dBm 6
|
||
#define SI24R1_PWR_7dBm 7
|
||
|
||
|
||
#define REG_STATUS 0x07
|
||
// RX FIFO数据READY中断标记位
|
||
// 写1清除此位
|
||
#define RX_DR 6
|
||
// 数据已发送中断标记位
|
||
// 如果启用AUTO_ACK，则此位仅在收到ACK后置1
|
||
// 写1清除此位
|
||
#define TX_DS 5
|
||
// 达到最大重发次数中断标记位
|
||
// 为了继续使用通信功能，此位必需被清0
|
||
// 写1清除此位
|
||
#define MAX_RT 4
|
||
// RX_P_NO 占用3:1共3个比特位
|
||
// RX_FIFIO中数据来自哪个data pipe的number
|
||
// 000-101 Data Pipe Number
|
||
// 110 未用
|
||
// 111 RX FIFO空
|
||
#define RX_P_NO 1
|
||
// TX FIFO满标志
|
||
// 0 TX FIFO中还有空间
|
||
// 1 满
|
||
#define TX_FULL 0
|
||
|
||
#define REG_OBSERVE_TX 0x08
|
||
// 占7:4共4个比特位，丢包计数
|
||
#define PLOS_CNT 4
|
||
// 占3:0共4个比特位，重传计数
|
||
#define ARC_CNT 0
|
||
|
||
// RSSI, Carrier Detect
|
||
// 最低比特位有效(0 接收信号小于-60dBm)
|
||
#define REG_RSSI 0x09
|
||
|
||
#define REG_RX_ADDR_P0 0x0A // 39:0 默认0xE7E7E7E7E7
|
||
#define REG_RX_ADDR_P1 0x0B // 39:0 默认0xC2C2C2C2C2
|
||
#define REG_RX_ADDR_P2 0x0C // 7:0 默认0xC3
|
||
#define REG_RX_ADDR_P3 0x0D // 7:0 默认0xC4
|
||
#define REG_RX_ADDR_P4 0x0E // 7:0 默认0xC5
|
||
#define REG_RX_ADDR_P5 0x0F // 7:0 默认0xC6
|
||
#define REG_TX_ADDR 0x10 // 39:0 默认0xE7E7E7E7E7
|
||
|
||
|
||
// 以下是一组表示各通道的静态负载长度
|
||
// 都是5:0为有效比特位
|
||
// 0 表示pipe未使用
|
||
// 1 1byte
|
||
// ...
|
||
// 32 32bytes
|
||
#define REG_RX_PW_P0 0x11
|
||
#define REG_RX_PW_P1 0x12
|
||
#define REG_RX_PW_P2 0x13
|
||
#define REG_RX_PW_P3 0x14
|
||
#define REG_RX_PW_P4 0x15
|
||
#define REG_RX_PW_P5 0x16
|
||
|
||
|
||
#define REG_FIFO_STATUS 0x17
|
||
// 如果置1则重用上次传输的数据包
|
||
// 只要CE为1，数据包就会不断地被重发
|
||
// SPI命令REUSE_TX_PL对此位置1
|
||
// SPI命令W_TX_PAYLOAD或FLUSH_TX对此位清0
|
||
#define TX_REUSE 6
|
||
// 0 TX FIFO尚有空间
|
||
// 1 TX FIFO已满
|
||
#define TX_FIFO_FULL 5
|
||
// 0 TX FIFO中有数据
|
||
// 1 TX FIFO中没有数据
|
||
#define TX_FIFIO_EMPTY 4
|
||
// 0 RX FIFO尚有空间
|
||
// 1 RX FIFO已满
|
||
#define RX_FIFO_FULL 1
|
||
// 0 RX FIFO中有数据
|
||
// 1 RX FIFO中没有数据
|
||
#define RX_FIFO_EMPTY 0
|
||
|
||
|
||
// 启用相应data pip的动态负载长度
|
||
// 需要启用 EN_DPL 和 ENAA_Pn
|
||
#define REG_DYNPD 0x1C
|
||
#define DPL_P5 5
|
||
#define DPL_P4 4
|
||
#define DPL_P3 3
|
||
#define DPL_P2 2
|
||
#define DPL_P1 1
|
||
#define DPL_P0 0
|
||
|
||
#define REG_FEATURE 0x1D
|
||
// Enable Dynamic Payload Length
|
||
#define EN_DPL 2
|
||
// Enable Payload with ACK
|
||
#define EN_ACK_PAY 1
|
||
// Enable W_TX_PAYLOAD_NOACK 命令
|
||
#define EN_DYN_ACK 0
|
||
|
||
|
||
#define REGISTER_MASK 0x1F
|
||
#define CMD_R_REGISTER 0x00
|
||
#define CMD_W_REGISTER 0x20
|
||
|
||
#define CMD_R_RX_PAYLOAD 0b01100001
|
||
#define CMD_W_TX_PAYLOAD 0b10100000
|
||
#define CMD_FLUSH_TX 0b11100001
|
||
#define CMD_FLUSH_RX 0b11100010
|
||
#define CMD_REUSE_TX_PL 0b11100011
|
||
#define CMD_ACTIVATE 0b01010000
|
||
#define CMD_R_RX_PL_WID 0b01100000
|
||
#define CMD_W_ACK_PAYLOAD 0b10101000
|
||
#define CMD_W_TX_PAYLOAD_NOACK 0b10110000
|
||
#define CMD_NOP 0b11111111
|
||
|
||
|
||
#define _BV(n) (1<<(n))
|
||
#define _VV(v, n) ((v)<<(n))
|
||
|
||
|
||
int nrf_init(void* ni);
|
||
|
||
void nrf_flush_rx();
|
||
|
||
void nrf_flush_tx();
|
||
|
||
void nrf_delay(uint32_t delay);
|
||
|
||
int nrf_powerup();
|
||
|
||
int nrf_powerdown();
|
||
|
||
void nrf_enable_rx_irq();
|
||
|
||
void nrf_disable_rx_irq();
|
||
|
||
void nrf_enable_tx_irq();
|
||
|
||
void nrf_disable_tx_irq();
|
||
|
||
void nrf_enable_max_rt_irq();
|
||
|
||
void nrf_disable_max_rt_irq();
|
||
|
||
void nrf_set_rf_channel(uint8_t channel);
|
||
|
||
int nrf_set_rxaddr(uint8_t pipe, uint8_t *addr, uint8_t addrlen);
|
||
|
||
int nrf_get_rxaddr(uint8_t pipe, uint8_t *addr, uint8_t *addrlen);
|
||
|
||
int nrf_set_txaddr(uint8_t *addr, uint8_t addrlen);
|
||
|
||
int nrf_get_txaddr(uint8_t *addr, uint8_t *addrlen);
|
||
|
||
int nrf_enable_rxaddr(uint8_t pipe);
|
||
|
||
void nrf_reset_registers();
|
||
|
||
void nrf_set_standby_mode();
|
||
|
||
void nrf_set_receive_mode();
|
||
|
||
void nrf_set_send_mode();
|
||
|
||
void nrf_enable_autoack(uint8_t pipe);
|
||
|
||
void nrf_disable_autoack(uint8_t pipe);
|
||
|
||
void nrf_set_datarate(uint8_t dr);
|
||
|
||
int nrf_enable_dynamic_payload(uint8_t pipe);
|
||
|
||
int nrf_read_payload(uint8_t *buf, uint8_t *len, uint8_t *pipe);
|
||
|
||
int nrf_write_payload(uint8_t *buf, uint8_t len);
|
||
|
||
void nrf_ce(uint8_t mode);
|
||
|
||
void nrf_csn(uint8_t mode);
|
||
|
||
#endif /* NRF24L01_H_ */
|