How tinny-robot/esp32oledstudio works
ESP32OLEDStudio is an Arduino library for controlling an SH1106 OLED locally, through either a simple sketch API or a browser UI served by the ESP32 access point. The main path is browser interaction → local HTTP handlers → display state → OLED rendering; sketches can also draw directly through the facade. The README documents dashboard, text, image-processing/upload, settings, and display modes. Source excerpts show the facade, display wrapper, and server handlers; some UI and route wiring is documented but not fully sampled.
Main entry points: app.js UI and API client · WebServerManager.cpp AP and HTTP handlers · ESP32OLEDStudio.cpp Studio facade · OLEDDisplay.cpp Display wrapper
Components 18
Arduino API
- Studio facade
src/ESP32OLEDStudio.cpp - Facade API
src/ESP32OLEDStudio.h
OLED Rendering
- Display wrapper
src/OLEDDisplay.cpp - Display modes and state
src/OLEDDisplay.h
Local Web Server
- AP and HTTP handlers
src/WebServerManager.cpp - Server API contract
src/WebServerManager.h - Embedded UI assets
src/WebContent.h
Browser Interface
- Dashboard and controls
data/index.html - UI and API client
data/app.js - Image processing
data/app.js - Interface styling
data/style.css - Status dashboard
data/app.js - Text and font controls
data/app.js - Settings controls
data/app.js
Other components
- Arduino sketch
- U8g2 driver
- SH1106 OLED
- Phone or laptop
Connections 19
- Arduino sketch → Studio facade: calls
README.md - Studio facade → Display wrapper: initializes and delegates
src/ESP32OLEDStudio.cpp - Studio facade → AP and HTTP handlers: starts and services
src/ESP32OLEDStudio.cpp - Studio facade → Facade API: implements API
src/ESP32OLEDStudio.cpp - Display wrapper → Display modes and state: implements state API
src/OLEDDisplay.cpp - Display wrapper → U8g2 driver: draws through
README.md - U8g2 driver → SH1106 OLED: updates
README.md - AP and HTTP handlers → Server API contract: implements handlers
src/WebServerManager.cpp - AP and HTTP handlers → Display wrapper: updates display state
src/WebServerManager.cpp - AP and HTTP handlers → Embedded UI assets: serves embedded assets
src/WebServerManager.cpp - Phone or laptop → Dashboard and controls: uses
README.md - Dashboard and controls → UI and API client: loads script
- Dashboard and controls → Interface styling: loads stylesheet
- UI and API client → AP and HTTP handlers: sends HTTP requests
README.md - UI and API client → Status dashboard: refreshes
data/app.js - UI and API client → Text and font controls: initializes controls
data/app.js - UI and API client → Settings controls: initializes controls
data/app.js - UI and API client → Image processing: processes selected image
data/app.js - Image processing → AP and HTTP handlers: uploads bitmap
README.md