# g3gg0/esp32_flasher architecture

> Architecture diagram of the GitHub repository g3gg0/esp32_flasher, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/g3gg0/esp32_flasher
- Repository: https://github.com/g3gg0/esp32_flasher

## Overview

This browser-first ESP32 toolkit lets users inspect or edit firmware images, or connect to hardware to read and flash device memory. The viewer workflow loads an image or connects live, parses boot and partition metadata, and exposes binary/NVS/FAT views and editing tools; the flasher workflow synchronizes with the bootloader and transfers flash data. The parser also supplies a lazy sparse-image cache for efficient reads and writes. Feature-level links rely on README statements where source excerpts do not show the UI wiring.

Main entry points: [`flasher.js`](https://github.com/g3gg0/esp32_flasher/blob/master/flasher.js) (Bootloader protocol), [`esp32-viewer.html`](https://github.com/g3gg0/esp32_flasher/blob/master/esp32-viewer.html) (Firmware viewer), [`esp32-parser.js`](https://github.com/g3gg0/esp32_flasher/blob/master/esp32-parser.js) (Image parser), [`flasher.html`](https://github.com/g3gg0/esp32_flasher/blob/master/flasher.html) (Flasher interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inspection["Firmware inspection"]
  node_viewer["Firmware viewer<br/>[esp32-viewer.html]"]
end

subgraph group_image["Image parsing and editing"]
  node_parser["Image parser<br/>[esp32-parser.js]"]
  node_sparse["Sparse image cache<br/>[esp32-parser.js]"]
  node_nvs["NVS and filesystem<br/>[esp32-parser.js]"]
end

subgraph group_device["Device flashing"]
  node_flasher_ui["Flasher interface<br/>[flasher.html]"]
  node_chip_data["Chip profiles<br/>[chips.js]"]
  node_protocol["Bootloader protocol<br/>[flasher.js]"]
end

subgraph group_transport["Device transport"]
  node_serial["Serial adapter<br/>[flasher.js]"]
  node_webusb["WebUSB transport<br/>[flasher.js]"]
end

node_user(("Engineer"))
node_file_image["Firmware image"]
node_device_target["ESP32 device"]

node_user -->|"opens"| node_viewer
node_user -->|"opens"| node_flasher_ui
node_user -->|"loads"| node_file_image
node_viewer -->|"parses image"| node_parser
node_viewer -->|"edits cached data"| node_sparse
node_parser -.->|"reads through"| node_sparse
node_parser -.->|"parses partitions"| node_nvs
node_flasher_ui -->|"controls flashing"| node_protocol
node_protocol -->|"uses profiles"| node_chip_data
node_protocol -.->|"communicates via"| node_serial
node_protocol -.->|"communicates via"| node_webusb
node_serial -->|"transfers flash"| node_device_target
node_webusb -->|"transfers flash"| node_device_target

click node_viewer "https://github.com/g3gg0/esp32_flasher/blob/master/esp32-viewer.html"
click node_flasher_ui "https://github.com/g3gg0/esp32_flasher/blob/master/flasher.html"
click node_parser "https://github.com/g3gg0/esp32_flasher/blob/master/esp32-parser.js"
click node_sparse "https://github.com/g3gg0/esp32_flasher/blob/master/esp32-parser.js"
click node_nvs "https://github.com/g3gg0/esp32_flasher/blob/master/esp32-parser.js"
click node_chip_data "https://github.com/g3gg0/esp32_flasher/blob/master/chips.js"
click node_protocol "https://github.com/g3gg0/esp32_flasher/blob/master/flasher.js"
click node_serial "https://github.com/g3gg0/esp32_flasher/blob/master/flasher.js"
click node_webusb "https://github.com/g3gg0/esp32_flasher/blob/master/flasher.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_viewer toneBlue
class node_parser,node_sparse,node_nvs toneAmber
class node_flasher_ui,node_chip_data,node_protocol toneMint
class node_serial,node_webusb toneRose
class node_user,node_file_image,node_device_target toneIndigo
```

## Components

### Firmware inspection

- [Firmware viewer](https://github.com/g3gg0/esp32_flasher/blob/master/esp32-viewer.html): `esp32-viewer.html`

### Image parsing and editing

- [Image parser](https://github.com/g3gg0/esp32_flasher/blob/master/esp32-parser.js): `esp32-parser.js`
- [Sparse image cache](https://github.com/g3gg0/esp32_flasher/blob/master/esp32-parser.js): `esp32-parser.js`
- [NVS and filesystem](https://github.com/g3gg0/esp32_flasher/blob/master/esp32-parser.js): `esp32-parser.js`

### Device flashing

- [Flasher interface](https://github.com/g3gg0/esp32_flasher/blob/master/flasher.html): `flasher.html`
- [Chip profiles](https://github.com/g3gg0/esp32_flasher/blob/master/chips.js): `chips.js`
- [Bootloader protocol](https://github.com/g3gg0/esp32_flasher/blob/master/flasher.js): `flasher.js`

### Device transport

- [Serial adapter](https://github.com/g3gg0/esp32_flasher/blob/master/flasher.js): `flasher.js`
- [WebUSB transport](https://github.com/g3gg0/esp32_flasher/blob/master/flasher.js): `flasher.js`

### Other components

- **Engineer**
- **Firmware image**
- **ESP32 device**

## Connections

- Engineer → Firmware viewer: opens (evidence: `README.md`)
- Engineer → Flasher interface: opens (evidence: `README.md`)
- Engineer → Firmware image: loads (evidence: `README.md`)
- Firmware viewer → Image parser: parses image (evidence: `README.md`)
- Firmware viewer → Sparse image cache: edits cached data (evidence: `README.md`)
- Image parser → Sparse image cache: reads through (evidence: `esp32-parser.js`)
- Image parser → NVS and filesystem: parses partitions (evidence: `esp32-parser.js`)
- Flasher interface → Bootloader protocol: controls flashing (evidence: `README.md`)
- Bootloader protocol → Chip profiles: uses profiles (evidence: `flasher.js`)
- Bootloader protocol → Serial adapter: communicates via (evidence: `flasher.js`)
- Bootloader protocol → WebUSB transport: communicates via (evidence: `README.md`)
- Serial adapter → ESP32 device: transfers flash (evidence: `README.md`)
- WebUSB transport → ESP32 device: transfers flash (evidence: `README.md`)
