本頁面由 Cloud Translation API 翻譯而成。

其他

這個單元包含適用於其他行為的平台抽象化機制。

摘要

列舉
`otPlatMcuPowerState{ OT_PLAT_MCU_POWER_STATE_ON = 0, OT_PLAT_MCU_POWER_STATE_LOW_POWER = 1, OT_PLAT_MCU_POWER_STATE_OFF = 2 }`	列舉微控制器的電源狀態列舉。
`otPlatResetReason`	列舉可能的重設原因代碼列舉。

函式
`otPlatAssertFail(const char *aFilename, int aLineNumber)`	`void` 提供宣告的特定平台實作。
`otPlatGetMcuPowerState(otInstance *aInstance)`	`otPlatMcuPowerState` 取得目前所需的 MCU 電源狀態。
`otPlatGetResetReason(otInstance *aInstance)`	`otPlatResetReason` 傳回上次重設平台的原因。
`otPlatReset(otInstance *aInstance)`	`void` 在支援的情況下，在平台上執行軟體重設。
`otPlatResetToBootloader(otInstance *aInstance)`	`otError` 會在平台上執行硬體重設，以啟動系統啟動載入程式模式 (如果支援)。
`otPlatSetMcuPowerState(otInstance *aInstance, otPlatMcuPowerState aState)`	`otError` 設定想要的 MCU 電源狀態。
`otPlatWakeHost(void)`	`void` 執行平台特定作業來喚醒主機 MCU。

列舉

otPlatMcuPowerState

 otPlatMcuPowerState

微控制器的電源狀態列舉。

啟用 OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL 時，這些值就會用於 NCP 設定。

電源狀態指定 NCP 微控制器 (MCU) 的所需電源狀態時，當基礎平台的作業系統進入閒置模式 (意即所有進行中的工作/事件都在處理中，而 MCU 可能會進入節能電源狀態)。

電源狀態主要會決定主機與 NCP 的互動方式，以及主機是否需要透過外部觸發條件 (「叫聲」) 連至 NCP，才能與 NCP 通訊。

重設後，MCU 電源狀態必須為 OT_PLAT_POWER_STATE_ON。

屬性

