Creazione e configurazione di OpenThread Commissioner

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

  1. Clona il repository OT Commissioner:

    git clone https://github.com/openthread/ot-commissioner
    

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

  1. Build OT Commissioner:

    mkdir build
    cd build
    cmake -DCMAKE_INSTALL_PREFIX=/usr/local -GNinja ..
    ninja -j1
    

  2. Crea una variabile di ambiente per eseguire commissioner-cli nel passaggio successivo:

    export COMMISSIONER_CLI=/usr/local/bin/commissioner-cli
    

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