声音控制说明
音调与时长
频率决定音调，持续时间和间隔决定节奏。器件典型频率为 4 kHz，不代表所有频率下声压相同，也不表示只有 4 kHz 可用。选择频率范围和参数单位时以官方库示例为准。
提示音从短音开始，依次验证发声、静音和间隔，再组合旋律。不要把发声强弱当作经校准的声压测量结果。
安装与效果
蜂鸣器开口、外壳声腔和固定方式会影响声音。保持发声面无遮挡，避免线缆或壳体压住器件。不同安装结构下的听感不能只用相同程序参数直接比较。
与传感器联动
可根据按钮、距离或其他传感器触发提示音。设置触发间隔和停止条件，避免循环中不断重启同一个声音命令，使节奏无法按预期完成。
同一总线上的节点需地址唯一。增加模块时核对上拉、线长和供电，不因为每个节点都带 Qwiic 就忽略总线限制。
MicroPython
官方提供 MicroPython 指南。按主控固件安装对应 Modulino 支持库，核对 I2C 引脚和地址表示，不直接照搬 Arduino C++ 的对象与函数。