Cette page a été traduite par l'API Cloud Translation.

Création et configuration d'OpenThread Commissionr

Ce guide décrit la compilation et la configuration de base d'OpenThread Commissionr (OT Commissaire). Une fois cette procédure terminée, vous disposerez d'un exécutable CLI OTcommissionr et d'une bibliothèque statique Commissaire.

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

Commissaire à la construction

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

Créer un 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 le commissaire OT

Le commissaire OT installe les éléments suivants dans votre répertoire d'installation:

Bibliothèque du commissaire OT et fichiers d'en-tête
binaire exécutable de la CLI OTT
Fichiers de configuration et identifiants par défaut
Scripts permettant d'exécuter la CLI OT Commissioner 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 à partir de la ligne de commande.

commissioner-cli -h

Configuration

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

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 Thread 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 CCM

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

Champ	Description
`DomainName`	Identifiant unique au sein 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 de 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 autre que CCM, vous pouvez définir votre PSKc à partir de la CLI OT Commissioner. Pour en savoir plus, consultez la page Mise en service externe.

Journalisation

Lorsque vous exécutez pi@raspberrypi: commissioner-cli à partir de la ligne de commande, le service de 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émarrer OT Commissioner avec vos paramètres de configuration:

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

Commander une jointure

Pour utiliser le commissaire OT pour commander un agent de jointure, reportez-vous à la section Mise en service externe.