fuchsia.lowpan.thread

添加次数：7

协议

CapabilitiesConnector

在 fuchsia.lowpan.thread/capabilities.fidl 中定义

用于在 LoWPAN 设备上连接到 Capabilities 的协议。

添加日期：18

连接

连接到指定的 LoWPAN 设备上的 ThreadCapabilities 协议。

可通过调用 fuchsia.lowpan/Lookup.GetDevices 了解接口的名称。

如果在处理此请求时发生错误，则指定频道会关闭，并使用一段级义码代码来描述失败原因：

  • ZX_ERR_INVALID_ARGUMENT：给定的接口名称格式不正确或无效。
  • ZX_ERR_NOT_FOUND：找不到具有指定名称的接口。
  • ZX_ERR_NOT_SUPPORTED：接口存在，但不支持此协议。

请求

名称类型
name fuchsia.lowpan/InterfaceName
server_end server_end<ThreadCapabilities>

数据集

在 fuchsia.lowpan.thread/dataset.fidl 中定义

线程操作数据集协议。

此协议可能会公开 PII。

此协议提供了与管理原始 TLV 形式的 Thread 操作数据集相关的方法。

AttachAllNodesTo

将当前网络上的所有节点连接到给定数据集所描述的线程网络的请求。返回更改生效之前经过的毫秒数。

在功能上等同于 ot-br-posix 的 AttachAllNodesTo4。

如果此设备当前未配置，则调用此方法等同于调用 SetActiveTlvs()。

所有节点到新网络的转换最多可能需要五分钟。此方法返回网络完成转换所需的确切时间。

成功安排过渡后，此方法会返回。任何阻止此操作的调度成功完成的错误（例如，提供的数据集不完整）都会导致协议被关闭。

添加：8 项

请求

名称类型
dataset OperationalDatasetTlvs

响应

名称类型
delay_ms int64

GetActiveTlvs

获取并返回原始 TLV 形式的活动 Thread 操作数据集。在功能上等同于 otDatasetGetActiveTlvs()2。

此方法会返回活跃数据集；如果没有有效的操作数据集，则不会返回任何内容。

任何阻止操作成功完成的错误都会导致协议被关闭。

请求

<EMPTY>

响应

名称类型
dataset OperationalDatasetTlvs

SetActiveTlvs

以原始 TLV 形式设置活跃的线程操作数据集。 在功能上等同于 otDatasetSetActiveTlvs()3。

该方法会在操作成功完成后返回。

任何阻止操作成功完成的错误都会导致协议被关闭。

请求

名称类型
dataset OperationalDatasetTlvs

响应

<EMPTY>

DatasetConnector

在 fuchsia.lowpan.thread/dataset.fidl 中定义

用于连接到 LoWPAN 设备上的 Dataset 的协议。

连接

连接到指定的 LoWPAN 设备上的 Dataset 协议。

可通过调用 fuchsia.lowpan/Lookup.GetDevices 了解接口的名称。

如果在处理此请求时发生错误，则指定频道会关闭，并使用一段级义码代码来描述失败原因：

  • ZX_ERR_INVALID_ARGUMENT：给定的接口名称格式不正确或无效。
  • ZX_ERR_NOT_FOUND：找不到具有指定名称的接口。
  • ZX_ERR_NOT_SUPPORTED：接口存在，但不支持此协议。

请求

名称类型
name fuchsia.lowpan/InterfaceName
server_end server_end<Dataset>

功能

在 fuchsia.lowpan.thread/feature.fidl 中定义

用于提取和更新特定 LoWPAN 接口的 OpenThread 功能配置的协议。

添加：11

GetFeatureConfig

返回此接口的当前 OpenThread 功能配置。

如果返回值中未设置字段，则表示该功能不受支持。

请求

<EMPTY>

响应

名称类型
config FeatureConfig

UpdateFeatureConfig

用于更新此接口的当前 OpenThread 功能配置。

如果 config 中未设置任何字段，该字段将保持不变。

请求

名称类型
config FeatureConfig

响应

<EMPTY>

FeatureConnector

在 fuchsia.lowpan.thread/feature.fidl 中定义

用于连接到 LoWPAN 设备上的 Feature 的协议。

添加：11

连接

连接到指定的 LoWPAN 设备上的 Feature 协议。

可通过调用 fuchsia.lowpan/Lookup.GetDevices 了解接口的名称。

如果在处理此请求时发生错误，则指定频道会关闭，并使用一段级义码代码来描述失败原因：

  • ZX_ERR_INVALID_ARGUMENT：给定的接口名称格式不正确或无效。
  • ZX_ERR_NOT_FOUND：找不到具有指定名称的接口。
  • ZX_ERR_NOT_SUPPORTED：接口存在，但不支持此协议。

请求

名称类型
name fuchsia.lowpan/InterfaceName
server_end server_end<Feature>

长裤

在 fuchsia.lowpan.thread/meshcop.fidl 中定义

与网格调试协议 (Meshcop) 关联的方法。

