1. 项目概述：为什么选择 XIAO nRF54LM20A Sense？

如果你最近在关注嵌入式开发，特别是低功耗蓝牙和传感器融合应用，那么“XIAO nRF54LM20A Sense”这个名字一定不会陌生。它不再是那个简单的、需要自己焊接传感器的原型板，而是直接集成了高精度六轴IMU（LSM6DSV16X）和麦克风（MP34DT06JTR）的“Sense”版本。这意味着，拿到手你就能立刻开始做姿态识别、语音唤醒、运动追踪这些项目，省去了大量外围电路设计和调试的麻烦。

但硬件只是基础，真正让它“活”起来的，是软件。这就是NRF Connect SDK（NCS）登场的时候。NCS是Nordic Semiconductor官方推出的、基于Zephyr RTOS的软件开发套件。它不是一个简单的库，而是一个完整的、面向现代物联网设备开发的生态系统。选择NCS来开发XIAO nRF54LM20A Sense，意味着你直接站在了Nordic官方支持的肩膀上，能够获得最稳定、最持续更新的蓝牙协议栈、电源管理、外设驱动和丰富的中间件（如传感器框架、DFU空中升级）。对于“Sense”版来说，NCS内置的传感器驱动和算法库（如Sensor API）能让你用几行代码就读到经过校准和滤波的传感器数据，而不是去啃寄存器手册。

所以，这个项目的核心，就是利用NCS这套强大的工具链，去充分释放XIAO nRF54LM20A Sense这块硬件的潜力。无论你是想做一个通过手势控制智能家居的遥控器，还是一个记录运动数据的可穿戴设备，或者是进行一些AI Agent在边缘端的初步探索（比如用板载麦克风做关键词识别），这个组合都能提供一个非常扎实的起点。它适合有一定嵌入式基础，想从传统裸机或简单RTOS转向更复杂、更现代的物联网开发框架的开发者，也适合那些想快速验证传感器应用创意的Maker。

2. 开发环境搭建与项目初始化

上手的第一步，就是把“厨房”准备好。NCS的开发环境搭建，是很多新手遇到的第一个门槛。它不像Arduino那样点几下鼠标就能完成，但一旦配置好，其效率和规范性是无可比拟的。

2.1 工具链安装：告别手动配置的烦恼

早期搭建NCS环境需要手动安装ARM GCC、CMake、Python依赖等一堆工具，版本冲突是家常便饭。现在，Nordic官方强烈推荐使用nRF Connect for Desktop中的Toolchain Manager。这是一个一站式的管理工具，它会自动为你下载并管理指定版本的NCS、对应的编译器、Python环境以及所有必要的依赖，并将它们封装在一个独立的“工具链目录”中。这彻底解决了环境污染和版本管理的问题。

具体操作是：先去Nordic官网下载并安装nRF Connect for Desktop。打开后，在“Toolchain Manager”里，你可以看到各个版本的NCS。对于XIAO nRF54LM20A（基于nRF54L15），建议选择最新的长期支持（LTS）版本，比如当前的v2.6.x LTS，它在稳定性和对nRF54系列的支持上是最佳的。点击安装，剩下的就交给工具。安装完成后，Toolchain Manager会提供一个命令行窗口的快捷入口，这个窗口已经配置好了所有环境变量。

注意：务必使用Toolchain Manager提供的命令行窗口进行后续所有操作。如果你习惯用VS Code，可以在这个命令行里启动code .，这样VS Code继承的环境也是正确的。自己系统里的终端很可能会因为找不到正确的工具链而编译失败。

2.2 获取SDK与创建项目

环境准备好后，我们需要获取NCS的源代码并创建一个针对XIAO板子的项目。NCS使用West（Zephyr的多仓库管理工具）来管理其由数十个Git仓库组成的代码树。

首先，在你喜欢的工作目录下，打开Toolchain Manager的命令行，使用West命令初始化并获取SDK：

west init -m https://github.com/nrfconnect/sdk-nrf --mr main-v2.6 ncs-workspace cd ncs-workspace west update

