System kompilacji CMake korzysta z plików CMakeLists.txt
, które definiują cele kompilacji. CMakeLists.txt
w katalogu głównym repozytorium to góra drzewa kompilacji. To dobre miejsce do rozpoczęcia definiowania różnych celów, opcji i makr używanych w procesie kompilacji.
Zacznij od zdefiniowania wartości projektu i obsługiwanych platform.
W tym przykładzie ustawiliśmy nazwę projektu na ot-efr32
z wersją 0.0.1
. Definiujemy również zmienną EFR32_PLATFORM_VALUES
, która zawiera listę platform efr32
obsługiwanych przez ot-efr32
. W tym przykładzie zdefiniowaliśmy kilka platform, ale dla zmiennej _PLATFORM_VALUES
można też korzystać z jednej platformy.
cmake_minimum_required(VERSION 3.10.2) project(ot-efr32 VERSION 0.0.1) set(EFR32_PLATFORM_VALUES "efr32mg1" "efr32mg12" "efr32mg13" "efr32mg21" )
Plik CMakeLists.txt
zawiera kontrolę, która przerywa kompilacje uruchamiane na nieobsługiwanych platformach.
set_property(CACHE EFR32_PLATFORM PROPERTY STRINGS ${EFR32_PLATFORM_VALUES}) if(NOT EFR32_PLATFORM IN_LIST EFR32_PLATFORM_VALUES) message(FATAL_ERROR "Please select a supported platform: ${EFR32_PLATFORM_VALUES}") endif()
Kolejna zmienna, którą należy zdefiniować, to OT_PLATFORM_LIB
. Ta zmienna jest używana przez przykładowe aplikacje OpenThread do łączenia się z Twoją platformą.
set(OT_PLATFORM_LIB "openthread-${EFR32_PLATFORM}")
Opcje CMake na platformie OpenThread
Różne funkcje OpenThread można włączać, wyłączać lub konfigurować przez zdefiniowanie zmiennych CMake.
Na platformie ot-efr32
używana jest zewnętrzna biblioteka mbedTLS silabs-mbedtls
.
set(OT_BUILTIN_MBEDTLS_MANAGEMENT OFF CACHE BOOL "disable builtin mbedtls management" FORCE) set(OT_EXTERNAL_MBEDTLS "silabs-mbedtls" CACHE STRING "use silabs mbedtls" FORCE) set(OT_MBEDTLS ${OT_EXTERNAL_MBEDTLS})
Zdefiniuj katalogi wyjściowe
Katalog wyjściowy dla różnych plików docelowych można skonfigurować za pomocą poniższych zmiennych.
set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/lib) set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/lib) set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/bin)
Dodaj OpenThread do drzewa kompilacji
Aby uwzględnić moduł podrzędny openthread
w drzewie kompilacji:
add_subdirectory(openthread)
Przekazywanie właściwości kompilacji do OpenThread
Ostatnia sekcja tego pliku pozwala zdefiniować właściwości kompilacji (np. definicje, opcje i katalogi), które warto dodać do drzewa kompilacji openthread
i do bibliotek platformy.
Te definicje możesz łatwo dodać za pomocą celu ot-config
. Ten cel jest fałszywym celem, który służy wyłącznie do definiowania konfiguracji i jest połączony z prawie wszystkimi celami CMake w openthread
.
# Define config filename macros target_compile_definitions(ot-config INTERFACE OPENTHREAD_CONFIG_FILE="openthread-core-efr32-config.h" OPENTHREAD_PROJECT_CORE_CONFIG_FILE="openthread-core-efr32-config.h" OPENTHREAD_CORE_CONFIG_PLATFORM_CHECK_FILE="openthread-core-efr32-config-check.h" ) # Disable -Wshadow and -Wpedantic target_compile_options(ot-config INTERFACE -Wno-shadow -Wno-pedantic ) # Add platform dirs to "include" dirs target_include_directories(ot-config INTERFACE ${PROJECT_SOURCE_DIR}/src/src ${PROJECT_SOURCE_DIR}/src/${EFR32_PLATFORM} ${PROJECT_SOURCE_DIR}/src/${EFR32_PLATFORM}/crypto )
Dodaj podkatalogi do drzewa kompilacji
Po zdefiniowaniu konfiguracji najwyższego poziomu możesz dodać do drzewa kompilacji inne podkatalogi.
Folder src
zawiera kod źródłowy warstwy abstrakcyjnej platformy. Folder third_party
zawiera kod innej firmy.
Jeśli chcesz umieścić w repozytorium przykładowe aplikacje, utwórz folder examples
i dodaj go także do drzewa kompilacji.
add_subdirectory(src) add_subdirectory(third_party) # Optional add_subdirectory(examples)
Katalog src
To jest serce repozytorium i w nim jest zaimplementowana warstwa abstrakcji platformy. Zawiera też kilka innych wymaganych plików.
src/arm-none-eabi.cmake
To jest plik łańcucha narzędzi, który definiuje niektóre zmienne używane w CMake w procesie kompilacji. Możesz zacząć od skopiowania wersji ot-efr32
tego pliku i zmodyfikowania go, aby pasował do Twojej platformy.
src/CMakeLists.txt
W tym miejscu definiuje się pliki źródłowe, dołączanie ścieżek i flag kompilatora dla biblioteki platformy. Dobrym przykładem tego pliku dla repozytorium, które obsługuje tylko 1 platformę, jest ot-cc2538
.
Istnieje możliwość obsługi wielu platform w jednym repozytorium. Można też wykorzystać kilka repozytoriów platform jako odniesienia. Zobacz ot-efr32 i ot-nrf528xx.