riot-ci/RIOT
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Merge pull request #14997 from jia200x/pr/hal/reg_retention

Browse Source 
ieee802154_hal: add cap for register retention during `off`
This commit is contained in:
benpicco 2020-09-10 14:53:10 +02:00 committed by GitHub
commit 8a2080ab91
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 16 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
sys/include/net/ieee802154/radio.h
View File

@ -110,6 +110,10 @@ typedef enum {
* It's assumed that @ref IEEE802154_CAP_FRAME_RETRANS is present. * It's assumed that @ref IEEE802154_CAP_FRAME_RETRANS is present.
*/ */
IEEE802154_CAP_FRAME_RETRANS_INFO, IEEE802154_CAP_FRAME_RETRANS_INFO,
/**
* @brief the device retains all register values when off.
*/
IEEE802154_CAP_REG_RETENTION,
} ieee802154_rf_caps_t; } ieee802154_rf_caps_t;
/** /**
@ -484,6 +488,18 @@ struct ieee802154_radio_ops {
* @pre call to @ref ieee802154_radio_ops::request_on was successful. * @pre call to @ref ieee802154_radio_ops::request_on was successful.
* *
* @post the transceiver state is @ref IEEE802154_TRX_STATE_TRX_OFF * @post the transceiver state is @ref IEEE802154_TRX_STATE_TRX_OFF
* During boot or in case the radio doesn't support @ref
* IEEE802154_CAP_REG_RETENTION when @ref off was called, the
* Physical Information Base will be undefined. Thus, take into
* consideration that the following functions should be called right after
* the radio is turned on again:
* - @ref set_cca_threshold
* - @ref set_cca_mode
* - @ref config_phy
* - @ref set_csma_params
* - @ref set_rx_mode
* - @ref set_hw_addr_filter
* - @ref set_frame_retrans (if available)
* *
* @param[in] dev IEEE802.15.4 device descriptor * @param[in] dev IEEE802.15.4 device descriptor
* *
@ -627,9 +643,6 @@ struct ieee802154_radio_ops {
* *
* @pre the device is on * @pre the device is on
* *
* @note this function pointer can be NULL if the device doesn't support
* hardware address filtering.
*
* @param[in] dev IEEE802.15.4 device descriptor * @param[in] dev IEEE802.15.4 device descriptor
* @param[in] short_addr the IEEE802.15.4 short address. If NULL, the short * @param[in] short_addr the IEEE802.15.4 short address. If NULL, the short
* address is not altered.. * address is not altered..