CMake 建構系統需要使用 CMakeLists.txt
檔案來定義建構目標。存放區根目錄的 CMakeLists.txt
是建構樹狀結構的頂端,非常適合用來定義在建構程序中使用的各種目標、選項和巨集。
第一個要定義的值是專案名稱和支援的平台。
在本範例中,我們將專案名稱設為 ot-efr32
,版本為 0.0.1
。我們也定義變數 EFR32_PLATFORM_VALUES
,此清單為 ot-efr32
支援的 efr32
平台清單。在此範例中,我們定義了多個平台,但也可以為 _PLATFORM_VALUES
變數設定單一平台。
cmake_minimum_required(VERSION 3.10.2) project(ot-efr32 VERSION 0.0.1) set(EFR32_PLATFORM_VALUES "efr32mg1" "efr32mg12" "efr32mg13" "efr32mg21" )
CMakeLists.txt
檔案內含一項檢查,確認已針對不支援的平台啟動取消版本。
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()
下一個需要定義的變數是 OT_PLATFORM_LIB
。OpenThread 範例應用程式會使用這個變數連結至您的平台。
set(OT_PLATFORM_LIB "openthread-${EFR32_PLATFORM}")
OpenThread CMake 選項
定義 CMake 變數時,可啟用/停用/設定 OpenThread 中的各種功能。
ot-efr32
平台上使用外部 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})
定義輸出目錄
您可以使用下列變數設定不同目標檔案的輸出目錄。
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)
將 OpenThread 新增至建構樹狀結構
如要在建構樹狀結構中加入 openthread
子模組,請按照下列指示操作:
add_subdirectory(openthread)
將建構屬性傳遞至 OpenThread
這個檔案的最後區段可讓您定義要加入 openthread
建構樹狀結構和平台程式庫的建構屬性 (例如定義、選項和包含目錄)。
使用 ot-config
目標即可輕鬆新增這些定義。這個目標僅用於定義設定,並且與 openthread
中絕大多數的 CMake 目標建立連結。
# 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 )
新增子目錄至建構樹狀結構
頂層設定已定義完成,接著可以新增其他子目錄到建構樹狀結構中。
src
資料夾是平台抽象層原始碼的位置。third_party
資料夾含有任何第三方程式碼。
如要在存放區中納入範例應用程式,請建立 examples
資料夾,並將其新增至建構樹狀結構。
add_subdirectory(src) add_subdirectory(third_party) # Optional add_subdirectory(examples)
src
目錄
這是存放區的核心,也是平台抽象層的實作位置。還包含一些其他必要檔案。
src/arm-none-eabi.cmake
這是工具鍊檔案,用於定義 CMake 在建構程序中使用的某些變數。建議您複製這個檔案的ot-efr32
版本,並根據平台需求修改檔案。
src/CMakeLists.txt
您可以在此定義平台程式庫的來源檔案、包含路徑和編譯器標記。ot-cc2538
這個檔案對於僅支援單一平台的存放區來說有一個很好的範例。
在單一存放區中支援多個平台,而多個平台存放區可做為參考。請參閱 ot-efr32 和 ot-nrf528xx。