Releases: AlasdairDev/whxrl
Release list
whxrl v3.0.0
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
- Open the Espressif web flasher: https://espressif.github.io/esptool-js/
- 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.
- If Connect fails, hold the BOOT button while connecting, or drop to
- Click Add File, choose
whxrl-m5sticks3-merged.bin, and set the offset to0x0. - 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, not0x1000— that's only older,
non-S3 ESP32 chips. And type the app offset carefully: it's0x10000(five
digits), not0x1000.
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.