OpenEVSE WiFi for ESP32
July 9, 2026 · View on GitHub
This release recommends OpenEVSE firmware 9.0.0 (minimum 7.1.3); features including Solar Divert and push-button menus may not behave as expected on older firmware.
- For the older WiFi V2.x ESP8266 version (pre June 2020), see the v2 firmware repository
 Dashboard — charging (dark theme) |
 Dashboard — charging (light theme) |
Screenshots of every screen — auto-generated and always current — illustrate the user guide.
The WiFi gateway uses an ESP32 which communicates with the OpenEVSE controller via serial RAPI API. The web UI is served directly from the ESP32 web server and can be controlled via a connected device on the local network.
Contents
Features
Web UI
- Dashboard — live charge state, power/session chart, charge modes (Auto / Eco / On / Off), Boost, charging-current control
- First-run setup wizard, light & dark themes, responsive/installable on mobile, four languages (EN / ES / FR / HU)
- Session limits — stop automatically at a target SOC, range, time, or energy
- Charge Manager — station defaults, always-active features, and recurring weekly charge rules (up to 50 timer slots), evaluated on-device
- Monitoring — live energy, sensor, vehicle, and claims data
- History — session & event log with CSV export, plus on-device energy logging (daily / monthly / annual)
Energy management
- 'Eco' mode / solar divert — start, stop, and modulate charging from excess solar PV or grid export (MQTT or HTTP fed)
- Current shaper — throttle charging so total household load stays within your supply capacity
- Vehicle integration — SOC, range, and charge ETA from Tesla, MQTT (e.g. Home Assistant), OCPP, or HTTP; home-battery display
- OhmConnect demand-response support
Integrations & access control
- MQTT status & control — full status published, control topics, MQTTS support; basis of the Home Assistant integration (beta)
- Emoncms logging — emoncms.org
- OCPP 1.6-J — connect to a charge-point management system
- RFID authorisation — card-based access with per-user charge history (PN532 module)
- HTTP API + WebSocket live stream; RAPI passthrough
System & safety
- Safety — GFCI / diode / ground / stuck-relay / vent checks, temperature throttling, boot lock, heartbeat watchdog
- Time & timezone via SNTP with automatic DST
- TLS certificates for MQTTS/HTTPS; HTTP authentication
- Firmware updates — one-click GitHub OTA or file upload from the web UI
- Wired Ethernet support (Olimex ESP32 Gateway and similar); automatic WiFi access-point fallback
- On-device TFT touchscreen display on supported hardware
Requirements
OpenEVSE based Safety/ESP32 WiFi
- Purchase via: OpenEVSE Store
- OpenEVSE FW V9.0.0 recommended
- All new OpenEVSE units are shipped with 9.0.0 pre-loaded (July 2026 onwards)
Documentation
Documentation is organised by audience — start at the documentation index.
User Guide
One page per screen of the web UI, illustrated with auto-generated screenshots: getting started (WiFi setup, first-run wizard), dashboard, charge manager, monitoring, history, solar divert, load shaper, integrations (MQTT, Home Assistant, EmonCMS), OCPP, RFID, vehicle, settings reference, safety, firmware update, and troubleshooting & reset.
Developer Guide
Architecture (subsystems, EvseManager priorities, RAPI patterns), building the firmware (PlatformIO envs, host tests), web UI development (gui-nightshift, mock mode, automated screenshots), and wired Ethernet.
API references
HTTP API · MQTT API (developer guide) · RAPI protocol
AI / coding-agent docs
AGENTS.md (build/test commands, critical workflows), invariants, and the feature map — CI enforces that every config option, UI route, and API path stays documented.
Screenshots
Every screenshot in the docs is generated automatically from the web UI (37 images covering all screens, light/dark themes, desktop and mobile): browse them in docs/user/screenshots/, or see how they're generated.
Licence
GNU General Public License (GPL) V3