Tools und Skripts

Quellcode auf GitHub ansehen

OpenThread Border Router (OTBR) enthält eine Vielzahl von Tools und Scripts, die zu Testzwecken verwendet werden können.

PSKc-Generator

pskc, verfügbar in ot-br-posix/tools, generiert einen vorinstallierten Schlüssel für den Bevollmächtigten (PSKc). Der PSKc wird verwendet, um einen externen Thread-Kommissionär bei einem Thread-Netzwerk zu authentifizieren. Erstelle und installiere OTBR, um dieses Tool zu verwenden.

Nach dem Erstellen befindet sich pskc unter ot-br-posix/build/otbr/tools.

Parameter

Der PSKc wird aus den folgenden Parametern generiert:

  • Anmeldedaten des Auftraggebers
  • Thread-Netzwerk – erweiterte PAN-ID
  • Name des Thread-Netzwerks

Nutzung

Syntax:

pskc commissioner-credential extpanid network-name

Beispiel:

cd ~/ot-br-posix/build/otbr/tools
./pskc J01NME 1234AAAA1234BBBB MyOTBRNetwork
ee4fb64e9341e13846bbe7e1c52b6785

Weitere Informationen zur Verwendung dieses Tools mit ot-ctl finden Sie unter Externe Inbetriebnahme.

Steering Data Generator

steering-data, verfügbar in ot-br-posix/tools, verwendet einen Bloom-Filter, um einen Hashwert der für die Inbetriebnahme vorgesehenen Joiner zu generieren. Während der Einrichtung sucht der Joiner nur nach Daten zur Anzeigenausrichtung von Netzwerken, die den Joiner selbst enthalten. Erstellen und installieren Sie OTBR, um dieses Tool zu verwenden.

Nach dem Erstellen befindet sich steering-data unter ot-br-posix/build/otbr/tools.

Parameter

Die Lenkungsdaten werden aus den folgenden Parametern generiert:

  • Byte-Länge der Lenkdaten (optional, Standardwert ist 16)
  • Teilnehmer-ID (EUI-64)

Nutzung

Syntax:

steering-data [length] joiner-id

Beispiel:

cd ~/ot-br-posix/build/otbr/tools
./steering-data 0000b57fffe15d68
00000000000000000020000000000100

Verwenden Sie mehrere Joiner-IDs, um sie alle in den Steuerungsdaten zu berücksichtigen:

./steering-data 0000b57fffe15d68 0000c57fffe15d68
00000000000080000020000000000500

Mit dem Parameter length können Sie die Bytelänge der resultierenden Steuerungsdaten ändern:

./steering-data 8 0000b57fffe15d68
0020000000000100

OTBR-Beauftragter

Die Rolle „Beauftragter“ ist standardmäßig auf OTBR aktiviert, ähnlich wie die Rolle „Beauftragter“ auf einem Gerät mit dem Flag -DOT_COMMISSIONER=ON. Verwende auf der Plattform, auf der OTBR ausgeführt wird, ot-ctl commissioner, um Teilnehmer über die Befehlszeile in Betrieb zu nehmen.

Parameter

Geben Sie help ein, um eine Liste der Befehle aufzurufen.

sudo ot-ctl commissioner help

Nutzung

Syntax:

sudo ot-ctl commissioner parameters

Beispiel:

sudo ot-ctl commissioner start
Done
sudo ot-ctl commissioner joiner add 2f57d222545271f1 J01NME
Done

MeshCoP-Script

OTBR stellt ein MeshCoP-Testscript (Mesh Commissioning Protocol) bereit, das OT Commissioner zum Testen der externen Inbetriebnahme verwendet. Informationen zur Verwendung finden Sie im meshcop-Testscript auf GitHub.

Standalone-IPv6-Script

Verwenden Sie das standalone_ipv6-Script, um die IPv6-Funktionen zu testen, wenn in Ihrer Test- oder Entwicklungsumgebung keine vollständige IPv6-Infrastruktur verfügbar ist (z. B. wenn Ihr Netzwerk nicht mit einem Upstream-IPv6-Anbieter verbunden ist).

Mit diesem Script werden zusätzliche Funktionen auf der Plattform installiert, auf der OTBR ausgeführt wird, damit das Gerät IPv6-Adressen bereitstellen kann.

Dieses Script befindet sich unter /ot-br-posix/script/standalone_ipv6.