本頁面由 Cloud Translation API 翻譯而成。

原始連結

這個模組包含用來控制原始連結圖層設定的函式。

摘要

Typedefs
`otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi)`	typedef `void(*` 此功能在接收 IEEE 802.15.4 幀。
`otLinkRawReceiveDone)(otInstance aInstance, otRadioFrame aFrame, otError aError)`	typedef `void(*` 此功能在接收 IEEE 802.15.4 幀。
`otLinkRawTransmitDone)(otInstance aInstance, otRadioFrame aFrame, otRadioFrame *aAckFrame, otError aError)`	typedef `void(*` 此功能在接收 IEEE 802.15.4 幀。

函式
`otLinkRawEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)`	`otError` 這種方法會啟動無線電的能量掃描序列。
`otLinkRawGetCaps(otInstance *aInstance)`	`otRadioCaps` 取得電台功能。
`otLinkRawGetPromiscuous(otInstance *aInstance)`	`bool` 這個函式會取得大略模式的狀態。
`otLinkRawGetRadioTime(otInstance *aInstance)`	`uint64_t` 取得電台晶片目前的平台時間 (寬度為 64 位元)。
`otLinkRawGetRssi(otInstance *aInstance)`	`int8_t` 取得最新的 RSSI 測量結果。
`otLinkRawGetTransmitBuffer(otInstance *aInstance)`	`otRadioFrame *` 電台會從「傳輸」轉換為「接收」。
`otLinkRawIsEnabled(otInstance *aInstance)`	`bool` 此函式會指出原始連結圖層是否已啟用。
`otLinkRawReceive(otInstance *aInstance)`	`otError` 正在將電台從「休眠」改為「接收」。
`otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)`	`otError` 設定目前的 MAC 畫格計數器值。
`otLinkRawSetMacKey(otInstance aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey aPrevKey, const otMacKey aCurrKey, const otMacKey aNextKey)`	`otError` 更新 MAC 鍵和金鑰索引。
`otLinkRawSetPromiscuous(otInstance *aInstance, bool aEnable)`	`otError` 這個函式會啟用或停用停用模式。
`otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)`	`otError` 這項功能會啟用/停用原始連結層。
`otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)`	`otError` 設定位址位址的短位址。
`otLinkRawSleep(otInstance *aInstance)`	`otError` 將電台從「接收」轉換為「睡眠」。
`otLinkRawSrcMatchAddExtEntry(otInstance aInstance, const otExtAddress aExtAddress)`	`otError` 正在將擴充位址新增至來源對照表。
`otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)`	`otError` 將短位址新增至來源對照表。
`otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)`	`otError` 從來源對照表中移除所有延伸地址。
`otLinkRawSrcMatchClearExtEntry(otInstance aInstance, const otExtAddress aExtAddress)`	`otError` 正在移除電台來源對照表中的延伸地址。
`otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)`	`otError` 從來源對照表中移除所有短位址。
`otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)`	`otError` 正在移除來源對照表的短位址。
`otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)`	`otError` 啟用/停用待處理的影格比對。
`otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)`	`otError` 這個方法會啟動無線電的傳輸序列。

Typedefs

otLinkRawEnergyScan 完成

void(* otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi)

此功能在接收 IEEE 802.15.4 幀。

詳情

參數總數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aEnergyScanMaxRssi`	已掃描頻道的 RSSI 最大值。

otLinkRawReceiveDone

void(* otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError)

此功能在接收 IEEE 802.15.4 幀。

詳情

參數總數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aFrame`	指向已接收頁框的遊標，如果接收作業被取消，則指向 NULL。
`[in] aError`	OT_ERROR_NONE (成功接收影格時)。接收到取消且未收到頁框時接收 OT_ERROR_ABORT。

otLinkRawTransmit 完成

void(* otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError)

此功能在接收 IEEE 802.15.4 幀。

詳情

參數總數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aFrame`	傳送畫格的遊標。
`[in] aAckFrame`	ACK 頁框的指標。
`[in] aError`	OT_ERROR_NONE。OT_ERROR_NO_ACK 已傳輸至畫格，但未收到 ACK，但由於傳輸作業因頻道活動而未進行傳輸，OT_ERROR_CHANNEL_ACCESS_FAILURE。傳輸作業中斷時，使用 OT_ERROR_ABORT。

函式

otLinkRawEnergyScan

otError otLinkRawEnergyScan(
  otInstance *aInstance,
  uint8_t aScanChannel,
  uint16_t aScanDuration,
  otLinkRawEnergyScanDone aCallback
)

這種方法會啟動無線電的能量掃描序列。

詳情

參數總數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aScanChannel`	執行能源掃描的管道。
`[in] aScanDuration`	掃描頻道的時間長度 (以毫秒為單位)。
`[in] aCallback`	指向掃描完成管道時呼叫的函式。

