Visualizza l'origine su GitHub
Questa guida illustra la build e la configurazione di base di OpenThread Commissioner (OT Commissioner). Al termine di questa procedura, avrai un comando eseguibile dell'interfaccia a riga di comando di OT Commissioner e una libreria di Commissioner statica.
Configura OT Commissioner
Clona il repository OT Commissioner:
git clone https://github.com/openthread/ot-commissioner
Installa le dipendenze:
cd ot-commissioner
./script/bootstrap.sh
Build OT Commissioner
OT Commissioner si installa nella directory /usr/local
. Se vuoi modificare la directory di installazione, imposta -DCMAKE_INSTALL_PREFIX
.
Build 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 test delle unità:
./tests/commissioner-test
Installa OT Commissioner
OT Commissioner installa quanto segue nella directory di installazione:
- File della libreria e delle intestazioni di OT Commissioner
- Autorizzazione binaria eseguibile dell'interfaccia a riga di comando di OT Commissioner
- Credenziali e file di configurazione predefiniti
- Script per eseguire l'interfaccia a riga di comando di OT Commissioner come daemon
sudo ninja install
Verifica l'installazione controllando il menu Guida.
$COMMISSIONER_CLI -h
Se hai installato la directory /usr/local
, commissioner-cli
è disponibile dalla riga di comando.
commissioner-cli -h
Configurazione
L'interfaccia a riga di comando OT Commissioner supporta sia la modalità Commissioni Commerciali Thread 1.2 (CCM) sia la commissione Thread 1.1 (non CCM). Per connetterti a reti Thread diverse, è necessario un file di configurazione JSON per avviare l'interfaccia a riga di comando di OT Commissioner:
ccm-config.json
: il file di configurazione predefinito per CCM Thread Network.non-ccm-config.json
: il file di configurazione predefinito per la rete Thread non CCM.
Per impostazione predefinita, questi file di configurazione sono installati in /usr/local/etc/commissioner
. Puoi anche visualizzare i file di esempio nel repository GitHub 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 Enterprise. |
PrivateKeyFile |
Il file della chiave privata in formato PEM. |
CertificateFile |
Il file del certificato in formato PEM. |
TrustAnchorFile |
Il file di ancoraggio di trust in formato PEM. |
Questi file della chiave e del certificato vengono utilizzati per stabilire sessioni sicure tra il commissario e l'agente di confine.
Configurazione non CRM
La chiave precondivisa PSKc
viene utilizzata per stabilire una sessione sicura tra il Commissioner e l'agente di confine. Per connetterti a una rete Thread non CSM, puoi
impostare PSKc
dall'interfaccia a riga di comando OT Commissioner. Per ulteriori informazioni, consulta Commissione esterna.
Logging
Quando esegui pi@raspberrypi: commissioner-cli
dalla riga di comando, OT Commissioner crea un file commissioner.log
nella directory di lavoro attuale, ad esempio /home/pi/commissioner.log
. Nel file di configurazione JSON, puoi configurare il percorso LogFile
, il livello di logging e altre impostazioni del log.
Carica configurazione
Per avviare OT Commissioner con le impostazioni di configurazione:
commissioner-cli /usr/local/etc/commissioner/ccm-config.json
Commissioni per la partecipazione
Per utilizzare OT Commissioner per commissionare un joiner, fai riferimento a External Commissioning.