Google is committed to advancing racial equity for Black communities. See how.

Zbuduj OpenThread

Wyświetl źródło na GitHub

Jak zbudować OpenThread

Kroki budowania OpenThread różnią się w zależności od łańcucha narzędzi, maszyny użytkownika i platformy docelowej.

Najczęstszym przepływem pracy jest:

  1. Skonfiguruj środowisko kompilacji i zainstaluj żądany zestaw narzędzi:
    1. Aby zbudować bezpośrednio na maszynie, zobacz Symulacja Codelab uzyskać szczegółowe instrukcje
    2. Aby używać pojemnik Docker z wstępnie skonfigurowane środowisko, należy pobrać i uruchomić OpenThread environment obrazu:
      docker pull openthread/environment:latest
      docker run -it --rm openthread/environment bash
      
  2. W wybranym środowisku sklonuj repozytorium OpenThread Git specyficzne dla platformy. Biorąc CC2538 jak np
    git clone https://github.com/openthread/ot-cc2538.git --recursive
    
  3. Z katalogu głównego sklonowanego repozytorium:
    1. Zainstalować toolchain:
      ./script/bootstrap
      
    2. Budowanie konfiguracji:
      ./script/build platform-specific-args cmake-options
      
  4. Flash żądany plik binarny do platformy docelowej. Wszystkie wygenerowane pliki binarne znajdują się w ./build/bin .

Konfiguracja

Możesz skonfigurować OpenThread dla różnych funkcji i zachowań podczas procesu kompilacji. Dostępne opcje konfiguracji są wyszczególnione w następujących lokalizacjach:

Rodzaj Lokalizacja
Stałe czasu kompilacji Wymienione w wszystkich plików nagłówkowych w /src/core/config
Opcje kompilacji cmake Wymienione w openthread/examples/README.md

Przykłady budowania

Użyj opcji kompilacji cmake, aby włączyć funkcjonalność platformy. Na przykład, aby zbudować plik binarny dla platformy CC2538 z włączoną obsługą Commissioner i Joiner:

./script/build -DOT_COMMISSIONER=ON -DOT_JOINER=ON

Lub, aby zbudować platformę nRF52840 z funkcją wykrywania Jam włączony swoim repo:

./script/build nrf52840 UART_trans -DOT_JAM_DETECTION=ON

Binaria

Następujące pliki binarne są generowane w ./build/bin z procesu kompilacji. Aby określić, które pliki binarne są generowane, flagi USE z ./script/build polecenia. Na przykład, aby zbudować OpenThread i wygenerować tylko plik binarny FTD CLI:

./script/build -DOT_APP_CLI=ON -DOT_FTD=ON -DOT_MTD=OFF -DOT_APP_NCP=OFF -DOT_APP_RCP=OFF -DOT_RCP=OFF
Dwójkowy Opis Opcje
ot-cli-ftd Urządzenie z pełnym gwintem do projektów SoC -DOT_APP_CLI=ON
-DOT_FTD=ON
ot-cli-mtd Urządzenie z minimalnym gwintem do projektów SoC -DOT_APP_CLI=ON
-DOT_MTD=ON
ot-ncp-ftd Urządzenie z pełnym wątkiem do projektów sieciowych współprocesorów (NCP) -DOT_APP_NCP=ON
-DOT_FTD=ON
ot-ncp-mtd Urządzenie Minimal Thread dla projektów NCP -DOT_APP_NCP=ON
-DOT_MTD=ON
ot-rcp Projekt współprocesora radiowego (RCP) -DOT_APP_RCP=ON
-DOT_RCP=ON

Domyślnie wszystkie powyższe flagi są włączone. Jeśli wyraźnie wyłączyć wszystkie flagi, aplikacje nie są budowane, ale pliki bibliotek OpenThread nadal są generowane w ./build/lib do wykorzystania w projekcie.

Sprawdź przykładowe pliki Makefile dla każdej platformy, aby zobaczyć, które flagi obsługuje każda platforma. Aby uzyskać więcej informacji na temat FTD i MTDs, zobacz wątek Primer . Aby uzyskać więcej informacji na temat projektów SoC i NCP, zobacz Platformy .

Proces flashowania tych plików binarnych różni się w zależności od przykładowych platform. Zobacz README w każdym platformy przykład folderze na szczegółowe instrukcje.

Demon OpenThread

OpenThread Daemon (OT Daemon) to tryb kompilacji OpenThread POSIX, który uruchamia OpenThread jako usługę i jest używany z projektem RCP. Aby uzyskać więcej informacji o tym, jak budować i używać go zobaczyć OpenThread demona .

Buduj pakiety wsparcia

Pakiety wsparcia budowy (BSP) znajdują się w /third_party . BSP to dodatkowy kod innych firm używane przez OpenThread na każdej odpowiedniej platformy, zazwyczaj uwzględniane przy przenoszeniu OpenThread na nową platformę sprzętową.