組態

該模塊包括用於無線電配置的平台抽象。

概要

職能
`otPlatRadioGetBusSpeed ( otInstance *aInstance)`	`uint32_t` 獲取主機和無線電芯片之間的總線速度（以位/秒為單位）。
`otPlatRadioGetCaps ( otInstance *aInstance)`	`otRadioCaps` 獲取廣播功能。
`otPlatRadioGetCcaEnergyDetectThreshold ( otInstance aInstance, int8_t aThreshold)`	`otError` 根據IEEE 802.15.4-2015第10.1.4節，獲取在天線連接器處測得的無線電CCA ED閾值（以dBm為單位）。
`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` 獲取無線電芯片的當前估計時間（64位寬度）。
`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` 以dBm為單位設置外部FEM的Rx LNA增益。
`otPlatRadioSetMacFrameCounter ( otInstance *aInstance, uint32_t aMacFrameCounter)`	`void` 此方法設置當前MAC幀計數器值。
`otPlatRadioSetMacKey ( otInstance aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey aPrevKey, const otMacKey aCurrKey, const otMacKey aNextKey)`	`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節，獲取在天線連接器處測得的無線電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閾值配置。

otPlatRadioGetFemLnaGain

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
)

獲取無線電芯片的當前估計時間（64位寬度）。

細節

參量

[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擴展地址的指針。

otPlatRadioSetFemLnaGain

otError otPlatRadioSetFemLnaGain(
  otInstance *aInstance,
  int8_t aGain
)

以dBm為單位設置外部FEM的Rx LNA增益。

細節

參量

`[in] aInstance`	OpenThread實例結構。
`[in] aGain`	外部FEM的Rx LNA增益，以dBm為單位。

返回值

`OT_ERROR_NONE`	成功設置外部FEM的LNA增益。
`OT_ERROR_NOT_IMPLEMENTED`	外部FEM的LNA增益設置未實現。

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 otMacKey *aPrevKey,
  const otMacKey *aCurrKey,
  const otMacKey *aNextKey
)

更新MAC密鑰和密鑰索引。

當收音機提供OT_RADIO_CAPS_TRANSMIT_SEC功能時，將使用此功能。

細節

參量

`[in] aInstance`	指向OpenThread實例的指針。
`[in] aKeyIdMode`	密鑰ID模式。
`[in] aKeyId`	當前的MAC密鑰索引。
`[in] aPrevKey`	指向前一個MAC密鑰的指針。
`[in] aCurrKey`	指向當前MAC密鑰的指針。
`[in] aNextKey`	指向下一個MAC密鑰的指針。

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的發射功率配置。