本頁面由 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 頁框計數器值。
`otLinkRawSetMacFrameCounterIfLarger(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

otLinkRawEnergyScanDone

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。

otLinkRawTransmitDone

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 卻未收到 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`	如未啟用原始連結層。

otLinkRawGetCaps

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 (如果有效)。127 表示 RSSI 無效。

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 頁框計數器值。

一律將 MAC 計數器設為與目前值無關的新指定值 aMacFrameCounter。

詳細說明

參數

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

傳回值

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

otLinkRawSetMacFrameCounterIfLarger

otError otLinkRawSetMacFrameCounterIfLarger(
  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`	如未啟用原始連結層。

otLinkRawSrcMatchClearShortEntries

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 取得。如要瞭解詳情或對說明文件做出貢獻，請參閱資源。