Datasets mit OT CLI anzeigen und verwalten

Quelle auf GitHub ansehen

Thread-Netzwerkkonfigurationsparameter werden mithilfe von aktiven und ausstehenden operativen Dataset-Objekten verwaltet. Die OT-Befehlszeile enthält Befehle zum Abrufen und Festlegen von aktiven und ausstehenden Datasets.

WARNUNG: Einschränkungen für Produktionsnutzung!

Mit den CLI-Befehlen zum Schreiben oder Ändern der aktiven und ausstehenden operativen Datasets können zu Testzwecken ungültige Parameter oder ungültige Kombinationen von Parametern festgelegt werden. Diese Befehlszeilenbefehle können nur verwendet werden:

  • Netzwerkparameter für das erste Gerät in einem neu erstellten Thread-Netzwerk konfigurieren
  • Zu Testzwecken (gilt nicht für Produktionsgeräte).

In Produktions-Thread-Netzwerken erfolgt die richtige Methode zum Schreiben oder Ändern von operativen Datasets über einen Initiator, der die Inbetriebnahme durchführt. Produktionsgeräte, die kein aktiver Beauftragter und Teil eines Thread-Netzwerks sind, DÜRFEN die operativen Datasets in keiner Weise ändern.

Aktives operatives Dataset

Das aktive operative Dataset enthält Parameter, die derzeit in einem gesamten Thread-Netzwerk verwendet werden. Das aktive operative Dataset enthält:

  • Aktiver Zeitstempel
  • Kanal
  • Kanalmaske
  • Erweiterte PAN
  • Mesh-Lokales-Präfix
  • Netzwerkname
  • PAN
  • Logo: PSKC
  • Sicherheitsrichtlinie

Um ein Gerät auf einfache Weise so zu konfigurieren, dass es ein vollständiges Mitglied des Thread-Netzwerks ist, können Sie den Befehl dataset Active -x verwenden, um einen hexadezimal codierten TLV abzurufen, und den Befehl dataset set Active, um das Dataset auf einem neuen Gerät festzulegen.

Rufen Sie auf einem vorhandenen Gerät den hexadezimal codierten TLV ab:

dataset active -x
0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

Legen Sie auf einem neuen Gerät das aktive Dataset fest:

dataset set active 0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

Ausstehendes operatives Dataset

Über das ausstehende operative Dataset werden Änderungen am aktiven operativen Dataset informiert, bevor sie wirksam werden. Das ausstehende operative Dataset enthält alle Parameter aus dem aktiven operativen Dataset sowie Folgendes:

  • Timer verzögern
  • Zeitstempel ausstehend

Mehr erfahren

Wenn Sie Datasets über die Befehlszeile verwalten möchten, schließen Sie unser Simulations-Codelab mit Docker ab und sehen Sie sich die Befehlsreferenz der Befehlszeile an.

Zum Simulations-Codelab

Zur Befehlsreferenz der Befehlszeile

Geben Sie help ein, um eine Liste der dataset-Befehle aufzurufen:

dataset help
help
active
activetimestamp
channel
channelmask
clear
commit
delay
extpanid
init
meshlocalprefix
mgmtgetcommand
mgmtsetcommand
networkkey
networkname
panid
pending
pendingtimestamp
pskc
securitypolicy
Done

Argumentzuordnungen

Sicherheitsrichtlinie

Sicherheitsrichtlinienbefehle verwenden Argumentzuordnungen zum Abrufen und Festlegen von otSecurityPolicy-Mitgliedern. Beispiel: dataset active:

dataset active
Active Timestamp: 1
Channel: 13
Channel Mask: 0x07fff800
Ext PAN ID: d63e8e3e495ebbc3
Mesh Local Prefix: fd3d:b50b:f96d:722d::/64
Network Key: dfd34f0f05cad978ec4e32b0413038ff
Network Name: OpenThread-8f28
PAN ID: 0x8f28
PSKc: c23a76e98f1a6483639b1ac1271e2e27
Security Policy: 0, onrcb
Done

In diesem Beispiel steht Security Policy: 0 für mRotationTime.

Im Folgenden finden Sie eine Liste aller Argumente der Sicherheitsrichtlinie-Befehlszeile und des entsprechenden otSecurityPolicy-Mitglieds für jedes Argument:

Die dataset securitypolicy-Befehle „get“ und „set“ verwenden ebenfalls die gleichen Argumentzuordnungen. So werden beispielsweise securitypolicy festgelegt und o, n, r und c übergeben:

dataset securitypolicy 672 onrc
Done

Dataset-Komponenten und mgmt-Befehle

Neben anderen Parametern können Sie mit mgmtgetcommand und mgmtsetcommand für aktive und ausstehende Datasets eine beliebige Kombination von otOperationalDatasetComponents abrufen und festlegen:

  • activetimestamp
  • pendingtimestamp
  • networkkey
  • networkname
  • extpanid
  • localprefix
  • delaytimer
  • panid
  • channel
  • securitypolicy

Für mgmtgetcommand können Sie diese Komponenten in beliebiger Reihenfolge angeben, um die entsprechenden Werte zu erhalten. Optional können Sie auch -x übergeben, um einen Hexadezimalstring zu verwenden, der als Bytesequenzdarstellung von TLVs behandelt wird. Das können anbieterspezifische TLVs sein, die Sie zusätzlich zu anderen Parametern hinzufügen möchten.

Mit mgmtgetcommand können Sie außerdem optional die IPv6-Adresse des Leaders angeben. Andernfalls wird das führende ALOC verwendet.

dataset mgmtgetcommand {active|pending} [address leader-address] [dataset-components] [-x tlv-list]

Um activetimestamp und securitypolicy abzurufen, verwenden Sie beispielsweise die folgenden Argumente:

dataset mgmtgetcommand active address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done

Zum Festlegen von Komponenten können Sie auch die Dataset-Komponenten in beliebiger Reihenfolge, gefolgt vom Komponentenwert, angeben.

dataset mgmtgetcommand {active|pending} [dataset-components] [-x tlv-list]

Verwenden Sie die folgenden Argumente, um activetimestamp und securitypolicy festzulegen:

dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrc
Done