Repository navigation
Firmware Updates
The OpenEVSE integration includes an update platform entity that integrates directly with Home Assistant's native update system, giving you one-click OTA firmware management.
The OpenEVSE Update entity:
- Queries the GitHub Releases API to detect available firmware updates.
- Displays the current installed version and the latest available version.
- Shows the release notes for the new firmware directly in the update card.
- Provides a Install button to apply the update OTA from within Home Assistant.
You can find it at: Settings → Devices & Services → OpenEVSE → (device) → Update
- When a new firmware version is available, a notification will appear in Home Assistant (depending on your notification settings).
- Navigate to the OpenEVSE Update entity card.
- Click Install to trigger the OTA update process on the charger.
- The charger will reboot after the update — the integration will reconnect automatically.
Warning
Do not unplug the charger or the vehicle during an OTA firmware update. Allow the process to complete fully.
The update entity checks for new firmware by querying the GitHub API. Unauthenticated requests are limited to 60 requests per hour per IP address. In most home setups this is sufficient, but if you share a public IP with many Home Assistant instances, you may encounter rate limit errors.
- Generate a token at GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic).
- Create a token with no additional scopes selected (public repo access is sufficient and requires no scopes).
- In Home Assistant, go to Settings → Devices & Services → OpenEVSE → Configure.
- Paste the token in the GitHub Personal Access Token field.
This increases the rate limit from 60 to 5,000 requests per hour.
The integration supports OpenEVSE WiFi firmware 2.x and above. Many advanced features require a higher minimum version. The Controller Firmware sensor (sensor.openevse_controller_firmware) always shows the currently installed version.
| Firmware | Features Unlocked |
|---|---|
| 2.x+ | Core sensors (status, current, voltage, energy, temperatures, WiFi signal), basic overrides |
| 3.0.0+ | Daily/weekly/monthly/yearly energy usage sensors |
| 4.0.0+ | RFID pairing (Learn RFID Tag button), Schedule Calendar, Reset Energy Meter button/service, TLS/SSL and Root CA certificate installation |
| 4.1.0+ | Manual Override switch, Solar PV Divert switch, Current Shaper switch, LED Brightness, Shaper diagnostic sensors, Vehicle SoC/Range/ETA sensors, Override State sensor/select |
| 4.1.4+ | RFID Access switch |
| 4.2.2+ | Current Power Usage (Actual) sensor |
| 5.0.0+ | RFID user management services (set_rfid_user, delete_rfid_user, get_rfid_users) |
| 5.1.0+ | Advisory notifications sensors (notifications_count, notifications_severity), notification services (get_notifications, acknowledge_notification), and Repairs integration |
| Controller 9.3.0+ | Stuck-Relay Recovery button |
The update entity polls GitHub on its standard update coordinator schedule. To force an immediate check, call:
action: homeassistant.update_entity
target:
entity_id: update.openevse_openevse_update