Wyświetl źródło na GitHubie
System kompilacji CMAKE korzysta z plików CMakeLists.txt
, które definiują cele kompilacji. CMakeLists.txt
w katalogu głównym repozytorium to wierzchołek drzewa kompilacji i stanowi dobre miejsce do definiowania różnych celów, opcji i makr używanych podczas procesu kompilacji.
Pierwsze wartości do zdefiniowania to nazwa projektu i obsługiwane platformy.
W tym przykładzie ustawiliśmy nazwę projektu na ot-efr32
w wersji 0.0.1
. Określamy też zmienną EFR32_PLATFORM_VALUES
, która zawiera listę efr32
platform obsługiwanych przez ot-efr32
. W tym przykładzie zdefiniowaliśmy wiele platform, ale jedna z nich ma zmienną _PLATFORM_VALUES
.
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 uruchomione 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()
Kolejną zmienną, którą trzeba zdefiniować, jest 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 tworzenia kodu OpenThread
Uwaga: ta sekcja jest opcjonalna.
Różne funkcje OpenThread można włączyć, wyłączyć lub skonfigurować, definiując zmienne 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
Uwaga: ta sekcja jest opcjonalna.
Katalog wyjściowy dla różnych plików docelowych możesz skonfigurować za pomocą zmiennych poniżej.
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)
Uwaga: listę zmiennych udostępnionych lub używanych przez CMAKE znajdziesz w dokumentacji producenta .
Dodaj OpenThread do drzewa kompilacji
Aby w kompilacji drzewa uwzględnić moduł podrzędny openthread
:
add_subdirectory(openthread)
Przekazywanie właściwości kompilacji do OpenThread
Ostatnia sekcja tego pliku umożliwia zdefiniowanie właściwości kompilacji (np. definicji, opcji i katalogów), które możesz dodać do drzewa kompilacji openthread
i do bibliotek platformy.
Aby łatwo dodawać te definicje, użyj wartości docelowej ot-config
. Ten cel jest celowy. Jest on używany wyłącznie do definiowania konfiguracji i jest połączony z niemal 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
Skoro konfiguracja najwyższego poziomu jest już zdefiniowana, dodaj do niej inne podkatalogi.
Folder src
zawiera kod źródłowy warstwy migawki platformy. Folder third_party
zawiera kod innej firmy.
Jeśli w repozytorium chcesz uwzględnić przykładowe aplikacje, utwórz folder examples
i dodaj go do drzewa kompilacji.
add_subdirectory(src)
add_subdirectory(third_party)
# Optional
add_subdirectory(examples)
Katalog src
To jest serce repozytorium i w tym miejscu jest zaimplementowana warstwa abstrakcji platformy. Plik zawiera też kilka innych wymaganych plików.
src/arm-none-eabi.cmake
Jest to plik z łańcuchem narzędzi, który definiuje niektóre zmienne, które CMake wykorzystuje w procesie kompilacji. Na początek skopiuj wersję tego pliku ot-efr32
i zmodyfikuj go, aby pasował do Twojej platformy.
src/CMakeLists.txt
Tutaj możesz określić pliki źródłowe, uwzględnić ścieżki i flagi kompilacji w Twojej bibliotece platformy. Dobrym przykładem tego pliku jest repozytorium ot-cc2538
, które obsługuje tylko jedną platformę.
W jednym repozytorium możliwa jest obsługa wielu platform, a replika może być używana jako kilka repozytoriów. Patrz ot-efr32 i ot-nrf528xx .