企业官网建设流程全解析

做振动监测和状态维护（CBM）的朋友，应该都听过IIS3DWB这颗传感器。我最近在手头一个设备预测性维护项目里，把IIS3DWB10IS这颗高带宽加速度计接到了STM32C5上，用SPI接口读震动数据，整个过程踩了不少坑，也总结了一套还算顺手的流程。这篇就完整记录一下：从为什么选SPI、硬件怎么接，到寄存器配置、数据换算，再到我实际遇到的各种诡异问题，一次性讲清楚。

IIS3DWB10IS最大的特点就是带宽能到6kHz，远超普通MEMS加速度计。这种传感器在工业振动监测里是刚需，比如电机轴承磨损、风机叶片不平衡、泵组气蚀，故障特征频率往往在几百Hz到几千Hz之间，普通加速度计1kHz出头的带宽根本抓不到。而IIS3DWB的6kHz带宽加上26.7kHz的ODR（输出数据速率），配合STM32C5的SPI高速读取，做边缘侧振动采集节点非常合适。

这篇文章适合刚拿到IIS3DWB准备调通SPI的嵌入式工程师，也适合正在评估振动监测方案的硬件选型人员。我会把关键代码和寄存器配置都贴出来，基本可以照着抄。

1. 项目拆解：为什么是IIS3DWB、SPI和STM32C5

很多人在选型阶段就卡住了，因为传感器、通信接口、MCU这三者必须匹配。我从实际需求倒推，说说我这个组合是怎么定下来的。

1.1 IIS3DWB10IS 到底是个什么传感器

IIS3DWB10IS本质上是ST的IIS3DWB高带宽三轴加速度计，量程固定在±2g，内置16位ADC，支持SPI和I2C两种接口。它的核心竞争力在频率响应：平坦带宽从DC一直到6kHz。这个参数在MEMS加速度计里相当能打，因为传统MEMS器件的谐振频率通常在几kHz到十几kHz，可用带宽往往只有几百Hz到1.5kHz，测高频振动信号会明显衰减。

我实际对比过普通加速度计和IIS3DWB在同一个电机轴承测点的频谱，普通传感器在2kHz以上基本就是一条平线，而IIS3DWB能清晰看到轴承外圈故障的倍频峰。这就是带宽带来的本质区别。当然，代价是IIS3DWB的量程只有±2g，如果用在冲击能量特别大的场合，可能需要评估是否过载。这算是一个选型上的典型矛盾：宽带宽和大量程很难兼得。

1.2 SPI 而不是 I2C：带宽是硬约束

I2C和SPI都是嵌入式里最常见的串行接口，但在这里几乎没有悬念，必须上SPI。IIS3DWB在高带宽模式下ODR是26.7kHz，也就是每秒钟要输出26700个样本。每个样本是X、Y、Z三个轴的6字节数据，加上寄存器开销，I2C的400kHz快速模式算下来每秒钟最多传输约50KB，看起来够用，但I2C协议本身有地址、应答、起始停止位等大量额外开销，而且总线还要被其他从机分时占用，实际吞吐率会打不少折扣。

SPI就简单直接得多，全双工、无地址、无应答，时钟能跑到10MHz，一秒钟理论上能搬1.25MB数据，传输6字节样本完全不是问题。如果后续还想接多个传感器或者跟外设共用总线，SPI的时序也更可控。我在这篇文章里默认用的就是STM32C5的SPI主模式，从机当然是IIS3DWB10IS。

1.3 STM32C5 的定位与选型理由

STM32C5是ST近两年主推的Cortex-M33内核系列，主频最高能到250MHz，带FPU和DSP扩展指令，定位是超低功耗加高性能的平衡点。对于振动监测这种需要长时间运行的边缘节点，C5的功耗表现很关键——它能在低功耗模式下保持SPI外设接收，有数据再唤醒M33核心处理，这个特性非常适合电池供电的无线传感器节点。

另外一个实际感受是STM32C5的SPI外设做了增强，FIFO深度和DMA配合更平滑，读高速传感器时不容易丢数据。我选了STM32C5配上IIS3DWB，其实就是在找“能长时间跑、算得动、接口跟得上”的最小系统组合。

2. 硬件准备与接线（保姆级）

硬件部分看起来简单，但很多SPI通信问题其实出在物理连接上。我把物料清单、接线图和上电前检查事项都列出来，照着做能省掉一大半排查时间。

2.1 物料清单

除了STM32C5开发板和IIS3DWB10IS传感器模块，下面这些也是必备的：

