tdeck-decomps/FLASHING.md

ESP32-S3 Firmware Flashing Instructions

This guide provides the commands to flash the patched Meshcore/Ripple firmwares to your LilyGO T-Deck.

Prerequisites

• esptool: Install via pip install esptool or use the one provided in this workspace.
• Connection: Connect your T-Deck via USB-C. Ensure it is in bootloader mode (hold the trackball/button while powering on if needed).

1. Flashing Full Flash Dumps (Merged)

These binaries include the bootloader, partition table, and application. They must be flashed at the base address 0x0.

Ultra-TDeck v9.2

esptool.py --chip esp32s3 write_flash 0x0 Ultra-TDeck-v9.2-merged.patched.bin

MeshOS v1.1.8

esptool.py --chip esp32s3 write_flash 0x0 MeshOS-TDeck-1.1.8-merged.patched.bin

2. Flashing Application Images (OTA)

If you only want to flash the application part (bypassing bootloader/partition changes), flash at 0x10000.

Ultra-TDeck v9.2

esptool.py --chip esp32s3 write_flash 0x10000 Ultra-TDeck-v9.2.patched.bin

MeshOS v1.1.8

esptool.py --chip esp32s3 write_flash 0x10000 MeshOS-TDeck-1.1.8.patched.bin

Troubleshooting

• Baud Rate: If flashing is slow or fails, try adding -b 921600 to the command.
• Port: Specify the serial port if multiple are connected (e.g., -p /dev/ttyACM0).

---

Generated by Sisyphus on 2026-03-27