本頁面由 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 框架。

Functions
`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。

otLinkRawTransmitmit

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：傳輸因其他原因而遭取消。

Functions

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 執行個體的指標。

傳回

這個 IBI 的 RSSI 為有效值，RSS1 無效時為 127。

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`	已成功轉換為 Receive。
`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`	如果未啟用原始連結圖層，

otLinkRawSetMacFrameCounterIfLer

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`	如果未啟用原始連結圖層，

otLinkRawSrcMatchClearShortShorts

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`	如果未啟用原始連結圖層，

otLinkRawSrcMatch 啟用

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 取得。如需詳細資訊或為說明文件貢獻一己之力，請參閱資源。