naps62
7d0be3c70c
test / test (push) Has been cancelled
Two related fixes for v0.1.3: 1. _read_power_w() reads each power sensor's unit_of_measurement and converts kW to W. Before this, sensors reporting in kW (Tesla integration's leomobile_charger_power = "1" kW) were treated as raw watts, causing the leftover calculation to undercount by ~1000×. In practice the algorithm sent the EV charge rate that matched "what's exporting NOW" instead of "what's available if EV pulled everything" — leaving ~1 kW of solar exported instead of routed to the car. 2. round() → math.ceil() on the amp computation. Trade-off: up to ~VOLTAGE watts of grid import per tick, in exchange for zero solar export. Maximizes PV self-consumption, accepts small grid cost as rounding noise. Tests added: kW conversion round-trip; ceil rounds up partial amps. All 57 pass. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
EV Solar Charger
A Home Assistant custom integration that dynamically sets your EV's charge current from solar surplus.
Features
- Solar-tracking charge rate during the day, with a configurable "always make progress" SOC floor.
- Hard cap during dinner hours to avoid overloading your home during peak cooking loads.
- Full-speed top-up during cheap-tariff night windows, gated by a separate night SOC target.
- Two independent SOC targets so you can hold for tomorrow's solar or top up from grid.
- Force-min / force-max / off overrides for one-off situations.
- Safety fallback to a conservative 6 A if any required sensor goes stale.
Installation
Via HACS (custom repository)
- HACS → ⋮ → Custom repositories
- Add
https://github.com/naps62/ha-ev-solar-chargeras category "Integration" - Install "EV Solar Charger"
- Restart Home Assistant
- Settings → Devices & Services → Add Integration → "EV Solar Charger"
Manual
Copy custom_components/ev_solar_charger/ into your HA config's custom_components/ directory. Restart HA. Add the integration via Settings → Devices & Services.
Configuration
The config flow asks for:
- Grid signal — either a single signed sensor (positive = import) or a pair of
grid_import_w+grid_export_wsensors. - EV consumption sensor — W reading of the EV's actual draw (e.g. a Shelly EM on the EV circuit).
- EV charge-current
number— the writable entity that sets the EV's charge amps. - EV charge
switch— the entity that starts/stops charging. - EV cable sensor — binary sensor that reads
onwhen plugged in. - EV battery SOC sensor — percentage.
- EV location tracker + home zone —
device_trackerand the zone name considered "home". - Solar production sensor (optional) — for dashboard + install verification.
After setup, an "EV Solar Charger" device appears with these entities:
| Entity | Purpose |
|---|---|
number.ev_solar_charger_target_day_soc |
SOC to charge to during the day (solar-tracking) |
number.ev_solar_charger_target_night_soc |
SOC to charge to overnight (cheap tariff) |
select.ev_solar_charger_mode |
auto / force-min / force-max / off |
switch.ev_solar_charger_enabled |
master kill |
time.ev_solar_charger_dinner_start |
start of the dinner cap window |
time.ev_solar_charger_night_start |
start of the night cheap-tariff window |
sensor.ev_solar_charger_leftover_w |
current solar surplus available |
sensor.ev_solar_charger_desired_amps |
what the integration wants the EV to draw |
sensor.ev_solar_charger_actual_amps |
what the EV is actually set to |
sensor.ev_solar_charger_sub_mode |
solar / dinner / night / safety-fallback / disabled |
sensor.ev_solar_charger_last_decision_reason |
short human-readable trace |
binary_sensor.ev_solar_charger_healthy |
overall health |
Tuning
| Tomorrow's plan | day target | night target |
|---|---|---|
| Sunny forecast, no trip | 50 % | 50 % |
| Cloudy forecast, no trip | 50 % | 80 % |
| Big trip tomorrow | 80 % | 100 % |
| Departing now | (use force-max) | (use force-max) |
License
MIT