快速开始
准备与连接
准备模块、Qwiic 线、具备 3.3 V I2C 接口的主控、USB 数据线和 Arduino IDE。主控没有 Qwiic 时，按引脚表连接 3.3 V、GND、SDA、SCL；5 V 逻辑需匹配的电平转换。
- 主控断电后连接模块，确认公共 GND。
- 为 Arduino IDE 安装主控实际型号的支持包。
- 在库管理器安装或更新官方 Arduino_Modulino 库。
- 打开库中对应模块的示例。
- 选择主控型号与端口，编译并上传到主控。
- 按示例波特率打开串口监视器，检查输出。
示例验证
单块 Knob 保留官方示例中的 ModulinoKnob knob;，由库自动识别 0x3A / 0x3B。需要手动填写地址时，按 I2C 地址选择 扫描确认，不填写 0x76。
打开 Knob 示例。官方类为 ModulinoKnob，get() 读取计数，isPressed() 读取按压状态，set() 设置计数参考值。先缓慢向两个方向旋转，观察计数分别增减；再按下并松开，确认按压状态变化。
计数变化的正负与安装观察方向有关，不把正值直接定义为所有安装方式下的顺时针。按压状态是当前状态，业务逻辑需区分持续按住与一次按下。
故障检查
| 现象 | 检查方法 |
|---|---|
| 扫描不到设备 | 核对 3.3 V、GND、总线选择和 SDA/SCL |
| 初始化失败 | 更新官方库，核对地址、硬件版本和地址冲突 |
| 加入多个模块后异常 | 检查地址唯一性、电源余量、线长和总线上拉 |
| 串口无输出 | 核对主控端口、波特率和示例是否运行 |