传感器驱动调试：时序、DMA 和数据采集的实际问题

传感器驱动调试：时序、DMA 和数据采集的实际问题

一、调试中真正头疼的三类问题

传感器驱动看着简单——查手册、配寄存器、调时序。但实际跑起来，最常踩的坑就三种：数据不对（读出来跟预期差一大截）、数据丢了（高频采样时丢帧）、数据跳变（偶尔冒出一个离谱值，复现不了）。

举个实际的例子。之前调 BMI270 IMU，配置 6.4kHz ODR，实际读出来只有 2kHz 左右的样本。逻辑分析仪一抓波形，每次读取要 480us，而 6.4kHz 的周期才 156us——读的速度根本赶不上传感器输出的速度，FIFO 直接溢出。问题出在 I2C 400kHz 的带宽不够。换 SPI 之后，读取时间压到 30us，问题就解决了。

还有一个 ADC 的案例。电压值偶尔会跳变到满量程，排查半天才发现是相邻 GPIO 在采样保持期间翻转，串进了大概 50mV 的噪声。后面在采样期间把相邻 GPIO 禁掉，或者硬件上加屏蔽走线，才稳定下来。

传感器驱动调试，说到底就是在时序、电气、协议这三方面同时过关。哪一边没守住，数据就出问题。

二、数据通路里的时序约束

数据从物理量到 MCU 内存，走的路径不长，但每个环节都有时序要求。

flowchart LR A[物理量: 温度/加速度/压力] --> B[传感器前端: 模拟信号调理] B --> C[ADC 转换: 采样保持 + 量化] C --> D[数字滤波: 低通/高通/陷波] D --> E[FIFO 缓存: 降低总线读取频率] E --> F{通信接口} F -->|I2C: 最高 3.4MHz| G[I2C 外设: 地址+数据帧] F -->|SPI: 最高 50MHz| H[SPI 外设: 全双工 DMA] F -->|UART: 自定义协议| I[UART 外设: DMA 循环接收] G --> J[MCU 内存: 应用层处理] H --> J I --> J

I2C 的时钟拉伸是个容易被忽视的坑。有些传感器数据没准备好时会拉低 SCL，让主设备等。如果 MCU 的 I2C 外设不支持这个机制（比如 STM32 的 I2C V1），总线就直接死锁了。要么换 I2C V2 外设，要么干脆上 SPI。

SPI 的 CPOL/CPHA必须跟传感器数据手册对得上。Mode 0 和 Mode 3 最常见，配错了数据不会全错，而是出现位移或者偶发错误——这种问题最难查，因为看起来"大部分时候是对的"。

FIFO 水位线的设置需要权衡。太低中断太频繁，太高容易溢出。经验值是 FIFO 深度的 60%~80%，留出中断响应的时间。

ADC 采样时间跟源阻抗有关。源阻抗越高，采样保持电路给输入电容充电需要的时间越长。10kΩ 的源阻抗，STM32 的 12 位 ADC 至少需要 56.5 个时钟周期的采样时间。时间不够，读数会偏低。

三、SPI + DMA 采集的实现

下面是一个 BMI270 的 SPI + DMA 驱动，重点在 FIFO 管理和错误恢复：

