ระบบบิวด์ 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
เป้าหมายนี้เป็นเป้าหมาย Phony ที่ใช้เพื่อการกําหนดการกําหนดค่าเพียงอย่างเดียวและลิงก์กับเป้าหมาย 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
ซึ่งเป็นที่ที่คุณกําหนดไฟล์แหล่งที่มา รวมเส้นทาง และแฟล็กคอมไพล์สําหรับไลบรารีแพลตฟอร์ม ตัวอย่างที่ดีของไฟล์นี้สําหรับที่เก็บซึ่งรองรับเพียงแพลตฟอร์มเดียวมาจาก ot-cc2538
การรองรับหลายแพลตฟอร์มในที่เก็บข้อมูลเดียวนั้นเป็นไปได้ และที่เก็บหลายแพลตฟอร์มสามารถใช้เป็นข้อมูลอ้างอิงได้ โปรดดู ot-efr32 และ ot-nrf528xx