Repository navigation
net/ieee802154: add timed transmission #23031
+428
−15
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -22,6 +22,8 @@ | |
| #include "nrf_clock.h" | ||
|
|
||
| #include "net/ieee802154.h" | ||
| #include "irq.h" | ||
| #include "periph/timer.h" | ||
| #include "nrf802154.h" | ||
| #include "net/ieee802154/radio.h" | ||
|
|
||
|
|
@@ -31,6 +33,9 @@ | |
| #define ED_RSSISCALE (4U) /**< RSSI scale for internal HW value */ | ||
| #define ED_RSSIOFFS (-92) /**< RSSI offset for internal HW value */ | ||
|
|
||
| /* The MAC timer provides the radio time in us */ | ||
| #define TIMER_FREQ (1000000UL) | ||
|
|
||
| #define TX_POWER_MIN (-40) /* in dBm */ | ||
| #define TX_POWER_MAX ((int)RADIO_TXPOWER_TXPOWER_Max) /* in dBm */ | ||
|
|
||
|
|
@@ -56,6 +61,44 @@ | |
| RADIO_SHORTS_CCABUSY_DISABLE_Msk | \ | ||
| RADIO_SHORTS_TXREADY_START_Msk) | ||
|
|
||
| #define MAC_TIMER_CHAN_TX (0U) /**< MAC timer channel for timed transmission */ | ||
|
|
||
| /** | ||
| * @brief PPI channel connecting the MAC timer compare event of | ||
| * @ref MAC_TIMER_CHAN_TX to the TX task of the radio. | ||
| */ | ||
| #ifndef NRF802154_PPI_CH_TX | ||
| # define NRF802154_PPI_CH_TX (19U) | ||
| #endif | ||
|
|
||
| /** | ||
| * @brief Minimum lead time in us for a timed transmission | ||
| * | ||
| * A timed transmission closer than this to the current radio time starts | ||
| * immediately, as the timer compare event might be missed otherwise. | ||
| */ | ||
| #ifndef NRF802154_TIMED_TX_MIN_LEAD_US | ||
| # define NRF802154_TIMED_TX_MIN_LEAD_US (2U) | ||
| #endif | ||
|
|
||
| /** | ||
| * @brief Time in us from TXEN to the start of the transmission | ||
| * | ||
| * The radio uses the fast ramp-up mode. | ||
| */ | ||
| #ifndef NRF802154_FAST_RAMPUP_US | ||
| # define NRF802154_FAST_RAMPUP_US (40U) | ||
| #endif | ||
|
|
||
| /** | ||
| * @brief Time in us from RXEN to the start of the transmission with CCA | ||
| * | ||
| * Fast RX ramp-up + CCA (8 symbols x 16us per Symbol) + fast TX ramp-up. | ||
| */ | ||
| #ifndef NRF802154_CCA_TX_RAMPUP_US | ||
| # define NRF802154_CCA_TX_RAMPUP_US ((2 * NRF802154_FAST_RAMPUP_US) + 128U) | ||
| #endif | ||
|
|
||
| static uint8_t rxbuf[IEEE802154_FRAME_LEN_MAX + 3]; /* len PHR + PSDU + LQI */ | ||
| static uint8_t txbuf[IEEE802154_FRAME_LEN_MAX + 3]; /* len PHR + PSDU + LQI */ | ||
|
|
||
|
|
@@ -86,6 +129,33 @@ static struct { | |
| static const ieee802154_radio_ops_t nrf802154_ops; | ||
| static ieee802154_dev_t *nrf802154_hal_dev; | ||
|
|
||
| static void _cancel_timed_tx(void) | ||
| { | ||
| timer_clear(NRF802154_TIMER, MAC_TIMER_CHAN_TX); | ||
| NRF_PPI->CHENCLR = (1UL << NRF802154_PPI_CH_TX); | ||
| } | ||
|
|
||
| static void _start_tx_at(uint32_t time_us, volatile uint32_t *start_task) | ||
| { | ||
| /* no interruption between reading the time and arming the timer, so | ||
| * the compare event can't be missed */ | ||
| unsigned irq_state = irq_disable(); | ||
|
|
||
| if ((int32_t)(time_us - timer_read(NRF802154_TIMER)) < (int32_t)NRF802154_TIMED_TX_MIN_LEAD_US){ | ||
| /* already passed or too close, start immediately */ | ||
| *start_task = 1; | ||
| } | ||
| else { | ||
| NRF_PPI->CH[NRF802154_PPI_CH_TX].EEP = | ||
| (uint32_t)&timer_config[NRF802154_TIMER].dev->EVENTS_COMPARE[MAC_TIMER_CHAN_TX]; | ||
| NRF_PPI->CH[NRF802154_PPI_CH_TX].TEP = (uint32_t)start_task; | ||
| NRF_PPI->CHENSET = (1UL << NRF802154_PPI_CH_TX); | ||
| timer_set_absolute(NRF802154_TIMER, MAC_TIMER_CHAN_TX, time_us); | ||
| } | ||
|
|
||
| irq_restore(irq_state); | ||
| } | ||
|
|
||
| static void _power_on(void) | ||
| { | ||
| if (NRF_RADIO->POWER == 0) { | ||
|
|
@@ -200,14 +270,26 @@ static int _request_op(ieee802154_dev_t *dev, ieee802154_hal_op_t op, void *ctx) | |
|
|
||
| switch (op) { | ||
| case IEEE802154_HAL_OP_TRANSMIT: | ||
| volatile uint32_t *start_task; | ||
|
|
||
| if (cfg.cca_send) { | ||
| NRF_RADIO->SHORTS = CCA_SHORTS; | ||
| start_task = &NRF_RADIO->TASKS_RXEN; | ||
| } | ||
| else { | ||
| NRF_RADIO->SHORTS = DEFAULT_SHORTS; | ||
| start_task = &NRF_RADIO->TASKS_TXEN; | ||
| } | ||
|
|
||
| if (ctx) { | ||
| uint32_t rampup_us = cfg.cca_send ? | ||
| NRF802154_CCA_TX_RAMPUP_US : NRF802154_FAST_RAMPUP_US; | ||
| _start_tx_at(*(const uint32_t *)ctx - rampup_us, start_task); | ||
| } | ||
| else { | ||
| *start_task = 1; | ||
| } | ||
|
|
||
| state = STATE_TX; | ||
| break; | ||
| case IEEE802154_HAL_OP_SET_RX: | ||
|
|
@@ -226,6 +308,8 @@ static int _request_op(ieee802154_dev_t *dev, ieee802154_hal_op_t op, void *ctx) | |
| if (!force && _state != STATE_IDLE && _state != STATE_RX) { | ||
| goto end; | ||
| } | ||
| /* a forced SET_IDLE also aborts a pending timed transmission */ | ||
| _cancel_timed_tx(); | ||
| _disable_blocking(); | ||
| NRF_RADIO->SHORTS = DEFAULT_SHORTS; | ||
| NRF_RADIO->PACKETPTR = (uint32_t) txbuf; | ||
|
|
@@ -394,6 +478,21 @@ static void _set_txpower(int16_t txpower) | |
| } | ||
| } | ||
|
|
||
| static void _timer_cb(void *arg, int chan) | ||
| { | ||
| (void)arg; | ||
| if (chan == MAC_TIMER_CHAN_TX) { | ||
| /* TXEN/RXEN was already triggered via PPI, just clear */ | ||
| NRF_PPI->CHENCLR = (1UL << NRF802154_PPI_CH_TX); | ||
| } | ||
| } | ||
|
|
||
| static uint32_t _get_time(ieee802154_dev_t *dev) | ||
| { | ||
| (void)dev; | ||
| return timer_read(NRF802154_TIMER); | ||
| } | ||
|
|
||
| /** | ||
| * @brief Set radio into DISABLED state | ||
| */ | ||
|
|
@@ -404,6 +503,11 @@ int nrf802154_init(void) | |
| rxbuf[0] = 0; | ||
| txbuf[0] = 0; | ||
|
|
||
| int result = timer_init(NRF802154_TIMER, TIMER_FREQ, _timer_cb, NULL); | ||
| assert(result >= 0); | ||
| (void)result; | ||
| timer_stop(NRF802154_TIMER); | ||
|
|
||
| /* power off peripheral (but do not release the HFXO as we never requested | ||
| * it so far) */ | ||
| NRF_RADIO->POWER = 0; | ||
|
|
@@ -511,6 +615,7 @@ static int _request_on(ieee802154_dev_t *dev) | |
| _state = STATE_IDLE; | ||
| DEBUG("[nrf802154]: Request to turn on\n"); | ||
| _power_on(); | ||
| timer_start(NRF802154_TIMER); | ||
| /* make sure the radio is disabled/stopped */ | ||
| _disable(); | ||
| /* we configure it to run in IEEE802.15.4 mode */ | ||
|
|
@@ -531,7 +636,7 @@ static int _request_on(ieee802154_dev_t *dev) | |
| NRF_RADIO->CRCPOLY = 0x011021; | ||
| NRF_RADIO->CRCINIT = 0; | ||
|
|
||
| /* Enable the fast ramp-up mode */ | ||
| NRF_RADIO->MODECNF0 |= RADIO_MODECNF0_RU_Msk; | ||
|
|
||
| NRF_RADIO->SHORTS = DEFAULT_SHORTS; | ||
|
|
@@ -575,7 +680,9 @@ static int _off(ieee802154_dev_t *dev) | |
| { | ||
| (void)dev; | ||
| DEBUG("[nrf802154] Turning off the radio\n"); | ||
| _cancel_timed_tx(); | ||
| _power_off(); | ||
| timer_stop(NRF802154_TIMER); | ||
| return 0; | ||
| } | ||
|
|
||
|
|
@@ -746,7 +853,8 @@ static const ieee802154_radio_ops_t nrf802154_ops = { | |
| | IEEE802154_CAP_IRQ_TX_DONE | ||
| | IEEE802154_CAP_IRQ_CCA_DONE | ||
| | IEEE802154_CAP_PHY_OQPSK | ||
| | IEEE802154_CAP_FRAME_RETENTION | ||
| | IEEE802154_CAP_TIMED_TX, | ||
|
|
||
| .write = _write, | ||
| .read = _read, | ||
|
|
@@ -763,6 +871,7 @@ static const ieee802154_radio_ops_t nrf802154_ops = { | |
| .set_csma_params = _set_csma_params, | ||
| .config_addr_filter = _config_addr_filter, | ||
| .config_src_addr_match = _config_src_addr_match, | ||
| .get_time = _get_time, | ||
| .set_frame_filter_mode = _set_frame_filter_mode, | ||
| .get_frame_filter_mode = _get_frame_filter_mode, | ||
| }; | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -191,7 +191,8 @@ static inline void kw41zrf_abort_sequence(kw41zrf_t *dev) | |
| /* Writing IDLE to XCVSEQ aborts any ongoing sequence */ | ||
| ZLL->PHY_CTRL = (ZLL->PHY_CTRL & | ||
| ~(ZLL_PHY_CTRL_XCVSEQ_MASK | | ||
| ZLL_PHY_CTRL_TC3TMOUT_MASK | ZLL_PHY_CTRL_TMRTRIGEN_MASK | | ||
| ZLL_PHY_CTRL_TMR2CMP_EN_MASK)) | | ||
| ZLL_PHY_CTRL_XCVSEQ(XCVSEQ_IDLE) | ZLL_PHY_CTRL_SEQMSK_MASK; | ||
| /* Spin until the sequence manager has acknowledged the sequence abort, this | ||
| * should not take many cycles */ | ||
|
|
@@ -264,6 +265,20 @@ static inline void kw41zrf_timer_set(kw41zrf_t *dev, volatile uint32_t *cmp_reg, | |
| *cmp_reg = now + timeout; | ||
| } | ||
|
|
||
| /** | ||
| * @brief Set an absolute value for the given compare register of the Event Timer | ||
| * | ||
| * @param[in] dev kw41zrf device descriptor | ||
| * @param[out] cmp_reg pointer to timer compare register, &ZLL->TxCMP | ||
| * @param[in] ticks absolute timer value, truncated to 24 bit | ||
| */ | ||
| static inline void kw41zrf_timer_set_abs(kw41zrf_t *dev, volatile uint32_t *cmp_reg, uint32_t ticks) | ||
| { | ||
| (void) dev; | ||
| /* all compare registers T1CMP..T4CMP are 24 bit wide */ | ||
| *cmp_reg = ticks & ZLL_T1CMP_T1CMP_MASK; | ||
| } | ||
|
|
||
| /** | ||
| * @brief Initialize the Event Timer Block (up counter) | ||
| * | ||
|
|
||
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.