# FENECON REST-API

Quelle: https://docs.evcc.io/de/meters/fenecon-rest-api

##### Lizenzhinweis:
Für FENECON FEMS Systeme ist für die aktive Batteriesteuerung eine kommerzielle Lizenz *FEMS App REST/JSON Schreibzugriff* erforderlich.

##### FEMS-Dokumentation:
- FEMS App REST/JSON Lesezugriff: [docs.fenecon.de](https://docs.fenecon.de/de/fems/fems-app/App_REST-JSON_Lesezugriff.html)
- FEMS App REST/JSON Schreibzugriff: [docs.fenecon.de](https://docs.fenecon.de/de/fems/fems-app/App_REST-JSON_Schreibzugriff.html)
##### OpenEMS-Dokumentation:
- OpenEMS Edge REST-Api Controller: [openems.github.io](https://openems.github.io/openems.io/openems/latest/edge/controller.html#_rest_api_controller)

Unterstützte Funktionen: battery-control

## Parameter

| Name | Beschreibung | Standard / Beispiel | |
| --- | --- | --- | --- |
| host | IP-Adresse oder Hostname | 192.0.2.2 |  |
| capacity | Akkukapazität | 50 kWh |  |
| minsoc | Minimaler Ladestand Untere Grenze wie am Batteriesystem eingestellt. Wird vom Optimizer genutzt. | 0 % |  |
| maxsoc | Maximaler Ladestand Obere Grenze wie am Batteriesystem eingestellt. Wird vom Optimizer und für Netzladen genutzt. | 100 % |  |
| password | Passwort Zugangspasswort des Dienstes | user | erweitert |
| maxacpower | Maximale AC Leistung des Hybrid-Wechselrichters | 0 W | erweitert |
| battery | Steuerbare Batterie Komponente aktive Batteriesteuerung (REST/JSON schreibend) | ess0 | erweitert |
| watchdog | FEMS/OpenEMS Batteriesteuerung API-Timeout FEMS/OpenEMS Standard 60s | 60s | erweitert |
| maxchargepower | Maximale Ladeleistung Für erzwungenes Laden des Speichers. |  W | erweitert |
| maxdischargepower | Maximale Entladeleistung Maximale Entladeleistung des Speichers. |  W | erweitert |
| cache | Cache Zeitintervall für erneute Datenabfrage | 1s | erweitert |

## Konfigurationsbeispiel für evcc.yaml

```yaml
meters:
    - name: my_grid
      type: template
      template: openems
      usage: grid
      host: 192.0.2.2 # IP-Adresse oder Hostname
      password: user # Passwort, Zugangspasswort des Dienstes (optional)
      cache: 1s # Cache, Zeitintervall für erneute Datenabfrage (optional)
```

```yaml
meters:
    - name: my_pv
      type: template
      template: openems
      usage: pv
      host: 192.0.2.2 # IP-Adresse oder Hostname
      password: user # Passwort, Zugangspasswort des Dienstes (optional)
      maxacpower: 0 # Maximale AC Leistung des Hybrid-Wechselrichters (W), optional
      cache: 1s # Cache, Zeitintervall für erneute Datenabfrage (optional)
```

```yaml
meters:
    - name: my_battery
      type: template
      template: openems
      usage: battery
      host: 192.0.2.2 # IP-Adresse oder Hostname
      capacity: 50 # Akkukapazität (kWh), optional
      minsoc: 0 # Minimaler Ladestand (%), Untere Grenze wie am Batteriesystem eingestellt. Wird vom Optimizer genutzt. (optional)
      maxsoc: 100 # Maximaler Ladestand (%), Obere Grenze wie am Batteriesystem eingestellt. Wird vom Optimizer und für Netzladen genutzt. (optional)
      password: user # Passwort, Zugangspasswort des Dienstes (optional)
      battery: ess0 # Steuerbare Batterie Komponente, aktive Batteriesteuerung (REST/JSON schreibend) (optional)
      watchdog: 60s # FEMS/OpenEMS Batteriesteuerung API-Timeout, FEMS/OpenEMS Standard 60s (optional)
      maxchargepower: # Maximale Ladeleistung (W), Für erzwungenes Laden des Speichers. (optional)
      maxdischargepower: # Maximale Entladeleistung (W), Maximale Entladeleistung des Speichers. (optional)
      cache: 1s # Cache, Zeitintervall für erneute Datenabfrage (optional)
```