在模拟器外设领域，方向盘、飞行摇杆、赛车踏板已相当成熟，但针对马术骑乘动作的专业输入设备却长期缺席。OpenRidingController 项目填补了这一空白，它通过 DIY 方式构建了一套基于红外反射传感器的动作捕捉系统，将骑乘者的身体姿态实时转换为 PC 游戏可识别的 HID 输入信号。
硬件架构：低成本传感阵列
该控制器的核心采用 RP2040 Zero 微控制器，这款板载双核 ARM Cortex-M0+ 的模组具备 USB 1.1 原生支持，足以承载 HID 复合设备的协议开销。动作检测层由 4 颗 TCRT5000 红外反射传感器构成，每颗传感器输出模拟电压信号，通过 ADC 采集后映射为离散动作状态。
TCRT5000 的选型体现了工程权衡：其有效检测距离约 1-3mm，适合检测踏板的下压深度或身体部位的靠近 / 远离动作。相比 IMU 方案，红外传感器无需复杂的姿态解算，响应延迟更低（典型值 <5ms），且不受磁场干扰。传感器阵列通过分压电阻网络连接至 RP2040 的 ADC0-ADC3 引脚，采样率设置为 1kHz 以捕捉快速动作变化。
机械结构采用 3D 打印件与标准钢管组合，M3 螺丝固定传感器模块，确保重复拆装后的定位精度。这种模块化设计允许用户根据体型调整传感器间距，适配不同身高的骑乘者。
USB HID 描述符与复合设备实现
项目使用 CircuitPython 10 进行固件开发，核心依赖 Adafruit CircuitPython HID Library。该库抽象了 USB HID Report Descriptor 的底层细节，使开发者可通过高层 API 定义设备功能。
OpenRidingController 实现了三重 HID 设备复合：Keyboard、Mouse 和 DirectInput Gamepad。这种设计允许单个 USB 接口同时输出多种输入类型，适配不同游戏的输入需求。例如，在支持 DirectInput 的骑乘模拟游戏中使用摇杆轴输入，而在通用游戏中退化为键盘 WASD 映射。
HID Report Descriptor 的关键配置如下：
- Keyboard：标准 8 字节报告（1 字节修饰键 + 6 字节按键码），轮询间隔 8ms
- Mouse：3 字节报告（X/Y 位移 + 按钮状态），轮询间隔 4ms
- Gamepad：8 字节报告（4 轴 16bit 模拟量 + 16 按钮位图），轮询间隔 10ms
复合设备在 USB 枚举阶段通过 Interface Association Descriptor 声明多个独立接口，操作系统将其识别为三个独立设备，互不影响。
动作到输入的映射策略
传感器原始数据需经过校准层和映射层才能转化为游戏动作。校准阶段记录每个传感器的静态基准值（骑乘者就位但未动作时的 ADC 读数），动态阈值设置为基准值的 ±20% 以消除漂移误差。
动作识别采用简单的状态机模型：
- 前倾：前侧传感器读数 > 阈值 → 映射为 "W" 键或 Gamepad 左摇杆 Y+ 轴
- 后仰：后侧传感器读数 > 阈值 → 映射为 "S" 键或左摇杆 Y- 轴
- 左倾 / 右倾：对应侧传感器触发 → 映射为 "A"/"D" 键或 X 轴偏移
- 踢踏动作：底部传感器触发 → 映射为空格键（跳跃）或鼠标左键
为消除抖动，状态切换引入 50ms 的消抖延时，避免传感器噪声导致的误触发。对于需要模拟量输入的场景（如控制马匹速度），采用线性插值将传感器读数映射到 0-255 的轴值范围。
工程实践要点与限制
USB Composite 限制：项目文档明确指出，该控制器无法通过 "键盘转游戏主机" 适配器（如 Brook、Mayflash 等）在主机平台使用。原因在于这类适配器通常只解析 USB HID 报告中的第一个接口（通常是键盘），忽略后续的鼠标和游戏 pad 接口。若需跨平台兼容，建议固件层面提供单设备模式切换功能，通过物理开关或启动时按键组合选择仅枚举键盘、鼠标或游戏 pad 之一。
校准清单：
- 上电后保持静止 3 秒，自动记录基准值
- 依次执行前倾、后仰、左倾、右倾，验证各方向触发阈值
- 测试踢踏动作响应，调整底部传感器灵敏度
- 运行 5 分钟连续测试，检查热漂移（TCRT5000 LED 温漂约 0.2%/℃）
可复用设计模式：该项目的架构可迁移至其他体感控制场景。只需替换传感器类型（如用霍尔传感器检测旋转、用压力传感器检测踩踏），保持相同的 HID 描述符结构和映射层接口，即可快速构建新的体感控制器。
总结
OpenRidingController 展示了如何用低成本硬件和 CircuitPython 快速验证体感输入原型。其核心价值在于提供了一套可复制的 HID 复合设备实现范式，以及传感器数据到游戏输入的完整处理链路。对于希望构建自定义游戏外设的开发者，该项目提供了从电路设计、3D 建模到固件开发的完整参考。
资料来源
- OpenRidingController GitHub 仓库：https://github.com/squalius-cephalus/OpenRidingController
- Adafruit CircuitPython HID Library 文档
内容声明：本文无广告投放、无付费植入。
如有事实性问题，欢迎发送勘误至 i@hotdrydog.com。