Compilación y configuración del comisionado de OpenThread

Ver código fuente en GitHub

En esta guía, se abarca la compilación y la configuración básicas de OpenThread Commissioner (OT Commissioner). Una vez que completes este procedimiento, tendrás un ejecutable de la CLI de OT Commissioner y una biblioteca estática de comisión.

Configure el comisionado de PO

  1. Clona el repositorio de OT Commissioner:

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

  2. Instala las dependencias:

    cd ot-commissioner
    ./script/bootstrap.sh
    

Comisionado de PO de compilación

El comisionado de TI se instala en el directorio /usr/local. Si deseas cambiar el directorio de instalación, configura -DCMAKE_INSTALL_PREFIX.

  1. Compilador de PO:

    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
    

Instala el comisionado de PO

La comisión de TS instala lo siguiente en su directorio de instalación:

  • Biblioteca del comisionado de PO y archivos de encabezados
  • Objeto binario ejecutable de la CLI de comisión de PO
  • Archivos de configuración y credenciales predeterminados
  • Secuencias de comandos para ejecutar la CLI de OT Commissioner como daemon
sudo ninja install

Verifica la instalación en el menú de ayuda.

$COMMISSIONER_CLI -h

Si instalaste el directorio en el directorio /usr/local, puedes usar commissioner-cli desde la línea de comandos.

commissioner-cli -h

Configuración

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

  • 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 una red Thread no compatible con CCM.

De forma predeterminada, estos archivos de configuración se instalan en /usr/local/etc/commissioner. También puedes ver archivos de muestra en el repositorio de GitHub de ot-commissioner.

Configuración de CCM

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

Campo Descripción
DomainName Es un identificador único dentro del dominio empresarial.
PrivateKeyFile El archivo de claves privadas en formato PEM
CertificateFile El archivo de 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 que no es de CCM

La clave compartida previamente PSKc se usa para establecer una sesión segura entre el comisionado y el agente de borde. Para conectarse a una red Thread que no es de CCM, puede configurar su PSKc desde la CLI de OT Commissioner. Para obtener más información, consulta Comisión externa.

Registros

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

Cargar configuración

Para iniciar la comisión de PO con los parámetros de configuración, haz lo siguiente:

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

Solicitar una unión

Si deseas usar la comisión de PO para encargar un encargo, consulta Puestos externos.