7#ifndef __nrf52840_nrf24l01_H__
8#define __nrf52840_nrf24l01_H__
10#if defined(USE_TINYUSB)
12 #include "Adafruit_TinyUSB.h"
15#if defined(NRF52811_XXAA) || defined(NRF52820_XXAA) || defined(NRF52833_XXAA) || defined(NRF52840_XXAA)
16 #define NRF_HAS_ENERGY_DETECT
19#define NRF52_RADIO_LIBRARY
20#define DEFAULT_MAX_PAYLOAD_SIZE 32
21#define ACTUAL_MAX_PAYLOAD_SIZE 258
22#define ACK_TIMEOUT_1MBPS 600
23#define ACK_TIMEOUT_2MBPS 400
24#define ACK_TIMEOUT_250KBPS 800
25#define ACK_TIMEOUT_1MBPS_OFFSET 300
26#define ACK_TIMEOUT_2MBPS_OFFSET 135
27#define ACK_TIMEOUT_250KBPS_OFFSET 300
28#define ACK_PAYLOAD_TIMEOUT_OFFSET 750
33#if defined(ARDUINO_NRF54L15) && defined(ARDUINO_ARCH_NRF54L15CLEAN)
34 #define NRF54_CCM_ENCRYPTION
36#if defined NRF_CCM || defined NRF54_CCM_ENCRYPTION || defined(DOXYGEN)
37 #define CCM_ENCRYPTION_ENABLED
39#if defined CCM_ENCRYPTION_ENABLED || defined(DOXYGEN)
40 #define MAX_PACKET_SIZE ACTUAL_MAX_PAYLOAD_SIZE
41 #define CCM_KEY_SIZE 16
43 #define CCM_IV_SIZE_ACTUAL 8
44 #define CCM_COUNTER_SIZE 3
45 #define CCM_MIC_SIZE 4
46 #define CCM_START_SIZE 3
47 #define CCM_MODE_LENGTH_EXTENDED 16
104#ifdef ARDUINO_NRF54L15
235 void read(
void* buf, uint8_t len);
260 bool write(
void* buf, uint8_t len,
bool multicast =
false,
bool doEncryption =
true);
298 void stopListening(
bool setWritingPipe =
true,
bool resetAddresses =
true);
307 void stopListening(
const uint8_t* txAddress,
bool setWritingPipe =
true,
bool resetAddresses =
true);
419 bool writeFast(
void* buf, uint8_t len,
bool multicast = 0);
432 bool startWrite(
void* buf, uint8_t len,
bool multicast,
bool doEncryption =
true);
522 void setChannel(uint8_t channel,
bool map = 0);
558 void setPALevel(uint8_t level,
bool lnaEnable =
true);
671 void setRetries(uint8_t retryVar, uint8_t attempts);
749 bool txStandBy(uint32_t timeout,
bool startTx = 0);
772 bool testRPD(uint8_t RSSI = 65);
818#ifdef NRF_HAS_ENERGY_DETECT
823 uint8_t sample_ed(
void);
838#if defined CCM_ENCRYPTION_ENABLED || defined(DOXYGEN)
845 uint8_t
encrypt(
void* bufferIn, uint8_t size);
852 uint8_t
decrypt(
void* bufferIn, uint8_t size);
895 bool acksEnabled(uint8_t pipe);
898 uint8_t retryDuration;
901 uint8_t rxFifoAvailable;
903 bool ackPayloadsEnabled;
904 volatile bool inRxMode;
905 uint8_t staticPayloadSize;
913 volatile bool ackPayloadAvailable;
914 uint8_t ackAvailablePipeNo;
915 uint8_t lastPacketCounter;
917 bool dynamicAckEnabled;
920 volatile bool payloadAvailable;
921 bool restartReturnRx();
924 bool pollRadio(uint8_t* pipe_num);
925 uint8_t* rxQueueFront();
927 uint16_t rxQueueSlotSize;
928 uint8_t rxQueueSlots;
929 volatile uint8_t rxQueueHead;
930 volatile uint8_t rxQueueTail;
932 uint16_t ackQueueSlotSize;
933 uint8_t ackQueueDepth;
934 volatile uint8_t ackQueueHead;
935 volatile uint8_t ackQueueCount;
937 void loadAckPayload(uint8_t pipe);
938 void allocateAckQueue();
940 void resizeRxQueue();
941 void setStaticLength(uint8_t size);
942#if defined CCM_ENCRYPTION_ENABLED
953 uint32_t packetCounter;
void startListening(bool resetAddresses=true)
void openReadingPipe(uint8_t child, const uint8_t *address)
void setPALevel(uint8_t level, bool lnaEnable=true)
void disableRxInterrupt()
bool testCarrier(uint8_t RSSI=65)
uint8_t decrypt(void *bufferIn, uint8_t size)
uint8_t radioData[ACTUAL_MAX_PAYLOAD_SIZE+2]
uint32_t addrConv32(uint32_t addr)
void disableDynamicPayloads()
bool write(void *buf, uint8_t len, bool multicast=false, bool doEncryption=true)
bool testRPD(uint8_t RSSI=65)
void setCounter(uint64_t counter)
void setAddressWidth(uint8_t a_width)
void setChannel(uint8_t channel, bool map=0)
uint8_t getDynamicPayloadSize()
bool setDataRate(uint8_t speed)
void setKey(uint8_t key[CCM_KEY_SIZE])
bool writeAckPayload(uint8_t pipe, void *buf, uint8_t len)
void enableDynamicPayloads(uint8_t payloadSize=DEFAULT_MAX_PAYLOAD_SIZE)
uint8_t encrypt(void *bufferIn, uint8_t size)
bool startWrite(void *buf, uint8_t len, bool multicast, bool doEncryption=true)
uint16_t interframeSpacing
uint8_t outBuffer[MAX_PACKET_SIZE+CCM_MIC_SIZE+CCM_START_SIZE]
void setRetries(uint8_t retryVar, uint8_t attempts)
void openWritingPipe(const uint8_t *address)
void setCRCLength(nrf_crclength_e length)
bool writeFast(void *buf, uint8_t len, bool multicast=0)
void setAutoAck(bool enable)
void read(void *buf, uint8_t len)
void stopListening(bool setWritingPipe=true, bool resetAddresses=true)
bool enableRxInterrupt(uint8_t depth=3)
void setIV(uint8_t IV[CCM_IV_SIZE])
void setPayloadSize(uint8_t size)
nrf_crclength_e getCRCLength()
#define CCM_MODE_LENGTH_EXTENDED
#define DEFAULT_MAX_PAYLOAD_SIZE
#define CCM_IV_SIZE_ACTUAL
#define ACTUAL_MAX_PAYLOAD_SIZE