Inverter Configuration

General options

max_grid_charge_rate

This is the uppler limit to charge the battery from grid. Value is WATT. This value should not be above the limit of your inverter.

Default:

max_grid_charge_rate: 5000

max_pv_charge_rate

This limits the used amount of PV to charge the battery. Value is WATT. With adding # in front of the value, this limit is not set and will push all PV into the battery.

Default:

#max_pv_charge_rate: 3000  (Disabled)

mqtt

This enables the MQTT inverter driver, which allows integration with any battery/inverter system via MQTT topics. This is a generic bridge that works with any external system that can publish battery status and receive control commands over MQTT.

For detailed documentation, see MQTT Inverter.

inverter:
  type: mqtt
  capacity: 10000              # Battery capacity in Wh (required)
  min_soc: 5                   # Minimum SoC % (default: 5)
  max_soc: 100                 # Maximum SoC % (default: 100)
  max_grid_charge_rate: 5000   # Maximum charge rate in W (required)
  cache_ttl: 120               # Cache TTL for SOC values in seconds (default: 120)

Key Features:

• Generic MQTT-based integration for any inverter
• Uses batcontrol's shared MQTT connection
• Supports Home Assistant auto-discovery
• Real-time status updates and command control
• No vendor-specific protocols required

fronius_gen24

This enables the Fronius GEN24 inverter.

inverter:
  type: fronius_gen24 #currently only fronius_gen24 supported
  address: 192.168.0.XX # the local IP of your inverter. needs to be reachable from the machine that runs batcontrol
  user: customer #customer or technician lowercase only!!
  password: YOUR-PASSWORD #
  max_grid_charge_rate: 5000 # Watt
  fronius_inverter_id: '1' # Optional: ID of the inverter in Fronius API (default: '1') (ab 0.5.6)
  fronius_controller_id: '0' # Optional: ID of the controller in Fronius API (default: '0') (ab 0.5.6)

Additional Parameters (since 0.5.6)

• fronius_inverter_id: Optional parameter to specify the inverter ID in the Fronius API. Default is '1'.
• fronius_controller_id: Optional parameter to specify the controller ID in the Fronius API. Default is '0'.

dummy

This option is for testing purposes only

*** Sample needs to be added ***