• 杜邦线或排针焊接线若干，建议用不同颜色区分SCK、MISO、MOSI、CS
• 100nF去耦电容，放在传感器电源引脚旁边，越小越靠近越好
• 逻辑分析仪（强烈建议），调SPI时序必备，哪怕是最便宜的24MHz采样版本
• 万用表，检查通断和电平

有个容易被忽略的点：IIS3DWB10IS的开发板或者模块上如果自带了电平转换芯片，要注意转换方向是否支持3.3V系统。如果直接买ST官方的适配板，一般会处理好了；如果是自己画板子，CS、SCK、MOSI这些输入引脚直接接3.3V逻辑没问题。

2.2 SPI 引脚连接与注意事项

IIS3DWB的SPI接口是4线：CS（片选）、SCK（时钟）、SDI（主出从入，对应MOSI）、SDO（主入从出，对应MISO）。它不支持标准的4线SPI多字节带命令头那种方式，而是ST自己的寄存器读写协议，这个后面讲代码时再详细展开。

以STM32C5的SPI1为例，我习惯的接法是：

接线时有三个容易踩的坑。第一个，SCK和MISO、MOSI尽量不要飞线太长，杜邦线超过10cm在10MHz时钟下就容易出现信号反射，实测降到2~4MHz就很稳。第二个，CS必须要由GPIO软件控制，不要图省事直接接GND，因为IIS3DWB没有像普通Flash那样可以纯硬件片选的“只读模式”，它的写操作需要CS配合高低电平完成特定时序。第三个，传感器模块的SDO引脚如果没有上拉电阻，在空闲状态下可能悬空，导致STM32的MISO读到随机电平，建议在SDO上加一个10kΩ上拉。

2.3 上电前检查清单

上电之前花两分钟检查这几项，能避免很多“看起来像代码问题”的硬件坑：

• 用万用表确认传感器VDD和GND之间是3.3V，不要是5V
• 确认CS、SCK、MOSI、MISO四条线没有和电源短路
• 如果模块上有焊接跳线，先确认SPI模式还是I2C模式（很多ST适配板用电阻跳线选择），必须跳成SPI模式
• 万用表量一下MISO线在传感器上电后有没有电平，一般应该被拉高到VDD

我上当过的经历是模块默认I2C模式，结果SPI咋调都不通，最后翻原理图才发现跳线电阻焊错了。

3. CubeMX 配置与 SPI 通信打通

软件第一步是初始化SPI。我这里用的是STM32CubeMX生成工程加HAL库的方式，虽然是老生常谈，但几个参数必须说清楚，尤其是时钟极性（CPOL）和时钟相位（CPHA）。

3.1 SPI 参数配置（时钟、极性和相位）

IIS3DWB数据手册里对SPI模式的要求是支持CPOL=0、CPHA=0（Mode 0）或CPOL=1、CPHA=1（Mode 3）。我实际测试过两种都能正常通信，但绝大多数人的习惯是Mode 0，CubeMX里默认也是Mode 0，我就保持Mode 0。

时钟频率方面，IIS3DWB的SPI最高支持10MHz，刚开始调通阶段我建议先用1MHz，通信稳定后再逐步提高。原因很简单：高速率下的时序余量小，一旦有毛刺或走线干扰，表现是间歇性的数据错位，很难排查。先用低速把功能跑通，再把频率拉上去，这个顺序能节约大量时间。

CubeMX里SPI1的典型配置如下：

• Mode：Full-Duplex Master
• Hardware NSS Signal：Disable（用软件GPIO控制CS）
• Data Size：8 bit，First Bit：MSB First
• Prescaler：按APB2时钟换算到1MHz左右（比如APB2=100MHz时选128分频）
• CPOL=Low，CPHA=1 Edge

有个细节：CPHA那一项CubeMX里显示的是“1 Edge”还是“2 Edge”，对应的是数据采样沿。Mode 0对应的是“1 Edge”（第一个时钟沿采样），这个别选反了，选反了会导致WHO_AM_I读出来的值完全不对。

3.2 从机选择（CS）怎么处理

因为CS是软件控制的GPIO，所以在HAL里把硬件NSS关掉，然后在代码里自己管理电平。控制时序上要注意：IIS3DWB要求在每次传输开始前CS拉低，传输结束后拉高。多字节连续读的时候，可以一直保持CS为低，直到读完所有字节再拉高，这样传感器内部的地址会自动递增（前提是CTRL3的IF_INC位被置1）。

写一个通用的CS操作宏：

