106 lines
4.7 KiB
Markdown
106 lines
4.7 KiB
Markdown
2. Starte IP-Symcon neu bzw. klicke in der Konsole auf „Module aktualisieren“.
|
||
|
||
Anschließend erscheint in der Instanzliste der neue Gerätetyp **Sofar Wechselrichter**.
|
||
|
||
---
|
||
|
||
## Konfiguration
|
||
|
||
1. **Instanz anlegen**
|
||
- Gehe in der IPS-Konsole auf „Instanzen hinzufügen“ → Hersteller: (falls sichtbar) → Modul: **Sofar Wechselrichter**.
|
||
- Vergib einen sinnvollen Namen und eine Beschreibung.
|
||
|
||
2. **Einstellungen in den Eigenschaften**
|
||
- **Logger-Seriennummer**:
|
||
Gib hier die „Logger-Nummer“ deines Sofar-Wechselrichters ein (Dezimal).
|
||
- **Abfragezyklus (Sekunden)**:
|
||
Intervall in Sekunden, in dem zyklisch alle eingetragenen Register abgefragt werden.
|
||
Ein Wert von `0` deaktiviert den Timer (keine zyklischen Abfragen).
|
||
- **Register-Tabelle**:
|
||
Hier definierst du beliebig viele Zeilen, jeweils mit:
|
||
1. **Register-Nummer** (dezimal)
|
||
2. **Bezeichnung** (z. B. „Gesamtproduktion“ oder „Spannung Phase L1“)
|
||
3. **Skalierungs-faktor** (z. B. `0.1`, `1`, `10` usw.)
|
||
|
||
Wird beispielsweise für Register `1476` als Bezeichnung „Gesamtproduktion“ mit Skalierungsfaktor `1` eingetragen,
|
||
so liest das Modul alle 60 Sekunden (oder den von dir gewählten Zyklus) Register 1476,
|
||
multipliziert das rohe UINT16-Ergebnis mit `1` und legt den Wert in einer IPS-Variable an.
|
||
|
||
3. **Speichern/Übernehmen**
|
||
Klicke auf „Übernehmen“, um die Änderungen zu übernehmen.
|
||
Das Modul legt automatisch untergeordnete IPS-Variablen an:
|
||
|
||
- **Vorheriger Wert (Register 1160)**
|
||
→ INT16BE, unverändert (analog zur alten Node-RED-Logik).
|
||
Diese Variable heißt intern `Vorheriger Wert` und wird automatisch gepflegt.
|
||
- **Alle weiteren Einträge aus der Register-Tabelle**
|
||
→ Für jede Zeile wird eine Float-Variable mit der von dir angegebenen „Bezeichnung“ angelegt.
|
||
Der Variablen-Identifier lautet automatisch `Reg<Registernummer>` (z. B. `Reg1476`).
|
||
|
||
---
|
||
|
||
## Funktionsweise
|
||
|
||
1. **Initialisierung (ApplyChanges)**
|
||
- Liest den Abfragezyklus aus den Moduleigenschaften und initialisiert den Timer.
|
||
- Legt eine Integer-Variable `Vorheriger Wert` (Reg 1160) an.
|
||
- Legt für jede Zeile in der Register-Tabelle eine Float-Variable an (Ident `Reg<Nummer>`).
|
||
|
||
2. **Zyklische Abfrage (Timer-Callback)**
|
||
- **Register 1160 (INT16BE)**
|
||
→ Wird als „Vorheriger Wert“ in die Variable geschrieben (signed interpretiert).
|
||
- **Alle weiteren Register aus der Tabelle**
|
||
→ Jedes Register wird per Modbus-ähnlichem TCP-Paketaustausch abgefragt, als UINT16 ausgelesen,
|
||
mit dem angegebenen Skalierungsfaktor multipliziert und in der zugehörigen Float-Variable gespeichert.
|
||
|
||
3. **Kommunikation**
|
||
- TCP-Verbindung zu `192.168.0.0:8899` (feste IP im Code).
|
||
- Der Aufruf von `readRegister()` baut ein „Out_Frame“ wie in Node-RED,
|
||
rechnet CRC16-Modbus über die letzten 6 Bytes, hängt eine Summen-Checksum + 0x15 an,
|
||
sendet das Paket, liest die Antwort, schneidet exakt 2 Daten-Bytes heraus und liefert sie zurück.
|
||
|
||
---
|
||
|
||
## Beispiel: Register 1476 („Gesamtproduktion“)
|
||
|
||
- **Register-Tabelle**
|
||
| Register‐Nummer | Bezeichnung | Skalierungsfaktor |
|
||
| --------------: | :------------------ | ----------------: |
|
||
| 1476 | Gesamtproduktion | 1 |
|
||
|
||
- **Ergebnis**
|
||
- Eine Float-Variable mit der Bezeichnung „Gesamtproduktion“ wird angelegt.
|
||
- Wenn der PollInterval auf `60` Sekunden steht, liest das Modul alle 60 Sekunden das Register 1476,
|
||
skaliert mit 1 und schreibt den numerischen Wert in `Reg1476`.
|
||
|
||
---
|
||
|
||
## Fehlersuche
|
||
|
||
- Falls die Variable „Vorheriger Wert“ immer denselben Wert liefert oder ein Lesefehler auftritt, prüfe bitte:
|
||
1. **Logger-Nummer**: Ist sie korrekt (Dezimal)?
|
||
2. **Netzwerk/Firewall**: Kann Symcon die Adresse `192.168.0.100:8899` erreichen?
|
||
3. **Debug-Ausgaben**:
|
||
– Öffne in der Konsole „Kernel-Log“ → Filter „SofarWechselrichter“.
|
||
– Dort werden WARNs und ERRs protokolliert, falls z. B. keine Antwort kommt oder das Datenpaket inkorrekt ist.
|
||
|
||
- Falls du andere Datentypen brauchst (z. B. INT16 für Register außerhalb 1160), definiere sie analog als separate Zeile:
|
||
– Trage die `Register‐Nummer` ein, gib als Skalierungsfaktor `1` (oder `0.1` etc.) an.
|
||
– Der absolute Rohwert wird stets als UINT16 interpretiert (0–65535).
|
||
– Solltest du negative INT16 benötigen, kannst du nachträglich einfach die Variable „Vorheriger Wert“ (Reg 1160)
|
||
als Beispiel nehmen und in einem Script umrechnen (Werte über 32767 → –32768 + Rest).
|
||
|
||
---
|
||
|
||
## Versionshistorie
|
||
|
||
- **1.0**
|
||
- Erstveröffentlichung:
|
||
• Zyklische Abfrage beliebiger Register in einer Matrix konfigurieren
|
||
• Automatische Anlage von Variablen für jeden Eintrag
|
||
• Spezieller „Vorheriger Wert“ (Register 1160 als INT16)
|
||
|
||
---
|
||
|
||
*Ende der Dokumentation.*
|