92 lines
3.3 KiB
Markdown
92 lines
3.3 KiB
Markdown
# Belevo_PV_Visu
|
||
|
||
Visualisierung des Eigenverbrauchs: Tages-Quoten für PV-Produktion vs. Einspeisung und Verbrauch vs. Netz-Bezug in IP-Symcon WebFront.
|
||
|
||
### Inhaltsverzeichnis
|
||
|
||
1. [Funktionsumfang](#1-funktionsumfang)
|
||
2. [Voraussetzungen](#2-voraussetzungen)
|
||
3. [Software-Installation](#3-software-installation)
|
||
4. [Einrichten der Instanzen in IP-Symcon](#4-einrichten-der-instanzen-in-ip-symcon)
|
||
5. [Statusvariablen und Profile](#5-statusvariablen-und-profile)
|
||
6. [WebFront](#6-webfront)
|
||
7. [PHP-Befehlsreferenz](#7-php-befehlsreferenz)
|
||
|
||
---
|
||
|
||
### 1. Funktionsumfang
|
||
|
||
* Anzeige von Tages-Quoten (in %)
|
||
* **Produktion** aufgeteilt in *Eigenverbrauch* vs. *Einspeisung*
|
||
* **Verbrauch** aufgeteilt in *PV-Anteil* vs. *Netz-Anteil*
|
||
* Zwei untereinander angeordnete Balkendiagramme
|
||
* Automatische Tages-Aggregation der Zählerwerte (kWh)
|
||
* Live-Update beim Laden der WebFront-Tile
|
||
|
||
---
|
||
|
||
### 2. Voraussetzungen
|
||
|
||
- IP-Symcon **ab Version 7.1**
|
||
- Aktiviertes **Archiv-Modul** (für Aggregation)
|
||
- Vier Zähler-Variablen (Produktion, Verbrauch, Einspeisung, Netz-Bezug) mit kWh-Zählerprofil
|
||
|
||
---
|
||
|
||
### 3. Software-Installation
|
||
|
||
1. **Über den Module Store**
|
||
- In der IPS-Konsole unter **Module → Modul Store** nach **Belevo_PV_Visu** suchen und installieren.
|
||
2. **Manuell per URL**
|
||
- In **Module → Einstellungen → Repositories** folgende Git-URL hinzufügen:
|
||
```
|
||
https://github.com/DeinRepo/Belevo_PV_Visu.git
|
||
```
|
||
- Anschließend **Module neu einlesen** und installieren.
|
||
|
||
---
|
||
|
||
### 4. Einrichten der Instanzen in IP-Symcon
|
||
|
||
Unter **Instanz hinzufügen** findet man das Modul über den Schnellfilter **“Belevo_PV_Visu”**.
|
||
|
||
__Konfigurationsseite__:
|
||
|
||
| Name | Beschreibung |
|
||
|------------------|----------------------------------------------------|
|
||
| **VarProduction**| Variable mit dem PV-Produktionszähler (kWh) |
|
||
| **VarConsumption**| Variable mit dem Gesamtverbrauchszähler (kWh) |
|
||
| **VarFeedIn** | Variable mit dem Einspeisezähler (kWh) |
|
||
| **VarGrid** | Variable mit dem Netz-Bezugszähler (kWh) |
|
||
|
||
> Nach dem Speichern der Konfiguration stehen die Variablen zur Live-Auswertung in der WebFront-Tile zur Verfügung.
|
||
|
||
---
|
||
|
||
### 5. Statusvariablen und Profile
|
||
|
||
Dieses Modul legt **keine** eigenen Statusvariablen an, sondern nutzt ausschließlich die vom Anwender ausgewählten Zähler. Profiles müssen für die Quoten-Balken nicht angelegt werden – sämtliche Formatierung erfolgt in der HTML-SDK.
|
||
|
||
---
|
||
|
||
### 6. WebFront
|
||
|
||
* **Tile-Typ:** „Belevo_PV_Visu“
|
||
* Zwei Balkendiagramme untereinander
|
||
1. **Produktion** – Grün-Töne (Eigenverbrauch/Einspeisung)
|
||
2. **Verbrauch** – Orange/Rot-Töne (PV-Anteil/Netz-Anteil)
|
||
* Beschriftung zeigt absolute Tages-Summen (kWh)
|
||
* Prozentwerte als Breite der jeweiligen Balken
|
||
|
||
<img src="https://www.symcon.de/service/dokumentation/konzepte/visualisierung/webfront/#tiles" alt="WebFront Tiles" width="600"/>
|
||
|
||
---
|
||
|
||
### 7. PHP-Befehlsreferenz
|
||
|
||
Zur manuellen Aktualisierung der Visualisierung kann folgender Aufruf in einem Script verwendet werden:
|
||
|
||
```php
|
||
// Aktualisiert die WebFront-Tile 'Belevo_PV_Visu' der Instanz $InstanceID
|
||
IPS_RequestAction($InstanceID, 'update', true);
|
||
Dieser Befehl löst das Neuberechnen der Tages-Aggregation aus und aktualisiert die Anzeige im WebFront. |