多平移

此模块包含用于多平移支持的平台抽象。

摘要

函数
otPlatMultipanGetActiveInstance(otInstance **aInstance)
获取当前控制无线装置的实例。
otPlatMultipanIidToInstance(uint8_t aIid)
获取与给定 IID 对应的实例指针。
otPlatMultipanInstanceToIid(otInstance *aInstance)
uint8_t
获取与给定 OpenThread 实例指针相对应的 IID。
otPlatMultipanSetActiveInstance(otInstance *aInstance, bool aCompletePending)
将 aInstance 设置为控制无线装置的当前活跃实例。
otPlatMultipanSwitchoverDone(otInstance *aInstance, bool aSuccess)
void
平台完成了接口切换过程。

函数

otPlatMultipanGetActiveInstance

otError otPlatMultipanGetActiveInstance(
  otInstance **aInstance
)

获取当前控制无线装置的实例。

如果无线装置未在所有接口上并行运行，则此函数会返回已被授予无线装置访问权限的实例对象。

具体说明
参数
[out] aInstance
指向用于存储活跃实例指针的变量的指针。
返回值
OT_ERROR_NONE
已成功检索到该媒体资源。
OT_ERROR_NOT_IMPLEMENTED
由于缺少对电台的支持而失败。
OT_ERROR_INVALID_COMMAND
平台同时支持所有接口。

otPlatMultipanIidToInstance

otInstance * otPlatMultipanIidToInstance(
  uint8_t aIid
)

获取与给定 IID 对应的实例指针。

具体说明
参数
[in] aIid
接口的 IID。
返回值
Instance
如果为 aIid 分配了实例，则返回指针，否则返回 nullptr。

otPlatMultipanInstanceToIid

uint8_t otPlatMultipanInstanceToIid(
  otInstance *aInstance
)

获取与给定 OpenThread 实例指针相对应的 IID。

具体说明
参数
[in] aInstance
OpenThread 实例结构。
返回值
IID
否则，就广播 IID。

otPlatMultipanSetActiveInstance

otError otPlatMultipanSetActiveInstance(
  otInstance *aInstance,
  bool aCompletePending
)

将 aInstance 设置为控制无线装置的当前活跃实例。

此函数允许在不支持多个接口上并行通信的平台上选择当前活跃的实例。换言之，如果有多个实例处于接收状态，调用 otPlatMultipanSetActiveInstance 可保证指定的实例将是接收状态的实例。如果正确接收了请求，则此函数返回。接口切换完成后，平台应调用 otPlatMultipanSwitchoverDone。如果将 aCompletePending 设置为 true，切换接口可能需要更长的时间。

具体说明
参数
[in] aInstance
OpenThread 实例结构。
[in] aCompletePending
如果正在进行的无线装置操作应在界面切换（软切换）之前完成，则为 true；如果是强制切换，则为 false。
返回值
OT_ERROR_NONE
已成功设置该属性。
OT_ERROR_BUSY
因另一项操作正在进行而失败。
OT_ERROR_NOT_IMPLEMENTED
由于实例未知或实例数超出可用接口而失败。
OT_ERROR_INVALID_COMMAND
平台同时支持所有接口。
OT_ERROR_ALREADY
指定的接口已处于活动状态。

otPlatMultipanSwitchoverDone

void otPlatMultipanSwitchoverDone(
  otInstance *aInstance,
  bool aSuccess
)

平台完成了接口切换过程。

如果不需要延迟，或者接口中的切换完全完成后，需要先完成一些更长的无线装置操作，则应在处理 otPlatMultipanSetActiveInstance 后立即调用。

具体说明
参数
[in] aInstance
OpenThread 实例结构。
[in] aSuccess
如果成功切换接口，则为 true；如果切换失败，则为 false。

资源

OpenThread API 参考文档源自 GitHub 上提供的源代码。如需了解详情，或者为我们的文档做贡献，请参阅资源。