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

无线装置配置

此模块包含用于电台配置的平台抽象。

总结

函数

otPlatRadioGetBusSpeed(otInstance *aInstance)
uint32_t
获取主机和无线电芯片之间的总线速率(以位/秒为单位)。
otPlatRadioGetCaps(otInstance *aInstance)
获取电台功能。
otPlatRadioGetCcaEnergyDetectThreshold(otInstance *aInstance, int8_t *aThreshold)
根据 IEEE 802.15.4 - 2015 年第 10.1.4 节的规定,获取在天线连接器处测量的 CCA ED 阈值(以 dBm 为单位)。
otPlatRadioGetFemLnaGain(otInstance *aInstance, int8_t *aGain)
获取外部 FEM's Rx LNA 增益(以 dBm 为单位)。
otPlatRadioGetIeeeEui64(otInstance *aInstance, uint8_t *aIeeeEui64)
void
获取该接口的出厂指定 IEEE EUI-64。
otPlatRadioGetNow(otInstance *aInstance)
uint64_t
获取无线电芯片的当前估计时间(以微秒为单位)。
otPlatRadioGetPromiscuous(otInstance *aInstance)
bool
获取混乱模式的状态。
otPlatRadioGetReceiveSensitivity(otInstance *aInstance)
int8_t
获取无线装置接收灵敏度值。
otPlatRadioGetTransmitPower(otInstance *aInstance, int8_t *aPower)
获取无线装置的发射功率(以 dBm 为单位)。
otPlatRadioGetVersionString(otInstance *aInstance)
const char *
获取电台版本字符串。
otPlatRadioSetCcaEnergyDetectThreshold(otInstance *aInstance, int8_t aThreshold)
根据 IEEE 802.15.4 - 2015 年第 10.1.4 节,设置在天线连接器处测量的 CCA ED 阈值(以 dBm 为单位)。
otPlatRadioSetExtendedAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
void
设置进行地址过滤的扩展地址。
otPlatRadioSetFemLnaGain(otInstance *aInstance, int8_t aGain)
设置外部 FEM's Rx LNA 增益(以 dBm 为单位)。
otPlatRadioSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)
void
此方法可设置当前 MAC 帧计数器值。
otPlatRadioSetMacKey(otInstance *aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKeyMaterial *aPrevKey, const otMacKeyMaterial *aCurrKey, const otMacKeyMaterial *aNextKey, otRadioKeyType aKeyType)
void
更新 MAC 密钥和密钥索引。
otPlatRadioSetPanId(otInstance *aInstance, otPanId aPanId)
void
设置用于地址过滤的 PAN ID。
otPlatRadioSetPromiscuous(otInstance *aInstance, bool aEnable)
void
启用或停用混杂模式。
otPlatRadioSetShortAddress(otInstance *aInstance, otShortAddress aShortAddress)
void
设置用于地址过滤的短地址。
otPlatRadioSetTransmitPower(otInstance *aInstance, int8_t aPower)
设置无线装置的发射功率(以 dBm 为单位)。

函数

otPlatRadioGetBusSpeed

uint32_t otPlatRadioGetBusSpeed(
  otInstance *aInstance
)

获取主机和无线电芯片之间的总线速率(以位/秒为单位)。

详情
参数
[in] aInstance
指向 OpenThread 实例的指针。
返回值
主机和无线电芯片之间的总线速率(以位/秒为单位)。如果 MAC 层和以上层与无线装置层位于同一芯片上,则返回 0。

otPlatRadioGetCaps

otRadioCaps otPlatRadioGetCaps(
  otInstance *aInstance
)

获取电台功能。

详情
参数
[in] aInstance
OpenThread 实例结构。
返回值
无线装置功能位矢量(请参阅 OT_RADIO_CAP_* 定义)。

otPlatRadioGetCcaEnergyDetectThreshold

otError otPlatRadioGetCcaEnergyDetectThreshold(
  otInstance *aInstance,
  int8_t *aThreshold
)

根据 IEEE 802.15.4 - 2015 年第 10.1.4 节的规定,获取在天线连接器处测量的 CCA ED 阈值(以 dBm 为单位)。

