用 SWO + ITM 替代串口打印：在 Cortex-M 上实现微秒级无干扰日志与变量实时监视

1. 为什么需要替代串口打印？

在 Cortex-M 开发中，printf 重定向到 UART 是最常见的调试手段，但它存在明显缺陷：

  • 阻塞式发送：等待发送寄存器空或使用 DMA 仍有中断开销，高频日志会严重拖慢实时性。
  • 占用引脚与外设：UART 需要 TX/RX 两根线，且与功能引脚冲突。
  • 中断干扰：UART 中断会打断关键时序，影响电机控制、音频处理等场景。
  • 带宽有限：115200 波特率下每秒仅约 11KB，难以输出大量变量。

而 Cortex-M 内核自带的 ITM（Instrumentation Trace Macrocell） 与 SWO（Single Wire Output） 组合，仅需一根调试引脚即可实现非阻塞、微秒级、几乎零 CPU 开销的日志输出，并支持变量实时监视（如 Keil 的 Watch 窗口直接查看变量）。

2. ITM 与 SWO 原理

ITM 是 ARM CoreSight 调试组件之一，它提供 32 个刺激端口（Stimulus Port），其中：

  • Port 0：通常用于 printf 风格的文本日志。
  • Port 1~31：可用于自定义数据通道，如二进制变量流。

当 CPU 向 ITM 的端口寄存器写入数据时，数据被送入 FIFO，再由 TPIU（Trace Port Interface Unit） 通过 SWO 引脚异步输出。整个过程不占用 CPU 周期等待，仅需几个时钟周期写入，且不会触发中断。

SWO 引脚在 Cortex-M3/M4/M7 上通常与 JTAG 的 TDO 复用，在 SWD 模式下即为 SWO 信号。调试器（J-Link、ST-Link、CMSIS-DAP）负责接收并转发到 IDE 的 Trace 窗口。

3. 硬件与工具配置

3.1 硬件连接

  • 确保调试器支持 SWO（J-Link、ST-Link V2-1、CMSIS-DAP 均支持）。
  • 连接 SWDIO、SWCLK、SWO、GND 四根线。
  • 目标 MCU 的 DBGMCU_CR 中需使能 Trace 相关位（部分型号默认开启）。

3.2 软件配置（以 Keil MDK 为例）

  1. Debug 选项卡：选择调试器，点击 Settings。
  2. Trace 选项卡：
    • Core Clock：填入 CPU 主频（如 168MHz）。
    • 勾选 Trace Enable。
    • 设置 SWO Clock（通常为 CPU 频率的 1/2 或 1/4，如 84MHz）。
    • 勾选 ITM Stimulus Port 0。
  3. 添加 ITM 查看窗口：View → Analysis Windows → Trace → ITM Viewer。

3.3 其他环境

  • IAR：在 Project Options → Debugger → Setup 中启用 SWO，并在 Terminal I/O 中设置。
  • OpenOCD + GDB：使用 tpiu config 和 itm port 0 on 命令。
  • STM32CubeIDE：在 Debug Configuration → Trace 中启用 SWV。

4. 完整代码示例

以下代码基于 STM32F4，使用 CMSIS 核心头文件，实现非阻塞 ITM_SendChar 和 printf 重定向。

#include "stm32f4xx.h"
#include <stdio.h>

// 重定向 fputc 到 ITM Port 0
int fputc(int ch, FILE *f) {
    ITM_SendChar((uint32_t)ch);
    return ch;
}

// 可选：实现简单的非阻塞日志宏
#define LOG(fmt, ...)   printf(fmt, ##__VA_ARGS__)

// 初始化 ITM 相关寄存器（通常调试器会自动配置，但手动确保）
void ITM_Init(void) {
    // 使能 ITM 全局控制（如果未使能）
    if ((ITM->TCR & ITM_TCR_ITMENA_Msk) == 0) {
        ITM->LAR = 0xC5ACCE55;  // 解锁
        ITM->TCR |= ITM_TCR_ITMENA_Msk;
    }
    // 使能 Port 0
    ITM->TER |= (1UL << 0);
    // 使能调试异常与监视（可选）
    CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk;
}

int main(void) {
    // 系统时钟初始化（略）
    ITM_Init();

    uint32_t counter = 0;
    while (1) {
        LOG("Counter: %lu, Tick: %lu\n", counter++, HAL_GetTick());
        // 模拟实时任务
        for (volatile int i = 0; i < 1000; i++);
    }
}

变量实时监视：在 Keil 的 Watch 窗口添加全局变量，并勾选 View → Periodic Window Update，即可通过 SWO 实时刷新变量值，无需停止 CPU。

5. 性能实测与对比

  • UART 115200：发送 20 字节字符串约耗时 1.7ms（阻塞）。
  • ITM Port 0：写入 20 字节仅需约 2~3μs（非阻塞，FIFO 缓冲）。
  • CPU 占用：ITM 方式几乎为 0，UART 中断方式在高速下可达 5% 以上。

6. 注意事项与常见问题

  • SWO 引脚未连接：检查硬件连线，部分开发板需短接 SB 或配置复用。
  • 无输出：确认调试器 Trace 设置中 Core Clock 与 SWO Clock 正确，且 ITM Port 0 已使能。
  • FIFO 溢出：ITM 的 FIFO 深度有限（通常 4~8 字节），高频大量输出仍可能丢失，建议降低日志频率或使用 DMA 辅助。
  • 低功耗模式：进入 Sleep/Stop 模式后 SWO 可能停止，需在调试时禁用低功耗或唤醒后重新初始化。
  • 多任务环境：ITM 写入是原子的，但 printf 本身可能非线程安全，建议加锁或使用 ITM_SendChar 直接输出。
  • 兼容性：Cortex-M0/M0+ 无 ITM，仅 M3/M4/M7/M33 等支持。

7. 总结

SWO + ITM 是 Cortex-M 调试的利器，它以极低的 CPU 开销和微秒级延迟，完美替代传统串口打印。通过本文的配置与代码，你可以快速在 Keil、IAR 或 OpenOCD 中启用，并利用变量实时监视功能大幅提升调试效率。告别 UART 阻塞，让日志输出不再成为实时性的瓶颈。