Skip to content

Firmware Updates

firstof9@gmail.com edited this page Oct 2, 2026 · 3 revisions

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 Update Entity

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


Installing a Firmware Update

  1. When a new firmware version is available, a notification will appear in Home Assistant (depending on your notification settings).
  2. Navigate to the OpenEVSE Update entity card.
  3. Click Install to trigger the OTA update process on the charger.
  4. 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.


GitHub API Rate Limiting

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.

Solution: Add a GitHub Personal Access Token

  1. Generate a token at GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic).
  2. Create a token with no additional scopes selected (public repo access is sufficient and requires no scopes).
  3. In Home Assistant, go to Settings → Devices & Services → OpenEVSE → Configure.
  4. Paste the token in the GitHub Personal Access Token field.

This increases the rate limit from 60 to 5,000 requests per hour.


Firmware Version Requirements

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

Manual Firmware Check

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

Clone this wiki locally