# 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
```bash
esptool.py --chip esp32s3 write_flash 0x0 Ultra-TDeck-v9.2-merged.patched.bin
```

### MeshOS v1.1.8
```bash
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
```bash
esptool.py --chip esp32s3 write_flash 0x10000 Ultra-TDeck-v9.2.patched.bin
```

### MeshOS v1.1.8
```bash
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*
