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 OT O executável da CLI do 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 comissário de OT

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

  1. Comissário de criação 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. Executar testes de unidade:

    ./tests/commissioner-test
    

Instalar o OT Commissioner

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

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

Confirme a instalação no menu de ajuda.

$COMMISSIONER_CLI -h

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

commissioner-cli -h

Configuração

A OT Commissioner CLI oferece suporte ao modo de comissionamento comercial do Thread 1.2 (CCM) e comissionamento do Thread 1.1 (não CCM). Para se conectar a uma linha de execução diferente é necessário um arquivo de configuração JSON para iniciar a OT Commissioner CLI:

  • ccm-config.json: o arquivo de configuração padrão para a rede Thread CCM.
  • non-ccm-config.json: o arquivo de configuração padrão para linhas de execução não CMM do Google.

Por padrão, esses arquivos de configuração são instalados em /usr/local/etc/commissioner. Você pode Veja também os arquivos de exemplo no repositório ot-commissioner do GitHub (em inglês).

Configuração do CCM

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

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

Esses arquivos de chave e certificado são usados para estabelecer sessões seguras entre comissário e agente de borda.

Configuração não CMM

A chave pré-compartilhada PSKc é usada para estabelecer uma sessão segura entre as Comissário e Agente de Fronteira. Para se conectar a uma rede Thread não CMM, pode definir seu PSKc na CLI do OT Commissioner. Para mais informações, consulte Comissão externa.

Logging

Quando você executa pi@raspberrypi: commissioner-cli na linha de comando, O OT Commissioner cria um arquivo commissioner.log no trabalho atual como /home/pi/commissioner.log. Na configuração do JSON é possível configurar o caminho LogFile, o nível de geração de registros e outros configurações.

Configuração de carregamento

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

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

Comissão de um marceneiro

Para usar o OT Commissioner para contratar um parceiro, consulte Externo Comissionamento.