TREL - 线程堆栈

此模块定义了用于 Thread over Infrastructure 的 Thread Radio Encapsulation Link (TREL) API。

摘要

此模块中的函数需要启用 OPENTHREAD_CONFIG_RADIO_LINK_TREL_ENABLE

类型定义符

otTrelPeer typedef
struct otTrelPeer
表示 TREL 对等方。
otTrelPeerIterator typedef
uint16_t
表示用于迭代 TREL 对等表条目的迭代器。

函数

otTrelGetNextPeer(otInstance *aInstance, otTrelPeerIterator *aIterator)
const otTrelPeer *
遍历对等表条目,并从表获取下一个条目。
otTrelInitPeerIterator(otInstance *aInstance, otTrelPeerIterator *aIterator)
void
初始化对等表迭代器。
otTrelIsEnabled(otInstance *aInstance)
bool
指示是否已启用 TREL 操作。
otTrelIsFilterEnabled(otInstance *aInstance)
bool
指明过滤器模式是否已启用。
otTrelSetEnabled(otInstance *aInstance, bool aEnable)
void
启用或停用 TREL 操作。
otTrelSetFilterEnabled(otInstance *aInstance, bool aEnable)
void
设置过滤模式(启用/停用过滤)。

结构体

otTrelPeer

表示 TREL 对等方。

类型定义符

otTrelPeer

struct otTrelPeer otTrelPeer

表示 TREL 对等方。

otTrelPeerIterator

uint16_t otTrelPeerIterator

表示用于迭代 TREL 对等表条目的迭代器。

函数

otTrelGetNextPeer

const otTrelPeer * otTrelGetNextPeer(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

遍历对等表条目,并从表获取下一个条目。

具体说明
参数
[in] aInstance
OpenThread 实例。
[in] aIterator
迭代器。必须初始化。
返回值
指向下一个 otTrelPeer 条目的指针,如果表中没有其他条目,则返回 NULL

otTrelInitPeerIterator

void otTrelInitPeerIterator(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

初始化对等表迭代器。

具体说明
参数
[in] aInstance
OpenThread 实例。
[in] aIterator
要初始化的迭代器。

otTrelIsEnabled

bool otTrelIsEnabled(
  otInstance *aInstance
)

指示是否已启用 TREL 操作。

具体说明
参数
[in] aInstance
OpenThread 实例。
返回值
TRUE
(如果已启用 TREL 操作)。
FALSE
如果 TREL 操作已停用。

otTrelIsFilterEnabled

bool otTrelIsFilterEnabled(
  otInstance *aInstance
)

指明过滤器模式是否已启用。

具体说明
参数
[in] aInstance
OpenThread 实例。
返回值
TRUE
(如果已启用 TREL 过滤模式)。
FALSE
(如果停用 TREL 过滤器模式)。

otTrelSetEnabled

void otTrelSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

启用或停用 TREL 操作。

aEnable 为 true 时,此函数会对本地浏览网域中的服务名称“_trel._udp”启动持续的 DNS-SD 浏览,以发现支持 TREL 的其他设备。设备还会使用 DNS-SD 注册要通告的新服务,服务名称为“_trel._udp”,表示其支持 TREL。然后,设备即可接收来自对等设备的 TREL 消息。

如果 aEnable 为 false,此函数会停止对服务名称“_trel._udp”进行 DNS-SD 浏览,停止通告 TREL DNS-SD 服务,并清除 TREL 对等表。

具体说明
参数
[in] aInstance
指向 OpenThread 实例的指针。
[in] aEnable
用于启用/停用 TREL 操作的布尔值。

otTrelSetFilterEnabled

void otTrelSetFilterEnabled(
  otInstance *aInstance,
  bool aEnable
)

设置过滤模式(启用/停用过滤)。

启用过滤模式后,系统会以静默方式丢弃通过 TREL 接口的所有 rx 和 tx 流量。这主要用于在测试期间使用。

与完全启动/停止 TREL 操作的 otTrel{Enable/Disable}() 不同,当过滤器模式启用时,TREL 接口会继续处于启用状态。

具体说明
参数
[in] aInstance
OpenThread 实例。
[in] aFiltered
为 TRUE 启用过滤模式,为 FALSE 以停用过滤模式。

资源

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