Build et configuration du commissaire OpenThread

Afficher la source sur GitHub

Ce guide traite de la création et de la configuration de base d'OpenThread Commissioner (commissaire OT). À la fin de cette procédure, vous disposerez d'un fichier exécutable de CLI commissaire OT et d'une bibliothèque Commissaire statique.

Configurer le commissaire de l'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

Le commissaire OT effectue l'installation dans le répertoire /usr/local. Si vous souhaitez changer de répertoire d'installation, définissez -DCMAKE_INSTALL_PREFIX.

  1. Build Commissaire OT :

    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 l'agent OT

L'agent d'exploitation installe les éléments suivants dans votre répertoire d'installation:

  • Bibliothèque et fichiers d'en-tête du Commissaire OT
  • Fichier binaire exécutable de la CLI commissaire OT
  • Fichiers et identifiants de configuration par défaut
  • Scripts permettant d'exécuter l'interface de ligne de commande OT Commissioner en tant que daemon
sudo ninja install

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

$COMMISSIONER_CLI -h

Si vous avez installé le service dans le répertoire /usr/local, commissioner-cli est disponible à partir de la ligne de commande.

commissioner-cli -h

Configuration

La CLI commissaire OT est compatible à la fois avec le mode de mise en service commerciale Thread 1.2 et la mise en service Thread 1.1 (non-CCM). Pour vous connecter à différents réseaux Thread, un fichier de configuration JSON est nécessaire pour démarrer la CLI du commissaire OT:

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

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

Configuration du CCM

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

Champ Description
DomainName Identifiant unique du 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és et de certificats permettent d'établir des sessions sécurisées entre le commissaire et l'agent frontière.

Configuration non-CCM

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

Logging

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

Charger la configuration

Pour définir les paramètres de configuration et les paramètres de configuration du commissaire OT, procédez comme suit:

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

Inviter un participant

Pour savoir comment utiliser le commissaire OT pour commander un jointeur, consultez la page Mise en service externe.