123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674 |
- /**
- * Copyright (c) 2016 - 2018, Nordic Semiconductor ASA
- *
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without modification,
- * are permitted provided that the following conditions are met:
- *
- * 1. Redistributions of source code must retain the above copyright notice, this
- * list of conditions and the following disclaimer.
- *
- * 2. Redistributions in binary form, except as embedded into a Nordic
- * Semiconductor ASA integrated circuit in a product or a software update for
- * such product, must reproduce the above copyright notice, this list of
- * conditions and the following disclaimer in the documentation and/or other
- * materials provided with the distribution.
- *
- * 3. Neither the name of Nordic Semiconductor ASA nor the names of its
- * contributors may be used to endorse or promote products derived from this
- * software without specific prior written permission.
- *
- * 4. This software, with or without modification, must only be used with a
- * Nordic Semiconductor ASA integrated circuit.
- *
- * 5. Any software provided in binary form under this license must not be reverse
- * engineered, decompiled, modified and/or disassembled.
- *
- * THIS SOFTWARE IS PROVIDED BY NORDIC SEMICONDUCTOR ASA "AS IS" AND ANY EXPRESS
- * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
- * OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
- * DISCLAIMED. IN NO EVENT SHALL NORDIC SEMICONDUCTOR ASA OR CONTRIBUTORS BE
- * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
- * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
- * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
- * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
- * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
- * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- */
- #include "nrf_error.h"
- #include "nrf_esb.h"
- #include "nrf_esb_error_codes.h"
- #include "nrf_gpio.h"
- #include <string.h>
- #include <stddef.h>
- #include "sdk_common.h"
- #include "sdk_macros.h"
- #include "app_util.h"
- #include "nrf_delay.h"
- #define BIT_MASK_UINT_8(x) (0xFF >> (8 - (x)))
- // Constant parameters
- #define RX_WAIT_FOR_ACK_TIMEOUT_US_2MBPS (48) /**< 2 Mb RX wait for acknowledgment time-out value. Smallest reliable value - 43. */
- #define RX_WAIT_FOR_ACK_TIMEOUT_US_1MBPS (73) /**< 1 Mb RX wait for acknowledgment time-out value. Smallest reliable value - 68. */
- #define RX_WAIT_FOR_ACK_TIMEOUT_US_250KBPS (250) /**< 250 Kb RX wait for acknowledgment time-out value. */
- #define RX_WAIT_FOR_ACK_TIMEOUT_US_1MBPS_BLE (73) /**< 1 Mb RX wait for acknowledgment time-out (combined with BLE). Smallest reliable value - 68.*/
- // Interrupt flags
- #define NRF_ESB_INT_TX_SUCCESS_MSK 0x01 /**< Interrupt mask value for TX success. */
- #define NRF_ESB_INT_TX_FAILED_MSK 0x02 /**< Interrupt mask value for TX failure. */
- #define NRF_ESB_INT_RX_DATA_RECEIVED_MSK 0x04 /**< Interrupt mask value for RX_DR. */
- #define NRF_ESB_PID_RESET_VALUE 0xFF /**< Invalid PID value which is guaranteed to not collide with any valid PID value. */
- #define NRF_ESB_PID_MAX 3 /**< Maximum value for PID. */
- #define NRF_ESB_CRC_RESET_VALUE 0xFFFF /**< CRC reset value. */
- // Internal Enhanced ShockBurst module state.
- typedef enum {
- NRF_ESB_STATE_IDLE, /**< Module idle. */
- NRF_ESB_STATE_PTX_TX, /**< Module transmitting without acknowledgment. */
- NRF_ESB_STATE_PTX_TX_ACK, /**< Module transmitting with acknowledgment. */
- NRF_ESB_STATE_PTX_RX_ACK, /**< Module transmitting with acknowledgment and reception of payload with the acknowledgment response. */
- NRF_ESB_STATE_PRX, /**< Module receiving packets without acknowledgment. */
- NRF_ESB_STATE_PRX_SEND_ACK, /**< Module transmitting acknowledgment in RX mode. */
- } nrf_esb_mainstate_t;
- #define DISABLE_RF_IRQ() NVIC_DisableIRQ(RADIO_IRQn)
- #define ENABLE_RF_IRQ() NVIC_EnableIRQ(RADIO_IRQn)
- #define _RADIO_SHORTS_COMMON ( RADIO_SHORTS_READY_START_Msk | RADIO_SHORTS_END_DISABLE_Msk | \
- RADIO_SHORTS_ADDRESS_RSSISTART_Msk | RADIO_SHORTS_DISABLED_RSSISTOP_Msk )
- #define VERIFY_PAYLOAD_LENGTH(p) \
- do \
- { \
- if (p->length == 0 || \
- p->length > NRF_ESB_MAX_PAYLOAD_LENGTH || \
- (m_config_local.protocol == NRF_ESB_PROTOCOL_ESB && \
- p->length > m_config_local.payload_length)) \
- { \
- return NRF_ERROR_INVALID_LENGTH; \
- } \
- }while (0)
- /* @brief Structure holding pipe info PID and CRC and acknowledgment payload. */
- typedef struct
- {
- uint16_t crc; /**< CRC value of the last received packet (Used to detect retransmits). */
- uint8_t pid; /**< Packet ID of the last received packet (Used to detect retransmits). */
- bool ack_payload; /**< Flag indicating the state of the transmission of acknowledgment payloads. */
- } pipe_info_t;
- /* @brief First-in, first-out queue of payloads to be transmitted. */
- typedef struct
- {
- nrf_esb_payload_t * p_payload[NRF_ESB_TX_FIFO_SIZE]; /**< Pointer to the actual queue. */
- uint32_t entry_point; /**< Current start of queue. */
- uint32_t exit_point; /**< Current end of queue. */
- uint32_t count; /**< Current number of elements in the queue. */
- } nrf_esb_payload_tx_fifo_t;
- /* @brief First-in, first-out queue of received payloads. */
- typedef struct
- {
- nrf_esb_payload_t * p_payload[NRF_ESB_RX_FIFO_SIZE]; /**< Pointer to the actual queue. */
- uint32_t entry_point; /**< Current start of queue. */
- uint32_t exit_point; /**< Current end of queue. */
- uint32_t count; /**< Current number of elements in the queue. */
- } nrf_esb_payload_rx_fifo_t;
- /**@brief Enhanced ShockBurst address.
- *
- * Enhanced ShockBurst addresses consist of a base address and a prefix
- * that is unique for each pipe. See @ref esb_addressing in the ESB user
- * guide for more information.
- */
- typedef struct
- {
- uint8_t base_addr_p0[4]; /**< Base address for pipe 0 encoded in big endian. */
- uint8_t base_addr_p1[4]; /**< Base address for pipe 1-7 encoded in big endian. */
- uint8_t pipe_prefixes[8]; /**< Address prefix for pipe 0 to 7. */
- uint8_t num_pipes; /**< Number of pipes available. */
- uint8_t addr_length; /**< Length of the address including the prefix. */
- uint8_t rx_pipes_enabled; /**< Bitfield for enabled pipes. */
- uint8_t rf_channel; /**< Channel to use (must be between 0 and 100). */
- } nrf_esb_address_t;
- // Module state
- static bool m_esb_initialized = false;
- static volatile nrf_esb_mainstate_t m_nrf_esb_mainstate = NRF_ESB_STATE_IDLE;
- static nrf_esb_payload_t * mp_current_payload;
- static nrf_esb_event_handler_t m_event_handler;
- // Address parameters
- __ALIGN(4) static nrf_esb_address_t m_esb_addr = NRF_ESB_ADDR_DEFAULT;
- // RF parameters
- static nrf_esb_config_t m_config_local;
- // TX FIFO
- static nrf_esb_payload_t m_tx_fifo_payload[NRF_ESB_TX_FIFO_SIZE];
- static nrf_esb_payload_tx_fifo_t m_tx_fifo;
- // RX FIFO
- static nrf_esb_payload_t m_rx_fifo_payload[NRF_ESB_RX_FIFO_SIZE];
- static nrf_esb_payload_rx_fifo_t m_rx_fifo;
- // Payload buffers
- static uint8_t m_tx_payload_buffer[NRF_ESB_MAX_PAYLOAD_LENGTH + 2];
- static uint8_t m_rx_payload_buffer[NRF_ESB_MAX_PAYLOAD_LENGTH + 2];
- // Run time variables
- static volatile uint32_t m_interrupt_flags = 0;
- static uint8_t m_pids[NRF_ESB_PIPE_COUNT];
- static pipe_info_t m_rx_pipe_info[NRF_ESB_PIPE_COUNT];
- static volatile uint32_t m_retransmits_remaining;
- static volatile uint32_t m_last_tx_attempts;
- static volatile uint32_t m_wait_for_ack_timeout_us;
- static volatile uint32_t m_radio_shorts_common = _RADIO_SHORTS_COMMON;
- // These function pointers are changed dynamically, depending on protocol configuration and state.
- static void (*on_radio_disabled)(void) = 0;
- static void (*on_radio_end)(void) = 0;
- static void (*update_rf_payload_format)(uint32_t payload_length) = 0;
- // The following functions are assigned to the function pointers above.
- static void on_radio_disabled_tx_noack(void);
- static void on_radio_disabled_tx(void);
- static void on_radio_disabled_tx_wait_for_ack(void);
- static void on_radio_disabled_rx(void);
- static void on_radio_disabled_rx_ack(void);
- #define NRF_ESB_ADDR_UPDATE_MASK_BASE0 (1 << 0) /*< Mask value to signal updating BASE0 radio address. */
- #define NRF_ESB_ADDR_UPDATE_MASK_BASE1 (1 << 1) /*< Mask value to signal updating BASE1 radio address. */
- #define NRF_ESB_ADDR_UPDATE_MASK_PREFIX (1 << 2) /*< Mask value to signal updating radio prefixes. */
- // Function to do bytewise bit-swap on an unsigned 32-bit value
- static uint32_t bytewise_bit_swap(uint8_t const * p_inp)
- {
- #if __CORTEX_M == (0x04U)
- uint32_t inp = (*(uint32_t*)p_inp);
- return __REV((uint32_t)__RBIT(inp)); //lint -esym(628, __rev) -esym(526, __rev) -esym(628, __rbit) -esym(526, __rbit) */
- #else
- uint32_t inp = (p_inp[3] << 24) | (p_inp[2] << 16) | (p_inp[1] << 8) | (p_inp[0]);
- inp = (inp & 0xF0F0F0F0) >> 4 | (inp & 0x0F0F0F0F) << 4;
- inp = (inp & 0xCCCCCCCC) >> 2 | (inp & 0x33333333) << 2;
- inp = (inp & 0xAAAAAAAA) >> 1 | (inp & 0x55555555) << 1;
- return inp;
- #endif
- }
- // Convert a base address from nRF24L format to nRF5 format
- static uint32_t addr_conv(uint8_t const* p_addr)
- {
- return __REV(bytewise_bit_swap(p_addr)); //lint -esym(628, __rev) -esym(526, __rev) */
- }
- #ifdef NRF52832_XXAA
- static ret_code_t apply_address_workarounds()
- {
- if ((NRF_FICR->INFO.VARIANT & 0x0000FF00) == 0x00004200) //Check if the device is an nRF52832 Rev. 1.
- {
- // Workaround for nRF52832 Rev 1 erratas
- // Set up radio parameters.
- NRF_RADIO->MODECNF0 = (NRF_RADIO->MODECNF0 & ~RADIO_MODECNF0_RU_Msk) | RADIO_MODECNF0_RU_Default << RADIO_MODECNF0_RU_Pos;
- // Workaround for nRF52832 Rev 1 Errata 102 and nRF52832 Rev 1 Errata 106. This will reduce sensitivity by 3dB.
- *((volatile uint32_t *)0x40001774) = (*((volatile uint32_t *)0x40001774) & 0xFFFFFFFE) | 0x01000000;
- }
- if ((NRF_FICR->INFO.VARIANT & 0x0000FF00) == 0x00004500)//Check if the device is an nRF52832 Rev. 2.
- {
- /*
- Workaround for nRF52832 Rev 2 Errata 143
- Check if the most significant bytes of address 0 (including prefix) match those of another address.
- It's recommended to use a unique address 0 since this will avoid the 3dBm penalty incurred from the workaround.
- */
- uint32_t base_address_mask = m_esb_addr.addr_length == 5 ? 0xFFFF0000 : 0xFF000000;
- // Load the two addresses before comparing them to ensure defined ordering of volatile accesses.
- uint32_t addr0 = NRF_RADIO->BASE0 & base_address_mask;
- uint32_t addr1 = NRF_RADIO->BASE1 & base_address_mask;
- if (addr0 == addr1)
- {
- uint32_t prefix0 = NRF_RADIO->PREFIX0 & 0x000000FF;
- uint32_t prefix1 = (NRF_RADIO->PREFIX0 & 0x0000FF00) >> 8;
- uint32_t prefix2 = (NRF_RADIO->PREFIX0 & 0x00FF0000) >> 16;
- uint32_t prefix3 = (NRF_RADIO->PREFIX0 & 0xFF000000) >> 24;
- uint32_t prefix4 = NRF_RADIO->PREFIX1 & 0x000000FF;
- uint32_t prefix5 = (NRF_RADIO->PREFIX1 & 0x0000FF00) >> 8;
- uint32_t prefix6 = (NRF_RADIO->PREFIX1 & 0x00FF0000) >> 16;
- uint32_t prefix7 = (NRF_RADIO->PREFIX1 & 0xFF000000) >> 24;
-
- if (prefix0 == prefix1 || prefix0 == prefix2 || prefix0 == prefix3 || prefix0 == prefix4 ||
- prefix0 == prefix5 || prefix0 == prefix6 || prefix0 == prefix7)
- {
- // This will cause a 3dBm sensitivity loss, avoid using such address combinations if possible.
- *(volatile uint32_t *) 0x40001774 = ((*(volatile uint32_t *) 0x40001774) & 0xfffffffe) | 0x01000000;
- }
- }
- }
- return NRF_SUCCESS;
- }
- #endif
- static void update_rf_payload_format_esb_dpl(uint32_t payload_length)
- {
- #if (NRF_ESB_MAX_PAYLOAD_LENGTH <= 32)
- // Using 6 bits for length
- NRF_RADIO->PCNF0 = (0 << RADIO_PCNF0_S0LEN_Pos) |
- (6 << RADIO_PCNF0_LFLEN_Pos) |
- (3 << RADIO_PCNF0_S1LEN_Pos) ;
- #else
- // Using 8 bits for length
- NRF_RADIO->PCNF0 = (0 << RADIO_PCNF0_S0LEN_Pos) |
- (8 << RADIO_PCNF0_LFLEN_Pos) |
- (3 << RADIO_PCNF0_S1LEN_Pos) ;
- #endif
- NRF_RADIO->PCNF1 = (RADIO_PCNF1_WHITEEN_Disabled << RADIO_PCNF1_WHITEEN_Pos) |
- (RADIO_PCNF1_ENDIAN_Big << RADIO_PCNF1_ENDIAN_Pos) |
- ((m_esb_addr.addr_length - 1) << RADIO_PCNF1_BALEN_Pos) |
- (0 << RADIO_PCNF1_STATLEN_Pos) |
- (NRF_ESB_MAX_PAYLOAD_LENGTH << RADIO_PCNF1_MAXLEN_Pos);
- }
- static void update_rf_payload_format_esb(uint32_t payload_length)
- {
- NRF_RADIO->PCNF0 = (1 << RADIO_PCNF0_S0LEN_Pos) |
- (0 << RADIO_PCNF0_LFLEN_Pos) |
- (1 << RADIO_PCNF0_S1LEN_Pos);
- NRF_RADIO->PCNF1 = (RADIO_PCNF1_WHITEEN_Disabled << RADIO_PCNF1_WHITEEN_Pos) |
- (RADIO_PCNF1_ENDIAN_Big << RADIO_PCNF1_ENDIAN_Pos) |
- ((m_esb_addr.addr_length - 1) << RADIO_PCNF1_BALEN_Pos) |
- (payload_length << RADIO_PCNF1_STATLEN_Pos) |
- (payload_length << RADIO_PCNF1_MAXLEN_Pos);
- }
- static void update_radio_addresses(uint8_t update_mask)
- {
- if ((update_mask & NRF_ESB_ADDR_UPDATE_MASK_BASE0) != 0)
- {
- NRF_RADIO->BASE0 = addr_conv(m_esb_addr.base_addr_p0);
- }
- if ((update_mask & NRF_ESB_ADDR_UPDATE_MASK_BASE1) != 0)
- {
- NRF_RADIO->BASE1 = addr_conv(m_esb_addr.base_addr_p1);
- }
- if ((update_mask & NRF_ESB_ADDR_UPDATE_MASK_PREFIX) != 0)
- {
- NRF_RADIO->PREFIX0 = bytewise_bit_swap(&m_esb_addr.pipe_prefixes[0]);
- NRF_RADIO->PREFIX1 = bytewise_bit_swap(&m_esb_addr.pipe_prefixes[4]);
- }
- }
- static void update_radio_tx_power()
- {
- NRF_RADIO->TXPOWER = m_config_local.tx_output_power << RADIO_TXPOWER_TXPOWER_Pos;
- }
- static bool update_radio_bitrate()
- {
- NRF_RADIO->MODE = m_config_local.bitrate << RADIO_MODE_MODE_Pos;
- switch (m_config_local.bitrate)
- {
- case NRF_ESB_BITRATE_2MBPS:
- #ifdef NRF52_SERIES
- case NRF_ESB_BITRATE_2MBPS_BLE:
- #endif
- m_wait_for_ack_timeout_us = RX_WAIT_FOR_ACK_TIMEOUT_US_2MBPS;
- break;
- case NRF_ESB_BITRATE_1MBPS:
- m_wait_for_ack_timeout_us = RX_WAIT_FOR_ACK_TIMEOUT_US_1MBPS;
- break;
- #ifdef NRF51
- case NRF_ESB_BITRATE_250KBPS:
- m_wait_for_ack_timeout_us = RX_WAIT_FOR_ACK_TIMEOUT_US_250KBPS;
- break;
- #endif
-
- case NRF_ESB_BITRATE_1MBPS_BLE:
- m_wait_for_ack_timeout_us = RX_WAIT_FOR_ACK_TIMEOUT_US_1MBPS_BLE;
- break;
- default:
- // Should not be reached
- return false;
- }
- return true;
- }
- static bool update_radio_protocol()
- {
- switch (m_config_local.protocol)
- {
- case NRF_ESB_PROTOCOL_ESB_DPL:
- update_rf_payload_format = update_rf_payload_format_esb_dpl;
- break;
- case NRF_ESB_PROTOCOL_ESB:
- update_rf_payload_format = update_rf_payload_format_esb;
- break;
- default:
- // Should not be reached
- return false;
- }
- return true;
- }
- static bool update_radio_crc()
- {
- switch(m_config_local.crc)
- {
- case NRF_ESB_CRC_16BIT:
- NRF_RADIO->CRCINIT = 0xFFFFUL; // Initial value
- NRF_RADIO->CRCPOLY = 0x11021UL; // CRC poly: x^16+x^12^x^5+1
- break;
-
- case NRF_ESB_CRC_8BIT:
- NRF_RADIO->CRCINIT = 0xFFUL; // Initial value
- NRF_RADIO->CRCPOLY = 0x107UL; // CRC poly: x^8+x^2^x^1+1
- break;
-
- case NRF_ESB_CRC_OFF:
- break;
-
- default:
- return false;
- }
- NRF_RADIO->CRCCNF = m_config_local.crc << RADIO_CRCCNF_LEN_Pos;
- return true;
- }
- static bool update_radio_parameters()
- {
- bool params_valid = true;
- update_radio_tx_power();
- params_valid &= update_radio_bitrate();
- params_valid &= update_radio_protocol();
- params_valid &= update_radio_crc();
- update_rf_payload_format(m_config_local.payload_length);
- params_valid &= (m_config_local.retransmit_delay >= NRF_ESB_RETRANSMIT_DELAY_MIN);
- return params_valid;
- }
- static void reset_fifos()
- {
- m_tx_fifo.entry_point = 0;
- m_tx_fifo.exit_point = 0;
- m_tx_fifo.count = 0;
- m_rx_fifo.entry_point = 0;
- m_rx_fifo.exit_point = 0;
- m_rx_fifo.count = 0;
- }
- static void initialize_fifos()
- {
- reset_fifos();
- for (int i = 0; i < NRF_ESB_TX_FIFO_SIZE; i++)
- {
- m_tx_fifo.p_payload[i] = &m_tx_fifo_payload[i];
- }
- for (int i = 0; i < NRF_ESB_RX_FIFO_SIZE; i++)
- {
- m_rx_fifo.p_payload[i] = &m_rx_fifo_payload[i];
- }
- }
- uint32_t nrf_esb_skip_tx()
- {
- VERIFY_TRUE(m_esb_initialized, NRF_ERROR_INVALID_STATE);
- VERIFY_TRUE(m_tx_fifo.count > 0, NRF_ERROR_BUFFER_EMPTY);
- DISABLE_RF_IRQ();
- m_tx_fifo.count--;
- if (++m_tx_fifo.exit_point >= NRF_ESB_TX_FIFO_SIZE)
- {
- m_tx_fifo.exit_point = 0;
- }
- ENABLE_RF_IRQ();
- return NRF_SUCCESS;
- }
- /** @brief Function to push the content of the rx_buffer to the RX FIFO.
- *
- * The module will point the register NRF_RADIO->PACKETPTR to a buffer for receiving packets.
- * After receiving a packet the module will call this function to copy the received data to
- * the RX FIFO.
- *
- * @param pipe Pipe number to set for the packet.
- * @param pid Packet ID.
- *
- * @retval true Operation successful.
- * @retval false Operation failed.
- */
- static bool rx_fifo_push_rfbuf(uint8_t pipe, uint8_t pid)
- {
- if (m_rx_fifo.count < NRF_ESB_RX_FIFO_SIZE)
- {
- if (m_config_local.protocol == NRF_ESB_PROTOCOL_ESB_DPL)
- {
- if (m_rx_payload_buffer[0] > NRF_ESB_MAX_PAYLOAD_LENGTH)
- {
- return false;
- }
- m_rx_fifo.p_payload[m_rx_fifo.entry_point]->length = m_rx_payload_buffer[0];
- }
- else if (m_config_local.mode == NRF_ESB_MODE_PTX)
- {
- // Received packet is an acknowledgment
- m_rx_fifo.p_payload[m_rx_fifo.entry_point]->length = 0;
- }
- else
- {
- m_rx_fifo.p_payload[m_rx_fifo.entry_point]->length = m_config_local.payload_length;
- }
- memcpy(m_rx_fifo.p_payload[m_rx_fifo.entry_point]->data, &m_rx_payload_buffer[2],
- m_rx_fifo.p_payload[m_rx_fifo.entry_point]->length);
- m_rx_fifo.p_payload[m_rx_fifo.entry_point]->pipe = pipe;
- m_rx_fifo.p_payload[m_rx_fifo.entry_point]->rssi = NRF_RADIO->RSSISAMPLE;
- m_rx_fifo.p_payload[m_rx_fifo.entry_point]->pid = pid;
- m_rx_fifo.p_payload[m_rx_fifo.entry_point]->noack = !(m_rx_payload_buffer[1] & 0x01);
- if (++m_rx_fifo.entry_point >= NRF_ESB_RX_FIFO_SIZE)
- {
- m_rx_fifo.entry_point = 0;
- }
- m_rx_fifo.count++;
- return true;
- }
- return false;
- }
- static void sys_timer_init()
- {
- // Configure the system timer with a 1 MHz base frequency
- NRF_ESB_SYS_TIMER->PRESCALER = 4;
- NRF_ESB_SYS_TIMER->BITMODE = TIMER_BITMODE_BITMODE_16Bit;
- NRF_ESB_SYS_TIMER->SHORTS = TIMER_SHORTS_COMPARE1_CLEAR_Msk | TIMER_SHORTS_COMPARE1_STOP_Msk;
- }
- static void ppi_init()
- {
- NRF_PPI->CH[NRF_ESB_PPI_TIMER_START].EEP = (uint32_t)&NRF_RADIO->EVENTS_READY;
- NRF_PPI->CH[NRF_ESB_PPI_TIMER_START].TEP = (uint32_t)&NRF_ESB_SYS_TIMER->TASKS_START;
- NRF_PPI->CH[NRF_ESB_PPI_TIMER_STOP].EEP = (uint32_t)&NRF_RADIO->EVENTS_ADDRESS;
- NRF_PPI->CH[NRF_ESB_PPI_TIMER_STOP].TEP = (uint32_t)&NRF_ESB_SYS_TIMER->TASKS_SHUTDOWN;
- NRF_PPI->CH[NRF_ESB_PPI_RX_TIMEOUT].EEP = (uint32_t)&NRF_ESB_SYS_TIMER->EVENTS_COMPARE[0];
- NRF_PPI->CH[NRF_ESB_PPI_RX_TIMEOUT].TEP = (uint32_t)&NRF_RADIO->TASKS_DISABLE;
- NRF_PPI->CH[NRF_ESB_PPI_TX_START].EEP = (uint32_t)&NRF_ESB_SYS_TIMER->EVENTS_COMPARE[1];
- NRF_PPI->CH[NRF_ESB_PPI_TX_START].TEP = (uint32_t)&NRF_RADIO->TASKS_TXEN;
- }
- static void start_tx_transaction()
- {
- bool ack;
- m_last_tx_attempts = 1;
- // Prepare the payload
- mp_current_payload = m_tx_fifo.p_payload[m_tx_fifo.exit_point];
- switch (m_config_local.protocol)
- {
- case NRF_ESB_PROTOCOL_ESB:
- update_rf_payload_format(mp_current_payload->length);
- m_tx_payload_buffer[0] = mp_current_payload->pid;
- m_tx_payload_buffer[1] = 0;
- memcpy(&m_tx_payload_buffer[2], mp_current_payload->data, mp_current_payload->length);
- NRF_RADIO->SHORTS = m_radio_shorts_common | RADIO_SHORTS_DISABLED_RXEN_Msk;
- NRF_RADIO->INTENSET = RADIO_INTENSET_DISABLED_Msk | RADIO_INTENSET_READY_Msk;
- // Configure the retransmit counter
- m_retransmits_remaining = m_config_local.retransmit_count;
- on_radio_disabled = on_radio_disabled_tx;
- m_nrf_esb_mainstate = NRF_ESB_STATE_PTX_TX_ACK;
- break;
- case NRF_ESB_PROTOCOL_ESB_DPL:
- ack = !mp_current_payload->noack || !m_config_local.selective_auto_ack;
- m_tx_payload_buffer[0] = mp_current_payload->length;
- m_tx_payload_buffer[1] = mp_current_payload->pid << 1;
- m_tx_payload_buffer[1] |= mp_current_payload->noack ? 0x00 : 0x01;
- memcpy(&m_tx_payload_buffer[2], mp_current_payload->data, mp_current_payload->length);
- // Handling ack if noack is set to false or if selective auto ack is turned off
- if (ack)
- {
- NRF_RADIO->SHORTS = m_radio_shorts_common | RADIO_SHORTS_DISABLED_RXEN_Msk;
- NRF_RADIO->INTENSET = RADIO_INTENSET_DISABLED_Msk | RADIO_INTENSET_READY_Msk;
- // Configure the retransmit counter
- m_retransmits_remaining = m_config_local.retransmit_count;
- on_radio_disabled = on_radio_disabled_tx;
- m_nrf_esb_mainstate = NRF_ESB_STATE_PTX_TX_ACK;
- }
- else
- {
- NRF_RADIO->SHORTS = m_radio_shorts_common;
- NRF_RADIO->INTENSET = RADIO_INTENSET_DISABLED_Msk;
- on_radio_disabled = on_radio_disabled_tx_noack;
- m_nrf_esb_mainstate = NRF_ESB_STATE_PTX_TX;
- }
- break;
- default:
- // Should not be reached
- break;
- }
- NRF_RADIO->TXADDRESS = mp_current_payload->pipe;
- NRF_RADIO->RXADDRESSES = 1 << mp_current_payload->pipe;
- NRF_RADIO->FREQUENCY = m_esb_addr.rf_channel;
- NRF_RADIO->PACKETPTR = (uint32_t)m_tx_payload_buffer;
- NVIC_ClearPendingIRQ(RADIO_IRQn);
- NVIC_EnableIRQ(RADIO_IRQn);
- NRF_RADIO->EVENTS_ADDRESS = 0;
- NRF_RADIO->EVENTS_PAYLOAD = 0;
- NRF_RADIO->EVENTS_DISABLED = 0;
- DEBUG_PIN_SET(DEBUGPIN4);
- NRF_RADIO->TASKS_TXEN = 1;
- }
- static void on_radio_disabled_tx_noack()
- {
- m_interrupt_flags |= NRF_ESB_INT_TX_SUCCESS_MSK;
- (void) nrf_esb_skip_tx();
- if (m_tx_fifo.count == 0)
- {
- m_nrf_esb_mainstate = NRF_ESB_STATE_IDLE;
- NVIC_SetPendingIRQ(ESB_EVT_IRQ);
- }
- else
- {
- NVIC_SetPendingIRQ(ESB_EVT_IRQ);
- start_tx_transaction();
- }
- }
- static void on_radio_disabled_tx()
- {
- // Remove the DISABLED -> RXEN shortcut, to make sure the radio stays
- // disabled after the RX window
- NRF_RADIO->SHORTS = m_radio_shorts_common;
- // Make sure the timer is started the next time the radio is ready,
- // and that it will disable the radio automatically if no packet is
- // received by the time defined in m_wait_for_ack_timeout_us
- NRF_ESB_SYS_TIMER->CC[0] = m_wait_for_ack_timeout_us;
- NRF_ESB_SYS_TIMER->CC[1] = m_config_local.retransmit_delay - 130;
- NRF_ESB_SYS_TIMER->TASKS_CLEAR = 1;
- NRF_ESB_SYS_TIMER->EVENTS_COMPARE[0] = 0;
- NRF_ESB_SYS_TIMER->EVENTS_COMPARE[1] = 0;
- NRF_PPI->CHENSET = (1 << NRF_ESB_PPI_TIMER_START) |
- (1 << NRF_ESB_PPI_RX_TIMEOUT) |
- (1 << NRF_ESB_PPI_TIMER_STOP);
- NRF_PPI->CHENCLR = (1 << NRF_ESB_PPI_TX_START);
- NRF_RADIO->EVENTS_END = 0;
- if (m_config_local.protocol == NRF_ESB_PROTOCOL_ESB)
- {
- update_rf_payload_format(0);
- }
- NRF_RADIO->PACKETPTR = (uint32_t)m_rx_payload_buffer;
- on_radio_disabled = on_radio_disabled_tx_wait_for_ack;
- m_nrf_esb_mainstate = NRF_ESB_STATE_PTX_RX_ACK;
- }
- static void on_radio_disabled_tx_wait_for_ack()
- {
- // This marks the completion of a TX_RX sequence (TX with ACK)
- // Make sure the timer will not deactivate the radio if a packet is received
- NRF_PPI->CHENCLR = (1 << NRF_ESB_PPI_TIMER_START) |
- (1 << NRF_ESB_PPI_RX_TIMEOUT) |
- (1 << NRF_ESB_PPI_TIMER_STOP);
- // If the radio has received a packet and the CRC status is OK
- if (NRF_RADIO->EVENTS_END && NRF_RADIO->CRCSTATUS != 0)
- {
- NRF_ESB_SYS_TIMER->TASKS_SHUTDOWN = 1;
- NRF_PPI->CHENCLR = (1 << NRF_ESB_PPI_TX_START);
- m_interrupt_flags |= NRF_ESB_INT_TX_SUCCESS_MSK;
- m_last_tx_attempts = m_config_local.retransmit_count - m_retransmits_remaining + 1;
- (void) nrf_esb_skip_tx();
- if (m_config_local.protocol != NRF_ESB_PROTOCOL_ESB && m_rx_payload_buffer[0] > 0)
- {
- if (rx_fifo_push_rfbuf((uint8_t)NRF_RADIO->TXADDRESS, m_rx_payload_buffer[1] >> 1))
- {
- m_interrupt_flags |= NRF_ESB_INT_RX_DATA_RECEIVED_MSK;
- }
- }
- if ((m_tx_fifo.count == 0) || (m_config_local.tx_mode == NRF_ESB_TXMODE_MANUAL))
- {
- m_nrf_esb_mainstate = NRF_ESB_STATE_IDLE;
- NVIC_SetPendingIRQ(ESB_EVT_IRQ);
- }
- else
- {
- NVIC_SetPendingIRQ(ESB_EVT_IRQ);
- start_tx_transaction();
- }
- }
- else
- {
- if (m_retransmits_remaining-- == 0)
- {
- NRF_ESB_SYS_TIMER->TASKS_SHUTDOWN = 1;
- NRF_PPI->CHENCLR = (1 << NRF_ESB_PPI_TX_START);
- // All retransmits are expended, and the TX operation is suspended
- m_last_tx_attempts = m_config_local.retransmit_count + 1;
- m_interrupt_flags |= NRF_ESB_INT_TX_FAILED_MSK;
- m_nrf_esb_mainstate = NRF_ESB_STATE_IDLE;
- NVIC_SetPendingIRQ(ESB_EVT_IRQ);
- }
- else
- {
- // There are still more retransmits left, TX mode should be
- // entered again as soon as the system timer reaches CC[1].
- NRF_RADIO->SHORTS = m_radio_shorts_common | RADIO_SHORTS_DISABLED_RXEN_Msk;
- update_rf_payload_format(mp_current_payload->length);
- NRF_RADIO->PACKETPTR = (uint32_t)m_tx_payload_buffer;
- on_radio_disabled = on_radio_disabled_tx;
- m_nrf_esb_mainstate = NRF_ESB_STATE_PTX_TX_ACK;
- NRF_ESB_SYS_TIMER->TASKS_START = 1;
- NRF_PPI->CHENSET = (1 << NRF_ESB_PPI_TX_START);
- if (NRF_ESB_SYS_TIMER->EVENTS_COMPARE[1])
- {
- NRF_RADIO->TASKS_TXEN = 1;
- }
- }
- }
- }
- static void clear_events_restart_rx(void)
- {
- NRF_RADIO->SHORTS = m_radio_shorts_common;
- update_rf_payload_format(m_config_local.payload_length);
- NRF_RADIO->PACKETPTR = (uint32_t)m_rx_payload_buffer;
- NRF_RADIO->EVENTS_DISABLED = 0;
- NRF_RADIO->TASKS_DISABLE = 1;
- while (NRF_RADIO->EVENTS_DISABLED == 0);
- NRF_RADIO->EVENTS_DISABLED = 0;
- NRF_RADIO->SHORTS = m_radio_shorts_common | RADIO_SHORTS_DISABLED_TXEN_Msk;
- NRF_RADIO->TASKS_RXEN = 1;
- }
- static void on_radio_disabled_rx(void)
- {
- bool ack = false;
- bool retransmit_payload = false;
- bool send_rx_event = true;
- pipe_info_t * p_pipe_info;
- if (NRF_RADIO->CRCSTATUS == 0)
- {
- clear_events_restart_rx();
- return;
- }
- if (m_rx_fifo.count >= NRF_ESB_RX_FIFO_SIZE)
- {
- clear_events_restart_rx();
- return;
- }
- p_pipe_info = &m_rx_pipe_info[NRF_RADIO->RXMATCH];
- if (NRF_RADIO->RXCRC == p_pipe_info->crc &&
- (m_rx_payload_buffer[1] >> 1) == p_pipe_info->pid
- )
- {
- retransmit_payload = true;
- send_rx_event = false;
- }
- p_pipe_info->pid = m_rx_payload_buffer[1] >> 1;
- p_pipe_info->crc = NRF_RADIO->RXCRC;
- if ((m_config_local.selective_auto_ack == false) || ((m_rx_payload_buffer[1] & 0x01) == 1))
- {
- ack = true;
- }
- if (ack)
- {
- NRF_RADIO->SHORTS = m_radio_shorts_common | RADIO_SHORTS_DISABLED_RXEN_Msk;
- switch (m_config_local.protocol)
- {
- case NRF_ESB_PROTOCOL_ESB_DPL:
- {
- if (m_tx_fifo.count > 0 &&
- (m_tx_fifo.p_payload[m_tx_fifo.exit_point]->pipe == NRF_RADIO->RXMATCH)
- )
- {
- // Pipe stays in ACK with payload until TX FIFO is empty
- // Do not report TX success on first ack payload or retransmit
- if (p_pipe_info->ack_payload == true && !retransmit_payload)
- {
- if (++m_tx_fifo.exit_point >= NRF_ESB_TX_FIFO_SIZE)
- {
- m_tx_fifo.exit_point = 0;
- }
- m_tx_fifo.count--;
- // ACK payloads also require TX_DS
- // (page 40 of the 'nRF24LE1_Product_Specification_rev1_6.pdf').
- m_interrupt_flags |= NRF_ESB_INT_TX_SUCCESS_MSK;
- }
- p_pipe_info->ack_payload = true;
- mp_current_payload = m_tx_fifo.p_payload[m_tx_fifo.exit_point];
- update_rf_payload_format(mp_current_payload->length);
- m_tx_payload_buffer[0] = mp_current_payload->length;
- memcpy(&m_tx_payload_buffer[2],
- mp_current_payload->data,
- mp_current_payload->length);
- }
- else
- {
- p_pipe_info->ack_payload = false;
- update_rf_payload_format(0);
- m_tx_payload_buffer[0] = 0;
- }
- m_tx_payload_buffer[1] = m_rx_payload_buffer[1];
- }
- break;
- case NRF_ESB_PROTOCOL_ESB:
- {
- update_rf_payload_format(0);
- m_tx_payload_buffer[0] = m_rx_payload_buffer[0];
- m_tx_payload_buffer[1] = 0;
- }
- break;
- }
- m_nrf_esb_mainstate = NRF_ESB_STATE_PRX_SEND_ACK;
- NRF_RADIO->TXADDRESS = NRF_RADIO->RXMATCH;
- NRF_RADIO->PACKETPTR = (uint32_t)m_tx_payload_buffer;
- on_radio_disabled = on_radio_disabled_rx_ack;
- }
- else
- {
- clear_events_restart_rx();
- }
- if (send_rx_event)
- {
- // Push the new packet to the RX buffer and trigger a received event if the operation was
- // successful.
- if (rx_fifo_push_rfbuf(NRF_RADIO->RXMATCH, p_pipe_info->pid))
- {
- m_interrupt_flags |= NRF_ESB_INT_RX_DATA_RECEIVED_MSK;
- NVIC_SetPendingIRQ(ESB_EVT_IRQ);
- }
- }
- }
- static void on_radio_disabled_rx_ack(void)
- {
- NRF_RADIO->SHORTS = m_radio_shorts_common | RADIO_SHORTS_DISABLED_TXEN_Msk;
- update_rf_payload_format(m_config_local.payload_length);
- NRF_RADIO->PACKETPTR = (uint32_t)m_rx_payload_buffer;
- on_radio_disabled = on_radio_disabled_rx;
- m_nrf_esb_mainstate = NRF_ESB_STATE_PRX;
- }
- /**@brief Function for clearing pending interrupts.
- *
- * @param[in,out] p_interrupts Pointer to the value that holds the current interrupts.
- *
- * @retval NRF_SUCCESS If the interrupts were cleared successfully.
- * @retval NRF_ERROR_NULL If the required parameter was NULL.
- * @retval NRF_INVALID_STATE If the module is not initialized.
- */
- static uint32_t nrf_esb_get_clear_interrupts(uint32_t * p_interrupts)
- {
- VERIFY_TRUE(m_esb_initialized, NRF_ERROR_INVALID_STATE);
- VERIFY_PARAM_NOT_NULL(p_interrupts);
- DISABLE_RF_IRQ();
- *p_interrupts = m_interrupt_flags;
- m_interrupt_flags = 0;
- ENABLE_RF_IRQ();
- return NRF_SUCCESS;
- }
- void RADIO_IRQHandler()
- {
- if (NRF_RADIO->EVENTS_READY && (NRF_RADIO->INTENSET & RADIO_INTENSET_READY_Msk))
- {
- NRF_RADIO->EVENTS_READY = 0;
- DEBUG_PIN_SET(DEBUGPIN1);
- }
- if (NRF_RADIO->EVENTS_END && (NRF_RADIO->INTENSET & RADIO_INTENSET_END_Msk))
- {
- NRF_RADIO->EVENTS_END = 0;
- DEBUG_PIN_SET(DEBUGPIN2);
- // Call the correct on_radio_end function, depending on the current protocol state
- if (on_radio_end)
- {
- on_radio_end();
- }
- }
- if (NRF_RADIO->EVENTS_DISABLED && (NRF_RADIO->INTENSET & RADIO_INTENSET_DISABLED_Msk))
- {
- NRF_RADIO->EVENTS_DISABLED = 0;
- DEBUG_PIN_SET(DEBUGPIN3);
- // Call the correct on_radio_disable function, depending on the current protocol state
- if (on_radio_disabled)
- {
- on_radio_disabled();
- }
- }
- DEBUG_PIN_CLR(DEBUGPIN1);
- DEBUG_PIN_CLR(DEBUGPIN2);
- DEBUG_PIN_CLR(DEBUGPIN3);
- DEBUG_PIN_CLR(DEBUGPIN4);
- }
- uint32_t nrf_esb_init(nrf_esb_config_t const * p_config)
- {
- uint32_t err_code;
- VERIFY_PARAM_NOT_NULL(p_config);
- if (m_esb_initialized)
- {
- err_code = nrf_esb_disable();
- if (err_code != NRF_SUCCESS)
- {
- return err_code;
- }
- }
- m_event_handler = p_config->event_handler;
- memcpy(&m_config_local, p_config, sizeof(nrf_esb_config_t));
-
- m_interrupt_flags = 0;
- memset(m_rx_pipe_info, 0, sizeof(m_rx_pipe_info));
- memset(m_pids, 0, sizeof(m_pids));
- VERIFY_TRUE(update_radio_parameters(), NRF_ERROR_INVALID_PARAM);
- // Configure radio address registers according to ESB default values
- NRF_RADIO->BASE0 = 0xE7E7E7E7;
- NRF_RADIO->BASE1 = 0x43434343;
- NRF_RADIO->PREFIX0 = 0x23C343E7;
- NRF_RADIO->PREFIX1 = 0x13E363A3;
-
- initialize_fifos();
- sys_timer_init();
- ppi_init();
- NVIC_SetPriority(RADIO_IRQn, m_config_local.radio_irq_priority & ESB_IRQ_PRIORITY_MSK);
- NVIC_SetPriority(ESB_EVT_IRQ, m_config_local.event_irq_priority & ESB_IRQ_PRIORITY_MSK);
- NVIC_EnableIRQ(ESB_EVT_IRQ);
- m_nrf_esb_mainstate = NRF_ESB_STATE_IDLE;
- m_esb_initialized = true;
- #ifdef NRF52832_XXAA
- if ((NRF_FICR->INFO.VARIANT & 0x0000FF00) == 0x00004500) //Check if the device is an nRF52832 Rev. 2.
- //Workaround for nRF52832 rev 2 errata 182
- *(volatile uint32_t *) 0x4000173C |= (1 << 10);
- #endif
- return NRF_SUCCESS;
- }
- uint32_t nrf_esb_suspend(void)
- {
- VERIFY_TRUE(m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE, NRF_ERROR_BUSY);
- // Clear PPI
- NRF_PPI->CHENCLR = (1 << NRF_ESB_PPI_TIMER_START) |
- (1 << NRF_ESB_PPI_TIMER_STOP) |
- (1 << NRF_ESB_PPI_RX_TIMEOUT) |
- (1 << NRF_ESB_PPI_TX_START);
- m_nrf_esb_mainstate = NRF_ESB_STATE_IDLE;
- return NRF_SUCCESS;
- }
- uint32_t nrf_esb_disable(void)
- {
- // Clear PPI
- NRF_PPI->CHENCLR = (1 << NRF_ESB_PPI_TIMER_START) |
- (1 << NRF_ESB_PPI_TIMER_STOP) |
- (1 << NRF_ESB_PPI_RX_TIMEOUT) |
- (1 << NRF_ESB_PPI_TX_START);
- m_nrf_esb_mainstate = NRF_ESB_STATE_IDLE;
- m_esb_initialized = false;
- reset_fifos();
- memset(m_rx_pipe_info, 0, sizeof(m_rx_pipe_info));
- memset(m_pids, 0, sizeof(m_pids));
- // Disable the radio
- NVIC_DisableIRQ(ESB_EVT_IRQ);
- NRF_RADIO->SHORTS = RADIO_SHORTS_READY_START_Enabled << RADIO_SHORTS_READY_START_Pos |
- RADIO_SHORTS_END_DISABLE_Enabled << RADIO_SHORTS_END_DISABLE_Pos;
- return NRF_SUCCESS;
- }
- bool nrf_esb_is_idle(void)
- {
- return m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE;
- }
- void ESB_EVT_IRQHandler(void)
- {
- ret_code_t err_code;
- uint32_t interrupts;
- nrf_esb_evt_t event;
- event.tx_attempts = m_last_tx_attempts;
- err_code = nrf_esb_get_clear_interrupts(&interrupts);
- if (err_code == NRF_SUCCESS && m_event_handler != 0)
- {
- if (interrupts & NRF_ESB_INT_TX_SUCCESS_MSK)
- {
- event.evt_id = NRF_ESB_EVENT_TX_SUCCESS;
- m_event_handler(&event);
- }
- if (interrupts & NRF_ESB_INT_TX_FAILED_MSK)
- {
- event.evt_id = NRF_ESB_EVENT_TX_FAILED;
- m_event_handler(&event);
- }
- if (interrupts & NRF_ESB_INT_RX_DATA_RECEIVED_MSK)
- {
- event.evt_id = NRF_ESB_EVENT_RX_RECEIVED;
- m_event_handler(&event);
- }
- }
- }
- uint32_t nrf_esb_write_payload(nrf_esb_payload_t const * p_payload)
- {
- VERIFY_TRUE(m_esb_initialized, NRF_ERROR_INVALID_STATE);
- VERIFY_PARAM_NOT_NULL(p_payload);
- VERIFY_PAYLOAD_LENGTH(p_payload);
- VERIFY_FALSE(m_tx_fifo.count >= NRF_ESB_TX_FIFO_SIZE, NRF_ERROR_NO_MEM);
- VERIFY_TRUE(p_payload->pipe < NRF_ESB_PIPE_COUNT, NRF_ERROR_INVALID_PARAM);
- DISABLE_RF_IRQ();
- memcpy(m_tx_fifo.p_payload[m_tx_fifo.entry_point], p_payload, sizeof(nrf_esb_payload_t));
- m_pids[p_payload->pipe] = (m_pids[p_payload->pipe] + 1) % (NRF_ESB_PID_MAX + 1);
- m_tx_fifo.p_payload[m_tx_fifo.entry_point]->pid = m_pids[p_payload->pipe];
- if (++m_tx_fifo.entry_point >= NRF_ESB_TX_FIFO_SIZE)
- {
- m_tx_fifo.entry_point = 0;
- }
- m_tx_fifo.count++;
- ENABLE_RF_IRQ();
- if (m_config_local.mode == NRF_ESB_MODE_PTX &&
- m_config_local.tx_mode == NRF_ESB_TXMODE_AUTO &&
- m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE)
- {
- start_tx_transaction();
- }
- return NRF_SUCCESS;
- }
- uint32_t nrf_esb_read_rx_payload(nrf_esb_payload_t * p_payload)
- {
- VERIFY_TRUE(m_esb_initialized, NRF_ERROR_INVALID_STATE);
- VERIFY_PARAM_NOT_NULL(p_payload);
- if (m_rx_fifo.count == 0)
- {
- return NRF_ERROR_NOT_FOUND;
- }
- DISABLE_RF_IRQ();
- p_payload->length = m_rx_fifo.p_payload[m_rx_fifo.exit_point]->length;
- p_payload->pipe = m_rx_fifo.p_payload[m_rx_fifo.exit_point]->pipe;
- p_payload->rssi = m_rx_fifo.p_payload[m_rx_fifo.exit_point]->rssi;
- p_payload->pid = m_rx_fifo.p_payload[m_rx_fifo.exit_point]->pid;
- p_payload->noack = m_rx_fifo.p_payload[m_rx_fifo.exit_point]->noack;
- memcpy(p_payload->data, m_rx_fifo.p_payload[m_rx_fifo.exit_point]->data, p_payload->length);
- if (++m_rx_fifo.exit_point >= NRF_ESB_RX_FIFO_SIZE)
- {
- m_rx_fifo.exit_point = 0;
- }
- m_rx_fifo.count--;
- ENABLE_RF_IRQ();
- return NRF_SUCCESS;
- }
- uint32_t nrf_esb_start_tx(void)
- {
- VERIFY_TRUE(m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE, NRF_ERROR_BUSY);
- if (m_tx_fifo.count == 0)
- {
- return NRF_ERROR_BUFFER_EMPTY;
- }
- start_tx_transaction();
- return NRF_SUCCESS;
- }
- uint32_t nrf_esb_start_rx(void)
- {
- VERIFY_TRUE(m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE, NRF_ERROR_BUSY);
- NRF_RADIO->INTENCLR = 0xFFFFFFFF;
- NRF_RADIO->EVENTS_DISABLED = 0;
- on_radio_disabled = on_radio_disabled_rx;
- NRF_RADIO->SHORTS = m_radio_shorts_common | RADIO_SHORTS_DISABLED_TXEN_Msk;
- NRF_RADIO->INTENSET = RADIO_INTENSET_DISABLED_Msk;
- m_nrf_esb_mainstate = NRF_ESB_STATE_PRX;
- NRF_RADIO->RXADDRESSES = m_esb_addr.rx_pipes_enabled;
- NRF_RADIO->FREQUENCY = m_esb_addr.rf_channel;
- NRF_RADIO->PACKETPTR = (uint32_t)m_rx_payload_buffer;
- NVIC_ClearPendingIRQ(RADIO_IRQn);
- NVIC_EnableIRQ(RADIO_IRQn);
- NRF_RADIO->EVENTS_ADDRESS = 0;
- NRF_RADIO->EVENTS_PAYLOAD = 0;
- NRF_RADIO->EVENTS_DISABLED = 0;
- NRF_RADIO->TASKS_RXEN = 1;
- return NRF_SUCCESS;
- }
- uint32_t nrf_esb_stop_rx(void)
- {
- if (m_nrf_esb_mainstate == NRF_ESB_STATE_PRX)
- {
- NRF_RADIO->SHORTS = 0;
- NRF_RADIO->INTENCLR = 0xFFFFFFFF;
- on_radio_disabled = NULL;
- NRF_RADIO->EVENTS_DISABLED = 0;
- NRF_RADIO->TASKS_DISABLE = 1;
- while (NRF_RADIO->EVENTS_DISABLED == 0);
- m_nrf_esb_mainstate = NRF_ESB_STATE_IDLE;
- return NRF_SUCCESS;
- }
- return NRF_ESB_ERROR_NOT_IN_RX_MODE;
- }
- uint32_t nrf_esb_flush_tx(void)
- {
- VERIFY_TRUE(m_esb_initialized, NRF_ERROR_INVALID_STATE);
- DISABLE_RF_IRQ();
- m_tx_fifo.count = 0;
- m_tx_fifo.entry_point = 0;
- m_tx_fifo.exit_point = 0;
- ENABLE_RF_IRQ();
- return NRF_SUCCESS;
- }
- uint32_t nrf_esb_pop_tx(void)
- {
- VERIFY_TRUE(m_esb_initialized, NRF_ERROR_INVALID_STATE);
- VERIFY_TRUE(m_tx_fifo.count > 0, NRF_ERROR_BUFFER_EMPTY);
- DISABLE_RF_IRQ();
- if (--m_tx_fifo.entry_point >= NRF_ESB_TX_FIFO_SIZE)
- {
- m_tx_fifo.entry_point = 0;
- }
- m_tx_fifo.count--;
- ENABLE_RF_IRQ();
- return NRF_SUCCESS;
- }
- uint32_t nrf_esb_flush_rx(void)
- {
- VERIFY_TRUE(m_esb_initialized, NRF_ERROR_INVALID_STATE);
- DISABLE_RF_IRQ();
- m_rx_fifo.count = 0;
- m_rx_fifo.entry_point = 0;
- m_rx_fifo.exit_point = 0;
- memset(m_rx_pipe_info, 0, sizeof(m_rx_pipe_info));
- ENABLE_RF_IRQ();
- return NRF_SUCCESS;
- }
- uint32_t nrf_esb_set_address_length(uint8_t length)
- {
- VERIFY_TRUE(m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE, NRF_ERROR_BUSY);
- VERIFY_TRUE(length > 2 && length < 6, NRF_ERROR_INVALID_PARAM);
-
- #ifdef NRF52832_XXAA
- uint32_t base_address_mask = length == 5 ? 0xFFFF0000 : 0xFF000000;
- if ((NRF_FICR->INFO.VARIANT & 0x0000FF00) == 0x00004200) //Check if the device is an nRF52832 Rev. 1.
- {
- /*
- Workaround for nRF52832 Rev 1 Errata 107
- Check if pipe 0 or pipe 1-7 has a 'zero address'.
- Avoid using access addresses in the following pattern (where X is don't care):
- ADDRLEN=5
- BASE0 = 0x0000XXXX, PREFIX0 = 0xXXXXXX00
- BASE1 = 0x0000XXXX, PREFIX0 = 0xXXXX00XX
- BASE1 = 0x0000XXXX, PREFIX0 = 0xXX00XXXX
- BASE1 = 0x0000XXXX, PREFIX0 = 0x00XXXXXX
- BASE1 = 0x0000XXXX, PREFIX1 = 0xXXXXXX00
- BASE1 = 0x0000XXXX, PREFIX1 = 0xXXXX00XX
- BASE1 = 0x0000XXXX, PREFIX1 = 0xXX00XXXX
- BASE1 = 0x0000XXXX, PREFIX1 = 0x00XXXXXX
- ADDRLEN=4
- BASE0 = 0x00XXXXXX, PREFIX0 = 0xXXXXXX00
- BASE1 = 0x00XXXXXX, PREFIX0 = 0xXXXX00XX
- BASE1 = 0x00XXXXXX, PREFIX0 = 0xXX00XXXX
- BASE1 = 0x00XXXXXX, PREFIX0 = 0x00XXXXXX
- BASE1 = 0x00XXXXXX, PREFIX1 = 0xXXXXXX00
- BASE1 = 0x00XXXXXX, PREFIX1 = 0xXXXX00XX
- BASE1 = 0x00XXXXXX, PREFIX1 = 0xXX00XXXX
- BASE1 = 0x00XXXXXX, PREFIX1 = 0x00XXXXXX
- */
- if ((NRF_RADIO->BASE0 & base_address_mask) == 0 && (NRF_RADIO->PREFIX0 & 0x000000FF) == 0)
- {
- return NRF_ERROR_INVALID_PARAM;
- }
- if ((NRF_RADIO->BASE1 & base_address_mask) == 0 && ((NRF_RADIO->PREFIX0 & 0x0000FF00) == 0 ||(NRF_RADIO->PREFIX0 & 0x00FF0000) == 0 || (NRF_RADIO->PREFIX0 & 0xFF000000) == 0 ||
- (NRF_RADIO->PREFIX1 & 0xFF000000) == 0 || (NRF_RADIO->PREFIX1 & 0x00FF0000) == 0 ||(NRF_RADIO->PREFIX1 & 0x0000FF00) == 0 || (NRF_RADIO->PREFIX1 & 0x000000FF) == 0))
- {
- return NRF_ERROR_INVALID_PARAM;
- }
- }
- #endif
- m_esb_addr.addr_length = length;
- update_rf_payload_format(m_config_local.payload_length);
- #ifdef NRF52832_XXAA
- if ((NRF_FICR->INFO.VARIANT & 0x0000FF00) == 0x00004500) //Check if the device is an nRF52832 Rev. 2.
- {
- return apply_address_workarounds();
- }
- else
- {
- return NRF_SUCCESS;
- }
- #else
- return NRF_SUCCESS;
- #endif
- }
- uint32_t nrf_esb_set_base_address_0(uint8_t const * p_addr)
- {
- VERIFY_TRUE(m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE, NRF_ERROR_BUSY);
- VERIFY_PARAM_NOT_NULL(p_addr);
- #ifdef NRF52832_XXAA
- if ((NRF_FICR->INFO.VARIANT & 0x0000FF00) == 0x00004200) //Check if the device is an nRF52832 Rev. 1.
- {
- /*
- Workaround for nRF52832 Rev 1 Errata 107
- Check if pipe 0 or pipe 1-7 has a 'zero address'.
- Avoid using access addresses in the following pattern (where X is don't care):
- ADDRLEN=5
- BASE0 = 0x0000XXXX, PREFIX0 = 0xXXXXXX00
- BASE1 = 0x0000XXXX, PREFIX0 = 0xXXXX00XX
- BASE1 = 0x0000XXXX, PREFIX0 = 0xXX00XXXX
- BASE1 = 0x0000XXXX, PREFIX0 = 0x00XXXXXX
- BASE1 = 0x0000XXXX, PREFIX1 = 0xXXXXXX00
- BASE1 = 0x0000XXXX, PREFIX1 = 0xXXXX00XX
- BASE1 = 0x0000XXXX, PREFIX1 = 0xXX00XXXX
- BASE1 = 0x0000XXXX, PREFIX1 = 0x00XXXXXX
- ADDRLEN=4
- BASE0 = 0x00XXXXXX, PREFIX0 = 0xXXXXXX00
- BASE1 = 0x00XXXXXX, PREFIX0 = 0xXXXX00XX
- BASE1 = 0x00XXXXXX, PREFIX0 = 0xXX00XXXX
- BASE1 = 0x00XXXXXX, PREFIX0 = 0x00XXXXXX
- BASE1 = 0x00XXXXXX, PREFIX1 = 0xXXXXXX00
- BASE1 = 0x00XXXXXX, PREFIX1 = 0xXXXX00XX
- BASE1 = 0x00XXXXXX, PREFIX1 = 0xXX00XXXX
- BASE1 = 0x00XXXXXX, PREFIX1 = 0x00XXXXXX
- */
- uint32_t base_address_mask = m_esb_addr.addr_length == 5 ? 0xFFFF0000 : 0xFF000000;
- if ((addr_conv(p_addr) & base_address_mask) == 0 && (NRF_RADIO->PREFIX0 & 0x000000FF) == 0)
- {
- return NRF_ERROR_INVALID_PARAM;
- }
- }
- #endif
- memcpy(m_esb_addr.base_addr_p0, p_addr, 4);
- update_radio_addresses(NRF_ESB_ADDR_UPDATE_MASK_BASE0);
- #ifdef NRF52832_XXAA
- return apply_address_workarounds();
- #else
- return NRF_SUCCESS;
- #endif
- }
- uint32_t nrf_esb_set_base_address_1(uint8_t const * p_addr)
- {
- VERIFY_TRUE(m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE, NRF_ERROR_BUSY);
- VERIFY_PARAM_NOT_NULL(p_addr);
- #ifdef NRF52832_XXAA
- if ((NRF_FICR->INFO.VARIANT & 0x0000FF00) == 0x00004200) //Check if the device is an nRF52832 Rev. 1.
- {
- /*
- Workaround for nRF52832 Rev 1 Errata 107
- Check if pipe 0 or pipe 1-7 has a 'zero address'.
- Avoid using access addresses in the following pattern (where X is don't care):
- ADDRLEN=5
- BASE0 = 0x0000XXXX, PREFIX0 = 0xXXXXXX00
- BASE1 = 0x0000XXXX, PREFIX0 = 0xXXXX00XX
- BASE1 = 0x0000XXXX, PREFIX0 = 0xXX00XXXX
- BASE1 = 0x0000XXXX, PREFIX0 = 0x00XXXXXX
- BASE1 = 0x0000XXXX, PREFIX1 = 0xXXXXXX00
- BASE1 = 0x0000XXXX, PREFIX1 = 0xXXXX00XX
- BASE1 = 0x0000XXXX, PREFIX1 = 0xXX00XXXX
- BASE1 = 0x0000XXXX, PREFIX1 = 0x00XXXXXX
- ADDRLEN=4
- BASE0 = 0x00XXXXXX, PREFIX0 = 0xXXXXXX00
- BASE1 = 0x00XXXXXX, PREFIX0 = 0xXXXX00XX
- BASE1 = 0x00XXXXXX, PREFIX0 = 0xXX00XXXX
- BASE1 = 0x00XXXXXX, PREFIX0 = 0x00XXXXXX
- BASE1 = 0x00XXXXXX, PREFIX1 = 0xXXXXXX00
- BASE1 = 0x00XXXXXX, PREFIX1 = 0xXXXX00XX
- BASE1 = 0x00XXXXXX, PREFIX1 = 0xXX00XXXX
- BASE1 = 0x00XXXXXX, PREFIX1 = 0x00XXXXXX
- */
- uint32_t base_address_mask = m_esb_addr.addr_length == 5 ? 0xFFFF0000 : 0xFF000000;
- if ((addr_conv(p_addr) & base_address_mask) == 0 &&
- ((NRF_RADIO->PREFIX0 & 0x0000FF00) == 0 ||(NRF_RADIO->PREFIX0 & 0x00FF0000) == 0 ||
- (NRF_RADIO->PREFIX0 & 0xFF000000) == 0 || (NRF_RADIO->PREFIX1 & 0xFF000000) == 0 ||
- (NRF_RADIO->PREFIX1 & 0x00FF0000) == 0 ||(NRF_RADIO->PREFIX1 & 0x0000FF00) == 0 ||
- (NRF_RADIO->PREFIX1 & 0x000000FF) == 0))
- {
- return NRF_ERROR_INVALID_PARAM;
- }
- }
- #endif
- memcpy(m_esb_addr.base_addr_p1, p_addr, 4);
- update_radio_addresses(NRF_ESB_ADDR_UPDATE_MASK_BASE1);
- #ifdef NRF52832_XXAA
- return apply_address_workarounds();
- #else
- return NRF_SUCCESS;
- #endif
- }
- uint32_t nrf_esb_set_prefixes(uint8_t const * p_prefixes, uint8_t num_pipes)
- {
- VERIFY_TRUE(m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE, NRF_ERROR_BUSY);
- VERIFY_PARAM_NOT_NULL(p_prefixes);
- VERIFY_TRUE(num_pipes <= NRF_ESB_PIPE_COUNT, NRF_ERROR_INVALID_PARAM);
-
- #ifdef NRF52832_XXAA
- if ((NRF_FICR->INFO.VARIANT & 0x0000FF00) == 0x00004200) //Check if the device is an nRF52832 Rev. 1.
- {
- /*
- Workaround for nRF52832 Rev 1 Errata 107
- Check if pipe 0 or pipe 1-7 has a 'zero address'.
- Avoid using access addresses in the following pattern (where X is don't care):
- ADDRLEN=5
- BASE0 = 0x0000XXXX, PREFIX0 = 0xXXXXXX00
- BASE1 = 0x0000XXXX, PREFIX0 = 0xXXXX00XX
- BASE1 = 0x0000XXXX, PREFIX0 = 0xXX00XXXX
- BASE1 = 0x0000XXXX, PREFIX0 = 0x00XXXXXX
- BASE1 = 0x0000XXXX, PREFIX1 = 0xXXXXXX00
- BASE1 = 0x0000XXXX, PREFIX1 = 0xXXXX00XX
- BASE1 = 0x0000XXXX, PREFIX1 = 0xXX00XXXX
- BASE1 = 0x0000XXXX, PREFIX1 = 0x00XXXXXX
- ADDRLEN=4
- BASE0 = 0x00XXXXXX, PREFIX0 = 0xXXXXXX00
- BASE1 = 0x00XXXXXX, PREFIX0 = 0xXXXX00XX
- BASE1 = 0x00XXXXXX, PREFIX0 = 0xXX00XXXX
- BASE1 = 0x00XXXXXX, PREFIX0 = 0x00XXXXXX
- BASE1 = 0x00XXXXXX, PREFIX1 = 0xXXXXXX00
- BASE1 = 0x00XXXXXX, PREFIX1 = 0xXXXX00XX
- BASE1 = 0x00XXXXXX, PREFIX1 = 0xXX00XXXX
- BASE1 = 0x00XXXXXX, PREFIX1 = 0x00XXXXXX
- */
- uint32_t base_address_mask = m_esb_addr.addr_length == 5 ? 0xFFFF0000 : 0xFF000000;
- if (num_pipes >= 1 && (NRF_RADIO->BASE0 & base_address_mask) == 0 && p_prefixes[0] == 0)
- {
- return NRF_ERROR_INVALID_PARAM;
- }
- if ((NRF_RADIO->BASE1 & base_address_mask) == 0)
- {
- for (uint8_t i = 1; i < num_pipes; i++)
- {
- if (p_prefixes[i] == 0)
- {
- return NRF_ERROR_INVALID_PARAM;
- }
- }
- }
- }
- #endif
-
- memcpy(m_esb_addr.pipe_prefixes, p_prefixes, num_pipes);
- m_esb_addr.num_pipes = num_pipes;
- m_esb_addr.rx_pipes_enabled = BIT_MASK_UINT_8(num_pipes);
- update_radio_addresses(NRF_ESB_ADDR_UPDATE_MASK_PREFIX);
- #ifdef NRF52832_XXAA
- return apply_address_workarounds();
- #else
- return NRF_SUCCESS;
- #endif
- }
- uint32_t nrf_esb_update_prefix(uint8_t pipe, uint8_t prefix)
- {
- VERIFY_TRUE(m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE, NRF_ERROR_BUSY);
- VERIFY_TRUE(pipe < NRF_ESB_PIPE_COUNT, NRF_ERROR_INVALID_PARAM);
-
- #ifdef NRF52832_XXAA
- if ((NRF_FICR->INFO.VARIANT & 0x0000FF00) == 0x00004200) //Check if the device is an nRF52832 Rev. 1.
- {
- /*
- Workaround for nRF52832 Rev 1 Errata 107
- Check if pipe 0 or pipe 1-7 has a 'zero address'.
- Avoid using access addresses in the following pattern (where X is don't care):
- ADDRLEN=5
- BASE0 = 0x0000XXXX, PREFIX0 = 0xXXXXXX00
- BASE1 = 0x0000XXXX, PREFIX0 = 0xXXXX00XX
- BASE1 = 0x0000XXXX, PREFIX0 = 0xXX00XXXX
- BASE1 = 0x0000XXXX, PREFIX0 = 0x00XXXXXX
- BASE1 = 0x0000XXXX, PREFIX1 = 0xXXXXXX00
- BASE1 = 0x0000XXXX, PREFIX1 = 0xXXXX00XX
- BASE1 = 0x0000XXXX, PREFIX1 = 0xXX00XXXX
- BASE1 = 0x0000XXXX, PREFIX1 = 0x00XXXXXX
- ADDRLEN=4
- BASE0 = 0x00XXXXXX, PREFIX0 = 0xXXXXXX00
- BASE1 = 0x00XXXXXX, PREFIX0 = 0xXXXX00XX
- BASE1 = 0x00XXXXXX, PREFIX0 = 0xXX00XXXX
- BASE1 = 0x00XXXXXX, PREFIX0 = 0x00XXXXXX
- BASE1 = 0x00XXXXXX, PREFIX1 = 0xXXXXXX00
- BASE1 = 0x00XXXXXX, PREFIX1 = 0xXXXX00XX
- BASE1 = 0x00XXXXXX, PREFIX1 = 0xXX00XXXX
- BASE1 = 0x00XXXXXX, PREFIX1 = 0x00XXXXXX
- */
- uint32_t base_address_mask = m_esb_addr.addr_length == 5 ? 0xFFFF0000 : 0xFF000000;
- if (pipe == 0)
- {
- if ((NRF_RADIO->BASE0 & base_address_mask) == 0 && prefix == 0)
- {
- return NRF_ERROR_INVALID_PARAM;
- }
- }
- else
- {
- if ((NRF_RADIO->BASE1 & base_address_mask) == 0 && prefix == 0)
- {
- return NRF_ERROR_INVALID_PARAM;
- }
- }
- }
- #endif
- m_esb_addr.pipe_prefixes[pipe] = prefix;
- update_radio_addresses(NRF_ESB_ADDR_UPDATE_MASK_PREFIX);
- #ifdef NRF52832_XXAA
- return apply_address_workarounds();
- #else
- return NRF_SUCCESS;
- #endif
- }
- uint32_t nrf_esb_enable_pipes(uint8_t enable_mask)
- {
- VERIFY_TRUE(m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE, NRF_ERROR_BUSY);
- VERIFY_TRUE((enable_mask | BIT_MASK_UINT_8(NRF_ESB_PIPE_COUNT)) == BIT_MASK_UINT_8(NRF_ESB_PIPE_COUNT), NRF_ERROR_INVALID_PARAM);
- m_esb_addr.rx_pipes_enabled = enable_mask;
- #ifdef NRF52832_XXAA
- return apply_address_workarounds();
- #else
- return NRF_SUCCESS;
- #endif
- }
- uint32_t nrf_esb_set_rf_channel(uint32_t channel)
- {
- VERIFY_TRUE(m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE, NRF_ERROR_BUSY);
- VERIFY_TRUE(channel <= 100, NRF_ERROR_INVALID_PARAM);
- m_esb_addr.rf_channel = channel;
- return NRF_SUCCESS;
- }
- uint32_t nrf_esb_get_rf_channel(uint32_t * p_channel)
- {
- VERIFY_PARAM_NOT_NULL(p_channel);
- *p_channel = m_esb_addr.rf_channel;
- return NRF_SUCCESS;
- }
- uint32_t nrf_esb_set_tx_power(nrf_esb_tx_power_t tx_output_power)
- {
- VERIFY_TRUE(m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE, NRF_ERROR_BUSY);
- if ( m_config_local.tx_output_power != tx_output_power )
- {
- m_config_local.tx_output_power = tx_output_power;
- update_radio_tx_power();
- }
- return NRF_SUCCESS;
- }
- uint32_t nrf_esb_set_retransmit_delay(uint16_t delay)
- {
- VERIFY_TRUE(m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE, NRF_ERROR_BUSY);
- VERIFY_TRUE(delay >= NRF_ESB_RETRANSMIT_DELAY_MIN, NRF_ERROR_INVALID_PARAM);
- m_config_local.retransmit_delay = delay;
- return NRF_SUCCESS;
- }
- uint32_t nrf_esb_set_retransmit_count(uint16_t count)
- {
- VERIFY_TRUE(m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE, NRF_ERROR_BUSY);
- m_config_local.retransmit_count = count;
- return NRF_SUCCESS;
- }
- uint32_t nrf_esb_set_bitrate(nrf_esb_bitrate_t bitrate)
- {
- VERIFY_TRUE(m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE, NRF_ERROR_BUSY);
- m_config_local.bitrate = bitrate;
- return update_radio_bitrate() ? NRF_SUCCESS : NRF_ERROR_INVALID_PARAM;
- }
- uint32_t nrf_esb_reuse_pid(uint8_t pipe)
- {
- VERIFY_TRUE(m_nrf_esb_mainstate == NRF_ESB_STATE_IDLE, NRF_ERROR_BUSY);
- VERIFY_TRUE(pipe < NRF_ESB_PIPE_COUNT, NRF_ERROR_INVALID_PARAM);
- m_pids[pipe] = (m_pids[pipe] + NRF_ESB_PID_MAX) % (NRF_ESB_PID_MAX + 1);
- return NRF_SUCCESS;
- }
- #ifdef NRF52832_XXAA
- // Workaround neccessary on nRF52832 Rev. 1.
- void NRF_ESB_BUGFIX_TIMER_IRQHandler(void)
- {
- if (NRF_ESB_BUGFIX_TIMER->EVENTS_COMPARE[0])
- {
- NRF_ESB_BUGFIX_TIMER->EVENTS_COMPARE[0] = 0;
- // If the timeout timer fires and we are in the PTX receive ACK state, disable the radio
- if (m_nrf_esb_mainstate == NRF_ESB_STATE_PTX_RX_ACK)
- {
- NRF_RADIO->TASKS_DISABLE = 1;
- }
- }
- }
- #endif
|