ระบบบิลด์ 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