How times-z/geekmagic-open-firmware works
GeekMagic Open Firmware replaces the stock interface on HelloCubic Lite and Smalltv-Ultra ESP8266 displays. At boot, firmware loads configuration, initializes the display and Wi-Fi, starts time synchronization and the web server, and optionally starts the metrics dashboard; its loop services display, rescue mode, and dashboard updates. The web UI exposes configuration and device-management features, including Wi-Fi, rotation, NTP, GIF upload, logs, tokens, reboot, and OTA. Several subsystem links are documented by the source index rather than shown in excerpts, so those edges are omitted or marked unverified.
Main entry points: main.cpp Firmware Runtime · DisplayManager.cpp Display Manager · Webserver.cpp HTTP Server · DashboardManager.cpp Metrics Dashboard
Components 19
Boot and Recovery
- Firmware Runtime
src/main.cpp - Rescue Mode
src/boot/RescueMode.cpp
Device Services
- Configuration
src/config/ConfigManager.cpp - Secure Storage
src/config/SecureStorage.cpp - EEPROM
- Wi-Fi Manager
src/wireless/WiFiManager.cpp - Time Sync
src/ntp/NTPClient.cpp - LittleFS
- Logger
lib/Logger/Logger.cpp
Web Management
- HTTP Server
src/web/Webserver.cpp - Management API
src/web/Api.cpp - Web Interface
data/web/index.html - Web Feature Handlers
data/web/js
Screen and Dashboard
- Display Manager
src/display/DisplayManager.cpp - GIF Playback
src/display/Gif.cpp - Metrics Dashboard
src/dashboard/DashboardManager.cpp
Other components
- Device Owner
- Metrics Service
- Browser
Connections 21
- Device Owner → Firmware Runtime: boots device
readme.md - Firmware Runtime → Configuration: loads settings
src/main.cpp - Configuration → Secure Storage: uses credentials store
- Secure Storage → EEPROM: reads and writes
src/config/SecureStorage.cpp - Firmware Runtime → Rescue Mode: checks boot state
src/main.cpp - Firmware Runtime → Display Manager: initializes and updates
src/main.cpp - Firmware Runtime → Wi-Fi Manager: starts connectivity
src/main.cpp - Firmware Runtime → Time Sync: starts time sync
src/main.cpp - Firmware Runtime → HTTP Server: configures server
src/main.cpp - Firmware Runtime → Metrics Dashboard: starts and updates
src/main.cpp - HTTP Server → Management API: routes requests
- Browser → Web Interface: opens interface
readme.md - Web Interface → Web Feature Handlers: loads handlers
- Web Feature Handlers → Management API: calls management endpoints
- HTTP Server → LittleFS: serves static files
- Firmware Runtime → LittleFS: mounts filesystem
src/main.cpp - Display Manager → GIF Playback: plays animations
src/display/DisplayManager.cpp - Metrics Dashboard → Display Manager: draws metrics
src/dashboard/DashboardManager.cpp - Metrics Dashboard → Metrics Service: fetches metrics
src/dashboard/DashboardManager.cpp - Wi-Fi Manager → Display Manager: renders connection status
src/wireless/WiFiManager.cpp - Firmware Runtime → Logger: logs runtime events