3. Trace数据采集：ITM/SWO与DMA方式实战

Trace数据采集，说白了就是给芯片装个「黑匣子」。我在做汽车电子项目时，有个现场故障复现概率极低，打日志影响时序，不加日志又抓不到现场。后来靠ITM+SWO才把那个幽灵Bug揪出来。这一章咱们就聊聊怎么用好这个黑匣子。

3.1 ITM与SWO基础概念

ITM（Instrumentation Trace Macrocell）是ARM Cortex-M内核内置的跟踪单元。它通过SWO（Single Wire Output）引脚把调试数据实时输出。你想想看，传统串口打印要占用一个UART，还要在代码里塞一堆printf。ITM只需要一根线，而且对目标系统几乎零侵入。

特性 ITM+SWO 传统串口 DMA+GPIO
引脚占用 1根（SWO） 2根（TX/RX） 2~8根
CPU占用 极低（硬件级） 中等（中断） 低（DMA）
时间戳精度 内核周期级 依赖波特率 依赖DMA时钟
数据带宽 最高约115.2kbps 最高约921.6kbps 取决于DMA配置

核心要点：ITM不是软件模拟的，它是硬件模块。数据从CPU写入ITM stimulus port，然后由SWO串行化输出。整个过程不占用CPU总线，不影响实时性。

3.2 ITM Stimulus Port配置

ITM有32个stimulus port，每个port可以独立使能。我个人习惯把不同优先级的数据分到不同port：port 0放紧急错误，port 1放性能计数，port 2放调试日志。这样在分析时可以直接过滤，不用在一堆数据里翻找。

// ITM初始化配置（基于Cortex-M4）
void ITM_Init(void) {
    // 1. 使能ITM模块
    ITM->LAR  = 0xC5ACCE55;  // 解锁ITM锁寄存器
    ITM->TCR  = 0x0001000F;  // 使能ITM，使能DWT事件，使能时间戳
    
    // 2. 配置SWO引脚（以STM32F4为例）
    GPIO->AFR[1] |= (0x0F << 12);  // PB3复用为SWO
    GPIO->MODER  |= (0x02 << 6);   // 复用功能模式
    
    // 3. 使能stimulus port 0和1
    ITM->TER  = 0x00000003;  // 使能port 0和port 1
    
    // 4. 配置SWO波特率（假设内核168MHz，目标2MHz SWO）
    DBGMCU->CR = 0x00000027;  // 使能调试时钟
}

注意：ITM的LAR（Lock Access Register）必须在使能前写入解锁码0xC5ACCE55。我见过不少新手直接写TCR，结果ITM死活不工作——其实就是没解锁。

3.3 SWO数据输出与协议

SWO使用NRZ（Non-Return-to-Zero）编码，数据帧格式固定：1个起始位 + 8个数据位 + 1个奇偶校验位 + 1个停止位。嗯，这里要注意，SWO的波特率不是随便设的，它必须与调试器（如J-Link、ST-Link）的采样率匹配。

我曾经在一个项目中把SWO波特率设到4MHz，结果调试器采样跟不上，数据全是乱码。后来降到2MHz才稳定。经验公式：SWO波特率 ≤ 调试器最大采样率 / 2。

// ITM数据发送函数（非阻塞）
void ITM_SendData(uint32_t port, uint8_t data) {
    // 检查stimulus port是否就绪
    if (ITM->PORT[port].u32 == 0) {
        return;  // 端口忙，丢弃数据
    }
    
    // 写入数据（硬件自动添加帧头帧尾）
    ITM->PORT[port].u8 = data;
}

// 使用示例：发送字符串
void ITM_SendString(uint32_t port, const char* str) {
    while (*str) {
        ITM_SendData(port, (uint8_t)*str++);
    }
}

小技巧：ITM的PORT寄存器是32位的，但每次只写最低8位。硬件会自动把数据打包成SWO帧。如果你需要发送大量数据，建议用DMA方式，后面会讲。

3.4 DMA方式采集Trace数据

ITM+SWO虽然好，但带宽有限。当Trace数据量超过SWO的传输能力时，数据就会丢失。这时候DMA方式就派上用场了。

DMA采集的核心思路：ITM数据不直接走SWO，而是通过DMA搬运到内存缓冲区，然后由调试器批量读取。这样带宽瓶颈从SWO的115kbps提升到DMA的数十MBps。

DMA方式Trace数据采集流程 CPU Core ITM DMA 内存缓冲区 调试器 说明： CPU写入ITM → ITM触发DMA请求 → DMA搬运到内存缓冲区 → 调试器通过SWD/JTAG批量读取 优势：CPU只需写ITM，不参与数据搬运，带宽提升10~100倍

3.5 DMA方式配置实战

以STM32H7为例，配置DMA采集ITM数据到SRAM：

