Dokumentacja poleceń interfejsu wiersza poleceń

klucz efemeryczny ba

Wskazuje, czy klucz tymczasowy jest obecnie aktywny.

Wymaga OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

Parametry

Brak parametrów.

Przykłady

ba ephemeralkey
active
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

wywołanie zwrotne ba na temat klucza efemerycznego (włącz, wyłącz)

Ustawia funkcję wywołania zwrotnego używaną przez agenta Granica do powiadamiania o zmianach związanych z użyciem klucza tymczasowego.

Wymaga OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

Kolejne wywołanie tej funkcji zastąpi każde wcześniej ustawione wywołanie zwrotne.

Parametry

Brak parametrów.

Przykłady

ba ephemeralkey callback enable
Done
ba ephemeralkey set W10X1 5000 49155
Done
BorderAgent callback: Ephemeral key active, port:49155
BorderAgent callback: Ephemeral key inactive

Dokumentacja interfejsu wiersza poleceń i interfejsu API

jasny klucz ba

Anuluje używany klucz tymczasowy.

Wymaga OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

Pozwala anulować ustawiony wcześniej klucz tymczasowy, zanim zostanie przekroczony limit czasu. Jeśli agent Granica nie jest uruchomiony lub nie jest używany klucz tymczasowy, wywołanie tej funkcji nie przyniesie żadnego efektu.

Jeśli komisarz jest połączony za pomocą klucza tymczasowego i jest obecnie aktywny, wywołanie tej funkcji nie zmienia stanu. W tym przypadku otBorderAgentIsEphemeralKeyActive() będzie zwracać wartość TRUE, dopóki komisarz się nie rozłączy.

Parametry

Brak parametrów.

Przykłady

ba ephemeralkey clear
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zestaw kluczy tymczasowych ba [timeout-in-msec] [port]

Ustawia klucz tymczasowy dla danego limitu czasu.

Wymaga OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

Klucz tymczasowy można ustawić, gdy agent Granica jest już uruchomiony i nie jest połączony z żadnym zewnętrznym komisarzem (czyli jest w stanie OT_BORDER_AGENT_STATE_STARTED). W przeciwnym razie zwracany jest OT_ERROR_INVALID_STATE.

Podana wartość aKeyString jest bezpośrednio używana jako efemeryczny klucz PSK (z wyłączeniem null na końcu znaku \0). Długość aKeyString musi należeć do zakresu od OT_BORDER_AGENT_MIN_EPHEMERAL_KEY_LENGTH do OT_BORDER_AGENT_MAX_EPHEMERAL_KEY_LENGTH włącznie.

Ponowne ustawienie klucza tymczasowego, zanim upłynie limit czasu ustawionego wcześniej, spowoduje zastąpienie wcześniej ustawionego klucza i zresetowanie czasu oczekiwania.

Gdy obowiązuje limit czasu oczekiwania, zewnętrzny inspektor może użyć klucza tymczasowego tylko raz, aby się połączyć. Po rozłączeniu komisarza klucz tymczasowy zostaje wyczyszczony, a agent graniczny powraca do korzystania z PSKc.

Parametry

Brak parametrów.

Przykłady

ba ephemeralkey set Z10X20g3J15w1000P60m16 5000 1234
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

identyfikator ba (get,set)

Pobiera lub ustawia 16-bajtowy identyfikator routera Border Router, który może jednoznacznie identyfikować urządzenie wśród wielu BR.

Parametry

ba id [border-agent-id]

Użyj opcjonalnego argumentu border-agent-id, aby ustawić identyfikator agenta granicznego.

Przykłady

ba id
cb6da1e0c0448aaec39fa90f3d58f45c
Done
ba id 00112233445566778899aabbccddeeff
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

port Ba

Pobiera port UDP usługi agenta Thread Border.

Parametry

Brak parametrów.

Przykłady

ba port
49153
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

stan Ba

Pobiera wartość otBorderAgentState roli agenta Thread Border.

Parametry

Brak parametrów.

Przykłady

ba state
Started
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

BBR

Zwraca bieżące informacje o głównym routerze szkieletowym dla urządzenia Thread.

Parametry

Brak parametrów.

Przykłady

bbr
BBR Primary:
server16: 0xE400
seqno:    10
delay:    120 secs
timeout:  300 secs
Done
bbr
BBR Primary: None
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

Konfiguracja bbr (zestaw)

Ustawia konfigurację lokalnego routera szkieletowego otBackboneRouterConfig.

Komunikat SRV_DATA.ntf żądania danych serwera jest inicjowany automatycznie, jeśli zmieni się zbiór danych BBR dla głównego routera szkieletowego.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE.

Interfejs bbr register powinien zostać wystawiony bezpośrednio, aby zarejestrować usługę routera szkieletowego na serwerze wiodącym dla dodatkowego routera szkieletowego.

Parametry

bbr config [seqno seqno] [delay delay] [timeout timeout]

Przykłady

bbr config seqno 20 delay 30
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Konfiguracja bbr

Pobiera konfigurację lokalnego routera szkieletowego.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE.

Parametry

Brak parametrów.

Przykłady

bbr config
seqno:    10
delay:    120 secs
timeout:  300 secs
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Wyłącz BBR

Włącza lub wyłącza funkcję szkieletu.

Jeśli ta opcja jest włączona, w przypadku podłączonego urządzenia, gdy w danych sieciowych Thread nie ma usługi routera szkieletowego, dla podłączonego urządzenia jest wywoływany komunikat SRV_DATA.ntf dotyczący żądania danych serwera.

Jeśli wyłączono, SRV_DATA.ntf jest aktywowany, gdy router szkieletowy jest w stanie głównym.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE.

Parametry

Brak parametrów.

Przykłady

bbr disable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Włącz BBR

Włącza lub wyłącza funkcję szkieletu.

Jeśli ta opcja jest włączona, w przypadku podłączonego urządzenia, gdy w danych sieciowych Thread nie ma usługi routera szkieletowego, dla podłączonego urządzenia jest wywoływany komunikat SRV_DATA.ntf dotyczący żądania danych serwera.

Jeśli wyłączono, SRV_DATA.ntf jest aktywowany, gdy router szkieletowy jest w stanie głównym.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE.

Parametry

Brak parametrów.

Przykłady

bbr enable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zakłócenia w bbr (get,set)

Pobiera lub ustawia zakłócenia (w sekundach) podczas rejestracji routera szkieletowego.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE.

Parametry

bbr jitter [jitter]

Przykłady

bbr jitter
20
Done
bbr jitter 10
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

bbr mgmt dua

Po dołączeniu meshLocalIid to polecenie konfiguruje stan odpowiedzi na potrzeby następnej rejestracji w DUA. Bez funkcji meshLocalIid w odpowiedzi na następne żądanie DUA.req podaj wartość status lub coap-code.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

Parametry

bbr mgmt dua status|coap-code [meshLocalIid]

W przypadku usługi status lub coap-code użyj:

  • 0: ST_DUA_SUCCESS
  • 1: ST_DUA_REREGISTER
  • 2: ST_DUA_FAILED
  • 3: ST_DUA_DUPLICATE
  • 4: ST_DUA_NO_RESOURCES
  • 5: ST_DUA_BBR_NOT_PRIMARY
  • 6: ST_DUA_GENERAL_FAILURE
  • 160: kod COAP 5.00.

Przykłady

bbr mgmt dua 1 2f7c235e5025a2fd
Done
bbr mgmt dua 160
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

bbr mgmt mlr detektor dodaj

Dodaje detektor multiemisji z wartością limitu czasu w sekundach.

Przekaż 0, aby użyć domyślnego limitu czasu MLR.

Dostępne, gdy włączone są funkcje OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE i OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

Parametry

bbr mgmt mlr listener add ipaddress [timeout-seconds]

Przykłady

bbr mgmt mlr listener add ff04::1
Done
bbr mgmt mlr listener add ff04::2 300
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

bbr mgmt słuchacz mlr

Zwraca detektory multiemisji z wartością otBackboneRouterMulticastListenerInfomTimeout w sekundach.

Dostępne, gdy włączone są funkcje OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE i OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE.

Parametry

Brak parametrów.

Przykłady

bbr mgmt mlr listener
ff04:0:0:0:0:0:0:abcd 3534000
ff04:0:0:0:0:0:0:eeee 3537610
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

bbr mgmt mlr słuchacz wyczyść

Usuwa detektory multiemisji.

Dostępne, gdy włączone są funkcje OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE i OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

Parametry

Brak parametrów.

Przykłady

bbr mgmt mlr listener clear
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

bbr mgmt odpowiedź mlr

Konfiguruje stan odpowiedzi dla następnej rejestracji odbiornika multiemisji.

Dostępne, gdy włączone są funkcje OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE i OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

Parametry

bbr mgmt mlr response status-code

W przypadku status-code użyj:

  • 0: ST_MLR_SUCCESS
  • 2: ST_MLR_FAILED
  • 3: ST_MLR_NO_PERSISTENT
  • 4: ST_MLR_NO_RESOURCES
  • 5: ST_MLR_BBR_NOT_PRIMARY
  • 6: ST_MLR_GENERAL_FAILURE

Przykłady

bbr mgmt mlr response 2
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

rejestr bbr

Jawnie rejestruje konfigurację lokalnego routera szkieletowego.

Dla podłączonego urządzenia aktywowano wiadomość z żądaniem danych serwera (SRV_DATA.ntf).

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE.

Parametry

Brak parametrów.

Przykłady

bbr register
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

stan CBB

Pobiera router szkieletowy otBackboneRouterState.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE.

Parametry

Brak parametrów.

Przykłady

bbr state
Disabled
Done
bbr state
Primary
Done
bbr state
Secondary
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

br wyłącz

Wyłącza menedżera granic granicznych.

Parametry

Brak parametrów.

Przykłady

br disable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

br włącz

Włącza menedżera granic granicznych.

Parametry

Brak parametrów.

Przykłady

br enable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

br init

Inicjuje menedżera granic granicznych.

Parametry

br init infrastructure-network-index is-running

Przykłady

br init 2 1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

br nat64prefiks

Na wyjściu generuje zarówno lokalne, jak i preferowane prefiksy NAT64.

Parametry

Brak parametrów.

Przykłady

br nat64prefix
Local: fd14:1078:b3d5:b0b0:0:0::/96
Favored: fd14:1078:b3d5:b0b0:0:0::/96 prf:low
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

preferowany przedrostek br nat64

Pobiera aktualnie preferowany prefiks NAT64.

Ulubiony prefiks NAT64 można wykryć za pomocą linku infrastruktury lub może to być lokalny prefiks NAT64 tego urządzenia.

Parametry

Brak parametrów.

Przykłady

br nat64prefix favored
fd14:1078:b3d5:b0b0:0:0::/96 prf:low
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

br nat64prefix lokal

Pobiera lokalny prefiks NAT64 routera granicznego.

Prefiks NAT64 może nie być rozgłaszany w sieci Thread.

Opcja OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE musi być włączona.

Parametry

Brak parametrów.

Przykłady

br nat64prefix local
fd14:1078:b3d5:b0b0:0:0::/96
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

br omrprefix

Na wyjściu generuje zarówno lokalny, jak i preferowany prefiks OMR.

Parametry

Brak parametrów.

Przykłady

br omrprefix
Local: fdfc:1ff5:1512:5622::/64
Favored: fdfc:1ff5:1512:5622::/64 prf:low
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

preferowany przedrostek br omrprefix

Pobiera aktualnie preferowany prefiks Off-Mesh-Routable (OMR).

preferowany prefiks OMR można wykryć na podstawie danych sieci lub być lokalnym prefiksem OMR tego urządzenia.

Parametry

Brak parametrów.

Przykłady

br omrprefix favored
fdfc:1ff5:1512:5622::/64 prf:low
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

br omrprefix lokal

Pobiera lokalny prefiks Off-Mesh-Routable (OMR), np. fdfc:1ff5:1512:5622::/64.

Prefiks OMR to generowany losowo 64-bitowy prefiks opublikowany w sieci Thread, jeśli jeszcze go nie ma. Ten prefiks jest dostępny z poziomu lokalnej sieci Wi-Fi lub Ethernet.

Parametry

Brak parametrów.

Przykłady

br omrprefix local
fdfc:1ff5:1512:5622::/64
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

br onlinkprefix

Na wyjściu generuje zarówno lokalne, jak i preferowane prefiksy on-link.

Parametry

Brak parametrów.

Przykłady

br onlinkprefix
Local: fd41:2650:a6f5:0::/64
Favored: 2600::0:1234:da12::/64
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

br, preferowany przedrostek onlink

Pobiera aktualnie preferowany prefiks On-Link.

Prefiks preferowany to wykryty prefiks łącza w ramach linku infrastruktury lub lokalny prefiks on-link.

Parametry

Brak parametrów.

Przykłady

br onlinkprefix favored
2600::0:1234:da12::/64
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

br onlinkprefix lokalny

Pobiera lokalny prefiks On-Link dla sąsiadującego połączenia z infrastrukturą.

Lokalny prefiks On-Link to 64-bitowy prefiks, który jest rozgłaszany w linku infrastruktury, jeśli nie ma jeszcze rozgłaszanego przez link, którego można używać w prefiksie on-link.

Parametry

Brak parametrów.

Przykłady

br onlinkprefix local
fd41:2650:a6f5:0::/64
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

tabela prefiksów br

Pobieranie wykrytych prefiksów przez menedżera routingu granic z połączenia infrastruktury. Informacje o każdym wpisie prefiksu:

  • Prefiks
  • Wskazuje, czy prefiks jest „on-link” czy „trasa”.
  • Liczba milisekund od ostatniego otrzymania reklamy routera zawierającej ten prefiks
  • Czas życia prefiksu w sekundach
  • Preferowany czas życia w sekundach tylko wtedy, gdy prefiks jest w linku
  • preferencja trasy (niska, średnia, wysoka) tylko wtedy, gdy prefiks jest trasą (a nie w linku)
  • Adres IPv6 routera, który reklamuje ten prefiks
  • Flagi w otrzymanym nagłówku reklamy routera:
    • M: flaga konfiguracji adresu zarządzanego
    • O: inna flaga konfiguracji
    • Fragment: flaga routera pośredniczącego (wskazuje, czy router jest routerem typu stub)

Parametry

Brak parametrów.

Przykłady

br prefixtable
prefix:fd00:1234:5678:0::/64, on-link:no, ms-since-rx:29526, lifetime:1800, route-prf:med,
router:ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1)
prefix:1200:abba:baba:0::/64, on-link:yes, ms-since-rx:29527, lifetime:1800, preferred:1800,
router:ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1)
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

br raoptions (set,clear)

Konfiguruje dodatkowe opcje dołączania na końcu wysyłanych komunikatów RA.

Zawartość obiektu aOptions jest kopiowana wewnętrznie, więc może być buforem tymczasowym (np. tablica przydzielona przez stos).

Kolejne wywołania tej funkcji zastępują poprzednio ustawioną wartość.

Parametry

br raoptions options|clear

br raoptions clear przekazuje nullptr do otBorderRoutingSetExtraRouterAdvertOptions. W przeciwnym razie możesz przekazać bajt options jako dane szesnastkowe.

Przykłady

br raoptions 0400ff00020001
Done
br raoptions clear
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

br rioprf (wysoki,średni,niski)

Jawnie ustawia preferencję używaną w przypadku reklamowania opcji informacji o trasach (RIO) w komunikatach reklam routera wysyłanych przez link infrastruktury.

Po wywołaniu tej funkcji BR będzie używać danego ustawienia dla wszystkich reklamowanych RIO. To ustawienie można wyczyścić, dzwoniąc pod numer otBorderRoutingClearRouteInfoOptionPreference() .

Parametry

br rioprf [high|med|low]

Przykłady

br rioprf low
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Br Rioprf

Pobiera bieżące ustawienie używane podczas reklamowania opcji informacji o trasach (RIO) w komunikatach reklam routera wysyłanych przez link infrastruktury.

Preferencje RIO są określane w ten sposób:

  • Jeśli zostanie ustawione przez użytkownika, wywołując metodę otBorderRoutingSetRouteInfoOptionPreference(), używane jest to ustawienie.
  • W przeciwnym razie jest ona określana na podstawie bieżącej roli urządzenia: Średnie preferencje w przypadku roli routera/lidera i niskie preferencje w przypadku roli podrzędnej.

Parametry

Brak parametrów.

Przykłady

br rioprf
med
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

br rioprf wyczyść

Usuwa poprzednio ustawioną wartość preferencji dla rozgłaszanych opcji informacji o trasie.

Po wywołaniu tej funkcji BR użyje roli urządzenia, aby określić preferencję RIO: Średnie preferencje w przypadku roli routera/lidera i niskie preferencje w przypadku roli podrzędnej.

Parametry

Brak parametrów.

Przykłady

br rioprf clear
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

br routeprf (wysoka,średnia,niska)

Jawnie ustawia preferencję opublikowanych tras w danych sieci.

Po wywołaniu tej funkcji BR użyje podanej preferencji. To ustawienie można wyczyścić, dzwoniąc pod numer otBorderRoutingClearRoutePreference() .

Parametry

br routeprf [high|med|low]

Przykłady

br routeprf low
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

BrRouteprf

Pobiera bieżące ustawienie używane w przypadku opublikowanych tras w danych sieci.

Preferencje są określane w następujący sposób:

  • Jeśli zostanie ustawione przez użytkownika, wywołując metodę otBorderRoutingSetRoutePreference(), używane jest to ustawienie.
  • W przeciwnym razie RoutingManager określi go automatycznie na podstawie roli urządzenia i jakości połączenia.

Parametry

Brak parametrów.

Przykłady

br routeprf
med
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

br trasaprf

Usuwa wcześniej ustawioną wartość preferencji dla opublikowanych tras w danych sieci.

Po wywołaniu tej funkcji BR automatycznie określi tę preferencję na podstawie roli urządzenia i jakości połączenia (w przypadku urządzenia nadrzędnego w przypadku urządzenia końcowego).

Parametry

Brak parametrów.

Przykłady

br routeprf clear
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

routery br

Pobierz listę routerów wykrytych przez menedżera Border Routing Manager z linku infrastruktury. Informacje dla każdego routera:

  • Adres IPv6 routera
  • Flagi w otrzymanym nagłówku reklamy routera:
    • M: flaga konfiguracji adresu zarządzanego
    • O: inna flaga konfiguracji
    • Fragment: flaga routera pośredniczącego (wskazuje, czy router jest routerem typu stub)

Parametry

Brak parametrów.

Przykłady

br routers
ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1)
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

stan br

Pobiera bieżący stan menedżera granic granicznych.

Parametry

Brak parametrów.

Przykłady

br state
running

Dokumentacja interfejsu wiersza poleceń i interfejsu API

informacje o buforze

Pobiera bieżące informacje z bufora wiadomości.

  • total wyświetla łączną liczbę buforów wiadomości w puli.
  • free wyświetla liczbę bezpłatnych buforów wiadomości.
  • max-used wyświetla maksymalną liczbę buforów używanych w tym samym czasie od zainicjowania stosu do pracy lub ostatniego bufferinfo reset.

Następnie interfejs wiersza poleceń wyświetla informacje o różnych kolejkach używanych przez stos OpenThread, na przykład 6lo send. Każdy wiersz po kolejce przedstawia informacje o kolejce:

  • Pierwsza liczba to liczba wiadomości w kolejce.
  • Druga liczba to liczba buforów używanych przez wszystkie wiadomości w kolejce.
  • Trzecia liczba to łączna liczba bajtów wszystkich wiadomości w kolejce.

Parametry

Brak parametrów.

Przykłady

bufferinfo
total: 40
free: 40
max-used: 5
6lo send: 0 0 0
6lo reas: 0 0 0
ip6: 0 0 0
mpl: 0 0 0
mle: 0 0 0
coap: 0 0 0
coap secure: 0 0 0
application coap: 0 0 0
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

resetowanie informacji o buforze

Zresetuj licznik informacji Bufor wiadomości śledzący maksymalną liczbę buforów używanych jednocześnie.

Spowoduje to zresetowanie urządzenia mMaxUsedBuffers w trybie otBufferInfo .

Parametry

Brak parametrów.

Przykłady

bufferinfo reset
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

ccathreshold (get,set)

Pobiera lub ustawia próg CCA w dBm mierzony na złączu anteny zgodnie z sekcją 10.1.4 standardu IEEE 802.15.4 – 2015 r.

Parametry

ccathreshold [CCA-threshold-dBm]

Aby ustawić próg CCA, użyj opcjonalnego argumentu CCA-threshold-dBm.

Przykłady

ccathreshold
-75 dBm
Done
ccathreshold -62
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

kanał (get,set)

Pobiera lub ustawia wartość kanału IEEE 802.15.4.

Parametry

channel [channel-num]

Użyj opcji channel-num, aby ustawić kanał.

Przykłady

channel
11
Done
channel 11
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

automatyczny menedżer kanału

Włącza lub wyłącza funkcję automatycznego wyboru kanału w przypadku kanału sieciowego.

Gdy ta opcja jest włączona, ChannelManager okresowo będzie wywoływać RequestChannelSelect(false). Odstęp między miesiączką można ustawić za pomocą wartości otChannelManagerSetAutoChannelSelectionInterval() .

Wymagane są ustawienia OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE lub OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE oraz OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

Parametry

channel manager auto enable

1 jest wartością logiczną enable.

Przykłady

channel manager auto 1
channel manager auto 1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zmiana menedżera kanału

Prosi o zmianę kanału sieci Thread.

Sieć przełącza się na dany kanał po określonym opóźnieniu (patrz funkcja otChannelManagerSetDelay()). Zmiana kanału jest przeprowadzana przez aktualizację oczekującego zbioru danych operacyjnych.

Następna rozmowa spowoduje anulowanie trwającej wcześniej zmiany w kanale.

Pole OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE jest wymagane.

Parametry

channel manager change channel-num

Przykłady

channel manager change 11
channel manager change 11
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

menedżer kanału

Pobrać stan menedżera kanału. Pole OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE lub OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE jest wymagane.

Parametry

Brak parametrów.

Przykłady

channel manager
channel: 11
auto: 1
delay: 120
interval: 10800
supported: { 11-26}
favored: { 11-26}
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

opóźnienie związane z menedżerem kanału

Określa opóźnienie (w sekundach) wykorzystywane przy zmianie kanału sieci.

Dostępne tylko dla FTD. Opóźnienie powinno być dłuższe niż maksymalny odstęp czasu odpytywania danych używany przez wszystkie Uśpione urządzenia końcowe w sieci Thread.

Pole OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE i OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE są wymagane.

Parametry

channel manager delay delay-seconds

Przykłady

channel manager delay 120
channel manager delay 120
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

faworyzowane przez menedżera kanału

Ustawia maskę ulubionego kanału.

Wymagane są ustawienia OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE lub OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE oraz OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

Parametry

channel manager favored mask

Przykłady

channel manager favored 0x7fffc00
channel manager favored 0x7fffc00
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

interwał menedżera kanału

Określa odstęp czasu (w sekundach) używany przez funkcję automatycznego wyboru kanałów.

Wymagane są ustawienia OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE lub OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE oraz OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

Parametry

channel manager interval interval-seconds

Przykłady

channel manager interval 10800
channel manager interval 10800
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

wybór menedżera kanału

ChannelManager prosi o zaznaczenie i wybranie nowego kanału oraz rozpoczęcie zmiany kanału.

W odróżnieniu od metody otChannelManagerRequestChannelChange() , gdzie kanał musi być podany jako parametr, funkcja ta prosi ChannelManager o wybranie samego kanału (na podstawie zebranych informacji o jakości kanału).

Po otrzymaniu połączenia menedżer kanału wykona te 3 czynności:

1) ChannelManager decyduje, czy zmiana kanału mogłaby być pomocna. To sprawdzenie można pominąć, jeśli zasada aSkipQualityCheck ma wartość Prawda (wymusza wybór kanału i pominięcie kontroli jakości). Ten krok wykorzystuje zebrane na urządzeniu dane o jakości linków (takie jak odsetek błędów CCA, odsetek błędów klatek i wiadomości według sąsiada itp.), aby określić, czy bieżąca jakość kanału jest na poziomie, który uzasadnia zmianę kanału.

2) Jeśli pierwszy krok zakończy się, ChannelManager wybierze potencjalnie lepszy kanał. Wykorzystuje zebrane dane o jakości kanału zebrane przez moduł ChannelMonitor. Na tym etapie używane są obsługiwane i preferowane kanały. (zobacz otChannelManagerSetSupportedChannels() i otChannelManagerSetFavoredChannels() ).

3) Jeśli nowo wybrany kanał jest inny niż bieżący, ChannelManager wysyła żądanie lub rozpoczyna proces zmiany kanału (wewnętrzne wywołanie RequestChannelChange()).

Wymagane są ustawienia OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE lub OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE oraz OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

Parametry

channel manager select skip-quality-check

Użyj 1 lub 0 jako wartości logicznej skip-quality-check.

Przykłady

channel manager select 1
channel manager select 1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

obsługiwany menedżer kanału

Ustawia obsługiwaną maskę kanału.

Wymagane są ustawienia OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE lub OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE oraz OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

Parametry

channel manager supported mask

Przykłady

channel manager supported 0x7fffc00
channel manager supported 0x7fffc00
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

próg menedżera kanału

Ustawia próg odsetka błędów CCA.

Wymagane są ustawienia OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE lub OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE oraz OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE.

Parametry

channel manager threshold threshold-percent

Użyj wartości szesnastkowej dla threshold-percent. 0 mapuje na 0%, a 0xffff na 100%.

Przykłady

channel manager threshold 0xffff
channel manager threshold 0xffff
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

monitor kanału

Pobierz bieżący stan monitorowania kanału i liczbę osób na kanale. Pole OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE jest wymagane.

Parametry

Brak parametrów.

Przykłady

channel monitor
enabled: 1
interval: 41000
threshold: -75
window: 960
count: 10552
occupancies:
ch 11 (0x0cb7)  4.96% busy
ch 12 (0x2e2b) 18.03% busy
ch 13 (0x2f54) 18.48% busy
ch 14 (0x0fef)  6.22% busy
ch 15 (0x1536)  8.28% busy
ch 16 (0x1746)  9.09% busy
ch 17 (0x0b8b)  4.50% busy
ch 18 (0x60a7) 37.75% busy
ch 19 (0x0810)  3.14% busy
ch 20 (0x0c2a)  4.75% busy
ch 21 (0x08dc)  3.46% busy
ch 22 (0x101d)  6.29% busy
ch 23 (0x0092)  0.22% busy
ch 24 (0x0028)  0.06% busy
ch 25 (0x0063)  0.15% busy
ch 26 (0x058c)  2.16% busy
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

uruchomienie monitorowania kanału

Włącz monitor kanału. Interfejs wiersza poleceń OT wysyła wartość logiczną true do parametru otChannelMonitorSetEnabled. Pole OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE jest wymagane.

Parametry

Brak parametrów.

Przykłady

channel monitor start
channel monitor start
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zatrzymanie monitorowania kanału

Zatrzymaj monitor kanału. Interfejs wiersza poleceń OT wysyła wartość logiczną false do parametru otChannelMonitorSetEnabled. Pole OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE jest wymagane.

Parametry

Brak parametrów.

Przykłady

channel monitor stop
channel monitor stop
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

preferowany kanał

Pobiera maskę kanału preferowanego przez urządzenie, którą urządzenie preferuje.

Parametry

Brak parametrów.

Przykłady

channel preferred
0x7fff800
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

obsługiwany kanał

Uzyskaj maskę kanału zgodną z radiem, na której może być włączone urządzenie.

Parametry

Brak parametrów.

Przykłady

channel supported
0x7fff800
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

element podrzędny (identyfikator)

Pobiera informacje diagnostyczne dotyczące powiązanego podmiotu podrzędnego na podstawie jego identyfikatora podrzędnego lub RLOC16.

Parametry

child child-id

Przykłady

child 1
Child ID: 1
Rloc: 9c01
Ext Addr: e2b3540590b0fd87
Mode: rn
CSL Synchronized: 1
Net Data: 184
Timeout: 100
Age: 0
Link Quality In: 3
RSSI: -20
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

lista podrzędna

Zwraca listę załączonych identyfikatorów elementów podrzędnych.

Parametry

Brak parametrów.

Przykłady

child list
1 2 3 6 7 8
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

tabela podrzędna

Drukuje tabelę z dołączonych elementów podrzędnych.

Parametry

Brak parametrów.

Przykłady

child table
| ID  | RLOC16 | Timeout    | Age        | LQ In | C_VN |R|D|N|Ver|CSL|QMsgCnt| Extended MAC     |
+-----+--------+------------+------------+-------+------+-+-+-+---+---+-------+------------------+
|   1 | 0xc801 |        240 |         24 |     3 |  131 |1|0|0|  3| 0 |     0 | 4ecede68435358ac |
|   2 | 0xc802 |        240 |          2 |     3 |  131 |0|0|0|  3| 1 |     0 | a672a601d2ce37d8 |
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Childrenip

Pobiera listę adresów IP przechowywanych na potrzeby elementów podrzędnych MTD.

Parametry

Brak parametrów.

Przykłady

childip
3401: fdde:ad00:beef:0:3037:3e03:8c5f:bc0c
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

childip max (set)

Ustawia lub przywraca maksymalną liczbę adresów IP, które każde podrzędne MTD może zarejestrować na tym urządzeniu jako konto nadrzędne.

Przekaż 0, aby wyczyścić ustawienie i przywrócić domyślne.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

Parametry

childip max count

Przykłady

childip max 2
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

childip maks.

Pobiera maksymalną liczbę adresów IP, które każde podrzędne MTD może zarejestrować na tym urządzeniu jako konto nadrzędne.

