Riferimento per i comandi dell'interfaccia a riga di comando

chiave temporanea ba

Indica se una chiave temporanea è attualmente attiva.

Richiede OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

Parametri

Nessun parametro.

Esempi

ba ephemeralkey
active
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderAgentIsEphemeralKeyActive

callback della chiave temporanea ba (abilita, disabilita)

Imposta la funzione di callback utilizzata dall'agente di confine per notificare eventuali modifiche relative all'utilizzo della chiave temporanea.

Richiede OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

Una chiamata successiva a questa funzione sostituirà qualsiasi callback impostato in precedenza.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderAgentSetEphemeralKeyCallback

chiave temporanea ba cancella

Annulla la chiave temporanea in uso.

Richiede OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

Può essere utilizzato per annullare una chiave temporanea impostata in precedenza prima che scada. Se l'agente di confine non è in esecuzione o non è in uso una chiave temporanea, la chiamata di questa funzione non ha alcun effetto.

Se un commissario è collegato utilizzando la chiave temporanea ed è attualmente attivo, la chiamata di questa funzione non ne modifica lo stato. In questo caso, otBorderAgentIsEphemeralKeyActive() continuerà a restituire TRUE fino a quando il comitato non si disconnetterà.

Parametri

Nessun parametro.

Esempi

ba ephemeralkey clear
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderAgentClearEphemeralKey

set di chiavi temporanee ba [timeout-in-msec] [porta]

Imposta la chiave temporanea per una determinata durata di timeout.

Richiede OPENTHREAD_CONFIG_BORDER_AGENT_EPHEMERAL_KEY_ENABLE.

La chiave temporanea può essere impostata quando l'agente di confine è già in esecuzione e al momento non è collegato ad alcun commissario esterno (ovvero è nello stato OT_BORDER_AGENT_STATE_STARTED). In caso contrario, viene restituito OT_ERROR_INVALID_STATE.

Il valore aKeyString specificato viene utilizzato direttamente come PSK temporanea (escluso il carattere \0 null finale). La lunghezza del campo aKeyString deve essere compresa tra OT_BORDER_AGENT_MIN_EPHEMERAL_KEY_LENGTH e OT_BORDER_AGENT_MAX_EPHEMERAL_KEY_LENGTH inclusi.

Se imposti di nuovo la chiave temporanea prima del timeout di una chiave impostata in precedenza, la chiave impostata in precedenza verrà sostituita e il timeout verrà reimpostato.

Mentre l'intervallo di timeout è attivo, la chiave temporanea può essere utilizzata una sola volta da un commissario esterno per connettersi. Quando il commissario si disconnette, la chiave temporanea viene cancellata e l'agente di confine torna a utilizzare PSKc.

Parametri

Nessun parametro.

Esempi

ba ephemeralkey set Z10X20g3J15w1000P60m16 5000 1234
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderAgentSetEphemeralKey

ID ba (get,set)

Ottiene o imposta l'ID router di confine di 16 byte che può identificare in modo univoco il dispositivo tra più BR.

Parametri

ba id [border-agent-id]

Utilizza l'argomento facoltativo border-agent-id per impostare l'ID agente di confine.

Esempi

ba id
cb6da1e0c0448aaec39fa90f3d58f45c
Done

ba id 00112233445566778899aabbccddeeff
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderAgentGetId
• otBorderAgentSetId

porta ba

Ottiene la porta UDP del servizio Agente di confine Thread.

Parametri

Nessun parametro.

Esempi

ba port
49153
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderAgentGetUdpPort

stato ba

Ottiene il valore otBorderAgentState del ruolo di Agente di confine Thread.

Parametri

Nessun parametro.

Esempi

ba state
Started
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderAgentGetState

bbr

Restituisce le informazioni correnti sul router backbone primario per il dispositivo Thread.

Parametri

Nessun parametro.

Esempi

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

bbr
BBR Primary: None
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

config bbr (set)

Imposta la configurazione del router backbone locale otBackboneRouterConfig.

Se il set di dati BBR viene modificato per il router backbone principale, viene avviato automaticamente un messaggio di richiesta dati del server SRV_DATA.ntf.

Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE è attivato.

bbr register deve essere emesso esplicitamente per registrare il servizio router backbone in Leader per il router backbone secondario.

Parametri

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

Esempi

bbr config seqno 20 delay 30
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBackboneRouterSetConfig

configurazione bbr

Ottiene la configurazione del router backbone locale.

Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE è attivato.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBackboneRouterGetConfig

bbr disattiva

Attiva o disattiva la funzionalità Backbone.

Se questa opzione è abilitata, viene attivato un messaggio di richiesta dati del server SRV_DATA.ntf per il dispositivo collegato se non è presente un servizio router backbone nei dati di rete Thread.

Se disattivato, SRV_DATA.ntf viene attivato se il router backbone è in stato principale.

Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE è attivato.

Parametri

Nessun parametro.

Esempi

bbr disable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBackboneRouterSetEnabled

bbr abilita

Attiva o disattiva la funzionalità Backbone.

Se questa opzione è abilitata, viene attivato un messaggio di richiesta dati del server SRV_DATA.ntf per il dispositivo collegato se non è presente un servizio router backbone nei dati di rete Thread.

Se disattivato, SRV_DATA.ntf viene attivato se il router backbone è in stato principale.

Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE è attivato.

Parametri

Nessun parametro.

Esempi

bbr enable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBackboneRouterSetEnabled

tremolio bbr (get,set)

Consente di acquisire o impostare il jitter (in secondi) per la registrazione del router backbone.

Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE è attivato.

Parametri

bbr jitter [jitter]

Esempi

bbr jitter
20
Done

bbr jitter 10
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBackboneRouterGetRegistrationJitter
• otBackboneRouterSetRegistrationJitter

bbr mgmt dua

Con l'inclusione di meshLocalIid, questo comando configura lo stato della risposta per la successiva registrazione DUA. Senza meshLocalIid, rispondi al successivo DUA.req con il valore status o coap-code specificato.

Disponibile quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE è attivato.

Parametri

bbr mgmt dua status|coap-code [meshLocalIid]

Per status o coap-code, usa:

• 0: ST_DUA_SUCCESS
• 1: ST_DUA_REREGISTER
• 2: ST_DUA_INVALID
• 3: ST_DUA_DUPLICATE
• 4: ST_DUA_NO_RESOURCES
• 5: ST_DUA_BBR_NOT_PRIMARY
• 6: ST_DUA_GENERAL_FAILURE
• 160: COAP codice 5.00

Esempi

bbr mgmt dua 1 2f7c235e5025a2fd
Done

bbr mgmt dua 160
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBackboneRouterConfigNextDuaRegistrationResponse

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 i criteri OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE e OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE sono abilitati.

Parametri

bbr mgmt mlr listener add ipaddress [timeout-seconds]

Esempi

bbr mgmt mlr listener add ff04::1
Done

bbr mgmt mlr listener add ff04::2 300
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBackboneRouterMulticastListenerAdd

listener bbr mgmt mlr

Restituisce i listener multicast con otBackboneRouterMulticastListenerInfomTimeout in secondi.

Disponibile quando i criteri OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE e OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE sono attivati.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBackboneRouterMulticastListenerGetNext

bbr mgmt mlr ascoltatore chiaro

Cancella i listener multicast.

Disponibile quando i criteri OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE e OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE sono abilitati.

Parametri

Nessun parametro.

Esempi

bbr mgmt mlr listener clear
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBackboneRouterMulticastListenerClear

bbr mgmt risposta mlr

Configura lo stato della risposta per la successiva registrazione del listener multicast.

Disponibile quando i criteri OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE, OPENTHREAD_CONFIG_BACKBONE_ROUTER_MULTICAST_ROUTING_ENABLE e OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE sono abilitati.

Parametri

bbr mgmt mlr response status-code

Per status-code, usa:

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

Esempi

bbr mgmt mlr response 2
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBackboneRouterConfigNextMulticastListenerRegistrationResponse

registro bbr

Registra esplicitamente la configurazione del router backbone locale.

Viene attivato un messaggio di richiesta dati del server SRV_DATA.ntf per il dispositivo collegato.

Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE è attivato.

Parametri

Nessun parametro.

Esempi

bbr register
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBackboneRouterRegister

stato bbr

Ottiene il router backbone otBackboneRouterState.

Disponibile quando OPENTHREAD_CONFIG_BACKBONE_ROUTER_ENABLE è attivato.

Parametri

Nessun parametro.

Esempi

bbr state
Disabled
Done

bbr state
Primary
Done

bbr state
Secondary
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBackboneRouterGetState

br disattiva

Disattiva Border Routing Manager.

Parametri

Nessun parametro.

Esempi

br disable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingSetEnabled

br abilita

Attiva il Border Routing Manager.

Parametri

Nessun parametro.

Esempi

br enable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingSetEnabled

br init

Inizializza il Border Routing Manager.

Parametri

br init infrastructure-network-index is-running

Esempi

br init 2 1
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingInit

prefisso br nat64

Restituisce sia i prefissi NAT64 locali che quelli preferiti.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingGetNat64Prefix
• otBorderRoutingGetFavoredNat64Prefix

prefisso br nat64 preferito

Ottiene il prefisso NAT64 attualmente preferito.

Il prefisso NAT64 preferito può essere rilevato dal link dell'infrastruttura o può essere il prefisso NAT64 locale di questo dispositivo.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingGetFavoredNat64Prefix

prefisso br nat64 locale

Ottiene il prefisso NAT64 locale del router di confine.

Il prefisso NAT64 potrebbe non essere pubblicizzato nella rete Thread.

OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE deve essere abilitato.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingGetNat64Prefix

br omrprefisso

Restituisce sia il prefisso OMR locale sia quello preferito.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingGetOmrPrefix
• otBorderRoutingGetFavoredOmrPrefix

br omrprefisso preferito

Ottieni il prefisso OMR (Off-Mesh-Routable) attualmente preferito.

Il prefisso OMR preferito può essere rilevato dai dati di rete o può essere il prefisso OMR locale di questo dispositivo.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingGetFavoredOmrPrefix

br omrprefix locale

Ottiene il prefisso locale Fuori mesh (OMR), ad esempio fdfc:1ff5:1512:5622::/64.

Un prefisso OMR è un prefisso a 64 bit generato casualmente che viene pubblicato nella rete Thread se non esiste già un prefisso OMR. Questo prefisso può essere raggiunto dalla rete Wi-Fi o Ethernet locale.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingGetOmrPrefix

br onlinkprefisso

Restituisce sia i prefissi all'interno del link sia quelli preferiti.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingGetOnLinkPrefix
• otBorderRoutingGetFavoredOnLinkPrefix

prefisso br onlink preferito

Ottiene il prefisso on-link preferito al momento.

Il prefisso preferito è un prefisso all'interno del link rilevato sul link dell'infrastruttura o il prefisso locale del link.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingGetFavoredOnLinkPrefix

br onlinkprefix locale

Ottiene il prefisso on-link locale per il collegamento dell'infrastruttura adiacente.

Il prefisso locale sul link è un prefisso a 64 bit pubblicizzato sul link dell'infrastruttura se non è già stato pubblicizzato un prefisso sul link utilizzabile sul link.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingGetOnLinkPrefix

br pd (attiva,disattiva)

Attiva / disattiva la delega del prefisso DHCPv6.

OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE deve essere abilitato.

Parametri

br pd enable|disable

Esempi

br pd enable
Done

br pd disable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingDhcp6PdSetEnabled

br pd omrprefisso

Restituisce il prefisso OMS (off-mesh-routable) fornito dalla delega di prefisso (PD) DHCPv6.

Nelle informazioni restituite per il prefisso vengono utilizzati solo i campi mPrefix, mValidLifetime e mPreferredLifetime.

OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE deve essere abilitato.

Parametri

Nessun parametro.

Esempi

br pd omrprefix
2001:db8:cafe:0:0/64 lifetime:1800 preferred:1800
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingGetPdOmrPrefix

stato br pd

Restituisce lo stato attuale della delega del prefisso DHCPv6.

Richiede l'attivazione di OPENTHREAD_CONFIG_BORDER_ROUTING_DHCP6_PD_ENABLE.

Parametri

Nessun parametro.

Esempi

br pd state
running
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingDhcp6PdGetState

br compagni

Recupera l'elenco dei BR peer trovati nelle voci di dati di rete. Il campo OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE è obbligatorio. I BR peer sono altri dispositivi all'interno del mesh Thread che forniscono connettività IP esterna. Un dispositivo viene considerato come dotato di connettività IP esterno se viene soddisfatta almeno una delle seguenti condizioni relative alle voci di dati di rete:

• È stata aggiunta almeno una voce di percorso esterna.
• Ha aggiunto almeno una voce di prefisso con i flag default-route e on-mesh impostati.
• Ha aggiunto almeno un prefisso di dominio (con i flag dominio e su mesh impostati). L'elenco di BR peer esclude in modo specifico il dispositivo attuale, anche se agisce a sua volta come un BR. Informazioni per voce in Brasile:
• RLOC16 del Brasile
• Età come intervallo di durata dall'inizio della visualizzazione di questo valore nei dati di rete. Il formato è {hh}:{mm}:{ss} per ore, minuti, secondi, se la durata è inferiore a 24 ore. Se la durata è di 24 ore o più, il formato è {dd}d.{hh}:{mm}:{ss} per giorni, ore, minuti e secondi.

Parametri

Nessun parametro.

Esempi

br peers
rloc16:0x5c00 age:00:00:49
rloc16:0xf800 age:00:01:51
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingGetNextPrefixTableEntry

conteggio dei compagni br

Restituisce il numero di BR peer trovati nei dati di rete.

Richiede OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE.

I BR peer sono altri dispositivi all'interno del mesh Thread che forniscono connettività IP esterna. Un dispositivo viene considerato come dotato di connettività IP esterno se viene soddisfatta almeno una delle seguenti condizioni relative alle voci di dati di rete:

• È stata aggiunta almeno una voce di percorso esterna.
• Ha aggiunto almeno una voce di prefisso con i flag default-route e on-mesh impostati.
• Ha aggiunto almeno un prefisso di dominio (con i flag dominio e su mesh impostati).

L'elenco di BR peer esclude in modo specifico il dispositivo attuale, anche se a sua volta funge da BR.

Parametri

Nessun parametro.

Esempi

br peers count
2 min-age:00:00:47
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingCountPeerBrs

br prefisso

Recupera i prefissi rilevati da Border Routing Manager sul collegamento dell'infrastruttura. Informazioni per voce di prefisso:

• Il prefisso
• Se il prefisso è "on-link" o "instradato"
• Millisecondi dall'ultima ricezione di un annuncio del router contenente questo prefisso
• Durata del prefisso in secondi
• Durata preferita in secondi solo se il prefisso è al link
• Preferenza di percorso (bassa, media, alta) solo se il prefisso è route (non sul link)
• L'indirizzo IPv6 del router che pubblicizza questo prefisso
• Flag nell'intestazione Pubblicità router ricevuto:
  • M: flag per la configurazione degli indirizzi gestiti
  • O: flag di configurazione diverso
  • Stub: flag router Stub (indica se il router è un router stub)

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingGetNextPrefixTableEntry

br raoptions (imposta,cancella)

Consente di impostare opzioni aggiuntive da aggiungere alla fine dei messaggi pubblicitari router (RA) emessi.

Il contenuto di aOptions viene copiato internamente, quindi può essere un buffer temporaneo (ad es. un array allo stack).

Le chiamate successive a questa funzione sovrascrivono il valore impostato in precedenza.

Parametri

br raoptions options|clear

br raoptions clear passa un nullptr a otBorderRoutingSetExtraRouterAdvertOptions. In caso contrario, puoi passare il byte options come dati esadecimale.

Esempi

br raoptions 0400ff00020001
Done

br raoptions clear
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingSetExtraRouterAdvertOptions

br rioprf (alto,medio,basso)

Imposta in modo esplicito la preferenza da utilizzare quando vengono pubblicizzate Opzioni info percorso (RIO) nei messaggi pubblicitari router inviati tramite il link dell'infrastruttura.

Dopo una chiamata a questa funzione, BR utilizza la preferenza specificata per tutti i RIO pubblicizzati. La preferenza può essere cancellata chiamando il numero otBorderRoutingClearRouteInfoOptionPreference() .

Parametri

br rioprf [high|med|low]

Esempi

br rioprf low
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingSetRouteInfoOptionPreference

br rioprf

Consente di acquisire la preferenza corrente utilizzata per pubblicizzare le opzioni RIO (Route Info Settings) nei messaggi pubblicitari del router inviati tramite il link dell'infrastruttura.

La preferenza RIO è determinata come segue:

• Se viene impostata esplicitamente dall'utente chiamando otBorderRoutingSetRouteInfoOptionPreference(), viene utilizzata la preferenza specificata.
• In caso contrario, viene determinato in base al ruolo attuale del dispositivo: preferenza media nel ruolo router/leader e bassa preferenza nel ruolo secondario.

Parametri

Nessun parametro.

Esempi

br rioprf
med
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingGetRouteInfoOptionPreference

br rioprf chiaro

Cancella un valore di preferenza impostato in precedenza per le opzioni di informazioni percorso annunciate.

Dopo una chiamata a questa funzione, il Brasile utilizzerà il ruolo del dispositivo per determinare la preferenza RIO: preferenza media nel ruolo router/leader e bassa preferenza nel ruolo figlio.

Parametri

Nessun parametro.

Esempi

br rioprf clear
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingClearRouteInfoOptionPreference

br routeprf (alto,medio,basso)

Imposta in modo esplicito la preferenza per le route pubblicate in Dati di rete.

Dopo una chiamata a questa funzione, BR utilizzerà la preferenza specificata. La preferenza può essere cancellata chiamando il numero otBorderRoutingClearRoutePreference() .

Parametri

br routeprf [high|med|low]

Esempi

br routeprf low
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingSetRoutePreference

br routeprf

Consente di acquisire la preferenza corrente utilizzata per le route pubblicate in Dati di rete.

La preferenza viene determinata come segue:

• Se viene impostata esplicitamente dall'utente chiamando otBorderRoutingSetRoutePreference(), viene utilizzata la preferenza specificata.
• In caso contrario, viene determinato automaticamente da RoutingManager in base al ruolo del dispositivo e alla qualità del link.

Parametri

Nessun parametro.

Esempi

br routeprf
med
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingGetRoutePreference

br routeprf cancella

Consente di cancellare un valore di preferenza impostato in precedenza per le route pubblicate in Dati di rete.

Dopo una chiamata a questa funzione, BR determinerà automaticamente la preferenza in base al ruolo del dispositivo e alla qualità del collegamento (al genitore quando agisce come dispositivo finale).

Parametri

Nessun parametro.

Esempi

br routeprf clear
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingClearRoutePreference

router br

Recupera l'elenco dei router rilevati da Border Routing Manager sul link dell'infrastruttura. Informazioni per router:

• L'indirizzo IPv6 del router
• Flag nell'intestazione Pubblicità router ricevuto:
  • M: flag per la configurazione degli indirizzi gestiti
  • O: flag di configurazione diverso
  • Stub: flag router Stub (indica se il router è un router stub)
• Millisecondi dall'ultima ricezione di questo messaggio da questo router
• Flag di raggiungibilità: un router viene contrassegnato come non raggiungibile se non risponde a più probe di richieste vicine.
• Età: intervallo di durata dal primo rilevamento del router. Il formato è {hh}:{mm}:{ss} per ore, minuti, secondi, se la durata è inferiore a 24 ore. Se la durata è di 24 ore o più, il formato è {dd}d.{hh}:{mm}:{ss} per giorni, ore, minuti e secondi.
• (this BR) viene aggiunto quando il router è il dispositivo locale stesso.
• (peer BR) viene aggiunto quando è probabile che il router sia un BR peer connesso allo stesso mesh Thread. Richiede OPENTHREAD_CONFIG_BORDER_ROUTING_TRACK_PEER_BR_INFO_ENABLE.

Parametri

Nessun parametro.

Esempi

br routers
ff02:0:0:0:0:0:0:1 (M:0 O:0 Stub:1) ms-since-rx:1505 reachable:yes age:00:18:13
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingGetNextRouterEntry

stato br

Recupera lo stato attuale di Border Routing Manager.

Parametri

Nessun parametro.

Esempi

br state
running

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRoutingGetState

bufferinfo

Recupera le informazioni correnti sul buffer dei messaggi.

• total visualizza il numero totale di buffer dei messaggi nel pool.
• free mostra il numero di buffer dei messaggi liberi.
• max-used visualizza il numero massimo di buffer utilizzati contemporaneamente dall'inizializzazione dello stack OT o dall'ultima bufferinfo reset.

Successivamente, l'interfaccia a riga di comando mostra le informazioni sulle diverse code utilizzate dallo stack OpenThread, ad esempio 6lo send. Ogni riga dopo la coda rappresenta le informazioni relative a una coda:

• Il primo numero mostra i messaggi numerici in coda.
• Il secondo numero indica il numero di buffer utilizzati da tutti i messaggi in coda.
• Il terzo numero indica il numero totale di byte di tutti i messaggi in coda.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otMessageGetBufferInfo

reimpostazione bufferinfo

Reimposta il contatore di informazioni del buffer dei messaggi tenendo traccia del numero massimo di buffer in uso contemporaneamente.

Questa operazione reimposta mMaxUsedBuffers in otBufferInfo .

Parametri

Nessun parametro.

Esempi

bufferinfo reset
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otMessageResetBufferInfo

ccathreshold (get,set)

Ottieni o imposta la soglia CCA in dBm misurata al connettore dell'antenna in base allo standard IEEE 802.15.4 - 2015 sezione 10.1.4.

Parametri

ccathreshold [CCA-threshold-dBm]

Utilizza l'argomento facoltativo CCA-threshold-dBm per impostare la soglia CCA.

Esempi

ccathreshold
-75 dBm
Done

ccathreshold -62
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otPlatRadioGetCcaEnergyDetectThreshold
• otPlatRadioSetCcaEnergyDetectThreshold

canale (get,set)

Consente di acquisire o impostare il valore del canale IEEE 802.15.4.

Parametri

channel [channel-num]

Usa channel-num per impostare il canale.

Esempi

channel
11
Done

channel 11
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

gestione canali automatica

Attiva o disattiva la funzionalità di selezione automatica del canale per il canale di rete.

Quando 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 per l'interfaccia a riga di comando e le API

• otChannelManagerSetAutoChannelSelectionEnabled

modifica al gestore del canale

Consente di richiedere una modifica del canale della rete Thread.

La rete passa al canale specificato dopo un determinato ritardo (vedi otChannelManagerSetDelay()). La modifica del canale viene eseguita aggiornando il set di dati operativo in attesa.

Una chiamata successiva annullerà una modifica del canale già richiesta in precedenza.

Il campo OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE è obbligatorio.

Parametri

channel manager change channel-num

Esempi

channel manager change 11
channel manager change 11
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otChannelManagerRequestChannelChange

gestore del canale

Ottieni lo stato del gestore del canale. È obbligatorio specificare OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE o OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otChannelManagerGetRequestedChannel

ritardo del gestore del canale

Imposta il ritardo (in secondi) utilizzato per un cambio di canale di rete.

Disponibile solo per i FTD. Preferibilmente, il ritardo dovrebbe essere maggiore dell'intervallo massimo di polling dei dati utilizzato da tutti i dispositivi finali Sleepy all'interno della rete Thread.

I campi OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE e OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE sono obbligatori.

Parametri

channel manager delay delay-seconds

Esempi

channel manager delay 120
channel manager delay 120
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otChannelManagerSetDelay

gestore del canale preferito

Imposta la maschera del canale preferito.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE o OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE e OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE sono obbligatori.

Parametri

channel manager favored mask

Esempi

channel manager favored 0x7fffc00
channel manager favored 0x7fffc00
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otChannelManagerSetFavoredChannels

intervallo del gestore del canale

Imposta l'intervallo (in secondi) utilizzato dalla funzionalità di selezione automatica del canale.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE o OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE e OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE sono obbligatori.

Parametri

channel manager interval interval-seconds

Esempi

channel manager interval 10800
channel manager interval 10800
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otChannelManagerSetAutoChannelSelectionInterval

selezione gestore del canale

Richieste che ChannelManager controlli e selezioni un nuovo canale e avvii una modifica del canale.

A differenza di otChannelManagerRequestChannelChange() in cui il canale deve essere indicato come parametro, questa funzione chiede al ChannelManager di selezionare autonomamente un canale (in base alle informazioni sulla qualità del canale raccolte).

Una volta chiamato, il gestore del canale eseguirà i seguenti 3 passaggi:

1) ChannelManager decide se il cambio di canale sarebbe utile. Questo controllo può essere ignorato se il criterio aSkipQualityCheck è impostato su true (forzando la selezione di un canale e saltando il controllo qualità). Questo passaggio utilizza le metriche di qualità dei link raccolte sul dispositivo (come il tasso di errore CCA, i tassi di errore di frame e messaggi per vicino e così via) per determinare se la qualità attuale del canale è al livello che giustifica un cambiamento di canale.