傳回值

`OT_ERROR_NONE`	已成功掃描頻道。
`OT_ERROR_BUSY`	電台正在執行電子掃描。
`OT_ERROR_NOT_IMPLEMENTED`	收音機不支援能源掃描。
`OT_ERROR_INVALID_STATE`	如果原始連結圖層並未啟用，

otLinkRawGetCap

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

取得電台功能。

詳情

參數總數

[in] aInstance

指向 OpenThread 執行個體的指標。

傳回

無線電功能位元向量。堆疊會根據這個數值啟用或停用某些函式。

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

這個函式會取得大略模式的狀態。

詳情

參數總數

[in] aInstance

指向 OpenThread 執行個體的指標。

傳回值

`true`	已啟用精簡模式。
`false`	已停用精簡模式。

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

取得電台晶片目前的平台時間 (寬度為 64 位元)。

詳情

參數總數

[in] aInstance

指向 OpenThread 執行個體的指標。

傳回

目前的電台時間 (以微秒為單位)。

otLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

取得最新的 RSSI 測量結果。

詳情

參數總數

[in] aInstance

指向 OpenThread 執行個體的指標。

傳回

有效期的 dBm 中的 RSSI。RSS1 無效。

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

電台會從「傳輸」轉換為「接收」。

這個方法會傳回指標給傳輸緩衝區。

呼叫者在此緩衝區中形成 IEEE 802.15.4 頁框，然後呼叫 otLinkRawTransmit() 以要求傳輸。

詳情

參數總數

[in] aInstance

指向 OpenThread 執行個體的指標。

傳回

指向傳輸緩衝區的指標，如果原始連結圖層未啟用，則指向 NULL。

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

此函式會指出原始連結圖層是否已啟用。

詳情

參數總數

[in] aInstance

指向 OpenThread 執行個體的指標。

傳回值

`true`	原始連結層已啟用。
`false`	原始連結層已停用。

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

正在將電台從「休眠」改為「接收」。

開啟電台。

詳情

參數總數

[in] aInstance

指向 OpenThread 執行個體的指標。

傳回值

`OT_ERROR_NONE`	已成功轉換為接收。
`OT_ERROR_INVALID_STATE`	收音機已停用或傳輸。

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

設定目前的 MAC 畫格計數器值。

詳情

參數總數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aMacFrameCounter`	MAC 畫面計數器值。

傳回值

`OT_ERROR_NONE`	如果成功，
`OT_ERROR_INVALID_STATE`	如果原始連結圖層並未啟用，

otLinkRawSetMacKey

otError otLinkRawSetMacKey(
  otInstance *aInstance,
  uint8_t aKeyIdMode,
  uint8_t aKeyId,
  const otMacKey *aPrevKey,
  const otMacKey *aCurrKey,
  const otMacKey *aNextKey
)

更新 MAC 鍵和金鑰索引。

詳情

參數總數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aKeyIdMode`	金鑰 ID 模式。
`[in] aKeyId`	索引鍵索引。
`[in] aPrevKey`	上述的 MAC 金鑰。
`[in] aCurrKey`	目前的 MAC 金鑰。
`[in] aNextKey`	下一個 MAC 金鑰。

傳回值

`OT_ERROR_NONE`	如果成功，
`OT_ERROR_INVALID_STATE`	如果原始連結圖層並未啟用，

otLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

這個函式會啟用或停用停用模式。

詳情

參數總數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aEnable`	指定啟用或停用停用模式的值。

傳回值

`OT_ERROR_NONE`	如果成功，
`OT_ERROR_INVALID_STATE`	如果原始連結圖層並未啟用，

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

這項功能會啟用/停用原始連結層。

詳情

參數總數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aCallback`	收到 IEEE 802.15.4 幀後被呼叫的函數的指標。NULL，以停用原始連結層。

傳回值

`OT_ERROR_FAILED`	無法啟用/停用電台。
`OT_ERROR_INVALID_STATE`	如果 OpenThread IPv6 介面已啟用。
`OT_ERROR_NONE`	如果已成功啟用啟用狀態，

