Fronius Solar API V1

← Solare, batteria domestica, rete, contatori

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!

Funzionalità supportate

Controllo batteria: Controllo esterno della carica e della scarica della batteria domestica tramite evcc.

Ambiti di utilizzo

Contatore di rete
Produzione solare
Batteria

Parametri

Nome	Descrizione	Livello
`host`	IP address or hostname Esempio: `192.0.2.2`	facoltativo
`user`	Username (for active battery control) e.g. email address, user id, etc. Predefinito: `customer`	facoltativo
`password`	Password (for active battery control) Service account password	facoltativo
`capacity` [kWh]	Battery capacity Esempio: `50`	facoltativo
`minsoc` [%]	Minimum charge Lower limit as configured on the battery system. Used by optimizer. Predefinito: `0` Esempio: `25`	facoltativo
`maxsoc` [%]	Maximum charge Upper limit as configured on the battery system. Used by optimizer and, on some devices, for grid charging. Predefinito: `100` Esempio: `95`	facoltativo
`batteryconfiguri`	Battery configuration URI Firmware starting with 1.36.5-1 requires /api/config. Predefinito: `/config`	avanzato
`maxchargepower` [W]	Maximum charge power Highest power the battery system can charge with. The optimizer plans with charging up to this power. Some devices also use it as grid charging power.	avanzato
`maxdischargepower` [W]	Maximum discharge power Highest power the battery system can discharge with. The optimizer plans with discharging up to this power. Smart mode assumes the battery supplies at most this power to vehicle charging.	avanzato
`cache`	Cache Time interval for data refresh Predefinito: `1s` Esempio: `5m`	avanzato

Esempio di configurazione per evcc.yaml

Se preferisci non configurare il dispositivo dall’interfaccia, puoi usare questo blocco YAML.

Contatore di reteProduzione solareBatteria

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: 0 # Minimum charge (%), Lower limit as configured on the battery system. Used by optimizer. (optional)
      maxsoc: 100 # Maximum charge (%), Upper limit as configured on the battery system. Used by optimizer and, on some devices, for grid charging. (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), Highest power the battery system can charge with. The optimizer plans with charging up to this power. Some devices also use it as grid charging power. (optional)
      maxdischargepower: # Maximum discharge power (W), Highest power the battery system can discharge with. The optimizer plans with discharging up to this power. Smart mode assumes the battery supplies at most this power to vehicle charging. (optional)
      cache: 1s # Cache, Time interval for data refresh (optional)