用 NUCLEO-H533RE 的 Arduino 接口驱动 LIS3DH:从「接线」到「读出三轴」的一次折腾
本次要做的很简单,主要就是能够驱动:把 Grove 平台上的那块 LIS3DH 三轴加速度计,插到 NUCLEO-H533RE 的 Arduino 接口上,走 I2C,读出 XYZ 三个轴,通过串口进行打印。听起来是十分钟的活,实际做下来花了一晚上。
一、任务拆解
在动手之前,先把这一晚上要实现的内容列清楚:
确认 NUCLEO-H533RE Arduino 接口的 SCL/SDA 是哪两个脚能对应到 STM32 的具体引脚号与复用外设
确认 Grove 板的逻辑电平与供电域3.3 V 直连,不烧板、不加电平转换
扫描 I²C 总线,拿到 LIS3DH 的实际地址扫到 0x18 或 0x194读 WHO_AM_I,确认通信真的通了返回 0x335配置量程与ODR,读出三轴原始值翻转板子,数值跟着变并输出串口能看到
二、硬件介绍
主控:NUCLEO-H533RE
H533 是 ST 中端线上的 Cortex-M33,250 MHz,带 FPU 和 TrustZone,512 KB Flash / 272 KB SRAM。这块板子我手头熟,前面做步进电机控制也用的它,所以这次继续沿用。
这块板子最大的好处是引脚是 Arduino UNO 排布的,同时板载 ST-LINK 兼 VCP 串口。也就是说:传感器插 Arduino 接口,串口打印走 USB 里那个虚拟串口,一根线全搞定,不用再外挂 USB-TTL。
传感器:Grove 三轴数字加速度计(LIS3DHTR)
LIS3DH 是 ST 的经典款:低功耗、12 位高分辨率、支持 I²C / SPI,还能测温度。Grove 板把它做成了标准 Grove 四线接口(VCC / GND / SDA / SCL)。
把它的关键指标先摆出来,后面调参全靠它:
参数取值说明I²C 地址0x18 或 0x19取决于 SA0 脚;
Grove 板固定一种WHO_AM_I (0x0F)0x33通信自检的「握手暗号」
量程 FS±2 / ±4 / ±8 / ±16 g,ODR 位分辨率高分辨率 12 bit
HR 模式灵敏度±2 g 时 1 mg/LSB换量程按比例变
三、Arduino 接口上的 SCL / SDA 到底是哪两个脚
这一步是本文最想强调的地方,选对引脚连对线很关键:

NUCLEO-64 的 Arduino 接口里,I²C 对应的是 D14(SDA)/ D15(SCL),位置在 CN10 排针上,不是从头开始的。这两个引脚内部接的是 STM32 的一个 I²C 外设(H533 上对应 I2C1 的复用通道),所以在 CubeMX 里要做两件事:
1.在 Pinout 里找到 PB6 /PB7(H533 上 D14/D15 的位置),手动把它们设成 I2C1_SDA / I2C1_SCL;
2.确认这两个脚没有被 CubeMX 默认分配成别的功能。我这块板上它们默认「空闲」,但一旦你启用了某个外设,占用关系会立刻变,所以务必要再检查一遍。
最终引脚分配表:

还需要我们进一步配置I2C,默认参数就行:

这里还有一个细节:Grove 板上的 SDA/SCL 已经自带 10 kΩ 上拉,NUCLEO 的板载 I²C 是没有上拉的正好。另外,H533 和 Grove 都是 3.3 V 逻辑,不存在电平转换问题,直接插就行,不要接 5 V。
四、软件
我们这次主要就是传感器的驱动,LIS3DHTR 的 7 位地址有两个,取决于 SA0 引脚接高还是接低:
SA0 引脚7 位地址传给 HAL 的值接低电平0x180x30接高电平0x190x32
不同厂商的模块焊接方式不一致,与其去查文档猜,不如两个都试一遍。驱动里的探测逻辑就是这样写的:
const uint8_t probe[2] = { LIS3_I2C_ADDR_SA0_HIGH, LIS3_I2C_ADDR_SA0_LOW };
dev->addr = 0U;
for (uint32_t i = 0U; i < 2U; ++i)
{
dev->addr = probe[i];
st = LIS3_ReadID(dev, &whoami);
if (st == LIS3_OK && whoami == LIS3_WHO_AM_I_VAL)
{
break; /* 找到了,记下实际地址 */
}
dev->addr = 0U;
}
if (dev->addr == 0U)
{
return LIS3_ERR_ID; /* 两个都不应答 */
}这段代码的价值在于把"模块焊接差异"从问题降级为细节:主程序不需要知道你的模块 SA0 是怎么接的,驱动自己会找到,并把结果存进 dev->addr。主程序初始化成功后打印出来的 I2C address detected = 0x19,就是这个探测的结果。
SUB 字节里的地址自增位。 LIS3DHTR 的寄存器地址是放在 I2C 的 SUB 字节里传的,它的低 7 位是寄存器地址,最高位是"地址自增"标志。单字节读时置 0,多字节突发读时必须置 1,否则器件会一直重复返回同一个寄存器——你会看到 X 轴数据正常,但 Y、Z 轴全是 X 轴的值。
驱动里的处理方式非常干净:
/* SUB = reg when len == 1 单字节读,不自增 * SUB = reg | 0x80 when len > 1 多字节读,打开地址自增 */ uint8_t sub = (uint8_t)(reg | ((len > 1U) ? 0x80U : 0x00U));
于是读三轴数据的地址是 0x28 | 0x80 = 0xA8,器件收到后会自己把地址递增,依次吐出 OUT_X_L, OUT_X_H, OUT_Y_L, OUT_Y_H, OUT_Z_L, OUT_Z_H 六个字节。一次 I2C 事务拿到全部六轴数据,比读六次单字节快得多,也避免了中间被其他主机打断造成的数据错位。
主要的驱动是在通过arduino的官方库进行的转化。
主循环本身很短,但每一行都有讲究:
while (1)
{
int16_t ax = 0, ay = 0, az = 0;
int32_t x_mg = 0, y_mg = 0, z_mg = 0;
if (LIS3_ReadAccel(&lis3dev, &ax, &ay, &az) == LIS3_OK)
{
(void)LIS3_ReadAccelMG(&lis3dev, &x_mg, &y_mg, &z_mg);
(void)COM_Printf(" raw: X=%5d Y=%5d Z=%5d | mg: X=%6d Y=%6d Z=%6d\r\n",
(int)ax, (int)ay, (int)az,
(int)x_mg, (int)y_mg, (int)z_mg);
}
else
{
(void)COM_Printf(" [LIS3] I2C read error\r\n");
}
BSP_LED_Toggle(LED_GREEN); /* 心跳指示 */
HAL_Delay(LIS3_PRINT_PERIOD_MS); /* 200 ms 节拍 */
}要点一:报告周期和采样率是两回事。 传感器以 400 Hz 转换(每 2.5 ms 一个新样本),但我们每 200 ms 才读一次、打印一次。这叫抽样读取。当前版本用旁路模式,读到的永远是最新一次转换结果,中间 79 个样本被丢掉了。对"看看板子怎么动"这个目的完全够用;如果后面要做频谱分析或者动作识别,200 ms 一次远远不够,必须改用 FIFO 批量取样——这是第二阶段的事。
要点二:读失败不退出循环。 I2C 偶发失败(干扰、接触不良)不应该让整个应用挂掉,所以这里打印错误后继续下一轮。连续失败时你会看到刷屏的 [LIS3] I2C read error,这本身就是很好的故障指示。
要点三:为什么不用 SysTick 定时中断? 用 HAL_Delay() 阻塞式延时,代码简单、无需考虑重入和共享资源。缺点是主循环里没法同时干别的事(不能中断式地做别的处理)。对于"定时采样并打印"这个应用,阻塞完全够用;等你加上 AI 推理、需要精确控制采样时刻时,再换成 TIM 定时中断。
要点四:LED 当心跳。 每 200 ms 翻转一次,视觉上是 2.5 Hz 的呼吸灯。好处是即使你不看串口,也能一眼判断出程序还活着——串口静默时,灯还闪,就说明问题在串口或传感器;灯不闪,说明程序本身挂了。
五、实测结果

我们对三轴数据进行了打印,可以看到中途的时候我们板子立了起来,这个时候就可以看到对应的X轴的数据变化挺大。
我要赚赏金