这条命令会创建一个名为ncs-workspace的目录，并将NCS v2.6分支的代码克隆到其中。west update会同步所有子模块。

接下来，我们基于一个示例项目来创建自己的应用。NCS提供了海量的示例（nrf/samples）。对于XIAO nRF54LM20A Sense，一个很好的起点是blinky（点灯）和sensor（传感器）示例的结合。但更规范的做法是使用Zephyr的模板。

我们可以直接复制一个接近的示例并修改。例如，复制一个简单的蓝牙外设示例并为其添加传感器支持：

cp -r nrf/samples/bluetooth/peripheral_uart my_xiao_sense_project cd my_xiao_sense_project

现在，你需要修改项目最关键的两个文件：prj.conf和CMakeLists.txt，以及板级定义。

2.3 板级配置与设备树（DTS）适配

XIAO nRF54LM20A Sense使用的是Seeed Studio的板子，其核心是nRF54L15芯片。NCS原生支持nRF54L15芯片，但不一定直接支持“XIAO nRF54LM20A Sense”这个具体的板型。我们需要进行板级配置。

1. 创建或指定板级定义：在NCS中，板级定义位于zephyr/boards/arm目录下。如果Seeed提供了官方的板级支持包（BSP），那最好不过。如果没有，我们可以基于最接近的板子进行修改，通常是Nordic的nRF54L15开发板（nrf54l15dk_nrf54l15）。

一个更简单实用的方法是，在项目目录下创建一个boards文件夹，然后放置一个自定义的板级定义。但更常见的做法是，直接在你的应用CMakeLists.txt中指定芯片型号，并通过设备树（Device Tree）覆盖文件来配置板载外设。

2. 使用设备树覆盖文件：设备树是Zephyr描述硬件的神器。我们创建一个boards目录，在里面为XIAO板子创建一个设备树覆盖文件，例如seeed_xiao_nrf54lm20a_sense.overlay：

// boards/seeed_xiao_nrf54lm20a_sense.overlay / { aliases { led0 = &blue_led; sw0 = &user_button; }; leds { compatible = "gpio-leds"; blue_led: led_0 { gpios = <&gpio1 12 GPIO_ACTIVE_LOW>; // 假设蓝色LED在P1.12，低电平点亮 label = "Blue LED"; }; }; buttons { compatible = "gpio-keys"; user_button: button_0 { gpios = <&gpio0 29 (GPIO_PULL_UP | GPIO_ACTIVE_LOW)>; // 假设按钮在P0.29，上拉，低有效 label = "User Button"; zephyr,code = <INPUT_KEY_0>; }; }; // 配置I2C1接口，用于连接IMU和麦克风（假设它们共用I2C） &i2c1 { compatible = "nordic,nrf-twim"; status = "okay"; pinctrl-0 = <&i2c1_default>; pinctrl-1 = <&i2c1_sleep>; pinctrl-names = "default", "sleep"; clock-frequency = <I2C_BITRATE_FAST>; // LSM6DSV16X 六轴IMU lsm6dsv16x: lsm6dsv16x@6a { compatible = "st,lsm6dsv16x"; reg = <0x6a>; label = "LSM6DSV16X"; // 可以配置中断引脚等 // drdy-gpios = <&gpio0 30 GPIO_ACTIVE_HIGH>; }; // MP34DT06JTR 麦克风（数字麦克风，通常走I2S或PDM，此处仅为示例，实际需查手册） // 注意：数字麦克风通常不走I2C，这里需要根据实际硬件连接调整。 // 如果麦克风是I2S接口，则需要配置i2s节点。 }; }; // 配置引脚控制（pinctrl） &pinctrl { i2c1_default: i2c1_default { group1 { psels = <NRF_PSEL(TWIM_SDA, 1, 02)>, // P1.02 作为 SDA <NRF_PSEL(TWIM_SCL, 1, 03)>; // P1.03 作为 SCL }; }; i2c1_sleep: i2c1_sleep { group1 { psels = <NRF_PSEL(TWIM_SDA, 1, 02)>, <NRF_PSEL(TWIM_SCL, 1, 03)>; low-power-enable; }; }; };

