Wyświetlanie zbiorów danych i zarządzanie nimi za pomocą interfejsu wiersza poleceń OT

Wyświetl źródło na GitHubie

Parametry konfiguracji sieci typu Thread są zarządzane za pomocą wartości aktywnych i oczekujących operacyjne obiekty zbioru danych, Interfejs wiersza poleceń OT zawiera polecenia do aktywowania i ustawienia Aktywne i oczekujących zbiorów danych.

OSTRZEŻENIE – ograniczenia dotyczące użytkowania w środowisku produkcyjnym

polecenia interfejsu wiersza poleceń do zapisywania lub zmieniania aktywnych i oczekujących zbiorów danych operacyjnych mogą umożliwić ustawienie nieprawidłowych parametrów; nieprawidłowych kombinacji parametrów do celów testowych. Tych poleceń interfejsu wiersza poleceń można używać tylko:

  • Aby skonfigurować parametry sieci dla pierwszego urządzenia w nowo utworzonej sieci Thread.
  • Do testowania (nie dotyczy urządzeń produkcyjnych).

W produkcyjnych sieciach Thread prawidłową metodą zapisu lub zmiany zbiorów danych operacyjnych jest Komisarz który zajmuje się realizacją prowizji. urządzenia produkcyjne, które nie są aktywnym komisarzem ani częścią usługi. sieci Thread W żaden sposób NIE MOŻE modyfikować zbiorów danych operacyjnych.

Aktywny zbiór danych operacyjnych

Aktywny zbiór danych operacyjnych zawiera parametry, które są obecnie używane w całej sieci Thread. Aktywny zbiór danych operacyjnych zawiera:

  • Aktywna sygnatura czasowa
  • Kanał
  • Maska kanału
  • Rozszerzony identyfikator PAN
  • Prefiks lokalny w sieci typu mesh
  • Nazwa sieci
  • PAN
  • PSKc
  • Zasada zabezpieczeń

Aby łatwo skonfigurować urządzenie tak, aby było ono w pełni częścią sieci Thread, możesz użyć polecenia dataset Active -x, otrzymasz zakodowany szesnastkowo kod TLV, polecenie dataset Active, na które ustawić zbiór danych na nowym urządzeniu.

Z istniejącego urządzenia pobierz plik TLV zakodowany szesnastkowo:

dataset active -x
0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

Na nowym urządzeniu ustaw aktywny zbiór danych:

dataset set active 0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

Oczekujący operacyjny zbiór danych

Oczekujący zbiór danych operacyjnych służy do przekazywania informacji o zmianach w aktywnym Zbiór danych operacyjnych, zanim zaczną obowiązywać. Oczekujący zbiór danych operacyjnych zawiera wszystkie parametry z aktywnego zbioru danych operacyjnych, przy czym dodanie:

  • Opóźnij minutnik
  • Oczekująca sygnatura czasowa

Rozpocznij

Aby zarządzać zbiorami danych z poziomu wiersza poleceń, wykonaj nasze symulacyjne ćwiczenia z programowania, w którym Dockera i przejrzyj dokument referencyjny polecenia interfejsu wiersza poleceń.

Otwórz ćwiczenia z programowania dotyczące symulacji

Przejdź do materiałów na temat polecenia interfejsu wiersza poleceń

Aby zobaczyć listę poleceń dataset, wpisz help:

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

Mapowania argumentów

Zasada zabezpieczeń

Polecenia dotyczące zasad zabezpieczeń używają mapowania argumentów do pobierania i ustawiania otSecurityPolicy członków. Przykład: 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

W tym przykładzie Security Policy: 0 wskazuje mRotationTime.

Oto lista wszystkich argumentów interfejsu wiersza poleceń zasad zabezpieczeń odpowiadający elementowi otSecurityPolicy dla każdego argumentu:

Polecenia get i set dla funkcji dataset securitypolicy również używają tego samego argumentu mapowania, np. ustawienie securitypolicy i przekazanie wartości o, n, r, i c:

dataset securitypolicy 672 onrc
Done

Komponenty zbioru danych i polecenia mgmt

Oprócz innych parametrów parametry mgmtgetcommand i mgmtsetcommand dla aktywnych i oczekujących zbiorów danych pozwalają uzyskać i ustawić dowolną kombinację z komponentów otOperationalDatasetComponents:

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

W przypadku elementu mgmtgetcommand możesz określić te komponenty w dowolnej kolejności, aby uzyskać odpowiednich wartości. Opcjonalnie można też przekazać -x, aby użyć wartości szesnastkowej ciąg znaków będący reprezentacją ciągów TLV w postaci sekwencji bajtów. Może to być dostawca konkretne identyfikatory TLV, które możesz dodać oprócz innych parametrów.

mgmtgetcommand umożliwia też opcjonalnie określenie adresu IPv6 lub lidera. W innym przypadku używany jest najlepszy wynik ALOC.

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

Aby na przykład uzyskać activetimestamp i securitypolicy, użyj następującego kodu argumenty:

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

Komponenty zbioru danych możesz też ustawiać w dowolnej kolejności, po nim wartość komponentu.

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

Aby ustawić activetimestamp i securitypolicy, użyj tych instrukcji argumenty:

dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrc
Done