OpenATV IR Gateway – User Guide

Web flasher:
https://webflascher.mynonpublic.com/

1. Required hardware

- M5Stack ATOM Lite ESP32
- M5Stack IR Unit
- USB-C data cable
- USB power supply for permanent operation

Other ESP32 boards or custom IR circuits are for advanced users only
and may require a modified firmware.

2. Install the firmware

Requirements:

- Google Chrome or Microsoft Edge
- M5Atom Lite connected with a USB-C data cable

Steps:

1. Open https://webflascher.mynonpublic.com/
2. Click Install.
3. Select the serial port of the M5Atom.
4. Wait until flashing is complete.
5. Unplug and reconnect the device.

Note:
If no USB port appears, the USB cable is often a charge-only cable.
Try another USB-C data cable.

3. First setup

On first boot, the gateway opens its own Wi-Fi network:

Wi-Fi:    OpenATV-IR-Gateway
Password: openatv1234
Address:  http://192.168.4.1/

Steps:

1. Connect to the OpenATV-IR-Gateway Wi-Fi network.
2. Open http://192.168.4.1/setup
3. Enter and save your home Wi-Fi credentials.
4. Then open the gateway in your home network:
   http://openatv-ir.local/
   or use the IP address shown by your router.

4. Import a remote-control bundle

1. Go to the RCU bundles section on the web flasher page.
2. Click the matching remote-control image and download the bundle JSON.
3. Open the gateway web interface.
4. Open /bundle/import.
5. Import the bundle JSON.
6. Open the remote page and test the buttons.

5. Help

No USB port visible:

- try another USB cable
- try another USB port
- install the USB serial driver
- use Chrome or Edge

No web interface:

- connect to the OpenATV-IR-Gateway Wi-Fi network
- open http://192.168.4.1/
- look for openatv-ir-gateway in your router
- try http://openatv-ir.local/

IR does not react:

- check the IR Unit connection
- make sure there is line of sight to the target device
- reduce the distance
- open /ir/sniff on the gateway and test the original remote control

6. Gateway diagnostic pages

/status
/debug
/ir/sniff