UpdateTxtEntries

更新与 Meshcop 边界代理 DNS-SD 条目关联的 TXT 记录信息。这样，当您担任边境代理时，就可以通过本地网络发现有关设备的其他信息。

在功能上等同于 ot-br-posix 的 UpdateVendorMeshCopTxtEntries1。

通常，系统会更新以下键：

  • vn：供应商名称
  • mn：模型名称
  • vo：供应商 OUI
  • vd/vcd：供应商特定数据

有关所有键及其值的详细说明，请参阅 Thread 1.2 规范第 8.4.1.1.2 节中的表 8-4。

任何阻止操作成功完成的错误（例如，提供无效密钥）都会导致协议关闭。

请求

名称类型
txt_entries vector<TxtEntries>[32]

响应

<EMPTY>

MeshcopConnector

在 fuchsia.lowpan.thread/meshcop.fidl 中定义

用于在 LoWPAN 设备上连接到 Meshcop 的协议。

连接

连接到指定的 LoWPAN 接口上的 Meshcop 协议。

可通过调用 fuchsia.lowpan/Lookup.GetDevices 了解接口的名称。

如果在处理此请求时发生错误，则指定频道会关闭，并使用一段级义码代码来描述失败原因：

  • ZX_ERR_INVALID_ARGUMENT：给定的接口名称格式不正确或无效。
  • ZX_ERR_NOT_FOUND：找不到具有指定名称的接口。
  • ZX_ERR_NOT_SUPPORTED：接口存在，但不支持此协议。

请求

名称类型
name fuchsia.lowpan/InterfaceName
server_end server_end<Meshcop>

ThreadCapabilities

在 fuchsia.lowpan.thread/capabilities.fidl 中定义

用于检索线程堆栈支持的功能的协议。

添加日期：18

GetCapabilities

返回此接口的 Openthread 的当前功能。

功能在接口的生命周期内预计不会发生变化。

请求

<EMPTY>

响应

名称类型
capabilities Capabilities

结构

TxtEntries

在 fuchsia.lowpan.thread/meshcop.fidl 中定义

野战类型说明默认
key string[254]

此 TXT 条目的键字符串。

不得包含字符 =。 最大理论长度为 254 个字节。

 无默认取景方式
value vector<uint8>[253]

与此密钥关联的二进制值。

理论上的最大长度为 253 字节，比单字节键和键/值分隔符字节的 TXT 记录最大长度少 2 字节。

 无默认取景方式

枚举

DetailLoggingLevel 灵活

类型：uint32

在 fuchsia.lowpan.thread/feature.fidl 中定义

添加数量：12

名称值说明
0
1
2
3
4
5
6
7
8

表

功能

在 fuchsia.lowpan.thread/capabilities.fidl 中定义

Openthread 功能。

功能是指 Openthread 支持的功能。例如，nat64 是指，如果 openthread 具有对 nat64 所需的软件支持，nat64（由 Openthread 中定义的宏决定）即可。而不表示该功能是否处于启用状态。 下表介绍了受支持/不支持的 openthread 功能。 对于添加的每个新功能，下表都应更新。

添加日期：18

序数野战类型说明
nat64 bool

这些字段不能缺失。这些参数设置为 true 或 false。 说明是否支持 nat64。 如果 nat64 为 true，则 Openthread 支持 nat64，否则为 false。
dhcpv6_pd bool

说明是否支持 dhcpv6 前缀委托。 如果 dhcpv6_pd 为 true，则 Openthread 支持 dhcpv6pd，否则为 false。

FeatureConfig

在 fuchsia.lowpan.thread/feature.fidl 中定义

OpenThread 功能配置。

下表介绍了为给定接口启用或停用的 OpenThread 功能。如需了解详情，请参阅 Feature 协议。

添加：11

序数野战类型说明
trel_enabled bool

确定是启用还是停用了 TREL。
nat64_enabled bool

确定是启用还是停用 NAT64。
srp_replication_enabled bool

确定是启用还是停用了 SRP 复制。
detailed_logging_enabled bool

确定是否已启用详细日志记录。如果设置为 false，则应在 lowpan-ot-driver 中使用配置文件中设置的默认日志记录级别。

添加数量：12
detailed_logging_level DetailedLoggingLevel

设置目标日志级别。只有当 detailed_logging_enabled 设置为 true 时，才会使用该值。

添加数量：12
dhcpv6_pd_enabled bool

确定是启用或停用 DHCPv6-PD。

添加日期：18
dns_upstream_query_enabled bool

确定是启用还是停用了 DNS 上游查询。

添加数量：19

常量

名称值类型说明
MAX_DATASET_TLV_LEN 254 uint8

别名

名称值说明
OperationalDatasetTlvs vector[MAX_DATASET_TLV_LEN]

用于包含原始 TLV 形式的 Thread 数据集的数据类型。 在功能上等同于类型 otOperationalDatasetTlvs1。

有关线程 TLV 格式的详细信息，请参阅线程规范。