Panoramica dell'interfaccia a riga di comando di OpenThread

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:

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
Done
networkname
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.