cmake-nRF5x 项目使用教程

1. 项目的目录结构及介绍

/cmake/
    arm-none-eabi.cmake - ARM GCC Toolchain 文件
    nrf5.cmake - 核心 CMake 文件，检查用户提供的配置选项并定义核心库和函数（例如 nrf5_mdk）
    nrf5_validation.cmake - 根据 Nordic 网站的信息验证用户提供的配置
    nrf5_utils.cmake - 在上述文件中使用的实用函数
    nrf5_XXX.cmake - 可选的额外 nRF 库文件，推荐使用
/ci/
    examples/ - 包含手写的 CMakeLists.txt 文件
README.md - 项目说明文件
LICENSE - 项目许可证文件

2. 项目的启动文件介绍

项目的启动文件通常是 CMakeLists.txt，它位于项目的根目录。以下是一个基本的 CMakeLists.txt 示例：

cmake_minimum_required(VERSION 3.14)
project(blinky LANGUAGES C ASM)
include("nrf5")
add_executable(${CMAKE_PROJECT_NAME} "${NRF5_SDK_PATH}/examples/peripheral/blinky/main.c")
nrf5_target(${CMAKE_PROJECT_NAME})
target_link_libraries(${CMAKE_PROJECT_NAME} PRIVATE nrf5_nrfx_common nrf5_delay nrf5_boards)

3. 项目的配置文件介绍

项目的配置文件主要包括 CMakeLists.txt 和 arm-none-eabi.cmake。以下是一个基本的配置示例：

# 生成项目
cmake \
    -S . \
    -B build \
    -DCMAKE_TOOLCHAIN_FILE="cmake/arm-none-eabi.cmake" \
    -DTOOLCHAIN_PREFIX="/path/to/gcc" \
    -DNRF5_SDK_PATH="/path/to/nrf5-sdk" \
    -DNRF5_BOARD="pca10056" \
    -DNRF5_SOFTDEVICE_VARIANT="s140"

# 构建项目
cmake --build build

以上配置文件指定了工具链路径、nRF5 SDK 路径、目标板和 SoftDevice 变体。