链接

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

摘要

枚举

otMacFilterAddressMode{
  OT_MAC_FILTER_ADDRESS_MODE_DISABLED,
  OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST,
  OT_MAC_FILTER_ADDRESS_MODE_DENYLIST
}
枚举
定义 Mac 过滤器的地址模式。

类型定义符

otActiveScanResult typedef
表示收到的 IEEE 802.15.4 信标。
otEnergyScanResult typedef
表示能量扫描结果。
otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext) typedef
void(*
当收到 IEEE 802.15.4 信标或扫描完成时,在 IEEE 802.15.4 主动扫描期间会调用指针。
otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext) typedef
void(*
当通道的结果准备就绪或扫描完成时,会在 IEEE 802.15.4 能量扫描期间调用指针。
otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext) typedef
void(*
系统会在收到 IEEE 802.15.4 帧时调用指针。
otMacCounters typedef
struct otMacCounters
表示 MAC 层计数器。
otMacFilterAddressMode typedef
定义 Mac 过滤器的地址模式。
otMacFilterEntry typedef
表示 Mac 过滤器条目。
otMacFilterIterator typedef
uint8_t
用于遍历 Mac 过滤器条目。
otThreadLinkInfo typedef
表示从 Thread 电台收到的消息的链接特定信息。

函数

otLinkActiveScan(otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleActiveScanResult aCallback, void *aCallbackContext)
启动 IEEE 802.15.4 主动扫描。
otLinkConvertLinkQualityToRss(otInstance *aInstance, uint8_t aLinkQuality)
int8_t
将链接质量转换为典型的接收信号强度。
otLinkConvertRssToLinkQuality(otInstance *aInstance, int8_t aRss)
uint8_t
将接收到的信号强度转换为链接质量。
otLinkEnergyScan(otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleEnergyScanResult aCallback, void *aCallbackContext)
启动 IEEE 802.15.4 能量扫描。
otLinkFilterAddAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
向 MAC 过滤器添加扩展地址。
otLinkFilterAddRssIn(otInstance *aInstance, const otExtAddress *aExtAddress, int8_t aRss)
将指定的扩展地址添加到 RssIn 列表(或修改 RssIn 列表中的现有地址),并设置来自该地址的邮件的接收信号强度(以 dBm 为单位)条目。
otLinkFilterClearAddresses(otInstance *aInstance)
void
清除 MAC 过滤器中的所有扩展地址。
otLinkFilterClearAllRssIn(otInstance *aInstance)
void
清除 RssIn 列表中接收的所有信号强度 (rss) 和链接质量指示器 (lqi) 条目(包括默认值)。
otLinkFilterClearDefaultRssIn(otInstance *aInstance)
void
清除 MAC 过滤器上之前设置的所有默认接收信号强度(以 dBm 为单位)。
otLinkFilterGetAddressMode(otInstance *aInstance)
获取 MAC 过滤器的地址模式。
otLinkFilterGetNextAddress(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
获取使用中的地址过滤器条目。
otLinkFilterGetNextRssIn(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
获取正在使用的 RssIn 过滤条件条目。
otLinkFilterRemoveAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
void
从 MAC 过滤器中移除扩展地址。
otLinkFilterRemoveRssIn(otInstance *aInstance, const otExtAddress *aExtAddress)
void
RssIn 列表中移除指定的扩展地址。
otLinkFilterSetAddressMode(otInstance *aInstance, otMacFilterAddressMode aMode)
void
设置 MAC 过滤器的地址模式。
otLinkFilterSetDefaultRssIn(otInstance *aInstance, int8_t aRss)
void
设置 MAC 过滤器上的默认接收信号强度(以 dBm 为单位)。
otLinkGetCcaFailureRate(otInstance *aInstance)
uint16_t
返回当前的 CCA(清晰渠道评估)失败率。
otLinkGetChannel(otInstance *aInstance)
uint8_t
获取 IEEE 802.15.4 信道。
otLinkGetCounters(otInstance *aInstance)
const otMacCounters *
获取 MAC 层计数器。
otLinkGetCslChannel(otInstance *aInstance)
uint8_t
获取 CSL 渠道。
otLinkGetCslPeriod(otInstance *aInstance)
uint32_t
获取 CSL 周期(以微秒为单位)。
otLinkGetCslTimeout(otInstance *aInstance)
uint32_t
获取 CSL 超时。
otLinkGetExtendedAddress(otInstance *aInstance)
const otExtAddress *
获取 IEEE 802.15.4 扩展地址。
otLinkGetFactoryAssignedIeeeEui64(otInstance *aInstance, otExtAddress *aEui64)
void
获取工厂分配的 IEEE EUI-64。
otLinkGetMaxFrameRetriesDirect(otInstance *aInstance)
uint8_t
返回直接传输期间的最大帧重试次数。
otLinkGetMaxFrameRetriesIndirect(otInstance *aInstance)
uint8_t
返回间接传输期间的最大帧重试次数。
otLinkGetPanId(otInstance *aInstance)
获取 IEEE 802.15.4 PAN ID。
otLinkGetPollPeriod(otInstance *aInstance)
uint32_t
获取休眠结束设备的数据轮询时间段。
otLinkGetRegion(otInstance *aInstance, uint16_t *aRegionCode)
获取地区代码。
otLinkGetShortAddress(otInstance *aInstance)
获取 IEEE 802.15.4 短地址。
otLinkGetSupportedChannelMask(otInstance *aInstance)
uint32_t
获取 MAC 层支持的信道掩码。
otLinkGetTxDirectRetrySuccessHistogram(otInstance *aInstance, uint8_t *aNumberOfEntries)
const uint32_t *
获取单个直接数据包的重试直方图,直到成功为止。
otLinkGetTxIndirectRetrySuccessHistogram(otInstance *aInstance, uint8_t *aNumberOfEntries)
const uint32_t *
获取单个间接数据包的重试直方图,直至成功。
otLinkIsActiveScanInProgress(otInstance *aInstance)
bool
指示 IEEE 802.15.4 主动扫描当前是否正在进行。
otLinkIsCslEnabled(otInstance *aInstance)
bool
指示是否已启用 CSL。
otLinkIsCslSupported(otInstance *aInstance)
bool
指示设备是否连接到支持 CSL 的父节点。
otLinkIsEnabled(otInstance *aInstance)
bool
指示是否已启用链接层。
otLinkIsEnergyScanInProgress(otInstance *aInstance)
bool
指明目前是否正在进行 IEEE 802.15.4 能量扫描。
otLinkIsInTransmitState(otInstance *aInstance)
bool
指示 IEEE 802.15.4 MAC 是否处于传输状态。
otLinkIsPromiscuous(otInstance *aInstance)
bool
指示是否在链路层启用混杂模式。
otLinkIsRadioFilterEnabled(otInstance *aInstance)
bool
指明是否启用 IEEE 802.15.4 无线装置过滤器。
otLinkResetCounters(otInstance *aInstance)
void
重置 MAC 层计数器。
otLinkResetTxRetrySuccessHistogram(otInstance *aInstance)
void
清除直接和间接传输的直方图统计信息。
otLinkSendDataRequest(otInstance *aInstance)
将 IEEE 802.15.4 数据请求消息加入队列以便传输。
otLinkSendEmptyData(otInstance *aInstance)
指示设备发送一个空的 IEEE 802.15.4 数据帧。
otLinkSetChannel(otInstance *aInstance, uint8_t aChannel)
设置 IEEE 802.15.4 信道。
otLinkSetCslChannel(otInstance *aInstance, uint8_t aChannel)
设置 CSL 渠道。
otLinkSetCslPeriod(otInstance *aInstance, uint32_t aPeriod)
设置 CSL 周期(以微秒为单位)。
otLinkSetCslTimeout(otInstance *aInstance, uint32_t aTimeout)
设置 CSL 超时(以秒为单位)。
otLinkSetEnabled(otInstance *aInstance, bool aEnable)
启用或停用链接层。
otLinkSetExtendedAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
设置 IEEE 802.15.4 扩展地址。
otLinkSetMaxFrameRetriesDirect(otInstance *aInstance, uint8_t aMaxFrameRetriesDirect)
void
设置直接传输期间的帧重试次数上限。
otLinkSetMaxFrameRetriesIndirect(otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect)
void
设置间接传输期间的帧重试次数上限。
otLinkSetPanId(otInstance *aInstance, otPanId aPanId)
设置 IEEE 802.15.4 PAN ID。
otLinkSetPcapCallback(otInstance *aInstance, otLinkPcapCallback aPcapCallback, void *aCallbackContext)
void
注册回调,以提供收到的原始 IEEE 802.15.4 帧。
otLinkSetPollPeriod(otInstance *aInstance, uint32_t aPollPeriod)
为休眠终端设备设置/清除用户指定的/外部数据轮询期限。
otLinkSetPromiscuous(otInstance *aInstance, bool aPromiscuous)
启用或停用链路层混杂模式。
otLinkSetRadioFilterEnabled(otInstance *aInstance, bool aFilterEnabled)
void
启用/停用 IEEE 802.15.4 无线装置过滤器模式。
otLinkSetRegion(otInstance *aInstance, uint16_t aRegionCode)
设置地区代码。
otLinkSetSupportedChannelMask(otInstance *aInstance, uint32_t aChannelMask)
设置 MAC 层支持的信道掩码。

结构体

otActiveScanResult

表示收到的 IEEE 802.15.4 信标。

otEnergyScanResult

表示能量扫描结果。

otMacCounters

表示 MAC 层计数器。

otMacFilterEntry

表示 Mac 过滤器条目。

otThreadLinkInfo

表示从 Thread 电台收到的消息的链接特定信息。

枚举

类型定义符

函数

资源

OpenThread API 参考文档源自 GitHub 上提供的源代码。如需了解详情,或者为我们的文档做贡献,请参阅资源