这个覆盖文件做了几件事：定义了LED和按钮的GPIO引脚（你需要根据XIAO的实际原理图修改引脚号）、启用了I2C1外设并配置了引脚、在I2C总线上添加了IMU传感器节点。麦克风的配置需要根据其实际接口（I2S/PDM）来，这里只是一个占位。

3. 在CMake中指定板型和覆盖文件：在你的项目CMakeLists.txt中，你需要告诉构建系统使用哪个板子和覆盖文件。

# CMakeLists.txt cmake_minimum_required(VERSION 3.20.0) find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE}) project(my_xiao_sense_project) # 指定目标板为nRF54L15的芯片，并应用我们的覆盖文件 set(BOARD nrf54l15dk_nrf54l15) # 先使用DK的板定义作为基础 set(DTC_OVERLAY_FILE ${CMAKE_CURRENT_SOURCE_DIR}/boards/seeed_xiao_nrf54lm20a_sense.overlay) target_sources(app PRIVATE src/main.c)

这样，编译时就会使用nRF54L15芯片的通用配置，并用我们的覆盖文件“打补丁”，适配XIAO Sense的具体硬件。

3. 核心功能实现：从点灯到读取传感器数据

环境搭好，项目架子立起来，接下来就是实现具体功能。我们从最简单的开始，逐步深入到传感器数据读取。

3.1 GPIO控制：让LED闪烁起来

虽然简单，但点灯是验证编译、烧录流程是否畅通的最佳方式。在Zephyr中，操作GPIO有标准的设备模型API。

首先，在prj.conf中确保GPIO驱动被启用：

# prj.conf CONFIG_GPIO=y

然后，在src/main.c中编写代码：

#include <zephyr/kernel.h> #include <zephyr/drivers/gpio.h> // 从设备树中获取LED0的设备指针 #define LED0_NODE DT_ALIAS(led0) static const struct gpio_dt_spec led = GPIO_DT_SPEC_GET(LED0_NODE, gpios); void main(void) { int ret; // 检查设备是否就绪 if (!device_is_ready(led.port)) { printk("Error: LED device is not ready\n"); return; } // 配置LED引脚为输出模式，初始为关闭状态（假设低电平点亮） ret = gpio_pin_configure_dt(&led, GPIO_OUTPUT_INACTIVE); if (ret < 0) { printk("Error configuring LED pin: %d\n", ret); return; } printk("Blinky example started on XIAO nRF54LM20A Sense\n"); while (1) { // 翻转LED状态 ret = gpio_pin_toggle_dt(&led); if (ret < 0) { printk("Error toggling LED: %d\n", ret); return; } // 延时500毫秒 k_msleep(500); } }

这段代码的关键在于GPIO_DT_SPEC_GET宏，它从我们之前在设备树覆盖文件中定义的led0别名获取到了具体的引脚配置（比如P1.12）。这就是设备树的威力——硬件配置与代码分离。修改硬件引脚时，只需改.overlay文件，无需碰C代码。

编译和烧录：

# 在项目目录下 west build -b nrf54l15dk_nrf54l15 west flash

west flash命令会自动调用nrfjprog或pyocd等工具将固件烧录到板子。如果看到蓝色LED开始规律闪烁，恭喜你，第一步成功了。

3.2 传感器数据读取：与IMU对话

XIAO Sense的核心是传感器。我们以LSM6DSV16X IMU为例，展示如何通过NCS的传感器子系统读取数据。

首先，需要在prj.conf中启用传感器驱动和必要的子系统：

# prj.conf CONFIG_I2C=y CONFIG_SENSOR=y CONFIG_LSM6DSV16X=y # 启用特定驱动 CONFIG_LSM6DSV16X_TRIGGER_NONE=y # 先不使用中断触发模式

然后，修改main.c：

