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 ostatniegobufferinfo 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
childrouterlinks (get,set)
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
: potwierdzonynon-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
: potwierdzonynon-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 toblock-16
,block-32
,block-64
,block-128
,block-256
,block-512
orazblock-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
: potwierdzonynon-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, aresponse
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 milisekundack_random_factor_numerator
: 3ack_random_factor_denominator
: 2max_retransmit
: 4
ack_timeout
:ACK_TIMEOUT
(0-UINT32_MAX) w milisekundach. Zapoznaj się z dokumentem RFC7252.ack_random_factor_numerator
: licznikACK_RANDOM_FACTOR
z możliwymi wartościami od 0 do 255. Zapoznaj się z dokumentem RFC7252.ack_random_factor_denominator
: mianownikACK_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
: potwierdzonynon-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 toblock-16
,block-32
,block-64
,block-128
,block-256
,block-512
orazblock-1024
.
payload
: żądanie ładunku CoAP, które w razie potrzeby jest ciągiem tekstowym lub liczbą całkowitą, w zależności od parametrutype
. Jeślitype
tocon
lubnon-con
, parametrpayload
jest opcjonalny. Jeśli pominiesz parametrpayload
, zostanie wysłany pusty ładunek. Jeśli jednak używasz parametrupayload
, jego wartość musi być ciągiem znaków, np.hellothere
. Jeślitype
toblock-
, wartość parametrupayload
musi być liczbą całkowitą określającą liczbę bloków do wysłania. Typblock-
wymaga ustawieniaOPENTHREAD_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
: potwierdzonynon-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 toblock-16
,block-32
,block-64
,block-128
,block-256
,block-512
orazblock-1024
.
payload
: żądanie ładunku CoAP, które w razie potrzeby jest ciągiem tekstowym lub liczbą całkowitą, w zależności od parametrutype
. Jeślitype
tocon
lubnon-con
, parametrpayload
jest opcjonalny. Jeśli pominiesz parametrpayload
, zostanie wysłany pusty ładunek. Jeśli jednak używasz parametrupayload
, jego wartość musi być ciągiem znaków, np.hellothere
. Jeślitype
toblock-
, wartość parametrupayload
musi być liczbą całkowitą określającą liczbę bloków do wysłania. Typblock-
wymaga ustawieniaOPENTHREAD_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
: potwierdzonynon-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
: potwierdzonynon-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 toblock-16
,block-32
,block-64
,block-128
,block-256
,block-512
orazblock-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
: potwierdzonynon-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 toblock-16
,block-32
,block-64
,block-128
,block-256
,block-512
orazblock-1024
.
payload
: żądanie ładunku CoAPS, które w przypadku użycia jest ciągiem tekstowym lub liczbą całkowitą, w zależności od parametrutype
. Jeślitype
tocon
lubnon-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ślitype
toblock-
, wartość parametru ładunku musi być liczbą całkowitą określającą liczbę bloków do wysłania. Typblock-
wymaga ustawieniaOPENTHREAD_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 PSKpsk-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
: potwierdzonynon-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 toblock-16
,block-32
,block-64
,block-128
,block-256
,block-512
orazblock-1024
.
payload
: żądanie ładunku CoAPS, które w przypadku użycia jest ciągiem tekstowym lub liczbą całkowitą, w zależności od parametrutype
. Jeślitype
tocon
lubnon-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ślitype
toblock-
, wartość parametru ładunku musi być liczbą całkowitą określającą liczbę bloków do wysłania. Typblock-
wymaga ustawieniaOPENTHREAD_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ścitrue
ma taki sam skutek jak pominięcie argumentu, czyli że wartośćcheck-peer-cert
totrue
, a wartośćmax-conn-attempts
to 0. - Ustawienie dla
check-peer-cert
wartościfalse
:check-peer-cert
ma wartośćfalse
, a wartośćmax-conn-attempts
– 0. - Określona liczba:
check-peer-cert
totrue
, 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 MLEAnnounce
.count
: liczba transmisji MLEAnnounce
na kanał.period
: liczba milisekund między kolejnymi wywołaniami MLEAnnounce
.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 formacienumber/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 formacienumber/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ładactivetimestamp
,pendingtimestamp
lubnetworkkey
. - 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
- otDatasetSendMgmtActiveGet
- oczekuje na polecenie mgmtgetcommand zbioru danych
- aktywne polecenie mgmtsetcommand zbioru danych
- oczekuje na polecenie mgmtsetcommand zbioru danych
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
- otDatasetSendMgmtPendingGet
- aktywny zbiór danych mgmtgetcommand
- aktywne polecenie mgmtsetcommand zbioru danych
- oczekuje na polecenie mgmtsetcommand zbioru danych
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
- otDatasetSendMgmtActiveSet
- aktywny zbiór danych mgmtgetcommand
- oczekuje na polecenie mgmtgetcommand zbioru danych
- oczekuje na polecenie mgmtsetcommand zbioru danych
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
- otDatasetSendMgmtPendingSet
- aktywny zbiór danych mgmtgetcommand
- oczekuje na polecenie mgmtgetcommand zbioru danych
- aktywne polecenie mgmtsetcommand zbioru danych
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]]
- Używaj aplikacji
rotationtime
w przypadku elementuthrKeyRotation
, w jednostkach godzin. - Polecenia dotyczące zasad zabezpieczeń używają mapowań argumentów
onrcCepR
do pobierania i ustawiania członków otSecurityPolicy, na przykłado
reprezentuje otSecurityPolicy::mObtainNetworkKeyEnabled. Więcej informacji znajdziesz w artykule na temat wyświetlania zbiorów danych i zarządzania nimi za pomocą interfejsu wiersza poleceń OT.
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
lubRemoved
. - Długość adresu/prefiksu: adres Unicast z długością prefiksu (w bitach).
- Źródło: możliwe wartości to
thread
,slaac
,dhcp6
lubmanual
. - 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
lubUnsubscribed
. - Adres multiemisji
- Źródło: możliwe wartości to
Thread
lubManual
.
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
lubRouter
. - Zdarzenie: możliwe wartości to
Added
,Removed
orazChanged
. - 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-nieaktywnyd
: 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
orazdisabled
. - 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-nieaktywnyd
: 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
lubRemoved
. - Prefiks
- Flagi/znaczenie:
p
: preferowana flagaa
: 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
lublow
. - 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
lubRemoved
. - Trasa
- Flagi/znaczenie:
s
: flaga stabilna.n
: flaga NAT64.
- Pref: Preference (Preferencja). Możliwe wartości to
high
,med
lublow
. - 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
orazCostChanged
. - 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
iICMP6
(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).
- Typ wiadomości IPv6, na przykład
- 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
inet
(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 symbolemTX-F
w formacie tabeli lubtx-success:no
w formacie listy. Przykłady nieudanej transmisji to m.in.tx
przerwanie i brak wysyłaniaack
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 lub0xffff
w formacie listy. Jeśli krótki adres sąsiada jest niedostępny, jest wyświetlany jakounknwn
w formacie tabeli lub0xfffe
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
luball
(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
iICMP6
(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).
- Typ wiadomości IPv6, na przykład
- 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
inet
(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 symbolemTX-F
w formacie tabeli lubtx-success:no
w formacie listy. Przykłady nieudanej transmisji to m.in.tx
przerwanie i brak wysyłaniaack
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 lub0xffff
w formacie listy. Jeśli krótki adres sąsiada jest niedostępny, jest wyświetlany jakounknwn
w formacie tabeli lub0xfffe
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
luball
(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
iICMP6
(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).
- Typ wiadomości IPv6, na przykład
- 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
inet
(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 symbolemTX-F
w formacie tabeli lubtx-success:no
w formacie listy. Przykłady nieudanej transmisji to m.in.tx
przerwanie i brak wysyłaniaack
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 lub0xffff
w formacie listy. Jeśli krótki adres sąsiada jest niedostępny, jest wyświetlany jakounknwn
w formacie tabeli lub0xfffe
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
luball
(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ścithread
,slaac
,dhcp6
,manual
i wskazuje pochodzenie adresuplen
: długość prefiksupreferred
: 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
ustawiaaDiscerner
nanullptr
.
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.
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
ia
] 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
ir
] 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
ir
] 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,
lubDisabled
- 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,
lubDisabled
- 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órychrss
ustawiono na inną wartość niż domyślna. Default rss
: pokazuje wartości domyślne ustawieńrss
ilqi
(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
). Ustawieniarss
ilqi
są mapowane na siebie. Jeśli ustawisz jedną z opcji, wartość drugiego zostanie ustawiona automatycznie. Ta lista adresów nosi nazwęRssIn List
. Ustawieniersi
lublqi
powoduje dodanie odpowiedniego rozszerzonego adresu do listyRssIn
. Default rss
: pokazuje wartości domyślne ustawieńrss
ilqi
(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 32-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-nieaktywnyd
: urządzenie z całym wątkiemn
: 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ściD
: urządzenie z pełną obsługą typu Full ThreadN
: 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)
- netdata publish dnssrp unicast (mle)
- otNetDataPublishDnsSrpServiceAnycast
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)
- netdata publish dnssrp anycast
- otNetDataPublishDnsSrpServiceUnicast
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
- netdata publish dnssrp unicast (addr,port)
- netdata publish dnssrp anycast
- otNetDataPublishDnsSrpServiceUnicastMeshLocalEid
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 MAC1
: adres 16 TLV2
: tryb TLV3
: limit czasu TLV (maksymalny czas odpytywania w przypadku SED)4
: TLV związany z łącznością5
: TLV Route646
: TLV danych lidera7
: TLV danych sieciowych8
: TLV listy adresów IPv69
: TLV liczników MAC14
: TLV poziomu baterii15
: napięcie TLV zasilania16
: TLV tabeli podrzędnej17
: TLV stron kanału19
: maksymalny czas oczekiwania użytkownika podrzędnego23
: EUI64 TLV24
: wersja TLV (numer wersji protokołów i funkcji)25
: nazwa dostawcy TLV26
: model TLV dostawcy27
: wersja TLV dostawcy28
: TLV wersji stosu wątków (identyfikator wersji jako ciąg UTF-8 dla bazy kodu/commitowania/wersji stosu Thread)29
: TLV podrzędnego34
: TLV liczników MLE35
: 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
wyszukiwanie rodzica
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:
- 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.
- 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.
- 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 Threadnetif
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ątkunetif
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 tofalse
). - 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 tofalse
). Ten parametr można określić tylko wtedy, gdy parametrremovekeylease
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
- otSrpServerServiceGetInstanceName
- otSrpServerServiceGetServiceName
- otSrpServerServiceGetSubTypeServiceNameAt
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
- otThreadGetDeviceRole
- otThreadBecomeChild
- otThreadBecomeRouter
- otThreadBecomeLeader
- otThreadBecomeDetached
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 zwracaInvalidState
, 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
lubcircular
: 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 funkcjilinked
icircular
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 wOPENTHREAD_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 zwracaInvalidState
, 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 zwracaInvalidState
).port
: docelowy port UDP.- Kombinacje typu
type
/value
:-t
: ładunek w parametrzevalue
jest traktowany jako tekst. Jeśli nie podasz wartościtype
, ładunek w parametrzevalue
będzie też traktowany jako tekst.-s
: wygenerowany automatycznie ładunek o długości określonej w parametrzevalue
.-x
: dane binarne w postaci szesnastkowej, podane w parametrzevalue
.
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 „
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