Parametry

Brak parametrów.

Przykłady

childip max
4
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

childmax (set)

Określa maksymalną obecnie dozwoloną liczbę elementów podrzędnych.

Ten parametr można ustawić tylko po zatrzymaniu operacji protokołu Thread.

Parametry

childmax count

Przykłady

childmax 2
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

ChildMax

Pobiera maksymalną dozwoloną obecnie liczbę elementów podrzędnych.

Parametry

Brak parametrów.

Przykłady

childmax
5
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Pobiera lub ustawia wartość MLE_CHILD_ROUTER_LINKS.

Parametry

childrouterlinks [links]

Przykłady

childrouterlinks
16
Done
childrouterlinks 16
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

czas kontroli nadzoru nad dzieckiem (ustawiony)

Określa czas oczekiwania na kontrolę nadzoru (w sekundach) na urządzeniu podrzędnym.

Parametry

childsupervision checktimeout timeout-seconds

Przykłady

childsupervision checktimeout 30
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

czas zakończenia nadzoru rodzicielskiego

Zbiera informacje o interwałach (w sekundach) limitu czasu oczekiwania na sprawdzenie nadzoru na urządzeniu dziecka.

Jeśli urządzenie jest śpiące i nie otrzymuje informacji od urządzenia nadrzędnego w określonym czasie oczekiwania na sprawdzenie, inicjuje proces ponownego podłączania (wymiana prośby o aktualizację podmiotu podrzędnego z systemem MLE/wymiany między podmiotem nadrzędnym).

Parametry

Brak parametrów.

Przykłady

childsupervision checktimeout
30
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

interwał nadzoru rodzicielskiego (ustawiony)

Określa czas (w sekundach) nadzoru rodzicielskiego na koncie dziecka.

Parametry

childsupervision interval interval-seconds

Przykłady

childsupervision interval 30
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

interwał nadzoru rodzicielskiego

Pobiera przedział czasu nadzoru rodzicielskiego (w sekundach) dotyczący dziecka.

Funkcja nadzoru rodzicielskiego umożliwia rodzicom wysyłanie wiadomości do każdego śpiącego dziecka w czasie trwania nadzoru rodzicielskiego. Jeśli w okresie nadzoru nie nastąpi przekazanie wiadomości do dziecka, OpenThread umieszcza w kolejce wiadomość i wysyła do dziecka wiadomość o nadzorze podrzędnym.

Parametry

Brak parametrów.

Przykłady

childsupervision interval
30
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

childtimeout (set)

Określa czas oczekiwania elementu podrzędnego wątku (w sekundach) używany podczas wykonywania działań w roli podrzędnej.

Parametry

childtimeout timeout-seconds

Przykłady

childtimeout 300
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

przekroczono limit czasu dziecka

Pobiera czas oczekiwania elementu podrzędnego wątku (w sekundach) używany podczas wykonywania operacji w roli podrzędnej.

Parametry

Brak parametrów.

Przykłady

childtimeout
300
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Anulowanie Coap

Anuluje istniejącą subskrypcję obserwacji dla zasobu zdalnego na serwerze CoAP.

Parametry

Brak parametrów.

Przykłady

coap cancel
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

coap delete

Usuwa określony zasób CoAP.

Parametry

coap delete address uri-path [type] [payload]
  • address: adres IPv6 serwera CoAP.
  • uri-path: ścieżka identyfikatora URI zasobu.
  • type:
    • con: potwierdzony
    • non-con: nie można potwierdzić (domyślnie)
  • payload: ciąg znaków ładunku CoAP. Na przykład: hellothere.

Przykłady

coap delete fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

Coap pobierz

Pobiera informacje o określonym zasobie CoAP na serwerze CoAP.

Parametry

coap get address uri-path [type]
  • address: adres IPv6 serwera CoAP.
  • uri-path: ścieżka identyfikatora URI zasobu.
  • type:
    • con: potwierdzony
    • non-con: nie można potwierdzić (domyślnie)
    • block-: użyj tej opcji, a po niej wpisz wartość blokową, jeśli odpowiedź ma być przekazywana blokowo. Prawidłowe wartości to block-16, block-32, block-64, block-128, block-256, block-512 oraz block-1024.

Przykłady

coap get fdde:ad00:beef:0:2780:9423:166c:1aac test-resource
Done
coap get fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

coap obserwacja

Wywołuje żądanie subskrypcji, które pozwala klientowi CoAP obserwować określony zasób na serwerze CoAP pod kątem możliwych zmian jego stanu.

Parametry

coap observe address uri-path [type]
  • address: adres IPv6 serwera CoAP.
  • uri-path: ścieżka identyfikatora URI zasobu.
  • type:
    • con: potwierdzony
    • non-con: nie można potwierdzić (domyślnie).

Przykłady

coap observe fdde:ad00:beef:0:2780:9423:166c:1aac test-resource
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

parametry coap(get,set)

Pobiera bieżące wartości parametrów CoAP, jeśli polecenie jest uruchamiane bez parametrów opcjonalnych.

Ustawia wartości domyślne dla parametrów CoAP lub określone przez Ciebie wartości w zależności od wybranej składni.

Parametry

coap parameters type [default | ack_timeout ack_random_factor_numerator ack_random_factor_denominator max_retransmit]
  • type: request w przypadku żądań CoAP, a response w przypadku odpowiedzi CoAP. Jeśli nie podasz więcej parametrów, polecenie wyświetli bieżącą konfigurację.
  • default: ustawia następujące domyślne wartości parametrów transmisji:
    • ack_timeout: 2000 milisekund
    • ack_random_factor_numerator: 3
    • ack_random_factor_denominator: 2
    • max_retransmit: 4
  • ack_timeout: ACK_TIMEOUT (0-UINT32_MAX) w milisekundach. Zapoznaj się z dokumentem RFC7252.
  • ack_random_factor_numerator: licznik ACK_RANDOM_FACTOR z możliwymi wartościami od 0 do 255. Zapoznaj się z dokumentem RFC7252.
  • ack_random_factor_denominator: mianownik ACK_RANDOM_FACTOR. Możliwe wartości to 0–255. Zapoznaj się z dokumentem RFC7252.
  • max_retransmit: MAX_RETRANSMIT (0–255). Zapoznaj się z dokumentem RFC7252.

Przykłady

coap parameters request
Transmission parameters for request:
ACK_TIMEOUT=1000 ms, ACK_RANDOM_FACTOR=255/254, MAX_RETRANSMIT=2
Done
coap parameters request default
Transmission parameters for request:
default
Done
coap parameters request 1000 255 254 2
Transmission parameters for request:
ACK_TIMEOUT=1000 ms, ACK_RANDOM_FACTOR=255/254, MAX_RETRANSMIT=2
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

post coap

Tworzy określony zasób CoAP. Więcej informacji znajdziesz w artykule na temat testowania połączeń z zasobem (CoAP) za pomocą interfejsu OT CLI (w języku angielskim).

Parametry

coap post address uri-path [type] [payload]
  • address: adres IPv6 serwera CoAP.
  • uri-path: ścieżka identyfikatora URI zasobu.
  • type:
    • con: potwierdzony
    • non-con: nie można potwierdzić (domyślnie)
    • block-: użyj tej opcji, a po niej wartości blokowej, aby wysłać bloki z losowo wygenerowaną liczbą bajtów dla ładunku. Prawidłowe wartości to block-16, block-32, block-64, block-128, block-256, block-512 oraz block-1024.
  • payload: żądanie ładunku CoAP, które w razie potrzeby jest ciągiem tekstowym lub liczbą całkowitą, w zależności od parametru type. Jeśli type to con lub non-con, parametr payload jest opcjonalny. Jeśli pominiesz parametr payload, zostanie wysłany pusty ładunek. Jeśli jednak używasz parametru payload, jego wartość musi być ciągiem znaków, np. hellothere. Jeśli type to block-, wartość parametru payload musi być liczbą całkowitą określającą liczbę bloków do wysłania. Typ block- wymaga ustawienia OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE.

Przykłady

coap post fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done
coap post fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024 10
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

Coap Masz

Modyfikuje podany zasób CoAP. Więcej informacji znajdziesz w artykule na temat testowania połączeń z zasobem (CoAP) za pomocą interfejsu OT CLI (w języku angielskim).

Parametry

coap put address uri-path [type] [payload]
  • address: adres IPv6 serwera CoAP.
  • uri-path: ścieżka identyfikatora URI zasobu.
  • type:
    • con: potwierdzony
    • non-con: nie można potwierdzić (domyślnie)
    • block-: użyj tej opcji, a po niej wartości blokowej, aby wysłać bloki z losowo wygenerowaną liczbą bajtów dla ładunku. Prawidłowe wartości to block-16, block-32, block-64, block-128, block-256, block-512 oraz block-1024.
  • payload: żądanie ładunku CoAP, które w razie potrzeby jest ciągiem tekstowym lub liczbą całkowitą, w zależności od parametru type. Jeśli type to con lub non-con, parametr payload jest opcjonalny. Jeśli pominiesz parametr payload, zostanie wysłany pusty ładunek. Jeśli jednak używasz parametru payload, jego wartość musi być ciągiem znaków, np. hellothere. Jeśli type to block-, wartość parametru payload musi być liczbą całkowitą określającą liczbę bloków do wysłania. Typ block- wymaga ustawienia OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE.

Przykłady

coap put fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done
coap put fdde:ad00:beef:0:2780:9423:166c:1aac test-resource block-1024 10
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

zasób coap (get,set)

Pobiera lub ustawia ścieżkę URI zasobu serwera CoAP.

Parametry

coap resource [uri-path]

Przykłady

coap resource test-resource
Done
coap resource
test-resource
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zestaw Coap

Ustawia treść wysyłaną przez zasób na serwerze CoAP. Jeśli klient CoAP obserwuje zasób, wysyłane jest do niego powiadomienie.

Parametry

coap set new-content

Przykłady

coap set Testing123
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

uruchamianie coap

Uruchamia serwer CoAP. Więcej informacji znajdziesz w artykule na temat testowania połączeń z zasobem (CoAP) za pomocą interfejsu OT CLI (w języku angielskim).

Parametry

Brak parametrów.

Przykłady

coap start
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zatrzymaj

Zatrzymuje serwer CoAP.

Parametry

Brak parametrów.

Przykłady

coap stop
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Coaps Connect

Inicjuje sesję DTLS z połączeniem równorzędnym Datagram Transport Layer Security. Więcej informacji znajdziesz w artykule na temat testowania połączeń z zasobem CoAPS (Consheld Application Protocol Secure) za pomocą OT CLI (w języku angielskim).

Parametry

coaps connect address

Parametr address to adres IPv6 połączenia równorzędnego.

Przykłady

coaps connect fdde:ad00:beef:0:9903:14b:27e0:5744
Done
coaps connected

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Usuń coaps

Ciąg znaków ładunku CoAPS do usunięcia.

Parametry

coaps delete uri-path [type] [payload]
  • uri-path: ścieżka identyfikatora URI zasobu.
  • type:
    • con: potwierdzony
    • non-con: nie można potwierdzić (domyślnie)
  • payload: żądanie ładunku CoAPS.

Przykłady

coaps delete test-resource con hellothere
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

Odłącz od Coaps

Zatrzymuje sesję DTLS.

Parametry

Brak parametrów.

Przykłady

coaps disconnect
coaps disconnected
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

coaps

Pobiera informacje o określonym zasobie CoAPS z serwera CoAPS. Więcej informacji znajdziesz w artykule na temat testowania połączeń z zasobem CoAPS (Consheld Application Protocol Secure) za pomocą OT CLI (w języku angielskim).

Parametry

coaps get uri-path [type]
  • uri-path: ścieżka identyfikatora URI zasobu.
  • type:
    • con: potwierdzony
    • non-con: nie można potwierdzić (domyślnie)
    • block-: użyj tej opcji, a po niej wpisz wartość blokową, jeśli odpowiedź ma być przekazywana blokowo. Prawidłowe wartości to block-16, block-32, block-64, block-128, block-256, block-512 oraz block-1024.

Przykłady

coaps get test-resource
Done
coaps get test-resource block-1024
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

Coaps jest zamknięty

Wskazuje, czy usługa CoAP Secure jest zamknięta. Więcej informacji znajdziesz w artykule na temat testowania połączeń z zasobem CoAPS (Consheld Application Protocol Secure) za pomocą OT CLI (w języku angielskim).

Parametry

Brak parametrów.

Przykłady

coaps isclosed
no
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

coaps isconnactive

Wskazuje, czy połączenie z usługą CoAP Secure jest aktywne (już nawiązane albo w trakcie nawiązywania połączenia). Więcej informacji znajdziesz w artykule na temat testowania połączeń z zasobem CoAPS (Consheld Application Protocol Secure) za pomocą OT CLI (w języku angielskim).

Parametry

Brak parametrów.

Przykłady

coaps isconnactive
yes
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Konto coaps jest połączone

Wskazuje, czy usługa CoAP Secure jest połączona. Więcej informacji znajdziesz w artykule na temat testowania połączeń z zasobem CoAPS (Consheld Application Protocol Secure) za pomocą OT CLI (w języku angielskim).

Parametry

Brak parametrów.

Przykłady

coaps isconnected
yes
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

post coaps

Tworzy określony zasób CoAPS. Więcej informacji znajdziesz w artykule na temat testowania połączeń z zasobem CoAPS (Consheld Application Protocol Secure) za pomocą OT CLI (w języku angielskim).

Parametry

uri-path [type] [payload]
  • uri-path: ścieżka identyfikatora URI zasobu.
  • type:
    • con: potwierdzony
    • non-con: nie można potwierdzić (domyślnie)
    • block-: użyj tej opcji, a po niej wartości blokowej, aby wysłać bloki z losowo wygenerowaną liczbą bajtów dla ładunku. Prawidłowe wartości to block-16, block-32, block-64, block-128, block-256, block-512 oraz block-1024.
  • payload: żądanie ładunku CoAPS, które w przypadku użycia jest ciągiem tekstowym lub liczbą całkowitą, w zależności od parametru type. Jeśli type to con lub non-con, parametr ładunku jest opcjonalny. Jeśli pominiesz parametr ładunku, zostanie wysłany pusty ładunek. Jeśli jednak używasz parametru ładunku, jego wartość musi być ciągiem znaków, np. hellothere. Jeśli type to block-, wartość parametru ładunku musi być liczbą całkowitą określającą liczbę bloków do wysłania. Typ block- wymaga ustawienia OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE.

Przykłady

coaps post test-resource con hellothere
Done
coaps post test-resource block-1024 10
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

coaps psk

Ustawia klucz PSK i zestaw szyfrów DTLS_PSK_WITH_AES_128_CCM_8.

Parametry

coaps psk psk-value psk-id
  • psk-value: klucz PSK
  • psk-id: identyfikator klucza PSK.

Przykłady

coaps psk 1234 key1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Coaps Pup

Modyfikuje podany zasób CoAPS. Więcej informacji znajdziesz w artykule na temat testowania połączeń z zasobem CoAPS (Consheld Application Protocol Secure) za pomocą OT CLI (w języku angielskim).

Parametry

uri-path [type] [payload]
  • uri-path: ścieżka identyfikatora URI zasobu.
  • type:
    • con: potwierdzony
    • non-con: nie można potwierdzić (domyślnie)
    • block-: użyj tej opcji, a po niej wartości blokowej, aby wysłać bloki z losowo wygenerowaną liczbą bajtów dla ładunku. Prawidłowe wartości to block-16, block-32, block-64, block-128, block-256, block-512 oraz block-1024.
  • payload: żądanie ładunku CoAPS, które w przypadku użycia jest ciągiem tekstowym lub liczbą całkowitą, w zależności od parametru type. Jeśli type to con lub non-con, parametr ładunku jest opcjonalny. Jeśli pominiesz parametr ładunku, zostanie wysłany pusty ładunek. Jeśli jednak używasz parametru ładunku, jego wartość musi być ciągiem znaków, np. hellothere. Jeśli type to block-, wartość parametru ładunku musi być liczbą całkowitą określającą liczbę bloków do wysłania. Typ block- wymaga ustawienia OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE.

Przykłady

coaps put test-resource con hellothere
Done
coaps put test-resource block-1024 10
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

zasób coaps (get,set)

Pobiera lub ustawia ścieżkę URI zasobu serwera CoAPS. Więcej informacji znajdziesz w artykule na temat testowania połączeń z zasobem CoAPS (Consheld Application Protocol Secure) za pomocą OT CLI (w języku angielskim).

Parametry

coaps resource [uri-path]

Przykłady

coaps resource test-resource
Done
coaps resource
test-resource
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

coaps set

Ustawia treść wysyłaną przez zasób na serwerze CoAPS. Więcej informacji znajdziesz w artykule na temat testowania połączeń z zasobem CoAPS (Consheld Application Protocol Secure) za pomocą OT CLI (w języku angielskim).

Parametry

coaps set new-content

Przykłady

coaps set Testing123
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

coaps początek

Uruchamia usługę CoAP Secure. Więcej informacji znajdziesz w artykule na temat testowania połączeń z zasobem CoAPS (Consheld Application Protocol Secure) za pomocą OT CLI (w języku angielskim).

Parametry

coaps start [check-peer-cert | max-conn-attempts]

Parametr check-peer-cert określa, czy sprawdzanie certyfikatu równorzędnego jest włączone (domyślnie), czy wyłączone. Parametr max-conn-attempts określa maksymalną dozwoloną liczbę prób nawiązania połączenia z serwerem CoAP Secure (udanych lub nieudanych). Wartość domyślna tego parametru to 0, co oznacza, że nie ma limitu liczby prób. Parametry check-peer-cert i max-conn-attempts działają w tych kombinacjach, mimo że możesz podać tylko jeden argument:

  • Nie określono argumentu: używane są wartości domyślne.
  • Ustawienie dla check-peer-cert wartości true ma taki sam skutek jak pominięcie argumentu, czyli że wartość check-peer-cert to true, a wartość max-conn-attempts to 0.
  • Ustawienie dla check-peer-cert wartości false: check-peer-cert ma wartość false, a wartość max-conn-attempts – 0.
  • Określona liczba: check-peer-cert to true, a wartość max-conn-attempts to liczba określona w argumencie.

Przykłady

coaps start
Done
coaps start false
Done
coaps start 8
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Coaps, stop

Zatrzymuje usługę CoAP Secure. Więcej informacji znajdziesz w artykule na temat testowania połączeń z zasobem CoAPS (Consheld Application Protocol Secure) za pomocą OT CLI (w języku angielskim).

Parametry

Brak parametrów.

Przykłady

coaps stop
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Coaps x509

Ustawia certyfikat X509 urządzenia lokalnego z odpowiednim kluczem prywatnym na potrzeby sesji DTLS z DTLS_ECDHE_ECDSA_WITH_AES_128_CCM_8.

Parametry

Brak parametrów.

Przykłady

coaps x509
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

ogłosić komisarz

Wysyła wiadomość rozpoczynającą się.

Parametry

commissioner announce mask count period destination
  • mask: maska bitowa identyfikująca kanały do wysyłania wiadomości MLE Announce.
  • count: liczba transmisji MLE Announce na kanał.
  • period: liczba milisekund między kolejnymi wywołaniami MLE Announce.
  • destination: docelowy adres IPv6 wiadomości. Wiadomość może być multiemisją.

Przykłady

commissioner announce 0x00050000 2 32 fdde:ad00:beef:0:0:ff:fe00:c00
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

komisarz ds. energii

Wysyła komunikat zapytania skanowania energii. Wynik polecenia jest drukowany w miarę ich odbierania.

Parametry

commissioner energy mask count period scanDuration destination
  • mask: maska bitowa identyfikująca kanały do przeprowadzania skanowania energii w standardzie IEEE 802.15.4.
  • count: liczba skanowań energii IEEE 802.15.4 na kanał.
  • period: liczba milisekund między kolejnymi skanowaniami energii IEEE 802.15.4.
  • scanDuration: czas trwania skanowania (w milisekundach) używany podczas skanowania energii IEEE 802.15.4.
  • destination: docelowy adres IPv6 wiadomości. Wiadomość może być multiemisją.

Przykłady

commissioner energy 0x00050000 2 32 1000 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Energy: 00050000 0 0 0 0

Dokumentacja interfejsu wiersza poleceń i interfejsu API

identyfikator komisarza (get,set)

Pobiera lub ustawia nazwę identyfikatora komisarza OpenThread.

Parametry

commissioner id name

Przykłady

commissioner id OpenThread Commissioner
Done
commissioner id
OpenThread Commissioner
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

dodanie komisarza dołączonego

Dodaje wpis łączenia.

Parametry

commissioner joiner add eui64|discerner pksd [timeout]
  • eui64: IEEE EUI-64 z łącznika. Aby dopasować dowolne złączniki, użyj polecenia *.
  • discerner: narzędzie do łączenia w formacie number/length.
  • pksd: wstępnie udostępniony klucz łączenia.
  • timeout: czas oczekiwania na dołączenie (w sekundach).

Przykłady

commissioner joiner add d45e64fa83f81cf7 J01NME
Done
commissioner joiner add 0xabc/12 J01NME
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

usunięcie z komisarza

Usuwa wpis Joiner.

Parametry

commissioner joiner remove eui64|discerner
  • eui64: IEEE EUI-64 złącza. Aby dopasować dowolne złączniki, użyj polecenia *.
  • discerner: narzędzie do rozpoznawania łączenia w formacie number/length.

Przykłady

commissioner joiner remove d45e64fa83f81cf7
Done
commissioner joiner remove 0xabc/12
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

tabela złącza komisji

Wyświetla listę wszystkich wpisów Joiner w formacie tabeli.

Parametry

Brak parametrów.

Przykłady

commissioner joiner table
| ID                    | PSKd                             | Expiration |
+-----------------------+----------------------------------+------------+
|                     * |                           J01NME |      81015 |
|      d45e64fa83f81cf7 |                           J01NME |     101204 |
| 0x0000000000000abc/12 |                           J01NME |     114360 |
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

komisarz mgmtget

Wysyła wiadomość MGMT_GET (Management Get) do lidera. Wyświetlane są wartości zmiennych ustawione za pomocą polecenia commissioner mgmtset.

Parametry

commissioner mgmtget [locator] [sessionid] [steeringdata] [joinerudpport] [-x TLVs]
  • locator: router graniczny RLOC16.
  • sessionid: identyfikator sesji komisarza.
  • steeringdata: dane sterowania.
  • joinerudpport: port UDP łączenia.
  • TLVs: zbiór TLV do pobrania.

Przykłady

commissioner mgmtget locator sessionid
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

komisarz mgmtset

Wysyła komunikat MGMT_SET (zestaw zarządzania) do repliki wiodącej i ustawia w zmiennych określone wartości.

Parametry

commissioner mgmtset [locator locator] [sessionid sessionid] [steeringdata steeringdata] [joinerudpport joinerudpport] [-x TLVs]
  • locator: router graniczny RLOC16.
  • sessionid: identyfikator sesji komisarza.
  • steeringdata: dane sterowania.
  • joinerudpport: port UDP łączenia.
  • TLVs: zbiór TLV do pobrania.

Przykłady

commissioner mgmtset joinerudpport 9988
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

komisarz panid

Wysyła zapytanie o identyfikator PAN. Wynik polecenia jest zwracany w miarę ich odbierania.

Parametry

commissioner panid panid mask destination
  • paind: identyfikator PAN używany do sprawdzania konfliktów.
  • mask; maska bitowa identyfikująca kanały, które mają przeprowadzać aktywne skanowania IEEE 802.15.4.
  • destination: adres docelowy IPv6 wiadomości. Wiadomość może być multiemisją.

Przykłady

commissioner panid 0xdead 0x7fff800 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Conflict: dead, 00000800

Dokumentacja interfejsu wiersza poleceń i interfejsu API

adres URL obsługi administracyjnej komisarza

Ustawia adres URL obsługi administracyjnej komisarza.

Parametry

commissioner provisioningurl provisioningurl

Przykłady

commissioner provisioningurl http://github.com/openthread/openthread
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

identyfikator sesji komisarza

Pobiera bieżący identyfikator sesji komisarza.

Parametry

Brak parametrów.

Przykłady

commissioner sessionid
0
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

rozpoczęcie pracy komisarza

Rozpoczyna rolę komisarza ds. wątków.

Parametry

Brak parametrów.

Przykłady

commissioner start
Commissioner: petitioning
Done
Commissioner: active

Dokumentacja interfejsu wiersza poleceń i interfejsu API

stan komisarza

Zwraca bieżący stan komisarza. Możliwe wartości to active, disabled lub petition (petycja w sprawie roli komisarza).

Parametry

Brak parametrów.

Przykłady

commissioner state
active
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

przystanek komisarza

Zatrzymuje rolę komisarza ds. wątków.

Parametry

Brak parametrów.

Przykłady

commissioner stop
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

kontekstoworeusedelay (get,set)

Pobiera lub ustawia wartość CONTEXT_ID_REUSE_DELAY.

Parametry

contextreusedelay delay

Użyj opcjonalnego argumentu delay, aby ustawić CONTEXT_ID_REUSE_DELAY.

Przykłady

contextreusedelay
11
Done
contextreusedelay 11
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

liczniki zdarzeń (Mac)

Pobieranie liczników warstw MAC.

Parametry

counters mac

Przykłady

counters mac
TxTotal: 10
   TxUnicast: 3
   TxBroadcast: 7
   TxAckRequested: 3
   TxAcked: 3
   TxNoAckRequested: 7
   TxData: 10
   TxDataPoll: 0
   TxBeacon: 0
   TxBeaconRequest: 0
   TxOther: 0
   TxRetry: 0
   TxErrCca: 0
   TxErrBusyChannel: 0
RxTotal: 2
   RxUnicast: 1
   RxBroadcast: 1
   RxData: 2
   RxDataPoll: 0
   RxBeacon: 0
   RxBeaconRequest: 0
   RxOther: 0
   RxAddressFiltered: 0
   RxDestAddrFiltered: 0
   RxDuplicated: 0
   RxErrNoFrame: 0
   RxErrNoUnknownNeighbor: 0
   RxErrInvalidSrcAddr: 0
   RxErrSec: 0
   RxErrFcs: 0
   RxErrOther: 0
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

liczniki (mle)

Pobiera liczniki MLE Thread.

Parametry

counters mle

Przykłady

counters mle
Role Disabled: 0
Role Detached: 1
Role Child: 0
Role Router: 0
Role Leader: 1
Attach Attempts: 1
Partition Id Changes: 1
Better Partition Attach Attempts: 0
Parent Changes: 0
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

liczniki zdarzeń

Pobiera obsługiwane nazwy liczników.

Parametry

Brak parametrów.

Przykłady

counters
ip
mac
mle
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

adres IP licznika

Pobiera liczniki IPv6.

Parametry

counters ip

Przykłady

counters ip
TxSuccess: 10
TxFailed: 0
RxSuccess: 5
RxFailed: 0
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

resetowanie IP liczników

Resetuje liczniki IPv6.

Parametry

counters ip reset

Przykłady

counters ip reset
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

resetowanie liczników do Maca

Resetuje liczniki warstw MAC.

Parametry

counters mac reset

Przykłady

counters mac reset
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

resetowanie liczników zdarzeń

Resetuje liczniki MLE Thread Thread.

Parametry

counters mle reset

Przykłady

counters mle reset
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

kanał csl

Ustawia kanał CSL.

Parametry

csl channel channel

Przykłady

csl channel 20
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

csl

Pobiera konfigurację CSL.

Parametry

Brak parametrów.

Przykłady

csl
Channel: 11
Period: 160000us
Timeout: 1000s
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

okres csl

Ustawia okres CSL w mikrosekundach.

Wyłącz CSL, ustawiając ten parametr na 0.

Okres CSL MUSI być wielokrotnością liczby OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC. W przeciwnym razie zwracana jest wartość OT_ERROR_INVALID_ARGS.

Parametry

csl period period

Przykłady

csl period 3000000
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Czas oczekiwania csl

Określa limit czasu CSL w sekundach.

Parametry

csl timeout timeout

Przykłady

cls timeout 10
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zbiór danych aktywny

Pobiera aktywny zbiór danych operacyjnych.

Interfejs wiersza poleceń OT korzysta z elementów zbioru danych otOperationalDataset, aby zwracać wartości zbioru danych do konsoli.

Parametry

dataset active [-x]

Opcjonalny argument -x wyświetla wartości aktywnego zbioru danych operacyjnych jako zakodowane szesnastkowo TLV.

Przykłady

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
dataset active -x
0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

aktywna sygnatura czasowa zbioru danych (get, set)

Pobiera lub ustawia otOperationalDataset::mActiveTimestamp.

Parametry

dataset activetimestamp [timestamp]

Przekaż opcjonalny argument timestamp, aby ustawić aktywną sygnaturę czasową.

Przykłady

dataset activetimestamp
123456789
Done
dataset activetimestamp 123456789
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

kanał zbioru danych (get,set)

Pobiera lub ustawia otOperationalDataset::mChannel.

Parametry

dataset channel [channel-num]

Aby ustawić kanał, użyj opcjonalnego argumentu channel-num.

Przykłady

dataset channel
12
Done
dataset channel 12
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

maska kanału zbioru danych (get,set)

Pobiera lub ustawia otOperationalDataset::mChannelMask.

Parametry

dataset channelmask [channel-mask]

Aby ustawić maskę kanału, użyj opcjonalnego argumentu channel-mask.

Przykłady

dataset channelmask
0x07fff800
Done
dataset channelmask 0x07fff800
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

wyczyść zbiór danych

Zresetuj bufor zbioru danych operacyjnych.

