# Peakshaving

IP-Symcon Modul zur automatischen monatlichen Vorgabe von Peakshaving-Werten.

Das Modul setzt je nach aktuellem Monat zwei Werte:

- Kapazität Peakshaving in %
- Leistung Peakshaving in W

Die Werte werden intern als Statusvariablen angezeigt und optional auf konfigurierte Ziel-Instanzen übertragen.

## Funktionsumfang

- Monatliche Vorgabewerte für Peakshaving
- Separate Ziel-Instanz für Kapazität
- Separate Ziel-Instanz für Leistung
- Frei konfigurierbare Property-Namen der Ziel-Instanzen
- Automatische tägliche Übernahme der aktuellen Monatswerte
- Manuelle Sofortübernahme über Button
- Manuelle Änderung der aktiven Werte über Statusvariablen

## Voraussetzungen

- IP-Symcon
- Ziel-Instanz für Kapazität, falls Kapazitätswert automatisch gesetzt werden soll
- Ziel-Instanz für Leistung, falls Leistungswert automatisch gesetzt werden soll
- Die angegebenen Property-Namen müssen in den Ziel-Instanzen vorhanden sein

## Konfiguration

### Ziel-Module

| Einstellung | Beschreibung |
|------------|--------------|
| Batterie Instanz | Ziel-Instanz für die Kapazität |
| Property-Name Kapazität | Property der Ziel-Instanz für die Kapazität |
| Instanz für Peakleistung | Ziel-Instanz für die Peakleistung |
| Manager Instanz | Property der Ziel-Instanz für die Peakleistung |

Standardwerte:

| Property | Standard |
|---------|----------|
| CapacityTargetProperty | AufdasNachladen |
| PowerTargetProperty | Peakleistung |

## Monatswerte

| Monat | Kapazität [%] | Leistung [W] |
|------|----------------|--------------|
| Januar | 11 | 42000 |
| Februar | 11 | 42000 |
| März | 8 | 43000 |
| April | 8 | 44000 |
| Mai bis September | 8 | 44000 |
| Oktober | 12 | 43000 |
| November | 12 | 43000 |
| Dezember | 12 | 43000 |

Die Werte können in der Instanzkonfiguration angepasst werden.

## Statusvariablen

| Name | Ident | Typ | Profil | Beschreibung |
|-----|-------|-----|--------|--------------|
| Kapazität Peakshaving | ActiveCapacity | Float | ~Intensity.100 | Aktive Kapazität in % |
| Leistung Peakshaving | ActivePower | Float | ~Watt | Aktive Peakshaving-Leistung in W |

Änderungen an diesen Statusvariablen werden direkt an die konfigurierte Ziel-Instanz übertragen.

## Automatische Übernahme

Das Modul prüft einmal täglich den aktuellen Monat und übernimmt die passenden Monatswerte.

Dabei werden:

1. die Statusvariablen aktualisiert
2. die Kapazität an die konfigurierte Ziel-Instanz geschrieben
3. die Leistung an die konfigurierte Ziel-Instanz geschrieben
4. `IPS_ApplyChanges()` auf der jeweiligen Ziel-Instanz ausgeführt
