Add a 'bootloader' MCU power state

SiliconLabs · Oct 12, 2023 · 05b4a5e · 05b4a5e
1 parent fc30740
commit 05b4a5e
Show file tree

Hide file tree

Showing 6 changed files with 26 additions and 5 deletions.
diff --git a/examples/platforms/simulation/misc.c b/examples/platforms/simulation/misc.c
@@ -82,6 +82,7 @@ otError otPlatSetMcuPowerState(otInstance *aInstance, otPlatMcuPowerState aState
     {
     case OT_PLAT_MCU_POWER_STATE_ON:
     case OT_PLAT_MCU_POWER_STATE_LOW_POWER:
+    case OT_PLAT_MCU_POWER_STATE_BOOTLOADER:
         gPlatMcuPowerState = aState;
         break;
 

diff --git a/include/openthread/platform/misc.h b/include/openthread/platform/misc.h
@@ -118,7 +118,7 @@ void otPlatWakeHost(void);
  * The power state primarily determines how the host should interact with the NCP and whether the host needs an
  * external trigger (a "poke") to NCP before it can communicate with the NCP or not.
  *
- * After a reset, the MCU power state MUST be `OT_PLAT_POWER_STATE_ON`.
+ * After a reset, the MCU power state MUST be `OT_PLAT_MCU_POWER_STATE_ON`.
  *
  */
 typedef enum
@@ -160,6 +160,15 @@ typedef enum
      *
      */
     OT_PLAT_MCU_POWER_STATE_OFF = 2,
+
+    /**
+     * NCP's MCU can enter bootloader mode.
+     *
+     * When the NCP's desired power state is set to `BOOTLOADER`, MCU enters its bootloader mode.
+     *
+     */
+    OT_PLAT_MCU_POWER_STATE_BOOTLOADER = 3,
+
 } otPlatMcuPowerState;
 
 /**
@@ -183,7 +192,7 @@ otError otPlatSetMcuPowerState(otInstance *aInstance, otPlatMcuPowerState aState
  * This is only applicable and used for NCP configuration when `OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL`
  * is enabled.
  *
- * After a reset, the power state MUST return `OT_PLAT_POWER_STATE_ON`. During operation, power state SHOULD only
+ * After a reset, the power state MUST return `OT_PLAT_MCU_POWER_STATE_ON`. During operation, power state SHOULD only
  * change through an explicit successful call to `otPlatSetMcuPowerState()`.
  *
  * @param[in] aInstance  A pointer to OpenThread instance.

diff --git a/src/lib/spinel/spinel.c b/src/lib/spinel/spinel.c
@@ -1516,6 +1516,7 @@ const char *spinel_mcu_power_state_to_cstr(uint8_t mcu_power_state)
         {SPINEL_MCU_POWER_STATE_ON, "MCU_POWER_STATE_ON"},
         {SPINEL_MCU_POWER_STATE_LOW_POWER, "MCU_POWER_STATE_LOW_POWER"},
         {SPINEL_MCU_POWER_STATE_OFF, "MCU_POWER_STATE_OFF"},
+        {SPINEL_MCU_POWER_STATE_BOOTLOADER, "MCU_POWER_STATE_BOOTLOADER"},
         {0, NULL},
     };
 

diff --git a/src/lib/spinel/spinel.h b/src/lib/spinel/spinel.h
@@ -613,9 +613,10 @@ typedef enum
 
 typedef enum
 {
-    SPINEL_MCU_POWER_STATE_ON        = 0,
-    SPINEL_MCU_POWER_STATE_LOW_POWER = 1,
-    SPINEL_MCU_POWER_STATE_OFF       = 2,
+    SPINEL_MCU_POWER_STATE_ON         = 0,
+    SPINEL_MCU_POWER_STATE_LOW_POWER  = 1,
+    SPINEL_MCU_POWER_STATE_OFF        = 2,
+    SPINEL_MCU_POWER_STATE_BOOTLOADER = 3,
 } spinel_mcu_power_state_t;
 
 // The `spinel_power_state_t` enumeration and `POWER_STATE`

diff --git a/src/ncp/ncp_base.cpp b/src/ncp/ncp_base.cpp
@@ -1994,6 +1994,10 @@ template <> otError NcpBase::HandlePropertyGet<SPINEL_PROP_MCU_POWER_STATE>(void
     case OT_PLAT_MCU_POWER_STATE_OFF:
         state = SPINEL_MCU_POWER_STATE_OFF;
         break;
+
+    case OT_PLAT_MCU_POWER_STATE_BOOTLOADER:
+        state = SPINEL_MCU_POWER_STATE_BOOTLOADER;
+        break;
     }
 
     return mEncoder.WriteUint8(state);
@@ -2021,6 +2025,10 @@ template <> otError NcpBase::HandlePropertySet<SPINEL_PROP_MCU_POWER_STATE>(void
         powerState = OT_PLAT_MCU_POWER_STATE_OFF;
         break;
 
+    case SPINEL_MCU_POWER_STATE_BOOTLOADER:
+        powerState = OT_PLAT_MCU_POWER_STATE_BOOTLOADER;
+        break;
+
     default:
         ExitNow(error = OT_ERROR_INVALID_ARGS);
     }

diff --git a/src/posix/platform/misc.cpp b/src/posix/platform/misc.cpp
@@ -65,6 +65,7 @@ otError otPlatSetMcuPowerState(otInstance *aInstance, otPlatMcuPowerState aState
     {
     case OT_PLAT_MCU_POWER_STATE_ON:
     case OT_PLAT_MCU_POWER_STATE_LOW_POWER:
+    case OT_PLAT_MCU_POWER_STATE_BOOTLOADER:
         gPlatMcuPowerState = aState;
         break;