Kompilacja i konfiguracja komponentu OpenCommerer Commissioner

Wyświetl źródło w GitHub

Ten przewodnik zawiera podstawowe instrukcje dotyczące konfiguracji i konfiguracji tej usługi. Po zakończeniu tej procedury otrzymasz plik wykonywalny interfejsu wiersza poleceń OT i statyczną bibliotekę komisarza.

Skonfiguruj OT Commissioner

  1. Skopiuj repozytorium OT Commissioner: 

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

  2. Zainstaluj zależności: 

    cd ot-commissioner
./script/bootstrap.sh

Komisarz sprzedawców

OT Commissioner instaluje w katalogu /usr/local. Jeśli chcesz zmienić katalog instalacyjny, ustaw -DCMAKE_INSTALL_PREFIX.

  1. Komisarz dot. utworzenia: 

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

  2. Utwórz zmienną środowiskową, która pozwoli uruchomić aplikację commissioner-cli w następnym kroku: 

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

  3. Opcjonalny. Przeprowadź testy jednostkowe: 

    ./tests/commissioner-test

Zainstaluj OT Commissioner

OT Commissioner instaluje do katalogu instalacji następujące elementy:

  • Pliki biblioteki nagłówków i nagłówka nagłówka
  • Plik binarny interfejsu wiersza poleceń OT Commissioner
  • Domyślne pliki konfiguracji i dane logowania
  • skrypty do uruchamiania interfejsu wiersza poleceń OT Commission, jak demon;
sudo ninja install

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

$COMMISSIONER_CLI -h

Jeśli została zainstalowana w katalogu /usr/local, plik commissioner-cli jest dostępny w wierszu polecenia.

commissioner-cli -h

Konfiguracja

Interfejs wiersza poleceń OT Commissioner obsługuje zarówno tryb prowizji Thread 1.2 (CCM), jak i prowizję Thread 1.1 (inną niż CCM). Aby połączyć się z różnymi sieciami wątków, potrzebny jest plik konfiguracji JSON z uruchomieniem interfejsu wiersza poleceń OT Commissioner:

  • ccm-config.json – domyślny plik konfiguracji sieci CCM Thread Network.
  • non-ccm-config.json – domyślny plik konfiguracji sieci spoza wątku CCM.

Domyślnie te pliki konfiguracji są instalowane w folderze /usr/local/etc/commissioner. Przykładowe pliki znajdziesz też narepozytorium GitHub ot-commissioner danych

Konfiguracja CCM

Aby połączyć się z siecią wątków CCM, zaktualizuj następujące pola w aplikacji ccm-config.json:

Pole Opis
DomainName Unikalny identyfikator w domenie Enterprise.
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 nawiązywania bezpiecznych sesji między komisarzem a agentem granicznym.

Konfiguracja inna niż CCM

Klucz wstępny PSKc służy do nawiązania bezpiecznej sesji między komisarzem a agentem granicznym. Aby połączyć się z siecią spoza wątku, możesz ustawić PSKc za pomocą interfejsu wiersza poleceń OT Commissioner. Więcej informacji znajdziesz w sekcji Prowizje zewnętrzne.

Logowanie

Po uruchomieniu pi@raspberrypi: commissioner-cli z poziomu wiersza poleceń OT Commission tworzy plik commissioner.log w bieżącym katalogu roboczym, na przykład /home/pi/commissioner.log. W pliku konfiguracyjnym JSON możesz skonfigurować ścieżkę LogFile, poziom rejestrowania i inne ustawienia dziennika.

Wczytaj konfigurację

Aby uruchomić komisarza OT z ustawieniami konfiguracji:

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

Połącz prowizję

Informacje o zachęcaniu użytkowników do nawiązywania kontaktów znajdziesz w sekcji Zewnętrzne prowizje.