1. 问题现象与初步排查
最近在调试STM32F103C8T6的USART1串口通信时遇到了一个典型问题：硬件连接PA9(TX)和PA10(RX)后，通信完全无反应。作为嵌入式开发中的"Hello World"级功能，这种基础问题往往隐藏着容易被忽视的细节。经过完整的问题排查流程，我总结出以下经验供大家参考。
首先需要确认的是基础硬件连接。使用万用表测量PA9和PA10到MAX3232电平转换芯片的线路通断，同时检查转换芯片到DB9接口的线路。特别注意TXD和RXD不能接反——这是新手最容易犯的错误之一。实测电压在发送时应能看到明显跳变（TTL电平约3.3V）。
关键提示：当使用USB转TTL工具直接连接时，务必交叉连接TX-RX线（MCU的TX接转换器的RX），且共地线必须连接。很多通信失败案例都是因为少了这根地线。
2. 时钟配置检查
STM32的任何外设工作都依赖正确的时钟配置。通过STM32CubeMX生成的代码中，需要确认：
c复制__HAL_RCC_USART1_CLK_ENABLE(); // 开启USART1时钟
__HAL_RCC_GPIOA_CLK_ENABLE(); // 开启GPIOA时钟
如果使用标准库，对应的函数是：
c复制RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1 | RCC_APB2Periph_GPIOA, ENABLE);
时钟树配置错误是导致外设不工作的常见原因。通过读取寄存器可以验证时钟是否真正开启：
c复制printf("USART1时钟状态: %d\n", __HAL_RCC_GET_USART1_SOURCE());
3. GPIO模式设置详解
USART的GPIO模式设置需要特别注意：TX引脚应配置为复用推挽输出，RX引脚为浮空输入或上拉输入。常见错误包括：
- 将TX设为普通推挽输出（无法输出串行数据）
- 将RX设为推挽输出（会冲突总线信号）
正确的CubeMX配置应为：
code复制PA9 - USART1_TX - Alternate Function Push Pull
PA10 - USART1_RX - Input Floating / Input Pull-up
对应的寄存器级配置如下：
c复制GPIO_InitTypeDef GPIO_InitStruct = {0};
GPIO_InitStruct.Pin = GPIO_PIN_9;
GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
GPIO_InitStruct.Pin = GPIO_PIN_10;
GPIO_InitStruct.Mode = GPIO_MODE_INPUT;
GPIO_InitStruct.Pull = GPIO_NOPULL;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);
4. 串口参数配置要点
USART的初始化参数必须与通信对方严格匹配。一个典型的115200波特率配置如下：
c复制huart1.Instance = USART1;
huart1.Init.BaudRate = 115200;
huart1.Init.WordLength = USART_WORDLENGTH_8B;
huart1.Init.StopBits = USART_STOPBITS_1;
huart1.Init.Parity = USART_PARITY_NONE;
huart1.Init.Mode = USART_MODE_TX_RX;
huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE;
huart1.Init.OverSampling = UART_OVERSAMPLING_16;
特别注意：
- 波特率误差不能超过2.5%（STM32F103的USART波特率计算公式为：fCK/(16*USARTDIV)）
- 过采样率通常保持16x不变
- 硬件流控制如果不需要必须禁用
5. 中断与DMA配置
如果使用中断或DMA方式，还需要额外配置NVIC。常见遗漏包括：
- 未开启USART1全局中断
- 未实现中断服务函数
- DMA通道配置错误
正确的中断配置流程：
c复制HAL_NVIC_SetPriority(USART1_IRQn, 0, 0);
HAL_NVIC_EnableIRQ(USART1_IRQn);
对应的中断服务函数（在stm32f1xx_it.c中）：
c复制void USART1_IRQHandler(void) {
HAL_UART_IRQHandler(&huart1);
}
6. 软件复位与重初始化
当通信异常时，可以通过软件复位USART外设：
c复制__HAL_UART_DISABLE(&huart1);
__HAL_UART_ENABLE(&huart1);
更彻底的复位方式是重新初始化：
c复制HAL_UART_DeInit(&huart1);
MX_USART1_UART_Init(); // 重新初始化
7. 常见问题速查表
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 能发送不能接收 | RX引脚模式错误 | 检查GPIO是否为输入模式 |
| 数据乱码 | 波特率不匹配 | 双方校验波特率设置 |
| 偶尔丢数据 | 缓冲区溢出 | 增大缓冲区或提高处理速度 |
| 完全无反应 | 时钟未开启 | 检查RCC相关寄存器 |
| 仅首字节正确 | 停止位设置错误 | 确认双方停止位一致 |
8. 进阶调试技巧
-
使用逻辑分析仪捕获实际波形，检查：
- 起始位下降沿是否清晰
- 波特率实际值（测量1bit时间）
- 数据位是否符合预期
-
寄存器级调试：
c复制// 检查USART状态寄存器
printf("SR: 0x%04X\n", USART1->SR);
printf("DR: 0x%04X\n", USART1->DR);
- 使用CubeMX的时钟配置工具确认：
- APB2总线时钟是否正确（默认应为72MHz）
- USART1时钟是否使能
经过以上系统排查，我的问题最终定位在GPIO模式配置错误——误将RX引脚设置为输出模式。修改后通信立即恢复正常。这个案例提醒我们，即使是最基础的外设配置，也需要对每个参数保持足够的警惕。