Esta página foi traduzida pela API Cloud Translation.

Build e configuração do OpenThread Commissioner

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

Configurar o OT Commissioner

Clone o repositório do OT Commissioner:

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

Instale as dependências:

cd ot-commissioner
./script/bootstrap.sh

Criar OT Commissioner

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

Criar o OT Commissioner:

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

Crie uma variável de ambiente para executar commissioner-cli na próxima etapa:
```
export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
```
Opcional: Execute testes de unidade:
```
./tests/commissioner-test
```

Instalar o OT Commissioner

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

Biblioteca OT Commissioner e arquivos principais
Binário executável da CLI OT Commissioner
Arquivos e credenciais de configuração padrão
Scripts para executar a CLI OT Commissioner como daemon

sudo ninja install

Para verificar a instalação, consulte o 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 CLI OT Commissioner é compatível com o comissionamento Thread 1.2 Commercial Commissioning (CCM) e Thread 1.1 Commissioning (Non-CCM). 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 CCM Thread Network.
non-ccm-config.json: o arquivo de configuração padrão da rede Thread não CCM.

Por padrão, esses arquivos de configuração são instalados no /usr/local/etc/commissioner. Você também pode ver arquivos de amostra no repositório ot-commissioner do GitHub.

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 â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 fronteira.

Configuração não-CCM

A chave pré-compartilhada PSKc é usada para estabelecer uma sessão segura entre o comissionador 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 Comissionamento externo.

Logging

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

Comissionamento de um combinador

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