1. 硬件准备与环境搭建
第一次尝试用树莓派和STM32做串口通信时，我对着桌上堆满的零件发愁：到底哪些线该接哪里？后来发现其实核心部件就三样：树莓派（推荐4B型号）、STM32开发板（我用的是F103C8T6）、以及几根杜邦线。这里有个坑要注意——千万别贪便宜买劣质杜邦线，之前用过某宝9.9包邮的线，通信时断时续，排查半天才发现是线材接触不良。
树莓派的GPIO引脚中，**物理引脚8（TX）和10（RX）**就是我们要用的串口通信引脚。有个快速识别的技巧：把树莓派网口朝下，左上角第一个引脚就是1号，往右数到8和10就行。STM32端建议使用USART1，它的TX(PA9)和RX(PA10)位置规整容易接线。我习惯用不同颜色的杜邦线区分信号线：红色接TX，黄色接RX，黑色接GND，这样调试时一眼就能看清连接关系。
电源方面有个实用技巧：如果STM32需要单独供电，建议共用地线。我遇到过只接信号线不共地的情况，数据死活传不过去，后来用万用表量才发现两边地线有0.3V电位差。现在我的标准做法是先用USB给树莓派供电，然后从树莓派的5V引脚给STM32供电，既省去额外电源又确保电平一致。
2. 树莓派串口配置详解
树莓派的串口配置就像给手机换铃声——系统默认的不一定适合你。最新版Raspbian系统默认把硬件串口分配给了蓝牙，这就像把跑车用来送快递。通过下面这些步骤可以解放硬件串口的真正实力：
先检查当前串口映射状态：
ls /dev/serial* -l正常情况会看到serial0 -> ttyS0，这表示硬件串口被蓝牙占用了。就像我上次做智能小车项目，直接使用mini串口导致控制指令延迟，小车经常"思考人生"。
修改配置文件的正确姿势是：
sudo nano /boot/config.txt在文件末尾添加两行关键配置：
dtoverlay=pi3-disable-bt enable_uart=1第一句像关掉蓝牙的开关，第二句是激活串口的钥匙。保存后重启，再用ls命令检查，现在serial0应该指向ttyAMA0了，就像把跑车钥匙从快递员手里拿了回来。
遇到过最头疼的问题是权限报错，提示"Could not open /dev/ttyAMA0"。这时候别急着sudo，先用这个命令一劳永逸：
sudo usermod -a -G dialout pi这相当于给你的用户账户发了串口通行证。建议接着安装调试利器minicom：
sudo apt install minicom minicom -D /dev/ttyAMA0 -b 115200启动后按Ctrl+A再按Z可以调出功能菜单，这里有个隐藏技巧：按O进入配置，把"Hardware Flow Control"设为No，能解决很多莫名其妙的卡顿问题。
3. STM32端配置技巧
给STM32配置串口就像教小朋友说外语，既要说清楚语法（寄存器配置），又要练好发音（波特率匹配）。我用HAL库配置USART1的代码骨架是这样的：
UART_HandleTypeDef huart1; void MX_USART1_UART_Init(void) { huart1.Instance = USART1; huart1.Init.BaudRate = 115200; huart1.Init.WordLength = UART_WORDLENGTH_8B; huart1.Init.StopBits = UART_STOPBITS_1; huart1.Init.Parity = UART_PARITY_NONE; huart1.Init.Mode = UART_MODE_TX_RX; huart1.Init.HwFlowCtl = UART_HWCONTROL_NONE; HAL_UART_Init(&huart1); }实际调试中发现三个关键点：
- 波特率误差要小于3%，我有次设了9615波特率（本想设9600），结果误码率高达30%
- 中断优先级要合理设置，特别是当系统中有其他实时任务时
- 接收缓冲区建议用环形队列，就像快递柜一样避免数据堆积
发送数据的实战代码示例：
char msg[] = "Hello Raspberry!\n"; HAL_UART_Transmit(&huart1, (uint8_t *)msg, strlen(msg), 100);接收端建议使用中断方式，就像订报纸而不是天天跑邮局问：
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if(huart->Instance == USART1){ // 处理接收到的数据 HAL_UART_Receive_IT(&huart1, &rx_data, 1); } }4. 双机通信实战测试
当树莓派的绿灯和STM32的蓝灯同时闪烁时，那种成就感就像第一次打通电话。但在这之前，我们要先做好物理连接：
- 树莓派TX(引脚8) —— STM32 RX(PA10)
- 树莓派RX(引脚10) —— STM32 TX(PA9)
- 树莓派GND(引脚6) —— STM32 GND
这里有个防呆设计：用万用表二极管档测通断，TX-RX应该不通，TX-TX应该通。如果发现接反了，千万别带电拔插，我因此烧过两个CH340芯片。
树莓派上的Python测试脚本建议这样写：
import serial import time ser = serial.Serial( port='/dev/ttyAMA0', baudrate=115200, parity=serial.PARITY_NONE, stopbits=serial.STOPBITS_ONE, bytesize=serial.EIGHTBITS, timeout=1 ) while True: ser.write(b'PING') time.sleep(0.5) if ser.in_waiting: print(ser.read_all())STM32端可以这样响应：
if(strncmp((char*)rx_buffer, "PING", 4) == 0){ HAL_UART_Transmit(&huart1, (uint8_t*)"PONG\n", 5, 100); }调试时建议准备三个终端窗口：
- minicom监视原始数据流
- Python脚本运行窗口
- 日志输出窗口（可用
dmesg -w观察内核消息）
常见问题排查表：
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
| 完全无反应 | 接线错误 | 用万用表检查TX-RX交叉 |
| 收到乱码 | 波特率不匹配 | 两边用相同标准波特率 |
| 数据截断 | 缓冲区溢出 | 增加接收缓冲区大小 |
| 间歇性丢失 | 电源干扰 | 添加0.1uF去耦电容 |
5. 性能优化与高级技巧
当基础通信跑通后，就像刚学会骑车就想玩特技。这些优化技巧是我踩过无数坑总结出来的：
波特率选择玄学：
- 短距离传输用115200bps足够
- 长距离建议降到9600bps
- 特殊场景可用自定义波特率，比如用
stty -F /dev/ttyAMA0 57600设置
数据校验三重保险：
- 协议层添加CRC校验
- 重要数据要求应答
- 定时发送心跳包
Python端高效接收方案：
def read_serial(): while True: data = ser.read(ser.in_waiting or 1) if data: process_data(data) thread = threading.Thread(target=read_serial) thread.daemon = True thread.start()STM32端DMA优化方案：
// 初始化DMA __HAL_UART_ENABLE_IT(&huart1, UART_IT_IDLE); HAL_UART_Receive_DMA(&huart1, dma_buffer, BUFFER_SIZE); // 空闲中断处理 void USART1_IRQHandler(void) { if(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_IDLE)){ __HAL_UART_CLEAR_IDLEFLAG(&huart1); // 处理dma_buffer中的数据 HAL_UART_Receive_DMA(&huart1, dma_buffer, BUFFER_SIZE); } }抗干扰三板斧：
- 在TX/RX线上串接100Ω电阻
- 在信号线与地之间并接10pF电容
- 使用双绞线代替普通杜邦线
有个项目在工业环境使用时，电磁干扰导致误码率飙升。后来在信号线上套了磁环，就像给数据穿了防弹衣，通信立即稳定了。
6. 常见问题解决方案
遇到问题时的表情，就像半夜发现代码突然不工作的程序员。这些解决方案可能帮你省下几小时调试时间：
权限问题终极方案：
sudo chmod a+rw /dev/ttyAMA0 sudo systemctl disable serial-getty@ttyAMA0.service sudo systemctl stop serial-getty@ttyAMA0.service内核日志监控技巧：
dmesg | grep tty这个命令就像串口通信的X光机，我靠它发现过GPIO复用冲突的问题。
Python环境依赖问题：
sudo apt install python3-serial pip install pyserial --upgrade注意：系统自带的serial包可能版本较旧，会导致timeout参数异常。
STM32端HardFault排查：
- 检查时钟配置是否正确
- 确认中断优先级分组设置
- 查看MAP文件确认内存分配
有次我的STM32收到数据就死机，最后发现是堆栈设置太小。在启动文件里把Stack_Size从0x400改为0x800就解决了，就像给小房子换了张大床。
树莓派CPU频率干扰：
sudo nano /boot/config.txt添加：
core_freq=250 core_freq_min=250这样可以防止CPU变频影响mini串口，就像给时钟上了发条。
最后分享一个血泪教训：永远在代码开头加版本注释。有次半年后要修改项目，死活想不起当时用的什么波特率，现在我的代码都长这样：
# 项目：智能温室控制器 # 版本：v2.3 2023-05-12 # 通信参数：115200bps,8N1,无流控 # 接线：树莓派TX->PA10, RX->PA9 # 注意事项：STM32需先上电
