OpenThread Commissioner – Build und Konfiguration

Quelle auf GitHub ansehen

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

  1. Klonen Sie das OT Commissioner-Repository:

    git clone https://github.com/openthread/ot-commissioner
    

  2. 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.

  1. Build OT Commissioner:

    mkdir build
    cd build
    cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
    ninja -j1
    

  2. Erstellen Sie eine Umgebungsvariable, um im nächsten Schritt commissioner-cli auszuführen:

    export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
    

  3. 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.