⚠️ WARNING: REPOSITORY DEPRECATED AND MOVED ⚠️

This repository will no longer be used or updated. To streamline development, I have unified all projects into a single workspace.

From now on, you will find the updated code for the Dongle, the Lightgun, and the upcoming Pedal exclusively in the main repository: 🔗 New Unified Repository: OpenFIRE-Firmware-ESP32 (All future discussions, Issues, and releases will take place in this new space).

Coming Soon: PreRelease5 Thank you for all the testing you are doing, and I apologize for any inconvenience caused by this migration. I am doing a deep refactoring of the code to support the new unified structure. The code for the Lightgun and the Dongle is already online and working, while the pedal code is currently a work in progress. I will need a few more days to clean things up before officially publishing PreRelease5.

Hardware and 3D Printing The only other repository that will remain active is the one dedicated to the mechanical parts and .STL files for my Lightgun (PICON-AS): 🔗 Hardware Repository: OpenFIRE-PICON-AS-ESP32

See you on the new main repository!

=============================================================

⚠️ ATTENZIONE: REPOSITORY DEPRECATO E SPOSTATO ⚠️

Questo repository non verrà più utilizzato o aggiornato. Per semplificare lo sviluppo, ho unificato tutti i progetti in un unico spazio.

D'ora in avanti, troverete il codice aggiornato del Dongle, della Lightgun e del futuro Pedale esclusivamente nel repository principale: 🔗 Nuovo Repository Unificato: OpenFIRE-Firmware-ESP32 (Tutte le future discussioni, Issues e release avverranno in questo nuovo spazio).

Novità in arrivo: PreRelease5 Vi ringrazio per i test che state facendo e mi scuso per l'eventuale disagio dovuto al cambio di link. Sto facendo un profondo refactoring del codice per supportare la nuova struttura unificata. Il codice di Lightgun e Dongle è già online e funzionante, mentre quello del pedale è in lavorazione. Mi servirà ancora qualche giorno per fare pulizia prima di pubblicare ufficialmente la PreRelease5.

Hardware e Stampa 3D L'unico altro repository che rimarrà attivo è quello dedicato alla parte meccanica e ai file .STL della mia Lightgun (PICON-AS): 🔗 Repository Hardware: OpenFIRE-PICON-AS-ESP32

Ci vediamo sul nuovo repository principale!

OpenFIRE-DONGLE for EPS32

Video.WhatsApp.2025-04-11.ore.20.29.06_bb51e09c.1.mp4

Questo repository è stato creato per essere utilizzato insieme al codice del progetto OpenFIRE-Firmware-ESP32, un porting del progetto originale 'OpenFIRE-firmware' del TeamOpenFIRE, adattato per funzionare sul microcontrollore ESP32S3. Il progetto, sviluppato utilizzando PlatformIO, rappresenta il firmware per un ESP32S3 da usare come dongle collegato al PC, al fine di abilitare una connessione wireless tramite il protocollo ESP-NOW di ESP32. Questo dongle è progettato per essere usato in combinazione con il firmware 'OpenFIRE-Firmware-ESP32', da installare sulla lightgun. Il codice è strutturato per rilevare automaticamente le lightgun e configurarsi in modo autonomo. La trasmissione tra lightgun e dongle è bidirezionale, consentendo di utilizzare la lightgun come se fosse connessa direttamente al PC via USB. Il PC non rileva alcuna differenza tra una connessione diretta tramite USB e una connessione wireless tramite dongle. Desidero esprimere la mia sincera gratitudine al TeamOpenFIRE per la creazione del progetto 'OpenFIRE': tutti i meriti e la mia piena riconoscenza vanno a loro. Una piccola parte del codice è stata estratta e modificata dal repository "SerialTransfer": https://github.com/PowerBroker2/SerialTransfer.git. Desidero pertanto ringraziare anche l'autore di tale codice, PowerBroker2, per il suo contributo.

This repository was created to be used together with the code from the OpenFIRE-Firmware-ESP32 project, a porting of the original 'OpenFIRE-firmware' project by TeamOpenFIRE, adapted to work on the ESP32S3 microcontroller. The project, developed using PlatformIO, serves as the firmware for an ESP32S3 to be used as a dongle connected to the PC, enabling wireless connectivity through the ESP-NOW protocol of ESP32. This dongle is designed to be used in combination with the firmware 'OpenFIRE-Firmware-ESP32', which is installed on the lightgun. The code is structured to automatically detect lightguns and configure itself independently. The communication between the lightgun and the dongle is bidirectional, allowing the lightgun to function as if it were directly connected to the PC via USB. The PC does not notice any difference between a direct USB connection and a wireless connection through the dongle. I would like to express my sincere gratitude to TeamOpenFIRE for creating the 'OpenFIRE' project; all credit and my deepest appreciation go to them. A small portion of the code was taken and modified from the repository "SerialTransfer": https://github.com/PowerBroker2/SerialTransfer.git. I would therefore like to thank the author of this code, PowerBroker2, for their contribution.

... segue la pagina originale del progetto 'OpenFIRE-firmware' del TeamOpenFIRE

... follows the original project page 'OpenFIRE-firmware' project by TeamOpenFIRE

Like our work? Remember to support the developers!

OpenFIRE - The Open Four Infa-Red Emitter Light Gun System

Successor to IR-GUN4ALL, which is based on the Prow Enhanced fork, which in itself is based on the 4IR Beta "Big Code Update" SAMCO project

Features:

• Fully featured peripherals, from Solenoid & Rumble Force Feedback, to TMP36 Temperature Monitoring, and others to come.
• Multiple IR layouts support, with realtime perspective-adjusted tracking for both double lightbar (recommended!) and Xwiigun-like diamond layouts (compatible with other systems).
• Flexible Input System, with outputs to Keyboard, 5-button ABS(olute Positioning) Mouse, and dual-stick gamepad w/ d-pad support, with a robust button mapping system to suit your needs!
• Easy installation with simple .UF2 binaries that can be drag'n'dropped directly onto an RP2040-based Microcontroller.
• Portable on-board settings to store calibration profiles, toggles, settings, USB identifier, and more.
• Integrates with the OpenFIRE App for user-friendly, and cross-platform on-the-fly configuration.
• Optimized for the RP2040, using its second core for input polling & queuing and serial handling, and the main core for camera and peripherals processing, whenever possible.
• Compatible with PC Force Feedback handlers such as Mame Hooker, The Hook Of The Reaper, and QMamehook.
• Supports integrated OLED display output for SSD1306 I2C displays for menu navigation and visual feedback of game elements such as life and current ammo counts.
• Compatible with the MiSTer FPGA ecosystem, with dedicated mappings to streamline the user experience as much as possible.
• Forever free and open source to the lightgun community!

---

Thanks:

• Samuel Ballantyne, for his original SAMCO project, the gorgeous OpenFIRE branding, and perspective-based tracking system.
• Prow7, for his enhanced SAMCO fork which provided the basis of pause mode and saving subsystems.
• Odwalla-J, mrkylegp, RG2020 & lemmingDev for prerelease consultation, bug testing and feedback.
• The IR-GUN4ALL testers for their early feedback and feature requests - this wouldn't have happened without you lot!
• Chris Young for his TinyUSB compatible library (now part of TinyUSB_Devices).