simplicity_sdk: Import HAL version 2025.6.1

Origin: Simplicity SDK
License: Zlib
URL: https://github.com/SiliconLabs/simplicity_sdk
Commit: 4c4c7151c8a5953a6afc1e926c0bbb9e4e1893de
Version: 2025.6.1
Purpose: HAL for Silicon Labs Series 2 devices
Signed-off-by: Aksel Skauge Mellbye <[email protected]>

Author: asmellby

simplicity_sdk/platform/common/inc/sl_event_system.h

@@ -37,6 +37,7 @@
 #include "sl_status.h"
 #include "sl_enum.h"
 #include "sl_core.h"
+#include "sl_component_catalog.h"
 
 #ifdef __cplusplus
 extern "C" {
@@ -86,6 +87,14 @@ extern "C" {
  * After consuming the event, the @sl_event_process function must be called for each
  * event instance. This will ensure that the memory and resources used by the event
  * data structure is properly deallocated.
+ *
+ * ## Supervisor Mode
+ *
+ * Supervisor mode allows users to subscribe to all events from all classes. There is an internal
+ * queue that will receive all events published by any publisher. When a publisher is registered,
+ * the supervisor queue will subscribe to it automatically. To get an event from the supervisor
+ * queue, the user must call the function @ref sl_event_supervisor_queue_get.
+ *
  * @{
  ******************************************************************************/
 
@@ -119,6 +128,7 @@ typedef struct {
 } sl_event_publisher_t;
 
 typedef struct {
+  sl_event_class_t        event_class;
   sl_event_free_data_cb_t free_data_callback;
   uint8_t                 reference_count;
   void*                   event_data;
@@ -379,15 +389,82 @@ sl_status_t sl_event_alloc(sl_event_t **event);
  *
  * @note
  *  Freeing an event structure that has not yet been processed by all
- *  subscribers will
+ *  subscribers will result in undefined behavior.
  *
- * @param[in] event    address of a pointer to an event struct
+ * @param[in] event    address of a pointer to an event struct.
  *
  * @return
  *    SL_STATUS_OK if successful, otherwise an error code is returned.
  ******************************************************************************/
 sl_status_t sl_event_free(sl_event_t *event);
 
+#if defined(SL_CATALOG_EVENT_SYSTEM_SUPERVISOR_MODE_PRESENT)
+/*******************************************************************************
+ * @brief
+ *  Get an event from the supervisor event queue.
+ *
+ * @param[out] event  address of a pointer to an event struct.
+ *
+ * @return
+ *    SL_STATUS_OK if successful, otherwise an error code is returned.
+ ******************************************************************************/
+sl_status_t sl_event_supervisor_queue_get(sl_event_t **event);
+#endif
+
+/*******************************************************************************
+ * @brief
+ *  Initialize the IRQ event system.
+ *
+ * @description
+ *  This function initializes the IRQ event publisher to allow publishing events
+ *  from interrupt service routines. This must be called after sl_event_system_init().
+ *
+ * @param[in] event_queue  Event queue to use for IRQ events.
+ *
+ * @return
+ *    SL_STATUS_OK if successful, otherwise an error code is returned.
+ ******************************************************************************/
+sl_status_t sl_event_irq_publisher_init(void);
+
+/*******************************************************************************
+ * @brief
+ *  De-initialize the IRQ event system.
+ *
+ * @return
+ *    SL_STATUS_OK if successful, otherwise an error code is returned.
+ ******************************************************************************/
+sl_status_t sl_event_irq_publisher_deinit(void);
+
+/*******************************************************************************
+ * @brief
+ *  Publish an event from an interrupt service routine (ISR).
+ *
+ * @details
+ *  This function should only be called from IRQ contexts to publish IRQ events to
+ *  subscribers of the IRQ event class.
+ *
+ * @param[in] irq_number   The IRQ number associated with the event.
+ *
+ * @return
+ *    SL_STATUS_OK if successful, otherwise an error code is returned.
+ *
+ * @note
+ *    This function must only be called from IRQ contexts. For non-IRQ contexts,
+ *    use the standard event publishing mechanisms.
+ ******************************************************************************/
+sl_status_t sl_event_irq_publish(uint32_t irq_number);
+
+/*******************************************************************************
+ * @brief
+ *  Decode the IRQ event from a given event structure.
+ *
+ * @param[in] event    Pointer to the event structure.
+ *
+ * @return
+ *    The decoded IRQ event, or 0xFFFFFFFF if the event is invalid.
+ ******************************************************************************/
+uint32_t sl_event_irq_decode(sl_event_t *event);
+
 /** @} (end addtogroup event-system) */
 
 #ifdef __cplusplus

simplicity_sdk/platform/emlib/src/em_eusart.c

@@ -1067,7 +1067,7 @@ static void EUSART_AsyncInitCommon(EUSART_TypeDef *eusart,
 #endif /* EUSART_DALICFG_DALIEN */
 
   // Enable EUSART IP.
-  EUSART_Enable(eusart, eusartEnable);
+  eusart->EN_SET = EUSART_EN_EN;
 
   // Configure the baudrate if auto baud detection is not used.
   if (init->baudrate) {
@@ -1222,13 +1222,8 @@ static void EUSART_SyncInitCommon(EUSART_TypeDef *eusart,
   // Set baudrate for synchronous operation mode.
   EUSART_BaudrateSet(eusart, init->refFreq, init->bitRate);
 
-  // Enable EUSART IP.
-  EUSART_Enable(eusart, eusartEnable);
-
   // Finally enable the Rx and/or Tx channel (as specified).
-  eusart_sync(eusart, _EUSART_SYNCBUSY_RXEN_MASK | _EUSART_SYNCBUSY_TXEN_MASK); // Wait for low frequency register synchronization.
-  eusart->CMD = (uint32_t)init->enable;
-  eusart_sync(eusart, _EUSART_SYNCBUSY_RXEN_MASK | _EUSART_SYNCBUSY_TXEN_MASK);
+  EUSART_Enable(eusart, init->enable);
   while (~EUSART_StatusGet(eusart) & (_EUSART_STATUS_RXIDLE_MASK | _EUSART_STATUS_TXIDLE_MASK)) {
   }
 }

simplicity_sdk/platform/peripheral/inc/sl_hal_burtc.h

@@ -64,7 +64,12 @@ typedef struct {
   bool                 compare0_top;    ///< Set if Compare Value 0 is also top value (counter restart)
   bool                 em4_comparator;  ///< Enable EM4 wakeup on compare match.
   bool                 em4_overflow;    ///< Enable EM4 wakeup on counter overflow.
-} sl_hal_burtc_init_config_t;
+} sl_hal_burtc_init_t;
+
+/** @cond DO_NOT_INCLUDE_WITH_DOXYGEN */
+// Typedef for configuration structure used for backward compatibility purposes.
+typedef sl_hal_burtc_init_t sl_hal_burtc_init_config_t;
+/** @endcond */
 
 /*******************************************************************************
  **************************   STRUCT INITIALIZERS   ****************************
@@ -91,10 +96,10 @@ typedef struct {
  * @brief
  *   Initialize the Back-Up RTC.
  *
- * @param[in] burtc_init
+ * @param[in] init
  *    A pointer to the initialization structure used to configure the BURTC.
  ******************************************************************************/
-void sl_hal_burtc_init(const sl_hal_burtc_init_config_t *burtc_init);
+void sl_hal_burtc_init(const sl_hal_burtc_init_t *init);
 
 /***************************************************************************//**
  * @brief
@@ -347,7 +352,7 @@ __INLINE void sl_hal_burtc_unlock(void)
  * void burtc_example(void)
  * {
  *   // Initialize configuration structure with default settings
- *   sl_hal_burtc_init_config_t init = SL_HAL_BURTC_INIT_DEFAULT;
+ *   sl_hal_burtc_init_t init = SL_HAL_BURTC_INIT_DEFAULT;
  *
  *   // Initialize BURTC with default settings
  *   sl_hal_burtc_init(&init);

simplicity_sdk/platform/peripheral/inc/sl_hal_dcdc_coulomb_counter.h

@@ -80,32 +80,42 @@ SL_ENUM(sl_hal_dcdc_coulomb_counter_calibration_load_level_t) {
 typedef struct {
   uint16_t counter_threshold_em0;      ///< Coulomb Counter Threshold in EM0.
   uint16_t counter_threshold_em2;      ///< Coulomb Counter Threshold in EM2.
-} sl_hal_dcdc_coulomb_counter_config_t;
-
-/// DCDC_COULOMB_COUNTER calibration configuration structure.
+} sl_hal_dcdc_coulomb_counter_init_t;
 typedef struct {
   CMU_Select_TypeDef reference_clk;                                     ///< Coulomb Counter Calibration Reference Clock.
   int8_t cal_count;                                                     ///< Coulomb Counter Calibration Reference Count.
   sl_hal_dcdc_coulomb_counter_emode_t cal_emode;                        ///< Coulomb Counter Calibration Energy Mode.
   sl_hal_dcdc_coulomb_counter_calibration_load_level_t cal_load_level;  ///< Coulomb Counter Calibration Power Load.
-} sl_hal_dcdc_coulomb_counter_calibration_config_t;
+} sl_hal_dcdc_coulomb_counter_calibration_init_t;
+
+/** @cond DO_NOT_INCLUDE_WITH_DOXYGEN */
+// Typedef for configuration structure used for backward compatibility purposes.
+typedef sl_hal_dcdc_coulomb_counter_init_t sl_hal_dcdc_coulomb_counter_config_t;
+typedef sl_hal_dcdc_coulomb_counter_calibration_init_t sl_hal_dcdc_coulomb_counter_calibration_config_t;
+/** @endcond */
 
 /// Suggested default values for DCDC_COULOMB_COUNTER configuration structure.
-#define DCDC_COULOMB_COUNTER_CONFIG_DEFAULT                              \
+#define SL_HAL_DCDC_COULOMB_COUNTER_INIT_DEFAULT                         \
   {                                                                      \
     0x8000,                         /* Coulomb Counter EM0 Threshold. */ \
     0x8000,                         /* Coulomb Counter EM2 Threshold. */ \
   }
 
 /// Suggested default values for DCDC_COULOMB_COUNTER calibration configuration structure.
-#define DCDC_COULOMB_COUNTER_CALIBRATION_CONFIG_DEFAULT                                              \
+#define SL_HAL_DCDC_COULOMB_COUNTER_CALIBRATION_INIT_DEFAULT                                         \
   {                                                                                                  \
     cmuSelect_HFXO,                             /* Coulomb Counter Calibration Reference Clock.   */ \
     8,                                          /* Coulomb Counter Calibration Reference Count.   */ \
     SL_HAL_DCDC_COULOMB_COUNTER_EM0,            /* Coulomb Counter Calibration DC-DC energy mode. */ \
     SL_HAL_DCDC_COULOMB_COUNTER_CAL_LOAD3,      /* Coulomb Counter Calibration Load.              */ \
   }
 
+/** @cond DO_NOT_INCLUDE_WITH_DOXYGEN */
+// Alias for deprecated macro names used for backward compatibility purposes.
+#define DCDC_COULOMB_COUNTER_CONFIG_DEFAULT SL_HAL_DCDC_COULOMB_COUNTER_INIT_DEFAULT
+#define DCDC_COULOMB_COUNTER_CALIBRATION_CONFIG_DEFAULT SL_HAL_DCDC_COULOMB_COUNTER_CALIBRATION_INIT_DEFAULT
+/** @endcond */
+
 /*******************************************************************************
  *****************************   PROTOTYPES   **********************************
  ******************************************************************************/
@@ -114,11 +124,11 @@ typedef struct {
  * @brief
  *   Initializes DCDC_COULOMB_COUNTER module.
  *
- * @param[in] p_config
+ * @param[in] init
  *   A pointer to the DCDC_COULOMB_COUNTER initialization
  *   structure variable.
  ******************************************************************************/
-void sl_hal_dcdc_coulomb_counter_init(const sl_hal_dcdc_coulomb_counter_config_t *p_config);
+void sl_hal_dcdc_coulomb_counter_init(const sl_hal_dcdc_coulomb_counter_init_t *init);
 
 /***************************************************************************//**
  * @brief
@@ -354,14 +364,14 @@ __STATIC_INLINE void sl_hal_dcdc_coulomb_counter_set_interrupts(uint32_t flags)
  * @brief
  *   Initializes the calibration of the DCDC Coulomb Counter.
  *
- * @param[in] config
+ * @param[in] init
  *   DCDC_COULOMB_COUNTER calibration configuration structure.
  *
  * @note
  *   The charge per pulse is measured using known on-chip calibration
  *   loads, a PRS channel, and the CMU RC oscillator calibration circuitry.
  ******************************************************************************/
-void sl_hal_dcdc_coulomb_counter_cal_init(sl_hal_dcdc_coulomb_counter_calibration_config_t config);
+void sl_hal_dcdc_coulomb_counter_cal_init(sl_hal_dcdc_coulomb_counter_calibration_init_t init);
 
 /***************************************************************************//**
  * @brief
@@ -472,10 +482,10 @@ __STATIC_INLINE bool sl_hal_dcdc_coulomb_counter_calhalt_is_set(void)
  *  @code{.c}
  *  {
  *    // Initialize with default configuration
- *    sl_hal_dcdc_coulomb_counter_config_t config = DCDC_COULOMB_COUNTER_CONFIG_DEFAULT;
+ *    sl_hal_dcdc_coulomb_counter_init_t init = SL_HAL_DCDC_COULOMB_COUNTER_INIT_DEFAULT;
  *
  *    // Initialize the coulomb counter
- *    sl_hal_dcdc_coulomb_counter_init(&config);
+ *    sl_hal_dcdc_coulomb_counter_init(&init);
  *
  *    // Enable the counter
  *    sl_hal_dcdc_coulomb_counter_enable();
@@ -502,10 +512,10 @@ __STATIC_INLINE bool sl_hal_dcdc_coulomb_counter_calhalt_is_set(void)
  *    sl_hal_dcdc_coulomb_counter_disable();
  *
  *    // To calibrate the counter before use:
- *    sl_hal_dcdc_coulomb_counter_calibration_config_t cal_config =
- *      DCDC_COULOMB_COUNTER_CALIBRATION_CONFIG_DEFAULT;
+ *    sl_hal_dcdc_coulomb_counter_calibration_init_t cal_init =
+ *      SL_HAL_DCDC_COULOMB_COUNTER_CALIBRATION_INIT_DEFAULT;
  *
- *    sl_hal_dcdc_coulomb_counter_cal_init(cal_config);
+ *    sl_hal_dcdc_coulomb_counter_cal_init(cal_init);
  *    sl_hal_dcdc_coulomb_counter_cal_start();
  *
  *    // After calibration is complete