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