Build e configuração do OpenThread Commissioner

Veja o código-fonte no GitHub

Este guia aborda a criação e a configuração básicas do OpenThread Commissioner (OT Commissioner). Após a conclusão deste procedimento, você terá um executável da CLI do OT Commissioner e uma biblioteca estática do Commissioner.

Configurar o OT Commissioner

  1. Clone o repositório do OT Commissioner:

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

  2. Instale as dependências:

    cd ot-commissioner
    ./script/bootstrap.sh
    

Criar um OT Commissioner

O OT Commissioner é instalado no diretório /usr/local. Se quiser mudar o diretório de instalação, defina -DCMAKE_INSTALL_PREFIX.

  1. Criar o comissário de OT:

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

  2. Crie uma variável de ambiente para executar commissioner-cli na próxima etapa:

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

  3. Opcional: Execute testes de unidade:

    ./tests/commissioner-test
    

Instalar o OT Commissioner

O OT Commissioner instala o seguinte no seu diretório de instalação:

  • Arquivos principais e de biblioteca do OT Commissioner
  • Binário executável da CLI OT da comissão
  • Arquivos de configuração e credenciais padrão
  • Scripts para executar a CLI OT Commissioner como daemon
sudo ninja install

Confira a instalação pelo menu de ajuda.

$COMMISSIONER_CLI -h

Se você instalou no diretório /usr/local, o commissioner-cli está disponível na linha de comando.

commissioner-cli -h

Configuração

A CLI OT Commissioner é compatível com o modo de comissionamento comercial (CCM, na sigla em inglês) da Thread 1.2 e o comissionamento (Não CCM) da Thread 1.1. Para se conectar a diferentes redes Thread, um arquivo de configuração JSON é necessário para iniciar a CLI OT Commissioner:

  • ccm-config.json: o arquivo de configuração padrão da rede da linha de execução do CCM.
  • non-ccm-config.json: o arquivo de configuração padrão da rede da linha de execução não CCC.

Por padrão, esses arquivos de configuração são instalados em /usr/local/etc/commissioner. Também é possível ver exemplos de arquivos no repositório ot-commissioner do GitHub (link em inglês).

Configuração do CCM

Para se conectar a uma rede Thread CCM, atualize estes campos no ccm-config.json:

Campo Descrição
DomainName Identificador exclusivo no domínio empresarial.
PrivateKeyFile O arquivo da chave privada no formato PEM.
CertificateFile O arquivo de certificado no formato PEM.
TrustAnchorFile O arquivo âncora de confiança no formato PEM.

Esses arquivos de chave e certificado são usados para estabelecer sessões seguras entre o Comissário e o Agente de Borda.

Configuração não-CCM

A chave pré-compartilhada PSKc é usada para estabelecer uma sessão segura entre o comissor e o agente de borda. Para se conectar a uma rede Thread não-CCM, defina o PSKc na CLI OT Commissioner. Para mais informações, consulte Comissões externas.

Geração de registros

Quando você executa pi@raspberrypi: commissioner-cli na linha de comando, o OT Commissioner cria um arquivo commissioner.log no diretório de trabalho atual, por exemplo, /home/pi/commissioner.log. No arquivo de configuração JSON, você pode definir o caminho LogFile, o nível de registro e outras configurações de registro.

Carregar configuração

Para iniciar o OT Commissioner com suas configurações:

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

Encomendar um membro

Para usar o OT Commissioner para encomendar um combinador, consulte Comissão externa.