硬件接口
引脚定义
| 接口 | 信号 | 用途 |
|---|---|---|
| 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 驱动同一信号，也不随意短接调试焊盘。