Skip to content

Latest commit

 

History

History
119 lines (68 loc) · 5.51 KB

controls.md

File metadata and controls

119 lines (68 loc) · 5.51 KB

Inverter & battery controls

Inverter controls are split in to:

  • Entities that map to a single configurable setting on the inverter.
  • Services that map to multiple settings on the inverter. There are used to expose high-level functions in a single place.

Entities

Battery power limits

Use number.battery_charge_power_limit and number.battery_discharge_power_limit to set the power limit (in Watts) for charging and discharging, respectively.

It's perfectly valid to set the value to 0, which has the effect of pausing charging or discharging until a non-zero value is set.

Battery AC charge limit

Two low-level entities control the AC charge limit:

  • number.battery_ac_charge_limit sets the target battery percentage when charging from the grid.
  • switch.battery_ac_charge_limit determines whether that percentage is actually respected or simply ignored.

Odd behaviour can occur when the switch is left on while the limit is set to 100%, in particular the battery charge can be seen to "bounce" between 99% and 100%, charging and discharging between the two while AC charging is active. The GivEnergy app and portal automatically enable the limit when you configure a value below 100%, and disable the limit when you set the limit to 100%. The "Enable timed charging" service also automatically handles this for you.

Battery Eco (a.k.a Dynamic) mode

Use switch.battery_eco_mode to change this value. This is not to be confused with "Eco" mode as you see in the GivEnergy app; use the Activate eco mode for that.

Here is the corresponding control in the GivEnergy portal:

Low-level Eco mode control

Don't blame the integration for this confusion; unfortunately GivEnergy came up with this naming system.

  • When on, the battery will only discharge to match demand. No energy will be exported.
  • When off, the battery to discharge at maximum power.

Battery AC charging

When switch.battery_ac_charging is turned on, the battery will be charged from the grid. This only happens during active charge slots.

Battery DC discharging

switch.battery_dc_discharging is typically used in combination with other switches/modes. In general, it's believed that this should be on when you want to respect discharge slots.

This seems to work for "Timed Export" mode, however "Timed Discharge" does not appear to behave as expected, with the battery continuing to discharge outside of the defined slots. This was observed on a Gen1 inverter, so results on other equipment may vary. Please update this if you know more!

Battery cutoff limit

number.battery_cutoff_limit sets the minimum allowable battery SOC during battery discharge.

This is relatively useful, unlike the poorly named and confusing...

Battery SOC reserve

This is controlled via number.battery_soc_reserve. Despite the name, this does not set a minimum SOC under normal conditions.

This is poorly documented. A GivEnergy marketing document suggests that this only affects systems with an EPS configured.

To further add confusion, this setting is exposed in the GivEnergy app, rather than the more useful cutoff limit.

Services

These operations map to high-level operations provided by GivEnergy (e.g. via the mobile app). Executing a service will changing several inverter settings in one go.

Activate eco mode

This refers to the mode as you see in the GivEnergy app, and not switch.battery_eco_mode. Here is the corresponding control in the GivEnergy portal:

High-level Eco mode control

Activating this mode is equivalent to configuring the following individual options:

  • Set switch.battery_eco_mode to on.
  • Set switch.battery_dc_discharging to off.

Note that this does not affect your AC charging settings which, if enabled, will continue to take priority.

Activate timed discharge mode

This is supposed to discharge the battery for home consumption only during the specified time period.

Activating this mode is equivalent to configuring the following individual options:

  • Set switch.battery_eco_mode to on.
  • Set switch.battery_dc_discharging to on.
  • Set the first battery discharge slot.

As noted in battery DC discharging, this does not appear to work.

Activate timed export mode

This will discharge the battery and export to the grid during the specified time period.

Activating this mode is equivalent to configuring the following individual options:

  • Set switch.battery_eco_mode to off.
  • Set switch.battery_dc_discharging to on.
  • Set the first battery discharge slot.

Ways to turn this off include:

Enable timed charging

The battery will charge from the grid during the defined time period, up to the SOC as given.

Charging settings work completely independently of the discharging settings; changing one does not affect the other. It's just that AC charging takes priority during the configured time slot.

Activating this mode is equivalent to configuring the following individual options:

  • Set switch.battery_ac_charging to on.
  • Set number.battery_ac_charge_limit.
  • Set switch.battery_ac_charge_limit to on when the limit is < 100%, otherwise off.
  • Set the first battery charge slot.

To turn this off, set switch.battery_ac_charging to off.

Disable timed charging

This simply sets switch.battery_ac_charging to off. It may be removed in a future version.