net: openthread: implement otPlatRadioSetRxOnWhenIdle

Implement `otPlatRadioSetRxOnWhenIdle`  and add `IEEE802154_RX_ON_WHEN_IDLE` capability.

Signed-off-by: Eduardo Montoya <eduardo.montoya@nordicsemi.no>

include/zephyr/net/ieee802154_radio.h

@@ -515,13 +515,16 @@ enum ieee802154_hw_caps {
 	/** TX security supported (key management, encryption and authentication) */
 	IEEE802154_HW_TX_SEC = BIT(11),
 
+	/** RxOnWhenIdle handling supported */
+	IEEE802154_RX_ON_WHEN_IDLE = BIT(12),
+
 	/* Note: Update also IEEE802154_HW_CAPS_BITS_COMMON_COUNT when changing
 	 * the ieee802154_hw_caps type.
 	 */
 };
 
 /** @brief Number of bits used by ieee802154_hw_caps type. */
-#define IEEE802154_HW_CAPS_BITS_COMMON_COUNT (12)
+#define IEEE802154_HW_CAPS_BITS_COMMON_COUNT (13)
 
 /** @brief This and higher values are specific to the protocol- or driver-specific extensions. */
 #define IEEE802154_HW_CAPS_BITS_PRIV_START IEEE802154_HW_CAPS_BITS_COMMON_COUNT
@@ -1036,6 +1039,31 @@ enum ieee802154_config_type {
 	 */
 	IEEE802154_CONFIG_ENH_ACK_HEADER_IE,
 
+	/**
+	 * Enable/disable RxOnWhenIdle MAC PIB attribute (Table 8-94).
+	 *
+	 * Since there is no clear guidance in IEEE 802.15.4 specification about the definition of
+	 * an "idle period", this implementation expects that drivers use the RxOnWhenIdle attribute
+	 * to determine next radio state (false --> off, true --> receive) in the following scenarios:
+ 	 * - Finalization of a regular frame reception task, provided that:
+ 	 *   - The frame is received without errors and passes the filtering and it's not an spurious ACK.
+ 	 *   - ACK is not requested or transmission of ACK is not possible due to internal conditions.
+ 	 * - Finalization of a frame transmission or transmission of an ACK frame, when ACK is not requested
+	     in the transmitted frame.
+ 	 * - Finalization of the reception operation of a requested ACK due to:
+ 	 *   - ACK timeout expiration.
+ 	 *   - Reception of an invalid ACK or not an ACK frame.
+ 	 *   - Reception of the proper ACK, unless the transmitted frame was a Data Request Command and the
+	 *     frame pending bit on the received ACK is set to true. In this case the radio platform
+	 *	   implementation SHOULD keep the receiver on until a determined timeout which triggers an idle
+	 *     period start.
+ 	 * - Finalization of a stand alone CCA task.
+ 	 * - Finalization of a CCA operation with busy result during CSMA/CA procedure.
+ 	 * - Finalization of an Energy Detection task.
+ 	 * - Finalization of a scheduled radio reception window (see @ref IEEE802154_CONFIG_RX_SLOT).
+	 */
+	IEEE802154_CONFIG_RX_ON_WHEN_IDLE,
+
 	/** Number of types defined in ieee802154_config_type. */
 	IEEE802154_CONFIG_COMMON_COUNT,
 
@@ -1082,6 +1110,9 @@ struct ieee802154_config {
 		/** see @ref IEEE802154_CONFIG_PROMISCUOUS */
 		bool promiscuous;
 
+		/** see @ref ``IEEE802154_CONFIG_RX_ON_WHNE_IDLE`` */
+		bool rx_on_when_idle;
+
 		/** see @ref IEEE802154_CONFIG_EVENT_HANDLER */
 		ieee802154_event_cb_t event_handler;
 

modules/openthread/platform/radio.c

@@ -895,9 +895,26 @@ otRadioCaps otPlatRadioGetCaps(otInstance *aInstance)
 		caps |= OT_RADIO_CAPS_RECEIVE_TIMING;
 	}
 
+	if (radio_caps & IEEE802154_RX_ON_WHEN_IDLE) {
+		caps |= OT_RADIO_CAPS_RX_ON_WHEN_IDLE;
+	}
+
 	return caps;
 }
 
+void otPlatRadioSetRxOnWhenIdle(otInstance *aInstance, bool aRxOnWhenIdle)
+{
+	struct ieee802154_config config = {
+		.rx_on_when_idle = aRxOnWhenIdle
+	};
+
+	ARG_UNUSED(aInstance);
+
+	LOG_DBG("RxOnWhenIdle=%d", aRxOnWhenIdle ? 1 : 0);
+
+	radio_api->configure(radio_dev, IEEE802154_CONFIG_RX_ON_WHEN_IDLE, &config);
+}
+
 bool otPlatRadioGetPromiscuous(otInstance *aInstance)
 {
 	ARG_UNUSED(aInstance);