WF100DPZ 这颗数字压力传感器第一次上手的人十有八九会在接口配置上卡住。不是读不出数据就是读出来的值飘得离谱再不然就是 I2C 死活不应答、SPI 波形看着对但数据全错。我自己前前后后用它做过三四个项目从最开始的 I2C 轮询到后来 SPI 配 DMA 批量采集中间踩的坑足够写一本小册子。这篇就把 WF100DPZ 的 I2C 和 SPI 两套接口配置从头到尾捋一遍重点讲清楚每一步为什么这么配以及那些文档里不会写、但实际调试中一定会遇到的错误怎么排查。不管你是刚拿到模块的新手还是已经调通但想搞清楚底层逻辑的老手应该都能从里面找到有用的东西。1. 先搞清楚 WF100DPZ 到底是个什么样的器件1.1 它的核心参数决定了接口怎么配WF100DPZ 是一颗数字输出的压力传感器内部集成了压力敏感元件和信号调理电路直接输出经过校准的数字量。这一点很关键——它不像那些只出模拟电压的传感器需要你自己外接 ADC 再换算它把 ADC 和校准都做在里面了你拿到的就是已经处理过的压力值。从接口能力上看它同时支持 I2C 和 SPI 两种数字通信方式这也是标题里说双接口的原因。实际选哪个取决于你的系统架构和采集需求。我先把几个影响配置决策的关键参数列出来参数项典型值对接口配置的影响供电电压3.3V部分型号支持 5V决定电平匹配和上拉电阻接法I2C 从机地址固定或可选视具体批次决定地址字节怎么写I2C 速率最高 400kHz决定上拉电阻取值和走线要求SPI 模式通常为 Mode 0 或 Mode 3决定 CPOL/CPHA 配置SPI 最高时钟一般 1MHz~10MHz决定分频系数和 DMA 配置数据分辨率16 位或 24 位决定读取字节数和数据拼接方式这里要特别提醒一句不同批次的 WF100DPZ 在从机地址和 SPI 模式上可能有差异拿到模块第一件事是确认你手上这颗的具体规格别直接抄别人的代码。我就吃过这个亏照着网上一个例程配了 I2C 地址结果死活不应答后来翻规格书才发现那批货的地址位不一样。1.2 I2C 和 SPI 各自的适用场景很多人纠结到底用哪个接口其实判断逻辑很简单I2C 适合的场景系统里已经有 I2C 总线挂了好几个器件引脚资源紧张采集频率不高比如每秒几次到几十次。WF100DPZ 用 I2C 只占两个引脚SCL、SDA还能和其他传感器共用总线布线简单。SPI 适合的场景需要高速连续采集比如做压力波形分析、动态压力监测采样率要求上千赫兹。SPI 是全双工、无地址开销配合 DMA 可以做到几乎不占 CPU数据吞吐量比 I2C 高一个数量级。我自己的经验是如果只是做静态压力监测I2C 完全够用配置也简单如果要做动态采集或者多通道同步直接上 SPI DMA别犹豫。后面两套配置我都会详细讲。1.3 硬件连接前必须确认的三件事在动手写代码之前先把硬件层面的事情确认清楚能省掉后面一大半的调试时间第一确认电平。WF100DPZ 的 IO 电平是 3.3V如果你的主控是 5V 系统比如某些老款单片机必须做电平转换否则要么读不到数据要么长期运行损坏器件。第二确认上拉电阻。I2C 是开漏输出SCL 和 SDA 必须接上拉电阻才能拉高。WF100DPZ 的 I2C 接口通常需要 4.7kΩ 到 10kΩ 的上拉速率越高阻值越小。这里有个常见误区有些人以为主控内部有上拉就不用外接了但内部上拉通常很弱几十 kΩ在 400kHz 速率下上升沿会严重变缓导致通信失败。第三确认片选和地址。SPI 模式下要接 CS 片选线I2C 模式下要确认从机地址。这两点后面会展开讲。2. I2C 接口配置从时序理解到代码落地2.1 I2C 时序的本质为什么用开漏加外部上拉要配好 I2C得先理解它为什么这么设计。I2C 只有两根线SCL 是时钟SDA 是数据而且都是开漏输出加外部上拉的结构。开漏的意思是器件只能把线拉低不能主动拉高拉高靠的是外部上拉电阻。为什么这么设计因为 I2C 是总线结构可以挂多个器件。如果两个器件同时驱动总线一个想拉高一个想拉低就会短路。开漏结构下任何器件都只能拉低只要有一个拉低总线就是低电平不会出现冲突。这就是所谓的线与逻辑。理解了这一点你就明白为什么上拉电阻这么重要了。上拉电阻和总线电容构成一个 RC 充电回路上升沿的时间常数 τ R × C。如果电阻太大或者总线电容太大上升沿就会变缓在高速率下还没升到高电平阈值下一个时钟沿就来了通信自然失败。我实测过一组数据供参考上拉电阻总线电容上升时间约400kHz 下是否可用10kΩ100pF1μs勉强边沿偏缓4.7kΩ100pF0.47μs可用2.2kΩ100pF0.22μs良好10kΩ400pF4μs不可用所以如果你的 I2C 在低速下能用、高速下就出错第一件事就是减小上拉电阻或者缩短走线降低电容。2.2 WF100DPZ 的 I2C 读写帧格式WF100DPZ 的 I2C 通信遵循标准的寄存器读写模型。一次完整的读操作流程是这样的主机发送起始条件START主机发送从机地址 写位0从机应答ACK主机发送要读取的寄存器地址从机应答ACK主机发送重复起始条件Repeated START主机发送从机地址 读位1从机应答ACK从机发送数据高字节主机应答从机发送数据低字节主机发送非应答NACK主机发送停止条件STOP这个流程里有两个容易出错的地方重复起始条件和最后的非应答。重复起始是为了在不释放总线的情况下切换读写方向很多简化版的 I2C 驱动不支持这个就会导致读操作失败。最后的非应答是告诉从机我读完了如果主机错误地发了应答从机会继续输出下一个字节数据就乱了。用 HAL 库的话读寄存器通常用HAL_I2C_Mem_Read这个函数它内部会自动处理重复起始和最后的 NACK。但如果你用的是软件模拟 I2C就得自己把时序写对。2.3 基于 HAL 库的 I2C 初始化配置以 STM32 为例用 CubeMX 配置 I2C 外设时几个关键参数这样设I2C Speed Mode选 Fast Mode速率设 400kHz。如果走线长或者上拉偏大先降到 100kHz 调通再提速。Clock No Stretch Mode一般关闭允许从机拉低 SCL 做时钟延展。WF100DPZ 在某些转换周期会拉低 SCL如果禁止了时钟延展就会读错。Primary Address Length7 位地址模式。Dual Address关闭。初始化代码大致如下hi2c1.Instance I2C1; hi2c1.Init.ClockSpeed 400000; hi2c1.Init.DutyCycle I2C_DUTYCYCLE_2; hi2c1.Init.OwnAddress1 0; hi2c1.Init.AddressingMode I2C_ADDRESSINGMODE_7BIT; hi2c1.Init.DualAddressMode I2C_DUALADDRESS_DISABLE; hi2c1.Init.GeneralCallMode I2C_GENERALCALL_DISABLE; hi2c1.Init.NoStretchMode I2C_NOSTRETCH_DISABLE;注意DutyCycle这个参数Fast Mode 下可以选 2:1 或 16:9。16:9 能让高低电平时间更均衡在长走线场景下更稳但有些从机对时序敏感2:1 兼容性更好。WF100DPZ 两种都支持我一般先用 2:1。2.4 读取压力数据的完整代码实现假设 WF100DPZ 的压力数据寄存器地址是 0x00高字节和 0x01低字节从机地址是 0x6D左移一位后是 0xDA读取代码如下#define WF100DPZ_ADDR (0x6D 1) #define REG_PRESS_H 0x00 #define REG_PRESS_L 0x01 uint8_t buf[2]; uint16_t raw_pressure; if (HAL_I2C_Mem_Read(hi2c1, WF100DPZ_ADDR, REG_PRESS_H, I2C_MEMADD_SIZE_8BIT, buf, 2, 100) HAL_OK) { raw_pressure (uint16_t)((buf[0] 8) | buf[1]); // 根据规格书换算成实际压力值 float pressure raw_pressure * 0.01f; // 系数以规格书为准 }这里I2C_MEMADD_SIZE_8BIT表示寄存器地址是 8 位。如果 WF100DPZ 用的是 16 位寄存器地址就要改成I2C_MEMADD_SIZE_16BIT这个搞错了会直接读不到数据。2.5 I2C 配置中最容易踩的四个坑坑一从机地址搞错。这是最高频的问题。规格书给的地址可能是 7 位原始值而 HAL 库要求传入的是左移一位后的值。比如规格书写 0x6D你传给 HAL 的应该是 0xDA。我见过太多人在这里卡半天。坑二上拉电阻缺失或过大。前面讲过内部上拉太弱必须外接。如果你用逻辑分析仪看波形发现 SDA 或 SCL 上升沿是缓慢的斜坡而不是陡峭的跳变就是上拉的问题。坑三时钟延展被禁止。WF100DPZ 在内部转换期间会拉低 SCL 告诉主机等一下如果主控配置了 NoStretch就会忽略这个信号读到无效数据。坑四总线死锁。如果通信过程中主控复位而从机还在输出数据SDA 可能被从机一直拉低总线就锁死了。解决办法是在初始化时手动发送 9 个时钟脉冲让从机释放总线。3. SPI 接口配置高速采集的正确打开方式3.1 SPI 四种模式与 WF100DPZ 的匹配SPI 有四种模式由 CPOL时钟极性和 CPHA时钟相位组合而成模式CPOLCPHA采样沿适用说明Mode 000上升沿最常用多数传感器默认Mode 101下降沿部分器件使用Mode 210下降沿较少见Mode 311上升沿部分传感器使用WF100DPZ 的 SPI 模式要以你手上那颗的规格书为准常见的是 Mode 0 或 Mode 3。判断方法很简单先用 Mode 0 试读不到数据就换 Mode 3。如果两个都不行再检查其他配置。我遇到过一颗标称 Mode 0 但实际要 Mode 3 才能读的后来发现是批次差异。3.2 CubeMX 中 SPI 参数的逐项设置用 CubeMX 配置 SPI 时每一项都有讲究Mode选 Full-Duplex Master全双工主机。WF100DPZ 作为从机主机要同时发和收。Data Size8 位。如果传感器是 16 位数据分两次读。CLK Polarity / Phase按上面确定的模式设。NSS选 Software软件片选。硬件片选虽然省事但多从机场景下不灵活而且有些主控的硬件 NSS 时序有 bug。软件片选自己控制 GPIO更可控。Baud Rate Prescaler决定 SPI 时钟。假设主频 72MHz分频 64 得到 1.125MHz分频 32 得到 2.25MHz。先从低速开始调通后再逐步提高。First BitMSB First绝大多数 SPI 器件都是高位先出。配置完生成代码后SPI 初始化部分大致是这样hspi1.Instance SPI1; hspi1.Init.Mode SPI_MODE_MASTER; hspi1.Init.Direction SPI_DIRECTION_2LINES; hspi1.Init.DataSize SPI_DATASIZE_8BIT; hspi1.Init.CLKPolarity SPI_POLARITY_LOW; hspi1.Init.CLKPhase SPI_PHASE_1EDGE; hspi1.Init.NSS SPI_NSS_SOFT; hspi1.Init.BaudRatePrescaler SPI_BAUDRATEPRESCALER_64; hspi1.Init.FirstBit SPI_FIRSTBIT_MSB; hspi1.Init.TIMode SPI_TIMODE_DISABLE; hspi1.Init.CRCCalculation SPI_CRCCALCULATION_DISABLE;3.3 软件片选与硬件片选的取舍标题热词里提到了spi硬件片选与软件片选这里展开说一下。硬件片选是主控的 SPI 外设自动控制 NSS 引脚发送数据时自动拉低发完自动拉高。优点是省 CPU时序精确。缺点是灵活性差多从机时要么用多个 SPI 外设要么用复杂的 NSS 脉冲模式。软件片选是自己用 GPIO 控制片选引脚发送前拉低发送后拉高。优点是灵活想怎么控就怎么控多从机随便挂。缺点是要手动管理忘了拉高就会导致从机一直占用总线。我的建议是单从机、追求极致速度用硬件片选多从机或者需要精细控制时序用软件片选。WF100DPZ 这种场景软件片选完全够用而且调试时更容易用逻辑分析仪观察。软件片选的操作代码#define WF100DPZ_CS_LOW() HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_RESET) #define WF100DPZ_CS_HIGH() HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_SET) uint8_t tx_buf[3] {0x00, 0x00, 0x00}; // 命令 两个空字节 uint8_t rx_buf[3]; WF100DPZ_CS_LOW(); HAL_SPI_TransmitReceive(hspi1, tx_buf, rx_buf, 3, 100); WF100DPZ_CS_HIGH(); uint16_t raw (uint16_t)((rx_buf[1] 8) | rx_buf[2]);注意这里用了HAL_SPI_TransmitReceive而不是分开的 Transmit 和 Receive因为 SPI 是全双工的发送的同时就在接收分开调用会丢失数据。3.4 SPI DMA 实现连续高速采集如果要做高速连续采集轮询方式就不够了CPU 会被完全占用。这时候要上 DMA。配置 DMA 的步骤在 CubeMX 的 SPI 配置里找到 DMA Settings添加 SPI1_TX 和 SPI1_RX 两个通道。模式选 Normal单次或 Circular循环。连续采集用 Circular。优先级设 High。数据宽度都选 Byte。代码实现#define BUF_SIZE 64 uint8_t spi_tx[BUF_SIZE]; uint8_t spi_rx[BUF_SIZE]; // 启动 DMA 传输 WF100DPZ_CS_LOW(); HAL_SPI_TransmitReceive_DMA(hspi1, spi_tx, spi_rx, BUF_SIZE); // DMA 完成回调 void HAL_SPI_TxRxCpltCallback(SPI_HandleTypeDef *hspi) { if (hspi-Instance SPI1) { WF100DPZ_CS_HIGH(); // 处理 spi_rx 中的数据 process_pressure_data(spi_rx, BUF_SIZE); } }这里有个关键点DMA 传输期间片选必须保持低电平所以 CS 的拉高要放在 DMA 完成回调里不能在启动 DMA 后立刻拉高。我见过有人在这里出错DMA 还没传完就把 CS 拉高了从机直接停止输出数据全是 0。另外如果用的是 Circular 模式CS 就不能在回调里拉高了得用别的方式管理。Circular 模式下 DMA 会一直循环传输适合连续采样的场景但要注意缓冲区会被不断覆盖处理数据要及时。3.5 SPI 通信不生效的排查链路SPI 通信不生效是热词里出现频率很高的问题。我把自己完整的排查流程整理出来你可以照着一步步走第一步看波形。用逻辑分析仪接上 SCLK、MOSI、MISO、CS 四根线发一次数据看波形有没有出来。如果 CS 没动说明片选控制有问题如果 SCLK 没动说明 SPI 外设没启动如果都有但 MISO 一直是高或一直是低说明从机没响应。第二步确认模式。波形出来了但数据不对先换 SPI 模式试试。Mode 0 和 Mode 3 是最常见的来回切一下。第三步降速。把 SPI 时钟降到最低比如 100kHz 以下如果低速能通高速不通就是时序或走线问题。第四步查片选时序。用逻辑分析仪看 CS 拉低到第一个时钟沿之间有没有足够的建立时间。有些从机要求 CS 拉低后至少等几百纳秒才能开始时钟。如果主控发得太快从机还没准备好第一个字节就丢了。第五步查数据顺序。MSB First 还是 LSB First 搞反了数据会完全错乱。这个在配置里改一下就行。第六步查电源和地。听起来很基础但我真的遇到过因为地线没接好导致 SPI 时好时坏的情况。确保主控和传感器共地电源稳定。4. 两套接口的实测对比与选型建议4.1 速度、资源占用、稳定性三维对比我把 WF100DPZ 在两种接口下的实测表现整理成表格对比维度I2C400kHzSPI2MHzSPI DMA2MHz单次读取耗时约 200μs约 20μs约 20μsCPU 占用近 0最大采样率约 2kHz约 20kHz约 20kHzCPU 占用中等较高极低引脚数244多器件扩展容易需要多片选需要多片选抗干扰能力较强差分逻辑一般单端一般配置复杂度低中高从表里能看出来I2C 胜在简单和扩展性SPI 胜在速度和 CPU 占用。如果你的采样率需求在 1kHz 以下I2C 完全够用没必要上 SPI 折腾。如果要做 10kHz 以上的动态采集SPI DMA 是唯一选择。4.2 什么情况下必须用 SPI有三种情况我建议直接上 SPI不要犹豫第一种采样率要求高。比如做压力脉动分析、冲击检测需要几千赫兹以上的采样率I2C 的 400kHz 带宽根本不够。第二种系统里 I2C 总线已经很拥挤。如果总线上挂了五六个器件每个都要通信I2C 的带宽会被瓜分WF100DPZ 的读取周期会被拉长。这时候单独给它一条 SPI 通道更合理。第三种需要和采集同步。SPI 的时序更确定配合 DMA 和定时器触发可以做到精确的等间隔采样这对做频谱分析很重要。I2C 因为时钟延展的存在采样间隔会有抖动。4.3 混合使用时的注意事项有些项目里 I2C 和 SPI 都要用比如 WF100DPZ 用 SPI 高速采集同时用 I2C 读其他慢速传感器。这种混合场景要注意引脚复用冲突。STM32 的 SPI 和 I2C 可能共用某些引脚配置时要查数据手册的复用表别冲突了。中断优先级。SPI 的 DMA 中断和 I2C 中断如果优先级设置不当可能互相打断导致数据错乱。一般把高速的 SPI DMA 中断设高优先级。电源去耦。两个接口同时工作时电流波动更大传感器的电源引脚旁边要加 100nF 和 10μF 的电容做去耦。5. 常见错误排查实战从现象到根因5.1 读出的压力值恒定不变或为 0这是最常见的问题。现象是代码能跑通不报错但读出来的值一直是同一个数或者 0。排查思路先确认通信是否真的成功。在读取函数里加打印看 HAL 函数的返回值是不是 HAL_OK。如果返回 HAL_ERROR 或 HAL_TIMEOUT说明通信层面就有问题回到接口配置去查。如果返回 HAL_OK 但数据不变那可能是读错了寄存器地址或者传感器没有触发新的转换。WF100DPZ 有些型号需要先写一个命令寄存器启动转换然后等一段时间再读结果。如果你直接读数据寄存器读到的可能是上次的旧值或者初始值。这个要仔细看规格书的寄存器说明。5.2 数据偶尔跳变或出现异常大值数据大部分正常但偶尔跳一下通常是时序或者干扰问题。如果是 I2C检查上拉电阻和走线看波形上升沿是否干净。如果是 SPI检查 CS 的时序看有没有在传输过程中被意外拉高。另外电源纹波也会导致数据跳变用示波器看一下传感器供电是否干净。还有一种可能是数据拼接错误。比如 16 位数据分两次读中间被中断打断读到了两次不同转换周期的数据。解决办法是读的时候关中断或者用传感器的连续读取模式一次性读完。5.3 逻辑分析仪抓不到任何波形如果逻辑分析仪接上去什么都看不到先别怀疑代码检查这几项逻辑分析仪的通道有没有接对引脚采样率够不够至少是被测信号频率的 5 倍以上触发条件设对没有比如设成 CS 下降沿触发探头地线有没有接好我遇到过逻辑分析仪地线没接导致波形全是噪声的情况折腾了半天才发现是硬件连接问题。5.4 通信一段时间后死机或数据停止更新这种跑一会儿就挂的问题最难查。常见原因有三个第一总线死锁。I2C 场景下如果主控在从机输出数据时复位SDA 可能被从机拉死。解决办法是加总线恢复机制检测到 SDA 一直为低就发时钟脉冲解锁。第二DMA 缓冲区溢出。SPI DMA 场景下如果数据处理速度跟不上采集速度缓冲区会被覆盖。要确保处理时间小于采集周期或者用双缓冲。第三看门狗复位。如果某个操作耗时太长触发了看门狗系统会不断复位。检查一下有没有阻塞式的等待改成超时机制。6. 几个能省下大量调试时间的实操技巧6.1 先用低速调通再提速这是我最想强调的一点。很多人一上来就把 I2C 设成 400kHz、SPI 设成 10MHz结果通信失败然后开始怀疑代码。正确的做法是先把速率降到最低I2C 用 100kHzSPI 用 100kHz 以下确认能正常读写数据了再逐步提高速率每次提高后验证一遍。这样一旦出问题你就知道是速率相关的时序问题排查范围大大缩小。6.2 用寄存器级操作验证硬件在写复杂驱动之前先用最简单的寄存器操作验证硬件连接是否正确。比如 I2C 就发一个地址看有没有 ACKSPI 就发一个字节看 MISO 有没有响应。这一步能快速区分是硬件问题还是软件问题。6.3 给关键时序留足余量WF100DPZ 的规格书里会给出各种时序参数的最小值和最大值比如 CS 建立时间、数据保持时间等。实际配置时不要贴着最小值来要留 20% 到 50% 的余量。因为规格书给的是理想条件下的值实际电路有走线延迟、器件离散性贴着极限值很容易在批量生产时出问题。6.4 做好错误计数和日志在产品代码里给通信错误加计数器记录超时、校验失败等事件的次数。调试阶段可以打印出来量产阶段可以通过这些计数判断传感器是否工作正常。这个习惯帮我提前发现过好几次偶发性的通信问题。6.5 保留一个已知good的配置备份调通一套配置后把 CubeMX 的配置文件、初始化代码、读取函数都备份一份。后面换项目或者改配置改出问题了可以快速回退到已知可用的版本。我自己的做法是每个项目建一个known_good文件夹专门存调通的版本。WF100DPZ 这颗传感器本身不算复杂但接口配置的细节很多任何一个环节没注意到都可能导致通信失败。我的经验是把硬件连接、时序理解、代码实现这三块都吃透再配合逻辑分析仪实际看波形基本就没有调不通的。真正花时间的往往不是写代码而是搞清楚为什么要这么配。希望这篇整理能帮你少走一些我当年走过的弯路。
WF100DPZ压力传感器I2C与SPI接口配置实战指南
WF100DPZ 这颗数字压力传感器第一次上手的人十有八九会在接口配置上卡住。不是读不出数据就是读出来的值飘得离谱再不然就是 I2C 死活不应答、SPI 波形看着对但数据全错。我自己前前后后用它做过三四个项目从最开始的 I2C 轮询到后来 SPI 配 DMA 批量采集中间踩的坑足够写一本小册子。这篇就把 WF100DPZ 的 I2C 和 SPI 两套接口配置从头到尾捋一遍重点讲清楚每一步为什么这么配以及那些文档里不会写、但实际调试中一定会遇到的错误怎么排查。不管你是刚拿到模块的新手还是已经调通但想搞清楚底层逻辑的老手应该都能从里面找到有用的东西。1. 先搞清楚 WF100DPZ 到底是个什么样的器件1.1 它的核心参数决定了接口怎么配WF100DPZ 是一颗数字输出的压力传感器内部集成了压力敏感元件和信号调理电路直接输出经过校准的数字量。这一点很关键——它不像那些只出模拟电压的传感器需要你自己外接 ADC 再换算它把 ADC 和校准都做在里面了你拿到的就是已经处理过的压力值。从接口能力上看它同时支持 I2C 和 SPI 两种数字通信方式这也是标题里说双接口的原因。实际选哪个取决于你的系统架构和采集需求。我先把几个影响配置决策的关键参数列出来参数项典型值对接口配置的影响供电电压3.3V部分型号支持 5V决定电平匹配和上拉电阻接法I2C 从机地址固定或可选视具体批次决定地址字节怎么写I2C 速率最高 400kHz决定上拉电阻取值和走线要求SPI 模式通常为 Mode 0 或 Mode 3决定 CPOL/CPHA 配置SPI 最高时钟一般 1MHz~10MHz决定分频系数和 DMA 配置数据分辨率16 位或 24 位决定读取字节数和数据拼接方式这里要特别提醒一句不同批次的 WF100DPZ 在从机地址和 SPI 模式上可能有差异拿到模块第一件事是确认你手上这颗的具体规格别直接抄别人的代码。我就吃过这个亏照着网上一个例程配了 I2C 地址结果死活不应答后来翻规格书才发现那批货的地址位不一样。1.2 I2C 和 SPI 各自的适用场景很多人纠结到底用哪个接口其实判断逻辑很简单I2C 适合的场景系统里已经有 I2C 总线挂了好几个器件引脚资源紧张采集频率不高比如每秒几次到几十次。WF100DPZ 用 I2C 只占两个引脚SCL、SDA还能和其他传感器共用总线布线简单。SPI 适合的场景需要高速连续采集比如做压力波形分析、动态压力监测采样率要求上千赫兹。SPI 是全双工、无地址开销配合 DMA 可以做到几乎不占 CPU数据吞吐量比 I2C 高一个数量级。我自己的经验是如果只是做静态压力监测I2C 完全够用配置也简单如果要做动态采集或者多通道同步直接上 SPI DMA别犹豫。后面两套配置我都会详细讲。1.3 硬件连接前必须确认的三件事在动手写代码之前先把硬件层面的事情确认清楚能省掉后面一大半的调试时间第一确认电平。WF100DPZ 的 IO 电平是 3.3V如果你的主控是 5V 系统比如某些老款单片机必须做电平转换否则要么读不到数据要么长期运行损坏器件。第二确认上拉电阻。I2C 是开漏输出SCL 和 SDA 必须接上拉电阻才能拉高。WF100DPZ 的 I2C 接口通常需要 4.7kΩ 到 10kΩ 的上拉速率越高阻值越小。这里有个常见误区有些人以为主控内部有上拉就不用外接了但内部上拉通常很弱几十 kΩ在 400kHz 速率下上升沿会严重变缓导致通信失败。第三确认片选和地址。SPI 模式下要接 CS 片选线I2C 模式下要确认从机地址。这两点后面会展开讲。2. I2C 接口配置从时序理解到代码落地2.1 I2C 时序的本质为什么用开漏加外部上拉要配好 I2C得先理解它为什么这么设计。I2C 只有两根线SCL 是时钟SDA 是数据而且都是开漏输出加外部上拉的结构。开漏的意思是器件只能把线拉低不能主动拉高拉高靠的是外部上拉电阻。为什么这么设计因为 I2C 是总线结构可以挂多个器件。如果两个器件同时驱动总线一个想拉高一个想拉低就会短路。开漏结构下任何器件都只能拉低只要有一个拉低总线就是低电平不会出现冲突。这就是所谓的线与逻辑。理解了这一点你就明白为什么上拉电阻这么重要了。上拉电阻和总线电容构成一个 RC 充电回路上升沿的时间常数 τ R × C。如果电阻太大或者总线电容太大上升沿就会变缓在高速率下还没升到高电平阈值下一个时钟沿就来了通信自然失败。我实测过一组数据供参考上拉电阻总线电容上升时间约400kHz 下是否可用10kΩ100pF1μs勉强边沿偏缓4.7kΩ100pF0.47μs可用2.2kΩ100pF0.22μs良好10kΩ400pF4μs不可用所以如果你的 I2C 在低速下能用、高速下就出错第一件事就是减小上拉电阻或者缩短走线降低电容。2.2 WF100DPZ 的 I2C 读写帧格式WF100DPZ 的 I2C 通信遵循标准的寄存器读写模型。一次完整的读操作流程是这样的主机发送起始条件START主机发送从机地址 写位0从机应答ACK主机发送要读取的寄存器地址从机应答ACK主机发送重复起始条件Repeated START主机发送从机地址 读位1从机应答ACK从机发送数据高字节主机应答从机发送数据低字节主机发送非应答NACK主机发送停止条件STOP这个流程里有两个容易出错的地方重复起始条件和最后的非应答。重复起始是为了在不释放总线的情况下切换读写方向很多简化版的 I2C 驱动不支持这个就会导致读操作失败。最后的非应答是告诉从机我读完了如果主机错误地发了应答从机会继续输出下一个字节数据就乱了。用 HAL 库的话读寄存器通常用HAL_I2C_Mem_Read这个函数它内部会自动处理重复起始和最后的 NACK。但如果你用的是软件模拟 I2C就得自己把时序写对。2.3 基于 HAL 库的 I2C 初始化配置以 STM32 为例用 CubeMX 配置 I2C 外设时几个关键参数这样设I2C Speed Mode选 Fast Mode速率设 400kHz。如果走线长或者上拉偏大先降到 100kHz 调通再提速。Clock No Stretch Mode一般关闭允许从机拉低 SCL 做时钟延展。WF100DPZ 在某些转换周期会拉低 SCL如果禁止了时钟延展就会读错。Primary Address Length7 位地址模式。Dual Address关闭。初始化代码大致如下hi2c1.Instance I2C1; hi2c1.Init.ClockSpeed 400000; hi2c1.Init.DutyCycle I2C_DUTYCYCLE_2; hi2c1.Init.OwnAddress1 0; hi2c1.Init.AddressingMode I2C_ADDRESSINGMODE_7BIT; hi2c1.Init.DualAddressMode I2C_DUALADDRESS_DISABLE; hi2c1.Init.GeneralCallMode I2C_GENERALCALL_DISABLE; hi2c1.Init.NoStretchMode I2C_NOSTRETCH_DISABLE;注意DutyCycle这个参数Fast Mode 下可以选 2:1 或 16:9。16:9 能让高低电平时间更均衡在长走线场景下更稳但有些从机对时序敏感2:1 兼容性更好。WF100DPZ 两种都支持我一般先用 2:1。2.4 读取压力数据的完整代码实现假设 WF100DPZ 的压力数据寄存器地址是 0x00高字节和 0x01低字节从机地址是 0x6D左移一位后是 0xDA读取代码如下#define WF100DPZ_ADDR (0x6D 1) #define REG_PRESS_H 0x00 #define REG_PRESS_L 0x01 uint8_t buf[2]; uint16_t raw_pressure; if (HAL_I2C_Mem_Read(hi2c1, WF100DPZ_ADDR, REG_PRESS_H, I2C_MEMADD_SIZE_8BIT, buf, 2, 100) HAL_OK) { raw_pressure (uint16_t)((buf[0] 8) | buf[1]); // 根据规格书换算成实际压力值 float pressure raw_pressure * 0.01f; // 系数以规格书为准 }这里I2C_MEMADD_SIZE_8BIT表示寄存器地址是 8 位。如果 WF100DPZ 用的是 16 位寄存器地址就要改成I2C_MEMADD_SIZE_16BIT这个搞错了会直接读不到数据。2.5 I2C 配置中最容易踩的四个坑坑一从机地址搞错。这是最高频的问题。规格书给的地址可能是 7 位原始值而 HAL 库要求传入的是左移一位后的值。比如规格书写 0x6D你传给 HAL 的应该是 0xDA。我见过太多人在这里卡半天。坑二上拉电阻缺失或过大。前面讲过内部上拉太弱必须外接。如果你用逻辑分析仪看波形发现 SDA 或 SCL 上升沿是缓慢的斜坡而不是陡峭的跳变就是上拉的问题。坑三时钟延展被禁止。WF100DPZ 在内部转换期间会拉低 SCL 告诉主机等一下如果主控配置了 NoStretch就会忽略这个信号读到无效数据。坑四总线死锁。如果通信过程中主控复位而从机还在输出数据SDA 可能被从机一直拉低总线就锁死了。解决办法是在初始化时手动发送 9 个时钟脉冲让从机释放总线。3. SPI 接口配置高速采集的正确打开方式3.1 SPI 四种模式与 WF100DPZ 的匹配SPI 有四种模式由 CPOL时钟极性和 CPHA时钟相位组合而成模式CPOLCPHA采样沿适用说明Mode 000上升沿最常用多数传感器默认Mode 101下降沿部分器件使用Mode 210下降沿较少见Mode 311上升沿部分传感器使用WF100DPZ 的 SPI 模式要以你手上那颗的规格书为准常见的是 Mode 0 或 Mode 3。判断方法很简单先用 Mode 0 试读不到数据就换 Mode 3。如果两个都不行再检查其他配置。我遇到过一颗标称 Mode 0 但实际要 Mode 3 才能读的后来发现是批次差异。3.2 CubeMX 中 SPI 参数的逐项设置用 CubeMX 配置 SPI 时每一项都有讲究Mode选 Full-Duplex Master全双工主机。WF100DPZ 作为从机主机要同时发和收。Data Size8 位。如果传感器是 16 位数据分两次读。CLK Polarity / Phase按上面确定的模式设。NSS选 Software软件片选。硬件片选虽然省事但多从机场景下不灵活而且有些主控的硬件 NSS 时序有 bug。软件片选自己控制 GPIO更可控。Baud Rate Prescaler决定 SPI 时钟。假设主频 72MHz分频 64 得到 1.125MHz分频 32 得到 2.25MHz。先从低速开始调通后再逐步提高。First BitMSB First绝大多数 SPI 器件都是高位先出。配置完生成代码后SPI 初始化部分大致是这样hspi1.Instance SPI1; hspi1.Init.Mode SPI_MODE_MASTER; hspi1.Init.Direction SPI_DIRECTION_2LINES; hspi1.Init.DataSize SPI_DATASIZE_8BIT; hspi1.Init.CLKPolarity SPI_POLARITY_LOW; hspi1.Init.CLKPhase SPI_PHASE_1EDGE; hspi1.Init.NSS SPI_NSS_SOFT; hspi1.Init.BaudRatePrescaler SPI_BAUDRATEPRESCALER_64; hspi1.Init.FirstBit SPI_FIRSTBIT_MSB; hspi1.Init.TIMode SPI_TIMODE_DISABLE; hspi1.Init.CRCCalculation SPI_CRCCALCULATION_DISABLE;3.3 软件片选与硬件片选的取舍标题热词里提到了spi硬件片选与软件片选这里展开说一下。硬件片选是主控的 SPI 外设自动控制 NSS 引脚发送数据时自动拉低发完自动拉高。优点是省 CPU时序精确。缺点是灵活性差多从机时要么用多个 SPI 外设要么用复杂的 NSS 脉冲模式。软件片选是自己用 GPIO 控制片选引脚发送前拉低发送后拉高。优点是灵活想怎么控就怎么控多从机随便挂。缺点是要手动管理忘了拉高就会导致从机一直占用总线。我的建议是单从机、追求极致速度用硬件片选多从机或者需要精细控制时序用软件片选。WF100DPZ 这种场景软件片选完全够用而且调试时更容易用逻辑分析仪观察。软件片选的操作代码#define WF100DPZ_CS_LOW() HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_RESET) #define WF100DPZ_CS_HIGH() HAL_GPIO_WritePin(GPIOA, GPIO_PIN_4, GPIO_PIN_SET) uint8_t tx_buf[3] {0x00, 0x00, 0x00}; // 命令 两个空字节 uint8_t rx_buf[3]; WF100DPZ_CS_LOW(); HAL_SPI_TransmitReceive(hspi1, tx_buf, rx_buf, 3, 100); WF100DPZ_CS_HIGH(); uint16_t raw (uint16_t)((rx_buf[1] 8) | rx_buf[2]);注意这里用了HAL_SPI_TransmitReceive而不是分开的 Transmit 和 Receive因为 SPI 是全双工的发送的同时就在接收分开调用会丢失数据。3.4 SPI DMA 实现连续高速采集如果要做高速连续采集轮询方式就不够了CPU 会被完全占用。这时候要上 DMA。配置 DMA 的步骤在 CubeMX 的 SPI 配置里找到 DMA Settings添加 SPI1_TX 和 SPI1_RX 两个通道。模式选 Normal单次或 Circular循环。连续采集用 Circular。优先级设 High。数据宽度都选 Byte。代码实现#define BUF_SIZE 64 uint8_t spi_tx[BUF_SIZE]; uint8_t spi_rx[BUF_SIZE]; // 启动 DMA 传输 WF100DPZ_CS_LOW(); HAL_SPI_TransmitReceive_DMA(hspi1, spi_tx, spi_rx, BUF_SIZE); // DMA 完成回调 void HAL_SPI_TxRxCpltCallback(SPI_HandleTypeDef *hspi) { if (hspi-Instance SPI1) { WF100DPZ_CS_HIGH(); // 处理 spi_rx 中的数据 process_pressure_data(spi_rx, BUF_SIZE); } }这里有个关键点DMA 传输期间片选必须保持低电平所以 CS 的拉高要放在 DMA 完成回调里不能在启动 DMA 后立刻拉高。我见过有人在这里出错DMA 还没传完就把 CS 拉高了从机直接停止输出数据全是 0。另外如果用的是 Circular 模式CS 就不能在回调里拉高了得用别的方式管理。Circular 模式下 DMA 会一直循环传输适合连续采样的场景但要注意缓冲区会被不断覆盖处理数据要及时。3.5 SPI 通信不生效的排查链路SPI 通信不生效是热词里出现频率很高的问题。我把自己完整的排查流程整理出来你可以照着一步步走第一步看波形。用逻辑分析仪接上 SCLK、MOSI、MISO、CS 四根线发一次数据看波形有没有出来。如果 CS 没动说明片选控制有问题如果 SCLK 没动说明 SPI 外设没启动如果都有但 MISO 一直是高或一直是低说明从机没响应。第二步确认模式。波形出来了但数据不对先换 SPI 模式试试。Mode 0 和 Mode 3 是最常见的来回切一下。第三步降速。把 SPI 时钟降到最低比如 100kHz 以下如果低速能通高速不通就是时序或走线问题。第四步查片选时序。用逻辑分析仪看 CS 拉低到第一个时钟沿之间有没有足够的建立时间。有些从机要求 CS 拉低后至少等几百纳秒才能开始时钟。如果主控发得太快从机还没准备好第一个字节就丢了。第五步查数据顺序。MSB First 还是 LSB First 搞反了数据会完全错乱。这个在配置里改一下就行。第六步查电源和地。听起来很基础但我真的遇到过因为地线没接好导致 SPI 时好时坏的情况。确保主控和传感器共地电源稳定。4. 两套接口的实测对比与选型建议4.1 速度、资源占用、稳定性三维对比我把 WF100DPZ 在两种接口下的实测表现整理成表格对比维度I2C400kHzSPI2MHzSPI DMA2MHz单次读取耗时约 200μs约 20μs约 20μsCPU 占用近 0最大采样率约 2kHz约 20kHz约 20kHzCPU 占用中等较高极低引脚数244多器件扩展容易需要多片选需要多片选抗干扰能力较强差分逻辑一般单端一般配置复杂度低中高从表里能看出来I2C 胜在简单和扩展性SPI 胜在速度和 CPU 占用。如果你的采样率需求在 1kHz 以下I2C 完全够用没必要上 SPI 折腾。如果要做 10kHz 以上的动态采集SPI DMA 是唯一选择。4.2 什么情况下必须用 SPI有三种情况我建议直接上 SPI不要犹豫第一种采样率要求高。比如做压力脉动分析、冲击检测需要几千赫兹以上的采样率I2C 的 400kHz 带宽根本不够。第二种系统里 I2C 总线已经很拥挤。如果总线上挂了五六个器件每个都要通信I2C 的带宽会被瓜分WF100DPZ 的读取周期会被拉长。这时候单独给它一条 SPI 通道更合理。第三种需要和采集同步。SPI 的时序更确定配合 DMA 和定时器触发可以做到精确的等间隔采样这对做频谱分析很重要。I2C 因为时钟延展的存在采样间隔会有抖动。4.3 混合使用时的注意事项有些项目里 I2C 和 SPI 都要用比如 WF100DPZ 用 SPI 高速采集同时用 I2C 读其他慢速传感器。这种混合场景要注意引脚复用冲突。STM32 的 SPI 和 I2C 可能共用某些引脚配置时要查数据手册的复用表别冲突了。中断优先级。SPI 的 DMA 中断和 I2C 中断如果优先级设置不当可能互相打断导致数据错乱。一般把高速的 SPI DMA 中断设高优先级。电源去耦。两个接口同时工作时电流波动更大传感器的电源引脚旁边要加 100nF 和 10μF 的电容做去耦。5. 常见错误排查实战从现象到根因5.1 读出的压力值恒定不变或为 0这是最常见的问题。现象是代码能跑通不报错但读出来的值一直是同一个数或者 0。排查思路先确认通信是否真的成功。在读取函数里加打印看 HAL 函数的返回值是不是 HAL_OK。如果返回 HAL_ERROR 或 HAL_TIMEOUT说明通信层面就有问题回到接口配置去查。如果返回 HAL_OK 但数据不变那可能是读错了寄存器地址或者传感器没有触发新的转换。WF100DPZ 有些型号需要先写一个命令寄存器启动转换然后等一段时间再读结果。如果你直接读数据寄存器读到的可能是上次的旧值或者初始值。这个要仔细看规格书的寄存器说明。5.2 数据偶尔跳变或出现异常大值数据大部分正常但偶尔跳一下通常是时序或者干扰问题。如果是 I2C检查上拉电阻和走线看波形上升沿是否干净。如果是 SPI检查 CS 的时序看有没有在传输过程中被意外拉高。另外电源纹波也会导致数据跳变用示波器看一下传感器供电是否干净。还有一种可能是数据拼接错误。比如 16 位数据分两次读中间被中断打断读到了两次不同转换周期的数据。解决办法是读的时候关中断或者用传感器的连续读取模式一次性读完。5.3 逻辑分析仪抓不到任何波形如果逻辑分析仪接上去什么都看不到先别怀疑代码检查这几项逻辑分析仪的通道有没有接对引脚采样率够不够至少是被测信号频率的 5 倍以上触发条件设对没有比如设成 CS 下降沿触发探头地线有没有接好我遇到过逻辑分析仪地线没接导致波形全是噪声的情况折腾了半天才发现是硬件连接问题。5.4 通信一段时间后死机或数据停止更新这种跑一会儿就挂的问题最难查。常见原因有三个第一总线死锁。I2C 场景下如果主控在从机输出数据时复位SDA 可能被从机拉死。解决办法是加总线恢复机制检测到 SDA 一直为低就发时钟脉冲解锁。第二DMA 缓冲区溢出。SPI DMA 场景下如果数据处理速度跟不上采集速度缓冲区会被覆盖。要确保处理时间小于采集周期或者用双缓冲。第三看门狗复位。如果某个操作耗时太长触发了看门狗系统会不断复位。检查一下有没有阻塞式的等待改成超时机制。6. 几个能省下大量调试时间的实操技巧6.1 先用低速调通再提速这是我最想强调的一点。很多人一上来就把 I2C 设成 400kHz、SPI 设成 10MHz结果通信失败然后开始怀疑代码。正确的做法是先把速率降到最低I2C 用 100kHzSPI 用 100kHz 以下确认能正常读写数据了再逐步提高速率每次提高后验证一遍。这样一旦出问题你就知道是速率相关的时序问题排查范围大大缩小。6.2 用寄存器级操作验证硬件在写复杂驱动之前先用最简单的寄存器操作验证硬件连接是否正确。比如 I2C 就发一个地址看有没有 ACKSPI 就发一个字节看 MISO 有没有响应。这一步能快速区分是硬件问题还是软件问题。6.3 给关键时序留足余量WF100DPZ 的规格书里会给出各种时序参数的最小值和最大值比如 CS 建立时间、数据保持时间等。实际配置时不要贴着最小值来要留 20% 到 50% 的余量。因为规格书给的是理想条件下的值实际电路有走线延迟、器件离散性贴着极限值很容易在批量生产时出问题。6.4 做好错误计数和日志在产品代码里给通信错误加计数器记录超时、校验失败等事件的次数。调试阶段可以打印出来量产阶段可以通过这些计数判断传感器是否工作正常。这个习惯帮我提前发现过好几次偶发性的通信问题。6.5 保留一个已知good的配置备份调通一套配置后把 CubeMX 的配置文件、初始化代码、读取函数都备份一份。后面换项目或者改配置改出问题了可以快速回退到已知可用的版本。我自己的做法是每个项目建一个known_good文件夹专门存调通的版本。WF100DPZ 这颗传感器本身不算复杂但接口配置的细节很多任何一个环节没注意到都可能导致通信失败。我的经验是把硬件连接、时序理解、代码实现这三块都吃透再配合逻辑分析仪实际看波形基本就没有调不通的。真正花时间的往往不是写代码而是搞清楚为什么要这么配。希望这篇整理能帮你少走一些我当年走过的弯路。
