🛠️ Hardware sponsored by PCBWay
Se vuoi costruire una lightgun wireless funzionante completamente a batteria basata su questo firmware, dai un'occhiata al progetto PICON-AS. Trovi tutte le istruzioni per l'hardware e il montaggio a questo indirizzo: Istruzioni PICON-AS
Note
Nota: Il sito è già fruibile e i contenuti tecnici sono corretti; stiamo solo ultimando la stesura dettagliata di alcune sezioni delle istruzioni. Al momento il sito è solo in lingua italiana, sarà tradotto in inglese quando sarà completato.
If you want to build a fully battery-powered wireless lightgun based on this firmware, check out the PICON-AS project. You can find all the hardware and assembly instructions at this link: PICON-AS Instructions
Note
Note: The website is already functional and all technical data is correct; we are currently finalizing the detailed step-by-step instructions. "Currently, the website is only available in Italian; it will be translated into English once it is completed
Questo repository è un porting del progetto originale 'OpenFIRE-firmware' del TeamOpenFIRE, adattato per funzionare sul microcontrollore ESP32S3. Il progetto è stato sviluppato utilizzando PlatformIO e, salvo alcuni adattamenti e piccole modifiche, il codice rimane sostanzialmente fedele all'originale del TeamOpenFIRE. Ho inoltre implementato la connessione wireless utilizzando il protocollo ESP-NOW per ESP32. Per farlo, ho sviluppato un dongle ESP32S3 da collegare al PC, il cui codice è disponibile in questo stesso repository. Grazie a questa soluzione, il PC non rileva alcuna differenza tra la connessione diretta via USB e quella wireless tramite dongle. Il codice di questo repository funziona anche sul microcontrollore RP2040, ma in questo caso supporta solo il collegamento diretto tramite USB, senza connessione wireless. Ogni volta che verranno apportate modifiche al progetto originale 'OpenFIRE-firmware' del TeamOpenFIRE, aggiornerò di conseguenza anche il codice di questo repository. Ringrazio di cuore il TeamOpenFIRE per la creazione del progetto 'OpenFIRE-firmware': a loro vanno tutti i meriti e la mia piena gratitudine. Questo è semplicemente un adattamento per il funzionamento su ESP32S3, con l'aggiunta della connessione wireless tramite ESP-NOW.
-
Calibrazione automatica del joystick analogico
IMPORTANTE: La procedura dura circa due secondi. Durante questa fase non toccare il joystick per garantire una calibrazione corretta.
-
Gestione della connettività
- Connessione via Cavo: Se il cavo USB è collegato al PC, la lightgun si connette direttamente in modalità cablata.
- Connessione Wireless (USB scollegato):
- La lightgun scansiona l'ambiente e seleziona il canale Wi-Fi con minori interferenze per una trasmissione ottimale.
- Rimane in ascolto di un dongle. Se durante l'attesa viene collegato un cavo USB, la connessione passa immediatamente su cavo.
- Una volta rilevato un dongle libero, esegue l'associazione. Il PC gestirà la periferica esattamente come se fosse collegata via cavo (nessuna differenza di funzionamento).
- Riconnessione automatica: In caso di spegnimento, al riavvio cercherà prioritariamente l'ultimo dongle associato per una connessione istantanea. Se non lo trova, farà una nuova scansione dei canali.
-
Stato della connessione Una volta stabilito il collegamento con il PC, l'interfaccia mostrerà lo stato attuale:
- Icona Wi-Fi: Connessione tramite dongle wireless.
- Icona USB: Connessione tramite cavo fisico.
This repository is a porting of the original 'OpenFIRE-firmware' project by TeamOpenFIRE, adapted to work on the ESP32S3 microcontroller. The project was developed using PlatformIO and, apart from some adaptations and small adjustments, the code remains essentially faithful to the original by TeamOpenFIRE. I have also implemented wireless connectivity using the ESP-NOW protocol for ESP32. To achieve this, I developed an ESP32S3 dongle to connect to the PC, and its code is available in this same repository. Thanks to this solution, the PC does not detect any difference between a direct USB connection and a wireless connection via dongle. The code in this repository also works on the RP2040 microcontroller, but in this case, it only supports direct USB connection without wireless connectivity. Whenever there are changes to the original 'OpenFIRE-firmware' project by TeamOpenFIRE, I will adapt the code in this repository accordingly. I sincerely thank TeamOpenFIRE for creating the 'OpenFIRE-firmware' project; all credit and gratitude go to them for their work. This is simply an adaptation to make it work on ESP32S3, with the addition of wireless connectivity via ESP-NOW.
-
Automatic analog joystick calibration
IMPORTANT: This process takes approximately two seconds. During this phase, do not touch the joystick to ensure correct calibration.
-
Connectivity management
- Wired Connection: If the USB cable is connected to the PC, the lightgun will connect directly in wired mode.
- Wireless Connection (USB disconnected):
- The lightgun scans the environment and selects the Wi-Fi channel with the least interference for optimal transmission.
- It remains in listening mode for a dongle. If a USB cable is connected during this wait, the connection immediately switches to wired mode.
- Once a free dongle is detected, it performs the pairing. The PC will handle the peripheral exactly as if it were connected via cable (no difference in functionality).
- Automatic reconnection: In case of power-off, upon restart, it will prioritize searching for the last paired dongle for an instantaneous connection. If not found, it will perform a new channel scan.
-
Connection status Once the connection with the PC is established, the interface will show the current status:
- Wi-Fi Icon: Connection via wireless dongle.
- USB Icon: Connection via physical cable.
A special thanks to PCBWay for sponsoring the hardware development of this project. Their professional PCB manufacturing service has been fundamental in transforming our schematics into reliable, high-quality physical boards.
We chose PCBWay for their:
- Manufacturing Precision: Excellent solder mask and silkscreen quality even on dense designs.
- Reliability: Consistent build quality across different batches.
- Fast Prototyping: Quick turnaround times that significantly accelerated our testing phase.
OpenFIRE - The Open Four Infa-Red Emitter Light Gun System https://github.com/TeamOpenFIRE/OpenFIRE-Firmware
