Modulino Knob 使用教程

产品特点​

  • 旋转编码输入:支持顺时针与逆时针连续旋转,可用于数值增减、音量调节和菜单选择。
  • 按压输入:旋钮集成按压开关,可用于菜单确认和模式切换。
  • I2C 通信:板载 MCU 采集旋转与按压状态,主控通过 Qwiic / I2C 读取。
  • 模块组合:可与其他 Modulino 传感器和执行器节点组合使用。
  • 交互应用:可用于智能家居控制、机器人交互、电子仪器参数调节和创客项目。

产品参数​

项目参数
编码器PEC11J-9215F-S0015,带按压开关
旋转方式360° 连续旋转,增量式输入
板载 MCUSTM32C011F4
供电与逻辑3.3 V,Qwiic / I2C
典型工作电流约 3.4 mA
工作温度-40~85°C(手册值)
默认 7 位 I2C 地址0x3A 或 0x3B,以实际扫描结果为准;官方库支持自动识别
板体尺寸41 × 25.36 mm
板厚1.6 ± 0.2 mm
安装孔4 个,直径 3.2 mm,孔距 32 × 16 mm

旋转编码器输出相对步进,不测量上电后的绝对轴角。MCU 的 2.0~3.6 V 供电范围不作为 Qwiic 模块的接线电压。

参数依据:Modulino Knob 数据手册。

产品展示​


产品尺寸​



硬件接口

引脚定义​


接口或信号用途
两个 Qwiic 与 1×4 焊盘GND、3.3 V、SDA、SCL,同一 I2C 总线
PA2按压开关
PA0、PA1编码器 A、B 相
GND、3V3电源与公共地
PF2 / RESETMCU 复位
SWCLK、SWDIOSWD 调试
TX1、RX1UART 扩展信号

1×10 焊盘顺序以引脚图为准。正常使用由板载 MCU 采集编码器,不把 PA0、PA1、PA2 与主控输出直接对接。

I2C 地址选择​

Knob 的默认 7 位地址可能为 0x3A 或 0x3B,官方库同时支持两者。单个模块使用官方库时,优先保留自动识别,无需预先二选一:

ModulinoKnob knob;

按官方 Knob 示例在初始化时调用 Modulino.begin() 和 knob.begin()。若需要手动指定地址,先只连接一块 Knob,在实际连接的 I2C 总线上扫描,再按结果设置:

扫描结果官方库对象声明Wire 使用的地址
0x3AModulinoKnob knob(0x3A);0x3A
0x3BModulinoKnob knob(0x3B);0x3B
未发现设备先检查供电、SDA/SCL 和所用总线不靠反复替换地址排查接线

在 UNO R4 WiFi、Nano R4 等主控上使用 Qwiic 时,注意扫描对应的 Wire1 总线;扫描 Wire 不能代替扫描另一路 I2C。

0x74、0x76 与 7 位地址​

官方地址工具把 Knob 标识为 Encoder,并列出两组对应关系:

固件 pinstrap 标识对应的默认 7 位地址
0x740x3A
0x760x3B

手册将 0x76 和 0x3A 放在同一行,不能据此把两者当作同一个地址。Wire 和 ModulinoKnob 的显式地址参数使用 7 位地址,不直接填入 0x74 或 0x76。

依据:Arduino_Modulino 地址工具源码(GitHub) 与 Arduino_Modulino 设备发现源码(GitHub)。示例通过 Arduino IDE 的官方库打开。

多模块改址​

同一总线上有多个地址冲突的 Knob 时,先只连接一块,在库的 Utilities 中打开 AddressChanger,按 115200 波特率查看设备表的 ADDR 列。输入“当前地址 新地址”,例如 0x3A 0x3C;仅在当前地址确为 0x3A 且 0x3C 未被占用时使用该示例。改址后重新上电并确认扫描结果,再接入其他模块。自定义地址在程序中显式指定,不依赖默认地址自动发现。

上拉与调试​

I2C 上拉默认未安装,手册建议在需要时使用 4.7 kΩ、0402 电阻。先检查主控和其他节点已有上拉,避免重复并联。SWD 固件改写会影响原有功能,入门读取旋钮无需重刷模块。


快速开始

准备与连接​

准备模块、Qwiic 线、具备 3.3 V I2C 接口的主控、USB 数据线和 Arduino IDE。主控没有 Qwiic 时,按引脚表连接 3.3 V、GND、SDA、SCL;5 V 逻辑需匹配的电平转换。

  1. 主控断电后连接模块,确认公共 GND。
  2. 为 Arduino IDE 安装主控实际型号的支持包。
  3. 在库管理器安装或更新官方 Arduino_Modulino 库。
  4. 打开库中对应模块的示例。
  5. 选择主控型号与端口,编译并上传到主控。
  6. 按示例波特率打开串口监视器,检查输出。

示例验证​

单块 Knob 保留官方示例中的 ModulinoKnob knob;,由库自动识别 0x3A / 0x3B。需要手动填写地址时,按 I2C 地址选择 扫描确认,不填写 0x76。

打开 Knob 示例。官方类为 ModulinoKnob,get() 读取计数,isPressed() 读取按压状态,set() 设置计数参考值。先缓慢向两个方向旋转,观察计数分别增减;再按下并松开,确认按压状态变化。

计数变化的正负与安装观察方向有关,不把正值直接定义为所有安装方式下的顺时针。按压状态是当前状态,业务逻辑需区分持续按住与一次按下。

故障检查​

现象检查方法
扫描不到设备核对 3.3 V、GND、总线选择和 SDA/SCL
初始化失败更新官方库,核对地址、硬件版本和地址冲突
加入多个模块后异常检查地址唯一性、电源余量、线长和总线上拉
串口无输出核对主控端口、波特率和示例是否运行


旋钮控制说明

增量与绝对角度​

旋钮可连续旋转,没有电位器的机械行程端点。读取值表示累计变化,不能直接当作绝对角度。若需要固定范围的音量或亮度,在应用程序中设置上下限,并决定到边界后是保持还是循环。

菜单与按键​

先读取旋转变化,更新菜单索引,再读取按压状态确认选择。避免每次循环都把按住状态处理为一次新点击;记录前一次状态,仅在需要的边沿触发操作。

set() 修改软件计数参考,不会让旋钮机械转到指定位置。设备重启后若需恢复业务设置,由主控应用保存该设置,不把编码器当作掉电保存的绝对位置传感器。

读取节奏​

先用低速旋转验证方向和按压,再测试实际操作速度。避免长时间阻塞主循环而错过交互时机;界面刷新与旋钮读取可分别调度。出现计数异常时先核对库版本、通信和采样流程,不自行假设每格固定等于多少角度。

机械安装​

按尺寸图预留轴、旋钮帽、按压行程和连接器空间。固定 PCB 时避免螺钉压住元件;不要将超过设计负荷的机械力传递到编码器和焊点。


相关资料

1. 硬件资料​

2. 技术手册​

3. 软件工具​

4. 其他资料​


技术支持

周一-周五(9:30-6:30)周六(9:30-5:30)

手机:13434470212

邮箱:services04@spotpear.cn

QQ:202004841