กําหนดกฎ CMake

ดูแหล่งข้อมูลใน GitHub

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

ซึ่งเป็นหัวใจของที่เก็บและใช้สําหรับเลเยอร์นามธรรมของแพลตฟอร์ม และมีไฟล์อื่นๆ ที่จําเป็นด้วย

src/arm-none-eabi.cmake

ซึ่งเป็นไฟล์ Toolchain ที่กําหนดตัวแปรบางอย่างที่ CMake ใช้ในกระบวนการบิลด์ จุดเริ่มต้นที่ดีคือการคัดลอกไฟล์นี้ในเวอร์ชัน ot-efr32 แล้วปรับให้พอดีกับแพลตฟอร์ม

src/CMakeLists.txt

นี่คือที่ที่คุณกําหนดไฟล์ต้นฉบับ รวมเส้นทาง และแฟล็กคอมไพเลอร์สําหรับไลบรารีแพลตฟอร์มของคุณ ตัวอย่างที่ดีของไฟล์นี้สําหรับที่เก็บซึ่งรองรับแพลตฟอร์มเดียวเท่านั้นมาจาก ot-cc2538

รองรับหลายแพลตฟอร์มในที่เก็บรายการเดียวและใช้ที่เก็บแพลตฟอร์มหลายรายการเป็นข้อมูลอ้างอิงได้ โปรดดู ot-efr32 และ ot-nrf528xx