2) Se il primo passaggio va a buon fine, ChannelManager selezionerà un canale potenzialmente migliore. Utilizza i dati sulla qualità del canale raccolti dal modulo ChannelMonitor. In questa fase vengono utilizzati i canali supportati e preferiti. (vedi otChannelManagerSetSupportedChannels() e otChannelManagerSetFavoredChannels() ).

3) Se il canale appena selezionato è diverso dal canale corrente, ChannelManager richiede/avvia la procedura di modifica del canale (richiamando internamente un RequestChannelChange()).

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE o OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE e OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE sono obbligatori.

Parametri

channel manager select skip-quality-check

Utilizza 1 o 0 per il valore booleano skip-quality-check.

Esempi

channel manager select 1
channel manager select 1
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otChannelManagerRequestChannelSelect

gestore del canale supportato

Imposta la maschera del canale supportata.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE o OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE e OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE sono obbligatori.

Parametri

channel manager supported mask

Esempi

channel manager supported 0x7fffc00
channel manager supported 0x7fffc00
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otChannelManagerSetSupportedChannels

soglia del gestore del canale

Imposta la soglia del tasso di errore CCA.

OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE o OPENTHREAD_CONFIG_MAC_CSL_RECEIVER_ENABLE && OPENTHREAD_CONFIG_CHANNEL_MANAGER_CSL_CHANNEL_SELECT_ENABLE e OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE sono obbligatori.

Parametri

channel manager threshold threshold-percent

Utilizza un valore esadecimale per threshold-percent. 0 mappa allo 0% e 0xffff al 100%.

Esempi

channel manager threshold 0xffff
channel manager threshold 0xffff
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otChannelManagerSetCcaFailureRateThreshold

monitoraggio del canale

Ottieni lo stato attuale del monitoraggio del canale e l'occupazione dei canali. Il campo OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE è obbligatorio.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

avvio monitoraggio canale

Avvia il monitoraggio del canale. L'interfaccia a riga di comando OT invia un valore booleano di true a otChannelMonitorSetEnabled. Il campo OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE è obbligatorio.

Parametri

Nessun parametro.

Esempi

channel monitor start
channel monitor start
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otChannelMonitorSetEnabled

interruzione del monitoraggio del canale

Interrompi il monitoraggio del canale. L'interfaccia a riga di comando OT invia un valore booleano di false a otChannelMonitorSetEnabled. Il campo OPENTHREAD_CONFIG_CHANNEL_MONITOR_ENABLE è obbligatorio.

Parametri

Nessun parametro.

Esempi

channel monitor stop
channel monitor stop
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otChannelMonitorSetEnabled

preferito per il canale

Consente di ottenere la maschera di canale preferita per la radio su cui il dispositivo preferisce formarsi.

Parametri

Nessun parametro.

Esempi

channel preferred
0x7fff800
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otPlatRadioGetPreferredChannelMask

canale supportato

Ottieni la maschera del canale supportata dalle radio su cui è consentito l'uso del dispositivo.

Parametri

Nessun parametro.

Esempi

channel supported
0x7fff800
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otPlatRadioGetSupportedChannelMask

figlio (ID)

Recupera le informazioni diagnostiche relative a un account secondario collegato in base al relativo ID figlio o RLOC16.

Parametri

child child-id

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetChildInfoById

elenco secondario

Restituisce un elenco di ID secondari allegati.

Parametri

Nessun parametro.

Esempi

child list
1 2 3 6 7 8
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetChildInfoByIndex

tabella secondaria

Stampa una tabella degli elementi secondari allegati.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetChildInfoByIndex

infantile

Ottiene un elenco di indirizzi IP archiviati per i bambini MTD.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetChildNextIp6Address

valore figlio massimo (impostato)

Consente di impostare o ripristinare il numero massimo di indirizzi IP che ogni MTD secondario può registrare con questo dispositivo come padre.

Passa 0 per cancellare l'impostazione e ripristinare quella predefinita.

Disponibile quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE è attivato.

Parametri

childip max count

Esempi

childip max 2
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetMaxChildIpAddresses

massimo figlio

Restituisce il numero massimo di indirizzi IP che ogni MTD secondario può registrare con questo dispositivo come padre.

Parametri

Nessun parametro.

Esempi

childip max
4
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetMaxChildIpAddresses

figlio max (impostato)

Consente di impostare il numero massimo di elementi secondari attualmente consentiti.

Questo parametro può essere impostato solo quando l'operazione del protocollo Thread è stata interrotta.

Parametri

childmax count

Esempi

childmax 2
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetMaxAllowedChildren

max. figlio

Consente di acquisire il numero massimo di elementi secondari attualmente consentiti.

Parametri

Nessun parametro.

Esempi

childmax
5
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetMaxAllowedChildren

link figlio-router (get,set)

Ottiene o imposta il valore MLE_CHILD_ROUTER_LINKS.

Parametri

childrouterlinks [links]

Esempi

childrouterlinks
16
Done

childrouterlinks 16
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetChildRouterLinks
• otThreadSetChildRouterLinks

checktimeout supervisione bambino (impostato)

Imposta l'intervallo di timeout dei controlli della supervisione (in secondi) per il bambino.

Parametri

childsupervision checktimeout timeout-seconds

Esempi

childsupervision checktimeout 30
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otChildSupervisionSetCheckTimeout

checktimeout supervisione bambini

Consente di acquisire l'intervallo di timeout dei controlli della supervisione (in secondi) sul bambino.

Se il dispositivo è un bambino assonnato e non riceve una risposta dal genitore entro il timeout di controllo specificato, avvia il processo di ricollegamento (scambio di richiesta/risposta di aggiornamento del figlio MLE con il genitore).

Parametri

Nessun parametro.

Esempi

childsupervision checktimeout
30
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otChildSupervisionGetCheckTimeout

intervallo supervisione figlio (impostato)

Consente di impostare l'intervallo di supervisione (in secondi) del bambino.

Parametri

childsupervision interval interval-seconds

Esempi

childsupervision interval 30
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otChildSupervisionSetInterval

intervallo supervisione bambino

Restituisce l'intervallo di supervisione dei minori (in secondi) su un bambino.

La funzionalità Supervisione dei bambini offre ai genitori un meccanismo per assicurarsi che ogni bambino assonnato venga inviato un messaggio nell'intervallo di supervisione. Se non avviene alcuna trasmissione al bambino entro l'intervallo di supervisione, OpenThread mette in coda e invia un messaggio relativo alla supervisione del bambino.

Parametri

Nessun parametro.

Esempi

childsupervision interval
30
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otChildSupervisionGetInterval

timeout secondario (impostato)

Imposta il timeout (in secondi) del thread secondario del thread utilizzato quando operi nel ruolo secondario.

Parametri

childtimeout timeout-seconds

Esempi

childtimeout 300
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetChildTimeout

timeout figlio

Restituisce il timeout (in secondi) del thread secondario del thread utilizzato quando utilizzi il ruolo secondario.

Parametri

Nessun parametro.

Esempi

childtimeout
300
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetChildTimeout

annulla coap

Annulla una sottoscrizione di osservazione esistente a una risorsa remota sul server CoAP.

Parametri

Nessun parametro.

Esempi

coap cancel
Done

Riferimenti per l'interfaccia a riga di comando e le API

• osservare

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: confermabile
  • non-con: non confermabile (valore predefinito)
• payload: la stringa del payload CoAP. Ad esempio, hellothere.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

coap get

Recupera informazioni sulla risorsa CoAP specificata sul server CoAP.

Parametri

coap get address uri-path [type]

