2. 硬件接口调试：I2C总线协议详解、SPI通信调试技巧、UART串口日志输出
各位工程师，咱们直接进入正题。医疗显微镜的嵌入式系统里，硬件接口就是设备的「神经末梢」。I2C、SPI、UART 这三个接口，我敢说占了嵌入式调试工作量的 70% 以上。今天我就把这几年的实战经验掰开揉碎了讲给你听。
2.1 I2C 总线协议详解
I2C 这玩意儿，说白了就是两根线走天下——SCL（时钟）和 SDA（数据）。它最大的优点是省引脚，一个主设备能挂几十个从设备。但省事的代价就是调试起来有点绕。
2.1.1 协议核心要点
- 起始条件：SCL 高电平时，SDA 从高到低跳变。我习惯用逻辑分析仪抓这个边沿，一眼就能看出主设备有没有「开口说话」。
- 从机地址：7 位地址 + 读写位。注意！很多新手搞混了地址左移一位的问题。比如设备地址是 0x50，实际发送的是 0xA0（写）或 0xA1（读）。
- 应答机制：每个字节后跟一个 ACK/NACK。我曾经被一个不拉低 SDA 的从设备坑了整整两天——它就是不回应，但示波器看波形又正常。后来发现是上拉电阻阻值选大了。
重要提醒：医疗设备对时序要求极高。I2C 总线电容不能超过 400pF，否则上升沿会变缓。我见过一台显微镜因为用了 1 米长的排线，I2C 直接罢工。
2.1.2 调试技巧
我个人习惯用逻辑分析仪抓 I2C 波形。别光看数据对不对，要盯着时序参数看：
| 参数 | 标准模式 | 快速模式 | 我的经验值 |
|---|---|---|---|
| SCL 频率 | 100kHz | 400kHz | 别超过 350kHz，留余量 |
| 上升时间 | 1000ns | 300ns | 超过 500ns 就要查上拉电阻 |
| 数据建立时间 | 250ns | 100ns | 至少留 50ns 余量 |
避坑指南：我曾经在调试一款 CMOS 图像传感器时，I2C 读写偶尔失败。查了三天，最后发现是中断服务程序里调用了 I2C 读写函数，导致时序被中断打乱。记住：I2C 操作不要在中断里做！
2.2 SPI 通信调试技巧
SPI 比 I2C 快得多，但线也多——至少 4 根：SCK、MOSI、MISO、CS。医疗显微镜里，SPI 常用来驱动显示屏或高速 ADC。
2.2.1 四种模式别搞混
SPI 有四种模式，由 CPOL（时钟极性）和 CPHA（时钟相位）决定。我见过最离谱的 bug，是两个工程师用了不同的 SPI 模式，数据死活对不上。
- 模式 0：CPOL=0，CPHA=0。空闲时 SCK 低电平，第一个边沿采样。这是最常用的模式。
- 模式 1：CPOL=0，CPHA=1。空闲低，第二个边沿采样。
- 模式 2：CPOL=1，CPHA=0。空闲高，第一个边沿采样。
- 模式 3：CPOL=1，CPHA=1。空闲高，第二个边沿采样。
注意：很多国产芯片的数据手册写得不清楚。我建议你直接看时序图，数一下数据是在 SCK 上升沿还是下降沿变化的。别信文字描述，信眼睛看到的。
2.2.2 调试三板斧
第一斧：检查 CS 信号。CS 必须在整个传输过程中保持低电平。我遇到过 CS 被 DMA 意外拉高的情况，数据只传了一半。
第二斧：看 MISO 有没有输出。如果 MISO 一直高阻，说明从设备没被正确选中。这时候查 CS 和供电。
第三斧：测 SCK 频率。SPI 速度不是越快越好。我调试一块 LCD 驱动板时，把 SCK 设到 20MHz，结果画面出现条纹。降到 10MHz 就正常了。为什么？因为从设备的输入缓冲有建立时间要求。
核心经验：SPI 调试时，先用 1MHz 低速跑通，再逐步提速。这能帮你快速区分是协议问题还是时序问题。
2.3 UART 串口日志输出
UART 是嵌入式调试的「眼睛」。没有它，你就像蒙着眼睛修机器。医疗显微镜的调试过程中，我至少 80% 的问题是通过串口日志定位的。
2.3.1 波特率匹配
这听起来简单，但坑最多。两边波特率必须一致，误差不能超过 2%。我算过一笔账：
| 标称波特率 | 实际误差 | 能否稳定通信 |
|---|---|---|
| 9600 | ±0.5% | 完全没问题 |
| 115200 | ±1.5% | 短距离可以 |
| 921600 | ±3% | 大概率丢数据 |
为什么会这样？因为 UART 是异步通信，靠起始位同步。误差大了，采样点会偏移到数据位边界上。
我的习惯：调试阶段用 115200，稳定后改 9600 用于生产。115200 速度快，但抗干扰差；9600 慢但稳。医疗设备嘛，稳字当头。
2.3.2 日志分级输出
别把所有信息都往串口扔。我见过有人把 ADC 原始数据每秒打印 1000 次，结果调试信息把正常通信都挤没了。建议这样分级：
- ERROR：系统崩溃、传感器无响应。必须打印，且要闪烁 LED 提示。
- WARNING：数据校验失败、重试次数超限。打印出来，但别太频繁。
- INFO：系统启动、模式切换。正常运行时打印，调试时可关闭。
- DEBUG：变量值、状态机跳转。只在调试阶段开启。
// 我常用的日志宏定义
#define LOG_E(fmt, ...) printf("[ERROR] " fmt "\r\n", ##__VA_ARGS__)
#define LOG_W(fmt, ...) printf("[WARN] " fmt "\r\n", ##__VA_ARGS__)
#define LOG_I(fmt, ...) printf("[INFO] " fmt "\r\n", ##__VA_ARGS__)
#ifdef DEBUG_ENABLE
#define LOG_D(fmt, ...) printf("[DEBUG] " fmt "\r\n", ##__VA_ARGS__)
#else
#define LOG_D(fmt, ...)
#endif2.3.3 环形缓冲区
串口打印是阻塞的。如果你在中断里直接 printf，系统响应会变慢。我建议用环形缓冲区：中断里只往缓冲区写数据，主循环里再统一发送。
曾经踩过的坑：有一次我调试显微镜的自动对焦模块，串口日志打印太多，导致电机控制中断被延迟。结果镜头来回震荡，差点撞坏。从那以后，我所有串口输出都加了时间戳和优先级控制。
2.4 三种接口的选型建议
最后给你个总结。选接口时，别只看速度：
- I2C：适合传感器配置、EEPROM 读写。线少，但速度慢，不适合大数据量。
- SPI：适合显示屏、ADC、DAC。速度快，但线多，抗干扰要处理好。
- UART：适合调试日志、GPS 模块。简单可靠，但只能点对点。
嗯，接口调试这块就说这么多。记住：示波器和逻辑分析仪是你的左右手。别光看代码，要看波形。波形对了，代码基本没问题；波形不对，代码写得再漂亮也是白搭。