Parametry

Brak parametrów.

Przykłady

dataset clear
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

zatwierdzenie zbioru danych jest aktywne

Zatwierdź bufor zbioru danych operacyjnych w aktywnym zbiorze danych operacyjnych.

Parametry

Brak parametrów.

Przykłady

dataset commit active
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

oczekuje na zatwierdzenie zbioru danych

Zatwierdź bufor zbioru danych operacyjnych w oczekującym zbiorze danych operacyjnych.

Parametry

Brak parametrów.

Przykłady

dataset commit pending
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

opóźnienie zbioru danych (get,set)

Pobiera lub ustawia otOperationalDataset::mOpóźnienie.

Parametry

dataset delay [delay]

Aby ustawić wartość opóźnienia licznika, użyj opcjonalnego argumentu delay.

Przykłady

dataset delay
1000
Done
dataset delay 1000
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zbiór danych extpanid (get,set)

Pobiera lub ustawia otOperationalDataset::mExtendedPanId.

Parametry

dataset extpanid [extpanid]

Użyj opcjonalnego argumentu extpanid, aby ustawić identyfikator rozszerzonej sieci osobistej.

Przykłady

dataset extpanid
000db80123456789
Done
dataset extpanid 000db80123456789
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

pomoc dotycząca zbioru danych

Pobiera listę poleceń interfejsu wiersza poleceń dataset. Więcej informacji znajdziesz w artykule na temat wyświetlania zbiorów danych i zarządzania nimi za pomocą interfejsu wiersza poleceń OT.

Parametry

Brak parametrów.

Przykłady

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

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

init w zbiorze danych (active,new,pending,tlvs)

Interfejs wiersza poleceń OT sprawdza poprawność active, pending i tlvs i zwraca odpowiadające im wartości. W przeciwnym razie interfejs wiersza poleceń OT tworzy nową, losową sieć i zwraca nowy zbiór danych.

Parametry

dataset init {active|new|pending|tlvs} [hex-encoded-tlvs]

Zainicjuj nowy zbiór danych w narzędziu new, a następnie wpisz polecenie dataset commit active. W przypadku TLV zakodowanego w postaci szesnastkowej użyj parametru tlvs.

Przykłady

dataset init new
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

siatka danych typu meshlocalprefix (get,set)

Pobiera lub ustawia otOperationalDataset::mMeshLocalPrefix.

Parametry

dataset meshlocalprefix [meshlocalprefix]

Użyj opcjonalnego argumentu meshlocalprefix, aby ustawić prefiks sieci typu mesh-Local.

Przykłady

dataset meshlocalprefix
fd00:db8:0:0::/64
Done
dataset meshlocalprefix fd00:db8:0:0::
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

Aktywne mgmtgetcommand zbioru danych

Wysyła MGMT_ACTIVE_GET.

Interfejs wiersza poleceń OT wysyła MGMT_ACTIVE_GET z odpowiednimi argumentami. Więcej informacji o tych parametrach i mapowaniu argumentów znajdziesz w artykule na temat wyświetlania zbiorów danych i zarządzania nimi za pomocą interfejsu wiersza poleceń OT.

Parametry

dataset mgmtgetcommand active [address leader-address] [dataset-components] [-x tlv-list]
  • Użyj address, aby określić miejsce docelowe IPv6. W przeciwnym razie domyślnie zostanie użyta ALOC strony wiodącej.
  • W przypadku dataset-components można przekazać dowolną kombinację elementów otOperationalDatasetComponents, na przykład activetimestamp, pendingtimestamp lub networkkey.
  • Opcjonalny argument -x określa nieprzetworzone TLV, które mają zostać żądane.

Przykłady

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

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Oczekiwanie na polecenie mgmtgetcommand zbioru danych

Wysyła MGMT_PENDING_GET.

Parametry

dataset mgmtgetcommand pending [address leader-address] [dataset-components] [-x tlv-list]

Więcej informacji o tych parametrach i mapowaniu argumentów znajdziesz w artykule na temat wyświetlania zbiorów danych i zarządzania nimi za pomocą interfejsu wiersza poleceń OT.

Przykłady

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

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Aktywne polecenie mgmtsetcommand zbioru danych

Wysyła MGMT_ACTIVE_SET.

Parametry

dataset mgmtsetcommand active [dataset-components] [-x tlv-list]

Więcej informacji o tych parametrach i mapowaniu argumentów znajdziesz w artykule na temat wyświetlania zbiorów danych i zarządzania nimi za pomocą interfejsu wiersza poleceń OT.

Przykłady

dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrcb
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Oczekiwanie na polecenie mgmtsetcommand zbioru danych

Wysyła MGMT_PENDING_SET.

Parametry

dataset mgmtsetcommand pending [dataset-components] [-x tlv-list]

Więcej informacji o tych parametrach i mapowaniu argumentów znajdziesz w artykule na temat wyświetlania zbiorów danych i zarządzania nimi za pomocą interfejsu wiersza poleceń OT.

Przykłady

dataset mgmtsetcommand pending activetimestamp 123 securitypolicy 1 onrcb
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

klucz sieciowy zbioru danych (get,set)

Pobiera lub ustawia otOperationalDataset::mNetworkKey.

Parametry

dataset networkkey [key]

Aby ustawić klucz sieci, użyj opcjonalnego argumentu key.

Przykłady

dataset networkkey
00112233445566778899aabbccddeeff
Done
dataset networkkey 00112233445566778899aabbccddeeff
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

nazwa sieci zbioru danych (get,set)

Pobiera lub ustawia otOperationalDataset::mNetworkName.

Parametry

dataset networkname [name]

Aby ustawić nazwę sieci, użyj opcjonalnego argumentu name.

Przykłady

dataset networkname
OpenThread
Done
dataset networkname OpenThread
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

panid zbioru danych (get,set)

Pobiera lub ustawia otOperationalDataset::mPanId.

Parametry

dataset panid [panid]

Podaj identyfikator PAN, używając opcjonalnego argumentu panid.

Przykłady

dataset panid
0x1234
Done
dataset panid 0x1234
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

zbiór danych pendingtimestamp (get,set)

Pobiera lub ustawia otOperationalDataset::mPendingTimestamp.

Parametry

dataset pendingtimestamp [timestamp]

Aby ustawić oczekujące sekundy na sygnaturę czasową, użyj opcjonalnego argumentu timestamp.

Przykłady

dataset pendingtimestamp
123456789
Done
dataset pendingtimestamp 123456789
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

zbiór danych pskc (get,set)

Pobiera lub ustawia otOperationalDataset::mPskc.

Parametry

dataset pskc [-p passphrase] | [key]

Tylko w przypadku FTD użyj -p z argumentem passphrase. -p generuje plik pskc z podanego przez Ciebie pliku passphrase zakodowanego w UTF-8 wraz z nazwą sieci i rozszerzonym identyfikatorem PAN. Jeśli jest ustawiony, -p używa bufora zbioru danych. W przeciwnym razie używa bieżącego stosu. Możesz też ustawić plik pskc jako key (format szesnastkowy).

Przykłady

dataset pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done
dataset pskc -p 123456
Done
dataset pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

zasada zabezpieczeń zbioru danych (get,set)

Pobiera lub ustawia zasadę zabezpieczeń zbioru danych.

Parametry

dataset securitypolicy [rotationtime [onrcCepR]]

Przykłady

dataset securitypolicy
672 onrc
Done
dataset securitypolicy 672 onrc
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

zbiór danych (aktywny,oczekujący)

Ustawia aktywny zbiór danych operacyjnych.

Jeśli zbiór danych nie zawiera aktywnej sygnatury czasowej, jest on tylko częściowo kompletny.

Jeśli usługa Thread jest włączona na urządzeniu z częściowo pełnym aktywnym zestawem danych, urządzenie spróbuje połączyć się z istniejącą siecią Thread, korzystając z wszystkich informacji znajdujących się w zbiorze danych. Do podłączenia do sieci potrzebny jest tylko klucz sieciowy Thread.

Jeśli kanał nie znajduje się w zbiorze danych, urządzenie będzie wysyłać komunikaty MLE Announce między różnymi kanałami, aby znaleźć sąsiadów w innych kanałach.

Jeśli urządzenie połączy się z siecią Thread, pobierze pełny aktywny zbiór danych od organizacji nadrzędnej. Pamiętaj, że urządzenie obsługujące router nie zostanie przełączone na rolę routera lub lidera, dopóki nie będzie mieć pełnego aktywnego zbioru danych.

Polecenie interfejsu wiersza poleceń dataset set ustawia aktywny zbiór danych operacyjnych za pomocą szesnastkowych postaci TLV.

Parametry

dataset set {active|pending} tlvs

Przykłady

dataset set active 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done
dataset set pending 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zbiory danych tlv

Konwertuje dany zbiór danych operacyjnych na format otOperationalDatasetTlvs .

Parametry

Brak parametrów.

Przykłady

dataset tlvs
0e080000000000010000000300001635060004001fffe0020...f7f8
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

anulowanie aktualizatora zbioru danych

Anuluje trwającą (jeśli jest taka) prośbę o aktualizację zbioru danych operacyjnych.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE.

Parametry

Brak parametrów.

Przykłady

@dataset updater cancel
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

aktualizator zbioru danych

Wskazuje, czy istnieje żądanie aktualizacji zbioru danych operacji.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE.

Parametry

Brak parametrów.

Przykłady

dataset updater
Enabled
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

uruchomienie aktualizatora zbioru danych

Prosi o aktualizację zbioru danych operacyjnych.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE.

Pole aDataset powinno zawierać pola do zaktualizowania i ich nową wartość. Nie może zawierać pól Aktywna ani Oczekująca sygnatura czasowa. Pole Opóźnienie jest opcjonalne. Jeśli nie zostanie podane, zostanie użyta wartość domyślna (1000 ms).

Parametry

Brak parametrów.

Przykłady

channel
19
Done
dataset clear
Done
dataset channel 15
Done
dataset
Channel: 15
Done
dataset updater start
Done
dataset updater
Enabled
Done
Dataset update complete: OK
channel
15
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

komunikat debugowania

Wykonuje serię poleceń interfejsu wiersza poleceń, aby zebrać informacje o urządzeniu i sieci wątków. Służy do debugowania. W danych wyjściowych pojawią się każde uruchomione polecenie interfejsu wiersza poleceń poprzedzone znakiem $, po którym pojawią się wygenerowane dane wyjściowe odpowiedniego polecenia. Wygenerowane dane wyjściowe obejmują te informacje:

  • Wersja
  • Bieżący stan
  • RLOC16, rozszerzony adres MAC
  • Lista adresów IPv6 Unicast i multiemisji
  • Kanał
  • identyfikator PAN i rozszerzony identyfikator PAN,
  • Dane sieci
  • Identyfikator partycji
  • Dane repliki wiodącej

Jeśli urządzenie działa jako FTD:

  • Tabela elementów podrzędnych i sąsiadów
  • Tabela routera i informacje o następnym przeskoku
  • Tabela adresów z pamięci podręcznej
  • Zarejestrowany podrzędny adres IPv6 MTD
  • Właściwości urządzenia

Jeśli urządzenie obsługuje klienta SRP i działa jako klient:

  • Stan klienta SRP
  • Usługi klienta SRP i informacje o hoście

Jeśli urządzenie obsługuje serwer SRP i działa jako serwer SRP:

  • Tryb stanu i adresu serwera SRP
  • Hosty i usługi zarejestrowane na serwerze SRP

Jeśli urządzenie obsługuje TREL:

  • Stan TREL i tabela porównawcza

Jeśli urządzenie obsługuje router graniczny i działa jako router graniczny:

  • Stan BR
  • Prefiksy BR (OMR, on-link, NAT64)
  • Tabela wykrytych prefiksów

Parametry

Brak parametrów.

Przykłady

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

Opóźnienietimermin (set)

Ustawia minimalne opóźnienie (w sekundach).

Parametry

delaytimermin delaytimermin

Przykłady

delaytimermin 60
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

czasopóźnienie

Ustaw minimalne opóźnienie (w sekundach).

Parametry

Brak parametrów.

Przykłady

delaytimermin
30
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

detach async

Rozpocznij proces odłączenia bez utraty danych podobny do polecenia detach bez blokowania i poczekaj na wywołanie zwrotne wskazujące, że odłączenie zostało zakończone.

Parametry

Brak parametrów.

Przykłady

detach async
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

odłączyć

Rozpocznij proces odłączania bez utraty danych, najpierw wysyłając powiadomienie do innych węzłów (wysyłając zwolnienie adresu, jeśli działasz jako router, lub ustawiając wartość limitu czasu podrzędnego na zero w przypadku elementu nadrzędnego, jeśli działa on jako element podrzędny), a następnie zatrzymuj działanie protokołu Thread.

Parametry

Brak parametrów.

Przykłady

detach
Finished detaching
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

deviceprops (zestaw)

Ustawia właściwości urządzenia.

Parametry

deviceprops powerSupply isBr supportsCcm isUnstable weightAdjustment

powerSupply: powinno mieć wartość „na baterie”, „zewnętrzne”, „zewnętrzna-stabilna”, „zewnętrzna-niestabilna”.

Przykłady

deviceprops battery 0 0 0 -5
Done
deviceprops
PowerSupply      : battery
IsBorderRouter   : no
SupportsCcm      : no
IsUnstable       : no
WeightAdjustment : -5
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

polecenia urządzeń

Pobierz bieżące właściwości urządzenia.

Wymaga OPENTHREAD_CONFIG_MLE_DEVICE_PROPERTY_LEADER_WEIGHT_ENABLE.

Parametry

Brak parametrów.

Przykłady

deviceprops
PowerSupply      : external
IsBorderRouter   : yes
SupportsCcm      : no
IsUnstable       : no
WeightAdjustment : 0
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

polecane

Przeprowadź operację wykrywania MLE.

Parametry

discover [channel]

channel: kanał, na którym chcesz odkrywać nowe treści. Jeśli nie podasz żadnego kanału, odkrywanie obejmie wszystkie prawidłowe kanały.

Przykłady

discover
| J | Network Name     | Extended PAN     | PAN  | MAC Address      | Ch | dBm | LQI |
+---+------------------+------------------+------+------------------+----+-----+-----+
| 0 | OpenThread       | dead00beef00cafe | ffff | f1d92a82c8d8fe43 | 11 | -20 |   0 |
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

wykrywanie wywołania zwrotnego (włącz,wyłącz)

Ustawia wywołanie zwrotne do odbierania danych dotyczących żądania wykrywania MLE.

Parametry

discover reqcallback enable|disable

Przykłady

discover reqcallback enable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Przeglądanie DNS

Wyślij zapytanie DNS do przeglądania (wyliczenie instancji usługi), aby uzyskać listę usług dla danej nazwy usługi

Parametry po service-name są opcjonalne. Każda nieokreślona wartość (lub zero) tych parametrów opcjonalnych zostanie zastąpiona wartością z bieżącej konfiguracji domyślnej (dns config).

Parametry

dns browse service-name [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]

Przykłady

dns browse _service._udp.example.com
DNS browse response for _service._udp.example.com.
inst1
    Port:1234, Priority:1, Weight:2, TTL:7200
    Host:host.example.com.
    HostAddress:fd00:0:0:0:0:0:0:abcd TTL:7200
    TXT:[a=6531, b=6c12] TTL:7300
instance2
    Port:1234, Priority:1, Weight:2, TTL:7200
    Host:host.example.com.
    HostAddress:fd00:0:0:0:0:0:0:abcd TTL:7200
    TXT:[a=1234] TTL:7300
Done
dns browse _airplay._tcp.default.service.arpa
DNS browse response for _airplay._tcp.default.service.arpa.
Mac mini
    Port:7000, Priority:0, Weight:0, TTL:10
    Host:Mac-mini.default.service.arpa.
    HostAddress:fd97:739d:386a:1:1c2e:d83c:fcbe:9cf4 TTL:10
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

kompresja dns (włącz,wyłącz)

Ustaw tryb „kompresja nazwy DNS”.

Domyślnie kompresja nazw DNS jest włączona. Gdy ta opcja jest wyłączona, nazwy DNS są dołączane jako pełne i nigdy nie są skompresowane. Dotyczy to modułów klienta/serwera DNS i SRP w OpenThread”. Pole OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE jest wymagane.

Parametry

dns compression [enable|disable]

Przykłady

dns compression enable
Enabled
dns compression disable
Done
dns compression
Disabled
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

kompresja DNS

Wskazuje, czy tryb „kompresja nazw DNS” jest włączony.

Ta funkcja jest przeznaczona do testowania i jest dostępna tylko wtedy, gdy włączona jest konfiguracja OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

Domyślnie kompresja nazw DNS jest włączona. Gdy ta opcja jest wyłączona, nazwy DNS są dołączane jako pełne i nigdy nie są skompresowane. Dotyczy to modułów klienta/serwera DNS i SRP w OpenThread”. Pole OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE jest wymagane.

Parametry

dns compression [enable|disable]

Przykłady

dns compression
Enabled

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Konfiguracja DNS (ustawienie)

Ustawia domyślną konfigurację zapytania w kliencie DNS.

W polu aConfig bez wartości NULL element wywołujący może pozostawić niektóre pola w instancji otDnsQueryConfig nieokreślonej (wartość 0). Pola nieokreślone są zastępowane odpowiednimi definicjami opcji konfiguracji trybu otwartego (OPENTHREAD_CONFIG_DNS_CLIENTDEFAULT{}), aby utworzyć domyślną konfigurację zapytania.

Gdy funkcja OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_ADDRESS_AUTO_SET_ENABLE jest włączona, klient DNS automatycznie ustawia i aktualizuje adres IPv6 serwera w konfiguracji domyślnej. Dzieje się tak tylko wtedy, gdy użytkownik jej nie ustawi ani nie określi. To zachowanie wymaga włączenia klienta SRP i jego funkcji automatycznego uruchamiania. Klient SRP będzie następnie monitorował dane sieciowe Thread pod kątem wpisów usługi DNS/SRP, aby wybrać serwer SRP. Wybrany adres serwera SRP jest też ustawiony jako adres serwera DNS w domyślnej konfiguracji.

Niektóre pola można zostawić jako nieokreślone (lub użyć wartości 0). Pola nieokreślone są zastępowane odpowiednimi definicjami opcji konfiguracji trybu otwartego (OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT), aby utworzyć domyślną konfigurację zapytania. Pole OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE jest wymagane.

Parametry

dns config [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean] [service-mode]

Przykłady

dns config fd00::1 1234 5000 2 0
Done
dns config
Server: [fd00:0:0:0:0:0:0:1]:1234
ResponseTimeout: 5000 ms
MaxTxAttempts: 2
RecursionDesired: no
Done
dns config fd00::2
Done
dns config
Server: [fd00:0:0:0:0:0:0:2]:53
ResponseTimeout: 3000 ms
MaxTxAttempts: 3
RecursionDesired: yes
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Konfiguracja DNS

Pobiera bieżącą domyślną konfigurację zapytania używaną przez klienta DNS.

Po uruchomieniu stosu OpenThread domyślna konfiguracja zapytania DNS jest określana na podstawie zestawu opcji konfiguracji OT, takich jak OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_IP6_ADDRESS, _DEFAULT_SERVER_PORT, _DEFAULT_RESPONSE_TIMEOUT itp. (wszystkie powiązane opcje konfiguracji znajdziesz w sekcji config/dns_client.h).

Konfiguracja obejmuje adres i port IPv6 serwera, czas oczekiwania na odpowiedź w ms (czas oczekiwania na odpowiedź rx), maksymalną liczbę prób Tx przed niepowodzeniem raportowania, flagę wartości logicznej wskazującej, czy serwer może rekurencyjnie rozwiązać zapytanie. Pole OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE jest wymagane.

Parametry

Brak parametrów.

Przykłady

dns config
Server: [fd00:0:0:0:0:0:0:1]:1234
ResponseTimeout: 5000 ms
MaxTxAttempts: 2
RecursionDesired: no
ServiceMode: srv
Nat64Mode: allow
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Rozwiązanie DNS

Wysyła zapytanie DNS dotyczące rozpoznawania adresów dla rekordów AAAA (IPv6) dla danej nazwy hosta.

aConfig może zawierać wartość NULL. W takim przypadku jako konfiguracja dla tego zapytania zostanie użyta konfiguracja domyślna (z otDnsClientGetDefaultConfig() ). W polu aConfig bez wartości NULL niektóre pola mogą być nieokreślone (wartość 0). Nieokreślone pola są następnie zastępowane wartościami z konfiguracji domyślnej.

Wyślij zapytanie DNS, aby uzyskać adres IPv6 dla danej nazwy hosta.

Parametry po nazwie hosta są opcjonalne. Każda nieokreślona wartość (lub zero) tych parametrów opcjonalnych zostanie zastąpiona wartością z bieżącej konfiguracji domyślnej (konfiguracja dns).

Adres IP serwera DNS może być adresem IPv4, który zostanie zsyntetyzowany na adres IPv6 przy użyciu preferowanego prefiksu NAT64 z danych sieci.

Parametry

dns resolve hostname [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]

Przykłady

dns resolve ipv6.google.com
DNS response for ipv6.google.com - 2a00:1450:401b:801:0:0:0:200e TTL: 300
dns resolve example.com 8.8.8.8
Synthesized IPv6 DNS server address: fdde:ad00:beef:2:0:0:808:808
DNS response for example.com. - fd4c:9574:3720:2:0:0:5db8:d822 TTL:20456
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

usługa DNS

Rozpoczyna rozpoznawanie instancji usługi DNS dla danej instancji usługi.

Opcja OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE jest dostępna, gdy jest włączona.

aConfig może zawierać wartość NULL. W takim przypadku jako konfiguracja dla tego zapytania zostanie użyta konfiguracja domyślna (z otDnsClientGetDefaultConfig() ). W polu aConfig bez wartości NULL niektóre pola mogą być nieokreślone (wartość 0). Nieokreślone pola są następnie zastępowane wartościami z konfiguracji domyślnej.

Funkcja wysyła zapytania o rekordy SRV lub TXT dla danej instancji usługi. Pole mServiceMode w polu otDnsQueryConfig określa, do których rekordów należy wysłać zapytanie (tylko SRV, tylko TXT lub zarówno SRV, jak i TXT) oraz sposób wykonywania zapytania (razem w tej samej wiadomości, równolegle niezależnie lub w trybie zoptymalizowanym, w którym klient najpierw spróbuje wysłać tę samą wiadomość, a następnie oddzielnie, jeśli nie otrzyma odpowiedzi).

Rekord SRV zawiera informacje o porcie usługi, priorytecie i wadze, a także nazwą hosta powiązaną z instancją usługi. Ta funkcja NIE wykonuje rozpoznawania adresów dla nazwy hosta wykrytej z rekordu SRV. Serwer/realizator może udostępnić rekordy AAAA/A dla nazwy hosta w sekcji Dane dodatkowe odpowiedzi na zapytanie SRV/TXT. Te informacje można pobrać przy użyciu otDnsServiceResponseGetServiceInfo() w narzędziu otDnsServiceCallback. Użytkownicy tego interfejsu API NIE MOGĄ zakładać, że adres hosta będzie zawsze dostępny z otDnsServiceResponseGetServiceInfo() .

Wyślij zapytanie DNS dotyczące rozpoznawania instancji usługi dla danej instancji usługi. Najpierw podawana jest etykieta instancji usługi, a po niej nazwa usługi (pamiętaj, że etykieta instancji usługi może zawierać kropkę „.”).

Parametry po service-name są opcjonalne. Każda nieokreślona wartość (lub zero) tych parametrów opcjonalnych zostanie zastąpiona wartością z bieżącej konfiguracji domyślnej (dns config).

Parametry

dns service service-instance-label service-name [DNS-server-IP] [DNS-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]

Przykłady

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Host usługi DNS

Rozpoczyna rozpoznawanie instancji usługi DNS dla danej instancji usługi z potencjalnym kolejnym rozwiązaniem adresu dla nazwy hosta wykrytej dla tej instancji usługi.

Opcja OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE jest dostępna, gdy jest włączona.

aConfig może zawierać wartość NULL. W takim przypadku jako konfiguracja dla tego zapytania zostanie użyta konfiguracja domyślna (z otDnsClientGetDefaultConfig() ). W polu aConfig bez wartości NULL niektóre pola mogą być nieokreślone (wartość 0). Nieokreślone pola są następnie zastępowane wartościami z konfiguracji domyślnej. Tej funkcji nie można używać z mServiceMode w konfiguracji DNS ustawionej na OT_DNS_SERVICE_MODE_TXT (tzn. z zapytaniem tylko o rekord TXT) i zwraca OT_ERROR_INVALID_ARGS.

Działa podobnie do wysyłania zapytań przez otDnsClientResolveService() o rekordy SRV i TXT. Jeśli jednak serwer/potwierdzający nie udostępnia rekordów AAAA/A dla nazwy hosta w odpowiedzi na zapytanie SRV (w sekcji Dodatkowe dane), to odczytuje nazwę hosta (wysyłając zapytanie AAAA) dla wykrytej nazwy hosta z rekordu SRV. Wywołanie zwrotne aCallback jest wywoływane po otrzymaniu odpowiedzi na wszystkie zapytania (tj. rozpoznawanie adresów usługi i hosta zostało zakończone).

Wysyłanie zapytania DNS dotyczącego rozpoznawania instancji usługi w przypadku danej instancji usługi z możliwością rozpoznania nazwy hosta w następnej kolejności. Najpierw podawana jest etykieta instancji usługi, a po niej nazwa usługi (pamiętaj, że etykieta instancji usługi może zawierać kropkę „.”).

Parametry po service-name są opcjonalne. Każda nieokreślona wartość (lub zero) tych parametrów opcjonalnych zostanie zastąpiona wartością z bieżącej konfiguracji domyślnej (dns config).

Parametry

dns servicehost service-instance-label service-name [DNS-server-IP] [DNS-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]

Przykłady

Dokumentacja interfejsu wiersza poleceń i interfejsu API

nazwa_domeny (zestaw)

Ustawia nazwę domeny Thread.

Działa tylko wtedy, gdy protokoły Thread są wyłączone.

Parametry

domainname name

Użyj klawisza backslash, aby wyjść ze spacji.

Przykłady

domainname Test\ Thread
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

nazwa domeny

Pobiera nazwę domeny Thread.

Parametry

Brak parametrów.

Przykłady

domainname
Thread
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

dua iid (ustawienie,wyczyść)

Ustawia lub usuwa identyfikator interfejsu określony ręcznie dla adresu Unicast domeny Thread.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_DUA_ENABLE.

Parametry

dua iid iid|clear

dua iid clear przekazuje nullptr do otThreadSetFixedDuaInterfaceIdentifier. W przeciwnym razie możesz zdać iid.

Przykłady

dua iid 0004000300020001
Done
dua iid clear
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Dua Iid

Pobiera identyfikator interfejsu określony ręcznie dla adresu Unicast domeny Thread.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_DUA_ENABLE.

Parametry

Brak parametrów.

Przykłady

dua iid
0004000300020001
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Eidcache

Zwraca wpisy z pamięci podręcznej EID do RLOC.

Parametry

Brak parametrów.

Przykłady

eidcache
fd49:caf4:a29f:dc0e:97fc:69dd:3c16:df7d 2000 cache canEvict=1 transTime=0 eid=fd49:caf4:a29f:dc0e:97fc:69dd:3c16:df7d
fd49:caf4:a29f:dc0e:97fc:69dd:3c16:df7f fffe retry canEvict=1 timeout=10 retryDelay=30
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

eui64

Pobiera IEEE EUI-64 przypisany do tego interfejsu.

Parametry

Brak parametrów.

Przykłady

eui64
0615aae900124b00
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

extaddr (zestaw)

Ustawia rozszerzony adres IEEE 802.15.4.

Parametry

extaddr extaddr

Przykłady

extaddr dead00beef00cafe
dead00beef00cafe
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

rozszerzenie

Pobiera rozszerzony adres IEEE 802.15.4.

Parametry

Brak parametrów.

Przykłady

extaddr
dead00beef00cafe
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

extpanid (set)

Ustawia rozszerzony identyfikator PAN IEEE 802.15.4.

Parametry

extpanid extpanid

Przykłady

extpanid dead00beef00cafe
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

rozszerzenia

Pobiera rozszerzony identyfikator PAN IEEE 802.15.4.

Parametry

Brak parametrów.

Przykłady

extpanid
dead00beef00cafe
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

reset fabryczny

Usuwa wszystkie ustawienia zapisane w pamięci nieulotnej, a następnie uruchamia resetowanie platformy.

Parametry

Brak parametrów.

Przykłady

factoryreset

Dokumentacja interfejsu wiersza poleceń i interfejsu API

fałszywy (a,an)

Wysyła fałszywe wiadomości w Thread.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

Parametry

fake /a/an dst-ipaddr target meshLocalIid

Przykłady

fake /a/an fdde:ad00:beef:0:0:ff:fe00:a800 fd00:7d03:7d03:7d03:55f2:bb6a:7a43:a03b 1111222233334444
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

fem

Pobiera zewnętrzne parametry FEM.

Parametry

Brak parametrów.

Przykłady

fem
LNA gain 11 dBm
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

fem lagain (get)

Pobiera wzmocnienie Rx LNA zewnętrznego FEM w dBm.

Parametry

Brak parametrów.

Przykłady

fem lnagain
11
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

fem lnagain (zestaw)

Ustawia wzmocnienie Rx LNA zewnętrznego FEM w dBm.

Parametry

Brak parametrów.

Przykłady

fem lnagain 8
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

historia ipaddr

Wyświetla historię adresów IPv6 pojedynczej transmisji w formacie tabeli lub listy.

