Visualizza l'origine su GitHub
L'interfaccia a riga di comando di OpenThread espone le API di configurazione e gestione da un'interfaccia a riga di comando. Utilizza l'interfaccia a riga di comando OT per creare un ambiente di sviluppo OpenThread o come strumento con codice aggiuntivo dell'applicazione. Ad esempio, gli script di test OpenThread utilizzano l'interfaccia a riga di comando per eseguire gli scenari di test.
Inizia
Completa il nostro codelab sulla simulazione con Docker ed esamina il riferimento del comando dell'interfaccia a riga di comando.
Vai al codelab sulla simulazione Vai al riferimento per il comando dell'interfaccia a riga di comando
Utilizza l'interfaccia a riga di comando OT
Puoi utilizzare OT CLI con OpenThread Border Router (OTBR) e i dispositivi Thread. I comandi dell'interfaccia a riga di comando variano in base al tipo di dispositivo e ai flag della build.
Da inizio anno
Per utilizzare l'interfaccia a riga di comando OT con OTBR, inserisci il prefisso che segue prima di ogni comando:
sudo ot-ctl
Dispositivi Thread
Per utilizzare i comandi dell'interfaccia a riga di comando su un dispositivo Thread, consulta la documentazione della piattaforma, il codelab o la guida. Per molti esempi, puoi iniziare a digitare i comandi senza un prefisso:
state
router
Done
Ecco alcune risorse utili per iniziare:
- Esamina le piattaforme OpenThread
- Codelab hardware nordico
- Codelab hardware Silicon Labs
- Esempi di piattaforme su GitHub
Caratteri speciali
Lo spazio vuoto (' '
) viene utilizzato per delimitare il nome del comando e i diversi argomenti, insieme alla scheda ('\t'
) e ai nuovi caratteri di riga ('\r'
, '\n'
).
Alcuni argomenti potrebbero includere spazi, ad esempio il nome di una rete Thread. Per inviare argomenti che includono spazi, utilizza la barra rovesciata ('\'
) per eseguire l'escape dei separatori o della barra rovesciata stessa:
networkname Test\ Network
Donenetworkname
Test Network Done
Mappature di argomenti
L'interfaccia a riga di comando di OT utilizza argomenti predefiniti che corrispondono ai valori di configurazione dell'API. Queste mappature possono essere passate con i comandi dell'interfaccia a riga di comando e potrebbero anche tornare alla console dell'interfaccia a riga di comando per vari comandi Data Network, ad esempio netdata show.
OtBorderRouterConfig
Alcuni comandi, ad esempio prefix add
, richiedono valori otBorderRouterConfig. Per impostare i membri otBorderRouterConfig
dalla riga di comando, l'interfaccia a riga di comando OT analizza un argomento della lettera mappato per ogni membro. Ad esempio, la combinazione di argomenti paros
imposta contemporaneamente i membri mPreferred, mSlaac, mDefaultRoute, mOnMesh e mStable.
Sintassi
Nell'esempio seguente, prefix
è obbligatorio e gli argomenti
otBorderRouterConfig
sono facoltativi, mappati come p
, a
, d
, c
, r
, o
, s
, n
e
D
:
prefix add prefix [padcrosnD]
Utilizzo
Per utilizzare le mappature degli argomenti, non inserire spazi tra le lettere:
prefix add 2001:dead:beef:cafe::/64 paros
Preferenza OtRoute
Per impostare otRoutePreferenza, utilizza high
, med
o low
nei comandi dell'interfaccia a riga di comando OT.
Sintassi
prefix add prefix [padcrosnD] [high|med|low]
Utilizzo
Ecco un esempio di utilizzo dei parametri otBorderRouterConfig
e otRoutePreference
mappati:
prefix add 2001:dead:beef:cafe::/64 paros med
Done
OtExternalRouteConfig
Per i valori otExternalRouteConfig, s
mappa a mStable
e n
mappa a mNat64
.
Sintassi
publish route prefix [sn]
Utilizzo
route add 2001:dead:beef:cafe::/64 s
Done
Valori restituiti
La maggior parte dei comandi restituisce il valore richiesto, seguito da Done
:
br onlinkprefix
fd41:2650:a6f5:0::/64
Done
Altri comandi che includono Dati di rete potrebbero restituire mappature di argomenti per prefissi, route e record di servizio. Per ulteriori informazioni, consulta Display and Manage Network Data with OT CLI.