Support → Target IR
Target IR — Wiring, Firmware & Setup
Everything you need to wire, flash, and configure your NeatoFX Target IR — interactive connection wizard, firmware installer, and full configuration reference.
Model
Target IR Rev 3.3
Connector Reference
Know your pins before you wire
Hover or tap any pin dot to see its GPIO number, voltage rating, and function. Pins also highlight when you select a connection type in the wizard below.
Tap any dot to see pin details
Pin & Output Overview
| Pin / Output | Spec | Typical Use |
|---|---|---|
| PWR IN | 5–24V DC, reverse-polarity protected | 12V supply (daisy-chain up to 5 targets) |
| RELAY (COM / NO / NC) | 2A @ 24VDC · 2A @ 120VAC | Motor, solenoid, bell, air cannon, AC light |
| GND SWITCH (NPN) | 20V @ 1.6A | 12V spot light, small DC device (low-side switch) |
| SERVO | PWM 50Hz, 5V @ 3A (via 5V AUX) | Knock-down servo, door latch, reveal mechanism |
| LED STRIP OUT | WS2811 / WS2812, GPIO22 | Addressable RGB strip — independent from face LEDs |
| 5V AUX (×2) | 5V @ 3A each | Power for servo, LED strip, sensors |
| GPIO IN (×3 + 1 analog) | 3.3V logic, 1× 0–3.3V analog | External trigger: button, PIR, pressure pad |
Power Input
Wiring your power supply
✓ No permit required
The included power supply converts 120VAC (standard wall outlet) to 12VDC. All cabling you run is low-voltage — no electrical permit needed in most jurisdictions.
⚠ Polarity protected
The target has reverse-polarity protection, but always wire + to + and − to − to avoid blowing the protection circuit. Check your supply before first power-on.
Connection Wizard
What do you want to connect?
Select a device type and get the wiring diagram, web interface settings, and recommended firmware all in one place.
Firmware
Choose your firmware build
Each build is pre-configured for a specific use case. After flashing, your target starts a WiFi setup portal — connect your phone to set your venue WiFi. All settings are then adjustable from the web interface.
Standard — NEC IR, Relay, LEDs, Home Assistant
The default build for most shooting gallery installations. Relay fires on hit, LEDs flash the hit effect, score event sent to Home Assistant. Servo pin is inactive — use the Servo Slider in the web UI if you've wired a servo.
Standalone — No Network or Home Assistant Required
Operates without venue WiFi or Home Assistant. The target boots as its own hotspot — connect your phone and configure everything from the local web interface at 192.168.4.1. Relay, LEDs, servo, and all settings work exactly the same; hit events just aren't sent to an external system. Ideal for portable setups, venues without network infrastructure, or self-contained game systems.
After flashing — first-time WiFi setup
Target starts AP mode
The target boots and broadcasts its own WiFi hotspot: NEATO-target-1
Password: neato123
Connect your phone
Connect to that hotspot. A captive portal opens automatically in your browser.
Set your venue WiFi
Select your venue network and enter the password. Target reboots and joins.
Home Assistant discovers it
Within 60 seconds, HA shows a notification: "New device found." Accept and you're done.
Updating existing targets via OTA
Already have targets running? No USB needed. Download the OTA binary and upload it through the target's web interface:
- Download the .ota.bin file for the firmware you want
- Open your target's web interface (
http://192.168.x.x) - Scroll to the bottom → OTA Update section
- Click Choose File, select the .bin, click Update
- Target reboots with the new firmware — all your settings are preserved
GPIO Inputs
External trigger inputs
Any of the 3 digital GPIO inputs (plus 1 analog) can fire the full hit sequence — LED flash, relay, servo, score update — without needing an IR shot. Use pressure pads, PIR sensors, buttons, or any NC/NO switch.
Momentary Button
Wire one terminal of a push button to the GPIO input, the other terminal to GND. Enable internal pull-up in the web interface. Button press = hit event.
PIR Motion Sensor
Power the PIR from 5V AUX, GND to GND, signal to GPIO. Motion detected = target fires. Use for animatronic activation when guests walk past.
Pressure Pad
NC pressure pad: wire between GPIO and GND. Step on it → circuit opens → hit fires. Configure NO/NC mode in the web interface.
Home Assistant Trigger
No wiring needed — use the HA service call to trigger any target remotely. Player completes a puzzle → HA fires a target LED sequence as a reward.
Configuration
Configuring your target from any browser
After connecting to WiFi, open your target's IP address in any browser. You'll see the full configuration panel — no app, no laptop required.
What you can set
All settings survive power loss
Every setting is stored in flash memory on the ESP32. Power off, power on — your config is exactly where you left it. No cloud sync required.
OTA firmware updates
Update all targets simultaneously from the ESPHome dashboard in Home Assistant. Push new firmware without visiting a single target — useful for multi-lane galleries.
Still have questions about your target?
We built this hardware — we know every pin and every edge case. Just ask.