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 deste procedimento, você terá um executável da CLI do OT Commissioner e uma biblioteca estática do 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 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.

Criar o comissário de OT:

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