| 项目 | 参数 |
|---|---|
| 编码器 | PEC11J-9215F-S0015,带按压开关 |
| 旋转方式 | 360° 连续旋转,增量式输入 |
| 板载 MCU | STM32C011F4 |
| 供电与逻辑 | 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 / RESET | MCU 复位 |
| SWCLK、SWDIO | SWD 调试 |
| TX1、RX1 | UART 扩展信号 |
1×10 焊盘顺序以引脚图为准。正常使用由板载 MCU 采集编码器,不把 PA0、PA1、PA2 与主控输出直接对接。
Knob 的默认 7 位地址可能为 0x3A 或 0x3B,官方库同时支持两者。单个模块使用官方库时,优先保留自动识别,无需预先二选一:
ModulinoKnob knob;
按官方 Knob 示例在初始化时调用 Modulino.begin() 和 knob.begin()。若需要手动指定地址,先只连接一块 Knob,在实际连接的 I2C 总线上扫描,再按结果设置:
| 扫描结果 | 官方库对象声明 | Wire 使用的地址 |
|---|---|---|
| 0x3A | ModulinoKnob knob(0x3A); | 0x3A |
| 0x3B | ModulinoKnob knob(0x3B); | 0x3B |
| 未发现设备 | 先检查供电、SDA/SCL 和所用总线 | 不靠反复替换地址排查接线 |
在 UNO R4 WiFi、Nano R4 等主控上使用 Qwiic 时,注意扫描对应的 Wire1 总线;扫描 Wire 不能代替扫描另一路 I2C。
官方地址工具把 Knob 标识为 Encoder,并列出两组对应关系:
| 固件 pinstrap 标识 | 对应的默认 7 位地址 |
|---|---|
| 0x74 | 0x3A |
| 0x76 | 0x3B |
手册将 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 逻辑需匹配的电平转换。
单块 Knob 保留官方示例中的 ModulinoKnob knob;,由库自动识别 0x3A / 0x3B。需要手动填写地址时,按 I2C 地址选择 扫描确认,不填写 0x76。
打开 Knob 示例。官方类为 ModulinoKnob,get() 读取计数,isPressed() 读取按压状态,set() 设置计数参考值。先缓慢向两个方向旋转,观察计数分别增减;再按下并松开,确认按压状态变化。
计数变化的正负与安装观察方向有关,不把正值直接定义为所有安装方式下的顺时针。按压状态是当前状态,业务逻辑需区分持续按住与一次按下。
| 现象 | 检查方法 |
|---|---|
| 扫描不到设备 | 核对 3.3 V、GND、总线选择和 SDA/SCL |
| 初始化失败 | 更新官方库,核对地址、硬件版本和地址冲突 |
| 加入多个模块后异常 | 检查地址唯一性、电源余量、线长和总线上拉 |
| 串口无输出 | 核对主控端口、波特率和示例是否运行 |
旋钮可连续旋转,没有电位器的机械行程端点。读取值表示累计变化,不能直接当作绝对角度。若需要固定范围的音量或亮度,在应用程序中设置上下限,并决定到边界后是保持还是循环。
先读取旋转变化,更新菜单索引,再读取按压状态确认选择。避免每次循环都把按住状态处理为一次新点击;记录前一次状态,仅在需要的边沿触发操作。
set() 修改软件计数参考,不会让旋钮机械转到指定位置。设备重启后若需恢复业务设置,由主控应用保存该设置,不把编码器当作掉电保存的绝对位置传感器。
先用低速旋转验证方向和按压,再测试实际操作速度。避免长时间阻塞主循环而错过交互时机;界面刷新与旋钮读取可分别调度。出现计数异常时先核对库版本、通信和采样流程,不自行假设每格固定等于多少角度。
按尺寸图预留轴、旋钮帽、按压行程和连接器空间。固定 PCB 时避免螺钉压住元件;不要将超过设计负荷的机械力传递到编码器和焊点。
周一-周五(9:30-6:30)周六(9:30-5:30)
手机:13434470212
邮箱:services04@spotpear.cn
QQ:202004841
