Skip to content

evcc

v0.309.0 Breaking

This release includes 2 breaking changes for platform teams planning a safe upgrade.

Published 1mo Home Automation
βœ“ No known CVEs patched
Read the diff β†’ Tool health β†’ What is this tool? β†’

✓ No known CVEs patched in this version

Topics

battery charger eebus emobility go home-automation
+8 more
modbus mqtt ocpp pv semp solar sunspec wallbox

Affected surfaces

auth rbac breaking_upgrade

ReleasePort's take

Light signal
editorial:auto 1mo

Versionβ€―0.309.0 introduces a long‑lived API key for BC and refactors the dim/curtail handling, splitting hems and circuit logic.

Why it matters: The breaking changes (severityβ€―70) affect API authentication and internal module behavior; operators must review configurations before upgrade.

Summary

AI summary

Updates Other Changes β˜€οΈ, Bug Fixes 🐞, and New Features πŸ’« across a mixed release.

Changes in this release

Breaking High

Adds long-lived API key (BC)

Adds long-lived API key (BC)

Source: llm_adapter@2026-06-10

Confidence: low

β€”
Breaking High

Refactors dim/curtail handling, splits hems and circuit (BC)

Refactors dim/curtail handling, splits hems and circuit (BC)

Source: llm_adapter@2026-06-10

Confidence: low

β€”
Feature Medium

Adds HoldCharge battery mode

Adds HoldCharge battery mode

Source: llm_adapter@2026-06-10

Confidence: high

β€”
Feature Medium

Adds OCPP forwarder capability

Adds OCPP forwarder capability

Source: llm_adapter@2026-06-10

Confidence: high

β€”
Feature Medium

Adds returnEnergy support for AlphaESS systems

Adds returnEnergy support for AlphaESS systems

Source: llm_adapter@2026-06-10

Confidence: high

β€”
Feature Medium

Adds returnEnergy example for Custom Device integration

Adds returnEnergy example for Custom Device integration

Source: llm_adapter@2026-06-10

Confidence: high

β€”
Feature Medium

Adds battery energy metering for SolarEdge Hybrid inverters

Adds battery energy metering for SolarEdge Hybrid inverters

Source: llm_adapter@2026-06-10

Confidence: high

β€”
Feature Medium

Adds returnEnergy support for TasmotaSML integration

Adds returnEnergy support for TasmotaSML integration

Source: llm_adapter@2026-06-10

Confidence: high

β€”
Feature Medium

Adds climaterdisabled feature for Vehicle integration

Adds climaterdisabled feature for Vehicle integration

Source: llm_adapter@2026-06-10

Confidence: high

β€”
Bugfix Medium

Fixes Deye energy, power calculations and adds returnEnergy/voltages handling

Fixes Deye energy, power calculations and adds returnEnergy/voltages handling

Source: llm_adapter@2026-06-10

Confidence: high

β€”
Bugfix Medium

Reverts meter/hybrid PV energy reading fix for SunSpec hybrid inverters

Reverts meter/hybrid PV energy reading fix for SunSpec hybrid inverters

Source: granite4.1:30b@2026-06-10-audit

Confidence: low

β€”
Bugfix Low

Fixes GoodWe wallbox RFID register and phase-type detection

Fixes GoodWe wallbox RFID register and phase-type detection

Source: granite4.1:30b@2026-06-10-audit

Confidence: low

β€”
Bugfix Low

Fixes consumption display in History UI when no external/aux meters exist

Fixes consumption display in History UI when no external/aux meters exist

Source: granite4.1:30b@2026-06-10-audit

Confidence: low

β€”
Bugfix Low

Corrects entity titles for database loadpoints in Metrics component

Corrects entity titles for database loadpoints in Metrics component

Source: granite4.1:30b@2026-06-10-audit

Confidence: low

β€”
Bugfix Low

Fixes missing SoC reporting for idle SAIC/MG vehicles

Fixes missing SoC reporting for idle SAIC/MG vehicles

Source: granite4.1:30b@2026-06-10-audit

Confidence: low

β€”
Bugfix Low

Corrects climater detection when air‑conditioning value is null in flobz/PSA vehicle integration

Corrects climater detection when air‑conditioning value is null in flobz/PSA vehicle integration

Source: granite4.1:30b@2026-06-10-audit

Confidence: low

β€”
Bugfix Low

Fixes phase switching for WARP2+Energy Manager and WARP3 devices

Fixes phase switching for WARP2+Energy Manager and WARP3 devices

Source: granite4.1:30b@2026-06-10-audit

Confidence: low

β€”
Full changelog

Changelog

