很多项目的 main.c里充斥着 HAL_GPIO_WritePin()和 HAL_UART_Transmit()。这种写法导致换一颗 MCU，业务逻辑必须重写。本文将演示如何通过 BSP 适配层（Board Support Package），实现“换芯片不改业务”。

TIM 配置成 Encoder Mode，正转加计数，反转减计数，低速正常，高速就乱？不是编码器精度问题，而是 TI1/TI2 的极性（Polarity）与输入滤波配置错误。本文解析正交编码器的硬件解码逻辑。

TIM 配置 1ms 中断，示波器测出来却是 1.024ms？或者中断偶尔丢失？不是 SystemCoreClock 算错，而是 Counter Mode（计数模式）​ 与 Center-Aligned（中心对齐）​ 配置导致的隐性误差。本文还原 TIM 中断的真实时序。

TIM 触发 DMA 搬运 ADC 数据，示波器看 ADC 在采样，但 DMA 缓冲区数据错位？不是 DMA 配置错了，而是 TIM 的 Update Event​ 与 TRGO​ 信号没对齐。本文解析 TIM 触发 DMA 的“隐形条件”。

USB CDC 设备插上 Windows，设备管理器里出现“未知设备”或“CDC ACM 设备”？不是代码不行，而是 VID/PID 未被 Windows 内置驱动识别，或 INF 文件配置错误。本文解析 CDC 虚拟串口的驱动匹配机制。

USB 描述符复制了例程，只是改了个 PID，电脑就提示“设备描述符请求失败”？不是 USB 栈坏了，而是描述符长度（bLength）或总长度（wTotalLength）算错了。本文拆解 USB 描述符的“字节级”潜规则。

CAN 总线调试时记不住终端电阻值？波特率怎么算？错误状态有哪些？本文汇总 CAN 物理层、链路层、协议层的核心参数与经验值，建议收藏并作为项目 Check List。

USB 设备在系统休眠后无法唤醒？或者长时间传输大数据时突然掉线？不是线缆问题，而是设备没有正确处理 SOF（帧起始）​ 和 Remote Wakeup（远程唤醒）​ 协议。本文解析 USB 的电源状态机。

USB CDC 虚拟串口理论带宽 1MB/s，实测只有 60kB/s？不是 USB 栈不行，而是端点（Endpoint）的最大包长度（MPS）和 FIFO 深度配置错了。本文拆解 USB 吞吐量的计算模型。

《嵌入式外设底层避坑指南》专栏聚焦六大核心外设（UART/SPI/I2C/CAN/USB/ADC）的实战陷阱，提供可落地的解决方案。内容涵盖：UART的ORE中断与死区时间处理、SPI的CPOL相位配置、I2C死锁解救方法、CAN总线阻抗匹配技巧、USB枚举电阻配置、ADC采样干扰排查等硬核知识点。专栏摒弃API搬运，直击工程师实际遇到的波形异常、数据丢帧、枚举失败等典型问题，附赠速查表与波形分析