How dandwhelan/esp32-spectra-e6-13inch works
This ESP32-S3 firmware turns uploaded or remotely sourced images into six-colour e-ink output, then manages configuration, cycling, quiet hours, and deep sleep. The main workflow is boot/config restore, optional Wi-Fi and time checks, image selection and processing, display refresh, portal servicing, and sleep. README-described decoding, dithering, scaling, and .spectra6 support are represented within the image renderer. Edges rely on the sampled main excerpt, source-index references, or README; unsampled implementation details are left unconnected where evidence is insufficient.
Main entry points: main.cpp Boot Orchestrator · ConfigurationServer.cpp Configuration Server · ImageScreen.cpp Image Renderer · HttpDownloader.cpp HTTP Downloader
Components 19
Boot and Power
- Boot Orchestrator
src/main.cpp - Wi-Fi Connection
src/WiFiConnection.cpp - Battery Status
src/battery.cpp
Configuration Portal
- Portal Screen
src/ConfigurationScreen.cpp - Configuration Server
src/ConfigurationServer.cpp - Portal Web UI
data/config.html
Image Sources and Processing
- Image Renderer
src/ImageScreen.cpp - Folder Image Source
src/FolderImageSource.cpp - HTTP Downloader
src/HttpDownloader.cpp
Display Hardware
- Display Adapter
src/DisplayAdapter.cpp - GDEP133C02 Driver
src/GDEP133C02.c - SPI and GPIO
src/comm.c
Persistent State
- Application Settings
src/ApplicationConfig.h - NVS Settings
src/ApplicationConfigStorage.cpp - SD Image Import
src/SDCardManager.cpp - LittleFS Images
src/ImageScreen.cpp
Other components
- Device User
- HTTP Image Host
- Spectra 6 Panel
Connections 24
- Device User → Configuration Server: configures device
README.md - Boot Orchestrator → NVS Settings: loads and saves
src/main.cpp - Boot Orchestrator → Wi-Fi Connection: connects
src/main.cpp - Boot Orchestrator → SD Image Import: imports image
README.md - Boot Orchestrator → Image Renderer: renders screen
src/main.cpp - Boot Orchestrator → Configuration Server: runs portal
src/main.cpp - Boot Orchestrator → Battery Status: checks status
src/main.cpp - Boot Orchestrator → Application Settings: uses settings
src/main.cpp - Boot Orchestrator → Display Adapter: initializes display
- Boot Orchestrator → Boot Orchestrator: sleeps and wakes
README.md - Configuration Server → NVS Settings: persists settings
- Configuration Server → Portal Web UI: serves interface
README.md - Configuration Server → Device User: accepts uploads
README.md - Configuration Server → Image Renderer: requests refresh
- Portal Screen → Configuration Server: uses server
src/ConfigurationScreen.cpp - Image Renderer → Folder Image Source: fetches folder images
src/ImageScreen.cpp - Image Renderer → HTTP Downloader: downloads image
- Folder Image Source → HTTP Downloader: downloads listing and image
- HTTP Downloader → HTTP Image Host: requests content
README.md - Image Renderer → LittleFS Images: reads and stores
README.md - Image Renderer → Display Adapter: draws framebuffer
- Display Adapter → GDEP133C02 Driver: sends frame
- GDEP133C02 Driver → SPI and GPIO: uses bus controls
src/GDEP133C02.c - SPI and GPIO → Spectra 6 Panel: drives QSPI
README.md