Other Inverters

PredBat was originally written for GivEnergy inverters using the GivTCP integration but this is now being extended to other models:

Name	Integration	Template
GivEnergy with GivTCP	GivTCP	givenergy_givtcp.yaml
Solis Hybrid inverters	Solax Modbus integration	ginlong_solis.yaml
Solax Gen4 inverters	Solax Modbus integration in Modbus Power Control Mode	solax_sx4.yaml
Sofar inverters	Sofar MQTT integration	sofar.yaml
Huawei inverters	Huawei Solar	huawei.yaml
SolarEdge inverters	Solaredge Modbus Multi	solaredge.yaml
Givenergy with GE Cloud	ge_cloud	givenergy_cloud.yaml
Givenergy with GE Cloud EMC	ge_cloud	givenergy_ems.yaml

Note that support for all these inverters is in various stages of development. Please expect things to fail and report them as Issues on Github. Please also ensure you have set up enhanced logging in AppDaemon as described here.

GivEnergy with GivTCP

Please see the main installation instructions, you will need to install GivTCP first and then use the supplied template

Solis Inverters

To run PredBat with Solis hybrid inverters, follow the following steps:

Install PredBat as per the Installation Summary
Ensure that you have the Solax Modbus integration running. There are a number of entities which this integration disables by default that you will need to enable via the Home Assistant GUI:

Name	Description
`sensor.solisx_rtc`	Real Time Clock
`sensor.solisx_battery_power`	Battery Power

Instead of apps.yaml use ginlong_solis.yaml from this Repo as your starting template. The majority of settings should be correct but please check. You will need to un-comment the template line to enable it. Save it to the config/appdaemon/apps/predbat/config folder. Set solax_modbus_new in apps.yaml to True if you have integration version 2024.03.2 or greater
Ensure that the inverter is set Control Mode 35 - on the Solax integration this is Timed Charge/Discharge. If you want to use the Reserve functionality within PredBat you will need to select Backup/Reserve (code 51) instead but be aware that this is not fully tested. In due course these mode settings will be incorporated into the code.

Solax Gen4 Inverters

Use the template configuration from: solax.sx4.yaml

Set solax_modbus_new in apps.yaml to True if you have integration version 2024.03.2 or greater

Please see this ticket in Github for ongoing discussion: https://github.com/springfall2008/batpred/issues/259

Sofar Inverters

For this integration the key elements are:

Hardware - sofar2mqtt EPS board - Relatively easy to solder and flash, or can be bought pre-made.
Software - Sofar MQTT integration - MQTT integration
Home Assistant configuration - sofar_inverter.yaml package (in templates directory) with the MQTT sensors. This is the default with a couple of additional inputs to support battery capacity. This should be installed in Home Assistant.
Predbat configuration - sofar.yaml template for Predbat (in templates directory). This file should be copied to apps.yaml
Please note that the inverter needs to be put into "Passive Mode" for the sofar2mqtt to control the inverter.
This integration has various limitations, it can charge and discharge the battery but does not have finer control over reserve and target SOC%
Note: You will need to change the min reserve in Home Assistant to match your minimum battery level (input_number.predbat_set_reserve_min).

Please see this ticket in Github for ongoing discussions: https://github.com/springfall2008/batpred/issues/395

Huawei Inverters

Discussion ticket is here: https://github.com/springfall2008/batpred/issues/684

Please copy the template apps.yaml from https://github.com/springfall2008/batpred/blob/main/templates/huawei.yaml and modify for your system
Ensure you set input_number.predbat_set_reserve_min to the minimum value for your system which maybe 12%

SolarEdge Inverters

Discussion ticket is here: https://github.com/springfall2008/batpred/issues/181

Please copy the template apps.yaml from https://github.com/springfall2008/batpred/blob/main/templates/solaredge.yaml and modify for your system
Ensure that number.solaredge_i1_storage_command_timeout is set to reasonably high value e.g. 3600 seconds to avoid the commands issued being cancelled
Power Control Options, as well as Enable Battery Control, must be enabled in the Solaredge Modbus Multi integration configuration, and switch.solaredge_i1_advanced_power_control must be on.
For pv_today, pv_power and load_power sensors to work you need to create this as a template within your Home Assistant configuration.yml Please see: https://gist.github.com/Ashpork/f80fb0d3cb22356a12ed24734065061c. These sensors are not critical so you can just comment it out in apps.yaml if you can't get it to work

