FreeRTOS에서 CMake 사용

CMake를 사용하여 FreeRTOS 애플리케이션 소스 코드에서 프로젝트 빌드 파일을 생성하고 소스 코드를 빌드 및 실행할 수 있습니다.

IDE를 사용하여 FreeRTOS 적격 디바이스에서 코드를 편집, 디버깅, 컴파일, 플래시 및 실행할 수도 있습니다. 각 보드별 시작 안내서에는 특정 플랫폼용 IDE 설정 지침이 포함되어 있습니다. IDE 없이 작업하려면 다른 타사 코드 편집 및 디버깅 도구를 사용하여 코드를 개발 및 디버깅한 다음 CMake를 사용하여 애플리케이션을 빌드하고 실행할 수 있습니다.

CMake를 지원하는 보드는 다음과 같습니다.

FreeRTOS에서 CMake를 사용하는 방법에 대한 자세한 내용은 아래 주제를 참조하세요.

사전 조건 

계속하기 전에 호스트 시스템이 다음 사전 조건을 충족하는지 확인하십시오.

타사 코드 편집기 및 디버깅 도구를 사용하여 FreeRTOS 애플리케이션 개발

코드 편집기, 디버깅 확장 또는 타사 디버깅 도구를 사용하여 FreeRTOS용 애플리케이션을 개발할 수 있습니다.

예를 들어 Visual Studio Code를 코드 편집기로 사용하는 경우 Cortex-Debug VS Code 확장을 디버거로 설치할 수 있습니다. 애플리케이션 개발을 마치면 CMake 명령줄 도구를 호출하여 VS Code 내에서 프로젝트를 빌드할 수 있습니다. CMake를 사용한 FreeRTOS 애플리케이션 빌드에 대한 자세한 내용은 CMake를 사용하여 FreeRTOS 빌드 섹션을 참조하세요.

디버깅을 위해 다음과 비슷한 디버그 구성으로 VS Code를 제공할 수 있습니다.

"configurations": [
    {
        "name": "Cortex Debug",
        "cwd": "${workspaceRoot}",
        "executable": "./build/st/stm32l475_discovery/aws_demos.elf",
        "request": "launch",
        "type": "cortex-debug",
        "servertype": "stutil"
    }
]

CMake를 사용하여 FreeRTOS 빌드

CMake는 기본적으로 호스트 운영 체제를 대상 시스템으로 사용합니다. CMake를 교차 컴파일에 사용하려면 도구 체인 파일이 필요합니다. 이 파일은 사용할 컴파일러를 지정합니다. FreeRTOS에서는 기본 도구 체인 파일이 freertos/tools/cmake/toolchains에서 제공됩니다. 이 파일을 CMake에 제공하는 방법은 CMake 명령줄 인터페이스를 사용하는지, 아니면 GUI를 사용하는지에 따라 다릅니다. 추가 세부 정보는 아래 빌드 파일 생성(CMake 명령줄 도구) 지침을 따르십시오. CMake에서의 크로스 컴파일에 대한 자세한 내용은 공식 CMake CrossCompiling위키에서 참조하십시오.

빌드 파일 생성(CMake 명령줄 도구)

CMake 명령줄 도구(cmake)를 사용하여 FreeRTOS 빌드 파일을 생성할 수 있습니다. 빌드 파일을 생성하려면 대상 보드, 컴파일러, 소스 코드와 빌드 디렉터리의 위치를 지정해야 합니다.

cmake에는 다음 옵션을 사용할 수 있습니다.

예를 들어, 공급업체가 Texas Instruments이고 보드가 CC3220 Launchpad이며 컴파일러가 ARM용 GCC인 경우, 다음 명령을 실행하여 현재 디렉터리에서 build-directory 디렉터리로 소스 파일을 빌드할 수 있습니다.

cmake -DVENDOR=ti -DBOARD=cc3220_launchpad -DCOMPILER=arm-ti -S . -B build-directory

cmake -DVENDOR=ti -DBOARD=cc3220_launchpad -DCOMPILER=arm-ti -S . -B build-directory -G Ninja

