In diesem Leitfaden werden die grundlegende Erstellung und Konfiguration von OpenThread Commissioner (OT Commissioner) behandelt. Nach Abschluss dieses Vorgangs haben Sie eine ausführbare OT Commissioner CLI und eine statische Commissioner-Bibliothek.
OT-Beauftragten einrichten
Klonen Sie das OT Commissioner-Repository:
git clone https://github.com/openthread/ot-commissioner
Abhängigkeiten installieren:
cd ot-commissioner
./script/bootstrap.sh
Beauftragter für OT-Build
OT Commissioner wird im Verzeichnis /usr/local
installiert. Wenn Sie Ihr Installationsverzeichnis ändern möchten, legen Sie -DCMAKE_INSTALL_PREFIX
fest.
Build OT Commissioner:
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
ninja -j1
Erstellen Sie eine Umgebungsvariable, um im nächsten Schritt
commissioner-cli
auszuführen:export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
Optional: Einheitentests ausführen:
./tests/commissioner-test
OT Commissioner installieren
OT Commissioner installiert Folgendes in Ihrem Installationsverzeichnis:
- OT-Kommissionsbibliothek und Headerdateien
- Ausführbare Binärdatei des OT-Kommissionsprogramms
- Standardkonfigurationsdateien und Anmeldedaten
- Skripts zum Ausführen der OT Commissioner CLI als Daemon
sudo ninja install
Prüfen Sie die Installation im Hilfemenü.
$COMMISSIONER_CLI -h
Wenn Sie die Anwendung im Verzeichnis /usr/local
installiert haben, ist commissioner-cli
über die Befehlszeile verfügbar.
commissioner-cli -h
Konfiguration
Die OT Commissioner CLI unterstützt sowohl den Thread 1.2 Commercial Commissioning Mode (CCM) als auch den Thread 1.1 Commissioning (Non-CCM). Zum Herstellen einer Verbindung zu verschiedenen Thread-Netzwerken wird eine JSON-Konfigurationsdatei benötigt, um die OT Commissioner CLI zu starten:
ccm-config.json
: Die Standardkonfigurationsdatei für das CCM-Thread-Netzwerk.non-ccm-config.json
: Die Standardkonfigurationsdatei für ein Nicht-CCM-Thread-Netzwerk.
Diese Konfigurationsdateien sind standardmäßig in /usr/local/etc/commissioner
installiert. Sie können sich auch Beispieldateien im GitHub-Repository für ot-commissioner ansehen.
CCM-Konfiguration
Aktualisieren Sie die folgenden Felder in ccm-config.json
, um eine Verbindung zu einem CCM-Thread-Netzwerk herzustellen:
Feld | Beschreibung |
---|---|
DomainName |
Eindeutige Kennung innerhalb der Unternehmensdomain. |
PrivateKeyFile |
Die private Schlüsseldatei im PEM-Format. |
CertificateFile |
Die Zertifikatsdatei im PEM-Format. |
TrustAnchorFile |
Die Vertrauensanker-Datei im PEM-Format. |
Diese Schlüssel- und Zertifikatsdateien werden verwendet, um sichere Sitzungen zwischen dem Kommissar und dem Grenzvertreter einzurichten.
Nicht-CCM-Konfiguration
Mit dem vorinstallierten Schlüssel PSKc
wird eine sichere Sitzung zwischen dem Kommissionsmitglied und dem Border Agent eingerichtet. Wenn Sie eine Verbindung zu einem Thread-unabhängigen Netzwerk herstellen möchten, können Sie PSKc
über die OT Commissioner CLI festlegen. Weitere Informationen finden Sie unter Externe Provision.
Logging
Wenn Sie pi@raspberrypi: commissioner-cli
über die Befehlszeile ausführen, erstellt OT Commissioner eine Datei commissioner.log
im aktuellen Arbeitsverzeichnis, z. B. /home/pi/commissioner.log
. In der JSON-Konfigurationsdatei können Sie den Pfad LogFile
, die Logging-Ebene und andere Logeinstellungen konfigurieren.
Konfiguration laden
So starten Sie OT Commissioner mit Ihren Konfigurationseinstellungen:
commissioner-cli /usr/local/etc/commissioner/ccm-config.json
Joiner beauftragen
Wie Sie einen Joiner mit OT-Kommission beauftragen, erfahren Sie unter Externe Provision.