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 Thread są zarządzane za pomocą obiektów Active (Aktywnych) i Pending Operational Dataset. Interfejs wiersza poleceń OT zawiera polecenia do pobierania i ustawiania zbiorów danych aktywnych i oczekujących.

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

Polecenia interfejsu wiersza poleceń służące do zapisywania lub zmiany aktywnych i oczekujących zbiorów danych operacyjnych mogą umożliwiać ustawianie nieprawidłowych parametrów lub 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.
  • Na potrzeby testowania (nie dotyczy urządzeń produkcyjnych).

W sieciach produkcyjnych Thread właściwą metodą zapisu lub zmiany zbiorów danych operacyjnych jest komisarz, który wykonuje zlecenie. Urządzenia produkcyjne, które nie są aktywnym komisarzem i należą do sieci Thread, NIE MOGĄ w żaden sposób 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 typu mesh
  • Nazwa sieci
  • PAN
  • klucz PSKc
  • Zasada zabezpieczeń

Aby łatwo skonfigurować urządzenie tak, aby należało do pełnej sieci Thread, możesz użyć polecenia dataset aktywnej -x, aby uzyskać szesnastkowy kod TLV, a za pomocą polecenia dataset Active (aktywny zbiór danych) umieścić zbiór danych na nowym urządzeniu.

Na istniejącym urządzeniu pobierz TLV zakodowany pod postacią liczby szesnastkowej:

dataset active -x
0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

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

dataset set active 0e080000000000010000000300001035060004001fffe00208e227ac6a7f24052f0708fdb753eb517cb4d3051062b2442a928d9ea3b947a1618fc4085a030f4f70656e5468726561642d393837330102987304105330d857354330133c05e1fd7ae81a910c0402a0f7f8
Done

Oczekujący zbiór danych operacyjnych

Oczekujący zbiór danych operacyjnych jest używany do przekazywania informacji o zmianach w aktywnym zbiorze danych operacyjnych, zanim zaczną obowiązywać. Oczekuje na zbiór danych operacyjnych zawiera wszystkie parametry z aktywnego zbioru danych operacyjnych oraz:

  • Opóźniacz
  • Oczekiwanie na znacznik czasu

Rozpocznij

Aby zarządzać zbiorami danych za pomocą wiersza poleceń, ukończ nasze ćwiczenia z programowania symulacji w Dockerie i zapoznaj się z dokumentacją poleceń interfejsu wiersza poleceń.

Otwórz ćwiczenia z programowania symulacji

Otwórz dokumentację poleceń interfejsu wiersza poleceń

Aby wyświetlić 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 zasad zabezpieczeń używają mapowań argumentów do pobierania i ustawiania elementów otSecurityPolicy. Na 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ń i odpowiadających im argumentów otSecurityPolicy dla każdego argumentu:

Polecenia get i set dataset securitypolicy korzystają też z tych samych mapowań argumentów, np. ustawiania securitypolicy oraz przekazywania o, n, r i c:

dataset securitypolicy 672 onrc
Done

Komponenty zbioru danych i polecenia mgmt

Wraz z innymi parametrami opcje mgmtgetcommand i mgmtsetcommand dotyczące aktywnych i oczekujących zbiorów danych umożliwiają pobieranie i ustawianie dowolnej kombinacji parametrów otOperationalDatasetComponents:

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

W polu mgmtgetcommand możesz określić te komponenty w dowolnej kolejności, aby uzyskać odpowiednie wartości. Możesz też przekazać -x, aby użyć ciągu szesnastkowego, który jest traktowany jako ciąg bajtów TLV. Mogą to być TLV od konkretnego dostawcy, które warto dodać oprócz innych parametrów.

mgmtgetcommand umożliwia też opcjonalnie określenie adresu IPv6 repliki wiodącej. W przeciwnym razie używany jest najlepszy wynik ALOC.

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

Aby np. uzyskać activetimestamp i securitypolicy, użyj tych argumentów:

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

Aby ustawić komponenty, możesz też podać komponenty zbioru danych w dowolnej kolejności, a po nich podaj wartość komponentu.

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

Aby ustawić activetimestamp i securitypolicy, użyj tych argumentów:

dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrc
Done