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
`cache`	Cache Time interval for data refresh Default: `1s` Example: `5m`	advanced

Configuration example for evcc.yaml

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

Grid meterSolar productionBattery

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)
      cache: 1s # Cache, Time interval for data refresh (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)
      cache: 1s # Cache, Time interval for data refresh (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)
      cache: 1s # Cache, Time interval for data refresh (optional)