#include <zephyr/kernel.h> #include <zephyr/drivers/sensor.h> #include <stdio.h> // 从设备树中获取IMU传感器设备指针 #define LSM6DSV16X_NODE DT_ALIAS(lsm6dsv16x) static const struct device *imu_dev = DEVICE_DT_GET(LSM6DSV16X_NODE); void main(void) { struct sensor_value accel[3], gyro[3], temp; // 检查传感器设备是否就绪 if (!device_is_ready(imu_dev)) { printk("Error: IMU device is not ready\n"); return; } printk("LSM6DSV16X IMU ready on XIAO Sense\n"); while (1) { // 1. 获取加速度计数据 if (sensor_sample_fetch_chan(imu_dev, SENSOR_CHAN_ACCEL_XYZ) == 0) { sensor_channel_get(imu_dev, SENSOR_CHAN_ACCEL_X, &accel[0]); sensor_channel_get(imu_dev, SENSOR_CHAN_ACCEL_Y, &accel[1]); sensor_channel_get(imu_dev, SENSOR_CHAN_ACCEL_Z, &accel[2]); printf("Accel: X=%.2f m/s^2, Y=%.2f m/s^2, Z=%.2f m/s^2\n", sensor_value_to_double(&accel[0]), sensor_value_to_double(&accel[1]), sensor_value_to_double(&accel[2])); } // 2. 获取陀螺仪数据 if (sensor_sample_fetch_chan(imu_dev, SENSOR_CHAN_GYRO_XYZ) == 0) { sensor_channel_get(imu_dev, SENSOR_CHAN_GYRO_X, &gyro[0]); sensor_channel_get(imu_dev, SENSOR_CHAN_GYRO_Y, &gyro[1]); sensor_channel_get(imu_dev, SENSOR_CHAN_GYRO_Z, &gyro[2]); printf("Gyro: X=%.2f dps, Y=%.2f dps, Z=%.2f dps\n", sensor_value_to_double(&gyro[0]), sensor_value_to_double(&gyro[1]), sensor_value_to_double(&gyro[2])); } // 3. 获取温度数据 if (sensor_sample_fetch_chan(imu_dev, SENSOR_CHAN_DIE_TEMP) == 0) { sensor_channel_get(imu_dev, SENSOR_CHAN_DIE_TEMP, &temp); printf("Temperature: %.2f C\n", sensor_value_to_double(&temp)); } printf("---\n"); k_msleep(100); // 100ms采样间隔 } }

Zephyr的传感器API设计得非常统一。无论是什么型号的传感器，只要驱动实现了标准的sensor_driver_api，你都可以用sensor_sample_fetch和sensor_channel_get这两个核心函数来获取数据。sensor_value结构体能智能地处理整数和小数值的转换，sensor_value_to_double则方便我们打印。

实操心得：在读取数据前，务必检查device_is_ready。传感器上电后可能需要几毫秒的初始化时间，如果立即读取可能会失败。另外，sensor_sample_fetch是实际发起I2C读取操作的函数，比较耗时。在低功耗应用中，应避免在循环中频繁调用，而应使用传感器的触发模式（如利用其内置的FIFO或配置DRDY中断引脚），在数据就绪时才去读取。

3.3 蓝牙连接与数据广播

作为一款nRF54系列芯片，蓝牙低功耗是其看家本领。我们实现一个简单的蓝牙外设，广播设备名称，并提供一个包含传感器数据的自定义服务。

首先，在prj.conf中配置蓝牙：

# prj.conf CONFIG_BT=y CONFIG_BT_PERIPHERAL=y CONFIG_BT_DEVICE_NAME="XIAO_Sense_Demo" CONFIG_BT_DEVICE_APPEARANCE=833 # 通用传感器的外观值 CONFIG_BT_SMP=y CONFIG_BT_GATT_DYNAMIC_DB=y

然后，我们创建一个自定义服务。在Zephyr中，通常使用bt_gatt_service来静态定义服务，但更灵活的方式是使用BT_GATT_SERVICE_DEFINE宏。我们在main.c中添加以下代码：

