Connects to your Eleven Energy site ( cloud connection ) and obtains minute by minute stats from your inverter. It also allows changing of the hybrid work mode through service calls.
To use, add this repository through HACS and install the Eleven Energy Integration. You require HACS to be installed, follow the guide at the HACS download site for more details.
Once HACS is installed on your system:
- Add the Eleven Energy repository to your HACS installation
- Click
Download
You will also need an API token obtained through the Site & System Settings page of the Eleven Energy app. Once you have a token, from the Devices page in Home Assistant, add an integration, choose "Eleven Energy" and add your API token when requested.
The current Work Mode operating on each inverter is shown in the sensor.{device_id}_system_work_mode entity and is read only. To change work modes you can perform an Action ( Service Call in old money ) which allows you to specify additional attributes that control the work mode.
An action can be selected within an automation by selecting "Add action" then "Other actions" then "Perform an action", then select the appropriate service action from the list below. You can then select the device to perform the action on, or leave blank and the first Hybrid Inverter on the site will be used.
Each action may require parameters as specified below, to use a parameter, add it as a JSON object in the Action data, for example:
Available work modes are as follows:
This is the default work mode, with excess solar diverted to the battery by default, and the battery supplying local loads if needed.
To switch to this work mode, use the "set_work_mode_self_consumption" service call with the following parameters:
| Key | Required | Description |
|---|---|---|
| percent_to_battery | No | Sets the percentage of any excess solar that is diverted to the battery. For example as value of 50 will send half of the excess solar out to the grid and half into the battery. |
Charges the battery at a set power rate with energy from the grid. Once the target state of charge has been reached, the system will remain is a state where grid power is consumed to supply local loads until the work mode is changed.
To switch to this work mode, use the "set_work_mode_force_charge" service call with the following parameters:
| Key | Required | Description |
|---|---|---|
| target_power | Yes | The amount of power in kW to charge the battery at. |
| target_percent | Yes | The target State Of Charge to charge the battery up to, a value of 100 will fully charge the battery. |
Force discharges the battery and uses excess solar to export to the grid at the specified rate until the target State of Charge is reached, thereafter the system will export all excess solar until the work mode is changed.
To switch to this work mode, use the "set_work_mode_grid_export" service call with the following optional parameters:
| Key | Required | Description |
|---|---|---|
| target_power | Yes | The amount of power in kW to export to the grid, including excess solar and battery power. |
| target_percent | Yes | The target State Of Charge to discharge to. |
| include_excess_solar | No | When true, adds the average amount of excess PV over the cunsumed amount to the export, useful when ensuring the battery is discharged to a specified level. |
Exports all excess solar to the grid instead of charging the battery, if the amount of excess solar exceeds the export limit of the site then any excess is used to charge the battery.
To switch to this work mode, use the "set_work_mode_pv_export" service call with no parameters.
Manages grid export, battery charging and battery discharging based on a specified target state of charge and duration. The energy management system will then attempt to balance the amount of excess solar and battery to reach the specified state of charge by the end of the period, using an average of solar excess and available battery. A higher or lower state of charge goal may be specified than the currect state of charge, however the system will not force charge from the grid to reach a higher state of charge goal, only using excess solar to charge the battery.
To avoid target charging and export power reaching infinity or excessive values, the algorithm tops out at 30 minutes remaining. I.e. if the work mode stays in Target SoC mode or reaches within 30 minutes of the target period, the algorithm treats all calculations as if there are 30 minutes remaining to reach the target.
To switch to this work mode, use the "set_work_mode_target_soc" service call with the following optional parameters:
| Key | Required | Description |
|---|---|---|
| target_soc | Yes | The desired state of charge in percent to reach at the end of the period. |
| target_minutes | Yes | The number of minutes from initiating this command to reach the target state of charge by. |
| max_charge_power | No | The amount of kilowatts max to charge the battery at. Defaults to the maximum charge rate of the battery. |
| max_discharge_power | No | The amount of kilowats max to discharge the battery at. Defaults to the maximum discharge rate of the battery. |
Allows the system to "coast" without using any battery, useful if you would prefer to reserve battery capacity for an upcoming period of high cost import.
To switch to this work mode, use the "set_work_mode_idle_battery" service call with the following parameters:
| Key | Required | Description |
|---|---|---|
| allow_charging | No | Set to true if you still want to allow charging of the battery with excess solar i.e. only prohibit discharging. |
| allow_discharging | No | Set to true if you still want to allow discharging of the battery i.e. only prohibit charging. |