<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
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
OT Commissioner installe le répertoire /usr/local
. Si vous souhaitez modifier
votre répertoire d'installation, définissez -DCMAKE_INSTALL_PREFIX
.
Build OT Commissioner:
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 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