#include <zephyr/bluetooth/bluetooth.h> #include <zephyr/bluetooth/uuid.h> #include <zephyr/bluetooth/gatt.h> #include <zephyr/bluetooth/services/bas.h> // 电池服务（可选） // 自定义传感器服务UUID（可以随机生成，但确保唯一性） #define BT_UUID_SENSOR_SERVICE_VAL \ BT_UUID_128_ENCODE(0x12345678, 0x1234, 0x1234, 0x1234, 0x123456789abc) static struct bt_uuid_128 sensor_service_uuid = BT_UUID_INIT_128(BT_UUID_SENSOR_SERVICE_VAL); // 定义特征：加速度计数据 #define BT_UUID_ACCEL_CHAR_VAL \ BT_UUID_128_ENCODE(0x23456789, 0x2345, 0x2345, 0x2345, 0x23456789abcd) static struct bt_uuid_128 accel_char_uuid = BT_UUID_INIT_128(BT_UUID_ACCEL_CHAR_VAL); static uint8_t accel_data[12]; // 3个float，每个4字节 static float accel_x, accel_y, accel_z; // 读取加速度计特征的回调函数 static ssize_t read_accel(struct bt_conn *conn, const struct bt_gatt_attr *attr, void *buf, uint16_t len, uint16_t offset) { // 在实际应用中，这里应该去获取最新的传感器数据 // 我们这里用一个静态变量示例 memcpy(accel_data, &accel_x, 4); memcpy(accel_data+4, &accel_y, 4); memcpy(accel_data+8, &accel_z, 4); return bt_gatt_attr_read(conn, attr, buf, len, offset, accel_data, sizeof(accel_data)); } // 定义GATT服务、特征和属性 BT_GATT_SERVICE_DEFINE(sensor_svc, BT_GATT_PRIMARY_SERVICE(&sensor_service_uuid), BT_GATT_CHARACTERISTIC(&accel_char_uuid.uuid, BT_GATT_CHRC_READ, BT_GATT_PERM_READ, read_accel, NULL, NULL), ); // 蓝牙连接回调 static void connected(struct bt_conn *conn, uint8_t err) { if (err) { printk("Connection failed (err %u)\n", err); } else { printk("Connected\n"); } } static void disconnected(struct bt_conn *conn, uint8_t reason) { printk("Disconnected (reason %u)\n", reason); } BT_CONN_CB_DEFINE(conn_callbacks) = { .connected = connected, .disconnected = disconnected, }; void main(void) { int err; // 初始化蓝牙 err = bt_enable(NULL); if (err) { printk("Bluetooth init failed (err %d)\n", err); return; } printk("Bluetooth initialized\n"); // 开始广播 err = bt_le_adv_start(BT_LE_ADV_CONN_NAME, NULL, 0, NULL, 0); if (err) { printk("Advertising failed to start (err %d)\n", err); return; } printk("Advertising successfully started\n"); // 主循环：更新传感器数据（此处简化，实际应从传感器读取） while (1) { // 模拟更新传感器数据 // accel_x, accel_y, accel_z = ... (从IMU读取) k_msleep(1000); } }

这段代码做了几件事：

1. 定义了自定义的128位UUID服务和特征。
2. 实现了特征的读回调read_accel，当中心设备（如手机）读取该特征时，会触发这个函数返回最新的加速度数据。
3. 定义了连接事件回调。
4. 在main函数中初始化蓝牙并开始可连接广播。

编译烧录后，用手机上的蓝牙调试App（如nRF Connect）就能搜索到名为“XIAO_Sense_Demo”的设备，连接后可以看到我们自定义的服务和特征，并读取加速度数据。

注意事项：蓝牙协议栈和传感器驱动可能会竞争I2C总线或产生中断冲突。在复杂的应用中，建议使用Zephyr的线程（k_thread）来分离不同任务，并使用信号量（k_sem）或消息队列（k_msgq）进行线程间通信。例如，创建一个高优先级的线程专门以固定频率读取传感器数据并更新全局变量，蓝牙线程在收到读请求时直接读取这些全局变量，避免在GATT回调中进行可能阻塞的I2C操作。

4. 电源管理与低功耗优化

对于电池供电的“Sense”设备，功耗是生命线。nRF54L15和NCS提供了强大的电源管理工具，但需要正确配置才能发挥其优势。

4.1 系统功耗模式配置

