Fronius Solar API V1

Solar API should only be used as fallback. Integration via Modbus is preferred.

Username and password are only required for active battery control.

Attention: Active battery control should only be used if no other settings for time-dependent battery control were made in the inverter configuration under "Energy Management" - "Battery Management", as existing settings will be overwritten. Choose corresponding configuration URI!

Supported features

Battery control: External control of home battery charging and discharging via evcc.

Usage areas

Grid meter
Solar production
Battery

Parameters

Name	Description	Level
`host`	IP address or hostname Example: `192.0.2.2`	optional
`user`	Username (for active battery control) e.g. email address, user id, etc. Default: `customer`	optional
`password`	Password (for active battery control) Service account password	optional
`capacity` [kWh]	Battery capacity Example: `50`	optional
`minsoc` [%]	Minimum charge Lower limit when discharging the battery in normal operation Example: `25`	optional
`maxsoc` [%]	Maximum charge Upper limit when charging the battery from the grid Example: `95`	optional
`batteryconfiguri`	Battery configuration URI Firmware starting with 1.36.5-1 requires /api/config. Default: `/config`	advanced
`maxchargepower` [W]	Maximum charge power For forced charging of the battery.	advanced
`maxdischargepower` [W]	Maximum discharge power Maximum discharge power of the storage.	advanced

Configuration example for evcc.yaml

If you don't want to configure via the UI, you can alternatively use this YAML block.

Grid meter Solar production Battery

meters:
    - name: my_grid
      type: template
      template: fronius-solarapi-v1
      usage: grid
      host: 192.0.2.2 # IP address or hostname
      user: customer # Username (for active battery control), e.g. email address, user id, etc. (optional)
      password: # Password (for active battery control), Service account password (optional)
      batteryconfiguri: /config # Battery configuration URI, Firmware starting with 1.36.5-1 requires /api/config. [/config, /api/config] (optional)

meters:
    - name: my_pv
      type: template
      template: fronius-solarapi-v1
      usage: pv
      host: 192.0.2.2 # IP address or hostname
      user: customer # Username (for active battery control), e.g. email address, user id, etc. (optional)
      password: # Password (for active battery control), Service account password (optional)
      batteryconfiguri: /config # Battery configuration URI, Firmware starting with 1.36.5-1 requires /api/config. [/config, /api/config] (optional)

meters:
    - name: my_battery
      type: template
      template: fronius-solarapi-v1
      usage: battery
      host: 192.0.2.2 # IP address or hostname
      user: customer # Username (for active battery control), e.g. email address, user id, etc. (optional)
      password: # Password (for active battery control), Service account password (optional)
      capacity: 50 # Battery capacity (kWh), optional
      minsoc: 25 # Minimum charge (%), Lower limit when discharging the battery in normal operation (optional)
      maxsoc: 95 # Maximum charge (%), Upper limit when charging the battery from the grid (optional)
      batteryconfiguri: /config # Battery configuration URI, Firmware starting with 1.36.5-1 requires /api/config. [/config, /api/config] (optional)
      maxchargepower: # Maximum charge power (W), For forced charging of the battery. (optional)
      maxdischargepower: # Maximum discharge power (W), Maximum discharge power of the storage. (optional)