Even though this custom integration has been created with care, the author cannot be responsible for any damage caused by this integration. Use at your own risk.
Home Assistant solar charger custom integration using OCPP and/or EV specific API to charge EV from surplus solar and weather forecast.
- Charge from excess solar adjusting car charging current according to feedback loop value "Main Power Net". The "Main Power Net" sensor expresses negative value in Watts for available power for charging car, or positive value for consumed power.
- Support multi-day solar charging using sun elevation triggers to start and stop.
- Compatible with off-peak night time charging.
- Configurable 7 days charge limit schedule. Default is to use existing charge limit already set in car.
- Support just-in-time schedule charging to required charge limit using solar and grid if charge completion time is set for the day.
- Automatically charge more today if today has no charge completion time and next 3 days have higher charge limit.
- Automatically adjust to the highest charge limit set within a rainy forecast period. The highest charge limit is selected from the 7 days charge limit settings that are within the forecast period taking into account the charge limit on bad weather setting. The objective is to charge more before a rainy period. Default disabled. (TODO)
- Might be possible to prolong car battery life by setting daily charge limit to 60%, and only charge more before a rainy period by enabling option to adjust daily car charge limit based on weather. (TODO)
- Allow manual top up from secondary power source (eg. grid, battery) if there is not enough solar during the day, or if required to charge during the night. Just need to set the power offset to specify the maximum power to draw from secondary power source. Also need to toggle on secondary power source if required to charge during the night. (TODO)
- Support manually setting or automatic programming of minimum charge current according to your requirement.
- Support charging multiple cars at the same time based on power allocation weighting for each car.
- Support skew to shift the power export/import curve left or right to achieve your minimal power import. (TODO)
- Configurable return codes for comparison with connect trigger states, connected states and charging states returned by your EV or charger specific API. These states are used to determine the stages of the charging process.
- Use EV specific API to control a EV for charging, and/or use OCPP to control an OCPP compliant charger to charge a EV. Only tested with OCPP simulator and Tesla car. OCPP and Tesla Fleet API support in beta testing phase.
💡 Tip: Please ⭐ this project if you find it useful, and may be also buy me a coffee!
- Home Assistant
- Enphase Envoy Integration configured for 20 seconds update interval.
- Tesla Custom Integration v3.20.4 (to control charging Tesla via Tesla cloud).
- Tesla UMC charger, 230V, max 15A.
- Tesla Model 3.
Entities from following integrations are also pre-configured in SolarCharger, ie. charger can be added using "Add charger device" button. Since I am not using these integrations, these integrations have only been tested by other users. Please feel free to ask for help in GitHub discussions.
- Tesla BLE MQTT docker This is for people who want to control their Tesla locally via Bluetooth without cloud.
- OCPP This is for people who want to use OCPP to control an OCPP compliant charger to charge their EV.
- Telsa Fleet
- Tessie
If your integration is not listed above, you might want to try "Add custom device" button and define your own charge control entities, ie. Settings > Devices & services > SolarCharger > Settings (cog wheel) > Select your custom device > Select your charge control entities (device on/off switch and read/set charge current are required as a minimum) > Submit
The Home Assistant Community Store (HACS) is a custom integration that provides a UI to manage custom elements such as Solar Charger Custom Integration in Home Assistant. You first need to install and configure it before following these instructions below.
- Go to HACS > Integrations in Home Assistant
- Search and install SolarCharger Integration
- Restart Home Assistant
- Copy the solarcharger directory to your Home Assistant machine, ie.
From: <Your git clone directory>\SolarCharger\custom_components\solarcharger
To: \\homeassistant.local\config\custom_components\solarcharger
- Restart Home Assistant.
- Go through normal procedure to add the integration, ie. Settings > Devices & services > Add integration > Search for "SolarCharger"
- Set up "Main Power Net" sensor in Home Assistant (HA) config. For example, for Enphase, sensor main_power_net expresses negative value in Watts for available power for charging or positive value for consumed power. For other inverter brands, adjust the formula to conform with above requirement according to your setup.
Settings > Devices & services > Helpers > Create helper > Template > Template a sensor >
Name: Main power net
State template: {{ states('sensor.envoy_[YourEnvoyId]_current_power_consumption')|int - states('sensor.envoy_[YourEnvoyId]_current_power_production')|int }}
Unit of measurement: W
Device class: Power
State class: Measurement
Device: Envoy [YourEnvoyId]
-
Add charger device, eg. Tesla, OCPP, etc.
-
If using OCPP charger, configure your charger to point to your HA OCPP central server, eg. ws://homeassistant.local:9000
-
Config the integration specifying the charger effective voltage, maximum current, maximum charge speed, ie.
SolarCharger > Global defaults > Configuration > Effective voltage
SolarCharger > Your local device > Configuration > Max current (if available)
- Set your car charge limit.
- Connect charger to car. Normal charging at constant current should begin immediately if schedule charging is disabled. After a little while, the integration will take over and manage the charging current during daylight hours. Please see wiki if automation cannot be triggered.
- There are 2 options on how to charge the car (see below).
- The integration will stop if charger is turned off manually or automatically by car when reaching charge limit.
- To abort charging, toggle off the "Charge" switch.
2 options on how to charge the car:
To charge from excess solar, just plug in the charger. The initial charge current is 6A. After about 1 minute it will adjust the current according to amount of excess power exported to grid.
To charge at full speed from secondary power source and solar, toggle on "Fast charge mode".
Please also check out the wiki pages.