Modulino Buzzer 使用教程

产品特点​

  • 压电发声:板载压电蜂鸣器,可制作提示音、提醒节奏和简单旋律。
  • I2C 控制:主控通过 I2C 发送音调命令,由模块 MCU 驱动蜂鸣器。
  • Qwiic 连接:使用 3.3 V Qwiic 接口连接主控与其他节点。
  • 官方库支持:可从 Arduino_Modulino 库打开 Buzzer 示例。

产品参数​

项目参数
蜂鸣器型号PKLCS1212E4001-R1
蜂鸣器类型压电式蜂鸣器
主控数据手册正文为 STM32C011F4
工作电压3.3 V
通信接口I2C
连接接口2 个 Qwiic 接口及可焊接引脚孔
典型工作电流发声时约 6.4 mA(手册值)
默认 I2C 地址(7 位)0x1E,可软件配置
Modulino / 固件 pinstrap 值0x3C,对应 7 位地址 0x1E
典型频率4 kHz
声压级最小 75 dB,典型 85 dB
板体尺寸41 × 25.36 mm
板厚1.6 ± 0.2 mm
安装孔4 个,直径 3.2 mm,孔距 32 × 16 mm

依据:Modulino Buzzer 数据手册 和 Modulino Buzzer 官方教程。官方资料中 MCU 后缀有 F4 与 F6 的不同写法,不能据此将示例扩展为特定 MCU 固件重刷流程。

产品展示​

Modulino Buzzer 与 Qwiic 线缆

产品尺寸​

Modulino Buzzer 机械尺寸

安装时预留蜂鸣器开口与连接器空间,避免遮挡发声面或挤压元件。


硬件接口

引脚定义​

Modulino Buzzer 引脚定义

接口信号用途
Qwiic 与 I2C 焊盘GND、3.3 V、SDA、SCL供电与主控 I2C 通信
1×8 扩展焊盘GND、3V3、RESET、SWCLK、SWDIO、TX1、RX1、PA0调试、复位及蜂鸣器相关信号

Qwiic 和 I2C 焊盘连接同一总线,不是两路独立接口。按 3.3 V 电源及逻辑接线,不直接接 5 V。断电连接并确认公共 GND,不能将蜂鸣器模块当作两线有源蜂鸣器接到主控 GPIO。

I2C 地址​

Buzzer 的默认 7 位 I2C 地址为 0x1E。素材和官方教程中的 0x3C 是 Modulino / 固件 pinstrap 表示;官方库按 0x3C / 2 = 0x1E 转换为实际通信地址。这是同一模块的两种表示方式,不是任选两个地址。

使用位置应使用的值
Arduino Wire 或 I2C 扫描结果0x1E
官方库显式指定地址ModulinoBuzzer buzzer(0x1E);
官方库自动识别ModulinoBuzzer buzzer;
官方资料的 Modulino / pinstrap 栏0x3C

不要在 Wire 中直接填入 0x3C。若模块曾经改址,以实际扫描结果为准。

依据:Arduino_Modulino 官方地址工具源码(GitHub)。示例通过 Arduino IDE 库管理器安装的官方库打开。

支持使用官方 AddressChanger 工具软件改址。修改时只连接目标模块,选择未占用地址,重新上电后扫描确认。参考:Modulino 地址说明。

上拉与扩展信号​

手册说明 I2C 上拉默认未安装,预留 0402 焊盘,建议值 4.7 kΩ。先检查主控和其他节点已有上拉,避免重复并联。

PA0 可用于高级直接驱动,SWD 用于固件改写。正常入门使用 I2C 库,不同时让外部输出与模块 MCU 驱动同一信号,也不随意短接调试焊盘。


快速开始

准备工作​

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

官方库验证​

  1. 主控断电,将模块接入 Qwiic。
  2. 核对电源和所用总线,再连接 USB。
  3. 在库管理器安装官方 Arduino_Modulino 库。
  4. 打开库中的 Buzzer 示例,核对频率、时长和停止控制。
  5. 选择主控型号和端口,编译上传。
  6. 先运行短时提示音,再验证停止和不同音调。

官方对象为 ModulinoBuzzer,参数范围和具体调用以安装版本示例为准。模块固件将 I2C 命令转换为蜂鸣器驱动,不直接在主控任意引脚调用 tone 来代替模块通信。

教程来源:Modulino Buzzer 官方入门。

结果检查​

预期蜂鸣器按程序发声并停止。修改音调后声音高度应变化,修改时长后提示持续时间应变化。先保持安静环境并确保发声开口无遮挡,不将耳朵贴近蜂鸣器测试。

现象检查方法
扫描不到模块检查 3.3 V、总线、SDA/SCL 和 7 位地址
有通信但无声音检查示例初始化、频率、时长和停止逻辑
声音与预期不同核对频率单位、节奏间隔和安装遮挡
多模块通信异常检查地址唯一性、上拉和总负载


声音控制说明

音调与时长​

频率决定音调,持续时间和间隔决定节奏。器件典型频率为 4 kHz,不代表所有频率下声压相同,也不表示只有 4 kHz 可用。选择频率范围和参数单位时以官方库示例为准。

提示音从短音开始,依次验证发声、静音和间隔,再组合旋律。不要把发声强弱当作经校准的声压测量结果。

安装与效果​

蜂鸣器开口、外壳声腔和固定方式会影响声音。保持发声面无遮挡,避免线缆或壳体压住器件。不同安装结构下的听感不能只用相同程序参数直接比较。

与传感器联动​

可根据按钮、距离或其他传感器触发提示音。设置触发间隔和停止条件,避免循环中不断重启同一个声音命令,使节奏无法按预期完成。

同一总线上的节点需地址唯一。增加模块时核对上拉、线长和供电,不因为每个节点都带 Qwiic 就忽略总线限制。

MicroPython​

官方提供 MicroPython 指南。按主控固件安装对应 Modulino 支持库,核对 I2C 引脚和地址表示,不直接照搬 Arduino C++ 的对象与函数。

参考:Modulino Buzzer MicroPython 指南。


相关资料

1. 技术手册​

2. 软件工具​

3. 其他资料​