此页面由 Cloud Translation API 翻译。

无线装置配置

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

总结

函数
`otPlatRadioGetBusSpeed(otInstance *aInstance)`	`uint32_t` 获取主机和无线电芯片之间的总线速度（以位/秒为单位）。
`otPlatRadioGetCaps(otInstance *aInstance)`	`otRadioCaps` 获取电台功能。
`otPlatRadioGetCcaEnergyDetectThreshold(otInstance aInstance, int8_t aThreshold)`	`otError` 根据 IEEE 802.15.4 - 2015 第 10.1.4 节的规定，在天线连接器上测量以 dBm 为单位的 CCA ED 阈值。
`otPlatRadioGetFemLnaGain(otInstance aInstance, int8_t aGain)`	`otError` 获取外部 FEM 的 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)`	`otError` 获取无线装置的发射功率（以 dBm 为单位）。
`otPlatRadioGetVersionString(otInstance *aInstance)`	`const char *` 获取电台版本字符串。
`otPlatRadioSetCcaEnergyDetectThreshold(otInstance *aInstance, int8_t aThreshold)`	`otError` 根据 IEEE 802.15.4 - 2015 第 10.1.4 节，在天线连接器处测量无线装置的 CCA ED 阈值（以 dBm 为单位）。
`otPlatRadioSetExtendedAddress(otInstance aInstance, const otExtAddress aExtAddress)`	`void` 设置地址过滤的扩展地址。
`otPlatRadioSetFemLnaGain(otInstance *aInstance, int8_t aGain)`	`otError` 设置外部 FEM 的 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)`	`otError` 设置无线装置的发射功率（以 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 节的规定，在天线连接器上测量以 dBm 为单位的 CCA ED 阈值。

详情

参数

`[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 阈值配置。

otPlatRadioGetFemLna 增益

otError otPlatRadioGetFemLnaGain(
  otInstance *aInstance,
  int8_t *aGain
)

获取外部 FEM 的 Rx LNA 增益（以 dBm 为单位）。

详情

参数

`[in] aInstance`	OpenThread 实例结构。
`[out] aGain`	外部 FEM 的 Rx LNA 增益（以 dBm 为单位）。

返回值

`OT_ERROR_NONE`	已成功检索到外部 FEM 的 LNA 增益。
`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 的指针，该地址以小端字节序字节顺序存储。

otPlatRadioSetFemLna 增益

otError otPlatRadioSetFemLnaGain(
  otInstance *aInstance,
  int8_t aGain
)

设置外部 FEM 的 Rx LNA 增益（以 dBm 为单位）。

详情

参数

`[in] aInstance`	OpenThread 实例结构。
`[in] aGain`	外部 FEM 的 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 上获取。如需了解详情或为我们的文档做贡献，请参阅资源。