Ver el código fuente en GitHub
En esta guía, se abordan la compilación y 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.
Configurar Comisionado de OT
Clona el repositorio del comisionado de OT:
git clone https://github.com/openthread/ot-commissioner
Instala las dependencias:
.cd ot-commissioner
./script/bootstrap.sh
Comisionado de OT
La comisión de OT se instala en el directorio /usr/local
. Si deseas cambiar el directorio de instalación, configura -DCMAKE_INSTALL_PREFIX
.
Comisionado de OT de compilación:
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
ninja -j1
Crea una variable de entorno para ejecutar
commissioner-cli
en el siguiente paso:export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
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:
- Biblioteca del comisionado de OT y archivos de encabezado
- Objeto binario ejecutable de la CLI de Commissioner de OT
- Archivos de configuración y credenciales predeterminados
- Secuencias de comandos para ejecutar la CLI de OT Commissioner como daemon
sudo ninja install
Para verificar la instalación, consulta el menú de ayuda.
$COMMISSIONER_CLI -h
Si instalaste el directorio en /usr/local
, commissioner-cli
estará disponible
desde la línea de comandos.
commissioner-cli -h
Configuración
La CLI de OT Commissioner admite tanto el modo de comisión comercial de Thread 1.2 como el comisionamiento de Thread 1.1 (que no es de CCM). A fin de conectarte a diferentes redes Thread, se necesita un archivo de configuración JSON para iniciar OT Commissioner CLI:
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 la red Thread que no es de CCM.
De forma predeterminada, estos archivos de configuración se instalan en /usr/local/etc/commissioner
. También puede ver archivos de muestra en el repositorio de GitHub de ot-commissioner.
Configuración de CCM
Para conectarse a una red Thread de CCM, actualiza estos campos en ccm-config.json
:
Campo | Descripción |
---|---|
DomainName |
Identificador único dentro del dominio empresarial. |
PrivateKeyFile |
El archivo de clave privada en formato PEM |
CertificateFile |
El archivo de certificado en formato PEM. |
TrustAnchorFile |
Es el archivo de anclaje de confianza en formato PEM. |
Estos archivos de clave y de certificado se usan para establecer sesiones seguras entre el comisionado y el agente de frontera.
Configuración que no es de CCM
La clave precompartida PSKc
se usa para establecer una sesión segura entre el comisionado y el agente de borde. Para conectarte a una red Thread que no sea de CCM, puedes configurar PSKc
desde la CLI de OT Commissioner. Para obtener más información, consulta Comisión externa.
Logging
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 establecer tu ruta de acceso LogFile
, el nivel de registro y otras opciones de registro.
Cargar configuración
Para iniciar Comisionado de OT con sus ajustes de configuración:
commissioner-cli /usr/local/etc/commissioner/ccm-config.json
Comisión de un carpintero
Si deseas usar el comisionado de OT para encargar una unión, consulta Comisionado externo.