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