Każdy wpis w tabeli lub na liście zawiera:

  • Wiek: czas, który upłynął od wydania polecenia, podany w formacie hours:minutes:seconds:milliseconds
  • Zdarzenie: możliwe wartości to Added lub Removed.
  • Długość adresu/prefiksu: adres Unicast z długością prefiksu (w bitach).
  • Źródło: możliwe wartości to thread, slaac, dhcp6 lub manual.
  • Zakres: zakres adresów IPv6.
  • P: flaga Preferred.
  • V: poprawna flaga.
  • RLOC (R): ta flaga wskazuje, czy adres IPv6 jest lokalizatorem routingu.

Parametry

history ipaddr [list] [num-entries]
  • Aby wyświetlić dane wyjściowe w formacie listy, użyj opcji list. W przeciwnym razie dane wyjściowe są wyświetlane w formacie tabeli.
  • Użyj opcji num-entries, aby ograniczyć dane wyjściowe do określonej liczby najnowszych wpisów. Jeśli ta opcja nie jest używana, w danych wyjściowych wyświetlane są wszystkie zapisane wpisy.

Przykłady

history ipaddr
| Age                  | Event   | Address / Prefix Length                     | Origin |Scope| P | V | R |
+----------------------+---------+---------------------------------------------+--------+-----+---+---+---+
|         00:00:04.991 | Removed | 2001:dead:beef:cafe:c4cb:caba:8d55:e30b/64  | slaac  |  14 | Y | Y | N |
|         00:00:44.647 | Added   | 2001:dead:beef:cafe:c4cb:caba:8d55:e30b/64  | slaac  |  14 | Y | Y | N |
|         00:01:07.199 | Added   | fd00:0:0:0:0:0:0:1/64                       | manual |  14 | Y | Y | N |
|         00:02:17.885 | Added   | fdde:ad00:beef:0:0:ff:fe00:fc00/64          | thread |   3 | N | Y | N |
|         00:02:17.885 | Added   | fdde:ad00:beef:0:0:ff:fe00:5400/64          | thread |   3 | N | Y | Y |
|         00:02:20.107 | Removed | fdde:ad00:beef:0:0:ff:fe00:5400/64          | thread |   3 | N | Y | Y |
|         00:02:21.575 | Added   | fdde:ad00:beef:0:0:ff:fe00:5400/64          | thread |   3 | N | Y | Y |
|         00:02:21.575 | Added   | fdde:ad00:beef:0:ecea:c4fc:ad96:4655/64     | thread |   3 | N | Y | N |
|         00:02:23.904 | Added   | fe80:0:0:0:3c12:a4d2:fbe0:31ad/64           | thread |   2 | Y | Y | N |
Done
history ipaddr list 5
00:00:20.327 -> event:Removed address:2001:dead:beef:cafe:c4cb:caba:8d55:e30b prefixlen:64 origin:slaac scope:14 preferred:yes valid:yes rloc:no
00:00:59.983 -> event:Added address:2001:dead:beef:cafe:c4cb:caba:8d55:e30b prefixlen:64 origin:slaac scope:14 preferred:yes valid:yes rloc:no
00:01:22.535 -> event:Added address:fd00:0:0:0:0:0:0:1 prefixlen:64 origin:manual scope:14 preferred:yes valid:yes rloc:no
00:02:33.221 -> event:Added address:fdde:ad00:beef:0:0:ff:fe00:fc00 prefixlen:64 origin:thread scope:3 preferred:no valid:yes rloc:no
00:02:33.221 -> event:Added address:fdde:ad00:beef:0:0:ff:fe00:5400 prefixlen:64 origin:thread scope:3 preferred:no valid:yes rloc:yes
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Historia ipmaddr

Wyświetla historię adresów IPv6 multiemisji w formacie tabeli lub listy.

Każdy wpis w tabeli lub na liście zawiera:

  • Wiek: czas, który upłynął od wydania polecenia, podany w formacie hours:minutes:seconds:milliseconds
  • Zdarzenie: możliwe wartości to Subscribed lub Unsubscribed.
  • Adres multiemisji
  • Źródło: możliwe wartości to Thread lub Manual.

Parametry

history ipmaddr [list] [num-entries]
  • Aby wyświetlić dane wyjściowe w formacie listy, użyj opcji list. W przeciwnym razie dane wyjściowe są wyświetlane w formacie tabeli.
  • Użyj opcji num-entries, aby ograniczyć dane wyjściowe do określonej liczby najnowszych wpisów. Jeśli ta opcja nie jest używana, w danych wyjściowych wyświetlane są wszystkie zapisane wpisy.

Przykłady

history ipmaddr
| Age                  | Event        | Multicast Address                       | Origin |
+----------------------+--------------+-----------------------------------------+--------+
|         00:00:08.592 | Unsubscribed | ff05:0:0:0:0:0:0:1                      | Manual |
|         00:01:25.353 | Subscribed   | ff05:0:0:0:0:0:0:1                      | Manual |
|         00:01:54.953 | Subscribed   | ff03:0:0:0:0:0:0:2                      | Thread |
|         00:01:54.953 | Subscribed   | ff02:0:0:0:0:0:0:2                      | Thread |
|         00:01:59.329 | Subscribed   | ff33:40:fdde:ad00:beef:0:0:1            | Thread |
|         00:01:59.329 | Subscribed   | ff32:40:fdde:ad00:beef:0:0:1            | Thread |
|         00:02:01.129 | Subscribed   | ff03:0:0:0:0:0:0:fc                     | Thread |
|         00:02:01.129 | Subscribed   | ff03:0:0:0:0:0:0:1                      | Thread |
|         00:02:01.129 | Subscribed   | ff02:0:0:0:0:0:0:1                      | Thread |
Done
history ipmaddr list
00:00:25.447 -> event:Unsubscribed address:ff05:0:0:0:0:0:0:1 origin:Manual
00:01:42.208 -> event:Subscribed address:ff05:0:0:0:0:0:0:1 origin:Manual
00:02:11.808 -> event:Subscribed address:ff03:0:0:0:0:0:0:2 origin:Thread
00:02:11.808 -> event:Subscribed address:ff02:0:0:0:0:0:0:2 origin:Thread
00:02:16.184 -> event:Subscribed address:ff33:40:fdde:ad00:beef:0:0:1 origin:Thread
00:02:16.184 -> event:Subscribed address:ff32:40:fdde:ad00:beef:0:0:1 origin:Thread
00:02:17.984 -> event:Subscribed address:ff03:0:0:0:0:0:0:fc origin:Thread
00:02:17.984 -> event:Subscribed address:ff03:0:0:0:0:0:0:1 origin:Thread
00:02:17.984 -> event:Subscribed address:ff02:0:0:0:0:0:0:1 origin:Thread
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

historyczny sąsiad

Wyświetla historię sąsiadów w formacie tabeli lub listy.

Każdy wpis w tabeli lub na liście zawiera:

  • Wiek: czas, który upłynął od wydania polecenia, podany w formacie hours:minutes:seconds:milliseconds
  • Typ: Child lub Router.
  • Zdarzenie: możliwe wartości to Added, Removed oraz Changed.
  • Rozszerzony adres
  • RLOC16
  • Tryb: tryb linku MLE. Możliwe wartości:
    • -: brak ustawionych flag (rx-off- Gdy-nieaktywny, minimalna liczba urządzeń Thread, stabilne dane sieciowe).
    • r: rx-on-Kiedy-nieaktywny
    • d: urządzenie z całym wątkiem.
    • n: pełne dane sieci
  • Ave RSS: średnia liczba klatek (w dBm) odebranych od sąsiada w momencie zarejestrowania wpisu.

Parametry

history neighbor [list] [num-entries]
  • Aby wyświetlić dane wyjściowe w formacie listy, użyj opcji list. W przeciwnym razie dane wyjściowe są wyświetlane w formacie tabeli.
  • Użyj opcji num-entries, aby ograniczyć dane wyjściowe do określonej liczby najnowszych wpisów. Jeśli ta opcja nie jest używana, w danych wyjściowych wyświetlane są wszystkie zapisane wpisy.

Przykłady

history neighbor
| Age                  | Type   | Event     | Extended Address | RLOC16 | Mode | Ave RSS |
+----------------------+--------+-----------+------------------+--------+------+---------+
|         00:00:29.233 | Child  | Added     | ae5105292f0b9169 | 0x8404 | -    |     -20 |
|         00:01:38.368 | Child  | Removed   | ae5105292f0b9169 | 0x8401 | -    |     -20 |
|         00:04:27.181 | Child  | Changed   | ae5105292f0b9169 | 0x8401 | -    |     -20 |
|         00:04:51.236 | Router | Added     | 865c7ca38a5fa960 | 0x9400 | rdn  |     -20 |
|         00:04:51.587 | Child  | Removed   | 865c7ca38a5fa960 | 0x8402 | rdn  |     -20 |
|         00:05:22.764 | Child  | Changed   | ae5105292f0b9169 | 0x8401 | rn   |     -20 |
|         00:06:40.764 | Child  | Added     | 4ec99efc874a1841 | 0x8403 | r    |     -20 |
|         00:06:44.060 | Child  | Added     | 865c7ca38a5fa960 | 0x8402 | rdn  |     -20 |
|         00:06:49.515 | Child  | Added     | ae5105292f0b9169 | 0x8401 | -    |     -20 |
Done
history neighbor list
00:00:34.753 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8404 mode:- rss:-20
00:01:43.888 -> type:Child event:Removed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:32.701 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:56.756 -> type:Router event:Added extaddr:865c7ca38a5fa960 rloc16:0x9400 mode:rdn rss:-20
00:04:57.107 -> type:Child event:Removed extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:05:28.284 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:rn rss:-20
00:06:46.284 -> type:Child event:Added extaddr:4ec99efc874a1841 rloc16:0x8403 mode:r rss:-20
00:06:49.580 -> type:Child event:Added extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:06:55.035 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Historia sieci

Wyświetla historię informacji o sieci w formacie tabeli lub listy.

Każdy wpis w tabeli lub na liście zawiera:

  • Wiek: czas, który upłynął od wydania polecenia, podany w formacie hours:minutes:seconds:milliseconds
  • Rola: rola urządzenia. Możliwe wartości to router, child, detached oraz disabled.
  • Tryb: tryb linku MLE. Możliwe wartości:
    • -: brak ustawionych flag (rx-off- Gdy-nieaktywny, minimalna liczba urządzeń Thread, stabilne dane sieciowe).
    • r: rx-on-Kiedy-nieaktywny
    • d: urządzenie z całym wątkiem.
    • n: pełne dane sieci
  • RLOC16
  • Identyfikator partycji.

Parametry

history netinfo [list] [num-entries]
  • Aby wyświetlić dane wyjściowe w formacie listy, użyj opcji list. W przeciwnym razie dane wyjściowe są wyświetlane w formacie tabeli.
  • Użyj opcji num-entries, aby ograniczyć dane wyjściowe do określonej liczby najnowszych wpisów. Jeśli ta opcja nie jest używana, w danych wyjściowych wyświetlane są wszystkie zapisane wpisy.

Przykłady

history netinfo
| Age                  | Role     | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
|         00:00:10.069 | router   | rdn  | 0x6000 |    151029327 |
|         00:02:09.337 | child    | rdn  | 0x2001 |    151029327 |
|         00:02:09.338 | child    | rdn  | 0x2001 |    151029327 |
|         00:07:40.806 | child    | -    | 0x2001 |    151029327 |
|         00:07:42.297 | detached | -    | 0x6000 |            0 |
|         00:07:42.968 | disabled | -    | 0x6000 |            0 |
Done
history netinfo list
00:00:59.467 -> role:router mode:rdn rloc16:0x6000 partition-id:151029327
00:02:58.735 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:02:58.736 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:08:30.204 -> role:child mode:- rloc16:0x2001 partition-id:151029327
00:08:31.695 -> role:detached mode:- rloc16:0x6000 partition-id:0
00:08:32.366 -> role:disabled mode:- rloc16:0x6000 partition-id:0
Done
history netinfo 2
| Age                  | Role     | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
|         00:02:05.451 | router   | rdn  | 0x6000 |    151029327 |
|         00:04:04.719 | child    | rdn  | 0x2001 |    151029327 |
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

prefiks historii

Wyświetla dane sieciowe dla historii prefiksów sieci typu mesh w formacie tabeli lub listy.

Każdy wpis w tabeli lub na liście zawiera:

  • Wiek: czas, który upłynął od wydania polecenia, podany w formacie hours:minutes:seconds:milliseconds
  • Zdarzenie: możliwe wartości to Added lub Removed.
  • Prefiks
  • Flagi/znaczenie:
    • p: preferowana flaga
    • a: flaga automatycznej konfiguracji bezstanowego adresu IPv6.
    • d: flaga konfiguracji adresu IPv6 DHCPv6.
    • c: flaga innej konfiguracji DHCPv6.
    • r: flaga trasy domyślnej.
    • o: flaga sieci typu mesh.
    • s: flaga stabilna.
    • n: flaga Nd Dns.
    • D: flaga prefiksu domeny.
  • Pref: Preference (Preferencja). Możliwe wartości to high, med lub low.
  • RLOC16

Parametry

history prefix [list] [num-entries]
  • Aby wyświetlić dane wyjściowe w formacie listy, użyj opcji list. W przeciwnym razie dane wyjściowe są wyświetlane w formacie tabeli.
  • Użyj opcji num-entries, aby ograniczyć dane wyjściowe do określonej liczby najnowszych wpisów. Jeśli ta opcja nie jest używana, w danych wyjściowych wyświetlane są wszystkie zapisane wpisy.

Przykłady

history prefix
| Age                  | Event   | Prefix                                      | Flags     | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
|         00:00:10.663 | Added   | fd00:1111:2222:3333::/64                    | paro      | med  | 0x5400 |
|         00:01:02.054 | Removed | fd00:dead:beef:1::/64                       | paros     | high | 0x5400 |
|         00:01:21.136 | Added   | fd00:abba:cddd:0::/64                       | paos      | med  | 0x5400 |
|         00:01:45.144 | Added   | fd00:dead:beef:1::/64                       | paros     | high | 0x3c00 |
|         00:01:50.944 | Added   | fd00:dead:beef:1::/64                       | paros     | high | 0x5400 |
|         00:01:59.887 | Added   | fd00:dead:beef:1::/64                       | paros     | med  | 0x8800 |
Done
history prefix list
00:04:12.487 -> event:Added prefix:fd00:1111:2222:3333::/64 flags:paro pref:med rloc16:0x5400
00:05:03.878 -> event:Removed prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:05:22.960 -> event:Added prefix:fd00:abba:cddd:0::/64 flags:paos pref:med rloc16:0x5400
00:05:46.968 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x3c00
00:05:52.768 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:06:01.711 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:med rloc16:0x8800
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

trasa historyczna

Wyświetla historię danych sieciowych dotyczących tras zewnętrznych w formacie tabeli lub listy.

Każdy wpis w tabeli lub na liście zawiera:

  • Wiek: czas, który upłynął od wydania polecenia, podany w formacie hours:minutes:seconds:milliseconds
  • Zdarzenie: możliwe wartości to Added lub Removed.
  • Trasa
  • Flagi/znaczenie:
    • s: flaga stabilna.
    • n: flaga NAT64.
  • Pref: Preference (Preferencja). Możliwe wartości to high, med lub low.
  • RLOC16

Parametry

history route [list] [num-entries]
  • Aby wyświetlić dane wyjściowe w formacie listy, użyj opcji list. W przeciwnym razie dane wyjściowe są wyświetlane w formacie tabeli.
  • Użyj opcji num-entries, aby ograniczyć dane wyjściowe do określonej liczby najnowszych wpisów. Jeśli ta opcja nie jest używana, w danych wyjściowych wyświetlane są wszystkie zapisane wpisy.

Przykłady

history route
| Age                  | Event   | Route                                       | Flags     | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
|         00:00:05.456 | Removed | fd00:1111:0::/48                            | s         | med  | 0x3c00 |
|         00:00:29.310 | Added   | fd00:1111:0::/48                            | s         | med  | 0x3c00 |
|         00:00:42.822 | Added   | fd00:1111:0::/48                            | s         | med  | 0x5400 |
|         00:01:27.688 | Added   | fd00:aaaa:bbbb:cccc::/64                    | s         | med  | 0x8800 |
Done
history route list 2
00:00:48.704 -> event:Removed route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
00:01:12.558 -> event:Added route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

router historii

Wyświetla historię tabeli tras w formacie tabeli lub listy.

Każdy wpis w tabeli lub na liście zawiera:

  • Wiek: czas, który upłynął od wydania polecenia, podany w formacie hours:minutes:seconds:milliseconds
  • Zdarzenie: możliwe wartości to Added, Removed, NextHopChanged oraz CostChanged.
  • ID (RLOC16): identyfikator routera i RLOC16 routera.
  • Następny przeskok: identyfikator routera i RLOC16 następnego przeskoku. Jeśli nie ma następnego przeskoku, wyświetlany jest none.
  • Koszt ścieżki: stary koszt -> nowy koszt. Wartość inf oznacza nieskończony koszt ścieżki.

Parametry

history router [list] [num-entries]
  • Aby wyświetlić dane wyjściowe w formacie listy, użyj opcji list. W przeciwnym razie dane wyjściowe są wyświetlane w formacie tabeli.
  • Użyj opcji num-entries, aby ograniczyć dane wyjściowe do określonej liczby najnowszych wpisów. Jeśli ta opcja nie jest używana, w danych wyjściowych wyświetlane są wszystkie zapisane wpisy.

Przykłady

