ระบบบิลด์ CMake ใช้ไฟล์ CMakeLists.txt รายการที่ระบุเป้าหมายของบิลด์ CMakeLists.txt ที่รูทของที่เก็บคือด้านบนสุดของโครงสร้างบิลด์ และเป็นตำแหน่งที่ดีในการเริ่มกำหนดเป้าหมาย ตัวเลือก และมาโครต่างๆ ที่ใช้ในกระบวนการสร้าง
ค่าแรกที่ต้องกําหนดคือชื่อโปรเจ็กต์และแพลตฟอร์มที่รองรับ
ในตัวอย่างนี้ เราตั้งชื่อโปรเจ็กต์เป็น ot-efr32 ด้วยเวอร์ชัน 0.0.1 นอกจากนี้ เรายังกำหนดตัวแปร EFR32_PLATFORM_VALUES ซึ่งเป็นรายการของ efr32 แพลตฟอร์มที่ ot-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}")
ตัวเลือก CMake ของ OpenThread
คุณสามารถเปิดใช้/ปิดใช้/กำหนดค่าฟีเจอร์ต่างๆ ใน OpenThread เพื่อกำหนดตัวแปร CMake
ในแพลตฟอร์ม 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)
จากเอกสารประกอบของ CMake
เพิ่ม OpenThread ลงในโครงสร้างบิลด์
หากต้องการรวมโมดูลย่อย openthread ในแผนผังบิลด์ ให้ทำดังนี้
add_subdirectory(openthread)
ส่งพร็อพเพอร์ตี้ของบิลด์ไปยัง OpenThread
ส่วนสุดท้ายของไฟล์นี้ช่วยให้คุณสามารถกำหนดพร็อพเพอร์ตี้ของบิลด์ (เช่น คำจำกัดความ ตัวเลือก และรวมไดเรกทอรี) ซึ่งคุณอาจต้องการเพิ่มลงในโครงสร้างบิลด์ openthread และไลบรารีแพลตฟอร์มของคุณ
วิธีที่สะดวกในการเพิ่มคําจํากัดความเหล่านี้คือการใช้เป้าหมาย ot-config เป้าหมายนี้เป็นเป้าหมายปลอมที่ใช้เพื่อการกำหนดค่าเท่านั้น และลิงก์กับเป้าหมาย CMake เกือบทั้งหมดใน 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
)
เพิ่มไดเรกทอรีย่อยลงในแผนผังบิลด์
เมื่อกำหนดค่าระดับบนสุดแล้ว ก็ถึงเวลาเพิ่มไดเรกทอรีย่อยอื่นๆ ในโครงสร้างบิวด์
โฟลเดอร์ src คือที่ที่ซอร์สโค้ดของเลเยอร์ Platform-abstraction อยู่ โฟลเดอร์ third_party มีโค้ดของบุคคลที่สาม
หากคุณต้องการรวมแอปพลิเคชันตัวอย่างในที่เก็บ ให้สร้างโฟลเดอร์ examples และเพิ่มไว้ในโครงสร้างบิลด์ด้วย
add_subdirectory(src) add_subdirectory(third_party) # Optional add_subdirectory(examples)
ไดเรกทอรี src
ซึ่งเป็นหัวใจของที่เก็บและเป็นส่วนที่ใช้เลเยอร์ Abstraction ของแพลตฟอร์ม นอกจากนี้ยังมีไฟล์อื่นๆ ที่จำเป็นอีกสองสามไฟล์ด้วย
src/arm-none-eabi.cmake
นี่เป็นไฟล์ Toolchain ซึ่งระบุตัวแปรบางอย่างที่ CMake ใช้ในกระบวนการบิลด์ เริ่มต้นด้วยการคัดลอกไฟล์นี้ในเวอร์ชัน ot-efr32 แล้วแก้ไขให้เหมาะกับแพลตฟอร์มของคุณ
src/CMakeLists.txt
ซึ่งเป็นที่ที่คุณระบุไฟล์แหล่งที่มา เส้นทาง รวมถึงแฟล็กคอมไพเลอร์สำหรับไลบรารีแพลตฟอร์ม ตัวอย่างที่ดีของไฟล์นี้สำหรับที่เก็บที่รองรับเพียงแพลตฟอร์มเดียวคือไฟล์จาก ot-cc2538
ที่เก็บเดียวรองรับหลายแพลตฟอร์ม และใช้ที่เก็บแพลตฟอร์มหลายแห่งเป็นข้อมูลอ้างอิงได้ ดู ot-efr32 และ ot-nrf528xx