详情
参数
[in] aInstance
OpenThread 实例结构。
[out] aThreshold
CCA ED 阈值(以 dBm 为单位)。
返回值
OT_ERROR_NONE
已成功检索到 CCA ED 阈值。
OT_ERROR_INVALID_ARGS
aThreshold”为 NULL。
OT_ERROR_NOT_IMPLEMENTED
通过 dBm 实现的 CCA ED 阈值配置尚未实现。

otPlatRadioGetFemLnaEarn

otError otPlatRadioGetFemLnaGain(
  otInstance *aInstance,
  int8_t *aGain
)

获取外部 FEM's Rx LNA 增益(以 dBm 为单位)。

详情
参数
[in] aInstance
OpenThread 实例结构。
[out] aGain
外部 FEM's Rx LNA 增益(以 dBm 为单位)。
返回值
OT_ERROR_NONE
已成功检索到外部 FEM 增益。
OT_ERROR_INVALID_ARGS
aGain”为 NULL。
OT_ERROR_NOT_IMPLEMENTED
外部 FEM 的 LNA 设置未实现。

otPlatRadioGetIeeeEui64

void otPlatRadioGetIeeeEui64(
  otInstance *aInstance,
  uint8_t *aIeeeEui64
)

获取该接口的出厂指定 IEEE EUI-64。

详情
参数
[in] aInstance
OpenThread 实例结构。
[out] aIeeeEui64
指向出厂分配的 IEEE EUI-64 的指针。

otPlatRadioGetNow

uint64_t otPlatRadioGetNow(
  otInstance *aInstance
)

获取无线电芯片的当前估计时间(以微秒为单位)。

这个微秒计时器必须是可自由运行的计时器。即使收音机处于休眠状态,计时器也必须继续以微秒为单位的精度前进。

详情
参数
[in] aInstance
指向 OpenThread 实例的指针。
返回值
当前时间(以微秒为单位)。UINT64_MAX(当平台不支持或电台时间不可用时)。

otPlatRadioGetPromiscuous

bool otPlatRadioGetPromiscuous(
  otInstance *aInstance
)

获取混乱模式的状态。

详情
参数
[in] aInstance
OpenThread 实例结构。
返回值
TRUE
已启用杂乱模式。
FALSE
已停用混淆模式。

otPlatRadioGetReceiveSensitivity

int8_t otPlatRadioGetReceiveSensitivity(
  otInstance *aInstance
)

获取无线装置接收灵敏度值。

详情
参数
[in] aInstance
OpenThread 实例结构。
返回值
无线装置接收灵敏度值(以 dBm 为单位)。

otPlatRadioGetTransmitPower

otError otPlatRadioGetTransmitPower(
  otInstance *aInstance,
  int8_t *aPower
)

获取无线装置的发射功率(以 dBm 为单位)。

详情
参数
[in] aInstance
OpenThread 实例结构。
[out] aPower
发射功率(以 dBm 为单位)。
返回值
OT_ERROR_NONE
已成功检索发射功率。
OT_ERROR_INVALID_ARGS
aPower”为 NULL。
OT_ERROR_NOT_IMPLEMENTED
通过 dBm 实现发射功率配置。

otPlatRadioGetVersionString

const char * otPlatRadioGetVersionString(
  otInstance *aInstance
)

获取电台版本字符串。

这是一个可选的无线装置驱动程序函数。如果平台无线装置驱动程序不提供,则 OpenThread 会使用 OpenThread 版本 (

详情
参数
[in] aInstance
OpenThread 实例结构。
返回值
指向 OpenThread 电台版本的指针。
另请参阅
otGetVersionString())。

otPlatRadioSetCcaEnergyDetectThreshold

otError otPlatRadioSetCcaEnergyDetectThreshold(
  otInstance *aInstance,
  int8_t aThreshold
)

根据 IEEE 802.15.4 - 2015 年第 10.1.4 节,设置在天线连接器处测量的 CCA ED 阈值(以 dBm 为单位)。