template:
  - sensor:
      - name: "Solar Panel Production W"
        unique_id: solar_panel_production_w
        unit_of_measurement: "W"
        icon: mdi:solar-power
        state: >
          {% set i1_dc_power = states('sensor.solaredge_i1_dc_power') | float(0) %}
          {% set b1_dc_power = states('sensor.solaredge_b1_dc_power') | float(0) %}
          {% if (i1_dc_power + b1_dc_power <= 0) %}
            0
          {% else %}
            {{ (i1_dc_power + b1_dc_power) }}
          {% endif %}
        availability: >
          {{ states('sensor.solaredge_i1_dc_power') | is_number and states('sensor.solaredge_b1_dc_power') | is_number }}

      - name: "Solar House Consumption W"
        unique_id: solar_house_consumption_w
        unit_of_measurement: "W"
        icon: mdi:home
        state: >
          {% set i1_ac_power = states('sensor.solaredge_i1_ac_power') | float(0) %}
          {% set m1_ac_power = states('sensor.solaredge_m1_ac_power') | float(0) %}
          {% if (i1_ac_power - m1_ac_power <= 0) %}
            0
          {% else %}
            {{ (i1_ac_power - m1_ac_power) }}
          {% endif %}
        availability: >
          {{ states('sensor.solaredge_i1_ac_power') | is_number and states('sensor.solaredge_m1_ac_power') | is_number }}

sensor:
  - platform: integration
    source: sensor.solar_panel_production_w
    method: left
    unit_prefix: k
    name: solar_panel_production_kwh

Givenergy with ge_cloud

This is experimental system, please discuss on the ticket: https://github.com/springfall2008/batpred/issues/905

First set up ge_cloud integration using your API key https://github.com/springfall2008/ge_cloud
Now copy the template givenergy_cloud.yaml from templates into your apps.yaml and edit
- Set geserial to your inverter serial
Make sure discharge down to registers are set to 4% and slots 2, 3 and 4 for charge and discharge are disabled (if you have them)

Givenergy with EMC

This is experimental system, please discuss on the ticket: https://github.com/springfall2008/batpred/issues/905

First set up ge_cloud integration using your API key https://github.com/springfall2008/ge_cloud
Now copy the template givenergy_emc.yaml from templates into your apps.yaml and edit
- Set geserial to your first inverter serial and geserial2 to the second (look in HA for entity names)
- Set geseriale to the EMS inverter serial number (look in HA for entity names)
Turn off slots 2, 3 and 4 for charge, export and discharge as Predbat will only use 1 slot (set the start and end times to 00:00)

I want to add an unsupported inverter to Predbat

First copy one of the template configurations that is close to your system and try to configure it to match the sensors you have
Create a github ticket for support and add in what you know to the ticket
Then find out how to control your inverter inside Home Assistant, ideally share any automation you have to control the inverter
You can create a new inverter type in apps.yaml and change the options as to which controls it has
The easy way to integrate is to use a HA service to start charges and discharges, edit the template below

 inverter_type: MINE
 inverter:
    name : "My Shiny new Inverter"
    has_rest_api: False
    has_mqtt_api: False
    has_service_api: True
    output_charge_control: "power"
    has_charge_enable_time: False
    has_discharge_enable_time: False
    has_target_soc: False
    has_reserve_soc: False
    charge_time_format: "S"
    charge_time_entity_is_option: False
    soc_units: "%"
    num_load_entities: 1
    has_ge_inverter_mode": False
    time_button_press: False
    clock_time_format: "%Y-%m-%d %H:%M:%S"
    write_and_poll_sleep: 2
    has_time_window: False
    support_charge_freeze: False
    support_discharge_freeze": False

  # Services to control charging/discharging
  charge_start_service:
    service: select.select_option
    entity_id: "select.solaredge_i1_storage_command_mode"
    option: "Charge from Solar Power and Grid"
  charge_stop_service:
    service: select.select_option
    entity_id: "select.solaredge_i1_storage_command_mode"
    option: "Charge from Solar Power"
  discharge_start_service:
    service: select.select_option
    entity_id: "select.solaredge_i1_storage_command_mode"
    option: "Maximize Self Consumption"