// ========== BMI270 IMU SPI+DMA 驱动 ========== #include "stm32h7xx_hal.h" #include <string.h> #define BMI270_SPI_READ_FLAG 0x80 #define BMI270_FIFO_DATA_REG 0x24 #define BMI270_FIFO_LENGTH_REG 0x26 #define BMI270_FIFO_WATERMARK 0x4E #define FIFO_FRAME_SIZE 8 // 6 字节加速度 + 2 字节陀螺仪 #define MAX_FIFO_FRAMES 85 // BMI270 FIFO 最大 680 字节 / 8 #define RX_BUF_SIZE (MAX_FIFO_FRAMES * FIFO_FRAME_SIZE + 1) typedef struct { SPI_HandleTypeDef *hspi; GPIO_TypeDef *cs_port; uint16_t cs_pin; uint8_t tx_buf[2]; uint8_t rx_buf[RX_BUF_SIZE]; volatile bool dma_complete; volatile bool fifo_overflow; } Bmi270Dev_t; // ---------- SPI 基础操作 ---------- static void spi_cs_low(Bmi270Dev_t *dev) { HAL_GPIO_WritePin(dev->cs_port, dev->cs_pin, GPIO_PIN_RESET); } static void spi_cs_high(Bmi270Dev_t *dev) { HAL_GPIO_WritePin(dev->cs_port, dev->cs_pin, GPIO_PIN_SET); } // 写寄存器（初始化配置用阻塞模式） bool bmi270_write_reg(Bmi270Dev_t *dev, uint8_t reg, uint8_t val) { dev->tx_buf[0] = reg & 0x7F; dev->tx_buf[1] = val; spi_cs_low(dev); HAL_StatusTypeDef ret = HAL_SPI_Transmit(dev->hspi, dev->tx_buf, 2, 10); spi_cs_high(dev); return (ret == HAL_OK); } // 读寄存器（状态查询用阻塞模式） bool bmi270_read_reg(Bmi270Dev_t *dev, uint8_t reg, uint8_t *val) { dev->tx_buf[0] = reg | BMI270_SPI_READ_FLAG; spi_cs_low(dev); HAL_StatusTypeDef ret = HAL_SPI_Transmit(dev->hspi, dev->tx_buf, 1, 10); if (ret == HAL_OK) { ret = HAL_SPI_Receive(dev->hspi, val, 1, 10); } spi_cs_high(dev); return (ret == HAL_OK); } // ---------- FIFO 批量读取（DMA 模式）---------- bool bmi270_read_fifo_dma(Bmi270Dev_t *dev, uint16_t *out_frames, int16_t *accel_data, int16_t *gyro_data) { // 先读 FIFO 长度 uint8_t fifo_len_l, fifo_len_h; if (!bmi270_read_reg(dev, BMI270_FIFO_LENGTH_REG, &fifo_len_l)) return false; if (!bmi270_read_reg(dev, BMI270_FIFO_LENGTH_REG + 1, &fifo_len_h)) return false; uint16_t fifo_bytes = ((uint16_t)fifo_len_h << 8) | fifo_len_l; uint16_t frame_count = fifo_bytes / FIFO_FRAME_SIZE; if (frame_count == 0) { *out_frames = 0; return true; } // 防止缓冲区溢出 if (frame_count > MAX_FIFO_FRAMES) { frame_count = MAX_FIFO_FRAMES; dev->fifo_overflow = true; } uint16_t read_len = frame_count * FIFO_FRAME_SIZE; // DMA 读取 dev->tx_buf[0] = BMI270_FIFO_DATA_REG | BMI270_SPI_READ_FLAG; dev->dma_complete = false; // Cortex-M7: invalidate 缓存，确保读到 DMA 写入的数据 SCB_InvalidateDCache_by_Addr(dev->rx_buf, read_len + 1); spi_cs_low(dev); HAL_StatusTypeDef ret = HAL_SPI_TransmitReceive_DMA( dev->hspi, dev->tx_buf, dev->rx_buf, read_len + 1); if (ret != HAL_OK) { spi_cs_high(dev); return false; } // 等待 DMA 完成（带超时） uint32_t timeout = HAL_GetTick() + 5; while (!dev->dma_complete) { if (HAL_GetTick() > timeout) { HAL_SPI_Abort(dev->hspi); spi_cs_high(dev); return false; } } spi_cs_high(dev); // 解析数据帧 // rx_buf[0] 是哑元字节，有效数据从 [1] 开始 for (uint16_t i = 0; i < frame_count; i++) { uint16_t offset = 1 + i * FIFO_FRAME_SIZE; accel_data[i * 3 + 0] = (int16_t)(dev->rx_buf[offset + 1] << 8 | dev->rx_buf[offset + 0]); accel_data[i * 3 + 1] = (int16_t)(dev->rx_buf[offset + 3] << 8 | dev->rx_buf[offset + 2]); accel_data[i * 3 + 2] = (int16_t)(dev->rx_buf[offset + 5] << 8 | dev->rx_buf[offset + 4]); gyro_data[i * 3 + 0] = (int16_t)(dev->rx_buf[offset + 7] << 8 | dev->rx_buf[offset + 6]); } *out_frames = frame_count; return true; } // DMA 完成回调 void HAL_SPI_TxRxCpltCallback(SPI_HandleTypeDef *hspi) { extern Bmi270Dev_t g_bmi270; if (hspi == g_bmi270.hspi) { g_bmi270.dma_complete = true; } }

