3. 软件调试环境搭建：STM32CubeIDE调试配置、串口日志输出、RTT使用
调试环境这东西，说白了就是你跟芯片对话的窗口。窗口搭不好，后面所有低功耗调优都像在摸黑走路。我见过不少工程师，代码写得漂亮，但一进调试就抓瞎——日志乱码、断点失效、功耗测量时调试器还在偷偷供电。嗯，这节课咱们就把这几个坑一个一个填平。
3.1 STM32CubeIDE调试配置——别让调试器坏了你的低功耗好事
STM32CubeIDE 基于 Eclipse，调试器核心是 OpenOCD + GDB。配置本身不复杂，但有几个开关跟低功耗调试直接相关，搞错了会出大问题。
3.1.1 调试器连接模式：SWD vs JTAG
低功耗板子通常只留 SWD（Serial Wire Debug），省引脚。我个人习惯只用 SWD，JTAG 在 4 层板以上才考虑。配置路径：
- Run → Debug Configurations → Debugger
- 选择 ST-LINK (OpenOCD)
- 接口选 SWD，速度建议先设 4 MHz，稳定后再往上提
3.1.2 复位模式与低功耗断点
调试低功耗代码时，最怕的是——你设了断点，芯片进 STOP 模式，调试器直接断开。CubeIDE 默认复位模式是 Normal，进低功耗模式后调试器会丢失连接。
解决办法：把复位模式改成 Connect Under Reset。
| 复位模式 | 适用场景 | 低功耗兼容性 |
|---|---|---|
| Normal | 普通调试 | ❌ STOP 模式断点失效 |
| Connect Under Reset | 低功耗调试 | ✅ 支持 STOP/STANDBY 断点 |
| Core Reset | 仅复位内核 | ⚠ 部分外设状态不重置 |
3.2 串口日志输出——低功耗下的“听诊器”
串口日志是嵌入式调试的标配。但在低功耗系统里，串口本身是个耗电大户。你不能让 UART 一直开着等日志，那功耗直接破表。
3.2.1 硬件连接与电平匹配
STM32L4 的 UART TX/RX 是 3.3V 电平。如果你用 USB 转串口模块（比如 CH340、CP2102），注意模块是否支持 3.3V。我曾经被 5V 模块烧过一块板子的 PA9，从那以后我每次都会先量电平。
- TX → RX（STM32 发，PC 收）
- RX → TX（PC 发，STM32 收，调试命令用）
- GND → GND（不共地 = 乱码）
3.2.2 串口初始化代码（低功耗友好版）
这里给出一段我常用的初始化代码。注意：波特率用 115200，兼顾速度和稳定性。更低的波特率在低功耗唤醒后更容易同步。
// 串句柄定义
UART_HandleTypeDef huart1;
// 初始化函数
void DEBUG_UART_Init(void)
{
__HAL_RCC_USART1_CLK_ENABLE();
__HAL_RCC_GPIOA_CLK_ENABLE();
// PA9 - TX, PA10 - RX
GPIO_InitTypeDef gpio = {0};
gpio.Pin = GPIO_PIN_9 | GPIO_PIN_10;
gpio.Mode = GPIO_MODE_AF_PP;
gpio.Pull = GPIO_NOPULL;
gpio.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
gpio.Alternate = GPIO_AF7_USART1;
HAL_GPIO_Init(GPIOA, &gpio);
huart1.Instance = USART1;
huart1.Init.BaudRate = 115200;
huart1.Init.WordLength = UART_WORDLENGTH_8B;
huart1.Init.StopBits = UART_STOPBITS_1;
huart1.Init.Parity = UART_PARITY_NONE;
huart1.Init.Mode = UART_MODE_TX_RX;
huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE;
huart1.Init.OverSampling = UART_OVERSAMPLING_16;
HAL_UART_Init(&huart1);
}
HAL_UART_MspDeInit()，唤醒后再重新初始化。别偷懒用 HAL_UART_Init() 直接恢复，我试过，有时会卡在 RXNE 标志位。
3.2.3 日志输出封装
直接调 HAL_UART_Transmit() 太啰嗦。我习惯封装一个宏，带时间戳和等级。
#define LOG_LEVEL_INFO 0
#define LOG_LEVEL_WARN 1
#define LOG_LEVEL_ERROR 2
#define DEBUG_LOG(level, fmt, ...) do { \
if (level >= g_log_level) { \
char buf[128]; \
snprintf(buf, sizeof(buf), "[%lu][%s] " fmt "\r\n", \
HAL_GetTick(), \
(level == LOG_LEVEL_ERROR) ? "ERR" : \
(level == LOG_LEVEL_WARN) ? "WRN" : "INF", \
##__VA_ARGS__); \
HAL_UART_Transmit(&huart1, (uint8_t*)buf, strlen(buf), 100); \
} \
} while(0)
用法：DEBUG_LOG(LOG_LEVEL_INFO, "进入STOP2模式，电流=%.2f uA", current_ua);
3.3 RTT（Real-Time Transfer）——不占串口，不耗引脚
串口虽好，但有个硬伤：它需要占用两个引脚，而且进低功耗后要重新初始化。RTT 不一样，它走的是 SWD 接口，跟调试器共用线，不额外占引脚。
3.3.1 RTT 原理
RTT 本质是在 RAM 里开一个环形缓冲区。MCU 往缓冲区写数据，调试器通过 SWD 读走。整个过程不打断 CPU 执行，也不影响低功耗模式。
3.3.2 在 STM32CubeIDE 中集成 RTT
SEGGER 的 RTT 实现是开源的，可以直接移植。步骤如下：
- 从 SEGGER 官网下载 RTT 实现包（SEGGER_RTT.c / .h）
- 将文件加入工程，路径随意，我习惯放
Middlewares/SEGGER/ - 在 main.c 中包含头文件：
#include "SEGGER_RTT.h" - 初始化：
SEGGER_RTT_Init(); - 输出日志：
SEGGER_RTT_printf(0, "当前电流: %.2f uA\n", current_ua);
SEGGER_RTT_Conf.h 里的 BUFFER_SIZE_UP。
3.3.3 RTT 与串口的对比
| 特性 | 串口日志 | RTT |
|---|---|---|
| 引脚占用 | 2 个（TX/RX） | 0 个（复用 SWD） |
| 低功耗影响 | 需重新初始化 UART | 无影响，缓冲区在 RAM |
| 传输速度 | 最高约 115200 bps | 约 1 MB/s（SWD 时钟决定） |
| 实时性 | 阻塞发送 | 非阻塞，不打断 CPU |
| 调试器依赖 | 不需要调试器 | 需要 J-Link 或 ST-Link |
3.4 三种调试手段的协同使用
实际项目中，我不会只用一种。我的习惯是：
- 开发阶段：串口日志为主，RTT 为辅。串口看流程，RTT 看时序敏感数据。
- 低功耗调优阶段：RTT 为主。因为串口在 STOP 模式要关掉，RTT 不受影响。
- 现场故障定位：串口日志 + 调试器断点。RTT 需要调试器一直连着，现场不一定方便。
3.5 常见问题与避坑
- 串口乱码：先查波特率是否匹配，再查 GND 是否共地。如果还乱，用示波器看 TX 脚波形，确认电平是否 3.3V。
- RTT 无输出：检查 SEGGER_RTT.c 是否编译进去了，控制块地址是否被优化掉。可以在
SEGGER_RTT_Conf.h里把SEGGER_RTT__CB声明为volatile。 - 调试器在 STOP 模式断开：确认复位模式已改为 Connect Under Reset，并且 SWD 速度不高于 4 MHz。
- 日志导致功耗偏高：进低功耗前务必关闭串口时钟，RTT 不需要额外操作，但注意调试器本身会从 SWD 取电，测量功耗时要断开调试器。