Like our work? Remember to support the maintainers!

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

Successor to 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 Mouse, and dual-stick gamepad w/ d-pad support (in Wired mode).
• Easy installation with simple .UF2 binaries that can be drag'n'dropped directly onto an RP2040-based Microcontroller.
• Bluetooth Support (BETA) with the Raspberry Pi Pico W, for untethered gameplay in battery-powered lightguns.
• Portable on-board settings to store calibration profiles, toggles, settings, mappings (WIP), identifier and more to come.
• Integrates with the OpenFIRE App for user-friendly, and cross-platform configuration.
• Optimized for the RP2040, using its second core for input reading and serial handling, and the main core for camera and peripherals processing, whenever possible.
• Compatible with PC Force Feedback handlers such as Mame Hooker 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.
• Forever free and open source to the lightgun community!

Requirements

• An RP2040 microcontroller for running the OpenFIRE firmware.
  • Recommended boards for new builds would be the Raspberry Pi Pico (cheapest, most pins available), Adafruit Kee Boar KB2040 (cheaper, Pro Micro formfactor, compatible with other carrier boards), or ItsyBitsy RP2040 (compatible with SAMCO carrier boards)
• DFRobot IR Positioning Camera [SEN0158]: Mouser (US Distributor) | DF-Robot (International) | Mirrors list
• 4 IR LED emitters: regular Wii sensor bars might work for small distances, but it's HIGHLY recommended to use SFH 4547 LEDs w/ 5.6Ω (ohm) resistors. DIY build tutorial here!
  • Optional: Any 12/24V solenoid, w/ associated driver board. DIY build tutorial here! Easy driver board here
    • Requires a DC power extension cable &/or DC pigtail, and a separate adjustable 12-24V power supply.
  • Optional: Any 5V gamepad rumble motor, w/ associated driver board. DIY build tutorial here! Easy driver board here
  • Optional: Any 2-way SPDT switches, to adjust state of rumble/solenoid/rapid fire in hardware (can be adjusted in software if not available!)
  • Optional: Any WS2812B GRB NeoPixels, or any four-pin RGB LED for realtime lighting and reactions. Amazon | AliExpress (International)
  • Optional: SSD1306-based I2C (2wire/4pin) 128x64 OLED display for visual UI and life/ammo counter feedback support. AliExpress (International)

Refer to BOARDS.md for default pinouts for various boards - though keep in mind that every board supports completely custom pin layouts, configurable through the OpenFIRE App.

Installation:

Grab the latest .UF2 binary for your respective board from the releases page, and drag'n'drop the file to your microcontroller while booted into Bootloader mode; the RP2040 is automatically mounted like this when no program is loaded, but it can be forced into this mode by holding BOOTSEL while plugging it into the computer - it will appear as a removable storage device called RPI-RP2.

Additional information

Check out the enclosed instruction book! For developers, consult the README files in libraries for more information on library functionality.

Known Issues:

• With Pico W & Bluetooth enabled, TinyUSB/Serial fails to initialize properly when connected via USB, so the firmware is deadlocked either sending serial or USB report data.
• Updating NeoPixels settings from the OF App might cause some Pixels to be locked or shut off after saving - this is only temporary and will resolve itself after unplugging the board.
• There may be rare instances of SSD1306 displays shifting the display down a number of rows when the screen updates, which persist until the board is unplugged. The exact cause is still being investigated.
• Some rare instances where a serial exit signal is received while sending an escape key signal in the Simple Pause Menu with (non-static) Pixels in use might cause the gun to freeze. The exact cause is being investiaged.

Note

Solenoid may cause EMI disconnects with too thin of wiring. Cables for this run specifically should be 22AWG at its thinnest - or else the cables will become antennas under extended use, which will trip USB safety thresholds in your PC to protect the ports.

TODO:

• Add temperature monitoring/tempering for serial solenoid activations (only perform every other solenoid-on op).
• Add configurable temperature thresholds.
• Experiment with more AR correction presets for non-16:9 screens (per cali profile?)
• (Re-)expose button function remapping.
• Use more appropriate RP2040-specific subsystems (i.e. hardware timers)?
• Start librarifying more sections of the code for better readability/portability, i.e. pause mode and serial processing/handling in bespoke classes.

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).