Übersicht über die OpenThread-Befehlszeile

<ph type="x-smartling-placeholder"></ph> Quelle auf GitHub ansehen

Die OpenThread-Befehlszeile stellt Konfigurations- und Verwaltungs-APIs über eine Befehlszeilenschnittstelle. Mit der OT-Befehlszeile eine OpenThread-Entwicklung erstellen oder als Tool mit zusätzlichem Anwendungscode verwenden. Beispiel: der OpenThread Testskripts verwenden, über die Befehlszeile Testfälle ausführen.

Erste Schritte

Absolvieren Sie unser Simulations-Codelab mit Docker und sehen Sie sich die CLI-Befehlsreferenz an.

Zum Simulations-Codelab Zur Befehlsreferenz der Befehlszeile

OT-CLI verwenden

Sie können die OT-Befehlszeile mit OpenThread Border Router (OTBR) und Thread-Geräten verwenden. CLI variieren je nach Gerätetyp und Build-Flags.

OTBR

Geben Sie Folgendes ein, um die OT-Befehlszeile mit OTBR zu verwenden: vor jedem Befehl ein:

sudo ot-ctl

Thread-Geräte

Informationen zur Verwendung von Befehlszeilenbefehlen auf einem Thread-Gerät finden Sie in der Dokumentation der Plattform, Codelab oder eine Anleitung. Bei vielen Beispielen können Sie mit der Eingabe von Befehlen beginnen, Präfix:

state
router
Done

Hier sind einige Ressourcen, die Ihnen den Einstieg erleichtern:

Sonderzeichen

Das Leerzeichen (' ') grenzt den Befehlsnamen und den verschiedene Argumente, zusammen mit dem Tabulatorzeichen ('\t') und Zeichen für Zeilenvorschub ('\r', '\n')

Einige Argumente können Leerzeichen enthalten, z. B. den Namen eines Thread-Netzwerks. Bis Argumente mit Leerzeichen senden, verwenden Sie den umgekehrten Schrägstrich ('\'), um Escape-Trennzeichen oder den umgekehrten Schrägstrich selbst:

networkname Test\ Network
Done
networkname
Test Network
Done

Argumentzuordnungen

Die OT-Befehlszeile verwendet vordefinierte Argumente, die API-Konfigurationswerten entsprechen. Diese Zuordnungen können mit CLI-Befehlen übergeben und möglicherweise auch zur Befehlszeile zurückgegeben werden. für verschiedene Network Data-Befehle, wie z. B. netdata show an.

otBorderRouterConfig

Einige Befehle, z. B. prefix add, erfordern otBorderRouterConfig Werte. otBorderRouterConfig-Mitglieder über die Befehlszeile über die OT-Befehlszeile festlegen parst ein zugeordnetes Buchstabenargument für jedes Mitglied. Das Argument der Kombination paros legt den mPreferred, mSlaac mDefaultRoute, mOnMesh und mStable aufeinanderfolgen.

Syntax

Im folgenden Beispiel ist prefix erforderlich und otBorderRouterConfig Argumente sind optional und werden als p, a, d, c, r, o, s, n und D:

prefix add prefix [padcrosnD]

Nutzung

Wenn Sie Argumentzuordnungen verwenden möchten, geben Sie zwischen den Buchstaben keine Leerzeichen ein:

prefix add 2001:dead:beef:cafe::/64 paros

otRoutePreference

So legen Sie otRoutePreference fest: Verwenden Sie high, med oder low in OT-Kommandozeilenbefehlen.

Syntax

prefix add prefix [padcrosnD] [high|med|low]

Nutzung

Hier ist ein Beispiel für die Verwendung der zugeordneten otBorderRouterConfig und otRoutePreference Parameter:

prefix add 2001:dead:beef:cafe::/64 paros med
Done

otExternalRouteConfig

Für otExternalRouteConfig wird s mStable zugeordnet und n mNat64 zugeordnet.

Syntax

publish route prefix [sn]

Nutzung

route add 2001:dead:beef:cafe::/64 s
Done

Rückgabewerte

Bei den meisten Befehlen wird der angeforderte Wert gefolgt von Done zurückgegeben:

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

Andere Befehle, die Network Data enthalten, können Argumentzuordnungen zurückgeben. für Präfix-, Routen- und Diensteinträge. Weitere Informationen finden Sie unter Display and Manage Network Data with OT CLI (Netzwerkdaten mit der OT-Befehlszeile anzeigen und verwalten)