-
-
Notifications
You must be signed in to change notification settings - Fork 12
Quick Start
This page is for the two most common jobs:
- Charge your battery from the grid at
Xwatts between timesYandZ. - Export up to
Xwatts between timesYandZ.
You can do this through the Home Assistant interface. You do not need YAML.
| Goal | Battery power | Schedule | Extra control |
|---|---|---|---|
| Charge from grid | Set Schedule Input Power to X
|
Add a charge slot from Y to Z
|
None |
| Export to grid | Set Schedule Output Power above X to cover house load |
Add a discharge slot from Y to Z
|
Cap the main meter export at X
|
Complete Installation and Setup, then find these devices under Settings > Devices & services > Solplanet:
- Your battery, including Work mode, Schedule Input Power, Schedule Output Power, and Schedule Configured.
- Your main meter, if you want to control export.
Home Assistant uses watts. For example, enter 5000 for 5 kW.
X is a power rate, not a total amount of energy. Charging at 5 kW for two hours adds roughly 10 kWh before losses, unless the battery reaches SOC max first.
Important
Charging the battery at 5,000 W does not limit your total grid import to 5,000 W. Your house loads are added to the battery charge power.
Setting a 5,000 W export limit caps export at about 5,000 W. It cannot guarantee that amount if your solar and battery do not have enough spare power.
The integration cannot hold your whole property's grid import at an exact watt value. Its import-current control only limits the inverter's own draw.
Example: charge at 5,000 W from 1:00 am to 3:00 am.
- Open your Solplanet battery device.
- Set Schedule Input Power to
5000. - Set Work mode to Custom mode.
- Open Developer Tools > Actions.
- Select Solplanet: Set Schedule Slots.
- Under Targets, select the battery's Schedule Configured entity.
- Select the day.
- Set Start hour to
1. - Set Start minute to
0. - Set Duration to
2. - Set Mode to
charge. - Select Perform action.
- Repeat for each day you want to charge.
The schedule remains on the inverter, so you do not need a separate Home Assistant automation to stop charging at 3:00 am.
Example: export up to 5,000 W from 5:00 pm to 7:00 pm.
This needs two parts:
- A battery schedule that makes power available.
- A meter limit that caps how much reaches the grid.
Your house uses battery power before the remainder is exported. Set Schedule Output Power high enough to cover both your house load and the export you want.
For example, if you want to export 5,000 W and your house normally uses 1,000 W at that time, start with 6,000 W. Stay within the ratings approved for your system.
- Open your Solplanet battery device.
- Set Schedule Output Power to
6000for this example. - Set Work mode to Custom mode.
- Open Developer Tools > Actions.
- Select Solplanet: Set Schedule Slots.
- Under Targets, select the battery's Schedule Configured entity.
- Select the day.
- Set Start hour to
17. - Set Start minute to
0. - Set Duration to
2. - Set Mode to
discharge. - Select Perform action.
- Repeat for each day you want to export.
Test this action manually before adding it to an automation:
- Open Developer Tools > Actions.
- Select Solplanet: Enable power limit control (Limit power).
- Select your main meter as the Meter device.
- Select Phase-balanced (Sum of all phases) for a typical single-phase system.
- Select (W) absolute power.
- Set Export power limit setpoint (W) to
5000. - Set Setpoint offset (W) to
-100for a small safety margin. - Set Communications loss timeout to
60seconds. - Set Communications loss power limit (W) to
0for a conservative fallback. - Select Perform action and watch your meter power.
Ask your installer which phase mode and fallback values to use if you have a three-phase system or an approved export-control requirement.
The battery stops scheduled discharge at Z, but the export cap stays enabled until you disable it. If you leave it enabled, it can also cap normal daytime solar export.
Test the stop action:
- Open Developer Tools > Actions.
- Select Solplanet: Disable power limit control.
- Select the same main meter.
- Select Perform action.
Create two Home Assistant automations after both manual actions work:
| Automation | Time | Action |
|---|---|---|
| Start export limit | One minute before Y
|
Enable power limit control (Limit power) with the tested values |
| Stop export limit | At Z
|
Disable power limit control |
Open Settings > Automations & scenes, create an automation, add a Time trigger, then add the tested Solplanet action. Starting the limit one minute early avoids a brief uncapped export when the battery schedule begins.
The schedule action asks for a start time and duration, not an end time.
Start (Y) |
End (Z) |
Start hour | Start minute | Duration |
|---|---|---|---|---|
| 01:00 | 03:00 | 1 |
0 |
2 |
| 13:30 | 16:30 | 13 |
30 |
3 |
| 17:00 | 21:00 | 17 |
0 |
4 |
A slot can start on the hour or half-hour and last one to four whole hours. For a longer period, add adjacent slots. Split a period that crosses midnight between the two days.
The current action labels Tuesday as Tus and Wednesday as Wen.
Set Schedule Slots adds a slot. It does not edit an existing one.
To change a slot:
- Run Solplanet: Clear Schedule for that day.
- Add the day's required slots again.
Wait for a successful integration update and check the existing schedule in the Solplanet app before changing it. This helps avoid losing slots if the dongle's schedule data has not loaded.
- Confirm the battery is in Custom mode.
- Confirm Schedule Input Power or Schedule Output Power is not 0.
- Confirm you created the slot for the correct day.
- For export control, confirm you selected the main meter.
- Check battery communication, warning, and error entities.
- Disable Power Limit Control temporarily if scheduled charging does not start.
See Battery Modes and Schedules, Power Limit Control, or Troubleshooting for more detail.
Solplanet Integration
Getting Started
Guides
Reference
Help And Advanced Use