fuchsia.lowpan.thread

新增日期：7

通訊協定

CapabilitiesConnector

定義於 fuchsia.lowpan.thread/features.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

更新與網格架構邊界代理程式 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/features.fidl

用於擷取執行緒堆疊支援的通訊協定。

新增時間：18 歲

GetCapabilities

傳回這個介面目前使用的 Openthread 功能。

整個介面的生命週期內不會 變更任何功能

要求

<EMPTY>

回應

名稱類型
capabilities Capabilities

結構化

TxtEntries

定義於 fuchsia.lowpan.thread/meshcop.fidl

廣闊類型說明預設
key string[254]

這個 TXT 項目的金鑰字串。

不得包含 = 字元。理論長度上限為 254 個位元組。

 無預設
value vector<uint8>[253]

與這個鍵相關聯的二進位值。

理論長度上限是 253 個位元組，也就是小於 TXT 記錄長度上限的兩位元組，以用於單一位元組索引鍵和鍵/值分隔符位元組。

 無預設

ENUMS

詳細記錄層級彈性

類型：uint32

定義於 fuchsia.lowpan.thread/feature.fidl

新增時間：12 張

名稱物超所值說明
0
1
2
3
4
5
6
7
8

資料表

功能

定義於 fuchsia.lowpan.thread/features.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 功能。詳情請參閱功能通訊協定。

新增時間：11 張

序數廣闊類型說明
trel_enabled bool

決定 TREL 是否啟用或停用。
nat64_enabled bool

決定 NAT64 為啟用或停用狀態。
srp_replication_enabled bool

決定啟用或停用 SRP 複製功能。
detailed_logging_enabled bool

判斷詳細記錄功能是否已啟用。如果設為 False，應在 lowpan-ot-驅動程式庫中使用在設定檔中設定的預設記錄層級。

新增時間：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 類型。

如需 Thread TLV 格式的詳細資訊，請參閱執行緒規格。