otLinkRawSetShortAddress

otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

設定位址位址的短位址。

詳情

參數總數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aShortAddress`	IEEE 802.15.4 短地址。

傳回值

`OT_ERROR_NONE`	如果成功，
`OT_ERROR_INVALID_STATE`	如果原始連結圖層並未啟用，

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

將電台從「接收」轉換為「睡眠」。

關閉收音機。

詳情

參數總數

[in] aInstance

指向 OpenThread 執行個體的指標。

傳回值

`OT_ERROR_NONE`	已成功轉換為睡眠。
`OT_ERROR_BUSY`	正在傳輸電台
`OT_ERROR_INVALID_STATE`	電台功能已停用

otLinkRawSrcMatchAddExtEntry

otError otLinkRawSrcMatchAddExtEntry(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

正在將擴充位址新增至來源對照表。

詳情

參數總數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aExtAddress`	要新增的延伸地址。

傳回值

`OT_ERROR_NONE`	已成功將延伸地址新增至來源對照表。
`OT_ERROR_NO_BUFS`	來源對照表中沒有可用的項目。
`OT_ERROR_INVALID_STATE`	如果原始連結圖層並未啟用，

otLinkRawSrcMatchAddShortEntry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

將短位址新增至來源對照表。

詳情

參數總數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aShortAddress`	要新增的短地址。

傳回值

`OT_ERROR_NONE`	已成功將短位址新增至來源對照表。
`OT_ERROR_NO_BUFS`	來源對照表中沒有可用的項目。
`OT_ERROR_INVALID_STATE`	如果原始連結圖層並未啟用，

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

從來源對照表中移除所有延伸地址。

詳情

參數總數

[in] aInstance

指向 OpenThread 執行個體的指標。

傳回值

`OT_ERROR_NONE`	如果成功，
`OT_ERROR_INVALID_STATE`	如果原始連結圖層並未啟用，

otLinkRawSrcMatchClearExtEntry

otError otLinkRawSrcMatchClearExtEntry(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

正在移除電台來源對照表中的延伸地址。

詳情

參數總數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aExtAddress`	要移除的延伸地址。

傳回值

`OT_ERROR_NONE`	已成功將來源地址從來源對照表中移除。
`OT_ERROR_NO_ADDRESS`	擴充地址不在來源對照表中。
`OT_ERROR_INVALID_STATE`	如果原始連結圖層並未啟用，

otLinkRawSrcMatchClearShortShortEntry

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

從來源對照表中移除所有短位址。

詳情

參數總數

[in] aInstance

指向 OpenThread 執行個體的指標。

傳回值

`OT_ERROR_NONE`	如果成功，
`OT_ERROR_INVALID_STATE`	如果原始連結圖層並未啟用，

otLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

正在移除來源對照表的短位址。

詳情

參數總數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aShortAddress`	要移除的簡短地址。

傳回值

`OT_ERROR_NONE`	已成功移除來源對照表中的短位址。
`OT_ERROR_NO_ADDRESS`	短地址不在來源對照表中。
`OT_ERROR_INVALID_STATE`	如果原始連結圖層並未啟用，

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

啟用/停用待處理的影格比對。

詳情

參數總數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aEnable`	啟用/停用待處理的影格比對。

傳回值

`OT_ERROR_NONE`	如果成功，
`OT_ERROR_INVALID_STATE`	如果原始連結圖層並未啟用，

otLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

這個方法會啟動無線電的傳輸序列。

呼叫者必須在要求傳輸之前，先在 otLinkRawGetTransmitBuffer() 提供的緩衝區中建立 IEEE 802.15.4 頁框。通道和傳輸功率也包含在 otRadioFrame 結構中。

傳輸序列包含下列項目：

正在將電台從「接收」轉場。
在指定的通道和指定的傳輸功率傳輸 PSDU。

詳情

參數總數

`[in] aInstance`	指向 OpenThread 執行個體的指標。
`[in] aCallback`	指向傳輸完成時呼叫的函式指標。

傳回值

`OT_ERROR_NONE`	已成功轉換至傳輸功能。
`OT_ERROR_INVALID_STATE`	收音機未處於接收狀態。

資源

OpenThread API 參考主題源自原始碼，可從 GitHub 取得。如要瞭解詳情或參閱說明文件，請參閱資源。