#define IIS3DWB_CS_LOW() HAL_GPIO_WritePin(CS_GPIO_Port, CS_Pin, GPIO_PIN_RESET) #define IIS3DWB_CS_HIGH() HAL_GPIO_WritePin(CS_GPIO_Port, CS_Pin, GPIO_PIN_SET)

这里有个经验教训：CS操作之后，要加一小段延时或者至少等几个NOP，尤其在高频下。虽然STM32的GPIO翻转速度很快，但传感器内部逻辑需要一点点时间响应CS下降沿。实测在10MHz SPI下不加延时偶尔会读到上一帧的残留数据，加了几个_nop()之后就稳定了。

3.3 最基本的 SPI 读写函数

IIS3DWB的寄存器读写规则是：第一个字节是寄存器地址，bit7为1表示读、为0表示写。读操作时，主设备发送地址字节后，传感器在下一个字节开始从SDO把数据推出来；写操作则是主设备紧接着发送要写入的数据。

有了这个规律，读写函数就很好写了。我这里用了HAL_SPI_TransmitReceive这样比较通用的接口：

uint8_t spi_read_reg(uint8_t reg) { uint8_t tx[2]; uint8_t rx[2] = {0, 0}; uint8_t value = 0; tx[0] = reg | 0x80; // 读标志 tx[1] = 0x00; // 随便写，目的是产生时钟 IIS3DWB_CS_LOW(); HAL_SPI_TransmitReceive(&hspi1, tx, rx, 2, 100); IIS3DWB_CS_HIGH(); value = rx[1]; // 第二个字节才是寄存器内容 return value; } void spi_write_reg(uint8_t reg, uint8_t data) { uint8_t tx[2]; uint8_t rx[2]; tx[0] = reg & 0x7F; // 写标志，bit7为0 tx[1] = data; IIS3DWB_CS_LOW(); HAL_SPI_TransmitReceive(&hspi1, tx, rx, 2, 100); IIS3DWB_CS_HIGH(); }

读多字节时，可以把地址字节发完后保持CS拉低，然后连续接收N个数据字节。这里要特别提醒一点：HAL_SPI_TransmitReceive同时收发，所以读N字节时发送缓冲区里可以填0x00占位，目的只是为MISO提供时钟。

3.4 第一个重要验证：WHO_AM_I

打通SPI之后第一件事就是读WHO_AM_I寄存器（地址0x0F）。IIS3DWB的WHO_AM_I固定值是0x79。这一步能通过，说明物理连接、SPI模式和基本的读写时序全都对了。

uint8_t id = spi_read_reg(0x0F); printf("WHO_AM_I = 0x%02X\n", id); if (id != 0x79) { // 通信有问题，不要继续往下走 }

我调试时习惯在串口助手上打印这个值，如果打印出来是0xFF，优先怀疑MISO没接好或者传感器没上电；如果是0x00，优先怀疑CS或者MOSI；如果是乱码，优先怀疑CPOL/CPHA配置不对。这三个方向基本覆盖了90%的问题。

4. 寄存器配置与数据读取全流程

通信打通之后，真正的震动数据读取就有章可循了。这个章节是全文最核心的部分，我会把寄存器选择、初始化序列、原始数据读取、物理量换算全部串起来。

4.1 关键寄存器一览

IIS3DWB的寄存器不算多，但每个都有讲究。我挑了我实际用到的几个关键寄存器：

这里重点说CTRL3，它的IF_INC位（bit1）决定了多字节读取时地址是否自动递增。这个位必须是1，否则你读6字节数据的时候，传感器会一直返回同一个地址的内容，出来的数据就是一串重复的X轴低字节。很多人在这一步翻车，数据怎么读都不对，其实就是IF_INC没置位。

CTRL1的带宽选择也很关键。IIS3DWB内部有低通滤波器用来做抗混叠，带宽可以选到6kHz或者降到1.5kHz、更低的选项。如果做频谱分析，建议把带宽拉到最大，保留完整的6kHz信号；如果是只关心低频振动，可以用低带宽模式减少高频噪声。具体位域值因为批次型号可能有差异，我建议以ST官方数据手册寄存器表为准，我当时就是对照着手册逐位配置的。

4.2 初始化序列与代码

我的初始化流程是：先软复位，再配置CTRL1/CTRL2/CTRL3/CTRL6，最后回读配置确认。软复位这个动作很容易被忽略，但它能保证传感器从一个确定的状态开始，避免上一次上电的寄存器残留值干扰。

void IIS3DWB_Init(void) { // 1. 软复位，CTRL3地址0x22，bit0置1 spi_write_reg(0x22, 0x01); HAL_Delay(10); // 等待复位完成 // 2. 配置CTRL1，开启高带宽模式，关闭内部低通滤波或按需配置 // 具体值根据数据手册的BW_FILT位域确定 spi_write_reg(0x20, 0x30); // 3. 配置CTRL2，默认关闭高通滤波（振动时一般保留直流分量） spi_write_reg(0x21, 0x00); // 4. 配置CTRL3，开启地址自动递增（IF_INC=1） spi_write_reg(0x22, 0x02); // 5. 配置CTRL6，默认连续测量模式 spi_write_reg(0x25, 0x00); // 6. 回读校验 uint8_t ctrl1 = spi_read_reg(0x20); uint8_t ctrl3 = spi_read_reg(0x22); printf("CTRL1 = 0x%02X, CTRL3 = 0x%02X\n", ctrl1, ctrl3); }

为什么要回读校验？因为SPI写操作如果因为时序问题失败，代码是感知不到的。回读一看就知道寄存器写没写进去。我调试的时候经常发现CTRL3写入0x02后被传感器自动清除，或者根本没写进去，回读机制能第一时间暴露这类问题。

4.3 读取三轴原始数据

初始化完成之后，读取震动数据就非常直接了。最简单的做法是用一个6字节的读取，从OUT_X_L开始连续读，因为CTRL3里开了地址自动递增，一次SPI事务就能把X、Y、Z三个轴的6个字节全部读回来。

typedef struct { int16_t x; int16_t y; int16_t z; } axis_raw_t; axis_raw_t IIS3DWB_ReadRaw(void) { uint8_t tx[7]; uint8_t rx[7] = {0}; axis_raw_t acc = {0}; tx[0] = 0x28 | 0x80; // 从OUT_X_L开始读 tx[1] = 0x00; tx[2] = 0x00; tx[3] = 0x00; tx[4] = 0x00; tx[5] = 0x00; tx[6] = 0x00; IIS3DWB_CS_LOW(); HAL_SPI_TransmitReceive(&hspi1, tx, rx, 7, 100); IIS3DWB_CS_HIGH(); acc.x = (int16_t)((rx[2] << 8) | rx[1]); // 高字节在前 acc.y = (int16_t)((rx[4] << 8) | rx[3]); acc.z = (int16_t)((rx[6] << 8) | rx[5]); return acc; }

注意这里地址递增的方向是OUT_X_L -> OUT_X_H -> OUT_Y_L -> OUT_Y_H -> OUT_Z_L -> OUT_Z_H，所以接收缓冲区下标对应关系是这样的：rx[0]是地址字节的接收值（不用管），rx[1]是X低，rx[2]是X高，以此类推。合成int16_t时，必须高字节左移8位再与低字节做或运算，顺序搞反了数据会和实际方向完全对不上。

4.4 原始值换算成物理量

拿到原始值之后，下一步是换算成实际加速度。IIS3DWB的量程是±2g，16位ADC的输出范围就是-32768到+32767，对应-2g到+2g。所以每LSB对应的加速度是：

2g×2/65536 ≈ 0.061mg/LSB

换算公式：

• 加速度(mg) = raw × 0.061
• 加速度(m/s²) = raw × 0.061 × 9.80665 / 1000 ≈ raw × 0.000598

代码实现：

typedef struct { float x_mg; float y_mg; float z_mg; } axis_mg_t; axis_mg_t IIS3DWB_ConvertMg(axis_raw_t raw) { axis_mg_t acc; acc.x_mg = (float)raw.x * 0.061f; acc.y_mg = (float)raw.y * 0.061f; acc.z_mg = (float)raw.z * 0.061f; return acc; }

很多人会问为什么不用2g除以32768而要用4g除以65536，其实是一个意思，量程范围是-2g到+2g，总跨度就是4g，填满65536个码值，所以0.061这个系数是这么来的。注意这里是mg/LSB，如果直接算g值，系数就是0.000061g/LSB。

在振动监测里，工程师通常更关心频谱幅值，单位是g或者m/s²。做FFT之前建议把这些原始值直接转成float数组再做窗函数处理，避免整型运算带来的截断误差。

4.5 用数据就绪位提高效率

读取方式上有个优化：不要无脑循环读，而是先查STATUS_REG的DRDY位（数据就绪标志），确认传感器已经更新完新数据再去读。否则可能读到半更新状态的中间值，出现前后两次样本相同或者偶发跳变的现象。

while ((spi_read_reg(0x1E) & 0x01) == 0) { // 等待数据就绪 } axis_raw_t acc = IIS3DWB_ReadRaw();

在26.7kHz的ODR下，数据更新的间隔大约是37.5µs，查询方式在STM32C5这种250MHz主频的MCU上完全跑得过来。如果还想再省CPU，可以把DRDY引脚接到MCU的外部中断上，数据就绪时触发中断，在中断里启动DMA读取。这种方式适合要把数据持续写入SD卡或者通过无线模块上传的场景。

5. 踩坑实录：SPI 读震动计数据的典型问题

最后一章，我把实际调试中遇到过的问题和排查思路整理成实录。这些问题的坑看起来五花八门，但根源大多集中在时序、电气连接和寄存器配置三个方面。

5.1 WHO_AM_I 读出来全 0xFF

这是我从零开始调SPI时遇到最多的现象。0xFF意味着MISO线上一直是高电平，传感器没有把数据拉低过。排查顺序是这样的：

先用万用表量MISO在传感器上电后是不是有电压，如果没电压，大概率是模块供电问题。接着确认模块是不是真的处于SPI模式，很多模块默认I2C模式，MISO引脚被拉死在高电平。最后看SPI速率，如果CubeMX里配到了10MHz，飞线状态下容易出现时序错乱，先降到1MHz试一下。

我实际定位到的问题竟然是模块SPI模式跳线没有焊接，传感器始终工作在I2C模式，SPI自然读不到任何有效数据。

5.2 数据一直是 0 或者固定值

WHO_AM_I能读对，但数据寄存器读出来全是0或者固定一个数，这种情况通常指向两个地方。第一个是IF_INC没置位，连续读取6字节时地址不递增，数据永远是同一个轴的同一个字节，拼出来的int16_t自然不对。第二个是读取时序的字节错位，地址字节发送后，第一个数据字节其实是上一个地址的残留值，必须丢弃第一个或前两个字节。

我建议在代码里加一个打印，把读回来的原始字节数组完整打出来看一眼，是不是“X低、X高、Y低、Y高”这样规律排列的。肉眼一看就知道字节错位还是地址不递增。

5.3 高频振动数据“毛刺”严重

SPI通信都正常，数据也能读出来，但做FFT时高频段毛刺一片，这往往不是通信问题，而是信号链路问题。

IIS3DWB的带宽能到6kHz，意味着传感器的输出噪声在整个频带内都会被采集进来。如果传感器模块的电源纹波大，或者PCB布局时VDD去耦电容离传感器太远，这些噪声会被MEMS敏感结构拾取。另外，传感器应该尽量刚性安装在被测物体表面，如果用了软胶垫或者双面胶，高频振动传到传感器时已经衰减和共振了，读回来的数据自然失真。

我试过用强力磁座固定和用双面胶固定的对比，同样转速下双面胶的频谱在2kHz以上明显出现额外的谐振峰。做设备故障诊断时，安装方式的影响不能忽略。

5.4 提高数据吞吐量的几个思路

如果后续要做连续采样，主循环逐字节读的方式效率偏低。我最后是用DMA加定时器触发的方式：定时器按照目标采样率触发DMA搬运，SPI的数据直接存到内存缓冲区，CPU只在缓冲区满时做一次FFT或者存储。这样既能保证采样间隔均匀，又不会因为CPU执行其他任务而丢样本。

// 伪代码示意：定时器触发DMA搬运 HAL_TIM_Base_Start(&htim2); HAL_DMA_Start(&hdma_spi1_rx, (uint32_t)&hspi1.Instance->DR, (uint32_t)acc_buffer, 6 * N);

这种方式下，IIS3DWB的DRDY引脚可以作为定时器门控，或者直接用固定定时器频率去采。如果做阶次跟踪之类的变转速分析，还要结合转速计信号来同步采样，那属于更高阶的玩法了。

5.5 常见问题速查表

最后再分享一个小技巧

我个人在实际操作中的一个体会是：IIS3DWB这颗传感器功能非常直接，真正的功夫在数据怎么用上。同样的原始数据，时域波形看着都差不多，一旦转到频域，细节差异就出来了。建议大家在把SPI读通之后，用串口把数据送上位机，直接用Python的matplotlib或者SciPy做一遍FFT，看到轴承故障特征频率那一刻，才会真正理解这颗6kHz带宽传感器的价值。

如果你是刚开始接触这个组合，不要一上来就追求10MHz的SPI时钟，先用1MHz把数据链跑通，再逐步提速。这个从慢到快的过程，比任何调试技巧都省时间。后续还可以在这个基础上扩展：比如接入TFT屏做实时频谱显示，或者用无线模块把数据传到上位机做远程诊断，玩法很多，但地基就是SPI这套通信链路。希望这篇能帮各位少走点弯路。