Visualizza il codice sorgente su GitHub
Questa guida illustra la build e la configurazione di base di OpenThread Commissioner. (OT Commissioner). Una volta completata questa procedura, Eseguibile dell'interfaccia a riga di comando di Commissioner e una libreria statica di Commissioner.
Configura OT Commissioner
Clona il repository di OT Commissioner:
git clone https://github.com/openthread/ot-commissioner
Installa le dipendenze:
cd ot-commissioner
./script/bootstrap.sh
Commissario OT per la creazione
OT Commissioner esegue l'installazione nella directory /usr/local
. Se desideri modificare
nella directory di installazione, imposta -DCMAKE_INSTALL_PREFIX
.
Creazione OT Commissioner:
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
ninja -j1
Crea una variabile di ambiente per eseguire
commissioner-cli
nel passaggio successivo:export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
Facoltativo. Esegui i test delle unità:
./tests/commissioner-test
Installa OT Commissioner
OT Commissioner installa quanto segue nella directory di installazione:
- Libreria e file di intestazione OT Commissioner
- Programma binario eseguibile dell'interfaccia a riga di comando OT Commissioner
- Credenziali e file di configurazione predefiniti
- Script per eseguire l'interfaccia a riga di comando OT Commissioner come daemon
sudo ninja install
Verifica l'installazione controllando il menu Guida.
$COMMISSIONER_CLI -h
Se hai eseguito l'installazione nella directory /usr/local
, commissioner-cli
è disponibile
dalla riga di comando.
commissioner-cli -h
Configurazione
L'interfaccia a riga di comando di OT Commissioner supporta sia la modalità di messa in servizio commerciale di Thread 1.2 (CCM) e Thread 1.1 (non CCM). Per connettersi a Thread diverso è necessario un file di configurazione JSON per avviare l'interfaccia a riga di comando OT Commissioner:
ccm-config.json
: il file di configurazione predefinito per la rete Thread CCM.non-ccm-config.json
: il file di configurazione predefinito per il thread non CCM Google Cloud.
Per impostazione predefinita, questi file di configurazione sono installati in /usr/local/etc/commissioner
. Puoi
Puoi inoltre visualizzare i file di esempio nel repository GitHub di ot-commissioner.
Configurazione CCM
Per connetterti a una rete Thread CCM, aggiorna questi campi in ccm-config.json
:
Campo | Descrizione |
---|---|
DomainName |
Identificatore univoco all'interno del dominio aziendale. |
PrivateKeyFile |
Il file della chiave privata in formato PEM. |
CertificateFile |
Il file del certificato in formato PEM. |
TrustAnchorFile |
Il file trust anchor in formato PEM. |
Questi file di chiavi e certificati vengono utilizzati per stabilire sessioni sicure tra il commissario e l'agente di frontiera.
Configurazione non CCM
La chiave precondivisa PSKc
viene utilizzata per stabilire una sessione sicura tra
Commissario e agente di frontiera. Per connetterti a una rete Thread non CCM, devi
puoi impostare PSKc
dall'interfaccia a riga di comando di OT Commissioner. Per ulteriori informazioni,
consulta la sezione Messa in servizio esterna.
Logging
Quando esegui pi@raspberrypi: commissioner-cli
dalla riga di comando,
OT Commissioner crea un file commissioner.log
nell'attuale standard
dell'applicazione, ad esempio /home/pi/commissioner.log
. Nella configurazione JSON
puoi configurare il percorso LogFile
, il livello di logging e altri log
impostazioni.
Carica configurazione
Per avviare OT Commissioner con le tue impostazioni di configurazione:
commissioner-cli /usr/local/etc/commissioner/ccm-config.json
Commissione un joiner
Per utilizzare OT Commissioner per commissionare un joiner, consulta le istruzioni Messa in servizio.