history router
| Age                  | Event          | ID (RLOC16) | Next Hop    | Path Cost  |
+----------------------+----------------+-------------+-------------+------------+
|         00:00:05.258 | NextHopChanged |  7 (0x1c00) | 34 (0x8800) | inf ->   3 |
|         00:00:08.604 | NextHopChanged | 34 (0x8800) | 34 (0x8800) | inf ->   2 |
|         00:00:08.604 | Added          |  7 (0x1c00) |        none | inf -> inf |
|         00:00:11.931 | Added          | 34 (0x8800) |        none | inf -> inf |
|         00:00:14.948 | Removed        | 59 (0xec00) |        none | inf -> inf |
|         00:00:14.948 | Removed        | 54 (0xd800) |        none | inf -> inf |
|         00:00:14.948 | Removed        | 34 (0x8800) |        none | inf -> inf |
|         00:00:14.948 | Removed        |  7 (0x1c00) |        none | inf -> inf |
|         00:00:54.795 | NextHopChanged | 59 (0xec00) | 34 (0x8800) |   1 ->   5 |
|         00:02:33.735 | NextHopChanged | 54 (0xd800) |        none |  15 -> inf |
|         00:03:10.915 | CostChanged    | 54 (0xd800) | 34 (0x8800) |  13 ->  15 |
|         00:03:45.716 | NextHopChanged | 54 (0xd800) | 34 (0x8800) |  15 ->  13 |
|         00:03:46.188 | CostChanged    | 54 (0xd800) | 59 (0xec00) |  13 ->  15 |
|         00:04:19.124 | CostChanged    | 54 (0xd800) | 59 (0xec00) |  11 ->  13 |
|         00:04:52.008 | CostChanged    | 54 (0xd800) | 59 (0xec00) |   9 ->  11 |
|         00:05:23.176 | CostChanged    | 54 (0xd800) | 59 (0xec00) |   7 ->   9 |
|         00:05:51.081 | CostChanged    | 54 (0xd800) | 59 (0xec00) |   5 ->   7 |
|         00:06:48.721 | CostChanged    | 54 (0xd800) | 59 (0xec00) |   3 ->   5 |
|         00:07:13.792 | NextHopChanged | 54 (0xd800) | 59 (0xec00) |   1 ->   3 |
|         00:09:28.681 | NextHopChanged |  7 (0x1c00) | 34 (0x8800) | inf ->   3 |
|         00:09:31.882 | Added          |  7 (0x1c00) |        none | inf -> inf |
|         00:09:51.240 | NextHopChanged | 54 (0xd800) | 54 (0xd800) | inf ->   1 |
|         00:09:54.204 | Added          | 54 (0xd800) |        none | inf -> inf |
|         00:10:20.645 | NextHopChanged | 34 (0x8800) | 34 (0x8800) | inf ->   2 |
|         00:10:24.242 | NextHopChanged | 59 (0xec00) | 59 (0xec00) | inf ->   1 |
|         00:10:24.242 | Added          | 34 (0x8800) |        none | inf -> inf |
|         00:10:41.900 | NextHopChanged | 59 (0xec00) |        none |   1 -> inf |
|         00:10:42.480 | Added          |  3 (0x0c00) |  3 (0x0c00) | inf -> inf |
|         00:10:43.614 | Added          | 59 (0xec00) | 59 (0xec00) | inf ->   1 |
Done
history router list 20
00:00:06.959 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
00:00:10.305 -> event:NextHopChanged router:34(0x8800) nexthop:34(0x8800) old-cost:inf new-cost:2
00:00:10.305 -> event:Added router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:13.632 -> event:Added router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:59(0xec00) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:54(0xd800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:56.496 -> event:NextHopChanged router:59(0xec00) nexthop:34(0x8800) old-cost:1 new-cost:5
00:02:35.436 -> event:NextHopChanged router:54(0xd800) nexthop:none old-cost:15 new-cost:inf
00:03:12.616 -> event:CostChanged router:54(0xd800) nexthop:34(0x8800) old-cost:13 new-cost:15
00:03:47.417 -> event:NextHopChanged router:54(0xd800) nexthop:34(0x8800) old-cost:15 new-cost:13
00:03:47.889 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:13 new-cost:15
00:04:20.825 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:11 new-cost:13
00:04:53.709 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:9 new-cost:11
00:05:24.877 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:7 new-cost:9
00:05:52.782 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:5 new-cost:7
00:06:50.422 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:3 new-cost:5
00:07:15.493 -> event:NextHopChanged router:54(0xd800) nexthop:59(0xec00) old-cost:1 new-cost:3
00:09:30.382 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Historia RX

Wyświetla historię RX wiadomości IPv6 w formacie tabeli lub listy.

Każdy wpis w tabeli lub na liście zawiera:

  • Wiek: czas, który upłynął od wydania polecenia, podany w formacie hours:minutes:seconds:milliseconds
  • Typ:
    • Typ wiadomości IPv6, na przykład UDP, TCP, HopOpts i ICMP6 (oraz jego podtyp).
    • src: źródłowy adres IPv6 i numer portu.
    • dst: docelowy adres IPv6 i numer portu (numer portu jest prawidłowy dla protokołu UDP/TCP, a w przeciwnym razie ma wartość 0).
  • Len: długość ładunku IPv6 (bez nagłówka IPv6).
  • Chksum: suma kontrolna wiadomości (prawidłowa dla wiadomości UDP, TCP i ICMP6).
  • Sek: wskazuje, czy były używane zabezpieczenia warstwy linku.
  • Prio: Priorytet wiadomości. Możliwe wartości to low, norm, high i net (w przypadku komunikatów sterujących Thread).
  • RSS: siła odbieranego sygnału (w dBm), uśredniona dla wszystkich otrzymanych ramek fragmentów, z których składa się wiadomość. W przypadku historii TX wyświetlana jest wartość NA (nie dotyczy).
  • Dyr: pokazuje, czy wiadomość została wysłana (TX) czy odebrana (RX). Nieudane przesyłanie jest oznaczone symbolem TX-F w formacie tabeli lub tx-success:no w formacie listy. Przykłady nieudanej transmisji to m.in. txprzerwanie i brak wysyłania ack z serwera równorzędnego w przypadku fragmentów wiadomości.
  • Sąsiad: krótki adres (RLOC16) sąsiada, do którego wiadomość została wysłana/odebrana. Jeśli klatka była transmitowana, jest wyświetlana jako bcast w formacie tabeli lub 0xffff w formacie listy. Jeśli krótki adres sąsiada jest niedostępny, jest wyświetlany jako unknwn w formacie tabeli lub 0xfffe w formacie listy.
  • Radio: link radiowy, w ramach którego wysłano/odebrano wiadomość (przydatne, gdy włączona jest funkcja OPENTHREAD_CONFIG_MULTI_RADIO). Może być 15.4, trel lub all (jeśli są wysyłane we wszystkich linkach radiowych).

Parametry

history rx [list] [num-entries]
  • Aby wyświetlić dane wyjściowe w formacie listy, użyj opcji list. W przeciwnym razie dane wyjściowe są wyświetlane w formacie tabeli.
  • Użyj opcji num-entries, aby ograniczyć dane wyjściowe do określonej liczby najnowszych wpisów. Jeśli ta opcja nie jest używana, w danych wyjściowych wyświetlane są wszystkie zapisane wpisy.

Przykłady

history rx
| Age                  | Type             | Len   | Chksum | Sec | Prio | RSS  |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0xbd26 |  no |  net |  -20 | RX | 0x4800 |  15.4 |
|         00:00:07.640 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788                                 |
|                      | dst: [ff02:0:0:0:0:0:0:1]:19788                                             |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | HopOpts          |    44 | 0x0000 | yes | norm |  -20 | RX | 0x4800 |  15.4 |
|         00:00:09.263 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:0                                    |
|                      | dst: [ff03:0:0:0:0:0:0:2]:0                                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    12 | 0x3f7d | yes |  net |  -20 | RX | 0x4800 |  15.4 |
|         00:00:09.302 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:61631                                |
|                      | dst: [fdde:ad00:beef:0:0:ff:fe00:4801]:61631                                |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | ICMP6(EchoReqst) |    16 | 0x942c | yes | norm |  -20 | RX | 0x4800 |  15.4 |
|         00:00:09.304 | src: [fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0                               |
|                      | dst: [fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0                               |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | HopOpts          |    44 | 0x0000 | yes | norm |  -20 | RX | 0x4800 |  15.4 |
|         00:00:09.304 | src: [fdde:ad00:beef:0:0:ff:fe00:4800]:0                                    |
|                      | dst: [ff03:0:0:0:0:0:0:2]:0                                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0x2e37 |  no |  net |  -20 | RX | 0x4800 |  15.4 |
|         00:00:21.622 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788                                 |
|                      | dst: [ff02:0:0:0:0:0:0:1]:19788                                             |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0xe177 |  no |  net |  -20 | RX | 0x4800 |  15.4 |
|         00:00:26.640 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788                                 |
|                      | dst: [ff02:0:0:0:0:0:0:1]:19788                                             |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |   165 | 0x82ee | yes |  net |  -20 | RX | 0x4800 |  15.4 |
|         00:00:30.000 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788                                 |
|                      | dst: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788                                  |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    93 | 0x52df |  no |  net |  -20 | RX | unknwn |  15.4 |
|         00:00:30.480 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788                                 |
|                      | dst: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788                                  |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0x5ccf |  no |  net |  -20 | RX | unknwn |  15.4 |
|         00:00:30.772 | src: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788                                 |
|                      | dst: [ff02:0:0:0:0:0:0:1]:19788                                             |
Done
history rx list 4
00:00:13.368
    type:UDP len:50 checksum:0xbd26 sec:no prio:net rss:-20 from:0x4800 radio:15.4
    src:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
    dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:14.991
    type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:4800]:0
    dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.030
    type:UDP len:12 checksum:0x3f7d sec:yes prio:net rss:-20 from:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
    dst:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
00:00:15.032
    type:ICMP6(EchoReqst) len:16 checksum:0x942c sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
    dst:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

historia rxtx

Wyświetla połączoną historię RX i TX wiadomości IPv6 w formacie tabeli lub listy.

Każdy wpis w tabeli lub na liście zawiera:

  • Wiek: czas, który upłynął od wydania polecenia, podany w formacie hours:minutes:seconds:milliseconds
  • Typ:
    • Typ wiadomości IPv6, na przykład UDP, TCP, HopOpts i ICMP6 (oraz jego podtyp).
    • src: źródłowy adres IPv6 i numer portu.
    • dst: docelowy adres IPv6 i numer portu (numer portu jest prawidłowy dla protokołu UDP/TCP, a w przeciwnym razie ma wartość 0).
  • Len: długość ładunku IPv6 (bez nagłówka IPv6).
  • Chksum: suma kontrolna wiadomości (prawidłowa dla wiadomości UDP, TCP i ICMP6).
  • Sek: wskazuje, czy były używane zabezpieczenia warstwy linku.
  • Prio: Priorytet wiadomości. Możliwe wartości to low, norm, high i net (w przypadku komunikatów sterujących Thread).
  • RSS: siła odbieranego sygnału (w dBm), uśredniona dla wszystkich otrzymanych ramek fragmentów, z których składa się wiadomość. W przypadku historii TX wyświetlana jest wartość NA (nie dotyczy).
  • Dyr: pokazuje, czy wiadomość została wysłana (TX) czy odebrana (RX). Nieudane przesyłanie jest oznaczone symbolem TX-F w formacie tabeli lub tx-success:no w formacie listy. Przykłady nieudanej transmisji to m.in. txprzerwanie i brak wysyłania ack z serwera równorzędnego w przypadku fragmentów wiadomości.
  • Sąsiad: krótki adres (RLOC16) sąsiada, do którego wiadomość została wysłana/odebrana. Jeśli klatka była transmitowana, jest wyświetlana jako bcast w formacie tabeli lub 0xffff w formacie listy. Jeśli krótki adres sąsiada jest niedostępny, jest wyświetlany jako unknwn w formacie tabeli lub 0xfffe w formacie listy.
  • Radio: link radiowy, w ramach którego wysłano/odebrano wiadomość (przydatne, gdy włączona jest funkcja OPENTHREAD_CONFIG_MULTI_RADIO). Może być 15.4, trel lub all (jeśli są wysyłane we wszystkich linkach radiowych).

Parametry

history rxtx [list] [num-entries]
  • Aby wyświetlić dane wyjściowe w formacie listy, użyj opcji list. W przeciwnym razie dane wyjściowe są wyświetlane w formacie tabeli.
  • Użyj opcji num-entries, aby ograniczyć dane wyjściowe do określonej liczby najnowszych wpisów. Jeśli ta opcja nie jest używana, w danych wyjściowych wyświetlane są wszystkie zapisane wpisy.

Przykłady

history rxtx
| Age                  | Type             | Len   | Chksum | Sec | Prio | RSS  |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | HopOpts          |    44 | 0x0000 | yes | norm |  -20 | RX | 0x0800 |  15.4 |
|         00:00:09.267 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:0                                     |
|                      | dst: [ff03:0:0:0:0:0:0:2]:0                                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    12 | 0x6c6b | yes |  net |  -20 | RX | 0x0800 |  15.4 |
|         00:00:09.290 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:61631                                 |
|                      | dst: [fdde:ad00:beef:0:0:ff:fe00:801]:61631                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | ICMP6(EchoReqst) |    16 | 0xc6a2 | yes | norm |  -20 | RX | 0x0800 |  15.4 |
|         00:00:09.292 | src: [fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0                               |
|                      | dst: [fdde:ad00:beef:0:af4c:3644:882a:3698]:0                               |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | ICMP6(EchoReply) |    16 | 0xc5a2 | yes | norm |  NA  | TX | 0x0800 |  15.4 |
|         00:00:09.292 | src: [fdde:ad00:beef:0:af4c:3644:882a:3698]:0                               |
|                      | dst: [fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0                               |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0xaa0d | yes |  net |  NA  | TX | 0x0800 |  15.4 |
|         00:00:09.294 | src: [fdde:ad00:beef:0:0:ff:fe00:801]:61631                                 |
|                      | dst: [fdde:ad00:beef:0:0:ff:fe00:800]:61631                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | HopOpts          |    44 | 0x0000 | yes | norm |  -20 | RX | 0x0800 |  15.4 |
|         00:00:09.296 | src: [fdde:ad00:beef:0:0:ff:fe00:800]:0                                     |
|                      | dst: [ff03:0:0:0:0:0:0:2]:0                                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0xc1d8 |  no |  net |  -20 | RX | 0x0800 |  15.4 |
|         00:00:09.569 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788                                 |
|                      | dst: [ff02:0:0:0:0:0:0:1]:19788                                             |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0x3cb1 |  no |  net |  -20 | RX | 0x0800 |  15.4 |
|         00:00:16.519 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788                                 |
|                      | dst: [ff02:0:0:0:0:0:0:1]:19788                                             |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0xeda0 |  no |  net |  -20 | RX | 0x0800 |  15.4 |
|         00:00:20.599 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788                                 |
|                      | dst: [ff02:0:0:0:0:0:0:1]:19788                                             |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |   165 | 0xbdfa | yes |  net |  -20 | RX | 0x0800 |  15.4 |
|         00:00:21.059 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788                                 |
|                      | dst: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    64 | 0x1c11 |  no |  net |  NA  | TX | 0x0800 |  15.4 |
|         00:00:21.062 | src: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788                                 |
|                      | dst: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    93 | 0xedff |  no |  net |  -20 | RX | unknwn |  15.4 |
|         00:00:21.474 | src: [fe80:0:0:0:54d9:5153:ffc6:df26]:19788                                 |
|                      | dst: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    44 | 0xd383 |  no |  net |  NA  | TX | bcast  |  15.4 |
|         00:00:21.811 | src: [fe80:0:0:0:8893:c2cc:d983:1e1c]:19788                                 |
|                      | dst: [ff02:0:0:0:0:0:0:2]:19788                                             |
Done
history rxtx list 5
00:00:02.100
    type:UDP len:50 checksum:0xd843 sec:no prio:net rss:-20 from:0x0800 radio:15.4
    src:[fe80:0:0:0:54d9:5153:ffc6:df26]:19788
    dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:15.331
    type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:800]:0
    dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.354
    type:UDP len:12 checksum:0x6c6b sec:yes prio:net rss:-20 from:0x0800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:800]:61631
    dst:[fdde:ad00:beef:0:0:ff:fe00:801]:61631
00:00:15.356
    type:ICMP6(EchoReqst) len:16 checksum:0xc6a2 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
    src:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
    dst:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
00:00:15.356
    type:ICMP6(EchoReply) len:16 checksum:0xc5a2 sec:yes prio:norm tx-success:yes to:0x0800 radio:15.4
    src:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
    dst:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

historia teks

Wyświetla historię TX wiadomości IPv6 w formacie tabeli lub listy.

Każdy wpis w tabeli lub na liście zawiera:

  • Wiek: czas, który upłynął od wydania polecenia, podany w formacie hours:minutes:seconds:milliseconds
  • Typ:
    • Typ wiadomości IPv6, na przykład UDP, TCP, HopOpts i ICMP6 (oraz jego podtyp).
    • src: źródłowy adres IPv6 i numer portu.
    • dst: docelowy adres IPv6 i numer portu (numer portu jest prawidłowy dla protokołu UDP/TCP, a w przeciwnym razie ma wartość 0).
  • Len: długość ładunku IPv6 (bez nagłówka IPv6).
  • Chksum: suma kontrolna wiadomości (prawidłowa dla wiadomości UDP, TCP i ICMP6).
  • Sek: wskazuje, czy były używane zabezpieczenia warstwy linku.
  • Prio: Priorytet wiadomości. Możliwe wartości to low, norm, high i net (w przypadku komunikatów sterujących Thread).
  • RSS: siła odbieranego sygnału (w dBm), uśredniona dla wszystkich otrzymanych ramek fragmentów, z których składa się wiadomość. W przypadku historii TX wyświetlana jest wartość NA (nie dotyczy).
  • Dyr: pokazuje, czy wiadomość została wysłana (TX) czy odebrana (RX). Nieudane przesyłanie jest oznaczone symbolem TX-F w formacie tabeli lub tx-success:no w formacie listy. Przykłady nieudanej transmisji to m.in. txprzerwanie i brak wysyłania ack z serwera równorzędnego w przypadku fragmentów wiadomości.
  • Sąsiad: krótki adres (RLOC16) sąsiada, do którego wiadomość została wysłana/odebrana. Jeśli klatka była transmitowana, jest wyświetlana jako bcast w formacie tabeli lub 0xffff w formacie listy. Jeśli krótki adres sąsiada jest niedostępny, jest wyświetlany jako unknwn w formacie tabeli lub 0xfffe w formacie listy.
  • Radio: link radiowy, w ramach którego wysłano/odebrano wiadomość (przydatne, gdy włączona jest funkcja OPENTHREAD_CONFIG_MULTI_RADIO). Może być 15.4, trel lub all (jeśli są wysyłane we wszystkich linkach radiowych).

Parametry

history tx [list] [num-entries]
  • Aby wyświetlić dane wyjściowe w formacie listy, użyj opcji list. W przeciwnym razie dane wyjściowe są wyświetlane w formacie tabeli.
  • Użyj opcji num-entries, aby ograniczyć dane wyjściowe do określonej liczby najnowszych wpisów. Jeśli ta opcja nie jest używana, w danych wyjściowych wyświetlane są wszystkie zapisane wpisy.

Przykłady

history tx
| Age                  | Type             | Len   | Chksum | Sec | Prio | RSS  |Dir | Neighb | Radio |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | ICMP6(EchoReply) |    16 | 0x932c | yes | norm |  NA  | TX | 0x4800 |  15.4 |
|         00:00:18.798 | src: [fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0                               |
|                      | dst: [fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0                               |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    50 | 0xce87 | yes |  net |  NA  | TX | 0x4800 |  15.4 |
|         00:00:18.800 | src: [fdde:ad00:beef:0:0:ff:fe00:4801]:61631                                |
|                      | dst: [fdde:ad00:beef:0:0:ff:fe00:4800]:61631                                |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    64 | 0xf7ba |  no |  net |  NA  | TX | 0x4800 |  15.4 |
|         00:00:39.499 | src: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788                                  |
|                      | dst: [fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788                                 |
+----------------------+------------------+-------+--------+-----+------+------+----+--------+-------+
|                      | UDP              |    44 | 0x26d4 |  no |  net |  NA  | TX | bcast  |  15.4 |
|         00:00:40.256 | src: [fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788                                  |
|                      | dst: [ff02:0:0:0:0:0:0:2]:19788                                             |
Done
history tx list
00:00:23.957
    type:ICMP6(EchoReply) len:16 checksum:0x932c sec:yes prio:norm tx-success:yes to:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
    dst:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
00:00:23.959
    type:UDP len:50 checksum:0xce87 sec:yes prio:net tx-success:yes to:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
    dst:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
00:00:44.658
    type:UDP len:64 checksum:0xf7ba sec:no prio:net tx-success:yes to:0x4800 radio:15.4
    src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
    dst:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
00:00:45.415
    type:UDP len:44 checksum:0x26d4 sec:no prio:net tx-success:yes to:0xffff radio:15.4
    src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
    dst:[ff02:0:0:0:0:0:0:2]:19788
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

ifconfig (w górę,w dół)

Włącza lub wyłącza interfejs IPv6.

Wywołaj, aby włączyć lub wyłączyć komunikację IPv6.

Parametry

ifconfig up|down

Przykłady

ifconfig up
Done
ifconfig down
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

ifconfig,

Wskazuje, czy interfejs IPv6 jest aktywny.

Parametry

Brak parametrów.

Przykłady

ifconfig
down
Done
ifconfig
up
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

identyfikator instancji

Pobiera identyfikator instancji.

Podczas tworzenia instancji identyfikator jest ustawiany na losową wartość, a jej wartość nie zmienia się po zainicjowaniu.

Parametry

Brak parametrów.

Przykłady

instanceid
468697314
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Dodaj do iPada

Dodaje adres interfejsu sieci do interfejsu Thread.

Przekazana instancja aAddress jest kopiowana przez interfejs Thread. Interfejs Thread obsługuje tylko stałą liczbę dodanych zewnętrznie adresów Unicast. Zobacz OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS.

Parametry

ipaddr add aAddress

Przykłady

ipaddr add 2001::dead:beef:cafe
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Ipaddr Del

Usuwa adres interfejsu sieci z interfejsu Thread.

Parametry

ipaddr del aAddress

Przykłady

ipaddr del 2001::dead:beef:cafe
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

iPad

Pobiera listę adresów IPv6 przypisanych do interfejsu Thread.

Parametry

ipaddr [-v]

Aby uzyskać bardziej szczegółowe informacje o adresie, skorzystaj z usługi -v:

  • origin: może mieć wartości thread, slaac, dhcp6, manual i wskazuje pochodzenie adresu
  • plen: długość prefiksu
  • preferred: preferowana flaga (wartość logiczna)
  • valid: prawidłowa flaga (wartość logiczna)

Przykłady

ipaddr
fdde:ad00:beef:0:0:ff:fe00:0
fdde:ad00:beef:0:558:f56b:d688:799
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done
ipaddr -v
fd5e:18fa:f4a5:b8:0:ff:fe00:fc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:0:ff:fe00:dc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:f8e:5d95:87a0:e82c origin:thread plen:64 preferred:0 valid:1
fe80:0:0:0:4891:b191:e277:8826 origin:thread plen:64 preferred:1 valid:1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

ipaddr Linklocal

Pobiera lokalny adres IPv6 linku wątku.

Adres lokalny linku wątku jest uzyskiwany przy użyciu rozszerzonego adresu IEEE802.15.4 jako identyfikatora interfejsu.

Parametry

Brak parametrów.

Przykłady

ipaddr linklocal
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

ipaddr mleid

Pobiera lokalny adres EID sieci typu mesh.

Parametry

Brak parametrów.

Przykłady

ipaddr mleid
fdde:ad00:beef:0:558:f56b:d688:799
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Ipaddr Rloc

Pobiera adres lokalizatora routingu wątków (RLOC).

Parametry

Brak parametrów.

Przykłady

ipaddr rloc
fdde:ad00:beef:0:0:ff:fe00:0
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

dodaj ipmaddr

Subskrybuje adres multiemisji interfejsu sieci i interfejs Thread.

Informacje przekazane w instancji aAddress zostaną skopiowane przez interfejs Thread. Interfejs Thread obsługuje tylko stałą liczbę dodanych zewnętrznie adresów multiemisji. Zobacz OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS.

Parametry

ipmaddr add aAddress

Przykłady

ipmaddr add ff05::1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

ipmaddr del

Anuluje subskrypcję interfejsu Thread na adres multiemisji interfejsu sieci.

Parametry

ipmaddr del aAddress

Przykłady

ipmaddr del ff05::1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

ipmaddr

Pobiera listę adresów multiemisji IPv6 subskrybowanych w interfejsie Thread.

Parametry

Brak parametrów.

Przykłady

ipmaddr
ff05:0:0:0:0:0:0:1
ff33:40:fdde:ad00:beef:0:0:1
ff32:40:fdde:ad00:beef:0:0:1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

ipmaddr llatn

Pobiera adres multiemisji w Thread Link-Local wszystkich węzłów Thread.

Adres jest adresem multicast opartym na prefiksie Unicast [RFC 3306], zawierającym:

  • flgs ustawione na 3 (P = 1 i T = 1)
  • zrzut ustawiony na 2
  • plen ustawiony na 64
  • prefiks sieci został ustawiony na lokalny prefiks sieci typu mesh
  • identyfikator grupy ustawiony na 1,

Parametry

Brak parametrów.

Przykłady

ipmaddr llatn
ff32:40:fdde:ad00:beef:0:0:1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

ipmaddr promiscuous (włącz,wyłącz)

Włącza lub wyłącza tryb uzyskiwania dostępu w trybie multiemisji w interfejsie Thread.

Parametry

ipmaddr promiscuous enable|disable

Przykłady

ipmaddr promiscuous enable
Done
ipmaddr promiscuous disable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

ipmaddr nasłuchujący

Sprawdza, czy w interfejsie Thread jest włączony tryb prognostyczny przesyłania zbiorczego.

Parametry

Brak parametrów.

Przykłady

ipmaddr promiscuous
Disabled
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

ipmaddr rlatn

Pobiera adres multiemisji wszystkich węzłów w regionie Thread Realm-Local.

Adres jest lokalnym adresem multicast opartym na prefiksie Unicast [RFC 3306], który zawiera:

  • flgs ustawione na 3 (P = 1 i T = 1)
  • scop ustawiony na 3
  • plen ustawiony na 64
  • prefiks sieci został ustawiony na lokalny prefiks sieci typu mesh
  • identyfikator grupy ustawiony na 1,

Parametry

Brak parametrów.

Przykłady

ipmaddr rlatn
ff33:40:fdde:ad00:beef:0:0:1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Joiner discerner (zestaw)

Konfiguruje narzędzie Joiner Discerner.

Parametry

joiner discerner discerner
  • Użyj {number}/{length}, aby ustawić discerner.
  • joiner discerner clear ustawia aDiscerner na nullptr.

Przykłady

joiner discerner 0xabc/12
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

joiner discerner wyraźne

Wyczyść narzędzie do łączenia

Parametry

Brak parametrów.

Przykłady

joiner discerner clear
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

narzędzie do porównywania jamy ustnej

Analizuje sprzęganie.

Więcej informacji znajdziesz w tym artykule: otJoinerSetDiscerner.

Parametry

Brak parametrów.

Przykłady

joiner discerner
0xabc/12
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

pomoc dołączana

Wydrukuj menu pomocy joiner.

Parametry

Brak parametrów.

Przykłady

joiner help
help
id
start
state
stop
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

identyfikator złącza

Pobiera identyfikator złącza.

Jeśli nie skonfigurowano elementu Joiner Discerner, Joiner ID to pierwsze 64 bity wyniku obliczenia SHA-256 za pomocą IEEE EUI-64 przypisanego do fabryki. W przeciwnym razie identyfikator złącza jest obliczany na podstawie wartości Joiner Discerner.

Identyfikator Joiner ID jest też używany jako rozszerzony adres IEEE 802.15.4 urządzenia podczas procesu wdrażania.

Parametry

Brak parametrów.

Przykłady

joiner id
d65e64fa83f81cf7
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

początek złączania

Włącza rolę Łączący wątki.

Parametry

joiner start joining-device-credential [provisioning-url]
  • joining-device-credential: hasło łączące. Musi być ciągiem zawierającym wszystkie wielkie znaki alfanumeryczne (0–9 i A–Y, z wyłączeniem I, O, Q i Z, aby ułatwić czytanie), o długości od 6 do 32 znaków.
  • provisioning-url: adres URL obsługi administracyjnej dla Joiner (opcjonalnie).

Przykłady

joiner start J01NM3
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

stan łączenia

Pobiera stan łączenia.

Zwraca jeden z tych stanów:

  • Idle
  • Discover
  • Connecting
  • Connected
  • Entrust
  • Joined

Parametry

Brak parametrów.

Przykłady

joiner state
Idle
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

wyłącznik

Wyłącza rolę Łączący wątki.

Parametry

Brak parametrów.

Przykłady

joiner stop
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Joinerport (set)

Ustawia port UDP Joiner.

Parametry

joinerport udp-port

Przykłady

joinerport 1000
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Joinerport

Pobiera port UDP Joiner.

Parametry

Brak parametrów.

Przykłady

joinerport
1000
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

licznik sekwencji kluczy (zestaw)

Ustawia thrKeySequenceCounter.

Parametry

keysequence counter counter

Przykłady

keysequence counter 10
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

licznik sekwencji kluczy

Pobiera thrKeySequenceCounter.

Parametry

Brak parametrów.

Przykłady

keysequence counter
10
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

czas ochrony sekwencji kluczy (ustawiony)

Ustawia thrKeySwitchGuardTime (w godzinach).

Parametry

keysequence guardtime guardtime-hours

Użyj wartości 0 do Thread Key Switch natychmiast, jeśli istnieje dopasowanie klucza do indeksu.

Przykłady

keysequence guardtime 0
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

czas ochrony sekwencji kluczy

Pobiera thrKeySwitchGuardTime (w godzinach).

Parametry

Brak parametrów.

Przykłady

keysequence guardtime
0
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

dane liderów

Pobiera dane lidera wątku.

Parametry

Brak parametrów.

Przykłady

leaderdata
Partition ID: 1077744240
Weighting: 64
Data Version: 109
Stable Data Version: 211
Leader Router ID: 60
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

leaderweight (set)

Określa wagę lidera wątku używaną podczas pracy w roli lidera.

Bezpośrednio ustawia nową wartość wagi repliki wiodącej, zastępując jej poprzednią wartość (która mogła zostać określona na podstawie bieżącej wartości otDeviceProperties ).

Parametry

leaderweight weight

Przykłady

leaderweight 128
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

waga lidera

Pobiera wagę lidera wątku używaną podczas działania w roli lidera.

Parametry

Brak parametrów.

Przykłady

leaderweight
128
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

linkmetrics mgmt rozszerzone potwierdzenia z funkcją usuwania

Wysyła żądanie zarządzania wskaźnikami połączeń w celu wyczyszczenia ulepszonego sondowania opartego na potwierdzeniu.

Parametry

linkmetrics mgmt peer-ipaddr enhanced-ack clear

Wartość peer-ipaddr powinna być adresem połączenia lokalnego sąsiadującego urządzenia.

Przykłady

linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack clear
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success

Dokumentacja interfejsu wiersza poleceń i interfejsu API

rejestr rozszerzonego potwierdzenia linkmetrics mgmt

Wysyła żądanie zarządzania wskaźnikami połączeń w celu zarejestrowania ulepszonego sondowania opartego na potwierdzeniu.

Parametry

linkmetrics mgmt peer-ipaddr enhanced-ack register [qmr][r]

[q, m i r] są mapowane na otLinkMetricsValues. Zgodnie ze specyfikacją 4.11.3.4.4.6 możesz używać maksymalnie 2 opcji jednocześnie, na przykład q lub qm.

  • q: warstwa 2 LQI.
  • m: marża linku.
  • r: RSSI.
Dodatkowa wartość r jest opcjonalna i używana tylko w przypadku urządzeń referencyjnych. Jeśli ta opcja jest określona, wartości typu/średnie wartości poszczególnych flag identyfikatora typu są zarezerwowane. Pozwala ona sprawdzić, czy podmiot sondowania prawidłowo obsługuje nieprawidłowe flagi typu identyfikatora i jest dostępna tylko wtedy, gdy włączona jest zasada OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

Przykłady

linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
> linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm r
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Cannot support new series

Dokumentacja interfejsu wiersza poleceń i interfejsu API

przekazywana dalej funkcja linkmetrics

Wysyła żądanie zarządzania wskaźnikami linków MLE w celu skonfigurowania lub usunięcia serii śledzenia.

Parametry

linkmetrics mgmt peer-ipaddr forward series-id [ldraX][pqmr]
  • peer-ipaddr: adres peera.
  • series-id: identyfikator serii.
  • [l, d, r i a] są mapowane na otLinkMetricsSeriesFlags. X nie reprezentuje żadnej z tych wartości (otLinkMetricsSeriesFlags), zatrzymuje księgowanie i usuwa serię.
    • l: sonda połączenia MLE.
    • d: dane MAC.
    • r: żądanie danych MAC.
    • a: potwierdzenie MAC.
    • X: można używać tylko bez innych flag.
  • [p, q, m i r] są mapowane na otLinkMetricsValues.
    • p: liczba otrzymanych jednostek PDU w warstwie 2.
    • q: warstwa 2 LQI.
    • m: marża linku.
    • r: RSSI.

Przykłady

linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 forward 1 dra pqmr
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: SUCCESS

Dokumentacja interfejsu wiersza poleceń i interfejsu API

sonda linkmetrics

Wysyła wiadomość MLE Link Probe.

Parametry

linkmetrics probe peer-ipaddr series-id length
  • peer-ipaddr: adres peera.
  • series-id: identyfikator serii, na którą kierowana jest wiadomość sondy.
  • length: długość wiadomości sondy. Prawidłowy zakres to [0, 64].

Przykłady

linkmetrics probe fe80:0:0:0:3092:f334:1455:1ad2 1 10
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

przekierowanie zapytania linkmetrics

Wykonywanie zapytania o dane o linkach (seria śledzenia z wyprzedzeniem).

Parametry

linkmetrics query peer-ipaddr forward series-id
  • peer-ipaddr: adres peera.
  • series-id: identyfikator serii.

Przykłady

linkmetrics query fe80:0:0:0:3092:f334:1455:1ad2 forward 1
Done
> Received Link Metrics Report from: fe80:0:0:0:3092:f334:1455:1ad2
- PDU Counter: 2 (Count/Summation)
- LQI: 76 (Exponential Moving Average)
- Margin: 82 (dB) (Exponential Moving Average)
- RSSI: -18 (dBm) (Exponential Moving Average)

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zapytanie linkmetrics pojedyncze

Wykonaj zapytanie o dane połączenia (pojedyncza sonda).

Parametry

linkmetrics query peer-ipaddr single [pqmr]
  • peer-ipaddr: adres peera.
  • [p, q, m i r] mapuje się na otLinkMetrics.
    • p: liczba otrzymanych jednostek PDU w warstwie 2.
    • q: warstwa 2 LQI.
    • m: marża linku.
    • r: RSSI.

Przykłady

linkmetrics query fe80:0:0:0:3092:f334:1455:1ad2 single qmr
Done
> Received Link Metrics Report from: fe80:0:0:0:3092:f334:1455:1ad2
- LQI: 76 (Exponential Moving Average)
- Margin: 82 (dB) (Exponential Moving Average)
- RSSI: -18 (dBm) (Exponential Moving Average)

Dokumentacja interfejsu wiersza poleceń i interfejsu API

linkmetricsmgr (włącz,wyłącz)

Włącz lub wyłącz menedżera wskaźników połączeń.

Parametry

linkmetricsmgr enable|disable

Przykłady

linkmetricmgr enable
Done
linkmetricmgr disable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

program linkmetricsmgr

Pobieranie danych wskaźników linków dotyczących sąsiada za pomocą jego rozszerzonego adresu.

Parametry

Brak parametrów.

Przykłady

linkmetricsmgr show
ExtAddr:827aa7f7f63e1234, LinkMargin:80, Rssi:-20
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zlokalizuj (ustaw)

Znajdź najbliższy punkt docelowy adresu anycast (na przykład znajdź lokalny EID i RLOC16 sieci miejsca docelowego).

Najbliższe miejsce docelowe jest określane na podstawie bieżącej tabeli routingu i kosztów ścieżek w siatce wątków.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE.

Parametry

locate anycastaddr

Przykłady

locate fdde:ad00:beef:0:0:ff:fe00:fc00
fdde:ad00:beef:0:d9d3:9000:16b:d03b 0xc800
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Zlokalizuj

Pobiera bieżący stan (In Progress lub Idle) lokalizatora Anycast.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE.

Parametry

Brak parametrów.

Przykłady

locate
Idle
Done
locate fdde:ad00:beef:0:0:ff:fe00:fc10
locate
In Progress
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

nazwa pliku dziennika

Określa nazwę pliku do przechwytywania wiadomości otPlatLog() , co jest przydatne przy debugowaniu automatycznych skryptów testowych w systemie Linux, gdy logowanie zakłóca działanie automatycznych skryptów testowych.

Wymaga OPENTHREAD_CONFIG_LOG_OUTPUT == OPENTHREAD_CONFIG_LOG_OUTPUT_DEBUG_UART i OPENTHREAD_POSIX.

Parametry

log filename filename

Przykłady

Dokumentacja interfejsu wiersza poleceń i interfejsu API

log level (set) (poziom logowania)

Ustawia poziom rejestrowania.

Parametry

log level level

Przykłady

log level 4
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

poziom logowania

Uzyskiwanie poziomu rejestrowania.

Parametry

Brak parametrów.

Przykłady

log level
1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Mac ponawia próbę połączenia (get,set)

Pobiera lub ustawia liczbę bezpośrednich ponownych prób TX w warstwie MAC.

Parametry

mac retries direct [number]

Opcjonalny argument number służy do ustawiania liczby bezpośrednich ponownych prób nawiązania połączenia TX.

Przykłady

mac retries direct
3
Done
mac retries direct 5
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

MAC ponawia próby pośrednie (get,set)

Pobiera lub ustawia liczbę pośrednich ponownych prób TX w warstwie MAC.

Parametry

mac retries indirect [number]

Użyj opcjonalnego argumentu number, aby ustawić liczbę pośrednich ponownych prób Tx.

Przykłady

mac retries indirect
3
Done
 max retries indirect 5
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

wysyłanie MAC

Instruuje urządzenie z Rx-Off-When-Idle, aby wysłało ramkę MAC do swojego urządzenia nadrzędnego. To polecenie służy do certyfikacji i można go używać tylko wtedy, gdy włączony jest interfejs OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

Parametry

mac send datarequest | emptydata

Musisz wybrać jeden z tych 2 argumentów:

  • datarequest: dodaje do kolejki wiadomość z żądaniem danych IEEE 802.15.4.
  • emptydata: powoduje, że urządzenie wysyła pustą ramkę danych IEEE 802.15.4.

Przykłady

mac send datarequest
Done
mac send emptydata
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

dodawanie dodawania filtra macfilter

Jest dostępna tylko wtedy, gdy włączona jest konfiguracja OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.

Dodaje rozszerzony adres IEEE 802.15.4 do listy filtra MAC. Określenie opcjonalnego argumentu rss poprawia siłę sygnału odbieranego przez wiadomości z tego adresu. Jeśli nie użyjesz opcji rss, adres będzie miał ustawioną wartość domyślną. Jeśli nie określisz wartości domyślnej, siłą sygnału będzie sygnał bezprzewodowy.

Parametry

macfilter addr add extaddr [rss]

Przykłady

macfilter addr add 0f6127e33af6b403 -95
Done
macfilter addr add 0f6127e33af6b402
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

lista dozwolonych dozwolonych adresów MACfilter

Włącza tryb filtra MAC allowlist, co oznacza, że dostęp tylko do adresów MAC z listy filtra MAC będzie możliwy.

Parametry

Brak parametrów.

Przykłady

macfilter addr allowlist
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

polecenie macfilter wyczyść

Jest dostępna, gdy włączona jest konfiguracja OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.

To polecenie usuwa wszystkie rozszerzone adresy z listy filtrów MAC.

Parametry

Brak parametrów.

Przykłady

macfilter addr clear
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

lista odrzuconych Addr MACfilter

Włącza tryb filtra MAC denylist, co oznacza, że wszystkie adresy MAC na liście filtra MAC nie będą miały dostępu do danych.

Parametry

Brak parametrów.

Przykłady

macfilter addr denylist
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

wyłączenie dodawania filtra macfilter

Wyłącza tryby filtra adresów MAC.

Parametry

Brak parametrów.

Przykłady

macfilter addr disable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

dodatek MACfilter

Jest dostępna, gdy włączona jest konfiguracja OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.

Zawiera te informacje:

  • Bieżący tryb listy filtrów MAC: AllowList, DenyList, lub Disabled
  • Lista wszystkich rozszerzonych adresów w filtrze. Siła odbieranego sygnału (rss) i wskaźnik jakości linku (lqi) wyświetlają się obok adresu, jeśli ich wartości zostały ustawione inaczej.

Parametry

Brak parametrów.

Przykłady

macfilter addr
Allowlist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

usunięcie dodawania filtra macfilter

Jest dostępna, gdy włączona jest konfiguracja OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.

To polecenie usuwa określony adres rozszerzony z listy filtra adresów MAC.

Parametry

macfilter addr remove extaddr

Przykłady

macfilter addr remove 0f6127e33af6b402
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Macfilter

Zawiera te informacje:

  • Address Mode: bieżący tryb filtra MAC: AllowList, DenyList, lub Disabled
  • Lista wszystkich rozszerzonych adresów na liście filtra MAC. Siła odbieranego sygnału (rss) i wskaźnik jakości linku (lqi) wyświetlają się obok adresu, jeśli ich wartości zostały ustawione inaczej.
  • Osobna lista (RssIn List) zawierająca wszystkie rozszerzone adresy, w przypadku których rss ustawiono na inną wartość niż domyślna.
  • Default rss: pokazuje wartości domyślne ustawień rss i lqi (w stosownych przypadkach).

Parametry

Brak parametrów.

Przykłady

macfilter
Address Mode: Allowlist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
RssIn List:
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

dodanie rss macfilter

Dodaje określony adres rozszerzony do listy RssIn (lub modyfikuje istniejący adres na liście RssIn) i ustawia pozycję siły odbieranego sygnału (w dBm) dla wiadomości pochodzących z tego adresu.

Parametry

macfilter rss add extaddr rss

Aby ustawić domyślną wartość siły odbieranego sygnału dla wszystkich otrzymywanych wiadomości, użyj funkcji * jako argumentu extaddr.

Przykłady

macfilter rss add * -50
Done
macfilter rss add 0f6127e33af6b404 -85
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Macfilter rss add-lqi

Dodaje określony rozszerzony adres do listy RssIn (lub modyfikuje istniejący adres na liście RssIn) i ustawia wskaźnik jakości stałego linku dla wiadomości z tego adresu. Rozszerzony adres nie musi znajdować się w filtrze address allowlist/denylist, aby ustawić lqi.

Ta funkcja jest dostępna, gdy włączona jest konfiguracja OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.

Parametry

macfilter rss add-lqi extaddr lqi

Aby ustawić domyślną wartość wskaźnika jakości linku dla wszystkich otrzymywanych wiadomości, użyj * jako argumentu extaddr. Dozwolony zakres to 0–3.

Przykłady

macfilter rss add-lqi * 3
Done
macfilter rss add-lqi 0f6127e33af6b404 2
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Czyszczenie plików rss Macfilter

Usuwa wszystkie wpisy dotyczące siły odbieranego sygnału (rss) i wskaźnika jakości linku (lqi) (w tym wartości domyślnych) z listy RssIn.

Spowoduje to, że wszystkie rozszerzone adresy będą używać sygnału naziemnego.

Jest dostępna, gdy włączona jest konfiguracja OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.

Parametry

Brak parametrów.

Przykłady

macfilter rss clear
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Macfilter rss

Zawiera te informacje:

  • Lista wszystkich rozszerzonych adresów, w przypadku których siła odbieranego sygnału (rss) jest inna niż wartość domyślna. Wyświetla się też wskaźnik jakości linku (lqi). Ustawienia rss i lqi są mapowane na siebie. Jeśli ustawisz jedną z opcji, wartość drugiego zostanie ustawiona automatycznie. Ta lista adresów nosi nazwę RssIn List. Ustawienie rsi lub lqi powoduje dodanie odpowiedniego rozszerzonego adresu do listy RssIn.
  • Default rss: pokazuje wartości domyślne ustawień rss i lqi (w stosownych przypadkach).

Parametry

Brak parametrów.

Przykłady

macfilter rss
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

macfilter rss – usunięcie

Usuwa określony adres rozszerzony z listy RssIn.

Po usunięciu z listy RssIn ten adres MAC będzie używać domyślnych ustawień rss i lqi (przy założeniu, że zostały ustawione wartości domyślne). (Jeśli nie zostały ustawione żadne wartości domyślne, używany jest sygnał bezprzewodowy).

Jest dostępna, gdy włączona jest konfiguracja OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.

Jeśli na liście RssIn nie ma wpisu pasującego do podanego adresu rozszerzonego, nie zostanie wykonane żadne działanie.

Parametry

macfilter rss remove extaddr

Jeśli chcesz usunąć domyślne ustawienia siły odbieranego sygnału i wskaźnika jakości linku, użyj * jako uprawnienia extaddr. Spowoduje to ustawienie wartości domyślnych, ale nie usunie wpisów z listy RssIn.

Przykłady

macfilter rss remove *
Done
macfilter rss remove 0f6127e33af6b404
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

meshdiagchildip6,

Wyślij zapytanie do elementu nadrzędnego, aby pobrać adresy IPv6 wszystkich jego elementów podrzędnych MTD.

Parametry

meshdiag childip6 parent-rloc16

Przykłady

meshdiag childip6 0xdc00
child-rloc16: 0xdc02
    fdde:ad00:beef:0:ded8:cd58:b73:2c21
    fd00:2:0:0:c24a:456:3b6b:c597
    fd00:1:0:0:120b:95fe:3ecc:d238
child-rloc16: 0xdc03
    fdde:ad00:beef:0:3aa6:b8bf:e7d6:eefe
    fd00:2:0:0:8ff8:a188:7436:6720
    fd00:1:0:0:1fcf:5495:790a:370f
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

meshdiag – plik podrzędny

Rozpocznij zapytanie o tabelę podrzędną routera o określonej wartości RLOC16. Dane wyjściowe zawierają wszystkie wpisy podrzędne. Informacje dla każdego dziecka:

  • RLOC16
  • Rozszerzony adres MAC
  • Wersja wątku
  • Limit czasu (w sekundach)
  • Wiek (w sekundach od ostatniego wykrycia)
  • Odstęp czasu nadzoru (w sekundach)
  • Liczba wiadomości w kolejce (jeśli wydawca podrzędny jest śpiący)
  • Tryb urządzenia
  • RSS (średnia i ostatnia)
  • Odsetek błędów: ramka tx (w warstwie MAC), tx wiadomości IPv6 (powyżej MAC)
  • Czas połączenia (w sekundach od utworzenia linku do formatu {dd}d.{hh}:{mm}:{ss})
  • Informacje o CSL:
    • Jeśli zsynchronizowano
    • Okres (w jednostce czasu 10 symboli)
    • Limit czasu (w sekundach)

Parametry

Brak parametrów.

Przykłady

meshdiag childtable 0x6400
rloc16:0x6402 ext-addr:8e6f4d323bbed1fe ver:4
    timeout:120 age:36 supvn:129 q-msg:0
    rx-on:yes type:ftd full-net:yes
    rss - ave:-20 last:-20 margin:80
    err-rate - frame:11.51% msg:0.76%
    conn-time:00:11:07
    csl - sync:no period:0 timeout:0 channel:0
rloc16:0x6403 ext-addr:ee24e64ecf8c079a ver:4
    timeout:120 age:19 supvn:129 q-msg:0
    rx-on:no type:mtd full-net:no
    rss - ave:-20 last:-20  margin:80
    err-rate - frame:0.73% msg:0.00%
    conn-time:01:08:53
    csl - sync:no period:0 timeout:0 channel:0
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

sieć meshdiag i router sąsiadujący

Rozpocznij zapytanie dotyczące tabeli sąsiadów routera o podanej wartości RLOC16. Dane wyjściowe zawierają wszystkie wpisy sąsiada routera. Informacje dla każdego wpisu:

  • RLOC16
  • Rozszerzony adres MAC
  • Wersja wątku
  • RSS (średni i ostatni) oraz marża linku
  • Odsetek błędów, liczba klatek tx (w warstwie MAC), tx wiadomości IPv6 (powyżej MAC)
  • Czas połączenia (w sekundach od utworzenia linku do formatu {dd}d.{hh}:{mm}:{ss})

Parametry

meshdiag routerneighbortable router-rloc16

Przykłady

meshdiag routerneighbortable 0x7400
rloc16:0x9c00 ext-addr:764788cf6e57a4d2 ver:4
   rss - ave:-20 last:-20 margin:80
   err-rate - frame:1.38% msg:0.00%
   conn-time:01:54:02
rloc16:0x7c00 ext-addr:4ed24fceec9bf6d3 ver:4
   rss - ave:-20 last:-20 margin:80
   err-rate - frame:0.72% msg:0.00%
   conn-time:00:11:27
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

topologia meshdiag

Poznaj topologię sieci (listę routerów i ich połączeń). Parametry są opcjonalne i wskazują dodatkowe elementy do wykrycia. Można je dodawać w dowolnej kolejności.

  • ip6-addrs, aby wykryć listę adresów IPv6 każdego routera.
  • children, aby wykryć tabelę podrzędną każdego routera.

Informacje o routerze:

  • Identyfikator routera
  • RLOC16
  • Rozszerzony adres MAC
  • Wersja wątku (jeśli jest znana)
  • Określa, czy router to samo urządzenie (me)
  • Określa, czy router jest nadrzędnym wobec tego urządzenia, gdy jest ono kontem podrzędnym (parent)
  • Określa, czy router jest leader
  • Określa, czy router działa jako router graniczny zapewniający połączenia zewnętrzne (br).
  • Lista routerów, do których ten router ma link:
    • 3-links: identyfikatory routerów, do których ten router ma połączenie przychodzące o jakości 3
    • 2-links: identyfikatory routerów, do których ten router ma połączenie przychodzące o jakości 2.
    • 1-links: identyfikatory routerów, do których ten router ma połączenie przychodzące o jakości 1
    • Jeśli lista jest pusta, jest pomijana na zewnątrz.
  • Jeśli ip6-addrs, lista adresów IPv6 routera
  • Jeśli children, lista wszystkich elementów podrzędnych routera. Informacje dla każdego dziecka:
    • RLOC16
    • Jakość linku przychodzącego z perspektywy elementu nadrzędnego i podrzędnego (zero oznacza nieznane)
    • Tryb urządzenia podrzędnego (r rx-on-when-idle, d urządzenie z całym wątkiem, n pełne dane sieciowe, - bez ustawionych flag)
    • Określa, czy dziecko jest tym urządzeniem (me)
    • Określa, czy urządzenie podrzędne działa jako router graniczny zapewniający połączenia zewnętrzne (br).

Parametry

meshdiag topology [ip6-addrs] [children]

Przykłady

meshdiag topology
id:02 rloc16:0x0800 ext-addr:8aa57d2c603fe16c ver:4 - me - leader
   3-links:{ 46 }
id:46 rloc16:0xb800 ext-addr:fe109d277e0175cc ver:4
   3-links:{ 02 51 57 }
id:33 rloc16:0x8400 ext-addr:d2e511a146b9e54d ver:4
   3-links:{ 51 57 }
id:51 rloc16:0xcc00 ext-addr:9aab43ababf05352 ver:4
   3-links:{ 33 57 }
   2-links:{ 46 }
id:57 rloc16:0xe400 ext-addr:dae9c4c0e9da55ff ver:4
   3-links:{ 46 51 }
   1-links:{ 33 }
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Mleadvimax

Pobiera bieżącą maksymalną wartość interwału używaną przez licznik czasu przepływu reklamy.

Ten interfejs API wymaga OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE i jest przeznaczony wyłącznie do testów.

Parametry

Brak parametrów.

Przykłady

mleadvimax
12000
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

mliid

Ustawia lokalny identyfikator IID sieci typu mesh (do celów testowych).

Wymaga OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

Musisz go użyć przed włączeniem stosu wątków.

Tylko do testowania lub urządzenia referencyjnego.

Parametry

mliid iid

Przykłady

mliid 1122334455667788
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

mlr reg

Rejestruje detektory multiemisji w głównym routerze szkieletowym.

Opcje OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE i OPENTHREAD_CONFIG_COMMISSIONER_ENABLE muszą być włączone.

Pomiń czas oczekiwania, aby użyć domyślnego limitu czasu MLR w głównym routerze szkieletowym.

Aby usunąć detektory multiemisji, użyj limitu czasu = 0.

Parametry

mlr reg ipaddr [timeout]

Przykłady

mlr reg ff04::1
status 0, 0 failed
Done
mlr reg ff04::1 ff04::2 ff02::1
status 2, 1 failed
ff02:0:0:0:0:0:0:1
Done
mlr reg ff04::1 ff04::2 1000
status 0, 0 failed
Done
mlr reg ff04::1 ff04::2 0
status 0, 0 failed
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

tryb (get,set)

Ustaw konfigurację trybu linku MLE.

Parametry

mode [rdn]
  • -: brak ustawionych flag (rx-off- Gdy-nieaktywny, minimalna liczba urządzeń Thread, stabilne dane sieciowe)
  • r: rx-on-Kiedy-nieaktywny
  • d: urządzenie z całym wątkiem
  • n: pełne dane sieci

Przykłady

mode rdn
Done
mode -
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Multiradio

Sprawdź listę obsługiwanych linków radiowych na urządzeniu.

To polecenie jest zawsze dostępne, nawet jeśli urządzenie obsługuje tylko jedno radio.

Parametry

Brak parametrów.

Przykłady

multiradio
[15.4, TREL]
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

lista sąsiadów z wieloma radioami

Pobiera informacje o wielu łączach radiowych powiązane z sąsiadem o danym rozszerzonym adresie.

Opcja OPENTHREAD_CONFIG_MULTI_RADIO musi być włączona.

Parametry

Brak parametrów.

Przykłady

multiradio neighbor list
ExtAddr:3a65bc38dbe4a5be, RLOC16:0xcc00, Radios:[15.4(255), TREL(255)]
ExtAddr:17df23452ee4a4be, RLOC16:0x1300, Radios:[15.4(255)]
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

multiradio sąsiad

Pobiera informacje o wielu łączach radiowych powiązane z sąsiadem o danym rozszerzonym adresie.

Opcja OPENTHREAD_CONFIG_MULTI_RADIO musi być włączona.

Parametry

multiradio neighbor ext-address

Przykłady

multiradio neighbor 3a65bc38dbe4a5be
[15.4(255), TREL(255)]
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

nat64 (włącz,wyłącz)

Włącz lub wyłącz funkcje NAT64.

Gdy zasada OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE jest włączona, wyłączenie tej opcji powoduje zresetowanie tabeli mapowania w tłumaczu.

Dostępne, gdy włączone są OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE lub OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE.

Parametry

nat64 enable|disable

Przykłady

nat64 enable
Done
nat64 disable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

NAT64 IDR

Parametry

Brak parametrów.

Przykłady

nat64 cidr 192.168.255.0/24
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

NAT64 IDR

Pobiera CIDR IPv4 skonfigurowany w tłumaczeniu NAT64.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE.

Parametry

Brak parametrów.

Przykłady

nat64 cidr
192.168.255.0/24
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

liczniki NAT64

Pobiera liczniki pakietów i błędów translatora NAT64.

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE.

Parametry

Brak parametrów.

Przykłady

nat64 counters
|               | 4 to 6                  | 6 to 4                  |
+---------------+-------------------------+-------------------------+
| Protocol      | Pkts     | Bytes        | Pkts     | Bytes        |
+---------------+----------+--------------+----------+--------------+
|         Total |       11 |          704 |       11 |          704 |
|           TCP |        0 |            0 |        0 |            0 |
|           UDP |        0 |            0 |        0 |            0 |
|          ICMP |       11 |          704 |       11 |          704 |
| Errors        | Pkts                    | Pkts                    |
+---------------+-------------------------+-------------------------+
|         Total |                       8 |                       4 |
|   Illegal Pkt |                       0 |                       0 |
|   Unsup Proto |                       0 |                       0 |
|    No Mapping |                       2 |                       0 |
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

mapowania NAT64

Pobiera następne informacje dotyczące mapowania adresu (przy użyciu iteratora).

Dostępne, gdy włączona jest funkcja OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE.

Parametry

Brak parametrów.

Przykłady

nat64 mappings
|          | Address                   |        | 4 to 6       | 6 to 4       |
+----------+---------------------------+--------+--------------+--------------+
| ID       | IPv6       | IPv4         | Expiry | Pkts | Bytes | Pkts | Bytes |
+----------+------------+--------------+--------+------+-------+------+-------+
| 00021cb9 | fdc7::df79 | 192.168.64.2 |  7196s |    6 |   456 |   11 |  1928 |
|          |                                TCP |    0 |     0 |    0 |     0 |
|          |                                UDP |    1 |   136 |   16 |  1608 |
|          |                               ICMP |    5 |   320 |    5 |   320 |

Dokumentacja interfejsu wiersza poleceń i interfejsu API

stan NAT64

Pobiera stan funkcji NAT64.

Stan PrefixManager jest dostępny, gdy włączona jest zasada OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE. Stan Translator jest dostępny, gdy włączona jest zasada OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE.

Gdy zasada OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE jest włączona, PrefixManager zwraca jeden z tych stanów:

  • Disabled: menedżer prefiksów NAT64 jest wyłączony.
  • NotRunning: menedżer prefiksów NAT64 jest włączony, ale nie działa. Może to oznaczać, że menedżer routingu jest wyłączony.
  • Idle: menedżer prefiksów NAT64 jest włączony i działa, ale nie publikuje prefiksu NAT64. Może się tak zdarzyć, gdy inny router graniczny publikuje prefiks NAT64 o wyższym priorytecie.
  • Active: menedżer prefiksów NAT64 jest włączony, uruchomiony i publikuje prefiks NAT64.

Gdy zasada OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE jest włączona, Translator zwraca jeden z tych stanów:

  • Disabled: tłumacz NAT64 jest wyłączony.
  • NotRunning: tłumacz NAT64 jest włączony, ale nie tłumaczy pakietów. Może to oznaczać, że tłumacz nie jest skonfigurowany z prefiksem NAT64 lub CIDR dla NAT64.
  • Active: tłumacz NAT64 jest włączony i tłumaczy pakiety.

Parametry

Brak parametrów.

Przykłady

nat64 state
PrefixManager: Active
Translator: Active
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

lista Conntime sąsiadów

Drukuje czas połączenia i wiek sąsiadów. To polecenie jest podobne do polecenia neighbor conntime, ale wyświetla informacje w formacie listy. Wiek i czas połączenia są wyświetlane w sekundach.

Parametry

Brak parametrów.

Przykłady

neighbor conntime list
0x8401 1a28be396a14a318 age:63 conn-time:644
0x5c00 723ebf0d9eba3264 age:23 conn-time:852
0xe800 ce53628a1e3f5b3c age:23 conn-time:180
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Sąsiad Conntime

Drukuje czas połączenia i wiek sąsiadów. Informacje o sąsiadach:

  • RLOC16
  • Rozszerzony adres MAC
  • Ostatnie usłyszenie (wiek): liczba sekund od ostatniego słuchania od sąsiada.
  • Czas połączenia: liczba sekund od utworzenia połączenia z sąsiadem. Jeśli czas trwania jest krótszy niż 1 dzień, przedziały czasu trwania są sformatowane jako {hh}:{mm}:{ss} dla godzin, minut i sekund. Jeśli czas trwania jest dłuższy niż 1 dzień, użyj formatu {dd}d.{hh}:{mm}:{ss}.

Parametry

Brak parametrów.

Przykłady

neighbor conntime
| RLOC16 | Extended MAC     | Last Heard (Age) | Connection Time  |
+--------+------------------+------------------+------------------+
| 0x8401 | 1a28be396a14a318 |         00:00:13 |         00:07:59 |
| 0x5c00 | 723ebf0d9eba3264 |         00:00:03 |         00:11:27 |
| 0xe800 | ce53628a1e3f5b3c |         00:00:02 |         00:00:15 |
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

jakość linków sąsiadów

Drukuje informacje o jakości linków dotyczące wszystkich sąsiadów.

Parametry

Brak parametrów.

Przykłady

neighbor linkquality
| RLOC16 | Extended MAC     | Frame Error | Msg Error | Avg RSS | Last RSS | Age   |
+--------+------------------+-------------+-----------+---------+----------+-------+
| 0xe800 | 9e2fa4e1b84f92db |      0.00 % |    0.00 % |     -46 |      -48 |     1 |
| 0xc001 | 0ad7ed6beaa6016d |      4.67 % |    0.08 % |     -68 |      -72 |    10 |
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

lista sąsiadów

Wyświetla listę RLOC16 każdego sąsiada.

Parametry

Brak parametrów.

Przykłady

neighbor list
0xcc01 0xc800 0xf000
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

tabela sąsiadów

Drukuje informacje o wszystkich sąsiadach w formacie tabeli.

W przypadku metody Role jedynymi możliwymi wartościami dla tej tabeli są C (podrzędny) i R (router).

Te kolumny zawierają informacje o trybie urządzenia sąsiadów. Każda kolumna ma wartość 0 (wyłączona) lub 1 (wł.).

  • R: odbiór w przypadku bezczynności
  • D: urządzenie z pełną obsługą typu Full Thread
  • N: pełne dane sieci

Parametry

Brak parametrów.

Przykłady

neighbor table
| Role | RLOC16 | Age | Avg RSSI | Last RSSI |R|D|N| Extended MAC     |
+------+--------+-----+----------+-----------+-+-+-+------------------+
|   C  | 0xcc01 |  96 |      -46 |       -46 |1|1|1| 1eb9ba8a6522636b |
|   R  | 0xc800 |   2 |      -29 |       -29 |1|1|1| 9a91556102c39ddb |
|   R  | 0xf000 |   3 |      -28 |       -28 |1|1|1| 0ad7ed6beaa6016d |
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

netdata pełna

Wydrukuj wartość „yes” (tak) lub „no” wskazującą, czy wywołanie zwrotne „net data full” zostało wykonane od rozpoczęcia operacji w Thread lub od ostatniego użycia flagi netdata full reset. To polecenie wymaga OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL. Wywołanie zwrotne „net data full” jest wywoływane za każdym razem, gdy:

  • Urządzenie działa jako urządzenie wiodące i otrzymuje od routera granicznego (BRA) rejestrację danych sieciowych, której nie można dodać do danych sieciowych (brak miejsca).
  • Urządzenie działa jako BR i nie można dodawać nowych wpisów do danych lokalnej sieci.
  • Urządzenie działa jako BR i próbuje zarejestrować lokalne dane sieci w elemencie wiodącym, ale stwierdza, że jego wpisy lokalne nie pasują.

Parametry

Brak parametrów.

Przykłady

netdata full
no
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Pełny reset netdata

Zresetuj flagę śledzenia, czy wywołano wywołanie zwrotne „net data full” (pełne dane netto).

Parametry

Brak parametrów.

Przykłady

netdata full reset
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

długość danych netto

Pobierz bieżącą długość (liczbę bajtów) danych sieciowych w wątku partycji.

Parametry

Brak parametrów.

Przykłady

netdata length
23
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

maksymalna długość danych netto

Uzyskaj maksymalną zaobserwowaną długość danych sieci typu Thread od zainicjowania stosu OT lub od ostatniego wywołania otNetDataResetMaxLength() .

Parametry

Brak parametrów.

Przykłady

netdata maxlength
40
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

resetowanie maksymalnej długości danych sieciowych

Zresetuj śledzoną maksymalną długość danych sieci Thread.

Parametry

Brak parametrów.

Przykłady

netdata maxlength reset
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

netdata publish dnssrp anycast

Publikuje adres Anycast usługi DNS/SRP z numerem sekwencyjnym. Każdy bieżący wpis usługi DNS/SRP opublikowany z poprzedniego polecenia publish dnssrp{anycast|unicast} zostanie usunięty i zastąpiony nowymi argumentami.

Opcja OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE musi być włączona.

Parametry

netdata publish dnssrp anycast seq-num

Przykłady

netdata publish dnssrp anycast 1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

netdata publish dnssrp unicast (addr,port)

Publikuje adres Unicast usługi DNS/SRP z adresem i numerem portu. Informacje o adresie i porcie są zawarte w danych TLV usługi. Każdy bieżący wpis usługi DNS/SRP opublikowany z poprzedniego polecenia publish dnssrp{anycast|unicast} zostanie usunięty i zastąpiony nowymi argumentami.

Opcja OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE musi być włączona.

Parametry

netdata publish dnssrp unicast address port

Przykłady

netdata publish dnssrp unicast fd00::1234 51525
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

netdata publish dnssrp unicast (mle)

Publikuje lokalny identyfikator EID urządzenia typu mesh z numerem portu. Informacje o MLE i porcie są zawarte w danych TLV serwera. Aby użyć innego adresu Unicast, użyj polecenia netdata publish dnssrp unicast (addr,port).

Każdy bieżący wpis usługi DNS/SRP opublikowany z poprzedniego polecenia publish dnssrp{anycast|unicast} zostanie usunięty i zastąpiony nowymi argumentami.

Opcja OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE musi być włączona.

Parametry

netdata publish dnssrp unicast port

Przykłady

netdata publish dnssrp unicast 50152
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

prefiks publikacji netdata

Opublikuj wpis z prefiksem on-siatki. Więcej informacji znajdziesz w artykule na temat wyświetlania danych sieci i zarządzania nimi za pomocą interfejsu wiersza poleceń OT.

Parametry

netdata publish prefix prefix [padcrosnD] [high|med|low]

Interfejs wiersza poleceń OT korzysta z zmapowanych argumentów do konfigurowania wartości otBorderRouterConfig. Więcej informacji znajdziesz w omówieniu interfejsu wiersza poleceń OpenThread.

Przykłady

netdata publish prefix fd00:1234:5678::/64 paos med
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

netdatapublish – zastąpienie

Zastępuje wcześniej opublikowany wpis trasy zewnętrznej. Więcej informacji znajdziesz w artykule na temat wyświetlania danych sieci i zarządzania nimi za pomocą interfejsu wiersza poleceń OT.

Parametry

netdata publish replace oldprefix prefix [sn] [high|med|low]

Interfejs wiersza poleceń OT korzysta z zmapowanych argumentów do konfigurowania wartości otExternalRouteConfig. Więcej informacji znajdziesz w omówieniu interfejsu wiersza poleceń OpenThread.

Przykłady

netdata publish replace ::/0 fd00:1234:5678::/64 s high
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

trasa publikowania netdata

Opublikuj wpis trasy zewnętrznej. Więcej informacji znajdziesz w artykule na temat wyświetlania danych sieci i zarządzania nimi za pomocą interfejsu wiersza poleceń OT.

Parametry

publish route prefix [sn] [high|med|low]

Interfejs wiersza poleceń OT korzysta z zmapowanych argumentów do konfigurowania wartości otExternalRouteConfig. Więcej informacji znajdziesz w omówieniu interfejsu wiersza poleceń OpenThread.

Przykłady

netdata publish route fd00:1234:5678::/64 s high
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

netdata record

Zarejestruj skonfigurowane prefiksy, trasy i usługi za pomocą repliki wiodącej.

Interfejs wiersza poleceń OT sprawdza interfejs OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE. Jeśli tryb OTBR jest włączony, rejestruje dane dotyczące sieci lokalnej w elemencie Leader. W przeciwnym razie wywołuje funkcję interfejsu wiersza poleceń otServerRegister. Więcej informacji znajdziesz w artykule na temat wyświetlania danych sieci i zarządzania nimi za pomocą interfejsu wiersza poleceń OT.

Parametry

Brak parametrów.

Przykłady

netdata register
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

netdata steeringdata check (discerner)

Sprawdź, czy dane dotyczące kierowania zawierają element Joiner o podanej wartości wyróżniającej.

Parametry

netdata steeringdata check discerner
  • discerner: narzędzie do łączenia w formacie {number}/{length}.

Przykłady

netdata steeringdata check 0xabc/12
Done
netdata steeringdata check 0xdef/12
Error 23: NotFound

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Sprawdzanie danych sterowania netdata (eui64)

Sprawdź, czy dane kierowania zawierają Joiner.

Parametry

netdata steeringdata check eui64
  • eui64: IEEE EUI-64 firmy Joiner.

Przykłady

netdata steeringdata check d45e64fa83f81cf7
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

cofnięcie publikacji danych netto (prefiks)

Cofa opublikowanie wcześniej opublikowanego prefiksu trasy w siatce lub zewnętrznej trasy.

Opcja OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE musi być włączona.

Więcej informacji znajdziesz w artykule na temat wyświetlania danych sieci i zarządzania nimi za pomocą interfejsu wiersza poleceń OT.

Parametry

netdata unpublish prefix

Przykłady

netdata unpublish fd00:1234:5678::/64
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

netdata wycofanie publikacji dnssrp

Cofa publikację dowolnego dodanego wcześniej wpisu usługi DNS/SRP (Anycast lub Unicast) z danych sieci Thread.

Opcja OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE musi być włączona.

Parametry

Brak parametrów.

Przykłady

netdata unpublish dnssrp
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Netstat

Pobiera nagłówek połączonej listy gniazd UDP.

Parametry

Brak parametrów.

Przykłady

netstat
| Local Address                                   | Peer Address                                    |
+-------------------------------------------------+-------------------------------------------------+
| [0:0:0:0:0:0:0:0]:49153                         | [0:0:0:0:0:0:0:0]:0                             |
| [0:0:0:0:0:0:0:0]:49152                         | [0:0:0:0:0:0:0:0]:0                             |
| [0:0:0:0:0:0:0:0]:61631                         | [0:0:0:0:0:0:0:0]:0                             |
| [0:0:0:0:0:0:0:0]:19788                         | [0:0:0:0:0:0:0:0]:0                             |
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

diagnostyka sieci pobierz

Wysyła żądanie diagnostyczne dotyczące sieci w celu pobrania określonych wartości długości typu (TLV) dla określonych adresów.

Parametry

networkdiagnostic get addr type(s)

W przypadku addr adres jednostkowy wyzwala Diagnostic Get. Adres multiemisji aktywuje Diagnostic Query. Wartości TLV, które możesz określić (rozdzielone spacjami, jeśli określisz więcej niż jeden TLV):

  • 0: TLV rozszerzonego adresu MAC
  • 1: adres 16 TLV
  • 2: tryb TLV
  • 3: limit czasu TLV (maksymalny czas odpytywania w przypadku SED)
  • 4: TLV związany z łącznością
  • 5: TLV Route64
  • 6: TLV danych lidera
  • 7: TLV danych sieciowych
  • 8: TLV listy adresów IPv6
  • 9: TLV liczników MAC
  • 14: TLV poziomu baterii
  • 15: napięcie TLV zasilania
  • 16: TLV tabeli podrzędnej
  • 17: TLV stron kanału
  • 19: maksymalny czas oczekiwania użytkownika podrzędnego
  • 23: EUI64 TLV
  • 24: wersja TLV (numer wersji protokołów i funkcji)
  • 25: nazwa dostawcy TLV
  • 26: model TLV dostawcy
  • 27: wersja TLV dostawcy
  • 28: TLV wersji stosu wątków (identyfikator wersji jako ciąg UTF-8 dla bazy kodu/commitowania/wersji stosu Thread)
  • 29: TLV podrzędnego
  • 34: TLV liczników MLE
  • 35: URL dostawcy aplikacji (TLV)

Przykłady

networkdiagnostic get fdde:ad00:beef:0:0:ff:fe00:fc00 0 1 6 23
DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c000608640b0f674074c503
Ext Address: 0e336e1c41494e1c
Rloc16: 0x0c00
Leader Data:
    PartitionId: 0x640b0f67
    Weighting: 64
    DataVersion: 116
    StableDataVersion: 197
    LeaderRouterId: 0x03
EUI64: 18b4300000000004
Done
networkdiagnostic get ff02::1 0 1
DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c00
Ext Address: '0e336e1c41494e1c'
Rloc16: 0x0c00
Done
DIAG_GET.rsp/ans: 00083efcdb7e3f9eb0f201021800
Ext Address: 3efcdb7e3f9eb0f2
Rloc16: 0x1800
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

resetowanie diagnostyki sieci

Wysyła żądanie diagnostyczne dotyczące sieci w celu zresetowania określonych wartości długości typu (TLV) dla określonych adresów. To polecenie obsługuje tylko następujące wartości TLV: 9 (TLV liczników MLE) lub 34 (liczniki MLE TLV)

Parametry

networkdiagnostic reset addr type(s)

Przykłady

networkdiagnostic reset fd00:db8::ff:fe00:0 9
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Networkidtimeout (get,set)

Pobiera lub ustawia parametr NETWORK_ID_TIMEOUT.

Parametry

networkidtimeout [timeout]

Użyj opcjonalnego argumentu timeout, aby ustawić wartość parametru NETWORK_ID_TIMEOUT.

Przykłady

networkidtimeout 120
Done
networkidtimeout
120
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

klucz sieci (klucz)

Ustaw klucz sieciowy Thread.

Kończy się tylko wtedy, gdy protokoły Thread są wyłączone. Pomyślne wywołanie tej funkcji powoduje unieważnienie aktywnych i oczekujących zbiorów danych operacyjnych w pamięci nieulotnej.

Parametry

networkkey key

Przykłady

networkkey 00112233445566778899aabbccddeeff
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

klucz sieci

Uzyskiwanie klucza sieciowego Thread.

Parametry

Brak parametrów.

Przykłady

networkkey
00112233445566778899aabbccddeeff
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

nazwa sieci (nazwa)

Ustaw nazwę sieci Thread.

Kończy się tylko wtedy, gdy protokoły Thread są wyłączone. Pomyślne wywołanie tej funkcji powoduje unieważnienie aktywnych i oczekujących zbiorów danych operacyjnych w pamięci nieulotnej.

Parametry

networkname name

Przykłady

networkname OpenThread
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

nazwa sieci

Uzyskaj nazwę sieci Thread.

Parametry

Brak parametrów.

Przykłady

networkname
OpenThread
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

czas sieci (ustawiony)

Ustawia parametry synchronizacji czasu.

  • timesyncperiod: okres synchronizacji czasu w sekundach.
  • xtalthreshold: próg dokładności XTAL, od którego urządzenie może stać się urządzeniem obsługującym router (PPM).

Parametry

networktime timesyncperiod xtalthreshold

Przykłady

networktime 100 300
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

czas sieci

Pobiera czas sieci Thread i parametry synchronizacji czasu.

Parametry

Brak parametrów.

Przykłady

networktime
Network Time:     21084154us (synchronized)
Time Sync Period: 100s
XTAL Threshold:   300ppm
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

nexthop (pobieranie)

Pobiera koszt następnego przeskoku i ścieżki w kierunku danego miejsca docelowego RLOC16.

Można jej używać z atrybutem aNextHopRloc16 lub aPathCost o wartości NULL, co oznacza, że element wywołujący nie chce otrzymywać wartości.

Parametry

nexthop rloc16

Przykłady

nexthop 0xc000
0xc000 cost:0
Done
nexthop 0x8001
0x2000 cost:3
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

następny przeskok

Tabela wyjściowa z przypisanymi identyfikatorami routerów oraz bieżącym kosztem następnego przeskoku i ścieżki dla każdego routera.

Parametry

Brak parametrów.

Przykłady

nexthop
| ID   |NxtHop| Cost |
+------+------+------+
|    9 |    9 |    1 |
|   25 |   25 |    0 |
|   30 |   30 |    1 |
|   46 |    - |    - |
|   50 |   30 |    3 |
|   60 |   30 |    2 |
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

panid (panid)

Ustaw identyfikator PAN IEEE 802.15.4.

Kończy się tylko wtedy, gdy protokoły Thread są wyłączone. Pomyślne wywołanie tej funkcji powoduje też unieważnienie aktywnych i oczekujących zbiorów danych operacyjnych w pamięci nieulotnej.

Parametry

panid panid

Przykłady

panid 0xdead
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

panida

Uzyskaj identyfikator PAN IEEE 802.15.4.

Parametry

Brak parametrów.

Przykłady

panid
0xdead
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

parent

Uzyskiwanie informacji diagnostycznych dla routera Thread jako konta nadrzędnego.

Gdy działa ono w trybie routera wątków przy włączonym OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE, to polecenie zwraca informacje z pamięci podręcznej z okresu, gdy urządzenie było wcześniej podłączone jako element podrzędny wątku. Zwrócenie informacji z pamięci podręcznej jest niezbędne do obsługi jarzma testów Thread – scenariusz testowy 8.2.x żąda adresu MAC poprzedniego elementu nadrzędnego (np. routera Joiner Router), nawet jeśli urządzenie zostało już awansowane na router.

Parametry

Brak parametrów.

Przykłady

parent
Ext Addr: be1857c6c21dce55
Rloc: 5c00
Link Quality In: 3
Link Quality Out: 3
Age: 20
Version: 4
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Rozpoczyna proces wyszukiwania lepszego elementu nadrzędnego (bez połączenia z bieżącym elementem nadrzędnym).

Musi być używana, gdy urządzenie jest podłączone jako dziecko.

Parametry

Brak parametrów.

Przykłady

parent search
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

nadrzędny priorytet (get,set)

Pobiera lub ustawia przypisaną wartość priorytetu nadrzędnego: 1, 0, -1 lub -2. -2 oznacza, że element nie jest przypisany.

Parametry

parentpriority [parentpriority]

Przykłady

parentpriority
1
Done
parentpriority 1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

identyfikator partycji

Uzyskaj identyfikator partycji sieciowej Thread.

Parametry

Brak parametrów.

Przykłady

partitionid
4294967295
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

preferowany identyfikator partycji (get,set)

Pole OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE jest wymagane.

Parametry

partitionid preferred partitionid

Przykłady

partitionid preferred
4294967295
Done
partitionid preferred 0xffffffff
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

platform

Drukuj bieżącą platformę

Parametry

Brak parametrów.

Przykłady

platform
NRF52840
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

okres sondy (get,set)

Uzyskaj lub ustaw niestandardowy okres ankiety danych dla śpiącego urządzenia (milisekundy). Tylko na potrzeby testu certyfikacyjnego.

Parametry

Brak parametrów.

Przykłady

pollperiod
0
Done
pollperiod 10
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

preferrouterid

Określa preferowany identyfikator routera, który lider powinien podać w odpowiedzi na prośbę o kontakt.

Parametry

preferrouterid routerid

Przykłady

preferrouterid 16
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

dodaj przedrostek

Dodaje prawidłowy prefiks do danych sieci.

Parametry

prefix add prefix [padcrosnD] [high|med|low]

Interfejs wiersza poleceń OT korzysta z zmapowanych argumentów do konfigurowania wartości otBorderRouterConfig. Więcej informacji znajdziesz w omówieniu interfejsu wiersza poleceń OpenThread.

Przykłady

prefix add 2001:dead:beef:cafe::/64 paros med
Done
prefix add fd00:7d03:7d03:7d03::/64 prosD low
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

siatka z prefiksem

Pobierz lokalny prefiks sieci typu mesh.

Parametry

Brak parametrów.

Przykłady

prefix meshlocal
fdde:ad00:beef:0::/64
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

prefiks

Pobierz listę prefiksów z lokalnych danych sieci.

Więcej informacji o flagach otBorderRouterConfig znajdziesz w omówieniu interfejsu wiersza poleceń OpenThread.

Parametry

Brak parametrów.

Przykłady

prefix
2001:dead:beef:cafe::/64 paros med
- fd00:7d03:7d03:7d03::/64 prosD med
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

usunięcie prefiksu

Usuń konfigurację routera granicznego z danych sieci lokalnej.

Parametry

Brak parametrów.

Przykłady

prefix remove 2001:dead:beef:cafe::/64
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

promiscuous (włącz,wyłącz)

Włącza lub wyłącza tryb dostępu w warstwie linku.

Parametry

promiscuous enable|disable

Przykłady

promiscuous enable
Done
promiscuous disable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

nasłuchiwanie

Wskazuje, czy tryb nasłuchiwania jest włączony w warstwie linku.

Parametry

Brak parametrów.

Przykłady

promiscuous
Disabled
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

pskc (zestaw)

Ustawia plik pskc w formacie szesnastkowym.

Parametry

pskc key

Przykłady

pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

pskc -p

Generuje plik pskc z hasła (zakodowanego w formacie UTF-8) wraz z bieżącą nazwą sieci i rozszerzonym identyfikatorem PAN.

Parametry

pskc -p passphrase

Przykłady

pskc -p 123456
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

PSK

Pobierz klucz PSKc Thread.

Parametry

Brak parametrów.

Przykłady

pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

pskcref (zestaw)

Ustaw odwołanie klucza na klucz PSKc wątku.

Wymaga włączenia funkcji czasu kompilacji OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE.

Odniesie sukces tylko wtedy, gdy protokoły Thread będą wyłączone. Jeśli operacja się uda, spowoduje to również unieważnienie aktywnych i oczekujących zbiorów danych operacyjnych w pamięci nieulotnej.

Parametry

pskc keyref

Przykłady

pskc 0x20017
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

pskcref

Pobranie odniesienia do klucza zapisanego klucza PSKc wątku

Wymaga włączenia funkcji czasu kompilacji OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE.

Parametry

Brak parametrów.

Przykłady

pskcref
0x80000000
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

radio (włącz,wyłącz)

Włącza lub wyłącza radio.

Parametry

radio enable|disable

Przykłady

radio enable
Done
radio disable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

wyczyść statystyki radiowe

Resetuje statystyki radia.

Wszystkie godziny są resetowane do wartości 0.

Parametry

Brak parametrów.

Przykłady

radio stats clear
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

statystyki radiowe

Pobiera statystyki radia.

Statystyki dotyczące radia obejmują czas, gdy radio jest w trybie TX/RX/uśpienia. Czasy są podane w mikrosekundach. Wszystkie czasy są obliczane na podstawie ostatniego resetowania statystyk dotyczących radia.

Parametry

Brak parametrów.

Przykłady

radio stats
Radio Statistics:
Total Time: 67.756s
Tx Time: 0.022944s (0.03%)
Rx Time: 1.482353s (2.18%)
Sleep Time: 66.251128s (97.77%)
Disabled Time: 0.000080s (0.00%)
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

wersja RCP

Pobierz ciąg znaków wersji radiowej.

Parametry

Brak parametrów.

Przykłady

rcp version
OPENTHREAD/20191113-00825-g82053cc9d-dirty; SIMULATION; Jun  4 2020 17:53:16
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

region (ustawiony)

Ustawia kod regionu.

Format regionu radiowego to 2-bajtowy kod alfa-2 zgodny z normą ISO 3166.

Zmiana tej wartości może wpłynąć na limit mocy transmisji.

Parametry

Brak parametrów.

Przykłady

region US
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

region

Pobierz kod regionu.

Format regionu radiowego to 2-bajtowy kod alfa-2 zgodny z normą ISO 3166.

Parametry

Brak parametrów.

Przykłady

region
US
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Releaserouterid (routery)

Zwolnij identyfikator routera przypisany do urządzenia w roli lidera.

Parametry

releaserouterid [routerid]

Przykłady

releaserouterid 16
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

rloc16

Pobierz RLOC16.

Parametry

Brak parametrów.

Przykłady

rloc16
0xdead
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

dodanie trasy

Jako parametrów użyj parametrów:

  • s: flaga stabilna
  • n: flaga NAT64
  • prf: Ustawienie domyślnego routera, [high, med, Low].

Dodaj prawidłową trasę zewnętrzną do danych sieciowych.

Parametry

route add prefix [sn] [high|med|low]

Przykłady

route add 2001:dead:beef:cafe::/64 s med
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

usunięcie trasy

Usuń konfigurację trasy zewnętrznej z danych sieci lokalnej.

Parametry

route remove [prefix]

Przykłady

route remove 2001:dead:beef:cafe::/64
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

trasa

Pobierz listę tras zewnętrznych w lokalnych danych sieci.

Parametry

Brak parametrów.

Przykłady

route
2001:dead:beef:cafe::/64 s med
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

router (identyfikator)

Funkcja przechowuje informacje diagnostyczne o danym routerze Thread.

Drukuj informacje diagnostyczne dotyczące routera Thread. Może to być identyfikator routera lub RLOC16.

Parametry

router [id]

Przykłady

router 50
Alloc: 1
Router ID: 50
Rloc: c800
Next Hop: c800
Link: 1
Ext Addr: e2b3540590b0fd87
Cost: 0
Link Quality In: 3
Link Quality Out: 3
Age: 3
Done
router 0xc800
Alloc: 1
Router ID: 50
Rloc: c800
Next Hop: c800
Link: 1
Ext Addr: e2b3540590b0fd87
Cost: 0
Link Quality In: 3
Link Quality Out: 3
Age: 7
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

lista routerów

Wyświetl listę przydzielonych identyfikatorów routerów.

Parametry

Brak parametrów.

Przykłady

router list
8 24 50
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

tabela routera

Drukuje listę routerów w formacie tabeli.

Parametry

Brak parametrów.

Przykłady

router table
| ID | RLOC16 | Next Hop | Path Cost | LQ In | LQ Out | Age | Extended MAC     | Link |
+----+--------+----------+-----------+-------+--------+-----+------------------+------+
| 22 | 0x5800 |       63 |         0 |     0 |      0 |   0 | 0aeb8196c9f61658 |    0 |
| 49 | 0xc400 |       63 |         0 |     3 |      3 |   0 | faa1c03908e2dbf2 |    1 |
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

próg obniżenia routera (get,set)

Pobiera lub ustawia wartość ROUTER_DOWNGRADE_THRESHOLD.

Parametry

routerdowngradethreshold [threshold]

Przykłady

 routerdowngradethreshold
23
Done
 routerdowngradethreshold 23
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

odpowiedni router (włącz,wyłącz)

Włącza lub wyłącza rolę routera.

Parametry

routereligible [enable|disable]

Przykłady

routereligible enable
Done
routereligible disable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

odpowiedni router

Wskazuje, czy rola routera jest włączona czy wyłączona.

Parametry

Brak parametrów.

Przykłady

routereligible
Enabled
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zakłócenie wyboru routera

Pobiera lub ustawia wartość ROUTER_SELECTION_JITTER.

Parametry

routerselectionjitter [jitter]

Przykłady

routerselectionjitter
120
Done
routerselectionjitter 120
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

próg uaktualnienia routera (get,set)

Pobiera lub ustawia wartość ROUTER_UPGRADE_THRESHOLD.

Parametry

routerupgradethreshold [threshold]

Przykłady

routerupgradethreshold
16
Done
routerupgradethreshold 16
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

skanuj energię

Przeprowadza skanowanie energii IEEE 802.15.4 i wyświetla czas (w milisekundach) potrzebny do skanowania każdego kanału. Na liście widoczne są wszystkie kanały, chyba że wybierzesz konkretny kanał, używając opcji kanału.

Parametry

scan energy [duration] [channel]

Przykłady

scan energy 10
| Ch | RSSI |
+----+------+
| 11 |  -59 |
| 12 |  -62 |
| 13 |  -67 |
| 14 |  -61 |
| 15 |  -87 |
| 16 |  -86 |
| 17 |  -86 |
| 18 |  -52 |
| 19 |  -58 |
| 20 |  -82 |
| 21 |  -76 |
| 22 |  -82 |
| 23 |  -74 |
| 24 |  -81 |
| 25 |  -88 |
| 26 |  -71 |
Done
scan energy 10 20
| Ch | RSSI |
+----+------+
| 20 |  -82 |
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

skanuj

Przeprowadza aktywne skanowanie IEEE 802.15.4. Skanowanie obejmuje wszystkie kanały, jeśli nie został określony żaden kanał. W przeciwnym razie span obejmuje tylko określony kanał.

Parametry

scan [channel]

Przykłady

scan
| PAN  | MAC Address      | Ch | dBm | LQI |
+------+------------------+----+-----+-----+
| ffff | f1d92a82c8d8fe43 | 11 | -20 |   0 |
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

dodanie usługi

Dodaje usługę do danych sieci.

  • enterpriseNumber: numer przedsiębiorstwa IANA
  • serviceData: dane usługi binarnej zakodowane szesnastkowo
  • ServerData: dane serwera binarne zakodowane szesnastkowo

Parametry

service add enterpriseNumber serviceData serverData

Przykłady

service add 44970 112233 aabbcc
Done
netdata register
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

usunięcie usługi

Usuwa usługę z danych sieci.

  • enterpriseNumber: numer przedsiębiorstwa IANA
  • serviceData: dane usługi binarnej zakodowane szesnastkowo

Parametry

service remove enterpriseNumber serviceData

Przykłady

service remove 44970 112233
Done
netdata register
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

singleton

Wskazuje, czy węzeł jest jedynym routerem w sieci. Zwraca wartość true lub false.

Parametry

Brak parametrów.

Przykłady

singleton
true
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zapytanie sntp

Wysyła zapytanie SNTP w celu uzyskania aktualnej godziny uniksowej (od 1 stycznia 1970 r.).

  • Domyślny adres IP serwera SNTP: 2001:4860:4806:8:: (serwer NTP Google IPv6)
  • Domyślny port serwera SNTP: 123

Parametry

sntp query [SNTP server IP] [SNTP server port]

Przykłady

sntp query
SNTP response - Unix time: 1540894725 (era: 0)
Done
sntp query 64:ff9b::d8ef:2308
SNTP response - Unix time: 1540898611 (era: 0)
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Automatyczne uruchamianie klienta srp (pobieranie)

Wskazuje bieżący stan trybu automatycznego uruchamiania (włączony lub wyłączony). Więcej informacji znajdziesz w artykule Konfigurowanie połączenia między serwerami i klienta (SRP) – Service Registration Protocol (SRP).

Parametry

Brak parametrów.

Przykłady

srp client autostart
Disabled
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Wyłączenie automatycznego uruchamiania klienta srp

Wyłącza tryb automatycznego uruchamiania.

Wyłączenie trybu automatycznego uruchamiania nie zatrzymuje uruchomionego klienta. Jednak klient SRP przestanie monitorować dane sieci Thread.

Parametry

Brak parametrów.

Przykłady

srp client autostart disable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

włączenie automatycznego uruchamiania klienta srp

Włącza tryb automatycznego uruchamiania.

Gdy automatyczne uruchamianie jest włączone, klient SRP monitoruje dane sieci Thread, by wykryć serwery SRP, wybrać preferowany serwer oraz automatycznie uruchamiać i zatrzymywać klienta po wykryciu serwera SRP.

Trzy kategorie danych dotyczących sieci wskazują na obecność serwera SRP i są preferowane w tej kolejności:

  1. Wpisy Unicast, w których adres serwera jest zawarty w danych usługi. Jeśli dostępnych jest kilka opcji, preferowana jest opcja z najniższym liczbowym adresem IPv6.
  2. Wpisy Anycast, z których każdy ma numer sekwencyjny. Preferowany jest największy numer sekwencyjny określony przez funkcję arytmetyczną numeru szeregowego w dokumencie RFC-1982.
  3. Wpisy Unicast, w których informacje o adresie serwera są dołączone do danych serwera. Jeśli dostępnych jest kilka opcji, preferowana jest opcja z najniższym liczbowym adresem IPv6.

Parametry

Brak parametrów.

Przykłady

srp client autostart enable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Wywołanie zwrotne klienta srp (get,enable,disable)

Pobiera lub włącza lub wyłącza drukowanie zdarzeń wywołania zwrotnego z klienta SRP. Więcej informacji znajdziesz w artykule Konfigurowanie połączenia między serwerami i klienta (SRP) – Service Registration Protocol (SRP).

Parametry

srp client callback [enable|disable]

Przykłady

srp client callback enable
Done
srp client callback
Enabled
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Adres hosta klienta srp (get)

Wskazuje, czy tryb automatycznego adresu jest włączony. Jeśli automatyczny tryb adresu nie jest włączony, zwracana jest lista adresów hosta klienta SRP. Więcej informacji znajdziesz w artykule Konfigurowanie połączenia między serwerami i klienta (SRP) – Service Registration Protocol (SRP).

Parametry

Brak parametrów.

Przykłady

srp client host address
auto
Done
srp client host address
fd00:0:0:0:0:0:0:1234
fd00:0:0:0:0:0:0:beef
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Adres hosta klienta srp (ustawienie)

Włącz tryb automatycznego adresu hosta lub jawnie ustaw listę adresów hosta. Więcej informacji znajdziesz w artykule Konfigurowanie połączenia między serwerami i klienta (SRP) – Service Registration Protocol (SRP).

Parametry

srp client host address [auto|address...]
  • Użyj parametru auto, aby włączyć tryb automatycznego adresu hosta. Gdy ta opcja jest włączona, klient automatycznie używa wszystkich preferowanych adresów Unicast w Thread netif z wyjątkiem adresów link-lokalny i siatka-lokalny. Jeśli adres nie jest prawidłowy, dodawany jest lokalny adres EID sieci typu mesh. Klient SRP automatycznie zarejestruje się ponownie, jeśli adresy w wątku netif zostaną dodane, usunięte lub oznaczone jako niepreferowane.
  • Wyraźnie określ listę adresów hosta, oddzielając każdy adres spacją. Tę listę możesz ustawić, gdy klient jest uruchomiony. Spowoduje to też wyłączenie trybu automatycznego adresu hosta.

Przykłady

srp client host address auto
Done
srp client host address fd00::cafe
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Czyszczenie hosta klienta srp

Usuwa wszystkie informacje o hoście i wszystkie usługi.

Parametry

Brak parametrów.

Przykłady

srp client host clear
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Nazwa hosta klienta srp (get,set)

Pobiera lub ustawia nazwę hosta klienta SRP. Więcej informacji znajdziesz w artykule Konfigurowanie połączenia między serwerami i klienta (SRP) – Service Registration Protocol (SRP).

Parametry

srp client host name [name]

Aby ustawić nazwę hosta klienta, gdy został on usunięty lub jeszcze nie zarejestrowany na serwerze, użyj parametru name.

Przykłady

srp client host name dev4312
Done
srp client host name
dev4312
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

usunięcie hosta klienta srp

Usuwa informacje o hoście klienta SRP i wszystkie usługi z serwera SRP. Więcej informacji znajdziesz w artykule Konfigurowanie połączenia między serwerami i klienta (SRP) – Service Registration Protocol (SRP).

Parametry

srp client host remove [removekeylease] [sendunregtoserver]
  • Parametr removekeylease jest opcjonalną wartością logiczną wskazującą, czy należy również usunąć dzierżawę klucza hosta (wartość domyślna to false).
  • Parametr sendunregtoserver jest opcjonalną wartością logiczną, która wskazuje, czy host klienta powinien wysłać komunikat o aktualizacji do serwera, nawet jeśli informacje o hoście klienta nie zostały jeszcze na nim zarejestrowane (wartość domyślna to false). Ten parametr można określić tylko wtedy, gdy parametr removekeylease został określony jako pierwszy w poleceniu.

Przykłady

srp client host remove 1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

host klienta srp

Pobiera informacje o hoście.

Parametry

Brak parametrów.

Przykłady

srp client host
name:"dev4312", state:Registered, addrs:[fd00:0:0:0:0:0:0:1234, fd00:0:0:0:0:0:0:beef]
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Stan hosta klienta srp

Zwraca stan hosta klienta SRP. Możliwe stany:

  • ToAdd: produkt do dodania/zarejestrowania.
  • Adding: trwa dodawanie/rejestrowanie produktu.
  • ToRefresh: element do odświeżenia w celu odnowienia dzierżawy.
  • Refreshing: element jest odświeżany w kolorze beżowym.
  • ToRemove: element do usunięcia.
  • Removing: usuwam element.
  • Registered: element został zarejestrowany na serwerze.
  • Removed: element został usunięty.

Parametry

Brak parametrów.

Przykłady

srp client host state
Registered
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

interwał klucza klienta srp (get,set)

Pobiera lub ustawia odstęp dzierżawy klucza w sekundach.

Parametry

srp client keyleaseinterval [interval]

Przykłady

srp client keyleaseinterval 864000
Done
srp client keyleaseinterval
864000
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

srp Client leaseinterval (get,set)

Pobiera lub ustawia odstęp dzierżawy w sekundach.

Parametry

srp client leaseinterval [interval]

Przykłady

srp client leaseinterval 3600
Done
srp client leaseinterval
3600
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Adres serwera klienta srp

Zwraca adres IPv6 serwera.

Parametry

Brak parametrów.

Przykłady

srp client server address
fd00:0:0:0:d88a:618b:384d:e760
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

Port serwera klienta srp

Zwraca numer portu serwera.

Parametry

Brak parametrów.

Przykłady

srp client server port
4724
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

serwer klienta srp

Pobiera adres gniazda (adres IPv6 i numer portu) serwera SRP używanego przez klienta SRP. Jeśli klient nie jest uruchomiony, adres jest nieokreślony (wszystkie zera) i numer portu to 0. Więcej informacji znajdziesz w artykule Konfigurowanie połączenia między serwerami i klienta (SRP) – Service Registration Protocol (SRP).

Parametry

Brak parametrów.

Przykłady

srp client server
[fd00:0:0:0:d88a:618b:384d:e760]:4724
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

dodanie usługi klienta srp

Dodaje usługę o podanej nazwie instancji, nazwie usługi i numerze portu. Więcej informacji znajdziesz w artykule Konfigurowanie połączenia między serwerami i klienta (SRP) – Service Registration Protocol (SRP).

Parametry

srp client service add instancename servicename port [priority] [weight] [txt]

Parametr servicename może opcjonalnie zawierać listę etykiet podtypów usługi rozdzielonych przecinkami. W przykładach używamy nazw ogólnych. Parametry priority i weight (oba mają wartość uint16_t) są opcjonalne, a jeśli nie są podane, używane jest 0. Opcjonalny parametr txt ustawia dane TXT powiązane z usługą. Wartość txt musi mieć format szesnastkowego ciągu znaków i jest traktowana jako już zakodowana sekwencja bajtów danych TXT.

Przykłady

srp client service add ins1 _test1._udp 777
Done
srp client service add ins2 _test2._udp,_sub1,_sub2 111 1 1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Klucz usługi klienta srp (get,set)

Pobiera lub ustawia tryb uwzględniania rekordu klucza usługi w kliencie SRP. To polecenie jest przeznaczone tylko do testowania i wymaga włączenia funkcji OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE. Więcej informacji znajdziesz w artykule Konfigurowanie połączenia między serwerami i klienta (SRP) – Service Registration Protocol (SRP).

Parametry

Brak parametrów.

Przykłady

srp client service key enable
Done
srp client service key
Enabled
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Wyczyść nazwę usługi klienta srp

Czyści usługę, natychmiast usuwając ją z listy usług klienta bez interakcji z serwerem SRP.

Parametry

srp client service clear instancename servicename

Przykłady

srp client service clear ins2 _test2._udp
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

usunięcie usługi klienta srp

Żąda wyrejestrowania usługi z serwera SRP.

Parametry

srp client service remove instancename servicename

Przykłady

srp client service remove ins2 _test2._udp
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

usługa klienta srp

Pobiera listę usług zarządzanych przez klienta.

Parametry

Brak parametrów.

Przykłady

srp client service
instance:"ins2", name:"_test2._udp,_sub1,_sub2", state:Registered, port:111, priority:1, weight:1
instance:"ins1", name:"_test1._udp", state:Registered, port:777, priority:0, weight:0
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

uruchomienie klienta srp

Uruchamia operację klienta SRP. Więcej informacji znajdziesz w artykule Konfigurowanie połączenia między serwerami i klienta (SRP) – Service Registration Protocol (SRP).

Parametry

srp client start serveraddr serverport

Przykłady

srp client start fd00::d88a:618b:384d:e760 4724
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Stan klienta srp

Wskazuje, czy klient SRP jest uruchomiony.

Parametry

Brak parametrów.

Przykłady

srp client state
Enabled
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Zatrzymaj klienta srp

Zatrzymuje operację klienta SRP.

Zatrzymuje dalsze interakcje z serwerem SRP. Pamiętaj, że nie spowoduje to usunięcia ani wyczyszczenia informacji o hoście i/lub listy usług. Wskazuje on wszystkie usługi do dodania/usunięcia po ponownym uruchomieniu klienta.

Parametry

Brak parametrów.

Przykłady

srp client stop
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

srp client ttl (get,set)

Pobiera lub ustawia wartość ttl(czas życia) w sekundach.

Parametry

srp client ttl [value]

Przykłady

srp client ttl 3600
Done
srp client ttl
3600
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

serwer srp (włącz,wyłącz)

Włącza lub wyłącza serwer SRP. Więcej informacji znajdziesz w artykule Konfigurowanie połączenia między serwerami i klienta (SRP) – Service Registration Protocol (SRP).

Parametry

srp server [enable|disable]

Przykłady

srp server disable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

srp Server addrmode (get,set)

Pobiera lub ustawia tryb adresu używany przez serwer SRP.

Tryb adresu informuje serwer SRP o tym, jak określić adres i numer portu, a następnie opublikować je w danych sieci Thread.

Parametry

srp server addrmode [anycast|unicast]

Przykłady

srp server addrmode anycast
Done
srp server addrmode
anycast
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Automatyczny serwer srp (włącz,wyłącz)

Włącza lub wyłącza tryb automatycznego włączania na serwerze SRP.

Gdy ten tryb jest włączony, Menedżer routingu granic decyduje o tym, czy i kiedy włączyć lub wyłączyć serwer SRP.

To polecenie wymaga włączenia funkcji OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE. Więcej informacji znajdziesz w artykule Konfigurowanie połączenia między serwerami i klienta (SRP) – Service Registration Protocol (SRP).

Parametry

srp server auto [enable|disable]

Przykłady

srp server auto enable
Done
srp server auto
Enabled
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Domena serwera srp (get,set)

Pobiera lub ustawia nazwę domeny serwera SRP.

Parametry

srp server domain [domain-name]

Przykłady

srp server domain thread.service.arpa.
Done
srp server domain
thread.service.arpa.
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

host serwera srp

Zwraca informacje o wszystkich zarejestrowanych hostach. Więcej informacji znajdziesz w artykule Konfigurowanie połączenia między serwerami i klienta (SRP) – Service Registration Protocol (SRP).

Parametry

Brak parametrów.

Przykłady

srp server host
srp-api-test-1.default.service.arpa.
    deleted: false
    addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
srp-api-test-0.default.service.arpa.
    deleted: false
    addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

dzierżawa serwera srp (get,set)

Pobiera lub ustawia wartości dzierżawy serwera SRP w liczbie sekund.

Parametry

srp server lease [min-lease max-lease min-key-lease max-key-lease]

Przykłady

srp server lease 1800 7200 86400 1209600
Done
srp server lease
min lease: 1800
max lease: 7200
min key-lease: 86400
max key-lease: 1209600
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

seqnum serwera srp (get,set)

Pobiera lub ustawia numer porządkowy używany w trybie adresu anycast. Numer sekwencyjny jest podany we wpisie „Adres Anycast usługi DNS/SRP” opublikowany w danych sieci.

Parametry

srp server seqnum [seqnum]

Przykłady

srp server seqnum 20
Done
srp server seqnum
20
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

usługa serwera srp

Zwraca informacje o zarejestrowanych usługach.

Rekord TXT jest wyświetlany jako tablica wpisów. Jeśli wpis zawiera klucz, jest on wydrukowany w formacie ASCII. Część wartości jest wydrukowana w bajtach szesnastkowych. Więcej informacji znajdziesz w artykule Konfigurowanie połączenia między serwerami i klienta (SRP) – Service Registration Protocol (SRP).

Parametry

Brak parametrów.

Przykłady

srp server service
srp-api-test-1._ipps._tcp.default.service.arpa.
    deleted: false
    subtypes: (null)
    port: 49152
    priority: 0
    weight: 0
    ttl: 7200
    lease: 7200
    key-lease: 1209600
    TXT: [616263, xyz=585960]
    host: srp-api-test-1.default.service.arpa.
    addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
srp-api-test-0._ipps._tcp.default.service.arpa.
    deleted: false
    subtypes: _sub1,_sub2
    port: 49152
    priority: 0
    weight: 0
    ttl: 3600
    lease: 3600
    key-lease: 1209600
    TXT: [616263, xyz=585960]
    host: srp-api-test-0.default.service.arpa.
    addresses: [fdde:ad00:beef:0:0:ff:fe00:fc10]
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Stan serwera srp

Zwraca jeden z tych możliwych stanów serwera SRP:

  • disabled: serwer SRP nie jest włączony.
  • stopped: serwer SRP jest włączony, ale nie jest aktywny ze względu na istniejące serwery SRP, które są już aktywne w sieci Thread. Serwer SRP może stać się aktywny, gdy istniejące serwery SRP nie są już aktywne w sieci Thread.
  • running: serwer SRP jest aktywny i może obsługiwać rejestracje usług.

Więcej informacji znajdziesz w artykule Konfigurowanie połączenia między serwerami i klienta (SRP) – Service Registration Protocol (SRP).

Parametry

Brak parametrów.

Przykłady

srp server state
running
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

state

Zwraca bieżącą rolę urządzenia Thread lub zmienia rolę zgodnie z jedną z opcji. Możliwe wartości zwracane przy pytaniu o rolę urządzenia:

  • child: urządzenie działa obecnie jako element podrzędny Thread.
  • router: urządzenie działa obecnie jako router Thread.
  • leader: urządzenie działa obecnie jako lider w wątku.
  • detached: urządzenie nie należy obecnie do sieci/partycji Thread.
  • disabled: stos wątków jest obecnie wyłączony.

Korzystając z jednej z opcji, możesz zmienić obecną rolę urządzenia z wyłączeniem zmiany stanu na disabled lub z niego.

Parametry

state [child|router|leader|detached]

Przykłady

state
child
Done
state leader
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

przerwanie tcp

Bezceremonialnie kończy połączenie TCP powiązane z przykładowym punktem końcowym TCP, przenosząc punkt końcowy TCP w stan zamknięty.

Parametry

Brak parametrów.

Przykłady

tcp abort
TCP: Connection reset
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

wynik testu porównawczego tcp

Pokazuje ostatni wynik testu porównawczego TCP. Możliwe wartości stanu:

  • Trwa
  • Ukończono
  • Nieprzetestowane

Polecenie to jest przeznaczone przede wszystkim do tworzenia skryptów, które automatyzują test porównawczy TCP.

Parametry

Brak parametrów.

Przykłady

tcp benchmark result
TCP Benchmark Status: Ongoing
Done
tcp benchmark result
TCP Benchmark Status: Completed
TCP Benchmark Complete: Transferred 73728 bytes in 7056 milliseconds
TCP Goodput: 83.592 kb/s

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

uruchomienie testów porównawczych tcp

Przekazuje określoną liczbę bajtów przez połączenie TCP obecnie powiązane z przykładowym punktem końcowym TCP udostępnionym przez interfejs wiersza poleceń tcp.

Parametry

tcp benchmark run [size]

Aby określić liczbę bajtów do wysłania w ramach testu porównawczego, użyj parametru size. Jeśli nie użyjesz parametru size, zostanie użyta wartość domyślna (OPENTHREAD_CONFIG_CLI_TCP_DEFAULT_BENCHMARK_SIZE).

Przykłady

tcp benchmark run
Done
TCP Benchmark Complete: Transferred 73728 bytes in 7233 milliseconds
TCP Goodput: 81.546 kb/s

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

powiązanie tcp

Wiąże adres IPv6 i port z przykładowym punktem końcowym TCP udostępnionym przez interfejs wiersza poleceń tcp. Powiązanie punktu końcowego TCP z adresem i portem IPv6 jest nazywane „nazwą punktu końcowego TCP”. Powiąże to punkt końcowy na potrzeby komunikacji. Więcej informacji znajdziesz w artykule Testowanie funkcji TCP za pomocą interfejsu OT CLI (w języku angielskim).

Parametry

tcp bind ip port
  • ip: adres IPv6, z którym chcesz utworzyć powiązanie. Jeśli chcesz, aby stos TCP/IPv6 przypisywał adres IPv6 wiązania, użyj nieokreślonego adresu IPv6: ::.
  • port: numer portu TCP, z którym chcesz utworzyć powiązanie.

Przykłady

tcp bind :: 30000
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

połączenie tcp

Nawiązuje połączenie z określonym peerem.

Jeśli połączenie się uda, wynikowe połączenie TCP zostanie powiązane z przykładowym punktem końcowym TCP. Więcej informacji znajdziesz w artykule Testowanie funkcji TCP za pomocą interfejsu OT CLI (w języku angielskim).

Parametry

tcp connect ip port [fastopen]
  • ip: adres IP peera. Adres może być adresem IPv4, który jest syntetyzowany na adres IPv6 przy użyciu preferowanego prefiksu NAT64 z danych sieci. Polecenie zwraca InvalidState, gdy preferowany prefiks NAT64 jest niedostępny.
  • port: numer portu TCP połączenia równorzędnego.
  • fastopen: ten parametr jest opcjonalny. Jeśli zasada ma wartość fast, szybkie otwieranie TCP jest włączone dla tego połączenia. W przeciwnym razie, jeśli ten parametr ma wartość slow lub nie jest używany, szybkie otwieranie TCP jest wyłączone.

Przykłady

tcp connect fe80:0:0:0:a8df:580a:860:ffa4 30000
Done
TCP: Connection established
tcp connect 172.17.0.1 1234
Connecting to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

TCP Deinit

Deinicjuje ten punkt końcowy TCP.

Oznacza to, że OpenThread nie śledzi już tego punktu końcowego TCP i cofa wszystkie zasoby przydzielone wewnętrznie dla tego punktu końcowego TCP. Aplikacja może ponownie wykorzystać pamięć obsługującą punkt końcowy TCP, jeśli uzna to za stosowne.

Jeśli odpowiada ono aktywnemu połączeniu TCP, połączenie jest przerywane bezceremonicznie (tak jak w przypadku otTcpAbort()). Wszystkie zasoby udostępnione przez aplikację dla tego punktu końcowego TCP (połączone bufory dla bufora wysyłania, pamięć dla bufora odbierania, sama struktura aEndpoint itp.) są natychmiast zwracane do aplikacji.

Parametry

Brak parametrów.

Przykłady

tcp deinit
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

init tcp

Inicjuje przykładowy detektor TCP i przykładowy punkt końcowy TCP przez interfejs wiersza poleceń tcp.

Parametry

tcp init [mode] [size]
  • Element mode może mieć 3 wartości:
    • tls: określa, że połączenie TCP między 2 węzłami również powinno korzystać z protokołu TLS oprócz TCP. Gdy 2 węzły komunikują się przez protokół TCP, oba węzły muszą używać protokołu TLS lub żaden z nich nie powinien używać TLS, ponieważ punkt końcowy inny niż TLS nie może się z nim komunikować.
    • linked lub circular: jedna z tych opcji oznacza, że protokół TLS nie powinien być używany i do buforowania TCP należy użyć określonego typu buforowania. Działanie funkcji linked i circular jest identyczne. Sprawdź kod pod kątem różnic między tymi dwoma typami buforowania. Dwa punkty końcowe połączenia TCP nie muszą używać tego samego typu buforowania.
  • Parametr size określa rozmiar bufora odbierania, który ma być powiązany z przykładowym punktem końcowym TCP. Jeśli nie określisz wartości, zostanie użyty maksymalny rozmiar. Maksymalny rozmiar jest ustawiony w OPENTHREAD_CONFIG_CLI_TCP_RECEIVE_BUFFER_SIZE.

Przykłady

tcp init tls
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

nasłuchiwanie tcp

Używa przykładowego detektora TCP do nasłuchiwania połączeń przychodzących pod określonym adresem i portem IPv6. Więcej informacji znajdziesz w artykule Testowanie funkcji TCP za pomocą interfejsu OT CLI (w języku angielskim).

Parametry

tcp listen ip port

Wymagane są te parametry:

  • ip: adres IPv6 lub nieokreślony adres IPv6 (::) przykładowego odbiornika TCP w interfejsie wiersza poleceń tcp.
  • port: port TCP przykładowego detektora TCP. Jeśli z przykładowym punktem końcowym TCP nie jest powiązane żadne połączenie TCP, wszystkie połączenia przychodzące pasujące do podanego adresu i portu IPv6 będą akceptowane i powiązane z przykładowym punktem końcowym TCP.

Przykłady

tcp listen :: 30000
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

wysyłanie tcp

Wysyła dane przez połączenie TCP powiązane z przykładowym punktem końcowym TCP udostępnianym w interfejsie wiersza poleceń tcp. Więcej informacji znajdziesz w artykule Testowanie funkcji TCP za pomocą interfejsu OT CLI (w języku angielskim).

Parametry

tcp send message

Parametr message zawiera wiadomość, którą chcesz wysłać do zdalnego punktu końcowego TCP.

Przykłady

tcp send hello
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

tcp sendend

Wysyła sygnał „koniec strumienia” przez połączenie TCP powiązane z przykładowym punktem końcowym TCP podanym przez interfejs wiersza poleceń tcp. Spowoduje to wysłanie alertu do peera, że nie będzie już otrzymywać danych przez to połączenie TCP.

Parametry

Brak parametrów.

Przykłady

tcp sendend
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zatrzymywanie nasłuchiwania tcp

Powoduje, że przykładowy detektor TCP przestał nasłuchiwać przychodzących połączeń TCP.

Parametry

Brak parametrów.

Przykłady

tcp stoplistening
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

początek wątku

Uruchamia operację protokołu Thread.

Parametry

Brak parametrów.

Przykłady

thread start
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zatrzymanie wątku

Zatrzymuje operację protokołu Thread.

Parametry

Brak parametrów.

Przykłady

thread stop
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

wersja wątku

Pobiera wersję protokołu Thread.

Parametry

Brak parametrów.

Przykłady

 thread version
2
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

maksymalny czas w kolejce

Pobiera maksymalny czas w kolejce dla wiadomości w kolejce TX.

Wymaga OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE.

Czas w kolejce jest śledzony tylko w przypadku transmisji bezpośrednich i jest mierzony jako czas od dodania wiadomości do kolejki przesyłania do momentu przekazania jej do warstwy MAC w celu jej wysłania lub usunięcia.

Zebrane statystyki można zresetować, wywołując otThreadResetTimeInQueueStat() .

Parametry

Brak parametrów.

Przykłady

timeinqueue max
281
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

resetowanie kolejki czasu

Resetuje statystyki czasu w kolejce TX.

Wymaga OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE.

Parametry

Brak parametrów.

Przykłady

timeinqueue reset
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

kolejka w czasie

Pobiera histogram czasu w kolejce dla wiadomości w kolejce TX.

Wymaga OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE.

Zbierany jest histogram czasu w kolejce wiadomości w kolejce przesyłania. Czas w kolejce jest śledzony tylko w przypadku transmisji bezpośrednich i jest mierzony jako czas od dodania wiadomości do kolejki przesyłania do momentu przekazania jej do warstwy MAC w celu jej wysłania lub usunięcia.

Histogram jest zwracany w postaci tablicy wartości uint32_t z wpisami aNumBins. Pierwszy wpis w tablicy (o indeksie 0) reprezentuje liczbę wiadomości, których czas w kolejce jest mniejszy niż aBinInterval. Drugi wpis przedstawia liczbę wiadomości, których czas w kolejce jest większy lub równy aBinInterval, ale mniejszy niż 2 * aBinInterval. I tak dalej. Ostatni wpis określa liczbę wiadomości, których czas w kolejce jest większy lub równy (aNumBins - 1) * aBinInterval.

Zebrane statystyki można zresetować, wywołując otThreadResetTimeInQueueStat() . Informacje dotyczące histogramu są zbierane od czasu zainicjowania instancji OpenThread lub od ostatniego zresetowania zbierania statystyk przez wywołanie metody otThreadResetTimeInQueueStat() .

Wskaźniki aNumBins i aBinInterval NIE MOGĄ BYĆ NULL.

Parametry

Brak parametrów.

Przykłady

timeinqueue
| Min  | Max  |Msg Count|
+------+------+---------+
|    0 |    9 |    1537 |
|   10 |   19 |     156 |
|   20 |   29 |      57 |
|   30 |   39 |     108 |
|   40 |   49 |      60 |
|   50 |   59 |      76 |
|   60 |   69 |      88 |
|   70 |   79 |      51 |
|   80 |   89 |      86 |
|   90 |   99 |      45 |
|  100 |  109 |      43 |
|  110 |  119 |      44 |
|  120 |  129 |      38 |
|  130 |  139 |      44 |
|  140 |  149 |      35 |
|  150 |  159 |      41 |
|  160 |  169 |      34 |
|  170 |  179 |      13 |
|  180 |  189 |      24 |
|  190 |  199 |       3 |
|  200 |  209 |       0 |
|  210 |  219 |       0 |
|  220 |  229 |       2 |
|  230 |  239 |       0 |
|  240 |  249 |       0 |
|  250 |  259 |       0 |
|  260 |  269 |       0 |
|  270 |  279 |       0 |
|  280 |  289 |       0 |
|  290 |  299 |       1 |
|  300 |  309 |       0 |
|  310 |  319 |       0 |
|  320 |  329 |       0 |
|  330 |  339 |       0 |
|  340 |  349 |       0 |
|  350 |  359 |       0 |
|  360 |  369 |       0 |
|  370 |  379 |       0 |
|  380 |  389 |       0 |
|  390 |  399 |       0 |
|  400 |  409 |       0 |
|  410 |  419 |       0 |
|  420 |  429 |       0 |
|  430 |  439 |       0 |
|  440 |  449 |       0 |
|  450 |  459 |       0 |
|  460 |  469 |       0 |
|  470 |  479 |       0 |
|  480 |  489 |       0 |
|  490 |  inf |       0 |
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

trel (enable,disable)

Włącza lub wyłącza działanie radia TREL.

Parametry

trel enable|disable

Przykłady

trel enable
Done
trel disable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

liczniki trel zostały zresetowane

Resetuje liczniki TREL.

Parametry

Brak parametrów.

Przykłady

trel counters reset
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

liczniki trel

Pobiera liczniki TREL.

Parametry

Brak parametrów.

Przykłady

trel counters
Inbound:  Packets 32 Bytes 4000
Outbound: Packets 4 Bytes 320 Failures 1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

filtr trel (włącz,wyłącz)

Włącza lub wyłącza tryb filtra TREL.

Parametry

trel filter enable|disable

Przykłady

trel filter enable
Done
trel filter disable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

filtr trel

Wskazuje, czy włączony jest tryb filtra TREL.

Po włączeniu trybu filtra cały ruch Rx i Tx wysyłany przez interfejs TREL jest dyskretnie usuwany.

Parametry

Brak parametrów.

Przykłady

trel filter
Disabled
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

trel peers

Pobiera tabelę równorzędną TREL w formacie tabeli lub listy.

Parametry

trel peers [list]

Przykłady

trel peers
| No  | Ext MAC Address  | Ext PAN Id       | IPv6 Socket Address                              |
+-----+------------------+------------------+--------------------------------------------------+
|   1 | 5e5785ba3a63adb9 | f0d9c001f00d2e43 | [fe80:0:0:0:cc79:2a29:d311:1aea]:9202            |
|   2 | ce792a29d3111aea | dead00beef00cafe | [fe80:0:0:0:5c57:85ba:3a63:adb9]:9203            |
Done
trel peers list
001 ExtAddr:5e5785ba3a63adb9 ExtPanId:f0d9c001f00d2e43 SockAddr:[fe80:0:0:0:cc79:2a29:d311:1aea]:9202
002 ExtAddr:ce792a29d3111aea ExtPanId:dead00beef00cafe SockAddr:[fe80:0:0:0:5c57:85ba:3a63:adb9]:9203
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Trel

Wskazuje, czy operacja TREL jest włączona.

Parametry

Brak parametrów.

Przykłady

trel
Enabled
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

tvcheck (włącz,wyłącz)

Włącza lub wyłącza sprawdzanie wersji wątku podczas uaktualniania do routera lub repliki wiodącej. To sprawdzanie jest domyślnie włączone.

Parametry

Brak parametrów.

Przykłady

tvcheck enable
Done
tvcheck disable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

txpower (get,set)

Pobiera (lub ustawia przy użyciu opcjonalnego argumentu txpower) moc transmisji w dBm.

Parametry

txpower [txpower]

Przykłady

txpower -10
Done
txpower
-10 dBm
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

powiązanie udp

Przypisuje adres IPv6 i port do otwartego gniazda, co wiąże to gniazdo na potrzeby komunikacji. Przypisanie adresu i portu IPv6 jest nazywane nadaniem gniazda. Więcej informacji znajdziesz w artykule na temat testowania funkcji UDP za pomocą interfejsu wiersza poleceń OT (w języku angielskim).

Parametry

udp bind [netif] ip port
  • netif: interfejs sieci wiązania, który jest określany w następujący sposób:
    • Brak wartości (ten parametr zostaje pominięty w poleceniu): używany jest interfejs sieci Thread.
    • -u: nieokreślony interfejs sieci, co oznacza, że stos UDP/IPv6 określa, z którym interfejsem sieciowym zostanie powiązane gniazdo.
    • -b: używany jest interfejs sieci szkieletowej.
  • ip: adres IPv6, z którym chcesz utworzyć powiązanie. Jeśli chcesz, aby stos UDP/IPv6 przypisywał adres IPv6 wiązania, możesz użyć tej wartości, aby użyć nieokreślonego adresu IPv6: ::. W każdym przykładzie używany jest nieokreślony adres IPv6.
  • port: numer portu UDP, z którym chcesz utworzyć powiązanie. Każdy z przykładów korzysta z numeru portu 1234.

Przykłady

udp bind :: 1234
Done
udp bind -u :: 1234
Done
udp bind -b :: 1234
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Zamknięcie: udp

Zamknij gniazdo UDP/IPv6.

Parametry

Brak parametrów.

Przykłady

udp close
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

połączenie udp

Podłącz gniazdo UDP/IPv6.

Parametry

udp connect ip port

Wymagane są te parametry:

  • ip: adres IP połączenia równorzędnego.
  • port: numer portu UDP połączenia równorzędnego. Adres może być adresem IPv4, który jest syntetyzowany na adres IPv6 za pomocą preferowanego prefiksu NAT64 z danych sieci. Polecenie zwraca InvalidState, gdy preferowany prefiks NAT64 jest niedostępny.

Przykłady

udp connect fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234
Done
udp connect 172.17.0.1 1234
Connecting to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

udp linksecurity (włącz,wyłącz)

Włącza lub wyłącza zabezpieczenia linków.

Parametry

Brak parametrów.

Przykłady

udp linksecurity enable
Done
udp linksecurity disable
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

bezpieczeństwo linków udp

Wskazuje, czy zabezpieczenia linków są włączone czy wyłączone.

Parametry

Brak parametrów.

Przykłady

udp linksecurity
Enabled
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

udp otwarte

Otwórz gniazdo UDP/IPv6.

Parametry

Brak parametrów.

Przykłady

udp open
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

wysyłanie udp

Wysyła wiadomość UDP przez gniazdo. Więcej informacji znajdziesz w artykule na temat testowania funkcji UDP za pomocą interfejsu wiersza poleceń OT (w języku angielskim).

Parametry

udp send [ip port] [type] value

ip i port są opcjonalne jako para, ale jeśli określisz jedną z nich, musisz podać drugą z nich. Jeśli ip i port nie są określone, adres gniazda peera jest używany z udp connect.

  • ip: adres miejsca docelowego. Ten adres może być adresem IPv4 lub IPv6. Adres IPv4 jest syntetyzowany z danych sieci jako adres IPv6 z preferowanym prefiksem NAT64. (Jeśli preferowany prefiks NAT64 jest niedostępny, polecenie zwraca InvalidState).
  • port: docelowy port UDP.
  • Kombinacje typu type/value:
    • -t: ładunek w parametrze value jest traktowany jako tekst. Jeśli nie podasz wartości type, ładunek w parametrze value będzie też traktowany jako tekst.
    • -s: wygenerowany automatycznie ładunek o długości określonej w parametrze value.
    • -x: dane binarne w postaci szesnastkowej, podane w parametrze value.

Przykłady

udp send hello
Done
udp send -t hello
Done
udp send -x 68656c6c6f
Done
udp send -s 800
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 hello
Done
udp send 172.17.0.1 1234 hello
Sending to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -t hello
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -x 68656c6c6f
Done
udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -s 800
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

niezabezpieczone pobieranie

Wyświetla wszystkie porty z listy dozwolonych niezabezpieczonych portów.

Parametry

Brak parametrów.

Przykłady

unsecure get
1234
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

dodawanie bez zabezpieczenia

Dodaje port do listy dozwolonych niezabezpieczonych portów.

Parametry

unsecureport add port

Przykłady

unsecureport add 1234
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

usunięcie bez zabezpieczenia

Usuwa określony port lub wszystkie porty z listy dozwolonych niezabezpieczonych portów.

Parametry

unsecureport remove port|all

Przykłady

unsecureport remove 1234
Done
unsecureport remove all
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

czas działania (ms)

Zwraca bieżącą dostępność instancji (w ms).

Wymaga włączenia OPENTHREAD_CONFIG_UPTIME_ENABLE.

Czas działania jest podany jako liczba milisekund od zainicjowania instancji OpenThread.

Parametry

Brak parametrów.

Przykłady

uptime ms
426238
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

czas działania

Zwraca bieżącą dostępność instancji w postaci ciągu zrozumiałego dla człowieka.

Wymaga włączenia OPENTHREAD_CONFIG_UPTIME_ENABLE.

Ciąg ma format „::.” oznaczający godziny, minuty, sekundy i milisekundy (jeśli czas działania jest krótszy niż jeden dzień) lub „

d.::." (jeśli jest dłuższy niż dzień).

Jeśli powstały ciąg znaków nie mieści się w elemencie aBuffer (łącznie ze znakami aSize), zostanie on obcięty, ale wyjściowy ciąg będzie zawsze miał wartość null.

Parametry

Brak parametrów.

Przykłady

uptime
12:46:35.469
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

appurl dostawcy (zestaw)

Ustaw ciąg adresu URL aplikacji dostawcy.

Wymaga OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

Parametr aVendorAppUrl powinien być w formacie UTF-8, a jego maksymalna długość to 64 znaki (MAX_VENDOR_APPL_URL_TLV_LENGTH). Maksymalna długość nie obejmuje pustego znaku \0.

Parametry

vendor appurl url

Przykłady

vendor appurl http://www.example.com
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

URL dostawcy

Pobierz ciąg tekstowy adresu URL aplikacji dostawcy.

Parametry

Brak parametrów.

Przykłady

vendor appurl
http://www.example.com
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

model dostawcy (zestaw)

Ustaw ciąg znaków modelu dostawcy.

Wymaga OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

Komponent aVendorModel powinien być w formacie UTF-8 i ma maksymalnie 32 znaki (MAX_VENDOR_MODEL_TLV_LENGTH). Maksymalna długość nie obejmuje pustego znaku \0.

Parametry

vendor model name

Przykłady

vendor model Hub\ Max
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

model dostawcy

Pobierz ciąg znaków modelu dostawcy.

Parametry

Brak parametrów.

Przykłady

vendor model
Hub Max
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

nazwa dostawcy (ustawiona)

Ustaw ciąg znaków z nazwą dostawcy.

Wymaga OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

Komponent aVendorName powinien być w formacie UTF-8 i ma maksymalnie 32 znaki (MAX_VENDOR_NAME_TLV_LENGTH). Maksymalna długość nie obejmuje pustego znaku \0.

Parametry

vendor name name

Przykłady

vendor name nest
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

nazwa dostawcy

Pobierz ciąg znaków z nazwą dostawcy.

Parametry

Brak parametrów.

Przykłady

vendor name
nest
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zmiana dostawcy (ustawiona)

Ustaw ciąg znaków wersji oprogramowania dostawcy.

Wymaga OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE.

Parametr aVendorSwVersion powinien być w formacie UTF-8, a jego maksymalna długość to 16 znaków(MAX_VENDOR_SW_VERSION_TLV_LENGTH). Maksymalna długość nie obejmuje pustego znaku \0.

Parametry

vendor swversion version

Przykłady

vendor swversion Marble3.5.1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zmiana dostawcy

Pobierz ciąg znaków wersji oprogramowania dostawcy.

Parametry

Brak parametrów.

Przykłady

vendor swversion
Marble3.5.1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

Verhoeff oblicz

Oblicza sumę kontrolną Verhoeffa dla danego ciągu dziesiętnego.

Wymaga OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE.

Parametry

verhoeff calculate decimalstring

Przykłady

verhoeff calculate 30731842
1
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

zweryfikować dokładne

Weryfikuje sumę kontrolną Verhoeffa dla danego ciągu dziesiętnego.

Wymaga OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE.

Parametry

verhoeff validate decimalstring

Przykłady

verhoeff validate 307318421
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

wersja API

Drukuje numer wersji interfejsu API.

Parametry

Brak parametrów.

Przykłady

version api
28
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API

  • Brak powiązanego interfejsu API

wersja

Pobiera ciąg znaków wersji OpenThread.

Parametry

Brak parametrów.

Przykłady

version
OPENTHREAD/gf4f2f04; Jul 1 2016 17:00:09
Done

Dokumentacja interfejsu wiersza poleceń i interfejsu API