Release version 2.4.0

Author: joshua-nmi

hal/ambiq/mcu/apollo3/hal/am_hal_clkgen.c

@@ -96,14 +96,34 @@ am_hal_clkgen_control(am_hal_clkgen_control_e eControl, void *pArgs)
             break;
 
         case AM_HAL_CLKGEN_CONTROL_XTAL_START:
+            if (CLKGEN->OCTRL_b.STOPXT == CLKGEN_OCTRL_STOPXT_EN)
+            {
+                break;
+            }
+
+            if (APOLLO3_B0)
+            {
+                MCUCTRL->XTALCTRL_b.XTALICOMPTRIM = 1;
+            }
             CLKGEN->OCTRL_b.STOPXT = CLKGEN_OCTRL_STOPXT_EN;
+            if (APOLLO3_B0)
+            {
+                am_hal_flash_delay(FLASH_CYCLES_US(1000000));
+                MCUCTRL->XTALCTRL_b.XTALICOMPTRIM = 3;
+                am_hal_flash_delay(FLASH_CYCLES_US(1000));
+            }
             break;
 
         case AM_HAL_CLKGEN_CONTROL_LFRC_STOP:
             CLKGEN->OCTRL_b.STOPRC = CLKGEN_OCTRL_STOPRC_STOP;
             break;
 
         case AM_HAL_CLKGEN_CONTROL_XTAL_STOP:
+            if (CLKGEN->OCTRL_b.STOPXT == CLKGEN_OCTRL_STOPXT_STOP)
+            {
+                break;
+            }
+
             // Software Workaround to guarantee proper function of HFADJ.
             if (APOLLO3_B0)
             {

hal/ambiq/mcu/apollo3p/hal/am_hal_clkgen.c

@@ -96,7 +96,22 @@ am_hal_clkgen_control(am_hal_clkgen_control_e eControl, void *pArgs)
             break;
 
         case AM_HAL_CLKGEN_CONTROL_XTAL_START:
+            if (CLKGEN->OCTRL_b.STOPXT == CLKGEN_OCTRL_STOPXT_EN)
+            {
+                break;
+            }
+
+            if (APOLLO3_GE_B0)
+            {
+                MCUCTRL->XTALCTRL_b.XTALICOMPTRIM = 1;
+            }
             CLKGEN->OCTRL_b.STOPXT = CLKGEN_OCTRL_STOPXT_EN;
+            if (APOLLO3_GE_B0)
+            {
+                am_hal_flash_delay(FLASH_CYCLES_US(1000000));
+                MCUCTRL->XTALCTRL_b.XTALICOMPTRIM = 3;
+                am_hal_flash_delay(FLASH_CYCLES_US(1000));
+            }
             break;
 
         case AM_HAL_CLKGEN_CONTROL_LFRC_STOP:

targets/cortex-m55/apollo510/hal/lib/libhal.a

@@ -80,6 +80,11 @@ typedef enum
      */
     LRM_ERROR_NO_BUFS = 3,
 
+    /**
+     * Device or service busy.
+     */
+    LRM_ERROR_BUSY = 5,
+
     /**
      * Failed to parse message.
      */
@@ -95,6 +100,10 @@ typedef enum
      */
     LRM_ERROR_INVALID_STATE = 13,
 
+    /**
+     * Operation is already in progress.
+     */
+    LRM_ERROR_ALREADY = 24,
 } lrm_error_e;
 
 typedef struct
@@ -118,6 +127,7 @@ typedef enum
     LRM_DEVICE_ROLE_CHILD    = 2,   // The Child role.
     LRM_DEVICE_ROLE_ROUTER   = 3,   // The Router role.
     LRM_DEVICE_ROLE_LEADER   = 4,   // The Leader role.
+    LRM_DEVICE_ROLE_PAUSED   = 5,
 } lrm_device_role_e;
 
 /**
@@ -283,6 +293,36 @@ lrm_error_e lrm_network_stop(lrm_context_t *context);
  */
 bool lrm_is_network_started(lrm_context_t *context);
 
+/**
+ * Pause the LoRa mesh network.
+ *
+ * @param[in]  context          A pointer to a LoRa mesh context.
+ *
+ * @retval LRM_ERROR_NONE           Successfully paused the network.
+ * @retval LRM_ERROR_INVALID_STATE  The network interface was not not up.
+ */
+lrm_error_e lrm_network_pause(lrm_context_t *context);
+
+/**
+ * Resume the LoRa mesh network.
+ *
+ * @param[in]  context          A pointer to a LoRa mesh context.
+ *
+ * @retval LRM_ERROR_NONE           Successfully resumed the network.
+ * @retval LRM_ERROR_INVALID_STATE  The network interface was not not up.
+ */
+lrm_error_e lrm_network_resume(lrm_context_t *context);
+
+/**
+ * Indicates whether a LoRa mesh network is paused or not.
+ *
+ * @param[in]  context          A pointer to a LoRa mesh context.
+ *
+ * @returns TRUE if a LoRa mesh network is paused, FALSE otherwise.
+ *
+ */
+bool lrm_is_network_paused(lrm_context_t *context);
+
 /**
  * Get the device role.
  *