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.