Breaking Changes 🚨

  • ead9296337a1811758b313c35c276e86eee22f86 Add long-lived api key (BC) (#29431)
  • 8106dc8b763799b078a83938d94605cc7b8a9bc5 Refactor dim/curtail handling- split hems and circuit (BC) (#30284)

New Features πŸ’«

  • 03d6c0249a71928b0159f3d500188585b81763b9 Add HoldCharge battery mode (#27906)
  • 3758ce1957462b84a1dd9830f1291557d8421d1f Add OCPP forwarder (#29154)
  • b4f7a42306c78b91c91e510c7c09d46eef904790 AlphaESS: add returnEnergy support (#30568)
  • 10001574c1ef28a35ac9830148708fe8c76273c8 Custom Device: add return energy example (#30544)
  • 9fb8be59568dc65ed0429719b4c81aee75fb975c SolarEdge Hybrid: add battery energy metering support (#30608)
  • 23bab534e6a3d602a03b7c76b84f819467e83447 TasmotaSML: add returnEnergy (#30599)
  • b479b3416564df855b7c78c45af5785ae10dd47f Vehicle: add climaterdisabled feature (#30610)

Experimental Features πŸ§ͺ

  • 4648f01fad9f73059b7fc7a4ec4436d2e049e8e4 Remote Access: now experimental (#30551)

Other Changes β˜€οΈ

  • 7d4e57ed38618ccd2a4ffd58f29fb0c739882b37 Battery Hold Charge: ui state; api docs (#30628)
  • 2f7126b005e1a2a595c69e76500ee739c0ebad96 Cardata: support "New Class" vehicles (#29709)
  • a0383838c4a0f6521ca458c869d35213860308bd Charger (Plugchoice): trim whitespace before parsing values (#30559)
  • 6f7b689322d8082436b38d4023a678469c624eee Cupra: migrate to EU Data Act portal
  • a1e62748e1426e32dd0e6add152f5178fcce02fa Loadpoint: prefer exact status match for vehicle identification (#29591)
  • 7fffbda78022ed0c5c1fb2ebfc377915d1bd9fb2 Meter (Kostal Plenticore): read DC PV energy from register 1056 (#30607)
  • a8361b575bd6143d1c9d29e21ec5d9f4f9b0408f Metrics: store entity title on lazy-create (#30196)
  • 0fa8b97daf20461ebf805ec270492b135e46cdba OCPP UI: remove wss assumption (#28996)
  • 2db85aeed6e365dbd1f9d6daec0e0df61cd66f22 OCPP: report zero charge power while idle (#30655)
  • 07a19d69a68afee8c396c4df12598c83b80ccee0 Optimizer ignore uninitialized loadpoints (#30600)
  • 1bb1ad20112acc5ae6456dd7b07e999a5866579b Optimizer: send zero solar forecast when current forecast is empty (#30637)
  • bfb55dc2c4cd8caa6b6750bf8dd02c0bdc911505 Shelly: drop grid energy and returnEnergy for 3-phase EM (#30534)
  • 0aa99422500100da2cc1f018c56c8b8d571273d2 Tariff: stop background routine when startup update fails (#30594)
  • 4dcff007d705429c8d582df3e4c78d414251e5f0 aa55 udp: dedupe concurrent block reads with single flight (#30589)
  • 6cf3ea92d2cc15f18902c8ee70a37677fdd0a117 sqlite: restore busy_timeout pragma (#30696)

Bug Fixes 🐞

  • ca2f32876df9e153b628f655f7ec3441dd3eb0c3 Deye: fix energy and power, add returnenergy and voltages (#30691)
  • 6d79408f86792b2f90b8766f77355f8bde1a1c72 GoodWe: fix wallbox RFID register and phase-type detection (#30667)
  • 4149d67faf5e104f1d2e80bb74dad5aab57ab9b0 History UI: fix consumption with no ext/aux meters (#30697)
  • c685afe9f21d1b410e198370dff590a68c4f0820 Metrics: fix entity titles for db loadpoints (#30634)
  • 635b543cb91d7eabd758e6f49473822c0c12ce52 Revert "meter/hybrid: fix pv energy readings in SunSpec hybrid inverter templates (#29955)"
  • 9f8de524632cd57c1a429501eb4e57fc949b123f Vehicle (SAIC/MG): fix missing SoC for idle vehicles (#30603)
  • 419a7d8f544880c1206c399e82419df239e181ce Vehicle (flobz/PSA): fix climater detection when air conditioning is null (#30621)
  • a1efbb901e07bba511cbc783f9f037e762b9e5b3 Warp: fix phase switching for WARP2+Energy Manager and WARP3 (#30460)

Breaking Changes

  • Refactored dim/curtail handling by splitting hems and circuit APIs
  • Added long-lived API key (BC) – requires migration

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track evcc

Get notified when new releases ship.

Sign up free

About evcc

solar charging β˜€

All releases β†’

Related context

Earlier breaking changes

  • v0.312.1 Home Assistant: add plugin source, support temp for heating switch devices
  • v0.312.0 make curtail (model 123/704) optional (BC)
  • v0.312.0 remove atoom alliantie (BC)
  • v0.308.0 Route VW/Audi vehicles through drivesomethinggreater service.
  • v0.307.2 Migrates VW/Audi token endpoint to /auth/v1/idk/oidc/token.

Beta — feedback welcome: [email protected]