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.