Clicker Firmware Flasher

Firmware Installation

Web Serial Direct

Release Version

Selected Target

v1.0.0

App Partition

0x10000

Binary Size

~360 KB

Flashing Modes

Standard Update (Keep Stats): Targets 0x10000. Preserves all click counts and NVS settings. (Leave "Erase device" unchecked).

Factory Reset: Wipes device flash and re-initializes memory. (Check "Erase device" in modal).

Web Serial is not supported on this browser. Use Chrome, Edge, Brave, or see manual options below.

Web Serial requires a secure context (HTTPS) or localhost.

Hardware Guidance & Setup

Hardware

1

Connect Device

Connect Clicker to your computer via USB-C data cable.
2

Select Serial Port

Click "Connect & Flash Clicker" and choose the device serial connection from the popup list.
3

Flash & Auto-Restart

The flasher installs the firmware. The OLED display will restart automatically upon completion.

Compatibility & Drivers

Browser: Requires Web Serial API (Google Chrome, MS Edge, Brave, Opera on Desktop).
Drivers: Standard USB-to-UART bridge (CP210x or CH340).

Hardware Note: If initial connection times out, hold the physical side button while plugging in USB to trigger bootloader mode.

Alternative Flashing & Browser Options

For browsers without Web Serial API support (Firefox, Safari, iOS) or manual command-line workflows:

DATA LOSS WARNING: THIRD-PARTY WEB FLASHERS

Third-party web tools like web.esphome.io run an automatic full-chip erase that COMPLETELY WIPES ALL SAVED DATA (click counts, milestones, and NVS settings).

To update without losing saved stats, use this Official Web Installer in Chrome/Edge, or run .\flash_device.bat from the repo.

Option 1: Supported Browsers

Use Google Chrome, Microsoft Edge, Brave, or Opera for direct web installation with 100% data preservation.

Maintains All Stats

Option 2: web.esphome.io (Recovery)

For full chip erases or device recovery:

Download factory_firmware.bin (Offset 0x0).
Open web.esphome.io.
Flash factory_firmware.bin.

Open web.esphome.io (Full Erase) →

Option 3: Desktop CLI / esptool.py

Flash the merged binary to offset 0x0:

esptool.py --chip esp32 --port COMx write_flash 0x0 factory_firmware.bin

Or run .\flash_device.bat in the repository.

Understanding Manual Binary Files & Data Safety

factory_firmware.bin (Offset: 0x0) • Complete merged image (bootloader, partitions, app). Required for third-party flashers or full recovery. Wipes NVS data.
firmware.bin (Offset: 0x10000) • App-only update. Flashing to 0x10000 without running erase_flash preserves all NVS stats.
flash_device.bat • Recommended desktop CLI script that interactively prompts you to keep data or factory reset.

Direct Release Binaries

Download compiled binaries for manual deployment or offline storage.

Release Tag	Offset	Image Size	Binary File