nrf_802154: rev ab926396fe37113664734181cc4dfbb53fb61863

This commit updates revision of the nrf_802154 component.

Signed-off-by: Rafal Kuznia <[email protected]>

Author: e-rk

nrf_802154/common/include/nrf_802154_nrfx_addons.h

@@ -36,6 +36,7 @@
 #define NRF_802154_NRFX_ADDONS_H__
 
 #include "nrfx.h"
+#include "nrf_802154_config.h"
 #include "nrf_802154_const.h"
 
 /* The usage of ED_RSSISCALE is described imprecisely in the nRF product specifications. The meaning of

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/driver/src/nrf_802154_trx.h

@@ -776,7 +776,7 @@ extern void nrf_802154_trx_standalone_cca_finished(bool channel_was_idle);
  * - @ref nrf_802154_trx_go_idle,
  * - @ref nrf_802154_trx_disable.
  *
- * @param ed_sample_dbm     Sample of detected energy.
+ * @param ed_sample     Sample of detected energy.
  */
 extern void nrf_802154_trx_energy_detection_finished(int8_t ed_sample_dbm);
 

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
+
 /**
  *@}
  **/