用DWT周期计数器在Cortex-M上做函数级耗时统计的移植与坑点

在嵌入式开发中，我们经常需要回答“这个函数到底跑了多久？”——尤其是优化算法、排查实时性瓶颈时。示波器需要引脚翻转，定时器精度有限且占用外设，而Cortex-M内核自带的DWT（Data Watchpoint and Trace）周期计数器能以极低成本提供CPU周期级的时间戳。

原理：DWT周期计数器是什么

DWT是ARM CoreSight调试组件的一部分，其中CYCCNT寄存器是一个32位向上计数器，每个内核时钟周期加1。只要使能，它就会自由运行，读取它几乎不消耗时间（一条MRS指令）。

  • 计数频率 = 内核时钟（HCLK），例如STM32F4@168MHz时，1个计数≈5.95ns。
  • 32位计数器在168MHz下约25.6秒溢出一次，对函数级测量足够。
  • 需要调试接口使能（通常通过CoreDebug->DEMCR的TRCENA位）。

移植步骤

1. 使能跟踪与DWT

#include "core_cm4.h"  // 根据内核型号选择

void DWT_Init(void)
{
    // 使能跟踪单元
    CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk;
    // 清零并启动周期计数器
    DWT->CYCCNT = 0;
    DWT->CTRL |= DWT_CTRL_CYCCNTENA_Msk;
}

注意：某些芯片（如STM32F0/L0）的DWT可能被裁剪，需查阅参考手册确认。

2. 读取与换算

static inline uint32_t DWT_GetCycles(void)
{
    return DWT->CYCCNT;
}

// 将周期差转换为微秒（假设SystemCoreClock已正确配置）
static inline uint32_t DWT_CyclesToUs(uint32_t cycles)
{
    return (uint32_t)((uint64_t)cycles * 1000000ULL / SystemCoreClock);
}

3. 函数级测量宏

#define DWT_MEASURE_BEGIN()  uint32_t _start = DWT_GetCycles()
#define DWT_MEASURE_END()    (DWT_GetCycles() - _start)

void test_function(void)
{
    DWT_MEASURE_BEGIN();
    // 被测代码
    for (volatile int i = 0; i < 1000; i++);
    uint32_t cycles = DWT_MEASURE_END();
    printf("cycles: %lu, us: %lu\n", cycles, DWT_CyclesToUs(cycles));
}

完整示例：测量memcpy耗时

#include <string.h>
#include "core_cm4.h"

static uint8_t src[1024], dst[1024];

int main(void)
{
    SystemInit();
    DWT_Init();

    uint32_t start = DWT_GetCycles();
    memcpy(dst, src, sizeof(src));
    uint32_t cycles = DWT_GetCycles() - start;

    printf("memcpy 1KB: %lu cycles, %lu us\n",
           cycles, DWT_CyclesToUs(cycles));
    while (1);
}

坑点与注意事项

  • 初始化顺序：必须先置位TRCENA再操作DWT，否则写入无效。部分调试器连接时会复位DWT，建议在main中重新初始化。
  • 计数器溢出：32位在高速时钟下约25秒溢出。若测量长流程，需在中断中累加溢出次数，或改用64位软件扩展。
  • 中断干扰：测量期间若发生中断，中断服务程序的时间会被计入。对精确测量，可临时关中断（__disable_irq()），但会破坏实时性，需权衡。
  • 编译器优化：被测代码可能被优化掉或重排。使用volatile或内存屏障（__DSB()）确保测量点不被移动。
  • 多核/低功耗：进入低功耗模式后DWT可能停止计数；多核系统中各核DWT独立，需分别读取。
  • 调试器影响：某些调试器在暂停时会冻结CYCCNT，在线调试时读数可能失真，建议脱机运行验证。
  • 时钟变化：动态调频后SystemCoreClock需同步更新，否则换算错误。

总结

DWT周期计数器是Cortex-M上做函数级耗时统计的“瑞士军刀”——零外设占用、纳秒级分辨率、代码量极小。只要注意初始化顺序、溢出与中断干扰，就能快速搭建可靠的性能剖析工具，为嵌入式软件优化提供数据支撑。