Google 致力于为黑人社区推动种族平等。查看具体行动。

此页面由 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 配置。

电源状态指定了当底层平台的操作系统进入空闲模式（即所有活动任务/事件均已处理，且 MCU 可能会进入节能电源状态）时 NCP 微控制器 (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 发送消息）。“poke”机制由平台代码决定（基于与主机的 NCP 接口）。当电源状态设置为 `LOW_POWER` 时，NCP 仍可以（随时）向主机发送消息。请注意，从 NCP 收到消息并不表示 NCP 的电源状态已更改，也就是说，主机在想与 NCP 通信时应继续“发出”，直到电源状态明确更改（通过成功调用 `otPlatSetMcuPowerState()` 将状态更改为 `ON`）。注意：`LOW_POWER` 电源状态仅决定 MCU 的电源模式，与无线装置的状态无关（无线装置由 OpenThread 核心和设备角色管理，例如设备是否处于休眠状态。
`OT_PLAT_MCU_POWER_STATE_OFF`	NCP 已完全关闭。需要进行 NCP 硬件重置（通过重置引脚）才能使 NCP 恢复到 `SPINEL_MCU_POWER_STATE_ON` 状态。重置后不保留 RAM。
`OT_PLAT_MCU_POWER_STATE_ON`	NCP 的 MCU 始终保持开启和活跃状态。当 NCP 的所需电源状态设为 `ON` 时，主机可以将消息发送至 NCP，而不需要任何“poke”或外部触发器。注意：`ON` 电源状态仅决定 MCU 的电源模式，与无线装置的状态无关。

OT_PLAT_MCU_POWER_STATE_LOW_POWER

NCP 的 MCU 可以进入低功耗（节能）状态。

当 NCP 的所需电源状态设为 LOW_POWER 时，主机应先对 NCP 进行“探查”操作（例如，像中断一样的外部触发器），然后才能与 NCP 通信（向 NCP 发送消息）。“poke”机制由平台代码决定（基于与主机的 NCP 接口）。

当电源状态设置为 LOW_POWER 时，NCP 仍可以（随时）向主机发送消息。请注意，从 NCP 收到消息并不表示 NCP 的电源状态已更改，也就是说，主机在想与 NCP 通信时应继续“发出”，直到电源状态明确更改（通过成功调用 otPlatSetMcuPowerState() 将状态更改为 ON）。

注意：LOW_POWER 电源状态仅决定 MCU 的电源模式，与无线装置的状态无关（无线装置由 OpenThread 核心和设备角色管理，例如设备是否处于休眠状态。

OT_PLAT_MCU_POWER_STATE_OFF

NCP 已完全关闭。

需要进行 NCP 硬件重置（通过重置引脚）才能使 NCP 恢复到 SPINEL_MCU_POWER_STATE_ON 状态。重置后不保留 RAM。

OT_PLAT_MCU_POWER_STATE_ON

NCP 的 MCU 始终保持开启和活跃状态。

当 NCP 的所需电源状态设为 ON 时，主机可以将消息发送至 NCP，而不需要任何“poke”或外部触发器。

注意：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 上提供的源代码。如需了解详情，或者为我们的文档做贡献，请参阅资源。