EC11 旋转编码器 STM32F103 接线与代码 实测通过

转动旋钮时，内部两个触点 A、B 一前一后地通断，形成一组「正交信号」。STM32 靠 A、B 谁先谁后判断方向，靠转到定位点才计一格，再显示到 OLED 和串口。按键 SW 是常开型，按下接通。

三个术语：

• 卡点（detent）：转一下「咔哒」一下的那个位置，一格就是一个卡点。
• 正交（quadrature）：A、B 两根信号错开四分之一周期，靠先后顺序判断方向。
• 定位态：旋钮停下时 A、B 同为高或同为低的状态，卡点计数就靠它。

和电位器怎么选：

编码器和 OLED 分开接，一共 9 根线。

编码器：

OLED：

最容易接错的三处（必须单独强调）：

1. OLED 的 I2C 用的是重映射引脚 PB8/PB9，不是默认的 PB7/PB6。 代码里要先 Wire.setSDA(PB9)、Wire.setSCL(PB8) 再 Wire.begin()，接错就读不到屏幕。
2. 按键不要接 PB2。 PB2 在 STM32F103 上兼作 BOOT1，接东西可能影响启动，所以本项目 SW 改接 PA0。
3. 必须共地。 编码器、OLED、STM32 的 GND 要接在一起，否则信号对不上。
4. PA13 / PA14 留给 ST-Link 调试，不要占用。

1. 把 I2C 指到 PB8 / PB9。 STM32duino 默认 I2C 是 PB7/PB6，必须手动指到重映射引脚，并升到 400 kHz 缩短整屏刷新时间。

Wire.setSDA(PB9);
Wire.setSCL(PB8);
Wire.begin();
Wire.setClock(400000);   // 400kHz

2. 编码器走中断，不在主循环轮询。 A、B 任一引脚跳变就进中断，OLED 刷屏占了几十毫秒也不会漏掉旋钮跳变——这是解决「快转漏计」的关键。

attachInterrupt(ENCODER_A_PIN, encoderISR, CHANGE);
attachInterrupt(ENCODER_B_PIN, encoderISR, CHANGE);

3. 只挑「到达定位态」计一次。 中断里读 A/B 拼成状态，只在到达定位态（A==B）的跳变上计数，并用 2 ms 去抖。转一个卡点正好 ±1。

switch (transition) {
  case 0b0100:  // 01 -> 00  顺时针
  case 0b1011:  // 10 -> 11  顺时针
    if (now - g_lastCountMs < 2UL) break;
    g_state.count += 1;
    g_state.direction = Direction::CW;
    break;
  case 0b1000:  // 10 -> 00  逆时针
  case 0b0111:  // 01 -> 11  逆时针
    if (now - g_lastCountMs < 2UL) break;
    g_state.count -= 1;
    g_state.direction = Direction::CCW;
    break;
}

4. 中断里写、主循环里读的字段全部标 volatile，否则编译器优化后主循环可能一直读到旧值。

5. 按键消抖用轮询 + 20 ms 稳定判定，机械按键抖动期内不改状态。

OLED 完全不亮 / 串口打印 SSD1306 allocation failed → 十有八九是 I2C 引脚或地址。确认 SDA 接 PB9、SCL 接 PB8（不是默认的 PB7/PB6），代码里 setSDA/setSCL 必须在 Wire.begin() 之前调用。OLED 地址常见 0x3C，少数是 0x3D。

转一格 COUNT 跳 2 下或 4 下 → 计数写法不对。用了「每个相位沿都计数」，一个卡点里有 4 次电平变化。改成只在到达定位态（A==B）的跳变上计数。

慢转正常，快速甩旋钮会少计几格 → 编码器在主循环里轮询，被 OLED 刷屏阻塞了。改用 attachInterrupt(..., CHANGE) 把 A/B 都挂中断。

方向反了，顺时针在减 → A、B 两根线对调，或者代码里把 CW/CCW 两组 case 对调。本项目已验证：顺时针 = CW = 加。

按键按下没反应 / 一按就乱跳 → 先确认 SW 接的是 PA0 不是 PB2（PB2 兼作 BOOT1）。乱跳是没消抖，本项目用 20 ms 稳定判定。

串口看不到数据 → 先查当前串口：pio device list，找 CP2102 / CP210x / CH340 对应的那个 COM。需要看串口时在自己电脑的 platformio.ini 里加 monitor_port = COMx 和 monitor_speed = 115200，COMx 换成自己电脑实际识别到的端口，不要照抄我们截图里的 COM 号。正常用 ST-Link 烧录不需要加这两行。

• 接线、代码、实测结果、编译烧录记录：本项目实测，2026-08-16 实机测试
• EC11 正交输出、卡点数、方向判断、按键类型、模块上拉：资料参考，来自公开资料与常规工程实践，由我们重新整理表述
• 具体卡点数、引脚顺序：待确认，以手上模块实际批次和丝印为准
• SKU：待补充