chiave temporanea ba
Indica se una chiave temporanea è attualmente attiva.
Richiede OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
.
Parametri
Nessun parametro.
Esempi
ba ephemeralkey
active
Done
Riferimenti per l'interfaccia a riga di comando e le API
callback della chiave temporanea ba (abilita, disabilita)
Imposta la funzione di callback utilizzata dall'agente di confine per notificare eventuali modifiche relative all'utilizzo della chiave temporanea.
Richiede OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
.
Una chiamata successiva a questa funzione sostituirà qualsiasi callback impostato in precedenza.
Parametri
Nessun parametro.
Esempi
ba ephemeralkey callback enable
Done
ba ephemeralkey set W10X1 5000 49155
Done
BorderAgent callback: Ephemeral key active, port:49155
BorderAgent callback: Ephemeral key inactive
Riferimenti per l'interfaccia a riga di comando e le API
chiave temporanea ba cancella
Annulla la chiave temporanea in uso.
Richiede OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
.
Può essere utilizzato per annullare una chiave temporanea impostata in precedenza prima che scada. Se l'agente di confine non è in esecuzione o non è in uso una chiave temporanea, la chiamata di questa funzione non ha alcun effetto.
Se un commissario è collegato utilizzando la chiave temporanea ed è attualmente attivo, la chiamata di questa funzione non ne modifica lo stato. In questo caso,
otBorderAgentIsEphemeralKeyActive()
continuerà a restituire TRUE
fino a quando il comitato non si disconnetterà.
Parametri
Nessun parametro.
Esempi
ba ephemeralkey clear
Done
Riferimenti per l'interfaccia a riga di comando e le API
set di chiavi temporanee ba [timeout-in-msec] [porta]
Imposta la chiave temporanea per una determinata durata di timeout.
Richiede OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
.
La chiave temporanea può essere impostata quando l'agente di confine è già in esecuzione e al momento non è collegato ad alcun commissario esterno (ovvero è nello stato OT_BORDER_AGENT_STATE_STARTED
). In caso contrario, viene restituito OT_ERROR_INVALID_STATE
.
Il valore aKeyString
specificato viene utilizzato direttamente come PSK temporanea (escluso il carattere \0
null finale). La lunghezza del campo aKeyString
deve essere compresa tra OT_BORDER_AGENT_MIN_EPHEMERAL_KEY_LENGTH
e OT_BORDER_AGENT_MAX_EPHEMERAL_KEY_LENGTH
inclusi.
Se imposti di nuovo la chiave temporanea prima del timeout di una chiave impostata in precedenza, la chiave impostata in precedenza verrà sostituita e il timeout verrà reimpostato.
Mentre l'intervallo di timeout è attivo, la chiave temporanea può essere utilizzata una sola volta da un commissario esterno per connettersi. Quando il commissario si disconnette, la chiave temporanea viene cancellata e l'agente di confine torna a utilizzare PSKc.
Parametri
Nessun parametro.
Esempi
ba ephemeralkey set Z10X20g3J15w1000P60m16 5000 1234
Done
Riferimenti per l'interfaccia a riga di comando e le API
ID ba (get,set)
Ottiene o imposta l'ID router di confine di 16 byte che può identificare in modo univoco il dispositivo tra più BR.
Parametri
ba id [border-agent-id]
Utilizza l'argomento facoltativo border-agent-id
per impostare l'ID agente di confine.
Esempi
ba id
cb6da1e0c0448aaec39fa90f3d58f45c
Done
ba id 00112233445566778899aabbccddeeff
Done
Riferimenti per l'interfaccia a riga di comando e le API
porta ba
Ottiene la porta UDP del servizio Agente di confine Thread.
Parametri
Nessun parametro.
Esempi
ba port
49153
Done
Riferimenti per l'interfaccia a riga di comando e le API
stato ba
Ottiene il valore otBorderAgentState del ruolo di Agente di confine Thread.
Parametri
Nessun parametro.
Esempi
ba state
Started
Done
Riferimenti per l'interfaccia a riga di comando e le API
bbr
Restituisce le informazioni correnti sul router backbone primario per il dispositivo Thread.
Parametri
Nessun parametro.
Esempi
bbr
BBR Primary:
server16: 0xE400
seqno: 10
delay: 120 secs
timeout: 300 secs
Done
bbr
BBR Primary: None
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
config bbr (set)
Imposta la configurazione del router backbone locale otBackboneRouterConfig.
Se il set di dati BBR viene modificato per il router backbone principale, viene avviato automaticamente un messaggio di richiesta dati del server SRV_DATA.ntf
.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
è attivato.
bbr register
deve essere emesso esplicitamente per registrare il servizio router backbone in Leader per il router backbone secondario.
Parametri
bbr config [seqno seqno] [delay delay] [timeout timeout]
Esempi
bbr config seqno 20 delay 30
Done
Riferimenti per l'interfaccia a riga di comando e le API
configurazione bbr
Ottiene la configurazione del router backbone locale.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
è attivato.
Parametri
Nessun parametro.
Esempi
bbr config
seqno: 10
delay: 120 secs
timeout: 300 secs
Done
Riferimenti per l'interfaccia a riga di comando e le API
bbr disattiva
Attiva o disattiva la funzionalità Backbone.
Se questa opzione è abilitata, viene attivato un messaggio di richiesta dati del server SRV_DATA.ntf
per il dispositivo collegato se non è presente un servizio router backbone nei dati di rete Thread.
Se disattivato, SRV_DATA.ntf
viene attivato se il router backbone è in stato principale.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
è attivato.
Parametri
Nessun parametro.
Esempi
bbr disable
Done
Riferimenti per l'interfaccia a riga di comando e le API
bbr abilita
Attiva o disattiva la funzionalità Backbone.
Se questa opzione è abilitata, viene attivato un messaggio di richiesta dati del server SRV_DATA.ntf
per il dispositivo collegato se non è presente un servizio router backbone nei dati di rete Thread.
Se disattivato, SRV_DATA.ntf
viene attivato se il router backbone è in stato principale.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
è attivato.
Parametri
Nessun parametro.
Esempi
bbr enable
Done
Riferimenti per l'interfaccia a riga di comando e le API
tremolio bbr (get,set)
Consente di acquisire o impostare il jitter (in secondi) per la registrazione del router backbone.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
è attivato.
Parametri
bbr jitter [jitter]
Esempi
bbr jitter
20
Done
bbr jitter 10
Done
Riferimenti per l'interfaccia a riga di comando e le API
bbr mgmt dua
Con l'inclusione di meshLocalIid
, questo comando configura lo stato della risposta per la successiva registrazione DUA. Senza meshLocalIid
, rispondi al successivo DUA.req con il valore status
o coap-code
specificato.
Disponibile quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
è attivato.
Parametri
bbr mgmt dua status|coap-code [meshLocalIid]
Per status
o coap-code
, usa:
- 0: ST_DUA_SUCCESS
- 1: ST_DUA_REREGISTER
- 2: ST_DUA_INVALID
- 3: ST_DUA_DUPLICATE
- 4: ST_DUA_NO_RESOURCES
- 5: ST_DUA_BBR_NOT_PRIMARY
- 6: ST_DUA_GENERAL_FAILURE
- 160: COAP codice 5.00
Esempi
bbr mgmt dua 1 2f7c235e5025a2fd
Done
bbr mgmt dua 160
Done
Riferimenti per l'interfaccia a riga di comando e le API
bbr mgmt mlr listener aggiungere
Aggiunge un listener multicast con un valore di timeout, in secondi.
Supera 0
per utilizzare il timeout MLR predefinito.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
e OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
sono abilitati.
Parametri
bbr mgmt mlr listener add ipaddress [timeout-seconds]
Esempi
bbr mgmt mlr listener add ff04::1
Done
bbr mgmt mlr listener add ff04::2 300
Done
Riferimenti per l'interfaccia a riga di comando e le API
listener bbr mgmt mlr
Restituisce i listener multicast con otBackboneRouterMulticastListenerInfomTimeout
in secondi.
Disponibile quando i criteri OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
e OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
sono attivati.
Parametri
Nessun parametro.
Esempi
bbr mgmt mlr listener
ff04:0:0:0:0:0:0:abcd 3534000
ff04:0:0:0:0:0:0:eeee 3537610
Done
Riferimenti per l'interfaccia a riga di comando e le API
bbr mgmt mlr ascoltatore chiaro
Cancella i listener multicast.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
e OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
sono abilitati.
Parametri
Nessun parametro.
Esempi
bbr mgmt mlr listener clear
Done
Riferimenti per l'interfaccia a riga di comando e le API
bbr mgmt risposta mlr
Configura lo stato della risposta per la successiva registrazione del listener multicast.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
e OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
sono abilitati.
Parametri
bbr mgmt mlr response status-code
Per status-code
, usa:
- 0: ST_MLR_SUCCESS
- 2: ST_MLR_INVALID
- 3: ST_MLR_NO_PERSISTENT
- 4: ST_MLR_NO_RESOURCES
- 5: ST_MLR_BBR_NOT_PRIMARY
- 6: ST_MLR_GENERAL_FAILURE
Esempi
bbr mgmt mlr response 2
Done
Riferimenti per l'interfaccia a riga di comando e le API
registro bbr
Registra esplicitamente la configurazione del router backbone locale.
Viene attivato un messaggio di richiesta dati del server SRV_DATA.ntf
per il dispositivo collegato.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
è attivato.
Parametri
Nessun parametro.
Esempi
bbr register
Done
Riferimenti per l'interfaccia a riga di comando e le API
stato bbr
Ottiene il router backbone otBackboneRouterState.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
è attivato.
Parametri
Nessun parametro.
Esempi
bbr state
Disabled
Done
bbr state
Primary
Done
bbr state
Secondary
Done
Riferimenti per l'interfaccia a riga di comando e le API
br disattiva
Disattiva Border Routing Manager.
Parametri
Nessun parametro.
Esempi
br disable
Done
Riferimenti per l'interfaccia a riga di comando e le API
br abilita
Attiva il Border Routing Manager.
Parametri
Nessun parametro.
Esempi
br enable
Done
Riferimenti per l'interfaccia a riga di comando e le API
br init
Inizializza il Border Routing Manager.
Parametri
br init infrastructure-network-index is-running
Esempi
br init 2 1
Done
Riferimenti per l'interfaccia a riga di comando e le API
prefisso br nat64
Restituisce sia i prefissi NAT64 locali che quelli preferiti.
Parametri
Nessun parametro.
Esempi
br nat64prefix
Local: fd14:1078:b3d5:b0b0:0:0::/96
Favored: fd14:1078:b3d5:b0b0:0:0::/96 prf:low
Done
Riferimenti per l'interfaccia a riga di comando e le API
prefisso br nat64 preferito
Ottiene il prefisso NAT64 attualmente preferito.
Il prefisso NAT64 preferito può essere rilevato dal link dell'infrastruttura o può essere il prefisso NAT64 locale di questo dispositivo.
Parametri
Nessun parametro.
Esempi
br nat64prefix favored
fd14:1078:b3d5:b0b0:0:0::/96 prf:low
Done
Riferimenti per l'interfaccia a riga di comando e le API
prefisso br nat64 locale
Ottiene il prefisso NAT64 locale del router di confine.
Il prefisso NAT64 potrebbe non essere pubblicizzato nella rete Thread.
OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
deve essere abilitato.
Parametri
Nessun parametro.
Esempi
br nat64prefix local
fd14:1078:b3d5:b0b0:0:0::/96
Done
Riferimenti per l'interfaccia a riga di comando e le API
br omrprefisso
Restituisce sia il prefisso OMR locale sia quello preferito.
Parametri
Nessun parametro.
Esempi
br omrprefix
Local: fdfc:1ff5:1512:5622::/64
Favored: fdfc:1ff5:1512:5622::/64 prf:low
Done
Riferimenti per l'interfaccia a riga di comando e le API
br omrprefisso preferito
Ottieni il prefisso OMR (Off-Mesh-Routable) attualmente preferito.
Il prefisso OMR preferito può essere rilevato dai dati di rete o può essere il prefisso OMR locale di questo dispositivo.
Parametri
Nessun parametro.
Esempi
br omrprefix favored
fdfc:1ff5:1512:5622::/64 prf:low
Done
Riferimenti per l'interfaccia a riga di comando e le API
br omrprefix locale
Ottiene il prefisso locale Fuori mesh (OMR), ad esempio fdfc:1ff5:1512:5622::/64
.
Un prefisso OMR è un prefisso a 64 bit generato casualmente che viene pubblicato nella rete Thread se non esiste già un prefisso OMR. Questo prefisso può essere raggiunto dalla rete Wi-Fi o Ethernet locale.
Parametri
Nessun parametro.
Esempi
br omrprefix local
fdfc:1ff5:1512:5622::/64
Done
Riferimenti per l'interfaccia a riga di comando e le API
br onlinkprefisso
Restituisce sia i prefissi all'interno del link sia quelli preferiti.
Parametri
Nessun parametro.
Esempi
br onlinkprefix
Local: fd41:2650:a6f5:0::/64
Favored: 2600::0:1234:da12::/64
Done
Riferimenti per l'interfaccia a riga di comando e le API
prefisso br onlink preferito
Ottiene il prefisso on-link preferito al momento.
Il prefisso preferito è un prefisso all'interno del link rilevato sul link dell'infrastruttura o il prefisso locale del link.
Parametri
Nessun parametro.
Esempi
br onlinkprefix favored
2600::0:1234:da12::/64
Done
Riferimenti per l'interfaccia a riga di comando e le API
br onlinkprefix locale
Ottiene il prefisso on-link locale per il collegamento dell'infrastruttura adiacente.
Il prefisso locale sul link è un prefisso a 64 bit pubblicizzato sul link dell'infrastruttura se non è già stato pubblicizzato un prefisso sul link utilizzabile sul link.
Parametri
Nessun parametro.
Esempi
br onlinkprefix local
fd41:2650:a6f5:0::/64
Done
Riferimenti per l'interfaccia a riga di comando e le API
br pd (attiva,disattiva)
Attiva / disattiva la delega del prefisso DHCPv6.
OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE
deve essere abilitato.
Parametri
br pd enable|disable
Esempi
br pd enable
Done
br pd disable
Done
Riferimenti per l'interfaccia a riga di comando e le API
br pd omrprefix
Restituisce il prefisso OMS (off-mesh-routable) fornito dalla delega di prefisso (PD) DHCPv6.
Nelle informazioni restituite per il prefisso vengono utilizzati solo i campi mPrefix, mValidLifetime e mPreferredLifetime.
OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE
deve essere abilitato.
Parametri
Nessun parametro.
Esempi
br pd omrprefix
2001:db8:cafe:0:0/64 lifetime:1800 preferred:1800
Done
Riferimenti per l'interfaccia a riga di comando e le API
stato br pd
Restituisce lo stato attuale della delega del prefisso DHCPv6.
Richiede l'attivazione di OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE
.
Parametri
Nessun parametro.
Esempi
br pd state
running
Done
Riferimenti per l'interfaccia a riga di comando e le API
br compagni
Recupera l'elenco dei BR peer trovati nelle voci di dati di rete. Il campo OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE
è obbligatorio. I BR peer sono altri dispositivi all'interno del mesh Thread che forniscono connettività IP esterna. Un dispositivo viene considerato come dotato di connettività IP esterno se viene soddisfatta almeno una delle seguenti condizioni relative alle voci di dati di rete:
- È stata aggiunta almeno una voce di percorso esterna.
- Ha aggiunto almeno una voce di prefisso con i flag default-route e on-mesh impostati.
- Ha aggiunto almeno un prefisso di dominio (con i flag dominio e su mesh impostati). L'elenco di BR peer esclude in modo specifico il dispositivo attuale, anche se agisce a sua volta come un BR. Informazioni per voce in Brasile:
- RLOC16 del Brasile
- Età come intervallo di durata dall'inizio della visualizzazione di questo valore nei dati di rete. Il formato è
{hh}:{mm}:{ss}
per ore, minuti, secondi, se la durata è inferiore a 24 ore. Se la durata è di 24 ore o più, il formato è{dd}d.{hh}:{mm}:{ss}
per giorni, ore, minuti e secondi.
Parametri
Nessun parametro.
Esempi
br peers
rloc16:0x5c00 age:00:00:49
rloc16:0xf800 age:00:01:51
Done
Riferimenti per l'interfaccia a riga di comando e le API
conteggio dei compagni br
Restituisce il numero di BR peer trovati nei dati di rete.
Richiede OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE
.
I BR peer sono altri dispositivi all'interno del mesh Thread che forniscono connettività IP esterna. Un dispositivo viene considerato come dotato di connettività IP esterno se viene soddisfatta almeno una delle seguenti condizioni relative alle voci di dati di rete:
- È stata aggiunta almeno una voce di percorso esterna.
- Ha aggiunto almeno una voce di prefisso con i flag default-route e on-mesh impostati.
- Ha aggiunto almeno un prefisso di dominio (con i flag dominio e su mesh impostati).
L'elenco di BR peer esclude in modo specifico il dispositivo attuale, anche se a sua volta funge da BR.
Parametri
Nessun parametro.
Esempi
br peers count
2 min-age:00:00:47
Done
Riferimenti per l'interfaccia a riga di comando e le API
br prefisso
Recupera i prefissi rilevati da Border Routing Manager sul collegamento dell'infrastruttura. Informazioni per voce di prefisso:
- Il prefisso
- Se il prefisso è "on-link" o "instradato"
- Millisecondi dall'ultima ricezione di un annuncio del router contenente questo prefisso
- Durata del prefisso in secondi
- Durata preferita in secondi solo se il prefisso è al link
- Preferenza di percorso (bassa, media, alta) solo se il prefisso è route (non sul link)
- L'indirizzo IPv6 del router che pubblicizza questo prefisso
- Flag nell'intestazione Pubblicità router ricevuto:
- M: flag per la configurazione degli indirizzi gestiti
- O: flag di configurazione diverso
- Stub: flag router Stub (indica se il router è un router stub)
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
br raoptions (imposta,cancella)
Consente di impostare opzioni aggiuntive da aggiungere alla fine dei messaggi pubblicitari router (RA) emessi.
Il contenuto di aOptions
viene copiato internamente, quindi può essere un buffer temporaneo (ad es. un array allo stack).
Le chiamate successive a questa funzione sovrascrivono il valore impostato in precedenza.
Parametri
br raoptions options|clear
br raoptions clear
passa un nullptr
a otBorderRoutingSetExtraRouterAdvertOptions. In caso contrario, puoi passare il byte options
come dati esadecimale.
Esempi
br raoptions 0400ff00020001
Done
br raoptions clear
Done
Riferimenti per l'interfaccia a riga di comando e le API
br rioprf (alto,medio,basso)
Imposta in modo esplicito la preferenza da utilizzare quando vengono pubblicizzate Opzioni info percorso (RIO) nei messaggi pubblicitari router inviati tramite il link dell'infrastruttura.
Dopo una chiamata a questa funzione, BR utilizza la preferenza specificata per tutti i RIO pubblicizzati. La preferenza può essere cancellata chiamando il numero
otBorderRoutingClearRouteInfoOptionPreference()
.
Parametri
br rioprf [high|med|low]
Esempi
br rioprf low
Done
Riferimenti per l'interfaccia a riga di comando e le API
br rioprf
Consente di acquisire la preferenza corrente utilizzata per pubblicizzare le opzioni RIO (Route Info Settings) nei messaggi pubblicitari del router inviati tramite il link dell'infrastruttura.
La preferenza RIO è determinata come segue:
- Se viene impostata esplicitamente dall'utente chiamando
otBorderRoutingSetRouteInfoOptionPreference()
, viene utilizzata la preferenza specificata. - In caso contrario, viene determinato in base al ruolo attuale del dispositivo: preferenza media nel ruolo router/leader e bassa preferenza nel ruolo secondario.
Parametri
Nessun parametro.
Esempi
br rioprf
med
Done
Riferimenti per l'interfaccia a riga di comando e le API
br rioprf chiaro
Cancella un valore di preferenza impostato in precedenza per le opzioni di informazioni percorso annunciate.
Dopo una chiamata a questa funzione, il Brasile utilizzerà il ruolo del dispositivo per determinare la preferenza RIO: preferenza media nel ruolo router/leader e bassa preferenza nel ruolo figlio.
Parametri
Nessun parametro.
Esempi
br rioprf clear
Done
Riferimenti per l'interfaccia a riga di comando e le API
br routeprf (alto,medio,basso)
Imposta in modo esplicito la preferenza per le route pubblicate in Dati di rete.
Dopo una chiamata a questa funzione, BR utilizzerà la preferenza specificata. La preferenza può essere cancellata chiamando il numero
otBorderRoutingClearRoutePreference()
.
Parametri
br routeprf [high|med|low]
Esempi
br routeprf low
Done
Riferimenti per l'interfaccia a riga di comando e le API
br routeprf
Consente di acquisire la preferenza corrente utilizzata per le route pubblicate in Dati di rete.
La preferenza viene determinata come segue:
- Se viene impostata esplicitamente dall'utente chiamando
otBorderRoutingSetRoutePreference()
, viene utilizzata la preferenza specificata. - In caso contrario, viene determinato automaticamente da
RoutingManager
in base al ruolo del dispositivo e alla qualità del link.
Parametri
Nessun parametro.
Esempi
br routeprf
med
Done
Riferimenti per l'interfaccia a riga di comando e le API
br routeprf cancella
Consente di cancellare un valore di preferenza impostato in precedenza per le route pubblicate in Dati di rete.
Dopo una chiamata a questa funzione, BR determinerà automaticamente la preferenza in base al ruolo del dispositivo e alla qualità del collegamento (al genitore quando agisce come dispositivo finale).
Parametri
Nessun parametro.
Esempi
br routeprf clear
Done
Riferimenti per l'interfaccia a riga di comando e le API
router br
Recupera l'elenco dei router rilevati da Border Routing Manager sul link dell'infrastruttura. Informazioni per router:
- L'indirizzo IPv6 del router
- Flag nell'intestazione Pubblicità router ricevuto:
- M: flag per la configurazione degli indirizzi gestiti
- O: flag di configurazione diverso
- Stub: flag router Stub (indica se il router è un router stub)
- Millisecondi dall'ultima ricezione di questo messaggio da questo router
- Flag di raggiungibilità: un router viene contrassegnato come non raggiungibile se non risponde a più probe di richieste vicine.
- Età: intervallo di durata dal primo rilevamento del router. Il formato è
{hh}:{mm}:{ss}
per ore, minuti, secondi, se la durata è inferiore a 24 ore. Se la durata è di 24 ore o più, il formato è{dd}d.{hh}:{mm}:{ss}
per giorni, ore, minuti e secondi. (this BR)
viene aggiunto quando il router è il dispositivo locale stesso.(peer BR)
viene aggiunto quando è probabile che il router sia un BR peer connesso allo stesso mesh Thread. RichiedeOPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE
.
Parametri
Nessun parametro.
Esempi
br routers
ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1) ms-since-rx:1505 reachable:yes age:00:18:13
Done
Riferimenti per l'interfaccia a riga di comando e le API
stato br
Recupera lo stato attuale di Border Routing Manager.
Parametri
Nessun parametro.
Esempi
br state
running
Riferimenti per l'interfaccia a riga di comando e le API
bufferinfo
Recupera le informazioni correnti sul buffer dei messaggi.
total
visualizza il numero totale di buffer dei messaggi nel pool.free
mostra il numero di buffer dei messaggi liberi.max-used
visualizza il numero massimo di buffer utilizzati contemporaneamente dall'inizializzazione dello stack OT o dall'ultimabufferinfo reset
.
Successivamente, l'interfaccia a riga di comando mostra le informazioni sulle diverse code utilizzate dallo stack OpenThread, ad esempio 6lo send
. Ogni riga dopo la coda rappresenta le informazioni relative a una coda:
- Il primo numero mostra i messaggi numerici in coda.
- Il secondo numero indica il numero di buffer utilizzati da tutti i messaggi in coda.
- Il terzo numero indica il numero totale di byte di tutti i messaggi in coda.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
reimpostazione bufferinfo
Reimposta il contatore di informazioni del buffer dei messaggi tenendo traccia del numero massimo di buffer in uso contemporaneamente.
Questa operazione reimposta mMaxUsedBuffers
in
otBufferInfo
.
Parametri
Nessun parametro.
Esempi
bufferinfo reset
Done
Riferimenti per l'interfaccia a riga di comando e le API
ccathreshold (get,set)
Ottieni o imposta la soglia CCA in dBm misurata al connettore dell'antenna in base allo standard IEEE 802.15.4 - 2015 sezione 10.1.4.
Parametri
ccathreshold [CCA-threshold-dBm]
Utilizza l'argomento facoltativo CCA-threshold-dBm
per impostare la soglia CCA.
Esempi
ccathreshold
-75 dBm
Done
ccathreshold -62
Done
Riferimenti per l'interfaccia a riga di comando e le API
canale (get,set)
Consente di acquisire o impostare il valore del canale IEEE 802.15.4.
Parametri
channel [channel-num]
Usa channel-num
per impostare il canale.
Esempi
channel
11
Done
channel 11
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
gestione canali automatica
Attiva o disattiva la funzionalità di selezione automatica del canale per il canale di rete.
Quando questa opzione è abilitata, ChannelManager
richiama periodicamente un RequestChannelSelect(false)
. L'intervallo del periodo può essere impostato da
otChannelManagerSetAutoChannelSelectionInterval()
.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
o OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
e OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
sono obbligatori.
Parametri
channel manager auto enable
1
è un valore booleano per enable
.
Esempi
channel manager auto 1
channel manager auto 1
Done
Riferimenti per l'interfaccia a riga di comando e le API
modifica al gestore del canale
Consente di richiedere una modifica del canale della rete Thread.
La rete passa al canale specificato dopo un determinato ritardo (vedi otChannelManagerSetDelay()). La modifica del canale viene eseguita aggiornando il set di dati operativo in attesa.
Una chiamata successiva annullerà una modifica del canale già richiesta in precedenza.
Il campo OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
è obbligatorio.
Parametri
channel manager change channel-num
Esempi
channel manager change 11
channel manager change 11
Done
Riferimenti per l'interfaccia a riga di comando e le API
gestore del canale
Ottieni lo stato del gestore del canale. È obbligatorio specificare OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
o OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
.
Parametri
Nessun parametro.
Esempi
channel manager
channel: 11
auto: 1
delay: 120
interval: 10800
supported: { 11-26}
favored: { 11-26}
Done
Riferimenti per l'interfaccia a riga di comando e le API
ritardo del gestore del canale
Imposta il ritardo (in secondi) utilizzato per un cambio di canale di rete.
Disponibile solo per i FTD. Preferibilmente, il ritardo dovrebbe essere maggiore dell'intervallo massimo di polling dei dati utilizzato da tutti i dispositivi finali Sleepy all'interno della rete Thread.
I campi OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
e OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
sono obbligatori.
Parametri
channel manager delay delay-seconds
Esempi
channel manager delay 120
channel manager delay 120
Done
Riferimenti per l'interfaccia a riga di comando e le API
gestore del canale preferito
Imposta la maschera del canale preferito.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
o OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
e OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
sono obbligatori.
Parametri
channel manager favored mask
Esempi
channel manager favored 0x7fffc00
channel manager favored 0x7fffc00
Done
Riferimenti per l'interfaccia a riga di comando e le API
intervallo del gestore del canale
Imposta l'intervallo (in secondi) utilizzato dalla funzionalità di selezione automatica del canale.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
o OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
e OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
sono obbligatori.
Parametri
channel manager interval interval-seconds
Esempi
channel manager interval 10800
channel manager interval 10800
Done
Riferimenti per l'interfaccia a riga di comando e le API
selezione gestore del canale
Richieste che ChannelManager
controlli e selezioni un nuovo canale e avvii una modifica del canale.
A differenza di
otChannelManagerRequestChannelChange()
in cui il canale deve essere indicato come parametro, questa funzione chiede al ChannelManager
di selezionare autonomamente un canale (in base alle informazioni sulla qualità del canale raccolte).
Una volta chiamato, il gestore del canale eseguirà i seguenti 3 passaggi:
1) ChannelManager
decide se il cambio di canale sarebbe utile. Questo controllo può essere ignorato se il criterio aSkipQualityCheck
è impostato su true (forzando la selezione di un canale e saltando il controllo qualità). Questo passaggio utilizza le metriche di qualità dei link raccolte sul dispositivo (come il tasso di errore CCA, i tassi di errore di frame e messaggi per vicino e così via) per determinare se la qualità attuale del canale è al livello che giustifica un cambiamento di canale.
2) Se il primo passaggio va a buon fine, ChannelManager
selezionerà un canale potenzialmente migliore. Utilizza i dati sulla qualità del canale raccolti dal modulo ChannelMonitor
. In questa fase vengono utilizzati i canali supportati e preferiti. (vedi
otChannelManagerSetSupportedChannels()
e
otChannelManagerSetFavoredChannels()
).
3) Se il canale appena selezionato è diverso dal canale corrente, ChannelManager
richiede/avvia la procedura di modifica del canale (richiamando internamente un RequestChannelChange()
).
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
o OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
e OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
sono obbligatori.
Parametri
channel manager select skip-quality-check
Utilizza 1
o 0
per il valore booleano skip-quality-check
.
Esempi
channel manager select 1
channel manager select 1
Done
Riferimenti per l'interfaccia a riga di comando e le API
gestore del canale supportato
Imposta la maschera del canale supportata.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
o OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
e OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
sono obbligatori.
Parametri
channel manager supported mask
Esempi
channel manager supported 0x7fffc00
channel manager supported 0x7fffc00
Done
Riferimenti per l'interfaccia a riga di comando e le API
soglia del gestore del canale
Imposta la soglia del tasso di errore CCA.
OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
o OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
e OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
sono obbligatori.
Parametri
channel manager threshold threshold-percent
Utilizza un valore esadecimale per threshold-percent
. 0
mappa allo 0% e 0xffff
al 100%.
Esempi
channel manager threshold 0xffff
channel manager threshold 0xffff
Done
Riferimenti per l'interfaccia a riga di comando e le API
monitoraggio del canale
Ottieni lo stato attuale del monitoraggio del canale e l'occupazione dei canali. Il campo OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
è obbligatorio.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
avvio monitoraggio canale
Avvia il monitoraggio del canale. L'interfaccia a riga di comando OT invia un valore booleano di true
a otChannelMonitorSetEnabled. Il campo OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
è obbligatorio.
Parametri
Nessun parametro.
Esempi
channel monitor start
channel monitor start
Done
Riferimenti per l'interfaccia a riga di comando e le API
interruzione del monitoraggio del canale
Interrompi il monitoraggio del canale. L'interfaccia a riga di comando OT invia un valore booleano di false
a otChannelMonitorSetEnabled. Il campo OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE
è obbligatorio.
Parametri
Nessun parametro.
Esempi
channel monitor stop
channel monitor stop
Done
Riferimenti per l'interfaccia a riga di comando e le API
preferito per il canale
Consente di ottenere la maschera di canale preferita per la radio su cui il dispositivo preferisce formarsi.
Parametri
Nessun parametro.
Esempi
channel preferred
0x7fff800
Done
Riferimenti per l'interfaccia a riga di comando e le API
canale supportato
Ottieni la maschera del canale supportata dalle radio su cui è consentito l'uso del dispositivo.
Parametri
Nessun parametro.
Esempi
channel supported
0x7fff800
Done
Riferimenti per l'interfaccia a riga di comando e le API
figlio (ID)
Recupera le informazioni diagnostiche relative a un account secondario collegato in base al relativo ID figlio o RLOC16.
Parametri
child child-id
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
elenco secondario
Restituisce un elenco di ID secondari allegati.
Parametri
Nessun parametro.
Esempi
child list
1 2 3 6 7 8
Done
Riferimenti per l'interfaccia a riga di comando e le API
tabella secondaria
Stampa una tabella degli elementi secondari allegati.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
infantile
Ottiene un elenco di indirizzi IP archiviati per i bambini MTD.
Parametri
Nessun parametro.
Esempi
childip
3401: fdde:ad00:beef:0:3037:3e03:8c5f:bc0c
Done
Riferimenti per l'interfaccia a riga di comando e le API
valore figlio massimo (impostato)
Consente di impostare o ripristinare il numero massimo di indirizzi IP che ogni MTD secondario può registrare con questo dispositivo come padre.
Passa 0
per cancellare l'impostazione e ripristinare quella predefinita.
Disponibile quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
è attivato.
Parametri
childip max count
Esempi
childip max 2
Done
Riferimenti per l'interfaccia a riga di comando e le API
massimo figlio
Ottiene il numero massimo di indirizzi IP che ogni MTD secondario può registrare con questo dispositivo come padre.
Parametri
Nessun parametro.
Esempi
childip max
4
Done
Riferimenti per l'interfaccia a riga di comando e le API
figlio max (impostato)
Consente di impostare il numero massimo di elementi secondari attualmente consentiti.
Questo parametro può essere impostato solo quando l'operazione del protocollo Thread è stata interrotta.
Parametri
childmax count
Esempi
childmax 2
Done
Riferimenti per l'interfaccia a riga di comando e le API
max. figlio
Consente di acquisire il numero massimo di elementi secondari attualmente consentiti.
Parametri
Nessun parametro.
Esempi
childmax
5
Done
Riferimenti per l'interfaccia a riga di comando e le API
link figlio-router (get,set)
Ottiene o imposta il valore MLE_CHILD_ROUTER_LINKS.
Parametri
childrouterlinks [links]
Esempi
childrouterlinks
16
Done
childrouterlinks 16
Done
Riferimenti per l'interfaccia a riga di comando e le API
checktimeout supervisione bambino (impostato)
Imposta l'intervallo di timeout dei controlli della supervisione (in secondi) per il bambino.
Parametri
childsupervision checktimeout timeout-seconds
Esempi
childsupervision checktimeout 30
Done
Riferimenti per l'interfaccia a riga di comando e le API
checktimeout supervisione bambini
Consente di acquisire l'intervallo di timeout dei controlli della supervisione (in secondi) sul bambino.
Se il dispositivo è un bambino assonnato e non riceve una risposta dal genitore entro il timeout di controllo specificato, avvia il processo di ricollegamento (scambio di richiesta/risposta di aggiornamento del figlio MLE con il genitore).
Parametri
Nessun parametro.
Esempi
childsupervision checktimeout
30
Done
Riferimenti per l'interfaccia a riga di comando e le API
intervallo supervisione figlio (impostato)
Consente di impostare l'intervallo di supervisione (in secondi) del bambino.
Parametri
childsupervision interval interval-seconds
Esempi
childsupervision interval 30
Done
Riferimenti per l'interfaccia a riga di comando e le API
intervallo supervisione bambino
Restituisce l'intervallo di supervisione dei minori (in secondi) su un bambino.
La funzionalità Supervisione dei bambini offre ai genitori un meccanismo per assicurarsi che ogni bambino assonnato venga inviato un messaggio nell'intervallo di supervisione. Se non avviene alcuna trasmissione al bambino entro l'intervallo di supervisione, OpenThread mette in coda e invia un messaggio relativo alla supervisione del bambino.
Parametri
Nessun parametro.
Esempi
childsupervision interval
30
Done
Riferimenti per l'interfaccia a riga di comando e le API
timeout secondario (impostato)
Imposta il timeout (in secondi) del thread secondario del thread utilizzato quando operi nel ruolo secondario.
Parametri
childtimeout timeout-seconds
Esempi
childtimeout 300
Done
Riferimenti per l'interfaccia a riga di comando e le API
timeout figlio
Restituisce il timeout (in secondi) del thread secondario del thread utilizzato quando utilizzi il ruolo secondario.
Parametri
Nessun parametro.
Esempi
childtimeout
300
Done
Riferimenti per l'interfaccia a riga di comando e le API
annulla coap
Annulla una sottoscrizione di osservazione esistente a una risorsa remota sul server CoAP.
Parametri
Nessun parametro.
Esempi
coap cancel
Done
Riferimenti per l'interfaccia a riga di comando e le API
eliminazione coap
Elimina la risorsa CoAP specificata.
Parametri
coap delete address uri-path [type] [payload]
address
: indirizzo IPv6 del server CoAP.uri-path
: percorso URI della risorsa.type
:con
: confermabilenon-con
: non confermabile (valore predefinito)
payload
: la stringa del payload CoAP. Ad esempio,hellothere
.
Esempi
coap delete fdde:ad00:beef:0:2780:9423:166c:1aac test-resource con hellothere
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
coap getta
Recupera informazioni sulla risorsa CoAP specificata sul server CoAP.
Parametri
coap get address uri-path [type]
address
: indirizzo IPv6 del server CoAP.uri-path
: percorso URI della risorsa.type
:con
: confermabilenon-con
: non confermabile (valore predefinito)block-
: utilizza questa opzione, seguita dal valore a livello di blocco, se la risposta deve essere trasferita a livello di blocco. I valori validi sono:block-16
,block-32
,block-64
,block-128
,block-256
,block-512
oblock-1024
.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
coap osserva
Attiva una richiesta di abbonamento che consente al client CoAP di osservare la risorsa specificata sul server CoAP al fine di verificare eventuali modifiche dello stato.
Parametri
coap observe address uri-path [type]
address
: indirizzo IPv6 del server CoAP.uri-path
: percorso URI della risorsa.type
:con
: confermabilenon-con
: non confermabile (impostazione predefinita).
Esempi
coap observe fdde:ad00:beef:0:2780:9423:166c:1aac test-resource
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
parametri coap(get,set)
Recupera i valori parametro CoAP correnti se il comando viene eseguito senza parametri facoltativi.
Imposta i parametri CoAP sui valori predefiniti o sui valori specificati, a seconda della sintassi scelta.
Parametri
coap parameters type [default | ack_timeout ack_random_factor_numerator ack_random_factor_denominator max_retransmit]
type
:request
per le richieste CoAP oresponse
per le risposte CoAP. Se non vengono forniti altri parametri, il comando visualizza la configurazione corrente.default
: imposta i parametri di trasmissione sui seguenti valori predefiniti:ack_timeout
: 2000 millisecondiack_random_factor_numerator
: 3ack_random_factor_denominator
: 2max_retransmit
: 4
ack_timeout
:ACK_TIMEOUT
(0-UINT32_MAX) in millisecondi. Fai riferimento a RFC7252.ack_random_factor_numerator
: il numeratoreACK_RANDOM_FACTOR
, con possibili valori compresi tra 0 e 255. Fai riferimento a RFC7252.ack_random_factor_denominator
: il denominatoreACK_RANDOM_FACTOR
, con valori possibili compresi tra 0 e 255. Fai riferimento a RFC7252.max_retransmit
:MAX_RETRANSMIT
(0-255). Fai riferimento a RFC7252.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
post coap
Crea la risorsa CoAP specificata. Per saperne di più, consulta Testare la connettività a una risorsa CoAP (Constrained Application Protocol) utilizzando l'interfaccia a riga di comando OT.
Parametri
coap post address uri-path [type] [payload]
address
: indirizzo IPv6 del server CoAP.uri-path
: percorso URI della risorsa.type
:con
: confermabilenon-con
: non confermabile (valore predefinito)block-
: utilizza questa opzione, seguita dal valore a blocchi, per inviare blocchi con un numero generato casualmente di byte per il payload. I valori validi sono:block-16
,block-32
,block-64
,block-128
,block-256
,block-512
oblock-1024
.
payload
: richiesta di payload CoAP, che, se utilizzata, è una stringa o un numero intero, a seconda ditype
. Setype
ècon
onon-con
, il parametropayload
è facoltativo. Se non specifichi il parametropayload
, viene inviato un payload vuoto. Tuttavia, se utilizzi il parametropayload
, il valore deve essere una stringa, ad esempiohellothere
. Setype
èblock-
, il valore del parametropayload
deve essere un numero intero che specifica il numero di blocchi da inviare. Il tipo diblock-
richiede l'impostazione diOPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
coap putt
Modifica la risorsa CoAP specificata. Per saperne di più, consulta Testare la connettività a una risorsa CoAP (Constrained Application Protocol) utilizzando l'interfaccia a riga di comando OT.
Parametri
coap put address uri-path [type] [payload]
address
: indirizzo IPv6 del server CoAP.uri-path
: percorso URI della risorsa.type
:con
: confermabilenon-con
: non confermabile (valore predefinito)block-
: utilizza questa opzione, seguita dal valore a blocchi, per inviare blocchi con un numero generato casualmente di byte per il payload. I valori validi sono:block-16
,block-32
,block-64
,block-128
,block-256
,block-512
oblock-1024
.
payload
: richiesta di payload CoAP, che, se utilizzata, è una stringa o un numero intero, a seconda ditype
. Setype
ècon
onon-con
, il parametropayload
è facoltativo. Se non specifichi il parametropayload
, viene inviato un payload vuoto. Tuttavia, se utilizzi il parametropayload
, il valore deve essere una stringa, ad esempiohellothere
. Setype
èblock-
, il valore del parametropayload
deve essere un numero intero che specifica il numero di blocchi da inviare. Il tipo diblock-
richiede l'impostazione diOPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
risorsa coap (get,set)
Ottiene o imposta il percorso dell'URI della risorsa del server CoAP.
Parametri
coap resource [uri-path]
Esempi
coap resource test-resource
Done
coap resource
test-resource
Done
Riferimenti per l'interfaccia a riga di comando e le API
coap set
Imposta i contenuti inviati dalla risorsa sul server CoAP. Se un client CoAP sta osservando la risorsa, gli viene inviata una notifica.
Parametri
coap set new-content
Esempi
coap set Testing123
Done
Riferimenti per l'interfaccia a riga di comando e le API
inizio coap
Avvia il server CoAP. Per saperne di più, consulta Testare la connettività a una risorsa CoAP (Constrained Application Protocol) utilizzando l'interfaccia a riga di comando OT.
Parametri
Nessun parametro.
Esempi
coap start
Done
Riferimenti per l'interfaccia a riga di comando e le API
coap stop
Arresta il server CoAP.
Parametri
Nessun parametro.
Esempi
coap stop
Done
Riferimenti per l'interfaccia a riga di comando e le API
Coaps Connect
Inizializza una sessione DTLS (Datagram Transport Layer Security) con un peer. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.
Parametri
coaps connect address
Il parametro address
è l'indirizzo IPv6 del peer.
Esempi
coaps connect fdde:ad00:beef:0:9903:14b:27e0:5744
Done
coaps connected
Riferimenti per l'interfaccia a riga di comando e le API
eliminazione coaps
La stringa del payload CoAPS da eliminare.
Parametri
coaps delete uri-path [type] [payload]
uri-path
: percorso URI della risorsa.type
:con
: confermabilenon-con
: non confermabile (valore predefinito)
payload
: richiesta di payload CoAPS.
Esempi
coaps delete test-resource con hellothere
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
coaps disconnessione
Interrompe la sessione DTLS.
Parametri
Nessun parametro.
Esempi
coaps disconnect
coaps disconnected
Done
Riferimenti per l'interfaccia a riga di comando e le API
i poliziotti prendono
Recupera informazioni sulla risorsa CoAPS specificata sul server CoAPS. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.
Parametri
coaps get uri-path [type]
uri-path
: percorso URI della risorsa.type
:con
: confermabilenon-con
: non confermabile (valore predefinito)block-
: utilizza questa opzione, seguita dal valore a livello di blocco, se la risposta deve essere trasferita a livello di blocco. I valori validi sono:block-16
,block-32
,block-64
,block-128
,block-256
,block-512
oblock-1024
.
Esempi
coaps get test-resource
Done
coaps get test-resource block-1024
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
coaps ischiudi
Indica se il servizio CoAP Secure è chiuso. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.
Parametri
Nessun parametro.
Esempi
coaps isclosed
no
Done
Riferimenti per l'interfaccia a riga di comando e le API
coaps non è attivo
Indica se la connessione al servizio CoAP Secure è attiva (già connessa o in fase di connessione). Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.
Parametri
Nessun parametro.
Esempi
coaps isconnactive
yes
Done
Riferimenti per l'interfaccia a riga di comando e le API
coaps è connesso
Indica se il servizio CoAP Secure è connesso. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.
Parametri
Nessun parametro.
Esempi
coaps isconnected
yes
Done
Riferimenti per l'interfaccia a riga di comando e le API
post coaps
Crea la risorsa CoAPS specificata. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.
Parametri
uri-path [type] [payload]
uri-path
: percorso URI della risorsa.type
:con
: confermabilenon-con
: non confermabile (valore predefinito)block-
: utilizza questa opzione, seguita dal valore a blocchi, per inviare blocchi con un numero generato casualmente di byte per il payload. I valori validi sono:block-16
,block-32
,block-64
,block-128
,block-256
,block-512
oblock-1024
.
payload
: richiesta di payload CoAPS che, se utilizzata, è una stringa o un numero intero, a seconda ditype
. Setype
ècon
onon-con
, il parametro del payload è facoltativo. Se il parametro payload viene tralasciato, viene inviato un payload vuoto. Tuttavia, se utilizzi il parametro payload, il suo valore deve essere una stringa, ad esempiohellothere
. Setype
èblock-
, il valore del parametro payload deve essere un numero intero che specifica il numero di blocchi da inviare. Il tipo diblock-
richiede l'impostazione diOPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
.
Esempi
coaps post test-resource con hellothere
Done
coaps post test-resource block-1024 10
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
coaps psk
Imposta la chiave precondivisa (PSK) e il pacchetto di crittografia DTLS_PSK_WITH_AES_128_CCM_8.
Parametri
coaps psk psk-value psk-id
psk-value
: la chiave precondivisapsk-id
: l'identificatore della chiave precondivisa.
Esempi
coaps psk 1234 key1
Done
Riferimenti per l'interfaccia a riga di comando e le API
coaps put
Modifica la risorsa CoAPS specificata. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.
Parametri
uri-path [type] [payload]
uri-path
: percorso URI della risorsa.type
:con
: confermabilenon-con
: non confermabile (valore predefinito)block-
: utilizza questa opzione, seguita dal valore a blocchi, per inviare blocchi con un numero generato casualmente di byte per il payload. I valori validi sono:block-16
,block-32
,block-64
,block-128
,block-256
,block-512
oblock-1024
.
payload
: richiesta di payload CoAPS che, se utilizzata, è una stringa o un numero intero, a seconda ditype
. Setype
ècon
onon-con
, il parametro del payload è facoltativo. Se il parametro payload viene tralasciato, viene inviato un payload vuoto. Tuttavia, se utilizzi il parametro payload, il suo valore deve essere una stringa, ad esempiohellothere
. Setype
èblock-
, il valore del parametro payload deve essere un numero intero che specifica il numero di blocchi da inviare. Il tipo diblock-
richiede l'impostazione diOPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE
.
Esempi
coaps put test-resource con hellothere
Done
coaps put test-resource block-1024 10
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
risorsa coaps (get,set)
Ottiene o imposta il percorso dell'URI della risorsa del server CoAPS. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.
Parametri
coaps resource [uri-path]
Esempi
coaps resource test-resource
Done
coaps resource
test-resource
Done
Riferimenti per l'interfaccia a riga di comando e le API
coaps impostati
Imposta i contenuti inviati dalla risorsa sul server CoAPS. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.
Parametri
coaps set new-content
Esempi
coaps set Testing123
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
inizio coaps
Avvia il servizio CoAP Secure. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.
Parametri
coaps start [check-peer-cert | max-conn-attempts]
Il parametro check-peer-cert
determina se il controllo del certificato peer è attivato (impostazione predefinita) o disattivato. Il parametro max-conn-attempts
imposta il numero massimo di tentativi consentiti, riusciti o non, per la connessione al server sicuro CoAP. Il valore predefinito di questo parametro è 0
, il che significa che non esiste un limite al numero di tentativi. I parametri check-peer-cert
e max-conn-attempts
funzionano insieme nelle seguenti combinazioni, anche se puoi specificare un solo argomento:
- Nessun argomento specificato: vengono utilizzati i valori predefiniti.
- Impostando
check-peer-cert
sutrue
: ha lo stesso effetto dell'omissione dell'argomento, ovvero il valorecheck-peer-cert
ètrue
e il valoremax-conn-attempts
è 0. - Se imposti
check-peer-cert
sufalse
: il valore dicheck-peer-cert
èfalse
, mentre il valore dimax-conn-attempts
è 0. - Specificare un numero:
check-peer-cert
ètrue
, mentre il valoremax-conn-attempts
è il numero specificato nell'argomento.
Esempi
coaps start
Done
coaps start false
Done
coaps start 8
Done
Riferimenti per l'interfaccia a riga di comando e le API
coaps stop
Arresta il servizio CoAP Secure. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.
Parametri
Nessun parametro.
Esempi
coaps stop
Done
Riferimenti per l'interfaccia a riga di comando e le API
coaps x509
Imposta il certificato X509 del dispositivo locale con la chiave privata corrispondente per la sessione DTLS con DTLS_ECDHE_ECDSA_WITH_AES_128_CCM_8
.
Parametri
Nessun parametro.
Esempi
coaps x509
Done
Riferimenti per l'interfaccia a riga di comando e le API
annuncio del commissario
Invia un messaggio Annuncia inizio.
Parametri
commissioner announce mask count period destination
mask
: Bitmask che identifica i canali per l'invio di messaggi MLEAnnounce
.count
: numero di trasmissioni MLEAnnounce
per canale.period
: numero di millisecondi tra trasmissioniAnnounce
MLE successive.destination
: indirizzo IPv6 di destinazione per il messaggio. Il messaggio potrebbe essere multicast.
Esempi
commissioner announce 0x00050000 2 32 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Riferimenti per l'interfaccia a riga di comando e le API
energia del commissario
Invia un messaggio Query sulla scansione dei consumi energetici. L'output del comando viene stampato quando viene ricevuto.
Parametri
commissioner energy mask count period scanDuration destination
mask
: maschera di bit che identifica i canali per eseguire le scansioni dell'energia secondo lo standard IEEE 802.15.4.count
: numero di scansioni dell'energia secondo lo standard IEEE 802.15.4 per canale.period
: numero di millisecondi tra scansioni successive dell'energia secondo lo standard IEEE 802.15.4.scanDuration
: durata della scansione in millisecondi da utilizzare durante una scansione energetica IEEE 802.15.4.destination
: indirizzo IPv6 di destinazione per il messaggio. Il messaggio potrebbe essere multicast.
Esempi
commissioner energy 0x00050000 2 32 1000 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Energy: 00050000 0 0 0 0
Riferimenti per l'interfaccia a riga di comando e le API
ID commissario (get,set)
Ottiene o imposta il nome ID OpenThread Commissioner.
Parametri
commissioner id name
Esempi
commissioner id OpenThread Commissioner
Done
commissioner id
OpenThread Commissioner
Done
Riferimenti per l'interfaccia a riga di comando e le API
aggiunta commissario joiner
Aggiunge una voce del joiner.
Parametri
commissioner joiner add eui64|discerner pksd [timeout]
eui64
: IEEE EUI-64 del Joiner. Per trovare una corrispondenza con qualsiasi membro, usa*
.discerner
: l'indice Joiner nel formatonumber/length
.pksd
: chiave precondivisa per il joiner.timeout
: il timeout del joiner in secondi.
Esempi
commissioner joiner add d45e64fa83f81cf7 J01NME
Done
commissioner joiner add 0xabc/12 J01NME
Done
Riferimenti per l'interfaccia a riga di comando e le API
rimozione commissioner joiner
Rimuove una voce Joiner.
Parametri
commissioner joiner remove eui64|discerner
eui64
: IEEE EUI-64 dell'abbonato. Per trovare una corrispondenza con qualsiasi membro, usa*
.discerner
: l'indice del joiner nel formatonumber/length
.
Esempi
commissioner joiner remove d45e64fa83f81cf7
Done
commissioner joiner remove 0xabc/12
Done
Riferimenti per l'interfaccia a riga di comando e le API
tabella commissario joiner
Elenca tutte le voci Joiner in formato tabella.
Parametri
Nessun parametro.
Esempi
commissioner joiner table
| ID | PSKd | Expiration |
+-----------------------+----------------------------------+------------+
| * | J01NME | 81015 |
| d45e64fa83f81cf7 | J01NME | 101204 |
| 0x0000000000000abc/12 | J01NME | 114360 |
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
gestione del commissario
Invia un messaggio MGMT_GET
(Management Get) al leader. Vengono restituiti i valori della variabile impostati utilizzando il comando commissioner mgmtset
.
Parametri
commissioner mgmtget [locator] [sessionid] [steeringdata] [joinerudpport] [-x TLVs]
locator
: router di confine RLOC16.sessionid
: ID sessione del Commissioner.steeringdata
: dati sull'indirizzamento.joinerudpport
: porta UDP del joiner.TLVs
: l'insieme di TLV da recuperare.
Esempi
commissioner mgmtget locator sessionid
Done
Riferimenti per l'interfaccia a riga di comando e le API
gestione del commissario
Invia un messaggio MGMT_SET
(set di gestione) al leader e imposta le variabili sui valori specificati.
Parametri
commissioner mgmtset [locator locator] [sessionid sessionid] [steeringdata steeringdata] [joinerudpport joinerudpport] [-x TLVs]
locator
: router di confine RLOC16.sessionid
: ID sessione del Commissioner.steeringdata
: dati sull'indirizzamento.joinerudpport
: porta UDP del joiner.TLVs
: l'insieme di TLV da recuperare.
Esempi
commissioner mgmtset joinerudpport 9988
Done
Riferimenti per l'interfaccia a riga di comando e le API
commissario panid
Invia una query sull'ID PAN. L'output comando viene restituito quando viene ricevuto.
Parametri
commissioner panid panid mask destination
paind
: ID PAN da utilizzare per verificare la presenza di conflitti.mask
; Maschera di bit che identifica i canali per eseguire scansioni attive IEEE 802.15.4.destination
: indirizzo di destinazione IPv6 per il messaggio. Il messaggio potrebbe essere multicast.
Esempi
commissioner panid 0xdead 0x7fff800 fdde:ad00:beef:0:0:ff:fe00:c00
Done
Conflict: dead, 00000800
Riferimenti per l'interfaccia a riga di comando e le API
URL provisioning commissario
Imposta l'URL di provisioning del Commissioner.
Parametri
commissioner provisioningurl provisioningurl
Esempi
commissioner provisioningurl http://github.com/openthread/openthread
Done
Riferimenti per l'interfaccia a riga di comando e le API
commissario Richiedi
Ottiene l'ID sessione attuale di Commissioner.
Parametri
Nessun parametro.
Esempi
commissioner sessionid
0
Done
Riferimenti per l'interfaccia a riga di comando e le API
inizio commissario
Avvia il ruolo Thread Commissioner.
Parametri
Nessun parametro.
Esempi
commissioner start
Commissioner: petitioning
Done
Commissioner: active
Riferimenti per l'interfaccia a riga di comando e le API
stato commissario
Restituisce lo stato attuale del Commissioner. I valori possibili sono active
, disabled
o petition
(che presenta la petizione per diventare Commissioner).
Parametri
Nessun parametro.
Esempi
commissioner state
active
Done
Riferimenti per l'interfaccia a riga di comando e le API
fermata del commissario
Interrompe il ruolo Thread Commissioner.
Parametri
Nessun parametro.
Esempi
commissioner stop
Done
Riferimenti per l'interfaccia a riga di comando e le API
contestoreutilizzato (get,set)
Consente di acquisire o impostare il valore CONTEXT_ID_REUSE_DELAY
.
Parametri
contextreusedelay delay
Utilizza l'argomento facoltativo delay
per impostare CONTEXT_ID_REUSE_DELAY
.
Esempi
contextreusedelay
11
Done
contextreusedelay 11
Done
Riferimenti per l'interfaccia a riga di comando e le API
contatori (mac)
Ottieni i contatori degli strati MAC.
Parametri
counters mac
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
contatori (mle)
Ottiene i contatori di Thread MLE.
Parametri
counters mle
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
contatori
Ottiene i nomi dei contatori supportati.
Parametri
Nessun parametro.
Esempi
counters
ip
mac
mle
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
IP contatori
Ottiene i contatori IPv6.
Parametri
counters ip
Esempi
counters ip
TxSuccess: 10
TxFailed: 0
RxSuccess: 5
RxFailed: 0
Done
Riferimenti per l'interfaccia a riga di comando e le API
contatori ip reimpostati
Reimposta i contatori IPv6.
Parametri
counters ip reset
Esempi
counters ip reset
Done
Riferimenti per l'interfaccia a riga di comando e le API
contatori MAC reset
Reimposta i contatori del livello MAC.
Parametri
counters mac reset
Esempi
counters mac reset
Done
Riferimenti per l'interfaccia a riga di comando e le API
reimpostazione dei contatori
Reimposta i contatori di Thread MLE.
Parametri
counters mle reset
Esempi
counters mle reset
Done
Riferimenti per l'interfaccia a riga di comando e le API
canale CSS
Imposta il canale CSL.
Parametri
csl channel channel
Esempi
csl channel 20
Done
Riferimenti per l'interfaccia a riga di comando e le API
CSS
Recupera la configurazione CSL.
Parametri
Nessun parametro.
Esempi
csl
Channel: 11
Period: 160000us
Timeout: 1000s
Done
Riferimenti per l'interfaccia a riga di comando e le API
periodo CSS
Imposta il periodo CSL in microsecondi.
Disabilita CSL impostando questo parametro su 0
.
Il periodo CSL DEVE essere un multiplo di OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC
, altrimenti viene restituito OT_ERROR_INVALID_ARGS
.
Parametri
csl period period
Esempi
csl period 3000000
Done
Riferimenti per l'interfaccia a riga di comando e le API
timeout csl
Imposta il timeout CSL in secondi.
Parametri
csl timeout timeout
Esempi
cls timeout 10
Done
Riferimenti per l'interfaccia a riga di comando e le API
set di dati attivo
Recupera il set di dati operativo attivo.
L'interfaccia a riga di comando OT utilizza i membri otOperationalDataset per restituire i valori del set di dati alla console.
Parametri
dataset active [-x]
L'argomento facoltativo -x
stampa i valori del set di dati operativo attivo come TLV con codifica esadecimale.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
set di dati activetimestamp (get, set)
Ottiene o imposta otOperationalDataset::mActiveTimestamp.
Parametri
dataset activetimestamp [timestamp]
Trasmetti l'argomento facoltativo timestamp
per impostare il timestamp attivo.
Esempi
dataset activetimestamp
123456789
Done
dataset activetimestamp 123456789
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
canale del set di dati (get,set)
Ottiene o imposta otOperationalDataset::mChannel.
Parametri
dataset channel [channel-num]
Utilizza l'argomento facoltativo channel-num
per impostare il canale.
Esempi
dataset channel
12
Done
dataset channel 12
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
maschera di canale del set di dati (get,set)
Ottiene o imposta otOperationalDataset::mChannelMask
Parametri
dataset channelmask [channel-mask]
Utilizza l'argomento facoltativo channel-mask
per impostare la maschera del canale.
Esempi
dataset channelmask
0x07fff800
Done
dataset channelmask 0x07fff800
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
cancellazione set di dati
Reimposta il buffer del set di dati operativo.
Parametri
Nessun parametro.
Esempi
dataset clear
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
commit del set di dati attivo
Esegui il commit del buffer del set di dati operativo in set di dati operativo attivo.
Parametri
Nessun parametro.
Esempi
dataset commit active
Done
Riferimenti per l'interfaccia a riga di comando e le API
commit del set di dati in attesa
Esegui il commit del buffer del set di dati operativo in set di dati operativo in attesa.
Parametri
Nessun parametro.
Esempi
dataset commit pending
Done
Riferimenti per l'interfaccia a riga di comando e le API
ritardo del set di dati (get,set)
Ottiene o imposta otOperationalDataset::mDelay.
Parametri
dataset delay [delay]
Utilizza l'argomento facoltativo delay
per impostare il valore del timer di ritardo.
Esempi
dataset delay
1000
Done
dataset delay 1000
Done
Riferimenti per l'interfaccia a riga di comando e le API
extpanid del set di dati (get,set)
Ottiene o imposta otOperationalDataset::mExtendedPanId.
Parametri
dataset extpanid [extpanid]
Utilizza l'argomento facoltativo extpanid
per impostare l'ID Extended Personal Area Network.
Esempi
dataset extpanid
000db80123456789
Done
dataset extpanid 000db80123456789
Done
Riferimenti per l'interfaccia a riga di comando e le API
guida per il set di dati
Recupera un elenco di comandi dell'interfaccia a riga di comando dataset
. Per saperne di più, consulta Visualizzare e gestire i set di dati con l'interfaccia a riga di comando OT.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
init set di dati (active,new,pending,tlvs)
L'interfaccia a riga di comando OT controlla active
, pending
o tlvs
e restituisce i valori corrispondenti. Altrimenti, l'interfaccia a riga di comando OT crea una nuova rete casuale e restituisce un nuovo set di dati.
Parametri
dataset init {active|new|pending|tlvs} [hex-encoded-tlvs]
Usa new
per inizializzare un nuovo set di dati, quindi inserisci il comando dataset commit active
. Utilizza tlvs
per i TLV con codifica esadecimale.
Esempi
dataset init new
Done
Riferimenti per l'interfaccia a riga di comando e le API
set di dati meshlocalprefix (get,set)
Ottiene o imposta otOperationalDataset::mMeshLocalPrefix.
Parametri
dataset meshlocalprefix [meshlocalprefix]
Utilizza l'argomento facoltativo meshlocalprefix
per impostare il prefisso mesh-locale.
Esempi
dataset meshlocalprefix
fd00:db8:0:0::/64
Done
dataset meshlocalprefix fd00:db8:0:0::
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
comando gestione set di dati attivo
Invia MGMT_ACTIVE_GET.
L'interfaccia a riga di comando OT invia un messaggio MGMT_ACTIVE_GET con gli argomenti pertinenti. Per scoprire di più su questi parametri e sulle mappature degli argomenti, consulta Visualizzare e gestire i set di dati con l'interfaccia a riga di comando OT.
Parametri
dataset mgmtgetcommand active [address leader-address] [dataset-components] [-x tlv-list]
- Usa
address
per specificare la destinazione IPv6. altrimenti viene usato come predefinito l'ALOC leader. - Per
dataset-components
, puoi passare qualsiasi combinazione di otOperationalDatasetComponents, ad esempioactivetimestamp
,pendingtimestamp
onetworkkey
. - L'argomento facoltativo
-x
specifica i TLV non elaborati da richiedere.
Esempi
dataset mgmtgetcommand active address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done
dataset mgmtgetcommand active networkname
Done
Riferimenti per l'interfaccia a riga di comando e le API
- otDatasetSendMgmtActiveGet
- comando gestione set di dati in attesa
- comando gestione set di dati attivo
- comando mgmtsetset di dati in attesa
set di comandi mgmtgetcommand in attesa
Invia MGMT_PENDING_GET.
Parametri
dataset mgmtgetcommand pending [address leader-address] [dataset-components] [-x tlv-list]
Per scoprire di più su questi parametri e sulle mappature degli argomenti, consulta Visualizzare e gestire i set di dati con l'interfaccia a riga di comando OT.
Esempi
dataset mgmtgetcommand pending address fdde:ad00:beef:0:558:f56b:d688:799 activetimestamp securitypolicy
Done
dataset mgmtgetcommand pending networkname
Done
Riferimenti per l'interfaccia a riga di comando e le API
- otDatasetSendMgmtPendingGet
- comando gestione set di dati attivo
- comando gestione set di dati attivo
- comando mgmtsetset di dati in attesa
Comando gestione set di dati attivo
Invia MGMT_ACTIVE_SET.
Parametri
dataset mgmtsetcommand active [dataset-components] [-x tlv-list]
Per scoprire di più su questi parametri e sulle mappature degli argomenti, consulta Visualizzare e gestire i set di dati con l'interfaccia a riga di comando OT.
Esempi
dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrcb
Done
Riferimenti per l'interfaccia a riga di comando e le API
- otDatasetSendMgmtActiveSet
- comando gestione set di dati attivo
- comando gestione set di dati in attesa
- comando mgmtsetset di dati in attesa
comando mgmtsetset set di dati in attesa
Invia MGMT_PENDING_SET.
Parametri
dataset mgmtsetcommand pending [dataset-components] [-x tlv-list]
Per scoprire di più su questi parametri e sulle mappature degli argomenti, consulta Visualizzare e gestire i set di dati con l'interfaccia a riga di comando OT.
Esempi
dataset mgmtsetcommand pending activetimestamp 123 securitypolicy 1 onrcb
Done
Riferimenti per l'interfaccia a riga di comando e le API
- otDatasetSendMgmtPendingSet
- comando gestione set di dati attivo
- comando gestione set di dati in attesa
- comando gestione set di dati attivo
chiave di rete del set di dati (get,set)
Ottiene o imposta otOperationalDataset::mNetworkKey.
Parametri
dataset networkkey [key]
Utilizza l'argomento facoltativo key
per impostare la chiave di rete.
Esempi
dataset networkkey
00112233445566778899aabbccddeeff
Done
dataset networkkey 00112233445566778899aabbccddeeff
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
nome rete del set di dati (get,set)
Ottiene o imposta otOperationalDataset::mNetworkName.
Parametri
dataset networkname [name]
Utilizza l'argomento facoltativo name
per impostare il nome della rete.
Esempi
dataset networkname
OpenThread
Done
dataset networkname OpenThread
Done
Riferimenti per l'interfaccia a riga di comando e le API
panid set di dati (get,set)
Ottiene o imposta otOperationalDataset::mPanId.
Parametri
dataset panid [panid]
Utilizza l'argomento facoltativo panid
per impostare l'ID PAN.
Esempi
dataset panid
0x1234
Done
dataset panid 0x1234
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
set di dati in attesa (get,set)
Ottiene o imposta otOperationalDataset::mPendingTimestamp.
Parametri
dataset pendingtimestamp [timestamp]
Utilizza l'argomento facoltativo timestamp
per impostare i secondi del timestamp in attesa.
Esempi
dataset pendingtimestamp
123456789
Done
dataset pendingtimestamp 123456789
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
dataset pskc (get,set)
Ottiene o imposta otOperationalDataset::mPskc.
Parametri
dataset pskc [-p passphrase] | [key]
Solo per FTD, utilizza -p
con l'argomento passphrase
. -p
genera un codice pskc a partire dalla codifica passphrase
UTF-8 che fornisci, insieme al nome della rete e all'ID PAN esteso. Se impostato, -p
utilizza il buffer del set di dati. altrimenti utilizza lo stack attuale. In alternativa, puoi impostare pskc come key
(formato esadecimale).
Esempi
dataset pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done
dataset pskc -p 123456
Done
dataset pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
criterio di sicurezza del set di dati (get,set)
Consente di acquisire o impostare il criterio di sicurezza del set di dati.
Parametri
dataset securitypolicy [rotationtime [onrcCepR]]
- Utilizza
rotationtime
perthrKeyRotation
, in unità di ore. - I comandi del criterio di sicurezza utilizzano le mappature di argomento
onrcCepR
per recuperare e impostare i membri otSecurityPolicy, ad esempioo
rappresenta otSecurityPolicy::mObtainNetworkKeyEnabled. Per saperne di più, consulta Visualizzare e gestire i set di dati con l'interfaccia a riga di comando OT.
Esempi
dataset securitypolicy
672 onrc
Done
dataset securitypolicy 672 onrc
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
set di dati impostato (attivo,in attesa)
Imposta il set di dati operativo attivo.
Se il set di dati non include un timestamp attivo, significa che è completato solo parzialmente.
Se Thread è abilitato su un dispositivo che ha un set di dati attivo parzialmente completo, il dispositivo tenterà di collegarsi a una rete Thread esistente utilizzando qualsiasi informazione esistente nel set di dati. Per il collegamento a una rete è necessaria solo la chiave di rete Thread.
Se il canale non è incluso nel set di dati, il dispositivo invierà messaggi di annuncio MLE su canali diversi per trovare vicini su altri canali.
Se il dispositivo si collega correttamente a una rete Thread, il dispositivo recupererà l'intero set di dati attivo dalla rete principale. Tieni presente che un dispositivo compatibile con il router non passerà ai ruoli Router o Leader finché non avrà un set di dati attivo completo.
Questa funzione restituisce costantemente OT_ERROR_NONE
e può essere trattata come se avesse un tipo restituito void
. In precedenza, altri errori (ad es. OT_ERROR_NOT_IMPLEMENTED
) sono state consentite per motivi precedenti. Tuttavia, poiché l'archiviazione permanente è ora obbligatoria per le operazioni Thread, qualsiasi errore di salvataggio del set di dati attiverà un'asserzione. Il tipo restituito otError
viene conservato per compatibilità con le versioni precedenti.
Il comando dataset set
dell'interfaccia a riga di comando imposta il set di dati operativo attivo utilizzando TLV con codifica esadecimale.
Parametri
dataset set {active|pending} tlvs
Esempi
dataset set active 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done
dataset set pending 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done
Riferimenti per l'interfaccia a riga di comando e le API
tlv del set di dati
Converte un determinato set di dati operativo in
otOperationalDatasetTlvs
.
Parametri
Nessun parametro.
Esempi
dataset tlvs
0e080000000000010000000300001635060004001fffe0020...f7f8
Done
Riferimenti per l'interfaccia a riga di comando e le API
annulla aggiornamento set di dati
Annulla una richiesta di aggiornamento del set di dati operativo in corso (se presente).
Disponibile quando OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
è attivato.
Parametri
Nessun parametro.
Esempi
@dataset updater cancel
Done
Riferimenti per l'interfaccia a riga di comando e le API
strumento di aggiornamento set di dati
Indica se è in corso una richiesta di aggiornamento del set di dati dell'operazione.
Disponibile quando OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
è attivato.
Parametri
Nessun parametro.
Esempi
dataset updater
Enabled
Done
Riferimenti per l'interfaccia a riga di comando e le API
avvio programma di aggiornamento set di dati
Richiedi un aggiornamento del set di dati operativo.
Disponibile quando OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
è attivato.
aDataset
deve contenere i campi da aggiornare e il relativo nuovo valore. Non deve contenere campi Timestamp attivi o in attesa. Il campo Delay è facoltativo. Se non viene fornito un valore predefinito (1000 ms), viene utilizzato il valore predefinito.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
debug
Esegue una serie di comandi dell'interfaccia a riga di comando per raccogliere informazioni sul dispositivo e sulla rete di thread. Questa funzionalità è destinata al debug. L'output mostrerà ogni comando dell'interfaccia a riga di comando eseguito preceduto da $
, seguito dall'output generato del comando corrispondente. L'output generato include le seguenti informazioni:
- Versione
- Stato attuale
- RLOC16, indirizzo MAC esteso
- Elenco di indirizzi IPv6 Unicast e multicast
- Canale
- ID PAN e ID PAN esteso
- Dati di rete
- ID partizione
- Dati leader
Se il dispositivo funziona come FTD:
- Tabella del publisher secondario e del vicino
- Informazioni sulla tabella router e sull'hop successivo
- Tabella della cache degli indirizzi
- Indirizzo IPv6 secondario MTD registrato
- Proprietà dispositivo
Se il dispositivo supporta e agisce come client SRP:
- Stato client SRP
- Informazioni sull'host e sui servizi client SRP
Se il dispositivo supporta e funge da server SRP:
- Modalità indirizzo e stato del server SRP
- Host e servizi registrati del server SRP
Se il dispositivo supporta TREL:
- Stato TREL e tabella delle app peer
Se il dispositivo supporta e funge da router di confine:
- Stato BR
- Prefissi BR (OMR, on-link, NAT64)
- Tabella dei prefissi rilevati
Parametri
Nessun parametro.
Esempi
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
scheduletimermin (impostato)
Imposta il timer per il ritardo minimo (in secondi).
Parametri
delaytimermin delaytimermin
Esempi
delaytimermin 60
Done
Riferimenti per l'interfaccia a riga di comando e le API
ritardo
Ottieni il timer con il ritardo minimo (in secondi).
Parametri
Nessun parametro.
Esempi
delaytimermin
30
Done
Riferimenti per l'interfaccia a riga di comando e le API
scollega asincrono
Avvia il processo di scollegamento controllato, simile al comando detach
, senza bloccare e attendere il callback che indica che il scollegamento è terminato.
Parametri
Nessun parametro.
Esempi
detach async
Done
Riferimenti per l'interfaccia a riga di comando e le API
detach
Avvia il processo di scollegamento controllato inviando prima una notifica agli altri nodi (inviando una release dell'indirizzo se agisci come router o impostando il valore di Timeout secondario su zero per l'elemento padre se agisci come figlio), quindi interrompendo l'operazione del protocollo Thread.
Parametri
Nessun parametro.
Esempi
detach
Finished detaching
Done
Riferimenti per l'interfaccia a riga di comando e le API
deviceprops (insieme)
Consente di impostare le proprietà del dispositivo.
Parametri
deviceprops powerSupply isBr supportsCcm isUnstable weightAdjustment
powerSupply
: dovrebbe essere "battery", "external", "external-stable", "external-unstable".
Esempi
deviceprops battery 0 0 0 -5
Done
deviceprops
PowerSupply : battery
IsBorderRouter : no
SupportsCcm : no
IsUnstable : no
WeightAdjustment : -5
Done
Riferimenti per l'interfaccia a riga di comando e le API
deviceprops
Visualizza le proprietà attuali del dispositivo.
Richiede OPENTHREAD_CONFIG_MLE_DEVICE_PROPERTY_LEADER_WEIGHT_ENABLE
.
Parametri
Nessun parametro.
Esempi
deviceprops
PowerSupply : external
IsBorderRouter : yes
SupportsCcm : no
IsUnstable : no
WeightAdjustment : 0
Done
Riferimenti per l'interfaccia a riga di comando e le API
Discover
Eseguire un'operazione di rilevamento MLE.
Parametri
discover [channel]
channel
: il canale da scoprire. Se non viene fornito alcun canale, la scoperta coprirà tutti i canali validi.
Esempi
discover
| J | Network Name | Extended PAN | PAN | MAC Address | Ch | dBm | LQI |
+---+------------------+------------------+------+------------------+----+-----+-----+
| 0 | OpenThread | dead00beef00cafe | ffff | f1d92a82c8d8fe43 | 11 | -20 | 0 |
Done
Riferimenti per l'interfaccia a riga di comando e le API
scopri reqcallback (attiva,disattiva)
Imposta un callback per ricevere i dati delle richieste di rilevamento MLE.
Parametri
discover reqcallback enable|disable
Esempi
discover reqcallback enable
Done
Riferimenti per l'interfaccia a riga di comando e le API
navigazione DNS
Invia una query DNS di esplorazione (enumerazione delle istanze di servizio) per ottenere l'elenco dei servizi per un determinato nome di servizio
I parametri dopo service-name
sono facoltativi. Qualsiasi valore non specificato (o zero) per questi parametri facoltativi viene sostituito dal valore della configurazione predefinita corrente (dns config
).
Parametri
dns browse service-name [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
compressione dns (abilita,disabilita)
Imposta il valore di "compressione dei nomi DNS" .
Per impostazione predefinita, la compressione dei nomi DNS è abilitata. Se questa opzione è disattivata, i nomi DNS vengono aggiunti come completi e mai compressi. Questo è applicabile ai moduli client/server DNS e SRP di OpenThread." Il campo OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
è obbligatorio.
Parametri
dns compression [enable|disable]
Esempi
dns compression enable
Enabled
dns compression disable
Done
dns compression
Disabled
Done
Riferimenti per l'interfaccia a riga di comando e le API
compressione DNS
Indica se il valore di "compressione nome DNS" attiva o meno.
Questa funzionalità è destinata solo ai test ed è disponibile quando la configurazione di OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
è abilitata.
Per impostazione predefinita, la compressione dei nomi DNS è abilitata. Se questa opzione è disattivata, i nomi DNS vengono aggiunti come completi e mai compressi. Questo è applicabile ai moduli client/server DNS e SRP di OpenThread." Il campo OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
è obbligatorio.
Parametri
dns compression [enable|disable]
Esempi
dns compression
Enabled
Riferimenti per l'interfaccia a riga di comando e le API
configurazione DNS (set)
Imposta la configurazione predefinita delle query sul client DNS.
In un valore aConfig
non NULL, il chiamante può scegliere di lasciare non specificati alcuni dei campi dell'istanza
otDnsQueryConfig
(valore zero). I campi non specificati vengono sostituiti dalle definizioni delle opzioni di configurazione OT corrispondenti OPENTHREAD_CONFIG_DNS_CLIENTDEFAULT{}
per formare la configurazione delle query predefinita.
Quando la funzionalità OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_ADDRESS_AUTO_SET_ENABLE
è abilitata, l'indirizzo IPv6 del server nella configurazione predefinita viene impostato e aggiornato automaticamente dal client DNS. Questo viene fatto solo se l'utente non lo imposta o non lo specifica esplicitamente. Questo comportamento richiede l'attivazione del client SRP e della relativa funzionalità di avvio automatico. Il client SRP monitorerà quindi i dati di rete Thread per le voci del servizio DNS/SRP per selezionare un server SRP. L'indirizzo del server SRP selezionato viene anche impostato come indirizzo del server DNS nella configurazione predefinita.
Possiamo lasciare alcuni campi come non specificati (o utilizzare il valore zero). I campi non specificati vengono sostituiti dalle definizioni delle opzioni di configurazione OT corrispondenti OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT
per formare la configurazione delle query predefinita. Il campo OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE
è obbligatorio.
Parametri
dns config [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean] [service-mode] [protocol]
Esempi
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
ServiceMode: srv_txt_opt
Nat64Mode: allow
TransportProtocol: udp
Done
dns config fd00::2
Done
dns config
Server: [fd00:0:0:0:0:0:0:2]:53
ResponseTimeout: 6000 ms
MaxTxAttempts: 3
RecursionDesired: yes
ServiceMode: srv_txt_opt
Nat64Mode: allow
TransportProtocol: udp
Done
Riferimenti per l'interfaccia a riga di comando e le API
configurazione DNS
Recupera l'attuale configurazione predefinita delle query utilizzata dal client DNS.
All'avvio dello stack OpenThread, la configurazione predefinita delle query DNS viene determinata in base a un insieme di opzioni di configurazione OT quali OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_IP6_ADDRESS
, _DEFAULT_SERVER_PORT
, _DEFAULT_RESPONSE_TIMEOUT
e così via (vedi config/dns_client.h
per tutte le opzioni di configurazione correlate).
La configurazione include indirizzo e porta IPv6 del server, timeout della risposta in msec (tempo di attesa per la risposta rx), massimo tentativi tx prima dell'errore di segnalazione, flag booleano per indicare se il server può risolvere la query in modo ricorsivo o meno. Il campo OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE
è obbligatorio.
Parametri
Nessun parametro.
Esempi
dns config
Server: [fd00:0:0:0:0:0:0:1]:1234
ResponseTimeout: 5000 ms
MaxTxAttempts: 2
RecursionDesired: no
ServiceMode: srv
Nat64Mode: allow
Done
Riferimenti per l'interfaccia a riga di comando e le API
risoluzione DNS
Invia una query DNS per la risoluzione degli indirizzi per i record AAAA (IPv6) di un determinato nome host.
aConfig
può essere NULL. In questo caso, la configurazione predefinita (da
otDnsClientGetDefaultConfig()
) verrà utilizzata come configurazione per questa query. In un valore aConfig
non NULL, alcuni campi possono essere lasciati non specificati (valore zero). I campi non specificati vengono quindi sostituiti dai valori della configurazione predefinita.
Invia una query DNS per ottenere l'indirizzo IPv6 per il nome host specificato.
I parametri dopo il nome host sono facoltativi. I valori non specificati (o zero) di questi parametri facoltativi vengono sostituiti dal valore della configurazione predefinita corrente (config dns).
L'indirizzo IP del server DNS può essere un indirizzo IPv4, che verrà sintetizzato in un indirizzo IPv6 utilizzando il prefisso NAT64 preferito dai dati di rete.
Parametri
dns resolve hostname [dns-server-IP] [dns-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
servizio DNS
Avvia la risoluzione di un'istanza di servizio DNS per una determinata istanza di servizio.
È disponibile quando OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE
è attivato.
aConfig
può essere NULL. In questo caso, la configurazione predefinita (da
otDnsClientGetDefaultConfig()
) verrà utilizzata come configurazione per questa query. In un valore aConfig
non NULL, alcuni campi possono essere lasciati non specificati (valore zero). I campi non specificati vengono quindi sostituiti dai valori della configurazione predefinita.
La funzione invia query per i record SRV e/o TXT per l'istanza di servizio specificata. Il campo mServiceMode
in
otDnsQueryConfig
determina quali record eseguire la query (solo SRV, solo TXT o sia SRV e TXT) e come eseguire la query (insieme nello stesso messaggio, separatamente, in parallelo o in modalità ottimizzata in cui il client cercherà prima lo stesso messaggio e poi separatamente se non riesce a ottenere una risposta).
Il record SRV fornisce informazioni su porta, priorità e peso del servizio insieme al nome host associato all'istanza di servizio. Questa funzione NON esegue la risoluzione dell'indirizzo per il nome host rilevato dal record SRV. Il server/risoltore potrebbe fornire record AAAA/A per il nome host nella sezione Dati aggiuntivi della risposta alla query SRV/TXT. Queste informazioni possono essere recuperate utilizzando
otDnsServiceResponseGetServiceInfo()
in otDnsServiceCallback
. Gli utenti di questa API NON DEVONO dare per scontato che l'indirizzo host sia sempre disponibile da
otDnsServiceResponseGetServiceInfo()
.
Invia una query DNS sulla risoluzione dell'istanza di servizio per una determinata istanza di servizio. Viene fornita prima l'etichetta dell'istanza di servizio, seguita dal nome del servizio (tieni presente che l'etichetta dell'istanza di servizio può contenere il punto ".").
I parametri dopo service-name
sono facoltativi. Qualsiasi valore non specificato (o zero) per questi parametri facoltativi viene sostituito dal valore della configurazione predefinita corrente (dns config
).
Parametri
dns service service-instance-label service-name [DNS-server-IP] [DNS-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]
Esempi
Riferimenti per l'interfaccia a riga di comando e le API
servizio DNS
Avvia una risoluzione dell'istanza di servizio DNS per una determinata istanza di servizio, con una potenziale risoluzione dell'indirizzo di follow-up per il nome host rilevato per l'istanza di servizio.
È disponibile quando OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE
è attivato.
aConfig
può essere NULL. In questo caso, la configurazione predefinita (da
otDnsClientGetDefaultConfig()
) verrà utilizzata come configurazione per questa query. In un valore aConfig
non NULL, alcuni campi possono essere lasciati non specificati (valore zero). I campi non specificati vengono quindi sostituiti dai valori della configurazione predefinita. Questa funzione non può essere utilizzata con l'elemento mServiceMode
nella configurazione DNS impostato su OT_DNS_SERVICE_MODE_TXT
(ovvero, viene eseguita una query solo per il record TXT) e restituirà OT_ERROR_INVALID_ARGS
.
Ha un comportamento simile all'invio di query per i record SRV e TXT da parte di
otDnsClientResolveService()
. Tuttavia, se il server/risoltore non fornisce record AAAA/A per il nome host nella risposta alla query SRV (nella sezione Dati aggiuntivi), eseguirà la risoluzione del nome host (invio di una query AAAA) per il nome host rilevato dal record SRV. Il callback aCallback
viene richiamato quando vengono ricevute le risposte a tutte le query (ad es. al termine delle risoluzioni del servizio e degli indirizzi host).
Invia una query DNS sulla risoluzione dell'istanza di servizio per una determinata istanza di servizio con potenziale risoluzione del nome host di follow-up. Viene fornita prima l'etichetta dell'istanza di servizio, seguita dal nome del servizio (tieni presente che l'etichetta dell'istanza di servizio può contenere il punto ".").
I parametri dopo service-name
sono facoltativi. Qualsiasi valore non specificato (o zero) per questi parametri facoltativi viene sostituito dal valore della configurazione predefinita corrente (dns config
).
Parametri
dns servicehost service-instance-label service-name [DNS-server-IP] [DNS-server-port] [response-timeout-ms] [max-tx-attempts] [recursion-desired-boolean]
Esempi
Riferimenti per l'interfaccia a riga di comando e le API
nomedominio (insieme)
Imposta il nome di dominio del thread.
L'operazione riesce solo quando i protocolli Thread sono disabilitati.
Parametri
domainname name
Usa un backslash
per uscire dagli spazi.
Esempi
domainname Test\ Thread
Done
Riferimenti per l'interfaccia a riga di comando e le API
nomedominio
Ottiene il nome di dominio del thread.
Parametri
Nessun parametro.
Esempi
domainname
Thread
Done
Riferimenti per l'interfaccia a riga di comando e le API
dua iid (set,cancella)
Imposta o cancella l'identificatore di interfaccia specificato manualmente per l'indirizzo Unicast del dominio Thread.
Disponibile quando OPENTHREAD_CONFIG_DUA_ENABLE
è attivato.
Parametri
dua iid iid|clear
dua iid clear
passa un valore nullptr
a otThreadSetFixedDuaInterfaceIdentifier. In caso contrario, puoi passare l'iid
.
Esempi
dua iid 0004000300020001
Done
dua iid clear
Done
Riferimenti per l'interfaccia a riga di comando e le API
dua iid
Ottiene l'identificatore di interfaccia specificato manualmente per l'indirizzo Unicast del dominio Thread.
Disponibile quando OPENTHREAD_CONFIG_DUA_ENABLE
è attivato.
Parametri
Nessun parametro.
Esempi
dua iid
0004000300020001
Done
Riferimenti per l'interfaccia a riga di comando e le API
eidcache
Restituisce le voci della cache EID-to-RLOC.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
eui64
Ottiene lo standard IEEE EUI-64 assegnato dal produttore per questa interfaccia.
Parametri
Nessun parametro.
Esempi
eui64
0615aae900124b00
Done
Riferimenti per l'interfaccia a riga di comando e le API
extaddr (set)
Imposta l'indirizzo esteso IEEE 802.15.4.
Parametri
extaddr extaddr
Esempi
extaddr dead00beef00cafe
dead00beef00cafe
Done
Riferimenti per l'interfaccia a riga di comando e le API
extaddr
Ottiene l'indirizzo esteso IEEE 802.15.4.
Parametri
Nessun parametro.
Esempi
extaddr
dead00beef00cafe
Done
Riferimenti per l'interfaccia a riga di comando e le API
extpanid (insieme)
Imposta l'ID PAN esteso IEEE 802.15.4.
Parametri
extpanid extpanid
Esempi
extpanid dead00beef00cafe
Done
Riferimenti per l'interfaccia a riga di comando e le API
estensione
Ottiene l'ID PAN esteso dello standard IEEE 802.15.4.
Parametri
Nessun parametro.
Esempi
extpanid
dead00beef00cafe
Done
Riferimenti per l'interfaccia a riga di comando e le API
ripristinare i dati di fabbrica
Elimina tutte le impostazioni archiviate nella memoria permanente, quindi attiva un ripristino della piattaforma.
Parametri
Nessun parametro.
Esempi
factoryreset
Riferimenti per l'interfaccia a riga di comando e le API
falso (un,un)
Invia messaggi Thread falsi.
Disponibile quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
è attivato.
Parametri
fake /a/an dst-ipaddr target meshLocalIid
Esempi
fake /a/an fdde:ad00:beef:0:0:ff:fe00:a800 fd00:7d03:7d03:7d03:55f2:bb6a:7a43:a03b 1111222233334444
Done
Riferimenti per l'interfaccia a riga di comando e le API
fem
Recupera parametri FEM esterni.
Parametri
Nessun parametro.
Esempi
fem
LNA gain 11 dBm
Done
Riferimenti per l'interfaccia a riga di comando e le API
fem lnagain (get)
Restituisce il guadagno Rx LNA del FEM esterno in dBm.
Parametri
Nessun parametro.
Esempi
fem lnagain
11
Done
Riferimenti per l'interfaccia a riga di comando e le API
lnagain fem (set)
Imposta il guadagno Rx LNA del FEM esterno in dBm.
Parametri
Nessun parametro.
Esempi
fem lnagain 8
Done
Riferimenti per l'interfaccia a riga di comando e le API
storia ipaddr
Visualizza la cronologia degli indirizzi IPv6 unicast in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: tempo trascorso dall'emissione del comando e specificato nel formato
hours
:minutes
:seconds
:milliseconds
- Evento: i valori possibili sono
Added
oRemoved
. - Lunghezza indirizzo/prefisso: indirizzo Unicast con la lunghezza del prefisso (in bit).
- Origine: i valori possibili sono
thread
,slaac
,dhcp6
omanual
. - Ambito: ambito degli indirizzi IPv6.
- P: flag preferito.
- V: flag valido.
- RLOC (R): questo flag indica se l'indirizzo IPv6 è un localizzatore di routing.
Parametri
history ipaddr [list] [num-entries]
- Utilizza l'opzione
list
per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
ipmaddr cronologia
Visualizza la cronologia degli indirizzi IPv6 multicast in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: tempo trascorso dall'emissione del comando e specificato nel formato
hours
:minutes
:seconds
:milliseconds
- Evento: i valori possibili sono
Subscribed
oUnsubscribed
. - Indirizzo multicast
- Origine: i valori possibili sono
Thread
oManual
.
Parametri
history ipmaddr [list] [num-entries]
- Utilizza l'opzione
list
per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
vicino di storia
Visualizza la cronologia dei vicini in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: tempo trascorso dall'emissione del comando e specificato nel formato
hours
:minutes
:seconds
:milliseconds
- Tipo:
Child
oRouter
. - Evento: i valori possibili sono
Added
,Removed
oChanged
. - Indirizzo esteso
- RLOC16
- Modalità: modalità di collegamento MLE. Valori possibili:
-
: nessun flag impostato (rx-off-quando-inattivo, dispositivo Thread minimo, dati di rete stabili).r
: rx-on-quando-inattivod
: dispositivo con interamente Thread.n
: dati di rete completi
- RSS Ave: numero medio di frame (in dBm) ricevuti dal vicino nel momento in cui è stata registrata la voce.
Parametri
history neighbor [list] [num-entries]
- Utilizza l'opzione
list
per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
netinfo cronologia
Visualizza la cronologia delle informazioni sulla rete in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: tempo trascorso dall'emissione del comando e specificato nel formato
hours
:minutes
:seconds
:milliseconds
- Ruolo: ruolo del dispositivo. I valori possibili sono
router
,child
,detached
odisabled
. - Modalità: modalità di collegamento MLE. Valori possibili:
-
: nessun flag impostato (rx-off-quando-inattivo, dispositivo Thread minimo, dati di rete stabili).r
: rx-on-quando-inattivod
: dispositivo con interamente Thread.n
: dati di rete completi
- RLOC16
- ID partizione.
Parametri
history netinfo [list] [num-entries]
- Utilizza l'opzione
list
per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
prefisso cronologia
Visualizza i dati di rete per la cronologia dei prefissi mesh in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: tempo trascorso dall'emissione del comando e specificato nel formato
hours
:minutes
:seconds
:milliseconds
- Evento: i valori possibili sono
Added
oRemoved
. - Prefisso
- Segnalazioni/significato:
p
: flag preferitoa
: flag di configurazione automatica degli indirizzi IPv6 stateless.d
: flag di configurazione dell'indirizzo IPv6 DHCPv6.c
: flag di altro configurazione DHCPv6.r
: flag predefinito per la route.o
: sul flag mesh.s
: flag stabile.n
: flag Dns nd.D
: flag prefisso di dominio.
- Preferenza: preferenza. I valori possono essere
high
,med
olow
. - RLOC16
Parametri
history prefix [list] [num-entries]
- Utilizza l'opzione
list
per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
percorso della storia
Visualizza la cronologia dei percorsi esterni dei dati di rete in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: tempo trascorso dall'emissione del comando e specificato nel formato
hours
:minutes
:seconds
:milliseconds
- Evento: i valori possibili sono
Added
oRemoved
. - Percorso
- Segnalazioni/significato:
s
: flag stabile.n
: flag NAT64.
- Preferenza: preferenza. I valori possono essere
high
,med
olow
. - RLOC16
Parametri
history route [list] [num-entries]
- Utilizza l'opzione
list
per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
router cronologia
Visualizza la cronologia della tabella di route in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: tempo trascorso dall'emissione del comando e specificato nel formato
hours
:minutes
:seconds
:milliseconds
- Evento: i valori possibili sono
Added
,Removed
,NextHopChanged
oCostChanged
. - ID (RLOC16): ID router e RLOC16 del router.
- Hop successivo: ID router e RLOC16 dell'hop successivo. Se non è presente alcun hop successivo, viene visualizzato
none
. - Costo del percorso: costo precedente
->
nuovo costo. Un valoreinf
indica un costo del percorso infinito.
Parametri
history router [list] [num-entries]
- Utilizza l'opzione
list
per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
rx cronologia
Visualizza la cronologia RX dei messaggi IPv6 in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: tempo trascorso dall'emissione del comando e specificato nel formato
hours
:minutes
:seconds
:milliseconds
- Tipo:
- Tipo di messaggio IPv6, come
UDP
,TCP
,HopOpts
eICMP6
(e il relativo sottotipo). src
: indirizzo IPv6 di origine e numero di porta.dst
: indirizzo IPv6 di destinazione e numero di porta (il numero di porta è valido per UDP/TCP, altrimenti è 0).
- Tipo di messaggio IPv6, come
- Len: lunghezza del payload IPv6 (esclusa l'intestazione IPv6).
- Chksum: checksum dei messaggi (valido per i messaggi UDP, TCP o ICMP6).
- Sec: indica se è stata utilizzata la sicurezza a livello di link.
- Prio: priorità del messaggio. I valori possibili sono
low
,norm
,high
onet
(per i messaggi di controllo Thread). - RSS: intensità del segnale ricevuto (in dBm), calcolata in media su tutti i frame di frammenti ricevuti che formano il messaggio. Per la cronologia di TX, viene visualizzato
NA
(non applicabile). - Dir: mostra se il messaggio è stato inviato (
TX
) o ricevuto (RX
). Una trasmissione non riuscita è indicata conTX-F
nel formato tabella otx-success:no
nel formato elenco. Esempi di trasmissione non riuscita sonotx
l'interruzione del servizio e nessunack
inviato dal peer per nessuno dei frammenti del messaggio. - Neighb: indirizzo breve (RLOC16) del vicino con cui è stato inviato/ricevuto il messaggio. Se il frame è stato trasmesso, viene mostrato come
bcast
in formato tabella o0xffff
in formato elenco. Se l'indirizzo breve del vicino non è disponibile, viene mostrato comeunknwn
in formato tabella o0xfffe
in formato elenco. - Radio: link della radio su cui è stato inviato/ricevuto il messaggio (utile quando
OPENTHREAD_CONFIG_MULTI_RADIO
è attivato). Può essere15.4
,trel
oall
(se inviato su tutti i link radio).
Parametri
history rx [list] [num-entries]
- Utilizza l'opzione
list
per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
cronologia rxtx
Visualizza la cronologia combinata dei messaggi IPv6 RX e TX, in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: tempo trascorso dall'emissione del comando e specificato nel formato
hours
:minutes
:seconds
:milliseconds
- Tipo:
- Tipo di messaggio IPv6, come
UDP
,TCP
,HopOpts
eICMP6
(e il relativo sottotipo). src
: indirizzo IPv6 di origine e numero di porta.dst
: indirizzo IPv6 di destinazione e numero di porta (il numero di porta è valido per UDP/TCP, altrimenti è 0).
- Tipo di messaggio IPv6, come
- Len: lunghezza del payload IPv6 (esclusa l'intestazione IPv6).
- Chksum: checksum dei messaggi (valido per i messaggi UDP, TCP o ICMP6).
- Sec: indica se è stata utilizzata la sicurezza a livello di link.
- Prio: priorità del messaggio. I valori possibili sono
low
,norm
,high
onet
(per i messaggi di controllo Thread). - RSS: intensità del segnale ricevuto (in dBm), calcolata in media su tutti i frame di frammenti ricevuti che formano il messaggio. Per la cronologia di TX, viene visualizzato
NA
(non applicabile). - Dir: mostra se il messaggio è stato inviato (
TX
) o ricevuto (RX
). Una trasmissione non riuscita è indicata conTX-F
nel formato tabella otx-success:no
nel formato elenco. Esempi di trasmissione non riuscita sonotx
l'interruzione del servizio e nessunack
inviato dal peer per nessuno dei frammenti del messaggio. - Neighb: indirizzo breve (RLOC16) del vicino con cui è stato inviato/ricevuto il messaggio. Se il frame è stato trasmesso, viene mostrato come
bcast
in formato tabella o0xffff
in formato elenco. Se l'indirizzo breve del vicino non è disponibile, viene mostrato comeunknwn
in formato tabella o0xfffe
in formato elenco. - Radio: link della radio su cui è stato inviato/ricevuto il messaggio (utile quando
OPENTHREAD_CONFIG_MULTI_RADIO
è attivato). Può essere15.4
,trel
oall
(se inviato su tutti i link radio).
Parametri
history rxtx [list] [num-entries]
- Utilizza l'opzione
list
per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
tx cronologia
Visualizza la cronologia TX dei messaggi IPv6 in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: tempo trascorso dall'emissione del comando e specificato nel formato
hours
:minutes
:seconds
:milliseconds
- Tipo:
- Tipo di messaggio IPv6, come
UDP
,TCP
,HopOpts
eICMP6
(e il relativo sottotipo). src
: indirizzo IPv6 di origine e numero di porta.dst
: indirizzo IPv6 di destinazione e numero di porta (il numero di porta è valido per UDP/TCP, altrimenti è 0).
- Tipo di messaggio IPv6, come
- Len: lunghezza del payload IPv6 (esclusa l'intestazione IPv6).
- Chksum: checksum dei messaggi (valido per i messaggi UDP, TCP o ICMP6).
- Sec: indica se è stata utilizzata la sicurezza a livello di link.
- Prio: priorità del messaggio. I valori possibili sono
low
,norm
,high
onet
(per i messaggi di controllo Thread). - RSS: intensità del segnale ricevuto (in dBm), calcolata in media su tutti i frame di frammenti ricevuti che formano il messaggio. Per la cronologia di TX, viene visualizzato
NA
(non applicabile). - Dir: mostra se il messaggio è stato inviato (
TX
) o ricevuto (RX
). Una trasmissione non riuscita è indicata conTX-F
nel formato tabella otx-success:no
nel formato elenco. Esempi di trasmissione non riuscita sonotx
l'interruzione del servizio e nessunack
inviato dal peer per nessuno dei frammenti del messaggio. - Neighb: indirizzo breve (RLOC16) del vicino con cui è stato inviato/ricevuto il messaggio. Se il frame è stato trasmesso, viene mostrato come
bcast
in formato tabella o0xffff
in formato elenco. Se l'indirizzo breve del vicino non è disponibile, viene mostrato comeunknwn
in formato tabella o0xfffe
in formato elenco. - Radio: link della radio su cui è stato inviato/ricevuto il messaggio (utile quando
OPENTHREAD_CONFIG_MULTI_RADIO
è attivato). Può essere15.4
,trel
oall
(se inviato su tutti i link radio).
Parametri
history tx [list] [num-entries]
- Utilizza l'opzione
list
per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
ifconfig (su,giù)
Porta in alto o in basso l'interfaccia IPv6.
Chiama questo numero per attivare o disattivare la comunicazione IPv6.
Parametri
ifconfig up|down
Esempi
ifconfig up
Done
ifconfig down
Done
Riferimenti per l'interfaccia a riga di comando e le API
ifconfig
Indica se l'interfaccia IPv6 è attiva o meno.
Parametri
Nessun parametro.
Esempi
ifconfig
down
Done
ifconfig
up
Done
Riferimenti per l'interfaccia a riga di comando e le API
instanceid
Ottiene l'identificatore dell'istanza.
L'identificatore dell'istanza è impostato su un valore casuale quando viene creata l'istanza, quindi il suo valore non cambierà dopo l'inizializzazione.
Parametri
Nessun parametro.
Esempi
instanceid
468697314
Done
Riferimenti per l'interfaccia a riga di comando e le API
ipaddr aggiungi
Aggiunge un indirizzo di interfaccia di rete all'interfaccia Thread.
L'istanza passata aAddress
viene copiata dall'interfaccia Thread. L'interfaccia Thread supporta solo un numero fisso di indirizzi unicast aggiunti esternamente. Leggi i OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS
.
Parametri
ipaddr add aAddress
Esempi
ipaddr add 2001::dead:beef:cafe
Done
Riferimenti per l'interfaccia a riga di comando e le API
Ipaddr Del
Rimuove un indirizzo di interfaccia di rete dall'interfaccia Thread.
Parametri
ipaddr del aAddress
Esempi
ipaddr del 2001::dead:beef:cafe
Done
Riferimenti per l'interfaccia a riga di comando e le API
Ipaddr
Restituisce l'elenco di indirizzi IPv6 assegnati all'interfaccia Thread.
Parametri
ipaddr [-v]
Utilizza -v
per avere informazioni più dettagliate sull'indirizzo:
origin
: può esserethread
,slaac
,dhcp6
,manual
e indica l'origine dell'indirizzoplen
: lunghezza del prefissopreferred
: flag preferito (booleano)valid
: flag valido (booleano)
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
linklocal ipaddr
Ottiene l'indirizzo IPv6 locale rispetto al collegamento di Thread.
L'indirizzo locale del collegamento Thread viene ricavato utilizzando l'indirizzo esteso IEEE802.15.4 come identificatore di interfaccia.
Parametri
Nessun parametro.
Esempi
ipaddr linklocal
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done
Riferimenti per l'interfaccia a riga di comando e le API
Ipaddr Mleid
Recupera l'indirizzo EID locale mesh.
Parametri
Nessun parametro.
Esempi
ipaddr mleid
fdde:ad00:beef:0:558:f56b:d688:799
Done
Riferimenti per l'interfaccia a riga di comando e le API
IPaddr RLO
Ottiene l'indirizzo RLOC (Thread Routing Locator).
Parametri
Nessun parametro.
Esempi
ipaddr rloc
fdde:ad00:beef:0:0:ff:fe00:0
Done
Riferimenti per l'interfaccia a riga di comando e le API
aggiungi ipmaddr
Sottoscrive l'interfaccia Thread a un indirizzo multicast interfaccia di rete.
Il valore trasmesso nell'istanza aAddress
verrà copiato dall'interfaccia Thread. L'interfaccia Thread supporta solo un numero fisso di indirizzi multicast aggiunti esternamente. Leggi i OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS
.
Parametri
ipmaddr add aAddress
Esempi
ipmaddr add ff05::1
Done
Riferimenti per l'interfaccia a riga di comando e le API
ipmaddr del
Annulla l'iscrizione dell'interfaccia Thread a un indirizzo multicast interfaccia di rete.
Parametri
ipmaddr del aAddress
Esempi
ipmaddr del ff05::1
Done
Riferimenti per l'interfaccia a riga di comando e le API
ipmaddr
Restituisce l'elenco di indirizzi multicast IPv6 sottoscritti all'interfaccia Thread.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
Ipmaddr Llatn
Ottiene l'indirizzo multicast di Tutti i nodi Thread locali del link Thread.
L'indirizzo è un collegamento Unicast locale basato su prefisso Multicast Address [RFC 3306], con:
- flgs impostati su 3 (P = 1 e T = 1)
- raccolta impostata su 2
- plen impostato su 64
- prefisso di rete impostato sul prefisso locale mesh
- ID gruppo impostato su 1
Parametri
Nessun parametro.
Esempi
ipmaddr llatn
ff32:40:fdde:ad00:beef:0:0:1
Done
Riferimenti per l'interfaccia a riga di comando e le API
ipmaddr rlatn
Ottiene l'indirizzo multicast di Tutti i nodi Thread locale dell'area di autenticazione Thread.
L'indirizzo è un regno locale Unicast Prefix-Based Multicast Address [RFC 3306], con:
- flgs impostati su 3 (P = 1 e T = 1)
- raccolta impostata su 3
- plen impostato su 64
- prefisso di rete impostato sul prefisso locale mesh
- ID gruppo impostato su 1
Parametri
Nessun parametro.
Esempi
ipmaddr rlatn
ff33:40:fdde:ad00:beef:0:0:1
Done
Riferimenti per l'interfaccia a riga di comando e le API
discernitore del joiner (insieme)
Imposta l'elemento Discerner del join.
Parametri
joiner discerner discerner
- Usa
{number}/{length}
per impostarediscerner
. joiner discerner clear
impostaaDiscerner
sunullptr
.
Esempi
joiner discerner 0xabc/12
Done
Riferimenti per l'interfaccia a riga di comando e le API
chiarimento del joiner
Cancella lo smistatore Joiner.
Parametri
Nessun parametro.
Esempi
joiner discerner clear
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
scrutatore di joiner
Ottiene il Distributore di falegnameria.
Per saperne di più, consulta otJoinerSetDiscerner.
Parametri
Nessun parametro.
Esempi
joiner discerner
0xabc/12
Done
Riferimenti per l'interfaccia a riga di comando e le API
aiuto di joiner
Stampa il menu Guida di joiner
.
Parametri
Nessun parametro.
Esempi
joiner help
help
id
start
state
stop
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
ID joiner
Ottiene l'ID Joiner.
Se non è impostato un Joiner Discerner, l'ID Joiner corrisponde ai primi 64 bit del risultato del calcolo di SHA-256 rispetto allo standard IEEE EUI-64 assegnato in fabbrica. In caso contrario, l'ID Joiner viene calcolato dal valore del Joiner Discerner.
L'ID Joiner viene utilizzato anche come indirizzo esteso IEEE 802.15.4 del dispositivo durante il processo di messa in servizio.
Parametri
Nessun parametro.
Esempi
joiner id
d65e64fa83f81cf7
Done
Riferimenti per l'interfaccia a riga di comando e le API
avvio joiner
Attiva il ruolo Thread Joiner.
Parametri
joiner start joining-device-credential [provisioning-url]
joining-device-credential
: passphrase di joiner. Deve essere una stringa di caratteri alfanumerici maiuscoli (0-9 e A-Y, esclusi I, O, Q e Z per la leggibilità), con una lunghezza compresa tra 6 e 32 caratteri.provisioning-url
: URL di provisioning per il joiner (facoltativo).
Esempi
joiner start J01NM3
Done
Riferimenti per l'interfaccia a riga di comando e le API
stato joiner
Ottieni lo stato di joiner.
Restituisce uno dei seguenti stati:
-
Idle
-
Discover
-
Connecting
-
Connected
-
Entrust
-
Joined
Parametri
Nessun parametro.
Esempi
joiner state
Idle
Done
Riferimenti per l'interfaccia a riga di comando e le API
punto di join
Disabilita il ruolo Thread Joiner.
Parametri
Nessun parametro.
Esempi
joiner stop
Done
Riferimenti per l'interfaccia a riga di comando e le API
joinerport (set)
Imposta la porta UDP del joiner.
Parametri
joinerport udp-port
Esempi
joinerport 1000
Done
Riferimenti per l'interfaccia a riga di comando e le API
Joinerport
Ottiene la porta UDP del joiner.
Parametri
Nessun parametro.
Esempi
joinerport
1000
Done
Riferimenti per l'interfaccia a riga di comando e le API
contatore sequenza di chiavi (impostato)
Imposta il valore di th interessatoSequenceCounter.
Parametri
keysequence counter counter
Esempi
keysequence counter 10
Done
Riferimenti per l'interfaccia a riga di comando e le API
contatore sequenza di chiavi
Ottiene il thpredictSequenceCounter.
Parametri
Nessun parametro.
Esempi
keysequence counter
10
Done
Riferimenti per l'interfaccia a riga di comando e le API
guardtime sequenza di chiavi (impostato)
Imposta il valore di thpredictSwitchGuardTime (in ore).
Parametri
keysequence guardtime guardtime-hours
Usa immediatamente 0
per Thread Key Switch
se c'è una corrispondenza dell'indice della chiave.
Esempi
keysequence guardtime 0
Done
Riferimenti per l'interfaccia a riga di comando e le API
tempo di protezione sequenza di chiavi
Ottiene il th insightSwitchGuardTime (in ore).
Parametri
Nessun parametro.
Esempi
keysequence guardtime
0
Done
Riferimenti per l'interfaccia a riga di comando e le API
dati leader
Ottiene i dati del leader Thread.
Parametri
Nessun parametro.
Esempi
leaderdata
Partition ID: 1077744240
Weighting: 64
Data Version: 109
Stable Data Version: 211
Leader Router ID: 60
Done
Riferimenti per l'interfaccia a riga di comando e le API
peso leader (set)
Imposta il peso della leader Thread utilizzato quando si opera nel ruolo Leader.
Imposta direttamente il peso leader sul nuovo valore, sostituendo il valore precedente (che potrebbe essere stato determinato dal valore attuale di
otDeviceProperties
).
Parametri
leaderweight weight
Esempi
leaderweight 128
Done
Riferimenti per l'interfaccia a riga di comando e le API
peso leader
Restituisce il peso del leader Thread utilizzato quando si opera nel ruolo Leader.
Parametri
Nessun parametro.
Esempi
leaderweight
128
Done
Riferimenti per l'interfaccia a riga di comando e le API
conferma confermata configurazione linkmetrics cancella
Invia una richiesta di gestione delle metriche dei link per cancellare un probe basato su ACK avanzato.
Parametri
linkmetrics config [async] peer-ipaddr enhanced-ack clear
async
: utilizza la modalità non di blocco.peer-ipaddr
deve essere l'indirizzo Link Local del dispositivo vicino.
Esempi
linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack clear
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
Done
Riferimenti per l'interfaccia a riga di comando e le API
registro ACK avanzato della configurazione linkmetrics
L'elemento r
aggiuntivo è facoltativo e viene utilizzato solo per i dispositivi di riferimento. Quando questa opzione è specificata, il valore enum Type/Average di ogni flag ID tipo è impostato su riservato. Viene utilizzato per verificare che l'oggetto del probe gestisca correttamente i flag di ID di tipo non validi ed è disponibile solo quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
è abilitato.
Invia una richiesta di gestione delle metriche dei link per registrare un probe basato su ACK avanzato.
Parametri
linkmetrics config [async] peer-ipaddr enhanced-ack register [qmr][r]
async
: utilizza la modalità non di blocco.- [
q
,m
er
] mappano a otLinkMetricsValues. In base alla specifica 4.11.3.4.4.6, puoi utilizzare al massimo due opzioni contemporaneamente, ad esempioq
oqm
.q
: LQI di livello 2.m
: margine link.r
: RSSI.
Esempi
linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
Done
> linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm r
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Cannot support new series
Done
Riferimenti per l'interfaccia a riga di comando e le API
in avanti configurazione linkmetrics
Invia una richiesta di gestione delle metriche dei link MLE per configurare o cancellare una serie di tracciamento avanti.
Parametri
linkmetrics config [async] peer-ipaddr forward series-id [ldraX][pqmr]
async
: utilizza la modalità non di blocco.peer-ipaddr
: indirizzo del peer.series-id
: l'ID della serie.- I valori [
l
,d
,r
ea
] vengono mappati a otLinkMetricsSeriesFlags.X
non rappresenta nessuno dei valoriotLinkMetricsSeriesFlags
e interrompe la contabilità e rimuove la serie.l
: sonda di collegamento MLE.d
: dati MAC.r
: richiesta di dati MAC.a
: ACK MAC.X
: può essere utilizzato solo senza altri flag.
- I valori [
p
,q
,m
er
] vengono mappati a otLinkMetricsValues.p
: numero di PDU di livello 2 ricevute.q
: LQI di livello 2.m
: margine link.r
: RSSI.
Esempi
linkmetrics config fe80:0:0:0:3092:f334:1455:1ad2 forward 1 dra pqmr
Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: SUCCESS
Done
Riferimenti per l'interfaccia a riga di comando e le API
probe linkmetrics
Invia un messaggio di sonda di link MLE.
Parametri
linkmetrics probe peer-ipaddr series-id length
peer-ipaddr
: indirizzo del peer.series-id
: l'ID della serie a cui è indirizzato il messaggio del probe.length
: la lunghezza del messaggio del probe. Un intervallo valido è [0, 64].
Esempi
linkmetrics probe fe80:0:0:0:3092:f334:1455:1ad2 1 10
Done
Riferimenti per l'interfaccia a riga di comando e le API
inoltro richiesta linkmetrics
Eseguire una query sulle metriche dei link (serie di tracciamento avanti).
Parametri
linkmetrics query [async] peer-ipaddr forward series-id
async
: utilizza la modalità non di blocco.peer-ipaddr
: indirizzo del peer.series-id
: l'ID della serie.
Esempi
linkmetrics request fe80:0:0:0:3092:f334:1455:1ad2 forward 1
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)
Done
Riferimenti per l'interfaccia a riga di comando e le API
richiesta linkmetrics singolo
Esegui una query sulle metriche dei link (sonda singola).
Parametri
linkmetrics request [async] peer-ipaddr single [pqmr]
async
: utilizza la modalità non di blocco.peer-ipaddr
: indirizzo del peer.- [
p
,q
,m
er
] mappano a otLinkMetrics.p
: numero di PDU di livello 2 ricevute.q
: LQI di livello 2.m
: margine link.r
: RSSI.
Esempi
linkmetrics request fe80:0:0:0:3092:f334:1455:1ad2 single qmr
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)
Done
Riferimenti per l'interfaccia a riga di comando e le API
linkmetricsmgr (attiva,disattiva)
Abilita o disabilita il Gestore metriche dei link.
Parametri
linkmetricsmgr enable|disable
Esempi
linkmetricmgr enable
Done
linkmetricmgr disable
Done
Riferimenti per l'interfaccia a riga di comando e le API
programma linkmetricsmgr
Ottieni i dati delle metriche di collegamento di un vicino in base al suo indirizzo esteso.
Parametri
Nessun parametro.
Esempi
linkmetricsmgr show
ExtAddr:827aa7f7f63e1234, LinkMargin:80, Rssi:-20
Done
Riferimenti per l'interfaccia a riga di comando e le API
individua (imposta)
Individua la destinazione più vicina di un indirizzo anycast (ovvero trova l'EID locale e RLOC16 del mesh di destinazione).
La destinazione più vicina viene determinata in base all'attuale tabella di routing e ai costi del percorso all'interno della mesh Thread.
Disponibile quando OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE
è attivato.
Parametri
locate anycastaddr
Esempi
locate fdde:ad00:beef:0:0:ff:fe00:fc00
fdde:ad00:beef:0:d9d3:9000:16b:d03b 0xc800
Done
Riferimenti per l'interfaccia a riga di comando e le API
individua
Restituisce lo stato corrente (In Progress
o Idle
) del localizzatore anycast.
Disponibile quando OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE
è attivato.
Parametri
Nessun parametro.
Esempi
locate
Idle
Done
locate fdde:ad00:beef:0:0:ff:fe00:fc10
locate
In Progress
Done
Riferimenti per l'interfaccia a riga di comando e le API
nome file di log
Specifica il nome file per acquisire i messaggi
otPlatLog()
, utile durante il debug degli script per i test automatici su Linux quando il logging interrompe gli script per il test automatico.
Richiede OPENTHREAD_CONFIG_LOG_OUTPUT == OPENTHREAD_CONFIG_LOG_OUTPUT_DEBUG_UART
e OPENTHREAD_POSIX
.
Parametri
log filename filename
Esempi
Riferimenti per l'interfaccia a riga di comando e le API
livello di log (impostato)
Imposta il livello di log.
Parametri
log level level
Esempi
log level 4
Done
Riferimenti per l'interfaccia a riga di comando e le API
livello log
Ottieni il livello di log.
Parametri
Nessun parametro.
Esempi
log level
1
Done
Riferimenti per l'interfaccia a riga di comando e le API
nuovi tentativi Mac diretti (get,set)
Consente di acquisire o impostare il numero di nuovi tentativi con trasmissione diretta nel livello MAC.
Parametri
mac retries direct [number]
Utilizza l'argomento facoltativo number
per impostare il numero di nuovi tentativi di trasmissione diretta.
Esempi
mac retries direct
3
Done
mac retries direct 5
Done
Riferimenti per l'interfaccia a riga di comando e le API
nuovi tentativi Mac indiretti (get,set)
Consente di acquisire o impostare il numero di nuovi tentativi TX indiretti nel livello MAC.
Parametri
mac retries indirect [number]
Utilizza l'argomento facoltativo number
per impostare il numero di nuovi tentativi di trasmissione indiretti.
Esempi
mac retries indirect
3
Done
max retries indirect 5
Done
Riferimenti per l'interfaccia a riga di comando e le API
invio mac
Indica a un dispositivo Rx-Off-When-Idle
di inviare un frame MAC al relativo dispositivo principale. Questo comando è a scopo di certificazione e può essere utilizzato solo quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
è abilitato.
Parametri
mac send datarequest | emptydata
Devi scegliere uno dei due argomenti seguenti:
datarequest
: accoda un messaggio di richiesta dati IEEE 802.15.4 per la trasmissione.emptydata
: indica al dispositivo di inviare un frame di dati IEEE 802.15.4 vuoto.
Esempi
mac send datarequest
Done
mac send emptydata
Done
Riferimenti per l'interfaccia a riga di comando e le API
aggiunta indirizzo macfilter
È disponibile solo quando è abilitata la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
.
Aggiunge un indirizzo esteso IEEE 802.15.4 all'elenco di filtri MAC. Se specifichi l'argomento facoltativo rss
, viene corretta la potenza del segnale ricevuto per i messaggi provenienti dall'indirizzo. Se non utilizzi l'opzione rss
, l'indirizzo utilizzerà qualsiasi valore predefinito impostato. Se non hai impostato un valore predefinito, l'intensità del segnale corrisponderà al segnale over-air.
Parametri
macfilter addr add extaddr [rss]
Esempi
macfilter addr add 0f6127e33af6b403 -95
Done
macfilter addr add 0f6127e33af6b402
Done
Riferimenti per l'interfaccia a riga di comando e le API
lista consentita dell'addr macfilter
Consente di attivare la modalità di filtro MAC allowlist
, il che significa che sarà consentito l'accesso solo agli indirizzi MAC presenti nell'elenco dei filtri MAC.
Parametri
Nessun parametro.
Esempi
macfilter addr allowlist
Done
Riferimenti per l'interfaccia a riga di comando e le API
cancellazione indirizzo macfilter
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Questo comando cancella tutti gli indirizzi estesi dall'elenco di filtri MAC.
Parametri
Nessun parametro.
Esempi
macfilter addr clear
Done
Riferimenti per l'interfaccia a riga di comando e le API
lista bloccata addr macfilter
Consente di attivare la modalità di filtro MAC denylist
, il che significa che a tutti gli indirizzi MAC nell'elenco di filtri MAC verrà negato l'accesso.
Parametri
Nessun parametro.
Esempi
macfilter addr denylist
Done
Riferimenti per l'interfaccia a riga di comando e le API
disattivazione indirizzo macfilter
Disattiva le modalità di filtro MAC.
Parametri
Nessun parametro.
Esempi
macfilter addr disable
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
indirizzo macfilter
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Fornisce le seguenti informazioni:
- Modalità attuale dell'elenco di filtri MAC:
AllowList
,DenyList,
oDisabled
- Un elenco di tutti gli indirizzi estesi nel filtro. L'intensità del segnale ricevuto (rss) e l'indicatore di qualità del link (lqi) sono indicati accanto all'indirizzo se questi valori sono stati impostati in modo da essere diversi dai valori predefiniti.
Parametri
Nessun parametro.
Esempi
macfilter addr
Allowlist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
Done
Riferimenti per l'interfaccia a riga di comando e le API
rimozione indirizzo macfilter
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Questo comando rimuove l'indirizzo esteso specificato dall'elenco dei filtri MAC.
Parametri
macfilter addr remove extaddr
Esempi
macfilter addr remove 0f6127e33af6b402
Done
Riferimenti per l'interfaccia a riga di comando e le API
filtro Mac
Fornisce le seguenti informazioni:
Address Mode
: modalità attuale del filtro MAC:AllowList
,DenyList,
oDisabled
- Un elenco di tutti gli indirizzi estesi nell'elenco dei filtri MAC. L'intensità del segnale ricevuto (rss) e l'indicatore di qualità del link (lqi) sono indicati accanto all'indirizzo se questi valori sono stati impostati in modo da essere diversi dai valori predefiniti.
- Un elenco separato (
RssIn List
) che mostra tutti gli indirizzi estesi in cuirss
è stato impostato in modo che sia diverso dal valore predefinito. Default rss
: mostra i valori predefiniti, se applicabili, per le impostazioni dirss
elqi
.
Parametri
Nessun parametro.
Esempi
macfilter
Address Mode: Allowlist
0f6127e33af6b403 : rss -95 (lqi 1)
0f6127e33af6b402
RssIn List:
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done
Riferimenti per l'interfaccia a riga di comando e le API
aggiunta macfilter rss
Aggiunge l'indirizzo esteso specificato all'elenco RssIn
(o modifica un indirizzo esistente nell'elenco RssIn
) e imposta la voce di intensità del segnale ricevuto (in dBm) per i messaggi provenienti da quell'indirizzo.
Parametri
macfilter rss add extaddr rss
Per impostare un valore predefinito per l'intensità del segnale ricevuto per tutti i messaggi ricevuti, utilizza *
per l'argomento extaddr
.
Esempi
macfilter rss add * -50
Done
macfilter rss add 0f6127e33af6b404 -85
Done
Riferimenti per l'interfaccia a riga di comando e le API
add-lqi macfilter rss
Aggiunge l'indirizzo esteso specificato all'elenco RssIn
(o modifica un indirizzo esistente nell'elenco RssIn
) e imposta l'indicatore di qualità del link fisso per i messaggi provenienti da quell'indirizzo. Per impostare lqi
, non è necessario che l'indirizzo esteso sia incluso nel filtro address allowlist/denylist
.
Questa opzione è disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Parametri
macfilter rss add-lqi extaddr lqi
Per impostare un valore predefinito per l'indicatore di qualità dei link per tutti i messaggi ricevuti, utilizza *
per l'argomento extaddr
. L'intervallo consentito è compreso tra 0 e 3.
Esempi
macfilter rss add-lqi * 3
Done
macfilter rss add-lqi 0f6127e33af6b404 2
Done
Riferimenti per l'interfaccia a riga di comando e le API
macfilter rss cancellare
Cancella tutte le voci di intensità del segnale ricevuto (rss
) e dell'indicatore di qualità del link (lqi
) (inclusi i valori predefiniti) dall'elenco RssIn
.
L'esecuzione di questa azione implica che tutti gli indirizzi estesi utilizzeranno il segnale in diretta.
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Parametri
Nessun parametro.
Esempi
macfilter rss clear
Done
Riferimenti per l'interfaccia a riga di comando e le API
macfilter rss
Fornisce le seguenti informazioni:
- Elenco di tutti gli indirizzi estesi in cui l'intensità del segnale ricevuto (
rss
) è stata impostata in modo da essere diversa dal valore predefinito. Viene mostrato anche l'indicatore di qualità del link (lqi
). Le impostazionirss
elqi
sono mappate tra loro. Se imposti un valore, il valore dell'altro viene impostato automaticamente. Questo elenco di indirizzi è denominatoRssIn List
. Se impostirsi
olqi
, l'indirizzo esteso corrispondente viene aggiunto all'elencoRssIn
. Default rss
: mostra i valori predefiniti, se applicabili, per le impostazioni dirss
elqi
.
Parametri
Nessun parametro.
Esempi
macfilter rss
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done
Riferimenti per l'interfaccia a riga di comando e le API
rimozione rss filtro mac
Rimuove l'indirizzo esteso specificato dall'elenco RssIn
.
Una volta rimosso dall'elenco RssIn
, questo indirizzo MAC utilizzerà le impostazioni predefinite di rss
e lqi
, supponendo che siano state configurate le impostazioni predefinite. Se non sono state impostate impostazioni predefinite, viene utilizzato il segnale over-air.
È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
è abilitata.
Non viene eseguita alcuna azione se non esiste una voce nell'elenco RssIn
corrispondente all'indirizzo esteso specificato.
Parametri
macfilter rss remove extaddr
Se vuoi rimuovere le impostazioni predefinite dell'intensità del segnale ricevuto e dell'indicatore di qualità del link, usa *
come extaddr
. Vengono annullati i valori predefiniti, ma le voci dall'elenco RssIn
non vengono rimosse.
Esempi
macfilter rss remove *
Done
macfilter rss remove 0f6127e33af6b404
Done
Riferimenti per l'interfaccia a riga di comando e le API
meshdiag figlio6
Invia una query a un elemento padre per recuperare gli indirizzi IPv6 di tutti i relativi elementi figlio MTD.
Parametri
meshdiag childip6 parent-rloc16
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
tabella infantile meshdiag
Avvia una query per una tabella figlio di un router con un determinato RLOC16. L'output elenca tutte le voci figlio. Informazioni per bambino:
- RLOC16
- Indirizzo MAC esteso
- Versione thread
- Timeout (in secondi)
- Età (secondi dall'ultimo rilevamento)
- Intervallo di supervisione (in secondi)
- Numero di messaggi in coda (nel caso in cui il bambino abbia sonno)
- Modalità dispositivo
- RSS (media e ultima)
- Frequenza di errore: frame tx (a livello MAC), messaggio IPv6 tx (sopra MAC)
- Tempo di connessione (secondi dal formato
{dd}d.{hh}:{mm}:{ss}
di creazione del collegamento) - Informazioni CSL:
- Se sincronizzato
- Periodo (in unità di 10 simboli-tempo)
- Timeout (in secondi)
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
router meshdiag vicino
Avvia una query per la tabella router vicino di un router con un determinato RLOC16. L'output elenca tutte le voci del router vicino. Informazioni per voce:
- RLOC16
- Indirizzo MAC esteso
- Versione thread
- RSS (media e ultima) e margine dei link
- Frequenze di errore, frame tx (a livello MAC), messaggio IPv6 tx (sopra MAC)
- Tempo di connessione (secondi dal formato
{dd}d.{hh}:{mm}:{ss}
di creazione del collegamento)
Parametri
meshdiag routerneighbortable router-rloc16
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
topologia meshdiag
Scopri la topologia di rete (elenco dei router e delle relative connessioni). I parametri sono facoltativi e indicano elementi aggiuntivi da scoprire. Possono essere aggiunti in qualsiasi ordine.
ip6-addrs
per trovare l'elenco di indirizzi IPv6 di ciascun router.children
per trovare la tabella figlio di ogni router.
Informazioni per router:
- ID router
- RLOC16
- Indirizzo MAC esteso
- Versione thread (se nota)
- Se il router è il dispositivo stesso (
me
) - Indica se il router è il dispositivo principale di questo dispositivo quando quest'ultimo è un bambino (
parent
) - Se il router è
leader
- Indica se il router funge da router di confine che fornisce connettività esterna (
br
) - Elenco dei router a cui è collegato il router:
3-links
: ID router a cui il router ha un link in entrata con qualità link 32-links
: ID router a cui il router ha un link in entrata con qualità link 21-links
: ID router a cui il router ha un link in entrata con qualità link 1- Se un elenco è vuoto, viene omesso.
- Se
ip6-addrs
, l'elenco di indirizzi IPv6 del router - Se
children
, elenca tutti gli elementi secondari del router. Informazioni per bambino:- RLOC16
- Qualità dei link in entrata dal punto di vista del livello principale a secondario (zero indica una qualità sconosciuta)
- Modalità dispositivo secondario (
r
rx-on-When-idle,d
dispositivo Thread completo,n
dati di rete completi,-
nessun flag impostato) - Se tuo figlio è il dispositivo stesso (
me
) - Se il publisher secondario agisce come router di confine che fornisce connettività esterna (
br
)
Parametri
meshdiag topology [ip6-addrs] [children]
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
Mleadvimax
Restituisce il valore massimo intervallo corrente utilizzato dal timer di esercizio di corrente pubblicità.
Questa API richiede OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
ed è destinata solo ai test.
Parametri
Nessun parametro.
Esempi
mleadvimax
12000
Done
Riferimenti per l'interfaccia a riga di comando e le API
mliid
Imposta l'IID locale mesh (a scopo di test).
Richiede OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
Deve essere utilizzato prima dell'abilitazione dello stack Thread.
Solo per dispositivi di test/di riferimento.
Parametri
mliid iid
Esempi
mliid 1122334455667788
Done
Riferimenti per l'interfaccia a riga di comando e le API
reg. mlr
Registra i listener multicast al router backbone principale.
OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE
e OPENTHREAD_CONFIG_COMMISSIONER_ENABLE
devono essere abilitati.
Ometti il timeout per utilizzare il timeout MLR predefinito sul router backbone principale.
Usa il timeout = 0 per annullare la registrazione dei listener multicast.
Parametri
mlr reg ipaddr [timeout]
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
modalità (get,set)
Imposta la configurazione della modalità di collegamento MLE.
Parametri
mode [rdn]
-
: nessun flag impostato (rx-off-quando-inattivo, dispositivo Thread minimo, dati di rete stabili)r
: rx-on-quando-inattivod
: dispositivo con tutta la tecnologia Threadn
: dati di rete completi
Esempi
mode rdn
Done
mode -
Done
Riferimenti per l'interfaccia a riga di comando e le API
multiradio
Scarica l'elenco dei link alle radio supportati dal dispositivo.
Questo comando è sempre disponibile, anche se il dispositivo supporta una sola radio.
Parametri
Nessun parametro.
Esempi
multiradio
[15.4, TREL]
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
elenco di vicini multiradio
Restituisce le informazioni sui link multi-radio associate al vicino di un determinato Indirizzo esteso.
OPENTHREAD_CONFIG_MULTI_RADIO
deve essere abilitato.
Parametri
Nessun parametro.
Esempi
multiradio neighbor list
ExtAddr:3a65bc38dbe4a5be, RLOC16:0xcc00, Radios:[15.4(255), TREL(255)]
ExtAddr:17df23452ee4a4be, RLOC16:0x1300, Radios:[15.4(255)]
Done
Riferimenti per l'interfaccia a riga di comando e le API
vicino multiradio
Restituisce le informazioni sui link multi-radio associate al vicino di un determinato Indirizzo esteso.
OPENTHREAD_CONFIG_MULTI_RADIO
deve essere abilitato.
Parametri
multiradio neighbor ext-address
Esempi
multiradio neighbor 3a65bc38dbe4a5be
[15.4(255), TREL(255)]
Done
Riferimenti per l'interfaccia a riga di comando e le API
nat64 (attivato,disattiva)
Abilita o disabilita le funzioni NAT64.
Se il criterio OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
è abilitato, l'impostazione disabilitata su true reimposta la tabella di mappatura nel traduttore.
Disponibile quando OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
o OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
è attivato.
Parametri
nat64 enable|disable
Esempi
nat64 enable
Done
nat64 disable
Done
Riferimenti per l'interfaccia a riga di comando e le API
sid64
Parametri
Nessun parametro.
Esempi
nat64 cidr 192.168.255.0/24
Done
Riferimenti per l'interfaccia a riga di comando e le API
sidro nat64
Ottiene il CIDR IPv4 configurato nel traduttore NAT64.
Disponibile quando OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
è attivato.
Parametri
Nessun parametro.
Esempi
nat64 cidr
192.168.255.0/24
Done
Riferimenti per l'interfaccia a riga di comando e le API
contatori nat64
Ottiene il pacchetto del traduttore NAT64 e i contatori degli errori.
Disponibile quando OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
è attivato.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
mappature nat64
Recupera le successive informazioni AddressMapping (utilizzando un iteratore).
Disponibile quando OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
è attivato.
Parametri
Nessun parametro.
Esempi
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 |
Riferimenti per l'interfaccia a riga di comando e le API
stato nat64
Ottiene lo stato delle funzioni NAT64.
Lo stato PrefixManager
è disponibile quando OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
è attivato. Lo stato Translator
è disponibile quando OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
è attivato.
Quando OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
è abilitato, PrefixManager
restituisce uno dei seguenti stati:
Disabled
: il gestore prefissi NAT64 è disabilitato.NotRunning
: il gestore prefissi NAT64 è abilitato, ma non è in esecuzione. Ciò potrebbe significare che Gestione routing è disattivato.Idle
: il gestore prefissi NAT64 è abilitato e in esecuzione, ma non pubblica un prefisso NAT64. Questo può accadere quando c'è un altro router di confine che pubblica un prefisso NAT64 con una priorità più alta.Active
: il gestore prefissi NAT64 è abilitato, in esecuzione e pubblica un prefisso NAT64.
Quando OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
è abilitato, Translator
restituisce uno dei seguenti stati:
Disabled
: il traduttore NAT64 è disabilitato.NotRunning
: il traduttore NAT64 è abilitato, ma non sta traducendo i pacchetti. Ciò potrebbe significare che il Traduttore non è configurato con un prefisso NAT64 o un CIDR per NAT64.Active
: il traduttore NAT64 è abilitato e sta traducendo i pacchetti.
Parametri
Nessun parametro.
Esempi
nat64 state
PrefixManager: Active
Translator: Active
Done
Riferimenti per l'interfaccia a riga di comando e le API
elenco contatti vicini
Stampa l'ora di connessione e l'età dei vicini. Questo comando è simile a neighbor conntime
, ma visualizza le informazioni sotto forma di elenco. L'età e il tempo di connessione sono entrambi visualizzati in secondi.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
tempo connessione vicino
Stampa l'ora di connessione e l'età dei vicini. Informazioni per vicino:
- RLOC16
- MAC esteso
- Ultimo udito (età): numero di secondi dall'ultimo udito dal vicino.
- Tempo di connessione: numero di secondi dalla creazione del collegamento con il vicino. Gli intervalli di durata vengono formattati come
{hh}:{mm}:{ss}
per ore, minuti e secondi se la durata è inferiore a un giorno. Se la durata è superiore a un giorno, il formato è{dd}d.{hh}:{mm}:{ss}
.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
linkquality vicino
Stampa le informazioni sulla qualità dei link relative a tutti i vicini.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
elenco di vicini
Elenca il RLOC16 di ogni vicino.
Parametri
Nessun parametro.
Esempi
neighbor list
0xcc01 0xc800 0xf000
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
tabella vicina
Stampa le informazioni in formato tabella su tutti i vicini.
Per Role
, gli unici valori possibili per questa tabella sono C
(secondario) o R
(router).
Le seguenti colonne forniscono informazioni sulla modalità dispositivo dei vicini. Ogni colonna ha un valore pari a 0
(disattivata) o 1
(attivata).
R
: RX attivo quando inattivoD
: dispositivo Thread completoN
: dati di rete completi
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
netdata pieno
Stampa "sì" o "no" che indica se i "dati netti completi" Il callback è stato richiamato dall'inizio dell'operazione Thread o dall'ultima volta che è stato utilizzato netdata full reset
per reimpostare il flag. Questo comando richiede OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL
. La metrica "Dati netti completi" viene richiamato ogni volta che:
- Il dispositivo agisce in qualità di leader e riceve da un router di confine (BR) una registrazione dei dati di rete che non può aggiungere ai dati di rete (esaurito lo spazio).
- Il dispositivo agisce come BR e non è possibile aggiungere nuove voci ai relativi dati di rete locali.
- Il dispositivo agisce come un BR e tenta di registrare le sue voci di dati di rete locali con la variante leader, ma determina che quelle locali non saranno adatte.
Parametri
Nessun parametro.
Esempi
netdata full
no
Done
Riferimenti per l'interfaccia a riga di comando e le API
reimpostazione completa netdata
Reimposta il flag monitorando se "net data full" è stato richiamato.
Parametri
Nessun parametro.
Esempi
netdata full reset
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
lunghezza netdata
Ottieni la lunghezza attuale (numero di byte) dei dati di rete Thread della partizione.
Parametri
Nessun parametro.
Esempi
netdata length
23
Done
Riferimenti per l'interfaccia a riga di comando e le API
netdata maxlength
Ottieni la lunghezza massima osservata dei dati di rete Thread dall'inizializzazione dello stack OT o dall'ultima chiamata a
otNetDataResetMaxLength()
.
Parametri
Nessun parametro.
Esempi
netdata maxlength
40
Done
Riferimenti per l'interfaccia a riga di comando e le API
netdata maxlength reimpostato
Reimposta la lunghezza massima tracciata dei dati di rete Thread.
Parametri
Nessun parametro.
Esempi
netdata maxlength reset
Done
Riferimenti per l'interfaccia a riga di comando e le API
netdata publish dnssrp anycast
Pubblica un indirizzo Anycast del servizio DNS/SRP con un numero di sequenza. Qualsiasi voce del servizio DNS/SRP corrente pubblicata da un comando publish dnssrp{anycast|unicast}
precedente viene rimossa e sostituita con i nuovi argomenti.
OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
deve essere abilitato.
Parametri
netdata publish dnssrp anycast seq-num
Esempi
netdata publish dnssrp anycast 1
Done
Riferimenti per l'interfaccia a riga di comando e le API
- netdata publish dnssrp unicast (addr,port)
- netdata publish dnssrp unicast (mle)
- otNetDataPublishDnsSrpServiceAnycast
netdata publish dnssrp unicast (addr,porta)
Pubblica un indirizzo Unicast del servizio DNS/SRP con un indirizzo e un numero di porta. Le informazioni su indirizzo e porta sono incluse nei dati TLV dei servizi. Qualsiasi voce del servizio DNS/SRP corrente pubblicata da un comando publish dnssrp{anycast|unicast}
precedente viene rimossa e sostituita con i nuovi argomenti.
OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
deve essere abilitato.
Parametri
netdata publish dnssrp unicast address port
Esempi
netdata publish dnssrp unicast fd00::1234 51525
Done
Riferimenti per l'interfaccia a riga di comando e le API
- netdata publish dnssrp unicast (mle)
- netdata publish dnssrp anycast
- otNetDataPublishDnsSrpServiceUnicast
netdata publish dnssrp unicast (mle)
Pubblica l'EID mesh-locale del dispositivo con un numero di porta. Le informazioni MLE e sulle porte sono incluse nei dati TLV del server. Per utilizzare un indirizzo Unicast diverso, usa il comando netdata publish dnssrp unicast (addr,port)
.
Qualsiasi voce del servizio DNS/SRP corrente pubblicata da un comando publish dnssrp{anycast|unicast}
precedente viene rimossa e sostituita con i nuovi argomenti.
OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
deve essere abilitato.
Parametri
netdata publish dnssrp unicast port
Esempi
netdata publish dnssrp unicast 50152
Done
Riferimenti per l'interfaccia a riga di comando e le API
- netdata publish dnssrp unicast (addr,port)
- netdata publish dnssrp anycast
- otNetDataPublishDnsSrpServiceUnicastMeshLocalEid
prefisso pubblicazione netdata
Pubblica una voce di prefisso on-mesh. Per saperne di più, consulta Visualizzare e gestire i dati di rete con OT CLI.
Parametri
netdata publish prefix prefix [padcrosnD] [high|med|low]
L'interfaccia a riga di comando OT utilizza argomenti mappati per configurare i valori otBorderRouterConfig. Per ulteriori informazioni, consulta la panoramica dell'interfaccia a riga di comando OpenThread.
Esempi
netdata publish prefix fd00:1234:5678::/64 paos med
Done
Riferimenti per l'interfaccia a riga di comando e le API
netdata publish sostituisci
Sostituisce una voce di route esterna pubblicata in precedenza. Per saperne di più, consulta Visualizzare e gestire i dati di rete con OT CLI.
Parametri
netdata publish replace oldprefix prefix [sn] [high|med|low]
L'interfaccia a riga di comando OT utilizza argomenti mappati per configurare i valori otExternalRouteConfig. Per ulteriori informazioni, consulta la panoramica dell'interfaccia a riga di comando OpenThread.
Esempi
netdata publish replace ::/0 fd00:1234:5678::/64 s high
Done
Riferimenti per l'interfaccia a riga di comando e le API
route di pubblicazione netdata
Pubblica una voce di route esterna. Per saperne di più, consulta Visualizzare e gestire i dati di rete con OT CLI.
Parametri
publish route prefix [sn] [high|med|low]
L'interfaccia a riga di comando OT utilizza argomenti mappati per configurare i valori otExternalRouteConfig. Per ulteriori informazioni, consulta la panoramica dell'interfaccia a riga di comando OpenThread.
Esempi
netdata publish route fd00:1234:5678::/64 s high
Done
Riferimenti per l'interfaccia a riga di comando e le API
registro netdata
Registrare prefissi, route e servizi configurati con il Leader.
Controlli dell'interfaccia a riga di comando OT per OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
. Se OTBR è abilitato, registra i dati di rete locali con il Leader. In caso contrario, chiama la funzione dell'interfaccia a riga di comando otServerRegister
. Per saperne di più, consulta Visualizzare e gestire i dati di rete con OT CLI.
Parametri
Nessun parametro.
Esempi
netdata register
Done
Riferimenti per l'interfaccia a riga di comando e le API
netdata steeringdata check (autore del controllo)
Controlla se i dati sul reindirizzamento includono un Joiner con un determinato valore di controllo.
Parametri
netdata steeringdata check discerner
discerner
: l'indice Joiner nel formato{number}/{length}
.
Esempi
netdata steeringdata check 0xabc/12
Done
netdata steeringdata check 0xdef/12
Error 23: NotFound
Riferimenti per l'interfaccia a riga di comando e le API
netdata steeringdata check (eui64)
Controlla se i dati sullo sterzo includono un joiner.
Parametri
netdata steeringdata check eui64
eui64
: l'IEEE EUI-64 del Joiner.
Esempi
netdata steeringdata check d45e64fa83f81cf7
Done
Riferimenti per l'interfaccia a riga di comando e le API
annullare pubblicazione di netdata (prefisso)
Annulla la pubblicazione di un prefisso di route esterno o on-mesh pubblicato in precedenza.
OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
deve essere abilitato.
Per saperne di più, consulta Visualizzare e gestire i dati di rete con OT CLI.
Parametri
netdata unpublish prefix
Esempi
netdata unpublish fd00:1234:5678::/64
Done
Riferimenti per l'interfaccia a riga di comando e le API
netdata annulla pubblicazione dnssrp
Annulla la pubblicazione di qualsiasi voce del servizio DNS/SRP (Anycast o Unicast) aggiunta in precedenza dai dati di rete Thread.
OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
deve essere abilitato.
Parametri
Nessun parametro.
Esempi
netdata unpublish dnssrp
Done
Riferimenti per l'interfaccia a riga di comando e le API
Netstat
Restituisce l'intestazione dell'elenco collegato di socket UDP.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
recupero diagnostica di rete
Invia una richiesta di diagnostica di rete per recuperare i valori TLV (Type Length) specificati per gli indirizzi specificati.
Parametri
networkdiagnostic get addr type(s)
Per addr
, un indirizzo unicast attiva un Diagnostic Get
. Un indirizzo multicast attiva un Diagnostic Query
. Valori TLV che puoi specificare (separati da uno spazio se specifichi più di un TLV):
0
: TLV indirizzo esteso MAC1
: TLV indirizzo 162
: modalità TLV3
: timeout TLV (periodo di tempo massimo di polling per i SED)4
: TLV per la connettività5
: Route64 TLV6
: TLV dei dati leader7
: TLV dei dati di rete8
: TLV elenco indirizzi IPv69
: TLV dei contatori MAC14
: Livello batteria TLV15
: TLV della tensione di alimentazione16
: TLV tabella secondaria17
: TLV delle pagine del canale19
: TLV timeout massimo dell'asset secondario23
: EUI64 TLV24
: versione TLV (numero di versione per i protocolli e le funzionalità)25
: TLV nome del fornitore26
: TLV modello fornitore27
: TLV versione software del fornitore28
: TLV versione stack Thread (identificatore di versione come stringa UTF-8 per codebase/commit/versione dello stack Thread)29
: TLV secondario34
: TLV per contatori MLE35
: TLV dell'URL dell'app del fornitore
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
reimpostazione diagnostica di rete
Invia una richiesta di diagnostica di rete per reimpostare i valori TLV (Type Length) specificati negli indirizzi specificati. Questo comando supporta solo i seguenti valori TLV: 9
(MAC Counters TLV) o 34
(MLE Counters TLV)
Parametri
networkdiagnostic reset addr type(s)
Esempi
networkdiagnostic reset fd00:db8::ff:fe00:0 9
Done
Riferimenti per l'interfaccia a riga di comando e le API
networkidtimeout (get,set)
Consente di acquisire o impostare il parametro NETWORK_ID_TIMEOUT
.
Parametri
networkidtimeout [timeout]
Utilizza l'argomento facoltativo timeout
per impostare il valore del parametro NETWORK_ID_TIMEOUT
.
Esempi
networkidtimeout 120
Done
networkidtimeout
120
Done
Riferimenti per l'interfaccia a riga di comando e le API
chiave di rete (chiave)
Imposta la chiave di rete Thread.
Riuscita solo quando i protocolli Thread sono disabilitati. Una chiamata riuscita a questa funzione rende i set di dati operativi attivi e in attesa nella memoria permanente.
Parametri
networkkey key
Esempi
networkkey 00112233445566778899aabbccddeeff
Done
Riferimenti per l'interfaccia a riga di comando e le API
chiave di rete
Ottieni la chiave di rete Thread.
Parametri
Nessun parametro.
Esempi
networkkey
00112233445566778899aabbccddeeff
Done
Riferimenti per l'interfaccia a riga di comando e le API
networkname (nome)
Imposta il nome della rete Thread.
Riuscita solo quando i protocolli Thread sono disabilitati. Una chiamata riuscita a questa funzione rende i set di dati operativi attivi e in attesa nella memoria permanente.
Parametri
networkname name
Esempi
networkname OpenThread
Done
Riferimenti per l'interfaccia a riga di comando e le API
nomerete
Ottieni il nome della rete Thread.
Parametri
Nessun parametro.
Esempi
networkname
OpenThread
Done
Riferimenti per l'interfaccia a riga di comando e le API
tempo di rete (impostato)
Consente di impostare i parametri di sincronizzazione dell'ora.
timesyncperiod
: il periodo di sincronizzazione dell'ora, in secondi.xtalthreshold
: la soglia di accuratezza XTAL necessaria per far diventare un dispositivo compatibile con il router, in PPM.
Parametri
networktime timesyncperiod xtalthreshold
Esempi
networktime 100 300
Done
Riferimenti per l'interfaccia a riga di comando e le API
tempo di rete
Ottiene l'ora della rete Thread e i parametri di sincronizzazione dell'ora.
Parametri
Nessun parametro.
Esempi
networktime
Network Time: 21084154us (synchronized)
Time Sync Period: 100s
XTAL Threshold: 300ppm
Done
Riferimenti per l'interfaccia a riga di comando e le API
nexthop (get)
Restituisce il costo dell'hop e del percorso successivo verso una determinata destinazione RLOC16.
Può essere utilizzato con aNextHopRloc16
o aPathCost
che è NULL, a indicare che il chiamante non vuole ottenere il valore.
Parametri
nexthop rloc16
Esempi
nexthop 0xc000
0xc000 cost:0
Done
nexthop 0x8001
0x2000 cost:3
Done
Riferimenti per l'interfaccia a riga di comando e le API
nexthop
Tabella di output degli ID router allocati e del costo attuale dell'hop successivo e del percorso per ciascun router.
Parametri
Nessun parametro.
Esempi
nexthop
| ID |NxtHop| Cost |
+------+------+------+
| 9 | 9 | 1 |
| 25 | 25 | 0 |
| 30 | 30 | 1 |
| 46 | - | - |
| 50 | 30 | 3 |
| 60 | 30 | 2 |
Done
Riferimenti per l'interfaccia a riga di comando e le API
panid (panid)
Impostare l'ID PAN IEEE 802.15.4.
Riuscita solo quando i protocolli Thread sono disabilitati. Una chiamata riuscita a questa funzione rende anche non validi i set di dati operativi attivi e in attesa nella memoria permanente.
Parametri
panid panid
Esempi
panid 0xdead
Done
Riferimenti per l'interfaccia a riga di comando e le API
panide
Ottieni l'ID PAN IEEE 802.15.4.
Parametri
Nessun parametro.
Esempi
panid
0xdead
Done
Riferimenti per l'interfaccia a riga di comando e le API
principale
Ottieni le informazioni diagnostiche per un router Thread come padre.
Quando utilizzi come router Thread e OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE è abilitato, questo comando restituirà le informazioni memorizzate nella cache relative a quando il dispositivo era stato precedentemente collegato come figlio Thread. La restituzione delle informazioni memorizzate nella cache è necessaria per supportare il Thread Test Harness - Test Scenario 8.2.x richiede l'indirizzo MAC del genitore precedente (ossia il Router Joiner) anche se il dispositivo è già diventato un router.
Parametri
Nessun parametro.
Esempi
parent
Ext Addr: be1857c6c21dce55
Rloc: 5c00
Link Quality In: 3
Link Quality Out: 3
Age: 20
Version: 4
Done
Riferimenti per l'interfaccia a riga di comando e le API
ricerca genitore
Avvia la procedura che consente al bambino di cercare un genitore migliore mantenendo il legame con il genitore attuale.
Deve essere utilizzato quando il dispositivo è collegato da un bambino.
Parametri
Nessun parametro.
Esempi
parent search
Done
Riferimenti per l'interfaccia a riga di comando e le API
parentPriority (get,set)
Consente di acquisire o impostare il valore di priorità padre assegnato: 1, 0, -1 o -2. -2 significa non assegnato.
Parametri
parentpriority [parentpriority]
Esempi
parentpriority
1
Done
parentpriority 1
Done
Riferimenti per l'interfaccia a riga di comando e le API
partitionid
Recupera l'ID partizione di rete Thread.
Parametri
Nessun parametro.
Esempi
partitionid
4294967295
Done
Riferimenti per l'interfaccia a riga di comando e le API
partitionid preferito (get,set)
Il campo OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
è obbligatorio.
Parametri
partitionid preferred partitionid
Esempi
partitionid preferred
4294967295
Done
partitionid preferred 0xffffffff
Done
Riferimenti per l'interfaccia a riga di comando e le API
platform
Stampa la piattaforma attuale
Parametri
Nessun parametro.
Esempi
platform
NRF52840
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
pollperiod (get,set)
Ottieni o imposta il periodo di sondaggio dati personalizzato del dispositivo finale per dormire (millisecondi). Solo per test di certificazione.
Parametri
Nessun parametro.
Esempi
pollperiod
0
Done
pollperiod 10
Done
Riferimenti per l'interfaccia a riga di comando e le API
Preferredrouterid
Specifica l'ID router preferito che il leader deve fornire quando richiesto.
Parametri
preferrouterid routerid
Esempi
preferrouterid 16
Done
Riferimenti per l'interfaccia a riga di comando e le API
aggiunta prefisso
Aggiunge un prefisso valido ai dati di rete.
Parametri
prefix add prefix [padcrosnD] [high|med|low]
L'interfaccia a riga di comando OT utilizza argomenti mappati per configurare i valori otBorderRouterConfig. Per ulteriori informazioni, consulta la panoramica dell'interfaccia a riga di comando OpenThread.
Esempi
prefix add 2001:dead:beef:cafe::/64 paros med
Done
prefix add fd00:7d03:7d03:7d03::/64 prosD low
Done
Riferimenti per l'interfaccia a riga di comando e le API
prefisso meshlocal
Ottieni il prefisso locale del mesh.
Parametri
Nessun parametro.
Esempi
prefix meshlocal
fdde:ad00:beef:0::/64
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
prefisso
Recupera l'elenco di prefissi nei dati di rete locali.
Per saperne di più sui flag otBorderRouterConfig, consulta la panoramica dell'interfaccia a riga di comando OpenThread.
Parametri
Nessun parametro.
Esempi
prefix
2001:dead:beef:cafe::/64 paros med
- fd00:7d03:7d03:7d03::/64 prosD med
Done
Riferimenti per l'interfaccia a riga di comando e le API
rimozione prefisso
Rimuovi la configurazione di un router di confine dai dati di rete locale.
Parametri
Nessun parametro.
Esempi
prefix remove 2001:dead:beef:cafe::/64
Done
Riferimenti per l'interfaccia a riga di comando e le API
promiscuo (attiva,disattiva)
Attiva o disattiva la modalità promiscuo del livello di link.
Parametri
promiscuous enable|disable
Esempi
promiscuous enable
Done
promiscuous disable
Done
Riferimenti per l'interfaccia a riga di comando e le API
promiscuo
Indica se la modalità promiscuo è attivata o meno a livello di link.
Parametri
Nessun parametro.
Esempi
promiscuous
Disabled
Done
Riferimenti per l'interfaccia a riga di comando e le API
pskc (insieme)
Imposta pskc in formato esadecimale.
Parametri
pskc key
Esempi
pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
pskc -p
Genera il codice pskc dalla passphrase (con codifica UTF-8), insieme al nome di rete corrente e all'ID PAN esteso.
Parametri
pskc -p passphrase
Esempi
pskc -p 123456
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
Pskc
Scarica il file PSKc Thread.
Parametri
Nessun parametro.
Esempi
pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done
Riferimenti per l'interfaccia a riga di comando e le API
pskcref (set)
Imposta il riferimento della chiave sul valore PSKc del thread.
Richiede l'abilitazione della funzionalità di fase di creazione OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE
.
L'operazione avrà esito positivo solo quando i protocolli Thread sono disabilitati. Se l'operazione riesce, i set di dati operativi attivi e in attesa nella memoria permanente verranno annullati anche.
Parametri
pskc keyref
Esempi
pskc 0x20017
Done
Riferimenti per l'interfaccia a riga di comando e le API
pskcref
Recupero riferimento chiave a PSKc Thread archiviato.
Richiede l'abilitazione della funzionalità di fase di creazione OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE
.
Parametri
Nessun parametro.
Esempi
pskcref
0x80000000
Done
Riferimenti per l'interfaccia a riga di comando e le API
opzione di attivazione/disattivazione (attiva,disattiva)
Attiva o disattiva la radio.
Parametri
radio enable|disable
Esempi
radio enable
Done
radio disable
Done
Riferimenti per l'interfaccia a riga di comando e le API
cancellazione statistiche radio
Reimposta le statistiche sulla radio.
Tutti gli orari vengono reimpostati su 0.
Parametri
Nessun parametro.
Esempi
radio stats clear
Done
Riferimenti per l'interfaccia a riga di comando e le API
statistiche radio
Recupera le statistiche radio.
Le statistiche della radio includono l'ora in cui la radio è in stato TX/RX/Sonno. Questi tempi sono espressi in microsecondi. Tutti gli orari vengono calcolati dall'ultima reimpostazione delle statistiche radio.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
versione rcp
Recupera la stringa della versione radio.
Parametri
Nessun parametro.
Esempi
rcp version
OPENTHREAD/20191113-00825-g82053cc9d-dirty; SIMULATION; Jun 4 2020 17:53:16
Done
Riferimenti per l'interfaccia a riga di comando e le API
regione (imposta)
Imposta il codice regione.
Il formato della regione radio è la rappresentazione ASCII a 2 byte del codice ISO 3166 alpha-2.
La modifica di questo valore può influire sul limite della potenza di trasmissione.
Parametri
Nessun parametro.
Esempi
region US
Done
Riferimenti per l'interfaccia a riga di comando e le API
regione
Recupera il codice regione.
Il formato della regione radio è la rappresentazione ASCII a 2 byte del codice ISO 3166 alpha-2.
Parametri
Nessun parametro.
Esempi
region
US
Done
Riferimenti per l'interfaccia a riga di comando e le API
releaserouterid (routerid)
Rilascia un ID router assegnato dal dispositivo nel ruolo Leader.
Parametri
releaserouterid [routerid]
Esempi
releaserouterid 16
Done
Riferimenti per l'interfaccia a riga di comando e le API
rloc16
Scarica RLOC16.
Parametri
Nessun parametro.
Esempi
rloc16
0xdead
Done
Riferimenti per l'interfaccia a riga di comando e le API
aggiunta percorso
Per i parametri, utilizza:
- s: flag stabile
- n: flag NAT64
- prf: preferenza router predefinita, [high, med, low].
Aggiungi una route esterna valida ai dati di rete.
Parametri
route add prefix [sn] [high|med|low]
Esempi
route add 2001:dead:beef:cafe::/64 s med
Done
Riferimenti per l'interfaccia a riga di comando e le API
rimozione percorso
Rimuovi la configurazione di una route esterna dai dati di rete locale.
Parametri
route remove [prefix]
Esempi
route remove 2001:dead:beef:cafe::/64
Done
Riferimenti per l'interfaccia a riga di comando e le API
percorso
Recupera l'elenco di route esterne nei dati di rete locali.
Parametri
Nessun parametro.
Esempi
route
2001:dead:beef:cafe::/64 s med
Done
Riferimenti per l'interfaccia a riga di comando e le API
router (ID)
La funzione conserva le informazioni diagnostiche per un determinato router Thread.
Stampa le informazioni diagnostiche relative a un router Thread. L'ID può essere un ID router o un RLOC16.
Parametri
router [id]
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
elenco router
Elenca gli ID router allocati.
Parametri
Nessun parametro.
Esempi
router list
8 24 50
Done
Riferimenti per l'interfaccia a riga di comando e le API
tavolo router
Stampa un elenco di router in formato tabella.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
soglia di downgrade del router (get,set)
Ottiene o imposta il valore ROUTER_DOWNGRADE_THRESHOLD.
Parametri
routerdowngradethreshold [threshold]
Esempi
routerdowngradethreshold
23
Done
routerdowngradethreshold 23
Done
Riferimenti per l'interfaccia a riga di comando e le API
router idoneo (attivato,disattivato)
Attiva o disattiva il ruolo router.
Parametri
routereligible [enable|disable]
Esempi
routereligible enable
Done
routereligible disable
Done
Riferimenti per l'interfaccia a riga di comando e le API
idoneo per il router
Indica se il ruolo router è abilitato o disabilitato.
Parametri
Nessun parametro.
Esempi
routereligible
Enabled
Done
Riferimenti per l'interfaccia a riga di comando e le API
routerselectionjitter
Consente di acquisire o impostare il valore ROUTER_SELECTION_JITTER.
Parametri
routerselectionjitter [jitter]
Esempi
routerselectionjitter
120
Done
routerselectionjitter 120
Done
Riferimenti per l'interfaccia a riga di comando e le API
soglia diupgrade del router (get,set)
Consente di acquisire o impostare il valore ROUTER_UPGRADE_THRESHOLD.
Parametri
routerupgradethreshold [threshold]
Esempi
routerupgradethreshold
16
Done
routerupgradethreshold 16
Done
Riferimenti per l'interfaccia a riga di comando e le API
scansione energia
Esegue una scansione dell'energia IEEE 802.15.4 e visualizza il tempo in millisecondi da utilizzare per la scansione di ciascun canale. Vengono mostrati tutti i canali, a meno che non ne specifichi uno specifico utilizzando l'opzione canale.
Parametri
scan energy [duration] [channel]
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
scansiona
Esegue una scansione attiva IEEE 802.15.4. La ricerca copre tutti i canali se non viene specificato alcun canale. altrimenti l'intervallo copre solo il canale specificato.
Parametri
scan [channel]
Esempi
scan
| PAN | MAC Address | Ch | dBm | LQI |
+------+------------------+----+-----+-----+
| ffff | f1d92a82c8d8fe43 | 11 | -20 | 0 |
Done
Riferimenti per l'interfaccia a riga di comando e le API
aggiunta al servizio
Aggiunge il servizio ai dati di rete.
- enterpriseNumber: codice IANA enterprise
- serviceData: dati dei servizi binari con codifica esadecimale
- serverData: dati del server binario con codifica esadecimale (vuoto se non fornito)
Parametri
service add enterpriseNumber serviceData [serverData]
Esempi
service add 44970 112233 aabbcc
Done
netdata register
Done
Riferimenti per l'interfaccia a riga di comando e le API
rimozione servizio
Rimuove il servizio dai dati di rete.
- enterpriseNumber: codice IANA enterprise
- serviceData: dati dei servizi binari con codifica esadecimale
Parametri
service remove enterpriseNumber serviceData
Esempi
service remove 44970 112233
Done
netdata register
Done
Riferimenti per l'interfaccia a riga di comando e le API
singleton
Indica se un nodo è l'unico router sulla rete. Restituisce true
o false
.
Parametri
Nessun parametro.
Esempi
singleton
true
Done
Riferimenti per l'interfaccia a riga di comando e le API
query sntp
Invia una query SNTP per ottenere l'ora dell'epoca Unix corrente (dal 1° gennaio 1970).
- Indirizzo IP predefinito del server SNTP:
2001:4860:4806:8::
(server NTP IPv6 di Google) - Porta predefinita del server SNTP:
123
Parametri
sntp query [SNTP server IP] [SNTP server port]
Esempi
sntp query
SNTP response - Unix time: 1540894725 (era: 0)
Done
sntp query 64:ff9b::d8ef:2308
SNTP response - Unix time: 1540898611 (era: 0)
Done
Riferimenti per l'interfaccia a riga di comando e le API
avvio automatico del client srp (get)
Indica lo stato attuale della modalità di avvio automatico (attivata o disattivata). Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.
Parametri
Nessun parametro.
Esempi
srp client autostart
Disabled
Done
Riferimenti per l'interfaccia a riga di comando e le API
disattivazione automatica dell'avvio automatico del client srp
Disattiva la modalità di avvio automatico.
La disattivazione della modalità di avvio automatico non arresta un client in esecuzione. Tuttavia, il client SRP interrompe il monitoraggio dei dati di rete Thread.
Parametri
Nessun parametro.
Esempi
srp client autostart disable
Done
Riferimenti per l'interfaccia a riga di comando e le API
Attivazione automatica client srp
Consente di attivare la modalità di avvio automatico.
Quando l'avvio automatico è abilitato, il client SRP monitora i dati di rete Thread per rilevare i server SRP, selezionare il server preferito e avviare e arrestare automaticamente il client quando viene rilevato un server SRP.
Tre categorie di voci di dati di rete indicano la presenza di un server SRP, da preferire nel seguente ordine:
- Voci Unicast in cui l'indirizzo del server è incluso nei dati di servizio. Se sono presenti più opzioni, è preferibile usare l'opzione con l'indirizzo IPv6 numerico più basso.
- Voci anycast che hanno ciascuna un numero di sequenza. È preferibile il numero di sequenza più grande specificato dalla logica aritmetica del numero di serie in RFC-1982.
- Voci Unicast in cui le informazioni sull'indirizzo del server sono incluse con i dati del server. Se sono presenti più opzioni, è preferibile usare l'opzione con l'indirizzo IPv6 numerico più basso.
Parametri
Nessun parametro.
Esempi
srp client autostart enable
Done
Riferimenti per l'interfaccia a riga di comando e le API
callback del client srp (get,enable,disable)
Consente di acquisire o attivare/disattivare la stampa degli eventi di callback dal client SRP. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.
Parametri
srp client callback [enable|disable]
Esempi
srp client callback enable
Done
srp client callback
Enabled
Done
Riferimenti per l'interfaccia a riga di comando e le API
Indirizzo host del client srp (get)
Indica se la modalità di indirizzo automatico è attivata. Se la modalità automatica degli indirizzi non è abilitata, viene restituito l'elenco di indirizzi host del client SRP. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
Indirizzo host client srp (set)
Attiva la modalità automatica degli indirizzi host o imposta esplicitamente l'elenco di indirizzi host. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.
Parametri
srp client host address [auto|address...]
- Utilizza il parametro
auto
per attivare la modalità automatica indirizzo host. Quando l'opzione è abilitata, il client utilizza automaticamente tutti gli indirizzi unicast Threadnetif
preferiti, ad eccezione degli indirizzi locali rispetto al collegamento e mesh-local. Se non è disponibile un indirizzo valido, viene aggiunto l'indirizzo EID locale del mesh. Il client SRP si registra di nuovo automaticamente se gli indirizzi nel threadnetif
vengono aggiunti o rimossi o contrassegnati come non preferiti. - Specifica in modo esplicito l'elenco di indirizzi host, separando ogni indirizzo con uno spazio. Puoi impostare questo elenco mentre il client è in esecuzione. L'operazione disattiverà anche la modalità indirizzo host automatico.
Esempi
srp client host address auto
Done
srp client host address fd00::cafe
Done
Riferimenti per l'interfaccia a riga di comando e le API
cancellazione host client srp
Cancella tutte le informazioni sull'host e tutti i servizi.
Parametri
Nessun parametro.
Esempi
srp client host clear
Done
Riferimenti per l'interfaccia a riga di comando e le API
Nome host del client srp (get,set)
Consente di acquisire o impostare il nome host del client SRP. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.
Parametri
srp client host name [name]
Per impostare il nome host del client quando l'host è stato rimosso o non è ancora registrato sul server, utilizza il parametro name
.
Esempi
srp client host name dev4312
Done
srp client host name
dev4312
Done
Riferimenti per l'interfaccia a riga di comando e le API
rimozione host client srp
Rimuove le informazioni sull'host del client SRP e tutti i servizi dal server SRP. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.
Parametri
srp client host remove [removekeylease] [sendunregtoserver]
- Il parametro
removekeylease
è un valore booleano facoltativo che indica se deve essere rimosso anche il lease della chiave host (il valore predefinito èfalse
). - Il parametro
sendunregtoserver
è un valore booleano facoltativo che indica se l'host del client deve inviare un "aggiornamento" al server anche se le informazioni sull'host del client non sono ancora state registrate sul server (il valore predefinito èfalse
). Questo parametro può essere specificato solo se il parametroremovekeylease
viene specificato per primo nel comando.
Esempi
srp client host remove 1
Done
Riferimenti per l'interfaccia a riga di comando e le API
host client srp
Recupera le informazioni sull'host.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
stato host del client srp
Restituisce lo stato dell'host del client SRP. Stati possibili:
ToAdd
: articolo da aggiungere/registrare.Adding
: l'elemento è in fase di aggiunta/registrazione.ToRefresh
: elemento da aggiornare per il rinnovo del leasing.Refreshing
: l'elemento è stato aggiornato.ToRemove
: elemento da rimuovere.Removing
: l'elemento è in fase di rimozione.Registered
: l'elemento è registrato sul server.Removed
: l'elemento è stato rimosso.
Parametri
Nessun parametro.
Esempi
srp client host state
Registered
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
keyleaseinterval del client srp (get,set)
Consente di acquisire o impostare l'intervallo di lease della chiave in secondi.
Parametri
srp client keyleaseinterval [interval]
Esempi
srp client keyleaseinterval 864000
Done
srp client keyleaseinterval
864000
Done
Riferimenti per l'interfaccia a riga di comando e le API
srp client leaseinterval (get,set)
Consente di ottenere o impostare l'intervallo di lease in secondi.
Parametri
srp client leaseinterval [interval]
Esempi
srp client leaseinterval 3600
Done
srp client leaseinterval
3600
Done
Riferimenti per l'interfaccia a riga di comando e le API
indirizzo del server client srp
Restituisce l'indirizzo IPv6 del server.
Parametri
Nessun parametro.
Esempi
srp client server address
fd00:0:0:0:d88a:618b:384d:e760
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
Porta server client srp
Restituisce il numero di porta del server.
Parametri
Nessun parametro.
Esempi
srp client server port
4724
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
server client srp
Restituisce l'indirizzo del socket (indirizzo IPv6 e numero di porta) del server SRP utilizzato dal client SRP. Se il client non è in esecuzione, l'indirizzo non è specificato (tutti zeri) con un numero di porta pari a 0. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.
Parametri
Nessun parametro.
Esempi
srp client server
[fd00:0:0:0:d88a:618b:384d:e760]:4724
Done
Riferimenti per l'interfaccia a riga di comando e le API
aggiunta servizio clienti srp
Aggiunge un servizio con un determinato nome istanza, nome servizio e numero di porta. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.
Parametri
srp client service add instancename servicename port [priority] [weight] [txt]
Il parametro servicename
può includere facoltativamente un elenco di etichette di sottotipo di servizio, separate da virgole. Gli esempi qui utilizzano una denominazione generica. I parametri priority
e weight
(entrambi sono valori uint16_t
) sono facoltativi. Se non viene fornito, viene utilizzato zero. Il parametro facoltativo txt
consente di impostare i dati TXT associati al servizio. Il valore txt
deve essere in formato di stringa esadecimale e viene considerato come una sequenza di byte di dati TXT già codificata.
Esempi
srp client service add ins1 _test1._udp 777
Done
srp client service add ins2 _test2._udp,_sub1,_sub2 111 1 1
Done
Riferimenti per l'interfaccia a riga di comando e le API
Chiave del servizio client srp (get,set)
Consente di acquisire o impostare la modalità di inclusione del record di chiavi del servizio nel client SRP. Questo comando è solo a scopo di test e richiede l'abilitazione di OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.
Parametri
Nessun parametro.
Esempi
srp client service key enable
Done
srp client service key
Enabled
Done
Riferimenti per l'interfaccia a riga di comando e le API
cancella nome servizio client srp
Cancella un servizio, rimuovendolo immediatamente dall'elenco dei servizi client, senza interazione con il server SRP.
Parametri
srp client service clear instancename servicename
Esempi
srp client service clear ins2 _test2._udp
Done
Riferimenti per l'interfaccia a riga di comando e le API
rimozione servizio clienti srp
Consente di richiedere l'annullamento della registrazione di un servizio con il server SRP.
Parametri
srp client service remove instancename servicename
Esempi
srp client service remove ins2 _test2._udp
Done
Riferimenti per l'interfaccia a riga di comando e le API
servizio clienti srp
Ottiene l'elenco dei servizi gestiti dal client.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
avvio client srp
Avvia l'operazione del client SRP. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.
Parametri
srp client start serveraddr serverport
Esempi
srp client start fd00::d88a:618b:384d:e760 4724
Done
Riferimenti per l'interfaccia a riga di comando e le API
stato client srp
Indica se il client SRP è in esecuzione o meno.
Parametri
Nessun parametro.
Esempi
srp client state
Enabled
Done
Riferimenti per l'interfaccia a riga di comando e le API
blocco client srp
Interrompe l'operazione del client SRP.
Arresta qualsiasi ulteriore interazione con il server SRP. Tieni presente che le informazioni sull'host e/o l'elenco di servizi non vengono rimosse né cancellate. Contrassegna tutti i servizi da aggiungere/rimuovere di nuovo dopo l'avvio del client.
Parametri
Nessun parametro.
Esempi
srp client stop
Done
Riferimenti per l'interfaccia a riga di comando e le API
ttl del client srp (get,set)
Consente di acquisire o impostare il valore ttl
(time to live) in secondi.
Parametri
srp client ttl [value]
Esempi
srp client ttl 3600
Done
srp client ttl
3600
Done
Riferimenti per l'interfaccia a riga di comando e le API
server srp (attivato,disattivato)
Attiva o disattiva il server SRP. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.
Parametri
srp server [enable|disable]
Esempi
srp server disable
Done
Riferimenti per l'interfaccia a riga di comando e le API
addrmode server srp (get,set)
Consente di acquisire o impostare la modalità di indirizzo utilizzata dal server SRP.
La modalità indirizzo indica al server SRP come determinare il proprio indirizzo e il numero di porta, che vengono poi pubblicati nei dati della rete Thread.
Parametri
srp server addrmode [anycast|unicast]
Esempi
srp server addrmode anycast
Done
srp server addrmode
anycast
Done
Riferimenti per l'interfaccia a riga di comando e le API
srp server auto (attivato,disattivato)
Attiva o disattiva la modalità di attivazione automatica sul server SRP.
Quando questa modalità è attivata, il Border Routing Manager stabilisce se e quando attivare o disattivare il server SRP.
Questo comando richiede l'abilitazione di OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE
. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.
Parametri
srp server auto [enable|disable]
Esempi
srp server auto enable
Done
srp server auto
Enabled
Done
Riferimenti per l'interfaccia a riga di comando e le API
Dominio server srp (get,set)
Consente di acquisire o impostare il nome di dominio del server SRP.
Parametri
srp server domain [domain-name]
Esempi
srp server domain thread.service.arpa.
Done
srp server domain
thread.service.arpa.
Done
Riferimenti per l'interfaccia a riga di comando e le API
host server srp
Restituisce informazioni su tutti gli host registrati. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
Lease server srp (get,set)
Ottiene o imposta i valori di lease del server SRP in numero di secondi.
Parametri
srp server lease [min-lease max-lease min-key-lease max-key-lease]
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
Seqnum server srp (get,set)
Ottiene o imposta il numero di sequenza utilizzato con la modalità degli indirizzi anycast. Il numero di sequenza è incluso nell'"Indirizzo Anycast del servizio DNS/SRP" pubblicata nella sezione Dati di rete.
Parametri
srp server seqnum [seqnum]
Esempi
srp server seqnum 20
Done
srp server seqnum
20
Done
Riferimenti per l'interfaccia a riga di comando e le API
servizio server srp
Restituisce informazioni sui servizi registrati.
Il record TXT
viene visualizzato come un array di voci. Se una voce contiene una chiave, la chiave viene stampata in formato ASCII. La parte del valore viene stampata in byte esadecimali. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
- otSrpServerServiceGetInstanceName
- otSrpServerServiceGetServiceName
- otSrpServerServiceGetSubTypeServiceNameAt
stato server srp
Restituisce uno dei seguenti stati possibili del server SRP:
disabled
: il server SRP non è abilitato.stopped
: il server SRP è abilitato ma non attivo a causa di server SRP esistenti già attivi nella rete Thread. Il server SRP può diventare attivo quando i server SRP esistenti non sono più attivi all'interno della rete Thread.running
: il server SRP è attivo e può gestire le registrazioni dei servizi.
Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.
Parametri
Nessun parametro.
Esempi
srp server state
running
Done
Riferimenti per l'interfaccia a riga di comando e le API
stato
Restituisce il ruolo attuale del dispositivo Thread o modifica il ruolo come specificato con una delle opzioni. Possibili valori restituiti durante la richiesta di informazioni sul ruolo del dispositivo:
child
: il dispositivo attualmente funziona come account secondario Thread.router
: il dispositivo attualmente funziona come router Thread.leader
: il dispositivo attualmente opera come leader Thread.detached
: al momento il dispositivo non fa parte di una rete/partizione Thread.disabled
: lo stack di thread è attualmente disabilitato.
L'utilizzo di una delle opzioni ti consente di modificare il ruolo attuale di un dispositivo, escludendo lo stato disabled
.
Parametri
state [child|router|leader|detached]
Esempi
state
child
Done
state leader
Done
Riferimenti per l'interfaccia a riga di comando e le API
- otThreadGetDeviceRole
- otThreadBecomeChild
- otThreadBecomeRouter
- otThreadBecomeLeader
- otThreadBecomeDetached
interrompi tcp
Chiude senza cerimonie la connessione TCP associata all'endpoint TCP di esempio, passando allo stato chiuso.
Parametri
Nessun parametro.
Esempi
tcp abort
TCP: Connection reset
Done
Riferimenti per l'interfaccia a riga di comando e le API
risultato benchmark tcp
Mostra l'ultimo risultato del test di benchmark TCP. Valori di stato possibili:
- In corso
- Completato
- Non testato
Questo comando è destinato principalmente alla creazione di script che automatizzano il test di benchmark TCP.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
esecuzione benchmark TCP
Trasferisce il numero specificato di byte utilizzando la connessione TCP attualmente associata all'endpoint TCP di esempio fornito dall'interfaccia a riga di comando di tcp
.
Parametri
tcp benchmark run [size]
Utilizza il parametro size
per specificare il numero di byte da inviare per il benchmark. Se non utilizzi il parametro size
, viene utilizzato il valore predefinito (OPENTHREAD_CONFIG_CLI_TCP_DEFAULT_BENCHMARK_SIZE
).
Esempi
tcp benchmark run
Done
TCP Benchmark Complete: Transferred 73728 bytes in 7233 milliseconds
TCP Goodput: 81.546 kb/s
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
associazione tcp
Associa un indirizzo IPv6 e una porta all'endpoint TCP di esempio fornito dall'interfaccia a riga di comando tcp
. L'associazione dell'endpoint TCP a un indirizzo e a una porta IPv6 prende il nome di "denominazione dell'endpoint TCP". In questo modo l'endpoint viene associato per la comunicazione. Per ulteriori informazioni, fai riferimento all'articolo Testare la funzionalità TCP con OT CLI.
Parametri
tcp bind ip port
ip
: indirizzo IPv6 a cui eseguire l'associazione. Se vuoi che lo stack TCP/IPv6 assegni l'indirizzo IPv6 di associazione, utilizza l'indirizzo IPv6 non specificato:::
.port
: numero di porta TCP a cui eseguire l'associazione.
Esempi
tcp bind :: 30000
Done
Riferimenti per l'interfaccia a riga di comando e le API
connetti TCP
Stabilisce una connessione con il peer specificato.
Se la connessione ha esito positivo, la connessione TCP risultante viene associata all'endpoint TCP di esempio. Per ulteriori informazioni, fai riferimento all'articolo Testare la funzionalità TCP con OT CLI.
Parametri
tcp connect ip port [fastopen]
ip
: indirizzo IP del peer. L'indirizzo può essere un indirizzo IPv4, che viene sintetizzato in un indirizzo IPv6 utilizzando il prefisso NAT64 preferito dai dati di rete. Il comando restituisceInvalidState
se il prefisso NAT64 preferito non è disponibile.port
: numero di porta TCP del peer.fastopen
: questo parametro è facoltativo. Se impostato sufast
, l'apertura rapida TCP viene abilitata per questa connessione. In caso contrario, se questo parametro viene impostato suslow
o non viene utilizzato, l'apertura rapida TCP viene disattivata.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
deinit tcp
Deinizializza questo endpoint TCP.
Ciò significa che OpenThread non tiene più traccia di questo endpoint TCP e riassegna tutte le risorse che ha allocato internamente per questo endpoint TCP. L'applicazione può riutilizzare la memoria a supporto dell'endpoint TCP a seconda delle esigenze.
Se corrisponde a una connessione TCP in tempo reale, la connessione viene terminata senza cerimonie (come in otTcpAbort()). Tutte le risorse fornite dall'applicazione per questo endpoint TCP (buffer collegati per il buffer di invio, memoria per il buffer di ricezione, la stessa struttura aEndpoint
e così via) vengono immediatamente restituite all'applicazione.
Parametri
Nessun parametro.
Esempi
tcp deinit
Done
Riferimenti per l'interfaccia a riga di comando e le API
init tcp
Inizializza il listener TCP di esempio e l'endpoint TCP di esempio fornito dall'interfaccia a riga di comando tcp
.
Parametri
tcp init [mode] [size]
mode
ha tre valori possibili:tls
: specifica che la connessione TCP tra due nodi deve utilizzare anche il protocollo TLS oltre a TCP. Quando due nodi comunicano tramite TCP, entrambi devono utilizzare TLS o nessuno dei due deve utilizzare TLS, perché un endpoint non TLS non è in grado di comunicare con un endpoint TLS.linked
ocircular
: una di queste opzioni significa che non deve essere utilizzato TLS e che deve essere utilizzato il tipo di buffering specificato per il buffering TCP. Il comportamento dilinked
ecircular
è identico. Esamina il codice per verificare le differenze tra questi due tipi di buffering. Non sono necessari due endpoint di una connessione TCP per utilizzare lo stesso tipo di buffering.
- Il parametro
size
imposta le dimensioni del buffer di ricezione da associare all'endpoint TCP di esempio. Se il criterio non viene specificato, viene utilizzata la dimensione massima. La dimensione massima è impostata inOPENTHREAD_CONFIG_CLI_TCP_RECEIVE_BUFFER_SIZE
.
Esempi
tcp init tls
Done
Riferimenti per l'interfaccia a riga di comando e le API
tcp in ascolto
Utilizza il listener TCP di esempio per ascoltare le connessioni in entrata sull'indirizzo e sulla porta IPv6 specificati. Per ulteriori informazioni, fai riferimento all'articolo Testare la funzionalità TCP con OT CLI.
Parametri
tcp listen ip port
I seguenti parametri sono obbligatori:
ip
: indirizzo IPv6 o indirizzo IPv6 non specificato (::
) del listener TCP di esempio fornito dall'interfaccia a riga di comandotcp
.port
: porta TCP del listener TCP di esempio. Se nessuna connessione TCP è associata all'endpoint TCP di esempio, tutte le connessioni in entrata corrispondenti all'indirizzo IPv6 e alla porta specificati vengono accettate e associate all'endpoint TCP di esempio.
Esempi
tcp listen :: 30000
Done
Riferimenti per l'interfaccia a riga di comando e le API
invio tcp
Invia i dati tramite la connessione TCP associata all'endpoint TCP di esempio fornita con l'interfaccia a riga di comando tcp
. Per ulteriori informazioni, fai riferimento all'articolo Testare la funzionalità TCP con OT CLI.
Parametri
tcp send message
Il parametro message
contiene il messaggio da inviare all'endpoint TCP remoto.
Esempi
tcp send hello
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
tcp invio
Invia la "fine dello stream" segnale sulla connessione TCP associata all'endpoint TCP di esempio fornito dall'interfaccia a riga di comando di tcp
. In questo modo si comunica al peer che non riceverà altri dati tramite questa connessione TCP.
Parametri
Nessun parametro.
Esempi
tcp sendend
Done
Riferimenti per l'interfaccia a riga di comando e le API
ascolto interrotto tcp
Indica al listener TCP di esempio di interrompere l'ascolto delle connessioni TCP in entrata.
Parametri
Nessun parametro.
Esempi
tcp stoplistening
Done
Riferimenti per l'interfaccia a riga di comando e le API
test tmforiginfilter
Attiva o disattiva il filtro per eliminare i messaggi TMF UDP da origini non attendibili.
Per impostazione predefinita, il filtro che elimina i messaggi TMF UDP dall'origine non attendibile è attivato. Se questa opzione è disattivata, i messaggi UDP inviati alla porta TMF che provengono da un'origine non attendibile (come un host, l'interfaccia a riga di comando o un nodo IPv6 esterno) saranno consentiti.
Parametri
test tmforiginfilter [enable|disable]
Esempi
test tmforiginfilter
Enabled
test tmforiginfilter enable
Done
test tmforiginfilter disable
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
inizio thread
Avvia l'operazione sul protocollo Thread.
Parametri
Nessun parametro.
Esempi
thread start
Done
Riferimenti per l'interfaccia a riga di comando e le API
interruzione thread
Interrompe l'operazione del protocollo Thread.
Parametri
Nessun parametro.
Esempi
thread stop
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
versione thread
Ottiene la versione del protocollo Thread.
Le costanti OT_THREADVERSION*
definiscono i valori numerici della versione.
Parametri
Nessun parametro.
Esempi
thread version
2
Done
Riferimenti per l'interfaccia a riga di comando e le API
timeinqueue max
Restituisce il tempo in coda massimo per i messaggi nella coda TX.
Richiede OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE
.
Il tempo in coda viene monitorato solo per le trasmissioni dirette e misurato come il tempo trascorso dal momento in cui un messaggio viene aggiunto alla coda di trasmissione fino a quando viene passato al livello MAC per la trasmissione o l'eliminazione.
Le statistiche raccolte possono essere reimpostate chiamando
otThreadResetTimeInQueueStat()
.
Parametri
Nessun parametro.
Esempi
timeinqueue max
281
Done
Riferimenti per l'interfaccia a riga di comando e le API
reimpostazione coda temporale
Reimposta le statistiche relative al tempo in coda nella coda di trasmissione.
Richiede OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE
.
Parametri
Nessun parametro.
Esempi
timeinqueue reset
Done
Riferimenti per l'interfaccia a riga di comando e le API
timeinqueue
Ottiene l'istogramma del tempo in coda per i messaggi presenti nella coda di trasmissione.
Richiede OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE
.
Viene raccolto l'istogramma del tempo in coda dei messaggi nella coda di trasmissione. Il tempo in coda viene monitorato solo per le trasmissioni dirette e misurato come il tempo trascorso dal momento in cui un messaggio viene aggiunto alla coda di trasmissione fino a quando viene passato al livello MAC per la trasmissione o l'eliminazione.
L'istogramma viene restituito come array di valori uint32_t
con voci aNumBins
. La prima voce dell'array (in indice 0) rappresenta il numero di messaggi con un tempo di coda inferiore a aBinInterval
. La seconda voce rappresenta il numero di messaggi con un tempo di coda maggiore o uguale a aBinInterval
, ma inferiore a 2 * aBinInterval
. e così via. L'ultima voce rappresenta il numero di messaggi con tempo di coda maggiore o uguale a (aNumBins - 1) * aBinInterval
.
Le statistiche raccolte possono essere reimpostate chiamando
otThreadResetTimeInQueueStat()
. Le informazioni sull'istogramma vengono raccolte a partire dall'inizializzazione dell'istanza OpenThread o dall'ultima reimpostazione della raccolta di statistiche chiamando il
otThreadResetTimeInQueueStat()
.
I puntatori aNumBins
e aBinInterval
NON DEVONO essere NULL.
Parametri
Nessun parametro.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
trel (attiva,disattiva)
Attiva o disattiva l'operazione radio TREL.
Parametri
trel enable|disable
Esempi
trel enable
Done
trel disable
Done
Riferimenti per l'interfaccia a riga di comando e le API
contatori trel reimpostati
Reimposta i contatori TREL.
Parametri
Nessun parametro.
Esempi
trel counters reset
Done
Riferimenti per l'interfaccia a riga di comando e le API
contatori Trel
Ottiene i contatori TREL.
Parametri
Nessun parametro.
Esempi
trel counters
Inbound: Packets 32 Bytes 4000
Outbound: Packets 4 Bytes 320 Failures 1
Done
Riferimenti per l'interfaccia a riga di comando e le API
filtro trel (attivato,disattivato)
Attiva o disattiva la modalità filtro TREL.
Parametri
trel filter enable|disable
Esempi
trel filter enable
Done
trel filter disable
Done
Riferimenti per l'interfaccia a riga di comando e le API
filtro trel
Indica se la modalità filtro TREL è abilitata.
Quando la modalità filtro è attiva, tutto il traffico Rx e Tx inviato tramite l'interfaccia TREL viene eliminato automaticamente.
Parametri
Nessun parametro.
Esempi
trel filter
Disabled
Done
Riferimenti per l'interfaccia a riga di comando e le API
Trel peer
Restituisce la tabella peer TREL in formato tabella o elenco.
Parametri
trel peers [list]
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
Trel
Indica se l'operazione TREL è abilitata.
Parametri
Nessun parametro.
Esempi
trel
Enabled
Done
Riferimenti per l'interfaccia a riga di comando e le API
tvcheck (attiva,disattiva)
Attiva o disattiva il controllo della versione di Thread durante l'upgrade al router o alla versione leader. Questo controllo è abilitato per impostazione predefinita.
Parametri
Nessun parametro.
Esempi
tvcheck enable
Done
tvcheck disable
Done
Riferimenti per l'interfaccia a riga di comando e le API
txpower (get,set)
Ottiene (o imposta con l'utilizzo dell'argomento facoltativo txpower
) la potenza di trasmissione in dBm.
Parametri
txpower [txpower]
Esempi
txpower -10
Done
txpower
-10 dBm
Done
Riferimenti per l'interfaccia a riga di comando e le API
associazione udp
Assegna un indirizzo IPv6 e una porta a un socket aperto che vincola il socket per la comunicazione. L'assegnazione dell'indirizzo e della porta IPv6 prende il nome del socket. Per saperne di più, consulta Testare la funzionalità UDP con l'interfaccia a riga di comando OT.
Parametri
udp bind [netif] ip port
netif
: l'interfaccia di rete di associazione, determinata come segue:- Nessun valore (esce questo parametro dal comando): viene utilizzata l'interfaccia di rete Thread.
-u
: interfaccia di rete non specificata, il che significa che lo stack UDP/IPv6 determina a quale interfaccia di rete associare il socket.-b
: viene utilizzata l'interfaccia di rete backbone.
ip
: indirizzo IPv6 Unicast a cui eseguire l'associazione. Se vuoi che lo stack UDP/IPv6 assegni l'indirizzo IPv6 di associazione o se vuoi eseguire l'associazione a indirizzi IPv6 multicast, puoi utilizzare il seguente valore per utilizzare l'indirizzo IPv6 non specificato:::
. Ogni esempio utilizza l'indirizzo IPv6 non specificato.port
: numero di porta UDP a cui eseguire l'associazione. Ciascuno degli esempi utilizza il numero di porta 1234.
Esempi
udp bind :: 1234
Done
udp bind -u :: 1234
Done
udp bind -b :: 1234
Done
Riferimenti per l'interfaccia a riga di comando e le API
chiudi udp
Chiudi un socket UDP/IPv6.
Parametri
Nessun parametro.
Esempi
udp close
Done
Riferimenti per l'interfaccia a riga di comando e le API
connessione udp
Connetti un socket UDP/IPv6.
Parametri
udp connect ip port
I seguenti parametri sono obbligatori:
ip
: indirizzo IP del peer.port
: numero di porta UDP del peer. L'indirizzo può essere un indirizzo IPv4, che viene sintetizzato in un indirizzo IPv6 usando il prefisso NAT64 preferito dai dati di rete. Il comando restituisceInvalidState
se il prefisso NAT64 preferito non è disponibile.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
udp linksecurity (attiva,disattiva)
Attiva o disattiva la sicurezza dei link.
Parametri
Nessun parametro.
Esempi
udp linksecurity enable
Done
udp linksecurity disable
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
linksecurity udp
Indica se la sicurezza dei link è attivata o disattivata.
Parametri
Nessun parametro.
Esempi
udp linksecurity
Enabled
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
udp aperta
Apri un socket UDP/IPv6.
Parametri
Nessun parametro.
Esempi
udp open
Done
Riferimenti per l'interfaccia a riga di comando e le API
invio udp
Invia un messaggio UDP utilizzando il socket. Per saperne di più, consulta Testare la funzionalità UDP con l'interfaccia a riga di comando OT.
Parametri
udp send [ip port] [type] value
ip
e port
sono facoltativi come coppia, ma se specifichi uno devi specificare l'altro. Se ip
e port
non sono specificati, l'indirizzo peer socket viene utilizzato da udp connect
.
ip
: indirizzo di destinazione. Questo indirizzo può essere un indirizzo IPv4 o IPv6. Un indirizzo IPv4 viene sintetizzato in un indirizzo IPv6 con il prefisso NAT64 preferito dai dati di rete. Se il prefisso NAT64 preferito non è disponibile, il comando restituisceInvalidState
.port
: porta di destinazione UDP.type
/value
combinazioni:-t
: il payload nel parametrovalue
viene considerato come testo. Se non viene inserito alcun valore pertype
, anche il payload nel parametrovalue
viene considerato come testo.-s
: payload generato automaticamente con la lunghezza specificata nel parametrovalue
.-x
: dati binari nella rappresentazione esadecimale specificata nel parametrovalue
.
Esempi
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
Riferimenti per l'interfaccia a riga di comando e le API
non sicuro
Elenca tutte le porte incluse nell'elenco delle porte non protette consentite.
Parametri
Nessun parametro.
Esempi
unsecure get
1234
Done
Riferimenti per l'interfaccia a riga di comando e le API
aggiunta non sicura
Aggiunge una porta all'elenco delle porte non protette consentite.
Parametri
unsecureport add port
Esempi
unsecureport add 1234
Done
Riferimenti per l'interfaccia a riga di comando e le API
rimozione non sicura
Rimuove una o tutte le porte specificate dall'elenco di porte non protette consentite.
Parametri
unsecureport remove port|all
Esempi
unsecureport remove 1234
Done
unsecureport remove all
Done
Riferimenti per l'interfaccia a riga di comando e le API
uptime in ms
Restituisce l'uptime dell'istanza attuale (in msec).
Richiede l'attivazione di OPENTHREAD_CONFIG_UPTIME_ENABLE
.
Il tempo di attività è espresso in millisecondi dall'inizializzazione dell'istanza OpenThread.
Parametri
Nessun parametro.
Esempi
uptime ms
426238
Done
Riferimenti per l'interfaccia a riga di comando e le API
periodo di attività
Restituisce l'uptime dell'istanza corrente come stringa leggibile.
Richiede l'attivazione di OPENTHREAD_CONFIG_UPTIME_ENABLE
.
La stringa segue il formato "
Se la stringa risultante non rientra in aBuffer
(nei suoi aSize
caratteri), la stringa verrà troncata ma la stringa emessa è sempre con terminazione null.
Parametri
Nessun parametro.
Esempi
uptime
12:46:35.469
Done
Riferimenti per l'interfaccia a riga di comando e le API
URL app del fornitore (impostato)
Imposta la stringa URL dell'app del fornitore.
Richiede OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
.
Il campo aVendorAppUrl
deve essere in UTF8 con una lunghezza massima di 64 caratteri (MAX_VENDOR_APPL_URL_TLV_LENGTH
). La lunghezza massima non include il carattere \0
null.
Parametri
vendor appurl url
Esempi
vendor appurl http://www.example.com
Done
Riferimenti per l'interfaccia a riga di comando e le API
URL app del fornitore
Recupera la stringa URL dell'app del fornitore.
Parametri
Nessun parametro.
Esempi
vendor appurl
http://www.example.com
Done
Riferimenti per l'interfaccia a riga di comando e le API
modello di fornitore (insieme)
Imposta la stringa del modello del fornitore.
Richiede OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
.
Il campo aVendorModel
deve essere in UTF8 con una lunghezza massima di 32 caratteri (MAX_VENDOR_MODEL_TLV_LENGTH
). La lunghezza massima non include il carattere \0
null.
Parametri
vendor model name
Esempi
vendor model Hub\ Max
Done
Riferimenti per l'interfaccia a riga di comando e le API
modello di fornitore
Ottieni la stringa del modello di fornitore.
Parametri
Nessun parametro.
Esempi
vendor model
Hub Max
Done
Riferimenti per l'interfaccia a riga di comando e le API
nome del fornitore (insieme)
Imposta la stringa del nome del fornitore.
Richiede OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
.
Il campo aVendorName
deve essere in UTF8 con una lunghezza massima di 32 caratteri (MAX_VENDOR_NAME_TLV_LENGTH
). La lunghezza massima non include il carattere \0
null.
Parametri
vendor name name
Esempi
vendor name nest
Done
Riferimenti per l'interfaccia a riga di comando e le API
nome del fornitore
Recupera la stringa del nome del fornitore.
Parametri
Nessun parametro.
Esempi
vendor name
nest
Done
Riferimenti per l'interfaccia a riga di comando e le API
swversion del fornitore (set)
Imposta la stringa della versione software del fornitore.
Richiede OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
.
Il campo aVendorSwVersion
deve essere in UTF8 con una lunghezza massima di 16 caratteri(MAX_VENDOR_SW_VERSION_TLV_LENGTH
). La lunghezza massima non include il carattere \0
null.
Parametri
vendor swversion version
Esempi
vendor swversion Marble3.5.1
Done
Riferimenti per l'interfaccia a riga di comando e le API
Swversion del fornitore
Ottieni la stringa della versione software del fornitore.
Parametri
Nessun parametro.
Esempi
vendor swversion
Marble3.5.1
Done
Riferimenti per l'interfaccia a riga di comando e le API
calcolo di verhoeff
Calcola il checksum di Verhoeff per una determinata stringa decimale.
Richiede OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE
.
Parametri
verhoeff calculate decimalstring
Esempi
verhoeff calculate 30731842
1
Done
Riferimenti per l'interfaccia a riga di comando e le API
Verhoeff convalidare
Convalida il checksum di Verhoeff per una determinata stringa decimale.
Richiede OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE
.
Parametri
verhoeff validate decimalstring
Esempi
verhoeff validate 307318421
Done
Riferimenti per l'interfaccia a riga di comando e le API
API versione
Stampa il numero di versione dell'API.
Parametri
Nessun parametro.
Esempi
version api
28
Done
Riferimenti per l'interfaccia a riga di comando e le API
- Nessuna API associata
versione
Ottiene la stringa di versione OpenThread.
Parametri
Nessun parametro.
Esempi
version
OPENTHREAD/gf4f2f04; Jul 1 2016 17:00:09
Done