Transport update (#722)
* Major transport rework * Adjust signal report calculations * Minor driver optimizations * Implement sanity check in legacy RFM69 driver * Additional RFM69 rework * RFM95 encryption * Polishing
This commit is contained in:
Olivier
Henrik Ekblad
+291
-171
@@ -6,7 +6,7 @@
|
||||
* network topology allowing messages to be routed to nodes.
|
||||
*
|
||||
* Created by Henrik Ekblad <henrik.ekblad@mysensors.org>
|
||||
* Copyright (C) 2013-2016 Sensnology AB
|
||||
* Copyright (C) 2013-2017 Sensnology AB
|
||||
* Full contributor list: https://github.com/mysensors/Arduino/graphs/contributors
|
||||
*
|
||||
* Documentation: http://www.mysensors.org
|
||||
@@ -17,45 +17,102 @@
|
||||
* version 2 as published by the Free Software Foundation.
|
||||
*
|
||||
* Based on maniacbug's RF24 library, copyright (C) 2011 J. Coliz <maniacbug@ymail.com>
|
||||
* RF24 driver refactored and optimized for speed and size, copyright (C) 2016 Olivier Mauti <olivier@mysensors.org>
|
||||
* RF24 driver refactored and optimized for speed and size, copyright (C) 2017 Olivier Mauti <olivier@mysensors.org>
|
||||
*
|
||||
* Definitions for Nordic NRF24L01+ radios:
|
||||
* https://www.nordicsemi.com/eng/Products/2.4GHz-RF/nRF24L01P
|
||||
*
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file RF24.h
|
||||
*
|
||||
* @defgroup RF24grp RF24
|
||||
* @ingroup internals
|
||||
* @{
|
||||
*
|
||||
* RF24 driver-related log messages, format: [!]SYSTEM:[SUB SYSTEM:]MESSAGE
|
||||
* - [!] Exclamation mark is prepended in case of error
|
||||
*
|
||||
* |E| SYS | SUB | Message | Comment
|
||||
* |-|-------|-------|-----------------------------------|---------------------------------------------------------------------
|
||||
* | | RF24 | INIT | | Initialise RF24 radio
|
||||
* | | RF24 | INIT | PIN,CE=%d,CS=%d | Pin configuration: chip enable (CE), chip select (CS)
|
||||
* |!| RF24 | INIT | SANCHK FAIL | Sanity check failed, check wiring or replace module
|
||||
* | | RF24 | SPP | PCT=%d,TX LEVEL=%d | Set TX level, input TX percent (PCT)
|
||||
* | | RF24 | RBR | REG=%d,VAL=%d | Read register (REG), value=(VAL)
|
||||
* | | RF24 | WBR | REG=%d,VAL=%d | Write register (REG), value=(VAL)
|
||||
* | | RF24 | FRX | | Flush RX buffer
|
||||
* | | RF24 | FTX | | Flush TX buffer
|
||||
* | | RF24 | OWP | RCPT=%d | Open writing pipe, recipient=(RCPT)
|
||||
* | | RF24 | STL | | Start listening
|
||||
* | | RF24 | SPL | | Stop listening
|
||||
* | | RF24 | SLP | | Set radio to sleep
|
||||
* | | RF24 | SBY | | Set radio to standby
|
||||
* | | RF24 | TXM | TO=%d,LEN=%d | Transmit message to=(TO), length=(LEN)
|
||||
* |!| RF24 | TXM | MAX_RT | Max TX retries, no ACK received
|
||||
* |!| RF24 | GDP | PYL INV | Invalid payload size
|
||||
* | | RF24 | RXM | LEN=%d | Read message, length=(LEN)
|
||||
* | | RF24 | STX | LEVEL=%d | Set TX level, level=(LEVEL)
|
||||
*
|
||||
*/
|
||||
|
||||
#ifndef __RF24_H__
|
||||
#define __RF24_H__
|
||||
|
||||
#define LOCAL static
|
||||
#include "RF24registers.h"
|
||||
|
||||
#if defined(ARDUINO_ARCH_AVR)
|
||||
#define DEFAULT_RF24_CE_PIN (9) //!< DEFAULT_RF24_CE_PIN
|
||||
#elif defined(ARDUINO_ARCH_ESP8266)
|
||||
#define DEFAULT_RF24_CE_PIN (4) //!< DEFAULT_RF24_CE_PIN
|
||||
#elif defined(ARDUINO_ARCH_ESP32)
|
||||
#warning not implemented yet
|
||||
#elif defined(ARDUINO_ARCH_SAMD)
|
||||
#define DEFAULT_RF24_CE_PIN (27) //!< DEFAULT_RF24_CE_PIN
|
||||
#elif defined(LINUX_ARCH_RASPBERRYPI)
|
||||
#define DEFAULT_RF24_CE_PIN (22) //!< DEFAULT_RF24_CE_PIN
|
||||
//#define DEFAULT_RF24_CS_PIN (24) //!< DEFAULT_RF24_CS_PIN
|
||||
#elif defined(ARDUINO_ARCH_STM32F1)
|
||||
#define DEFAULT_RF24_CE_PIN (PB0) //!< DEFAULT_RF24_CE_PIN
|
||||
#else
|
||||
#define DEFAULT_RF24_CE_PIN (9) //!< DEFAULT_RF24_CE_PIN
|
||||
#endif
|
||||
|
||||
#define DEFAULT_RF24_CS_PIN (SS) //!< DEFAULT_RF24_CS_PIN
|
||||
|
||||
|
||||
#define LOCAL static //!< static
|
||||
|
||||
// SPI settings
|
||||
#if !defined(MY_RF24_SPI_MAX_SPEED)
|
||||
// default 2Mhz - safe for nRF24L01+ clones
|
||||
#define MY_RF24_SPI_MAX_SPEED 2000000
|
||||
#endif
|
||||
#define MY_RF24_SPI_DATA_ORDER MSBFIRST
|
||||
#define MY_RF24_SPI_DATA_MODE SPI_MODE0
|
||||
#define RF24_SPI_DATA_ORDER MSBFIRST //!< RF24_SPI_DATA_ORDER
|
||||
#define RF24_SPI_DATA_MODE SPI_MODE0 //!< RF24_SPI_DATA_MODE
|
||||
|
||||
#if defined (ARDUINO) && !defined (__arm__) && !defined (_SPI)
|
||||
#define RF24_BROADCAST_ADDRESS (255u) //!< RF24_BROADCAST_ADDRESS
|
||||
|
||||
#if defined(ARDUINO) && !defined(__arm__) && !defined(_SPI)
|
||||
#include <SPI.h>
|
||||
#if defined(MY_SOFTSPI)
|
||||
SoftSPI<MY_SOFT_SPI_MISO_PIN, MY_SOFT_SPI_MOSI_PIN, MY_SOFT_SPI_SCK_PIN, MY_RF24_SPI_DATA_MODE>
|
||||
SoftSPI<MY_SOFT_SPI_MISO_PIN, MY_SOFT_SPI_MOSI_PIN, MY_SOFT_SPI_SCK_PIN, RF24_SPI_DATA_MODE>
|
||||
_SPI;
|
||||
#else
|
||||
#define _SPI SPI
|
||||
#define _SPI SPI //!< SPI
|
||||
#endif
|
||||
#else
|
||||
#include <stdint.h>
|
||||
#include <stdio.h>
|
||||
#include <string.h>
|
||||
|
||||
#define _BV(x) (1<<(x))
|
||||
#define _BV(x) (1<<(x)) //!< _BV()
|
||||
|
||||
#if defined(__arm__) || defined(__linux__)
|
||||
#include <SPI.h>
|
||||
#else
|
||||
extern HardwareSPI SPI;
|
||||
extern HardwareSPI SPI; //!< SPI
|
||||
#endif
|
||||
|
||||
#if !defined(_SPI)
|
||||
#define _SPI SPI
|
||||
#define _SPI SPI //!< SPI
|
||||
#endif
|
||||
#endif
|
||||
|
||||
@@ -84,207 +141,270 @@ extern HardwareSPI SPI;
|
||||
|
||||
// RF24 settings
|
||||
#if defined(MY_RX_MESSAGE_BUFFER_FEATURE)
|
||||
#define MY_RF24_CONFIGURATION (uint8_t) ((RF24_CRC_16 << 2) | (1 << RF24_MASK_TX_DS) | (1 << RF24_MASK_MAX_RT))
|
||||
#define RF24_CONFIGURATION (uint8_t) ((RF24_CRC_16 << 2) | (1 << RF24_MASK_TX_DS) | (1 << RF24_MASK_MAX_RT)) //!< MY_RF24_CONFIGURATION
|
||||
#else
|
||||
#define MY_RF24_CONFIGURATION (uint8_t) (RF24_CRC_16 << 2)
|
||||
#define RF24_CONFIGURATION (uint8_t) (RF24_CRC_16 << 2) //!< RF24_CONFIGURATION
|
||||
#endif
|
||||
#define MY_RF24_FEATURE (uint8_t)( _BV(RF24_EN_DPL) | _BV(RF24_EN_ACK_PAY) )
|
||||
#define MY_RF24_RF_SETUP (uint8_t)( ((MY_RF24_DATARATE & 0b10 ) << 4) | ((MY_RF24_DATARATE & 0b01 ) << 3) | (MY_RF24_PA_LEVEL << 1) ) + 1 // +1 for Si24R1
|
||||
#define RF24_FEATURE (uint8_t)( _BV(RF24_EN_DPL) | _BV(RF24_EN_ACK_PAY) ) //!< RF24_FEATURE
|
||||
#define RF24_RF_SETUP (uint8_t)( ((MY_RF24_DATARATE & 0b10 ) << 4) | ((MY_RF24_DATARATE & 0b01 ) << 3) | (MY_RF24_PA_LEVEL << 1) ) + 1 //!< RF24_RF_SETUP, +1 for Si24R1 and LNA
|
||||
|
||||
// powerup delay
|
||||
#define RF24_POWERUP_DELAY_MS (100u) //!< Power up delay, allow VCC to settle, transport to become fully operational
|
||||
|
||||
// pipes
|
||||
#define RF24_BROADCAST_PIPE (1)
|
||||
#define RF24_NODE_PIPE (0)
|
||||
|
||||
// debug
|
||||
#if defined(MY_DEBUG_VERBOSE_RF24)
|
||||
#define RF24_DEBUG(x,...) debug(x, ##__VA_ARGS__)
|
||||
#else
|
||||
#define RF24_DEBUG(x,...)
|
||||
#endif
|
||||
|
||||
// PA levels
|
||||
#define RF24_PA_MIN (0)
|
||||
#define RF24_PA_LOW (1)
|
||||
#define RF24_PA_HIGH (2)
|
||||
#define RF24_PA_MAX (3)
|
||||
|
||||
// data rate
|
||||
#define RF24_1MBPS (0)
|
||||
#define RF24_2MBPS (1)
|
||||
#define RF24_250KBPS (2)
|
||||
|
||||
// CRC
|
||||
#define RF24_CRC_DISABLED (0)
|
||||
#define RF24_CRC_8 (2)
|
||||
#define RF24_CRC_16 (3)
|
||||
|
||||
// ARD, auto retry delay
|
||||
#define RF24_SET_ARD (5) //=1500us
|
||||
|
||||
// ARD, auto retry count
|
||||
#define RF24_SET_ARC (15)
|
||||
|
||||
// nRF24L01(+) register definitions
|
||||
#define RF24_NRF_CONFIG (0x00)
|
||||
#define RF24_EN_AA (0x01)
|
||||
#define RF24_EN_RXADDR (0x02)
|
||||
#define RF24_SETUP_AW (0x03)
|
||||
#define RF24_SETUP_RETR (0x04)
|
||||
#define RF24_RF_CH (0x05)
|
||||
#define RF24_RF_SETUP (0x06)
|
||||
#define RF24_STATUS (0x07)
|
||||
#define RF24_OBSERVE_TX (0x08)
|
||||
#define RF24_CD (0x09)
|
||||
#define RF24_RX_ADDR_P0 (0x0A)
|
||||
#define RF24_RX_ADDR_P1 (0x0B)
|
||||
#define RF24_RX_ADDR_P2 (0x0C)
|
||||
#define RF24_RX_ADDR_P3 (0x0D)
|
||||
#define RF24_RX_ADDR_P4 (0x0E)
|
||||
#define RF24_RX_ADDR_P5 (0x0F)
|
||||
#define RF24_TX_ADDR (0x10)
|
||||
#define RF24_RX_PW_P0 (0x11)
|
||||
#define RF24_RX_PW_P1 (0x12)
|
||||
#define RF24_RX_PW_P2 (0x13)
|
||||
#define RF24_RX_PW_P3 (0x14)
|
||||
#define RF24_RX_PW_P4 (0x15)
|
||||
#define RF24_RX_PW_P5 (0x16)
|
||||
#define RF24_FIFO_STATUS (0x17)
|
||||
#define RF24_DYNPD (0x1C)
|
||||
#define RF24_FEATURE (0x1D)
|
||||
|
||||
// instructions
|
||||
#define RF24_READ_REGISTER (0x00)
|
||||
#define RF24_RPD (0x09)
|
||||
#define RF24_WRITE_REGISTER (0x20)
|
||||
#define RF24_REGISTER_MASK (0x1F)
|
||||
#define RF24_ACTIVATE (0x50)
|
||||
#define RF24_READ_RX_PL_WID (0x60)
|
||||
#define RF24_READ_RX_PAYLOAD (0x61)
|
||||
#define RF24_WRITE_TX_PAYLOAD (0xA0)
|
||||
#define RF24_WRITE_ACK_PAYLOAD (0xA8)
|
||||
#define RF24_WRITE_TX_PAYLOAD_NO_ACK (0xB0)
|
||||
#define RF24_FLUSH_TX (0xE1)
|
||||
#define RF24_FLUSH_RX (0xE2)
|
||||
#define RF24_REUSE_TX_PL (0xE3)
|
||||
#define RF24_NOP (0xFF)
|
||||
|
||||
// bit mnemonics
|
||||
#define RF24_MASK_RX_DR (6)
|
||||
#define RF24_MASK_TX_DS (5)
|
||||
#define RF24_MASK_MAX_RT (4)
|
||||
#define RF24_EN_CRC (3)
|
||||
#define RF24_CRCO (2)
|
||||
#define RF24_PWR_UP (1)
|
||||
#define RF24_PRIM_RX (0)
|
||||
|
||||
// auto ACK
|
||||
#define RF24_ENAA_P5 (5)
|
||||
#define RF24_ENAA_P4 (4)
|
||||
#define RF24_ENAA_P3 (3)
|
||||
#define RF24_ENAA_P2 (2)
|
||||
#define RF24_ENAA_P1 (1)
|
||||
#define RF24_ENAA_P0 (0)
|
||||
|
||||
// rx pipe
|
||||
#define RF24_ERX_P5 (5)
|
||||
#define RF24_ERX_P4 (4)
|
||||
#define RF24_ERX_P3 (3)
|
||||
#define RF24_ERX_P2 (2)
|
||||
#define RF24_ERX_P1 (1)
|
||||
#define RF24_ERX_P0 (0)
|
||||
|
||||
// dynamic payload
|
||||
#define RF24_DPL_P5 (5)
|
||||
#define RF24_DPL_P4 (4)
|
||||
#define RF24_DPL_P3 (3)
|
||||
#define RF24_DPL_P2 (2)
|
||||
#define RF24_DPL_P1 (1)
|
||||
#define RF24_DPL_P0 (0)
|
||||
|
||||
#define RF24_AW (0)
|
||||
#define RF24_ARD (4)
|
||||
#define RF24_ARC (0)
|
||||
#define RF24_PLL_LOCK (4)
|
||||
#define RF24_RF_DR (3)
|
||||
#define RF24_RF_PWR (6)
|
||||
#define RF24_RX_DR (6)
|
||||
#define RF24_TX_DS (5)
|
||||
#define RF24_MAX_RT (4)
|
||||
#define RF24_RX_P_NO (1)
|
||||
#define RF24_TX_FULL (0)
|
||||
#define RF24_PLOS_CNT (4)
|
||||
#define RF24_ARC_CNT (0)
|
||||
#define RF24_TX_REUSE (6)
|
||||
#define RF24_FIFO_FULL (5)
|
||||
#define RF24_TX_EMPTY (4)
|
||||
#define RF24_RX_FULL (1)
|
||||
#define RF24_RX_EMPTY (0)
|
||||
|
||||
// features
|
||||
#define RF24_EN_DPL (2)
|
||||
#define RF24_EN_ACK_PAY (1)
|
||||
#define RF24_EN_DYN_ACK (0)
|
||||
|
||||
#define RF24_LNA_HCURR (0)
|
||||
#define RF24_RF_DR_LOW (5)
|
||||
#define RF24_RF_DR_HIGH (3)
|
||||
#define RF24_RF_PWR_LOW (1)
|
||||
#define RF24_RF_PWR_HIGH (2)
|
||||
#define RF24_BROADCAST_PIPE (1u) //!< RF24_BROADCAST_PIPE
|
||||
#define RF24_NODE_PIPE (0u) //!< RF24_NODE_PIPE
|
||||
|
||||
// functions
|
||||
|
||||
/**
|
||||
* @brief RF24_csn
|
||||
* @param level
|
||||
*/
|
||||
LOCAL void RF24_csn(const bool level);
|
||||
/**
|
||||
* @brief RF24_ce
|
||||
* @param level
|
||||
*/
|
||||
LOCAL void RF24_ce(const bool level);
|
||||
/**
|
||||
* @brief RF24_spiMultiByteTransfer
|
||||
* @param cmd
|
||||
* @param buf
|
||||
* @param len
|
||||
* @param readMode
|
||||
* @return
|
||||
*/
|
||||
LOCAL uint8_t RF24_spiMultiByteTransfer(const uint8_t cmd, uint8_t* buf, const uint8_t len,
|
||||
const bool aReadMode);
|
||||
const bool readMode);
|
||||
/**
|
||||
* @brief RF24_spiByteTransfer
|
||||
* @param cmd
|
||||
* @return
|
||||
*/
|
||||
LOCAL uint8_t RF24_spiByteTransfer(const uint8_t cmd);
|
||||
/**
|
||||
* @brief RF24_RAW_readByteRegister
|
||||
* @param cmd
|
||||
* @return
|
||||
*/
|
||||
LOCAL uint8_t RF24_RAW_readByteRegister(const uint8_t cmd);
|
||||
/**
|
||||
* @brief RF24_RAW_writeByteRegister
|
||||
* @param cmd
|
||||
* @param value
|
||||
* @return
|
||||
*/
|
||||
LOCAL uint8_t RF24_RAW_writeByteRegister(const uint8_t cmd, const uint8_t value);
|
||||
|
||||
#define RF24_readByteRegister(__reg) RF24_RAW_readByteRegister(RF24_READ_REGISTER | (RF24_REGISTER_MASK & __reg))
|
||||
#define RF24_writeByteRegister(__reg,__value) RF24_RAW_writeByteRegister(RF24_WRITE_REGISTER | (RF24_REGISTER_MASK & __reg), __value)
|
||||
#define RF24_writeMultiByteRegister(__reg,__buf,__len) RF24_spiMultiByteTransfer(RF24_WRITE_REGISTER | (RF24_REGISTER_MASK & __reg),(uint8_t*)__buf, __len,false)
|
||||
// helper macros
|
||||
#define RF24_readByteRegister(__reg) RF24_RAW_readByteRegister(RF24_CMD_READ_REGISTER | (RF24_REGISTER_MASK & (__reg))) //!< RF24_readByteRegister
|
||||
#define RF24_writeByteRegister(__reg,__value) RF24_RAW_writeByteRegister(RF24_CMD_WRITE_REGISTER | (RF24_REGISTER_MASK & (__reg)), __value) //!< RF24_writeByteRegister
|
||||
#define RF24_writeMultiByteRegister(__reg,__buf,__len) RF24_spiMultiByteTransfer(RF24_CMD_WRITE_REGISTER | (RF24_REGISTER_MASK & (__reg)),(uint8_t*)__buf, __len,false) //!< RF24_writeMultiByteRegister
|
||||
|
||||
/**
|
||||
* @brief RF24_flushRX
|
||||
*/
|
||||
LOCAL void RF24_flushRX(void);
|
||||
/**
|
||||
* @brief RF24_flushTX
|
||||
*/
|
||||
LOCAL void RF24_flushTX(void);
|
||||
/**
|
||||
* @brief RF24_getStatus
|
||||
* @return
|
||||
*/
|
||||
LOCAL uint8_t RF24_getStatus(void);
|
||||
/**
|
||||
* @brief RF24_getFIFOStatus
|
||||
* @return
|
||||
*/
|
||||
LOCAL uint8_t RF24_getFIFOStatus(void);
|
||||
/**
|
||||
* @brief RF24_openWritingPipe
|
||||
* @param recipient
|
||||
*/
|
||||
LOCAL void RF24_openWritingPipe(const uint8_t recipient);
|
||||
/**
|
||||
* @brief RF24_startListening
|
||||
*/
|
||||
LOCAL void RF24_startListening(void);
|
||||
/**
|
||||
* @brief RF24_stopListening
|
||||
*/
|
||||
LOCAL void RF24_stopListening(void);
|
||||
/**
|
||||
* @brief RF24_sleep
|
||||
*/
|
||||
LOCAL void RF24_sleep(void);
|
||||
/**
|
||||
* @brief RF24_standBy
|
||||
*/
|
||||
LOCAL void RF24_standBy(void);
|
||||
/**
|
||||
* @brief RF24_powerDown
|
||||
*/
|
||||
LOCAL void RF24_powerDown(void);
|
||||
LOCAL bool RF24_sendMessage(const uint8_t recipient, const void* buf, const uint8_t len);
|
||||
/**
|
||||
* @brief RF24_powerUp
|
||||
*/
|
||||
LOCAL void RF24_powerUp(void);
|
||||
/**
|
||||
* @brief RF24_sendMessage
|
||||
* @param recipient
|
||||
* @param buf
|
||||
* @param len
|
||||
* @param noACK set True if no ACK is required
|
||||
* @return
|
||||
*/
|
||||
LOCAL bool RF24_sendMessage(const uint8_t recipient, const void* buf, const uint8_t len,
|
||||
const bool noACK = false);
|
||||
/**
|
||||
* @brief RF24_getDynamicPayloadSize
|
||||
* @return
|
||||
*/
|
||||
LOCAL uint8_t RF24_getDynamicPayloadSize(void);
|
||||
/**
|
||||
* @brief RF24_isDataAvailable
|
||||
* @return
|
||||
*/
|
||||
LOCAL bool RF24_isDataAvailable(void);
|
||||
/**
|
||||
* @brief RF24_readMessage
|
||||
* @return
|
||||
*/
|
||||
LOCAL uint8_t RF24_readMessage(void* buf);
|
||||
/**
|
||||
* @brief RF24_setNodeAddress
|
||||
* @param address
|
||||
*/
|
||||
LOCAL void RF24_setNodeAddress(const uint8_t address);
|
||||
/**
|
||||
* @brief RF24_getNodeID
|
||||
* @return
|
||||
*/
|
||||
LOCAL uint8_t RF24_getNodeID(void);
|
||||
/**
|
||||
* @brief RF24_sanityCheck
|
||||
* @return
|
||||
*/
|
||||
LOCAL bool RF24_sanityCheck(void);
|
||||
/**
|
||||
* @brief RF24_initialize
|
||||
* @return
|
||||
*/
|
||||
LOCAL bool RF24_initialize(void);
|
||||
/**
|
||||
* @brief RF24_setChannel
|
||||
* @param channel
|
||||
*/
|
||||
LOCAL void RF24_setChannel(const uint8_t channel);
|
||||
/**
|
||||
* @brief RF24_setRetries
|
||||
* @param retransmitDelay
|
||||
* @param retransmitCount
|
||||
*/
|
||||
LOCAL void RF24_setRetries(const uint8_t retransmitDelay, const uint8_t retransmitCount);
|
||||
LOCAL void RF24_setAddressWidth(const uint8_t width);
|
||||
/**
|
||||
* @brief RF24_setAddressWidth
|
||||
* @param addressWidth
|
||||
*/
|
||||
LOCAL void RF24_setAddressWidth(const uint8_t addressWidth);
|
||||
/**
|
||||
* @brief RF24_setRFSetup
|
||||
* @param RFsetup
|
||||
*/
|
||||
LOCAL void RF24_setRFSetup(const uint8_t RFsetup);
|
||||
/**
|
||||
* @brief RF24_setFeature
|
||||
* @param feature
|
||||
*/
|
||||
LOCAL void RF24_setFeature(const uint8_t feature);
|
||||
/**
|
||||
* @brief RF24_setPipe
|
||||
* @param pipe
|
||||
*/
|
||||
LOCAL void RF24_setPipe(const uint8_t pipe);
|
||||
/**
|
||||
* @brief RF24_setAutoACK
|
||||
* @param pipe
|
||||
*/
|
||||
LOCAL void RF24_setAutoACK(const uint8_t pipe);
|
||||
/**
|
||||
* @brief RF24_setDynamicPayload
|
||||
* @param pipe
|
||||
*/
|
||||
LOCAL void RF24_setDynamicPayload(const uint8_t pipe);
|
||||
/**
|
||||
* @brief RF24_setRFConfiguration
|
||||
* @param configuration
|
||||
*/
|
||||
LOCAL void RF24_setRFConfiguration(const uint8_t configuration);
|
||||
LOCAL void RF24_setPipeAddress(const uint8_t pipe, uint8_t* address, const uint8_t width);
|
||||
/**
|
||||
* @brief RF24_setPipeAddress
|
||||
* @param pipe
|
||||
* @param address
|
||||
* @param addressWidth
|
||||
*/
|
||||
LOCAL void RF24_setPipeAddress(const uint8_t pipe, uint8_t* address, const uint8_t addressWidth);
|
||||
/**
|
||||
* @brief RF24_setPipeLSB
|
||||
* @param pipe
|
||||
* @param LSB
|
||||
*/
|
||||
LOCAL void RF24_setPipeLSB(const uint8_t pipe, const uint8_t LSB);
|
||||
/**
|
||||
* @brief RF24_getObserveTX
|
||||
* @return
|
||||
*/
|
||||
LOCAL uint8_t RF24_getObserveTX(void);
|
||||
/**
|
||||
* @brief RF24_setStatus
|
||||
* @param status
|
||||
*/
|
||||
LOCAL void RF24_setStatus(const uint8_t status);
|
||||
/**
|
||||
* @brief RF24_enableFeatures
|
||||
*/
|
||||
LOCAL void RF24_enableFeatures(void);
|
||||
/**
|
||||
* @brief RF24_getTxPowerPercent
|
||||
* @return
|
||||
*/
|
||||
LOCAL uint8_t RF24_getTxPowerPercent(void);
|
||||
/**
|
||||
* @brief RF24_getTxPowerLevel
|
||||
* @return
|
||||
*/
|
||||
LOCAL int16_t RF24_getTxPowerLevel(void);
|
||||
/**
|
||||
* @brief RF24_setTxPowerPercent
|
||||
* @param newPowerPercent
|
||||
* @return
|
||||
*/
|
||||
LOCAL bool RF24_setTxPowerPercent(const uint8_t newPowerPercent);
|
||||
/**
|
||||
* @brief RF24_getSendingRSSI
|
||||
* @return Pseudo-RSSI based on ARC register
|
||||
*/
|
||||
LOCAL int16_t RF24_getSendingRSSI(void);
|
||||
|
||||
|
||||
#if defined(MY_RX_MESSAGE_BUFFER_FEATURE)
|
||||
/**
|
||||
* @brief Callback type
|
||||
*/
|
||||
typedef void (*RF24_receiveCallbackType)(void);
|
||||
/**
|
||||
* Register a callback, which will be called (from interrupt context) for every message received.
|
||||
* @note When a callback is registered, it _must_ retrieve the message from the nRF24
|
||||
* by calling RF24_readMessage(). Otherwise the interrupt will not get deasserted
|
||||
* and message reception will stop.
|
||||
*/
|
||||
* @brief RF24_registerReceiveCallback
|
||||
* Register a callback, which will be called (from interrupt context) for every message received.
|
||||
* @note When a callback is registered, it _must_ retrieve the message from the nRF24
|
||||
* by calling RF24_readMessage(). Otherwise the interrupt will not get deasserted
|
||||
* and message reception will stop.
|
||||
* @param cb
|
||||
*/
|
||||
LOCAL void RF24_registerReceiveCallback(RF24_receiveCallbackType cb);
|
||||
#endif
|
||||
|
||||
#endif // __RF24_H__
|
||||
#endif // __RF24_H__
|
||||
|
||||
/** @}*/
|
||||
Reference in New Issue
Block a user