mesh-rs firmware

This page provides firmware downloads and command-line flashing instructions for every supported device.

ESP32 devices

Device	Download
M5Stack Cardputer gallery	stable 0.4.1: cardputer-mesh-0.4.1.bin 3.2 MiB · `127b05045d6cfad5cf3cb6ff36fbeced850933414103602ac0c773ef35012762`
Heltec WiFi LoRa 32 V2	Nothing published yet.
Heltec WiFi LoRa 32 V3	Nothing published yet.
Heltec WiFi LoRa 32 V4	stable 0.4.1: heltec-v4-0.4.1.bin 1.3 MiB · `3b9d3d820b5ff0cec9984b40a6d4f26b2e1d057e929fe6415500d3ef316f7790`
Guition JC4880P443	stable 0.4.1: jc4880p443-0.4.1.bin 2.8 MiB · `ba229c06d6a587ba0d6b9d68b0a847ff20f5477dc6648ea121f703b61a76b135`
LilyGo T-Deck / T-Deck Plus gallery	stable 0.4.1: t-deck-0.4.1.bin 3.7 MiB · `7445e2423d2f4c62e27f657b073bc336c035057672ad983f2e4dfc50dd5f9d95`
LilyGo T-Deck Max / Pro v2	stable 0.4.1: t-deck-max-0.4.1.bin 3.4 MiB · `16c565f9c5c14a8093831a6b4259661af9b5794210637ab54216a3b4450209d2`
LilyGo T-Deck Pro	stable 0.4.1: t-deck-pro-0.4.1.bin 3.4 MiB · `51aae6bedcdd2895928c83cc397322f9c06995cc5accdff3dfbb2f3807246d62`
LilyGo T-Lora Dual	Nothing published yet.
Elecrow ThinkNode M7	Nothing published yet.
Seeed XIAO ESP32-S3	Nothing published yet.

nRF52 devices

Device	Download
Heltec MeshPocket	latest 0.4.1: heltec-meshpocket-0.4.1.zip 530.5 KiB · `2db6c3bdd143919bc4538ce50464f35b5a5ced109c71f6437ad5bb5478eebac6`
Heltec Mesh Node T1	latest 0.4.1: heltec-t1-0.4.1.zip 548.1 KiB · `3419c88be27489bf0c44d76c137b465da0546b5b5ec06e4136e7e88460c72774`
Seeed SenseCAP T1000-E	latest 0.4.1: t1000e-0.4.1.zip 536.2 KiB · `c229588b7d282f543153ca3c7202787cf4196dcb40fe79d102826c979cfc5117`
Elecrow ThinkNode M1 gallery	latest 0.4.1: thinknode-m1-0.4.1.zip 801.3 KiB · `8b329225f2e59b39e694959a932a5a31b9fbc7efcc3720454289fbbf2238ff2c`
Seeed Wio Tracker L1 E-ink gallery	latest 0.4.1: wio-tracker-l1-eink-0.4.1.zip 809.5 KiB · `99eee606a279f91e7cc17dfcdd85903a8c120081ee13eefe1e802d288427e063`
Seeed Wio Tracker L1 OLED gallery	latest 0.4.1: wio-tracker-l1-oled-0.4.1.zip 799.1 KiB · `322f2dacdbba0a6e1ed861f4072fd51ad0c2437fc890d06874ac679f41408b98`
Seeed XIAO nRF52840	Nothing published yet.

Flashing an ESP32 board

Each ESP32 download is a combined flash image that includes the bootloader, partition table and application. Write it to address 0x0 with esptool:

CardPuter Adv/Mesh

esptool --chip esp32s3 --port /dev/ttyACM0 --before usb-reset --after watchdog-reset write-flash 0x0 cardputer-mesh-0.1.54.bin

T-Deck

esptool --chip esp32s3 --port /dev/ttyACM0 --before usb-reset --after watchdog-reset write-flash 0x0 t-deck-0.1.54.bin

These commands use firmware version 0.1.54 and serial port /dev/ttyACM0; substitute the image filename and serial port for your setup.

Flashing an nRF52 board

Each nRF52 download is a Nordic Secure DFU package in ZIP format. Place the board in DFU mode by double-pressing RESET or running dfu in the console, then transfer the package with Nordic's nrfutil:

nrfutil nrf5sdk-tools dfu usb-serial -pkg wio-tracker-l1-eink-0.1.54.zip -p /dev/ttyACM0

This example uses Wio Tracker L1 firmware version 0.1.54 and serial port /dev/ttyACM0.

Replacing the nRF52 bootloader

Running mesh-rs on an nRF52 board requires replacing the stock bootloader with the unified Nordic Secure DFU bootloader. Download the package matching the board's current bootloader, save it as bootloader_replace.zip (or substitute the filename below), and flash it with adafruit-nrfutil:

adafruit-nrfutil --verbose dfu serial -pkg bootloader_replace.zip -p /dev/ttyACM0 -b 115200 -sb

fleet_bootloader_legacy.zip 188.7 KiB · 6561d05a2d6213f997ff8028afab90f5e4c75d113750f023554c62aa11cecfdc — for a board that still runs its factory Adafruit or Heltec bootloader.
fleet_bootloader_signed.zip 39.4 KiB · 00a507f01fb0745099cf1b6d78b22810acc297c47d80abcbd71948cc54b6771b — to update or reflash an existing Nordic Secure DFU bootloader.

Substitute the serial port for your board in place of /dev/ttyACM0.

Restoring the stock bootloader

The following signed DFU packages replace the mesh-rs bootloader with the board's original Adafruit bootloader.

wio_otafix_revert_signed.zip 33.6 KiB · 10524b6e717868fdb88b51c57f3ca8a9d8152271676f11260bd50bb2be70c602
t1000e_otafix_revert_signed.zip 33.6 KiB · 26ee81d8b3799a1f7242a9fcbf5250f6db5f3cbd9d826a1c9fa1f129ad21bac9
xiao_nrf52_otafix_revert_signed.zip 33.6 KiB · 1d2d09b2e57bbc288ef24171cc7c4706b8a40f82ceaec081b5e1f21d9ff351da
thinknode_m1_otafix_revert_signed.zip 33.7 KiB · 8dec94dd547769dfa34a592fd68bf21414d53e0d53dc2b3ede5de2e7f697e7eb
heltec_t1_otafix_revert_signed.zip 35.7 KiB · c1997c8df4f7d44c88f1a9a097635e0ad44731823548e173d6da2893f6d982e2

Once the original bootloader is restored, stock firmware can be installed with adafruit-nrfutil or a web flasher.