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
Clonez le dépôt OT Commissioner :
git clone https://github.com/openthread/ot-commissioner
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
.
Build Commissaire OT :
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
ninja -j1
Créez une variable d'environnement pour exécuter
commissioner-cli
à l'étape suivante :export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
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.