OpenFIRE-ESP32固件
OpenFIRE-Firmware-ESP32
ESP32
1/5
已发布
项目简介
A high-performance firmware port of the OpenFIRE lightgun project for the ESP32-S3, adding native wireless connectivity
OpenFIRE-Firmware-ESP32 是一个专为 ESP32-S3 微控制器架构深度优化的开源光枪固件移植项目。该项目源自 TeamOpenFIRE 团队开发的 OpenFIRE 固件，旨在为光枪爱好者提供一套功能丰富、性能卓越的 DIY 解决方案，使其能够在现代平板显示器上畅玩光枪游戏。
标签
项目特点
**原生无线集成**：通过 ESP-NOW 协议实现光枪与专用 Dongle 之间的直接通信，系统将光枪识别为标准 USB 外设，无需第三方驱动或软件，延迟极低。
**增强追踪算法**：引入深度优化的空间计算算法，在近距离下提供出色的光标稳定性，并能在光枪大角度旋转（倾斜）时正确计算追踪。
**双核优化**：充分利用 ESP32-S3 的双核能力，同时管理输入轮询、摄像头处理和外围设备管理，无任何卡顿。
**完整外设支持**：原生支持触觉和力反馈（螺线管和震动马达）、温度监控（TMP36 传感器）以及动态照明（WS2812B NeoPixel LED）。
**灵活输入映射**：提供键盘、5键绝对定位鼠标（ABS）和双摇杆手柄（带 D-pad 支持）等多种输出方式，并支持强大的按键映射系统。
**OLED 视觉反馈**：支持 I2C SSD1306 显示屏，用于菜单导航和游戏内元素（如生命值、弹药）的视觉指示。
**高级兼容性**：完全兼容 PC 力反馈处理器（如 Mame Hooker、The Hook Of The Reaper、QMamehook）和 MiSTer FPGA 生态系统。
**硬件通用性**：除专用 USB 接收器外，所有标准 ESP32-S3 开发板均可互换用于光枪、踏板或 DIY Dongle。
技术规格
| 目标微控制器 | ESP32-S3（参考架构），兼容 RP2040（仅有线模式） |
|---|---|
| 无线协议 | ESP-NOW（点对点低延迟通信） |
| 追踪系统 | 四点红外系统，支持双灯条（推荐）或菱形布局，带实时透视校正 |
| 输入方式 | 键盘、5键绝对定位鼠标（ABS）、双摇杆手柄（带 D-pad） |
| 反馈机制 | 螺线管（Solenoid）、震动马达（Rumble）、WS2812B NeoPixel LED |
| 温度监控 | TMP36 模拟温度传感器 |
| 显示支持 | I2C SSD1306 OLED 显示屏 |
| 配置方式 | 通过 OpenFIRE App（Windows/Linux）进行实时配置 |
| 存储方式 | 校准配置和用户设置保存至光枪内部存储器 |
| 开发环境 | PlatformIO |
| 推荐开发板 | Lightgun: ESP32-S3-DevKitC-1 / Waveshare S3-PICO；Dongle: LILYGO T-Dongle-S3 / Pocket Dongle S3；Pedal: Waveshare ESP32-S3-ZERO |
项目资源
搜索资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| ESP32-S3-DevKitC-1 或 Waveshare S3-PICO | 1 | — | 用于光枪，GPIO 引脚多 |
| LILYGO T-Dongle-S3 或 Pocket Dongle S3 | 1 | — | 用于接收器，USB 直插 |
| Waveshare ESP32-S3-ZERO | 1 | — | 用于无线踏板，超紧凑 |
| 红外检测摄像头 | 1 | — | 用于追踪红外 LED |
| 螺线管（Solenoid） | 1 | — | 力反馈（后坐力模拟） |
| 震动马达（Rumble motor） | 1 | — | 力反馈（震动） |
| WS2812B NeoPixel LED | 若干 | — | 动态照明 |
| TMP36 温度传感器 | 1 | — | 温度监控 |
| SSD1306 OLED（I2C） | 1 | — | 可选，用于视觉反馈 |
| 红外 LED | 4 | — | 安装在显示器四周 |
| 按键、开关、连接线等 | 若干 | — | 根据具体设计 |
能力画像
⚪ 记忆与知识检索: 1/5
🔵 逻辑推演: 3/5
⚪ 表达与交流: 1/5
⚪ 感知与观察: 2/5
🔵 数理与计算: 3/5
🔵 动手与操作: 4/5
⚪ 狂热与坚持: 3/5
⚪ 创造与创新: 3/5
项目图库
所需技能
🔧 **动手能力**：需要具备一定的电子制作和焊接技能，能够将 ESP32-S3 开发板、红外摄像头、螺线管、震动马达、LED 等元件组装到光枪外壳内，并进行布线。
💻 **编程能力**：需要熟悉 PlatformIO 开发环境，能够编译和烧录固件。了解 C/C++ 编程和 ESP32 架构有助于进行自定义修改和调试。
⚡ **电子电路**：需要理解基本电路原理，能够连接传感器、执行器和电源，并确保电路安全可靠。了解 ESP-NOW 无线协议和 HID 协议有助于理解系统架构。
适用场景
**街机光枪游戏**：在 PC 或 MiSTer FPGA 上玩 Time Crisis、House of the Dead 等经典街机光枪射击游戏，获得无线、低延迟的沉浸式体验。
**DIY 光枪制作**：适合电子爱好者和游戏玩家自行制作高性能、可定制化的光枪外设。
**家庭娱乐中心**：将光枪集成到家庭游戏系统中，提供不同于传统手柄的独特交互方式。
**开源固件学习**：学习 ESP32-S3 双核优化、ESP-NOW 无线通信、红外追踪算法等嵌入式开发技术。