Update revision of nrf_802154

nrf_802154/doc/CHANGELOG.rst

@@ -25,6 +25,10 @@ Added
 =====
 
 * Added the :c:func:`nrf_802154_alternate_short_address_set` function, which allows for setting the secondary short address that will be accepted by the frame filter. (KRKNWK-20051)
+* Added the :c:func:`nrf_802154_clock_hfclk_latency_set` function, which sets the HFXO startup latency.
+  Currently, it is supported only on nRF54L Series SoCs.
+  Use this API during clock platform initialization.
+  If the latency is not set, the driver assumes a default worst-case startup latency of 1650 us.
 
 nRF Connect SDK v3.0.0 - nRF 802.15.4 Radio Driver
 **************************************************

nrf_802154/sl/include/nrf_802154_sl_utils.h

@@ -66,6 +66,12 @@
         (ticks) * (NRF_802154_SL_US_PER_S >> NRF_802154_SL_FREQUENCY_US_PER_S_GCD_BITS), \
         (NRF_802154_SL_RTC_FREQUENCY >> NRF_802154_SL_FREQUENCY_US_PER_S_GCD_BITS))
 
+/**@brief Maximum of two values. */
+#define max(a, b) ((a) > (b) ? (a) : (b))
+
+/**@brief Minimum of two values. */
+#define min(a, b) ((a) < (b) ? (a) : (b))
+
 /**@brief Converts microseconds (us) to RTC ticks.
  *
  * @param time      Time is us to be converted to RTC ticks.

nrf_802154/sl/include/platform/nrf_802154_clock.h

@@ -49,6 +49,7 @@
 #define NRF_802154_CLOCK_H_
 
 #include <stdbool.h>
+#include <stdint.h>
 
 #ifdef __cplusplus
 extern "C" {
@@ -127,6 +128,26 @@ extern void nrf_802154_clock_hfclk_ready(void);
  */
 extern void nrf_802154_clock_lfclk_ready(void);
 
+#ifdef NRF54L_SERIES
+
+/**
+ * @brief Informs the nRF 802.15.4 Radio Driver about the HFXO startup latency.
+ *
+ * This function sets the clock latency that will be taken into account during timing
+ * calculations. Lower latencies result in lower power consumption and an ability to
+ * schedule TX/RX windows earlier in the future, but require a crystal oscillator with better
+ * parameters. The default clock latency assumes the worst-case crystal oscillator and should
+ * be adjusted to achieve better power efficiency.
+ *
+ * Note: This API is available only on nRF54L series SoCs.
+ *
+ * @param[in]  latency_us    Time difference in microseconds between start event of the HFXO
+ *                           and the HFXO started/tuned event.
+ */
+extern void nrf_802154_clock_hfclk_latency_set(uint32_t latency_us);
+
+#endif
+
 /**
  *@}
  **/

nrf_802154/sl/sl_opensource/src/nrf_802154_sl_rsch.c

@@ -195,3 +195,13 @@ uint32_t nrf_802154_rsch_delayed_timeslot_time_to_hw_trigger_get(void)
 }
 
 #endif
+
+#ifdef NRF54L_SERIES
+
+void nrf_802154_clock_hfclk_latency_set(uint32_t latency_us)
+{
+    /* Intentionally empty. */
+    (void)latency_us;
+}
+
+#endif