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.
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:
o
: mObtainNetworkKeyEnabledn
: mNativeCommissioningEnabledr
: mRoutersEnabledc
: mExternalCommissioningEnabledb
: mBeaconsEnabledC
: mCommercialCommissioningEnablede
: mAutonomousEnrollmentEnabledp
: mNetworkKeyProvisioningEnabledR
: mNonCcmRoutersEnabled
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