Compilación y configuración del comisionado de OpenThread

Ver código fuente en GitHub

En esta guía, se abordan la compilación y configuración básicas del comisionado de OpenThread (Comisionado de OT). Al finalizar el procedimiento, tendrás una OT CLI de Commissioner ejecutable y una biblioteca estática Commissioner.

Configure el comisionado de OT

  1. Clona el repositorio del comisionado de OT: 

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

  2. Instala las dependencias: 

    cd ot-commissioner
./script/bootstrap.sh

Comisionado de OT del Build

El comisionado de OT realiza las instalaciones en el directorio /usr/local. Si quieres cambiar de tu directorio de instalación, configura -DCMAKE_INSTALL_PREFIX.

  1. Comisionado de OT de Build: 

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

  2. Crea una variable de entorno para ejecutar commissioner-cli en el siguiente paso: 

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

  3. Opcional. Ejecuta pruebas de unidades: 

    ./tests/commissioner-test

Instalación del comisionado de OT

El comisionado de OT instala lo siguiente en tu directorio de instalación:

  • Archivos de encabezado y biblioteca del comisionado de OT
  • Objeto binario ejecutable de la CLI del comisionado de OT
  • Credenciales y archivos de configuración predeterminados
  • Secuencias de comandos para ejecutar la CLI del comisionado de OT como daemon
sudo ninja install

Para verificar la instalación, consulta el menú de ayuda.

$COMMISSIONER_CLI -h

Si instalaste el directorio /usr/local, commissioner-cli estará disponible. desde la línea de comandos.

commissioner-cli -h

Configuración

La CLI del comisionado de OT admite tanto el modo de comisión comercial de Thread 1.2 (CCM) y Thread 1.1 (no CCM). Para conectarte a Thread diferentes redes, se necesita un archivo de configuración JSON para iniciar la CLI del comisionado de OT:

  • ccm-config.json: Es el archivo de configuración predeterminado para la red de subprocesos de CCM.
  • non-ccm-config.json: Es el archivo de configuración predeterminado para el subproceso que no es CCM. de Google.

De forma predeterminada, estos archivos de configuración se instalan en /usr/local/etc/commissioner. Puedes Consulta también los archivos de muestra en el repositorio de GitHub de OT-commissioner.

Configuración de la CCM

Para conectarte a una red de Thread de CCM, actualiza estos campos en ccm-config.json:

Campo Descripción
DomainName Identificador único dentro del dominio empresarial.
PrivateKeyFile El archivo de claves privadas en formato PEM.
CertificateFile Archivo del certificado en formato PEM.
TrustAnchorFile El archivo de anclaje de confianza en formato PEM.

Estos archivos de claves y certificados se usan para establecer sesiones seguras entre el Comisionado y el Agente de Frontera.

Configuración no CCM

La clave precompartida PSKc se usa para establecer una sesión segura entre las Comisionado y agente de frontera. Para conectarte a una red Thread que no es CCM, Puedes configurar tu PSKc desde la CLI del comisionado de OT. Para obtener más información, consulta Comisionado externo.

Logging

Cuando ejecutas pi@raspberrypi: commissioner-cli desde la línea de comandos, El comisionado de OT crea un archivo commissioner.log en el archivo directorio, por ejemplo, /home/pi/commissioner.log. En la configuración de JSON puedes configurar la ruta de acceso LogFile, el nivel de registro y otras configuración.

Cargar configuración

Para iniciar el comisionado de OT con tus parámetros de configuración, haz lo siguiente:

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

Encarga a un carpintero

Si deseas usar el comisionado de OT para encargar a un carpintero, consulta Información externa Comisión.