Kompilacja i konfiguracja komisarza OpenThreader

Wyświetl źródło na GitHubie

W tym przewodniku omawiamy podstawową kompilację i konfigurację komisarza OpenThreader. (komisarza OT). Po zakończeniu tej procedury otrzymasz OT. Plik wykonywalny interfejsu wiersza poleceń komisarza i statyczna biblioteka komisarza.

Skonfiguruj komisarza OT

  1. Sklonuj repozytorium OT Commissioner: 

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

  2. Zainstaluj zależności: 

    cd ot-commissioner
./script/bootstrap.sh

Komisarz generalny Build

Komisarz OT instaluje aplikację w katalogu /usr/local. Jeśli chcesz zmienić w katalogu instalacji ustaw -DCMAKE_INSTALL_PREFIX.

  1. Komisarz ds. Operowania na zewnątrz Build: 

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

  2. Utwórz zmienną środowiskową do uruchamiania funkcji commissioner-cli w następnym kroku: 

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

  3. Opcjonalnie. Przeprowadzanie testów jednostkowych: 

    ./tests/commissioner-test

Komisarz instalacji OT

OT Commissioner instaluje w katalogu instalacji ten program:

  • Biblioteka i pliki nagłówka OT Commissioner
  • Plik wykonywalny interfejsu wiersza poleceń OT komisarza
  • Domyślne pliki konfiguracji i dane logowania
  • Skrypty do uruchamiania interfejsu wiersza poleceń OT Commissioner jako demon
sudo ninja install

Sprawdź instalację, korzystając z menu pomocy.

$COMMISSIONER_CLI -h

Jeśli aplikacja została zainstalowana w katalogu /usr/local, dostępna jest wersja commissioner-cli. w wierszu poleceń.

commissioner-cli -h

Konfiguracja

Interfejs wiersza poleceń OT Commissioner CLI obsługuje zarówno tryb przekazywania komercyjnego Thread 1.2, (CCM) i realizację Thread 1.1 (innych niż CCM). Łączenie z innym Thread sieci, do uruchomienia interfejsu wiersza poleceń OT komisarza potrzebny jest plik konfiguracji JSON:

  • ccm-config.json – domyślny plik konfiguracji sieci Thread CCM.
  • non-ccm-config.json – domyślny plik konfiguracji wątku innego niż CCM Sieć.

Domyślnie te pliki konfiguracji są instalowane w /usr/local/etc/commissioner. Dostępne opcje wyświetl też przykładowe pliki w repozytorium ot-commissioner na GitHubie.

Konfiguracja narzędzia do zarządzania zgodą użytkowników

Aby połączyć się z siecią CCM Thread, zaktualizuj te pola w usłudze ccm-config.json:

Pole Opis
DomainName Unikalny identyfikator w domenie firmowej.
PrivateKeyFile Plik klucza prywatnego w formacie PEM.
CertificateFile Plik certyfikatu w formacie PEM.
TrustAnchorFile Plik kotwicy zaufania w formacie PEM.

Te pliki kluczy i certyfikatów służą do ustanawiania bezpiecznych sesji między komisarza i agenta granicznego.

Konfiguracja inna niż CCM

Wstępnie udostępniony klucz PSKc służy do ustanowienia bezpiecznej sesji między Komisarza i agenta. Aby połączyć się z siecią inną niż CCM Thread: może ustawić PSKc za pomocą interfejsu wiersza poleceń OT Commissioner. Aby dowiedzieć się więcej, zapoznaj się z artykułem na temat przekazywania do użytku zewnętrznego.

Logowanie

Gdy uruchomisz pi@raspberrypi: commissioner-cli z poziomu wiersza poleceń, Komisarz OT tworzy plik commissioner.log w bieżącym działaniu katalogu, na przykład /home/pi/commissioner.log. W konfiguracji JSON możesz skonfigurować ścieżkę LogFile, poziom logowania i inne ustawieniach.

Wczytaj konfigurację

Aby uruchomić komisarza OT z ustawieniami konfiguracji:

commissioner-cli /usr/local/etc/commissioner/ccm-config.json

Zlecenie łączenia

Aby skorzystać z pomocy komisarza ds. usług OT, zapoznaj się z sekcją Zewnętrzne Prowizje.