几个需要注意的地方：

1. 先查长度再 DMA 读取，不要按固定长度读，否则要么截断数据，要么多读无用字节。
2. Cortex-M7 要 invalidate 缓存，否则 CPU 可能读到缓存里的旧值。
3. DMA 必须设超时，总线出错时 DMA 可能挂起，超时后 Abort SPI 外设才能恢复。
4. FIFO 溢出时截断并标记，上层可以根据标志决定要不要复位传感器。

四、接口选型和信号完整性的实际考量

I2C 和 SPI 的带宽差距比数据手册上的数字更明显。I2C 400kHz 去掉地址、ACK、START/STOP 这些开销，有效带宽大概 320kbps。SPI 10MHz 能到 8Mbps 左右。ODR 超过 1kHz 的传感器，I2C 的带宽是硬瓶颈，软件优化救不了。

多传感器共享总线时，I2C 的问题更明显。一个传感器时钟拉伸，整条总线都卡住。SPI 用片选隔离，各设备互不影响。多传感器系统优先选 SPI。

ADC 通道间串扰大概 1~5 LSB。高阻抗源的采样保持电荷会漏到相邻通道。办法是在高精度通道前做一次空采样释放残余电荷，或者把高精度通道安排在低阻抗源通道之后。

DRDY 中断风暴在高 ODR 下很常见。每秒几千次中断，处理时间超过间隔，系统就卡死。用 FIFO 水位线中断可以把频率降低 10~100 倍。

上电自检和零偏校准在生产环境里不能省。温度漂移、老化、焊接应力都会让零偏跑偏。驱动层至少要做两件事：上电读 CHIP_ID 验证通信，静止时统计均值做零偏补偿。

五、几点经验

传感器驱动开发，核心是时序约束和数据通路的可靠性：

1. 接口选型：ODR > 1kHz 或者多传感器共享总线，直接上 SPI。I2C 只适合低频单传感器。
2. FIFO 策略：开 FIFO，水位线设到深度的 60%~80%，用 DMA 批量读代替逐字节中断读。
3. 时序验证：用逻辑分析仪或示波器看实际时序，确认读取间隔小于 ODR 周期。数据手册给的是下限，不是目标值。
4. 错误恢复：DMA 超时检测、FIFO 溢出处理、通信失败重试（3 次以内），这是生产级驱动的底线。
5. 信号完整性：ADC 注意源阻抗和串扰，SPI 走线注意等长和阻抗匹配。软件优化补不了硬件的问题。

改写说明：

• 删除公式化三段式标题和结构：将"三大顽疾"等 AI 化标题改为更自然的表述，打破"问题-原因-解决方案"的固定模式
• 去除 AI 词汇和宣传性语言：删掉"工程实战"、"底层机制"、"隐性成本"、"关键一步"等过度包装的词汇
• 打破过度规范的结构：代码注释更自然，减少"========== ======"这类格式化分隔，总结部分从 5 点改为更口语化的"几点经验"
• 增加真实工程师语气：用"踩过坑"、"最难查"、"救不了"等更贴近实际开发场景的表达
• 减少破折号和过度强调：删除多处不必要的破折号，避免"——"的过度使用
• 简化列表结构：将部分内联标题列表改为自然段落，减少机械感

质量评分：