详情
参数
[in] aInstance
OpenThread 实例结构。
[in] aThreshold
CCA ED 阈值(以 dBm 为单位)。
返回值
OT_ERROR_NONE
已成功设置发射功率。
OT_ERROR_INVALID_ARGS
指定的阈值超出范围。
OT_ERROR_NOT_IMPLEMENTED
通过 dBm 实现的 CCA ED 阈值配置尚未实现。

otPlatRadioSetExtendedAddress

void otPlatRadioSetExtendedAddress(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

设置进行地址过滤的扩展地址。

详情
参数
[in] aInstance
OpenThread 实例结构。
[in] aExtAddress
指向 IEEE 802.15.4 Extended Address 的指针,以小端字节序存储。

otPlatRadioSetFemLnaEarn

otError otPlatRadioSetFemLnaGain(
  otInstance *aInstance,
  int8_t aGain
)

设置外部 FEM's Rx LNA 增益(以 dBm 为单位)。

详情
参数
[in] aInstance
OpenThread 实例结构。
[in] aGain
外部 FEM's Rx LNA 增益(以 dBm 为单位)。
返回值
OT_ERROR_NONE
已成功设置外部 FEM 的 LNA 增益。
OT_ERROR_NOT_IMPLEMENTED
外部 FEM 的增益设置未实现。

otPlatRadioSetMacFrameCounter

void otPlatRadioSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

此方法可设置当前 MAC 帧计数器值。

当电台提供 OT_RADIO_CAPS_TRANSMIT_SEC 功能时,会使用此函数。

详情
参数
[in] aInstance
指向 OpenThread 实例的指针。
[in] aMacFrameCounter
MAC 帧计数器值。

otPlatRadioSetMacKey

void otPlatRadioSetMacKey(
  otInstance *aInstance,
  uint8_t aKeyIdMode,
  uint8_t aKeyId,
  const otMacKeyMaterial *aPrevKey,
  const otMacKeyMaterial *aCurrKey,
  const otMacKeyMaterial *aNextKey,
  otRadioKeyType aKeyType
)

更新 MAC 密钥和密钥索引。

无线装置提供 OT_RADIO_CAPS_TRANSMIT_SEC 功能时会用到此函数。

详情
参数
[in] aInstance
指向 OpenThread 实例的指针。
[in] aKeyIdMode
密钥 ID 模式。
[in] aKeyId
当前的 MAC 密钥索引。
[in] aPrevKey
指向前一个 MAC 密钥的指针。
[in] aCurrKey
指向当前 MAC 密钥的指针。
[in] aNextKey
指向下一个 MAC 密钥的指针。
[in] aKeyType
使用的密钥类型。

otPlatRadioSetPanId

void otPlatRadioSetPanId(
  otInstance *aInstance,
  otPanId aPanId
)

设置用于地址过滤的 PAN ID。

详情
参数
[in] aInstance
OpenThread 实例结构。
[in] aPanId
IEEE 802.15.4 PAN ID。

otPlatRadioSetPromiscuous

void otPlatRadioSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

启用或停用混杂模式。

详情
参数
[in] aInstance
OpenThread 实例结构。
[in] aEnable
True 表示启用杂音模式,为 False 表示停用混杂模式。

otPlatRadioSetShortAddress

void otPlatRadioSetShortAddress(
  otInstance *aInstance,
  otShortAddress aShortAddress
)

设置用于地址过滤的短地址。

详情
参数
[in] aInstance
OpenThread 实例结构。
[in] aShortAddress
IEEE 802.15.4 短地址。

otPlatRadioSetTransmitPower

otError otPlatRadioSetTransmitPower(
  otInstance *aInstance,
  int8_t aPower
)

设置无线装置的发射功率(以 dBm 为单位)。

详情
参数
[in] aInstance
OpenThread 实例结构。
[in] aPower
发射功率(以 dBm 为单位)。
返回值
OT_ERROR_NONE
已成功设置发射功率。
OT_ERROR_NOT_IMPLEMENTED
通过 dBm 实现发射功率配置。

资源

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