• address: indirizzo IPv6 del server CoAP.
• uri-path: percorso URI della risorsa.
• type:
  • con: confermabile
  • non-con: non confermabile (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 o block-1024.

Esempi

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

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

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

coap osserva

Attiva una richiesta di abbonamento che consente al client CoAP di osservare la risorsa specificata sul server CoAP al fine di verificare eventuali modifiche dello stato.

Parametri

coap observe address uri-path [type]

• address: indirizzo IPv6 del server CoAP.
• uri-path: percorso URI della risorsa.
• type:
  • con: confermabile
  • non-con: non confermabile (impostazione predefinita).

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

parametri coap(get,set)

Recupera i valori parametro CoAP correnti se il comando viene eseguito senza parametri facoltativi.

Imposta i parametri CoAP sui valori predefiniti o sui valori specificati, a seconda della sintassi scelta.

Parametri

coap parameters type [default | ack_timeout ack_random_factor_numerator ack_random_factor_denominator max_retransmit]

• type: request per le richieste CoAP o response per le risposte CoAP. Se non vengono forniti altri parametri, il comando visualizza la configurazione corrente.
• default: imposta i parametri di trasmissione sui seguenti valori predefiniti:
  • ack_timeout: 2000 millisecondi
  • ack_random_factor_numerator: 3
  • ack_random_factor_denominator: 2
  • max_retransmit: 4
• ack_timeout: ACK_TIMEOUT (0-UINT32_MAX) in millisecondi. Fai riferimento a RFC7252.
• ack_random_factor_numerator: il numeratore ACK_RANDOM_FACTOR, con possibili valori compresi tra 0 e 255. Fai riferimento a RFC7252.
• ack_random_factor_denominator: il denominatore ACK_RANDOM_FACTOR, con valori possibili compresi tra 0 e 255. Fai riferimento a RFC7252.
• max_retransmit: MAX_RETRANSMIT (0-255). Fai riferimento a RFC7252.

Esempi

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

coap parameters request default
Transmission parameters for request:
default
Done

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

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

post coap

Crea la risorsa CoAP specificata. Per saperne di più, consulta Testare la connettività a una risorsa CoAP (Constrained Application Protocol) utilizzando l'interfaccia a riga di comando OT.

Parametri

coap post address uri-path [type] [payload]

• address: indirizzo IPv6 del server CoAP.
• uri-path: percorso URI della risorsa.
• type:
  • con: confermabile
  • non-con: non confermabile (valore predefinito)
  • block-: utilizza questa opzione, seguita dal valore a blocchi, per inviare blocchi con un numero generato casualmente di byte per il payload. I valori validi sono: block-16, block-32, block-64, block-128, block-256, block-512 o block-1024.
• payload: richiesta di payload CoAP, che, se utilizzata, è una stringa o un numero intero, a seconda di type. Se type è con o non-con, il parametro payload è facoltativo. Se non specifichi il parametro payload, viene inviato un payload vuoto. Tuttavia, se utilizzi il parametro payload, il valore deve essere una stringa, ad esempio hellothere. Se type è block-, il valore del parametro payload deve essere un numero intero che specifica il numero di blocchi da inviare. Il tipo di block- richiede l'impostazione di OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE.

Esempi

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

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

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

coap putt

Modifica la risorsa CoAP specificata. Per saperne di più, consulta Testare la connettività a una risorsa CoAP (Constrained Application Protocol) utilizzando l'interfaccia a riga di comando OT.

Parametri

coap put address uri-path [type] [payload]

• address: indirizzo IPv6 del server CoAP.
• uri-path: percorso URI della risorsa.
• type:
  • con: confermabile
  • non-con: non confermabile (valore predefinito)
  • block-: utilizza questa opzione, seguita dal valore a blocchi, per inviare blocchi con un numero generato casualmente di byte per il payload. I valori validi sono: block-16, block-32, block-64, block-128, block-256, block-512 o block-1024.
• payload: richiesta di payload CoAP, che, se utilizzata, è una stringa o un numero intero, a seconda di type. Se type è con o non-con, il parametro payload è facoltativo. Se non specifichi il parametro payload, viene inviato un payload vuoto. Tuttavia, se utilizzi il parametro payload, il valore deve essere una stringa, ad esempio hellothere. Se type è block-, il valore del parametro payload deve essere un numero intero che specifica il numero di blocchi da inviare. Il tipo di block- richiede l'impostazione di OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE.

Esempi

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

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

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

risorsa coap (get,set)

Ottiene o imposta il percorso dell'URI della risorsa del server CoAP.

Parametri

coap resource [uri-path]

Esempi

coap resource test-resource
Done

coap resource
test-resource
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCoapAddResource
• otCoapAddBlockWiseResource

coap set

Imposta i contenuti inviati dalla risorsa sul server CoAP. Se un client CoAP sta osservando la risorsa, gli viene inviata una notifica.

Parametri

coap set new-content

Esempi

coap set Testing123
Done

Riferimenti per l'interfaccia a riga di comando e le API

• osservare
• otCoapMessageInit
• otCoapNewMessage

inizio coap

Avvia il server CoAP. Per saperne di più, consulta Testare la connettività a una risorsa CoAP (Constrained Application Protocol) utilizzando l'interfaccia a riga di comando OT.

Parametri

Nessun parametro.

Esempi

coap start
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCoapStart

coap stop

Arresta il server CoAP.

Parametri

Nessun parametro.

Esempi

coap stop
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCoapStop

Coaps Connect

Inizializza una sessione DTLS (Datagram Transport Layer Security) con un peer. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.

Parametri

coaps connect address

Il parametro address è l'indirizzo IPv6 del peer.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otCoapSecureConnect

eliminazione coaps

La stringa del payload CoAPS da eliminare.

Parametri

coaps delete uri-path [type] [payload]

• uri-path: percorso URI della risorsa.
• type:
  • con: confermabile
  • non-con: non confermabile (valore predefinito)
• payload: richiesta di payload CoAPS.

Esempi

coaps delete test-resource con hellothere
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

coaps disconnessione

Interrompe la sessione DTLS.

Parametri

Nessun parametro.

Esempi

coaps disconnect
coaps disconnected
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCoapSecureDisconnect

i poliziotti prendono

Recupera informazioni sulla risorsa CoAPS specificata sul server CoAPS. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.

Parametri

coaps get uri-path [type]

• uri-path: percorso URI della risorsa.
• type:
  • con: confermabile
  • non-con: non confermabile (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 o block-1024.

Esempi

coaps get test-resource
Done

coaps get test-resource block-1024
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

coaps ischiudi

Indica se il servizio CoAP Secure è chiuso. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.

Parametri

Nessun parametro.

Esempi

coaps isclosed
no
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCoapSecureIsClosed

coaps non è attivo

Indica se la connessione al servizio CoAP Secure è attiva (già connessa o in fase di connessione). Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.

Parametri

Nessun parametro.

Esempi

coaps isconnactive
yes
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCoapSecureIsConnectionActive

coaps è connesso

Indica se il servizio CoAP Secure è connesso. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.

Parametri

Nessun parametro.

Esempi

coaps isconnected
yes
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCoapSecureIsConnected

post coaps

Crea la risorsa CoAPS specificata. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.

Parametri

uri-path [type] [payload]

• uri-path: percorso URI della risorsa.
• type:
  • con: confermabile
  • non-con: non confermabile (valore predefinito)
  • block-: utilizza questa opzione, seguita dal valore a blocchi, per inviare blocchi con un numero generato casualmente di byte per il payload. I valori validi sono: block-16, block-32, block-64, block-128, block-256, block-512 o block-1024.
• payload: richiesta di payload CoAPS che, se utilizzata, è una stringa o un numero intero, a seconda di type. Se type è con o non-con, il parametro del payload è facoltativo. Se il parametro payload viene tralasciato, viene inviato un payload vuoto. Tuttavia, se utilizzi il parametro payload, il suo valore deve essere una stringa, ad esempio hellothere. Se type è block-, il valore del parametro payload deve essere un numero intero che specifica il numero di blocchi da inviare. Il tipo di block- richiede l'impostazione di OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE.

Esempi

coaps post test-resource con hellothere
Done

coaps post test-resource block-1024 10
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

coaps psk

Imposta la chiave precondivisa (PSK) e il pacchetto di crittografia DTLS_PSK_WITH_AES_128_CCM_8.

Parametri

coaps psk psk-value psk-id

• psk-value: la chiave precondivisa
• psk-id: l'identificatore della chiave precondivisa.

Esempi

coaps psk 1234 key1
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCoapSecureSetPsk

coaps put

Modifica la risorsa CoAPS specificata. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.

Parametri

uri-path [type] [payload]

• uri-path: percorso URI della risorsa.
• type:
  • con: confermabile
  • non-con: non confermabile (valore predefinito)
  • block-: utilizza questa opzione, seguita dal valore a blocchi, per inviare blocchi con un numero generato casualmente di byte per il payload. I valori validi sono: block-16, block-32, block-64, block-128, block-256, block-512 o block-1024.
• payload: richiesta di payload CoAPS che, se utilizzata, è una stringa o un numero intero, a seconda di type. Se type è con o non-con, il parametro del payload è facoltativo. Se il parametro payload viene tralasciato, viene inviato un payload vuoto. Tuttavia, se utilizzi il parametro payload, il suo valore deve essere una stringa, ad esempio hellothere. Se type è block-, il valore del parametro payload deve essere un numero intero che specifica il numero di blocchi da inviare. Il tipo di block- richiede l'impostazione di OPENTHREAD_CONFIG_COAP_BLOCKWISE_TRANSFER_ENABLE.

Esempi

coaps put test-resource con hellothere
Done

coaps put test-resource block-1024 10
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

risorsa coaps (get,set)

Ottiene o imposta il percorso dell'URI della risorsa del server CoAPS. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.

Parametri

coaps resource [uri-path]

Esempi

coaps resource test-resource
Done

coaps resource
test-resource
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCoapSecureAddBlockWiseResource

coaps impostati

Imposta i contenuti inviati dalla risorsa sul server CoAPS. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.

Parametri

coaps set new-content

Esempi

coaps set Testing123
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

inizio coaps

Avvia il servizio CoAP Secure. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.

Parametri

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

Il parametro check-peer-cert determina se il controllo del certificato peer è attivato (impostazione predefinita) o disattivato. Il parametro max-conn-attempts imposta il numero massimo di tentativi consentiti, riusciti o non, per la connessione al server sicuro CoAP. Il valore predefinito di questo parametro è 0, il che significa che non esiste un limite al numero di tentativi. I parametri check-peer-cert e max-conn-attempts funzionano insieme nelle seguenti combinazioni, anche se puoi specificare un solo argomento:

• Nessun argomento specificato: vengono utilizzati i valori predefiniti.
• Impostando check-peer-cert su true: ha lo stesso effetto dell'omissione dell'argomento, ovvero il valore check-peer-cert è true e il valore max-conn-attempts è 0.
• Se imposti check-peer-cert su false: il valore di check-peer-cert è false, mentre il valore di max-conn-attempts è 0.
• Specificare un numero: check-peer-cert è true, mentre il valore max-conn-attempts è il numero specificato nell'argomento.

Esempi

coaps start
Done

coaps start false
Done

coaps start 8
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCoapSecureStart
• otCoapSecureSetSslAuthMode
• otCoapSecureSetClientConnectedCallback

coaps stop

Arresta il servizio CoAP Secure. Per saperne di più, consulta Testare la connettività a una risorsa CoAPS (Constrained Application Protocol Secure) utilizzando l'interfaccia a riga di comando OT.

Parametri

Nessun parametro.

Esempi

coaps stop
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCoapSecureStop

coaps x509

Imposta il certificato X509 del dispositivo locale con la chiave privata corrispondente per la sessione DTLS con DTLS_ECDHE_ECDSA_WITH_AES_128_CCM_8.

Parametri

Nessun parametro.

Esempi

coaps x509
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCoapSecureSetCertificate
• otCoapSecureSetCaCertificateChain

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 MLE Announce.
• count: numero di trasmissioni MLE Announce per canale.
• period: numero di millisecondi tra trasmissioni Announce MLE successive.
• destination: indirizzo IPv6 di destinazione per il messaggio. Il messaggio potrebbe essere multicast.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• avvio da parte del commisser
• otCommissionerAnnounceBegin

energia del commissario

Invia un messaggio Query sulla scansione dei consumi energetici. L'output del comando viene stampato quando viene ricevuto.

Parametri

commissioner energy mask count period scanDuration destination

• mask: maschera di bit che identifica i canali per eseguire le scansioni dell'energia secondo lo standard IEEE 802.15.4.
• count: numero di scansioni dell'energia secondo lo standard IEEE 802.15.4 per canale.
• period: numero di millisecondi tra scansioni successive dell'energia secondo lo standard IEEE 802.15.4.
• scanDuration: durata della scansione in millisecondi da utilizzare durante una scansione energetica IEEE 802.15.4.
• destination: indirizzo IPv6 di destinazione per il messaggio. Il messaggio potrebbe essere multicast.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• avvio da parte del commisser
• otCommissionerEnergyScan

ID commissario (get,set)

Ottiene o imposta il nome ID OpenThread Commissioner.

Parametri

commissioner id name

Esempi

commissioner id OpenThread Commissioner
Done

commissioner id
OpenThread Commissioner
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCommissionerSetId

aggiunta commissario joiner

Aggiunge una voce del joiner.

Parametri

commissioner joiner add eui64|discerner pksd [timeout]

• eui64: IEEE EUI-64 del Joiner. Per trovare una corrispondenza con qualsiasi membro, usa *.
• discerner: l'indice Joiner nel formato number/length.
• pksd: chiave precondivisa per il joiner.
• timeout: il timeout del joiner in secondi.

Esempi

commissioner joiner add d45e64fa83f81cf7 J01NME
Done

commissioner joiner add 0xabc/12 J01NME
Done

Riferimenti per l'interfaccia a riga di comando e le API

• avvio da parte del commisser
• otCommissionerAddJoiner
• otCommissionerAddJoinerWithDiscerner

rimozione commissioner joiner

Rimuove una voce Joiner.

Parametri

commissioner joiner remove eui64|discerner

• eui64: IEEE EUI-64 dell'abbonato. Per trovare una corrispondenza con qualsiasi membro, usa *.
• discerner: l'indice del joiner nel formato number/length.

Esempi

commissioner joiner remove d45e64fa83f81cf7
Done

commissioner joiner remove 0xabc/12
Done

Riferimenti per l'interfaccia a riga di comando e le API

• avvio da parte del commisser
• otCommissionerRemoveJoiner
• otCommissionerRemoveJoinerWithDiscerner

tabella commissario joiner

Elenca tutte le voci Joiner in formato tabella.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

gestione del commissario

Invia un messaggio MGMT_GET (Management Get) al leader. Vengono restituiti i valori della variabile impostati utilizzando il comando commissioner mgmtset.

Parametri

commissioner mgmtget [locator] [sessionid] [steeringdata] [joinerudpport] [-x TLVs]

• locator: router di confine RLOC16.
• sessionid: ID sessione del Commissioner.
• steeringdata: dati sull'indirizzamento.
• joinerudpport: porta UDP del joiner.
• TLVs: l'insieme di TLV da recuperare.

Esempi

commissioner mgmtget locator sessionid
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCommissionerSendMgmtGet

gestione del commissario

Invia un messaggio MGMT_SET (set di gestione) al leader e imposta le variabili sui valori specificati.

Parametri

commissioner mgmtset [locator locator] [sessionid sessionid] [steeringdata steeringdata] [joinerudpport joinerudpport] [-x TLVs]

• locator: router di confine RLOC16.
• sessionid: ID sessione del Commissioner.
• steeringdata: dati sull'indirizzamento.
• joinerudpport: porta UDP del joiner.
• TLVs: l'insieme di TLV da recuperare.

Esempi

commissioner mgmtset joinerudpport 9988
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCommissionerSendMgmtSet

commissario panid

Invia una query sull'ID PAN. L'output comando viene restituito quando viene ricevuto.

Parametri

commissioner panid panid mask destination

• paind: ID PAN da utilizzare per verificare la presenza di conflitti.
• mask; Maschera di bit che identifica i canali per eseguire scansioni attive IEEE 802.15.4.
• destination: indirizzo di destinazione IPv6 per il messaggio. Il messaggio potrebbe essere multicast.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• avvio da parte del commisser
• otCommissionerPanIdQuery

URL provisioning commissario

Imposta l'URL di provisioning del Commissioner.

Parametri

commissioner provisioningurl provisioningurl

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otCommissionerSetProvisioningUrl

commissario Richiedi

Ottiene l'ID sessione attuale di Commissioner.

Parametri

Nessun parametro.

Esempi

commissioner sessionid
0
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCommissionerGetSessionId

inizio commissario

Avvia il ruolo Thread Commissioner.

Parametri

Nessun parametro.

Esempi

commissioner start
Commissioner: petitioning
Done
Commissioner: active

Riferimenti per l'interfaccia a riga di comando e le API

• otCommissionerStart

stato commissario

Restituisce lo stato attuale del Commissioner. I valori possibili sono active, disabled o petition (che presenta la petizione per diventare Commissioner).

Parametri

Nessun parametro.

Esempi

commissioner state
active
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCommissionerState

fermata del commissario

Interrompe il ruolo Thread Commissioner.

Parametri

Nessun parametro.

Esempi

commissioner stop
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otCommissionerStop

contestoreutilizzato (get,set)

Consente di acquisire o impostare il valore CONTEXT_ID_REUSE_DELAY.

Parametri

contextreusedelay delay

Utilizza l'argomento facoltativo delay per impostare CONTEXT_ID_REUSE_DELAY.

Esempi

contextreusedelay
11
Done

contextreusedelay 11
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetContextIdReuseDelay
• otThreadSetContextIdReuseDelay

contatori (mac)

Ottieni i contatori degli strati MAC.

Parametri

counters mac

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkGetCounters

contatori (mle)

Ottiene i contatori di Thread MLE.

Parametri

counters mle

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetMleCounters

contatori

Ottiene i nomi dei contatori supportati.

Parametri

Nessun parametro.

Esempi

counters
ip
mac
mle
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

IP contatori

Ottiene i contatori IPv6.

Parametri

counters ip

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetIp6Counters

contatori ip reimpostati

Reimposta i contatori IPv6.

Parametri

counters ip reset

Esempi

counters ip reset
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadResetIp6Counters

contatori MAC reset

Reimposta i contatori del livello MAC.

Parametri

counters mac reset

Esempi

counters mac reset
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkResetCounters

reimpostazione dei contatori

Reimposta i contatori di Thread MLE.

Parametri

counters mle reset

Esempi

counters mle reset
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadResetMleCounters

canale CSS

Imposta il canale CSL.

Parametri

csl channel channel

Esempi

csl channel 20
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkSetCslChannel

CSS

Recupera la configurazione CSL.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkGetCslChannel
• otLinkGetCslPeriod
• otLinkGetCslPeriod
• otLinkGetCslTimeout

periodo CSS

Imposta il periodo CSL in microsecondi.

Disabilita CSL impostando questo parametro su 0.

Il periodo CSL DEVE essere un multiplo di OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC, altrimenti viene restituito OT_ERROR_INVALID_ARGS.

Parametri

csl period period

Esempi

csl period 3000000
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkSetCslPeriod

timeout csl

Imposta il timeout CSL in secondi.

Parametri

csl timeout timeout

Esempi

cls timeout 10
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkSetCslTimeout

set di dati attivo

Recupera il set di dati operativo attivo.

L'interfaccia a riga di comando OT utilizza i membri otOperationalDataset per restituire i valori del set di dati alla console.

Parametri

dataset active [-x]

L'argomento facoltativo -x stampa i valori del set di dati operativo attivo come TLV con codifica esadecimale.

Esempi

dataset active
Active Timestamp: 1
Channel: 13
Channel Mask: 0x07fff800
Ext PAN ID: d63e8e3e495ebbc3
Mesh Local Prefix: fd3d:b50b:f96d:722d::/64
Network Key: dfd34f0f05cad978ec4e32b0413038ff
Network Name: OpenThread-8f28
PAN ID: 0x8f28
PSKc: c23a76e98f1a6483639b1ac1271e2e27
Security Policy: 0, onrcb
Done

dataset active -x
0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otDatasetGetActive

set di dati activetimestamp (get, set)

Ottiene o imposta otOperationalDataset::mActiveTimestamp.

Parametri

dataset activetimestamp [timestamp]

Trasmetti l'argomento facoltativo timestamp per impostare il timestamp attivo.

Esempi

dataset activetimestamp
123456789
Done

dataset activetimestamp 123456789
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

canale del set di dati (get,set)

Ottiene o imposta otOperationalDataset::mChannel.

Parametri

dataset channel [channel-num]

Utilizza l'argomento facoltativo channel-num per impostare il canale.

Esempi

dataset channel
12
Done

dataset channel 12
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

maschera di canale del set di dati (get,set)

Ottiene o imposta otOperationalDataset::mChannelMask

Parametri

dataset channelmask [channel-mask]

Utilizza l'argomento facoltativo channel-mask per impostare la maschera del canale.

Esempi

dataset channelmask
0x07fff800
Done

dataset channelmask 0x07fff800
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

cancellazione set di dati

Reimposta il buffer del set di dati operativo.

Parametri

Nessun parametro.

Esempi

dataset clear
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

commit del set di dati attivo

Esegui il commit del buffer del set di dati operativo in set di dati operativo attivo.

Parametri

Nessun parametro.

Esempi

dataset commit active
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Commit del set di dati in attesa
• otDatasetSetPending

commit del set di dati in attesa

Esegui il commit del buffer del set di dati operativo in set di dati operativo in attesa.

Parametri

Nessun parametro.

Esempi

dataset commit pending
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Commit del set di dati attivo
• otDatasetSetActive

ritardo del set di dati (get,set)

Ottiene o imposta otOperationalDataset::mDelay.

Parametri

dataset delay [delay]

Utilizza l'argomento facoltativo delay per impostare il valore del timer di ritardo.

Esempi

dataset delay
1000
Done

dataset delay 1000
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otDatasetSetDelayTimerMinimal

extpanid del set di dati (get,set)

Ottiene o imposta otOperationalDataset::mExtendedPanId.

Parametri

dataset extpanid [extpanid]

Utilizza l'argomento facoltativo extpanid per impostare l'ID Extended Personal Area Network.

Esempi

dataset extpanid
000db80123456789
Done

dataset extpanid 000db80123456789
Done

Riferimenti per l'interfaccia a riga di comando e le API

• set di dati pskc (get,set)

guida per il set di dati

Recupera un elenco di comandi dell'interfaccia a riga di comando dataset. Per saperne di più, consulta Visualizzare e gestire i set di dati con l'interfaccia a riga di comando OT.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

init set di dati (active,new,pending,tlvs)

L'interfaccia a riga di comando OT controlla active, pending o tlvs e restituisce i valori corrispondenti. Altrimenti, l'interfaccia a riga di comando OT crea una nuova rete casuale e restituisce un nuovo set di dati.

Parametri

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

Usa new per inizializzare un nuovo set di dati, quindi inserisci il comando dataset commit active. Utilizza tlvs per i TLV con codifica esadecimale.

Esempi

dataset init new
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Commit del set di dati attivo
• set di dati attivo

set di dati meshlocalprefix (get,set)

Ottiene o imposta otOperationalDataset::mMeshLocalPrefix.

Parametri

dataset meshlocalprefix [meshlocalprefix]

Utilizza l'argomento facoltativo meshlocalprefix per impostare il prefisso mesh-locale.

Esempi

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

dataset meshlocalprefix fd00:db8:0:0::
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

comando gestione set di dati attivo

Invia MGMT_ACTIVE_GET.

L'interfaccia a riga di comando OT invia un messaggio MGMT_ACTIVE_GET con gli argomenti pertinenti. Per scoprire di più su questi parametri e sulle mappature degli argomenti, consulta Visualizzare e gestire i set di dati con l'interfaccia a riga di comando OT.

Parametri

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

• Usa address per specificare la destinazione IPv6. altrimenti viene usato come predefinito l'ALOC leader.
• Per dataset-components, puoi passare qualsiasi combinazione di otOperationalDatasetComponents, ad esempio activetimestamp, pendingtimestamp o networkkey.
• L'argomento facoltativo -x specifica i TLV non elaborati da richiedere.

Esempi

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

dataset mgmtgetcommand active networkname
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otDatasetSendMgmtActiveGet
• comando gestione set di dati in attesa
• comando gestione set di dati attivo
• comando mgmtsetset di dati in attesa

set di comandi mgmtgetcommand in attesa

Invia MGMT_PENDING_GET.

Parametri

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

Per scoprire di più su questi parametri e sulle mappature degli argomenti, consulta Visualizzare e gestire i set di dati con l'interfaccia a riga di comando OT.

Esempi

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

dataset mgmtgetcommand pending networkname
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otDatasetSendMgmtPendingGet
• comando gestione set di dati attivo
• comando gestione set di dati attivo
• comando mgmtsetset di dati in attesa

Comando gestione set di dati attivo

Invia MGMT_ACTIVE_SET.

Parametri

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

Per scoprire di più su questi parametri e sulle mappature degli argomenti, consulta Visualizzare e gestire i set di dati con l'interfaccia a riga di comando OT.

Esempi

dataset mgmtsetcommand active activetimestamp 123 securitypolicy 1 onrcb
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otDatasetSendMgmtActiveSet
• comando gestione set di dati attivo
• comando gestione set di dati in attesa
• comando mgmtsetset di dati in attesa

comando mgmtsetset set di dati in attesa

Invia MGMT_PENDING_SET.

Parametri

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

Per scoprire di più su questi parametri e sulle mappature degli argomenti, consulta Visualizzare e gestire i set di dati con l'interfaccia a riga di comando OT.

Esempi

dataset mgmtsetcommand pending activetimestamp 123 securitypolicy 1 onrcb
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otDatasetSendMgmtPendingSet
• comando gestione set di dati attivo
• comando gestione set di dati in attesa
• comando gestione set di dati attivo

chiave di rete del set di dati (get,set)

Ottiene o imposta otOperationalDataset::mNetworkKey.

Parametri

dataset networkkey [key]

Utilizza l'argomento facoltativo key per impostare la chiave di rete.

Esempi

dataset networkkey
00112233445566778899aabbccddeeff
Done

dataset networkkey 00112233445566778899aabbccddeeff
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

nome rete del set di dati (get,set)

Ottiene o imposta otOperationalDataset::mNetworkName.

Parametri

dataset networkname [name]

Utilizza l'argomento facoltativo name per impostare il nome della rete.

Esempi

dataset networkname
OpenThread
Done

dataset networkname OpenThread
Done

Riferimenti per l'interfaccia a riga di comando e le API

• set di dati pskc (get,set)

panid set di dati (get,set)

Ottiene o imposta otOperationalDataset::mPanId.

Parametri

dataset panid [panid]

Utilizza l'argomento facoltativo panid per impostare l'ID PAN.

Esempi

dataset panid
0x1234
Done

dataset panid 0x1234
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

set di dati in attesa (get,set)

Ottiene o imposta otOperationalDataset::mPendingTimestamp.

Parametri

dataset pendingtimestamp [timestamp]

Utilizza l'argomento facoltativo timestamp per impostare i secondi del timestamp in attesa.

Esempi

dataset pendingtimestamp
123456789
Done

dataset pendingtimestamp 123456789
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

dataset pskc (get,set)

Ottiene o imposta otOperationalDataset::mPskc.

Parametri

dataset pskc [-p passphrase] | [key]

Solo per FTD, utilizza -p con l'argomento passphrase. -p genera un codice pskc a partire dalla codifica passphrase UTF-8 che fornisci, insieme al nome della rete e all'ID PAN esteso. Se impostato, -p utilizza il buffer del set di dati. altrimenti utilizza lo stack attuale. In alternativa, puoi impostare pskc come key (formato esadecimale).

Esempi

dataset pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done

dataset pskc -p 123456
Done

dataset pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

criterio di sicurezza del set di dati (get,set)

Consente di acquisire o impostare il criterio di sicurezza del set di dati.

Parametri

dataset securitypolicy [rotationtime [onrcCepR]]

• Utilizza rotationtime per thrKeyRotation, in unità di ore.
• I comandi del criterio di sicurezza utilizzano le mappature di argomento onrcCepR per recuperare e impostare i membri otSecurityPolicy, ad esempio o rappresenta otSecurityPolicy::mObtainNetworkKeyEnabled. Per saperne di più, consulta Visualizzare e gestire i set di dati con l'interfaccia a riga di comando OT.

Esempi

dataset securitypolicy
672 onrc
Done

dataset securitypolicy 672 onrc
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

set di dati impostato (attivo,in attesa)

Imposta il set di dati operativo attivo.

Se il set di dati non include un timestamp attivo, significa che è completato solo parzialmente.

Se Thread è abilitato su un dispositivo che ha un set di dati attivo parzialmente completo, il dispositivo tenterà di collegarsi a una rete Thread esistente utilizzando qualsiasi informazione esistente nel set di dati. Per il collegamento a una rete è necessaria solo la chiave di rete Thread.

Se il canale non è incluso nel set di dati, il dispositivo invierà messaggi di annuncio MLE su canali diversi per trovare vicini su altri canali.

Se il dispositivo si collega correttamente a una rete Thread, il dispositivo recupererà l'intero set di dati attivo dalla rete principale. Tieni presente che un dispositivo compatibile con il router non passerà ai ruoli Router o Leader finché non avrà un set di dati attivo completo.

Questa funzione restituisce costantemente OT_ERROR_NONE e può essere trattata come se avesse un tipo restituito void. In precedenza, altri errori (ad es. OT_ERROR_NOT_IMPLEMENTED) sono state consentite per motivi precedenti. Tuttavia, poiché l'archiviazione permanente è ora obbligatoria per le operazioni Thread, qualsiasi errore di salvataggio del set di dati attiverà un'asserzione. Il tipo restituito otError viene conservato per compatibilità con le versioni precedenti.

Il comando dataset set dell'interfaccia a riga di comando imposta il set di dati operativo attivo utilizzando TLV con codifica esadecimale.

Parametri

dataset set {active|pending} tlvs

Esempi

dataset set active 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done

dataset set pending 0e08000000000001000000030000103506000...3023d82c841eff0e68db86f35740c030000ff
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otDatasetSetActive

tlv del set di dati

Converte un determinato set di dati operativo in otOperationalDatasetTlvs .

Parametri

Nessun parametro.

Esempi

dataset tlvs
0e080000000000010000000300001635060004001fffe0020...f7f8
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otDatasetConvertToTlvs

annulla aggiornamento set di dati

Annulla una richiesta di aggiornamento del set di dati operativo in corso (se presente).

Disponibile quando OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE è attivato.

Parametri

Nessun parametro.

Esempi

@dataset updater cancel
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otDatasetUpdaterCancelUpdate

strumento di aggiornamento set di dati

Indica se è in corso una richiesta di aggiornamento del set di dati dell'operazione.

Disponibile quando OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE è attivato.

Parametri

Nessun parametro.

Esempi

dataset updater
Enabled
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otDatasetUpdaterIsUpdateOngoing

avvio programma di aggiornamento set di dati

Richiedi un aggiornamento del set di dati operativo.

Disponibile quando OPENTHREAD_CONFIG_DATASET_UPDATER_ENABLE è attivato.

aDataset deve contenere i campi da aggiornare e il relativo nuovo valore. Non deve contenere campi Timestamp attivi o in attesa. Il campo Delay è facoltativo. Se non viene fornito un valore predefinito (1000 ms), viene utilizzato il valore predefinito.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otDatasetUpdaterRequestUpdate

debug

Esegue una serie di comandi dell'interfaccia a riga di comando per raccogliere informazioni sul dispositivo e sulla rete di thread. Questa funzionalità è destinata al debug. L'output mostrerà ogni comando dell'interfaccia a riga di comando eseguito preceduto da $, seguito dall'output generato del comando corrispondente. L'output generato include le seguenti informazioni:

• Versione
• Stato attuale
• RLOC16, indirizzo MAC esteso
• Elenco di indirizzi IPv6 Unicast e multicast
• Canale
• ID PAN e ID PAN esteso
• Dati di rete
• ID partizione
• Dati leader

Se il dispositivo funziona come FTD:

• Tabella del publisher secondario e del vicino
• Informazioni sulla tabella router e sull'hop successivo
• Tabella della cache degli indirizzi
• Indirizzo IPv6 secondario MTD registrato
• Proprietà dispositivo

Se il dispositivo supporta e agisce come client SRP:

• Stato client SRP
• Informazioni sull'host e sui servizi client SRP

Se il dispositivo supporta e funge da server SRP:

• Modalità indirizzo e stato del server SRP
• Host e servizi registrati del server SRP

Se il dispositivo supporta TREL:

• Stato TREL e tabella delle app peer

Se il dispositivo supporta e funge da router di confine:

• Stato BR
• Prefissi BR (OMR, on-link, NAT64)
• Tabella dei prefissi rilevati

Parametri

Nessun parametro.

Esempi

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

scheduletimermin (impostato)

Imposta il timer per il ritardo minimo (in secondi).

Parametri

delaytimermin delaytimermin

Esempi

delaytimermin 60
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otDatasetSetDelayTimerMinimal

ritardo

Ottieni il timer con il ritardo minimo (in secondi).

Parametri

Nessun parametro.

Esempi

delaytimermin
30
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otDatasetGetDelayTimerMinimal

scollega asincrono

Avvia il processo di scollegamento controllato, simile al comando detach, senza bloccare e attendere il callback che indica che il scollegamento è terminato.

Parametri

Nessun parametro.

Esempi

detach async
Done

Riferimenti per l'interfaccia a riga di comando e le API

• scollega
• otThreadDetachGracefully

detach

Avvia il processo di scollegamento controllato inviando prima una notifica agli altri nodi (inviando una release dell'indirizzo se agisci come router o impostando il valore di Timeout secondario su zero per l'elemento padre se agisci come figlio), quindi interrompendo l'operazione del protocollo Thread.

Parametri

Nessun parametro.

Esempi

detach
Finished detaching
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadDetachGracefully

deviceprops (insieme)

Consente di impostare le proprietà del dispositivo.

Parametri

deviceprops powerSupply isBr supportsCcm isUnstable weightAdjustment

powerSupply: dovrebbe essere "battery", "external", "external-stable", "external-unstable".

Esempi

deviceprops battery 0 0 0 -5
Done

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

Riferimenti per l'interfaccia a riga di comando e le API

• peso leader
• leaderweight (set)
• otThreadSetDeviceProperties

deviceprops

Visualizza le proprietà attuali del dispositivo.

Richiede OPENTHREAD_CONFIG_MLE_DEVICE_PROPERTY_LEADER_WEIGHT_ENABLE.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetDeviceProperties

Discover

Eseguire un'operazione di rilevamento MLE.

Parametri

discover [channel]

channel: il canale da scoprire. Se non viene fornito alcun canale, la scoperta coprirà tutti i canali validi.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadDiscover

scopri reqcallback (attiva,disattiva)

Imposta un callback per ricevere i dati delle richieste di rilevamento MLE.

Parametri

discover reqcallback enable|disable

Esempi

discover reqcallback enable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetDiscoveryRequestCallback

navigazione DNS

Invia una query DNS di esplorazione (enumerazione delle istanze di servizio) per ottenere l'elenco dei servizi per un determinato nome di servizio

I parametri dopo service-name sono facoltativi. Qualsiasi valore non specificato (o zero) per questi parametri facoltativi viene sostituito dal valore della configurazione predefinita corrente (dns config).

Parametri

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

Esempi

dns browse _service._udp.example.com
DNS browse response for _service._udp.example.com.
inst1
    Port:1234, Priority:1, Weight:2, TTL:7200
    Host:host.example.com.
    HostAddress:fd00:0:0:0:0:0:0:abcd TTL:7200
    TXT:[a=6531, b=6c12] TTL:7300
instance2
    Port:1234, Priority:1, Weight:2, TTL:7200
    Host:host.example.com.
    HostAddress:fd00:0:0:0:0:0:0:abcd TTL:7200
    TXT:[a=1234] TTL:7300
Done

dns browse _airplay._tcp.default.service.arpa
DNS browse response for _airplay._tcp.default.service.arpa.
Mac mini
    Port:7000, Priority:0, Weight:0, TTL:10
    Host:Mac-mini.default.service.arpa.
    HostAddress:fd97:739d:386a:1:1c2e:d83c:fcbe:9cf4 TTL:10
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otDnsClientBrowse

compressione dns (abilita,disabilita)

Imposta il valore di "compressione dei nomi DNS" .

Per impostazione predefinita, la compressione dei nomi DNS è abilitata. Se questa opzione è disattivata, i nomi DNS vengono aggiunti come completi e mai compressi. Questo è applicabile ai moduli client/server DNS e SRP di OpenThread." Il campo OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE è obbligatorio.

Parametri

dns compression [enable|disable]

Esempi

dns compression enable
Enabled

dns compression disable
Done
dns compression
Disabled
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otDnsSetNameCompressionEnabled

compressione DNS

Indica se il valore di "compressione nome DNS" attiva o meno.

Questa funzionalità è destinata solo ai test ed è disponibile quando la configurazione di OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE è abilitata.

Per impostazione predefinita, la compressione dei nomi DNS è abilitata. Se questa opzione è disattivata, i nomi DNS vengono aggiunti come completi e mai compressi. Questo è applicabile ai moduli client/server DNS e SRP di OpenThread." Il campo OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE è obbligatorio.

Parametri

dns compression [enable|disable]

Esempi

dns compression
Enabled

Riferimenti per l'interfaccia a riga di comando e le API

• otDnsIsNameCompressionEnabled

configurazione DNS (set)

Imposta la configurazione predefinita delle query sul client DNS.

In un valore aConfig non NULL, il chiamante può scegliere di lasciare non specificati alcuni dei campi dell'istanza otDnsQueryConfig (valore zero). I campi non specificati vengono sostituiti dalle definizioni delle opzioni di configurazione OT corrispondenti OPENTHREAD_CONFIG_DNS_CLIENTDEFAULT{} per formare la configurazione delle query predefinita.

Quando la funzionalità OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_ADDRESS_AUTO_SET_ENABLE è abilitata, l'indirizzo IPv6 del server nella configurazione predefinita viene impostato e aggiornato automaticamente dal client DNS. Questo viene fatto solo se l'utente non lo imposta o non lo specifica esplicitamente. Questo comportamento richiede l'attivazione del client SRP e della relativa funzionalità di avvio automatico. Il client SRP monitorerà quindi i dati di rete Thread per le voci del servizio DNS/SRP per selezionare un server SRP. L'indirizzo del server SRP selezionato viene anche impostato come indirizzo del server DNS nella configurazione predefinita.

Possiamo lasciare alcuni campi come non specificati (o utilizzare il valore zero). I campi non specificati vengono sostituiti dalle definizioni delle opzioni di configurazione OT corrispondenti OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT per formare la configurazione delle query predefinita. Il campo OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE è obbligatorio.

Parametri

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

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 per l'interfaccia a riga di comando e le API

• otDnsClientSetDefaultConfig

configurazione DNS

Recupera l'attuale configurazione predefinita delle query utilizzata dal client DNS.

All'avvio dello stack OpenThread, la configurazione predefinita delle query DNS viene determinata in base a un insieme di opzioni di configurazione OT quali OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_IP6_ADDRESS, _DEFAULT_SERVER_PORT, _DEFAULT_RESPONSE_TIMEOUT e così via (vedi config/dns_client.h per tutte le opzioni di configurazione correlate).

La configurazione include indirizzo e porta IPv6 del server, timeout della risposta in msec (tempo di attesa per la risposta rx), massimo tentativi tx prima dell'errore di segnalazione, flag booleano per indicare se il server può risolvere la query in modo ricorsivo o meno. Il campo OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE è obbligatorio.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otDnsClientGetDefaultConfig

risoluzione DNS

Invia una query DNS per la risoluzione degli indirizzi per i record AAAA (IPv6) di un determinato nome host.

aConfig può essere NULL. In questo caso, la configurazione predefinita (da otDnsClientGetDefaultConfig() ) verrà utilizzata come configurazione per questa query. In un valore aConfig non NULL, alcuni campi possono essere lasciati non specificati (valore zero). I campi non specificati vengono quindi sostituiti dai valori della configurazione predefinita.

Invia una query DNS per ottenere l'indirizzo IPv6 per il nome host specificato.

I parametri dopo il nome host sono facoltativi. I valori non specificati (o zero) di questi parametri facoltativi vengono sostituiti dal valore della configurazione predefinita corrente (config dns).

L'indirizzo IP del server DNS può essere un indirizzo IPv4, che verrà sintetizzato in un indirizzo IPv6 utilizzando il prefisso NAT64 preferito dai dati di rete.

Parametri

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

Esempi

dns resolve ipv6.google.com
DNS response for ipv6.google.com - 2a00:1450:401b:801:0:0:0:200e TTL: 300

dns resolve example.com 8.8.8.8
Synthesized IPv6 DNS server address: fdde:ad00:beef:2:0:0:808:808
DNS response for example.com. - fd4c:9574:3720:2:0:0:5db8:d822 TTL:20456
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otDnsClientResolveAddress

servizio DNS

Avvia la risoluzione di un'istanza di servizio DNS per una determinata istanza di servizio.

È disponibile quando OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE è attivato.

aConfig può essere NULL. In questo caso, la configurazione predefinita (da otDnsClientGetDefaultConfig() ) verrà utilizzata come configurazione per questa query. In un valore aConfig non NULL, alcuni campi possono essere lasciati non specificati (valore zero). I campi non specificati vengono quindi sostituiti dai valori della configurazione predefinita.

La funzione invia query per i record SRV e/o TXT per l'istanza di servizio specificata. Il campo mServiceMode in otDnsQueryConfig determina quali record eseguire la query (solo SRV, solo TXT o sia SRV e TXT) e come eseguire la query (insieme nello stesso messaggio, separatamente, in parallelo o in modalità ottimizzata in cui il client cercherà prima lo stesso messaggio e poi separatamente se non riesce a ricevere una risposta).

Il record SRV fornisce informazioni su porta, priorità e peso del servizio insieme al nome host associato all'istanza di servizio. Questa funzione NON esegue la risoluzione dell'indirizzo per il nome host rilevato dal record SRV. Il server/risoltore potrebbe fornire record AAAA/A per il nome host nella sezione Dati aggiuntivi della risposta alla query SRV/TXT. Queste informazioni possono essere recuperate utilizzando otDnsServiceResponseGetServiceInfo() in otDnsServiceCallback. Gli utenti di questa API NON DEVONO dare per scontato che l'indirizzo host sia sempre disponibile da otDnsServiceResponseGetServiceInfo() .

Invia una query DNS sulla risoluzione dell'istanza di servizio per una determinata istanza di servizio. Viene fornita prima l'etichetta dell'istanza di servizio, seguita dal nome del servizio (tieni presente che l'etichetta dell'istanza di servizio può contenere il punto ".").

I parametri dopo service-name sono facoltativi. Qualsiasi valore non specificato (o zero) per questi parametri facoltativi viene sostituito dal valore della configurazione predefinita corrente (dns config).

Parametri

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

Esempi

Riferimenti per l'interfaccia a riga di comando e le API

• otDnsClientResolveService

servizio DNS

Avvia una risoluzione dell'istanza di servizio DNS per una determinata istanza di servizio, con una potenziale risoluzione dell'indirizzo di follow-up per il nome host rilevato per l'istanza di servizio.

È disponibile quando OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE è attivato.

aConfig può essere NULL. In questo caso, la configurazione predefinita (da otDnsClientGetDefaultConfig() ) verrà utilizzata come configurazione per questa query. In un valore aConfig non NULL, alcuni campi possono essere lasciati non specificati (valore zero). I campi non specificati vengono quindi sostituiti dai valori della configurazione predefinita. Questa funzione non può essere utilizzata con l'elemento mServiceMode nella configurazione DNS impostato su OT_DNS_SERVICE_MODE_TXT (ovvero, viene eseguita una query solo per il record TXT) e restituirà OT_ERROR_INVALID_ARGS.

Ha un comportamento simile all'invio di query per i record SRV e TXT da parte di otDnsClientResolveService() . Tuttavia, se il server/risoltore non fornisce record AAAA/A per il nome host nella risposta alla query SRV (nella sezione Dati aggiuntivi), eseguirà la risoluzione del nome host (invio di una query AAAA) per il nome host rilevato dal record SRV. Il callback aCallback viene richiamato quando vengono ricevute le risposte a tutte le query (ad es. al termine delle risoluzioni del servizio e degli indirizzi host).

Invia una query DNS sulla risoluzione dell'istanza di servizio per una determinata istanza di servizio con potenziale risoluzione del nome host di follow-up. Viene fornita prima l'etichetta dell'istanza di servizio, seguita dal nome del servizio (tieni presente che l'etichetta dell'istanza di servizio può contenere il punto ".").

I parametri dopo service-name sono facoltativi. Qualsiasi valore non specificato (o zero) per questi parametri facoltativi viene sostituito dal valore della configurazione predefinita corrente (dns config).

Parametri

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

Esempi

Riferimenti per l'interfaccia a riga di comando e le API

• otDnsClientResolveServiceAndHostAddress

nomedominio (insieme)

Imposta il nome di dominio del thread.

L'operazione riesce solo quando i protocolli Thread sono disabilitati.

Parametri

domainname name

Usa un backslash per uscire dagli spazi.

Esempi

domainname Test\ Thread
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetDomainName

nomedominio

Ottiene il nome di dominio del thread.

Parametri

Nessun parametro.

Esempi

domainname
Thread
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetDomainName

dua iid (set,cancella)

Imposta o cancella l'identificatore di interfaccia specificato manualmente per l'indirizzo Unicast del dominio Thread.

Disponibile quando OPENTHREAD_CONFIG_DUA_ENABLE è attivato.

Parametri

dua iid iid|clear

dua iid clear passa un valore nullptr a otThreadSetFixedDuaInterfaceIdentifier. In caso contrario, puoi passare l'iid.

Esempi

dua iid 0004000300020001
Done

dua iid clear
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetFixedDuaInterfaceIdentifier

dua iid

Ottiene l'identificatore di interfaccia specificato manualmente per l'indirizzo Unicast del dominio Thread.

Disponibile quando OPENTHREAD_CONFIG_DUA_ENABLE è attivato.

Parametri

Nessun parametro.

Esempi

dua iid
0004000300020001
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetFixedDuaInterfaceIdentifier

eidcache

Restituisce le voci della cache EID-to-RLOC.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetNextCacheEntry

eui64

Ottiene lo standard IEEE EUI-64 assegnato di fabbrica per questa interfaccia.

Parametri

Nessun parametro.

Esempi

eui64
0615aae900124b00
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otPlatRadioGetIeeeEui64

extaddr (set)

Imposta l'indirizzo esteso IEEE 802.15.4.

Parametri

extaddr extaddr

Esempi

extaddr dead00beef00cafe
dead00beef00cafe
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkSetExtendedAddress

estensore

Ottiene l'indirizzo esteso IEEE 802.15.4.

Parametri

Nessun parametro.

Esempi

extaddr
dead00beef00cafe
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkGetExtendedAddress

extpanid (insieme)

Imposta l'ID PAN esteso IEEE 802.15.4.

Parametri

extpanid extpanid

Esempi

extpanid dead00beef00cafe
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetExtendedPanId

estensione

Ottiene l'ID PAN esteso dello standard IEEE 802.15.4.

Parametri

Nessun parametro.

Esempi

extpanid
dead00beef00cafe
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetExtendedPanId

ripristino dati di fabbrica

Elimina tutte le impostazioni archiviate nella memoria permanente, quindi attiva un ripristino della piattaforma.

Parametri

Nessun parametro.

Esempi

factoryreset

Riferimenti per l'interfaccia a riga di comando e le API

• otInstanceFactoryReset

falso (un,un)

Invia messaggi Thread falsi.

Disponibile quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE è attivato.

Parametri

fake /a/an dst-ipaddr target meshLocalIid

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSendAddressNotification

fem

Recupera parametri FEM esterni.

Parametri

Nessun parametro.

Esempi

fem
LNA gain 11 dBm
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otPlatRadioGetFemLnaGain

fem lnagain (get)

Restituisce il guadagno Rx LNA del FEM esterno in dBm.

Parametri

Nessun parametro.

Esempi

fem lnagain
11
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otPlatRadioGetFemLnaGain

lnagain fem (set)

Imposta il guadagno Rx LNA del FEM esterno in dBm.

Parametri

Nessun parametro.

Esempi

fem lnagain 8
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otPlatRadioSetFemLnaGain

storia ipaddr

Visualizza la cronologia degli indirizzi IPv6 unicast in formato tabella o elenco.

Ogni voce di tabella o elenco fornisce:

• Età: tempo trascorso dall'emissione del comando e specificato nel formato hours:minutes:seconds:milliseconds
• Evento: i valori possibili sono Added o Removed.
• Lunghezza indirizzo/prefisso: indirizzo Unicast con la lunghezza del prefisso (in bit).
• Origine: i valori possibili sono thread, slaac, dhcp6 o manual.
• Ambito: ambito degli indirizzi IPv6.
• P: flag preferito.
• V: flag valido.
• RLOC (R): questo flag indica se l'indirizzo IPv6 è un localizzatore di routing.

Parametri

history ipaddr [list] [num-entries]

• Utilizza l'opzione list per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella.
• Utilizza l'opzione num-entries per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.

Esempi

history ipaddr
| Age                  | Event   | Address / Prefix Length                     | Origin |Scope| P | V | R |
+----------------------+---------+---------------------------------------------+--------+-----+---+---+---+
|         00:00:04.991 | Removed | 2001:dead:beef:cafe:c4cb:caba:8d55:e30b/64  | slaac  |  14 | Y | Y | N |
|         00:00:44.647 | Added   | 2001:dead:beef:cafe:c4cb:caba:8d55:e30b/64  | slaac  |  14 | Y | Y | N |
|         00:01:07.199 | Added   | fd00:0:0:0:0:0:0:1/64                       | manual |  14 | Y | Y | N |
|         00:02:17.885 | Added   | fdde:ad00:beef:0:0:ff:fe00:fc00/64          | thread |   3 | N | Y | N |
|         00:02:17.885 | Added   | fdde:ad00:beef:0:0:ff:fe00:5400/64          | thread |   3 | N | Y | Y |
|         00:02:20.107 | Removed | fdde:ad00:beef:0:0:ff:fe00:5400/64          | thread |   3 | N | Y | Y |
|         00:02:21.575 | Added   | fdde:ad00:beef:0:0:ff:fe00:5400/64          | thread |   3 | N | Y | Y |
|         00:02:21.575 | Added   | fdde:ad00:beef:0:ecea:c4fc:ad96:4655/64     | thread |   3 | N | Y | N |
|         00:02:23.904 | Added   | fe80:0:0:0:3c12:a4d2:fbe0:31ad/64           | thread |   2 | Y | Y | N |
Done

history ipaddr list 5
00:00:20.327 -> event:Removed address:2001:dead:beef:cafe:c4cb:caba:8d55:e30b prefixlen:64 origin:slaac scope:14 preferred:yes valid:yes rloc:no
00:00:59.983 -> event:Added address:2001:dead:beef:cafe:c4cb:caba:8d55:e30b prefixlen:64 origin:slaac scope:14 preferred:yes valid:yes rloc:no
00:01:22.535 -> event:Added address:fd00:0:0:0:0:0:0:1 prefixlen:64 origin:manual scope:14 preferred:yes valid:yes rloc:no
00:02:33.221 -> event:Added address:fdde:ad00:beef:0:0:ff:fe00:fc00 prefixlen:64 origin:thread scope:3 preferred:no valid:yes rloc:no
00:02:33.221 -> event:Added address:fdde:ad00:beef:0:0:ff:fe00:5400 prefixlen:64 origin:thread scope:3 preferred:no valid:yes rloc:yes
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otHistoryTrackerEntryAgeToString
• otHistoryTrackerIterateUnicastAddressHistory

ipmaddr cronologia

Visualizza la cronologia degli indirizzi IPv6 multicast in formato tabella o elenco.

Ogni voce di tabella o elenco fornisce:

• Età: tempo trascorso dall'emissione del comando e specificato nel formato hours:minutes:seconds:milliseconds
• Evento: i valori possibili sono Subscribed o Unsubscribed.
• Indirizzo multicast
• Origine: i valori possibili sono Thread o Manual.

Parametri

history ipmaddr [list] [num-entries]

• Utilizza l'opzione list per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella.
• Utilizza l'opzione num-entries per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.

Esempi

history ipmaddr
| Age                  | Event        | Multicast Address                       | Origin |
+----------------------+--------------+-----------------------------------------+--------+
|         00:00:08.592 | Unsubscribed | ff05:0:0:0:0:0:0:1                      | Manual |
|         00:01:25.353 | Subscribed   | ff05:0:0:0:0:0:0:1                      | Manual |
|         00:01:54.953 | Subscribed   | ff03:0:0:0:0:0:0:2                      | Thread |
|         00:01:54.953 | Subscribed   | ff02:0:0:0:0:0:0:2                      | Thread |
|         00:01:59.329 | Subscribed   | ff33:40:fdde:ad00:beef:0:0:1            | Thread |
|         00:01:59.329 | Subscribed   | ff32:40:fdde:ad00:beef:0:0:1            | Thread |
|         00:02:01.129 | Subscribed   | ff03:0:0:0:0:0:0:fc                     | Thread |
|         00:02:01.129 | Subscribed   | ff03:0:0:0:0:0:0:1                      | Thread |
|         00:02:01.129 | Subscribed   | ff02:0:0:0:0:0:0:1                      | Thread |
Done

history ipmaddr list
00:00:25.447 -> event:Unsubscribed address:ff05:0:0:0:0:0:0:1 origin:Manual
00:01:42.208 -> event:Subscribed address:ff05:0:0:0:0:0:0:1 origin:Manual
00:02:11.808 -> event:Subscribed address:ff03:0:0:0:0:0:0:2 origin:Thread
00:02:11.808 -> event:Subscribed address:ff02:0:0:0:0:0:0:2 origin:Thread
00:02:16.184 -> event:Subscribed address:ff33:40:fdde:ad00:beef:0:0:1 origin:Thread
00:02:16.184 -> event:Subscribed address:ff32:40:fdde:ad00:beef:0:0:1 origin:Thread
00:02:17.984 -> event:Subscribed address:ff03:0:0:0:0:0:0:fc origin:Thread
00:02:17.984 -> event:Subscribed address:ff03:0:0:0:0:0:0:1 origin:Thread
00:02:17.984 -> event:Subscribed address:ff02:0:0:0:0:0:0:1 origin:Thread
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otHistoryTrackerEntryAgeToString
• otHistoryTrackerIterateMulticastAddressHistory

vicino di storia

Visualizza la cronologia dei vicini in formato tabella o elenco.

Ogni voce di tabella o elenco fornisce:

• Età: tempo trascorso dall'emissione del comando e specificato nel formato hours:minutes:seconds:milliseconds
• Tipo: Child o Router.
• Evento: i valori possibili sono Added, Removed o Changed.
• Indirizzo esteso
• RLOC16
• Modalità: modalità di collegamento MLE. Valori possibili:
  • -: nessun flag impostato (rx-off-quando-inattivo, dispositivo Thread minimo, dati di rete stabili).
  • r: rx-on-quando-inattivo
  • d: dispositivo con interamente Thread.
  • n: dati di rete completi
• RSS Ave: numero medio di frame (in dBm) ricevuti dal vicino nel momento in cui è stata registrata la voce.

Parametri

history neighbor [list] [num-entries]

• Utilizza l'opzione list per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella.
• Utilizza l'opzione num-entries per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.

Esempi

history neighbor
| Age                  | Type   | Event     | Extended Address | RLOC16 | Mode | Ave RSS |
+----------------------+--------+-----------+------------------+--------+------+---------+
|         00:00:29.233 | Child  | Added     | ae5105292f0b9169 | 0x8404 | -    |     -20 |
|         00:01:38.368 | Child  | Removed   | ae5105292f0b9169 | 0x8401 | -    |     -20 |
|         00:04:27.181 | Child  | Changed   | ae5105292f0b9169 | 0x8401 | -    |     -20 |
|         00:04:51.236 | Router | Added     | 865c7ca38a5fa960 | 0x9400 | rdn  |     -20 |
|         00:04:51.587 | Child  | Removed   | 865c7ca38a5fa960 | 0x8402 | rdn  |     -20 |
|         00:05:22.764 | Child  | Changed   | ae5105292f0b9169 | 0x8401 | rn   |     -20 |
|         00:06:40.764 | Child  | Added     | 4ec99efc874a1841 | 0x8403 | r    |     -20 |
|         00:06:44.060 | Child  | Added     | 865c7ca38a5fa960 | 0x8402 | rdn  |     -20 |
|         00:06:49.515 | Child  | Added     | ae5105292f0b9169 | 0x8401 | -    |     -20 |
Done

history neighbor list
00:00:34.753 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8404 mode:- rss:-20
00:01:43.888 -> type:Child event:Removed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:32.701 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
00:04:56.756 -> type:Router event:Added extaddr:865c7ca38a5fa960 rloc16:0x9400 mode:rdn rss:-20
00:04:57.107 -> type:Child event:Removed extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:05:28.284 -> type:Child event:Changed extaddr:ae5105292f0b9169 rloc16:0x8401 mode:rn rss:-20
00:06:46.284 -> type:Child event:Added extaddr:4ec99efc874a1841 rloc16:0x8403 mode:r rss:-20
00:06:49.580 -> type:Child event:Added extaddr:865c7ca38a5fa960 rloc16:0x8402 mode:rdn rss:-20
00:06:55.035 -> type:Child event:Added extaddr:ae5105292f0b9169 rloc16:0x8401 mode:- rss:-20
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otHistoryTrackerIterateNeighborHistory

netinfo cronologia

Visualizza la cronologia delle informazioni sulla rete in formato tabella o elenco.

Ogni voce di tabella o elenco fornisce:

• Età: tempo trascorso dall'emissione del comando e specificato nel formato hours:minutes:seconds:milliseconds
• Ruolo: ruolo del dispositivo. I valori possibili sono router, child, detached o disabled.
• Modalità: modalità di collegamento MLE. Valori possibili:
  • -: nessun flag impostato (rx-off-quando-inattivo, dispositivo Thread minimo, dati di rete stabili).
  • r: rx-on-quando-inattivo
  • d: dispositivo con interamente Thread.
  • n: dati di rete completi
• RLOC16
• ID partizione.

Parametri

history netinfo [list] [num-entries]

• Utilizza l'opzione list per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella.
• Utilizza l'opzione num-entries per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.

Esempi

history netinfo
| Age                  | Role     | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
|         00:00:10.069 | router   | rdn  | 0x6000 |    151029327 |
|         00:02:09.337 | child    | rdn  | 0x2001 |    151029327 |
|         00:02:09.338 | child    | rdn  | 0x2001 |    151029327 |
|         00:07:40.806 | child    | -    | 0x2001 |    151029327 |
|         00:07:42.297 | detached | -    | 0x6000 |            0 |
|         00:07:42.968 | disabled | -    | 0x6000 |            0 |
Done

history netinfo list
00:00:59.467 -> role:router mode:rdn rloc16:0x6000 partition-id:151029327
00:02:58.735 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:02:58.736 -> role:child mode:rdn rloc16:0x2001 partition-id:151029327
00:08:30.204 -> role:child mode:- rloc16:0x2001 partition-id:151029327
00:08:31.695 -> role:detached mode:- rloc16:0x6000 partition-id:0
00:08:32.366 -> role:disabled mode:- rloc16:0x6000 partition-id:0
Done

history netinfo 2
| Age                  | Role     | Mode | RLOC16 | Partition ID |
+----------------------+----------+------+--------+--------------+
|         00:02:05.451 | router   | rdn  | 0x6000 |    151029327 |
|         00:04:04.719 | child    | rdn  | 0x2001 |    151029327 |
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otHistoryTrackerIterateNetInfoHistory

prefisso cronologia

Visualizza i dati di rete per la cronologia dei prefissi mesh in formato tabella o elenco.

Ogni voce di tabella o elenco fornisce:

• Età: tempo trascorso dall'emissione del comando e specificato nel formato hours:minutes:seconds:milliseconds
• Evento: i valori possibili sono Added o Removed.
• Prefisso
• Segnalazioni/significato:
  • p: flag preferito
  • a: flag di configurazione automatica degli indirizzi IPv6 stateless.
  • d: flag di configurazione dell'indirizzo IPv6 DHCPv6.
  • c: flag di altro configurazione DHCPv6.
  • r: flag predefinito per la route.
  • o: sul flag mesh.
  • s: flag stabile.
  • n: flag Dns nd.
  • D: flag prefisso di dominio.
• Preferenza: preferenza. I valori possono essere high, med o low.
• RLOC16

Parametri

history prefix [list] [num-entries]

• Utilizza l'opzione list per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella.
• Utilizza l'opzione num-entries per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.

Esempi

history prefix
| Age                  | Event   | Prefix                                      | Flags     | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
|         00:00:10.663 | Added   | fd00:1111:2222:3333::/64                    | paro      | med  | 0x5400 |
|         00:01:02.054 | Removed | fd00:dead:beef:1::/64                       | paros     | high | 0x5400 |
|         00:01:21.136 | Added   | fd00:abba:cddd:0::/64                       | paos      | med  | 0x5400 |
|         00:01:45.144 | Added   | fd00:dead:beef:1::/64                       | paros     | high | 0x3c00 |
|         00:01:50.944 | Added   | fd00:dead:beef:1::/64                       | paros     | high | 0x5400 |
|         00:01:59.887 | Added   | fd00:dead:beef:1::/64                       | paros     | med  | 0x8800 |
Done

history prefix list
00:04:12.487 -> event:Added prefix:fd00:1111:2222:3333::/64 flags:paro pref:med rloc16:0x5400
00:05:03.878 -> event:Removed prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:05:22.960 -> event:Added prefix:fd00:abba:cddd:0::/64 flags:paos pref:med rloc16:0x5400
00:05:46.968 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x3c00
00:05:52.768 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:high rloc16:0x5400
00:06:01.711 -> event:Added prefix:fd00:dead:beef:1::/64 flags:paros pref:med rloc16:0x8800
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otHistoryTrackerIterateOnMeshPrefixHistory

percorso della storia

Visualizza la cronologia dei percorsi esterni dei dati di rete in formato tabella o elenco.

Ogni voce di tabella o elenco fornisce:

• Età: tempo trascorso dall'emissione del comando e specificato nel formato hours:minutes:seconds:milliseconds
• Evento: i valori possibili sono Added o Removed.
• Percorso
• Segnalazioni/significato:
  • s: flag stabile.
  • n: flag NAT64.
• Preferenza: preferenza. I valori possono essere high, med o low.
• RLOC16

Parametri

history route [list] [num-entries]

• Utilizza l'opzione list per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella.
• Utilizza l'opzione num-entries per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.

Esempi

history route
| Age                  | Event   | Route                                       | Flags     | Pref | RLOC16 |
+----------------------+---------+---------------------------------------------+-----------+------+--------+
|         00:00:05.456 | Removed | fd00:1111:0::/48                            | s         | med  | 0x3c00 |
|         00:00:29.310 | Added   | fd00:1111:0::/48                            | s         | med  | 0x3c00 |
|         00:00:42.822 | Added   | fd00:1111:0::/48                            | s         | med  | 0x5400 |
|         00:01:27.688 | Added   | fd00:aaaa:bbbb:cccc::/64                    | s         | med  | 0x8800 |
Done

history route list 2
00:00:48.704 -> event:Removed route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
00:01:12.558 -> event:Added route:fd00:1111:0::/48 flags:s pref:med rloc16:0x3c00
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otHistoryTrackerIterateExternalRouteHistory

router cronologia

Visualizza la cronologia della tabella di route in formato tabella o elenco.

Ogni voce di tabella o elenco fornisce:

• Età: tempo trascorso dall'emissione del comando e specificato nel formato hours:minutes:seconds:milliseconds
• Evento: i valori possibili sono Added, Removed, NextHopChanged o CostChanged.
• ID (RLOC16): ID router e RLOC16 del router.
• Hop successivo: ID router e RLOC16 dell'hop successivo. Se non è presente alcun hop successivo, viene visualizzato none.
• Costo del percorso: costo precedente -> nuovo costo. Un valore inf indica un costo del percorso infinito.

Parametri

history router [list] [num-entries]

• Utilizza l'opzione list per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella.
• Utilizza l'opzione num-entries per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.

Esempi

history router
| Age                  | Event          | ID (RLOC16) | Next Hop    | Path Cost  |
+----------------------+----------------+-------------+-------------+------------+
|         00:00:05.258 | NextHopChanged |  7 (0x1c00) | 34 (0x8800) | inf ->   3 |
|         00:00:08.604 | NextHopChanged | 34 (0x8800) | 34 (0x8800) | inf ->   2 |
|         00:00:08.604 | Added          |  7 (0x1c00) |        none | inf -> inf |
|         00:00:11.931 | Added          | 34 (0x8800) |        none | inf -> inf |
|         00:00:14.948 | Removed        | 59 (0xec00) |        none | inf -> inf |
|         00:00:14.948 | Removed        | 54 (0xd800) |        none | inf -> inf |
|         00:00:14.948 | Removed        | 34 (0x8800) |        none | inf -> inf |
|         00:00:14.948 | Removed        |  7 (0x1c00) |        none | inf -> inf |
|         00:00:54.795 | NextHopChanged | 59 (0xec00) | 34 (0x8800) |   1 ->   5 |
|         00:02:33.735 | NextHopChanged | 54 (0xd800) |        none |  15 -> inf |
|         00:03:10.915 | CostChanged    | 54 (0xd800) | 34 (0x8800) |  13 ->  15 |
|         00:03:45.716 | NextHopChanged | 54 (0xd800) | 34 (0x8800) |  15 ->  13 |
|         00:03:46.188 | CostChanged    | 54 (0xd800) | 59 (0xec00) |  13 ->  15 |
|         00:04:19.124 | CostChanged    | 54 (0xd800) | 59 (0xec00) |  11 ->  13 |
|         00:04:52.008 | CostChanged    | 54 (0xd800) | 59 (0xec00) |   9 ->  11 |
|         00:05:23.176 | CostChanged    | 54 (0xd800) | 59 (0xec00) |   7 ->   9 |
|         00:05:51.081 | CostChanged    | 54 (0xd800) | 59 (0xec00) |   5 ->   7 |
|         00:06:48.721 | CostChanged    | 54 (0xd800) | 59 (0xec00) |   3 ->   5 |
|         00:07:13.792 | NextHopChanged | 54 (0xd800) | 59 (0xec00) |   1 ->   3 |
|         00:09:28.681 | NextHopChanged |  7 (0x1c00) | 34 (0x8800) | inf ->   3 |
|         00:09:31.882 | Added          |  7 (0x1c00) |        none | inf -> inf |
|         00:09:51.240 | NextHopChanged | 54 (0xd800) | 54 (0xd800) | inf ->   1 |
|         00:09:54.204 | Added          | 54 (0xd800) |        none | inf -> inf |
|         00:10:20.645 | NextHopChanged | 34 (0x8800) | 34 (0x8800) | inf ->   2 |
|         00:10:24.242 | NextHopChanged | 59 (0xec00) | 59 (0xec00) | inf ->   1 |
|         00:10:24.242 | Added          | 34 (0x8800) |        none | inf -> inf |
|         00:10:41.900 | NextHopChanged | 59 (0xec00) |        none |   1 -> inf |
|         00:10:42.480 | Added          |  3 (0x0c00) |  3 (0x0c00) | inf -> inf |
|         00:10:43.614 | Added          | 59 (0xec00) | 59 (0xec00) | inf ->   1 |
Done

history router list 20
00:00:06.959 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
00:00:10.305 -> event:NextHopChanged router:34(0x8800) nexthop:34(0x8800) old-cost:inf new-cost:2
00:00:10.305 -> event:Added router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:13.632 -> event:Added router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:59(0xec00) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:54(0xd800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:34(0x8800) nexthop:none old-cost:inf new-cost:inf
00:00:16.649 -> event:Removed router:7(0x1c00) nexthop:none old-cost:inf new-cost:inf
00:00:56.496 -> event:NextHopChanged router:59(0xec00) nexthop:34(0x8800) old-cost:1 new-cost:5
00:02:35.436 -> event:NextHopChanged router:54(0xd800) nexthop:none old-cost:15 new-cost:inf
00:03:12.616 -> event:CostChanged router:54(0xd800) nexthop:34(0x8800) old-cost:13 new-cost:15
00:03:47.417 -> event:NextHopChanged router:54(0xd800) nexthop:34(0x8800) old-cost:15 new-cost:13
00:03:47.889 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:13 new-cost:15
00:04:20.825 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:11 new-cost:13
00:04:53.709 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:9 new-cost:11
00:05:24.877 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:7 new-cost:9
00:05:52.782 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:5 new-cost:7
00:06:50.422 -> event:CostChanged router:54(0xd800) nexthop:59(0xec00) old-cost:3 new-cost:5
00:07:15.493 -> event:NextHopChanged router:54(0xd800) nexthop:59(0xec00) old-cost:1 new-cost:3
00:09:30.382 -> event:NextHopChanged router:7(0x1c00) nexthop:34(0x8800) old-cost:inf new-cost:3
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otHistoryTrackerIterateRouterHistory

rx cronologia

Visualizza la cronologia RX dei messaggi IPv6 in formato tabella o elenco.

Ogni voce di tabella o elenco fornisce:

• Età: tempo trascorso dall'emissione del comando e specificato nel formato hours:minutes:seconds:milliseconds
• Tipo:
  • Tipo di messaggio IPv6, come UDP, TCP, HopOpts e ICMP6 (e il relativo sottotipo).
  • src: indirizzo IPv6 di origine e numero di porta.
  • dst: indirizzo IPv6 di destinazione e numero di porta (il numero di porta è valido per UDP/TCP, altrimenti è 0).
• Len: lunghezza del payload IPv6 (esclusa l'intestazione IPv6).
• Chksum: checksum dei messaggi (valido per i messaggi UDP, TCP o ICMP6).
• Sec: indica se è stata utilizzata la sicurezza a livello di link.
• Prio: priorità del messaggio. I valori possibili sono low, norm, high o net (per i messaggi di controllo Thread).
• RSS: intensità del segnale ricevuto (in dBm), calcolata in media su tutti i frame di frammenti ricevuti che formano il messaggio. Per la cronologia di TX, viene visualizzato NA (non applicabile).
• Dir: mostra se il messaggio è stato inviato (TX) o ricevuto (RX). Una trasmissione non riuscita è indicata con TX-F nel formato tabella o tx-success:no nel formato elenco. Esempi di trasmissione non riuscita sono txl'interruzione del servizio e nessun ack inviato dal peer per nessuno dei frammenti del messaggio.
• Neighb: indirizzo breve (RLOC16) del vicino con cui è stato inviato/ricevuto il messaggio. Se il frame è stato trasmesso, viene mostrato come bcast in formato tabella o 0xffff in formato elenco. Se l'indirizzo breve del vicino non è disponibile, viene mostrato come unknwn in formato tabella o 0xfffe in formato elenco.
• Radio: link della radio su cui è stato inviato/ricevuto il messaggio (utile quando OPENTHREAD_CONFIG_MULTI_RADIO è attivato). Può essere 15.4, trel o all (se inviato su tutti i link radio).

Parametri

history rx [list] [num-entries]

• Utilizza l'opzione list per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella.
• Utilizza l'opzione num-entries per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.

Esempi

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

history rx list 4
00:00:13.368
    type:UDP len:50 checksum:0xbd26 sec:no prio:net rss:-20 from:0x4800 radio:15.4
    src:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
    dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:14.991
    type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:4800]:0
    dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.030
    type:UDP len:12 checksum:0x3f7d sec:yes prio:net rss:-20 from:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
    dst:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
00:00:15.032
    type:ICMP6(EchoReqst) len:16 checksum:0x942c sec:yes prio:norm rss:-20 from:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
    dst:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otHistoryTrackerIterateRxHistory

cronologia rxtx

Visualizza la cronologia combinata dei messaggi IPv6 RX e TX, in formato tabella o elenco.

Ogni voce di tabella o elenco fornisce:

• Età: tempo trascorso dall'emissione del comando e specificato nel formato hours:minutes:seconds:milliseconds
• Tipo:
  • Tipo di messaggio IPv6, come UDP, TCP, HopOpts e ICMP6 (e il relativo sottotipo).
  • src: indirizzo IPv6 di origine e numero di porta.
  • dst: indirizzo IPv6 di destinazione e numero di porta (il numero di porta è valido per UDP/TCP, altrimenti è 0).
• Len: lunghezza del payload IPv6 (esclusa l'intestazione IPv6).
• Chksum: checksum dei messaggi (valido per i messaggi UDP, TCP o ICMP6).
• Sec: indica se è stata utilizzata la sicurezza a livello di link.
• Prio: priorità del messaggio. I valori possibili sono low, norm, high o net (per i messaggi di controllo Thread).
• RSS: intensità del segnale ricevuto (in dBm), calcolata in media su tutti i frame di frammenti ricevuti che formano il messaggio. Per la cronologia di TX, viene visualizzato NA (non applicabile).
• Dir: mostra se il messaggio è stato inviato (TX) o ricevuto (RX). Una trasmissione non riuscita è indicata con TX-F nel formato tabella o tx-success:no nel formato elenco. Esempi di trasmissione non riuscita sono txl'interruzione del servizio e nessun ack inviato dal peer per nessuno dei frammenti del messaggio.
• Neighb: indirizzo breve (RLOC16) del vicino con cui è stato inviato/ricevuto il messaggio. Se il frame è stato trasmesso, viene mostrato come bcast in formato tabella o 0xffff in formato elenco. Se l'indirizzo breve del vicino non è disponibile, viene mostrato come unknwn in formato tabella o 0xfffe in formato elenco.
• Radio: link della radio su cui è stato inviato/ricevuto il messaggio (utile quando OPENTHREAD_CONFIG_MULTI_RADIO è attivato). Può essere 15.4, trel o all (se inviato su tutti i link radio).

Parametri

history rxtx [list] [num-entries]

• Utilizza l'opzione list per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella.
• Utilizza l'opzione num-entries per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.

Esempi

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

history rxtx list 5
00:00:02.100
    type:UDP len:50 checksum:0xd843 sec:no prio:net rss:-20 from:0x0800 radio:15.4
    src:[fe80:0:0:0:54d9:5153:ffc6:df26]:19788
    dst:[ff02:0:0:0:0:0:0:1]:19788
00:00:15.331
    type:HopOpts len:44 checksum:0x0000 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:800]:0
    dst:[ff03:0:0:0:0:0:0:2]:0
00:00:15.354
    type:UDP len:12 checksum:0x6c6b sec:yes prio:net rss:-20 from:0x0800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:800]:61631
    dst:[fdde:ad00:beef:0:0:ff:fe00:801]:61631
00:00:15.356
    type:ICMP6(EchoReqst) len:16 checksum:0xc6a2 sec:yes prio:norm rss:-20 from:0x0800 radio:15.4
    src:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
    dst:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
00:00:15.356
    type:ICMP6(EchoReply) len:16 checksum:0xc5a2 sec:yes prio:norm tx-success:yes to:0x0800 radio:15.4
    src:[fdde:ad00:beef:0:af4c:3644:882a:3698]:0
    dst:[fdde:ad00:beef:0:efe8:4910:cf95:dee9]:0
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otHistoryTrackerIterateRxHistory
• otHistoryTrackerIterateTxHistory

tx cronologia

Visualizza la cronologia TX dei messaggi IPv6 in formato tabella o elenco.

Ogni voce di tabella o elenco fornisce:

• Età: tempo trascorso dall'emissione del comando e specificato nel formato hours:minutes:seconds:milliseconds
• Tipo:
  • Tipo di messaggio IPv6, come UDP, TCP, HopOpts e ICMP6 (e il relativo sottotipo).
  • src: indirizzo IPv6 di origine e numero di porta.
  • dst: indirizzo IPv6 di destinazione e numero di porta (il numero di porta è valido per UDP/TCP, altrimenti è 0).
• Len: lunghezza del payload IPv6 (esclusa l'intestazione IPv6).
• Chksum: checksum dei messaggi (valido per i messaggi UDP, TCP o ICMP6).
• Sec: indica se è stata utilizzata la sicurezza a livello di link.
• Prio: priorità del messaggio. I valori possibili sono low, norm, high o net (per i messaggi di controllo Thread).
• RSS: intensità del segnale ricevuto (in dBm), calcolata in media su tutti i frame di frammenti ricevuti che formano il messaggio. Per la cronologia di TX, viene visualizzato NA (non applicabile).
• Dir: mostra se il messaggio è stato inviato (TX) o ricevuto (RX). Una trasmissione non riuscita è indicata con TX-F nel formato tabella o tx-success:no nel formato elenco. Esempi di trasmissione non riuscita sono txl'interruzione del servizio e nessun ack inviato dal peer per nessuno dei frammenti del messaggio.
• Neighb: indirizzo breve (RLOC16) del vicino con cui è stato inviato/ricevuto il messaggio. Se il frame è stato trasmesso, viene mostrato come bcast in formato tabella o 0xffff in formato elenco. Se l'indirizzo breve del vicino non è disponibile, viene mostrato come unknwn in formato tabella o 0xfffe in formato elenco.
• Radio: link della radio su cui è stato inviato/ricevuto il messaggio (utile quando OPENTHREAD_CONFIG_MULTI_RADIO è attivato). Può essere 15.4, trel o all (se inviato su tutti i link radio).

Parametri

history tx [list] [num-entries]

• Utilizza l'opzione list per visualizzare l'output in formato elenco. In caso contrario, l'output viene mostrato in formato tabella.
• Utilizza l'opzione num-entries per limitare l'output al numero di voci più recenti specificate. Se questa opzione non viene utilizzata, tutte le voci memorizzate vengono mostrate nell'output.

Esempi

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

history tx list
00:00:23.957
    type:ICMP6(EchoReply) len:16 checksum:0x932c sec:yes prio:norm tx-success:yes to:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:dc0e:d6b3:f180:b75b]:0
    dst:[fdde:ad00:beef:0:ac09:a16b:3204:dc09]:0
00:00:23.959
    type:UDP len:50 checksum:0xce87 sec:yes prio:net tx-success:yes to:0x4800 radio:15.4
    src:[fdde:ad00:beef:0:0:ff:fe00:4801]:61631
    dst:[fdde:ad00:beef:0:0:ff:fe00:4800]:61631
00:00:44.658
    type:UDP len:64 checksum:0xf7ba sec:no prio:net tx-success:yes to:0x4800 radio:15.4
    src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
    dst:[fe80:0:0:0:d03d:d3e7:cc5e:7cd7]:19788
00:00:45.415
    type:UDP len:44 checksum:0x26d4 sec:no prio:net tx-success:yes to:0xffff radio:15.4
    src:[fe80:0:0:0:a4a5:bbac:a8e:bd07]:19788
    dst:[ff02:0:0:0:0:0:0:2]:19788
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otHistoryTrackerIterateTxHistory

ifconfig (su,giù)

Porta in alto o in basso l'interfaccia IPv6.

Chiama questo numero per attivare o disattivare la comunicazione IPv6.

Parametri

ifconfig up|down

Esempi

ifconfig up
Done

ifconfig down
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otIp6SetEnabled

ifconfig

Indica se l'interfaccia IPv6 è attiva o meno.

Parametri

Nessun parametro.

Esempi

ifconfig
down
Done

ifconfig
up
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otIp6IsEnabled

instanceid

Ottiene l'identificatore dell'istanza.

L'identificatore dell'istanza è impostato su un valore casuale quando viene creata l'istanza, quindi il suo valore non cambierà dopo l'inizializzazione.

Parametri

Nessun parametro.

Esempi

instanceid
468697314
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otInstanceGetId

ipaddr aggiungi

Aggiunge un indirizzo di interfaccia di rete all'interfaccia Thread.

L'istanza passata aAddress viene copiata dall'interfaccia Thread. L'interfaccia Thread supporta solo un numero fisso di indirizzi unicast aggiunti esternamente. Leggi i OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS.

Parametri

ipaddr add aAddress

Esempi

ipaddr add 2001::dead:beef:cafe
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otIp6AddUnicastAddress

Ipaddr Del

Rimuove un indirizzo di interfaccia di rete dall'interfaccia Thread.

Parametri

ipaddr del aAddress

Esempi

ipaddr del 2001::dead:beef:cafe
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otIp6RemoveUnicastAddress

Ipaddr

Restituisce l'elenco di indirizzi IPv6 assegnati all'interfaccia Thread.

Parametri

ipaddr [-v]

Utilizza -v per avere informazioni più dettagliate sull'indirizzo:

• origin: può essere thread, slaac, dhcp6, manual e indica l'origine dell'indirizzo
• plen: lunghezza del prefisso
• preferred: flag preferito (booleano)
• valid: flag valido (booleano)

Esempi

ipaddr
fdde:ad00:beef:0:0:ff:fe00:0
fdde:ad00:beef:0:558:f56b:d688:799
fe80:0:0:0:f3d9:2a82:c8d8:fe43
Done

ipaddr -v
fd5e:18fa:f4a5:b8:0:ff:fe00:fc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:0:ff:fe00:dc00 origin:thread plen:64 preferred:0 valid:1
fd5e:18fa:f4a5:b8:f8e:5d95:87a0:e82c origin:thread plen:64 preferred:0 valid:1
fe80:0:0:0:4891:b191:e277:8826 origin:thread plen:64 preferred:1 valid:1
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otIp6GetUnicastAddresses

linklocal ipaddr

Ottiene l'indirizzo IPv6 locale rispetto al collegamento di Thread.

L'indirizzo locale del collegamento Thread viene ricavato utilizzando l'indirizzo esteso IEEE802.15.4 come identificatore di interfaccia.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetLinkLocalIp6Address

Ipaddr Mleid

Recupera l'indirizzo EID locale mesh.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetMeshLocalEid

IPaddr RLO

Ottiene l'indirizzo RLOC (Thread Routing Locator).

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetRloc

aggiungi ipmaddr

Sottoscrive l'interfaccia Thread a un indirizzo multicast interfaccia di rete.

Il valore trasmesso nell'istanza aAddress verrà copiato dall'interfaccia Thread. L'interfaccia Thread supporta solo un numero fisso di indirizzi multicast aggiunti esternamente. Leggi i OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS.

Parametri

ipmaddr add aAddress

Esempi

ipmaddr add ff05::1
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otIp6SubscribeMulticastAddress

ipmaddr del

Annulla l'iscrizione dell'interfaccia Thread a un indirizzo multicast interfaccia di rete.

Parametri

ipmaddr del aAddress

Esempi

ipmaddr del ff05::1
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otIp6UnsubscribeMulticastAddress

ipmaddr

Restituisce l'elenco di indirizzi multicast IPv6 sottoscritti all'interfaccia Thread.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otIp6GetMulticastAddresses

Ipmaddr Llatn

Ottiene l'indirizzo multicast di Tutti i nodi Thread locali del link Thread.

L'indirizzo è un collegamento Unicast locale basato su prefisso Multicast Address [RFC 3306], con:

• flgs impostati su 3 (P = 1 e T = 1)
• raccolta impostata su 2
• plen impostato su 64
• prefisso di rete impostato sul prefisso locale mesh
• ID gruppo impostato su 1

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetLinkLocalAllThreadNodesMulticastAddress

ipmaddr rlatn

Ottiene l'indirizzo multicast di Tutti i nodi Thread locale dell'area di autenticazione Thread.

L'indirizzo è un regno locale Unicast Prefix-Based Multicast Address [RFC 3306], con:

• flgs impostati su 3 (P = 1 e T = 1)
• raccolta impostata su 3
• plen impostato su 64
• prefisso di rete impostato sul prefisso locale mesh
• ID gruppo impostato su 1

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetRealmLocalAllThreadNodesMulticastAddress

discernitrice (insieme)

Imposta l'elemento Discerner del join.

Parametri

joiner discerner discerner

• Usa {number}/{length} per impostare discerner.
• joiner discerner clear imposta aDiscerner su nullptr.

Esempi

joiner discerner 0xabc/12
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otJoinerSetDiscerner

chiarimento del joiner

Cancella lo smistatore Joiner.

Parametri

Nessun parametro.

Esempi

joiner discerner clear
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

scrutatore di joiner

Ottiene il Distributore di falegnameria.

Per saperne di più, consulta otJoinerSetDiscerner.

Parametri

Nessun parametro.

Esempi

joiner discerner
0xabc/12
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otJoinerGetDiscerner

aiuto di joiner

Stampa il menu Guida di joiner.

Parametri

Nessun parametro.

Esempi

joiner help
help
id
start
state
stop
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

ID joiner

Ottiene l'ID Joiner.

Se non è impostato un Joiner Discerner, l'ID Joiner corrisponde ai primi 64 bit del risultato del calcolo di SHA-256 rispetto allo standard IEEE EUI-64 assegnato in fabbrica. In caso contrario, l'ID Joiner viene calcolato dal valore del Joiner Discerner.

L'ID Joiner viene utilizzato anche come indirizzo esteso IEEE 802.15.4 del dispositivo durante il processo di messa in servizio.

Parametri

Nessun parametro.

Esempi

joiner id
d65e64fa83f81cf7
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otJoinerGetId

avvio joiner

Attiva il ruolo Thread Joiner.

Parametri

joiner start joining-device-credential [provisioning-url]

• joining-device-credential: passphrase di joiner. Deve essere una stringa di caratteri alfanumerici maiuscoli (0-9 e A-Y, esclusi I, O, Q e Z per la leggibilità), con una lunghezza compresa tra 6 e 32 caratteri.
• provisioning-url: URL di provisioning per il joiner (facoltativo).

Esempi

joiner start J01NM3
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otJoinerStart

stato joiner

Ottieni lo stato di joiner.

Restituisce uno dei seguenti stati:

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

Parametri

Nessun parametro.

Esempi

joiner state
Idle
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otJoinerGetState

punto di join

Disabilita il ruolo Thread Joiner.

Parametri

Nessun parametro.

Esempi

joiner stop
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otJoinerStop

joinerport (set)

Imposta la porta UDP del joiner.

Parametri

joinerport udp-port

Esempi

joinerport 1000
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetJoinerUdpPort

Joinerport

Ottiene la porta UDP del joiner.

Parametri

Nessun parametro.

Esempi

joinerport
1000
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetJoinerUdpPort

contatore sequenza di chiavi (impostato)

Imposta il valore di th interessatoSequenceCounter.

Parametri

keysequence counter counter

Esempi

keysequence counter 10
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetKeySequenceCounter

contatore sequenza di chiavi

Ottiene il thpredictSequenceCounter.

Parametri

Nessun parametro.

Esempi

keysequence counter
10
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetKeySequenceCounter

guardtime sequenza di chiavi (impostato)

Imposta il valore di thpredictSwitchGuardTime (in ore).

Parametri

keysequence guardtime guardtime-hours

Usa immediatamente 0 per Thread Key Switch se c'è una corrispondenza dell'indice della chiave.

Esempi

keysequence guardtime 0
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetKeySwitchGuardTime

tempo di protezione sequenza di chiavi

Ottiene il th insightSwitchGuardTime (in ore).

Parametri

Nessun parametro.

Esempi

keysequence guardtime
0
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetKeySwitchGuardTime

dati leader

Ottiene i dati del leader Thread.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetLeaderData

peso leader (set)

Imposta il peso della leader Thread utilizzato quando si opera nel ruolo Leader.

Imposta direttamente il peso leader sul nuovo valore, sostituendo il valore precedente (che potrebbe essere stato determinato dal valore attuale di otDeviceProperties ).

Parametri

leaderweight weight

Esempi

leaderweight 128
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetLocalLeaderWeight

peso leader

Restituisce il peso del leader Thread utilizzato quando si opera nel ruolo Leader.

Parametri

Nessun parametro.

Esempi

leaderweight
128
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetLocalLeaderWeight

conferma avanzata della gestione dei linkmetrics, trasparente

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 Link Local 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 per l'interfaccia a riga di comando e le API

• otLinkMetricsConfigEnhAckProbing

registro ACK avanzato gestione linkmetrics

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] mappano a otLinkMetricsValues. In base alla specifica 4.11.3.4.4.6, puoi utilizzare al massimo due opzioni contemporaneamente, ad esempio q o qm.

• q: LQI di livello 2.
• m: margine link.
• r: RSSI.

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 per l'interfaccia a riga di comando e le API

• otLinkMetricsConfigEnhAckProbing

gestione dei linkmetrics in avanti

Invia una richiesta di gestione delle metriche dei 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 della serie.
• I valori [l, d, r e a] vengono mappati a otLinkMetricsSeriesFlags. X non rappresenta nessuno dei valori otLinkMetricsSeriesFlags e interrompe la contabilità e rimuove la serie.
  • l: sonda di collegamento MLE.
  • d: dati MAC.
  • r: richiesta di dati MAC.
  • a: ACK MAC.
  • X: può essere utilizzato solo senza altri flag.
• I valori [p, q, m e r] vengono mappati a otLinkMetricsValues.
  • p: numero di PDU di livello 2 ricevute.
  • q: LQI di livello 2.
  • m: margine 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 per l'interfaccia a riga di comando e le API

• otLinkMetricsConfigForwardTrackingSeries

probe linkmetrics

Invia un messaggio di sonda di link MLE.

Parametri

linkmetrics probe peer-ipaddr series-id length

• peer-ipaddr: indirizzo del peer.
• series-id: l'ID della serie a cui è indirizzato il messaggio del probe.
• length: la lunghezza del messaggio del probe. Un intervallo valido è [0, 64].

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkMetricsSendLinkProbe

inoltro della query linkmetrics

Eseguire una query sulle metriche dei link (serie di tracciamento avanti).

Parametri

linkmetrics query peer-ipaddr forward series-id

• peer-ipaddr: indirizzo del peer.
• series-id: l'ID della 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 per l'interfaccia a riga di comando e le API

• otLinkMetricsQuery

query linkmetrics singolo

Esegui una query sulle metriche dei link (sonda singola).

Parametri

linkmetrics query peer-ipaddr single [pqmr]

• peer-ipaddr: indirizzo del peer.
• [p, q, m e r] mappano a otLinkMetrics.
  • p: numero di PDU di livello 2 ricevute.
  • q: LQI di livello 2.
  • m: margine 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 per l'interfaccia a riga di comando e le API

• otLinkMetricsQuery

linkmetricsmgr (attiva,disattiva)

Abilita o disabilita il Gestore metriche dei link.

Parametri

linkmetricsmgr enable|disable

Esempi

linkmetricmgr enable
Done

linkmetricmgr disable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkMetricsManagerSetEnabled

programma linkmetricsmgr

Ottieni i dati delle metriche di collegamento di un vicino in base al suo indirizzo esteso.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkMetricsManagerGetMetricsValueByExtAddr

individua (imposta)

Individua la destinazione più vicina di un indirizzo anycast (ovvero trova l'EID locale e RLOC16 del mesh di destinazione).

La destinazione più vicina viene determinata in base all'attuale tabella di routing e ai costi del percorso all'interno della mesh Thread.

Disponibile quando OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE è attivato.

Parametri

locate anycastaddr

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadLocateAnycastDestination

individua

Restituisce lo stato attuale (In Progress o Idle) del localizzatore anycast.

Disponibile quando OPENTHREAD_CONFIG_TMF_ANYCAST_LOCATOR_ENABLE è attivato.

Parametri

Nessun parametro.

Esempi

locate
Idle
Done

locate fdde:ad00:beef:0:0:ff:fe00:fc10

locate
In Progress
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadIsAnycastLocateInProgress

nome file di log

Specifica il nome file per acquisire i messaggi otPlatLog() , utile durante il debug degli script per i test automatici su Linux quando il logging interrompe gli script per il test automatico.

Richiede OPENTHREAD_CONFIG_LOG_OUTPUT == OPENTHREAD_CONFIG_LOG_OUTPUT_DEBUG_UART e OPENTHREAD_POSIX.

Parametri

log filename filename

Esempi

Riferimenti per l'interfaccia a riga di comando e le API

• otPlatDebugUart_logfile

livello di log (impostato)

Imposta il livello di log.

Parametri

log level level

Esempi

log level 4
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLoggingSetLevel

livello log

Ottieni il livello di log.

Parametri

Nessun parametro.

Esempi

log level
1
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLoggingGetLevel

nuovi tentativi Mac diretti (get,set)

Consente di acquisire o impostare il numero di nuovi tentativi con trasmissione diretta nel livello MAC.

Parametri

mac retries direct [number]

Utilizza l'argomento facoltativo number per impostare il numero di nuovi tentativi di trasmissione diretta.

Esempi

mac retries direct
3
Done

mac retries direct 5
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkGetMaxFrameRetriesDirect
• otLinkSetMaxFrameRetriesDirect

nuovi tentativi Mac indiretti (get,set)

Consente di acquisire o impostare il numero di nuovi tentativi TX indiretti nel livello MAC.

Parametri

mac retries indirect [number]

Utilizza l'argomento facoltativo number per impostare il numero di nuovi tentativi di trasmissione indiretti.

Esempi

mac retries indirect
3
Done

 max retries indirect 5
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkGetMaxFrameRetriesIndirect
• otLinkSetMaxFrameRetriesIndirect

invio mac

Indica a un dispositivo Rx-Off-When-Idle di inviare un frame MAC al relativo dispositivo principale. Questo comando è a scopo di certificazione e può essere utilizzato solo quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE è abilitato.

Parametri

mac send datarequest | emptydata

Devi scegliere uno dei due argomenti seguenti:

• datarequest: accoda un messaggio di richiesta dati IEEE 802.15.4 per la trasmissione.
• emptydata: indica al dispositivo di inviare un frame di dati IEEE 802.15.4 vuoto.

Esempi

mac send datarequest
Done

mac send emptydata
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkSendDataRequest
• otLinkSendEmptyData

aggiunta indirizzo macfilter

È disponibile solo quando è abilitata la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE.

Aggiunge un indirizzo esteso IEEE 802.15.4 all'elenco di filtri MAC. Se specifichi l'argomento facoltativo rss, viene corretta la potenza del segnale ricevuto per i messaggi provenienti dall'indirizzo. Se non utilizzi l'opzione rss, l'indirizzo utilizzerà qualsiasi valore predefinito impostato. Se non hai impostato un valore predefinito, l'intensità del segnale corrisponderà al segnale over-air.

Parametri

macfilter addr add extaddr [rss]

Esempi

macfilter addr add 0f6127e33af6b403 -95
Done

macfilter addr add 0f6127e33af6b402
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkFilterAddAddress

lista consentita dell'addr macfilter

Consente di attivare la modalità di filtro MAC allowlist, il che significa che sarà consentito l'accesso solo agli indirizzi MAC presenti nell'elenco dei filtri MAC.

Parametri

Nessun parametro.

Esempi

macfilter addr allowlist
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkFilterSetAddressMode

cancellazione indirizzo macfilter

È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Questo comando cancella tutti gli indirizzi estesi dall'elenco di filtri MAC.

Parametri

Nessun parametro.

Esempi

macfilter addr clear
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkFilterClearAddresses

lista bloccata addr macfilter

Consente di attivare la modalità di filtro MAC denylist, il che significa che a tutti gli indirizzi MAC nell'elenco di filtri MAC verrà negato l'accesso.

Parametri

Nessun parametro.

Esempi

macfilter addr denylist
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkFilterSetAddressMode

disattivazione indirizzo macfilter

Disattiva le modalità di filtro MAC.

Parametri

Nessun parametro.

Esempi

macfilter addr disable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

indirizzo macfilter

È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Fornisce le seguenti informazioni:

• Modalità attuale dell'elenco di filtri MAC: AllowList, DenyList, o Disabled
• Un elenco di tutti gli indirizzi estesi nel filtro. L'intensità del segnale ricevuto (rss) e l'indicatore di qualità del link (lqi) sono indicati accanto all'indirizzo se questi valori sono stati impostati in modo da essere diversi dai valori predefiniti.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkFilterGetAddressMode

rimozione indirizzo macfilter

È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Questo comando rimuove l'indirizzo esteso specificato dall'elenco dei filtri MAC.

Parametri

macfilter addr remove extaddr

Esempi

macfilter addr remove 0f6127e33af6b402
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkFilterRemoveAddress

filtro Mac

Fornisce le seguenti informazioni:

• Address Mode: modalità attuale del filtro MAC: AllowList, DenyList, o Disabled
• Un elenco di tutti gli indirizzi estesi nell'elenco dei filtri MAC. L'intensità del segnale ricevuto (rss) e l'indicatore di qualità del link (lqi) sono indicati accanto all'indirizzo se questi valori sono stati impostati in modo da essere diversi dai valori predefiniti.
• Un elenco separato (RssIn List) che mostra tutti gli indirizzi estesi in cui rss è stato impostato in modo che sia diverso dal valore predefinito.
• Default rss: mostra i valori predefiniti, se applicabili, per le impostazioni di rss e lqi.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkFilterSetAddressMode
• otLinkFilterGetNextAddress
• otLinkFilterGetNextRssIn

aggiunta macfilter rss

Aggiunge l'indirizzo esteso specificato all'elenco RssIn (o modifica un indirizzo esistente nell'elenco RssIn) e imposta la voce di intensità del segnale ricevuto (in dBm) per i messaggi provenienti da quell'indirizzo.

Parametri

macfilter rss add extaddr rss

Per impostare un valore predefinito per l'intensità del segnale ricevuto per tutti i messaggi ricevuti, utilizza * per l'argomento extaddr.

Esempi

macfilter rss add * -50
Done

macfilter rss add 0f6127e33af6b404 -85
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkFilterAddRssIn

add-lqi macfilter rss

Aggiunge l'indirizzo esteso specificato all'elenco RssIn (o modifica un indirizzo esistente nell'elenco RssIn) e imposta l'indicatore di qualità del link fisso per i messaggi provenienti da quell'indirizzo. Per impostare lqi, non è necessario che l'indirizzo esteso sia incluso nel filtro address allowlist/denylist.

Questa opzione è disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Parametri

macfilter rss add-lqi extaddr lqi

Per impostare un valore predefinito per l'indicatore di qualità dei link per tutti i messaggi ricevuti, utilizza * per l'argomento extaddr. L'intervallo consentito è compreso tra 0 e 3.

Esempi

macfilter rss add-lqi * 3
Done

macfilter rss add-lqi 0f6127e33af6b404 2
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkConvertLinkQualityToRss
• otLinkFilterSetDefaultRssIn

macfilter rss cancellare

Cancella tutte le voci di intensità del segnale ricevuto (rss) e dell'indicatore di qualità del link (lqi) (inclusi i valori predefiniti) dall'elenco RssIn.

L'esecuzione di questa azione implica che tutti gli indirizzi estesi utilizzeranno il segnale in diretta.

È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Parametri

Nessun parametro.

Esempi

macfilter rss clear
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkFilterClearAllRssIn

macfilter rss

Fornisce le seguenti informazioni:

• Elenco di tutti gli indirizzi estesi in cui l'intensità del segnale ricevuto (rss) è stata impostata in modo da essere diversa dal valore predefinito. Viene mostrato anche l'indicatore di qualità del link (lqi). Le impostazioni rss e lqi sono mappate tra loro. Se imposti un valore, il valore dell'altro viene impostato automaticamente. Questo elenco di indirizzi è denominato RssIn List. Se imposti rsi o lqi, l'indirizzo esteso corrispondente viene aggiunto all'elenco RssIn.
• Default rss: mostra i valori predefiniti, se applicabili, per le impostazioni di rss e lqi.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkFilterGetNextRssIn

rimozione rss filtro mac

Rimuove l'indirizzo esteso specificato dall'elenco RssIn.

Una volta rimosso dall'elenco RssIn, questo indirizzo MAC utilizzerà le impostazioni predefinite di rss e lqi, supponendo che siano state configurate le impostazioni predefinite. Se non sono state impostate impostazioni predefinite, viene utilizzato il segnale over-air.

È disponibile quando la configurazione di OPENTHREAD_CONFIG_MAC_FILTER_ENABLE è abilitata.

Non viene eseguita alcuna azione se non esiste una voce nell'elenco RssIn corrispondente all'indirizzo esteso specificato.

Parametri

macfilter rss remove extaddr

Se vuoi rimuovere le impostazioni predefinite dell'intensità del segnale ricevuto e dell'indicatore di qualità del link, usa * come extaddr. Vengono annullati i valori predefiniti, ma le voci dall'elenco RssIn non vengono rimosse.

Esempi

macfilter rss remove *
Done

macfilter rss remove 0f6127e33af6b404
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkFilterRemoveRssIn

meshdiag figlio6

Invia una query a un elemento padre per recuperare gli indirizzi IPv6 di tutti i relativi elementi figlio MTD.

Parametri

meshdiag childip6 parent-rloc16

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otMeshDiagQueryChildrenIp6Addrs

tabella infantile meshdiag

Avvia una query per una tabella figlio di un router con un determinato RLOC16. L'output elenca tutte le voci figlio. Informazioni per bambino:

• RLOC16
• Indirizzo MAC esteso
• Versione thread
• Timeout (in secondi)
• Età (secondi dall'ultimo rilevamento)
• Intervallo di supervisione (in secondi)
• Numero di messaggi in coda (nel caso in cui il bambino abbia sonno)
• Modalità dispositivo
• RSS (media e ultima)
• Frequenza di errore: frame tx (a livello MAC), messaggio IPv6 tx (sopra MAC)
• Tempo di connessione (secondi dal formato {dd}d.{hh}:{mm}:{ss} di creazione del collegamento)
• Informazioni CSL:
  • Se sincronizzato
  • Periodo (in unità di 10 simboli-tempo)
  • Timeout (in secondi)

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

router meshdiag vicino

Avvia una query per la tabella router vicino di un router con un determinato RLOC16. L'output elenca tutte le voci del router vicino. Informazioni per voce:

• RLOC16
• Indirizzo MAC esteso
• Versione thread
• RSS (media e ultima) e margine dei link
• Frequenze di errore, frame tx (a livello MAC), messaggio IPv6 tx (sopra MAC)
• Tempo di connessione (secondi dal formato {dd}d.{hh}:{mm}:{ss} di creazione del collegamento)

Parametri

meshdiag routerneighbortable router-rloc16

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otMeshDiagQueryRouterNeighborTable

topologia meshdiag

Scopri la topologia di rete (elenco dei router e delle relative connessioni). I parametri sono facoltativi e indicano elementi aggiuntivi da scoprire. Possono essere aggiunti in qualsiasi ordine.

• ip6-addrs per trovare l'elenco di indirizzi IPv6 di ciascun router.
• children per trovare la tabella figlio di ogni router.

Informazioni per router:

• ID router
• RLOC16
• Indirizzo MAC esteso
• Versione thread (se nota)
• Se il router è il dispositivo stesso (me)
• Se il router è il dispositivo principale di questo dispositivo quando quest'ultimo è un bambino (parent)
• Se il router è leader
• Indica se il router funge da router di confine che fornisce connettività esterna (br)
• Elenco dei router a cui è collegato il router:
  • 3-links: ID router a cui il router ha un link in entrata con qualità link 3
  • 2-links: ID router a cui il router ha un link in entrata con qualità link 2
  • 1-links: ID router a cui il router ha un link in entrata con qualità link 1
  • Se un elenco è vuoto, viene omesso.
• Se ip6-addrs, l'elenco di indirizzi IPv6 del router
• Se children, elenca tutti gli elementi secondari del router. Informazioni per bambino:
  • RLOC16
  • Qualità dei link in entrata dal punto di vista del livello principale a secondario (zero indica una qualità sconosciuta)
  • Modalità dispositivo secondario (r rx-on-When-idle, d dispositivo Thread completo, n dati di rete completi, - nessun flag impostato)
  • Se tuo figlio è il dispositivo stesso (me)
  • Se il publisher secondario agisce come router di confine che fornisce connettività esterna (br)

Parametri

meshdiag topology [ip6-addrs] [children]

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otMeshDiagDiscoverTopology

mleadvimax

Restituisce il valore massimo intervallo corrente utilizzato dal timer di esercizio di corrente pubblicità.

Questa API richiede OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE ed è destinata solo ai test.

Parametri

Nessun parametro.

Esempi

mleadvimax
12000
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetAdvertisementTrickleIntervalMax

mliid

Imposta l'IID locale mesh (a scopo di test).

Richiede OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

Deve essere utilizzato prima dell'abilitazione dello stack Thread.

Solo per dispositivi di test/di riferimento.

Parametri

mliid iid

Esempi

mliid 1122334455667788
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otIp6SetMeshLocalIid

reg. mlr

Registra i listener multicast al router backbone principale.

OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE e OPENTHREAD_CONFIG_COMMISSIONER_ENABLE devono essere abilitati.

Ometti il timeout per utilizzare il timeout MLR predefinito sul router backbone principale.

Usa il timeout = 0 per annullare la registrazione dei listener multicast.

Parametri

mlr reg ipaddr [timeout]

Esempi

mlr reg ff04::1
status 0, 0 failed
Done

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

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

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

Riferimenti per l'interfaccia a riga di comando e le API

• otIp6RegisterMulticastListeners

modalità (get,set)

Imposta la configurazione della modalità di collegamento MLE.

Parametri

mode [rdn]

• -: nessun flag impostato (rx-off-quando-inattivo, dispositivo Thread minimo, dati di rete stabili)
• r: rx-on-quando-inattivo
• d: dispositivo con tutta la tecnologia Thread
• n: dati di rete completi

Esempi

mode rdn
Done

mode -
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetLinkMode

multiradio

Scarica l'elenco dei link alle radio supportati dal dispositivo.

Questo comando è sempre disponibile, anche se il dispositivo supporta una sola radio.

Parametri

Nessun parametro.

Esempi

multiradio
[15.4, TREL]
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

elenco di vicini multiradio

Restituisce le informazioni sui link multi-radio associate al vicino di un determinato Indirizzo esteso.

OPENTHREAD_CONFIG_MULTI_RADIO deve essere abilitato.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otMultiRadioGetNeighborInfo

vicino multiradio

Restituisce le informazioni sui link multi-radio associate al vicino di un determinato Indirizzo esteso.

OPENTHREAD_CONFIG_MULTI_RADIO deve essere abilitato.

Parametri

multiradio neighbor ext-address

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otMultiRadioGetNeighborInfo

nat64 (attivato,disattiva)

Abilita o disabilita le funzioni NAT64.

Se il criterio OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE è abilitato, l'impostazione disabilitata su true reimposta la tabella di mappatura nel traduttore.

Disponibile quando OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE o OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE è attivato.

Parametri

nat64 enable|disable

Esempi

nat64 enable
Done

nat64 disable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otNat64SetEnabled

sid64

Parametri

Nessun parametro.

Esempi

nat64 cidr 192.168.255.0/24
Done

Riferimenti per l'interfaccia a riga di comando e le API

sidro nat64

Ottiene il CIDR IPv4 configurato nel traduttore NAT64.

Disponibile quando OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE è attivato.

Parametri

Nessun parametro.

Esempi

nat64 cidr
192.168.255.0/24
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otNat64GetCidr

contatori nat64

Ottiene il pacchetto del traduttore NAT64 e i contatori degli errori.

Disponibile quando OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE è attivato.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otNat64GetCounters
• otNat64GetErrorCounters

mappature nat64

Recupera le successive informazioni AddressMapping (utilizzando un iteratore).

Disponibile quando OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE è attivato.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otNat64GetNextAddressMapping

stato nat64

Ottiene lo stato delle funzioni NAT64.

Lo stato PrefixManager è disponibile quando OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE è attivato. Lo stato Translator è disponibile quando OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE è attivato.

Quando OPENTHREAD_CONFIG_NAT64_BORDER_ROUTING_ENABLE è abilitato, PrefixManager restituisce uno dei seguenti stati:

• Disabled: il gestore prefissi NAT64 è disabilitato.
• NotRunning: il gestore prefissi NAT64 è abilitato, ma non è in esecuzione. Ciò potrebbe significare che Gestione routing è disattivato.
• Idle: il gestore prefissi NAT64 è abilitato e in esecuzione, ma non pubblica un prefisso NAT64. Questo può accadere quando c'è un altro router di confine che pubblica un prefisso NAT64 con una priorità più alta.
• Active: il gestore prefissi NAT64 è abilitato, in esecuzione e pubblica un prefisso NAT64.

Quando OPENTHREAD_CONFIG_NAT64_TRANSLATOR_ENABLE è abilitato, Translator restituisce uno dei seguenti stati:

• Disabled: il traduttore NAT64 è disabilitato.
• NotRunning: il traduttore NAT64 è abilitato, ma non sta traducendo i pacchetti. Ciò potrebbe significare che il Traduttore non è configurato con un prefisso NAT64 o un CIDR per NAT64.
• Active: il traduttore NAT64 è abilitato e sta traducendo i pacchetti.

Parametri

Nessun parametro.

Esempi

nat64 state
PrefixManager: Active
Translator: Active
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otNat64GetPrefixManagerState
• otNat64GetTranslatorState

elenco contatti vicini

Stampa l'ora di connessione e l'età dei vicini. Questo comando è simile a neighbor conntime, ma visualizza le informazioni sotto forma di elenco. L'età e il tempo di connessione sono entrambi visualizzati in secondi.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• conntime vicino

tempo connessione vicino

Stampa l'ora di connessione e l'età dei vicini. Informazioni per vicino:

• RLOC16
• MAC esteso
• Ultimo udito (età): numero di secondi dall'ultimo udito dal vicino.
• Tempo di connessione: numero di secondi dalla creazione del collegamento con il vicino. Gli intervalli di durata vengono formattati come {hh}:{mm}:{ss} per ore, minuti e secondi se la durata è inferiore a un giorno. Se la durata è superiore a un giorno, il formato è {dd}d.{hh}:{mm}:{ss}.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• elenco di connessione dei vicini

linkquality vicino

Stampa le informazioni sulla qualità dei link relative a tutti i vicini.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

elenco di vicini

Elenca il RLOC16 di ogni vicino.

Parametri

Nessun parametro.

Esempi

neighbor list
0xcc01 0xc800 0xf000
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

tabella vicina

Stampa le informazioni in formato tabella su tutti i vicini.

Per Role, gli unici valori possibili per questa tabella sono C (secondario) o R (router).

Le seguenti colonne forniscono informazioni sulla modalità dispositivo dei vicini. Ogni colonna ha un valore pari a 0 (disattivata) o 1 (attivata).

• R: RX attivo quando inattivo
• D: dispositivo Thread completo
• N: dati di rete completi

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetNextNeighborInfo

netdata pieno

Stampa "sì" o "no" che indica se i "dati netti completi" Il callback è stato richiamato dall'inizio dell'operazione Thread o dall'ultima volta in cui è stato utilizzato netdata full reset per reimpostare il flag. Questo comando richiede OPENTHREAD_CONFIG_BORDER_ROUTER_SIGNAL_NETWORK_DATA_FULL. La metrica "Dati netti completi" viene richiamato ogni volta che:

• Il dispositivo agisce in qualità di leader e riceve da un router di confine (BR) una registrazione dei dati di rete che non può aggiungere ai dati di rete (esaurito lo spazio).
• Il dispositivo agisce come BR e non è possibile aggiungere nuove voci ai relativi dati di rete locali.
• Il dispositivo agisce come un BR e tenta di registrare le sue voci di dati di rete locali con la variante leader, ma determina che quelle locali non saranno adatte.

Parametri

Nessun parametro.

Esempi

netdata full
no
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRouterSetNetDataFullCallback

reimpostazione completa netdata

Reimposta il flag monitorando se "net data full" è stato richiamato.

Parametri

Nessun parametro.

Esempi

netdata full reset
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

lunghezza netdata

Ottieni la lunghezza attuale (numero di byte) dei dati di rete Thread della partizione.

Parametri

Nessun parametro.

Esempi

netdata length
23
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otNetDataGetLength

netdata maxlength

Ottieni la lunghezza massima osservata dei dati di rete Thread dall'inizializzazione dello stack OT o dall'ultima chiamata a otNetDataResetMaxLength() .

Parametri

Nessun parametro.

Esempi

netdata maxlength
40
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otNetDataGetMaxLength

netdata maxlength reimpostato

Reimposta la lunghezza massima tracciata dei dati di rete Thread.

Parametri

Nessun parametro.

Esempi

netdata maxlength reset
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otNetDataResetMaxLength

netdata publish dnssrp anycast

Pubblica un indirizzo Anycast del servizio DNS/SRP con un numero di sequenza. Qualsiasi voce del servizio DNS/SRP corrente pubblicata da un comando publish dnssrp{anycast|unicast} precedente viene rimossa e sostituita con i nuovi argomenti.

OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE deve essere abilitato.

Parametri

netdata publish dnssrp anycast seq-num

Esempi

netdata publish dnssrp anycast 1
Done

Riferimenti per l'interfaccia a riga di comando e le API

• netdata publish dnssrp unicast (addr,port)
• netdata publish dnssrp unicast (mle)
• otNetDataPublishDnsSrpServiceAnycast

netdata publish dnssrp unicast (addr,porta)

Pubblica un indirizzo Unicast del servizio DNS/SRP con un indirizzo e un numero di porta. Le informazioni su indirizzo e porta sono incluse nei dati TLV dei servizi. Qualsiasi voce del servizio DNS/SRP corrente pubblicata da un comando publish dnssrp{anycast|unicast} precedente viene rimossa e sostituita con i nuovi argomenti.

OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE deve essere abilitato.

Parametri

netdata publish dnssrp unicast address port

Esempi

netdata publish dnssrp unicast fd00::1234 51525
Done

Riferimenti per l'interfaccia a riga di comando e le API

• netdata publish dnssrp unicast (mle)
• netdata publish dnssrp anycast
• otNetDataPublishDnsSrpServiceUnicast

netdata publish dnssrp unicast (mle)

Pubblica l'EID mesh-locale del dispositivo con un numero di porta. Le informazioni MLE e sulle porte sono incluse nei dati TLV del server. Per utilizzare un indirizzo Unicast diverso, usa il comando netdata publish dnssrp unicast (addr,port).

Qualsiasi voce del servizio DNS/SRP corrente pubblicata da un comando publish dnssrp{anycast|unicast} precedente viene rimossa e sostituita con i nuovi argomenti.

OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE deve essere abilitato.

Parametri

netdata publish dnssrp unicast port

Esempi

netdata publish dnssrp unicast 50152
Done

Riferimenti per l'interfaccia a riga di comando e le API

• netdata publish dnssrp unicast (addr,port)
• netdata publish dnssrp anycast
• otNetDataPublishDnsSrpServiceUnicastMeshLocalEid

prefisso di pubblicazione netdata

Pubblica una voce di prefisso on-mesh. Per saperne di più, consulta Visualizzare e gestire i dati di rete con OT CLI.

Parametri

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

L'interfaccia a riga di comando OT utilizza argomenti mappati per configurare i valori otBorderRouterConfig. Per ulteriori informazioni, consulta la panoramica dell'interfaccia a riga di comando OpenThread.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otNetDataPublishOnMeshPrefix

netdata publish sostituisci

Sostituisce una voce di route esterna pubblicata in precedenza. Per saperne di più, consulta Visualizzare e gestire i dati di rete con OT CLI.

Parametri

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

L'interfaccia a riga di comando OT utilizza argomenti mappati per configurare i valori otExternalRouteConfig. Per ulteriori informazioni, consulta la panoramica dell'interfaccia a riga di comando OpenThread.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otNetDataReplacePublishedExternalRoute

route di pubblicazione netdata

Pubblica una voce di route esterna. Per saperne di più, consulta Visualizzare e gestire i dati di rete con OT CLI.

Parametri

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

L'interfaccia a riga di comando OT utilizza argomenti mappati per configurare i valori otExternalRouteConfig. Per ulteriori informazioni, consulta la panoramica dell'interfaccia a riga di comando OpenThread.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otNetDataPublishExternalRoute

registro netdata

Registrare prefissi, route e servizi configurati con il Leader.

Controlli dell'interfaccia a riga di comando OT per OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE. Se OTBR è abilitato, registra i dati di rete locali con il Leader. In caso contrario, chiama la funzione dell'interfaccia a riga di comando otServerRegister. Per saperne di più, consulta Visualizzare e gestire i dati di rete con OT CLI.

Parametri

Nessun parametro.

Esempi

netdata register
Done

Riferimenti per l'interfaccia a riga di comando e le API

• aggiunta prefisso
• otBorderRouterRegister
• otServerAddService

netdata steeringdata check (autore del controllo)

Controlla se i dati sul reindirizzamento includono un Joiner con un determinato valore di controllo.

Parametri

netdata steeringdata check discerner

• discerner: l'indice Joiner nel formato {number}/{length}.

Esempi

netdata steeringdata check 0xabc/12
Done

netdata steeringdata check 0xdef/12
Error 23: NotFound

Riferimenti per l'interfaccia a riga di comando e le API

• otNetDataSteeringDataCheckJoinerWithDiscerner
• dischiatore del join

netdata steeringdata check (eui64)

Controlla se i dati sullo sterzo includono un joiner.

Parametri

netdata steeringdata check eui64

• eui64: l'IEEE EUI-64 del Joiner.

Esempi

netdata steeringdata check d45e64fa83f81cf7
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otNetDataSteeringDataCheckJoiner
• eui64

annullare pubblicazione di netdata (prefisso)

Annulla la pubblicazione di un prefisso di route esterno o on-mesh pubblicato in precedenza.

OPENTHREAD_CONFIG_BORDER_ROUTER_ENABLE deve essere abilitato.

Per saperne di più, consulta Visualizzare e gestire i dati di rete con OT CLI.

Parametri

netdata unpublish prefix

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otNetDataUnpublishPrefix

netdata annulla pubblicazione dnssrp

Annulla la pubblicazione di qualsiasi voce del servizio DNS/SRP (Anycast o Unicast) aggiunta in precedenza dai dati di rete Thread.

OPENTHREAD_CONFIG_TMF_NETDATA_SERVICE_ENABLE deve essere abilitato.

Parametri

Nessun parametro.

Esempi

netdata unpublish dnssrp
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otNetDataUnpublishDnsSrpService

Netstat

Restituisce l'intestazione dell'elenco collegato di socket UDP.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otUdpGetSockets

recupero diagnostica di rete

Invia una richiesta di diagnostica di rete per recuperare i valori TLV (Type Length) specificati per gli indirizzi specificati.

Parametri

networkdiagnostic get addr type(s)

Per addr, un indirizzo unicast attiva un Diagnostic Get. Un indirizzo multicast attiva un Diagnostic Query. Valori TLV che puoi specificare (separati da uno spazio se specifichi più di un TLV):

• 0: TLV indirizzo esteso MAC
• 1: TLV indirizzo 16
• 2: modalità TLV
• 3: timeout TLV (periodo di tempo massimo di polling per i SED)
• 4: TLV per la connettività
• 5: Route64 TLV
• 6: TLV dei dati leader
• 7: TLV dei dati di rete
• 8: TLV elenco indirizzi IPv6
• 9: TLV dei contatori MAC
• 14: Livello batteria TLV
• 15: TLV della tensione di alimentazione
• 16: TLV tabella secondaria
• 17: TLV delle pagine del canale
• 19: TLV timeout massimo dell'asset secondario
• 23: EUI64 TLV
• 24: versione TLV (numero di versione per i protocolli e le funzionalità)
• 25: TLV nome del fornitore
• 26: TLV modello fornitore
• 27: TLV versione software del fornitore
• 28: TLV versione stack Thread (identificatore di versione come stringa UTF-8 per codebase/commit/versione dello stack Thread)
• 29: TLV secondario
• 34: TLV per contatori MLE
• 35: TLV dell'URL dell'app del fornitore

Esempi

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

networkdiagnostic get ff02::1 0 1
DIAG_GET.rsp/ans: 00080e336e1c41494e1c01020c00
Ext Address: '0e336e1c41494e1c'
Rloc16: 0x0c00
Done
DIAG_GET.rsp/ans: 00083efcdb7e3f9eb0f201021800
Ext Address: 3efcdb7e3f9eb0f2
Rloc16: 0x1800
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSendDiagnosticGet

reimpostazione diagnostica di rete

Invia una richiesta di diagnostica di rete per reimpostare i valori TLV (Type Length) specificati negli indirizzi specificati. Questo comando supporta solo i seguenti valori TLV: 9 (MAC Counters TLV) o 34 (MLE Counters TLV)

Parametri

networkdiagnostic reset addr type(s)

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSendDiagnosticReset

networkidtimeout (get,set)

Consente di acquisire o impostare il parametro NETWORK_ID_TIMEOUT.

Parametri

networkidtimeout [timeout]

Utilizza l'argomento facoltativo timeout per impostare il valore del parametro NETWORK_ID_TIMEOUT.

Esempi

networkidtimeout 120
Done

networkidtimeout
120
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetNetworkIdTimeout
• otThreadSetNetworkIdTimeout

chiave di rete (chiave)

Imposta la chiave di rete Thread.

Riuscita solo quando i protocolli Thread sono disabilitati. Una chiamata riuscita a questa funzione rende i set di dati operativi attivi e in attesa nella memoria permanente.

Parametri

networkkey key

Esempi

networkkey 00112233445566778899aabbccddeeff
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetNetworkKey

networkkey

Ottieni la chiave di rete Thread.

Parametri

Nessun parametro.

Esempi

networkkey
00112233445566778899aabbccddeeff
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetNetworkKey

networkname (nome)

Imposta il nome della rete Thread.

Riuscita solo quando i protocolli Thread sono disabilitati. Una chiamata riuscita a questa funzione rende i set di dati operativi attivi e in attesa nella memoria permanente.

Parametri

networkname name

Esempi

networkname OpenThread
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetNetworkName

nomerete

Ottieni il nome della rete Thread.

Parametri

Nessun parametro.

Esempi

networkname
OpenThread
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetNetworkName

tempo di rete (impostato)

Consente di impostare i parametri di sincronizzazione dell'ora.

• timesyncperiod: il periodo di sincronizzazione dell'ora, in secondi.
• xtalthreshold: la soglia di accuratezza XTAL necessaria per far diventare un dispositivo compatibile con il router, in PPM.

Parametri

networktime timesyncperiod xtalthreshold

Esempi

networktime 100 300
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otNetworkTimeSetSyncPeriod
• otNetworkTimeSetXtalThreshold

tempo di rete

Ottiene l'ora della rete Thread e i parametri di sincronizzazione dell'ora.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otNetworkTimeGet
• otNetworkTimeGetSyncPeriod
• otNetworkTimeGetXtalThreshold

nexthop (get)

Restituisce il costo dell'hop e del percorso successivo verso una determinata destinazione RLOC16.

Può essere utilizzato con aNextHopRloc16 o aPathCost che è NULL, a indicare che il chiamante non vuole ottenere il valore.

Parametri

nexthop rloc16

Esempi

nexthop 0xc000
0xc000 cost:0
Done

nexthop 0x8001
0x2000 cost:3
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetNextHopAndPathCost

nexthop

Tabella di output degli ID router allocati e del costo attuale dell'hop successivo e del percorso per ciascun router.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetNextHopAndPathCost
• otThreadIsRouterIdAllocated

panid (panid)

Impostare l'ID PAN IEEE 802.15.4.

Riuscita solo quando i protocolli Thread sono disabilitati. Una chiamata riuscita a questa funzione rende anche non validi i set di dati operativi attivi e in attesa nella memoria permanente.

Parametri

panid panid

Esempi

panid 0xdead
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkSetPanId

panide

Ottieni l'ID PAN IEEE 802.15.4.

Parametri

Nessun parametro.

Esempi

panid
0xdead
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkGetPanId

principale

Ottieni le informazioni diagnostiche per un router Thread come padre.

Quando utilizzi come router Thread e OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE è abilitato, questo comando restituirà le informazioni memorizzate nella cache relative a quando il dispositivo era stato precedentemente collegato come figlio Thread. La restituzione delle informazioni memorizzate nella cache è necessaria per supportare il Thread Test Harness - Test Scenario 8.2.x richiede l'indirizzo MAC del genitore precedente (ossia il Router Joiner) anche se il dispositivo è già diventato un router.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetParentInfo

ricerca genitore

Avvia la procedura che consente a tuo figlio di cercare un genitore migliore mantenendo il legame con il genitore attuale.

Deve essere utilizzato quando il dispositivo è collegato da un bambino.

Parametri

Nessun parametro.

Esempi

parent search
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSearchForBetterParent

parentPriority (get,set)

Consente di acquisire o impostare il valore di priorità padre assegnato: 1, 0, -1 o -2. -2 significa non assegnato.

Parametri

parentpriority [parentpriority]

Esempi

parentpriority
1
Done

parentpriority 1
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetParentPriority
• otThreadSetParentPriority

partitionid

Recupera l'ID partizione di rete Thread.

Parametri

Nessun parametro.

Esempi

partitionid
4294967295
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetPartitionId

partitionid preferito (get,set)

Il campo OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE è obbligatorio.

Parametri

partitionid preferred partitionid

Esempi

partitionid preferred
4294967295
Done

partitionid preferred 0xffffffff
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetPreferredLeaderPartitionId
• otThreadSetPreferredLeaderPartitionId

platform

Stampa la piattaforma attuale

Parametri

Nessun parametro.

Esempi

platform
NRF52840
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

pollperiod (get,set)

Ottieni o imposta il periodo di sondaggio dati personalizzato del dispositivo finale per dormire (millisecondi). Solo per test di certificazione.

Parametri

Nessun parametro.

Esempi

pollperiod
0
Done

pollperiod 10
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkGetPollPeriod
• otLinkSetPollPeriod

Preferredrouterid

Specifica l'ID router preferito che il leader deve fornire quando richiesto.

Parametri

preferrouterid routerid

Esempi

preferrouterid 16
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetPreferredRouterId

aggiunta prefisso

Aggiunge un prefisso valido ai dati di rete.

Parametri

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

L'interfaccia a riga di comando OT utilizza argomenti mappati per configurare i valori otBorderRouterConfig. Per ulteriori informazioni, consulta la panoramica dell'interfaccia a riga di comando OpenThread.

Esempi

prefix add 2001:dead:beef:cafe::/64 paros med
Done

prefix add fd00:7d03:7d03:7d03::/64 prosD low
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRouterAddOnMeshPrefix

prefisso meshlocal

Ottieni il prefisso locale del mesh.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

prefisso

Recupera l'elenco di prefissi nei dati di rete locali.

Per saperne di più sui flag otBorderRouterConfig, consulta la panoramica dell'interfaccia a riga di comando OpenThread.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRouterGetNextOnMeshPrefix

rimozione prefisso

Rimuovi la configurazione di un router di confine dai dati di rete locale.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRouterRemoveOnMeshPrefix

promiscuo (attiva,disattiva)

Attiva o disattiva la modalità promiscuo del livello di link.

Parametri

promiscuous enable|disable

Esempi

promiscuous enable
Done

promiscuous disable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkSetPromiscuous

promiscuo

Indica se la modalità promiscuo è attivata o meno a livello di link.

Parametri

Nessun parametro.

Esempi

promiscuous
Disabled
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkIsPromiscuous
• otPlatRadioGetPromiscuous

pskc (insieme)

Imposta pskc in formato esadecimale.

Parametri

pskc key

Esempi

pskc 67c0c203aa0b042bfb5381c47aef4d9e
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

pskc -p

Genera il codice pskc dalla passphrase (con codifica UTF-8), insieme al nome di rete corrente e all'ID PAN esteso.

Parametri

pskc -p passphrase

Esempi

pskc -p 123456
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

pskc

Scarica il file PSKc Thread.

Parametri

Nessun parametro.

Esempi

pskc
67c0c203aa0b042bfb5381c47aef4d9e
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetPskc

pskcref (set)

Imposta il riferimento della chiave sul valore PSKc del thread.

Richiede l'abilitazione della funzionalità di fase di creazione OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE.

L'operazione avrà esito positivo solo quando i protocolli Thread sono disabilitati. Se l'operazione riesce, i set di dati operativi attivi e in attesa nella memoria permanente verranno annullati anche.

Parametri

pskc keyref

Esempi

pskc 0x20017
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetPskcRef

pskcref

Recupero riferimento chiave a PSKc Thread archiviato.

Richiede l'abilitazione della funzionalità di fase di creazione OPENTHREAD_CONFIG_PLATFORM_KEY_REFERENCES_ENABLE.

Parametri

Nessun parametro.

Esempi

pskcref
0x80000000
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetPskcRef

opzione di attivazione/disattivazione (attiva,disattiva)

Attiva o disattiva la radio.

Parametri

radio enable|disable

Esempi

radio enable
Done

radio disable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkSetEnabled

cancellazione statistiche radio

Reimposta le statistiche sulla radio.

Tutti gli orari vengono reimpostati su 0.

Parametri

Nessun parametro.

Esempi

radio stats clear
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otRadioTimeStatsReset

statistiche radio

Recupera le statistiche radio.

Le statistiche della radio includono l'ora in cui la radio è in stato TX/RX/Sonno. Questi tempi sono in unità di microsecondi. Tutti gli orari vengono calcolati dall'ultima reimpostazione delle statistiche radio.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otRadioTimeStatsGet

versione rcp

Recupera la stringa della versione radio.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otPlatRadioGetVersionString

regione (imposta)

Imposta il codice regione.

Il formato della regione radio è la rappresentazione ASCII a 2 byte del codice ISO 3166 alpha-2.

La modifica di questo valore può influire sul limite della potenza di trasmissione.

Parametri

Nessun parametro.

Esempi

region US
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkSetRegion

regione

Recupera il codice regione.

Il formato della regione radio è la rappresentazione ASCII a 2 byte del codice ISO 3166 alpha-2.

Parametri

Nessun parametro.

Esempi

region
US
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkGetRegion

releaserouterid (routerid)

Rilascia un ID router assegnato dal dispositivo nel ruolo Leader.

Parametri

releaserouterid [routerid]

Esempi

releaserouterid 16
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadReleaseRouterId

rloc16

Scarica RLOC16.

Parametri

Nessun parametro.

Esempi

rloc16
0xdead
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetRloc16

aggiunta percorso

Per i parametri, utilizza:

• s: flag stabile
• n: flag NAT64
• prf: preferenza router predefinita, [high, med, low].

Aggiungi una route esterna valida ai dati di rete.

Parametri

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

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otExternalRouteConfig

rimozione percorso

Rimuovi la configurazione di una route esterna dai dati di rete locale.

Parametri

route remove [prefix]

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRouterRemoveRoute

percorso

Recupera l'elenco di route esterne nei dati di rete locali.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otBorderRouterGetNextRoute

router (ID)

La funzione conserva le informazioni diagnostiche per un determinato router Thread.

Stampa le informazioni diagnostiche relative a un router Thread. L'ID può essere un ID router o un RLOC16.

Parametri

router [id]

Esempi

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

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetRouterInfo

elenco router

Elenca gli ID router allocati.

Parametri

Nessun parametro.

Esempi

router list
8 24 50
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetRouterInfo

tavolo router

Stampa un elenco di router in formato tabella.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetRouterInfo

soglia di downgrade del router (get,set)

Ottiene o imposta il valore ROUTER_DOWNGRADE_THRESHOLD.

Parametri

routerdowngradethreshold [threshold]

Esempi

 routerdowngradethreshold
23
Done

 routerdowngradethreshold 23
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetRouterDowngradeThreshold
• otThreadSetRouterDowngradeThreshold

router idoneo (attivato,disattivato)

Attiva o disattiva il ruolo router.

Parametri

routereligible [enable|disable]

Esempi

routereligible enable
Done

routereligible disable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetRouterEligible

idoneo per il router

Indica se il ruolo router è abilitato o disabilitato.

Parametri

Nessun parametro.

Esempi

routereligible
Enabled
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadIsRouterEligible

routerselectionjitter

Consente di acquisire o impostare il valore ROUTER_SELECTION_JITTER.

Parametri

routerselectionjitter [jitter]

Esempi

routerselectionjitter
120
Done

routerselectionjitter 120
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetRouterSelectionJitter
• otThreadSetRouterSelectionJitter

soglia diupgrade del router (get,set)

Ottiene o imposta il valore ROUTER_UPGRADE_THRESHOLD.

Parametri

routerupgradethreshold [threshold]

Esempi

routerupgradethreshold
16
Done

routerupgradethreshold 16
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetRouterUpgradeThreshold
• otThreadSetRouterUpgradeThreshold

scansione energia

Esegue una scansione dell'energia IEEE 802.15.4 e visualizza il tempo in millisecondi da utilizzare per la scansione di ciascun canale. Vengono mostrati tutti i canali, a meno che non ne specifichi uno specifico utilizzando l'opzione canale.

Parametri

scan energy [duration] [channel]

Esempi

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

scan energy 10 20
| Ch | RSSI |
+----+------+
| 20 |  -82 |
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkEnergyScan

scansiona

Esegue una scansione attiva IEEE 802.15.4. La ricerca copre tutti i canali se non viene specificato alcun canale. altrimenti l'intervallo copre solo il canale specificato.

Parametri

scan [channel]

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otLinkActiveScan

aggiunta al servizio

Aggiunge il servizio ai dati di rete.

• enterpriseNumber: codice IANA enterprise
• serviceData: dati dei servizi binari con codifica esadecimale
• serverData: dati del server binario con codifica esadecimale (vuoto se non fornito)

Parametri

service add enterpriseNumber serviceData [serverData]

Esempi

service add 44970 112233 aabbcc
Done

netdata register
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otServerAddService
• netdata registry

rimozione servizio

Rimuove il servizio dai dati di rete.

• enterpriseNumber: codice IANA enterprise
• serviceData: dati dei servizi binari con codifica esadecimale

Parametri

service remove enterpriseNumber serviceData

Esempi

service remove 44970 112233
Done

netdata register
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otServerRemoveService
• netdata registry

singleton

Indica se un nodo è l'unico router sulla rete. Restituisce true o false.

Parametri

Nessun parametro.

Esempi

singleton
true
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadIsSingleton

query sntp

Invia una query SNTP per ottenere l'ora dell'epoca Unix corrente (dal 1° gennaio 1970).

• Indirizzo IP predefinito del server SNTP: 2001:4860:4806:8:: (server NTP IPv6 di Google)
• Porta predefinita del server SNTP: 123

Parametri

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

Esempi

sntp query
SNTP response - Unix time: 1540894725 (era: 0)
Done

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

Riferimenti per l'interfaccia a riga di comando e le API

• otSntpClientQuery

avvio automatico del client srp (get)

Indica lo stato attuale della modalità di avvio automatico (attivata o disattivata). Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.

Parametri

Nessun parametro.

Esempi

srp client autostart
Disabled
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientIsAutoStartModeEnabled

disattivazione automatica dell'avvio automatico del client srp

Disattiva la modalità di avvio automatico.

La disattivazione della modalità di avvio automatico non arresta un client in esecuzione. Tuttavia, il client SRP interrompe il monitoraggio dei dati di rete Thread.

Parametri

Nessun parametro.

Esempi

srp client autostart disable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientDisableAutoStartMode

Attivazione automatica client srp

Consente di attivare la modalità di avvio automatico.

Quando l'avvio automatico è abilitato, il client SRP monitora i dati di rete Thread per rilevare i server SRP, selezionare il server preferito e avviare e arrestare automaticamente il client quando viene rilevato un server SRP.

Tre categorie di voci di dati di rete indicano la presenza di un server SRP, da preferire nel seguente ordine:

1. Voci Unicast in cui l'indirizzo del server è incluso nei dati di servizio. Se sono presenti più opzioni, è preferibile usare l'opzione con l'indirizzo IPv6 numerico più basso.
2. Voci anycast che hanno ciascuna un numero di sequenza. È preferibile il numero di sequenza più grande specificato dalla logica aritmetica del numero di serie in RFC-1982.
3. Voci Unicast in cui le informazioni sull'indirizzo del server sono incluse con i dati del server. Se sono presenti più opzioni, è preferibile usare l'opzione con l'indirizzo IPv6 numerico più basso.

Parametri

Nessun parametro.

Esempi

srp client autostart enable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientEnableAutoStartMode

callback del client srp (get,enable,disable)

Consente di acquisire o attivare/disattivare la stampa degli eventi di callback dal client SRP. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.

Parametri

srp client callback [enable|disable]

Esempi

srp client callback enable
Done

srp client callback
Enabled
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientSetCallback

Indirizzo host del client srp (get)

Indica se la modalità indirizzo automatico è attivata. Se la modalità automatica degli indirizzi non è abilitata, viene restituito l'elenco di indirizzi host del client SRP. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.

Parametri

Nessun parametro.

Esempi

srp client host address
auto
Done

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

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientGetHostInfo

Indirizzo host client srp (set)

Attiva la modalità automatica degli indirizzi host o imposta esplicitamente l'elenco di indirizzi host. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.

Parametri

srp client host address [auto|address...]

• Utilizza il parametro auto per attivare la modalità automatica indirizzo host. Quando l'opzione è abilitata, il client utilizza automaticamente tutti gli indirizzi unicast Thread netif preferiti, ad eccezione degli indirizzi locali rispetto al collegamento e mesh-local. Se non è disponibile un indirizzo valido, viene aggiunto l'indirizzo EID locale del mesh. Il client SRP si registra di nuovo automaticamente se gli indirizzi nel thread netif vengono aggiunti o rimossi o contrassegnati come non preferiti.
• Specifica in modo esplicito l'elenco di indirizzi host, separando ogni indirizzo con uno spazio. Puoi impostare questo elenco mentre il client è in esecuzione. L'operazione disattiverà anche la modalità indirizzo host automatico.

Esempi

srp client host address auto
Done

srp client host address fd00::cafe
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientEnableAutoHostAddress
• otSrpClientSetHostAddresses

cancellazione host client srp

Cancella tutte le informazioni sull'host e tutti i servizi.

Parametri

Nessun parametro.

Esempi

srp client host clear
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientBuffersFreeAllServices
• otSrpClientClearHostAndServices

Nome host del client srp (get,set)

Consente di acquisire o impostare il nome host del client SRP. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.

Parametri

srp client host name [name]

Per impostare il nome host del client quando l'host è stato rimosso o non è ancora registrato sul server, utilizza il parametro name.

Esempi

srp client host name dev4312
Done

srp client host name
dev4312
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientSetHostName

rimozione host client srp

Rimuove le informazioni sull'host del client SRP e tutti i servizi dal server SRP. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.

Parametri

srp client host remove [removekeylease] [sendunregtoserver]

• Il parametro removekeylease è un valore booleano facoltativo che indica se deve essere rimosso anche il lease della chiave host (il valore predefinito è false).
• Il parametro sendunregtoserver è un valore booleano facoltativo che indica se l'host del client deve inviare un "aggiornamento" al server anche se le informazioni sull'host del client non sono ancora state registrate sul server (il valore predefinito è false). Questo parametro può essere specificato solo se il parametro removekeylease viene specificato per primo nel comando.

Esempi

srp client host remove 1
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientRemoveHostAndServices
• otSrpClientSetHostName

host client srp

Recupera le informazioni sull'host.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientGetHostInfo

stato host del client srp

Restituisce lo stato dell'host del client SRP. Stati possibili:

• ToAdd: articolo da aggiungere/registrare.
• Adding: l'elemento è in fase di aggiunta/registrazione.
• ToRefresh: elemento da aggiornare per il rinnovo del leasing.
• Refreshing: l'elemento è stato aggiornato.
• ToRemove: elemento da rimuovere.
• Removing: l'elemento è in fase di rimozione.
• Registered: l'elemento è registrato sul server.
• Removed: l'elemento è stato rimosso.

Parametri

Nessun parametro.

Esempi

srp client host state
Registered
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

keyleaseinterval del client srp (get,set)

Consente di acquisire o impostare l'intervallo di lease della chiave in secondi.

Parametri

srp client keyleaseinterval [interval]

Esempi

srp client keyleaseinterval 864000
Done

srp client keyleaseinterval
864000
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientGetKeyLeaseInterval
• otSrpClientSetKeyLeaseInterval

srp client leaseinterval (get,set)

Consente di acquisire o impostare l'intervallo di lease in secondi.

Parametri

srp client leaseinterval [interval]

Esempi

srp client leaseinterval 3600
Done

srp client leaseinterval
3600
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientGetLeaseInterval
• otSrpClientSetLeaseInterval

indirizzo del server client srp

Restituisce l'indirizzo IPv6 del server.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

Porta server client srp

Restituisce il numero di porta del server.

Parametri

Nessun parametro.

Esempi

srp client server port
4724
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

server client srp

Restituisce l'indirizzo del socket (indirizzo IPv6 e numero di porta) del server SRP utilizzato dal client SRP. Se il client non è in esecuzione, l'indirizzo non è specificato (tutti zeri) con un numero di porta pari a 0. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientGetServerAddress

aggiunta servizio clienti srp

Aggiunge un servizio con un determinato nome istanza, nome servizio e numero di porta. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.

Parametri

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

Il parametro servicename può includere facoltativamente un elenco di etichette di sottotipo di servizio, separate da virgole. Gli esempi qui utilizzano una denominazione generica. I parametri priority e weight (entrambi sono valori uint16_t) sono facoltativi. Se non viene fornito, viene utilizzato zero. Il parametro facoltativo txt consente di impostare i dati TXT associati al servizio. Il valore txt deve essere in formato di stringa esadecimale e viene considerato come una sequenza di byte di dati TXT già codificata.

Esempi

srp client service add ins1 _test1._udp 777
Done

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

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientAddService

Chiave del servizio client srp (get,set)

Consente di acquisire o impostare la modalità di inclusione del record di chiavi del servizio nel client SRP. Questo comando è solo a scopo di test e richiede l'abilitazione di OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.

Parametri

Nessun parametro.

Esempi

srp client service key enable
Done

srp client service key
Enabled
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientIsServiceKeyRecordEnabled

cancella nome servizio client srp

Cancella un servizio, rimuovendolo immediatamente dall'elenco dei servizi client, senza interazione con il server SRP.

Parametri

srp client service clear instancename servicename

Esempi

srp client service clear ins2 _test2._udp
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientClearService

rimozione servizio clienti srp

Consente di richiedere l'annullamento della registrazione di un servizio con il server SRP.

Parametri

srp client service remove instancename servicename

Esempi

srp client service remove ins2 _test2._udp
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientRemoveService

servizio clienti srp

Ottiene l'elenco dei servizi gestiti dal client.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientGetServices

avvio client srp

Avvia l'operazione del client SRP. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.

Parametri

srp client start serveraddr serverport

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientStart

stato client srp

Indica se il client SRP è in esecuzione o meno.

Parametri

Nessun parametro.

Esempi

srp client state
Enabled
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientIsRunning

blocco client srp

Interrompe l'operazione del client SRP.

Arresta qualsiasi ulteriore interazione con il server SRP. Tieni presente che le informazioni sull'host e/o l'elenco di servizi non vengono rimosse né cancellate. Contrassegna tutti i servizi da aggiungere/rimuovere di nuovo dopo l'avvio del client.

Parametri

Nessun parametro.

Esempi

srp client stop
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientStop

ttl del client srp (get,set)

Consente di acquisire o impostare il valore ttl(time to live) in secondi.

Parametri

srp client ttl [value]

Esempi

srp client ttl 3600
Done

srp client ttl
3600
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpClientGetTtl
• otSrpClientSetTtl

server srp (attivato,disattivato)

Attiva o disattiva il server SRP. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.

Parametri

srp server [enable|disable]

Esempi

srp server disable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpServerSetEnabled

addrmode server srp (get,set)

Consente di acquisire o impostare la modalità di indirizzo utilizzata dal server SRP.

La modalità indirizzo indica al server SRP come determinare il proprio indirizzo e il numero di porta, che vengono poi pubblicati nei dati della rete Thread.

Parametri

srp server addrmode [anycast|unicast]

Esempi

srp server addrmode anycast
Done

srp server addrmode
anycast
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpServerGetAddressMode
• otSrpServerSetAddressMode

srp server auto (attivato,disattivato)

Attiva o disattiva la modalità di attivazione automatica sul server SRP.

Quando questa modalità è attivata, il Border Routing Manager stabilisce se e quando attivare o disattivare il server SRP.

Questo comando richiede l'abilitazione di OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.

Parametri

srp server auto [enable|disable]

Esempi

srp server auto enable
Done

srp server auto
Enabled
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpServerIsAutoEnableMode
• otSrpServerSetAutoEnableMode

Dominio server srp (get,set)

Consente di acquisire o impostare il nome di dominio del server SRP.

Parametri

srp server domain [domain-name]

Esempi

srp server domain thread.service.arpa.
Done

srp server domain
thread.service.arpa.
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpServerGetDomain
• otSrpServerSetDomain

host server srp

Restituisce informazioni su tutti gli host registrati. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpServerGetNextHost
• otSrpServerHostGetAddresses
• otSrpServerHostGetFullName

Lease del server srp (get,set)

Ottiene o imposta i valori di lease del server SRP in numero di secondi.

Parametri

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

Esempi

srp server lease 1800 7200 86400 1209600
Done

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

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpServerGetLeaseConfig
• otSrpServerSetLeaseConfig

Seqnum server srp (get,set)

Ottiene o imposta il numero di sequenza utilizzato con la modalità degli indirizzi anycast. Il numero di sequenza è incluso nell'"Indirizzo Anycast del servizio DNS/SRP" pubblicata nella sezione Dati di rete.

Parametri

srp server seqnum [seqnum]

Esempi

srp server seqnum 20
Done

srp server seqnum
20
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpServerGetAnycastModeSequenceNumber
• otSrpServerSetAnycastModeSequenceNumber

servizio server srp

Restituisce informazioni sui servizi registrati.

Il record TXT viene visualizzato come un array di voci. Se una voce contiene una chiave, la chiave viene stampata in formato ASCII. La parte del valore viene stampata in byte esadecimali. Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpServerServiceGetInstanceName
• otSrpServerServiceGetServiceName
• otSrpServerServiceGetSubTypeServiceNameAt

stato server srp

Restituisce uno dei seguenti stati possibili del server SRP:

• disabled: il server SRP non è abilitato.
• stopped: il server SRP è abilitato ma non attivo a causa di server SRP esistenti già attivi nella rete Thread. Il server SRP può diventare attivo quando i server SRP esistenti non sono più attivi all'interno della rete Thread.
• running: il server SRP è attivo e può gestire le registrazioni dei servizi.

Per saperne di più, consulta l'articolo Configurare la connettività server-client SRP (Service Registration Protocol) con OT CLI.

Parametri

Nessun parametro.

Esempi

srp server state
running
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otSrpServerGetState

stato

Restituisce il ruolo attuale del dispositivo Thread o modifica il ruolo come specificato con una delle opzioni. Possibili valori restituiti durante la richiesta di informazioni sul ruolo del dispositivo:

• child: il dispositivo attualmente funziona come account secondario Thread.
• router: il dispositivo attualmente funziona come router Thread.
• leader: il dispositivo attualmente opera come leader Thread.
• detached: al momento il dispositivo non fa parte di una rete/partizione Thread.
• disabled: lo stack di thread è attualmente disabilitato.

L'utilizzo di una delle opzioni ti consente di modificare il ruolo attuale di un dispositivo, escludendo lo stato disabled.

Parametri

state [child|router|leader|detached]

Esempi

state
child
Done

state leader
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetDeviceRole
• otThreadBecomeChild
• otThreadBecomeRouter
• otThreadBecomeLeader
• otThreadBecomeDetached

interrompi tcp

Chiude senza cerimonie la connessione TCP associata all'endpoint TCP di esempio, passando allo stato chiuso.

Parametri

Nessun parametro.

Esempi

tcp abort
TCP: Connection reset
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otTcpAbort

risultato benchmark tcp

Mostra l'ultimo risultato del test di benchmark TCP. Valori di stato possibili:

• In corso
• Completato
• Non testato

Questo comando è destinato principalmente alla creazione di script che automatizzano il test di benchmark TCP.

Parametri

Nessun parametro.

Esempi

tcp benchmark result
TCP Benchmark Status: Ongoing
Done

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

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

esecuzione benchmark TCP

Trasferisce il numero specificato di byte utilizzando la connessione TCP attualmente associata all'endpoint TCP di esempio fornito dall'interfaccia a riga di comando di tcp.

Parametri

tcp benchmark run [size]

Utilizza il parametro size per specificare il numero di byte da inviare per il benchmark. Se non utilizzi il parametro size, viene utilizzato il valore predefinito (OPENTHREAD_CONFIG_CLI_TCP_DEFAULT_BENCHMARK_SIZE).

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

associazione tcp

Associa un indirizzo IPv6 e una porta all'endpoint TCP di esempio fornito dall'interfaccia a riga di comando tcp. L'associazione dell'endpoint TCP a un indirizzo e a una porta IPv6 prende il nome di "denominazione dell'endpoint TCP". In questo modo l'endpoint viene associato per la comunicazione. Per ulteriori informazioni, fai riferimento all'articolo Testare la funzionalità TCP con OT CLI.

Parametri

tcp bind ip port

• ip: indirizzo IPv6 a cui eseguire l'associazione. Se vuoi che lo stack TCP/IPv6 assegni l'indirizzo IPv6 di associazione, utilizza l'indirizzo IPv6 non specificato: ::.
• port: numero di porta TCP a cui eseguire l'associazione.

Esempi

tcp bind :: 30000
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otTcpBind

connetti TCP

Stabilisce una connessione con il peer specificato.

Se la connessione ha esito positivo, la connessione TCP risultante viene associata all'endpoint TCP di esempio. Per ulteriori informazioni, fai riferimento all'articolo Testare la funzionalità TCP con OT CLI.

Parametri

tcp connect ip port [fastopen]

• ip: indirizzo IP del peer. L'indirizzo può essere un indirizzo IPv4, che viene sintetizzato in un indirizzo IPv6 utilizzando il prefisso NAT64 preferito dai dati di rete. Il comando restituisce InvalidState se il prefisso NAT64 preferito non è disponibile.
• port: numero di porta TCP del peer.
• fastopen: questo parametro è facoltativo. Se impostato su fast, l'apertura rapida TCP viene abilitata per questa connessione. In caso contrario, se questo parametro viene impostato su slow o non viene utilizzato, l'apertura rapida TCP viene disattivata.

Esempi

tcp connect fe80:0:0:0:a8df:580a:860:ffa4 30000
Done
TCP: Connection established

tcp connect 172.17.0.1 1234
Connecting to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otTcpConnect

deinit tcp

Deinizializza questo endpoint TCP.

Ciò significa che OpenThread non tiene più traccia di questo endpoint TCP e riassegna tutte le risorse che ha allocato internamente per questo endpoint TCP. L'applicazione può riutilizzare la memoria a supporto dell'endpoint TCP a seconda delle esigenze.

Se corrisponde a una connessione TCP in tempo reale, la connessione viene terminata senza cerimonie (come in otTcpAbort()). Tutte le risorse fornite dall'applicazione per questo endpoint TCP (buffer collegati per il buffer di invio, memoria per il buffer di ricezione, la stessa struttura aEndpoint e così via) vengono immediatamente restituite all'applicazione.

Parametri

Nessun parametro.

Esempi

tcp deinit
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otTcpEndpointDeinitialize

init tcp

Inizializza il listener TCP di esempio e l'endpoint TCP di esempio fornito dall'interfaccia a riga di comando tcp.

Parametri

tcp init [mode] [size]

• mode ha tre valori possibili:
  • tls: specifica che la connessione TCP tra due nodi deve utilizzare anche il protocollo TLS oltre a TCP. Quando due nodi comunicano tramite TCP, entrambi devono utilizzare TLS o nessuno dei due deve utilizzare TLS, perché un endpoint non TLS non è in grado di comunicare con un endpoint TLS.
  • linked o circular: una di queste opzioni significa che non deve essere utilizzato TLS e che deve essere utilizzato il tipo di buffering specificato per il buffering TCP. Il comportamento di linked e circular è identico. Esamina il codice per verificare se esistono differenze tra questi due tipi di buffering. Non sono necessari due endpoint di una connessione TCP per utilizzare lo stesso tipo di buffering.
• Il parametro size imposta le dimensioni del buffer di ricezione da associare all'endpoint TCP di esempio. Se il criterio non viene specificato, viene utilizzata la dimensione massima. La dimensione massima è impostata in OPENTHREAD_CONFIG_CLI_TCP_RECEIVE_BUFFER_SIZE.

Esempi

tcp init tls
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otTcpListenerInitialize
• otTcpEndpointInitialize

tcp in ascolto

Utilizza il listener TCP di esempio per ascoltare le connessioni in entrata sull'indirizzo e sulla porta IPv6 specificati. Per ulteriori informazioni, fai riferimento all'articolo Testare la funzionalità TCP con OT CLI.

Parametri

tcp listen ip port

I seguenti parametri sono obbligatori:

• ip: indirizzo IPv6 o indirizzo IPv6 non specificato (::) del listener TCP di esempio fornito dall'interfaccia a riga di comando di tcp.
• port: porta TCP del listener TCP di esempio. Se nessuna connessione TCP è associata all'endpoint TCP di esempio, tutte le connessioni in entrata corrispondenti all'indirizzo IPv6 e alla porta specificati vengono accettate e associate all'endpoint TCP di esempio.

Esempi

tcp listen :: 30000
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otTcpListen

invio tcp

Invia i dati tramite la connessione TCP associata all'endpoint TCP di esempio fornita con l'interfaccia a riga di comando tcp. Per ulteriori informazioni, fai riferimento all'articolo Testare la funzionalità TCP con OT CLI.

Parametri

tcp send message

Il parametro message contiene il messaggio da inviare all'endpoint TCP remoto.

Esempi

tcp send hello
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

tcp invio

Invia la "fine dello stream" segnale sulla connessione TCP associata all'endpoint TCP di esempio fornito dall'interfaccia a riga di comando di tcp. In questo modo si comunica al peer che non riceverà altri dati tramite questa connessione TCP.

Parametri

Nessun parametro.

Esempi

tcp sendend
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otTcpSendEndOfStream

ascolto interrotto tcp

Indica al listener TCP di esempio di interrompere l'ascolto delle connessioni TCP in entrata.

Parametri

Nessun parametro.

Esempi

tcp stoplistening
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otTcpStopListening

test tmforiginfilter

Attiva o disattiva il filtro per eliminare i messaggi TMF UDP da origini non attendibili.

Per impostazione predefinita, il filtro che elimina i messaggi TMF UDP dall'origine non attendibile è attivato. Se questa opzione è disattivata, i messaggi UDP inviati alla porta TMF che provengono da un'origine non attendibile (come un host, l'interfaccia a riga di comando o un nodo IPv6 esterno) saranno consentiti.

Parametri

test tmforiginfilter [enable|disable]

Esempi

test tmforiginfilter
Enabled

test tmforiginfilter enable
Done

test tmforiginfilter disable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

inizio thread

Avvia l'operazione sul protocollo Thread.

Parametri

Nessun parametro.

Esempi

thread start
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetEnabled

interruzione thread

Interrompe l'operazione del protocollo Thread.

Parametri

Nessun parametro.

Esempi

thread stop
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

versione thread

Ottiene la versione del protocollo Thread.

Parametri

Nessun parametro.

Esempi

 thread version
2
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetVersion

timeinqueue max

Restituisce il tempo in coda massimo per i messaggi nella coda TX.

Richiede OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE.

Il tempo in coda viene monitorato solo per le trasmissioni dirette e misurato come il tempo trascorso dal momento in cui un messaggio viene aggiunto alla coda di trasmissione fino a quando viene passato al livello MAC per la trasmissione o l'eliminazione.

Le statistiche raccolte possono essere reimpostate chiamando otThreadResetTimeInQueueStat() .

Parametri

Nessun parametro.

Esempi

timeinqueue max
281
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetMaxTimeInQueue
• reimpostazione coda temporale

reimpostazione coda temporale

Reimposta le statistiche sul tempo in coda della coda di trasmissione.

Richiede OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE.

Parametri

Nessun parametro.

Esempi

timeinqueue reset
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadResetTimeInQueueStat

timeinqueue

Ottiene l'istogramma del tempo in coda per i messaggi presenti nella coda di trasmissione.

Richiede OPENTHREAD_CONFIG_TX_QUEUE_STATISTICS_ENABLE.

Viene raccolto l'istogramma del tempo in coda dei messaggi nella coda di trasmissione. Il tempo in coda viene monitorato solo per le trasmissioni dirette e misurato come il tempo trascorso dal momento in cui un messaggio viene aggiunto alla coda di trasmissione fino a quando viene passato al livello MAC per la trasmissione o l'eliminazione.

L'istogramma viene restituito come array di valori uint32_t con voci aNumBins. La prima voce dell'array (all'indice 0) rappresenta il numero di messaggi con un tempo di coda inferiore a aBinInterval. La seconda voce rappresenta il numero di messaggi con un tempo di coda maggiore o uguale a aBinInterval, ma inferiore a 2 * aBinInterval. e così via. L'ultima voce rappresenta il numero di messaggi con tempo di coda maggiore o uguale a (aNumBins - 1) * aBinInterval.

Le statistiche raccolte possono essere reimpostate chiamando otThreadResetTimeInQueueStat() . Le informazioni sull'istogramma vengono raccolte a partire dall'inizializzazione dell'istanza OpenThread o dall'ultima reimpostazione della raccolta di statistiche chiamando il otThreadResetTimeInQueueStat() .

I puntatori aNumBins e aBinInterval NON DEVONO essere NULL.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadGetTimeInQueueHistogram
• reimpostazione coda temporale

trel (attiva,disattiva)

Attiva o disattiva l'operazione radio TREL.

Parametri

trel enable|disable

Esempi

trel enable
Done

trel disable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otTrelSetEnabled

contatori trel reimpostati

Reimposta i contatori TREL.

Parametri

Nessun parametro.

Esempi

trel counters reset
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otTrelResetCounters

contatori Trel

Ottiene i contatori TREL.

Parametri

Nessun parametro.

Esempi

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

Riferimenti per l'interfaccia a riga di comando e le API

• otTrelGetCounters

filtro trel (attivato,disattivato)

Attiva o disattiva la modalità filtro TREL.

Parametri

trel filter enable|disable

Esempi

trel filter enable
Done

trel filter disable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otTrelSetFilterEnabled

filtro trel

Indica se la modalità filtro TREL è abilitata.

Quando la modalità filtro è attiva, tutto il traffico Rx e Tx inviato tramite l'interfaccia TREL viene eliminato automaticamente.

Parametri

Nessun parametro.

Esempi

trel filter
Disabled
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otTrelIsFilterEnabled

Trel peer

Restituisce la tabella peer TREL in formato tabella o elenco.

Parametri

trel peers [list]

Esempi

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

trel peers list
001 ExtAddr:5e5785ba3a63adb9 ExtPanId:f0d9c001f00d2e43 SockAddr:[fe80:0:0:0:cc79:2a29:d311:1aea]:9202
002 ExtAddr:ce792a29d3111aea ExtPanId:dead00beef00cafe SockAddr:[fe80:0:0:0:5c57:85ba:3a63:adb9]:9203
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otTrelGetNextPeer

Trel

Indica se l'operazione TREL è abilitata.

Parametri

Nessun parametro.

Esempi

trel
Enabled
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otTrelIsEnabled

tvcheck (attiva,disattiva)

Attiva o disattiva il controllo della versione di Thread durante l'upgrade al router o alla versione leader. Questo controllo è abilitato per impostazione predefinita.

Parametri

Nessun parametro.

Esempi

tvcheck enable
Done

tvcheck disable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otThreadSetThreadVersionCheckEnabled

txpower (get,set)

Ottiene (o imposta con l'utilizzo dell'argomento facoltativo txpower) la potenza di trasmissione in dBm.

Parametri

txpower [txpower]

Esempi

txpower -10
Done

txpower
-10 dBm
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otPlatRadioGetTransmitPower
• otPlatRadioSetTransmitPower

associazione udp

Assegna un indirizzo IPv6 e una porta a un socket aperto che vincola il socket per la comunicazione. L'assegnazione dell'indirizzo e della porta IPv6 prende il nome di socket. Per saperne di più, consulta Testare la funzionalità UDP con l'interfaccia a riga di comando OT.

Parametri

udp bind [netif] ip port

• netif: l'interfaccia di rete di associazione, determinata come segue:
  • Nessun valore (esce questo parametro dal comando): viene utilizzata l'interfaccia di rete Thread.
  • -u: interfaccia di rete non specificata, il che significa che lo stack UDP/IPv6 determina a quale interfaccia di rete associare il socket.
  • -b: viene utilizzata l'interfaccia di rete backbone.
• ip: indirizzo IPv6 Unicast a cui eseguire l'associazione. Se vuoi che lo stack UDP/IPv6 assegni l'indirizzo IPv6 di associazione o se vuoi eseguire l'associazione a indirizzi IPv6 multicast, puoi utilizzare il seguente valore per utilizzare l'indirizzo IPv6 non specificato: ::. Ogni esempio utilizza l'indirizzo IPv6 non specificato.
• port: numero di porta UDP a cui eseguire l'associazione. Ciascuno degli esempi utilizza il numero di porta 1234.

Esempi

udp bind :: 1234
Done

udp bind -u :: 1234
Done

udp bind -b :: 1234
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otUdpBind

chiudi udp

Chiudi un socket UDP/IPv6.

Parametri

Nessun parametro.

Esempi

udp close
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otUdpClose

connessione udp

Connetti un socket UDP/IPv6.

Parametri

udp connect ip port

I seguenti parametri sono obbligatori:

• ip: indirizzo IP del peer.
• port: numero di porta UDP del peer. L'indirizzo può essere un indirizzo IPv4, che viene sintetizzato in un indirizzo IPv6 usando il prefisso NAT64 preferito dai dati di rete. Il comando restituisce InvalidState se il prefisso NAT64 preferito non è disponibile.

Esempi

udp connect fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234
Done

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

Riferimenti per l'interfaccia a riga di comando e le API

• otUdpConnect

udp linksecurity (attiva,disattiva)

Attiva o disattiva la sicurezza dei link.

Parametri

Nessun parametro.

Esempi

udp linksecurity enable
Done

udp linksecurity disable
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

linksecurity udp

Indica se la sicurezza dei link è attivata o disattivata.

Parametri

Nessun parametro.

Esempi

udp linksecurity
Enabled
Done

Riferimenti per l'interfaccia a riga di comando e le API

• Nessuna API associata

udp aperta

Apri un socket UDP/IPv6.

Parametri

Nessun parametro.

Esempi

udp open
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otUdpOpen

invio udp

Invia un messaggio UDP utilizzando il socket. Per saperne di più, consulta Testare la funzionalità UDP con l'interfaccia a riga di comando OT.

Parametri

udp send [ip port] [type] value

ip e port sono facoltativi come coppia, ma se specifichi uno devi specificare l'altro. Se ip e port non sono specificati, l'indirizzo peer socket viene utilizzato da udp connect.

• ip: indirizzo di destinazione. Questo indirizzo può essere un indirizzo IPv4 o IPv6. Un indirizzo IPv4 viene sintetizzato in un indirizzo IPv6 con il prefisso NAT64 preferito dai dati di rete. Se il prefisso NAT64 preferito non è disponibile, il comando restituisce InvalidState.
• port: porta di destinazione UDP.
• type/value combinazioni:
  • -t: il payload nel parametro value viene considerato come testo. Se non viene inserito alcun valore per type, anche il payload nel parametro value viene considerato come testo.
  • -s: payload generato automaticamente con la lunghezza specificata nel parametro value.
  • -x: dati binari nella rappresentazione esadecimale specificata nel parametro value.

Esempi

udp send hello
Done

udp send -t hello
Done

udp send -x 68656c6c6f
Done

udp send -s 800
Done

udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 hello
Done

udp send 172.17.0.1 1234 hello
Sending to synthesized IPv6 address: fdde:ad00:beef:2:0:0:ac11:1
Done

udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -t hello
Done

udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -x 68656c6c6f
Done

udp send fdde:ad00:beef:0:bb1:ebd6:ad10:f33 1234 -s 800
Done

Riferimenti per l'interfaccia a riga di comando e le API

• udp aperta
• associazione udp
• udp Connect
• otUdpSend

non sicuro

Elenca tutte le porte incluse nell'elenco delle porte non protette consentite.

Parametri

Nessun parametro.

Esempi

unsecure get
1234
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otIp6GetUnsecurePorts

aggiunta non sicura

Aggiunge una porta all'elenco delle porte non protette consentite.

Parametri

unsecureport add port

Esempi

unsecureport add 1234
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otIp6AddUnsecurePort

rimozione non sicura

Rimuove una o tutte le porte specificate dall'elenco di porte non protette consentite.

Parametri

unsecureport remove port|all

Esempi

unsecureport remove 1234
Done

unsecureport remove all
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otIp6AddUnsecurePort
• otIp6RemoveAllUnsecurePorts

uptime in ms

Restituisce l'uptime dell'istanza attuale (in msec).

Richiede l'attivazione di OPENTHREAD_CONFIG_UPTIME_ENABLE.

Il tempo di attività è espresso in millisecondi dall'inizializzazione dell'istanza OpenThread.

Parametri

Nessun parametro.

Esempi

uptime ms
426238
Done

Riferimenti per l'interfaccia a riga di comando e le API

• otInstanceGetUptime

periodo di attività

Restituisce l'uptime dell'istanza corrente come stringa leggibile.

Richiede l'attivazione di OPENTHREAD_CONFIG_UPTIME_ENABLE.

La stringa segue il formato "::.". per ore, minuti, secondi e millisecondi (se l'uptime è inferiore a un giorno) o "

uptime
12:46:35.469
Done

vendor appurl url

vendor appurl http://www.example.com
Done

vendor appurl
http://www.example.com
Done

vendor model name

vendor model Hub\ Max
Done

vendor model
Hub Max
Done

vendor name name

vendor name nest
Done

vendor name
nest
Done

vendor swversion version

vendor swversion Marble3.5.1
Done

vendor swversion
Marble3.5.1
Done

verhoeff calculate decimalstring

verhoeff calculate 30731842
1
Done

verhoeff validate decimalstring

verhoeff validate 307318421
Done

version api
28
Done

version
OPENTHREAD/gf4f2f04; Jul 1 2016 17:00:09
Done