chiave temporanea ba
Indica se una chiave temporanea è attualmente attiva o meno.
Richiede OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE
.
Parametri
Nessun parametro.
Esempi
ba ephemeralkey
active
Done
Riferimenti a interfaccia a riga di comando e API
ba callback temporaneo (attiva, disattiva)
Imposta la funzione di callback utilizzata da Border Agent 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 a interfaccia a riga di comando e API
ba ephemeralkey chiaro
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 frontiera non è in esecuzione o se non è in uso una chiave temporanea, la chiamata di questa funzione non ha alcun effetto.
Se un commissario è connesso tramite la chiave temporanea ed è attualmente attivo, la chiamata di questa funzione non ne cambia lo stato. In questo caso,
otBorderAgentIsEphemeralKeyActive()
continuerà a restituire TRUE
fino alla disconnessione del commissario.
Parametri
Nessun parametro.
Esempi
ba ephemeralkey clear
Done
Riferimenti a interfaccia a riga di comando e API
Impostazione chiave temporanea 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 frontiera è già in esecuzione e non è attualmente connesso a nessun commissario esterno (ovvero, è in stato OT_BORDER_AGENT_STATE_STARTED
). In caso contrario, viene restituito OT_ERROR_INVALID_STATE
.
Il valore aKeyString
specificato viene utilizzato direttamente come PSK temporaneo (escluso il carattere \0
null finale). La lunghezza di 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 è attivo l'intervallo di timeout, la chiave temporanea può essere utilizzata solo una volta da un commissioner esterno per connettersi. Una volta che il commissario si disconnette, la chiave temporanea viene cancellata e l'agente di frontiera torna a utilizzare PSKc.
Parametri
Nessun parametro.
Esempi
ba ephemeralkey set Z10X20g3J15w1000P60m16 5000 1234
Done
Riferimenti a interfaccia a riga di comando e API
ID BA (get,set)
Restituisce 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 frontiera.
Esempi
ba id
cb6da1e0c0448aaec39fa90f3d58f45c
Done
ba id 00112233445566778899aabbccddeeff
Done
Riferimenti a interfaccia a riga di comando e API
Porta BA
Recupera la porta UDP del servizio Thread Border Agent.
Parametri
Nessun parametro.
Esempi
ba port
49153
Done
Riferimenti a interfaccia a riga di comando e API
stato BA
Restituisce il valore otBorderAgentState del ruolo Thread Border Agent.
Parametri
Nessun parametro.
Esempi
ba state
Started
Done
Riferimenti a interfaccia a riga di comando e API
bbr
Restituisce le informazioni del router backbone principale corrente 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 a interfaccia a riga di comando e API
- Nessuna API associata
Configurazione bbr (set)
Imposta la configurazione del router backbone locale otBackboneRouterConfig.
Viene avviato automaticamente un messaggio di richiesta dati del server SRV_DATA.ntf
se il set di dati BBR cambia per il router backbone principale.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
è abilitato.
bbr register
deve essere emesso esplicitamente per registrare il servizio del router backbone a Leader per il router backbone secondario.
Parametri
bbr config [seqno seqno] [delay delay] [timeout timeout]
Esempi
bbr config seqno 20 delay 30
Done
Riferimenti a interfaccia a riga di comando e API
config bbr
Restituisce la configurazione del router backbone locale.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
è abilitato.
Parametri
Nessun parametro.
Esempi
bbr config
seqno: 10
delay: 120 secs
timeout: 300 secs
Done
Riferimenti a interfaccia a riga di comando e API
bbr disattiva
Attiva o disattiva la funzionalità backbone.
Se il criterio viene attivato, per il dispositivo collegato viene attivato un messaggio di richiesta dati del server SRV_DATA.ntf
se non è presente alcun servizio router backbone nei dati di rete Thread.
Se disattivato, SRV_DATA.ntf
viene attivato se il router backbone è nello stato principale.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
è abilitato.
Parametri
Nessun parametro.
Esempi
bbr disable
Done
Riferimenti a interfaccia a riga di comando e API
bbr abilita
Attiva o disattiva la funzionalità backbone.
Se il criterio viene attivato, per il dispositivo collegato viene attivato un messaggio di richiesta dati del server SRV_DATA.ntf
se non è presente alcun servizio router backbone nei dati di rete Thread.
Se disattivato, SRV_DATA.ntf
viene attivato se il router backbone è nello stato principale.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
è abilitato.
Parametri
Nessun parametro.
Esempi
bbr enable
Done
Riferimenti a interfaccia a riga di comando e API
bbr jitter (get,set)
Ottieni o imposta il tremolio (in secondi) per la registrazione del router backbone.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
è abilitato.
Parametri
bbr jitter [jitter]
Esempi
bbr jitter
20
Done
bbr jitter 10
Done
Riferimenti a interfaccia a riga di comando e API
bbr mgmt dua
Includendo meshLocalIid
, questo comando configura lo stato della risposta per la successiva registrazione DUA. Senza meshLocalIid
, rispondi al DUA.req successivo con il valore status
o coap-code
specificato.
Disponibile quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
è abilitato.
Parametri
bbr mgmt dua status|coap-code [meshLocalIid]
Per status
o coap-code
, utilizza:
- 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_PRINCIPALE
- 6: ST_DUA_GENERAL_ADDRESS
- 160: Codice COAP 5.00
Esempi
bbr mgmt dua 1 2f7c235e5025a2fd
Done
bbr mgmt dua 160
Done
Riferimenti a interfaccia a riga di comando e 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 sono attivati OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
e OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
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 a interfaccia a riga di comando e API
bbr mgmt ascoltatore mlr
Restituisce i listener multicast con otBackboneRouterMulticastListenerInfomTimeout
in secondi.
Disponibile quando sono attivati OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
e OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
.
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 a interfaccia a riga di comando e API
bbr mgmt mlr listener chiaro
Cancella i listener multicast.
Disponibile quando sono attivati OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
e OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
Parametri
Nessun parametro.
Esempi
bbr mgmt mlr listener clear
Done
Riferimenti a interfaccia a riga di comando e API
risposta bbr gestione mlr
Configura lo stato della risposta per la successiva registrazione del listener multicast.
Disponibile quando sono attivati OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE
e OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
.
Parametri
bbr mgmt mlr response status-code
Per status-code
, utilizza:
- 0: ST_MLR_SUCCESS
- 2: ST_MLR_INVALID
- 3: ST_MLR_NO_PERSISTENT
- 4: ST_MLR_NO_RESOURCES
- 5: ST_MLR_BBR_NOT_PRINCIPALE
- 6: ST_MLR_GENERAL_Failed
Esempi
bbr mgmt mlr response 2
Done
Riferimenti a interfaccia a riga di comando e API
registro bbr
Registra in modo esplicito la configurazione del router backbone locale.
Per il dispositivo collegato viene attivato un messaggio di richiesta di dati del server SRV_DATA.ntf
.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
è abilitato.
Parametri
Nessun parametro.
Esempi
bbr register
Done
Riferimenti a interfaccia a riga di comando e API
bbr state
Recupera il router backbone otBackboneRouterState.
Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE
è abilitato.
Parametri
Nessun parametro.
Esempi
bbr state
Disabled
Done
bbr state
Primary
Done
bbr state
Secondary
Done
Riferimenti a interfaccia a riga di comando e API
br disattivare
Disattiva il gestore del routing delle frontiere.
Parametri
Nessun parametro.
Esempi
br disable
Done
Riferimenti a interfaccia a riga di comando e API
br abilita
Abilita il gestore del routing delle frontiere.
Parametri
Nessun parametro.
Esempi
br enable
Done
Riferimenti a interfaccia a riga di comando e API
br init
Inizializza Border Routing Manager.
Parametri
br init infrastructure-network-index is-running
Esempi
br init 2 1
Done
Riferimenti a interfaccia a riga di comando e API
br nat64prefix
Restituisce come output i prefissi NAT64 locali e 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 a interfaccia a riga di comando e API
br nat64prefix preferito
Restituisce il prefisso NAT64 attualmente preferito.
Il prefisso NAT64 preferito può essere rilevato dal collegamento 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 a interfaccia a riga di comando e API
br nat64prefix locale
Recupera il prefisso NAT64 locale del router di confine.
Il prefisso NAT64 potrebbe non essere pubblicizzato nella rete Thread.
È necessario attivare OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
.
Parametri
Nessun parametro.
Esempi
br nat64prefix local
fd14:1078:b3d5:b0b0:0:0::/96
Done
Riferimenti a interfaccia a riga di comando e API
br omrprefix
Restituisce come output il prefisso OMR locale e preferito.
Parametri
Nessun parametro.
Esempi
br omrprefix
Local: fdfc:1ff5:1512:5622::/64
Favored: fdfc:1ff5:1512:5622::/64 prf:low
Done
Riferimenti a interfaccia a riga di comando e API
br omrprefix preferito
Restituisce il prefisso Off-Mesh-Routable (OMR) attualmente preferito.
Il prefisso OMR preferito può essere rilevato da Network Data 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 a interfaccia a riga di comando e API
br omrprefix locale
Recupera il prefisso locale Off-Mesh-Routable (OMR), ad esempio fdfc:1ff5:1512:5622::/64
.
Un prefisso OMR è un prefisso a 64 bit generato in modo casuale 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 a interfaccia a riga di comando e API
prefisso br onlink
Restituisce come output i prefissi locali e quelli preferiti.
Parametri
Nessun parametro.
Esempi
br onlinkprefix
Local: fd41:2650:a6f5:0::/64
Favored: 2600::0:1234:da12::/64
Done
Riferimenti a interfaccia a riga di comando e API
br onlinkprefix preferito
Restituisce il prefisso on-link attualmente preferito.
Il prefisso preferito è un prefisso on-link scoperto sul collegamento dell'infrastruttura o il prefisso locale on-link.
Parametri
Nessun parametro.
Esempi
br onlinkprefix favored
2600::0:1234:da12::/64
Done
Riferimenti a interfaccia a riga di comando e API
br onlinkprefix locale
Recupera il prefisso On-Link locale per il collegamento dell'infrastruttura adiacente.
Il prefisso locale del collegamento è un prefisso a 64 bit pubblicizzato sul collegamento dell'infrastruttura se non è già stato pubblicizzato al link un prefisso utilizzabile.
Parametri
Nessun parametro.
Esempi
br onlinkprefix local
fd41:2650:a6f5:0::/64
Done
Riferimenti a interfaccia a riga di comando e API
tabella prefisso br
Recupera i prefissi rilevati da Border Routing Manager sul link dell'infrastruttura. Informazioni per voce di prefisso:
- Il prefisso
- Se il prefisso è on-link o route
- Millisecondi dall'ultima ricezione di un annuncio sul router contenente questo prefisso
- Durata del prefisso in secondi
- Durata preferita in secondi solo se il prefisso è on-link
- Preferenza di percorso (bassa, media, alta) solo se il prefisso è route (non on-link)
- L'indirizzo IPv6 del router che pubblicizza questo prefisso
- Flag nell'intestazione annuncio del router ricevuto:
- M: flag della configurazione indirizzo gestito
- O: altro flag di configurazione
- Stub: flag del 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 a interfaccia a riga di comando e API
br raoptions (imposta,chiaro)
Imposta opzioni aggiuntive da aggiungere alla fine dei messaggi RA (Router Advertisingment) emessi.
Il contenuto di aOptions
viene copiato internamente, quindi può trattarsi di un buffer temporaneo (ad es. un array allocato allo stack).
Le chiamate successive a questa funzione sovrascriveranno il valore impostato in precedenza.
Parametri
br raoptions options|clear
br raoptions clear
passa un nullptr
a otBorderRoutingSetExtraRouterAdvertOptions. Altrimenti, puoi passare il byte options
come dati esadecimale.
Esempi
br raoptions 0400ff00020001
Done
br raoptions clear
Done
Riferimenti a interfaccia a riga di comando e API
br rioprf (alto,medio,basso)
Imposta in modo esplicito la preferenza da utilizzare per pubblicizzare Route Info Opzioni (RIO) nei messaggi pubblicitari del router inviati tramite il link dell'infrastruttura.
Dopo una chiamata a questa funzione, BR utilizzerà 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 a interfaccia a riga di comando e API
BR Rioprf
Restituisce la preferenza corrente utilizzata per pubblicizzare Route Info Opzioni (RIO) nei messaggi pubblicitari del router inviati tramite il link dell'infrastruttura.
La preferenza RIO è determinata come segue:
- Se impostata esplicitamente dall'utente chiamando
otBorderRoutingSetRouteInfoOptionPreference()
, viene utilizzata la preferenza specificata. - In caso contrario, viene determinato in base all'attuale ruolo del dispositivo: preferenza media quando il ruolo è router/leader e preferenza bassa nel ruolo secondario.
Parametri
Nessun parametro.
Esempi
br rioprf
med
Done
Riferimenti a interfaccia a riga di comando e API
br rioprf chiaro
Cancella un valore di preferenza impostato in precedenza per le opzioni pubblicizzate relative alle informazioni sul percorso.
Dopo una chiamata a questa funzione, BR userà il ruolo del dispositivo per determinare la preferenza RIO: preferenza media quando nel ruolo router/leader e preferenza bassa quando nel ruolo secondario.
Parametri
Nessun parametro.
Esempi
br rioprf clear
Done
Riferimenti a interfaccia a riga di comando e API
br routeprf (alta,media,bassa)
Imposta in modo esplicito la preferenza delle 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 a interfaccia a riga di comando e API
br routeprf
Restituisce la preferenza corrente utilizzata per le route pubblicate in Dati di rete.
La preferenza viene determinata come segue:
- Se 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 a interfaccia a riga di comando e API
br routeprf sereno
Cancella 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 dispositivo principale quando agisce come dispositivo finale).
Parametri
Nessun parametro.
Esempi
br routeprf clear
Done
Riferimenti a interfaccia a riga di comando e API
router br
Recupera l'elenco dei router rilevati da Border Routing Manager sul collegamento dell'infrastruttura. Informazioni per router:
- L'indirizzo IPv6 del router
- Flag nell'intestazione annuncio del router ricevuto:
- M: flag della configurazione indirizzo gestito
- O: altro flag di configurazione
- Stub: flag del router stub (indica se il router è un router stub)
Parametri
Nessun parametro.
Esempi
br routers
ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1)
Done
Riferimenti a interfaccia a riga di comando e API
stato br
Restituisce lo stato attuale di Border Routing Manager.
Parametri
Nessun parametro.
Esempi
br state
running
Riferimenti a interfaccia a riga di comando e API
informazioni buffer
Recupera le informazioni correnti del buffer dei messaggi.
total
mostra il numero totale di buffer dei messaggi nel pool.free
mostra il numero di buffer dei messaggi senza costi.max-used
mostra il numero massimo di buffer utilizzati contemporaneamente dall'inizializzazione dello stack OT o dall'ultimobufferinfo reset
.
L'interfaccia a riga di comando mostra quindi 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 indica il numero di messaggi 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 a interfaccia a riga di comando e API
reimpostazione bufferinfo
Reimposta il contatore di informazioni di buffer dei messaggi che registra il numero massimo di buffer in uso contemporaneamente.
Questa operazione reimposta mMaxUsedBuffers
in
otBufferInfo
.
Parametri
Nessun parametro.
Esempi
bufferinfo reset
Done
Riferimenti a interfaccia a riga di comando e API
ccathreshold (get,set)
Recupera o imposta la soglia CCA in dBm misurata al connettore dell'antenna secondo lo standard IEEE 802.15.4 - 2015, sezione 10.1.4.
Parametri
ccathreshold [CCA-threshold-dBm]
Utilizza l'argomento CCA-threshold-dBm
facoltativo per impostare la soglia CCA.
Esempi
ccathreshold
-75 dBm
Done
ccathreshold -62
Done
Riferimenti a interfaccia a riga di comando e API
canale (get,set)
Ottieni o imposta 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 a interfaccia a riga di comando e API
- Nessuna API associata
gestione automatica del canale
Attiva o disattiva la funzionalità di selezione automatica del canale per il canale di rete.
Se l'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 a interfaccia a riga di comando e API
modifica del gestore del canale
Richiede una modifica del canale di rete Thread.
La rete passa al canale specificato dopo un ritardo specificato (vedi otChannelManagerSetDelay()). Il cambio di canale viene eseguito aggiornando il set di dati operativo in attesa.
Una chiamata successiva annullerà una modifica del canale precedentemente richiesta.
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 a interfaccia a riga di comando e API
gestore del canale
Conoscere lo stato del gestore del canale. OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE
o OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE
è obbligatorio.
Parametri
Nessun parametro.
Esempi
channel manager
channel: 11
auto: 1
delay: 120
interval: 10800
supported: { 11-26}
favored: { 11-26}
Done
Riferimenti a interfaccia a riga di comando e API
ritardo nel gestore del canale
Imposta il ritardo (in secondi) utilizzato per un cambio di canale di rete.
Disponibile solo su FTD. Preferibilmente, il ritardo dovrebbe essere maggiore dell'intervallo massimo di sondaggio sui dati utilizzato da tutti i Dispositivi finali in stato di sospensione all'interno della rete Thread.
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 a interfaccia a riga di comando e API
preferito dal gestore del canale
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 a interfaccia a riga di comando e API
intervallo del gestore del canale
Consente di impostare l'intervallo del periodo (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 a interfaccia a riga di comando e API
selezione del gestore del canale
Richieste a cui ChannelManager
controlla e seleziona un nuovo canale e avvia una modifica del canale.
A differenza di
otChannelManagerRequestChannelChange()
, in cui il canale deve essere specificato come parametro, questa funzione chiede al ChannelManager
di selezionare un canale da solo (in base alle informazioni raccolte sulla qualità del canale).
Dopo la chiamata, il gestore del canale svolgerà i tre passaggi seguenti:
1) È ChannelManager
a decidere se cambiare il canale può essere 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 sulla qualità dei link raccolte sul dispositivo (ad esempio percentuale di errori CCA, percentuale di errori di frame e messaggi per vicino e così via) per determinare se la qualità del canale corrente è al livello che giustifica una modifica del canale.
2) Se il primo passaggio va a buon fine, ChannelManager
seleziona un canale potenzialmente migliore. Utilizza i dati sulla qualità del canale raccolti dal modulo ChannelMonitor
. In questo passaggio vengono utilizzati i canali supportati e preferiti. (vedi
otChannelManagerSetSupportedChannels()
e
otChannelManagerSetFavoredChannels()
).
3) Se il canale appena selezionato è diverso da quello corrente, ChannelManager
richiede/avvia il processo di cambio 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 a interfaccia a riga di comando e API
gestione del canale supportata
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 a interfaccia a riga di comando e API
soglia del gestore del canale
Imposta la soglia della percentuale 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
corrisponde allo 0% e 0xffff
al 100%.
Esempi
channel manager threshold 0xffff
channel manager threshold 0xffff
Done
Riferimenti a interfaccia a riga di comando e API
monitoraggio del canale
Ottieni lo stato di monitoraggio attuale del canale e il numero di persone. 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 a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
interruzione monitoraggio 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 a interfaccia a riga di comando e API
canale preferito
Restituisce la maschera per il canale preferito su cui il dispositivo preferisce applicare la radio.
Parametri
Nessun parametro.
Esempi
channel preferred
0x7fff800
Done
Riferimenti a interfaccia a riga di comando e API
canale supportato
Ottieni la maschera del canale supportata dalla radio che può essere attivata sul dispositivo.
Parametri
Nessun parametro.
Esempi
channel supported
0x7fff800
Done
Riferimenti a interfaccia a riga di comando e API
secondario (ID)
Recupera le informazioni diagnostiche per un asset secondario collegato tramite il relativo ID secondario 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 a interfaccia a riga di comando e API
elenco secondario
Restituisce un elenco di ID figlio allegati.
Parametri
Nessun parametro.
Esempi
child list
1 2 3 6 7 8
Done
Riferimenti a interfaccia a riga di comando e API
tabella figlio
Stampa una tabella degli elementi secondari collegati.
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 a interfaccia a riga di comando e API
ip figlio
Recupera un elenco di indirizzi IP archiviati per i figli MTD.
Parametri
Nessun parametro.
Esempi
childip
3401: fdde:ad00:beef:0:3037:3e03:8c5f:bc0c
Done
Riferimenti a interfaccia a riga di comando e API
childip max (impostato)
Consente di impostare o ripristinare il numero massimo di indirizzi IP che ogni account secondario MTD può registrare con questo dispositivo come padre.
Supera 0
per cancellare l'impostazione e ripristinare quella predefinita.
Disponibile quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
è abilitato.
Parametri
childip max count
Esempi
childip max 2
Done
Riferimenti a interfaccia a riga di comando e API
Ip figlio max
Consente di acquisire il numero massimo di indirizzi IP che ogni publisher secondario MTD può registrare con questo dispositivo come padre.
Parametri
Nessun parametro.
Esempi
childip max
4
Done
Riferimenti a interfaccia a riga di comando e API
figliomax (impostato)
Imposta il numero massimo di figli attualmente consentiti.
Questo parametro può essere impostato solo quando l'operazione del protocollo Thread è stata interrotta.
Parametri
childmax count
Esempi
childmax 2
Done
Riferimenti a interfaccia a riga di comando e API
bambinomax
Consente di acquisire il numero massimo di figli attualmente consentito.
Parametri
Nessun parametro.
Esempi
childmax
5
Done
Riferimenti a interfaccia a riga di comando e API
childrouterlinks (get,set)
Restituisce o imposta il valore MLE_CHILD_ROUTER_LINKS.
Parametri
childrouterlinks [links]
Esempi
childrouterlinks
16
Done
childrouterlinks 16
Done
Riferimenti a interfaccia a riga di comando e API
checktimeout per la supervisione dei minori (set)
Imposta l'intervallo di timeout del controllo della supervisione (in secondi) per il file secondario.
Parametri
childsupervision checktimeout timeout-seconds
Esempi
childsupervision checktimeout 30
Done
Riferimenti a interfaccia a riga di comando e API
checktimeout per la supervisione dei minori
Restituisce l'intervallo di timeout del controllo della supervisione (in secondi) sul file secondario.
Se il dispositivo è un bambino assonnato e non sente il suo genitore entro il timeout di controllo specificato, avvia il processo di ricollegamento (scambio di richiesta/risposta di aggiornamento del bambino MLE con il relativo padre).
Parametri
Nessun parametro.
Esempi
childsupervision checktimeout
30
Done
Riferimenti a interfaccia a riga di comando e API
intervallo di supervisione dei bambini (impostato)
Imposta l'intervallo di supervisione del bambino (in secondi) per il bambino.
Parametri
childsupervision interval interval-seconds
Esempi
childsupervision interval 30
Done
Riferimenti a interfaccia a riga di comando e API
intervallo di supervisione
Restituisce l'intervallo di supervisione dei minori (in secondi) su un bambino.
La funzionalità Supervisione dei bambini offre un meccanismo che consente al genitore di assicurarsi che venga inviato un messaggio a ogni figlio assonnato entro l'intervallo di supervisione. Se non avviene alcuna trasmissione al bambino/a nell'intervallo di supervisione, OpenThread mette in coda e invia al bambino un messaggio per la supervisione dei minori.
Parametri
Nessun parametro.
Esempi
childsupervision interval
30
Done
Riferimenti a interfaccia a riga di comando e API
bambino/a (imposta)
Imposta il timeout dell'account secondario del thread (in secondi) utilizzato quando operi nel ruolo dell'account secondario.
Parametri
childtimeout timeout-seconds
Esempi
childtimeout 300
Done
Riferimenti a interfaccia a riga di comando e API
timeout bambino
Restituisce il timeout dell'account secondario del thread (in secondi) utilizzato durante l'uso del ruolo figlio.
Parametri
Nessun parametro.
Esempi
childtimeout
300
Done
Riferimenti a interfaccia a riga di comando e API
coap annulla
Annulla un abbonamento di osservazione esistente a una risorsa remota sul server CoAP.
Parametri
Nessun parametro.
Esempi
coap cancel
Done
Riferimenti a interfaccia a riga di comando e 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 confermabili (impostazione predefinita)
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 a interfaccia a riga di comando e API
- Nessuna API associata
CANNOT TRANSLATE
Recupera le 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 confermabili (impostazione predefinita)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 a interfaccia a riga di comando e API
- Nessuna API associata
coap osservare
Attiva una richiesta di abbonamento che consente al client CoAP di osservare la risorsa specificata sul server CoAP per rilevare eventuali modifiche del suo 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 a interfaccia a riga di comando e API
- Nessuna API associata
parametri coap(get,set)
Recupera i valori dei parametri CoAP attuali se il comando viene eseguito senza parametri facoltativi.
Consente di impostare i parametri CoAP sui rispettivi 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 stampa 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 valori possibili compresi tra 0 e 255. Fai riferimento a RFC7252.ack_random_factor_denominator
: il denominatore diACK_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 a interfaccia a riga di comando e API
- Nessuna API associata
post coap
Crea la risorsa CoAP specificata. Per saperne di più, consulta Testare la connettività a una risorsa CoAP (Consad 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 confermabili (impostazione predefinita)block-
: usa questa opzione, seguita dal valore a livello di blocco, per inviare blocchi con un numero di byte generato casualmente 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. Se utilizzata, è una stringa o un numero intero, a seconda ditype
. Setype
ècon
onon-con
, il parametropayload
è facoltativo. Se ometti il parametropayload
, viene inviato un payload vuoto. Tuttavia, se utilizzi il parametropayload
, il suo 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 tipoblock-
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 a interfaccia a riga di comando e API
- Nessuna API associata
lancio coap
Modifica la risorsa CoAP specificata. Per saperne di più, consulta Testare la connettività a una risorsa CoAP (Consad 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 confermabili (impostazione predefinita)block-
: usa questa opzione, seguita dal valore a livello di blocco, per inviare blocchi con un numero di byte generato casualmente 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. Se utilizzata, è una stringa o un numero intero, a seconda ditype
. Setype
ècon
onon-con
, il parametropayload
è facoltativo. Se ometti il parametropayload
, viene inviato un payload vuoto. Tuttavia, se utilizzi il parametropayload
, il suo 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 tipoblock-
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 a interfaccia a riga di comando e API
- Nessuna API associata
risorsa coap (get,set)
Restituisce o imposta il percorso URI della risorsa server CoAP.
Parametri
coap resource [uri-path]
Esempi
coap resource test-resource
Done
coap resource
test-resource
Done
Riferimenti a interfaccia a riga di comando e API
serie coap
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 a interfaccia a riga di comando e API
inizio coap
Avvia il server CoAP. Per saperne di più, consulta Testare la connettività a una risorsa CoAP (Consad Application Protocol) utilizzando l'interfaccia a riga di comando OT.
Parametri
Nessun parametro.
Esempi
coap start
Done
Riferimenti a interfaccia a riga di comando e API
coap stop
Arresta il server CoAP.
Parametri
Nessun parametro.
Esempi
coap stop
Done
Riferimenti a interfaccia a riga di comando e API
Coaps Connect
Inizializza una sessione DTLS (Datagram Transport Layer Security) con un peer. Per saperne di più, consulta l'articolo Verificare la connettività a una risorsa CoAPS (Consad 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 a interfaccia a riga di comando e 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 confermabili (impostazione predefinita)
payload
: richiesta di payload CoAPS.
Esempi
coaps delete test-resource con hellothere
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
coaps disconnetti
Interrompe la sessione DTLS.
Parametri
Nessun parametro.
Esempi
coaps disconnect
coaps disconnected
Done
Riferimenti a interfaccia a riga di comando e API
i coaps ottengono
Recupera le informazioni sulla risorsa CoAPS specificata sul server CoAPS. Per saperne di più, consulta l'articolo Verificare la connettività a una risorsa CoAPS (Consad 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 confermabili (impostazione predefinita)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 a interfaccia a riga di comando e API
- Nessuna API associata
coaps chiuso
Indica se il servizio CoAP Secure è chiuso. Per saperne di più, consulta l'articolo Verificare la connettività a una risorsa CoAPS (Consad Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.
Parametri
Nessun parametro.
Esempi
coaps isclosed
no
Done
Riferimenti a interfaccia a riga di comando e API
coaps isconnactive
Indica se la connessione al servizio CoAP Secure è attiva (già connessa o in fase di definizione di una connessione). Per saperne di più, consulta l'articolo Verificare la connettività a una risorsa CoAPS (Consad Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.
Parametri
Nessun parametro.
Esempi
coaps isconnactive
yes
Done
Riferimenti a interfaccia a riga di comando e API
coaps è connesso
Indica se il servizio CoAP Secure è connesso. Per saperne di più, consulta l'articolo Verificare la connettività a una risorsa CoAPS (Consad Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.
Parametri
Nessun parametro.
Esempi
coaps isconnected
yes
Done
Riferimenti a interfaccia a riga di comando e API
coaps post
Crea la risorsa CoAPS specificata. Per saperne di più, consulta l'articolo Verificare la connettività a una risorsa CoAPS (Consad 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 confermabili (impostazione predefinita)block-
: usa questa opzione, seguita dal valore a livello di blocco, per inviare blocchi con un numero di byte generato casualmente 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 escludi il parametro payload, viene inviato un payload vuoto. Tuttavia, se utilizzi il parametro payload, il suo valore deve essere una stringa, comehellothere
. Setype
èblock-
, il valore del parametro payload deve essere un numero intero che specifica il numero di blocchi da inviare. Il tipoblock-
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 a interfaccia a riga di comando e API
- Nessuna API associata
coaps psk
Imposta la chiave precondivisa (PSK) e la suite 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 a interfaccia a riga di comando e API
coaps put
Modifica la risorsa CoAPS specificata. Per saperne di più, consulta l'articolo Verificare la connettività a una risorsa CoAPS (Consad 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 confermabili (impostazione predefinita)block-
: usa questa opzione, seguita dal valore a livello di blocco, per inviare blocchi con un numero di byte generato casualmente 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 escludi il parametro payload, viene inviato un payload vuoto. Tuttavia, se utilizzi il parametro payload, il suo valore deve essere una stringa, comehellothere
. Setype
èblock-
, il valore del parametro payload deve essere un numero intero che specifica il numero di blocchi da inviare. Il tipoblock-
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 a interfaccia a riga di comando e API
- Nessuna API associata
risorsa coaps (get,set)
Restituisce o imposta il percorso URI della risorsa server CoAPS. Per saperne di più, consulta l'articolo Verificare la connettività a una risorsa CoAPS (Consad 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 a interfaccia a riga di comando e API
insieme di coaps
Imposta i contenuti inviati dalla risorsa sul server CoAPS. Per saperne di più, consulta l'articolo Verificare la connettività a una risorsa CoAPS (Consad Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.
Parametri
coaps set new-content
Esempi
coaps set Testing123
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
inizio coaps
Avvia il servizio CoAP Secure. Per saperne di più, consulta l'articolo Verificare la connettività a una risorsa CoAPS (Consad 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 è abilitato (impostazione predefinita) o disabilitata. Il parametro max-conn-attempts
imposta il numero massimo di tentativi consentiti, riusciti o non riusciti, per la connessione al server CoAP Secure. Il valore predefinito di questo parametro è 0
, il che significa che non è previsto alcun limite al numero di tentativi. I parametri check-peer-cert
e max-conn-attempts
interagiscono nelle seguenti combinazioni, anche se puoi specificare un solo argomento:
- Nessun argomento specificato: vengono utilizzati valori predefiniti.
- L'impostazione di
check-peer-cert
sutrue
equivale a omettere l'argomento, ovvero il valore dicheck-peer-cert
ètrue
e il valore dimax-conn-attempts
è 0. - Impostando
check-peer-cert
sufalse
: il valore dicheck-peer-cert
èfalse
, mentre il valore dimax-conn-attempts
è 0. - Specificare un numero:
check-peer-cert
ètrue
e il valoremax-conn-attempts
è il numero specificato nell'argomento.
Esempi
coaps start
Done
coaps start false
Done
coaps start 8
Done
Riferimenti a interfaccia a riga di comando e API
coaps stop
Interrompe il servizio CoAP Secure. Per saperne di più, consulta l'articolo Verificare la connettività a una risorsa CoAPS (Consad Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.
Parametri
Nessun parametro.
Esempi
coaps stop
Done
Riferimenti a interfaccia a riga di comando e 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 a interfaccia a riga di comando e 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 le trasmissioni successive diAnnounce
con MLE.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 a interfaccia a riga di comando e API
Commissioner Energy
Invia un messaggio Query sulla scansione energetica. L'output comando viene stampato così come viene ricevuto.
Parametri
commissioner energy mask count period scanDuration destination
mask
: bitmask che identifica i canali per l'esecuzione di scansioni sull'energia IEEE 802.15.4.count
: numero di scansioni di energia elettrica secondo lo standard IEEE 802.15.4 per canale.period
: numero di millisecondi tra le successive scansioni energetiche dello standard IEEE 802.15.4.scanDuration
: durata della scansione in millisecondi da utilizzare quando si esegue 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 a interfaccia a riga di comando e API
ID commissario (get,set)
Restituisce o imposta il nome dell'ID OpenThread Commissioner.
Parametri
commissioner id name
Esempi
commissioner id OpenThread Commissioner
Done
commissioner id
OpenThread Commissioner
Done
Riferimenti a interfaccia a riga di comando e API
aggiunta commissario joiner
Aggiunge una voce membro.
Parametri
commissioner joiner add eui64|discerner pksd [timeout]
eui64
: EUI-64 IEEE del Joiner. Per trovare la corrispondenza con qualsiasi partecipante, utilizza*
.discerner
: le distinzioni di Joiner nel formatonumber/length
.pksd
: chiave precondivisa per il joiner.timeout
: timeout del joiner in secondi.
Esempi
commissioner joiner add d45e64fa83f81cf7 J01NME
Done
commissioner joiner add 0xabc/12 J01NME
Done
Riferimenti a interfaccia a riga di comando e API
rimozione membro commissario
Rimuove una voce Joiner.
Parametri
commissioner joiner remove eui64|discerner
eui64
: EUI-64 IEEE del joiner. Per trovare la corrispondenza con qualsiasi partecipante, utilizza*
.discerner
: il legislatore nel formatonumber/length
.
Esempi
commissioner joiner remove d45e64fa83f81cf7
Done
commissioner joiner remove 0xabc/12
Done
Riferimenti a interfaccia a riga di comando e API
tabella Commissioner 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 a interfaccia a riga di comando e API
- Nessuna API associata
gestione del commissario
Invia un messaggio MGMT_GET
(Management get) al responsabile. Vengono restituiti i valori delle variabili che sono stati impostati utilizzando il comando commissioner mgmtset
.
Parametri
commissioner mgmtget [locator] [sessionid] [steeringdata] [joinerudpport] [-x TLVs]
locator
: router di confine RLOC16.sessionid
: ID sessione del Commissario.steeringdata
: orientamento dei dati.joinerudpport
: porta UDP del joiner.TLVs
: l'insieme di TLV da recuperare.
Esempi
commissioner mgmtget locator sessionid
Done
Riferimenti a interfaccia a riga di comando e 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 Commissario.steeringdata
: orientamento dei dati.joinerudpport
: porta UDP del joiner.TLVs
: l'insieme di TLV da recuperare.
Esempi
commissioner mgmtset joinerudpport 9988
Done
Riferimenti a interfaccia a riga di comando e API
commissario panid
Invia una query sull'ID PAN. L'output del comando viene restituito così come viene ricevuto.
Parametri
commissioner panid panid mask destination
paind
: ID PAN da utilizzare per verificare la presenza di conflitti.mask
; Bitmask che identifica i canali su cui eseguire le scansioni attive secondo lo standard 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 a interfaccia a riga di comando e API
url di provisioning del commissario
Imposta l'URL di provisioning del Commissioner.
Parametri
commissioner provisioningurl provisioningurl
Esempi
commissioner provisioningurl http://github.com/openthread/openthread
Done
Riferimenti a interfaccia a riga di comando e API
Commissioner dcm
Recupera l'ID sessione Commissioner corrente.
Parametri
Nessun parametro.
Esempi
commissioner sessionid
0
Done
Riferimenti a interfaccia a riga di comando e API
inizio commissario
Avvia il ruolo di Thread Commissioner.
Parametri
Nessun parametro.
Esempi
commissioner start
Commissioner: petitioning
Done
Commissioner: active
Riferimenti a interfaccia a riga di comando e API
stato del commissario
Restituisce lo stato attuale del Commissioner. I valori possibili sono active
, disabled
o petition
(presentazione di una petizione per diventare Commissioner).
Parametri
Nessun parametro.
Esempi
commissioner state
active
Done
Riferimenti a interfaccia a riga di comando e API
interruzione del commissario
Interrompe il ruolo di Thread Commissioner.
Parametri
Nessun parametro.
Esempi
commissioner stop
Done
Riferimenti a interfaccia a riga di comando e API
contestoreusedelay (get,set)
Recupera o imposta 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 a interfaccia a riga di comando e API
contatori (mac)
Trova i contatori del livello 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 a interfaccia a riga di comando e API
contatori (mle)
Restituisce i contatori 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 a interfaccia a riga di comando e API
contatori
Restituisce i nomi dei contatori supportati.
Parametri
Nessun parametro.
Esempi
counters
ip
mac
mle
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
IP contatori
Recupera i contatori IPv6.
Parametri
counters ip
Esempi
counters ip
TxSuccess: 10
TxFailed: 0
RxSuccess: 5
RxFailed: 0
Done
Riferimenti a interfaccia a riga di comando e API
IP dei contatori reimpostato
Reimposta i contatori IPv6.
Parametri
counters ip reset
Esempi
counters ip reset
Done
Riferimenti a interfaccia a riga di comando e API
contatori reset mac
Reimposta i contatori del livello MAC.
Parametri
counters mac reset
Esempi
counters mac reset
Done
Riferimenti a interfaccia a riga di comando e API
contatori mle reimpostati
Reimposta i contatori MLE di Thread.
Parametri
counters mle reset
Esempi
counters mle reset
Done
Riferimenti a interfaccia a riga di comando e API
canale csl
Imposta il canale CSL.
Parametri
csl channel channel
Esempi
csl channel 20
Done
Riferimenti a interfaccia a riga di comando e API
CSS
Restituisce la configurazione CSL.
Parametri
Nessun parametro.
Esempi
csl
Channel: 11
Period: 160000us
Timeout: 1000s
Done
Riferimenti a interfaccia a riga di comando e API
periodo csl
Imposta il periodo CSL in microsecondi.
Disattiva 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 a interfaccia a riga di comando e API
timeout csl
Imposta il timeout CSL in secondi.
Parametri
csl timeout timeout
Esempi
cls timeout 10
Done
Riferimenti a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
set di dati attivotimestamp (get, set)
Restituisce o imposta otOperationalDataset::mActiveTimestamp.
Parametri
dataset activetimestamp [timestamp]
Passa l'argomento timestamp
facoltativo per impostare il timestamp attivo.
Esempi
dataset activetimestamp
123456789
Done
dataset activetimestamp 123456789
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
canale del set di dati (get,set)
Restituisce 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 a interfaccia a riga di comando e API
- Nessuna API associata
channelmask del set di dati (get,set)
Ottieni 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 a interfaccia a riga di comando e API
- Nessuna API associata
set di dati chiaro
Reimposta il buffer del set di dati operativo.
Parametri
Nessun parametro.
Esempi
dataset clear
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
commit set attivo
Esegui il commit del buffer del set di dati operativo in Active Operational Dataset.
Parametri
Nessun parametro.
Esempi
dataset commit active
Done
Riferimenti a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
ritardo del set di dati (get,set)
Restituisce 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 a interfaccia a riga di comando e API
extpanid del set di dati (get,set)
Restituisce o imposta otOperationalDataset::mExtendedPanId.
Parametri
dataset extpanid [extpanid]
Usa l'argomento facoltativo extpanid
per impostare l'ID Extended Personal Area Network.
Esempi
dataset extpanid
000db80123456789
Done
dataset extpanid 000db80123456789
Done
Riferimenti a interfaccia a riga di comando e API
guida per i set di dati
Recupera un elenco di comandi dell'interfaccia a riga di comando di dataset
. Per saperne di più, consulta Visualizzare e gestire i set di dati con OT CLI.
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 a interfaccia a riga di comando e API
- Nessuna API associata
set di dati init (attivo,nuovo,in attesa,tlvs)
L'interfaccia a riga di comando OT controlla active
, pending
o tlvs
e restituisce i valori corrispondenti. Altrimenti, OT CLI 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 a interfaccia a riga di comando e API
prefisso locale mesh del set di dati (get,set)
Ottieni o imposta otOperationalDataset::mMeshLocalPrefix.
Parametri
dataset meshlocalprefix [meshlocalprefix]
Utilizza l'argomento meshlocalprefix
facoltativo per impostare il prefisso locale mesh.
Esempi
dataset meshlocalprefix
fd00:db8:0:0::/64
Done
dataset meshlocalprefix fd00:db8:0:0::
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
set di dati mgmtgetcommand attivo
Invia MGMT_ACTIVE_GET.
OT CLI invia un MGMT_ACTIVE_GET con gli argomenti pertinenti. Per scoprire di più su questi parametri e mappature di 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; in caso contrario, viene utilizzato l'ALOC Leader come impostazione predefinita. - 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 a interfaccia a riga di comando e API
- otDatasetSendMgmtActiveGet
- gestione del set di dati in sospeso
- comando gestione set di dati attivo
- comando gestione set di dati in attesa
comando 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 mappature di 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 a interfaccia a riga di comando e API
- otDatasetSendMgmtPendingGet
- gestione del set di dati attivo
- comando gestione set di dati attivo
- comando gestione set di dati in attesa
set di dati mgmtsetcommand attivo
Invia MGMT_ACTIVE_SET.
Parametri
dataset mgmtsetcommand active [dataset-components] [-x tlv-list]
Per scoprire di più su questi parametri e mappature di 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 a interfaccia a riga di comando e API
- otDatasetSendMgmtActiveSet
- gestione del set di dati attivo
- gestione del set di dati in sospeso
- comando gestione set di dati in attesa
comando mgmtsetcommand in attesa
Invia MGMT_PENDING_SET.
Parametri
dataset mgmtsetcommand pending [dataset-components] [-x tlv-list]
Per scoprire di più su questi parametri e mappature di 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 a interfaccia a riga di comando e API
- otDatasetSendMgmtPendingSet
- gestione del set di dati attivo
- gestione del set di dati in sospeso
- comando gestione set di dati attivo
chiave di rete del set di dati (get,set)
Restituisce o imposta otOperationalDataset::mNetworkKey.
Parametri
dataset networkkey [key]
Utilizza l'argomento key
facoltativo per impostare la chiave di rete.
Esempi
dataset networkkey
00112233445566778899aabbccddeeff
Done
dataset networkkey 00112233445566778899aabbccddeeff
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
nome rete del set di dati (get,set)
Restituisce o imposta otOperationalDataset::mNetworkName.
Parametri
dataset networkname [name]
Utilizza l'argomento facoltativo name
per impostare il nome rete.
Esempi
dataset networkname
OpenThread
Done
dataset networkname OpenThread
Done
Riferimenti a interfaccia a riga di comando e API
panid set di dati (get,set)
Restituisce 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 a interfaccia a riga di comando e API
- Nessuna API associata
set di dati in attesatimestamp (get,set)
Restituisce 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 a interfaccia a riga di comando e API
- Nessuna API associata
set di dati pskc (get,set)
Restituisce o imposta otOperationalDataset::mPskc.
Parametri
dataset pskc [-p passphrase] | [key]
Solo per FTD, utilizza -p
con l'argomento passphrase
. -p
genera un file pskc dal codice passphrase
con codifica 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 a interfaccia a riga di comando e API
- Nessuna API associata
policy 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]]
- Usa
rotationtime
perthrKeyRotation
, in unità di ore. - I comandi di Criteri di sicurezza utilizzano le mappature degli argomenti
onrcCepR
per ottenere e impostare i membri otSecurityPolicy, ad esempioo
rappresenta otSecurityPolicy::mOttieniNetworkKeyEnabled. Per saperne di più, consulta Visualizzare e gestire i set di dati con OT CLI.
Esempi
dataset securitypolicy
672 onrc
Done
dataset securitypolicy 672 onrc
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
set di dati (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 con 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. È necessaria solo la chiave di rete Thread per collegarsi a una rete.
Se il canale non è incluso nel set di dati, il dispositivo invierà messaggi di annuncio MLE su diversi canali per trovare vicini su altri canali.
Se il dispositivo si collega correttamente a una rete Thread, recupererà l'intero set di dati attivo dal relativo set di dati principale. Tieni presente che un dispositivo compatibile con il router non passerà ai ruoli di router o di leader finché non dispone di un set di dati attivo completo.
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 a interfaccia a riga di comando e API
tlv di set di dati
Converte un determinato set di dati operativo in
otOperationalDatasetTlvs
.
Parametri
Nessun parametro.
Esempi
dataset tlvs
0e080000000000010000000300001635060004001fffe0020...f7f8
Done
Riferimenti a interfaccia a riga di comando e API
annullamento dell'aggiornamento del set di dati
Annulla un'eventuale richiesta di aggiornamento del set di dati operativo in corso.
Disponibile quando OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
è abilitato.
Parametri
Nessun parametro.
Esempi
@dataset updater cancel
Done
Riferimenti a interfaccia a riga di comando e 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
è abilitato.
Parametri
Nessun parametro.
Esempi
dataset updater
Enabled
Done
Riferimenti a interfaccia a riga di comando e API
inizio programma di aggiornamento set di dati
Richiede un aggiornamento del set di dati operativo.
Disponibile quando OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE
è abilitato.
aDataset
deve contenere i campi da aggiornare e il nuovo valore. Non deve contenere i campi Active (Attiva) o Pending Timestamp (Timestamp in sospeso). Il campo Ritardo è facoltativo; se non viene fornito, viene utilizzato un valore predefinito (1000 ms).
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 a interfaccia a riga di comando e API
debug
Esegue una serie di comandi dell'interfaccia a riga di comando per raccogliere informazioni sulla rete del dispositivo e dei thread. Questa funzione è destinata al debug. L'output mostrerà ogni comando dell'interfaccia a riga di comando eseguito, preceduto da $
, seguito dall'output generato dal 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 dei figli e dei vicini
- Informazioni sulla tabella del router e sull'hop successivo
- Tabella della cache degli indirizzi
- Indirizzo IPv6 figlio MTD registrato
- Proprietà dispositivo
Se il dispositivo supporta e agisce in qualità di client SRP:
- Stato client SRP
- Servizi client SRP e informazioni sull'host
Se il dispositivo supporta e funge da server SRP:
- Stato e modalità indirizzo del server SRP
- Host e servizi registrati dal 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 Prefisso rilevato
Parametri
Nessun parametro.
Esempi
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
ritardotimermin (impostato)
Imposta il timer di ritardo minimo (in secondi).
Parametri
delaytimermin delaytimermin
Esempi
delaytimermin 60
Done
Riferimenti a interfaccia a riga di comando e API
Ritardo
Ottieni il timer con ritardo minimo (in secondi).
Parametri
Nessun parametro.
Esempi
delaytimermin
30
Done
Riferimenti a interfaccia a riga di comando e API
detach async
Avvia il processo di scollegamento controllato, simile al comando detach
, senza bloccare e attendere il callback che indica che lo scollegamento è terminato.
Parametri
Nessun parametro.
Esempi
detach async
Done
Riferimenti a interfaccia a riga di comando e API
detach
Avvia il processo di scollegamento gestito inviando prima una notifica agli altri nodi (inviando il rilascio dell'indirizzo se agisci come router o impostando il valore di timeout del bambino su zero sulla rete padre se agisci come figlio) e quindi interrompendo l'operazione del protocollo Thread.
Parametri
Nessun parametro.
Esempi
detach
Finished detaching
Done
Riferimenti a interfaccia a riga di comando e API
oggetti (set)
Imposta le proprietà del dispositivo.
Parametri
deviceprops powerSupply isBr supportsCcm isUnstable weightAdjustment
powerSupply
: deve 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 a interfaccia a riga di comando e API
oggetti di scena
Recupera 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 a interfaccia a riga di comando e API
Discover
Eseguire un'operazione di rilevamento dell'MLE.
Parametri
discover [channel]
channel
: il canale su cui 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 a interfaccia a riga di comando e API
scopri reqcallback (attiva,disattiva)
Imposta un callback per ricevere i dati di MLE Discovery Request.
Parametri
discover reqcallback enable|disable
Esempi
discover reqcallback enable
Done
Riferimenti a interfaccia a riga di comando e 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 dell'attuale configurazione predefinita (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 a interfaccia a riga di comando e API
Compressione DNS (abilitato,disabilitato)
Imposta la modalità "Compressione dei nomi DNS".
Per impostazione predefinita, la compressione dei nomi DNS è abilitata. Quando è disabilitata, i nomi DNS vengono aggiunti come completi e non sono mai compressi. Questo vale per i 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 a interfaccia a riga di comando e API
compressione DNS
Indica se la modalità "Compressione dei nomi DNS" è attivata o meno.
Questa funzionalità è destinata solo ai test e disponibile quando la configurazione di OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
è abilitata.
Per impostazione predefinita, la compressione dei nomi DNS è abilitata. Quando è disabilitata, i nomi DNS vengono aggiunti come completi e non sono mai compressi. Questo vale per i 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 a interfaccia a riga di comando e API
Configurazione DNS (set)
Imposta la configurazione della query predefinita sul client DNS.
In un valore aConfig
diverso da NULL, il chiamante può scegliere di lasciare alcuni dei campi dell'istanza
otDnsQueryConfig
non specificati (valore pari a 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 OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_ADDRESS_AUTO_SET_ENABLE
è abilitato, l'indirizzo IPv6 del server nella configurazione predefinita viene impostato e aggiornato automaticamente dal client DNS. Questo viene fatto solo quando 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. Anche l'indirizzo del server SRP selezionato viene 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]
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
Done
dns config fd00::2
Done
dns config
Server: [fd00:0:0:0:0:0:0:2]:53
ResponseTimeout: 3000 ms
MaxTxAttempts: 3
RecursionDesired: yes
Done
Riferimenti a interfaccia a riga di comando e API
configurazione DNS
Recupera l'attuale configurazione di query predefinita utilizzata dal client DNS.
Quando si avvia lo stack OpenThread, la configurazione delle query DNS predefinita viene determinata da un insieme di opzioni di configurazione OT, ad esempio 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 la porta e l'indirizzo IPv6 del server, il timeout della risposta in msec (tempo di attesa alla risposta rx), il numero massimo di tentativi tx prima di segnalare l'errore, il flag booleano che indica 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 a interfaccia a riga di comando e API
risoluzione DNS
Invia una query DNS di risoluzione degli indirizzi per i record AAAA (IPv6) per un determinato nome host.
Il valore 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 pari a zero). I campi non specificati vengono quindi sostituiti con i 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) per questi parametri facoltativi vengono sostituiti dal valore dell'attuale configurazione predefinita (configurazione DNS).
L'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 a interfaccia a riga di comando e API
servizio DNS
Avvia una risoluzione dell'istanza di servizio DNS per una determinata istanza di servizio.
È disponibile quando OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE
è abilitato.
Il valore 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 pari a zero). I campi non specificati vengono quindi sostituiti con i valori della configurazione predefinita.
La funzione invia le query per i record SRV e/o TXT per l'istanza di servizio specificata. Il campo mServiceMode
in
otDnsQueryConfig
determina i record su cui eseguire la query (solo SRV, solo TXT o sia SRV che TXT) e come eseguirla (insieme nello stesso messaggio, separatamente in parallelo o in modalità ottimizzata, in cui il client proverà prima nello stesso messaggio e poi separatamente se non riesce a ricevere una risposta).
Il record SRV fornisce informazioni sulla porta, la priorità e il peso del servizio, oltre al nome host associato all'istanza del servizio. Questa funzione NON esegue la risoluzione dell'indirizzo per il nome host rilevato dal record SRV. Il server/resolver può 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 presumere che l'indirizzo host sarà sempre disponibile da
otDnsServiceResponseGetServiceInfo()
.
Invia una query DNS per la risoluzione delle istanze di servizio per una determinata istanza di servizio. Viene fornita per prima l'etichetta dell'istanza di servizio, seguita dal nome del servizio (tieni presente che l'etichetta dell'istanza di servizio può contenere il carattere punto ".").
I parametri dopo service-name
sono facoltativi. Qualsiasi valore non specificato (o zero) per questi parametri facoltativi viene sostituito dal valore dell'attuale configurazione predefinita (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 a interfaccia a riga di comando e API
host 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
è abilitato.
Il valore 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 pari a zero). I campi non specificati vengono quindi sostituiti con i valori della configurazione predefinita. Questa funzione non può essere utilizzata con mServiceMode
nella configurazione DNS impostata su OT_DNS_SERVICE_MODE_TXT
(ovvero l'esecuzione di query solo per il record TXT) e restituirà OT_ERROR_INVALID_ARGS
.
Si comporta in modo simile all'invio di query da parte di
otDnsClientResolveService()
per i record SRV e TXT. Tuttavia, se il server/resolver 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 attivato quando vengono ricevute le risposte a tutte le query (ovvero, sono terminate le risoluzioni sia dell'indirizzo del servizio che dell'indirizzo host).
Invia una query DNS per la risoluzione delle istanze di servizio per una determinata istanza di servizio con la potenziale risoluzione del nome host di follow-up. Viene fornita per prima l'etichetta dell'istanza di servizio, seguita dal nome del servizio (tieni presente che l'etichetta dell'istanza di servizio può contenere il carattere punto ".").
I parametri dopo service-name
sono facoltativi. Qualsiasi valore non specificato (o zero) per questi parametri facoltativi viene sostituito dal valore dell'attuale configurazione predefinita (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 a interfaccia a riga di comando e API
nome dominio (insieme)
Imposta il nome di dominio Thread.
Operazione riuscita solo se i protocolli Thread sono disabilitati.
Parametri
domainname name
Utilizza un carattere backslash
per l'escape degli spazi.
Esempi
domainname Test\ Thread
Done
Riferimenti a interfaccia a riga di comando e API
nome dominio
Recupera il nome di dominio Thread.
Parametri
Nessun parametro.
Esempi
domainname
Thread
Done
Riferimenti a interfaccia a riga di comando e API
dua iid (imposta,chiaro)
Imposta o cancella l'identificatore interfaccia specificato manualmente per l'indirizzo Unicast di dominio Thread.
Disponibile quando OPENTHREAD_CONFIG_DUA_ENABLE
è abilitato.
Parametri
dua iid iid|clear
dua iid clear
passa un nullptr
a otThreadSetFixedDuaInterfaceIdentifier. In caso contrario, puoi superare l'iid
.
Esempi
dua iid 0004000300020001
Done
dua iid clear
Done
Riferimenti a interfaccia a riga di comando e API
dua iid
Restituisce l'identificatore interfaccia specificato manualmente per l'indirizzo Unicast di dominio Thread.
Disponibile quando OPENTHREAD_CONFIG_DUA_ENABLE
è abilitato.
Parametri
Nessun parametro.
Esempi
dua iid
0004000300020001
Done
Riferimenti a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
eui64
Ottieni lo standard IEEE EUI-64 assegnato in fabbrica per questa interfaccia.
Parametri
Nessun parametro.
Esempi
eui64
0615aae900124b00
Done
Riferimenti a interfaccia a riga di comando e API
extaddr (insieme)
Imposta l'indirizzo esteso IEEE 802.15.4.
Parametri
extaddr extaddr
Esempi
extaddr dead00beef00cafe
dead00beef00cafe
Done
Riferimenti a interfaccia a riga di comando e API
extaddr
Ottieni l'indirizzo esteso IEEE 802.15.4.
Parametri
Nessun parametro.
Esempi
extaddr
dead00beef00cafe
Done
Riferimenti a interfaccia a riga di comando e API
extpanid (insieme)
Imposta l'ID PAN esteso IEEE 802.15.4.
Parametri
extpanid extpanid
Esempi
extpanid dead00beef00cafe
Done
Riferimenti a interfaccia a riga di comando e API
extpanid
Ottieni l'ID PAN esteso IEEE 802.15.4.
Parametri
Nessun parametro.
Esempi
extpanid
dead00beef00cafe
Done
Riferimenti a interfaccia a riga di comando e API
ripristino dei dati di fabbrica
Elimina tutte le impostazioni memorizzate nella memoria non volatile e attiva il ripristino della piattaforma.
Parametri
Nessun parametro.
Esempi
factoryreset
Riferimenti a interfaccia a riga di comando e API
falso (uno,uno)
Invia messaggi Thread falsi.
Disponibile quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
è abilitato.
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 a interfaccia a riga di comando e API
fem
Restituisce i parametri FEM esterni.
Parametri
Nessun parametro.
Esempi
fem
LNA gain 11 dBm
Done
Riferimenti a interfaccia a riga di comando e API
fem lnagain (get)
Ottieni il guadagno LNA del Rx del FEM esterno in dBm.
Parametri
Nessun parametro.
Esempi
fem lnagain
11
Done
Riferimenti a interfaccia a riga di comando e API
fem lnagain (insieme)
Imposta il guadagno Rx LNA del FEM esterno in dBm.
Parametri
Nessun parametro.
Esempi
fem lnagain 8
Done
Riferimenti a interfaccia a riga di comando e API
storia ipaddr
Visualizza la cronologia degli indirizzi IPv6 unicast in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: il 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 dell'indirizzo 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 visualizzato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificato. Se questa opzione non viene utilizzata, tutte le voci archiviate 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 a interfaccia a riga di comando e API
cronologia ipmaddr
Visualizza la cronologia degli indirizzi IPv6 multicast in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: il 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 visualizzato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificato. Se questa opzione non viene utilizzata, tutte le voci archiviate 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 a interfaccia a riga di comando e API
vicino di casa
Visualizza la cronologia dei vicini sotto forma di tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: il 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
- Mode: MLE link mode. Valori possibili:
-
: nessun flag impostato (rx-off- when-in-idle, dispositivo Thread minimo, dati di rete stabili).r
: rx-su-quando-inattivod
: dispositivo Thread completo.n
: dati di rete completi
- RSS Ave: numero medio di frame (in dBm) ricevuti dal vicino al momento della registrazione della voce.
Parametri
history neighbor [list] [num-entries]
- Utilizza l'opzione
list
per visualizzare l'output in formato elenco. In caso contrario, l'output viene visualizzato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificato. Se questa opzione non viene utilizzata, tutte le voci archiviate 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 a interfaccia a riga di comando e API
cronologia netinfo
Visualizza la cronologia delle informazioni di rete in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: il tempo trascorso dall'emissione del comando e specificato nel formato:
hours
:minutes
:seconds
:milliseconds
- Ruolo: ruolo dispositivo. I valori possibili sono
router
,child
,detached
odisabled
. - Mode: MLE link mode. Valori possibili:
-
: nessun flag impostato (rx-off- when-in-idle, dispositivo Thread minimo, dati di rete stabili).r
: rx-su-quando-inattivod
: dispositivo Thread completo.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 visualizzato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificato. Se questa opzione non viene utilizzata, tutte le voci archiviate 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 a interfaccia a riga di comando e API
prefisso della 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à: il 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 configurazione di altro tipo DHCPv6.r
: flag di route predefinito.o
: flag della rete mesh.s
: flag stabile.n
: flag Dns Nd.D
: flag del prefisso del dominio.
- Pref: 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 visualizzato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificato. Se questa opzione non viene utilizzata, tutte le voci archiviate 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 a interfaccia a riga di comando e API
percorso della cronologia
Visualizza la cronologia dei percorsi esterni dei dati di rete in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: il tempo trascorso dall'emissione del comando e specificato nel formato:
hours
:minutes
:seconds
:milliseconds
- Evento: i valori possibili sono
Added
oRemoved
. - Route
- Segnalazioni/significato:
s
: flag stabile.n
: flag NAT64.
- Pref: 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 visualizzato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificato. Se questa opzione non viene utilizzata, tutte le voci archiviate 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 a interfaccia a riga di comando e API
router della cronologia
Visualizza la cronologia della tabella delle route in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: il 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): l'ID del 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 valore pari ainf
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 visualizzato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificato. Se questa opzione non viene utilizzata, tutte le voci archiviate 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 a interfaccia a riga di comando e API
rx cronologia
Visualizza la cronologia RX dei messaggi IPv6 in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: il 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 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 del messaggio (valido per i messaggi UDP, TCP o ICMP6).
- Sec: indica se è stata utilizzata la sicurezza a livello di link.
- Prio: priorità dei messaggi. 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 hanno formato 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
in formato tabella otx-success:no
nel formato elenco. Esempi di una trasmissione non riuscita includono l'tx
interruzione del servizio e l'assenza diack
inviato dal peer per nessuno dei frammenti di messaggio. - Neighb: indirizzo breve (RLOC16) del vicino con cui è stato inviato/ricevuto il messaggio. Se il frame è stato trasmesso, viene visualizzato come
bcast
in formato tabella o0xffff
in formato elenco. Se l'indirizzo breve del vicino non è disponibile, viene visualizzato comeunknwn
in formato tabella o0xfffe
nel formato elenco. - Radio: link radio tramite il quale il messaggio è stato inviato/ricevuto (utile quando
OPENTHREAD_CONFIG_MULTI_RADIO
è abilitato). 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 visualizzato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificato. Se questa opzione non viene utilizzata, tutte le voci archiviate 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 a interfaccia a riga di comando e API
storia rxtx
Visualizza la cronologia combinata di RX e TX dei messaggi IPv6 in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: il 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 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 del messaggio (valido per i messaggi UDP, TCP o ICMP6).
- Sec: indica se è stata utilizzata la sicurezza a livello di link.
- Prio: priorità dei messaggi. 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 hanno formato 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
in formato tabella otx-success:no
nel formato elenco. Esempi di una trasmissione non riuscita includono l'tx
interruzione del servizio e l'assenza diack
inviato dal peer per nessuno dei frammenti di messaggio. - Neighb: indirizzo breve (RLOC16) del vicino con cui è stato inviato/ricevuto il messaggio. Se il frame è stato trasmesso, viene visualizzato come
bcast
in formato tabella o0xffff
in formato elenco. Se l'indirizzo breve del vicino non è disponibile, viene visualizzato comeunknwn
in formato tabella o0xfffe
nel formato elenco. - Radio: link radio tramite il quale il messaggio è stato inviato/ricevuto (utile quando
OPENTHREAD_CONFIG_MULTI_RADIO
è abilitato). 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 visualizzato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificato. Se questa opzione non viene utilizzata, tutte le voci archiviate 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 a interfaccia a riga di comando e API
cronologia tx
Visualizza la cronologia TX dei messaggi IPv6 in formato tabella o elenco.
Ogni voce di tabella o elenco fornisce:
- Età: il 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 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 del messaggio (valido per i messaggi UDP, TCP o ICMP6).
- Sec: indica se è stata utilizzata la sicurezza a livello di link.
- Prio: priorità dei messaggi. 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 hanno formato 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
in formato tabella otx-success:no
nel formato elenco. Esempi di una trasmissione non riuscita includono l'tx
interruzione del servizio e l'assenza diack
inviato dal peer per nessuno dei frammenti di messaggio. - Neighb: indirizzo breve (RLOC16) del vicino con cui è stato inviato/ricevuto il messaggio. Se il frame è stato trasmesso, viene visualizzato come
bcast
in formato tabella o0xffff
in formato elenco. Se l'indirizzo breve del vicino non è disponibile, viene visualizzato comeunknwn
in formato tabella o0xfffe
nel formato elenco. - Radio: link radio tramite il quale il messaggio è stato inviato/ricevuto (utile quando
OPENTHREAD_CONFIG_MULTI_RADIO
è abilitato). 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 visualizzato in formato tabella. - Utilizza l'opzione
num-entries
per limitare l'output al numero di voci più recenti specificato. Se questa opzione non viene utilizzata, tutte le voci archiviate 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 a interfaccia a riga di comando e API
ifconfig (verso l'alto,verso il basso)
Consente di attivare o disattivare l'interfaccia IPv6.
Chiama questa opzione per attivare o disattivare la comunicazione IPv6.
Parametri
ifconfig up|down
Esempi
ifconfig up
Done
ifconfig down
Done
Riferimenti a interfaccia a riga di comando e API
ifconfig
Indica se l'interfaccia IPv6 è attiva o meno.
Parametri
Nessun parametro.
Esempi
ifconfig
down
Done
ifconfig
up
Done
Riferimenti a interfaccia a riga di comando e API
ID istanza
Recupera l'identificatore dell'istanza.
L'identificatore dell'istanza è impostato su un valore casuale al momento della creazione dell'istanza e il suo valore non cambierà dopo l'inizializzazione.
Parametri
Nessun parametro.
Esempi
instanceid
468697314
Done
Riferimenti a interfaccia a riga di comando e API
aggiungi ipaddr
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 a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
ipaddr
Restituisce l'elenco di indirizzi IPv6 assegnati all'interfaccia Thread.
Parametri
ipaddr [-v]
Usa -v
per ottenere 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 a interfaccia a riga di comando e API
ipaddr linklocal
Recupera l'indirizzo IPv6 locale rispetto al collegamento di Thread.
L'indirizzo locale del collegamento Thread viene derivato 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 a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
ipaddr rloc
Recupera l'indirizzo RLOC (Thread Routing Locator).
Parametri
Nessun parametro.
Esempi
ipaddr rloc
fdde:ad00:beef:0:0:ff:fe00:0
Done
Riferimenti a interfaccia a riga di comando e API
aggiunta ipmaddr
Sottoscrive l'interfaccia Thread a un indirizzo multicast di interfaccia di rete.
Il contenuto passato 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 a interfaccia a riga di comando e API
ipmaddr del
Annulla l'iscrizione dell'interfaccia Thread a un indirizzo multicast di interfaccia di rete.
Parametri
ipmaddr del aAddress
Esempi
ipmaddr del ff05::1
Done
Riferimenti a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
Ipmaddr Llatn
Restituisce l'indirizzo multicast dei nodi Thread link-locali.
L'indirizzo è un link-local Unicast Prefix-Based Multicast indirizzo [RFC 3306], con:
- flgs impostati su 3 (P = 1 e T = 1)
- scop impostato su 2
- 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 a interfaccia a riga di comando e API
ipmaddr promiscuo (attiva,disattivata)
Attiva o disattiva la modalità promiscuo multicast nell'interfaccia di Thread.
Parametri
ipmaddr promiscuous enable|disable
Esempi
ipmaddr promiscuous enable
Done
ipmaddr promiscuous disable
Done
Riferimenti a interfaccia a riga di comando e API
ipmaddr promiscuo
Verifica se la modalità promiscuo multicast è attiva nell'interfaccia di Thread.
Parametri
Nessun parametro.
Esempi
ipmaddr promiscuous
Disabled
Done
Riferimenti a interfaccia a riga di comando e API
Ipmaddr rlatn
Restituisce l'indirizzo multicast di Thread Realm-Local All Thread.
L'indirizzo è un realm-local Unicast Prefix-Based Multicast Indirizzo [RFC 3306], con:
- flgs impostati su 3 (P = 1 e T = 1)
- scop impostato su 3
- 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 a interfaccia a riga di comando e API
discerner joiner (insieme)
Imposta il Discerner di join.
Parametri
joiner discerner discerner
- Usa
{number}/{length}
per impostarediscerner
. joiner discerner clear
impostaaDiscerner
sunullptr
.
Esempi
joiner discerner 0xabc/12
Done
Riferimenti a interfaccia a riga di comando e API
chiarezza joiner
Libera il legame.
Parametri
Nessun parametro.
Esempi
joiner discerner clear
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
distinzioni di joiner
Ottiene il Joiner Discerner.
Per ulteriori informazioni, consulta otJoinerSetDiscerner.
Parametri
Nessun parametro.
Esempi
joiner discerner
0xabc/12
Done
Riferimenti a interfaccia a riga di comando e API
guida joiner
Stampa il menu Guida di joiner
.
Parametri
Nessun parametro.
Esempi
joiner help
help
id
start
state
stop
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
ID joiner
Recupera l'ID joiner.
Se non è impostato un Joiner Discerner, l'ID joiner rappresenta i primi 64 bit del risultato del calcolo di SHA-256 rispetto allo standard IEEE EUI-64 assegnato in fabbrica. In caso contrario, l'ID join viene calcolato dal valore del disrigitore di joiner.
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 a interfaccia a riga di comando e API
inizio joiner
Abilita il ruolo Thread Joiner.
Parametri
joiner start joining-device-credential [provisioning-url]
joining-device-credential
: passphrase di unione. Deve essere una stringa di tutti i 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 a interfaccia a riga di comando e API
stato joiner
Recupera lo stato Joiner.
Restituisce uno dei seguenti stati:
-
Idle
-
Discover
-
Connecting
-
Connected
-
Entrust
-
Joined
Parametri
Nessun parametro.
Esempi
joiner state
Idle
Done
Riferimenti a interfaccia a riga di comando e API
stop joiner
Disabilita il ruolo Joiner Thread.
Parametri
Nessun parametro.
Esempi
joiner stop
Done
Riferimenti a interfaccia a riga di comando e API
joinerport (insieme)
Imposta la porta UDP del joiner.
Parametri
joinerport udp-port
Esempi
joinerport 1000
Done
Riferimenti a interfaccia a riga di comando e API
Joinerport
Recupera la porta UDP del joiner.
Parametri
Nessun parametro.
Esempi
joinerport
1000
Done
Riferimenti a interfaccia a riga di comando e API
contatore sequenza di chiavi (impostato)
Imposta il parametro thRichiestaSequenceCounter.
Parametri
keysequence counter counter
Esempi
keysequence counter 10
Done
Riferimenti a interfaccia a riga di comando e API
contatore sequenza di chiavi
Consente di acquisire il thmioSequenceCounter.
Parametri
Nessun parametro.
Esempi
keysequence counter
10
Done
Riferimenti a interfaccia a riga di comando e API
guardtime sequenza di tasti (impostato)
Imposta il valore di thRichiestaSwitchGuardTime (in ore).
Parametri
keysequence guardtime guardtime-hours
Usa 0
per Thread Key Switch
immediatamente se esiste una corrispondenza dell'indice della chiave.
Esempi
keysequence guardtime 0
Done
Riferimenti a interfaccia a riga di comando e API
guardtime sequenza di tasti
Recupera thRichiestaSwitchGuardTime (in ore).
Parametri
Nessun parametro.
Esempi
keysequence guardtime
0
Done
Riferimenti a interfaccia a riga di comando e API
leaderdata
Recupera 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 a interfaccia a riga di comando e API
peso leader (impostato)
Imposta il peso della leader del thread utilizzato quando operi con il ruolo Leader.
Imposta direttamente la ponderazione leader sul nuovo valore, sostituendo il valore precedente (che potrebbe essere stato determinato dal valore
otDeviceProperties
attuale).
Parametri
leaderweight weight
Esempi
leaderweight 128
Done
Riferimenti a interfaccia a riga di comando e API
peso leader
Ottieni il peso della leader del thread utilizzato quando operi con il ruolo Leader.
Parametri
Nessun parametro.
Esempi
leaderweight
128
Done
Riferimenti a interfaccia a riga di comando e API
gestione di linkmetrics, autorizzazione di controllo avanzata
Invia una richiesta di gestione delle metriche dei link per cancellare un probe basato su ACK avanzato.
Parametri
linkmetrics mgmt peer-ipaddr enhanced-ack clear
peer-ipaddr
deve essere l'indirizzo locale del collegamento del dispositivo vicino.
Esempi
linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack clear
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
Riferimenti a interfaccia a riga di comando e API
registro ACK avanzato gestione linkmetrics di gestione
Invia una richiesta di gestione delle metriche dei link per registrare un probe basato su ACK avanzato.
Parametri
linkmetrics mgmt peer-ipaddr enhanced-ack register [qmr][r]
[q
, m
e r
] sono mappati a otLinkMetricsValues. Secondo la specifica 4.11.3.4.4.6, puoi utilizzare solo un massimo di due opzioni alla volta, ad esempio q
o qm
.
q
: LQI di livello 2.m
: margine del link.r
: RSSI.
r
aggiuntivo è facoltativo e viene utilizzato solo per i dispositivi di riferimento. Quando questa opzione è specificata, Tipo/Enum media di ciascun flag ID tipo è impostato su riservato. Viene utilizzato per verificare che il soggetto in questione gestisca correttamente i flag ID di tipo non validi ed è disponibile solo quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
è abilitato.
Esempi
linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Success
> linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 enhanced-ack register qm r
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: Cannot support new series
Riferimenti a interfaccia a riga di comando e API
gestione dei link in avanti
Invia una richiesta di gestione delle metriche del link MLE per configurare o cancellare una serie di tracciamento avanti.
Parametri
linkmetrics mgmt peer-ipaddr forward series-id [ldraX][pqmr]
peer-ipaddr
: indirizzo del peer.series-id
: l'ID serie.- [
l
,d
,r
ea
] sono mappati a otLinkMetricsSeriesFlags.X
non rappresenta nessuno deiotLinkMetricsSeriesFlags
e interrompe la contabilità e rimuove la serie.l
: probe di collegamento MLE.d
: dati MAC.r
: richiesta di dati MAC.a
: conferma MAC.X
: può essere utilizzato solo senza altri flag.
- [
p
,q
,m
er
] vengono mappati a otLinkMetricsValues.p
: numero di livello 2 di PDU ricevute.q
: LQI di livello 2.m
: margine del link.r
: RSSI.
Esempi
linkmetrics mgmt fe80:0:0:0:3092:f334:1455:1ad2 forward 1 dra pqmr
Done
> Received Link Metrics Management Response from: fe80:0:0:0:3092:f334:1455:1ad2
Status: SUCCESS
Riferimenti a interfaccia a riga di comando e API
probe linkmetrics
Invia un messaggio MLE Link Probe.
Parametri
linkmetrics probe peer-ipaddr series-id length
peer-ipaddr
: indirizzo del peer.series-id
: l'ID serie a cui ha come target il messaggio Probe.length
: la lunghezza del messaggio Probe. Un intervallo valido è [0, 64].
Esempi
linkmetrics probe fe80:0:0:0:3092:f334:1455:1ad2 1 10
Done
Riferimenti a interfaccia a riga di comando e API
inoltra query linkmetrics
Eseguire una query Metriche dei link (serie Forward Tracking).
Parametri
linkmetrics query peer-ipaddr forward series-id
peer-ipaddr
: indirizzo del peer.series-id
: l'ID serie.
Esempi
linkmetrics query fe80:0:0:0:3092:f334:1455:1ad2 forward 1
Done
> Received Link Metrics Report from: fe80:0:0:0:3092:f334:1455:1ad2
- PDU Counter: 2 (Count/Summation)
- LQI: 76 (Exponential Moving Average)
- Margin: 82 (dB) (Exponential Moving Average)
- RSSI: -18 (dBm) (Exponential Moving Average)
Riferimenti a interfaccia a riga di comando e API
query linkmetrics, singola
Eseguire una query Link Metrics (singolo probe).
Parametri
linkmetrics query peer-ipaddr single [pqmr]
peer-ipaddr
: indirizzo del peer.- [
p
,q
,m
er
] sono mappati a otLinkMetrics.p
: numero di livello 2 di PDU ricevute.q
: LQI di livello 2.m
: margine del link.r
: RSSI.
Esempi
linkmetrics query fe80:0:0:0:3092:f334:1455:1ad2 single qmr
Done
> Received Link Metrics Report from: fe80:0:0:0:3092:f334:1455:1ad2
- LQI: 76 (Exponential Moving Average)
- Margin: 82 (dB) (Exponential Moving Average)
- RSSI: -18 (dBm) (Exponential Moving Average)
Riferimenti a interfaccia a riga di comando e API
linkmetricsmgr (attiva,disattiva)
Abilita o disabilita Gestore delle metriche dei link.
Parametri
linkmetricsmgr enable|disable
Esempi
linkmetricmgr enable
Done
linkmetricmgr disable
Done
Riferimenti a interfaccia a riga di comando e API
programma linkmetricsmgr
Ottieni i dati delle Metriche dei link di un vicino in base al suo indirizzo esteso.
Parametri
Nessun parametro.
Esempi
linkmetricsmgr show
ExtAddr:827aa7f7f63e1234, LinkMargin:80, Rssi:-20
Done
Riferimenti a interfaccia a riga di comando e API
individua (imposta)
Individua la destinazione più vicina di un indirizzo anycast (ad esempio trova l'EID locale e RLOC16 del mesh della destinazione).
La destinazione più vicina viene determinata in base alla tabella di routing attuale e ai costi del percorso all'interno del mesh Thread.
Disponibile quando OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE
è abilitato.
Parametri
locate anycastaddr
Esempi
locate fdde:ad00:beef:0:0:ff:fe00:fc00
fdde:ad00:beef:0:d9d3:9000:16b:d03b 0xc800
Done
Riferimenti a interfaccia a riga di comando e API
individua
Restituisce lo stato attuale (In Progress
o Idle
) del locator anycast.
Disponibile quando OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE
è abilitato.
Parametri
Nessun parametro.
Esempi
locate
Idle
Done
locate fdde:ad00:beef:0:0:ff:fe00:fc10
locate
In Progress
Done
Riferimenti a interfaccia a riga di comando e API
nome file di log
Specifica il nome file per acquisire i messaggi
otPlatLog()
, una funzionalità utile durante il debug degli script di test automatici su Linux durante il logging che interrompe gli script di test automatici.
Richiede OPENTHREAD_CONFIG_LOG_OUTPUT == OPENTHREAD_CONFIG_LOG_OUTPUT_DEBUG_UART
e OPENTHREAD_POSIX
.
Parametri
log filename filename
Esempi
Riferimenti a interfaccia a riga di comando e API
livello log (impostato)
Imposta il livello di log.
Parametri
log level level
Esempi
log level 4
Done
Riferimenti a interfaccia a riga di comando e API
livello log
Ottieni il livello log.
Parametri
Nessun parametro.
Esempi
log level
1
Done
Riferimenti a interfaccia a riga di comando e API
nuovi tentativi mac diretti (get,set)
Ottieni o imposta il numero di nuovi tentativi TX diretti sul livello MAC.
Parametri
mac retries direct [number]
Utilizza l'argomento number
facoltativo per impostare il numero di nuovi tentativi diretti di TX.
Esempi
mac retries direct
3
Done
mac retries direct 5
Done
Riferimenti a interfaccia a riga di comando e API
nuovi tentativi mac indiretti (get,set)
Ottieni o imposta il numero di nuovi tentativi TX indiretti sul livello MAC.
Parametri
mac retries indirect [number]
Utilizza l'argomento facoltativo number
per impostare il numero di nuovi tentativi Tx indiretti.
Esempi
mac retries indirect
3
Done
max retries indirect 5
Done
Riferimenti a interfaccia a riga di comando e API
inviare mac
Comunica a un dispositivo Rx-Off-When-Idle
di inviare un frame MAC al dispositivo padre. Questo comando è destinato alla certificazione e può essere utilizzato solo quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
è abilitato.
Parametri
mac send datarequest | emptydata
Devi scegliere uno dei seguenti due argomenti:
datarequest
: mette in coda un messaggio di richiesta di dati IEEE 802.15.4 da trasmettere.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 a interfaccia a riga di comando e API
aggiungi indirizzo macfilter
È disponibile solo quando è abilitata la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
.
Aggiunge un indirizzo esteso IEEE 802.15.4 all'elenco dei filtri MAC. Se specifichi l'argomento facoltativo rss
, viene corretta l'intensità del segnale ricevuto per i messaggi provenienti dall'indirizzo. Se non utilizzi l'opzione rss
, l'indirizzo utilizzerà il valore predefinito impostato. Se non hai impostato un valore predefinito, l'intensità del segnale sarà quella over-air.
Parametri
macfilter addr add extaddr [rss]
Esempi
macfilter addr add 0f6127e33af6b403 -95
Done
macfilter addr add 0f6127e33af6b402
Done
Riferimenti a interfaccia a riga di comando e API
lista consentita indirizzo macfilter
Attiva la modalità di filtro MAC di allowlist
, il che significa che sarà consentito l'accesso solo agli indirizzi MAC nell'elenco dei filtri MAC.
Parametri
Nessun parametro.
Esempi
macfilter addr allowlist
Done
Riferimenti a interfaccia a riga di comando e API
CANNOT TRANSLATE
È disponibile quando è abilitata la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
.
Questo comando cancella tutti gli indirizzi estesi dall'elenco dei filtri MAC.
Parametri
Nessun parametro.
Esempi
macfilter addr clear
Done
Riferimenti a interfaccia a riga di comando e API
lista bloccata macfilter addr
Attiva la modalità di filtro MAC di denylist
, il che significa che a tutti gli indirizzi MAC nell'elenco dei filtri MAC sarà negato l'accesso.
Parametri
Nessun parametro.
Esempi
macfilter addr denylist
Done
Riferimenti a interfaccia a riga di comando e API
disabilita indirizzo macfilter
Disattiva le modalità di filtro MAC.
Parametri
Nessun parametro.
Esempi
macfilter addr disable
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
indirizzo macfilter
È disponibile quando è abilitata la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
.
Fornisce le seguenti informazioni:
- Modalità attuale dell'elenco di filtri MAC:
AllowList
,DenyList,
oDisabled
- Un elenco di tutti gli indirizzi estesi presenti nel filtro. L'intensità del segnale ricevuto (rss) e l'indicatore di qualità del link (LQI) sono elencati 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 a interfaccia a riga di comando e API
rimozione indirizzo macfilter
È disponibile quando è abilitata la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
.
Questo comando rimuove l'indirizzo esteso specificato dall'elenco dei filtri MAC.
Parametri
macfilter addr remove extaddr
Esempi
macfilter addr remove 0f6127e33af6b402
Done
Riferimenti a interfaccia a riga di comando e API
filtro mac
Fornisce le seguenti informazioni:
Address Mode
: modalità attuale del filtro MAC:AllowList
,DenyList,
oDisabled
- Un elenco di tutti gli indirizzi estesi presenti nell'elenco dei filtri MAC. L'intensità del segnale ricevuto (rss) e l'indicatore di qualità del link (LQI) sono elencati 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 cui il valore dirss
è stato impostato in modo che sia diverso dal valore predefinito. Default rss
: mostra i valori predefiniti, se applicabili, per le impostazionirss
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 a interfaccia a riga di comando e API
aggiungi 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 a interfaccia a riga di comando e API
macfilter rss add-lqi
Aggiunge l'indirizzo esteso specificato all'elenco RssIn
(o modifica un indirizzo esistente nell'elenco RssIn
) e imposta l'indicatore della qualità del link fisso per i messaggi provenienti da quell'indirizzo. L'indirizzo esteso non deve necessariamente trovarsi nel filtro address allowlist/denylist
per impostare lqi
.
Questa opzione è disponibile quando è abilitata la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
.
Parametri
macfilter rss add-lqi extaddr lqi
Per impostare un valore predefinito per l'indicatore di qualità del 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 a interfaccia a riga di comando e API
macfilter rss cancella
Cancella tutte le voci (inclusi i valori predefiniti) dell'intensità del segnale ricevuto (rss
) e dell'indicatore di qualità del link (lqi
) dall'elenco RssIn
.
Lo svolgimento di questa azione significa che tutti gli indirizzi estesi utilizzeranno il segnale in onda.
È disponibile quando è abilitata la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
.
Parametri
Nessun parametro.
Esempi
macfilter rss clear
Done
Riferimenti a interfaccia a riga di comando e 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 della qualità del link (lqi
). Le impostazionirss
elqi
sono mappate l'una all'altra. 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 impostazionirss
elqi
.
Parametri
Nessun parametro.
Esempi
macfilter rss
0f6127e33af6b403 : rss -95 (lqi 1)
Default rss: -50 (lqi 3)
Done
Riferimenti a interfaccia a riga di comando e API
rimozione macfilter rss
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
, se i valori predefiniti sono stati impostati. Se non sono stati impostati valori predefiniti, viene utilizzato il segnale over-air.
È disponibile quando è abilitata la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE
.
Non viene eseguita alcuna azione se non esistono voci esistenti nell'elenco RssIn
corrispondente all'Indirizzo esteso specificato.
Parametri
macfilter rss remove extaddr
Se vuoi rimuovere le impostazioni predefinite dell'indicatore di intensità del segnale ricevuto e di qualità del link, utilizza *
come extaddr
. Questa opzione consente di annullare le impostazioni predefinite, ma non rimuove le voci dall'elenco RssIn
.
Esempi
macfilter rss remove *
Done
macfilter rss remove 0f6127e33af6b404
Done
Riferimenti a interfaccia a riga di comando e API
meshdiag childip6
Invia una query a un padre per recuperare gli indirizzi IPv6 di tutti i relativi MTD secondari.
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 a interfaccia a riga di comando e API
tabella figlio meshdiag
Avvia una query per la 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 (in caso di sonno di tuo figlio)
- Modalità dispositivo
- RSS (media e ultimo)
- Frequenza di errori: frame tx (a livello MAC), messaggio IPv6 tx (sopra MAC)
- Tempo di connessione (secondi dall'inizio del formato
{dd}d.{hh}:{mm}:{ss}
per la creazione del collegamento) - Informazioni CSL:
- Se sincronizzato
- Periodo (in unità di 10 simboli)
- 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 a interfaccia a riga di comando e API
- Nessuna API associata
router meshdiag nelle vicinanze
Avvia una query per la tabella dei router vicini di un router con un determinato RLOC16. L'output elenca tutte le voci dei router vicini. Informazioni per voce:
- RLOC16
- Indirizzo MAC esteso
- Versione thread
- RSS (media e ultimo) e margine link
- Frequenza di errori, frame tx (a livello MAC), messaggio IPv6 tx (sopra MAC)
- Tempo di connessione (secondi dall'inizio del formato
{dd}d.{hh}:{mm}:{ss}
per la 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 a interfaccia a riga di comando e API
topologia meshdiag
Scopri la topologia di rete (elenco dei router e delle relative connessioni). I parametri sono facoltativi e indicano altri elementi da scoprire. Può essere aggiunto in qualsiasi ordine.
ip6-addrs
per scoprire l'elenco di indirizzi IPv6 di ogni router.children
per trovare la tabella secondaria di ogni router.
Informazioni per router:
- ID router
- RLOC16
- Indirizzo MAC esteso
- Versione thread (se nota)
- Indica se il router è un dispositivo stesso (
me
) - Indica se il router è il principale di questo dispositivo quando il dispositivo è un bambino (
parent
) - Se il router è
leader
- Se il router funge da router di confine che fornisce connettività esterna (
br
) - Elenco di router a cui il router è collegato:
3-links
: ID router a cui il router ha un link in entrata con qualità del link 3.2-links
: ID router a cui il router ha un link in entrata con qualità del link 2.1-links
: ID router a cui il router ha un link in entrata con qualità del link 1.- Se un elenco è vuoto, viene omesso.
- Se
ip6-addrs
, elenca gli indirizzi IPv6 del router - Se
children
, elenca tutti i dispositivi secondari del router. Informazioni per bambino:- RLOC16
- Qualità del link in entrata dal punto di vista dell'account principale a quello secondario (zero indica sconosciuto)
- Modalità dispositivo secondario (
r
rx-on-When-idle,d
dispositivo full Thread,n
dati di rete completi,-
nessun flag impostato) - Se tuo figlio è il dispositivo stesso (
me
) - Se il publisher secondario funge da 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 a interfaccia a riga di comando e API
Mleadvimax
Recupera il valore Intervallo Max corrente utilizzato dal timer di mantenimento della pubblicità.
Questa API richiede OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
ed è destinata solo a scopi di test.
Parametri
Nessun parametro.
Esempi
mleadvimax
12000
Done
Riferimenti a interfaccia a riga di comando e API
mliide
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 test/dispositivo di riferimento.
Parametri
mliid iid
Esempi
mliid 1122334455667788
Done
Riferimenti a interfaccia a riga di comando e API
mlr reg
Registra i listener multicast al router backbone principale.
OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE
e OPENTHREAD_CONFIG_COMMISSIONER_ENABLE
devono essere attivati.
Ometti il timeout per utilizzare il timeout MLR predefinito sul router backbone principale.
Utilizza 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 a interfaccia a riga di comando e API
modalità (get,set)
Imposta la configurazione della modalità di collegamento con MLE.
Parametri
mode [rdn]
-
: nessun flag impostato (rx-off-quando-inattivo, dispositivo Thread minimo, dati di rete stabili)r
: rx-su-quando-inattivod
: dispositivo Thread completon
: dati di rete completi
Esempi
mode rdn
Done
mode -
Done
Riferimenti a interfaccia a riga di comando e API
multiradio
Scarica l'elenco dei link radio supportati dal dispositivo.
Questo comando è sempre disponibile, anche quando il dispositivo supporta una sola radio.
Parametri
Nessun parametro.
Esempi
multiradio
[15.4, TREL]
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
elenco di vicini multiradio
Recupera le informazioni sul collegamento multi-radio associato a un vicino con un indirizzo esteso specificato.
È necessario attivare OPENTHREAD_CONFIG_MULTI_RADIO
.
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 a interfaccia a riga di comando e API
vicino multiradio
Recupera le informazioni sul collegamento multi-radio associato a un vicino con un indirizzo esteso specificato.
È necessario attivare OPENTHREAD_CONFIG_MULTI_RADIO
.
Parametri
multiradio neighbor ext-address
Esempi
multiradio neighbor 3a65bc38dbe4a5be
[15.4(255), TREL(255)]
Done
Riferimenti a interfaccia a riga di comando e API
nat64 (abilita,disabilita)
Abilita o disabilita le funzioni NAT64.
Se OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
è abilitato, l'impostazione disabilitata su true reimposta la tabella di mappatura nel traduttore.
Disponibile quando sono attivati OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
o OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
.
Parametri
nat64 enable|disable
Esempi
nat64 enable
Done
nat64 disable
Done
Riferimenti a interfaccia a riga di comando e API
Nat64 CDR
Parametri
Nessun parametro.
Esempi
nat64 cidr 192.168.255.0/24
Done
Riferimenti a interfaccia a riga di comando e API
Nat64 Sidro
Restituisce il CIDR IPv4 configurato nel traduttore NAT64.
Disponibile quando OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
è abilitato.
Parametri
Nessun parametro.
Esempi
nat64 cidr
192.168.255.0/24
Done
Riferimenti a interfaccia a riga di comando e API
contatori nat64
Recupera i contatori dei pacchetti e degli errori del traduttore NAT64.
Disponibile quando OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
è abilitato.
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 a interfaccia a riga di comando e API
mappature nat64
Recupera le informazioni successive di AddressMapping (usando un iteratore).
Disponibile quando OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
è abilitato.
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 a interfaccia a riga di comando e API
stato nat64
Recupera 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.
Se OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE
è abilitato, PrefixManager
restituisce uno dei seguenti stati:
Disabled
: il gestore di prefissi NAT64 è disabilitato.NotRunning
: il gestore di prefissi NAT64 è abilitato, ma non è in esecuzione. Ciò potrebbe significare che la gestione dei percorsi è disattivata.Idle
: il gestore di 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 di prefissi NAT64 è abilitato, in esecuzione e pubblica un prefisso NAT64.
Se OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE
è abilitato, Translator
restituisce uno dei seguenti stati:
Disabled
: il traduttore NAT64 è disattivato.NotRunning
: il traduttore NAT64 è abilitato, ma non traduce i pacchetti. Questo 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 a interfaccia a riga di comando e API
elenco di connessione dei vicini
Stampa la data e l'età della connessione dei vicini. Questo comando è simile a neighbor conntime
, ma visualizza le informazioni sotto forma di elenco. L'età e la durata della connessione vengono visualizzate 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 a interfaccia a riga di comando e API
vicino di connessione
Stampa la data e l'età della connessione dei vicini. Informazioni per vicino:
- RLOC16
- MAC esteso
- Ultimo sentito (età): numero di secondi dall'ultimo ascolto del vicino.
- Tempo connessione: numero di secondi dalla creazione del collegamento con il vicino. Gli intervalli della durata sono 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 a interfaccia a riga di comando e API
qualità link vicino
Stampa le informazioni sulla qualità del link per 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 a interfaccia a riga di comando e API
- Nessuna API associata
elenco dei vicini
Elenca l'RLOC16 di ogni vicino.
Parametri
Nessun parametro.
Esempi
neighbor list
0xcc01 0xc800 0xf000
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
tabella dei vicini
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à del dispositivo dei vicini. Ogni colonna ha un valore di 0
(off) o 1
(on).
R
: RX acceso in caso di inattivitàD
: 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 a interfaccia a riga di comando e API
netdata completo
Stampa "sì" o "no" per indicare se il callback "dati netti pieno" è stato richiamato dall'inizio dell'operazione Thread o dall'ultima volta in cui è stato utilizzato netdata full reset
per reimpostare il flag. Questo comando richiede OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL
. Il callback "dati netti completi" viene richiamato ogni volta che:
- Il dispositivo agisce come leader e riceve una registrazione dei dati di rete da un router di confine (BR) che non può aggiungere ai dati di rete (spazio disponibile in esaurimento).
- Il dispositivo funge da BR e non è possibile aggiungere nuove voci ai relativi dati di rete locali.
- Il dispositivo funge da BR e cerca di registrare le sue voci di dati di rete locali con la variante principale, ma determina che le sue voci locali non possono essere considerate.
Parametri
Nessun parametro.
Esempi
netdata full
no
Done
Riferimenti a interfaccia a riga di comando e API
reimpostazione completa netdata
Reimposta il monitoraggio del flag se è stato richiamato il callback "dati netti completi".
Parametri
Nessun parametro.
Esempi
netdata full reset
Done
Riferimenti a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
lunghezza massima netdata
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 a interfaccia a riga di comando e API
reimpostazione di netdata maxlength
Reimposta la lunghezza massima rilevata dei dati di rete Thread.
Parametri
Nessun parametro.
Esempi
netdata maxlength reset
Done
Riferimenti a interfaccia a riga di comando e 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.
È necessario attivare OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
.
Parametri
netdata publish dnssrp anycast seq-num
Esempi
netdata publish dnssrp anycast 1
Done
Riferimenti a interfaccia a riga di comando e API
- netdata publish dnssrp unicast (addr,port)
- netdata publish dnssrp unicast (mle)
- otNetDataPublishDnsSrpServiceAnycast
netdata publish dnssrp unicast (addr,porta)
Pubblica un indirizzo Unicast di 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.
È necessario attivare OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
.
Parametri
netdata publish dnssrp unicast address port
Esempi
netdata publish dnssrp unicast fd00::1234 51525
Done
Riferimenti a interfaccia a riga di comando e API
- netdata publish dnssrp unicast (mle)
- netdata publish dnssrp anycast
- otNetDataPublishDnsSrpServiceUnicast
netdata publish dnssrp unicast (mle)
Pubblica l'EID locale mesh del dispositivo con un numero di porta. Le informazioni su MLE e porta sono incluse nei dati TLV del server. Per utilizzare un indirizzo Unicast diverso, utilizza 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.
È necessario attivare OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
.
Parametri
netdata publish dnssrp unicast port
Esempi
netdata publish dnssrp unicast 50152
Done
Riferimenti a interfaccia a riga di comando e API
- netdata publish dnssrp unicast (addr,port)
- netdata publish dnssrp anycast
- otNetDataPublishDnsSrpServiceUnicastMeshLocalEid
prefisso di pubblicazione netdata
Pubblica una voce con 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 gli argomenti mappati per configurare i valori otBorderRouterConfig. Per saperne di più, consulta la panoramica dell'interfaccia a riga di comando OpenThread.
Esempi
netdata publish prefix fd00:1234:5678::/64 paos med
Done
Riferimenti a interfaccia a riga di comando e API
sostituzione pubblicazione netdata
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 gli argomenti mappati per configurare i valori otExternalRouteConfig. Per saperne di più, consulta la panoramica dell'interfaccia a riga di comando OpenThread.
Esempi
netdata publish replace ::/0 fd00:1234:5678::/64 s high
Done
Riferimenti a interfaccia a riga di comando e 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 gli argomenti mappati per configurare i valori otExternalRouteConfig. Per saperne di più, consulta la panoramica dell'interfaccia a riga di comando OpenThread.
Esempi
netdata publish route fd00:1234:5678::/64 s high
Done
Riferimenti a interfaccia a riga di comando e API
registro netdata
Registra prefissi, route e servizi configurati con Leader.
L'interfaccia a riga di comando OT controlla OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
. Se la tecnologia OTBR è abilitata, registra i dati di rete locali con 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 a interfaccia a riga di comando e API
controllo netdata steeringdata (discerner)
Controlla se i dati sullo sterzo includono un Joiner con un determinato valore di discernimento.
Parametri
netdata steeringdata check discerner
discerner
: The Joiner discerner in format{number}/{length}
.
Esempi
netdata steeringdata check 0xabc/12
Done
netdata steeringdata check 0xdef/12
Error 23: NotFound
Riferimenti a interfaccia a riga di comando e API
controllo netdata steeringdata (eui64)
Controlla se i dati sullo sterzo includono un Joiner.
Parametri
netdata steeringdata check eui64
eui64
: EUI-64 dell'IEEE del Joiner.
Esempi
netdata steeringdata check d45e64fa83f81cf7
Done
Riferimenti a interfaccia a riga di comando e API
annullamento pubblicazione netdata (prefisso)
Annulla la pubblicazione di un prefisso di percorso esterno o nella rete mesh pubblicato in precedenza.
È necessario attivare OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE
.
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 a interfaccia a riga di comando e API
annullamento pubblicazione dnssrp netdata
Annulla la pubblicazione di qualsiasi voce del servizio DNS/SRP (Anycast o Unicast) aggiunta in precedenza dai dati di rete Thread.
È necessario attivare OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE
.
Parametri
Nessun parametro.
Esempi
netdata unpublish dnssrp
Done
Riferimenti a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
networkdiagnostic ottengono
Invia una richiesta di diagnostica di rete per recuperare i valori di lunghezza del tipo (TLV) 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 (il periodo di tempo massimo del polling per SED)4
: TLV connettività5
: TLV di Route646
: dati dei leader TLV7
: TLV dei dati di rete8
: TLV elenco indirizzi IPv69
: Contatori MAC TLV14
: livello della batteria (TLV)15
: tensione di alimentazione TLV16
: TLV tabella secondaria17
: TLV delle pagine del canale19
: timeout max figli (TLV)23
: TLV EUI6424
: versione TLV (numero di versione per protocolli e funzionalità)25
: nome del fornitore (TLV)26
: TLV modello del fornitore27
: versione SW del fornitore TLV28
: versione TLV dello stack Thread (identificatore della versione come stringa UTF-8 per codebase/commit/versione dello stack Thread)29
: TLV secondario34
: Contatori MLE TLV35
: TLV 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 a interfaccia a riga di comando e API
reimpostazione diagnostica della rete
Invia una richiesta di diagnostica della rete per reimpostare i valori TLV (Type Length Value) specificati negli indirizzi specificati. Questo comando supporta solo i seguenti valori TLV: 9
(Contatori MAC TLV) o 34
(Contatori MLE TLV)
Parametri
networkdiagnostic reset addr type(s)
Esempi
networkdiagnostic reset fd00:db8::ff:fe00:0 9
Done
Riferimenti a interfaccia a riga di comando e API
networkidtimeout (get,set)
Restituisce o imposta il parametro NETWORK_ID_TIMEOUT
.
Parametri
networkidtimeout [timeout]
Utilizza l'argomento timeout
facoltativo per impostare il valore del parametro NETWORK_ID_TIMEOUT
.
Esempi
networkidtimeout 120
Done
networkidtimeout
120
Done
Riferimenti a interfaccia a riga di comando e API
networkkey (chiave)
Imposta la chiave di rete Thread.
Ha successo solo se i protocolli Thread sono disabilitati. Una chiamata riuscita a questa funzione rende non validi i set di dati operativi attivi e in attesa nella memoria non volatile.
Parametri
networkkey key
Esempi
networkkey 00112233445566778899aabbccddeeff
Done
Riferimenti a interfaccia a riga di comando e API
chiave di rete
Recupera la chiave di rete Thread.
Parametri
Nessun parametro.
Esempi
networkkey
00112233445566778899aabbccddeeff
Done
Riferimenti a interfaccia a riga di comando e API
nomerete (nome)
Imposta il nome della rete Thread.
Ha successo solo se i protocolli Thread sono disabilitati. Una chiamata riuscita a questa funzione rende non validi i set di dati operativi attivi e in attesa nella memoria non volatile.
Parametri
networkname name
Esempi
networkname OpenThread
Done
Riferimenti a interfaccia a riga di comando e API
nomerete
Ottieni il nome di rete Thread.
Parametri
Nessun parametro.
Esempi
networkname
OpenThread
Done
Riferimenti a interfaccia a riga di comando e API
networktime (impostato)
Imposta i parametri di sincronizzazione dell'ora.
timesyncperiod
: il periodo di sincronizzazione temporale, in secondi.xtalthreshold
: la soglia di accuratezza XTAL per far diventare un dispositivo compatibile con il router (in PPM).
Parametri
networktime timesyncperiod xtalthreshold
Esempi
networktime 100 300
Done
Riferimenti a interfaccia a riga di comando e API
ora della rete
Restituisce 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 a interfaccia a riga di comando e API
nexthop (get)
Restituisce il costo dell'hop e del percorso successivo verso una determinata destinazione RLOC16.
Può essere utilizzato se aNextHopRloc16
o aPathCost
sono NULL e indicano 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 a interfaccia a riga di comando e API
Nexthop
Tabella di output degli ID router allocati e dei costi attuali del percorso e dell'hop successivo 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 a interfaccia a riga di comando e API
panid (panid)
Imposta l'ID PAN IEEE 802.15.4.
Ha successo solo se i protocolli Thread sono disabilitati. Una chiamata riuscita a questa funzione rende non valido anche i set di dati operativi attivi e in attesa nella memoria non volatile.
Parametri
panid panid
Esempi
panid 0xdead
Done
Riferimenti a interfaccia a riga di comando e API
panid
Ottieni l'ID PAN IEEE 802.15.4.
Parametri
Nessun parametro.
Esempi
panid
0xdead
Done
Riferimenti a interfaccia a riga di comando e API
parent
Recupera le informazioni diagnostiche per un router Thread come padre.
Quando utilizzi come router Thread quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE è abilitato, questo comando restituisce le informazioni memorizzate nella cache dal momento in cui il dispositivo era stato precedentemente collegato come elemento secondario Thread. È necessario restituire le informazioni memorizzate nella cache per supportare lo scenario di test del Thread Test Harness 8.2.x, che richiede l'indirizzo MAC padre precedente (ad es. il router Joiner) anche se il dispositivo è già stato promosso a 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 a interfaccia a riga di comando e API
ricerca genitore
Avvia il processo per il figlio di cercare un genitore migliore mantenendo l'identità del genitore attuale.
Deve essere utilizzato quando il dispositivo è collegato come bambino.
Parametri
Nessun parametro.
Esempi
parent search
Done
Riferimenti a interfaccia a riga di comando e API
priorità genitori (get,set)
Ottieni o imposta il valore di priorità padre assegnato: 1, 0, -1 o -2. -2 significa che non è assegnato.
Parametri
parentpriority [parentpriority]
Esempi
parentpriority
1
Done
parentpriority 1
Done
Riferimenti a interfaccia a riga di comando e API
ID partizione
Recupera l'ID partizione di rete Thread.
Parametri
Nessun parametro.
Esempi
partitionid
4294967295
Done
Riferimenti a interfaccia a riga di comando e API
Partizioneid 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 a interfaccia a riga di comando e API
platform
Stampa la piattaforma attuale
Parametri
Nessun parametro.
Esempi
platform
NRF52840
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
periodo sondaggio (get,set)
Ottieni o imposta il periodo del sondaggio personalizzato sui dati del dispositivo finale assonnato (millisecondi). Solo per test di certificazione.
Parametri
Nessun parametro.
Esempi
pollperiod
0
Done
pollperiod 10
Done
Riferimenti a interfaccia a riga di comando e API
preferrouterid
Specifica l'ID router preferito che il leader deve fornire quando richiesto.
Parametri
preferrouterid routerid
Esempi
preferrouterid 16
Done
Riferimenti a interfaccia a riga di comando e API
aggiungi 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 gli argomenti mappati per configurare i valori otBorderRouterConfig. Per saperne di più, 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 a interfaccia a riga di comando e API
prefisso meshlocal
Ottieni il prefisso locale mesh.
Parametri
Nessun parametro.
Esempi
prefix meshlocal
fdde:ad00:beef:0::/64
Done
Riferimenti a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
rimozione prefisso
Rimuovi la configurazione di un router di confine dai dati della rete locale.
Parametri
Nessun parametro.
Esempi
prefix remove 2001:dead:beef:cafe::/64
Done
Riferimenti a interfaccia a riga di comando e API
promiscuo (attiva,disattivata)
Attiva o disattiva la modalità promiscuo del livello dei link.
Parametri
promiscuous enable|disable
Esempi
promiscuous enable
Done
promiscuous disable
Done
Riferimenti a interfaccia a riga di comando e API
promiscuo
Indica se la modalità promiscuo è attivata o meno a livello di link.
Parametri
Nessun parametro.
Esempi
promiscuous
Disabled
Done
Riferimenti a interfaccia a riga di comando e API
pskc (impostato)
Imposta il file pskc in formato esadecimale.
Parametri
pskc key
Esempi
pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done
Riferimenti a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
- Nessuna API associata
pskc
Scarica la PSKc di Thread.
Parametri
Nessun parametro.
Esempi
pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done
Riferimenti a interfaccia a riga di comando e API
pskcref (set)
Imposta il riferimento chiave su PSKc Thread.
Richiede l'abilitazione della funzionalità OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE
in fase di build.
L'operazione riesce solo se i protocolli Thread sono disabilitati. Se l'operazione ha esito positivo, questa operazione renderà non validi i set di dati operativi attivi e in attesa nella memoria non volatile.
Parametri
pskc keyref
Esempi
pskc 0x20017
Done
Riferimenti a interfaccia a riga di comando e API
Pskcref
Recupero del riferimento chiave alla PSKc Thread archiviata.
Richiede l'abilitazione della funzionalità OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE
in fase di build.
Parametri
Nessun parametro.
Esempi
pskcref
0x80000000
Done
Riferimenti a interfaccia a riga di comando e API
pulsante di opzione (attiva,disattiva)
Attiva o disattiva la radio.
Parametri
radio enable|disable
Esempi
radio enable
Done
radio disable
Done
Riferimenti a interfaccia a riga di comando e API
statistiche radio cancellate
Reimposta le statistiche radio.
Tutti gli orari vengono reimpostati su 0.
Parametri
Nessun parametro.
Esempi
radio stats clear
Done
Riferimenti a interfaccia a riga di comando e API
statistiche radio
Recupera le statistiche radio.
Le statistiche radio includono l'ora in cui la radio è in stato TX/RX/Sonno. Questi tempi sono espressi in unità di microsecondi. Tutti gli orari sono calcolati dall'ultimo ripristino 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 a interfaccia a riga di comando e API
versione RCP
Ottieni 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 a interfaccia a riga di comando e API
regione (insieme)
Imposta il codice regione.
Il formato della regione radio è la rappresentazione ASCII a 2 byte del codice ISO 3166 alpha-2.
La modifica di questa impostazione può influire sul limite di potenza di trasmissione.
Parametri
Nessun parametro.
Esempi
region US
Done
Riferimenti a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
releaserouterid (routerid)
Rilascia un ID router assegnato dal dispositivo con il ruolo Leader.
Parametri
releaserouterid [routerid]
Esempi
releaserouterid 16
Done
Riferimenti a interfaccia a riga di comando e API
rloc16
Scarica RLOC16.
Parametri
Nessun parametro.
Esempi
rloc16
0xdead
Done
Riferimenti a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
rimozione percorso
Rimuovi la configurazione di una route esterna dai dati della rete locale.
Parametri
route remove [prefix]
Esempi
route remove 2001:dead:beef:cafe::/64
Done
Riferimenti a interfaccia a riga di comando e API
percorso
Ottieni l'elenco di route esterne nei dati di rete locali.
Parametri
Nessun parametro.
Esempi
route
2001:dead:beef:cafe::/64 s med
Done
Riferimenti a interfaccia a riga di comando e API
router (ID)
La funzione conserva le informazioni diagnostiche per un determinato router Thread.
Stampa le informazioni diagnostiche per 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 a interfaccia a riga di comando e API
elenco di router
Elenca gli ID router allocati.
Parametri
Nessun parametro.
Esempi
router list
8 24 50
Done
Riferimenti a interfaccia a riga di comando e API
tabella 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 a interfaccia a riga di comando e API
soglia di downgrade del router (get,set)
Consente di ottenere o impostare il valore ROUTER_DOWNGRADE_THRESHOLD.
Parametri
routerdowngradethreshold [threshold]
Esempi
routerdowngradethreshold
23
Done
routerdowngradethreshold 23
Done
Riferimenti a interfaccia a riga di comando e API
router idoneo (attivazione,disattivazione)
Attiva o disattiva il ruolo del router.
Parametri
routereligible [enable|disable]
Esempi
routereligible enable
Done
routereligible disable
Done
Riferimenti a interfaccia a riga di comando e API
router idoneo
Indica se il ruolo del router è attivato o disattivato.
Parametri
Nessun parametro.
Esempi
routereligible
Enabled
Done
Riferimenti a interfaccia a riga di comando e API
routerselectionjitter
Restituisce o imposta il valore ROUTER_SELECTION_JITTER.
Parametri
routerselectionjitter [jitter]
Esempi
routerselectionjitter
120
Done
routerselectionjitter 120
Done
Riferimenti a interfaccia a riga di comando e API
routerupgradethreshold (get,set)
Restituisce o imposta il valore ROUTER_UPGRADE_THRESHOLD.
Parametri
routerupgradethreshold [threshold]
Esempi
routerupgradethreshold
16
Done
routerupgradethreshold 16
Done
Riferimenti a interfaccia a riga di comando e API
scansione energia
Esegue una scansione energetica IEEE 802.15.4 e visualizza il tempo in millisecondi da utilizzare per la scansione di ogni canale. Vengono visualizzati tutti i canali, a meno che non ne specifichi uno specifico tramite l'opzione del 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 a interfaccia a riga di comando e API
scansiona
Esegue una scansione IEEE 802.15.4 attiva. La ricerca copre tutti i canali se non è 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 a interfaccia a riga di comando e API
aggiunta servizio
Aggiunge il servizio ai dati di rete.
- enterpriseNumber: numero aziendale IANA
- serviceData: dati dei servizi binari con codifica esadecimale
- serverData: dati del server binario con codifica esadecimale
Parametri
service add enterpriseNumber serviceData serverData
Esempi
service add 44970 112233 aabbcc
Done
netdata register
Done
Riferimenti a interfaccia a riga di comando e API
rimozione servizio
Rimuove il servizio dai dati di rete.
- enterpriseNumber: numero aziendale IANA
- serviceData: dati dei servizi binari con codifica esadecimale
Parametri
service remove enterpriseNumber serviceData
Esempi
service remove 44970 112233
Done
netdata register
Done
Riferimenti a interfaccia a riga di comando e API
singleton
Indica se un nodo è l'unico router sulla rete. Restituisce true
o false
.
Parametri
Nessun parametro.
Esempi
singleton
true
Done
Riferimenti a interfaccia a riga di comando e API
query sntp
Invia una query SNTP per ottenere l'ora corrente del periodo Unix (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 a interfaccia a riga di comando e API
avvio automatico client srp (get)
Indica lo stato corrente 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 l'interfaccia a riga di comando OT.
Parametri
Nessun parametro.
Esempi
srp client autostart
Disabled
Done
Riferimenti a interfaccia a riga di comando e API
disattivazione avvio automatico client srp
Disattiva la modalità di avvio automatico.
La disattivazione della modalità di avvio automatico non interrompe un client in esecuzione. Tuttavia, il client SRP smette di monitorare i dati di rete Thread.
Parametri
Nessun parametro.
Esempi
srp client autostart disable
Done
Riferimenti a interfaccia a riga di comando e API
attivazione avvio automatico client srp
Attiva 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 per avviare e arrestare automaticamente il client quando viene rilevato un server SRP.
Esistono tre categorie di voci di dati di rete che indicano la presenza di un server SRP e sono preferite nel seguente ordine:
- Voci Unicast in cui l'indirizzo del server è incluso nei dati del servizio. Se sono disponibili più opzioni, è preferibile l'opzione con l'indirizzo IPv6 numerico più basso.
- Voci anycast con ciascuna un numero di sequenza. È preferibile utilizzare il numero di sequenza più grande come specificato da Serial Number Arithmetic Logic in RFC-1982.
- Voci Unicast in cui le informazioni sull'indirizzo del server sono incluse nei dati del server. Se sono disponibili più opzioni, è preferibile l'opzione con l'indirizzo IPv6 numerico più basso.
Parametri
Nessun parametro.
Esempi
srp client autostart enable
Done
Riferimenti a interfaccia a riga di comando e API
Callback del client srp (get,enable,disable)
Consente di acquisire o attivare/disattivare gli eventi di callback di stampa dal client SRP. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con l'interfaccia a riga di comando OT.
Parametri
srp client callback [enable|disable]
Esempi
srp client callback enable
Done
srp client callback
Enabled
Done
Riferimenti a interfaccia a riga di comando e API
Indirizzo host client srp (get)
Indica se è attiva la modalità di indirizzo automatico. Se la modalità di indirizzo automatico non è abilitata, viene restituito l'elenco degli indirizzi host del client SRP. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con l'interfaccia a riga di comando OT.
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 a interfaccia a riga di comando e API
Indirizzo host client srp (impostato)
Attiva la modalità indirizzo host automatico 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 l'interfaccia a riga di comando OT.
Parametri
srp client host address [auto|address...]
- Utilizza il parametro
auto
per attivare la modalità di indirizzi dell'host automatico. Quando l'opzione è abilitata, il client utilizza automaticamente tutti gli indirizzi unicastnetif
Thread preferiti, tranne gli indirizzi locali rispetto al link e locali del mesh. Se non esiste un indirizzo valido, viene aggiunto l'indirizzo EID locale del mesh. Il client SRP si registra automaticamente di nuovo 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 da uno spazio. Puoi impostare questo elenco mentre il client è in esecuzione. Verrà disattivata anche la modalità indirizzo host automatico.
Esempi
srp client host address auto
Done
srp client host address fd00::cafe
Done
Riferimenti a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
Nome host 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 l'interfaccia a riga di comando OT.
Parametri
srp client host name [name]
Per impostare il nome host del client quando l'host è stato rimosso o non è ancora stato registrato con il server, utilizza il parametro name
.
Esempi
srp client host name dev4312
Done
srp client host name
dev4312
Done
Riferimenti a interfaccia a riga di comando e 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 l'interfaccia a riga di comando OT.
Parametri
srp client host remove [removekeylease] [sendunregtoserver]
- Il parametro
removekeylease
è un valore booleano facoltativo che indica se è necessario rimuovere 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 messaggio di "aggiornamento" al server anche quando le informazioni relative all'host del client non sono ancora state registrate nel 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 a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
stato host client SRP
Restituisce lo stato dell'host del client SRP. Stati possibili:
ToAdd
: elemento da aggiungere/registrare.Adding
: l'elemento è in fase di aggiunta/registrazione.ToRefresh
: elemento da aggiornare per il rinnovo dell'affitto.Refreshing
: l'elemento è aggiornato.ToRemove
: elemento da rimuovere.Removing
: l'elemento è in fase di rimozione.Registered
: l'elemento è registrato con il server.Removed
: l'elemento è stato rimosso.
Parametri
Nessun parametro.
Esempi
srp client host state
Registered
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
keyleaseinterval client srp (get,set)
Restituisce o imposta l'intervallo di lease delle chiavi in secondi.
Parametri
srp client keyleaseinterval [interval]
Esempi
srp client keyleaseinterval 864000
Done
srp client keyleaseinterval
864000
Done
Riferimenti a interfaccia a riga di comando e API
leaseinterval client srp (get,set)
Restituisce o imposta l'intervallo di lease in secondi.
Parametri
srp client leaseinterval [interval]
Esempi
srp client leaseinterval 3600
Done
srp client leaseinterval
3600
Done
Riferimenti a interfaccia a riga di comando e API
indirizzo 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 a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
- Nessuna API associata
server client srp
Recupera l'indirizzo 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 gli zero) con il numero di porta 0. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con l'interfaccia a riga di comando OT.
Parametri
Nessun parametro.
Esempi
srp client server
[fd00:0:0:0:d88a:618b:384d:e760]:4724
Done
Riferimenti a interfaccia a riga di comando e API
aggiunta servizio client srp
Aggiunge un servizio con un nome istanza, un nome di servizio e un numero di porta specifici. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con l'interfaccia a riga di comando OT.
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. In questi esempi viene utilizzato un nome generico. I parametri priority
e weight
(entrambi sono valori uint16_t
) sono facoltativi e, se non viene fornito, viene utilizzato il valore zero. Il parametro facoltativo txt
imposta i dati TXT associati al servizio. Il valore txt
deve essere in formato stringa esadecimale e viene trattato 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 a interfaccia a riga di comando e API
Chiave di servizio client srp (get,set)
Ottieni o imposta la modalità di inclusione del record della chiave di servizio nel client SRP. Questo comando è destinato esclusivamente ai 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 l'interfaccia a riga di comando OT.
Parametri
Nessun parametro.
Esempi
srp client service key enable
Done
srp client service key
Enabled
Done
Riferimenti a interfaccia a riga di comando e API
nome servizio client srp chiaro
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 a interfaccia a riga di comando e API
rimozione servizio client srp
Richiede 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 a interfaccia a riga di comando e API
servizio client srp
Recupera 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 a interfaccia a riga di comando e 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 l'interfaccia a riga di comando OT.
Parametri
srp client start serveraddr serverport
Esempi
srp client start fd00::d88a:618b:384d:e760 4724
Done
Riferimenti a interfaccia a riga di comando e API
stato client srp
Indica se il client SRP è in esecuzione o meno.
Parametri
Nessun parametro.
Esempi
srp client state
Enabled
Done
Riferimenti a interfaccia a riga di comando e API
interruzione client srp
Interrompe l'operazione del client SRP.
Interrompe eventuali ulteriori interazioni con il server SRP. Tieni presente che le informazioni sull'host e/o l'elenco dei servizi non vengono rimosse né cancellate. Contrassegna tutti i servizi da aggiungere/rimuovere di nuovo una volta che il client viene (ri)avviato.
Parametri
Nessun parametro.
Esempi
srp client stop
Done
Riferimenti a interfaccia a riga di comando e API
srp client ttl (get,set)
Restituisce o imposta il valore ttl
(durata) in secondi.
Parametri
srp client ttl [value]
Esempi
srp client ttl 3600
Done
srp client ttl
3600
Done
Riferimenti a interfaccia a riga di comando e API
Server srp (enable,disable)
Abilita o disabilita il server SRP. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con l'interfaccia a riga di comando OT.
Parametri
srp server [enable|disable]
Esempi
srp server disable
Done
Riferimenti a interfaccia a riga di comando e API
addrmode server srp (get,set)
Restituisce o imposta la modalità indirizzo utilizzata dal server SRP.
La modalità indirizzo indica al server SRP come determinare l'indirizzo e il numero di porta, che poi verranno pubblicati nei dati di rete Thread.
Parametri
srp server addrmode [anycast|unicast]
Esempi
srp server addrmode anycast
Done
srp server addrmode
anycast
Done
Riferimenti a interfaccia a riga di comando e API
server srp automatico (attivazione,disattivazione)
Attiva o disattiva la modalità di attivazione automatica sul server SRP.
Quando questa modalità è attivata, il gestore del routing delle frontiere controlla se e quando abilitare o disabilitare 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 l'interfaccia a riga di comando OT.
Parametri
srp server auto [enable|disable]
Esempi
srp server auto enable
Done
srp server auto
Enabled
Done
Riferimenti a interfaccia a riga di comando e 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 a interfaccia a riga di comando e 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 l'interfaccia a riga di comando OT.
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 a interfaccia a riga di comando e API
lease server srp (get,set)
Restituisce 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 a interfaccia a riga di comando e API
seqnum server srp (get,set)
Restituisce o imposta il numero di sequenza utilizzato con la modalità di indirizzo anycast. Il numero di sequenza è incluso nella voce "Indirizzo Anycast del servizio DNS/SRP" pubblicata nei dati di rete.
Parametri
srp server seqnum [seqnum]
Esempi
srp server seqnum 20
Done
srp server seqnum
20
Done
Riferimenti a interfaccia a riga di comando e 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, questa 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 l'interfaccia a riga di comando OT.
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 a interfaccia a riga di comando e 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 che sono già attivi nella rete Thread. Il server SRP potrebbe 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 ai servizi.
Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con l'interfaccia a riga di comando OT.
Parametri
Nessun parametro.
Esempi
srp server state
running
Done
Riferimenti a interfaccia a riga di comando e API
state
Restituisce il ruolo attuale del dispositivo Thread o lo modifica come specificato con una delle opzioni. Possibili valori restituiti in caso di richiesta di informazioni sul ruolo del dispositivo:
child
: il dispositivo attualmente funziona come dispositivo secondario di Thread.router
: il dispositivo attualmente funziona come router Thread.leader
: il dispositivo attualmente funziona come leader Thread.detached
: il dispositivo al momento non sta partecipando a una partizione/rete Thread.disabled
: lo stack di thread è attualmente disattivato.
Utilizzando una delle opzioni puoi modificare il ruolo attuale di un dispositivo, ma non puoi cambiare lo stato in disabled
.
Parametri
state [child|router|leader|detached]
Esempi
state
child
Done
state leader
Done
Riferimenti a interfaccia a riga di comando e API
- otThreadGetDeviceRole
- otThreadBecomeChild
- otThreadBecomeRouter
- otThreadBecomeLeader
- otThreadBecomeDetached
interruzione tcp
Termina senza difficoltà la connessione TCP associata all'endpoint TCP di esempio, eseguendo la transizione dell'endpoint TCP allo stato chiuso.
Parametri
Nessun parametro.
Esempi
tcp abort
TCP: Connection reset
Done
Riferimenti a interfaccia a riga di comando e API
Risultato benchmark CPA
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 del 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 a interfaccia a riga di comando e API
- Nessuna API associata
Esecuzione benchmark CPA
Trasferisce il numero specificato di byte utilizzando la connessione TCP attualmente associata all'endpoint TCP di esempio fornito dall'interfaccia a riga di comando 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 usato 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 a interfaccia a riga di comando e 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 IPv6 e a una porta è definito "assegnazione del nome all'endpoint TCP". Questo associa l'endpoint per la comunicazione. Per saperne di più, consulta Testare la funzionalità TCP con l'interfaccia a riga di comando OT.
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 associarsi.
Esempi
tcp bind :: 30000
Done
Riferimenti a interfaccia a riga di comando e API
connessione TCP
Stabilisce una connessione con il peer specificato.
Se la connessione viene stabilita, la connessione TCP risultante viene associata all'endpoint TCP di esempio. Per saperne di più, consulta Testare la funzionalità TCP con l'interfaccia a riga di comando OT.
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
quando il prefisso NAT64 preferito non è disponibile.port
: numero di porta TCP del peer.fastopen
: questo parametro è facoltativo. Se il criterio viene impostato sufast
, l'apertura rapida TCP viene attivata per questa connessione. Altrimenti, se questo parametro è 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 a interfaccia a riga di comando e API
parametro tcp
Deinizializza questo endpoint TCP.
Ciò significa che OpenThread non tiene più traccia di questo endpoint TCP e distribuisce tutte le risorse che ha allocato internamente per questo endpoint TCP. L'applicazione può riutilizzare la memoria a supporto dell'endpoint TCP come meglio ritenga.
Se corrisponde a una connessione TCP attiva, la connessione viene interrotta 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 struttura aEndpoint
stessa e così via) vengono immediatamente restituite all'applicazione.
Parametri
Nessun parametro.
Esempi
tcp deinit
Done
Riferimenti a interfaccia a riga di comando e API
tcp init
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 anche la connessione TCP tra due nodi deve utilizzare il protocollo TLS oltre a TCP. Quando due nodi comunicano su TCP, entrambi i nodi devono utilizzare TLS o nessuno dei due deve utilizzare TLS, perché un endpoint non TLS non può comunicare con un endpoint TLS.linked
ocircular
: una di queste opzioni indica che non si deve utilizzare TLS e che per il buffering TCP deve essere utilizzato il tipo di buffering specificato. 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 la dimensione del buffer di ricezione da associare all'endpoint TCP di esempio. Se non specificata, viene utilizzata la dimensione massima. La dimensione massima è impostata inOPENTHREAD_CONFIG_CLI_TCP_RECEIVE_BUFFER_SIZE
.
Esempi
tcp init tls
Done
Riferimenti a interfaccia a riga di comando e API
tcp ascolto
Utilizza il listener TCP di esempio per rimanere in ascolto delle connessioni in entrata sull'indirizzo e sulla porta IPv6 specificati. Per saperne di più, consulta Testare la funzionalità TCP con l'interfaccia a riga di comando OT.
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, vengono accettate tutte le connessioni in entrata corrispondenti all'indirizzo e alla porta IPv6 specificati e vengono associate all'endpoint TCP di esempio.
Esempi
tcp listen :: 30000
Done
Riferimenti a interfaccia a riga di comando e API
invio tcp
Invia i dati tramite la connessione TCP associata all'endpoint TCP di esempio fornito con l'interfaccia a riga di comando tcp
. Per saperne di più, consulta Testare la funzionalità TCP con l'interfaccia a riga di comando OT.
Parametri
tcp send message
Il parametro message
contiene il messaggio da inviare all'endpoint TCP remoto.
Esempi
tcp send hello
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
TCP sendend
Invia il segnale di "fine flusso" sulla connessione TCP associata all'endpoint TCP di esempio fornito dall'interfaccia a riga di comando tcp
. Questo avviso informa il peer che non riceverà altri dati su questa connessione TCP.
Parametri
Nessun parametro.
Esempi
tcp sendend
Done
Riferimenti a interfaccia a riga di comando e API
interruzione dell'ascolto TCP
Indica al listener TCP di esempio di interrompere l'ascolto delle connessioni TCP in entrata.
Parametri
Nessun parametro.
Esempi
tcp stoplistening
Done
Riferimenti a interfaccia a riga di comando e API
test tmforiginfilter
Attiva o disattiva il filtro per eliminare i messaggi TMF UDP da un'origine non attendibile.
Per impostazione predefinita, il filtro che elimina i messaggi TMF UDP da un'origine non attendibile è abilitato. Quando questa opzione è disattivata, i messaggi UDP inviati alla porta TMF che provengono da un'origine non attendibile (come host, 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 a interfaccia a riga di comando e API
- Nessuna API associata
inizio thread
Avvia l'operazione del protocollo Thread.
Parametri
Nessun parametro.
Esempi
thread start
Done
Riferimenti a interfaccia a riga di comando e API
interruzione del thread
Interrompe l'operazione del protocollo Thread.
Parametri
Nessun parametro.
Esempi
thread stop
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
versione thread
Recupera la versione del protocollo Thread.
Parametri
Nessun parametro.
Esempi
thread version
2
Done
Riferimenti a interfaccia a riga di comando e API
tempo massimo in coda
Restituisce il tempo massimo in coda per i messaggi in coda TX.
Richiede OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE
.
Il tempo nella coda viene registrato solo per le trasmissioni dirette e viene misurato come il periodo di tempo che intercorre tra l'aggiunta di un messaggio alla coda di trasmissione e il suo passaggio al livello MAC per la trasmissione o l'eliminazione.
Le statistiche raccolte possono essere reimpostate chiamando il numero
otThreadResetTimeInQueueStat()
.
Parametri
Nessun parametro.
Esempi
timeinqueue max
281
Done
Riferimenti a interfaccia a riga di comando e API
reimpostazione di timeinqueue
Reimposta le statistiche relative al tempo in coda della coda TX.
Richiede OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE
.
Parametri
Nessun parametro.
Esempi
timeinqueue reset
Done
Riferimenti a interfaccia a riga di comando e API
in coda
Recupera l'istogramma del tempo nella coda per i messaggi in coda TX.
Richiede OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE
.
Viene raccolto l'istogramma del tempo in coda dei messaggi nella coda di trasmissione. Il tempo nella coda viene registrato solo per le trasmissioni dirette e viene misurato come il periodo di tempo che intercorre tra l'aggiunta di un messaggio alla coda di trasmissione e il suo passaggio 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 nell'array (con indice 0) rappresenta il numero di messaggi con un tempo nella coda inferiore a aBinInterval
. La seconda voce rappresenta il numero di messaggi con un tempo nella coda maggiore o uguale a aBinInterval
, ma inferiore a 2 * aBinInterval
. e così via. L'ultima voce rappresenta il numero di messaggi con tempo nella coda maggiore o uguale a (aNumBins - 1) * aBinInterval
.
Le statistiche raccolte possono essere reimpostate chiamando il numero
otThreadResetTimeInQueueStat()
. Le informazioni sull'istogramma vengono raccolte dal momento in cui l'istanza OpenThread è stata inizializzata o dall'ultima volta che la raccolta delle statistiche è stata reimpostata 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 a interfaccia a riga di comando e API
trel (attiva,disabilitata)
Attiva o disattiva l'operazione radio TREL.
Parametri
trel enable|disable
Esempi
trel enable
Done
trel disable
Done
Riferimenti a interfaccia a riga di comando e API
contatori trel reimpostati
Azzera i contatori TREL.
Parametri
Nessun parametro.
Esempi
trel counters reset
Done
Riferimenti a interfaccia a riga di comando e API
contatori trel
Recupera i contatori TREL.
Parametri
Nessun parametro.
Esempi
trel counters
Inbound: Packets 32 Bytes 4000
Outbound: Packets 4 Bytes 320 Failures 1
Done
Riferimenti a interfaccia a riga di comando e API
Filtro trel (attivato,disattivato)
Attiva o disattiva la modalità di filtro TREL.
Parametri
trel filter enable|disable
Esempi
trel filter enable
Done
trel filter disable
Done
Riferimenti a interfaccia a riga di comando e API
filtro trel
Indica se la modalità di filtro TREL è attivata.
Quando la modalità filtro è attivata, tutto il traffico Rx e Tx inviato attraverso l'interfaccia TREL viene disattivato automaticamente.
Parametri
Nessun parametro.
Esempi
trel filter
Disabled
Done
Riferimenti a interfaccia a riga di comando e API
colleghi Trel
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 a interfaccia a riga di comando e API
Trel
Indica se l'operazione TREL è abilitata.
Parametri
Nessun parametro.
Esempi
trel
Enabled
Done
Riferimenti a interfaccia a riga di comando e API
tvcheck (abilita,disabilita)
Attiva o disattiva il controllo della versione di Thread quando esegui 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 a interfaccia a riga di comando e API
txpower (get,set)
Recupera (o imposta con l'uso dell'argomento txpower
facoltativo) la potenza di trasmissione in dBm.
Parametri
txpower [txpower]
Esempi
txpower -10
Done
txpower
-10 dBm
Done
Riferimenti a interfaccia a riga di comando e API
binding UDP
Assegna un indirizzo IPv6 e una porta a un socket aperto che associa il socket per la comunicazione. L'assegnazione dell'indirizzo IPv6 e della porta è detta denominazione del socket. Per ulteriori informazioni, 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 (escludendo 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
: è in uso l'interfaccia di rete backbone.
ip
: indirizzo IPv6 a cui eseguire l'associazione. Se vuoi che lo stack UDP/IPv6 assegni l'indirizzo IPv6 di associazione, 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 a interfaccia a riga di comando e API
udp chiudi
Chiudi un socket UDP/IPv6.
Parametri
Nessun parametro.
Esempi
udp close
Done
Riferimenti a interfaccia a riga di comando e API
connessione udp
Collega 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 utilizzando il prefisso NAT64 preferito dai dati di rete. Il comando restituisceInvalidState
quando 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 a interfaccia a riga di comando e API
sicurezza link udp (attiva,disattiva)
Attiva o disattiva la sicurezza dei link.
Parametri
Nessun parametro.
Esempi
udp linksecurity enable
Done
udp linksecurity disable
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
sicurezza link udp
Indica se la sicurezza dei link è attivata o disattivata.
Parametri
Nessun parametro.
Esempi
udp linksecurity
Enabled
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
udp aperto
Apri un socket UDP/IPv6.
Parametri
Nessun parametro.
Esempi
udp open
Done
Riferimenti a interfaccia a riga di comando e API
invio udp
Invia un messaggio UDP utilizzando il socket. Per ulteriori informazioni, 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 ne 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 trattato come testo. Se non viene inserito alcun valoretype
, anche il payload nel parametrovalue
viene considerato come testo.-s
: payload generato automaticamente con la lunghezza specificata nel parametrovalue
.-x
: dati binari in rappresentazione esadecimale indicati 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 a interfaccia a riga di comando e API
recupero non sicuro
Elenca tutte le porte presenti nell'elenco delle porte non protette consentite.
Parametri
Nessun parametro.
Esempi
unsecure get
1234
Done
Riferimenti a interfaccia a riga di comando e API
aggiunta non protetta
Aggiunge una porta all'elenco delle porte non protette consentite.
Parametri
unsecureport add port
Esempi
unsecureport add 1234
Done
Riferimenti a interfaccia a riga di comando e API
rimozione non protetta
Rimuove una porta specificata o tutte le porte dall'elenco delle porte non protette consentite.
Parametri
unsecureport remove port|all
Esempi
unsecureport remove 1234
Done
unsecureport remove all
Done
Riferimenti a interfaccia a riga di comando e API
tempo di attività in ms
Restituisce l'uptime attuale dell'istanza (in msec).
Richiede l'attivazione di OPENTHREAD_CONFIG_UPTIME_ENABLE
.
L'uptime viene espresso sotto forma di numero di millisecondi dall'inizializzazione dell'istanza OpenThread.
Parametri
Nessun parametro.
Esempi
uptime ms
426238
Done
Riferimenti a interfaccia a riga di comando e API
tempo di attività
Restituisce il tempo di attività attuale dell'istanza sotto forma di stringa leggibile.
Richiede l'attivazione di OPENTHREAD_CONFIG_UPTIME_ENABLE
.
La stringa ha il formato "
Se la stringa risultante non rientra in aBuffer
(all'interno dei suoi aSize
caratteri), la stringa verrà troncata, ma la stringa generata è sempre con terminazione null.
Parametri
Nessun parametro.
Esempi
uptime
12:46:35.469
Done
Riferimenti a interfaccia a riga di comando e API
appurl del fornitore (impostato)
Imposta la stringa dell'URL dell'app del fornitore.
Richiede OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
.
aVendorAppUrl
deve essere in formato 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 a interfaccia a riga di comando e API
URL applicazione fornitore
Recupera la stringa dell'URL dell'app del fornitore.
Parametri
Nessun parametro.
Esempi
vendor appurl
http://www.example.com
Done
Riferimenti a interfaccia a riga di comando e API
modello di fornitore (insieme)
Imposta la stringa del modello del fornitore.
Richiede OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
.
aVendorModel
deve essere in formato 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 a interfaccia a riga di comando e API
modello di fornitore
Recupera la stringa del modello del fornitore.
Parametri
Nessun parametro.
Esempi
vendor model
Hub Max
Done
Riferimenti a interfaccia a riga di comando e API
nome del fornitore (insieme)
Imposta la stringa del nome del fornitore.
Richiede OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
.
aVendorName
deve essere in formato 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 a interfaccia a riga di comando e API
nome del fornitore
Recupera la stringa del nome del fornitore.
Parametri
Nessun parametro.
Esempi
vendor name
nest
Done
Riferimenti a interfaccia a riga di comando e API
swversion del fornitore (set)
Imposta la stringa della versione del software del fornitore.
Richiede OPENTHREAD_CONFIG_NET_DIAG_VENDOR_INFO_SET_API_ENABLE
.
aVendorSwVersion
deve essere in formato 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 a interfaccia a riga di comando e API
versione fornitore
Recupera la stringa della versione del software del fornitore.
Parametri
Nessun parametro.
Esempi
vendor swversion
Marble3.5.1
Done
Riferimenti a interfaccia a riga di comando e 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 a interfaccia a riga di comando e API
convalidare verhoeff
Convalida il checksum Verhoeff per una determinata stringa decimale.
Richiede OPENTHREAD_CONFIG_VERHOEFF_CHECKSUM_ENABLE
.
Parametri
verhoeff validate decimalstring
Esempi
verhoeff validate 307318421
Done
Riferimenti a interfaccia a riga di comando e API
API versione
Stampa il numero di versione dell'API.
Parametri
Nessun parametro.
Esempi
version api
28
Done
Riferimenti a interfaccia a riga di comando e API
- Nessuna API associata
versione
Recupera la stringa di versione OpenThread.
Parametri
Nessun parametro.
Esempi
version
OPENTHREAD/gf4f2f04; Jul 1 2016 17:00:09
Done