CMake 규칙 정의

GitHub에서 소스 보기

작성자 Mason Tran

SiLabs 참여

CMake 빌드 시스템은 빌드 타겟을 정의하는 CMakeLists.txt 파일에 의존합니다. 저장소 루트에 있는 CMakeLists.txt는 빌드 트리의 맨 위에 있으며 빌드 프로세스에 사용되는 다양한 타겟, 옵션, 매크로를 정의하기에 좋은 위치입니다.

가장 먼저 정의해야 하는 값은 프로젝트 이름과 지원되는 플랫폼입니다.

이 예시에서는 프로젝트 이름을 0.0.1 버전인 ot-efr32으로 설정합니다. ot-efr32에서 지원하는 efr32 플랫폼 목록인 EFR32_PLATFORM_VALUES 변수도 정의합니다. 이 예에서는 여러 플랫폼을 정의했지만 _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 옵션

CMake 변수를 정의하여 OpenThread의 다양한 기능을 사용 설정/사용 중지/구성할 수 있습니다.

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 빌드 트리와 플랫폼 라이브러리에 추가할 빌드 속성 (예: 정의, 옵션 및 include 디렉터리)을 정의할 수 있습니다.

이러한 정의를 추가하는 편리한 방법은 ot-config 타겟을 사용하는 것입니다. 이 타겟은 구성을 정의하는 목적으로만 사용되며 openthread의 거의 모든 CMake 타겟에 의해 연결되는 가짜 타겟입니다.

# 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

이 파일은 CMake가 빌드 프로세스에서 사용하는 일부 변수를 정의하는 도구 모음 파일입니다. 우선 이 파일의 ot-efr32 버전을 복사하여 플랫폼에 맞게 수정하는 것이 좋습니다.

src/CMakeLists.txt

여기에서 플랫폼 라이브러리의 소스 파일, include 경로 및 컴파일러 플래그를 정의합니다. 단일 플랫폼만 지원하는 저장소에 대한 이 파일의 좋은 예는 ot-cc2538에 있습니다.

단일 저장소에서 여러 플랫폼을 지원할 수 있으며 여러 플랫폼 저장소를 참조로 사용할 수 있습니다. ot-efr32 및 ot-nrf528xx를 참고하세요.