// DMA方式采集Trace配置
#define TRACE_BUF_SIZE  4096
static uint8_t trace_buf[TRACE_BUF_SIZE] __attribute__((section(".trace_ram")));

void DMA_Trace_Init(void) {
    // 1. 配置DMA通道（DMA1 Stream0）
    DMA1_Stream0->CR = 0;
    DMA1_Stream0->CR |= (0x01 << 25);  // 外设到内存
    DMA1_Stream0->CR |= (0x01 << 10);  // 外设地址递增
    DMA1_Stream0->CR |= (0x01 << 8);   // 内存地址递增
    
    // 2. 设置源地址（ITM stimulus port 0）
    DMA1_Stream0->PAR = (uint32_t)&ITM->PORT[0].u8;
    
    // 3. 设置目的地址（内存缓冲区）
    DMA1_Stream0->M0AR = (uint32_t)trace_buf;
    
    // 4. 设置传输长度
    DMA1_Stream0->NDTR = TRACE_BUF_SIZE;
    
    // 5. 使能DMA
    DMA1_Stream0->CR |= (0x01 << 0);  // 使能DMA
    
    // 6. 配置ITM触发DMA请求
    ITM->TCR |= (0x01 << 23);  // 使能DMA触发模式
}

关键点：DMA方式下，ITM的每个stimulus port都可以独立触发DMA请求。你可以在port 0上配置DMA采集高频性能计数器，port 1上保留SWO输出低频调试日志。这样既保证了高频数据的完整性，又保留了实时查看能力。

3.6 缓冲区管理与数据同步

DMA是异步的，CPU和DMA同时访问缓冲区时会出现竞争。我常用的方案是双缓冲（ping-pong buffer）：DMA写一个缓冲区时，CPU读另一个。两个缓冲区轮流切换，永不冲突。

// 双缓冲管理
typedef struct {
    uint8_t* buf[2];      // 两个缓冲区
    volatile uint32_t active;  // 当前DMA写入的缓冲区索引
    uint32_t size;         // 每个缓冲区大小
} PingPongBuf_t;

PingPongBuf_t trace_pp;

void DMA_Trace_SwitchBuffer(void) {
    uint32_t next = trace_pp.active ^ 0x01;  // 切换到另一个缓冲区
    
    // 更新DMA目的地址
    DMA1_Stream0->M0AR = (uint32_t)trace_pp.buf[next];
    DMA1_Stream0->NDTR = trace_pp.size;
    
    // 标记切换完成
    trace_pp.active = next;
}

// DMA传输完成中断回调
void DMA1_Stream0_IRQHandler(void) {
    if (DMA1->LISR & (0x01 << 5)) {  // TCIF0
        // 处理已完成的缓冲区数据
        ProcessTraceData(trace_pp.buf[trace_pp.active ^ 0x01]);
        
        // 切换缓冲区
        DMA_Trace_SwitchBuffer();
        
        DMA1->LIFCR |= (0x01 << 5);  // 清除中断标志
    }
}

经验之谈：缓冲区大小建议设为2的幂次方（如1024、2048、4096），这样DMA地址对齐更好，性能更高。我一般用4096字节，既不会浪费内存，又能保证在100MHz采样率下有足够的时间处理数据。

3.7 常见问题与避坑指南

  • SWO无输出：检查ITM是否解锁（LAR写入0xC5ACCE55），检查SWO引脚复用配置是否正确。
  • 数据乱码：SWO波特率与调试器采样率不匹配。降低波特率或升级调试器固件。
  • DMA传输卡死：检查DMA通道优先级，确保ITM的DMA请求没有被更高优先级的中断阻塞。
  • 缓冲区溢出：CPU处理速度跟不上DMA写入速度。增大缓冲区或降低Trace数据产生频率。

曾经踩过的坑：我在一个项目中用了DMA方式采集Trace，结果发现数据总是少几个字节。排查了两天，最后发现是DMA的FIFO阈值设置不对。DMA默认FIFO阈值是1/4，但ITM的数据是单字节写入，FIFO不满就不会触发传输。把阈值改成1/2就解决了。

3.8 性能对比与选型建议

场景 推荐方式 理由
低频调试（<10kHz） ITM+SWO 配置简单，实时性好
中频性能分析（10kHz~1MHz） ITM+SWO（高波特率） 带宽够用，无需额外内存
高频数据采集（>1MHz） DMA方式 带宽高，不丢数据
多通道并行采集 DMA方式 可同时采集多个stimulus port

嗯，总结一下：ITM+SWO适合日常调试和低频数据采集，DMA方式适合高频性能分析和多通道场景。我个人建议项目初期先用ITM+SWO快速验证，等遇到性能瓶颈再切换到DMA方式。这样既不会在调试工具上浪费太多时间，又能保证后期有足够的扩展空间。

← 上一章 📖 返回目录 下一章 →