Skip to main content

Home Assistant

Home Assistant collects and visualises data from your smart home and offers extensive automation capabilities. evcc specialises in smart charging and heating. Both systems complement each other and can be connected in different ways.

note

evcc can also be installed as a Home Assistant Addon. You can find the instructions here.

Visualise & Automate​

evcc comes with many controls for smart charging and heating but can't cover every use case. Integrating with Home Assistant gives you more flexibility. Here are some examples:

  • Visualise measurements in dashboards
  • Create charging plans based on calendar events
  • Switch charging modes based on presence
  • ...

Home Assistant evcc Integration (Recommended)​

The ha-evcc integration by marq24 brings evcc data and functions directly into Home Assistant. This works regardless of whether you run evcc as a Home Assistant addon or not. The only requirement is that Home Assistant and evcc are reachable on the same network.

The integration provides all relevant evcc entities: measurements, settings, charging points, and vehicles. After installation, you get a comprehensive list of entities that you can use in dashboards and automations.

Installation via HACS:

  1. Open HACS in Home Assistant and search for "evcc".
  2. Install the entry evcc☀️🚘- Solar Charging by marq24.
  3. Restart Home Assistant.
  4. Go to Settings → Devices & Services → Add Integration, search for "evcc", and enter the URL of your evcc instance.

For additional installation options and details, see the GitHub repository.

Manual Integration​

Alternatively, you can manually integrate evcc data into Home Assistant via the REST API or MQTT.

REST API​

evcc offers a REST API. This guide by marq24 describes the integration with Home Assistant in detail.

MQTT​

You need an MQTT broker (e.g. Mosquitto, also available as a Home Assistant addon).

Configure the broker connection in evcc under Configuration → MQTT. The same broker and topic must be configured in Home Assistant so that both systems can exchange data.

You can use a tool like MQTT Explorer to verify that topics are arriving correctly. A guide on setting up MQTT sensors in Home Assistant is available in the blog by Alkly (German).

The available topics are documented in the MQTT API.

Using Home Assistant Entities​

evcc can connect directly to Home Assistant and use its entities (sensors, switches, numbers) as data sources. This allows you to integrate devices into evcc that are not natively supported, e.g. Zigbee smart plugs, sensors from other integrations, or DIY solutions. As long as the data is available as a Home Assistant entity, evcc can work with it.

Setup​

  1. Add a new device in the evcc UI (e.g. Configuration → Add additional meter)
  2. Select "Home Assistant" as the manufacturer
  3. evcc will automatically discover your Home Assistant instance on the network
  4. Authorise evcc in Home Assistant (new tab)
  5. Assign Home Assistant entities to the presented fields (e.g. "Power")
    • You'll get suggestions and autocomplete (e.g. sensor.inverter_power)
    • Entities must return pure numeric values (1234, not 1234 W)
    • To invert the sign, prepend - to the entity name (-sensor.inverter_power)

Supported Device Types​

  • Meters (grid, solar, battery, ...) with power, energy, currents, voltages, SoC
  • Chargers with status, enable/disable, and maximum charging current
  • Smart switches with simple on/off control (for smart plugs, relays)
  • Vehicles with SoC, range, status, odometer; optionally scripts for start/stop
  • Notifications under Configuration → Notifications you can send evcc messages via Home Assistant

Further Resources (Videos)​

Videos are in German.