Skip to content

Latest commit

 

History

History
128 lines (93 loc) · 6.36 KB

README.md

File metadata and controls

128 lines (93 loc) · 6.36 KB
Raw

SDK Version Version
License Check Style Run Tests
Spenden Wunschliste

Hoymiles WiFi IO

Regelt die Kommunikation mit einem Hoymiles WiFi Wechselrichter.

Inhaltsverzeichnis

1. Funktionsumfang

  • Intervall-Abfragen aller relevanten Daten.
  • Schlafmodus der Instanz per Script, Aktion oder Variable möglich.
  • Abschaltbare unterdrückung von Fehlermeldungen, wenn Gerät nicht erreichbar ist.

2. Voraussetzungen

  • Symcon ab Version 7.0
  • Hoymiles Wechselrichter mit WiFi (integrierte DTU)

3. Software-Installation

Dieses Modul ist Bestandteil der Hoymiles WiFi-Library.

4. Einrichten der Instanzen in IP-Symcon

Unter 'Instanz hinzufügen' kann das 'Hoymiles WiFi IO'-Modul mithilfe des Schnellfilters gefunden werden.
- Weitere Informationen zum Hinzufügen von Instanzen in der Dokumentation der Instanzen

Es wird empfohlen eine Instanz des Configurator-Moduls anzulegen, die IO Instanz wird automatisch mit erzeugt.

Instanzen

Konfigurationsseite:

Name Typ Standardwert Beschreibung
Open boolean false Verbindung herstellen
Host string IP Adresse des Wechselrichters
Port integer 10081 TCP Port für die Kommunikation
RequestInterval integer 60 Abfrageintervall in Sekunden
SuppressConnectionError boolean true Fehlermeldungen unterdrücken wenn WR nicht erreichbar (*1)
StartVariableId integer 1 VariableId zum beenden des Schlafmodus
StopVariableId integer 1 VariableId zum starten des Schlafmodus
DayValue string Vergleichswert (JSON-Kodiert) zum beenden des Schlafmodus
NightValue string Vergleichswert (JSON-Kodiert) zum starten des Schlafmodus
(*1) siehe Schlafmodus

Konfiguration

Schlafmodus:

Die Wechselrichter schalten sich bei Dunkelheit automatisch ab; um Fehlermeldungen in Symcon zu vermeiden, ist per default die Option Fehlermeldungen unterdrücken aktiv.
Hierdurch können dann aber keine defekten Verbindungen mehr erkannt werden.

Alternativ kann er Schlafmodus der Instanz genutzt werden, um die Abfrage des Nachts zu pausieren.
Hierfür gibt es folgende Möglichkeiten:

  1. Location Control mit den Variablen für Sonnenauf- und Untergang
  2. Beliebige Integer Variablen mit dem Profil ~UnixTmestemp
  3. Beliebige Variablen mit Vergleichswert
  4. Aktionen, welche in beliebigen Ereignissen oder Ablaufplänen genutzt werden können
  5. Instanz-Funktionen HMSWIFI_SetInactive und HMSWIFI_SetActive

Varianten:

  1. Auswahl des Location Control, die Variablen für Schlafende und Start werden automatisch übernommen.
    Der Vergleich erfolgt mit der aktuellen Uhrzeit.
  2. Bei den Variablen für Schlafende und Start wurden Variablen mit dem Profil ~UnixTmestemp ausgewählt.
    Der Vergleich erfolgt mit der aktuellen Uhrzeit.
  3. Bei den Variablen für Schlafende und Start wurden Variablen mit einem anderen Profil als ~UnixTmestemp ausgewählt.
    Für den Vergleich müssen jeweils die Vergleichswerte eingestellt werden, welche für den Vergleich genutzt werden.
  4. Es existieren zwei Aktionen um den Schlafmodus zu aktiveren oder deaktivieren.
    Actions
  5. Über PHP-Scripte kann die Instanz mit den Befehlen HMSWIFI_SetInactive und HMSWIFI_SetActive Inaktiv und Aktiv geschaltet werden.

5. Statusvariablen und Profile

Es werden keine Statusvariablen und Profile angelegt.

6. PHP-Befehlsreferenz

bool HMSWIFI_RequestState(integer $InstanzID);

Abrufen der Daten vom Wechselrichter.

bool HMSWIFI_SetActive(integer $InstanzID);

Schlafmodus beenden, Abfrageintervall starten.

bool HMSWIFI_SetInactive(integer $InstanzID);

Schlafmodus starten, Abfrageintervall beenden.

7. Changelog

siehe Changelog der Hoymiles WiFi-Library.

8. Spenden

Die Library ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:

Wunschliste

9. Lizenz

CC BY-NC-SA 4.0