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
Clona el repositorio de OT Commissioner:
git clone https://github.com/openthread/ot-commissioner
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
.
Compilador de PO:
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
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.