别再搞混了！用ST-Link V2给STM32F103C8T6烧录，Serial和Serial1输出到底有啥区别？

STM32串口调试陷阱：ST-Link与USB-TTL烧录的Serial/Serial1差异全解析

当你在STM32F103C8T6上调试串口通信时，是否遇到过这样的场景——用ST-Link烧录后串口毫无反应，但换成USB-TTL却能正常输出？这不是你的代码问题，而是一个隐藏在烧录工具选择中的硬件映射陷阱。本文将彻底拆解这个让无数开发者踩坑的"Serial/Serial1之谜"。

1. 现象还原：两种烧录方式的串口行为差异

在STM32的Arduino开发环境中，使用不同烧录工具会导致串口默认映射到不同硬件接口上：

• ST-Link V2烧录：默认使用Serial1（对应USART2）
• USB-TTL烧录：默认使用Serial（对应USART1）

这个差异直接导致了许多开发者的困惑：为什么同样的代码，只是换了烧录工具，串口输出就"消失"了？

实际案例：某智能硬件团队在量产测试时发现，产线上用ST-Link烧录的设备有30%无法通过串口测试，最终排查发现是测试脚本默认监听错了串口。

2. 硬件原理深度解析

要理解这种现象，需要深入STM32的串口硬件架构：

2.1 STM32F103的串口资源分布

STM32F103C8T6提供3个USART接口：

2.2 烧录工具如何影响串口映射

不同烧录工具会修改芯片的启动配置：

• USB-TTL：通过BOOT0引脚设置启动模式，保持USART1作为主串口
• ST-Link：通过SWD接口直接编程，默认启用USART2用于调试输出

// 典型Arduino初始化代码背后的差异 void setup() { // ST-Link烧录时实际执行： Serial1.begin(115200); // USART2 // USB-TTL烧录时实际执行： Serial.begin(115200); // USART1 }

3. 解决方案：编写兼容两种烧录方式的代码

3.1 自动检测当前激活的串口

void setup() { // 尝试初始化所有可能的串口 Serial.begin(115200); Serial1.begin(115200); Serial2.begin(115200); // 检测哪个串口实际可用 if(Serial) { Serial.println("使用Serial(USART1)通信"); activeSerial = &Serial; } else if(Serial1) { Serial1.println("使用Serial1(USART2)通信"); activeSerial = &Serial1; } else { Serial2.println("使用Serial2(USART3)通信"); activeSerial = &Serial2; } }

3.2 硬件引脚强制指定法

直接在代码中明确指定使用的串口和引脚：

// 明确使用USART1，无论何种烧录方式 HardwareSerial MySerial(USART1); #define TX_PIN PA9 #define RX_PIN PA10 void setup() { MySerial.begin(115200); pinMode(TX_PIN, ALTERNATE_PUSH_PULL); pinMode(RX_PIN, INPUT_PULLUP); }

4. 进阶技巧：自定义串口映射表

对于需要灵活切换串口的项目，可以建立映射表：

struct UART_Mapping { HardwareSerial* serial; uint8_t tx_pin; uint8_t rx_pin; USART_TypeDef* instance; }; const UART_Mapping uart_options[] = { {&Serial, PA9, PA10, USART1}, {&Serial1, PA2, PA3, USART2}, {&Serial2, PB10, PB11, USART3} }; void setup() { // 根据烧录工具自动选择 int selected = detect_programmer_type(); auto uart = uart_options[selected]; uart.serial->begin(115200); pinMode(uart.tx_pin, ALTERNATE_PUSH_PULL); pinMode(uart.rx_pin, INPUT_PULLUP); }

5. 验证与调试实战

5.1 串口测试代码

void test_all_uart() { const char* messages[] = { "Serial(USART1)测试消息", "Serial1(USART2)测试消息", "Serial2(USART3)测试消息" }; HardwareSerial* ports[] = {&Serial, &Serial1, &Serial2}; for(int i=0; i<3; i++) { if(*ports[i]) { ports[i]->println(messages[i]); delay(100); } } }

5.2 逻辑分析仪抓包验证

使用Saleae等工具同时监测多组引脚：

1. 连接PA9/PA10(USART1)
2. 连接PA2/PA3(USART2)
3. 运行测试代码
4. 观察实际数据出现在哪个接口

6. 工程实践建议

1. 项目文档明确标注：在README中注明使用的串口及对应烧录工具
2. 统一团队开发环境：建议全组使用同类型烧录工具
3. PCB设计预留测试点：为所有串口引出测试焊盘
4. 量产前双重验证：同时测试ST-Link和USB-TTL两种烧录方式

在最近的一个工业传感器项目中，我们通过预先定义ACTIVE_SERIAL宏，使得代码可以自动适应不同烧录环境：

#if defined(USE_STLINK) #define ACTIVE_SERIAL Serial1 #elif defined(USE_USBTTL) #define ACTIVE_SERIAL Serial #endif void send_data(const char* msg) { ACTIVE_SERIAL.println(msg); }