cmake -DVENDOR=ti -DBOARD=cc3220_launchpad -DCOMPILER=arm-ti -S . -B build-directory -G "MinGW Makefiles"

정규 표현식 ${VENDOR}.* 및 ${BOARD}.*는 일치하는 보드를 검색하는 데 사용되므로 VENDOR 및 BOARD 옵션에 대해 공급업체 및 보드의 전체 이름을 사용할 필요가 없습니다. 일치하는 항목이 하나만 있는 경우 이름의 일부만 사용해도 됩니다. 예를 들어, 다음 명령은 동일한 소스에서 동일한 빌드 파일을 생성합니다.

cmake -DVENDOR=ti -DCOMPILER=arm-ti -S . -B build-directory

cmake -DBOARD=cc3220 -DCOMPILER=arm-ti -S . -B build-directory

cmake -DVENDOR=t -DBOARD=cc -DCOMPILER=arm-ti -S . -B build-directory

기본 디렉터리 cmake/toolchains에 없는 도구 체인 파일을 사용하려면 CMAKE_TOOLCHAIN_FILE 옵션을 사용할 수 있습니다. 예:

cmake -DBOARD=cc3220 -DCMAKE_TOOLCHAIN_FILE='/path/to/toolchain_file.cmake' -S . -B build-directory

도구 체인 파일이 컴파일러에 대한 절대 경로를 사용하지 않고 컴파일러를 PATH 환경 변수에 추가하지 않은 경우 CMake가 해당 경로를 찾을 수 없습니다. CMake가 도구 체인 파일을 찾을 수 있게 하려면 AFR_TOOLCHAIN_PATH 옵션을 사용합니다. 이 옵션은 bin 아래에서 지정된 도구 체인 디렉터리 경로와 도구 체인의 하위 폴더를 검색합니다. 예:

cmake -DBOARD=cc3220 -DCMAKE_TOOLCHAIN_FILE='/path/to/toolchain_file.cmake' -DAFR_TOOLCHAIN_PATH='/path/to/toolchain/' -S . -B build-directory

디버깅을 활성화하려면 CMAKE_BUILD_TYPE을 debug로 설정합니다. 이 옵션을 활성화한 경우 CMake는 디버그 플래그를 컴파일 옵션에 추가하고 디버그 기호로 FreeRTOS를 빌드합니다.

# Build with debug symbols
cmake -DBOARD=cc3220 -DCOMPILER=arm-ti -DCMAKE_BUILD_TYPE=debug -S . -B build-directory

CMAKE_BUILD_TYPE을 release로 설정하여 컴파일 옵션에 최적화 플래그를 추가할 수도 있습니다.

빌드 파일 생성(CMake GUI)

CMake GUI를 사용하여 FreeRTOS 빌드 파일을 생성할 수 있습니다.

생성된 빌드 파일에서 FreeRTOS 빌드

네이티브 빌드 시스템을 사용하여 빌드

출력 바이너리 디렉터리에서 빌드 시스템 명령을 호출하여 네이티브 빌드 시스템으로 FreeRTOS를 빌드할 수 있습니다.

예를 들어, 빌드 파일 출력 디렉터리가 <build_dir>이고 네이티브 빌드 시스템으로 Make를 사용하는 경우 다음 명령을 실행하세요.

cd <build_dir>
make -j4

CMake를 사용하여 빌드

CMake 명령줄 도구를 사용하여 FreeRTOS를 빌드할 수도 있습니다. CMake는 네이티브 빌드 시스템을 호출하기 위한 추상 계층을 제공합니다. 예:

cmake --build build_dir

다음은 CMake 명령줄 도구의 빌드 모드를 사용하는 몇 가지 일반적인 사례입니다.

# Take advantage of CPU cores.
cmake --build build_dir --parallel 8

# Build specific targets.
cmake --build build_dir --target afr_kernel

# Clean first, then build.
cmake --build build_dir --clean-first

CMake 빌드 모드에 대한 자세한 내용은 CMake 설명서를 참조하십시오.