| 项目 | 参数 |
|---|---|
| 蜂鸣器型号 | 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 固件重刷流程。


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

| 接口 | 信号 | 用途 |
|---|---|---|
| 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。
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。为主控安装实际型号对应的支持包,不把模块当作程序上传目标。
官方对象为 ModulinoBuzzer,参数范围和具体调用以安装版本示例为准。模块固件将 I2C 命令转换为蜂鸣器驱动,不直接在主控任意引脚调用 tone 来代替模块通信。
教程来源:Modulino Buzzer 官方入门。
预期蜂鸣器按程序发声并停止。修改音调后声音高度应变化,修改时长后提示持续时间应变化。先保持安静环境并确保发声开口无遮挡,不将耳朵贴近蜂鸣器测试。
| 现象 | 检查方法 |
|---|---|
| 扫描不到模块 | 检查 3.3 V、总线、SDA/SCL 和 7 位地址 |
| 有通信但无声音 | 检查示例初始化、频率、时长和停止逻辑 |
| 声音与预期不同 | 核对频率单位、节奏间隔和安装遮挡 |
| 多模块通信异常 | 检查地址唯一性、上拉和总负载 |
频率决定音调,持续时间和间隔决定节奏。器件典型频率为 4 kHz,不代表所有频率下声压相同,也不表示只有 4 kHz 可用。选择频率范围和参数单位时以官方库示例为准。
提示音从短音开始,依次验证发声、静音和间隔,再组合旋律。不要把发声强弱当作经校准的声压测量结果。
蜂鸣器开口、外壳声腔和固定方式会影响声音。保持发声面无遮挡,避免线缆或壳体压住器件。不同安装结构下的听感不能只用相同程序参数直接比较。
可根据按钮、距离或其他传感器触发提示音。设置触发间隔和停止条件,避免循环中不断重启同一个声音命令,使节奏无法按预期完成。
同一总线上的节点需地址唯一。增加模块时核对上拉、线长和供电,不因为每个节点都带 Qwiic 就忽略总线限制。
官方提供 MicroPython 指南。按主控固件安装对应 Modulino 支持库,核对 I2C 引脚和地址表示,不直接照搬 Arduino C++ 的对象与函数。
参考:Modulino Buzzer MicroPython 指南。