[nrf noup] drivers: ieee802154_nrf5: add polling of radio driver

Add Kconfig `IEEE802154_NRF5_RX_THREAD_HEARTBEAT_PERIOD_MS` to
control polling of the nRF 802.15.4 radio driver.
This option is to detect any malfunctions of the radio driver or
the core it is running when the driver is serialized.

Signed-off-by: Andrzej Kuros <[email protected]>

Author: ankuns

drivers/ieee802154/Kconfig.nrf5

@@ -89,6 +89,17 @@ config IEEE802154_NRF5_CALLOUT_TIMEOUT_MS
 	  Set this value to 0 to have no limit (equivalent to K_FOREVER) which turns off the
 	  timing-out feature.
 
+config IEEE802154_NRF5_RX_THREAD_HEARTBEAT_PERIOD_MS
+	int "Period in milliseconds of polling nRF 802.15.4 Radio Driver to detect potential malfunctions"
+	default 60000 if NRF_802154_SER_HOST
+	default 0
+	help
+	  The nRF 802.15.4 Radio Driver is polled with period set by this parameter in order to
+	  detect any potential malfunctions of the driver. This option is useful when
+	  the radio driver implementation is provided by separate core through serialization.
+	  To keep energy usage low the value should be set to big values.
+	  Value equal to 0 turns off the polling completely.
+
 config IEEE802154_NRF5_LOG_RX_FAILURES
 	bool "Frame reception failures logging"
 	help

drivers/ieee802154/ieee802154_nrf5.c

@@ -204,6 +204,7 @@ static void nrf5_rx_thread(void *arg1, void *arg2, void *arg3)
 {
 	struct nrf5_802154_data *nrf5_radio = (struct nrf5_802154_data *)arg1;
 	struct nrf5_802154_rx_frame *rx_frame;
+	uint64_t last_heartbeat_timestamp = 0;
 
 	ARG_UNUSED(arg2);
 	ARG_UNUSED(arg3);
@@ -213,10 +214,26 @@ static void nrf5_rx_thread(void *arg1, void *arg2, void *arg3)
 
 		LOG_DBG("Waiting for frame");
 
-		rx_frame = k_fifo_get(&nrf5_radio->rx_fifo, K_FOREVER);
+		rx_frame = k_fifo_get(&nrf5_radio->rx_fifo,
+			(CONFIG_IEEE802154_NRF5_RX_THREAD_HEARTBEAT_PERIOD_MS != 0) ?
+				K_MSEC(CONFIG_IEEE802154_NRF5_RX_THREAD_HEARTBEAT_PERIOD_MS) :
+				K_FOREVER);
 
 		if (rx_frame != NULL) {
 			nrf5_rx_frame_process(nrf5_radio, rx_frame);
+		} else if (CONFIG_IEEE802154_NRF5_RX_THREAD_HEARTBEAT_PERIOD_MS != 0) {
+			/* No frame was received long enough.
+			 * If core implementing the function below is dead, there will be
+			 * serialization error.
+			 */
+			uint64_t ts = nrf_802154_time_get();
+
+			if (ts < last_heartbeat_timestamp) {
+				/* The core providing nRF 802.15.4 has been reset silently */
+				__ASSERT(false, "802.15.4 heartbeat failure");
+				k_oops();
+			}
+			last_heartbeat_timestamp = ts;
 		}
 	}
 }