屬性
`OT_PLAT_MCU_POWER_STATE_LOW_POWER`	NCP 的 MCU 可進入低耗電 (節能) 狀態。將 NCP 的所需電源狀態設為 `LOW_POWER` 時，主機應先「破壞」NCP (例如中斷的外部觸發條件)，然後才能與 NCP (傳送訊息至 NCP) 通訊。「抽菸」機制是由平台程式碼決定 (根據主機的 NCP 介面)。當電源狀態設為 `LOW_POWER` 時，NCP 仍可 (任何時間) 傳送訊息到主機。請注意，收到來自 NCP 的訊息並不表示 NCP 的電源狀態已變更，也就是說，當 NCP 想與 NCP 進行通訊時，應會繼續「關閉」，直到明確變更電源狀態為止 (成功呼叫 `otPlatSetMcuPowerState()` 將狀態變更為 `ON`)。注意：`LOW_POWER` 電源狀態只會確定 MCU 的電源模式，與無線電狀態無關 (電台是由 OpenThread 核心和裝置角色管理，例如裝置是否處於休眠狀態。
`OT_PLAT_MCU_POWER_STATE_OFF`	NCP 完全關閉。必須重設 NCP 硬體 (透過 RESET PIN 碼)，才能將 NCP 復原至 `SPINEL_MCU_POWER_STATE_ON`。重設後，RAM 不會保留。
`OT_PLAT_MCU_POWER_STATE_ON`	NCP 的 MCU 會持續運作並保持運作。當 NCP 的所需電源狀態設為 `ON` 時，主機無需任何「叫用」或外部觸發條件，即可傳送訊息至 NCP。注意：`ON` 電源狀態只會決定 MCU 的電源模式，與無線電狀態無關。

OT_PLAT_MCU_POWER_STATE_LOW_POWER

NCP 的 MCU 可進入低耗電 (節能) 狀態。

將 NCP 的所需電源狀態設為 LOW_POWER 時，主機應先「破壞」NCP (例如中斷的外部觸發條件)，然後才能與 NCP (傳送訊息至 NCP) 通訊。「抽菸」機制是由平台程式碼決定 (根據主機的 NCP 介面)。

當電源狀態設為 LOW_POWER 時，NCP 仍可 (任何時間) 傳送訊息到主機。請注意，收到來自 NCP 的訊息並不表示 NCP 的電源狀態已變更，也就是說，當 NCP 想與 NCP 進行通訊時，應會繼續「關閉」，直到明確變更電源狀態為止 (成功呼叫 otPlatSetMcuPowerState() 將狀態變更為 ON)。

注意：LOW_POWER 電源狀態只會確定 MCU 的電源模式，與無線電狀態無關 (電台是由 OpenThread 核心和裝置角色管理，例如裝置是否處於休眠狀態。

OT_PLAT_MCU_POWER_STATE_OFF

NCP 完全關閉。

必須重設 NCP 硬體 (透過 RESET PIN 碼)，才能將 NCP 復原至 SPINEL_MCU_POWER_STATE_ON。重設後，RAM 不會保留。

OT_PLAT_MCU_POWER_STATE_ON

NCP 的 MCU 會持續運作並保持運作。

當 NCP 的所需電源狀態設為 ON 時，主機無需任何「叫用」或外部觸發條件，即可傳送訊息至 NCP。

注意：ON 電源狀態只會決定 MCU 的電源模式，與無線電狀態無關。

otPlatResetReason

 otPlatResetReason

可能的重設原因代碼列舉。

這些順序與「Spinel 重設」原因代碼的順序相同。

函式

otPlatAssertFail

void otPlatAssertFail(
  const char *aFilename,
  int aLineNumber
)

提供宣告的特定平台實作。

詳細說明

參數

`[in] aFilename`	發生斷言的檔案名稱。
`[in] aLineNumber`	發生斷言的檔案行號。

otPlatGetMcuPowerState

otPlatMcuPowerState otPlatGetMcuPowerState(
  otInstance *aInstance
)

取得目前所需的 MCU 電源狀態。

只有在已啟用 OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL 的情況下，這項設定才會用於 NCP 設定。

重設後，電源狀態必須傳回 OT_PLAT_POWER_STATE_ON。在作業期間，電源狀態「應該」只透過明確成功呼叫 otPlatSetMcuPowerState() 而變更。

詳細說明

參數

[in] aInstance

指向 OpenThread 執行個體的指標。

傳回

目前的電源狀態。

otPlatGetResetReason

otPlatResetReason otPlatGetResetReason(
  otInstance *aInstance
)

傳回上次重設平台的原因。

詳細說明

參數

[in] aInstance

OpenThread 執行個體結構。

otPlatReset

void otPlatReset(
  otInstance *aInstance
)

在支援的情況下，在平台上執行軟體重設。

詳細說明

參數

[in] aInstance

OpenThread 執行個體結構。

otPlatResetToBootloader

otError otPlatResetToBootloader(
  otInstance *aInstance
)

會在平台上執行硬體重設，以啟動系統啟動載入程式模式 (如果支援)。

在 OPENTHREAD_CONFIG_PLATFORM_BOOTLOADER_MODE_ENABLE 啟用時使用。

詳細說明

參數

[in] aInstance

OpenThread 執行個體結構。

傳回值

`OT_ERROR_NONE`	已成功重設為系統啟動載入程式。
`OT_ERROR_BUSY`	正在執行另一項作業，因此無法執行這項作業。
`OT_ERROR_NOT_CAPABLE`	無法重設為系統啟動載入程式。

otPlatSetMcuPowerState

otError otPlatSetMcuPowerState(
  otInstance *aInstance,
  otPlatMcuPowerState aState
)

設定想要的 MCU 電源狀態。

只有在已啟用 OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL 的情況下，這項設定才會用於 NCP 設定。

詳細說明

參數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aState`	新的 MCU 電源狀態。

傳回值

`OT_ERROR_NONE`	已成功更新電源狀態。
`OT_ERROR_FAILED`	平台不支援指定的 MCU 電源狀態。

otPlatWakeHost

void otPlatWakeHost(
  void
)

執行平台特定作業來喚醒主機 MCU。

只會用於 NCP 設定。

資源

OpenThread API 參考資料主題源自原始碼，請前往 GitHub 取得。如要瞭解詳情或對說明文件做出貢獻，請參閱資源。