Build et configuration d'OpenThread Commissioner

<ph type="x-smartling-placeholder"></ph> Consulter le code source sur GitHub

Ce guide couvre le build et la configuration de base d'OpenThread Commissioner (Commissaire OT). À la fin de cette procédure, vous aurez un OT Exécutable de la CLI Commissioner et une bibliothèque Commissioner statique.

Configurer le commissaire OT

  1. Clonez le dépôt OT Commissioner:

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

  2. Installez les dépendances :

    cd ot-commissioner
    ./script/bootstrap.sh
    

Build OT Commissioner

OT Commissioner installe le répertoire /usr/local. Si vous souhaitez modifier votre répertoire d'installation, définissez -DCMAKE_INSTALL_PREFIX.

  1. Build OT Commissioner:

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

  2. Créez une variable d'environnement pour exécuter commissioner-cli à l'étape suivante:

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

  3. Facultatif. Exécutez des tests unitaires:

    ./tests/commissioner-test
    

Installer OT Commissaire

OT Commissioner installe ce qui suit dans votre répertoire d'installation:

  • Bibliothèque OT Commissioner et fichiers d’en-tête
  • Binaire exécutable de la CLI OT Commissioner
  • Fichiers de configuration et identifiants par défaut
  • Scripts permettant d'exécuter OT Commissioner CLI en tant que daemon
sudo ninja install

Vérifiez l'installation en consultant le menu d'aide.

$COMMISSIONER_CLI -h

Si vous l'avez installé dans le répertoire /usr/local, commissioner-cli est disponible depuis la ligne de commande.

commissioner-cli -h

Configuration

La CLI OT Commissioner prend en charge le mode de mise en service commercial Thread 1.2 (CCM) et la mise en service Thread 1.1 (hors CCM). Pour se connecter à un autre Thread réseau, un fichier de configuration JSON est nécessaire pour lancer OT Commissioner CLI:

  • ccm-config.json : fichier de configuration par défaut du réseau de threads CCM.
  • non-ccm-config.json : fichier de configuration par défaut pour le thread non-CCM Réseau.

Par défaut, ces fichiers de configuration sont installés dans /usr/local/etc/commissioner. Vous pouvez Vous pouvez également consulter des exemples de fichiers dans le dépôt GitHub ot-commissioner.

Configuration CCM

Pour vous connecter à un réseau Thread CCM, mettez à jour ces champs dans ccm-config.json:

Champ Description
DomainName Identifiant unique dans le domaine d'entreprise.
PrivateKeyFile Fichier de clé privée au format PEM.
CertificateFile Fichier de certificat au format PEM.
TrustAnchorFile Fichier d'ancrage de confiance au format PEM.

Ces fichiers de clé et de certificat sont utilisés pour établir des sessions sécurisées entre le commissaire et l'agent frontalier.

Configuration autre que CCM

La clé pré-partagée PSKc permet d'établir une session sécurisée entre les Commissaire et agent frontalier. Pour vous connecter à un réseau Thread non-CCM, vous Vous pouvez définir votre PSKc à partir de l'OT Commissioner CLI. Pour plus d'informations, consultez la page Mise en service externe.

Journalisation

Lorsque vous exécutez pi@raspberrypi: commissioner-cli à partir de la ligne de commande, OT Commissioner crée un fichier commissioner.log dans le fichier (par exemple, /home/pi/commissioner.log). Dans la configuration JSON , vous pouvez configurer le chemin d'accès LogFile, le niveau de journalisation paramètres.

Charger la configuration

Pour lancer OT Commissioner avec vos paramètres de configuration:

commissioner-cli /usr/local/etc/commissioner/ccm-config.json

Faire appel à un joint

Pour savoir comment utiliser OT Commissaire pour commander un employé, consultez Externe Mise en service