1. 项目概述：嵌入式调试的利器SWO与RTT
在嵌入式开发中，调试信息的输出一直是个痛点。传统串口调试占用硬件资源多、速度慢，而SWO（Serial Wire Output）和RTT（Real Time Transfer）技术通过调试接口实现了高效的数据传输。MDK（Keil Microcontroller Development Kit）配合J-Link调试器，可以轻松实现这两种调试方式。
SWO是ARM Cortex-M内核内置的调试组件，通过单根线输出数据，最高速度可达2MB/s。RTT则是SEGGER公司开发的双向通信技术，无需额外硬件引脚，直接在内存中开辟缓冲区进行数据交换。两者相比：
- SWO依赖芯片硬件支持，需要连接SWO线
- RTT纯软件实现，但需要占用少量RAM
- SWO带宽固定，RTT速度取决于调试接口速率
2. 硬件准备与软件配置
2.1 硬件连接要点
使用SWO功能时，除了常规的SWD四线（VCC、GND、SWDIO、SWCLK）外，必须连接SWO信号线。以STM32F4 Discovery板为例：
- J-Link的1脚(VTref)连接板子3.3V
- 7脚(SWDIO)接PA13
- 9脚(SWCLK)接PA14
- 13脚(SWO)接PB3
- 共用GND（4/6/8/10等脚）
注意：不同开发板的SWO引脚可能不同，需查阅具体芯片手册。例如NXP部分芯片SWO映射在P0.10
2.2 软件环境搭建
-
安装最新版J-Link驱动（V7.92以上）
-
Keil MDK中配置调试器：
- Debug选项卡选择"J-Link / J-Trace Cortex"
- Port选择"SW"
- Max Clock建议设为4MHz（高速可能导致不稳定）
- 勾选"Serial Wire Viewer"选项
-
在Target选项的"Trace"标签下：
c复制Core Clock: 168000000 // 根据实际CPU主频设置 SWO Clock: 2000000 // 建议设为CPU主频的1/8 Trace Enable: 勾选 ITM Stimulus Ports: 0x00000001 // 启用端口0
3. SWOViewer实现详解
3.1 代码端配置
在MDK工程中添加ITM输出代码：
c复制#include "stdio.h"
// 重定义fputc以使用ITM端口0
int fputc(int ch, FILE *f) {
if (DEMCR & TRCENA) {
while (ITM_Port32(0) == 0);
ITM_Port8(0) = ch;
}
return ch;
}
void main() {
// 初始化代码...
printf("System start at %dHz\r\n", SystemCoreClock);
while(1) {
printf("ADC value: %d\r\n", read_adc());
Delay_ms(100);
}
}
3.2 MDK调试配置技巧
- 在Debug模式下点击"View"→"Serial Windows"→"Debug Viewer"
- 右键Debug Viewer选择"Show Time Stamp"可显示时间戳
- 使用以下格式可实现彩色输出：
c复制#define ANSI_COLOR_RED "\x1b[31m" printf(ANSI_COLOR_RED "Error: sensor timeout!\n");
常见问题排查：
- 无输出：检查SWO线连接、时钟配置、ITM端口使能
- 乱码：确认SWO Clock与Core Clock比例正确
- 数据丢失：降低SWO Clock频率或优化代码输出频率
4. RTTViewer实战指南
4.1 工程集成步骤
-
从SEGGER官网下载J-Link软件包，解压后获取：
RTT目录下的SEGGER_RTT.c、SEGGER_RTT.hRTT_Syscalls_KEIL.c用于重定向标准输出
-
在MDK工程中添加这些文件，并设置包含路径
-
修改代码使用RTT API：
c复制#include "SEGGER_RTT.h"
void main() {
SEGGER_RTT_Init();
SEGGER_RTT_WriteString(0, "RTT Initialized\r\n");
while(1) {
SEGGER_RTT_printf(0, "Tick: %d\r\n", HAL_GetTick());
if(SEGGER_RTT_HasKey()) {
char c = SEGGER_RTT_GetKey();
SEGGER_RTT_Write(0, &c, 1);
}
}
}
4.2 RTTViewer高级功能
-
多通道使用：
c复制// 通道0用于调试信息 SEGGER_RTT_WriteString(0, "Debug message"); // 通道1用于数据采集 SEGGER_RTT_Write(1, &sensor_data, sizeof(sensor_data)); -
终端颜色控制：
c复制#define RTT_CTRL_TEXT_RED "\x1B[31m" SEGGER_RTT_WriteString(0, RTT_CTRL_TEXT_RED "Critical Error!"); -
性能优化技巧：
- 适当增大
SEGGER_RTT_Conf.h中的缓冲区大小 - 对高频数据使用
SEGGER_RTT_WriteNoLock() - 避免在中断中调用RTT输出
- 适当增大
5. 对比分析与应用场景
5.1 SWO与RTT技术对比
| 特性 | SWO | RTT |
|---|---|---|
| 硬件需求 | 需要SWO引脚 | 仅需调试接口 |
| 最大速度 | 2Mbps | 取决于调试器速度 |
| 内存占用 | 无 | 需要RAM缓冲区 |
| 双向通信 | 不支持 | 支持 |
| 多通道支持 | 32个ITM端口 | 无限通道 |
| 芯片依赖性 | Cortex-M内核 | 任何支持调试的MCU |
5.2 典型应用场景选择
-
使用SWO的场景：
- 芯片引脚资源紧张
- 需要精确时间戳的调试
- 低功耗模式下调试输出
- 已经占用所有串口的情况
-
使用RTT的场景：
- 需要双向交互式调试
- 大数据量传输（如波形数据）
- 非ARM架构芯片调试
- 需要自定义数据格式
6. 常见问题深度解析
6.1 连接问题排查指南
-
J-Link无法识别：
- 检查设备管理器中的驱动状态
- 尝试降低接口时钟频率
- 更换USB线或接口（推荐使用带屏蔽的USB线）
-
RTT连接不稳定：
c复制// 在代码中添加连接检测 if(SEGGER_RTT_GetKey() == 0xAA) { SEGGER_RTT_WriteString(0, "Host connected"); } -
SWO信号质量差：
- 确保SWO线长度小于15cm
- 在SWO线上串联100Ω电阻
- 检查目标板供电稳定
6.2 性能优化实战
-
RTT缓冲区设置原则：
c复制#define BUFFER_SIZE_UP 1024 // 上行缓冲区(MCU->PC) #define BUFFER_SIZE_DOWN 32 // 下行缓冲区(PC->MCU) -
中断安全输出方案：
c复制void safe_printf(const char *fmt, ...) { va_list args; SEGGER_RTT_LOCK(); va_start(args, fmt); SEGGER_RTT_vprintf(0, fmt, &args); va_end(args); SEGGER_RTT_UNLOCK(); } -
低功耗模式适配：
c复制void enter_low_power() { SEGGER_RTT_WriteString(0, "Entering STOP mode"); // 先刷新所有输出 while(SEGGER_RTT_HasDataUp(0)); HAL_PWR_EnterSTOPMode(...); }
7. 高级技巧与扩展应用
7.1 自定义数据协议
利用RTT通道传输结构化数据：
c复制#pragma pack(push, 1)
typedef struct {
uint32_t timestamp;
float temperature;
uint16_t adc_value;
} sensor_packet_t;
#pragma pack(pop)
void send_sensor_data() {
sensor_packet_t packet = {
.timestamp = HAL_GetTick(),
.temperature = read_temp(),
.adc_value = read_adc()
};
SEGGER_RTT_Write(2, &packet, sizeof(packet));
}
PC端用Python解析：
python复制import struct
fmt = "<IfH" # 小端, uint32+float+uint16
data = rtt.read(channel=2, size=struct.calcsize(fmt))
ts, temp, adc = struct.unpack(fmt, data)
7.2 与RTOS集成技巧
在FreeRTOS中的安全使用：
c复制void vTaskDebugOutput(void *pv) {
for(;;) {
// 使用互斥锁保护RTT输出
xSemaphoreTake(rtt_mutex, portMAX_DELAY);
SEGGER_RTT_printf(0, "[%s] Heap free: %u\r\n",
pcTaskGetName(NULL),
xPortGetFreeHeapSize());
xSemaphoreGive(rtt_mutex);
vTaskDelay(pdMS_TO_TICKS(1000));
}
}
7.3 固件升级方案
通过RTT实现Bootloader通信：
c复制// Bootloader端
void handle_rtt_command() {
if(SEGGER_RTT_HasKey()) {
char cmd = SEGGER_RTT_GetKey();
switch(cmd) {
case 'U': // 开始升级
start_firmware_update();
break;
case 'D': // 数据包
receive_firmware_data();
break;
}
}
}
// PC端工具
JLinkRTTClient.exe -rttchannel 0 "U" # 发送升级命令
通过MDK+JLink实现SWO/RTT调试，开发者可以获得比传统串口更强大的调试能力。在实际项目中，我通常会根据以下原则选择方案：
- 早期硬件阶段使用RTT，避免连接问题
- 量产测试使用SWO，节省IO资源
- 关键数据采用二进制格式传输
- 为每个模块分配独立RTT通道
调试效率的提升往往能节省30%以上的开发时间，值得投入精力掌握这些高级调试技术。当遇到复杂问题时，可以结合SWO的时间戳和RTT的大数据量特性，采用混合调试策略。