此页面由 Cloud Translation API 翻译。

原始链接

此模块包含控制原始链路层配置的函数。

摘要

类型定义符
`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` 此方法开始无线装置上的传输序列。

类型定义符

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（传输帧时，但未收到 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_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 实例的指针。

返回值

有效的 RSSI（以 dBm 为单位）。如果 RSSI 无效，则为 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`	已成功转换为“接收”。
`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`	原始原始层是否处于启用状态。

otLinkRawSrcMatchClearExtEntry

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`	原始原始层是否处于启用状态。

otLinkRawSrcMatchClearShortEntry

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`	已成功转换为 Transmit。
`OT_ERROR_INVALID_STATE`	无线装置未处于“接收”状态。

资源

OpenThread API 参考主题源自源代码，可在 GitHub 上找到。如需了解详情或为我们的文档做贡献，请参阅资源。