Skip to content

Releases: AlasdairDev/whxrl

Release list

whxrl v3.0.0

Choose a tag to compare

@AlasdairDev AlasdairDev released this 30 Jun 01:53

Flash these without installing the Arduino toolchain. Use Chrome or Edge
they support Web Serial; Firefox and Safari don't.

File Flash at What it is
whxrl-m5sticks3-merged.bin 0x0 Everything in one image (easiest)
bootloader.bin 0x0 Bootloader
partitions.bin 0x8000 Partition table
boot_app0.bin 0xe000 OTA selector
app.bin 0x10000 The application

Easiest: one file, in your browser

  1. Open the Espressif web flasher: https://espressif.github.io/esptool-js/
  2. Set Baudrate to 921600, click Connect, and pick the Stick's serial port.
    • If Connect fails, hold the BOOT button while connecting, or drop to 115200.
  3. Click Add File, choose whxrl-m5sticks3-merged.bin, and set the offset to 0x0.
  4. Click Program. When it reaches 100%, press the Stick's reset button.

The merged image writes the whole 8 MB flash, so it also clears any existing
blocklist and credentials — exactly what you want for a clean install.

Alternative: the four component files

Prefer not to rewrite the full 8 MB (it's faster, and keeps any existing data on
the device)? Add the four files above at their listed offsets instead of the
merged one.

ESP32-S3 uses bootloader offset 0x0, not 0x1000 — that's only older,
non-S3 ESP32 chips. And type the app offset carefully: it's 0x10000 (five
digits), not 0x1000.

First boot

The LCD drops straight into Wi-Fi setup — pick your network and type the password
on the keypad. Then open the dashboard at http://whxrl.local:

  • Default login is admin / whxrl — change it immediately (the dashboard
    reminds you, and there's a Change login link).
  • To filter your whole network, point your router's DNS at the Stick's IP.

Building from source instead? See ../tools/build.ps1 and
../docs/GENERATE_MY_BINARY.md.