Zdefiniuj reguły CMake

Wyświetl źródło w GitHub

System kompilacji CMake korzysta z plików CMakeLists.txt, które określają cele kompilacji. CMakeLists.txt w katalogu głównym repozytorium to górna część drzewa kompilacji. To dobre miejsce, by zacząć definiować różne cele, opcje i makra używane w procesie kompilacji.

Pierwsze wartości do zdefiniowania to nazwa projektu i obsługiwane platformy.

W tym przykładzie nazwa projektu to ot-efr32 w wersji 0.0.1. Definiujemy także zmienną EFR32_PLATFORM_VALUES, czyli listę platform efr32 obsługiwanych przez narzędzie ot-efr32. Na potrzeby naszego przykładu zdefiniowaliśmy wiele platform, ale możesz mieć jedną platformę dla zmiennej _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ę, że przerywa działanie kompilacji 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()

Następna zmienna, którą należy zdefiniować, to OT_PLATFORM_LIB. Ta zmienna jest używana przez przykładowe aplikacje typu OpenThread, aby połączyć ją z Twoją platformą.

set(OT_PLATFORM_LIB "openthread-${EFR32_PLATFORM}")

Opcje CMake w OpenThread

Różne funkcje programu OpenThread można włączyć/wyłączyć/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

Katalog wyjściowy dla różnych plików docelowych można skonfigurować przy użyciu 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)

Dodawanie OpenThread do drzewa kompilacji

Aby w drzewie kompilacji uwzględnić moduł podrzędny openthread:

add_subdirectory(openthread)

Przekazuj właściwości kompilacji do OpenThread

W ostatniej części tego pliku możesz zdefiniować właściwości kompilacji (np. definicje, opcje i katalogi), które możesz dodać do drzewa kompilacji openthread oraz bibliotek platformy.

Wygody możesz dodawać za pomocą celu ot-config. To cel jest fałszywą metodą, która służy wyłącznie do definiowania konfiguracji i jest powiązana 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
)

Dodawanie podkatalogów do drzewa kompilacji

Po zdefiniowaniu konfiguracji najwyższego poziomu nadszedł czas na dodanie innych podkatalogów do drzewa kompilacji.

W folderze src znajduje się kod źródłowy warstwy abstrakcji platformy. Folder third_party zawiera kod innej firmy.

Jeśli chcesz uwzględnić przykładowe aplikacje w repozytorium, utwórz folder examples i dodaj go też do drzewa kompilacji.

add_subdirectory(src)
add_subdirectory(third_party)

# Optional
add_subdirectory(examples)

katalog src

Jest to serce repozytorium, gdzie zaimplementowano warstwę abstrakcji platformy. Zawiera on także kilka innych wymaganych plików.

src/arm-none-eabi.cmake

Jest to plik zestawu narzędzi, który określa zmienne używane przez CMake w procesie kompilacji. Najlepiej zacząć od skopiowania wersji ot-efr32 pliku i dostosowania go do swojej platformy.

src/CMakeLists.txt

Tutaj definiujesz pliki źródłowe, dołączasz ścieżki i flagi kompilacji dla biblioteki platformy. Dobrym przykładem tego pliku jest repozytorium z ot-cc2538, które obsługuje tylko jedną platformę.

Możliwe jest korzystanie z wielu platform w jednym repozytorium jako odniesienia. Zobacz ot-efr32 i ot-nrf528xx.