WIFILTWeb interface for Icom LAN Transceivers
Firmware installer — version 20260812 •
GitHub
The whole road, before you start
Flashing is step zero. Everything after it happens on the device's own SETUP page, in this order — each step only needs what the device cannot work out for itself.
- 0 Flash firmware
- 1 Network
- 2 Identity
- 3 Radio
- 4 Transmit check
- 5 This browser
Required hardware
- Processor
- Original Espressif ESP32 (Xtensa LX6), compatible with the ESP32 Dev Module target.
- Flash memory
- 4 MB minimum, configured for DIO mode at 80 MHz.
- RAM
- Standard ESP32 internal SRAM (520 KB). External PSRAM is not required.
- Flash layout
- No OTA: 1.375 MB application and 2.56 MB LittleFS web assets, plus a separate 128 kB configuration partition the installer never writes.
This firmware image targets the original ESP32. It is not compatible with ESP32-C3, ESP32-S2, ESP32-S3, or other ESP32 chip families.
Flash firmware via USB
Open this page in Google Chrome or Microsoft Edge (Web Serial is not supported in Firefox or Safari). Connect the ESP32 to your computer via USB.
Is this a new device, or one that is already working? This page cannot tell, and the answer decides one checkbox further on.
Your configuration survives this — do not tick "Erase device". The installer asks Do you want to erase the device before installing WIFILT? with the box already unticked. That is the answer you want: leaving it alone writes the firmware and the web pages only.
- Leave "Erase device" unticked
- The normal update. WiFi networks and passwords, callsign and locator, radio
connections and credentials, LOG and JS8 settings,
every TX audio gain calibration, CW and frequency memories, MSG BOX
and band decoder rows all stay — they live in NVS and in the
configuration partition at
0x170000, and the installer writes neither. - Tick it only to start clean
- It erases the whole chip: everything above goes, including the WiFi credentials that let you reach the device at all. Use it for a board that will not boot, or when you are deliberately starting over — then restore from a backup file.
- Not affected either way
- Your QSO log. It is stored in your browser, not on the device, so flashing cannot touch it.
Coming from a release older than 20260808? Those builds kept the configuration inside the web-asset filesystem that this flash replaces, so it is lost whichever way you answer. Save a backup first and restore it afterwards: download it now, or open your device's address and use SETUP → Download config. This page cannot fetch it for you — it is served over HTTPS and your device over HTTP, so the browser blocks the request.
One thing a backup file never carries: the MSG BOX. Stored messages cannot be exported, so anything still waiting there is lost by an erase — read or forward it first.
- After connecting, select the correct
CP210x/CH340/JTAGserial device. - Choose Install WIFILT.
- The next screen asks Do you want to erase the device before installing WIFILT? — the Erase device box starts unticked. Leave it that way unless you mean to wipe the whole chip, then press Next.
Answer the question above to continue.
Open the interface after flashing
Updated a working device without erasing it? It keeps its WiFi credentials, rejoins your network on its own and is back at the same address as before. Nothing below applies — the steps are for a device that has no WiFi yet: brand new, or just erased.
-
Join the device's own WiFi. On its first boot it creates the network
WIFILT-AP, passwordremoteqth. Scan this with a phone to join without typing either:If the camera app does not offer to join, pick
WIFILT-APfrom the WiFi list and type the password. - Open
http://192.168.4.1. The setup page appears; some phones open it by themselves. - Erased the device, or came from a release older than 20260808? Restore your backup first — Upload config at the bottom of the setup page — before setting anything by hand. Anything you type before restoring will be overwritten by the file.
- Enter your WiFi network and password, then save. The device joins your network while its hotspot is still running and shows the address it was given, with a QR code. Scan or write it down: the hotspot closes when it restarts.
- Set up the radio. Reconnect your phone or computer to your normal WiFi,
open that address, and go to SETUP → Radio: set TRX1 to
ICOM-LAN, enter the radio's address, network user and password, then press Test & identify radio. The radio needs Network Control switched on in its own menu first.
Lost the address? Try http://wifilt.local/, look in your router's DHCP client
list, or open the serial console above at 9600 baud and press
Reset Device to read it from the boot log.
The button above flashes: bootloader, partition table, boot_app0, firmware, web assets.
It does not write the configuration partition at 0x170000, which is what
lets your settings survive an update.
For manual flashing there is wifilt-20260812-full.bin at offset 0x0
with esptool.py. That one erases everything — it is a whole-chip
image, so it overwrites the WiFi credentials in NVS and the configuration partition
as well. Use it to recover a board that will not boot, not to update a working one.
Icom is a registered trademark of Icom Incorporated. WIFILT is an independent software project and is not affiliated with, endorsed by, or sponsored by Icom Incorporated.