Skip to content

Scheduling

firstof9 edited this page Sep 28, 2026 · 1 revision

Scheduling (Calendar)

The OpenEVSE integration exposes a calendar platform entity that allows you to view, create, and delete scheduled charging events directly within Home Assistant.

Important

The Schedule calendar entity requires firmware 4.0.0 or higher. It will not be registered on older firmware.


How It Works

The OpenEVSE charger has a built-in schedule feature that controls when charging is allowed to start and stop. The integration maps this schedule to a standard Home Assistant calendar entity, so you can:

  • View upcoming charging windows in the Home Assistant Calendar UI.
  • Create new scheduled charging events using the standard HA calendar UI or via automations.
  • Delete existing scheduled events.

Each calendar event corresponds to one scheduled charging window on the charger, with a start time, end time, and optional charge limit (SoC percentage).


Using the Calendar UI

  1. Navigate to the Calendar view in the Home Assistant sidebar.
  2. Find the OpenEVSE Schedule calendar in the left panel.
  3. Click any existing event to view its details or delete it.
  4. Click a blank time slot to create a new scheduled charging window.

Supported Event Fields

When creating a schedule event:

Field Description
Start time When the charging window opens
End time When the charging window closes
Day of week Single-day or recurring weekly schedule
SoC limit Optional: stop charging at this battery percentage (requires vehicle SoC sensor)

Creating Events via Automations

You can use Home Assistant's calendar.create_event service to create schedule entries programmatically:

action: calendar.create_event
target:
  entity_id: calendar.openevse_schedule
data:
  summary: "Overnight Charge"
  start_date_time: "2026-10-01T22:00:00"
  end_date_time: "2026-10-02T07:00:00"

Note

The schedule calendar uses local time based on the Home Assistant timezone. Make sure your charger timezone is set correctly using openevse.set_time.


Deleting Events via Automations

action: calendar.delete_event
target:
  entity_id: calendar.openevse_schedule
data:
  uid: "<event-uid>"

Tips & Limitations

  • Recurring events are implemented as weekly repeating schedules on the charger. A new event created for a specific date will appear only once.
  • Changes take effect on the charger immediately — no restart required.
  • The charger's internal schedule is the source of truth. If you edit the schedule directly via the charger's web UI, the calendar entity in Home Assistant will reflect the changes at the next update poll.
  • If the firmware version check fails, the entity will not be created and a debug message will be logged. Check your firmware version at Settings → Devices & Services → OpenEVSE → (device) → Firmware.

Clone this wiki locally