在prj.conf中，我们可以进行基础的功耗配置：

# prj.conf CONFIG_PM=y # 启用电源管理 CONFIG_PM_DEVICE=y # 启用设备级电源管理 CONFIG_SENSOR=y CONFIG_SENSOR_INFO=y # 对于不需要一直工作的传感器，可以配置为按需上电 CONFIG_LSM6DSV16X_POWER_MODE=1 # 假设1代表低功耗模式，需查驱动源码

更关键的是应用逻辑的设计。我们的主循环在无事可做时，应该让系统进入低功耗状态。

void main(void) { // ... 初始化蓝牙、传感器等 ... // 配置一个周期性定时器，用于唤醒系统并采样 static struct k_timer sensor_timer; k_timer_init(&sensor_timer, NULL, NULL); k_timer_start(&sensor_timer, K_SECONDS(10), K_SECONDS(10)); // 每10秒采样一次 while (1) { // 1. 进入系统空闲状态，等待被中断唤醒（定时器、蓝牙事件、按钮等） k_sleep(K_FOREVER); // 2. 被唤醒后，检查唤醒源 if (k_timer_status_get(&sensor_timer) > 0) { // 定时器唤醒，执行传感器采样 read_sensor_data(); // 处理数据，例如判断是否超过阈值，决定是否通过蓝牙上报 process_data_and_notify(); // 重置定时器状态 k_timer_status_sync(&sensor_timer); } // 可以添加其他唤醒源的处理，如蓝牙连接事件 } }

这里使用了k_sleep(K_FOREVER)让主线程挂起，系统在没有任务时会自动进入最深的、允许的空闲状态（如System On Sleep）。定时器到期会产生中断，将系统唤醒，执行完采样任务后，又继续睡眠。

4.2 外设电源动态管理

NCS的设备模型支持运行时电源管理。对于传感器这类外设，我们可以在不需要时将其挂起（suspend）。

// 假设 imu_dev 是之前获取的传感器设备指针 int ret; // 在进入长时间睡眠前，挂起传感器 ret = pm_device_action_run(imu_dev, PM_DEVICE_ACTION_SUSPEND); if (ret < 0 && ret != -ENOSYS) { // ENOSYS表示设备不支持此操作 printk("Failed to suspend IMU: %d\n", ret); } // 在需要采样前，恢复传感器 ret = pm_device_action_run(imu_dev, PM_DEVICE_ACTION_RESUME); if (ret < 0 && ret != -ENOSYS) { printk("Failed to resume IMU: %d\n", ret); } k_msleep(5); // 给传感器一点启动稳定时间 read_sensor_data();

对于蓝牙，在广播或连接间隔期间，射频部分会自动进入低功耗状态。你可以通过调整广播间隔和连接参数来平衡功耗和响应速度。

// 更省电的广播参数 static struct bt_le_adv_param *adv_param = BT_LE_ADV_PARAM( (BT_LE_ADV_OPT_CONNECTABLE | BT_LE_ADV_OPT_USE_IDENTITY), 800, // 最小广播间隔 800*0.625ms = 500ms 1200, // 最大广播间隔 1200*0.625ms = 750ms NULL);

避坑技巧：测量功耗时，不要只看代码逻辑。一定要用电流表或Nordic的Power Profiler Kit II（PPK2）进行实际测量。有时一个忘记关闭的GPIO上拉、一个配置错误的时钟源，都会导致功耗飙升。使用NCS的CONFIG_PM_DEVICE_RUNTIME_LOG=y等调试选项，可以在串口日志中看到设备的电源状态切换，帮助定位问题。

5. 调试、烧录与问题排查实录

开发过程中，遇到问题是常态。一套高效的调试和问题排查方法至关重要。

5.1 串口日志与RTT输出

最基础的调试手段是串口日志。在prj.conf中启用并配置日志：

CONFIG_LOG=y CONFIG_LOG_MODE_IMMEDIATE=y # 立即模式，不缓冲，方便调试崩溃问题 CONFIG_LOG_BACKEND_UART=y CONFIG_LOG_BUFFER_SIZE=2048 CONFIG_PRINTK=y CONFIG_CONSOLE=y CONFIG_UART_CONSOLE=y CONFIG_SERIAL=y

连接XIAO的UART引脚（通常是P0.28/TX, P0.29/RX）到USB转串口工具，用终端软件（如PuTTY, screen, minicom）打开对应端口，波特率通常为115200，即可看到printk和日志输出。

对于更实时、不影响系统时序的调试，Segger RTT（Real Time Transfer）是更好的选择。它通过J-Link调试器直接在内存中读写日志，没有串口的速度限制和时序干扰。

CONFIG_LOG_BACKEND_RTT=y CONFIG_LOG_BACKEND_UART=n # 如果使用RTT，可以关闭UART后端 CONFIG_RTT_CONSOLE=y CONFIG_USE_SEGGER_RTT=y

使用J-Link连接XIAO的SWD接口，然后在主机上使用J-Link RTT Viewer或pyocd rtt命令即可查看日志。

5.2 使用调试器进行单步调试

当代码行为异常或崩溃时，单步调试是终极武器。你需要一个支持CMSIS-DAP或J-Link的调试器（如J-Link EDU，或者XIAO板载的DAPLink）。

1. 配置调试环境：在VS Code中安装Cortex-Debug扩展。
2. 创建调试配置：在项目.vscode/launch.json中添加配置。对于pyocd（如果板载是DAPLink）：

   { "version": "0.2.0", "configurations": [ { "name": "Cortex Debug (pyocd)", "cwd": "${workspaceFolder}", "executable": "${command:cmake.launchTargetPath}", "request": "launch", "type": "cortex-debug", "servertype": "pyocd", "serverpath": "pyocd", "device": "nRF54L15", "runToEntryPoint": "main", "svdFile": "${env:ZEPHYR_BASE}/../nrf/scripts/debug_svd/nrf54l15.svd" } ] }

3. 编译并调试：确保项目已用west build编译。在VS Code中设置断点，然后启动调试。你可以查看变量、寄存器、内存，一步步执行代码。

5.3 常见问题与解决方案速查表

以下是我在开发中遇到的一些典型问题及解决方法：

5.4 固件升级（DFU）

产品化离不开固件升级。NCS支持多种DFU方式，最常用的是通过蓝牙的空中升级（OTA DFU）和通过串口的MCUboot。

基于MCUboot和串口的DFU：

1. 编译引导程序（Bootloader）：NCS提供了集成的MCUboot支持。你需要先编译一个包含MCUboot的引导程序镜像。

   west build -b nrf54l15dk_nrf54l15 -- -DCONF_FILE=prj.conf path/to/mcuboot.conf west flash

2. 编译应用并生成可升级镜像：在应用项目的prj.conf中启用MCUboot支持（CONFIG_BOOTLOADER_MCUBOOT=y），并使用west sign命令对编译出的zephyr.bin进行签名，生成zephyr.signed.bin。
3. 升级：将signed.bin文件通过串口工具（如nRF Connect for Desktop的Programmer）烧录到MCUboot规定的次级Slot中，复位后MCUboot会验证并跳转。

基于蓝牙的OTA DFU：这更复杂，需要集成Nordic的DFU服务（CONFIG_BT_DFU_SMP=y）和相应的手机App（如nRF Connect）或网关来发起升级。其流程是：Bootloader（MCUboot） + 包含DFU服务的应用程序 + 新的应用程序镜像。手机App通过蓝牙将新镜像传输到设备，设备将其存入Flash的升级区，然后重启由MCUboot完成验证和覆盖升级。

我个人在开发中的体会是，在原型阶段，先用好日志和调试器快速定位问题。进入功耗优化阶段，必须依赖实际的电流测量工具。而在规划产品功能时，一定要把DFU方案考虑进去，哪怕最初只是预留一个串口升级接口，也能为后续迭代省去大量麻烦。对于XIAO nRF54LM20A Sense这样资源相对丰富的板子，在项目早期就启用CONFIG_BOOTLOADER_MCUBOOT并规划好Flash分区，是一个非常好的习惯。