Modulino Vibro 使用教程

产品特点​

  • 振动触觉反馈:板载振动电机,可用于设备状态提醒和交互反馈。
  • 振动强度调节:支持 PWM 控制,按程序调整振动输出强度。
  • 振动电机:采用 VZ43FM1B8230001L,额定转速为 12000 rpm。
  • 可编程振动时序:通过程序控制振动启停和持续时间,组合不同的振动提示。
  • I2C 数字控制:板载 STM32C011 接收主控命令,配合 MOSFET 驱动电机。
  • 双 Qwiic 接口:通过 3.3 V Qwiic 连接主控及其他 Modulino 节点。
  • Arduino 库支持:支持 Arduino_Modulino 库,提供振动控制示例。

产品参数​

项目参数
主控STM32C011F4
电机VZ43FM1B8230001L
驱动2N7002KT1G N 沟道 MOSFET
电机额定转速12000 rpm,实际振感随安装与控制条件变化
电流MCU 约 3.4 mA;电机典型 67 mA、最大 85 mA
供电与接口3.3 V,Qwiic / I2C
工作温度−40°C 至 85°C
板体尺寸41 × 25.36 mm
板厚1.6 ± 0.2 mm
安装孔4 个,直径 3.2 mm,孔距 32 × 16 mm

参数依据:Modulino Vibro 数据手册。电流数值为对应器件或工作条件下的规格,电源预算还需计入主控、其他节点和线缆压降。

产品尺寸​



硬件接口

引脚定义​


Qwiic 与可焊 I2C 焊盘提供 GND、3.3 V、SDA、SCL,连接同一总线。断电后接线,主控需提供匹配的 3.3 V 电源和信号电平,不能直接接 5 V。

1×8 扩展接口含 GND、3V3、RESET、SWCLK、SWDIO、TX1、RX1 及电机相关信号。手册表格将 PA2 标为电机控制,而注释写 PA0,二者不一致;正常使用按 I2C 官方库控制,不提供直接操作该 GPIO 的接线。

I2C 地址​

官方资料对默认地址给出两种值,且未说明各自的适用版本:

  • 新版《Getting Started with Modulino》地址表:7 位地址 0x38,支持软件改址。
  • Vibro 数据手册(ABX00130):0x3A 与硬件地址 0x1D。0x1D 左移一位即 0x3A,两者是同一地址的 7 位与 8 位(含读写位)写法。

因此不要把任一数值直接填进 Wire 的地址参数。首次使用先扫描总线确认实际地址,再按扫描结果或官方库的自动探测访问模块。

地址来源:Modulino 官方地址参考。改址时只连接待配置模块,选择未占用地址,使用官方 AddressChanger 工具后重新上电并扫描确认。

总线与供电​

Qwiic 连接器共享电源,增加节点时需核对总负载及主控 3.3 V 输出能力。电源指示灯亮不代表 I2C 初始化或负载驱动已正常。

手册注明 I2C 上拉默认未安装,提供可选 0402 焊盘,建议值为 4.7 kΩ。先核对主控及其他节点已有上拉,不要为每个模块盲目重复加装。


快速开始

准备工作​

准备模块、Qwiic 线、匹配 3.3 V I2C 的主控和 Arduino IDE。安装主控实际型号的支持包,不把 Modulino 当作应用程序上传目标。

安装与示例​

  1. 主控断电,连接模块 Qwiic 接口。
  2. 检查供电能力及所用 I2C 总线,再连接 USB。
  3. 在库管理器安装官方 Arduino_Modulino 库(0.10.0,由 Arduino 官方服务器分发,不需要访问 GitHub)。
  4. 打开库内 Modulino Vibro 对应示例,核对示例使用的接口和参数。
  5. 选择主控型号、端口,编译上传。
  6. 观察负载输出并按示例调整参数,确认启停或图案变化。

先运行短时低强度振动,再停止输出。预期电机按程序启停,改变强度或时长后振动表现变化。固定模块,避免电机和线缆被结构夹住;出现复位或通信中断时检查供电负载。

官方类名为 ModulinoVibro。强度与持续时间的参数范围以安装版本示例为准,不将 PWM 参数直接解释为电机转速。

参考:Arduino_Modulino 官方库说明。


振动控制说明

强度与节奏​

PWM 调整用于改变振动表现,不是闭环转速或振幅标定。先用短时脉冲确认触觉效果,再组合提醒节奏。安装材料、固定方式和接触位置都会改变体感,不能只按额定 rpm 比较效果。

供电检查​

电机工作电流高于 MCU 静态电流。主控电源和 Qwiic 线需覆盖启动及运行负载,多个 Vibro 同时动作时还需累加。不要将外部电机接到模块信号焊盘,也不要直接从主控 GPIO 驱动电机。


相关资料

1. 技术手册​

2. 软件工具​

3. 其他资料​


技术支持

周一-周五(9:30-6:30)周六(9:30-5:30)

手机:13434470212

邮箱:services04@spotpear.cn

QQ:202004841