最近在折腾工业状态监测的小样机核心是一颗ST新出的STM32C5系列单片机外挂一片IIS3DWB三轴加速度计用SPI总线把高频振动数据读回来。IIS3DWB这枚传感器有点意思带宽能到6kHz输出数据率最高26.7kHz做轴承和齿轮箱的振动诊断基本够用STM32C5则是Cortex-M33内核跑到250MHz主打低功耗加硬件安全。这篇文章是系列第一篇只讲最基础也最关键的一步SPI通信怎么打通数据怎么读出来。这篇内容适合两类人看。一类是做设备状态监测、预测性维护的嵌入式工程师想快速把IIS3DWB这类超宽带宽传感器接到MCU上另一类是最近在评估STM32C5新品、纠结它和G4怎么选的开发者。我会把方案选型、寄存器和时序、CubeMX配置、HAL库代码、常见坑全部过一遍尽量让你看完就能照着操作。1. 方案选型C5、IIS3DWB和SPI这三个关键词怎么凑到一块先说结论这套组合不是随手攒的是围绕高频振动采集这个需求倒推出来的。传感器、主控、通信接口三者之间是互相匹配的关系任何一个换成别的整体方案都要重新评估。1.1 IIS3DWB为什么会出现在振动监测方案里IIS3DWB是ST推出的一颗超宽带宽三轴加速度计它和普通加速度计最大的区别就是带宽和输出数据率。普通消费级传感器通常带宽只有几百Hz做倾角、做手环计步没问题但抓不到轴承故障早期的高频振动特征。旋转机械的故障频率往往能到几kHz要有效分析这些信号传感器本身的带宽必须足够。IIS3DWB的带宽能到6kHz输出数据率最高26.7kHz两者配合起来能覆盖很大一部分工业振动诊断场景。打个比方普通加速度计像一部30帧的摄像机抓慢动作都费劲IIS3DWB相当于高速摄影机能把短暂冲击、瞬态振动记录下来。内置的抗混叠滤波也省掉了外部RC低通电路板子布线上少一摊麻烦。它的量程可以配置为±2g、±4g、±8g、±16g接口同时支持I2C和SPI。噪声密度做得很低这对看微弱振动信号很关键。整体功耗也不高供电范围1.71V到3.6V和主流MCU的IO电平能直接对接不需要额外电平转换。1.2 STM32C5与G4只论SPI读取其实差别不大很多人会拿STM32C5和STM32G4比因为两个系列发布节奏接近名字也都是C开头。我在选型时做了个对比核心差异其实不在SPI这类常规外设上。维度STM32C5STM32G4内核Cortex-M33带TrustZoneCortex-M4主频最高250MHz最高170MHz运行功耗约60μA/MHz级别相对更高一些安全特性TrustZone、SAES、PKA、RNG、HASH常规不带TrustZone优势场景工业IoT节点、状态监测、安全启动需求数字电源、电机控制、模拟外设丰富如果只是把IIS3DWB的数据读回来G4完全够用但整套工业节点还要考虑联网通信、固件防篡改、低功耗待机的话C5的优势就出来了。Cortex-M33内核在保证算力的同时有TrustZone做安全隔离硬件加密引擎也省了CPU的加解密开销。说句实在话现在C5的样片和开发板确实还不太好买第三方板卡生态也没完全铺开。我的建议是拿不到C5就先拿G4验证SPI通信逻辑因为HAL库的API风格基本一致等C5板子到位后移植成本很低主要改时钟树和引脚复用驱动代码基本能原样搬过去。1.3 采集高频振动为什么要走SPI而不是I2CIIS3DWB的I2C速率上限远低于SPI。高频振动场景下数据量大26.7kHz输出率、三轴每样本6字节算下来约160KB/s的数据流。I2C标准模式400kHz理论上勉强够但总线还要承载寄存器配置、状态查询等开销实际余量很小。SPI则可以跑到10MHz同样时间能传的数据量是I2C的十几倍。另外IIS3DWB的SPI接口读数据时支持多字节连续读取一次CS拉低就能把X、Y、Z轴6个字节全部读回来中间不需要反复切换地址和方向。这种连续读特性特别适合后续用DMA搬运数据对CPU的打扰降到最低。从时序上讲SPI没有I2C那种地址应答、ACK/NACK机制调试时用逻辑分析仪看数据要直观得多。对于工程开发越直观越容易排查问题。2. 读懂IIS3DWB的SPI时序和寄存器再动手在写代码之前先把几个关键协议约定搞清楚。IIS3DWB的SPI通信不复杂但有一个细节特别容易被坑字节序和地址格式。2.1 SPI读写的关键约定地址格式与字节序ST的MEMS传感器SPI协议延续了同一套风格。每个寄存器地址是7位传输时用一个字节表示高7位是寄存器地址最低位是读写标志。写寄存器发送字节 寄存器地址左移1位或上0即(reg 1) | 0x00读寄存器发送字节 寄存器地址左移1位或上1即(reg 1) | 0x01IIS3DWB支持SPI Mode 0或Mode 3配置成CPOL0、CPHA0最省心数据在时钟上升沿采样空闲时钟为低电平。CPOL1、CPHA1也可以但没必要自找麻烦。SPI时钟最高10MHz实际板子上跑5MHz以内比较稳线长、干扰都可能让高速传输出错工程上要留余量。数据字节在连续读取时按寄存器地址递增顺序输出。比如从0x28开始连续读6字节得到的是OUTX_L_XL、OUTX_H_XL、OUTY_L_XL、OUTY_H_XL、OUTZ_L_XL、OUTZ_H_XL。注意低字节地址在前拼合数据时要用高字节左移8位再或低字节写成(buf[1] 8) | buf[0]。这个顺序搞反后面的数据处理全乱。2.2 必须要认识的几个寄存器IIS3DWB寄存器表不长但有几个是绕不开的寄存器地址作用WHO_AM_I0x0F芯片标识读回固定值用于验证SPI链路CTRL1_XL0x20输出数据率ODR和量程FS配置CTRL3_XL0x22SPI接口配置、重启、地址自动递增等STATUS_REG0x1E数据就绪标志bit0为XLDAOUTX_L_XL ~ OUTZ_H_XL0x28~0x2D三轴加速度原始数据首次上电后第一步就是读WHO_AM_I把读回的值打印出来和官方数据手册里的默认值做比对。如果读出来是稳定的一个数且不是0xFF、0x00SPI链路基本就通了。很多人的第一笔代码就是卡在这一步。CTRL1_XL用来配ODR和量程。IIS3DWB默认工作在最高输出数据率如果你想降低采样率省电就在这个寄存器里改ODR位。量程位也要对着数据手册的寄存器映射表来操作不同型号ST传感器的位定义有差异直接抄别的芯片代码容易翻车。CTRL3_XL里有IF_ADD_INC位置1后支持连续多字节读我的例程是依赖这个功能读六字节数据的。2.3 数据换算从原始码到振动加速度传感器输出的原始数据是16位有符号整数不是浮点。换算成物理量需要乘灵敏度系数而灵敏度又和量程档位有关。以±16g量程为例典型灵敏度约0.488mg/LSB±2g量程约0.061mg/LSB整体对应关系如下量程灵敏度(mg/LSB)±2g0.061±4g0.122±8g0.244±16g0.488换算步骤就是两步先由原始码乘灵敏度得到毫g再除以1000得到g值如果要转成振动分析常用的mm/s²再乘9.80665。注意mg和g差了1000倍这个小数点位置非常容易写错。我的习惯是统一在代码里用float处理灵敏度系数写成0.488f单位单独注释清楚避免后续接手的同事混淆。3. 硬件接线与CubeMX配置软件协议思路清晰后剩下就是把它落到工程里。先讲硬件连接再讲CubeMX的配置最后给初始化顺序。3.1 引脚分配与软件片选的选择IIS3DWB接口引脚不多VDD、GND、SCLK、SDI对应MCU的MOSI、SDO对应MCU的MISO、CS。如果IIS3DWB模块上有VDD_IO引脚通常和VDD一起接3.3V。注意绝对不能接5V传感器耐压到不了。CS片选这里要专门说一句。STM32C5的SPI有硬件NSS功能但做单从机传感器读取时我更推荐用一个普通GPIO做软件片选。理由很简单硬件NSS在多从机或CS时序要求严格的场景下容易出幺蛾子配置不当会在通信间隙误拉CS软件片选完全由代码控制时序CS的建立时间、保持时间都能自己掌握出问题时逻辑分析仪一看便知道CS拉没拉对我用的是C5的SPI1SCLK选PB3MISO选PB4MOSI选PB5CS用任意空闲GPIO比如PB6CubeMX里先把SPI引脚复用对再把PB6单独配成GPIO_Output。3.2 CubeMX里的SPI参数怎么填打开STM32CubeMX选择SPI1设置为Full-Duplex Master模式。关键参数按下面配置Data Size8 bits。IIS3DWB一个寄存器字节就是8位选别的会乱First BitMSB First。ST传感器协议固定MSB先行Prescaler根据APB时钟算确保SCLK不超过10MHz。C5主频高SPI时钟源可能是几十MHz分频后取2MHz到5MHz之间比较稳CPOLLowCPHA1 Edge即Mode 0NSSDisableCS用软件GPIO控制在这个环节最容易犯的错是Prescaler选太小SPI跑到十几MHz甚至更高。IIS3DWB最高支持10MHz超了不见得立刻报错但信号下降沿变差、误码率上升表现为数据偶尔跳变。宁可慢一点先把链路跑通再提速度。时钟树部分不用特殊处理SPI时钟源默认从APB总线来。如果你想确认实际波特率生成工程后鼠标悬停在SPI1配置上CubeMX会把最终算出的波特率显示出来只要低于10MHz就行。3.3 上电初始化顺序传感器上电后不要立刻狂读寄存器。IIS3DWB上电到稳定需要一点时间我的初始化顺序是这样的电源稳定后延时10ms左右让内部电路起来读WHO_AM_I确认SPI链路和传感器正常按需写CTRL1_XL配置量程和ODR写CTRL3_XL确认开启地址自动递增如果传感器复位过重新配一次读STATUS_REG直到XLDA置1表示新数据就绪正式读取三轴数据初始化期间CS保持高电平避免干扰。每次读数据前再拉低CS读完立即拉高。这个节奏虽然简单但对稳定性影响很大。4. HAL库读取IIS3DWB数据的完整实现下面进入正题。我用STM32C5的HAL库写了一套最基础的读写函数所有工程都可以直接套用。4.1 单字节读写函数SPI单字节读写是最底层的两个封装其他高级函数都建立在它们之上。uint8_t iis3dwb_read_reg(uint8_t reg) { uint8_t addr (reg 1) | 0x01; // 读标志 uint8_t val 0; HAL_GPIO_WritePin(IIS3DWB_CS_GPIO_Port, IIS3DWB_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(hspi1, addr, 1, HAL_MAX_DELAY); HAL_SPI_Receive(hspi1, val, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(IIS3DWB_CS_GPIO_Port, IIS3DWB_CS_Pin, GPIO_PIN_SET); return val; } void iis3dwb_write_reg(uint8_t reg, uint8_t val) { uint8_t addr reg 1; // 写标志为0 HAL_GPIO_WritePin(IIS3DWB_CS_GPIO_Port, IIS3DWB_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(hspi1, addr, 1, HAL_MAX_DELAY); HAL_SPI_Transmit(hspi1, val, 1, HAL_MAX_DELAY); HAL_GPIO_WritePin(IIS3DWB_CS_GPIO_Port, IIS3DWB_CS_Pin, GPIO_PIN_SET); }HAL_MAX_DELAY在调试阶段用没问题后面如果上DMA或者中断必须换成带超时时间的值否则卡死时整个系统没有退出机会。每次读写结束把CS拉高这个动作很重要不要和下一次操作的CS拉低之间留模糊区间。有些MCU的GPIO翻转很快但传感器需要CS高电平至少持续几个ns才算一次完整片选周期代码上保持连续即可。4.2 连续读取三轴数据有了单字节读写连续读三轴就顺手了。我把数据寄存器起始地址0x28作为读地址一次读6字节void iis3dwb_read_xyz(int16_t *ax, int16_t *ay, int16_t *az) { uint8_t buf[6] {0}; uint8_t addr (0x28 1) | 0x01; // 从 OUTX_L_XL 开始连续读 HAL_GPIO_WritePin(IIS3DWB_CS_GPIO_Port, IIS3DWB_CS_Pin, GPIO_PIN_RESET); HAL_SPI_Transmit(hspi1, addr, 1, HAL_MAX_DELAY); HAL_SPI_Receive(hspi1, buf, 6, HAL_MAX_DELAY); HAL_GPIO_WritePin(IIS3DWB_CS_GPIO_Port, IIS3DWB_CS_Pin, GPIO_PIN_SET); *ax (int16_t)((buf[1] 8) | buf[0]); *ay (int16_t)((buf[3] 8) | buf[2]); *az (int16_t)((buf[5] 8) | buf[4]); }主程序里的调用流程长这样uint8_t whoami; whoami iis3dwb_read_reg(0x0F); printf(WHO_AM_I 0x%02X\r\n, whoami); // 配置量程为 ±16g按手册操作 CTRL1_XL(0x20) // 这里只给出读改写思路具体位定义以数据手册为准 // ctrl iis3dwb_read_reg(0x20); // ctrl (ctrl ~FS_MASK) | FS_16G; // iis3dwb_write_reg(0x20, ctrl); if (WHO_AM_I 比对失败) { printf(IIS3DWB not found!\n); Error_Handler(); } int16_t ax, ay, az; float g_x, mm_s2_x; if (iis3dwb_read_reg(0x1E) 0x01) // 数据就绪 { iis3dwb_read_xyz(ax, ay, az); g_x (float)ax * 0.488f / 1000.0f; // ±16g, mg - g mm_s2_x g_x * 9.80665f; // 转 mm/s² printf(X: %d raw, %.4f g, %.2f mm/s2\r\n, ax, g_x, mm_s2_x); }三个字节拼16位数据时我先读的是低字节所以拼出来时要高字节在前。这个细节我反复强调是因为真有人在上面交学费。4.3 从轮询到DMA高采样率下的工程化改造上面这套轮询代码用来验证链路非常好每读一次数据从CS拉低到数据到手全程都是阻塞的。IIS3DWB在最高26.7kHz输出率下每37微秒左右就有一组新数据这种速度让CPU频繁进入SPI收发流程基本干不了别的事。长时间连续采集时我建议改成DMA方式。思路是每次CS拉低后使用SPI的DMA请求把地址字节发出去再触发DMA接收6字节数据完成中断里拉高CS并把数据放入环形缓冲区主循环再从缓冲区取数据做分析。STM32C5的GPDMA在CubeMX里配置很直观数据搬运和主循环可以并行。这个改造并不复杂但对工程结构的影响很大。建议先把轮询版本跑通确认传感器和SPI参数都正确再动DMA。否则一次改两件事出了问题不好定位。4.4 上位机验证串口把数据导出来看波形数据读回来只是第一步还得确认读到的数据是对的。我一般用串口把原始16位数直接打印到电脑接一个串口波形工具看实时曲线。有个更快的办法是如果手头暂时没有C5板子或者想先验证传感器好坏可以用USB转SPI的调试工具配合Python读一遍WHO_AM_I和加速度寄存器。IIS3DWB的SPI速率上限10MHz这类工具通常跑几MHz完全足够。不过工具和MCU的实际时序特性有差异最终还是要用目标MCU再验一遍。看波形的小技巧把传感器平放在桌面上静止X、Y轴读数应该接近0gZ轴应该稳定在1g附近。如果Z轴不是1g多半是量程配置或者换算系数不对。轻敲桌面波形上能看到明显的冲击尖峰说明传感器响应正常。5. 我踩过的坑问题排查与避坑指南读写代码写起来几十行但实际调试时可能卡住你的都是一些小问题。下面把几个高频问题列个速查表。现象可能原因解决办法读WHO_AM_I全是0xFFMOSI/MISO接反或传感器没供电检查接线核对SDI接MCU的MOSI、SDO接MISO读WHO_AM_I全是0x00CS没有被正确拉低或SPI时钟没输出检查CS引脚配置和代码里的GPIO宏数据偶尔跳变SPI速率太高或线太长降Prescaler缩短杜邦线检查信号完整性数据静态不为0或Z轴不对字节序拼错、灵敏度系数不对核对 (buf[1]8)初始化卡死在HAL_MAX_DELAY的收发里SPI没配置好BUSY标志没清重新生成工程确认CubeMX的SPI参数5.1 读WHO_AM_I全是0xFF或0x000xFF和0x00是两个极端场景排查方向完全相反。读回0xFF说明MISO线上收到的全是高电平。最常见原因是MOSI和MISO接反了传感器把从地址字节也输出到了别的线上还有一种可能是传感器没上电MISO被外部上拉电阻拉高。先把供电量一遍VDD引脚对着3.3VGND和MCU共地然后再查接线。读回0x00重点看CS。CS如果一直拉低传感器每次都在响应但总线状态混乱CS如果一直没有被拉低读到的就是默认电平。而且GPIO的初始化顺序要在SPI初始化之后否则CS引脚被复用成NSS功能软件拉低会失效。5.2 数据看起来有规律但拼接后是乱的这是最隐蔽的坑。串口打印原始字节数组比如0x28后跟0x01、0x00看起来好像数据在变但拼出来的值要么乱跳要么正负方向完全不对。我遇到过的情况是把低字节拼在前面了。正确做法是先打印每个字节的值手工按寄存器顺序排一下再写拼接公式。IIS3DWB连续读时先出低字节后出高字节这个顺序不能想当然。拼好后还要测一组已知数据静止时Z轴应该在1g附近如果出现在负半轴大概率字节序反了。5.3 高速采样时CPU被拖死的处理思路把ODR提到最高后轮询读取会让主循环几乎停滞。我实测下来单纯打印三轴数据就能把CPU吃满大半。这时候不要硬扛着轮询两个方向可以同时推进一是把打印频率降下来每采样1000次打印一次平均值或抽一个点CPU占用立减。二是把读取改为DMA搬运数据进环形缓冲主循环想做FFT还是做阈值判断都行。尤其做振动分析时数据处理永远比采集更重要采集链路要设计成尽量不消耗CPU。5.4 逻辑分析仪看时序的实战心得如果条件允许强烈建议把SCLK、CS、MOSI、MISO四根线挂到逻辑分析仪上抓一次读WHO_AM_I的过程。你会直观看到CS拉低、8个CLK发地址字节、再8个CLK收数据、CS拉高的完整波形。对照SPI Mode 0的时序图一眼就能看出CPOL/CPHA配错没有数据踩在哪个边沿也清清楚楚。这个习惯不只在IIS3DWB上适用任何SPI从设备的调试都适用。我个人觉得逻辑分析仪是嵌入式调试的必备工具比示波器更直观排查协议问题时能省下大半天时间。最后说一点我个人的体会。这类高频传感器的第一个坑往往不是算法而是底层数据链路字节序、CS时序、SPI速率任何一个地方不对后面所有滤波和FFT都是白搭。我这次在自己代码里找字节序问题花了小半天把经验写出来就是希望你能一步跨过这个坎。等哪天我把DMA采样和FFT那套也调通了再接着往下写。