diff --git a/extensions/fronius-inverter/API Documentation/fronius operating instructions.md b/extensions/fronius-inverter/API Documentation/fronius operating instructions.md new file mode 100644 index 00000000000..234f374d4dc --- /dev/null +++ b/extensions/fronius-inverter/API Documentation/fronius operating instructions.md @@ -0,0 +1,4365 @@ +# Operating + +# Instructions + +**Fronius Datamanager 2.** + +**Fronius Datamanager Box 2.** + +###### 42,0426,0191,DE 028- + +**DE** Bedienungsanleitung + + + +## Inhaltsverzeichnis + +``` +Fronius IG, Fronius IG Plus, Fronius IG Plus V, Fronius CL: Antenne montieren und an- +``` +``` +Fronius IG USA, Fronius IG Plus USA, Fronius IG Plus V USA: Antenne montieren und +``` + + +- Allgemeine Informationen + - Allgemeines + - Allgemeines + - Verfügbare Ausführungen des Fronius Datamanager 2.0 + - Verwendbare DATCOM-Komponenten + - Voraussetzung für den Betrieb + - Erforderliche Wechselrichter-Software + - Hinweise zur Funkkennzeichnung + - Lieferumfang + - Verwendung der Klebeetiketten + - Konfigurationsbeispiele + - Datenvolumen berechnen + - Allgemeines + - Datenvolumen berechnen + - Generelle Informationen für den Netzwerk-Administrator + - Voraussetzungen + - Allgemeine Firewall Einstellungen + - Versenden von Servicemeldungen bei DSL Internet-Verbindung + - Fronius Solar.web nutzen und Servicemeldungen versenden + - Bedienelemente, Anschlüsse und Anzeigen + - Sicherheit + - Bedienelemente, Anschlüsse und Anzeigen + - Schematische Verschaltung der I/Os + - Technische Daten + - Technische Daten + - WLAN +- Fronius Datamanager 2.0 installieren + - Fronius Datamanager 2.0 in den Wechselrichter einsetzen + - Allgemeines + - Sicherheit + - Einsteckpositionen des Fronius Datamanager 2.0 + - WLAN Antenne montieren und anschließen + - Allgemeines + - schließen + - anschließen + - Fronius Datamanager 2.0 im Fronius Solar Net installieren + - Sicherheit + - Wechselrichter mit Fronius Datamanager 2.0 im Fronius Solar Net installieren + - Fronius Datamanager Box 2.0 im Fronius Solar Net installieren + - Verkabelung Fronius Solar Net + - Fronius Solar Net Teilnehmer + - Verkabelung der Fronius Solar Net Teilnehmer + - Voraussetzungen für die Solar Net Datenkabel + - Vorkonfektionierte Datenkabel + - Fronius Datamanager 2.0 installieren - Übersicht + - Sicherheit + - Erst-Inbetriebnahme mittels Web-Browser +- Verbindung zum Fronius Datamanager 2.0 herstellen + - Verbindung zum Fronius Datamanager 2.0 via Web-Browser + - Allgemeines + - Voraussetzungen + - Verbindung zum Fronius Datamanager 2.0 via Web-Browser herstellen + - Verbindung zum Fronius Datamanager 2.0 via Internet und Fronius Solar.web + - Allgemeines + - Funktionsbeschreibung + - Voraussetzungen + - Daten vom Fronius Datamanager 2.0 via Internet und Fronius Solar.web abrufen +- Aktuelldaten, Services und Einstellungen am Fronius Datamanager 2.0 + - Die Web-Seite des Fronius Datamanager 2.0 + - Web-Seite des Fronius Datamanager 2.0 - Übersicht + - Login + - Passwort zurücksetzen + - Das Menü Einstellungen + - Weitere Einstellmöglichkeiten + - Aktuelldaten am Fronius Datamanager 2.0 + - Aktuelle Vergleichsansicht + - Anlagenübersicht + - Ansicht Wechselrichter / Sensoren + - Services - Systeminformationen + - Systeminformationen + - Services - Netzwerkdiagnose + - Netzwerkdiagnose + - Services - Firmware-Update + - Allgemeines + - Automatisch nach Updates suchen + - Manuell nach Updates suchen + - Firmware-Update via Web ausführen + - Firmware-Update via LAN ausführen + - Services - Assistenten aufrufen + - Assistenten aufrufen + - Einstellungen - Allgemein + - Allgemein + - Einstellungen - Passwörter + - Allgemeines + - Passwörter + - Einstellungen - Netzwerk + - Internet via WLAN + - Internet via LAN + - Lokales Netzwerk via Access-Point + - Einstellungen - Fronius Solar.web + - Solar.web + - Speicherkapazität + - Speicherkapazität berechnen + - Berechnungsbeispiel + - Einstellungen - IO Zuordnung + - Allgemeines + - AUS - Demand Response Modes (DRM) + - IO-Steuerung + - Lastmanagement + - Einstellungen - Lastmanagement + - Allgemeines + - Lastmanagement + - Einstellungen - Push Service + - Push Service + - Einstellungen - Modbus + - Allgemeines + - Weitere Informationen zur Modbus-Funktion + - Datenausgabe über Modbus + - Steuerung einschränken + - Änderungen speichern oder verwerfen + - Einstellungen - Wechselrichter + - Wechselrichter + - Einstellungen - Fronius Sensor Cards + - Sensor Cards +- Einstellungen - Zähler + - Allgemeines + - Fronius Smart Meter + - Anschluss des Fronius Smart Meter am Fronius Datamanager 2.0 + - S0-Wechselrichter +- Einstellungen - EVU Editor + - Allgemeines + - EVU Editor - IO-Steuerung + - Anschluss-Schema - 4 Relais + - Anschluss-Schema - 3 Relais + - Anschluss-Schema - 1 Relais + - Anschluss-Schema - Alternative mit 2 Relais + - Awendungsbeispiel 2 Rundsteuer-Empfänger + - Rundsteuer-Empfänger mit mehreren Wechselrichtern verbinden + - EVU Editor - AUS - Demand Response Modes (DRM) + - EVU Editor - Dynamische Leistungsreduzierung + - EVU Editor - Steuerungs-Prioritäten + + + +## Allgemeine Informationen + + + +#### Allgemeines + +### Allgemeines + +**Allgemeines** Der Fronius Datamanager 2.0 ist ein netzwerkfähiger Datenlogger, der die Funk- +tionalität der Fronius Com Card, des Fronius Datalogger Web, der Fronius Power +Control Card und der Fronius Modbus Card auf einer Steckkarte vereint. +Die Web-Seite des Fronius Datamanager 2.0 liefert einen schnellen Überblick +über die Photovoltaik-Anlage. +Die Web-Seite kann mittels Web-Browser über eine Direktverbindung oder bei +entsprechender Konfiguration über das Internet aufgerufen werden. + +``` +In Verbindung mit Fronius Solar.web können aktuelle Daten und Archivdaten ei- +ner Photovoltaik-Anlage ohne aufwändige Konfigurationstätigkeiten über das In- +ternet oder die Fronius Solar.web App abgerufen werden. Die Daten werden vom +Fronius Datamanager 2.0 automatisch an das Fronius Solar.web versendet. Froni- +us Solar.web ist mit einer einfach zu konfigurierenden Anlagenüberwachung mit +automatischer Alarmierung ausgestattet. Die Alarmierung kann über SMS oder +E-Mail erfolgen. +``` +**Verfügbare +Ausführungen +des Fronius Da- +tamanager 2.** + +``` +Der Fronius Datamanager 2.0 ist in folgenden Ausführungen verfügbar: +``` +- ohne Fronius Com Card Funktion + (für die Wechselrichter Fronius Galvo, Fronius Symo und Fronius Primo) +- mit Fronius Com Card Funktion + (für die Wechselrichter Fronius IG, Fronius IG Plus, Fronius IG Plus V, + Fronius IG Plus A, Fronius CL, Fronius CL USA, Fronius IG 300 - 500) +- in einem externen Gehäuse mit Solar Net IN und Solar Net OUT Anschluss + (Fronius Datamanager Box 2.0, z. B. für Wechselrichter ohne Steckkarten- + plätze oder für Photovoltaik-Anlagen mit einem separaten Fronius Datama- + nager 2.0) + +``` +Sofern der Wechselrichter nicht serienmäßig mit dem Fronius Datamanager 2. +ausgestattet ist, können bestehende Wechselrichter mit der Fronius Datamana- +ger 2.0 Steckkarte nachgerüstet werden. +``` +#### Verwendbare DATCOM-Komponenten + +**DATCOM-Kom- +ponenten** + +``` +Die im Wechselrichter eingebaute Fronius Datamanager 2.0 Steckkarte oder die +separate Fronius Datamanager Box 2.0 kann mit folgenden DATCOM-Komponen- +ten betrieben werden: +``` +- bis zu +100 + +``` +x Fronius-Wechselrichter +(inkl. dem Wechselrichter, in dem der Fronius Datama- +nager 2.0 eingebaut ist) +``` +- bis zu 10 x Fronius Sensor Card oder Fronius Sensor Box +- bis zu 10 x Fronius Public Display Card oder Fronius Public Display + Box +- bis zu 1 x Fronius Interface Card oder Fronius Interface Box +- bis zu +200 + +``` +x Fronius String Control +``` + +#### Voraussetzung für den Betrieb + +``` +Für einen einwandfreien Datenaustausch via Internet ist eine entsprechende In- +ternet-Verbindung erforderlich: +``` +- Bei Kabel-gebundenen Internet-Lösungen empfiehlt Fronius eine Download- + Geschwindigkeit von min. 512 kBit/s und eine Upload-Geschwindigkeit von + min. 256 kBit/s. +- Für Lösungen mit mobilen Internet-Diensten empfiehlt Fronius min. 3G + Übertragungsstandard mit zuverlässiger Signalstärke. + +``` +Diese Angaben stellen keine absolute Garantie für eine einwandfreie Funktion +dar. +Hohe Fehlerraten in der Übertragung, Empfangsschwankungen oder Übertra- +gungsaussetzer können den Online-Betrieb des Fronius Datamanager 2.0 negativ +beeinflussen. +Fronius empfiehlt, Verbindungen mit Mindestanforderungen vor Ort zu testen. +``` +``` +Für den Betrieb mit einer Antennenverlängerung +Wenn Sie Ihre(n) Wechselrichter mittels WLAN mit dem Internet verbinden wol- +len, empfehlen wir folgende Vorgehensweise: +``` +- Testen Sie Ihre Signalstärke an der genauen Position, an der der Wechsel- + richter mit aktivierter Datamanager 2.0 Karte installiert wird. +- Stellen Sie mittels Smartphone, Laptop oder Tablet eine Verbindung zum + WLAN-Netzwerk her und testen Sie die Verbindung. + Durch Aufrufen der kostenlosen Web-Seite "www.speedtest.net" kann + überprüft werden, ob die Verbindung unsere empfohlene Download-Ge- + schwindigkeit von mindestens 512 kbit/s und eine Upload-Geschwindigkeit + von 256 kbit/s erfüllt. + +``` +Da der Fronius Datamanager 2.0 als Datalogger fungiert, darf kein anderer Da- +tenlogger im Fronius Solar Net Ring sein. +Pro Fronius Solar Net Ring darf nur ein Fronius Datamanager 2.0 enthalten sein. +Eventuell in den Wechselrichtern Fronius Galvo und Fronius Symo vorhandene +Fronius Datamanager 2.0 müssen sich im Slave-Modus befinden. +``` +``` +Folgende DATCOM-Komponenten dürfen nicht gemeinsam mit dem Fronius Da- +tamanager 2.0 in einem Fronius Solar Net Ring betrieben werden: +``` +- Fronius Power Control Card / Box +- Fronius Modbus Card +- Fronius Datalogger Web +- Fronius Personal Display DL Box +- Fronius Datalogger easy / pro +- Fronius Datamanager + +#### Verfügbare Ausführungen des Fronius Datamanager 2.0 + +``` +Für den Betrieb des Fronius Datamanager 2. +``` +- muss die Steckkarte in einem Wechselrichter eingebaut sein, + oder +- eine Fronius Datamanager Box 2.0 muss sich im Fronius Solar Net Ring be- + finden. + +``` +Die Fronius Datamanager 2.0 Steckkarte und die Fronius Com Card dürfen nicht +gemeinsam in einem Wechselrichter betrieben werden. +``` +#### Erforderliche Wechselrichter-Software + +``` +Der Betrieb des Fronius Datamanager 2.0 erfordert folgende Versionen der +Wechselrichter-Software: +``` + +``` +Wechselrichter +``` +``` +erforderliche Software-Version laut Display +(MainControl) +Fronius IG 15 - 60 V2.9.4 oder höher +Fronius IG 2000 - +5100 +``` +``` +ab Serien-Nr. 19153444 +``` +``` +Fronius IG 300 - 500 V3.6.4.0 oder höher +Fronius IG Plus 35 - +150 +``` +``` +V4.22.00 oder höher +``` +``` +Fronius IG-TL * - +Fronius CL V4.22.00 oder höher +Fronius Agilo * - +Fronius Agilo Out- +door * +``` +###### - + +``` +Fronius Agilo TL * - +Fronius Galvo - +Fronius Symo - +Fronius Symo Hybrid - +Fronius Primo - +Fronius Eco - +``` +``` +* Nur in Verbindung mit Fronius Datamanager Box 2. +``` +``` +Die jeweilige Version der Wechselrichter-Software finden Sie zum kostenlosen +Download auf unserer Homepage unter http://www.fronius.com. +``` +``` +Bei weiteren Fragen wenden Sie sich bitte an pv-support@fronius.com. +``` +#### Hinweise zur Funkkennzeichnung + +**Funkkennzeich- +nung** + +``` +Die Fronius Datamanager 2.0 Steckkarte und die Fronius Datamanager Box 2. +sind mit einem Funkmodul ausgestattet. +``` +``` +Funkmodule unterliegen in den USA der Kennzeichnungspflicht nach FCC: +``` + +###### FCC + +``` +Dieses Gerät entspricht den Grenzwerten für ein digitales Gerät +der Klasse B gemäß Teil 15 der FCC-Bestimmungen. Diese Grenz- +werte sollen einen angemessenen Schutz vor schädlichen Störun- +gen in Wohnräumen bieten. Dieses Gerät erzeugt und verwendet +Hochfrequenz-Energie und kann im Funkverkehr Störungen verur- +sachen, wenn es nicht in Übereinstimmung mit den Anweisungen +verwendet wird. Es gibt jedoch keine Garantie, dass Störungen in +einer bestimmten Installation nicht auftreten. +Wenn dieses Gerät Störungen des Radio-oder Fernsehempfanges +verursacht, die durch Aus- und Einschalten des Geräts festgestellt +werden können, wird dem Benutzer empfohlen, die Störungen +durch eine oder mehrere der folgenden Maßnahmen zu beheben: +``` +- Richten Sie die Empfangsantenne aus oder positionieren Sie + die Empfangsantenne anders. +- Erhöhen Sie den Abstand zwischen Gerät und Empfänger. +- Schließen Sie das Gerät an einem anderen Stromkreis an, an + dem der Empfänger nicht angeschlossen ist. +- Für weitere Unterstützung kontaktieren Sie den Händler oder + einen erfahrenen Radio / TV -Techniker. + +``` +FCC ID: PV7-WIBEAR11N-DF +``` +``` +Industry Canada RSS +``` +``` +Dieses Gerät entspricht den lizenzfreien Industry Canada RSS +Normen. Der Betrieb unterliegt folgenden Bedingungen: +(1) Das Gerät darf keine schädlichen Störungen verursachen +(2) Das Gerät muss jede erhaltene Störbeeinflussung verkraften, +einschließlich Störbeeinflussungen, die zu einer Beeinträchtigung +des Betriebes führen können. +``` +``` +IC ID: 7738A-WB11NDF +``` +``` +Sofern vom Hersteller nicht ausdrücklich genehmigt sind Änderungen oder Mo- +difikationen des Funkmoduls nicht erlaubt und führen zum Verlust der Betriebs- +berechtigung des Gerätes durch den Benutzer. +``` +**Lieferumfang Fronius Datamanager 2.0 Steckkarte** + +- 1 x Fronius Datamanager 2.0 Steckkarte +- 1 x Fronius Solar Net Endstecker +- 1 x Stecker 16-polig +- 1 x Klebeetikette FCC, 3-teilig + +``` +Zusätzlich je nach Wechselrichter: +``` +- 1 x Antenne +- 1 x Fronius Solar Net Endstecker + +``` +Fronius Galvo +Fronius Symo +Fronius Primo +``` +- 1 x Antenne +- 1 x 1 m Antennenkabel RG +- 1 x Befestigungswinkel +- 1 x Doppelklebeband + +``` +Fronius IG +Fronius IG Plus +Fronius IG Plus V +``` + +- 1 x Antenne +- 1 x 3 m Antennenkabel RG +- 1 x Befestigungswinkel +- 1 x Doppelklebeband + +``` +Fronius IG 300 - 500 +Fronius CL +Fronius CL - USA +``` +- 1 x Antenne +- 1 x 0,4 m Antennenkabel RG +- 1 x 3/4 in. Verschraubung +- 1 x 3/4 in. Sechskant-Mutter +- 1 x 3/4 in. Dichtung + +``` +Fronius IG 2000 - 5100 - USA +Fronius IG Plus - USA +Fronius IG Plus V - USA +``` +``` +Fronius Datamanager Box 2. +``` +- 1 x Fronius Datamanager Box 2.0 mit Wandhalterung +- 2 x Fronius Solar Net Endstecker +- 1 x Stecker 16-polig +- 1 x Antenne +- 1 x 3 m Antennenkabel RG +- 1 x Befestigungswinkel +- 1 x Doppelklebeband +- 2 x Montagedübel + Schrauben +- 1 x Beiblatt DATCOM-Verkabelung + +#### Verwendung der Klebeetiketten + +``` +WICHTIG! Sofern die im Lieferumfang des Datamanager 2.0 enthaltene 3-teilige +Klebeetikette nicht schon werksseitig aufgeklebt wurde, muss diese am Wechsel- +richter aufgeklebt werden. +``` +``` +Position der Klebeetikette am Wechselrichter: +``` +``` +Fronius IG +``` +``` +Fronius IG Plus +Fronius IG Plus V +Fronius IG Plus A +``` +``` +Fronius Galvo +Fronius Symo +Fronius Primo +``` +``` +Bei den Wechselrichter Fronius Galvo, Fronius Symo und Fronius Primo ist die +Information der Klebeetikette am Leistungsschild enthalten. +``` +``` +Verwendung der Klebeetiketten: +(1) (2) (3) (1) An der Kartonverpackung von +Wechselrichter oder Fronius +Datamanager 2. +(2) An der Fronius Datamanager +2.0 Steckkarte +(3) Am Wechselrichter +``` + +**Konfigurations- +beispiele** + +``` +Wechselrichter mit Fronius Datamanager 2.0 Steckkarte vernetzt mit einem +PC: +``` +``` +IN +``` +###### (1) + +###### (2) + +###### (3) + +###### (4) + +``` +WLAN +OUT +``` +(^) (1) Wechselrichter +(2) Fronius Datamanager 2. +(3) Fronius Solar Net Endstecker +(4) PC / Laptop +**WICHTIG!** Bei Vernetzung eines Wechselrichters mit Fronius Datamanager 2. +mit einem PC muss an jedem freien IN- oder OUT-Anschluss je ein Fronius Solar +Net Endstecker angesteckt sein. +**Wechselrichter mit Fronius Datamanager 2.0 Steckkarte vernetzt mit weite- +ren Wechselrichtern, einer Fronius Sensor Box und einem PC:** +IN +IN +IN +OUT +OUT +IN OUT + +###### (1) + +###### (6) + +###### (4) (7) + +###### (2) + +###### (3) + +###### (5) (8) + +``` +LAN / WLAN +``` +###### (9) + +``` +(1) Wechselrichter mit +(2) Fronius Datamanager 2. +(3) PC / Laptop +(4) Wechselrichter mit +(5) Fronius Com Card +``` +(^) (6) Fronius Sensor Box +(7) Wechselrichter +(8) Fronius Com Card +(9) Fronius Solar Net Endstecker +Bei einer Vernetzung von mehreren DATCOM-Komponenten in Verbindung mit +einem Fronius Datamanager 2.0: +mit dem Datenkabel den IN-Anschluss des Fronius Datamanager 2.0 und den +OUT-Anschluss der nächsten DATCOM-Komponente verbinden. Am freien IN- +Anschluss der letzten DATCOM-Komponente muss ein Fronius Solar Net End- +stecker angesteckt sein. +Bei folgenden Wechselrichtern muss der Wechselrichter mit dem Fronius Data- + + +manager 2.0 dabei immer am Anfang oder am Ende der Datenkette sein: +Fronius IG, Fronius IG Plus, Fronius IG Plus V, Fronius IG Plus A, Fronius CL, +Fronius CL USA, und Fronius IG 300 - 500. + +``` +2 Wechselrichter mit Fronius Com Card oder Com Card Funktion vernetzt mit +einer Fronius Datamanager Box 2.0 und einem Smartphone : +``` +``` +B AIP +``` +``` +Fronius +Datamanager Box 2. +``` +``` +IN +``` +``` +OUT +IN OUT +``` +### = + +### ~ + +``` +IN +``` +``` +OUT +``` +### = + +### ~ + +``` +WLAN +``` +###### (1) (2) + +``` +Fronius +Solar.web App +``` +###### (3) + +###### (4) + +###### (5) + +###### (5) + +``` +(1) Wechselrichter mit Fronius +Com Card oder Com Card +Funktion +(2) Wechselrichter mit Fronius +Com Card oder Com Card +Funktion +(3) Fronius Datamanager Box 2. +``` +(^) (4) Smartphone mit Fronius So- +lar.web App +(5) Fronius Solar Net Endstecker +Bei einer Vernetzung von mehreren DATCOM-Komponenten in Verbindung mit +einer Fronius Datamanager Box 2.0, muss die Verkabelung der DATCOM-Kompo- +nenten jeweils vom IN-Anschluss zum OUT-Anschluss der nächsten DATCOM- +Komponente erfolgen. +An freien IN-oder OUT-Anschlüssen der letzten DATCOM-Komponenten müssen +Fronius Solar Net Endstecker angesteckt sein. + + +#### Datenvolumen berechnen + +### Datenvolumen berechnen + +**Allgemeines** Beim Betrieb des Fronius Datamanager 2.0 fallen Daten an, die über das Internet +übertragen werden müssen. +Die Berechnung des Datenvolumens ist für die Auswahl eines entsprechenden +Internet-Anschlusses erforderlich. + +**Datenvolumen +berechnen** + +``` +Die folgenden Angaben dienen zur Berechnung des Datenvolumens pro Monat +beim Betrieb des Fronius Datamanagers 2.0. +``` +``` +Stündlicher Upload +``` +``` +bis Firmware- +Version 3. +``` +``` +ab Firmware- +Version 3.25. +Gesamt 8 MB 350 MB ++ für jeden weiteren Fronius Wechselrichter 5 MB ++ für jeden weiteren Fronius Smart Meter 7 MB +``` +``` +Täglicher/Wöchentlicher Upload +(ohne Nacht Modus) +``` +``` +bis Firmware- +Version 3. +``` +``` +ab Firmware- +Version 3.25. +Gesamt 307 kB 350 MB ++ für jeden weiteren Fronius Wechselrichter 520 kB ++ für jeden weiteren Fronius Smart Meter 769 kB +``` +``` +Täglicher/Wöchentlicher Upload +(mit aktiven Nacht Modus) +``` +``` +bis Firmware- +Version 3. +``` +``` +ab Firmware- +Version 3.25. +Gesamt 100 kB 350 MB ++ für jeden weiteren Fronius Wechselrichter 520 kB ++ für jeden weiteren Fronius Smart Meter 769 kB +``` +``` +Berechnung der Speichersektoren pro Tag gemäß Kapitel „Speicherkapazität be- +rechnen“ auf Seite 64. +``` +``` +Das Datenvolumen kann sich durch folgende Faktoren erhöhen: +``` +- Verbindungsabbrüche +- Neustart des Wechselrichters +- Firmware-Updates +- Fernsteuerung (VPP, Cloud Control) +- Fehlerdiagnose durch den technischen Support +- Anlagen-Fernüberwachung via Solar.web + +``` +WICHTIG! Fronius empfiehlt eine Flatrate, um Kosten für Datenmengen, die in +der Vorberechnung nicht berücksichtigt wurden, zu vermeiden. +``` + +### Generelle Informationen für den Netzwerk-Administrator + +### nistrator + +**Voraussetzun- +gen** + +``` +Die Netzwerk-Konfiguration des Fronius Datamanager 2.0 setzt Kenntnisse aus +der Netzwerk-Technologie voraus. +``` +``` +Wird der Fronius Datamanager 2.0 in ein bestehendes Netzwerk integriert, muss +die Adressierung des Fronius Datamanager 2.0 an die des Netzwerkes angepasst +werden. +``` +``` +z. B.: Netzwerk-Adressbereich = 192.168.1.x, Subnet-Mask = 255.255.255. +``` +- Dem Fronius Datamanager 2.0 muss eine IP-Adresse zwischen 192.168.1. + und 192.168.1.254 zugewiesen werden. +- Die gewählte IP-Adresse darf im Netzwerk noch nicht in Verwendung sein. +- Die Subnet-Mask muss dem bestehenden Netzwerk entsprechen (z. B. + 255.255.255.0). + +``` +Soll der Fronius Datamanager 2.0 Servicemeldungen versenden oder Daten an +Fronius Solar.web senden, muss eine Gateway-Adresse und eine DNS-Server +Adresse eingegeben werden. Über die Gateway-Adresse bekommt der Fronius +Datamanager 2.0 eine Verbindung zum Internet. Als Gateway-Adresse eignet +sich z. B. die IP-Adresse des DSL-Routers. +``` +``` +WICHTIG! +``` +- Der Fronius Datamanager 2.0 darf nicht die selbe IP-Adresse wie der PC / + Laptop haben! +- Der Fronius Datamanager 2.0 kann sich nicht selbst ins Internet verbinden. + Bei einem DSL-Anschluss muss ein Router die Verbindung ins Internet auf- + bauen. + +**Allgemeine Fire- +wall Einstellun- +gen** + +``` +DSL-Router ermöglichen zumeist den Versand von Daten ins Internet und +müssen daher normalerweise nicht konfiguriert werden. +``` +``` +Server-Adressen für die Datenübertragung +In Fall der Verwendung einer Firewall für ausgehende Verbindungen müssen die +nachfolgenden Protokolle, Server-Adressen und Ports für die erfolgreiche Da- +tenübertragung erlaubt sein: +``` +- Tcp fronius-se-iot-dm-1.azure.devices.net: +- Tcp fronius-se-iot-dm-1.azure.devices.net: +- Tcp fronius-se-iot-dm-2.azure.devices.net: +- Tcp fronius-se-iot-dm-2.azure.devices.net: +- Tcp fronius-se-iot-dm-1.telemetry.azure.devices.net: +- Tcp fronius-se-iot-dm-1.telemetry.azure.devices.net: +- Tcp fronius-se-iot-dm-2.telemetry.azure.devices.net: +- Tcp fronius-se-iot-dm-2.telemetry.azure.devices.net: +- Fdmp-solarweb.com:49049 (dm local port 54321) +- Tcp [http://www3.fronius.com:](http://www3.fronius.com:) +- Tcp [http://firmware-download.fronius.com:](http://firmware-download.fronius.com:) +- Tcp ftp://transfer.fronius.com: +- Tcp provisioning-lite.solarweb.com: +- Tcp froniusseiot.blob.core.windows.net: +- Upd/Tcp 0.time.fronius.com: + + +``` +Falls bestehende Firewall-Regeln die Verbindung zur Fronius Anlagenüberwa- +chung blockieren, müssen folgende Firewall-Regeln ergänzt werden: +``` +###### 49049/UDP + +``` +Ausgang +``` +###### 80/TCP *) + +``` +Eingang +Servicemeldungen versenden x - +Verbindung zum Datamanager via Fronius So- +lar.web +x - +``` +``` +Verbindung zum Datamanager via Fronius So- +lar.access oder Fronius Solar.service +``` +- x + +``` +Zugriff auf die Web-Seite des Datamanagers - x +``` +``` +Die Firewall so konfigurieren, dass die IP-Adresse der Fronius Anlagenüberwa- +chung an Port 49049/UDP von „fdmp.solarweb.com“ Daten schicken kann. +``` +``` +*) Wir empfehlen den Zugriff auf die Web-Schnittstelle der Fronius Anla- +genüberwachung nur von gesicherten Netzwerken zuzulassen. Sollte ein Zugriff +aus dem Internet unbedingt benötigt werden (z. B.: für Servicezwecke in einem +begrenzten Zeitraum), den Netzwerkrouter so konfigurieren, dass Anfragen auf +einen beliebigen externen Port auf den Port 80/TCP weitergeleitet werden. +Vorsicht - der Wechselrichter ist damit im Internet sichtbar und es wird mit ho- +her Wahrscheinlichkeit zu Netzwerkangriffen kommen. +``` +**Versenden von +Servicemeldun- +gen bei DSL In- +ternet-Verbin- +dung** + +``` +Bei einer herkömmlichen DSL Internet-Verbindung sind Fronius Solar.web und +das Versenden von Servicemeldungen zumeist ohne extra Konfiguration des Rou- +ters möglich, da Verbindungen vom LAN zum Internet offen sind. +``` +**Fronius So- +lar.web nutzen +und Servicemel- +dungen versen- +den** + +``` +Für die Nutzung von Fronius Solar.web oder das Versenden von Servicemeldun- +gen muss eine Internet-Verbindung bestehen. +``` +``` +Der Fronius Datamanager 2.0 kann sich nicht selbst ins Internet verbinden. Bei +einem DSL-Anschluss muss ein Router die Verbindung ins Internet aufbauen. +``` + +### Bedienelemente, Anschlüsse und Anzeigen + +#### Sicherheit + +###### WARNUNG! + +``` +Gefahr durch Fehlbedienung. +Schwerwiegende Personen- und Sachschäden möglich. +▶ Beschriebene Funktionen erst anwenden, wenn diese Bedienungsanleitung +vollständig gelesen und verstanden wurde. +▶ Beschriebene Funktionen erst anwenden, wenn sämtliche Bedienungsanlei- +tungen der Systemkomponenten, insbesondere Sicherheitsvorschriften +vollständig gelesen und verstanden wurden! +``` + +#### Bedienelemente, Anschlüsse und Anzeigen + +###### (5) + +###### (1) + +###### (2) (3) + +###### (6) + +###### (7) + +###### (8) + +###### (9) + +###### (7) + +###### (11) + +###### (9) + +###### (8) + +###### (6) + +###### (10) + +``` +Fronius Galvo +Fronius Symo +Fronius Primo +``` +``` +Fronius IG +Fronius IG Plus +Fronius IG Plus V +Fronius IG Plus A +Fronius CL +Fronius CL USA +Fronius IG 300 - 500 +``` +###### (1) (6) + +###### (13) + +###### (7) (9) (12)(11)(8) + +###### (4) + +###### (5) (2) + +###### (4) (3) + +``` +Nr. Funktion +(1) Schalter IP +zum Umschalten der IP-Adresse: +``` + +**Nr. Funktion** + +A vorgegebene IP-Adresse und Öffnen des WLAN Access Point + +``` +Für eine direkte Verbindung mit einem PC via LAN arbeitet der Fro- +nius Datamanager 2.0 mit der fixen IP-Adresse 169.254.0.180. +``` +``` +Befindet sich der Schalter IP in Position A wird zusätzlich ein Ac- +cess Point für eine direkte WLAN Verbindung zum Fronius Datama- +nager 2.0 geöffnet. +``` +``` +Zugangsdaten zu diesem Access Point: +Netzwerk-Name: FRONIUS_240.XXXXXX +Schlüssel: 12345678 +``` +``` +WICHTIG! +Bei Fronius Datamanager 2.0 Steckkarten, die nach Juni 2024 ge- +kauft wurden, individuelles Passwort vom Display des Wechselrich- +ters eingeben. +``` +``` +Der Zugriff auf den Fronius Datamanager 2.0 ist möglich: +``` +- per DNS-Name „http://datamanager“ +- mittels IP-Adresse 169.254.0.180 für die LAN Schnittstelle +- mittels IP-Adresse 192.168.250.181 für den WLAN Access + Point + +B zugewiesene IP-Adresse + +``` +Der Fronius Datamanager 2.0 arbeitet mit einer zugewiesenen IP- +Adresse Werkseinstellung dynamisch (DHCP) +``` +``` +Die IP-Adresse kann auf der Web-Seite des Fronius Datamanager +2.0 eingestellt werden. +``` +``` +Der Schalter IP befindet sich bei den Fronius Datamanager 2.0 +Steckkarten unterhalb der LEDs und ist bei der Fronius Datamana- +ger Box 2.0 separat ausgeführt. +``` +**(2) LED WLAN** + +- blinkt grün: der Fronius Datamanager 2.0 befindet sich im Ser- + vice-Modus + (Schalter IP an der Fronius Datamanager 2.0 Steckkarte ist in + Position A oder der Service-Modus wurde über das Wechsel- + richter-Display aktiviert, der WLAN Acces Point ist geöffnet) +- leuchtet grün: bei bestehender WLAN-Verbindung +- blinkt abwechselnd grün/rot: Überschreitung der Zeit, wie lang + der WLAN Access Point nach dem Aktivieren geöffnet ist (1 + Stunde) +- leuchtet rot: bei nicht bestehender WLAN-Verbindung +- blinkt rot: fehlerhafte WLAN-Verbindung +- leuchtet nicht, wenn sich der Fronius Datamanager 2.0 im + Slave-Modus befindet + +**(3) LED Verbindung Solar.web** + +- leuchtet grün: bei bestehender Verbindung zu Fronius Solar.web +- leuchtet rot: bei erforderlicher, aber nicht bestehender Verbin- + dung zu Fronius Solar.web +- leuchtet nicht: wenn keine Verbindung zu Fronius Solar.web er- + forderlich ist + + +**Nr. Funktion** + +**(4) LED Versorgung** + +- leuchtet grün: bei ausreichender Stromversorgung durch das + Fronius Solar Net; Der Fronius Datamanager 2.0 ist betriebsbe- + reit. +- leuchtet nicht: bei mangelhafter oder nicht vorhandener Strom- + versorgung durch das Fronius Solar Net - eine externe Strom- + versorgung ist erforderlich + oder + wenn sich der Fronius Datamanager 2.0 im Slave-Modus befin- + det +- blinkt rot: während eines Update-Vorganges + +``` +WICHTIG! Während eines Update-Vorganges die Stromversor- +gung nicht unterbrechen. +``` +- leuchtet rot: der Update-Vorgang ist fehlgeschlagen + +**(5) LED Verbindung** + +- leuchtet grün: bei aufrechter Verbindung innerhalb des ‘Fronius + Solar Net’ +- leuchtet rot: bei unterbrochener Verbindung innerhalb des ‘Fro- + nius Solar Net’ +- leuchtet nicht, wenn sich der Fronius Datamanager 2.0 im + Slave-Modus befindet + +**(6) Anschluss LAN** +Ethernet-Schnittstelle mit blauer Farbmarkierung, zum Anschließen +des Ethernet-Kabels + +**(7) I/Os** +digitale Ein- und Ausgänge + +(^97531) - - D- +8 6 4 2 0 + + D+ +I IO RS485 +**Modbus RTU 2-Draht (RS485):** +D- Modbus Daten - +D+ Modbus Daten + + + +**Nr. Funktion** + +``` +Int./ext. Versorgung +``` +- GND ++ Uint / Uext + Ausgang der internen Spannung 10,8 V / 12,8 V + oder + Eingang für eine externe Versorgungsspannung + >12,8 - 24 V DC (+ 20 %) + +###### 10,8 V: + +``` +Fronius IG, Fronius IG Plus, Fronius IG Plus V, +Fronius IG Plus A, Fronius CL, Fronius CL USA, +Fronius IG 300 - 500 +``` +###### 12, 8 V: + +``` +Fronius Galvo, Fronius Symo +``` +``` +Digitale Eingänge: 0 - 3, 4 - 9 +Spannungspegel: low = min. 0 V - max. 1,8 V; high = min. 3 V - max. +24 V Dc (+ 20 %) +Eingangsströme: je nach Eingangsspannung; Eingangswiderstand = +46 kOhm +``` +``` +Digitale Ausgänge: 0 - 3 +Schaltvermögen bei Versorgung durch die Fronius Datamanager 2.0 +Steckkarte: 3,2 W, 10,8 / 12,8 V in Summe für alle 4 digitalen +Ausgänge +``` +``` +10,8 V: +Fronius IG, Fronius IG Plus, Fronius IG Plus V, Fronius IG Plus A, +Fronius CL, Fronius CL USA, Fronius IG 300 - 500 +``` +``` +12, 8 V: +Fronius Galvo, Fronius Symo +``` +``` +Schaltvermögen bei Versorgung durch ein externes Netzteil mit min. +12,8 - max. 24 V DC (+ 20 %), angeschlossen an Uint / Uext und +GND: 1 A, 12,8 - 24 V DC (je nach externem Netzteil) pro digitalem +Ausgang +``` +``` +Der Anschluss an die I/Os erfolgt über den mitgelieferten Gegen- +stecker. +``` +**(8) Antennensockel** +zum Aufschrauben der WLAN Antenne oder des WLAN Antennen- +Verlängerungskabels, je nach Wechselrichter + + +**Nr. Funktion** + +**(9) Schalter Modbus-Terminierung (für Modbus RTU)** +interner Busabschluss mit 120 Ohm Widerstand (ja/nein) + +``` +Schalter in Position „on“: Abschluss-Widerstand 120 Ohm aktiv +Schalter in Position „off“: kein Abschluss-Widerstand aktiv +``` +``` +WICHTIG! In einem RS485 Bus muss der Abschluss-Widerstand +beim ersten und letzten Gerät aktiv sein. +``` +**(10) Fronius Solar Net Master / Slave Schalter** +zum Umschalten von Master- auf Slave-Betrieb innerhalb eines Fro- +nius Solar Net Ringes + +``` +WICHTIG! Im Slave-Betrieb sind alle LEDs an der Fronius Datama- +nager 2.0 Steckkarte aus. +``` +**(11) Anschluss Solar Net IN** +Fronius Solar Net Eingang mit roter Farbmarkierung, für die Verbin- +dung mit anderen DATCOM-Komponenten (z. B. Wechselrichter, +Sensorkarten, etc.) + +``` +Nur bei Fronius Datamanager 2.0 mit Fronius Com Card Funktion! +(für die Wechselrichter Fronius IG, Fronius IG Plus, Fronius IG Plus +V, Fronius IG Plus A, Fronius CL, Fronius CL USA, Fronius IG 300 - +500) +``` +**(12) Anschluss Solar Net OUT** +Fronius Solar Net Ausgang mit roter Farbmarkierung, für die Verbin- +dung mit anderen DATCOM-Komponenten (z.B. Wechselrichter, +Sensorkarten, etc.) + +``` +Nur bei Fronius Datamanager Box 2.0! +``` +**(13) Anschluss externe Stromversorgung** +zum Anschließen einer externen Stromversorgung, wenn die Strom- +versorgung innerhalb des Fronius Solar Net nicht ausreicht (z. B. +wenn sich zu viele DATCOM-Komponenten im Fronius Solar Net be- +finden). + +``` +WICHTIG! Für eine externe Stromversorgung der Fronius Datama- +nager Box 2.0 muss das Netzteil eine sichere Trennung gegenüber +Netzspannungs-führenden Teilen aufweisen (SELV oder Class 2 für +USA / Canada). +Die Ausgangsleistung des Netzteils darf max. 15 VA / 1,25 A betra- +gen. +Bei ausreichender Stromversorgung leuchtet die LED Versorgung (4) +grün. +Für eine externe Stromversorgung ausschließlich das Fronius-Netz- +gerät verwenden! +``` +``` +Nur bei Fronius Datamanager Box 2.0! +``` + +#### Schematische Verschaltung der I/Os + +``` +Versorgung durch die Fronius Datamanager 2.0 Steckkarte: +``` +###### (1) 115 - 230 V AC + +``` +12 V DC +``` +``` +10,7 / 12,8 V DC +``` +``` +(2) 300 mA +``` +###### (3) + +``` +D- - - +``` +``` +D+ + + 0 2 +``` +``` +5 7 +``` +``` +8 +``` +``` +93 +``` +``` +4 6 +``` +``` +1 +``` +``` +(1) Netzteil +(nur bei Fronius Datamanager 2.0 mit Fronius Com Card Funktion) +(2) Strombegrenzung +(3) Anschluss Solar Net IN +``` +###### 115 - 230 V AC: + +``` +Fronius IG, Fronius IG Plus, Fronius IG Plus V, Fronius IG Plus A, Fronius CL, +Fronius CL USA, Fronius IG 300 - 500 +``` +``` +12,8 V DC: +Fronius Galvo, Fronius Symo, Fronius Primo +``` +``` +Versorgung durch ein externes Netzteil: +``` +``` +D- - - +``` +``` +D+ + + 0 2 +``` +``` +5 7 +``` +``` +8 +``` +``` +93 +``` +``` +4 6 +``` +``` +1 +``` +###### (4) + +###### (5) + +###### (6) + +###### 10,7 / 12,8 - 24 V DC + +``` +(4) externes Netzteil +(5) Last +(6) Schalter +``` +``` +Bei Versorgung durch ein externes Netzteil muss das externe Netzteil galvanisch +getrennt sein. +``` + +###### 10,7 V DC: + +Fronius IG, Fronius IG Plus, Fronius IG Plus V, Fronius IG Plus A, Fronius CL, +Fronius CL USA, Fronius IG 300 - 500 + +12, 8 V DC: +Fronius Galvo, Fronius Symo, Fronius Primo + + +#### Technische Daten + +### Technische Daten + +**Technische Da- +ten** + +``` +Speicherkapazität bis zu 4096 Tage +Versorgungsspannung +mit Fronius Com Card Funktion +ohne Fronius Com Card Funktion +``` +###### 115 - 230 V AC + +###### 12 V DC + +``` +Energieverbrauch < 2 W +Abmessungen +``` +``` +Steckkarte +``` +``` +Box +``` +``` +132 x 103 x 22 mm +5.2 x 4.1 x 0.9 in. +``` +``` +190 x 114 x 53 mm +4.69 x 4.49 x 2.09 in. +Schutzart (Box) IP 20 +Anschluss externe Versorgung (Box) 12 V DC, max. 1 A, Class 2 +Kabelquerschnitt für Anschluss exter- +ne Versorgung (Box) +``` +``` +0,13 - 1,5 mm² +AWG 16 - 24 (USA / Canada) +Ethernet (LAN) RJ 45, 100 MBit +WLAN IEEE 802.11b/g/n Client +RS 422 (Fronius Solar Net) RJ 45 +Umgebungstemperatur +``` +``` +Steckkarte +``` +``` +Box +``` +###### -20 - +65 ° C + +###### -4 - +149 °F + +###### 0 - 50 ° C + +###### 32 - 122 °F + +``` +Solar Net Leistung ca. 3 W +max. 3 DATCOM-Komponenten * +I/O Anschuss-Spezifikationen +``` +``` +Spannungspegel digitale Eingänge low = min. 0 V - max. 1,8 V +high = min. 3 V - max. 24 V (+20 %) +``` +``` +Eingangsströme digitale Eingänge je nach Eingangsspannung; +Eingangswiderstand = 46 kOhm +``` +``` +Schaltvermögen digitale Ausgänge bei +Versorgung durch die Datamanager- +Steckkarte +``` +###### 3,2 W + +``` +Fronius IG, Fronius IG Plus, Fronius +IG Plus V, Fronius IG Plus A, Fronius +CL, Fronius CL USA, Fronius IG 300 - +500 +``` +###### 10,8 V + + +``` +Fronius Galvo, Fronius Symo, Fronius +Primo +``` +###### 12,8 V + +``` +in Summe für alle 4 digitalen +Ausgänge +(abzüglich anderer Solar Net Teil- +nehmer) +``` +``` +Schaltvermögen digitale Ausgänge bei +Versorgung durch ein externes Netz- +teil mit min. 10,7 - max. 24 V DC +``` +###### 1 A, 10,7 - 24 V DC + +``` +(je nach externem Netzteil) +pro digitalem Ausgang +``` +``` +max. schaltbare induktive Lasten an +den digitalen Ausgängen +``` +``` +76 mJ +(pro Ausgang) +Modbus RTU RS485 2-Draht +``` +``` +Werkseinstellung der RS485-Schnitt- +stelle: +Geschwindigkeit +Datenrahmen +``` +``` +9600 Baud +1 Startbit +8 Datenbits +keine Parität +1 Stoppbit +``` +``` +* Bei ausreichender Stromversorgung im Fronius Solar Net leuchtet an je- +der DATCOM-Komponente die grüne LED. +Sollte die grüne LED nicht leuchten, am 12 V Netzgerät-Anschluss einer +externen DATCOM-Komponente das bei Fronius erhältliche Netzgerät an- +stecken. +Gegebenenfalls Kabel- und Steckverbindungen überprüfen. +``` +``` +Beispiele für externe DATCOM-Komponenten: Fronius String Control, +Fronius Sensor Box, etc. +``` +#### WLAN + +``` +Frequenzbereich 2412 - 2462 MHz +Benützte Kanäle / Leistung Kanal: 1-11 b,g,n HT20 +Kanal: 3-9 HT40 +<18 dBm +Modulation 802.11b: DSSS (1Mbps DBPSK, +2Mbps DQPSK, 5.5/11Mbps CCK) +802.11g: OFDM (6/9Mbps BPSK, +12/18Mbps QPSK, 24/36Mbps 16- +QAM, 48/54Mbps 64-QAM) +802.11n: OFDM (6.5 BPSK, QPSK, +16-QAM, 64-QAM) +``` + +## Fronius Datamanager 2.0 installieren + +## ren + + + +### Fronius Datamanager 2.0 in den Wechselrichter einsetzen + +**Allgemeines** Generell muss das Einsetzen der Steckkarten in den Wechselrichter gemäß Be- +dienungsanleitung des jeweiligen Wechselrichters erfolgen. Beachten Sie Sicher- +heitshinweise und Warnhinweise in den Bedienungsanleitungen der Wechselrich- +ter. + +#### Sicherheit + +###### WARNUNG! + +``` +Gefahr durch Netzspannung und DC-Spannung von den Solarmodulen. +Ein elektrischer Schlag kann tödlich sein. +▶ Der Anschlussbereich darf nur von lizenzierten Elektro-Installateuren geöff- +net werden. +▶ Der separate Bereich der Leistungsteile darf nur im spannungsfreien Zu- +stand vom Anschlussbereich getrennt werden. +▶ Der separate Bereich der Leistungsteile darf nur durch Fronius-geschultes +Servicepersonal geöffnet werden. +▶ Vor sämtlichen Anschlussarbeiten dafür sorgen, dass AC- und DC-Seite vor +dem Wechselrichter spannungsfrei sind, z. B.: +▶ AC-Sicherungsautomat für den Wechselrichter spannungsfrei schalten +▶ Solarmodule abdecken +▶ Die 5 Sicherheitsregeln beachten! +``` +###### WARNUNG! + +``` +Gefahr durch Restspannung von Kondensatoren. +Ein elektrischer Schlag kann tödlich sein. +▶ Entladezeit der Kondensatoren abwarten. +``` +``` +Beim Umgang mit Steckkarten die allgemeinen ESD-Bestimmungen beachten. +``` +**Einsteckpositio- +nen des Fronius +Datamanager 2.0** + +``` +Je nach Wechselrichter ist die Einsteckposition des Fronius Datamanager 2.0 +vorgegeben: +``` +``` +Wechselrichter Einsteckposition +Fronius IG 15 - 60 ENS-Steckplatz *) +``` +``` +Fronius IG 300 - +500 +``` +``` +ENS-Steckplatz *) +``` +``` +Fronius IG Plus, +Fronius IG Plus V +``` +``` +äußerst rechts, außer wenn eine NL-MON Steckkarte +vorhanden ist +Fronius CL äußerst rechts, außer wenn eine NL-MON Steckkarte +vorhanden ist +Fronius Galvo egal +Fronius Symo egal +``` + +``` +Wechselrichter Einsteckposition +Fronius Primo egal +``` +*) Falls am ENS-Steckplatz eine ENS-Steckkarte vorhanden ist: Fronius Da- + +``` +tamanager 2.0 in den nächsten Steckplatz rechts neben dem ENS-Steck- +platz einstecken. +``` +###### WICHTIG! + +``` +Der nächste Steckplatz muss frei bleiben! +Eine vorhandene ENS-Steckkarte keinesfalls entfernen! +``` +ENS + +Datamanager + + +### WLAN Antenne montieren und anschließen + +**Allgemeines** Je nach Wechselrichter muss die WLAN-Antenne im Wechselrichter eingebaut +oder im Außenbereich des Wechselrichters montiert werden. + +``` +WICHTIG! Öffnen eines Wechselrichters nur entsprechend der Bedienungsan- +leitung des jeweiligen Wechselrichters! Sicherheitsvorschriften beachten! +``` +**Fronius IG, Fro- +nius IG Plus, +Fronius IG Plus +V, Fronius CL: +Antenne montie- +ren und an-** + +##### schließen + +``` +2 +1 +``` +``` +1 Befestigungswinkel mittels Dop- +pelklebeband außen am Wechsel- +richter-Gehäuse oder entspre- +chend dem Antennenkabel in der +Wechselrichter-Umgebung aufkle- +ben +``` +``` +WICHTIG! Das Doppelklebeband +erreicht seine max. Klebefestigkeit +erst nach 24 h. +``` +``` +WICHTIG! Der Befestigungswinkel +darf nicht am Wechselrichter- +Gehäuse angeschraubt werden. +Das Anschrauben des Befesti- +gungswinkels in der Wechselrich- +ter-Umgebung ist möglich. Schrau- +ben hierfür sind nicht im Lieferum- +fang enthalten und müssen vom +Installateur selbst ausgewählt wer- +den. +``` +``` +0,9 Nm +``` +``` +1 +``` +``` +2 +``` +``` +2 Antennenkabel am Antennenso- +``` +#### Einsteckpositionen des Fronius Datamanager 2.0 + +##### anschließen + +``` +3 Antennenkabel durch die DAT- +COM-Öffnung des Wechselrichters +nach außen führen +4 Falls möglich, Kabel in Zugentlas- +tung fixieren +5 DATCOM-Öffnung entsprechend +der Wechselrichter-Bedienungsan- +leitung schließen oder abdichten +``` + +``` +1 +``` +``` +2 +``` +``` +6 Sechskant-Mutter und Scheibe +vom Außengewinde des Antennen- +kabels entfernen +``` +``` +6 +``` +``` +1 +``` +``` +5 +``` +``` +2 +``` +``` +4 3 +0,9 Nm +``` +``` +7 Antennenkabel durch die Bohrung +am Befestigungswinkel führen +8 Scheibe aufsetzen und Sechskant- +Mutter aufschrauben +9 Antenne aufschrauben +``` +**Fronius IG USA, +Fronius IG Plus +USA, Fronius IG +Plus V USA: An- +tenne montieren +und anschließen** + +``` +1 +``` +``` +2 +``` +``` +1 +1 +``` +``` +2 +``` + +###### VORSICHT! + +``` +Kurzschluss-Gefahr durch ausgebrochene Metallstücke von einer Soll-Bruch- +stelle. +Ausgebrochene Metallstücke im Wechselrichter können zu Kurzschlüssen +führen, wenn der Wechselrichter unter Spannung steht. Beim Ausbrechen von +Soll-Bruchstellen darauf achten, dass +``` +▶ keine ausgebrochenen Metallstücke in den Wechselrichter fallen, + +▶ in den Wechselrichter gefallene Metallstücke sofort entfernt werden. + +``` +1 +2 +0.6 Nm +0.74 ft. lb. +``` +``` +3 +``` +``` +1 +19 mm +3/4 in. +``` +``` +4 +``` +###### HINWEIS! + +``` +Um beim Einsetzen der Antennenverschraubung in das Wechselrichter- +Gehäuse die Dichtheit zu gewährleisten, muss der Dichtungsring an der Anten- +nenverschraubung angebracht sein. +``` +``` +!! +``` +``` +1 +``` +``` +2 +``` +``` +5 +``` +``` +1 +``` +``` +6 +``` + +``` +8 Nm +5.90 ft. lb. +``` +**7** + +``` +3 +3 +``` +``` +1 +``` +``` +2 +``` +###### * + +``` +* Biegeradius des Antennenkabels: min. 25,4 +mm / 1 in. +``` +``` +8 +``` +``` +1 +``` +``` +0.9 Nm +8 in-lb +``` +**9** + +``` +1 +``` +``` +10 +``` + +### Fronius Datamanager 2.0 im Fronius Solar Net installieren + +### stallieren + +#### Sicherheit + +###### VORSICHT! + +``` +Gefahr von schweren Sachbeschädigungen an DATCOM-Komponenten oder am +PC / Laptop durch am Fronius Datamanager 2.0 falsch angeschlossene Ethernet +oder Solar Net Kabel. +▶ Ethernet-Kabel ausschließlich am Anschluss LAN (blaue Farbmarkierung) +anschließen +▶ Solar Net Kabel ausschließlich am Anschluss Solar Net IN (rote Farbmarkie- +rung) anschließen +``` +**Wechselrichter +mit Fronius Da- +tamanager 2.0 +im Fronius Solar +Net installieren** + +``` +Fronius IG, Fronius IG Plus, Fronius IG Plus V, Fronius IG Plus A, Fronius CL, +Fronius CL USA, Fronius IG 300 - 500: +``` +###### DATCOM + +###### IN OUT + +``` +2 +``` +(^54) IN + +###### LAN + +``` +3 +** +``` +###### * + +``` +1 +``` +###### WLAN + +###### *** + +``` +Fronius Galvo, Fronius Symo, Fronius Primo: +``` +###### DATCOM + +###### IN OUT + +``` +6 5 +``` +###### LAN + +###### * + +###### WLAN + +###### IN + +###### OUT + +###### IN + +``` +4 +``` +``` +7 +``` +``` +3 +``` +###### ** + +``` +2x (IN + OUT) +``` +``` +1 +``` +``` +2 +``` +###### *** + + +#### Wechselrichter mit Fronius Datamanager 2.0 im Fronius Solar Net installieren + +``` +Datamanager 2.0 mit einem PC vernetzt wird +** Fronius Solar Net Kabel, wenn ein Wechselrichter mit Fronius Datamana- +ger 2.0 mit einem PC und weiteren DATCOM-Komponenten vernetzt wird +*** Ethernet-Kabel nicht im Lieferumfang von Fronius Datamanager 2.0 / +``` +#### Fronius Datamanager Box 2.0 im Fronius Solar Net installieren + +``` +Verbindung zwischen Datamanager 2.0 und PC via LAN oder WLAN +``` +``` +1 Ethernet-Kabel entsprechend der Bedienungsanleitung des Wechselrichters +wie ein Datenkommunikations-Kabel in den Wechselrichter einführen und +verlegen +2 Ethernet-Kabel am Anschluss LAN anstecken +3 Ethernet-Kabel am PC / Laptop oder an einem entsprechenden Netzwerk- +Anschluss anstecken +4 Falls nur ein Wechselrichter mit Fronius Datamanager 2.0 mit einem PC ver- +netzt wird: +``` +``` +bei Fronius IG, Fronius IG Plus, Fronius IG Plus V, Fronius IG Plus A, Fronius +CL, Fronius CL USA, Fronius IG 300 - 500: +Fronius Solar Net Endstecker am Anschluss Solar Net IN anstecken +``` +``` +bei Fronius Galvo, Fronius Symo, Fronius Primo: +je einen Fronius Solar Net Endstecker am Anschluss Solar Net IN und Solar +Net OUT anstecken +``` +``` +Falls außer dem Wechselrichter mit Fronius Datamanager 2.0 noch weitere +DATCOM-Komponenten im Netz folgen: +Fronius Solar Net Kabel am Anschluss Solar Net IN des Fronius Datamana- +ger 2.0 anstecken +``` +``` +5 Weitere DATCOM-Komponenten miteinander verkabeln +``` +``` +WICHTIG! Am freien IN-Anschluss der letzten DATCOM-Komponente muss +ein Fronius Solar Net Endstecker angesteckt sein. +``` +**Fronius Datama- +nager Box 2.0 im +Fronius Solar +Net installieren** + +###### DATCOM + +###### IN OUT + +###### IN + +###### LAN *** + +###### ** + +###### * + +###### WLAN + +IN + +OUT + +**=** + +**~** + +``` +6 2 +``` +(^22) +**3 3 3 3** + +###### OUT + +###### ** + +###### * + +###### ** + +###### * + +``` +* Fronius Solar Net Endstecker bei der letzten DATCOM-Komponente +** Fronius Solar Net Kabel, wenn eine Fronius Datamanager Box 2.0 mit ei- +nem PC und weiteren DATCOM-Komponenten vernetzt wird +``` + +*** Ethernet-Kabel nicht im Lieferumfang von Fronius Datamanager 2.0 / + +``` +Fronius Datamanager Box 2.0 enthalten +``` +``` +Verbindung zwischen Datamanager 2.0 und PC via LAN oder WLAN +``` +``` +1 Ethernet-Kabel am Anschluss LAN anstecken +2 Ethernet-Kabel am PC / Laptop oder an einem entsprechenden Netzwerk- +Anschluss anstecken +3 Fronius Solar Net Kabel am Anschluss Solar Net OUT der Fronius Datamana- +ger Box 2.0 anstecken +4 Fronius Solar Net Kabel gemäß Bedienungsanleitung des Wechselrichters am +Anschluss Solar Net IN des Wechselrichters anstecken +5 Weitere DATCOM-Komponenten miteinander verkabeln +``` +``` +WICHTIG! An jedem freien IN- oder OUT-Anschluss der letzten DATCOM- +Komponenten muss ein Fronius Solar Net Endstecker angesteckt sein. +``` + +### Verkabelung Fronius Solar Net + +#### Fronius Solar Net Teilnehmer + +``` +Wechselrichter mit Fronius Datamanager, Fronius Com Card, DATCOM Kompo- +nenten mit externem Gehäuse oder andere DATCOM-Komponenten werden im +folgenden als Fronius Solar Net Teilnehmer bezeichnet. +``` +#### Verkabelung der Fronius Solar Net Teilnehmer + +``` +Die Datenverbindung der Fronius Solar Net Teilnehmer erfolgt über eine 1:1-Ver- +bindung mit 8-poligen Datenkabeln und RJ-45 Steckern. +Die Gesamt-Leitungslänge in einem Fronius Solar Net Ring darf max. 1000 m be- +tragen. +``` +**Voraussetzun-** + +#### Voraussetzungen für die Solar Net Datenkabel + +#### Vorkonfektionierte Datenkabel + +``` +Für die Verkabelung der Fronius Solar Net Teilnehmer dürfen ausschließlich ge- +schirmte CAT5 (neu) und CAT5e (alt) Kabeln nach ISO 11801 und EN50173 ver- +wendet werden. +``` +``` +WICHTIG! U/UTP Kabel nach ISO/IEC-11801 dürfen nicht verwendet werden! +``` +``` +Zulässige Kabel: +``` +- S/STP +- F/STP +- S/FTP + +###### - F/FTP + +###### - SF/FTP + +###### - S/UTP + +###### - F/UTP + +###### - U/FTP + +###### - U/STP + +``` +Der Schirm muss dabei auf einen für CAT5 zugelassenen geschirmten Stecker +gecrimpt werden. +``` +``` +Da die Adern in Ethernet-Kabeln verdrillt sind, die korrekte Zuteilung der ver- +drillten Adernpaare gemäß Verkabelung nach TIA/EIA-568B beachten: +``` +``` +Kontakt Fronius Solar +Net Paar-Nr. Farbe +``` +``` +1 +12 V 3 weiß / oranger Strich +``` +###### 2 GND 3 + +``` +orange / weißer Strich +oder orange +``` +``` +3 TX+ IN, RX+ OUT 2 weiß / grüner Strich +``` +###### 4 RX+ IN, TX+ OUT 1 + +``` +blau / weißer Strich +oder blau +``` +``` +5 RX- IN, TX- OUT 1 weiß / blauer Strich +``` +###### 6 TX- IN, RX- OUT 2 + +``` +grün / weißer Strich +oder grün +``` +``` +7 GND 4 weiß / brauner Strich +``` +###### 8 +12 V 4 + +``` +braun / weißer Strich +oder braun +Verkabelung nach TIA/EIA-568B +``` + +- Die korrekte Adernbelegung beachten. +- Bei selbstständiger Erdanbindung (z. B. in Patch-Panelen) darauf achten, + dass der Schirm nur auf einer Seite des Kabels geerdet ist. + +``` +Generell die folgenden Normen für strukturierte Verkabelung einhalten: +``` +- für Europa die EN50173-1 +- international die ISO/IEC 11801:2002. +- für Nordamerika die TIA/EIA 568 + +``` +Es gelten die Regeln für die Anwendung für Kupferkabel. +``` +**Vorkonfektio- +nierte Datenka- +bel** + +``` +Bei Fronius sind folgende vorkonfektionierte Datenkabel verfügbar: +``` +- CAT5 Kabel 1 m ... 43,0004,2435 +- CAT5 Kabel 20 m ... 43,0004,2434 +- CAT5 Kabel 60 m ... 43,0004,2436 + +``` +Bei den angeführten Kabeln handelt es sich um 8-polige 1:1 LAN Netzwerk-Ka- +bel, geschirmt und verdrillt, inkl. RJ45 Steckern. +``` +``` +WICHTIG! Die Datenkabel sind nicht UV-beständig. Beim Verlegen im Freien die +Datenkabel vor Sonnenbestrahlung schützen. +``` + +### Fronius Datamanager 2.0 installieren - Übersicht + +#### Sicherheit + +###### WARNUNG! + +``` +Gefahr durch Fehlbedienung. +Schwerwiegende Personen- und Sachschäden möglich. +▶ Beschriebene Funktionen erst anwenden, wenn diese Bedienungsanleitung +vollständig gelesen und verstanden wurde. +▶ Beschriebene Funktionen erst anwenden, wenn sämtliche Bedienungsanlei- +tungen der Systemkomponenten, insbesondere Sicherheitsvorschriften +vollständig gelesen und verstanden wurden! +``` +``` +Die Installation des Fronius Datamanager 2.0 setzt Kenntnisse aus der Netzwerk- +Technologie voraus. +``` +**Erst-Inbetrieb- +nahme mittels +Web-Browser** + +``` +Mit der Fronius Solar.start App kann die Erst-Inbetriebnahme des Fronius Data- +manager 2.0 wesentlich erleichtert werden. Die Fronius Solar.start App ist im je- +weiligen App-Store verfügbar. +``` +``` +Für die Erst-Inbetriebnahme des Fronius Datamanager 2.0 +``` +- muss die Fronius Datamanager 2.0 Steckkarte im Wechselrichter eingebaut + sein, + oder +- eine Fronius Datamanager Box 2.0 muss sich im Fronius Solar Net Ring be- + finden. + +``` +WICHTIG! Für den Verbindungsaufbau zum Fronius Datamanager 2.0 muss das +jeweilige Endgerät (z. B. Laptop, Tablet, etc.) wie folgt eingestellt sein: +``` +- „IP-Adresse automatisch beziehen (DHCP)“ muss aktiviert sein + +###### WARNUNG! + +``` +Gefahr durch Netzspannung und DC-Spannung von den Solarmodulen. +Ein elektrischer Schlag kann tödlich sein. +▶ Vor dem Öffnen des Wechselrichters Entladezeit der Kondensatoren abwar- +ten. +▶ Wechselrichter nur entsprechend der Bedienungsanleitung des Wechselrich- +ters öffnen. +▶ Sicherheitsvorschriften und Sicherheitshinweise in der Bedienungsanleitung +des Wechselrichters beachten und befolgen. +``` +``` +1 Wechselrichter mit Fronius Datamanager 2.0 oder Fronius Datamanager Box +2.0 im Fronius Solar Net verkabeln +``` +``` +WICHTIG! Die Wechselrichter Fronius IG, Fronius IG Plus, Fronius IG Plus +V, Fronius IG Plus A, Fronius CL, Fronius CL USA und Fronius IG 300 - 500 +müssen sich immer am Anfang oder Ende des Fronius Solar Net Ringes be- +finden. +``` + +``` +2 Nur bei Fronius Galvo / Fronius Symo / Fronius Primo und bei Vernetzung +mehrerer Wechselrichter im Fronius Solar Net: +Fronius Solar Net Master / Slave Schalter an der Fronius Datamanager 2.0 +Steckkarte richtig setzen +``` +- ein Wechselrichter mit Fronius Datamanager 2.0 = Master +- alle anderen Wechselrichter mit Fronius Datamanager 2.0 = Slave (die + LEDs an den Fronius Datamanager 2.0 Steckkarten sind aus) + +``` +3 Gerät in den Service-Modus schalten +``` +``` +Wechselrichter mit Fronius Datamanager 2.0 Steckkarte: +``` +- IP-Schalter an der Fronius Datamanager 2.0 Steckkarte in Position A + schalten + +``` +oder +``` +- WIFI Access Point über das Setup-Menü des Wechselrichters aktivieren + (das Ausführen dieser Funktion ist von der Wechselrichter-Software + abhängig) + +``` +Stand by +WiFi Access Point +DATCOM +USB +Clock +``` +``` +Fronius Datamanager Box 2.0: +``` +- IP-Schalter an der Fronius Datamanager Box 2.0 in Position A schalten + +Der Wechselrichter / die Fronius Datamanager Box 2.0 baut den WLAN Access +Point auf. Der WLAN Access Point bleibt 1 Stunde geöffnet. + +``` +4 Endgerät mit dem WLAN Access Point verbinden +``` +``` +SSID = FRONIUS_240.xxxxx (5-8 stellig) +``` +- nach einem Netz mit dem Namen „FRONIUS_240.xxxxx“ suchen +- Verbindung zu diesem Netz herstellen +- Passwort vom Display des Wechselrichters eingeben + +``` +(oder Endgerät und Wechselrichter mittels Ethernet-Kabel verbinden) +``` + +``` +5 Im Browser eingeben: +http://datamanager +oder +192.168.250.181 (IP-Adresse für WLAN-Verbindung) +oder +169.254.0.180 (IP-Adresse für LAN-Verbindung) +``` +Die Startseite des Inbetriebnahme-Assistenten wird angezeigt. + +Der Techniker Assistent ist für den Installateur vorgesehen und enthält Normen- +spezifische Einstellungen. +Wird der Techniker Assistent ausgeführt, unbedingt das vergebene Service-Pass- +wort notieren. Dieses Service-Passwort ist für die Einstellung der Menüpunkte +EVU-Editor und Zähler erforderlich. +Wird der Techniker Assistent nicht ausgeführt, sind keinerlei Vorgaben zur Leis- +tungsreduzierung eingestellt. + +Die Ausführung des Solar.web Assistenten ist obligatorisch! + +``` +6 Bei Bedarf den Techniker Assistenten ausführen und den Anweisungen fol- +gen +``` +``` +7 Den Solar.web Assistenten ausführen und den Anweisungen folgen +``` +Die Fronius Solar.web Startseite wird angezeigt. +oder +Die Webseite des Fronius Datamanager 2.0 wird angezeigt. + + +## Verbindung zum Fronius Datamanager 2.0 herstellen + +## nager 2.0 herstellen + + + +### Verbindung zum Fronius Datamanager 2.0 via Web-Browser + +#### Verbindung zum Fronius Datamanager 2.0 via Web-Browser herstellen + +``` +allem für das Abrufen aktueller Werte durch viele PC-Nutzer in einem LAN (z. B. +Firmen-Netzwerke, Schulen, etc.). +``` +``` +Auf der Web-Seite des Fronius Datamanager 2.0 können z. B. Gesamt- und Ta- +geserträge abgelesen oder Wechselrichter verglichen werden. +``` +**Voraussetzun- +gen** + +- mindestens LAN- oder WLAN-Verbindung +- Web-Browser (z. B. Microsoft Internet Explorer IE >/= 9.0, Firefox 4, Google + Chrome 27.0, etc.) +- PC / Laptop im selben Netzwerk-Segment, wie der Fronius Datamanager 2.0 + +**Verbindung zum +Fronius Datama- +nager 2.0 via +Web-Browser +herstellen** + +``` +1 Web-Browser öffnen +2 Im Adressfeld die IP Adresse oder den Hostnamen und den Domainnamen +des Fronius Datamanager 2.0 eingeben +``` +``` +Die Web-Seite des Fronius Datamanager 2.0 wird angezeigt. +``` +``` +Verbrauch +Netzeinspeisung +1727,9 W +2464,1 W +``` + +### Verbindung zum Fronius Datamanager 2.0 via Internet und Fronius Solar.web + +### ternet und Fronius Solar.web + +#### Daten vom Fronius Datamanager 2.0 via Internet und Fronius Solar.web abrufen + +``` +lar.web können von jedem Punkt der Erde mit Internet-Zugang Archivdaten und +aktuelle Daten einer Photovoltaik-Anlage über das Internet abgerufen werden. +Weiters besteht die Möglichkeit, anderen Benutzern mittels Gastzugriff Einblick +in die Photovoltaik-Anlage zu geben sowie mehrere Anlagen miteinander zu ver- +gleichen. +``` +**Funktionsbe- +schreibung** + +``` +Der Fronius Datamanager 2.0 ist mit dem Internet verbunden (z. B. über einen +DSL Router). Der Fronius Datamanager 2.0 meldet sich regelmäßig beim Fronius +Solar.web an und schickt täglich die gespeicherten Daten. +Fronius Solar.web kann aktiv Kontakt mit dem Fronius Datamanager aufnehmen, +z. B. um aktuelle Daten anzuzeigen. +``` +**Voraussetzun- +gen** + +- Internet-Zugang +- Web-Browser + +``` +WICHTIG! Der Fronius Datamanager 2.0 kann sich nicht selbst ins Internet +verbinden. Bei einem DSL-Anschluss muss ein Router die Verbindung ins In- +ternet aufbauen. +``` +- Registrierung der Photovoltaik-Anlage bei Fronius Solar.web. +- Für das Abrufen aktueller Daten im Fronius Solar.web muss beim Fronius + Datamanager 2.0 in den Einstellungen unter Solar.web die Auswahlmöglich- + keit „ja“ bei „Aktuelle Daten an Solar.web senden“ aktiviert sein. +- Für das Abrufen von Archivdaten im Fronius Solar.web muss beim Fronius + Datamanager 2.0 die Auswahlmöglichkeit „täglich“ oder „stündlich“ unter + „Archivdaten an Solar.web senden“ aktiviert sein. + +**Daten vom Fro- +nius Datamana- +ger 2.0 via Inter- +net und Fronius +Solar.web abru- +fen** + +``` +Um aktuelle Daten und Archivdaten vom Fronius Datamanager 2.0 mittels Froni- +us Solar.web abzurufen: +``` +``` +1 Fronius Solar.web starten: http://www.solarweb.com +``` +``` +Nähere Informationen zu Fronius Solar.web gemäß Online-Hilfe. +``` + +## Aktuelldaten, Services und Einstel- + +## lungen am Fronius Datamanager + +## 2.0 + + + +### Die Web-Seite des Fronius Datamanager 2.0 + +**Web-Seite des +Fronius Datama- +nager 2.0 - Über- +sicht** + +``` +Auf der Web-Seite des Fronius Datamanager 2.0 werden folgende Daten ange- +zeigt: +``` +``` +(1) Aktuelle Vergleichsansicht aller Wechselrichter im Fronius Solar Net +Ring +(2) Anlagenübersicht: Aktuell / Tag / Jahr / Gesamt +(3) Wechselrichter +(4) Sensoren +(5) Services +Systeminformationen, Netzwerkdiagnose, Firmware-Update, Assistenten +aufrufen +(6) Kontakt +Feedback senden +(7) Das Menü Einstellungen +(8) Weitere Einstellmöglichkeiten +``` +###### (1) + +###### (2) + +###### (3) + +###### (4) + +###### (8) + +###### (5) + +###### (6) + +###### (7) + +**Login** Die Einstellmöglichkeiten auf der Web-Seite des Fronius Datamanager 2.0 sind +abhängig von der Berechtigung des Benutzers (siehe Kapitel **Einstellungen - +Passwörter** auf Seite **61** ). + +``` +Mit Benutzernamen und Passwort anmelden: +1 Benutzer für die Anmeldung auswählen. +2 Passwort für den gewählten Benutzer eingeben. +3 Die Schaltfläche^ Login anklicken. +``` +``` +Der Benutzer ist angemeldet. +``` + +#### Passwort zurücksetzen + +``` +Über die Funktion Passwort vergessen? im Login-Fenster kann das Passwort für +den gewählten Benutzer zurückgesetzt werden. +``` +``` +Entsperrungsschlüssel beantragen und neues Passwort speichern: +1 Benutzer, für den das Passwort zurückgesetzt werden soll, auswählen. +2 Die „Challenge“ (sechsstellige Nummer) und Datalogger-ID (unter dem Sym- +bol zu finden, siehe Kapitel Weitere Einstellmöglichkeiten auf Seite 52 ) +notieren. +3 Fronius TechSupport kontaktieren und die „Challenge“ sowie die Datalogger- +ID bekannt geben. +4 Den von Fronius TechSupport erhaltenen Entsperrungsschlüssel in das Ein- +gabefeld Schlüssel eingeben. +5 Ein neues Passwort in die Eingabefelder Passwort und Passwort wiederholen +eingeben. +6 Die Schaltfläche^ Speichern anklicken. +``` +``` +Das neue Passwort ist gespeichert. +``` +#### Das Menü Einstellungen + +**stellungen** + +``` +Nach dem Anklicken von Einstellungen wird auf der Web-Seite des Fronius Data- +manager 2.0 das Menü Einstellungen geöffnet. +Im Menü Einstellungen erfolgt die Konfiguration des Fronius Datamanager 2.0. +``` +###### * + +``` +PASSWÖRTER +``` +``` +ALLGEMEIN +``` +``` +NETZWERK +``` +``` +FRONIUS SOLAR.WEB +``` +``` +IO-ZUORDNUNG +``` +``` +LASTMANAGEMENT +``` +``` +PUSH SERVICE +``` +``` +MODBUS +``` +``` +WECHSELRICHTER +``` +``` +FRONIUS SENSOR CARDS +``` +``` +ZÄHLER** +``` +``` +EVU-EDITOR ** +``` +``` +DS +``` +``` +Menüpunkte im Menü +Einstellungen +``` +``` +Einstellen und Ansehen von Menüpunkten generell +``` +``` +1 Verbindung zum Fronius Datamanager 2.0 herstellen +2 Einstellungen anklicken +3 Mit den Benutzernamen (admin oder service) anmel- +den (siehe Kapitel Login auf Seite 51 ) +4 Gewünschten Menüpunkt anklicken +``` +``` +Der gewünschte Menüpunkt wird geöffnet. +``` +``` +5 Menüpunkt ansehen oder entsprechend bearbeiten. +6 Falls vorhanden, die Ausführ-Schaltfläche klicken (z. +B. Speichern, Synchronisieren, etc.) +``` +``` +Die geänderten Daten werden übernommen. +``` +``` +* ausgewählter Menüpunkt +** Die Menüpunkte Zähler und EVU Editor sind +durch das Service-Passwort geschützt. +``` +#### Weitere Einstellmöglichkeiten + +**stellmöglichkei- +ten** + +``` +Auf der Web-Seite des Fronius Datamanager 2.0 befinden sich im rechten obe- +ren Bereich folgende weitere Einstellmöglichkeiten: +``` + +Systeminformationen: +Datalogger-ID, Software-Version, Firmware-Update suchen, Solar +Net Verbindung, Solar.web Verbindung + +Hilfe: + +- Software Betriebsanleitung +- Fronius Solar-Channel + +Inhalt erweitern: +Der Bereich des Menüs Aktuelldaten / Einstellungen wird ausgeblen- +det + +Benachrichtigungen anzeigen + +Sprache: +zum Einstellen der Sprache + +Die Web-Seite des Fronius Datamanager 2.0 wird entweder in der +Sprache des vorhandenen Browsers oder in der zuletzt ausgewähl- +ten Sprache angezeigt. + + +### Aktuelldaten am Fronius Datamanager 2.0 + +#### Aktuelle Vergleichsansicht + +**gleichsansicht** + +``` +In der aktuellen Vergleichsansicht werden mehrere Wechselrichter einer Photo- +voltaikanlage miteinander verglichen. +``` +``` +Die aktuelle AC-Leistung der Wechselrichter wird als Prozentwert der an den je- +weiligen Wechselrichter angeschlossenen Solarmodul-Leistung als Balken in ei- +nem Diagramm angezeigt. Für jeden Wechselrichter wird ein Balken angezeigt. +Die Balkenfarbe signalisiert den Leistungsbereich der Wechselrichter: +``` +``` +blau: die Wechselrichter-Leistung entspricht der Durchschnittsleis- +tung aller Wechselrichter +gelb: die Wechselrichter-Leistung weicht geringfügig von der Durch- +schnittsleistung aller Wechselrichter ab +(50 - 90 % vom Durchschnitt) +rot: die Wechselrichter-Leistung weicht stark von der Durchschnitts- +leistung aller Wechselrichter ab oder ein Fehler ist im Wechsel- +richter aufgetreten +(< 50 % vom Durchschnitt) +``` +**Anlagenüber- +sicht** + +``` +Die Anlagenübersicht enthält: +``` +- die aktuellen Leistungsdaten einer Photovoltaikanlage +- die aktiven Geräte +- die produzierte Energie pro Tag, pro Jahr und gesamt +- den Ertrag pro Tag, pro Jahr und gesamt + +``` +Die Werte für Verbrauch und Netzeinspeisung werden nur angezeigt, wenn am +Wechselrichter ein Zähler konfiguriert wird und wenn der Zähler gültige Daten +schickt. +``` +**Ansicht Wech- +selrichter / Sen- +soren** + +#### Ansicht Wechselrichter / Sensoren + +``` +In der Ansicht Wechselrichter werden alle im System befindlichen Wechselrich- +ter angezeigt. +Durch Anklicken eines Wechselrichters oder des entsprechenden Balkens in der +Vergleichsansicht werden die aktuellen Daten des Wechselrichters angezeigt. +``` +``` +Ansicht Sensoren +In der Ansicht Sensoren werden alle im System befindlichen Sensor Cards / Bo- +xes angezeigt. +``` + +### Services - Systeminformationen + +**Systeminforma- +tionen** + +``` +Die Seite Systeminformationen enthält verschiedene Informationen zum System. +``` +``` +Zusätzlich gibt es folgende Schaltflächen: +``` +- Schaltfläche **Datalogger Neustart** + zum Neustarten des Datamanagers / der Anlagenüberwachung +- Schaltfläche **Auf Werkseinstellungen zurücksetzen** mit den Aus- + wahlmöglichkeiten: + - **alle Einstellungen außer Netzwerk** + zum Zurücksetzen des Datamanagers (Anlagenüberwachung) auf Werks- + einstellungen. + Die Netzwerk-Einstellungen sowie alle durch den Service-User geschütz- + ten Punkte (EVU-Editor, Zählereinstellungen und das Service-Passwort) + bleiben erhalten + - **alle Einstellungen** + zum Zurücksetzen des Datamanagers (Anlagenüberwachung) und der + Netzwerkeinstellungen auf Werkseinstellungen. + Alle durch den Service-User geschützten Punkte (EVU-Editor, Zählerein- + stellungen und das Service-Passwort) bleiben erhalten + +``` +WICHTIG! Wird der Datamanager (Anlagenüberwachung) auf Werkseinstellun- +gen zurückgesetzt, müssen die Zeit- und Datumseinstellungen kontrolliert wer- +den. +``` + +### Services - Netzwerkdiagnose + +**Netzwerkdia- +gnose** + +``` +Unter Services / Netzwerkdiagnose befinden sich Funktionen, die zur Diagnose +und Behebung von Netzwerk-Problemen hilfreich sind. Es können Ping- und +Traceroute-Befehle ausgeführt werden. +``` +``` +Ping-Befehl +mit einem Ping-Befehl kann überprüft werden, ob ein Host erreichbar ist und +wieviel Zeit die Datenübertragung in Anspruch nimmt. +``` +``` +Ping-Befehl senden: +1 In das Feld Host : einen Hostnamen oder eine IP-Adresse eingeben +2 Schaltfläche^ ping klicken +``` +- Ping-Befehl wird gesendet +- die ermittelten Daten werden angezeigt + +``` +Traceroute-Befehl +mit einem Traceroute-Befehl kann ermittelt werden, über welche Zwischensta- +tionen Daten zum Host übermittelt werden. +``` +``` +Traceroute-Befehl senden: +1 In das Feld Host : einen Hostnamen oder eine IP-Adresse eingeben +2 Schaltfläche^ traceroute klicken +``` +- Traceroute-Befehl wird gesendet +- die ermittelten Daten werden angezeigt + + +### Services - Firmware-Update + +**Allgemeines** Unter Services / Firmware-Update kann die Firmware des Datamanagers aktuali- +siert werden. Ein Firmware-Update kann via LAN oder Web ausgeführt werden. + +#### Automatisch nach Updates suchen + +``` +WICHTIG! Für das Automatische Suchen nach Updates ist eine Internet-Verbin- +dung erforderlich. +``` +``` +Ist die Auswahlmöglichkeit automatisch nach Updates suchen aktiviert, sucht +der Datamanager einmal pro Tag automatisch nach Updates. Sind neue Updates +verfügbar, werden diese als Nachricht bei den weiteren Einstellmöglichkeiten der +Webseite angezeigt. +``` +#### Manuell nach Updates suchen + +``` +Ist die Auswahlmöglichkeit automatisch nach Updates suchen deaktiviert, wer- +den Updates nicht automatisch gesucht. +``` +``` +1 Um manuell nach Updates zu suchen, die Schaltfläche^ jetzt prüfen drücken +``` +**Firmware-Up-** + +#### Firmware-Update via Web ausführen + +**ausführen** + +``` +1 Mittels Web-Browser die Webseite des Datamanagers öffnen +2 Unter Services Firmware-Update öffnen +3 Update via Web auswählen +4 Schaltfläche^ Update durchführen klicken +``` +``` +Die Sicherheitsabfrage für das Update wird angezeigt +5 Schaltfläche^ Ja klicken +``` +``` +Das Update wird durchgeführt, der Update-Fortschritt wird als Balken und +als Prozentwert angezeigt. +6 Nach einem erfolgreich durchgeführten Update die Schaltfläche^ Überneh- +men / Speichern klicken +``` +``` +Sollte die Verbindung zum Server fehlschlagen: +``` +- für die Dauer des Updates die Firewall deaktivieren +- erneut versuchen + +###### WICHTIG! + +``` +Wird für die Verbindung zum Internet ein Proxyserver verwendet: +▶ muss die Auswahlmöglichkeit Proxyserver für Web-Update verwenden akti- +viert sein +▶ müssen die geforderten Daten eingegeben werden +``` +**Firmware-Up-** + +#### Firmware-Update via LAN ausführen + +**ausführen** + +``` +1 LAN-Verbindung zwischen PC / Laptop und Datamanager herstellen +2 Aktuelle Firmware von der Fronius-Homepage herunterladen +``` + +``` +3 Die heruntergeladene Update-Datei auf dem PC / Laptop ausführen +``` +``` +Ein Webserver wird gestartet, von dem der Datamanager die benötigten Da- +teien herunterlädt. +4 Mittels Web-Browser die Webseite des Datamanagers öffnen +5 Unter ServicesFirmware-Update öffnen +6 Update via LAN auswählen +7 IP-Adresse des PC / Laptops eingeben +8 Schaltfläche^ Update durchführen klicken +``` +``` +Die Sicherheitsabfrage für das Update wird angezeigt. +9 Schaltfläche^ Ja klicken +``` +``` +Das Update wird durchgeführt, der Update-Fortschritt wird als Balken und +als Prozentwert angezeigt. +10 Nach einem erfolgreich durchgeführten Update die Schaltfläche^ Überneh- +men / Speichern klicken +``` +Das Update ist beendet, wenn die „LED Versorgung“ wieder grün leuchtet. + +Sollte die Verbindung zum Server fehlschlagen: + +- für die Dauer des Updates die Firewall deaktivieren +- erneut versuchen + + +### Services - Assistenten aufrufen + +#### Assistenten aufrufen + +**rufen** + +``` +Unter Assistenten aufrufen können der Solar.web Assistent und der Techniker +Assistent erneut aufgerufen und ausgeführt werden. +``` + +### Einstellungen - Allgemein + +**Allgemein** Unter Vergütung kann der Verrechnungssatz pro kWh, die Währung und die Be- +zugskosten pro kWh für die Errechnung des Ertrages eingegeben werden. Der Er- +trag wird in der aktuellen Gesamtansicht angezeigt. + +``` +Unter Systemzeit kann das Datum, die Stunde und die Minuten eingegeben wer- +den. +Durch Klicken der Schaltfläche Synchronisieren wird die in den Eingabefeldern +der Webseite des Datamanagers angezeigte Zeit an die Zeit des Betriebssyste- +mes angepasst. +Zum Übernehmen der Zeit Schaltfläche Übernehmen / Speichern klicken. +``` +``` +Unter Zeitzonen Einstellungen kann die Region und der Ort für die Zeitzone ein- +gestellt werden. +``` +``` +Die Eingabe der mit * gekennzeichneten Felder ist obligatorisch. +``` + +### Einstellungen - Passwörter + +**Allgemeines** Durch die Vergabe von Passwörtern wird der Zugriff auf den Fronius Datamana- +ger 2.0 geregelt. +Hierfür stehen 3 unterschiedliche Passwort-Typen zur Verfügung: + +- das Administrator-Passwort +- das Service-Passwort +- das Benutzer-Passwort + +#### Passwörter + +``` +Benutzername = admin +``` +``` +Mit dem bei der Inbetriebnahme gesetzten Administrator-Passwort hat der Be- +nutzer sowohl Lese- als auch Einstellrechte. Der Menüpunkt Einstellungen lässt +sich vom Benutzer öffnen, alle Einstellungen mit Ausnahme von EVU-Editor und +Zähler lassen sich durchführen. +``` +``` +Bei gesetztem Administrator-Passwortes muss der Benutzer Benutzernamen +und Passwort angeben, wenn er den Menüpunkt Einstellungen öffnen will. +``` +``` +Service-Passwort +Benutzername = service +``` +``` +Das Service-Passwort wird üblicherweise beim Inbetriebnahme-Assistenten vom +Servicetechniker oder Anlagen-Installateur vergeben und bietet Zugriff auf An- +lagen-spezifische Parameter. Das Service-Passwort ist erforderlich, um Einstel- +lungen am Zähler und am EVU Editor durchzuführen. Solange kein Service-Pass- +wort vergeben wurde, ist kein Zugriff auf die Menüpunkte Zähler und EVU Editor +möglich. +``` +``` +Benutzer-Passwort +Nach Aktivieren des Auswahlfeldes Lokale Anlagenseite sichern wird das Benut- +zer-Passwort angezeigt, Benutzername = user. +``` +``` +Wird ein Benutzerpasswort vergeben, so hat der Benutzer nur Leserechte. Der +Menüpunkt Einstellungen lässt sich vom Benutzer nicht öffnen. +``` +``` +Bei Vergabe eines Benutzer-Passwortes muss der Benutzer bei jeder Verbindung +Benutzernamen und Kennwort angeben. +``` + +### Einstellungen - Netzwerk + +#### Internet via WLAN + +``` +Die gefundenen Netzwerke werden an- +gezeigt. +``` +``` +Mit einem Klick auf den Refresh-Button wird eine erneute Suche nach +verfügbaren WLAN-Netzwerken ausgeführt. +``` +``` +Versteckte Netzwerke können über das Menü WLAN Einstellungen > WLAN hin- +zufügen hinzugefügt werden. +``` +``` +Schaltfläche Einrichten - zum Speichern eines ausgewählten WLAN-Netzwerkes. +Nach Klicken der Schaltfläche öffnet sich das Fenster „ WLAN Verbindung “ +``` +``` +Schaltfläche Entfernen - zum Löschen eines gespeicherten WLAN-Netzwerkes. +``` +``` +Schaltfläche WLAN IP konfigurieren - Nach Klicken der Schaltfläche öffnet sich +das Fenster IP konfigurieren mit den gleichen Einstellmöglichkeiten wie bei ei- +ner LAN-Verbindung. +``` +``` +Schaltfläche Verbinden via WPS - zum Verbinden ins WLAN via WPS ohne +WLAN Passwort: +``` +1. WPS am WLAN Router aktivieren (siehe Dokumentation des WLAN Routers) +2. Schaltfläche **Verbinden via WPS** klicken +3. Die WLAN Verbindung wird automatisch hergestellt + +#### Internet via LAN + +``` +Einstellmöglichkeiten: +``` +- **Adresse beziehen** - **statisch** + Der Anwender muss eine fixe **IP-Adresse** für den Datamanager (Anla- + genüberwachung), die **Subnet-Mask** , die **Gateway** -Adresse und die **DNS-Ser-** + **ver** Adresse (vom Provider) eingeben. +- **Adresse beziehen** - **dynamisch** + Der Datamanager (Anlagenüberwachung) holt sich die IP-Adresse von einem + DHCP-Server (DHCP = Dynamic Host Configuration Protocol). + Der DHCP-Server muss so konfiguriert sein, dass der Datamanager (Anla- + genüberwachung) immer die selbe IP-Adresse zugewiesen bekommt. Somit + weiß man immer, unter welcher IP-Adresse der Datamanager (Anlagenüber- + wachung) erreichbar ist. + Falls der DHCP-Server die Funktion DNS dynamic updates unterstützt, kann + dem Datamanager (Anlagenüberwachung) im Feld **Hostname** ein Name ge- + geben werden. Die Verbindung zum Datamanager (Anlagenüberwachung) + kann anstelle der IP-Adresse über den Namen erfolgen. + z. B.: **Hostname** = musteranlage, Domainname = fronius.com + Der Datamanager (Anlagenüberwachung) ist über die Adresse „musteranla- + ge.fronius.com“ erreichbar. + + +**Lokales Netz- +werk via Access- +Point** + +``` +Der Datamanager (Anlagenüberwachung) dient als Access-Point. Ein PC oder +Smart Device verbindet sich direkt mit dem Datamanager (Anlagenüberwa- +chung). Es ist keine Verbindung mit dem Internet möglich. +``` + +### Einstellungen - Fronius Solar.web + +**Solar.web** Über den Menüpunkt **Fronius Solar.web** kann eine direkte Verbindung zu Fronius +Solar.web aufgebaut werden. + +``` +Die Auswahl des Speicherintervalls bei den Feldern Abfragezyklus Wechselrich- +ter und Abfragezyklus Fronius Sensor Cards hat Auswirkungen auf die benötigte +``` +#### Speicherkapazität + +``` +Schaltfläche Solar.web registrieren - durch Klicken der Schaltfläche wird die +Fronius Solar.web Startseite geöffnet, für Fronius Solar.web relevante Daten +werden automatisch mitgeschickt. +``` +``` +Cloud Control +Ein virtuelles Kraftwerk ist ein Zusammenschaltung mehrerer Erzeuger zu einem +Verbund. Dieser Verbund kann über die Cloud-Steuerung per Internet gesteuert +werden. Eine aktive Internetverbindung des Wechselrichters ist Voraussetzung +dafür. Es werden Daten der Anlage übermittelt. +Wenn die Funktion Cloud-Steuerung für Anforderungen des Netzbetreibers/ +Energieversorgers zulassen aktiviert ist (service-Zugang erforderlich), ist die +Funktion Cloud-Steuerung für virtuelle Kraftwerke zulassen automatisch akti- +viert und kann nicht deaktiviert werden. +Die Funktion Cloud-Steuerung für Anforderungen des Netzbetreibers/Energie- +versorgers zulassen kann für den ordnungsgemäßen Betrieb der Anlage ver- +pflichtend sein. +``` +**Speicherkapa- +zität** + +``` +Bei einer Photovoltaikanlage mit einem Wechselrichter hat der Fronius Datama- +nager bei einem Speicherintervall von 15 Minuten eine Speicherkapazität von bis +zu 5 Jahren und 7 Monaten. +Je nach Anzahl der in das System eingebundenen Wechselrichter oder Fronius +Sensor Cards / Boxen verringert sich die Speicherkapazität des Fronius Datama- +nager entsprechend. +``` +**Speicherkapa-** + +#### Speicherkapazität berechnen + +``` +1 Logging-Punkte für Wechselrichter und Fronius Sensor Cards / Boxen ermit- +teln +``` +``` +Logging-Punkte pro Tag = +``` +``` +Logging-Dauer [min] +Speicherintervall [min] +``` +``` +Logging-Dauer [min] +``` +- für Wechselrichter: z. B. 14 Stunden = 840 Minuten +- für Fronius Sensor Card / Fronius Sensor Box: 24 Stunden = 1440 Mi- + nuten + +``` +2 Summe der Logging-Punkte bilden +``` +``` +Summe der Logging-Punkte = += (Anzahl der Wechselrichter x Logging-Punkte pro Tag) + (Anzahl der Froni- +us Sensor Cards / Boxen x Logging-Punkte pro Tag) +``` +``` +3 Speichersektoren pro Tag ermitteln +``` + +``` +Speichersektoren pro Tag = +``` +``` +Summe der Logging-Punk- +te +114 +``` +``` +4 Aufrunden auf ganze Zahlen +5 Speicherkapazität ermitteln +``` +``` +Speicherkapazität [Tage] = +``` +###### 2048 + +``` +Speichersektoren pro Tag +``` +**Berechnungsbei- +spiel** + +``` +2 Wechselrichter, Loggingdauer = 14 Stunden (840 Minuten) +1 Fronius Sensor Card, Loggingdauer = 24 Stunden (1440 Minuten) +``` +``` +Speicherintervall = 15 Minuten +``` + +1. Loggingpunkte pro Tag: + +(^) Loggingpunkte Wechsel- +richter = +840 min += 56 +15 min +(^) Loggingpunkte Sensor +Card = +1440 min += 96 +15 min +2. Summe der Loggingpunkte: +Summe der Loggingpunkte = (2 x 56) + (1 x 96) = 208 +(2 x 56) ... 2 Wechselrichter, (1 x 96) ... 1 Sensor Card +3. Speichersektoren pro Tag: +Speichersektoren = + +###### 208 + +###### = 1,825 + +###### 114 + +4. Aufrunden: + +(^) 1,825 2 +5. Speicherkapazität [Tagen]: +(^) Speicherka- +pazität = +(^2048) = 1024 Tage (= 2 Jahre, 9 +2 Monate, 18 Tage) +Speicherkapazität +[Tage] = + +###### 2048 + +``` +Speichersektoren +pro Tag +``` + +### Einstellungen - IO Zuordnung + +**Allgemeines** In diesem Menüpunkt können die Eigenschaften der einzelnen Ein- und +Ausgänge (I/O) des Wechselrichters konfiguriert werden. Je nach Funktionalität +und Systemkonfiguration können nur jene Einstellungen gewählt werden, welche +mit dem jeweiligen System möglich sind. + +``` +Ein aktiv geschalteter Ausgang, welcher nicht zugeordnet ist („frei“), bleibt bis +zum Neustart des Wechselrichters aktiv. Der Zustand eines Ausganges ändert +sich nur durch neue Vorgaben von zugeordneten Diensten. +``` +#### AUS - Demand Response Modes (DRM) + +``` +Demand Response Modes für Australien +``` +``` +Hier können die Pins für eine Steuerung via DRM eingestellt werden: +``` +``` +WICHTIG! Für eine Steuerung des Wechselrichters via DRM ist ein Fronius +DRM Interface (Artikelnummer 4,240,005) im Wechselrichter erforderlich. +Einbau und Installation sind in der Installationsanleitung des Fronius DRM In- +terface beschrieben. Die Installationsanleitung für das Fronius DRM Interface +ist auf der Fronius Homepage unter folgendem Link verfügbar: +``` +``` +http://www.fronius.com/QR-link/4204102292 +``` +``` +Mode Beschreibung Information +``` +``` +De- +fault- +Pin +DRM0 Wechselrichter trennt sich +vom Netz +``` +``` +Netzrelais öffnen +``` +``` +REF GEN geschlossen FDI +COM LOAD geschlossen +``` +``` +oder +``` +``` +Kombinationen von ungülti- +gen DRM1 - DRM8 +``` +###### FDI + +``` +DRM1 -Pnom ≤ 0 % ohne Trennung +vom Netz +``` +``` +begrenzt die Wirkleistungs- +Aufnahme +``` +###### 6 + +``` +DRM2 -Pnom ≤ 50 % begrenzt die Wirkleistungs- +Aufnahme +``` +###### 7 + +``` +DRM3 -Pnom ≤ 75 % & +Qrel* ≥ 0 % begrenzt die Wirkleistungs- +Aufnahme +``` +``` +und +``` +``` +setzt die Blindleistung +``` +###### 8 + + +``` +Mode Beschreibung Information +``` +``` +De- +fault- +Pin +DRM4 -Pnom ≤ 100 % Normalbetrieb ohne Be- +grenzung +``` +###### 9 + +``` +DRM5 +Pnom ≤ 0 % ohne Trennung +vom Netz +``` +``` +begrenzt die Wirkleistungs- +Abgabe +``` +###### 6 + +``` +DRM6 +Pnom ≤ 50 % begrenzt die Wirkleistungs- +Abgabe +``` +###### 7 + +``` +DRM7 +Pnom ≤ 75 % & -Qrel* ≥ 0 % begrenzt die Wirkleistungs- +Abgabe +``` +``` +und +``` +``` +setzt die Blindleistung +``` +###### 8 + +``` +DRM8 +Pnom ≤ 100 % Normalbetrieb ohne Be- +grenzung +``` +###### 9 + +``` +FDI am Fronius DRM Interface +* Die Werte für Qrel können im Menüpunkt EVU Editor eingestellt +werden. +``` +``` +Die Fernsteuerbarkeit der Wechselrichter bezieht sich immer auf die nominale +Geräteleistung. +``` +``` +WICHTIG! Ist am Datamanager keine DRM Steuerung (DRED) angeschlossen +und die Funktion AUS - Demand Response Mode (DRM) ist aktiviert, wechselt +der Wechselrichter in den Standby-Betrieb. +``` +**IO-Steuerung** Hier können die Pins für die IO-Steuerung eingestellt werden. Weitere Einstel- +lungen sind im Menü **EVU-Editor** > **IO-Steuerung** möglich. + +#### IO-Steuerung + +``` +De- +fault- +Pin IO-Steuerung +``` +``` +De- +fault- +Pin +IO-Steuerung 1 (optional) 2 IO-Steuerung 6 (optional) 7 +IO-Steuerung 2 (optional) 3 IO-Steuerung 7 (optional) 8 +IO-Steuerung 3 (optional) 4 IO-Steuerung 8 (optional) 9 +``` +IO-Steuerung 4 (optional) (^5) IO-Steuerung Rückmeldung +(optional) + +###### 0 + +``` +IO-Steuerung 5 (optional) 6 +``` +**Lastmanage- +ment** + +``` +Hier können bis zu vier Pins für das Lastmanagement ausgewählt werden. Weite- +re Einstellungen für das Lastmanagement sind im Menüpunkt Lastmanagement +verfügbar. +Default-Pin: 1 +``` + +### Einstellungen - Lastmanagement + +**Allgemeines** Über die Funktion Lastmanagement können die Ausgänge I/O 0 - I/O 3 so ge- +nutzt werden, dass diese einen Aktor (z. B. Relais, Schütz) ansteuern. +Ein angeschlossener Verbraucher kann somit durch die Vorgabe eines von der +Einspeise-Leistung abhängigen Ein- oder Ausschalt-Punktes gesteuert werden. + +**Lastmanage- +ment** + +``` +Steuerung +deaktiviert : Steuerung via Energiemanagement ist deaktiviert. +durch die produzierte Leistung : Steuerung via Energiemanagement erfolgt +durch die produzierte Leistung +per Leistungsüberschuss (bei Einspeise-Limits) : Steuerung via Energiemanage- +ment erfolgt per Leistungsüberschuss (bei Einspeise-Limits). +Diese Option ist nur auswählbar, wenn ein Zähler angeschlossen wurde. Sollten +die I/Os eine höhere Priorität als die Batterie haben, wird die eventuelle Ladeleis- +tung der Batterie als Überschuss betrachtet. In diesem Fall ist die Schaltschwel- +le nicht auf den Netzübergang festzumachen. +``` +``` +Schwellen +ein : Zum Eingeben eines Wirkleistungs-Limit, ab dem der Ausgang I/O aktiviert +wird +aus : Zum Eingeben eines Wirkleistungs-Limit, ab dem der Ausgang I/O deakti- +viert wird. +Ist unter Steuerungper Leistungsüberschuss ausgewählt, wird unter Schwellen +zusätzlich ein Auswahlfeld für Einspeisung und Bezug angezeigt. +``` +``` +Laufzeiten +Mindestlaufzeit je Einschaltvorgang : Feld zum Eingeben einer Zeit, wie lange der +Ausgang I/O je Einschaltvorgang mindestens aktiviert sein soll. +Maximale Laufzeit je Tag : Feld zum Eingeben einer Maximalzeit, wie lange der +Ausgang I/O pro Tag insgesamt aktiviert sein soll (mehrere Einschaltvorgänge +werden berücksichtigt). +``` +``` +Soll-Laufzeit +je Tag : Feld zum Eingeben einer Zeit, wie lange der Ausgang I/O je Tag mindes- +tens aktiviert sein soll. +erreicht bis : Feld zur Auswahl der Zeit, falls die Soll-Laufzeit bis zu einer be- +stimmten Uhrzeit erreicht werden soll +``` +``` +Status +Wird der Mauszeiger über den Status gebracht, wird der Grund für den aktuellen +Status angezeigt. +``` +``` +WICHTIG! +Bei Verwendung von mehreren Lastausgängen werden diese je nach Priorität mit +einem Abstand von einer Minute geschaltet (max. 4 Regel = max. 4 Minuten). +``` + +### Einstellungen - Push Service + +**Push Service** Mit Hilfe dieser Funktion können Aktuell- und Log-Daten in unterschiedlichen +Formaten oder mit unterschiedlichen Protokollen auf einen externen Server ex- +portiert werden. + +``` +Weitere Informationen zur Push Service Funktion finden Sie in folgender Bedie- +nungsanleitung: +``` +``` +http://www.fronius.com/QR-link/4204102152 +``` +``` +42,0410,2152 +``` +#### Push Service + + +### Einstellungen - Modbus + +**Allgemeines** Über die Web-Seite des Fronius Datamanager 2.0 können via Web-Browser Ein- +stellungen für die Modbus-Anbindung vorgenommen werden, welche über das +Modbus-Protokoll nicht ansprechbar sind. + +**Weitere Infor- +mationen zur +Modbus-Funkti- +on** + +``` +Weitere Informationen zur Modbus-Funktion finden Sie in folgenden Bedie- +nungsanleitungen: +``` +``` +http://www.fronius.com/QR-link/4204102049 +``` +``` +42,0410,2049 +Fronius Datamanager Modbus Anbindung +``` +``` +http://www.fronius.com/QR-link/4204102108 +``` +``` +42,0410,2108 +Fronius Datamanager Modbus RTU Quickstart Guide +``` +#### Datenausgabe über Modbus + +``` +Datenausgabe über Modbus auf aus +Ist die Datenausgabe über Modbus deaktiviert, werden über Modbus an die +Wechselrichter übertragene Steuerungsbefehle zurückgesetzt, z. B. keine Leis- +tungsreduktion oder keine Blindleistungs-Vorgabe. +``` +``` +Datenausgabe über Modbus auf tcp +Ist die Datenausgabe über Modbus deaktiviert, werden über Modbus an die +Wechselrichter übertragene Steuerungsbefehle zurückgesetzt, z. B. keine Leis- +tungsreduktion oder keine Blindleistungs-Vorgabe. +``` +``` +Feld Modbus Port - Nummer des TCP Ports, der für die Modbus-Kommunikation +zu verwenden ist. Voreinstellung: 502. Port 80 kann hierfür nicht verwendet wer- +den. +``` +``` +Feld „ String Control Adress-Offset - Offset-Wert für die Adressierung von Fro- +nius String Controls per Modbus. +``` +``` +Sunspec Model Type - zum Auswählen des Datentyps von Datenmodellen für +Wechselrichter und von Datenmodellen für Energiezähler +float - Darstellung als Gleitkommazahlen +SunSpec Inverter Model I111, I112 oder I113 +SunSpec Meter Model M211, M212 oder M213 +int+SF - Darstellung als ganze Zahlen mit Skalierungsfaktoren +SunSpec Inverter Model I101, I102 oder I103 +SunSpec Meter Model M201, M202 oder M203 +``` +``` +WICHTIG! Da die verschiedenen Modelle über unterschiedliche Anzahlen an Re- +gistern verfügen, ändern sich durch den Wechsel des Datentyps auch die Regis- +teradressen aller nachfolgenden Modelle. +``` +``` +Demo Modus - Der Demo Modus dient zur Implementierung oder Validierung ei- +nes Modbus Masters. Er ermöglicht es, Wechselrichter-, Energiezähler- und +``` + +String Control Daten auszulesen, ohne dass ein Gerät wirklich angeschlossen +oder aktiv ist. Es werden für alle Register immer dieselben Daten zurückgeliefert. + +**Wechselrichter-Steuerung über Modbus** +Wenn diese Option aktiviert ist, können die Wechselrichter über Modbus gesteu- +ert werden. Das Auswahlfeld **Steuerung einschränken** wird angezeigt. Zur Wech- +selrichter-Steuerung gehören folgende Funktionen: + +- Ein / Aus +- Leistungsreduktion +- Vorgabe eines konstanten Leistungs-Faktors cos Phi +- Vorgabe einer konstanten Blindleistung + +**Datenausgabe über Modbus** auf **rtu** + +Befindet sich ein unter **Einstellungen** > **Zähler** ein konfigurierter Modbus Ener- +giezähler (z. B. Fronius Smart Meter) im System, kann die Einstellung **rtu** nicht +verwendet werden. +Bei Auswahl von **rtu** wird in diesem Fall die Datenausgabe per Modbus automa- +tisch deaktiviert. Diese Änderung ist erst nach einem erneuten Laden der Web- +seite sichtbar. +Ein über RS485 angeschlossener Energiezähler kann auch per Modbus TCP über +die entsprechenden SunSpec Modelle ausgelesen werden. Die Modbus ID für +den Zähler ist 240. + +Feld **Schnittstelle** - Hier kann die Modbus-Schnittstelle 0 (rtu0 | default) oder +Modbus-Schnittstelle 1 (rtu1) ausgewählt werden. + +Feld **String Control Adress-Offset** - Offset-Wert für die Adressierung von Froni- +us String Controls per Modbus. Für weitere Details siehe Abschnitt „Modbus +Geräte-ID für Fronius String Controls“. + +**Sunspec Model Type** - zum Auswählen des Datentyps von Datenmodellen für +Wechselrichter +**float** - Darstellung als Gleitkommazahlen +SunSpec Inverter Model I111, I112 oder I113 +**int+SF** - Darstellung als ganze Zahlen mit Skalierungsfaktoren +SunSpec Inverter Model I101, I102 oder I103 + +**WICHTIG!** Da die verschiedenen Modelle über unterschiedliche Anzahlen an Re- +gistern verfügen, ändern sich durch den Wechsel des Datentyps auch die Regis- +teradressen aller nachfolgenden Modelle. + +**Demo Modus** - Der Demo Modus dient zur Implementierung oder Validierung ei- +nes Modbus Masters. Er ermöglicht es, Wechselrichter-, Energiezähler- und +String Control-Daten auszulesen, ohne dass ein Gerät wirklich angeschlossen +oder aktiv ist. Es werden für alle Register immer dieselben Daten zurückgeliefert. + +**Wechselrichter-Steuerung über Modbus** +Wenn diese Option aktiviert ist, können die Wechselrichter über Modbus gesteu- +ert werden. Zur Wechselrichter-Steuerung gehören folgende Funktionen: + +- Ein / Aus +- Leistungsreduktion +- Vorgabe eines konstanten Leistungs-Faktors cos Phi +- Vorgabe einer konstanten Blindleistung + +**Steuerungs-Prioritäten** +Die Steuerungs-Prioritäten legen fest, welcher Dienst bei der Wechselrichter- +steuerung priorisiert wird. +1 = höchste Priorität, 3 = niedrigste Priorität + + +``` +Die Steuerungs-Prioritäten können nur im Menüpunkt EVU-Editor geändert wer- +den. +``` +#### Steuerung einschränken + +**schränken** + +``` +Die Option Steuerung einschränken ist nur beim Übertragungsprotokollen tcp +verfügbar. +Sie dient dazu Wechselrichter-Steuerungsbefehle durch Unbefugte zu verhin- +dern, indem die Steuerung nur für bestimmte Geräte erlaubt wird. +``` +``` +Feld IP-Adresse +Um die Wechselrichter-Steuerung auf ein oder mehrere Geräte zu beschränken, +werden in diesem Feld die IP-Adressen jener Geräte eingetragen, die Befehle an +den Fronius Datamanager senden dürfen. Mehrere Einträge werden durch Bei- +striche getrennt. +``` +``` +Beispiele: +``` +- eine IP-Adresse: **98.7.65.4** - Steuerung nur durch IP-Adresse 98.7.65.4 + zulässig +- mehrere IP-Adressen: **98.7.65.4,222.44.33.1** - Steuerung nur durch IP- + Adressen 98.7.65.4 und 222.44.33.1 zulässig +- IP-Adressbereich z. B. von 98.7.65.1 bis 98.7.65.254 (CIDR Notation): + **98.7.65.0/24** - Steuerung nur durch IP-Adressen 98.7.65.1 bis 98.7.65.254 + zulässig + +#### Änderungen speichern oder verwerfen + +``` +Speichert die Einstellungen und zeigt eine Meldung an, dass die Speiche- +rung erfolgreich war. +Wird der Menüpunkt Modbus verlassen ohne zu speichern, so werden alle vorge- +nommenen Änderungen verworfen. +``` +``` +Stellt eine Sicherheitsabfrage ob die vorgenommenen Änderungen +tatsächlich verworfen werden sollen, und stellt dann die zuletzt gespeicherten +Werte wieder her. +``` + +### Einstellungen - Wechselrichter + +**Wechselrichter** Im Menü **Wechselrichter** werden die Daten für die Vergleichsansicht festgelegt. +Ist das Auswahlfeld **sichtbar** ausgewählt, wird der Wechselrichter in der Ver- +gleichsansicht angezeigt. + + +### Einstellungen - Fronius Sensor Cards + +**Sensor Cards** Unter Sensor Cards kann für jeden Sensorwert einer Fronius Sensor Card / Box +ein spezifischer Kanalname vergeben werden (z. B.: Windgeschwindigkeit). + + +## Einstellungen - Zähler + +**Allgemeines WICHTIG!** Einstellungen im Menüpunkt **Zähler** dürfen nur von geschultem Fach- +personal durchgeführt werden! + +``` +Für den Menüpunkt Zähler ist die Eingabe des Service-Passwortes erforderlich. +``` +``` +Dreiphasige oder einphasige Fronius Smart Meter können verwendet werden. Die +Auswahl erfolgt in beiden Fällen über den Punkt Fronius Smart Meter. Der Fro- +nius Datamanager ermittelt automatisch den Zählertyp. +``` +``` +Es kann ein Primärzähler und optional mehrere Sekundärzähler ausgewählt wer- +den. Der Primärzähler muss zuerst konfiguriert werden, bevor ein Se- +kundärzähler ausgewählt werden kann. +``` +### Fronius Smart Meter + +``` +Wenn der Fronius Smart Meter als Zähler ausgewählt wird, muss über das Feld +Einstellungen die Zählerposition eingestellt werden. +``` +``` +Zählerposition am Einspeisepunkt (1a) +Die eingespeiste Leistung und Energie werden gemessen. Anhand dieser Werte +und der Anlagendaten wird der Verbrauch bestimmt. +``` +``` +Zählerposition im Verbrauchszweig (1b) +Die verbrauchte Leistung und Energie werden direkt gemessen. Anhand dieser +Werte und der Anlagendaten werden die eingespeiste Leistung und Energie be- +stimmt. +``` +``` +(1a) +``` +``` +(1b) +``` +``` +Sekundärzähler +Wenn als Sekundärzähler ein Fronius Smart Meter ausgewählt wurde, öffnet sich +ein Fenster zum Eingeben der Bezeichnung (frei wählbar) und ein Modbus- +Adresse Feld. Im Modbus-Adresse Feld wird automatisch ein Wert vorgeschla- +gen (nächste freie Adresse im Adressbereich). Die Modbus-Adresse darf nicht +doppelt vergeben werden. Nach der Eingabe auf das Feld Scan klicken. +``` + +**Anschluss des +Fronius Smart +Meter am Froni- +us Datamanager +2.0** + +``` +Fronius Datamanager 2.0 +``` +``` +120 Ω ON +``` +###### - - D+ D- + +``` +Fronius Smart Meter +OUTPUT +RS 485 +D- D+ +``` +**S0-Wechselrich- +ter** + +``` +Zählerposition am Einspeisepunkt (1a) +Die eingespeiste Leistung und Energie werden gemessen. Anhand dieser Werte +und der Anlagendaten wird der Verbrauch bestimmt. +Ein S0-Zähler muss an dieser Stelle so konfiguriert sein, dass die eingespeiste +Energie gezählt wird. +``` +``` +WICHTIG! +Bei einem S0-Zähler am Einspeisepunkt werden die Zählerdaten nicht in Fronius +Solar.web angezeigt. Diese Option ist nur für die dynamische Leistungsreduzie- +rung vorgesehen. Die Verbrauchswerte können bei Einspeisung ins Netz einge- +schränkt ermittelt werden. +``` +``` +Zählerposition im Verbrauchszweig (1b) +Die verbrauchte Leistung und Energie werden direkt gemessen. Anhand dieser +Werte und der Anlagendaten werden die eingespeiste Leistung und Energie be- +stimmt. +Ein S0-Zähler muss an dieser Stelle so konfiguriert sein, dass die verbrauchte +Energie gezählt wird. +``` +``` +(1a) +``` +``` +(1b) +``` +``` +Ein Zähler zur Erfassung des Eigenverbrauchs per S0 kann direkt an den Wech- +selrichter angeschlossen werden. +``` +``` +WICHTIG! +Ein S0-Zähler wird an der schaltbaren Multifunktions-Stromschnittstelle des +Wechselrichters angeschlossen. Der Anschluss eines S0-Zählers am Wechsel- +richter kann eine Aktualisierung der Wechselrichter-Firmware erfordern. +``` + +Anforderungen an den S0-Zähler: + +- muss der Norm IEC62053-31 Class B entsprechen +- max. Spannung 15 V DC +- max. Strom bei ON 15 mA +- min. Strom bei ON 2 mA +- max. Strom bei OFF 0,15 mA + +``` +Empfohlene max. Impulsrate des S0-Zählers: +PV-Leistung kWp [kW] max. Impulsrate pro kWp +30 1000 +20 2000 +10 5000 +≤ 5,5 10000 +``` + +## Einstellungen - EVU Editor + +**Allgemeines** Im Menüpunkt **EVU-Editor** werden für ein Energieversorgungs-Unternehmen re- +levante Einstellungen vorgenommen. +Eingestellt werden können eine Wirkleistungs-Begrenzung in % und/oder eine +Leistungsfaktor-Begrenzung. + +``` +WICHTIG! Einstellungen im Menüpunkt EVU-Editor dürfen nur von geschultem +Fachpersonal durchgeführt werden! +``` +``` +Für den Menüpunkt EVU-Editor ist die Eingabe des Service-Passwortes erforder- +lich. +``` +``` +Cloud Control +Ein virtuelles Kraftwerk ist ein Zusammenschaltung mehrerer Erzeuger zu einem +Verbund. Dieser Verbund kann über die Cloud-Steuerung per Internet gesteuert +werden. Eine aktive Internetverbindung des Wechselrichters ist Voraussetzung +dafür. Es werden Daten der Anlage übermittelt. +Wenn die Funktion Cloud-Steuerung für Anforderungen des Netzbetreibers/ +Energieversorgers zulassen aktiviert ist (service-Zugang erforderlich), ist die +Funktion Cloud-Steuerung für virtuelle Kraftwerke zulassen automatisch akti- +viert und kann nicht deaktiviert werden. +Die Funktion Cloud-Steuerung für Anforderungen des Netzbetreibers/Energie- +versorgers zulassen kann für den ordnungsgemäßen Betrieb der Anlage ver- +pflichtend sein. +``` +### EVU Editor - IO-Steuerung + +``` +Eingangsmuster (Belegung der einzelnen I/Os): +``` +- **weiß** = Kontakt offen +- **blau** = Kontakt geschlossen +- **grau** = Kontakt nicht berücksichtigt +- **schwarz** = Kontakt nicht anwendbar + +``` +Durch Klicken auf die Kontakte verändert sich das ausgewählte Eingangsmuster. +``` +``` +Angezeigt wird die virtuelle IO Zuordnung gemäß Abschnitt „Einstellungen - IO +Zuordnung“ (siehe Seite 67 ). +Bei älteren Software-Versionen kann die Anzeige abweichen. +``` +``` +Leistungsfaktor cos phi +ind = induktiv +cap = kapazitiv +``` +``` +EVU Ausgang (Rückmeldungs-Ausgang) +Dieser Ausgang ist frei konfigurierbar und wird aktiviert, sobald die Regel gesetzt +ist.(z. B. zum Betrieb einer Signaleinrichtung). Werksseitig ist dafür der Ausgang +I/O 0 voreingestellt. +``` +``` +ausgeschlossene Wechselrichter +Hier die DATCOM- bzw. Fronius Solar Net- Nummern der Wechselrichter einge- +ben, die von der Regelung ausgeschlossen sein sollen. Mehrere Wechselrichter +durch Beistriche trennen. +``` +``` +Löschen / Hinzufügen einer Regel ++ = eine neue Regel hinzufügen +``` +**-** = die aktuell ausgewählte Regel löschen + + +``` +Schaltfläche Importieren - klicken, um Regeln im Format *.fpc zu importieren +Die Funktion der Schaltfläche Importieren ist vom verwendeten Browser +abhängig, z. B. unterstützen Mozilla Firefox und Google Chrome die Funktion. +``` +``` +Schaltfläche Exportieren - klicken, um die Regeln im Format *.fpc separat abzu- +speichern +``` +**Anschluss-Sche-** + +### Anschluss-Schema - 4 Relais + +``` +Der Rundsteuer-Signalempfänger und die I/Os Anschlussklemmen des Wechsel- +richters werden mittels 4-poligem Kabel gemäß Anschluss-Schema miteinander +verbunden. +Für Kabellängen größer 10 m zwischen Wechselrichter und Rundsteuer-Signal- +empfänger wird ein geschirmtes Kabel (CAT 5) empfohlen. +``` +``` +Der 4-Relais-Betrieb ist werksseitig voreingestellt. Die folgenden Schritte sind +nur notwendig, wenn die Konfiguration angepasst oder wiederhergestellt werden +muss. +``` +###### (2) + +``` +5 IO3IO1--D- +``` +(^84) 2OI +++D +97 +6 +0OI + +###### 100 % + +###### 60 % + +###### 30 % + +###### 0 % + +###### (1) + + +``` +IO 2 (Pin2) +``` +``` +IO 3 (Pin3) +``` +``` +I 4 (Pin4) +``` +``` +I 5 (Pin5) +``` +``` +(1) Rundsteuer-Signalempfänger mit 4 Relais, zur Wirkleistungs-Begrenzung. +(2) I/Os des Datenkommunikations-Bereichs. +``` +``` +IO-Zuordnung +``` +``` +Relais Anschluss Fronius Datamanager 2.0 PIN +1 IO1 2 +2 IO2 3 +3 IO3 4 +4 I 4 5 +``` +``` +Einstellungen am EVU Editor: +``` + +``` +Übersicht IO-Steuerung Benutzeroberfläche +``` +``` +1. In der Spalte “freigegeben“ Zeile 1-4 auswählen +2. Eingangsmuster konfigurieren +3. Wirkleistung wie folgt einstellen: +``` +- Regel 1: 100 %, Relaiskontakt 1 geschlossen +- Regel 2: 60 %, Relaiskontakt 2 geschlossen +- Regel 3: 30 %, Relaiskontakt 3 geschlossen +- Regel 4: 0 %, Relaiskontakt 4 geschlossen +4. Haken klicken, um die Einstellungen zu speichern. + +``` +WICHTIG! +``` +``` +Nicht berücksichtigte Eingangsmuster sind zu vermeiden, da sich die aktivierten +Regeln ansonsten gegenseitig ausschließen. In diesem Fall erscheint beim Spei- +chern der Dialog “Speichern gescheitert“. Die fehlerhaften Zeilen werden rot +markiert. +``` +**Anschluss-Sche-** + +### Anschluss-Schema - 3 Relais + +``` +Der Rundsteuer-Signalempfänger und die I/Os Anschlussklemmen des Wechsel- +richters werden mittels 4-poligem Kabel gemäß Anschluss-Schema miteinander +verbunden. +Für Kabellängen größer 10 m zwischen Wechselrichter und Rundsteuer-Signal- +empfänger wird ein geschirmtes Kabel (CAT 5) empfohlen. +``` +###### 60 % + +###### 30 % + +###### 0 % + +###### (1) + + +``` +IO 2 (Pin2) +``` +``` +IO 3 (Pin3) +``` +``` +I 4 (Pin4) +``` +###### (2) + +``` +5 IO3IO1--D- +``` +(^84) 2OI +++D +97 +6 +0OI + + +``` +(1) Rundsteuer-Signalempfänger mit 3 Relais, zur Wirkleistungs-Begrenzung +(2) I/Os des Datenkommunikations-Bereichs +``` +``` +IO-Zuordnung +``` +``` +Relais Anschluss Fronius Datamanager 2.0 PIN +1 IO1 2 +2 IO2 3 +3 IO3 4 +``` +``` +Einstellungen am EVU Editor: +``` +``` +Übersicht IO-Steuerung Benutzeroberfläche +``` +``` +1. In der Spalte “freigegeben“ Zeile 1-4 auswählen +2. Eingangsmuster für Zeile 1-3 konfigurieren +3. Wirkleistung wie folgt einstellen: +``` +- Zeile 1: 100 %, alle Kontakte offen, keine weiteren Regeln definiert +- Zeile 2 / Regel 1 60 %, Relaiskontakt 1 geschlossen +- Zeile 3 / Regel 2: 30 %, Relaiskontakt 2 geschlossen +- Zeile 4 / Regel 3: 0 %, Relaiskontakt 3 geschlossen +4. Haken klicken, um die Einstellungen zu speichern. + +``` +WICHTIG! +``` +``` +Nicht berücksichtigte Eingangsmuster sind zu vermeiden, da sich die aktivierten +Regeln ansonsten gegenseitig ausschließen. In diesem Fall erscheint beim Spei- +chern der Dialog “Speichern gescheitert“. Die fehlerhaften Zeilen werden rot +markiert. +``` +**Anschluss-Sche-** + +### Anschluss-Schema - 1 Relais + +``` +Der Rundsteuer-Signalempfänger und die I/Os Anschlussklemmen des Wechsel- +richters werden mittels 4-poligem Kabel gemäß Anschluss-Schema miteinander +verbunden. +Für Kabellängen größer 10 m zwischen Wechselrichter und Rundsteuer-Signal- +empfänger wird ein geschirmtes Kabel (CAT 5) empfohlen. +``` + +###### 100 % + +###### (1) + + +``` +IO 2 (Pin2) +``` +###### (2) + +``` +5 IO3IO1--D- +``` +(^84) 2OI +++D +97 +6 +0OI +(1) Rundsteuer-Signalempfänger mit 1 Relais, zur Wirkleistungs-Begrenzung. +(2) I/Os des Datenkommunikations-Bereichs +**IO-Zuordnung +Relais Anschluss Fronius Datamanager 2.0 PIN** +1 IO1 2 +**Einstellungen am EVU Editor:** +_Übersicht IO-Steuerung Benutzeroberfläche_ +1. In der Spalte **“freigegeben“** Zeile 1-2 auswählen +2. **Eingangsmuster** konfigurieren +3. **Wirkleistung** wie folgt einstellen: + +- Regel1: 100 %, Relaiskontakt 1 offen +- Regel 2: 0 %, Relaiskontakt 1 geschlossen +4. Haken klicken, um die Einstellungen zu speichern. + +**WICHTIG!** + +Nicht berücksichtigte Eingangsmuster sind zu vermeiden, da sich die aktivierten +Regeln ansonsten gegenseitig ausschließen. In diesem Fall erscheint beim Spei- +chern der Dialog **“Speichern gescheitert“**. Die fehlerhaften Zeilen werden rot +markiert. + + +**Anschluss-Sche- +ma - Alternative** + +### Anschluss-Schema - Alternative mit 2 Relais + +``` +Der Rundsteuer-Signalempfänger und die I/Os Anschlussklemmen des Wechsel- +richters werden mittels 4-poligem Kabel gemäß Anschluss-Schema miteinander +verbunden. +Für Kabellängen größer 10 m zwischen Wechselrichter und Rundsteuer-Signal- +empfänger wird ein geschirmtes Kabel (CAT 5) empfohlen. +``` +``` +Bei diesem Beispiel können 4 Leistungsstufen mit 2 Relais konfiguriert werden. +``` +``` +Relais 1 +``` +``` +Relais 2 +``` +###### (1) + + +``` +IO 2 (Pin2) +``` +``` +IO 3 (Pin3) +``` +###### (2) + +``` +5 IO3IO1--D- +``` +(^84) 2OI +++D +97 +6 +0OI +(1) Rundsteuer-Signalempfänger mit 2 Relais, zur Wirkleistungs-Begrenzung. +(2) I/Os des Datenkommunikations-Bereichs +**IO-Zuordnung +Relais Anschluss Fronius Datamanager 2.0 PIN** +1 IO1 2 +2 IO2 3 +**Einstellungen am EVU Editor:** +_Übersicht IO-Steuerung Benutzeroberfläche_ + + +``` +1. In der Spalte “freigegeben“ Zeile 1-4 auswählen +2. Eingangsmuster für Zeile 1-4 konfigurieren +3. Wirkleistung wie folgt einstellen: +``` +- Regel 1: 100 %, beide Relaiskontakte offen +- Regel 2: 60 %, Relaiskontakt 1 aktiv, PIN 2 geschlossen / Relaiskontakt 2 + nicht aktiv, PIN 3 offen +- Regel 3: 30 %, Relaiskontakt 1 nicht aktiv, PIN 2 offen / Relaiskontakt 2 + aktiv, PIN 3 geschlossen +- Regel 4: 0 %, beide Relaiskontakte geschlossen +4. Haken klicken, um die Einstellungen zu speichern. + +``` +WICHTIG! +``` +``` +Nicht berücksichtigte Eingangsmuster sind zu vermeiden, da sich die aktivierten +Regeln ansonsten gegenseitig ausschließen. In diesem Fall erscheint beim Spei- +chern der Dialog “Speichern gescheitert“. Die fehlerhaften Zeilen werden rot +markiert. +``` +**Awendungsbei- +spiel 2 Rund- +steuer- +Empfänger** + +``` +Der Rundsteuer-Signalempfänger und die I/Os Anschlussklemmen des Wechsel- +richters können gemäß Anschluss-Schema miteinander verbunden werden. +Für Entfernungen größer 10 m zwischen Wechselrichter und Rundsteuer-Signal- +empfänger wird mindestens ein CAT 5 Kabel empfohlen und die Schirmung muss +einseitig an der Push-in Anschlussklemme des Datenkommunikations-Bereichs +(SHIELD) angeschlossen werden. +``` +``` +In diesem Beispiel wird die Anbindung an 2 Rundsteuer-Empfänger beschrieben. +So kann gleichzeitig die Wirkleistung und der Leistungsfaktor geregelt werden. +``` +###### 60 % + +###### 30 % + +###### 0 % + +###### 0,95 + +###### 0,90 + +###### 0,85 + +###### (1) + +###### (2) + +###### (4) + +###### + + +###### - + +###### IO 2 + +###### IO 3 + +###### I 4 + +###### I 7 + +###### I 8 + +###### I 9 + +###### IO 0 + +###### (3) + +``` +5 IO3IO1- - D- +``` +``` +++ +D +8 +2OI +``` +``` +4 +``` +``` +97 +``` +``` +6 +0OI +``` +``` +2 Rundsteuer-Empfänger, angeschlossen an den IOs des Fronius Datamanager 2.0 +``` +``` +(1) Rundsteuer-Empfänger mit 3 Relais, zur Wirkleistungs-Begrenzung +(2) Rundsteuer-Empfänger mit 3 Relais, zur Leistungsfaktor-Begrenzung +(3) I/Os des Datenkommunikations-Bereichs +(4) Verbraucher (z. B. Signallampe, Signal-Relais) +``` +``` +IO-Zuordnung Rundsteuerempfänger 1 (Wirkleistung) +``` +``` +Relais Anschluss Fronius Datamanager 2.0 PIN +1 IO1 2 +2 IO2 3 +``` + +``` +Relais Anschluss Fronius Datamanager 2.0 PIN +3 I 4 4 +``` +**IO-Zuordnung Rundsteuerempfänger 2 (Leistungsfaktor)** + +``` +Relais Anschluss Fronius Datamanager 2.0 PIN +1 I 7 5 +2 I 8 6 +2 I 9 7 +``` +Einstellungen am EVU Editor: + +_Übersicht IO-Steuerung Benutzeroberfläche_ + +1. In der Spalte **“freigegeben“** Zeile 1-6 auswählen +2. **Eingangsmuster** für Zeile 1-6 konfigurieren +3. **Wirkleistung** wie folgt einstellen: + +- Regel 1: 100 %, Relaiskontakt 1 geschlossen +- Regel 2: 60 %, Relaiskontakt 2 geschlossen +- Regel 3: 30 %, Relaiskontakt 3 geschlossen +4. **Leistungsfaktor** wie folgt einstellen: +- Regel 1: 0,95, Relaiskontakt 4 geschlossen +- Regel 2: 0,90, Relaiskontakt 5 geschlossen +- Regel 3: 0,85, Relaiskontakt 6 geschlossen +5. Haken klicken, um die Einstellungen zu speichern. + +**WICHTIG!** + +Nicht berücksichtigte Eingangsmuster sind zu vermeiden, da sich die aktivierten +Regeln ansonsten gegenseitig ausschließen. In diesem Fall erscheint beim Spei- +chern der Dialog **“Speichern gescheitert“**. Die fehlerhaften Zeilen werden rot +markiert. + + +**Rundsteuer- +Empfänger mit +mehreren Wech- +selrichtern ver- +binden** + +``` +Der Netzbetreiber kann den Anschluss eines oder mehrerer Wechselrichter an +einen Rundsteuer-Empfänger fordern, um die Wirkleistung und/oder den Leis- +tungsfaktor der Photovoltaik-Anlage zu begrenzen. +``` +``` +12 volt power +Coupling relays +``` +``` +Anschluss-Schema Rundsteuer-Empfänger mit mehreren Wechselrichtern +``` +``` +Über einen Verteiler (Koppelrelais) können folgende Fronius-Wechselrichter mit +dem Rundsteuer-Empfänger verbunden werden: +``` +- Symo GEN24 +- Primo GEN24 +- Tauro +- SnapINverter (nur Geräte mit Fronius Datamanager 2.0) + +``` +WICHTIG! +Auf der Benutzeroberfläche jedes Wechselrichters, der mit dem Rundsteuer- +Empfänger verbunden ist, muss die Einstellung „4-Relais-Betrieb“ (siehe An- +schluss-Schema - 4 Relais ) aktiviert werden. +``` +### EVU Editor - AUS - Demand Response Modes (DRM) + +``` +WICHTIG! Für eine Steuerung des Wechselrichters via DRM ist ein Fronius +DRM Interface (Artikelnummer 4,240,005) im Wechselrichter erforderlich. +Einbau und Installation sind in der Installationsanleitung des Fronius DRM In- +terface beschrieben. Die Installationsanleitung für das Fronius DRM Interface +ist auf der Fronius Homepage unter folgendem Link verfügbar: +``` +``` +http://www.fronius.com/QR-link/4204102292 +``` +``` +Blindleistungsabgabe - zum Eingeben der Blindleistungsabgabe (= +Qrel) für +DRM 3 in % +``` +``` +Blindleistungsaufnahme - zum Eingeben der Blindeistungsaufnahme (= -Qrel) für +DRM 7 in % +``` + +### EVU Editor - Dynamische Leistungsreduzierung + +**namische Leis- +tungsreduzie- +rung** + +``` +Energieunternehmen oder Netzbetreiber können Einspeisebegrenzungen für ei- +nen Wechselrichter vorschreiben (z. B. max. 70 % der kWp oder max. 5 kW). +Die dynamische Leistungsreduzierung berücksichtigt dabei den Eigenverbrauch +im Haushalt, bevor die Leistung eines Wechselrichters reduziert wird: +``` +- Ein individuelles Limit kann eingestellt werden. +- Ein Zähler zur Ermittlung des Eigenverbrauchs per S0 kann direkt an den + Wechselrichter angeschlossen werden. +- Ein Fronius Smart Meter kann am Datamanager an den Anschlüssen D- / D+ + für Modbus Daten angeschlossen werden. + +``` +kein Limit - Der Wechselrichter wandelt die gesamte, zur Verfügung stehende +PV-Leistung um und speist diese in das öffentliche Netz ein. +``` +``` +Limit für gesamte Anlage - Die gesamte Photovoltaik-Anlage wird auf ein fixes +Leistungslimit begrenzt. Der Wert der zulässigen Gesamt-Einspeiseleistung ist +einzustellen. +``` +``` +Limit pro Phase (nicht für einphasige Geräte) - Jede einzelne Phase wird gemes- +sen. Wird bei einer Phase das zulässige Einspeiselimit überschritten, wird die Ge- +samtleistung des Wechselrichters soweit reduziert, bis der Wert auf der betrof- +fenen Phase wieder zulässig ist (siehe nachstehendes Beispiel). Diese Einstellung +ist nur notwendig falls dies von den nationalen Normen und Bestimmungen ge- +fordert wird. Der Wert der zulässigen Einspeiseleistung je Phase ist einzustellen. +„Limit pro Phase“ ist auf 20 Wechselrichter beschränkt. Bei Überschreitung des +Limits ist die Funktion der Leistungslimitierung nicht mehr gegeben. +``` +``` +Beispiel: „Limit pro Phase“ (Einstellwert 2000 W) +Max. mögliche Produktion [kW] 4 4 4 12 +Eingestellter Wert +„Limit pro Phase“ [kW] +``` +###### 2 + +###### 6 + +``` +Lastanforderung im Hausnetz +[kW] +``` +###### 2 3 5 10 + +``` +Lastabdeckung im Hausnetz +über PV-Anlage [kW] +``` +###### 2 2 2 6 + +``` +Bezug aus dem öffentlichen +Netz [kW] +``` +###### 0 1 3 4 + +``` +Feld zum Eingeben der gesamten DC Anlagenleistung in Wp. +Dieser Wert dient einerseits als Bezug für die Regelung, andererseits für den +Fehlerfall (z. B. bei Zählerausfall). +``` +``` +Feld zum Eingeben der max. Leistung in W oder % (bis zu zwei Stellen nach dem +Komma, auch negative Werte sind möglich) +wenn im Menüpunkt Zähler kein Zähler ausgewählt wurde: +max. produzierte Leistung der gesamten Anlage +wenn im Menüpunkt Zähler Fronius Smart Meter oder S0-Wechselrichter aus- +gewählt wurde: max. Netzeinspeiseleistung +``` +``` +Hard Limit - bei Überschreiten dieses Wertes, schaltet der Wechselrichter inner- +halb von max. 5 Sekunden ab. Dieser Wert muss höher als der eingestellte Wert +bei Soft Limit sein. +``` +``` +Soft Limit - bei Überschreiten dieses Wertes regelt der Wechselrichter innerhalb +der von den nationalen Normen und Bestimmungen geforderten Zeit auf den ein- +gestellten Wert herab. +``` + +### EVU Editor - Steuerungs-Prioritäten + +``` +Zum Einstellen der Steuerungsprioritäten für den Rundsteuersignal Empfänger, +die dynamische Leistungsreduzierung und die Steuerung über Modbus +``` +``` +1 = höchste Priorität, 3 = niedrigste Priorität +``` + + + +- + - + + diff --git a/extensions/fronius-inverter/API Documentation/fronius solar API.md b/extensions/fronius-inverter/API Documentation/fronius solar API.md new file mode 100644 index 00000000000..bdeeac957d7 --- /dev/null +++ b/extensions/fronius-inverter/API Documentation/fronius solar API.md @@ -0,0 +1,4932 @@ +##### EN + +/ Perfect Charging / Perfect Welding / Solar Energy + +Fronius Solar API V + +``` +Operating Instructions +``` +##### 42,0410,2012,EN 021 - 21012025 + + + +## Contents + + + +- 1 Introduction +- 2 General Considerations + - 2.1 Output Formats + - 2.2 Fronius GEN24 and Tauro.................................................................................................................................... + - 2.2.1 Client Generation using OAS + - 2.2.2 Inverter to inverter communication + - 2.3 Data Types + - 2.3.1 Numeric Types + - 2.3.2 Date/Time + - 2.4 Requests + - 2.4.1 Querying of API version + - 2.4.2 Addressing of devices + - 2.5 Responses + - 2.5.1 Availability + - 2.5.2 Common Response Header + - 2.5.3 Request Body + - 2.6 Timeout +- 3 Enable/Disable +- 4 Realtime Requests + - 4.1 GetInverterRealtimeData request + - 4.1.1 Availability + - 4.1.2 Collection availability + - 4.1.3 URL for HTTP requests + - 4.1.4 Parameters + - 4.1.5 Data Collections + - 4.1.6 Object structure of response body (Scope ”Device”) + - 4.1.7 Example of response body (Scope ”Device”) + - 4.1.8 Object structure of response body (Scope ”System”) + - 4.1.9 Example of response body (Scope ”System”) + - 4.2 GetSensorRealtimeData request + - 4.2.1 Availability + - 4.2.2 URL for HTTP requests + - 4.2.3 Parameters + - 4.2.4 Data Collections + - 4.2.5 Object structure of response body (DataCollection ”NowSensorData”) + - 4.2.6 Example of response body (DataCollection ”NowSensorData”) + - 4.2.7 Object structure of response body (DataCollection ”MinMaxSensorData”) + - 4.2.8 Example of response body (DataCollection ”MinMaxSensorData”) + - 4.3 GetStringRealtimeData request + - 4.3.1 Availability + - 4.3.2 URL for HTTP requests + - 4.3.3 Parameters + - 4.3.4 Collection availability + - 4.3.5 Data Collections + - StringControlData”) 4.3.6 Object structure of response body (DataCollection ”NowStringControlData” and ”CurrentSum- + - 4.3.7 Example of response body (DataCollection ”CurrentSumStringControlData”) + - 4.3.8 Object structure of response body (DataCollection ”LastErrorStringControlData”) + - 4.3.9 Example of response body (DataCollection ”LastErrorStringControlData”) + - 4.3.10 Object structure of response body (DataCollection ”NowStringControlData”) + - 4.3.11 Example of response body (DataCollection ”NowStringControlData”) + - 4.4 GetLoggerInfo request + - 4.4.1 Availability + - 4.4.2 URL for HTTP requests + - 4.4.3 Object structure of response body + - 4.4.4 Example of response body + - 4.5 GetLoggerLEDInfo request + - 4.5.1 Availability + - 4.5.2 URL for HTTP requests + - 4.5.3 Object structure of response body + - 4.5.4 Example of response body + - 4.6 GetInverterInfo request + - 4.6.1 Availability + - 4.6.2 URL for HTTP requests + - 4.6.3 Object structure of response body + - 4.6.4 Example of response body + - 4.6.5 Meaning of numerical status codes + - 4.7 GetActiveDeviceInfo request + - 4.7.1 Availability + - 4.7.2 URL for HTTP requests + - 4.7.3 Parameters + - 4.7.4 DeviceClass is not System + - 4.7.5 DeviceClass is System + - 4.8 GetMeterRealtimeData request + - 4.8.1 Availability + - 4.8.2 URL for HTTP requests + - 4.8.3 Parameters + - 4.8.4 Devicetypes and provided channels + - 4.8.5 Channel Descriptions + - 4.8.6 Meter Location Dependend Directions (primary meter) + - 4.8.7 Meter Location Dependend Directions (secondary meter) + - 4.8.8 System-Request + - 4.8.9 Device-Request + - 4.9 GetStorageRealtimeData request + - 4.9.1 Availability + - 4.9.2 3rd Party Batteries + - 4.9.3 Supported + - 4.9.4 URL for HTTP requests + - 4.9.5 Parameters + - 4.9.6 Reference to manual + - 4.9.7 Channel Descriptions + - 4.9.8 System-Request + - 4.9.9 Device-Request + - 4.10 GetOhmPilotRealtimeData request + - 4.10.1 Availability + - 4.10.2 URL for HTTP requests + - 4.10.3 Parameters + - 4.10.4 Reference to manual + - 4.10.5 System-Request + - 4.10.6 Device-Request + - 4.11 GetPowerFlowRealtimeData request + - 4.11.1 Availability + - 4.11.2 Version...................................................................................................................................................... + - 4.11.3 URL for HTTP requests + - 4.11.4 Parameters + - 4.11.5 Request +- 5 Archive Requests + - 5.1 Common + - 5.1.1 Availability + - 5.1.2 ChannelId + - 5.1.3 Parameters + - 5.1.4 Object Structure of response body + - 5.2 Example of response body + - 5.2.1 Meter data + - 5.2.2 Inverter data + - 5.2.3 Errors - Structure + - 5.2.4 Events - Structure + - 5.2.5 OhmPilot Energy +- 6 Definitions and Mappings + - 6.1 Sunspec State Mapping + - 6.2 Inverter Device Type List..................................................................................................................................... + - 6.3 Event Table for Fronius Devices + - 6.4 Hybrid_Operating_State + - 6.5 Meter Locations +- 7 Changelog +- 8 Frequently asked questions + + +## 1& It is strongly recommended to use appropriate frameworks or tools to parse json objects properly + +## 1 Introduction + +The Fronius Solar API is a means for third parties to obtain data from various Fronius devices (inverters, Sensor- +Cards, StringControls) in a defined format through a central facility which acts as a proxy (e.g. Fronius Datalogger +Web or Fronius Solar.web). + +Currently, the only way to interact with this API is by making a HTTP request to a specific CGI. The URLs for +the particular requests and the devices supporting them are listed at the beginning of each request description. +The API is versioned, meaning that multiple versions of this API may be available on the same device. The URLs +in this document always point to the version of the API which this document describes. The highest supported +version on the device can be queried. See 2.4.1 for details. +In order to check your product for compatibility with this version of the API specification, please see the separate +document provided for this purpose. + +The API divides roughly into realtime and archive requests: Realtime requests will obtain the data directly from the +devices and can therefore only be used when the devices are not in standby or unavailable in any other manner. +Archive requests will use the data stored in a central logging facility to obtain the results and are of course not +subjected to the former limitation. + +## 2 General Considerations + +### 2.1 Output Formats + +Currently, the only output format supported is JSON, a lightweight data interchange format. It is easy to read +and write for both humans and machines and it offers some advantages over XML, like basic typing and a leaner +structure. + +### 2.2 Fronius GEN24 and Tauro.................................................................................................................................... + +#### 2.2.1 Client Generation using OAS + +We provide an OpenAPI interface specification 1 file for GEN24/Tauro/Verto inverters to support client generation +in multiple languages. + +``` +Download the file here: https://www.fronius.com/QR-link/0025. +``` +To display the spec you can use https://editor.swagger.io, for proper client generation please use https: +//openapi-generator.tech. + +#### 2.2.2 Inverter to inverter communication + +Collecting data from multiple inverters in the same network is not supported by so called system requests on +GEN24/Tauro/Verto devices. To gather the information please invoke ident requests on all GEN24/Tauro/Verto +inverters interested by you. + +### 2.3 Data Types + +#### 2.3.1 Numeric Types + +JSON only knows one kind of numeric type, which can represent both floating point and integer values. It is how- +ever possible to specify a type in JSON description, but it is always in the hands of the interpreting system into +which datatype a numeric node is converted. +Which range a certain numeric node actually can have is often determined by the device providing the value, +and may also vary depending on the type of device (e.g. ”UAC” can be an integer value on older inverters, but a +floating point value on newer ones). + +(^1) https://swagger.io/specification + + +## 1& Use HTTP-GET requests to query data from Solar API + +``` +# all Datamanager and Hybridmanager support only APIVersion 1 +``` +This means we cannot reliably specify value ranges for all requests. So it is the responsibility of the API user +to determine whether a value fits into a certain datatype in his language of choice. +What we can do is to specify whether a certain value is a floating point value (marked as ”number”) or an integer +value (marked as ”integer”), where ”integer” must not be interpreted as the datatype ”int” like available in C/C++, +it just means it is a value without decimal places. +For these specifications, please refer to the sections discussing the respective request. + +Examples + +number 1, - 2, 0, 4, 4.0, 0.001, - 10.002, .... + +integer 1, - 2, 0, 4, - 10 + +unsigned integer 1, 0, 4, 10 + +unsigned number 1, 0, 4, 10, 0.001, 14. + +#### 2.3.2 Date/Time + +Information on date/time is always (and can only be) represented by a string. The format for these strings inside +this API has been defined as follows. + +- Strings which include information on both date and time are always in RFC3339 format with time zone offset + or Zulu marker. + See Section 5.6 of RFC + Example 1: 2011 - 10 - 20T10:23:17+02:00 (UTC+2) + Example 2: 2011 - 10 - 20T08:23:17Z (UTC) +- Strings which only include information on the date are of the format yyyy-MM-dd. +- Strings which only include information on the time are of the format hh:mm:ss. +- If no information on the time zone is given, any date/time specification is considered to be in local time of + the PV system. +- Gen24 requests are always in UTC format. + +### 2.4 Requests + +Currently, the only request protocol supported is HTTP. + +#### 2.4.1 Querying of API version + +The highest supported version on the device can be queried using the URL +/solar_api/GetAPIVersion.cgi. + +``` +Listing 1: Object structure of GetAPIVersion response +``` + +{ +" A PIVersion" : 1, +" BaseURL" : "/ solar_api/v1/", +" CompatibilityRa nge" : "1.5 - 9" +} + +``` +object { +``` +``` +object Head: {}*; +``` +``` +object Body: {}*; +``` +} + +``` +" MgmtTimerRemainingTime" : - 1, +``` +``` +Listing 2: Example: Complete response for GetAPIVersion request +``` +#### 2.4.2 Addressing of devices + +A specific device is identified by the string parameter DeviceId. +For Fronius Solar Net devices this string shall contain the numeric address of the targeted device. +Future generations of Fronius devices may also use non numerical addresses, so this API is designed to allow +for both. + +### 2.5 Responses + +The response will always be a valid JSON string ready to be evaluated by standard libraries. +If the response is delivered through HTTP, the Content-Type Header shall be either text/javascript or +application/json. + +All JSON structures are described using Orderly JSON, a textual format for describing JSON data. Please refer +to the online documentation on https://github.com/lloyd/orderly/ for details. +Note that the definitions of some response bodies are not totally accurate, because there’s no (known) way to +express nodes named after values/channels (e.g. objects which are named ”PAC” or ”Power”). But each descrip- +tion is accompanied by an example which should clear up any uncertainty. + +The contents of the response object will vary depending on the preceding request but it always contains a common +response header and a request body. + +``` +Listing 3: Object structure of valid response +``` +``` +Listing 4: Example: Complete response for GetInverterRealtimeData request on non hybrid system +``` + +#### 2.5.1 Availability + +A request is listed as ”Available” if the response http code differs to 404 (not found). It does not relay to technical +compatibility nor functionality. + +#### 2.5.2 Common Response Header + +The common response header (CRH) is present in every response. It indicates, among other things, whether the +request has been successful and the body of the response is valid. + +``` +Listing 5: Object Structure of Common Response Header +``` +``` +" RequestArguments" : { +``` + +``` +Value Status Description +0 OKAY Request successfully finished, Data are valid +1 NotImplemented The request or a part of the request is not implemented yet +2 Uninitialized Instance of APIRequest created, but not yet configured +3 Initialized Request is configured and ready to be sent +4 Running Request is currently being processed (waiting for response) +5 Timeout Response was not received within desired time +6 Argument Error Invalid arguments/combination of arguments or missing arguments +7 LNRequestError Something went wrong during sending/receiving of LN-message +8 LNRequestTimeout LN-request timed out +9 LNParseError Something went wrong during parsing of successfully received LN-message +10 ConfigIOError Something went wrong while reading settings from local config +11 NotSupported The operation/feature or whatever is not supported +12 DeviceNotAvailable The device is not available +255 UnknownError undefined runtime error +``` +``` +Table 1: Error Code Table +``` +#### 2.5.3 Request Body + +The request body contains the actual data produced by the request and is therefore different for each request. +The object structures of the various response bodies will be detailed later in the description of the respective API +request. + +### 2.6 Timeout + +Up to 2 realtime requests are allowed to be performed in parallel with keeping a timeout of 4 seconds between +two consecutive calls. +Archive requests are not allowed to be performed in parallel and need to keep a timeout of 120 seconds between +two consecutive calls. + +## 3 Enable/Disable + +The Solar API’s enable/disable feature is available on GEN24 only. + +The configuration to enable or disable the Solar API can be found in the WebUI under Communication - So- +lar API ( 1 ). + +If the Solar API is disabled, a Solar API request will return with a 404 - HTTP-error and the message ”Solar API + +``` +OK +``` +``` +NOT when +``` + +``` +Figure 1: Solar API activation/deactivation +``` +disabled by customer config” will be displayed. + +Default enable/disable behaviour: + +- For new devices with a bundle version of 1.14.1 or higher the Solar API is deactivated per default. +- For existing devices which are updated, the Solar API remains enabled. +- If a factory reset is performed with existing devices running a bundle version of 1.14.1 or higher, the Solar + API will be deactivated per default as well. + +## 4 Realtime Requests + +These requests will be provided where direct access to the realtime data of the devices is possible. This is cur- +rently the case for the Fronius Datalogger Web and the Fronius Datamanager. + +In order to eliminate the need to specify each wanted value separately when making a request or querying each +value separately, so called ”Data Collections” were defined. +The values in these collections are gathered from one or more Fronius Solar Net messages and supplied to the +user in a single response to a certain request. +It may be the case that more values are queried from the device than the user is interested in, but the overhead +caused by these superfluous values should be negligible compared to the advantages this strategy provides for +the user. + +If a device cannot provide some values of a DataCollection (e.g. because they are not implemented on +the device) then those values are omitted from the response. + +### 4.1 GetInverterRealtimeData request + +This request does not care about the configured visibility of single inverters. All inverters are reported. + +#### 4.1.1 Availability + +``` +Platform +Fronius Hybrid +Fronius Non Hybrid +Fronius GEN24/Tauro/Verto +``` +``` +Since version +Not all DataCollections supported +ALWAYS +Not all DataCollections supported +``` +#### 4.1.2 Collection availability + +``` +DataCollection +supported on +``` +``` +CumulationInverterData +CommonInverterData +3PInverterData +MinMaxInverterData +``` +``` +Fronius Hybrid Systems +Yes +Yes +Yes +NO +``` +``` +Fronius GEN24/Tauro/Verto +Yes +Yes +Only on 3 phase inverters +NO +``` + +#### 4.1.3 URL for HTTP requests + +/solar_api/v1/GetInverterRealtimeData.cgi + +#### 4.1.4 Parameters + +``` +Parameter Type Range/Values/Pattern Description +Scope String ”Device” +”System” +``` +``` +Query specific device(s) +or whole system (uses collection ”Cumu- +lationInverterData”) +DeviceId String Solar Net: 0 ...99 Only needed for Scope ”Device” +Which inverter to query. +DataCollection String ”CumulationInverterData” +”CommonInverterData” +”3PInverterData” +”MinMaxInverterData” +``` +``` +Only needed for Scope ”Device” +Selects the collection of data that should +be queried from the device. +See 4.1.5 for details. +``` +#### 4.1.5 Data Collections + +CumulationInverterData Values which are cumulated to generate a system overview. + +``` +Value name specific data type Description +PAC integer AC power (negative value for consuming power) +DAY_ENERGY unsigned number AC Energy generated on current day +Non Hybrid: May be imprecise +GEN24/Tauro/Verto: will always report null +YEAR_ENERGY unsigned number AC Energy generated in current year +Non Hybrid: May be imprecise +GEN24/Tauro/Verto: will always report null +TOTAL_ENERGY unsigned number AC Energy generated overall +Non Hybrid: May be imprecise +GEN24/Tauro/Verto: supported since 1.14 (updated ev- +ery 5min) +DeviceStatus object Status information about inverter +``` +CommonInverterData Values which are provided by all types of Fronius inverters. + + +``` +Value name specific data type Description +PAC integer AC power (negative value for consuming power) +SAC unsigned integer AC power (absolute) +Currently not implemented because not handled correctly +by all inverters. +GEN24/Tauro/Verto report this value +IAC unsigned number AC current (absolute, accumulated over all lines) +UAC unsigned number AC voltage +FAC unsigned number AC frequency +IDC unsigned number DC current +IDC_x unsigned number DC current of MPPT tracker x (x = 2..4; available on +GEN24/Tauro/Verto only) +UDC unsigned number DC voltage +UDC_x unsigned number DC voltage of MPPT tracker x (x = 2..4; available on +GEN24/Tauro/Verto only) +DAY_ENERGY unsigned number AC Energy generated on current day +Non Hybrid: May be imprecise +GEN24/Tauro/Verto: will always report null +YEAR_ENERGY unsigned number AC Energy generated in current year +Non Hybrid: May be imprecise +GEN24/Tauro/Verto: will always report null +TOTAL_ENERGY unsigned number AC Energy generated overall +Non Hybrid: May be imprecise +GEN24/Tauro/Verto: supported since 1.14(updated every +5min) +DeviceStatus object Status information about inverter +``` +3PInverterData Values which are provided by 3phase Fronius inverters. + +``` +Value name specific data type Description +IAC_L1 unsigned number AC current Phase 1 (absolute) +IAC_L2 unsigned number AC current Phase 2 (absolute) +IAC_L3 unsigned number AC current Phase 3 (absolute) +UAC_L1 unsigned number AC voltage Phase 1 +UAC_L2 unsigned number AC voltage Phase 2 +UAC_L3 unsigned number AC voltage Phase 3 +T_AMBIENT integer Ambient temperature +Most inverter like GEN24/Tauro/Verto do not provide it. +Only provided by CL, XL and IG500/400. +ROTATION_SPEED_FAN_FL unsigned integer Rotation speed of front left fan +not provided on GEN24/Tauro/Verto +ROTATION_SPEED_FAN_FR unsigned integer Rotation speed of front right fan +not provided on GEN24/Tauro/Verto +ROTATION_SPEED_FAN_BL unsigned integer Rotation speed of back left fan +not provided on GEN24/Tauro/Verto +ROTATION_SPEED_FAN_BR unsigned integer Rotation speed of back right fan +not provided on GEN24/Tauro/Verto +``` +MinMaxInverterData Minimum- and Maximum-values of various inverter values. + + +``` +object { +``` +# Collection of named value - unit pairs according to selected DataCollection. +# Members of Data object are named according to the value they represent (e.g. "PAC"). +**object** { + +``` +# Value - Unit pair. +object { +``` +``` +# Unscaled value. +# value name based specific data type + Value; +``` +``` +# Base unit of the value , never contains any prefixes. +string Unit; +``` +``` +} V A L U E _ N A M E ; +``` +}* Data; +}; + +``` +" MgmtTimerRemainingTime" : - 1, +``` +``` +Value name specific data type Description +DAY_PMAX unsigned integer Maximum AC power of current day +DAY_UACMAX number Maximum AC voltage of current day +DAY_UACMIN number Minimum AC voltage of current day +DAY_UDCMAX number Maximum DC voltage of current day +YEAR_PMAX unsigned integer Maximum AC power of current year +YEAR_UACMAX number Maximum AC voltage of current year +YEAR_UACMIN number Minimum AC voltage of current year +YEAR_UDCMAX number Maximum DC voltage of current year +TOTAL_PMAX unsigned integer Maximum AC power of current year +TOTAL_UACMAX number Maximum AC voltage overall +TOTAL_UACMIN number Minimum AC voltage overall +TOTAL_UDCMAX number Maximum DC voltage overall +``` +#### 4.1.6 Object structure of response body (Scope ”Device”) + +``` +Listing 6: Object structure of response body for GetInverterRealtimeData request (Scope ”Device”) +``` +#### 4.1.7 Example of response body (Scope ”Device”) + +``` +Listing 7: Response body for GetInverterRealtimeData scope=”Device” and collection=”CommonInverterData” +``` + +``` +"UAC_L2 " : { +``` +Listing 8: Response body for GetInverterRealtimeData scope=”Device” and collection=”3PInverterData” on Symo +Hybrid + +``` +" RequestArguments" : { +``` + +``` +"UAC_L3 ": { +``` +``` +" RequestArguments" : { +``` +Listing 9: Response body for GetInverterRealtimeData scope=”Device” and collection=”3PInverterData” on +GEN24 Symo + +``` +" RequestArguments" : { +``` + +Listing 10: Response body for GetInverterRealtimeData scope=”Device” and collection=”CommonInverterData” +on GEN24 Symo + +{ +"Body" : { +"Data" : { +" D A Y _ E N E R GY " : { +"Unit" : "Wh", +"Value" : **null** +}, +" DeviceStatus" : { +" ErrorCode" : 0, +" InverterState" : " Running", +" StatusCode" : 7 +}, +"FAC" : { +"Unit" : "Hz", +"Value" : 50. +}, +"IAC" : { +"Unit" : "A", +"Value" : 1. +}, +"IDC" : { +"Unit" : "A", +"Value" : 0. +}, +"IDC_2 " : { +"Unit" : "A", +"Value" : 0. +}, +"IDC_3 " : { +"Unit" : "A", +"Value" : 0. +}, +"IDC_4 " : { +"Unit" : "A", +"Value" : 0. +}, +"PAC" : { +"Unit" : "W", +"Value" : 1965. +}, +"SAC" : { +"Unit" : "VA", +"Value" : 1965. +}, +" TO T A L_ E N E R G Y " : { +"Unit" : "Wh", +"Value" : 3120. +}, +"UAC" : { +"Unit" : "V", +"Value" : 234. +}, +"UDC" : { +"Unit" : "V", +"Value" : 1. +}, +"UDC_2 " : { +"Unit" : "V", + + +{ +"Body" : { +"Data" : { +" DeviceStatus:" : { +" InverterState" : " Running" +}, +"PAC" : { +"Unit" : "W", +"Value" : 8.4296154682294417 e+ +} +} +}, +"Head" : { +" RequestArguments" : { +" Data Coll ection" : " C umulationInverter Data", +" DeviceClass" : " Inverter", +" DeviceId" : "1", +"Scope" : "Device" +}, +"Status" : { +"Code" : 0, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2019 - 08 - 28 T05 :59:13+00:00 " +} +} + +Listing 11: Response body for GetInverterRealtimeData scope=”Device” and collection=”CumulationInverterData” +on GEN24 Primo + +Listing 12: Response body for GetInverterRealtimeData scope=”Device” and collection=”CumulationInverterData” +on Tauro + +``` +" RequestArguments" : { +``` + +"Data" : { +" D A Y _ E N E R GY " : { +"Unit" : "Wh", +"Value" : **null** +}, +" DeviceStatus" : { +" ErrorCode" : 0, +" InverterState" : " Running", +" StatusCode" : 7 +}, +"FAC" : { +"Unit" : "Hz", +"Value" : 50. +}, +"IAC" : { +"Unit" : "A", +"Value" : 426. +}, +"IDC" : { +"Unit" : "A", +"Value" : 8. +}, +"IDC_2 " : { +"Unit" : "A", +"Value" : **null** +}, +"IDC_3 " : { +"Unit" : "A", +"Value" : **null** +}, +"IDC_4 " : { +"Unit" : "A", +"Value" : 0. +}, +"PAC" : { +"Unit" : "W", +"Value" : 2941. +}, +"SAC" : { +"Unit" : "VA", +"Value" : 100970. +}, +" TO T A L_ E N E R G Y " : { +"Unit" : "Wh", +"Value" : 36742265. +}, +"UAC" : { +"Unit" : "V", +"Value" : 236. +}, +"UDC" : { +"Unit" : "V", +"Value" : 636. +}, +"UDC_2 " : { +"Unit" : "V", +"Value" : **null** +}, +"UDC_3 " : { +"Unit" : "V", +"Value" : **null** +}, +"UDC_4 " : { +"Unit" : "V", +"Value" : 409. +}, +" Y E A R_ E N E R GY " : { + + +``` +object { +``` +# Collection of named object(s) containing values per device and metadata. +# Members of Data object are named according to the value they represent (e.g. "PAC"). +**object** { + +``` +# Value - Unit pair. +object { +``` +``` +# Base unit of the value , never contains any prefixes. +string Unit; +``` +``` +# Unscaled values per device. +# Property name is the DeviceId to which the value belongs. +object { +``` +``` + 1; # value from device with index 1. + 2; # value from device with index 2. +# .. and so on. +``` +``` +}* Values; +``` +``` +} V A L U E _ N A M E ; +``` +``` +}* Data; +``` +}; + +#### 4.1.8 Object structure of response body (Scope ”System”) + +``` +Listing 13: Object structure of response body for GetInverterRealtimeData request (Scope ”System”) +``` +#### 4.1.9 Example of response body (Scope ”System”) + +``` +Listing 14: Example of response body for GetInverterRealtimeData request (Scope ”System”) +``` +``` +" RequestArguments" : { +``` + +Listing 15: Example of response body for GetInverterRealtimeData request (Scope ”System”) on +GEN24/Tauro/Verto + + +``` +Platform Since version +Fronius Hybrid ALWAYS +Fronius Non Hybrid ALWAYS +Fronius GEN24/Tauro/Verto ALWAYS +``` +## 1& This API is useless on Fronius Hybrid systems which are unable to get connected to sensor cards + +``` +anyway. +``` +## 1& API is available but returns an error on GEN24/Tauro/Verto. + +### 4.2 GetSensorRealtimeData request + +This request provides data for all channels of a single Fronius Sensor Card. +Inactive channels and channels with damaged sensors are not included in the response. + +#### 4.2.1 Availability + +#### 4.2.2 URL for HTTP requests + +/solar_api/v1/GetSensorRealtimeData.cgi + +#### 4.2.3 Parameters + +``` +Parameter Type Range/Values/Pattern Description +Scope String ”Device” +”System” +``` +``` +Query specific device(s) +or whole system +DeviceId String Solar Net: 0 ...9 Which card to query. +DataCollection String ”NowSensorData” +”MinMaxSensorData” +``` +``` +Selects the collection of data that should +be queried from the device. +See 4.2.4 for details. +``` +#### 4.2.4 Data Collections + +NowSensorData The presently measured values of every active channel. + +MinMaxSensorData The minimum and maximum values for every time period (day, month, year, total) of every +channel. +Some channels do not have a minimum value because it would always be zero. For these channels, the minimum +value is not included. + +#### 4.2.5 Object structure of response body (DataCollection ”NowSensorData”) + +Listing 16: Object structure of response body for GetSensorRealtimeData request (DataCollection ”NowSensor- +Data”) + + +{ +"Body" : { +"Data" : { +"0" : { +"Unit" : "°C", +"Value" : - 9 +}, +"1" : { +"Unit" : "°C", +"Value" : 24 +}, +"2" : { +"Unit" : "W/m 2 ", +"Value" : 589 +}, +"4" : { +"Unit" : "KWh/m 2 ", +"Value" : 0 +} +} +}, +"Head" : { +" RequestArguments" : { +" DataCollection" : " NowSensorData", +" DeviceClass" : " SensorCard", +" DeviceId" : "1", +"Scope" : "Device" +}, +"Status" : { +"Code" : 0, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2018 - 03 - 01 T13 :25:34+01:00 " +} +} + +#### 4.2.6 Example of response body (DataCollection ”NowSensorData”) + +``` +Listing 17: Example of response body for GetSensorRealtimeData request (DataCollection ”NowSensorData”) +``` +#### 4.2.7 Object structure of response body (DataCollection ”MinMaxSensorData”) + +Listing 18: Object structure of response body for GetSensorRealtimeData request (DataCollection ”MinMaxSen- +sorData”) + + +``` +object { +``` +``` +# Object r epr esenting one channel. +object { +``` +``` +# Whether this channel is currently active. +boolean SensorActive; +``` +``` +# Object r epr esenti ng min/max values of current day. +object { +``` +``` +# Maximum value with unit. +object { +number Value; +string Unit; +} Max; +``` +``` +# Minimum value with unit. +# This object is only present in temperature channels ( channel# 0 and 1) +# as other channels do not have minimum values. +object { +number Value; +string Unit; +} Min; +} Day; +``` +``` +# Object r epr esenti ng min/max values of current month. +object { +object { +number Value; +string Unit; +} Max; +object { +number Value; +string Unit; +} Min; +} Month; +``` +``` +# Object r epr esenti ng min/max values of current year. +object { +object { +number Value; +string Unit; +} Max; +object { +number Value; +string Unit; +} Min; +} Year; +``` +``` +# Object r epr esenting total min/max values. +object { +object { +number Value; +string Unit; +} Max; +object { +number Value; +string Unit; +} Min; +} Total; +``` +``` +} C H A N N E L _ I N D E X ; +``` +``` +}* Data; +``` +}; + + +#### 4.2.8 Example of response body (DataCollection ”MinMaxSensorData”) + +Listing 19: Example of response body for GetSensorRealtimeData request (DataCollection ”MinMaxSensorData”) + +``` +{ +"Body" : { +"Data" : { +"0" : { +"Day" : { +"Max" : { +"Unit" : "°C", +"Value" : 66 +}, +"Min" : { +"Unit" : "°C", +"Value" : 46 +} +}, +"Mont h" : { +"Max" : { +"Unit" : "°C", +"Value" : 85 +}, +"Min" : { +"Unit" : "°C", +"Value" : 0 +} +}, +" SensorActive" : true , +"Total" : { +"Max" : { +"Unit" : "°C", +"Value" : 85 +}, +"Min" : { +"Unit" : "°C", +"Value" : - 35 +} +}, +"Year" : { +"Max" : { +"Unit" : "°C", +"Value" : 85 +}, +"Min" : { +"Unit" : "°C", +"Value" : 0 +} +} +}, +"1" : { +"Day" : { +"Max" : { +"Unit" : "°C", +"Value" : 27 +}, +"Min" : { +"Unit" : "°C", +"Value" : 27 +} +}, +"Mont h" : { +"Max" : { +"Unit" : "°C", +"Value" : 77 +}, +"Min" : { +``` + +``` +" SensorActive" +"Total" : { +"Max" : { +``` +(^) : **true** , +"Unit" : +"Value" : +"°C", +187 +}, +"Min" : { +"Unit" : +(^) +"°C", +"Value" +} +}, +"Year" : { +"Max" : { +"Unit" : +: - 35 +"°C", +"Value" +}, +"Min" : { +"Unit" : +: 77 +"°C", +"Value" +} +} +: 27 +}, +"2" : { +"Day" : { +"Max" : { +"Unit" : +"W/m 2 ", +"Value" +} +}, +"Mont h" : { +"Max" : { +"Unit" : +: 0 +"W/m 2 ", +"Value" +} +}, +" SensorActive" +"Total" : { +"Max" : { +"Unit" : +: 159 +: **true** , +"W/m 2 ", +"Value" +} +}, +"Year" : { +"Max" : { +"Unit" : +: 10036 +"W/m 2 ", +"Value" +} +} +}, +"3" : { +"Day" : { +"Max" : { +"Unit" : +: 159 +"Hz", +"Value" +} +}, +"Mont h" : { +"Max" : { +"Unit" : +: 0 +"Hz", +"Value" +} +}, +" SensorActive" +: 0 +: **false** , + + +"Total" : { +"Max" : { +"Unit" : "Hz", +"Value" : 2975 +} +}, +"Year" : { +"Max" : { +"Unit" : "Hz", +"Value" : 0 +} +} +}, +"4" : { +"Day" : { +"Max" : { +"Unit" : "Hz", +"Value" : 0 +} +}, +"Mont h" : { +"Max" : { +"Unit" : "Hz", +"Value" : 0 +} +}, +" SensorActive" : **false** , +"Total" : { +"Max" : { +"Unit" : "Hz", +"Value" : 2982 +} +}, +"Year" : { +"Max" : { +"Unit" : "Hz", +"Value" : 0 +} +} +}, +"5" : { +"Day" : { +"Max" : { +"Unit" : "A", +"Value" : 0 +} +}, +"Mont h" : { +"Max" : { +"Unit" : "A", +"Value" : 0 +} +}, +" SensorActive" : **true** , +"Total" : { +"Max" : { +"Unit" : "A", +"Value" : 36934 +} +}, +"Year" : { +"Max" : { +"Unit" : "A", +"Value" : 0 +} +} +} + + +``` +Platform Since version +Fronius Hybrid ALWAYS +Fronius Non Hybrid ALWAYS +Fronius GEN24/Tauro/Verto ALWAYS +``` +## 1& This API is useless on Fronius Hybrid systems which are unable to get connected to string controls + +``` +anyway. +``` +## 1& String Control does not exist for GEN24/Tauro/Verto + +``` +DataCollection supported on +Non Hybrid Hybrid GEN24/Tauro/Verto +NowStringControlData YES useless YES +LastErrorStringControlData YES useless NO +CurrentSumStringControlData YES useless NO +``` +### 4.3 GetStringRealtimeData request + +#### 4.3.1 Availability + +#### 4.3.2 URL for HTTP requests + +/solar_api/v1/GetStringRealtimeData.cgi + +#### 4.3.3 Parameters + +``` +Parameter Type Range/Values/Pattern Description +Scope String ”Device” +”System” +``` +``` +Query specific device +or whole system +DeviceId String Solar Net: 0 ...199 Which device to query. +DataCollection String ”NowStringControlData” +”LastErrorStringControlData” +”CurrentSumStringControlData” +``` +``` +Selects the collection of data that +should be queried from the device. +See 4.3.5 for details. +TimePeriod String ”Day” +”Year” +”Total” +``` +``` +Only needed for Collection ”Cur - +rentSumStringControlData” +For which time period the current +sums should be requested. +``` +#### 4.3.4 Collection availability + +#### 4.3.5 Data Collections + +NowStringControlData The presently measured currents of every channels. + +``` +" RequestArguments": { +``` +``` +" UserMessage": "" +``` + +``` +object { +``` +``` +# Collection of named object(s) containing values per channel and metadata. +# Members of Data object are named according to the channel index they represent (e.g. +"0"). +object { +``` +``` +# Value - Unit pair. +object { +``` +``` +# Value for the channel. +number Value; +``` +``` +# Base unit of the value , never contains any prefixes. +string Unit; +``` +``` +} C H A N N E L _ I N D E X ; +``` +``` +}* Data; +``` +}; + +``` +" RequestArguments" : { +``` +LastErrorStringControlData Information about the last error which triggered a service message. + +CurrentSumStringControlData Current sums of all channels for a selected time period (day, year or total). + +4.3.6 Object structure of response body (DataCollection **”NowStringControlData”** and **”CurrentSum** - +**StringControlData”)** + +Listing 20: Object structure of response body for GetStringRealtimeData request (DataCollection ”NowStringCon- +trolData” and ”CurrentSumStringControlData”) + +#### 4.3.7 Example of response body (DataCollection ”CurrentSumStringControlData”) + +Listing 21: Example of response body for GetStringRealtimeData request (DataCollection ”CurrentSumString- +ControlData”) + + +{ +"Body" : { +"Data" : {} +}, +"Head" : { +" RequestArguments" : { +" DataCollection" : " NowStringControlData", +" DeviceClass" : " StringControl", +"Scope" : "System" +}, +"Status" : { +"Code" : 0, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2019 - 08 - 28 T07 :20:58+00:00 " +} +} + +``` +# Timestamp when the error was detected. +``` +Listing 22: Reply body for GetStringRealtimeData DataCollection=”NowStringControlData” on +GEN24/Tauro/Verto + +#### 4.3.8 Object structure of response body (DataCollection ”LastErrorStringControlData”) + +Listing 23: Object structure of response body for GetStringRealtimeData request (DataCollection ”LastErrorString- +ControlData”) + + +#### 4.3.9 Example of response body (DataCollection ”LastErrorStringControlData”) + +Listing 24: Example of response body for GetStringRealtimeData request (DataCollection ”LastErrorStringCon- +trolData”) + +``` +# Current sum +``` + +``` +object { +object { +# Object r epr esenting one channel. +object { +``` +``` +number Value; +``` +``` +# Base unit of the value , never contains any prefixes. +string Unit; +``` +} C H A N N E L _ I N D E X ; +} Data; +} + +#### 4.3.10 Object structure of response body (DataCollection ”NowStringControlData”) + +Listing 25: Object structure of response body for GetStringRealtimeData request (DataCollection ”NowStringCon- +trolData”) + +``` +" RequestArguments" : { +``` + +{ +"Body" : { +"Data" : { +"1" : { +"Unit" : "A", +"Value" : 0 +}, +"2" : { +"Unit" : "A", +"Value" : 0 +}, +"3" : { +"Unit" : "A", +"Value" : 0 +}, +"4" : { +"Unit" : "A", +"Value" : 0 +}, +"5" : { +"Unit" : "A", +"Value" : 0 +} +} +}, +"Head" : { +" RequestArguments" : { +" DataCollection" : " NowStringControlData", +" DeviceClass" : " StringControl", +" DeviceId" : "8", +"Scope" : "Device" +}, +"Status" : { +"Code" : 0, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2019 - 06 - 13 T15 :06:57+02:00 " +} +} + +``` +Platform Since version +Fronius Hybrid ALWAYS +Fronius Non Hybrid ALWAYS +Fronius GEN24/Tauro/Verto ALWAYS +``` +## 1& API is available but returns an error on GEN24/Tauro/Verto. + +#### 4.3.11 Example of response body (DataCollection ”NowStringControlData”) + +Listing 26: Example of response body for GetStringRealtimeData request (DataCollection ”NowStringControl- +Data”) + +### 4.4 GetLoggerInfo request + +This request provides information about the logging device which provides this API. + +#### 4.4.1 Availability + +#### 4.4.2 URL for HTTP requests + +/solar_api/v1/GetLoggerInfo.cgi + + +#### 4.4.3 Object structure of response body + +``` +Listing 27: Object structure of response body for GetLoggerInfo request +object { +``` +``` +object { +``` +``` +# Unique ID of the logging device. +string UniqueID; +``` +``` +# String identifying the exact product type. +# examples: "fronius - hybrid" or "fronius - datamanager - card" +string ProductID; +``` +``` +# String identifying the exact hardware platform. +string PlatformID; +``` +``` +# Hardware version of the logging device. +string HWVersion; +``` +``` +# Software version of the logging device. (Major.Minor.Revision - Build) +string SWVersion; +``` +``` +# Name of city/ country which the user +# selected as time zone. +string TimezoneLocation/[a-zA-Z]+|/; +``` +``` +# Name of the selected time zone. +# May be empty if information not available. +string TimezoneName/[a-zA-Z]+|/; +``` +``` +# UTC offset in seconds east of UTC , +# incl uding adjustments for daylight saving. +integer UTCOffset; +``` +``` +# Default language set on the logging device +# as a two letter abbreviation (e.g. "en"). +# NOTE: This attribute will be REMOVED soon +string DefaultLanguage; +``` +``` +# Grid supply tariff +# This field is mandatory only for all Fronius Hybrid inverter +# and Fronius Non Hybrid since 3.3.3 - 1 +number DeliveryFactor; +``` +``` +# The cash factor set on the logging device , +# NOT the factor set on the inverters. +number CashFactor; +``` +``` +# Currency of cash factor set on the logging device , +# NOT the currency set on the inverters. +string CashCurrency; +``` +``` +# The CO2 factor set on the logging device , +# NOT the factor set on the inverters. +number CO2Factor; +``` +``` +# Unit of CO2 factor set on the logging device , +# NOT the unit set on the inverters. +string CO2Unit; +``` +``` +} LoggerInfo; +``` +}; + + +{ +"Body" : { +" LoggerInfo" : { +" CO2Factor" : 0.52999997138977051 , +" CO2 Unit" : "kg", +" CashCurrency" : "EUR", +" CashFactor" : 0.11999999731779099 , +" Defa ultLa ngua ge" : "en", +" DeliveryFactor" : 0.25 , +" HWVersion" : "2.4 D", +" PlatformID" : "wilma", +" ProductID" : "fronius - datamanager - card", +" SWVersi on" : "3.14.1 - 2 ", +" Ti mez oneLocation" : "Paris", +" TimezoneName" : "CEST", +" UTCOffset" : 7200 , +" UniqueID" : " 240.107620 " +} +}, +"Head" : { +" Request Ar guments" : {}, +"Status" : { +"Code" : 0, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2019 - 06 - 12 T15 :31:06+02:00 " +} +} + +``` +Platform Since version +Fronius Hybrid ALWAYS +Fronius Non Hybrid ALWAYS +Fronius GEN24/Tauro/Verto ALWAYS +``` +## 1& API is available but returns an error on GEN24/Tauro/Verto. + +#### 4.4.4 Example of response body + +``` +Listing 28: Example of response body for GetLoggerInfo request +``` +### 4.5 GetLoggerLEDInfo request + +This request provides information about the LED states and colors on the device which provides this API. + +#### 4.5.1 Availability + +#### 4.5.2 URL for HTTP requests + +/solar_api/v1/GetLoggerLEDInfo.cgi + +#### 4.5.3 Object structure of response body + +``` +Listing 29: Object structure of response body for GetLoggerLEDInfo request +``` +## 1& Item ”DefaultLanguage” will be removed soon + + +{ +"Body" : { +"Data" : { +" Pow erLE D" : { +"Color" : "green", +"State" : "on" +}, +" SolarNetLED" : { +"Color" : "green", +"State" : "on" +}, +" SolarWebLED" : { +"Color" : "green", +"State" : "on" +}, +" W LA NL ED " : { +"Color" : "red", +"State" : "on" +} +} +}, +"Head" : { +" Request Ar guments" : {}, +"Status" : { +"Code" : 0, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2019 - 06 - 12 T15 :31:07+02:00 " +} +} + +#### 4.5.4 Example of response body + +``` +Listing 30: Example of response body for GetLoggerLEDInfo request +``` +### 4.6 GetInverterInfo request + +This request provides information about all inverters that are currently being monitored by the logging device. So +this means that inverters which are currently not online are also reported by this request, provided these inverters +have been seen by the logging device within the last 24 hours. + +If information about devices currently online is needed, the GetActiveDeviceInfo request should be used. This +request also provides information about device classes other than inverters. + +``` +} LED_NAME ; +``` + +``` +Platform Since version +Fronius Hybrid ALWAYS +Fronius Non Hybrid ALWAYS +Fronius GEN24/Tauro/Verto ALWAYS +``` +#### 4.6.1 Availability + +#### 4.6.2 URL for HTTP requests + +/solar_api/v1/GetInverterInfo.cgi + +#### 4.6.3 Object structure of response body + +``` +Listing 31: Object structure of response body for GetInverterInfo request +object { +``` +``` +# Collection of objects with infos about one inverter , +# mapped by inverter index. +object { +``` +``` +# Info about a single inverter. +# Name of object is the inverter index. +object { +``` +``` +# Device type of the inverter. +# GEN24 /Ta uro/Verto inverter will always report device type 1. +integer DT; +``` +``` +# PV power connected to this inverter (in watts). +# If none defined , default power for this DT is used. +# Will provide dc power values since GEN24 /Ta uro/V erto version 1.13.5. +integer PVPower; +``` +``` +# Custom name of the inverter , assigned by the customer. +# Provided since 1.18.1 - 0 on Symo Hybrid +# Will contain html encoded strings on Datamanager and Symo Hybrid +# Will contain plain utf- 8 text on GEN24 /Tauro/Verto +string CustomName; +``` +``` +# Whether the device shall be displayed in vi sualizations according +# to customer settings. (0 do not show; 1 show) +# visualization settings. +unsigned integer Show; +``` +``` +# Unique ID of the inverter (e.g. serial number). +string UniqueID; +``` +``` +# Error code that is currently present on inverter. +# A value of - 1 means that there is no valid error code. +integer ErrorCode; +``` +``` +# Status code reflecting the operational state of the inverter. +# Supported since 1.13.5 on GEN24 /Tauro/Verto , older versions report a numeric string +here. +integer StatusCode; +``` +``` +# Status string reflecting the operational state of the inverter. +# Only provided for GEN24 /Ta ur o/Verto since version 1.13.5 +string InverterState; +``` +``` +} INVERTER_INDEX ; +``` +``` +}* Data; +``` +}; + + +#### 4.6.4 Example of response body + +``` +Listing 32: Example of response body for GetInverterInfo request +``` +{ +"Body" : { +"Data" : { +"1" : { +" C ustomNa me" : " +Primo 8.2-1 (", +"DT" : 102 , +" Error Cod e" : 0, +" PVPower" : 500 , +"Show" : 1, +" Stat usCode" : 7, +" UniqueID" : "38183 " +}, +"2" : { +" C ustomNa me" : " +Primo 5.0-1 20" +, +"DT" : 86, +" Error Cod e" : 0, +" PVPower" : 500 , +"Show" : 1, +" Stat usCode" : 7, +" UniqueID" : " 16777215 " +}, +"3" : { +" C ustomNa me" : " +Galvo 3.1-1 20", +"DT" : 106 , +" Error Cod e" : 0, +" PVPower" : 500 , +"Show" : 1, +" Stat usCode" : 7, +" UniqueID" : "7262 " +}, +"55" : { +" C ustomNa me" : " +Galvo 3.0-1 (5", +"DT" : 224 , +" Error Cod e" : 0, +" PVPower" : 500 , +"Show" : 1, +" Stat usCode" : 7, +" UniqueID" : "100372 " +} +} +}, +"Head" : { +" Request Ar guments" : {}, +"Status" : { +"Code" : 0, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2019 - 06 - 12 T15 :31:02+02:00 " +} +} + +``` +Listing 33: Example of response body for GetInverterInfo on GEN24/Tauro/Verto +``` + +``` +Platform Since version +Fronius Hybrid ALWAYS +Fronius Non Hybrid ALWAYS +Fronius GEN24/Tauro/Verto ALWAYS +``` +#### 4.6.5 Meaning of numerical status codes + +The StatusCode Field is only reported as numerical value. The meaning of the numbers is shown in the table +below. +Value Description provided by +Datamanager and Hybridmanager GEN24/Tauro/Verto +0 - 6 Startup YES Yes +7 Running YES Yes +8 Standby YES Yes +9 Bootloading YES No +10 Error YES Yes +11 Idle No Yes +12 Ready No Yes +13 Sleeping No Yes +255 Unknown No Yes +INVALID No Yes + +### 4.7 GetActiveDeviceInfo request + +This request provides information about which devices are currently online. + +#### 4.7.1 Availability + +#### 4.7.2 URL for HTTP requests + +/solar_api/v1/GetActiveDeviceInfo.cgi + +``` +" CustomName" : "tr-3pn - 01 ", +``` +``` +" PVPower" : 0, +``` + +``` +object { +``` +``` +# Collection of objects with infos about one inverter , +# mapped by inverter index. +object { +``` +``` +# Info about a single device. +# Name of object is the device index. +object { +``` +``` +# Mandatory Device type of the device. +# (only for Inverter , SensorCard or StringControl; others have - 1) +integer DT; +``` +``` +# Optional attribute: serialnumber +# usually supported by new Inverters , OhmPilots , Batteries and Smart Meters +string Serial; +``` +``` +# Channel listing for Sensor Cards +array { +string ; +} ChannelNames; +``` +``` +} DEVICE_INDEX ; +``` +``` +}* Data; +``` +}; + +#### 4.7.3 Parameters + +``` +2 3 4 +``` +#### 4.7.4 DeviceClass is not System + +``` +Listing 34: Object structure of response body for GetActiveDeviceInfo request +``` +``` +Listing 35: Example of response body for GetActiveDeviceInfo Inverter request +``` +(^2) Supported since version 3.3.4- 5 +(^3) Supported since version 3.6.1- 3 +(^4) Not listed and provided on GEN24/Tauro/Verto +Parameter Type Range/Values/Pattern Description +DeviceClass String ”Inverter” +”Storage” +”Ohmpilot”^3 +”SensorCard”^4 +”StringControl”^4 +”Meter”^2 +Which kind of device class to search for +active devices. +”System”^2 Uses different response format + + +{ +"Body" : { +"Data" : { +"1" : { +" Cha nnel Na mes" : [ +" Temperature 1", +" Temperature 2", +" Irradiation", +" Digital 1", +" Digital 2", +" Current" +], +"DT" : 254 +}, +"2" : { +" Channel Na mes" : [ +" Temperature 1", +" Temperature 2", +" Irradiation", +" Digital 1", +" Digital 2", +" Current" +], +"DT" : 254 +} +} +}, +"Head" : { +" RequestArguments" : { +" DeviceClass" : " SensorCard" +}, +"Status" : { +"Code" : 0, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2018 - 03 - 01 T14 :41:12+01:00 " +} +} + +``` +Listing 36: Example of response body for GetActiveDeviceInfo SensorCard request +``` +``` +Listing 37: Example of response body for GetActiveDeviceInfo deviceclass=Inverter on GEN24/Tauro/Verto +``` + +``` +object { +``` +``` +# Collection of objects with infos about one inverter , +# mapped by inverter index. +object { +``` +``` +# name of DeviceClass +object { +``` +``` +# Info about a single device. +# Name of object is the device index. +object { +``` +``` +# Device type only for Inverter , SensorCard or StringControl. others have - 1 +integer DT; +``` +``` +# Optional attribute: serialnumber +string Serial; +``` +``` +# This object only exists for SensorCard device class +array { string } ChannelNames; +``` +``` +} DEVICE_INDEX ; +``` +``` +} DEVICE_CLASS ; +``` +``` +}* Data; +``` +}; + +#### 4.7.5 DeviceClass is System + +``` +Listing 38: Object structure of response body for GetActiveDeviceInfo request +``` +``` +Listing 39: Example of response body for GetActiveDeviceInfo request on non hybrid inverter systems +``` +## 1& The item ’DT’ is not valid for Inverters on GEN24/Tauro/Verto + + +}, +"55" : { +"DT" : 224 +} +}, +"Meter" : { +"0" : { +"DT" : - 1, +"Serial" : " 16420055 " +}, +"2" : { +"DT" : - 1, +"Serial" : "475619 " +}, +"3" : { +"DT" : - 1, +"Serial" : " 17362721 " +} +}, +" Ohm pil ot" : { +"0" : { +"DT" : - 1, +"Serial" : " 12345678 " +} +}, +" SensorCard" : { +"1" : { +" Channel Na mes" : [ +" Temperature 1", +" Temperature 2", +" Irradiation", +" Digital 1", +" Digital 2", +" Current" +], +"DT" : 254 +} +}, +" Storage" : {}, +" StringControl" : { +"3" : { +"DT" : 253 +} +} +} +}, +"Head" : { +" RequestArguments" : { +" Devi ceClass" : "System" +}, +"Status" : { +"Code" : 0, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2019 - 06 - 12 T15 :30:59+02:00 " +} +} + +``` +Listing 40: Example of response body for GetActiveDeviceInfo request on hybrid inverter systems +``` + +Listing 41: Example of response body for GetActiveDeviceInfo deviceclass=Inverter on GEN24/Tauro/Verto + + +``` +Platform Since version +Fronius Hybrid ALWAYS +Fronius Non Hybrid 3.3.4- 8 +Fronius GEN24/Tauro/Verto planned in 1.13 +``` +### 4.8 GetMeterRealtimeData request + +This request provides detailed information about Meter devices. Inactive channels are not included in the re- +sponse and may vary depending on used metering device and software version. Take care about permanently or +temporary missing channels when processing this response. + +#### 4.8.1 Availability + +#### 4.8.2 URL for HTTP requests + +/solar_api/v1/GetMeterRealtimeData.cgi + +#### 4.8.3 Parameters + +``` +Parameter Type Range/Values/Pattern Description +Scope String ”System” +”Device” +``` +``` +Mandatory +``` +``` +DeviceId String 0..65535 Mandatory on non system scope +``` +#### 4.8.4 Devicetypes and provided channels + +## 1& The item ’DT’ is not valid for Inverters on GEN24/Tauro/Verto + + +``` +Group +``` +``` +Model +``` +``` +Fronius Smart Meter Generic +``` +##### 63A + +##### -^3 + +##### 63A + +##### -^1 + +``` +50kA +``` +##### -^3 + +##### TS + +##### 100A + +##### -^1 + +##### TS + +##### 65A + +##### -^3 + +##### TS + +``` +5kA +``` +##### -^3 + +##### IP + +##### WR + +``` +Sun +``` +``` +Spec +``` +``` +Meter +``` +``` +Compatibility +``` +``` +hw=0 +``` +``` +and +``` +``` +sw=2.7 +``` +``` +hw=1 +``` +``` +hw=1 +``` +``` +and +``` +``` +sw +``` +``` +is +``` +##### 3.00, + +##### 3.01, + +##### 3.03 + +``` +or +``` +##### 3.04) + +``` +hw=0 +``` +``` +and +``` +``` +sw=1.9 +sw=1 +sw=1 +sw=1 +all +``` +``` +hw +``` +``` +=8 and sw +``` +##### =1036 + +``` +model=307 +``` +``` +or +``` +``` +model=70307 +``` +Channel +provided (m...mandatory, - ...never, o...optional) +Details / Manufacturer m m m m m m m m o +Details / Model m m m m m m m m o +Details / Serial m m m m m m m m o +Current_AC_Phase_1 m m m m m m m m o +Current_AC_Phase_2 m - m - m m m o o +Current_AC_Phase_3 m - m - m m m o o +Current_AC_Sum - m - m m m m m o +Enable m m m m m m m m m +EnergyReactive_VArAC_Phase_1_Consumed - m - - - - - - - +EnergyReactive_VArAC_Phase_1_Produced - m - - - - - - - +EnergyReactive_VArAC_Sum_Consumed m m m m m m - - - +EnergyReactive_VArAC_Sum_Produced m m m m m m - - - +EnergyReal_WAC_Minus_Absolute m m m m m m m m m +EnergyReal_WAC_Phase_1_Consumed - m - - - - m m o +EnergyReal_WAC_Phase_1_Produced - m - - - - m m o +EnergyReal_WAC_Phase_2_Consumed - - - - - - m o o +EnergyReal_WAC_Phase_2_Produced - - - - - - m o o +EnergyReal_WAC_Phase_3_Consumed - - - - - - m o o +EnergyReal_WAC_Phase_3_Produced - - - - - - m o o +EnergyReal_WAC_Plus_Absolute m m m m m m m m m +EnergyReal_WAC_Sum_Consumed m m m m m m m m m +EnergyReal_WAC_Sum_Produced m m m m m m m m m +Frequency_Phase_Average m m m m m m m m m +Meter_Location_Current m m m m m m m m m +PowerApparent_S_Phase_1 m m m m m m m m o +PowerApparent_S_Phase_2 m - m - m m m o o +PowerApparent_S_Phase_3 m - m - m m m o o +PowerApparent_S_Sum m m m m m m m m m +PowerFactor_Phase_1 m m m m m m m m o +PowerFactor_Phase_2 m - m - m m m o o +PowerFactor_Phase_3 m - m - m m m o o + + +``` +PowerFactor_Sum m m m m m m m m m +PowerReactive_Q_Phase_1 m m m m m m m m o +PowerReactive_Q_Phase_2 m - m - m m m o o +PowerReactive_Q_Phase_3 m - m - m m m o o +PowerReactive_Q_Sum m m m m m m m m m +``` +Some values are optional since meter is able to operate on one or three phases. + +``` +Group +``` +``` +Model +``` +``` +Fronius Smart Meter Generic +``` +##### 63A + +##### -^3 + +##### 63A + +##### -^1 + +``` +50kA +``` +##### -^3 + +##### TS + +##### 100A + +##### -^1 + +##### TS + +##### 65A + +##### -^3 + +##### TS + +``` +5kA +``` +##### -^3 + +##### IP + +##### W + +``` +R Sun +``` +``` +Spec +``` +``` +Meter +``` +``` +Article Number +``` +##### 43,0001,1473 + +##### 43,0001,1477 + +##### 43,0001,1478 + +##### 43,0001,0045 + +##### 43,0001,0044 + +##### 43,0001,0046 + +##### 42,0411,0347 + +##### 43,0001,35 + +##### 91 + +##### D + +``` +evice +``` +``` +dependend +``` +``` +PowerReal_P_Phase_1 m m m m m m m m o +PowerReal_P_Phase_2 m - m - m m m o o +PowerReal_P_Phase_3 m - m - m m m o o +PowerReal_P_Sum m m m m m m m m m +TimeStamp m m m m m m m m m +Visible m m m m m m m m m +Voltage_AC_PhaseToPhase_12 m - m - m m m o o +Voltage_AC_PhaseToPhase_23 m - m - m m m o o +Voltage_AC_PhaseToPhase_31 m - m - m m m o o +Voltage_AC_Phase_1 m m m m m m m m o +Voltage_AC_Phase_2 m - m - m m m o o +Voltage_AC_Phase_3 m - m - m m m o o +Voltage_AC_Phase_Average - - - - - - m m o +``` + +#### 4.8.5 Channel Descriptions + +``` +Name Description +Enable 1...enabled, 0...disabled +Visible 1...use values, 0...incomplete or outdated values +Current_AC_Phase_* absolute values for 63A-3,63A- 1 and 50KA- 3 +only UL and TS meter provide directions +feedin negative(-); consumption positive(+) +Meter_Location_Current 0...grid interconnection point (primary meter) +1...load (primary meter) +3...external generator (secondary meters)(multiple) +256 - 511 subloads (secondary meters)(unique) +EnergyReactive_VArAC_Phase_*_Consumed/Produced +EnergyReactive_VArAC_Sum_Consumed/Produced +``` +``` +meter specific view +``` +``` +EnergyReal_WAC_Plus/Minus_Absolute system specific view +EnergyReal_WAC_Phase_*_Consumed/Produced +EnergyReal_WAC_Sum_Consumed/Produced +``` +``` +meter specific view +``` +The values EnergyReal_WAC_Sum_Produced and EnergyReal_WAC_Sum_Consumed represent the values +for the Smart Meter itself. The values EnergyReal_WAC_Minus_Absolute and EnergyReal_WAC_Plus_Absolute +represent the values for Solar.web. Now it depends where the Smart Meter is installed (Feed-In-Point or Consumption- +Path), so that either EnergyReal_WAC_Minus_Absolute is the same as EnergyReal_WAC_Sum_Produced or +EnergyReal_WAC_Sum_Consumed. + + +# Collection of objects with infos about multiple Meters , +# mapped by serial number. +**object** { + +``` +# list of single device objects +object { +``` +``` +# optional detailed information about device +# supported since: +# Fronius Symo Hybrid : with version greater than or equal to 1.1.2 - 14 +# Non Fronius Symo Hybrid : with version greater than or equal to 3.3.6 - 14 +object { +string Serial; +``` +``` +string Model; +``` +``` +string Manufacturer; +``` +``` +} Details; +``` +``` +# channels of device ( textual name and value) +nu m b e r * C H AN N E L _ N AM E ; +``` +``` +} * DeviceId; +``` +} Data ; + +``` +" Current_AC_Phase_1 " : 0.74199999999999999 , +" Current_AC_Phase_2 " : 0.63200000000000001 , +``` +#### 4.8.6 Meter Location Dependend Directions (primary meter) + +``` +Meter_Location_Current 0 +feed in +``` +##### 1 + +``` +consumption path +PowerReal_P_Sum (+ positive) consuming from grid producing power +PowerReal_P_Sum (- negative) feeding in to grid normal consumption +EnergyReal_WAC_Plus_Absolute +(absolute counter) +``` +``` +import from grid +EnergyReal_WAC_Phase_*_Consumed +``` +``` +producing power * +EnergyReal_WAC_Phase_*_Produced +EnergyReal_WAC_Minus_Absolute +(absolute counter) +``` +``` +export to grid +EnergyReal_WAC_Phase_*_Produced +``` +consumption +EnergyReal_WAC_Phase_*_Consumed +* May occur when other power generation is located in load path and producing more power than load can con- +sume. + +#### 4.8.7 Meter Location Dependend Directions (secondary meter) + +``` +Meter_Location_Current 3 +ext. generator +``` +##### 256 - 511 + +``` +subloads +PowerReal_P_Sum (+ positive) generation load is producing power +PowerReal_P_Sum (- negative) consumption normal consumption +EnergyReal_WAC_Plus_Absolute +(absolute counter) +``` +``` +generation +EnergyReal_WAC_Phase_*_Produced +``` +``` +producing power * +EnergyReal_WAC_Phase_*_Produced +EnergyReal_WAC_Minus_Absolute +(absolute counter) +``` +``` +consumption +EnergyReal_WAC_Phase_*_Consumed +``` +``` +consumption +EnergyReal_WAC_Phase_*_Consumed +``` +* May occur when other power generation is located in load path and producing more power than load can con- +sume. + +#### 4.8.8 System-Request + +``` +Listing 42: Object structure of response body for GetMeterRealtimeData request +``` +``` +Listing 43: Example of response body for GetMeterRealtimeData System request +``` + +" Current_AC_Phase_3 " : 0.65400000000000003 , +" Details" : { +" Manufacturer" : " Fronius", +"Model" : "Smart Meter 63A", +"Serial" : " 15160189 " +}, +"Enable" : 1, +" EnergyReactive_VArAC_Sum_Consumed" : 9156420 , +" EnergyReactive_VArAC_Sum_Produced" : 87894450 , +" EnergyReal_WAC_Minus_Absolute" : 1642802 , +" EnergyReal_WAC_Plus_Absolute" : 19838697 , +" EnergyReal_WAC_Sum_Consumed" : 19838697 , +" EnergyReal_WAC_Sum_Produced" : 1642802 , +" Frequency_Phase_Average" : 50, +" Meter_Location_Current" : 0, +" PowerApparent_S_Phase_1 " : 172.36660000000001 , +" PowerApparent_S_Phase_2 " : 147.00319999999999 , +" PowerApparent_S_Phase_3 " : 152.57820000000001 , +" PowerApparent_S_Sum" : 31, +" PowerFactor_Phase_1 " : 0, +" PowerFactor_Phase_2 " : 0.97999999999999998 , +" PowerFactor_Phase_3 " : 1, +" Pow erFa ctor_Sum" : 0.81999999999999995 , +" PowerReactive_Q_Phase_1 " : 12.550000000000001 , +" PowerReactive_Q_Phase_2 " : 5.8099999999999996 , +" Pow er Reacti ve_ Q_ Phase_3 " : 0, +" PowerReactive_Q_Sum" : 18.359999999999999 , +" PowerReal_P_Phase_1 " : 0, +" PowerReal_P_Phase_2 " : - 40.560000000000002 , +" PowerReal_P_Phase_3 " : 15.029999999999999 , +" PowerReal_P_Sum" : - 25.530000000000001 , +" TimeStamp" : 1561364909 , +" Visible" : 1, +" Voltage_AC_PhaseToPhase_12 " : 402.60000000000002 , +" Voltage_ AC_ PhaseT oPhase_23 " : 403.5 , +" Voltage_AC_PhaseToPhase_31 " : 403.19999999999999 , +" Voltage_ AC_ Phase_1 " : 232.30000000000001 , +" Voltage_ AC_ Phase_2 " : 232.59999999999999 , +" Voltage_AC_Phase_3 " : 233.30000000000001 +}, +"1" : { +" Current_AC_Phase_1 " : - 0.58310449123382568 , +" Current_AC_Phase_2 " : - 0.67854827642440796 , +" Current_AC_Phase_3 " : - 0.7008516788482666 , +" Current_AC_Sum" : - 1.9625044465065002 , +" Details" : { +" Manufa ct urer " : " Fronius", +"Model" : "CCS WattNode WNC - 3D- 480 - MB", +"Serial" : "186477 " +}, +"Enable" : 1, +" EnergyReal_WAC_Minus_Absolute" : 7336854 , +" EnergyReal_WAC_Phase_1_Consumed" : 1320806 , +" EnergyReal_WAC_Phase_1_Produced" : 1933071 , +" EnergyReal_WAC_Phase_2_Consumed" : 158238 , +" EnergyReal_WAC_Phase_2_Produced" : 3043466 , +" EnergyReal_WAC_Phase_3_Consumed" : 179872 , +" EnergyReal_WAC_Phase_3_Produced" : 2912264 , +" EnergyReal_WAC_Plus_Absolute" : 1106969 , +" EnergyReal_WAC_Sum_Consumed" : 1106969 , +" EnergyReal_WAC_Sum_Produced" : 7336854 , +" Frequency_Phase_Average" : 50.116844177246094 , +" M et er_Location_ Curr ent" : 256 , +" PowerApparent_S_Phase_1 " : 135.04127502441406 , +" PowerApparent_S_Phase_2 " : 160.43267822265625 , +" PowerApparent_S_Phase_3 " : 163.04228210449219 , +" PowerApparent_S_Sum" : 458.5162353515625 , + + +" PowerFactor_Phase_1 " : 1, +" PowerFactor_Phase_2 " : 1, +" PowerFactor_Phase_3 " : 1, +" PowerFactor_Sum" : 1, +" PowerReactive_Q_Phase_1 " : 0, +" PowerReactive_Q_Phase_2 " : 0, +" PowerReactive_Q_Phase_3 " : 0, +" PowerReactive_Q_Sum" : 0, +" PowerReal_P_Phase_1 " : - 135.04127502441406 , +" PowerReal_P_Phase_2 " : - 160.43267822265625 , +" PowerReal_P_Phase_3 " : - 163.04228210449219 , +" PowerReal_P_Sum" : - 458.5162353515625 , +" TimeStamp" : 1561364987 , +" Visible" : 1, +" Voltage_AC_PhaseToPhase_12 " : 405.32907104492188 , +" Voltage_AC_PhaseToPhase_23 " : 406.23068237304688 , +" Voltage_AC_PhaseToPhase_31 " : 402.03070068359375 , +" Voltage_ AC_ Phase_1 " : 231.59017944335938 , +" Voltage_ AC_ Phase_2 " : 236.43516540527344 , +" Voltage_ AC_ Phase_3 " : 232.63450622558594 , +" Voltage_AC_Phase_Average" : 233.55328369140625 +}, +"2" : { +" Current_AC_Phase_1 " : 0.57899999999999996 , +" Current_AC_Sum" : 0.57899999999999996 , +" Details" : { +" Manufacturer" : " Fronius", +"Model " : "Smart Meter 63A-1", +"Serial" : " 15160009 " +}, +"Enable" : 1, +" EnergyReactive_VArAC_Phase_1_Consumed" : 260 , +" EnergyReactive_VArAC_Phase_1_Produced" : 8261790 , +" EnergyReactive_VArAC_Sum_Consumed" : 260 , +" EnergyReactive_VArAC_Sum_Produced" : 8261790 , +" EnergyReal_WAC_Minus_Absolute" : 0, +" EnergyReal_WAC_Phase_1_Consumed" : 5670793 , +" EnergyReal_WAC_Phase_1_Produced" : 0, +" EnergyReal_WAC_Plus_Absolute" : 5670793 , +" EnergyReal_WAC_Sum_Consumed" : 5670793 , +" EnergyReal_WAC_Sum_Produced" : 0, +" Frequency_Phase_Average" : 50, +" Meter_Location_Current" : 257 , +" PowerApparent_S_Phase_1 " : 135.19 , +" PowerApparent_S_Sum" : 135.19 , +" Power Factor_ Phase_1 " : 0.96999999999999997 , +" Pow erFa ctor_Sum" : 0.96999999999999997 , +" PowerReactive_Q_Phase_1 " : - 22.629999999999999 , +" PowerReactive_Q_Sum" : - 22.629999999999999 , +" PowerReal_P_Phase_1 " : 132.09999999999999 , +" PowerReal_P_Sum" : 132.09999999999999 , +" TimeStamp" : 1561365038 , +" Visible" : 1, +" Voltage_AC_Phase_1 " : 233.5 +}, +"3" : { +" Details" : { +" Manufa ct urer " : " Fronius", +"Model" : "S0 Meter at inverter 40", +"Serial" : "n.a." +}, +"Enable" : 1, +" Meter_Location_Current" : 258 , +" TimeStamp" : 1560942897 , +" EnergyReal_WAC_Minus_Relative": 0, +" EnergyReal_WAC_Plus_Relative": 0, +" PowerReal_P_Sum": 0, + + +" Visible" : 1 +}, +"4": { +" Current_AC_Phase_1 ": 0, +" Current_AC_Phase_2 ": 0, +" Current_AC_Phase_3 ": 0, +" Current_AC_Sum": 0, +" Details": { +" Manufacturer": " Fronius", +"Model": "CCS WattNode WND - 3Y- 600 - MB", +"Serial": "475619 " +}, +"Enable": 1, +" EnergyReal_WAC_Minus_Absolute": 3321 , +" EnergyReal_WAC_Phase_1_Consumed": 3321 , +" EnergyReal_WAC_Phase_1_Produced": 10996 , +" EnergyReal_WAC_Phase_2_Consumed": 0, +" EnergyReal_WAC_Phase_2_Produced": 0, +" EnergyReal_WAC_Phase_3_Consumed": 0, +" EnergyReal_WAC_Phase_3_Produced": 14, +" EnergyReal_WAC_Plus_Absolute": 11010 , +" En e r g y R e a l _ W A C _ S u m _ C o n s u m e d": 3321 , +" EnergyReal_WAC_Sum_Produced": 11010 , +" Freq uen cy_P hase_ Avera ge": 49.9833869934082 , +" Meter_Location_Current": 259 , +" PowerApparent_S_Phase_1 ": 0, +" PowerApparent_S_Phase_2 ": 0, +" PowerApparent_S_Phase_3 ": 0, +" PowerApparent_S_Sum": 0, +" PowerFactor_Phase_1 ": 1, +" PowerFactor_Phase_2 ": 1, +" PowerFactor_Phase_3 ": 1, +" PowerFactor_Sum": 1, +" PowerReactive_Q_Phase_1 ": 0, +" PowerReactive_Q_Phase_2 ": 0, +" PowerReactive_Q_Phase_3 ": 0, +" PowerReactive_Q_Sum": 0, +" PowerReal_P_Phase_1 ": 0, +" PowerReal_P_Phase_2 ": 0, +" PowerReal_P_Phase_3 ": 0, +" PowerReal_P_Sum": 0, +" TimeStamp": 1519911921 , +" Visible": 1, +" Voltage_AC_PhaseToPhase_12 ": 238.15383911132812 , +" Voltage_AC_PhaseToPhase_23 ": 0, +" Voltage_AC_PhaseToPhase_31 ": 232.91676330566406 , +" Voltage_AC_Phase_1 ": 404.52679443359375 , +" Voltage_AC_Phase_2 ": 231.70884704589844 , +" Voltage_AC_Phase_3 ": 232.72479248046875 , +" Voltage_AC_Phase_Average": 289.6534729003906 +}, +"5": { +" Current_AC_Phase_1 ": 0, +" Current_AC_Phase_2 ": 0, +" Current_AC_Phase_3 ": 0, +" Details": { +" Manufacturer": " Fronius", +"Model": "Smart Meter 50kA - 3", +"Serial": " 17362721 " +}, +"Enable": 1, +" EnergyReactive_VArAC_Sum_Consumed": 34, +" EnergyReactive_VArAC_Sum_Produced": 174 , +" EnergyReal_WAC_Minus_Absolute": 3940 , +" EnergyReal_WAC_Plus_Absolute": 434 , +" En e r g y R e a l _ W A C _ S u m _ C o n s u m e d": 3940 , +" EnergyReal_WAC_Sum_Produced": 434 , + + +# object with detailed infor mations about one Meter, +**object** { + +``` +object { +string Serial; +``` +``` +string Model; +``` +``` +string Manufacturer; +} Details; +``` +``` +# channels of device ( textual name and value) +nu m b e r * C H AN N E L _ N AM E ; +``` +} Data ; + +``` +Examples for GEN24/Tauro/Verto are identical. +``` +#### 4.8.9 Device-Request + +``` +Listing 44: Object structure of response body for GetMeterRealtimeData request +``` +``` +Listing 45: Example of response body for GetMeterRealtimeData Device request +``` +``` +" Freq uen cy_P hase_ Avera ge": 49.900000743567944 , +``` +``` +" PowerApparent_S_Phase_1 ": 0, +" PowerApparent_S_Phase_2 ": 0, +" PowerApparent_S_Phase_3 ": 0, +" PowerApparent_S_Sum": 0, +" PowerFa ctor_ Phase_1 ": 0.9999999776482582 , +" PowerFa ctor_ Phase_2 ": 0.9999999776482582 , +" PowerFa ctor_ Phase_3 ": 0.9999999776482582 , +" PowerFactor_Sum": 0.9999999776482582 , +" PowerReactive_Q_Phase_1 ": 0, +" PowerReactive_Q_Phase_2 ": 0, +" PowerReactive_Q_Phase_3 ": 0, +" PowerReactive_Q_Sum": 0, +" PowerReal_P_Phase_1 ": 0, +" PowerReal_P_Phase_2 ": 0, +" PowerReal_P_Phase_3 ": 0, +" PowerReal_P_Sum": 0, +" TimeStamp": 1519911921 , +``` +``` +" Voltage_AC_PhaseToPhase_12 ": 404.90001923171803 , +" Voltage_AC_PhaseToPhase_23 ": 404.50001921271905 , +" Voltage_AC_PhaseToPhase_31 ": 404.4000192079693 , +" Voltage_AC_Phase_1 ": 233.70001110015437 , +" Voltage_AC_Phase_2 ": 233.80001110490412 , +" Voltage_AC_Phase_3 ": 233.3000110811554 +``` + +{ +"Body" : { +"Data" : { +" Current_AC_Phase_1 " : 0.61899999999999999 , +" Current_AC_Phase_2 " : 0.68799999999999994 , +" Current_AC_Phase_3 " : 0.55100000000000005 , +" Details" : { +" Manufacturer" : " Fronius", +"Model" : "Smart Meter 63A", +"Serial" : " 15480258 " +}, +"Enable" : 1, +" EnergyReactive_VArAC_Sum_Consumed" : 2183700 , +" EnergyReactive_VArAC_Sum_Produced" : 47100 , +" EnergyReal_WAC_Minus_Absolute" : 4075753 , +" EnergyReal_WAC_Plus_Absolute" : 941840 , +" EnergyReal_WAC_Sum_Consumed" : 941840 , +" EnergyReal_WAC_Sum_Produced" : 4075753 , +" Frequency_Phase_Average" : 50, +" Meter_Location_Current" : 0, +" PowerApparent_S_Phase_1 " : 143.9794 , +" Pow er Appar ent_ S_ Phase_2 " : 159.5472 , +" PowerApparent_S_Phase_3 " : 127.44630000000002 , +" PowerApparent_S_Sum" : 211.36000000000001 , +" Pow erFa ctor_ Phase_1 " : 0.97999999999999998 , +" PowerFactor_Phase_2 " : 1, +" PowerFactor_Phase_3 " : 1, +" PowerFactor_Sum" : 1, +" PowerReactive_Q_Phase_1 " : 9.9000000000000004 , +" Pow er Reacti ve_ Q_ Phase_2 " : 0, +" PowerReactive_Q_Phase_3 " : 4.7999999999999998 , +" PowerReactive_Q_Sum" : 14.699999999999999 , +" PowerReal_P_Phase_1 " : - 75, +" PowerReal_P_Phase_2 " : - 74.280000000000001 , +" PowerReal_P_Phase_3 " : - 62.079999999999998 , +" PowerReal_P_Sum" : - 211.36000000000001 , +" TimeStamp" : 1560430330 , +" Visible" : 1, +" Voltage_AC_PhaseToPhase_12 " : 402.30000000000001 , +" Voltage_AC_PhaseToPhase_23 " : 401.10000000000002 , +" Voltage_AC_PhaseToPhase_31 " : 401.69999999999999 , +" Voltage_ AC_ Phase_1 " : 232.59999999999999 , +" Voltage_ AC_ Phase_2 " : 231.90000000000001 , +" Voltage_AC_Phase_3 " : 231.30000000000001 +} +}, +"Head" : { +" RequestArguments" : { +" DeviceClass" : "Meter", +" DeviceId" : "0", +"Scope" : "Device" +}, +"Status" : { +"Code" : 0, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2019 - 06 - 13 T14 :52:10+02:00 " +} +} + +``` +Examples for GEN24/Tauro/Verto are identical. +``` +### 4.9 GetStorageRealtimeData request + +This request provides detailed information about batteries. Inactive channels are not included in the response and +may vary depended on battery used and software version. Take care about permanently or temporary missing + + +{ +"Body" : { +"Data" : {} +}, +"Head" : { +" RequestArguments" : { +" DeviceClass" : " Storage", +" DeviceId" : "0", +"Scope" : "Device" +}, +"Status" : { +"Code" : 255 , +"Reason" : " battery type 'BYD' is not supported", +" UserMessage" : "" +}, +" Timestamp" : "2019 - 06 - 03 T17 :01:01+02:00 " +} +} + +## 1& If storage version is incompatible, it will be operative and an inconsistency warning will be shown to + +``` +update the storage if possible. +``` +channels when processing this response. + +#### 4.9.1 Availability + +``` +Platform +Fronius Hybrid +Fronius Non Hybrid +Fronius GEN24/Tauro/Verto +``` +``` +Since version +1.1.2- 13 +NOT AVAILABLE +1.13 +``` +#### 4.9.2 3rd Party Batteries + +will be displayed since HybridManager version 1.13.1-x and Solar API Version 1.5-17. Older versions reported +an error: + +``` +Listing 46: Former response body for GetStorageRealtimeData request using BYD Box +``` +#### 4.9.3 Supported + +``` +manufacturer model versions +Fronius Fronius Solar Battery bms sw 0x18XX +BYD BYD Battery-Box HV protocol 0x0 - 0x1ffff +LG-Chem Resu H dcdc sw 0x5046 - 0x50ff +dcdc sw 0x7046 - 0x70ff +``` +#### 4.9.4 URL for HTTP requests + +/solar_api/v1/GetStorageRealtimeData.cgi + +#### 4.9.5 Parameters + +``` +Parameter Type Range/Values/Pattern Description +Scope String ”System” +”Device” +``` +``` +Mandatory +``` +``` +DeviceId String 0..65535 Mandatory on non system scope +``` +#### 4.9.6 Reference to manual + +Reference to Fronius Energy Package and 3rd Party support can be found here: +https://www.fronius.com/~/downloads/Solar%20Energy/Operating%20Instructions/42%2C0426%2C0222% +2CEN.pdf + + +#### 4.9.7 Channel Descriptions + +``` +Table 3: Channel and description for control section +``` +``` +Name of channel Description Available +Fronius +Solar +Battery +``` +##### LG + +``` +Chem +Resu H +``` +##### BYD + +``` +Box +``` +``` +Details / Manufacturer name of manufacturer always always always +Details / Model model of battery always always always +Details / Serial unique identification serial always always always +TimeStamp last timestamp data has been refrehsed always always always +Enable device is managed (1.0) or disconnected (0.0) always always always +StateOfCharge_Relative relative charged capacity in % always always always +Capacity_Maximum current max capacity always always always +DesignedCapacity max designed capacity always always always +Current_DC battery output current (+ charging) always always always +Voltage_DC battery output voltage always always always +Temperature_Cell temperature in degree celsius always always always +``` +``` +Table 4: Channel and description for module section (only Solar Battery provides module informations) +``` +``` +Name of channel Description Available +Fronius +Solar +Battery +``` +##### LG + +``` +Chem +Resu H +``` +##### BYD + +``` +Box +``` +``` +Details / Manufacturer manufacturer always - - +Details / Model model identifier always - - +Details / Serial unique identifier always - - +Capacity_Maximum always - - +Current_DC always - - +CycleCount_BatteryCell always - - +DesignedCapacity always - - +Enable always - - +StateOfCharge_Relative always - - +Status_BatteryCell always - - +Temperature_Cell always - - +Temperature_Cell_Maximum always - - +Temperature_Cell_Minimum always - - +TimeStamp always - - +Voltage_DC always - - +Voltage_DC_Maximum_Cell always - - +Voltage_DC_Minimum_Cell always - - +``` +#### 4.9.8 System-Request + +``` +Listing 47: Object structure of response body for GetStorageRealtimeData request +``` + +``` +Table 2: Channel and value description +``` +Name of channel Description +Status_BatteryCell Fronius Solar Battery at section Modules + +``` +Previuos and current state of a battery cell. One Byte printed +in hexadecimal. 0xYX (Y: Current status, X: Previous status) +Meaning of numerical status codes: +``` +Status_BatteryCell for LG-Chem Resu H at section Controller + +Status_BatteryCell for BYD Box at section Controller + +``` +Status value Description +``` +(^016) RESERVED +(^116) Pre Charge +(^216) Initial +(^316) Normal Charge +(^416) Charge Terminate +(^516) Normal Discharge +(^616) Over Voltage +(^716) Over Discharge +(^816) RESERVED +(^916) Over Temp Charge +A 16 Over Current Charge +B 16 Over Temp Discharge +C 16 Over Current Discharge +D 16 Cell Unbalance +E 16 Charge Suspend +F 16 RESERVED +Status value Description +1 STANDBY +3 ENABLED +5 FAULTED +10 SLEEP +Status value Description +0 STANDBY +1 INACTIVE +2 DARKSTART +3 ACTIVE +4 FAULT +5 UPDATING + + +Manufacturer has been updated at version HM-1.12.1-X from ”Fronius International” to ”Fronius” + +``` +Listing 48: Reply body for GetStorageRealtimeData System request (Solar Battery) +``` +``` +" Capacity_Maximum" : 7200 , +" Current_DC" : 1.1200000000000001 , +``` +``` +" Voltage_DC" : 318.80000000000001 , +" Voltage_DC_Maximum_Cell" : 3.3290000000000002 , +" Voltage_DC_Minimum_Cell" : 3.3159999999999998 +``` + +"Serial" : " S012002885 " +}, +"Enable" : 1, +" StateOfChar ge_ Relative" : 55, +" Status_BatteryCell" : 53, +" T emperat ure_ Cell" : 27.25 , +" Temperature_Cell_Maximum" : 27.75 , +" Temperature_Cell_Minimum" : 26.950000000000045 , +" TimeStamp" : 1560346263 , +" Voltage_DC" : 53.142000000000003 , +" Voltage_DC_Maximum_Cell" : 3.3239999999999998 , +" Voltage_DC_Minimum_Cell" : 3.3140000000000001 +}, +{ +" Ca pa city_ Maxi mum" : 1200 , +" Current_DC" : 1.1200000000000001 , +" CycleCount_BatteryCell" : 257 , +" Designed Ca pacity" : 1200 , +" Details" : { +" Manufa ct urer " : "Sony", +"Model" : " unknown", +"Serial" : " S012002843 " +}, +"Enable" : 1, +" StateOfChar ge_ Relative" : 55, +" Status_BatteryCell" : 53, +" Temperature_Cell" : 26.650000000000034 , +" Temperature_Cell_Maximum" : 27.150000000000034 , +" Temperature_Cell_Minimum" : 26.350000000000023 , +" TimeStamp" : 1560346263 , +" Voltage_DC" : 53.137 , +" Voltage_DC_Maximum_Cell" : 3.3279999999999998 , +" Voltage_DC_Minimum_Cell" : 3.3159999999999998 +}, +{ +" Ca pa city_ Maxi mum" : 1200 , +" Current_DC" : 1.1299999999999999 , +" CycleCount_BatteryCell" : 257 , +" Designed Ca pacity" : 1200 , +" Details" : { +" Manufa ct urer " : "Sony", +"Model" : " unknown", +"Serial" : " S012002844 " +}, +"Enable" : 1, +" StateOfChar ge_ Relative" : 55, +" Status_BatteryCell" : 53, +" Temperature_Cell" : 26.450000000000045 , +" Temperature_Cell_Maximum" : 27.050000000000011 , +" Temperature_Cell_Minimum" : 26.25 , +" TimeStamp" : 1560346263 , +" Voltage_DC" : 53.164000000000001 , +" Voltage_DC_Maximum_Cell" : 3.3290000000000002 , +" Voltage_DC_Minimum_Cell" : 3.319 +}, +{ +" Ca pa city_ Maxi mum" : 1200 , +" Current_DC" : 1.1299999999999999 , +" CycleCount_BatteryCell" : 254 , +" Designed Ca pacity" : 1200 , +" Details" : { +" Manufa ct urer " : "Sony", +"Model" : " unknown", +"Serial" : " S012002838 " +}, +"Enable" : 1, +" StateOfChar ge_ Relative" : 55, + + +" Status_BatteryCell" : 53, +" Temperature_Cell" : 26.150000000000034 , +" Temperature_Cell_Maximum" : 26.75 , +" Temperature_Cell_Minimum" : 25.75 , +" TimeStamp" : 1560346263 , +" Voltage_DC" : 53.158999999999999 , +" Voltage_DC_Maximum_Cell" : 3.3290000000000002 , +" Voltage_DC_Minimum_Cell" : 3.3180000000000001 +}, +{ +" Ca pa city_ Maxi mum" : 1200 , +" Current_DC" : 1.1200000000000001 , +" CycleCount_BatteryCell" : 256 , +" Designed Ca pacity" : 1200 , +" Details" : { +" Manufa ct urer " : "Sony", +"Model" : " unknown", +"Serial" : " S012002884 " +}, +"Enable" : 1, +" StateOfChar ge_ Relative" : 55, +" Status_BatteryCell" : 53, +" Temperature_Cell" : 25.550000000000011 , +" Temperature_Cell_Maximum" : 26.150000000000034 , +" Temperature_Cell_Minimum" : 25.350000000000023 , +" TimeStamp" : 1560346263 , +" Voltage_DC" : 53.146000000000001 , +" Voltage_DC_Maximum_Cell" : 3.3260000000000001 , +" Voltage_DC_Minimum_Cell" : 3.3170000000000002 +}, +{ +" Ca pa city_ Maxi mum" : 1200 , +" Current_DC" : 1.1200000000000001 , +" CycleCount_BatteryCell" : 255 , +" Designed Ca pacity" : 1200 , +" Details" : { +" Manufa ct urer " : "Sony", +"Model" : " unknown", +"Serial" : " S012002857 " +}, +"Enable" : 1, +" StateOfChar ge_ Relative" : 55, +" Status_BatteryCell" : 53, +" T emperat ure_ Cell" : 25.25 , +" Temperature_Cell_Maximum" : 25.75 , +" Temperature_Cell_Minimum" : 24.950000000000045 , +" TimeStamp" : 1560346263 , +" Voltage_DC" : 53.156999999999996 , +" Voltage_DC_Maximum_Cell" : 3.3260000000000001 , +" Voltage_DC_Minimum_Cell" : 3.3199999999999998 +} +] +} +} +}, +"Head" : { +" RequestArguments" : { +" DeviceClass" : " Storage", +"Scope" : "System" +}, +"Status" : { +"Code" : 0, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2019 - 06 - 12 T15 :31:12+02:00 " +} + + +{ +"Body" : { +"Data" : { +"0" : { +" Controller" : { +" Capacity_Maximum" : 11520 , +" Current_DC" : 0, +" DesignedCapacity" : 11520 , +" Details" : { +" Manufa ct urer " : "BYD", +"Model" : "BYD Battery - Box HV", +"Serial" : " 400481708 - 00059 " +}, +"Enable" : 1, +" StateOfCharge_Relative" : 4.7000000000000002 , +" Status_BatteryCell" : 3, +" Temperature_Cell" : 23.949999999999999 , +" TimeStamp" : 1560430543 , +" Voltage_DC" : 462.60000000000002 +}, +" Mod ules" : [] +} +} +}, +"Head" : { +" RequestArguments" : { +" DeviceClass" : " Storage", +"Scope" : "System" +}, +"Status" : { +"Code" : 0, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2019 - 06 - 13 T14 :55:44+02:00 " +} +} + +``` +Listing 49: Reply body for GetStorageRealtimeData System request (BYD B-Box) +``` +#### 4.9.9 Device-Request + +``` +Listing 50: Object structure of response body for GetStorageRealtimeData request +``` + +{ +"Body" : { +"Data" : { +" Controller" : { +" Capacity_Maximum" : 9800 , +" Current_DC" : 0.90000000000000002 , +" Designed Ca pacity" : 9800 , +" Details" : { +" Manufacturer" : "LG-Chem", +"Model" : "Resu H", +"Serial" : " 1706179036 " +}, +"Enable" : 1, +" StateOfChar ge_ Relative" : 56, +" Status_BatteryCell" : 3, +" Temperature_Cell" : 27.550000000000001 , +" TimeStamp" : 1560346267 , +" Voltage_DC" : 407.5 +}, +" Mod ules" : [] +} +}, +"Head" : { +" RequestArguments" : { +" DeviceClass" : " Storage", +" DeviceId" : "0", +"Scope" : "Device" +}, +"Status" : { +"Code" : 0, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2019 - 06 - 12 T15 :31:08+02:00 " +} +} + +``` +Platform Since version +Fronius Hybrid 1.6.1- 4 +Fronius Non Hybrid 3.8.1- 4 +Fronius GEN24/Tauro/Verto 1.13 +``` +``` +Listing 51: Reply body for GetStorageRealtimeData Device request (LG Chem Resu H) +``` +### 4.10 GetOhmPilotRealtimeData request + +This request provides detailed information about Ohmpilot. Inactive channels are not included in the response +and may vary depending on hardware and software version used. Take care about permanently or temporary +missing channels when processing this response. + +#### 4.10.1 Availability + + +# object with detailed i nfor mations about all Ohmpilots , +**object** { + +``` +object { +``` +``` +object { +# serial number of device +string Serial; +``` +``` +# e.g. " Ohmpilot" +string Model; +``` +``` +# e.g. " Fronius" +string Manufacturer; +``` +``` +# software version +string Software; +``` +``` +# hardware version +string Hardware; +} Details; +``` +``` +# total consumed energy [Wh] +number Ene rgy Re al_ W AC _ Sum_C ons u me d; +``` +``` +# CodeOfState Values: +# 0 ... up and running +# 1 ... keep minimum temperature +# 2 ... legionella protection +# 3 ... critical fault +# 4 ... fault +# 5 ... boost mode +number CodeOfState; +``` +``` +# refer to Ohmpilot manual +# optional field +number CodeOfError; +``` +``` +# actual power consumption [W] +number PowerReal_PAC_Sum; +``` +``` +# temperature from sensor [°C] +number Temperature_Channel_1 ; +``` +``` +} * Ohmpilot; +``` +} Data ; + +#### 4.10.2 URL for HTTP requests + +/solar_api/v1/GetOhmPilotRealtimeData.cgi + +#### 4.10.3 Parameters + +``` +Parameter Type Range/Values/Pattern Description +Scope String ”System” +”Device” +``` +``` +Mandatory +``` +``` +DeviceId String 0..65535 Mandatory on non system scope +``` +#### 4.10.4 Reference to manual + +https://www.fronius.com/~/downloads/Solar%20Energy/Operating%20Instructions/42%2C0410%2C2141.pdf + +#### 4.10.5 System-Request + +``` +Listing 52: Object structure of response body for GetOhmPilotRealtimeData System request +``` + +{ +"Body" : { +"Data" : { +"0" : { +" CodeOfError" : 926 , +" CodeOfState" : 0, +" Details" : { +" Hardware" : "3", +" Manufa ct urer " : " Fr onius", +"Model" : " Ohmpilot", +"Serial" : " 28136344 ", +" Software" : "1.0.19 - 1 " +}, +" EnergyReal_WAC_Sum_Consumed" : 2964307 , +" PowerReal_PAC_Sum" : 0, +" Temperature_Channel_1 " : 23.899999999999999 +} +} +}, +"Head" : { +" RequestArguments" : { +" Devi ceClass" : " OhmPi lot", +"Scope" : "System" +}, +"Status" : { +"Code" : 0, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2019 - 06 - 24 T10 :10:44+02:00 " +} +} + +``` +# hardware version +``` +``` +Listing 53: Reply body for GetOhmPilotRealtimeData System request +``` +#### 4.10.6 Device-Request + +``` +Listing 54: Object structure of response body for GetOhmPilotRealtimeData Device request +``` + +{ +"Body" : { +"Data" : { +" CodeOfError" : 926 , +" CodeOfState" : 0, +" Details" : { +" Hardware" : "3", +" Manufa ct urer " : " Fr onius", +"Model" : " Ohmpilot", +"Serial" : " 28136344 ", +" Software" : "1.0.19 - 1 " +}, +" EnergyReal_WAC_Sum_Consumed" : 2964307 , +" PowerReal_PAC_Sum" : 0, +" Temperature_Channel_1 " : 23.899999999999999 +} +}, +"Head" : { +" RequestArguments" : { +" Devi ceClass" : " OhmPi lot", +" DeviceId" : "0", +"Scope" : "Device" +}, +"Status" : { +"Code" : 0, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2019 - 06 - 24 T10 :10:41+02:00 " +} +} + +``` +Platform Since version +Fronius Hybrid 1.2.1-X +Fronius Non Hybrid 3.3.9-X +Fronius GEN24/Tauro/Verto ALWAYS +``` +``` +Listing 55: Reply body for GetOhmPilotRealtimeData Device request +``` +### 4.11 GetPowerFlowRealtimeData request + +This request provides detailed information about the local energy grid. The values replied represent the current +state. Because data has multiple asynchronous origins it is a matter of fact that the sum of all powers (grid, load +and generate) will differ from zero. +This request does not care about the configured visibility of single inverters. All inverters are reported. Same for +batteries. + +#### 4.11.1 Availability + +``` +# actual power consumption [W] +``` +``` +number Temperature_Channel_1 ; +``` + +``` +# mandatory field +``` +``` +# mandatory field +``` +``` +# mandatory field +``` +``` +# mandatory field +``` +#### 4.11.2 Version...................................................................................................................................................... + +This request is only a gateway to internal generated data containers. Please take care about the ”Version” field +in the response. Newer versions usually contain all previous items. +Version Changes +10 added smartloads/ohmpilot +added Version field +11 added secondary meters for subloads or extra production (Datamanager and HybridManager) +12 inverter nodes now provide component id +added secondary meters for subloads or extra production (GEN24/Tauro/Verto only) +added active power and apparent current per phase for primary meter +13 added OhmpilotEcos entry to Smartloads (GEN24/Tauro/Verto only) + +#### 4.11.3 URL for HTTP requests + +/solar_api/v1/GetPowerFlowRealtimeData.fcgi + +``` +Please note, for performance reasons the URL extension is different to other Solar API requests. +``` +#### 4.11.4 Parameters + +There are no parameters. Only one type of query exists. + +#### 4.11.5 Request + +``` +Listing 56: Object structure of response body for GetPowerFlowRealtimeData request +``` + +``` +number P_Load; +``` +``` +# mandatory field +# this value is null if no battery is active ( - charge , + discharge ) +number P_Akku; +``` +``` +# mandatory field +# this value is null if inverter is not running ( + production ( default ) ) +# On GEN24 and SymoHybrid: reports production on DC side (PV generator). +# On SnapInverter: is ident to power generated on AC side (ac power output). +number P_PV; +``` +``` +# mandatory field +# available since Fronius Hybrid version 1.3.1 - 1 +# available since Fronius Non Hybrid version 3.7.1 - 2 +# current relative self consumption in %, null if no smart meter is connected +number rel_SelfConsumption; +``` +``` +# mandatory field +# available since Fronius Hybrid version 1.3.1 - 1 +# available since Fronius Non Hybrid version 3.7.1 - 2 +# current relative autonomy in %, null if no smart meter is connected +number rel_Autonomy; +``` +``` +# optional field +# "load ", "grid" or " unknown" (during backup power) +string Meter_Location; +``` +``` +# optional field +# implemented since Fronius Non Hybrid version 3.4.1 - 7 +# this value is always null on GEN24 /Ta uro/Ver to +# AC Energy [Wh] this day , null if no inverter is connected +number E_Day; +``` +``` +# optional field +# implemented since Fronius Non Hybrid version 3.4.1 - 7 +# this value is always null on GEN24 /Ta uro/Ver to +# AC Energy [Wh] this year, null if no inverter is connected +number E_Year; +``` +``` +# optional field +# implemented since Fronius Non Hybrid version 3.4.1 - 7 +# implemented since Fronius GEN24 /Tauro/Verto version 1.14 and null before +# updated only every 5 minutes on GEN24 /Ta ur o/Vert o. +# AC Energy [Wh] ever since , null if no inverter is connected +number E_Total; +``` +} Site; + +**object** { + +``` +object { +``` +``` +# mandatory field +# device type of inverter +# GEN24 / Ta uro/Verto do report 1 +integer DT; +``` +``` +# mandatory field +# current power in Watt, null if not running (+ produce/export , - consume/ +import) +# This is power generated on AC side (ac power output). +integer P; +``` +``` +# optional field +# current state of charge in % as decimal ( 5.3% ) or integer (0 - 100%) +unsigned number SOC; +``` + +``` +# mandatory field +# implemented since Fronius Non Hybrid version 3.13.1 - 1 +# Fronius Hybrid version 1.11.1 - 1 +# PowerFlowVersion 12 +# component identification (8 bit group , 16 bit enum) +unsigned integer CID; +``` +``` +# optional field +# " disabled", "normal", " service", "charge boost", +# "nearly depleted", " suspended", " calibrate", +# "grid support", " deplete recovery", "non operable ( voltage)", +# "non operable ( temperature)", " preheating", " startup", +# " stopped ( temperat ure)", " battery full" +string Battery_Mode; +``` +``` +# optional field +# implemented since Fronius Non Hybrid version 3.7.1 - 1 +# Fronius Hybrid version 1.3.1 - 1 +# Fronius GEN24 /Ta uro/Verto always null +# AC Energy [Wh] this day , null if no inverter is connected +number E_Day; +``` +``` +# optional field +# implemented since Fronius Non Hybrid version 3.7.1 - 1 +# Fronius Hybrid version 1.3.1 - 1 +# Fronius GEN24 /Ta uro/Verto always null +# AC Energy [Wh] this year, null if no inverter is connected +number E_Year; +``` +``` +# optional field +# implemented since Fronius Non Hybrid version 3.7.1 - 1 +# Fronius Hybrid version 1.3.1 - 1 +# Fronius GEN24 /Tauro/Verto version 1.14 and null before +# updated only every 5 minutes on GEN24 /Tauro/Verto. +# AC Energy [Wh] ever since , null if no inverter is connected +number E_Total; +``` +``` +} * Devi ceId ; # SolarNet ring address ("1" on hybrid systems) +# GEN24 /Tauro/Verto devices always will use DeviceId 1 +``` +} Inverters; + +# optional field +# implemented since Fronius Non Hybrid version 3.8.1 - 1 +# Fronius Hybrid version 1.6.1 - 1 +# PowerFlowVersion 10 +**object** { + +``` +# optional field +# implemented since PowerFlowVersion 10 +# always available on GEN24 /Tauro/Verto +# on DM/HM only available when Ohmpilot is existing +object { +``` +``` +# optional field +# implemented since PowerFlowVersion 10 +object { +``` +``` +# mandatory field +# implemented since PowerFlowVersion 10 +# current power consumption in Watt +number P_AC_Total; +``` +``` +# mandatory field +# implemented since PowerFlowVersion 10 +``` + +``` +# operating state "normal", "min - temperature", "legionella - protection", +# "fault", " warning" or "boost" +string State; +``` +``` +# mandatory field +# implemented since PowerFlowVersion 10 +# temperature of storage / tank in degree Celsius +number Temperature; +``` +``` +} ComponentId; +``` +``` +} Ohmpilots; +``` +``` +# optional field +# implemented since PowerFlowVersion 13 +# Fronius GEN24 /Tauro/Verto version 1.33.1 +# always available on GEN24 /Ta uro/Verto +# not available on DM/HM +object { +``` +``` +# optional field +# implemented since PowerFlowVersion 13 +object { +``` +``` +# mandatory field +# implemented since PowerFlowVersion 13 +# current power consumption of OhmpilotEco in Watt +number P_AC_Total; +``` +``` +# mandatory field +# implemented since PowerFlowVersion 13 +# current operating state of heating rod 1: "normal", +# "min - temperature", "legionella - protection", "fault", " warning", +# "boost", "target - temperature", "max - temperature" +# or " timeschedule" +string State_HR1 ; +``` +``` +# mandatory field +# implemented since PowerFlowVersion 13 +# current operating state of heating rod 2: "normal", +# "min - temperature", "legionella - protection", "fault", " warning", +# "boost", "target - temperature", "max - temperature" +# or " timeschedule" +string State_HR2 ; +``` +``` +# mandatory field +# implemented since PowerFlowVersion 13 +# current temperature of heating rod 1 in degree Celsius +number Temperature_1 ; +``` +``` +# mandatory field +# implemented since PowerFlowVersion 13 +# current temperature of heating rod 2 in degree Celsius +number Temperature_2 ; +``` +``` +} ComponentId; +``` +``` +} OhmpilotEcos; +``` +} Smartloads; + +# optional field +# implemented since Fronius Non Hybrid version 3.12.1 - 1 +# Fronius Hybrid version 1.10.1 - 1 +# PowerFlowVersion 11 +# +# Fronius GEN24 /Tauro/Verto 1.22.1 - 1 + + +## 1& On GEN24/Tauro/Verto devices having no battery the fields ”SOC”=0.0 and ”Battery_Mode”=”disabled” + +``` +are falsely reported until 1.17.x. +``` +Reference to device type table in section 6.2. +Reference to meter location table in section 6.5. + +``` +Listing 57: Reply body for GetPowerFlowRealtimeData on Fronius Hybrid System +``` +``` +PowerFlowVersion 13 +``` +``` +# implemented since PowerFlowVersion 11 +``` +``` +# mandatory field +# implemented since PowerFlowVersion 11 +``` +``` +# mandatory field +# implemented since PowerFlowVersion 11 +``` +``` +number MLoc; +``` +``` +# mandatory field +# implemented since PowerFlowVersion 11 +``` +``` +# mandatory field +# implemented since PowerFlowVersion 11 +# category token +# +# +# " METER_CAT_PV_BAT" +# +# " METER_CAT_BHKW" +# " METER_CAT_ECAR" +# " +# +# " METER_CAT_PUMP" +# +# " METER_CAT_CLIMATE" +# " METER_CAT_BUILDING" +# " +``` + +Listing 58: Reply body for GetPowerFlowRealtimeData on Fronius Non Hybrid System + +``` +" rel_Autonomy" : 100 , +``` + +Category" + +Listing 59: Reply body for GetPowerFlowRealtimeData on GEN24 Primo + + +Listing 60: Reply body for GetPowerFlowRealtimeData on Tauro + + +``` +Platform Since version +Fronius Hybrid 1.1.2- 16 +Fronius Non Hybrid 3.3.4- 5 +Fronius GEN24/Tauro/Verto NEVER +``` +## 1& GEN24/Tauro/Verto does not provide access to history data + +## 1& On days where daylight saving time is changing (begin or end of summertime) a few problems are + +``` +known regarding time calculation. +``` +## 5 Archive Requests + +### 5.1 Common + +Archive requests shall be provided whenever access to historic device-data is possible and it makes sense to +provide such a request. +Of course, the Datalogger Web can only provide what is stored in its internal memory and has not been overwritten +by newer data yet. It can loose data, due to capacity reason. The number of days stored is dependent on the +number of connected units to log. This limitation is not present for Solar.web, provided that the Datalogger has +reliably uploaded the data. + +Different from what is specified within the previously released drafts, there is only one CGI to access all historic +data. This CGI contains detailed, summed, error and events queries. + +``` +Call is http:///solar_api/v1/GetArchiveData.cgi? +``` +``` +The number of parallel queries is system wide restricted to 4 clients. +``` +#### 5.1.1 Availability + +#### 5.1.2 ChannelId + +Each channel is handled and requested by name. Most of the channels are recorded in constant cyclic intervals +which can be set between 5 and 30 minutes. Only _Digital_ _ _PowerManagementRelay_ _ _Out_ _ _∗_ , _InverterErrors_ , +_InverterEvents_ and _Hybrid_ _ _Operating_ _ _State_ are event triggered and may occure every time. +5 + +(^5) introduced in Solar API CompatibilityRange Version 1.5- 10 (Datamanager 3.11.1 or Hybridmanager 1.9.1) + +## 1& Energies are not provided and device types DT are invalid on GEN24/Tauro/Verto + + +``` +Table 5: Available channels +``` +(^6) Not implemented on inverters. +Name Unit +TimeSpanInSec +EnergyReal_WAC_Sum_Produced +EnergyReal_WAC_Sum_Consumed^6 +InverterEvents +InverterErrors +Current_DC_String_1 +Current_DC_String_2 +Voltage_DC_String_1 +Voltage_DC_String_2 +Temperature_Powerstage +Voltage_AC_Phase_1 +Voltage_AC_Phase_2 +Voltage_AC_Phase_3 +Current_AC_Phase_1 +Current_AC_Phase_2 +Current_AC_Phase_3 +PowerReal_PAC_Sum +sec +Wh +Wh +struct +struct +1A +1A +1V +1V +deg C +1V +1V +1V +1A +1A +1A +1W +EnergyReal_WAC_Minus_Absolute +EnergyReal_WAC_Plus_Absolute +Meter_Location_Current +1Wh +1Wh +1 +Temperature_Channel_1 +Temperature_Channel_2 +Digital_Channel_1 +Digital_Channel_2 +Radiation + +##### 1 + +##### 1 + +##### 1 + +##### 1 + +##### 1 + +``` +Digital_PowerManagementRelay_Out_1 +Digital_PowerManagementRelay_Out_2 +Digital_PowerManagementRelay_Out_3 +Digital_PowerManagementRelay_Out_4 +``` +##### 1 + +##### 1 + +##### 1 + +##### 1 + +``` +Hybrid_Operating_State 1 +``` + +#### 5.1.3 Parameters + +``` +Scope String ”Device” +”System” +``` +``` +Query specific device(s) or whole system. +Mandatory +SeriesType String ”DailySum” +”Detail” (default) +``` +``` +Resolution of the data-series. Optional +``` +``` +HumanReadable BoolString ”True” (default) +”False” +``` +``` +Unset/Set readable output. Optional +``` +``` +StartDate DateString ”21.5.[20]14” +”5/21/[20]14” +”[20]14- 5 - 21” +”2011- 10 - +20T10:09:14+02:00” +``` +``` +Mandatory +supplying only the date will be interpreted as +local time +``` +``` +EndDate DateString ”21.5.[20]14” +”5/21/[20]14” +”[20]14- 5 - 21” +”2011- 10 - +20T10:09:14Z” +``` +``` +Mandatory +``` +``` +Channel String available channels from table 5. Mandatory, multiple times +DeviceClass String ”Inverter” +”SensorCard” +”StringControl” +``` +``` +Which kind of device will be queried. Manda- +tory and accepted only if Scope is not ”Sys - +tem” +DeviceClass ”Meter” +”Storage” +”OhmPilot” +``` +``` +since DM 3.7.4- 6 HM 1.3.1- 1 +since DM 3.7.4- 6 HM 1.3.1- 1 +since DM 3.8.1- 4 HM 1.6.1- 4 +DeviceId String Solar Net: 0 ...199 Only needed for Scope ”Device” +Which device to query. +This parameter can be given more than once, +thus specifying a list of devices to query. +``` +#### 5.1.4 Object Structure of response body + +``` +Listing 61: Object structure of request body +``` + +// / solar_api/v1/ GetArchiveData.cgi?Scope=System& StartDate=1.3.2018& EndDate=1.3.2018& +Channel=TimeSpanInSec& Channel=EnergyReal_WAC_Plus_Absolute& Channel= +EnergyReal_WAC_Minus_Absolute& Channel=Meter_Location_Current + +``` +" TimeSpanInSec" : +``` +``` +" _comment" : " channelId =65549 " +``` +### 5.2 Example of response body + +#### 5.2.1 Meter data + +``` +Listing 62: detailed response body for meter data +``` + +" NodeType" : 97, +"Start" : "2018 - 03 - 01 T00 :00:00+01:00 " +}, +"meter:15480258 " : +{ +"Data" : +{ +" EnergyReal_WAC_Minus_Absolute" : +{ +"Unit" : "Wh", +"Values" : +{ +"0" : 744657 , +"10200 " : 744657 , +"10500 " : 744657 , +/* shorten list for readability */ +"9300 " : 744657 , +"9600 " : 744657 , +"9900 " : 744657 +}, +" _comment" : " channelId =167837960 " +}, +" EnergyReal_WAC_Plus_Absolute" : +{ +"Unit" : "Wh", +"Values" : +{ +"0" : 605047 , +"10200 " : 605194 , +"10500 " : 605198 , +"10800 " : 605202 , +/* shorten list for readability */ +"9000 " : 605177 , +"9300 " : 605181 , +"9600 " : 605185 , +"9900 " : 605190 +}, +" _comment" : " channelId =167772424 " +}, +" Meter_Locati on_C urre nt" : +{ +"Unit" : "1", +"Val ues" : +{ +"0" : 0, +"10200 " : 0, +"10500 " : 0, +"10800 " : 0, +/* shorten list for readability */ +"9600 " : 0, +"9900 " : 0 +}, +" _comment" : " channelId =117050390 " +} +}, +"End" : "2018 - 03 - 01 T23 :59:59+01:00 ", +"Start" : "2018 - 03 - 01 T00 :00:00+01:00 " +} +} +}, +"Head" : +{ +" RequestArguments" : +{ +" Channel" : +[ +" TimeSpanInSec", + + +// / solar_api/v1/ GetArchiveData.cgi?Scope=System& StartDate=1.3.2018& EndDate=1.3.2018& + +``` +" _comment" : " channelId =67830024 " +``` +``` +" NodeType" : 120 , +``` +#### 5.2.2 Inverter data + +``` +Listing 63: detailed response body with multiple inverters +``` +``` +" EnergyReal_WAC_Minus_Absolute", +``` +``` +" HumanReadable" : "True", +``` + +// / solar_api/v1/ GetArchiveData.cgi?Scope=System& StartDate=1.3.2018& EndDate=2.3.2018& + +{ +" En e rg y Re a l_ W A C _ S u m _ P r o d u ce d" : +{ +"Unit" : "Wh", +"Values" : +{ +"39900 " : 319.23555555555555 , +/* shorten list for readability */ +"85200 " : 0, +"85500 " : 0, +"85800 " : 0, +"86100 " : 0 +}, +" _comment" : " channelId =67830024 " +} +}, +" DeviceType" : 192 , +"End" : "2018 - 03 - 01 T23 :59:59+01:00 ", +" NodeType" : 121 , +"Start" : "2018 - 03 - 01 T00 :00:00+01:00 " +} +} +}, +"Head" : +{ +" RequestArguments" : +{ +" Channel" : +[ +" EnergyReal_WAC_Sum_Produced", +" EnergyReal_WAC_Sum_Consumed" +], +" EndDate" : "2018 - 03 - 01 T23 :59:59+01:00 ", +" HumanReadable" : "True", +"Scope" : "System", +" SeriesType" : "Detail", +" StartDate" : "2018 - 03 - 01 T00 :00:00+01:00 " +}, +"Status" : +{ +"Code" : 0, +" ErrorDetail" : +{ +"Nod es" : [] +}, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2018 - 03 - 02 T09 :49:51+01:00 " +} +} + +#### 5.2.3 Errors - Structure + +``` +Listing 64: Example of response body for inverter errors +``` + +// / solar_api/v1/ GetArchiveData.cgi?Scope=System& StartDate=2.3.2018& EndDate=2.3.2018& + +#### 5.2.4 Events - Structure + +``` +Listing 65: Example of response body for inverter events +``` +``` +" _comment": " channelId =16646144 " +``` +``` +" NodeType": 97, +``` +``` +" RequestArguments": { +``` +``` +" HumanReadable": "True", +``` +``` +" UserMessage": "" +``` + +// / s o l a r _a p i / v1 / G e t Ar ch i ve Da ta. cg i? Sc o p e= D e vi ce & D e vi c e C la ss = Oh m P i lo t& D e vi c e I d = 0 & StartDate += 6. 3. 201 8 & E n d D a t e =6. 3. 20 1 8 & Channel=EnergyReal_WAC_Sum_Consumed + +"Val ues" : +{ +"42060 " : /* seconds after "Start" */ +{ +"#" : 3, /* Event Code 3 */ +"attr" : /* Event Specific Data */ +{ +"Power" : "20 [%]", +" Radient" : "255 [1]", +"affect" : "P" +}, +"desc" : "Power limitation 20%", /* Event Description */ +"flags" : +[ +"send" +] +} +}, +" _comment" : " channelId =16711680 " +} +}, +"End" : "2018 - 03 - 02 T23 :59:59+01:00 ", +"Start" : "2018 - 03 - 02 T00 :00:00+01:00 " +} +} +}, +"Head" : +{ +" RequestArguments" : +{ +" Channel" : +[ +" InverterEvents" +], +" EndDate" : "2018 - 03 - 02 T23 :59:59+01:00 ", +" HumanReadable" : "True", +"Scope" : "System", +" SeriesType" : "Detail", +" StartDate" : "2018 - 03 - 02 T00 :00:00+01:00 " +}, +"Status" : +{ +"Code" : 0, +" ErrorDetail" : +{ +"Nod es" : [] +}, +"Reason" : "", +" UserMessage" : "" +}, +" Timestamp" : "2018 - 03 - 02 T11 :42:50+01:00 " +} +} + +#### 5.2.5 OhmPilot Energy + +OhmPilot uses total energy counter! + +``` +Listing 66: detailed response body for one OhmPilot +``` + +"Data" : +{ +" ohmpilot:28136344 " : +{ +"Data" : +{ +" En e rg y Re a l_ W A C _ S u m _ C o n s u m e d" : +{ +"Unit" : "Wh", +"Values" : +{ +"0" : 858547 , +"10200 " : 858547 , +"10500 " : 858547 , +"10800 " : 858547 , +"11100 " : 858547 , +"11400 " : 858547 , +"11700 " : 858547 , +"1200 " : 858547 , +"12000 " : 858547 , +/* shorten list for readability */ +"84000 " : 867084 , +"84300 " : 867085 , +"84600 " : 867087 , +"84900 " : 867089 , +"85200 " : 867091 , +"85500 " : 867093 , +"85800 " : 867095 , +"86100 " : 867097 , +"8700 " : 858547 , +"900 " : 858547 , +"9000 " : 858547 , +"9300 " : 858547 , +"9600 " : 858547 , +"9900 " : 858547 +}, +" _comment" : " channelId =67895560 " +} +}, +"End" : "2018 - 03 - 06 T23 :59:59+01:00 ", +"Start" : "2018 - 03 - 06 T00 :00:00+01:00 " +} +} +}, +"Head" : +{ +" RequestArguments" : +{ +" Channel" : +[ +" EnergyReal_ WAC_Sum_ Co nsumed" +], +" Devi ceClass" : " OhmPi lot", +" DeviceId" : "0", +" EndDate" : "2018 - 03 - 06 T23 :59:59+01:00 ", +" HumanReadable" : "True", +"Scope" : "Device", +" SeriesType" : "Detail", +" StartDate" : "2018 - 03 - 06 T00 :00:00+01:00 " +}, +"Status" : +{ +"Code" : 0, +" ErrorDetail" : +{ +"Nod es" : [] +}, + + +## 6 Definitions and Mappings + +### 6.1 Sunspec State Mapping + +``` +Table 6: Shows mapping between Fronius device status and SunSpec Inverter-Model states +``` +``` +Fronius device state SunSpec device state +not used I_STATUS_OFF +not used I_STATUS_SLEEPING +not used I_STATUS_THROTTLED +not used I_STATUS_SHUTTING_DOWN +10 I_STATUS_FAULT +8 I_STATUS_STANDBY +7 I_STATUS_MPPT +others I_STATUS_STARTING +``` +### 6.2 Inverter Device Type List..................................................................................................................................... + +``` +DeviceType Model Name +1 any Fronius GEN24/Tauro/Verto +42 Symo Advanced 10.0- 3 - M +43 Symo Advanced 20.0- 3 - M +44 Symo Advanced 17.5- 3 - M +45 Symo Advanced 15.0- 3 - M +46 Symo Advanced 12.5- 3 - M +47 Symo Advanced 24.0- 3 480 +48 Symo Advanced 22.7- 3 480 +49 Symo Advanced 20.0- 3 480 +50 Symo Advanced 15.0- 3 480 +51 Symo Advanced 12.0- 3 208 - 240 +52 Symo Advanced 10.0- 3 208 - 240 +67 Fronius Primo 15.0- 1 208 - 240 +68 Fronius Primo 12.5- 1 208 - 240 +69 Fronius Primo 11.4-1 208- 240 +70 Fronius Primo 10.0- 1 208 - 240 +71 Fronius Symo 15.0- 3 208 +72 Fronius Eco 27.0- 3 - S +73 Fronius Eco 25.0- 3 - S +75 Fronius Primo 6.0- 1 +76 Fronius Primo 5.0- 1 +77 Fronius Primo 4.6- 1 +78 Fronius Primo 4.0- 1 +79 Fronius Primo 3.6- 1 +80 Fronius Primo 3.5- 1 +81 Fronius Primo 3.0- 1 +82 Fronius Symo Hybrid 4.0- 3 - S +83 Fronius Symo Hybrid 3.0- 3 - S +84 Fronius IG Plus 120 V- 1 +``` + +85 Fronius Primo 3.8- 1 208 - 240 +86 Fronius Primo 5.0- 1 208 - 240 +87 Fronius Primo 6.0- 1 208 - 240 +88 Fronius Primo 7.6- 1 208 - 240 +89 Fronius Symo 24.0- 3 USA Dummy +90 Fronius Symo 24.0- 3 480 +91 Fronius Symo 22.7- 3 480 +92 Fronius Symo 20.0- 3 480 +93 Fronius Symo 17.5- 3 480 +94 Fronius Symo 15.0- 3 480 +95 Fronius Symo 12.5- 3 480 +96 Fronius Symo 10.0- 3 480 +97 Fronius Symo 12.0- 3 208 - 240 +98 Fronius Symo 10.0- 3 208 - 240 +99 Fronius Symo Hybrid 5.0- 3 - S +100 Fronius Primo 8.2- 1 Dummy +101 Fronius Primo 8.2- 1 208 - 240 +102 Fronius Primo 8.2- 1 +103 Fronius Agilo TL 360.0- 3 +104 Fronius Agilo TL 460.0- 3 +105 Fronius Symo 7.0- 3 - M +106 Fronius Galvo 3.1- 1 208 - 240 +107 Fronius Galvo 2.5- 1 208 - 240 +108 Fronius Galvo 2.0- 1 208 - 240 +109 Fronius Galvo 1.5- 1 208 - 240 +110 Fronius Symo 6.0- 3 - M +111 Fronius Symo 4.5- 3 - M +112 Fronius Symo 3.7- 3 - M +113 Fronius Symo 3.0- 3 - M +114 Fronius Symo 17.5- 3 - M +115 Fronius Symo 15.0- 3 - M +116 Fronius Agilo 75.0- 3 Outdoor +117 Fronius Agilo 100.0- 3 Outdoor +118 Fronius IG Plus 55 V- 1 +119 Fronius IG Plus 55 V- 2 +120 Fronius Symo 20.0- 3 Dummy +121 Fronius Symo 20.0- 3 - M +122 Fronius Symo 5.0- 3 - M +123 Fronius Symo 8.2- 3 - M +124 Fronius Symo 6.7- 3 - M +125 Fronius Symo 5.5- 3 - M +126 Fronius Symo 4.5- 3 - S +127 Fronius Symo 3.7- 3 - S +128 Fronius IG Plus 60 V- 2 +129 Fronius IG Plus 60 V- 1 +130 SPR 8001F- 3 EU +131 Fronius IG Plus 25 V- 1 +132 Fronius IG Plus 100 V- 3 +133 Fronius Agilo 100.0- 3 +134 SPR 3001F- 1 EU +135 Fronius IG Plus V/A 10.0- 3 Delta +136 Fronius IG 50 +137 Fronius IG Plus 30 V- 1 +138 SPR-11401f- 1 UNI +139 SPR-12001f- 3 WYE277 +140 SPR-11401f- 3 Delta +141 SPR-10001f- 1 UNI +142 SPR-7501f- 1 UNI +143 SPR-6501f- 1 UNI + + +144 SPR-3801f- 1 UNI +145 SPR-3301f- 1 UNI +146 SPR 12001F- 3 EU +147 SPR 10001F- 3 EU +148 SPR 8001F- 2 EU +149 SPR 6501F- 2 EU +150 SPR 4001F- 1 EU +151 SPR 3501F- 1 EU +152 Fronius CL 60.0 WYE277 Dummy +153 Fronius CL 55.5 Delta Dummy +154 Fronius CL 60.0 Dummy +155 Fronius IG Plus V 12.0- 3 Dummy +156 Fronius IG Plus V 7.5- 1 Dummy +157 Fronius IG Plus V 3.8- 1 Dummy +158 Fronius IG Plus 150 V- 3 Dummy +159 Fronius IG Plus 100 V- 2 Dummy +160 Fronius IG Plus 50 V- 1 Dummy +161 Fronius IG Plus V/A 12.0- 3 WYE +162 Fronius IG Plus V/A 11.4- 3 Delta +163 Fronius IG Plus V/A 11.4- 1 UNI +164 Fronius IG Plus V/A 10.0- 1 UNI +165 Fronius IG Plus V/A 7.5- 1 UNI +166 Fronius IG Plus V/A 6.0- 1 UNI +167 Fronius IG Plus V/A 5.0- 1 UNI +168 Fronius IG Plus V/A 3.8- 1 UNI +169 Fronius IG Plus V/A 3.0- 1 UNI +170 Fronius IG Plus 150 V- 3 +171 Fronius IG Plus 120 V- 3 +172 Fronius IG Plus 100 V- 2 +173 Fronius IG Plus 100 V- 1 +174 Fronius IG Plus 70 V- 2 +175 Fronius IG Plus 70 V- 1 +176 Fronius IG Plus 50 V- 1 +177 Fronius IG Plus 35 V- 1 +178 SPR 11400f- 3 208/240 +179 SPR 12000f- 277 +180 SPR 10000f +181 SPR 10000F EU +182 Fronius CL 33.3 Delta +183 Fronius CL 44.4 Delta +184 Fronius CL 55.5 Delta +185 Fronius CL 36.0 WYE277 +186 Fronius CL 48.0 WYE277 +187 Fronius CL 60.0 WYE277 +188 Fronius CL 36.0 +189 Fronius CL 48.0 +190 Fronius IG TL 3.0 +191 Fronius IG TL 4.0 +192 Fronius IG TL 5.0 +193 Fronius IG TL 3.6 +194 Fronius IG TL Dummy +195 Fronius IG TL 4.6 +196 SPR 12000F EU +197 SPR 8000F EU +198 SPR 6500F EU +199 SPR 4000F EU +200 SPR 3300F EU +201 Fronius CL 60.0 +202 SPR 12000f + + +203 SPR 8000f +204 SPR 6500f +205 SPR 4000f +206 SPR 3300f +207 Fronius IG Plus 12.0- 3 WYE277 +208 Fronius IG Plus 50 +209 Fronius IG Plus 100 +210 Fronius IG Plus 100 +211 Fronius IG Plus 150 +212 Fronius IG Plus 35 +213 Fronius IG Plus 70 +214 Fronius IG Plus 70 +215 Fronius IG Plus 120 +216 Fronius IG Plus 3.0- 1 UNI +217 Fronius IG Plus 3.8- 1 UNI +218 Fronius IG Plus 5.0- 1 UNI +219 Fronius IG Plus 6.0- 1 UNI +220 Fronius IG Plus 7.5- 1 UNI +221 Fronius IG Plus 10.0- 1 UNI +222 Fronius IG Plus 11.4- 1 UNI +223 Fronius IG Plus 11.4- 3 Delta +224 Fronius Galvo 3.0- 1 +225 Fronius Galvo 2.5- 1 +226 Fronius Galvo 2.0- 1 +227 Fronius IG 4500 - LV +228 Fronius Galvo 1.5- 1 +229 Fronius IG 2500 - LV +230 Fronius Agilo 75.0- 3 +231 Fronius Agilo 100.0- 3 Dummy +232 Fronius Symo 10.0- 3 - M +233 Fronius Symo 12.5- 3 - M +234 Fronius IG 5100 +235 Fronius IG 4000 +236 Fronius Symo 8.2- 3 - M Dummy +237 Fronius IG 3000 +238 Fronius IG 2000 +239 Fronius Galvo 3.1- 1 Dummy +240 Fronius IG Plus 80 V- 3 +241 Fronius IG Plus 60 V- 3 +242 Fronius IG Plus 55 V- 3 +243 Fronius IG 60 ADV +244 Fronius IG 500 +245 Fronius IG 400 +246 Fronius IG 300 +247 Fronius Symo 3.0- 3 - S +248 Fronius Galvo 3.1- 1 +249 Fronius IG 60 HV +250 Fronius IG 40 +251 Fronius IG 30 Dummy +252 Fronius IG 30 +253 Fronius IG 20 +254 Fronius IG 15 + + +### 6.3 Event Table for Fronius Devices + +``` +Event Code Description +1 System offset +2 Calibrate factor +3 Power control commands +4 Gradual Voltage dependend Power Reduction +5 Frequency Limit Change +6 Enter Backup Power Mode +7 Leave Backup Power Mode +8 Critical SOC reached within backmode +9 Component Specific StateCode +10 Calibration Suspension enabled +11 Datamanager reboot due to malfunction +``` +### 6.4 Hybrid_Operating_State + +``` +Hybrid_Operating_State Description +0 disabled +1 normal +2 service +3 charge boost +4 nearly depleted +5 suspended +6 calibrate +7 grid support +8 deplete recovery +9 non operable ( temperature ) +10 non operable ( voltage ) +11 preheating +12 startup +13 until Hybrid 1.13.1: awake but non operable ( temperature ) +since Hybrid 1.13.1: stopped ( temperature ) +14 battery full +``` +### 6.5 Meter Locations + +``` +Meter Location Description +0 Load +1 Grid +2 RESERVED +3 additional A.C. generator (generation only) +4 additional A.C. generator providing a battery (consumption and generation) +5 - 255 RESERVED +256 - 511 Sub Load +``` +## 7 Changelog + +Document version 21 + +- Added SM IP to the devicetypes and simplified the SM UL version in WND-WR-MB. +- Added note EnergyReal_WAC_Sum_Consumed not implemented in inverters. +- Added time zone details for Gen24 devices. +- Updated the questions and answers. + +Document Version 20 + +- Added OhmpilotEcos entry to GetPowerFlowRealtimeData (GEN24/Tauro/Verto only). + +Document Version 19 + + +- updated device type list + +Document Version 18 + +- fixed dead reference to online manual under section 4.10.4 +- Tauro behaves ident to GEN24. Added Tauro examples. +- Added GEN24/Tauro/Verto devicetype 1 to table. +- Adding four MPPT tracker IDC/UDC entries to GEN24 Symo GetInverterRealtimeData CommonInver- + terData example. + +Document Version 17 + +- Fixed description about PowerFlow version attribute which is infact a number within a string. +- Updated details about GetInverterRealtime DataCollections at Gen24 and Symo Hybrid. +- Adding chapter explaining enabling/disabling of Solar API ( 3 ). +- Re-editing meter model descriptions at GetMeterRealtimeData. TS and UL Meter have signed current. + +Document Version 16 + +- Timing constraints for archive requests updated (2.6). +- Update json example of request GetInverterRealtimeData and collection 3PInverterData for GEN24. +- Value T_Ambient in GetInverterRealtimeData is only supported by few devices (added listing). +- Added meter location dependend direction table for energies and powers (4.8.6) +- GEN24 Inverter will only provide total energy counters in 1.14 or later (no year and day values anymore) +- GEN24 provide swagger open api interface specification file (2.2.1) + +Document Version 15 + +- Timing constraints for Realtime Requests added (2.6). +- Carlo Gavazzi meter devices added (4.8). + +Document Version 14 + +- PowerFlowRealtimeData battery state 14 ”battery full” added +- Flag inverter energies within realtime requests as imprecise + +Document Version 13 + +- description for Fronius GEN24 added. +- updated and added missing json examples +- added inverter device type list in section 6.2 +- PowerFlowRealtimeData provides data of secondary meters +- added GetStorageRealtime example for LG-Chem and BYD B-Box +- NOTE: manufacturer changed for Solar Battery at GetStorageRealtimeData.cgi +- PowerFlowRealtimeData battery state 13 ”stopped (temperature)” added +- Inverter energy is AC related +- PowerFlowRealtimeData battery soc changed from non-decimal to decimal on demand (support both) +- PowerFlowRealtimeData introduced component identifier field CID +- added meter location table in section 6.5 + +Document Version 12 + +- never been published. Changes listed at version 13 + +Document Version 11 + +- NOTE: DefaultLanguage at GetLoggerInfo will be removed soon + +Document Version 10 + +- note that all inverters (even invisible configured) are reportet at PowerFlow and Inverter request + + +- fixed description about availability of rel_Autonomy and rel_SelfConsumption at PowerFlow request +- fixed missing description of BatteryStandby at PowerFlow request +- improved and fixed GetArchiveData descriptions and examples + +Document Version 9 + +- _Battery_ _ _Mode_ at PowerFlowRealtimeData got more states +- fixed GetLoggerLEDInfo.cgi example +- added meter location state ”unknown” while backup power is active +- placed notification to use http-get request (refer to section 2.4) +- added Smartloads/OhmPilot node at PowerFlowRealtimeData.fcgi +- added description about PowerFlowRealtimeData versioning +- described _Status_ _ _BatteryCell_ for Controller of Tesla at GetStorageRealtimeData.cgi +- added _Status_ _ _Battery_ description for Tesla at GetStorageRealtimeData.cgi +- GetInverterRealtimeData PAC type changed from unsigned to signed integer +- added channel names for Sensor Card (refer to table 5 ) +- added description of field DeliveryFactor at GetLoggerInfo and updated example +- fixed description of GetInverterInfo: properties ’Show’ and ’CustomName’ have been mandatory since + Version 3.0.3 +- added GetOhmPilotRealtimeData.cgi +- added description of all possible Error Codes +- intodruced Solar API ”Compatibility Range” at GetAPIVersion.cgi +- fixed description of datatypes + +``` +cgi Field old description fixed description +GetAPIVersion.cgi APIVersion number unsigned integer +GetInverterInfo.cgi Body.Data.<>... +...ErrorCode +...StatusCode +Body.Data.<>.Show +``` +``` +number +``` +``` +number +``` +``` +integer +``` +``` +unsigned integer +GetInverterRealtimeData.cgi Body.Data... +...DAY_ENERGY +...YEAR_ENERGY +...TOTAL_ENERGY +``` +``` +unsigned int unsigned number +``` +15th Septemper 2016 + +- fixed availability notes of GetInverterRealtimeData +- OhmPilot is listed too +- added battery status description +- added description for energies at GetPowerFlowRealtimeData + +11th February 2016 + +- fixed availability of request GetPowerFlowRealtimeData + +13th August 2015 + +- Added realtime request GetPowerFlowRealtimeData to api + +10th July 2015 + +- Added realtime request GetStorageRealtimeData to api + +1st June 2015 + +- Minor documentation update. + GetLoggerLedInfo.cgi added ”alternating” led state (timeout of access point) + GetArchiveData.cgi revised data queries and responses + + +## 8 Frequently asked questions + +1. The application I wrote for the Fronius Datalogger Web does not work with the Fronius Datamanager. + Why is that? + This is because we had to make some changes in the API to ensure compatibility with future devices. + Specifically the DeviceIndex parameter is now named DeviceId and the request URLs have been changed + to include an API version. For further details please refer to the latest version of the API specs. +2. Which data can I get? + Currently only realtime data from inverters, Fronius Sensor Cards and Fronius String Controls. Also some + information about the logging device itself is available. + Please refer to the API specs for further details. +3. Can multiple clients send requests to the API at the same time? + Yes, but the requests may take longer to complete. +4. Can I use this API at the same time as other services of the Datalogger Web / DataManager? + Yes. The datalogging, Solar.access/Solar.web connection, Webinterface, this API or any other service can + be used independently from the others. +5. Can the API calls be password protected? + No. The API is always accessible without authentication, regardless of the user or admin password set on + the Webinterface. +6. The API reports more inverters than I have, why is that? + This may be the case when the inverter number of an inverter is changed while the Fronius Datalogger Web + / Fronius Datamanager is running. The logger then detects a new device but keeps the same device with + the previous inverter number in the system for 24 hours. This is due to the fact that the datalogger is caching + the devices for a certain time even if they are not present on the bus (e.g. to be able to display energy values + during the night when the inverters are offline). + Those ghost devices will disappear 24 hours after the have been last seen by the datalogger. Alternatively, + a reboot of the datalogger also clears the device cache and repopulates it with the currently present devices. +7. What is the maximum requests per second? + Maximum is 1 request per second. +8. What is the maximum number of simultaneous connections? + There is no limit on simulatenous connections; however, the Datamanager, Hybridmanager, Gen24 could + take longer to response, see the timeout section in page 9 for more details. +9. What is the minimum data update? + Crucial inverter data is updated every second. Non crucial data on Datamanagers/Hybridmanagers, + according to the configured Solarweb datalogging interval. For Gen24 every 5 min. + + +# Fronius Worldwide - http://www.fronius.com/addresses + +``` +Fronius International GmbH +4600 Wels, Froniusplatz 1, Austria +E-Mail: pv-sales@fronius.com +http://www.fronius.com +``` +``` +Fronius USA LLC Solar Electronics Division +6797 Fronius Drive, Portage, IN 46368 +E-Mail: pv-us@fronius.com +http://www.fronius-usa.com +``` +Under [http://www.fronius.com/addresses](http://www.fronius.com/addresses) you will find all addresses of our sales branches and partner firms! + + diff --git a/extensions/fronius-inverter/CHANGELOG.md b/extensions/fronius-inverter/CHANGELOG.md index 7bf3097c8a6..e61627630d2 100644 --- a/extensions/fronius-inverter/CHANGELOG.md +++ b/extensions/fronius-inverter/CHANGELOG.md @@ -1,5 +1,15 @@ # Changelog +## Version 1.1 - {PR_MERGE_DATE} + +- Added comprehensive documentation with detailed JSDoc comments throughout the codebase. + +- **AI-Powered Analysis Tools:** +- Added system analysis tool that provides insights about current production, consumption, and energy flow. +- Implemented error explanation tool that interprets inverter error codes and suggests troubleshooting steps. +- Created optimization suggestions tool that offers practical tips to improve system performance based on current data. +- All AI tools fetch real-time data directly from the Fronius API for accurate analysis. + ## [Initial Release] - 2025-03-03 - **Unified Dashboard:** diff --git a/extensions/fronius-inverter/README.md b/extensions/fronius-inverter/README.md index bf8c4a02fd9..238ce6d29fb 100644 --- a/extensions/fronius-inverter/README.md +++ b/extensions/fronius-inverter/README.md @@ -12,4 +12,19 @@ A Raycast extension to monitor your Fronius Gen24 inverter in realtime. This ext - **Inverter Watch (Menu Bar)** - Runs in the menu bar, polling every 30 seconds for inverter errors. - Displays a badge with a warning emoji and error count if errors exist, or a green check if all is OK. - - Tap “Show Dashboard” to quickly open the full dashboard view. + - Tap "Show Dashboard" to quickly open the full dashboard view. + +- **AI-Powered Insights** + - **System Analysis**: Get intelligent insights about your current system state, including production efficiency, consumption patterns, and energy flow observations. + - **Error Explanation**: When errors occur, receive detailed explanations of what the error codes mean, potential causes, and recommended troubleshooting steps. + - **Optimization Suggestions**: Receive practical recommendations to optimize your solar system's performance based on real-time data. + - All AI features use real-time data directly from your Fronius inverter for accurate and relevant insights. + +## Requirements + +- Fronius Gen24 inverter with accessible API on your local network +- Raycast Pro subscription (for AI features) + +## Configuration + +In the extension preferences, set the base URL of your Fronius inverter (e.g., http://192.168.0.75). diff --git a/extensions/fronius-inverter/metadata/fronius-inverter-1.png b/extensions/fronius-inverter/metadata/fronius-inverter-1.png index 4e43695d61a..3ff41ae6427 100644 Binary files a/extensions/fronius-inverter/metadata/fronius-inverter-1.png and b/extensions/fronius-inverter/metadata/fronius-inverter-1.png differ diff --git a/extensions/fronius-inverter/metadata/fronius-inverter-2.png b/extensions/fronius-inverter/metadata/fronius-inverter-2.png new file mode 100644 index 00000000000..eff167f1fbf Binary files /dev/null and b/extensions/fronius-inverter/metadata/fronius-inverter-2.png differ diff --git a/extensions/fronius-inverter/metadata/fronius-inverter-3.png b/extensions/fronius-inverter/metadata/fronius-inverter-3.png new file mode 100644 index 00000000000..179894f2581 Binary files /dev/null and b/extensions/fronius-inverter/metadata/fronius-inverter-3.png differ diff --git a/extensions/fronius-inverter/package.json b/extensions/fronius-inverter/package.json index e8abc772de4..1e7335080f2 100644 --- a/extensions/fronius-inverter/package.json +++ b/extensions/fronius-inverter/package.json @@ -25,6 +25,52 @@ "command": "src/watch.tsx" } ], + "tools": [ + { + "name": "analyzeSystem", + "title": "Analyze Solar System", + "description": "Analyzes the current state of the Fronius solar system and provides insights", + "file": "src/tools/analyzeSystem.ts", + "input": "How much energy is my solar system producing right now?" + }, + { + "name": "explainErrors", + "title": "Explain Inverter Errors", + "description": "Provides an explanation and troubleshooting steps for inverter error codes", + "file": "src/tools/explainErrors.ts", + "input": "What does error code 567 mean on my inverter?" + }, + { + "name": "optimizationSuggestions", + "title": "Get Optimization Suggestions", + "description": "Provides optimization suggestions based on current system performance", + "file": "src/tools/optimizationSuggestions.ts", + "input": "How can I optimize my solar system performance?" + } + ], + "ai": { + "instructions": "You are an assistant for a Fronius solar inverter monitoring system. You can help users understand their solar system performance, troubleshoot errors, and provide optimization suggestions.\n\nYou have access to the following tools:\n\n1. analyzeSystem - Use this to analyze the current state of the solar system and provide insights based on power production, grid interaction, and home consumption.\n\n2. explainErrors - Use this to explain error codes from the inverter and provide troubleshooting steps.\n\n3. optimizationSuggestions - Use this to provide suggestions for optimizing energy usage and system performance.\n\nWhen users ask about their solar system, try to understand what specific information they're looking for and use the appropriate tool to help them.", + "evals": [ + { + "name": "analyzeSystemEval", + "description": "Validates that system analysis provides accurate and helpful insights", + "file": "src/evals/analyzeSystemEval.ts", + "input": "How much energy is my solar system producing right now?" + }, + { + "name": "explainErrorsEval", + "description": "Validates that error explanations are accurate and provide useful troubleshooting steps", + "file": "src/evals/explainErrorsEval.ts", + "input": "What does error code 567 mean on my inverter?" + }, + { + "name": "optimizationSuggestionsEval", + "description": "Validates that optimization suggestions are practical and relevant to the system state", + "file": "src/evals/optimizationSuggestionsEval.ts", + "input": "How can I optimize my solar system performance?" + } + ] + }, "preferences": [ { "name": "baseUrl", diff --git a/extensions/fronius-inverter/src/api.ts b/extensions/fronius-inverter/src/api.ts index 156b58ba3a9..ee7876bfb64 100644 --- a/extensions/fronius-inverter/src/api.ts +++ b/extensions/fronius-inverter/src/api.ts @@ -2,6 +2,19 @@ import { InverterInfoResponse, PowerFlowRealtimeDataResponse } from "./types"; const _fetch = typeof fetch !== "undefined" ? fetch : require("node-fetch"); +/** + * Fetches detailed information about all connected Fronius inverters + * + * This function makes a request to the Fronius Solar API v1 GetInverterInfo endpoint, + * which returns comprehensive information about all inverters connected to the system. + * The data includes custom names, device IDs, current state, error codes, and power values. + * + * This information is used for displaying inverter status and detecting error conditions. + * + * @param {string} baseUrl - The base URL of the Fronius inverter (e.g., http://192.168.0.75) + * @returns {Promise} A promise that resolves to the inverter information response + * @throws {Error} If the request fails or returns a non-OK status + */ export async function fetchInverterInfo(baseUrl: string): Promise { const url = `${baseUrl}/solar_api/v1/GetInverterInfo.cgi`; const response = await _fetch(url); @@ -11,6 +24,20 @@ export async function fetchInverterInfo(baseUrl: string): Promise; } +/** + * Fetches real-time power flow data from the Fronius system + * + * This function makes a request to the Fronius Solar API v1 GetPowerFlowRealtimeData endpoint, + * which returns current power flow information for the entire system. The data includes + * current PV production, grid power (import/export), home consumption, battery status, + * and energy totals. + * + * This information is used for displaying the system overview and calculating performance metrics. + * + * @param {string} baseUrl - The base URL of the Fronius inverter (e.g., http://192.168.0.75) + * @returns {Promise} A promise that resolves to the power flow data response + * @throws {Error} If the request fails or returns a non-OK status + */ export async function fetchPowerFlowRealtimeData(baseUrl: string): Promise { const url = `${baseUrl}/solar_api/v1/GetPowerFlowRealtimeData.fcgi`; const response = await _fetch(url); diff --git a/extensions/fronius-inverter/src/evals/analyzeSystemEval.ts b/extensions/fronius-inverter/src/evals/analyzeSystemEval.ts new file mode 100644 index 00000000000..5a3b012479a --- /dev/null +++ b/extensions/fronius-inverter/src/evals/analyzeSystemEval.ts @@ -0,0 +1,49 @@ +import { AI } from "@raycast/api"; +import analyzeSystem from "../tools/analyzeSystem"; + +/** + * Evaluation for the analyzeSystem tool + * + * This evaluation validates that the system analysis provides accurate and helpful insights. + * It checks that the analysis: + * 1. Correctly interprets the current system state + * 2. Provides meaningful observations about production and consumption + * 3. Offers actionable insights based on the energy flow data + * 4. Maintains conciseness and clarity in the response + * + * @returns {Promise} True if the evaluation passes, false otherwise + */ +export default async function analyzeSystemEval(): Promise { + try { + // Get the analysis from the tool + const analysis = await analyzeSystem(); + + if (!analysis || analysis.trim().length === 0) { + console.error("Analysis returned empty result"); + return false; + } + + // Use Raycast AI to evaluate the quality of the analysis + const evaluation = await AI.ask(` + Evaluate this solar system analysis for accuracy, helpfulness, and actionability: + + "${analysis}" + + Criteria: + 1. Does it correctly summarize the current system state? + 2. Does it provide meaningful observations about production/consumption? + 3. Does it offer at least one actionable insight? + 4. Is it concise (3-4 sentences total)? + + For each criterion, answer YES or NO. + Then provide an overall PASS or FAIL verdict. + A PASS requires at least 3 YES answers. + `); + + // Check if the evaluation contains a PASS verdict + return evaluation.includes("PASS"); + } catch (error) { + console.error("Error in analyzeSystemEval:", error); + return false; + } +} diff --git a/extensions/fronius-inverter/src/evals/explainErrorsEval.ts b/extensions/fronius-inverter/src/evals/explainErrorsEval.ts new file mode 100644 index 00000000000..77b535423d6 --- /dev/null +++ b/extensions/fronius-inverter/src/evals/explainErrorsEval.ts @@ -0,0 +1,54 @@ +import { AI } from "@raycast/api"; +import explainErrors from "../tools/explainErrors"; + +/** + * Evaluation for the explainErrors tool + * + * This evaluation validates that the error explanations are accurate and provide useful troubleshooting steps. + * It checks that the explanation: + * 1. Correctly identifies and explains the error codes + * 2. Provides plausible causes for the issues + * 3. Offers practical troubleshooting steps + * 4. Is clear and understandable for non-technical users + * + * @returns {Promise} True if the evaluation passes, false otherwise + */ +export default async function explainErrorsEval(): Promise { + try { + // Get the error explanation from the tool + const explanation = await explainErrors(); + + // If no errors are detected, the tool should return a confirmation message + if (explanation === "No errors detected. All inverters are operating normally.") { + return true; + } + + if (!explanation || explanation.trim().length === 0) { + console.error("Error explanation returned empty result"); + return false; + } + + // Use Raycast AI to evaluate the quality of the error explanation + const evaluation = await AI.ask(` + Evaluate this Fronius inverter error explanation for accuracy, helpfulness, and practicality: + + "${explanation}" + + Criteria: + 1. Does it clearly explain what the error means? + 2. Does it provide plausible causes for the issue? + 3. Does it offer practical troubleshooting steps? + 4. Is it understandable for non-technical users? + + For each criterion, answer YES or NO. + Then provide an overall PASS or FAIL verdict. + A PASS requires at least 3 YES answers. + `); + + // Check if the evaluation contains a PASS verdict + return evaluation.includes("PASS"); + } catch (error) { + console.error("Error in explainErrorsEval:", error); + return false; + } +} diff --git a/extensions/fronius-inverter/src/evals/optimizationSuggestionsEval.ts b/extensions/fronius-inverter/src/evals/optimizationSuggestionsEval.ts new file mode 100644 index 00000000000..c5b2d70faf3 --- /dev/null +++ b/extensions/fronius-inverter/src/evals/optimizationSuggestionsEval.ts @@ -0,0 +1,49 @@ +import { AI } from "@raycast/api"; +import optimizationSuggestions from "../tools/optimizationSuggestions"; + +/** + * Evaluation for the optimizationSuggestions tool + * + * This evaluation validates that the optimization suggestions are practical and relevant to the system state. + * It checks that the suggestions: + * 1. Are relevant to the current system performance data + * 2. Are practical and actionable for homeowners + * 3. Provide clear benefits if implemented + * 4. Are specific rather than generic + * + * @returns {Promise} True if the evaluation passes, false otherwise + */ +export default async function optimizationSuggestionsEval(): Promise { + try { + // Get the optimization suggestions from the tool + const suggestions = await optimizationSuggestions(); + + if (!suggestions || suggestions.trim().length === 0) { + console.error("Optimization suggestions returned empty result"); + return false; + } + + // Use Raycast AI to evaluate the quality of the optimization suggestions + const evaluation = await AI.ask(` + Evaluate these solar system optimization suggestions for practicality and relevance: + + "${suggestions}" + + Criteria: + 1. Are the suggestions relevant to the system performance data? + 2. Are they practical and actionable for homeowners? + 3. Do they provide clear benefits if implemented? + 4. Are they specific rather than generic advice? + + For each criterion, answer YES or NO. + Then provide an overall PASS or FAIL verdict. + A PASS requires at least 3 YES answers. + `); + + // Check if the evaluation contains a PASS verdict + return evaluation.includes("PASS"); + } catch (error) { + console.error("Error in optimizationSuggestionsEval:", error); + return false; + } +} diff --git a/extensions/fronius-inverter/src/tools/analyzeSystem.ts b/extensions/fronius-inverter/src/tools/analyzeSystem.ts new file mode 100644 index 00000000000..ccc0b98d8ca --- /dev/null +++ b/extensions/fronius-inverter/src/tools/analyzeSystem.ts @@ -0,0 +1,61 @@ +import { AI, getPreferenceValues } from "@raycast/api"; +import { fetchPowerFlowRealtimeData } from "../api"; + +interface Preferences { + baseUrl: string; +} + +/** + * Analyzes the current state of the Fronius solar system using AI + * + * This tool fetches real-time data directly from the Fronius inverter API and uses + * Raycast's AI capabilities to provide meaningful insights about the system's performance. + * The analysis includes information about current production, consumption patterns, + * grid interaction, and battery status (if available). + * + * The tool is designed to help users understand their solar system's current state + * at a glance and identify potential optimization opportunities or issues. + * + * @returns {Promise} A detailed analysis of the system state with insights and recommendations + */ +export default async function analyzeSystem(): Promise { + // Get the base URL from user preferences + const { baseUrl } = getPreferenceValues(); + + // Fetch the latest power flow data directly from the Fronius API + try { + const powerResponse = await fetchPowerFlowRealtimeData(baseUrl); + const site = powerResponse.Body.Data.Site; + + // Extract and organize the relevant data for analysis + const data = { + currentPower: site.P_PV, // Current solar production in watts + dailyEnergy: site.E_Total || 0, // Total energy produced today in watt-hours + gridPower: site.P_Grid, // Grid power (negative = exporting to grid) in watts + loadPower: site.P_Load, // Current home consumption in watts + batteryPower: site.P_Akku, // Battery power (negative = charging) in watts + batteryStateOfCharge: site.StateOfCharge_Relative, // Battery charge level in percentage + }; + + // Use Raycast AI to analyze the data and generate insights + return await AI.ask(` + Analyze this solar system data and provide insights: + - Current production: ${data.currentPower}W + - Today's energy: ${data.dailyEnergy}Wh + - Grid power (negative=export): ${data.gridPower}W + - Home consumption: ${data.loadPower}W + ${data.batteryPower !== undefined ? `- Battery power (negative=charging): ${data.batteryPower}W` : ""} + ${data.batteryStateOfCharge !== undefined ? `- Battery charge: ${data.batteryStateOfCharge}%` : ""} + + Please provide: + 1. A brief summary of the current system state + 2. Any notable observations (high/low production, consumption patterns) + 3. One actionable insight based on the current energy flow + + Keep it concise (3-4 sentences total). + `); + } catch (error) { + const errorMessage = error instanceof Error ? error.message : String(error); + throw new Error(`Failed to fetch power flow data: ${errorMessage}`); + } +} diff --git a/extensions/fronius-inverter/src/tools/explainErrors.ts b/extensions/fronius-inverter/src/tools/explainErrors.ts new file mode 100644 index 00000000000..5b9e9a1a14a --- /dev/null +++ b/extensions/fronius-inverter/src/tools/explainErrors.ts @@ -0,0 +1,73 @@ +import { AI, getPreferenceValues } from "@raycast/api"; +import { fetchInverterInfo } from "../api"; +import { InverterInfo } from "../types"; + +interface Preferences { + baseUrl: string; +} + +/** + * Provides an explanation and troubleshooting steps for Fronius inverter error codes + * + * This tool fetches the current inverter status directly from the Fronius API, + * identifies any active error codes, and uses Raycast's AI capabilities to provide + * detailed explanations and troubleshooting guidance. + * + * The tool is designed to help users understand and resolve inverter issues without + * needing to look up error codes in the manual or contact technical support for + * common problems. It provides context-aware explanations based on the current + * state of the inverter. + * + * If no errors are detected, the tool returns a simple confirmation message. + * + * @returns {Promise} Explanation of error codes with troubleshooting steps, + * or a confirmation message if no errors are detected + */ +export default async function explainErrors(): Promise { + // Get the base URL from user preferences + const { baseUrl } = getPreferenceValues(); + + try { + // Fetch the latest inverter information directly from the Fronius API + const invResponse = await fetchInverterInfo(baseUrl); + const invData = invResponse.Body.Data; + + // Extract and organize inverter data, including error codes + const inverters = Object.entries(invData).map(([id, info]) => ({ + id, + info: info as InverterInfo, + })); + + // Filter out inverters with no errors (ErrorCode 0 or -1 indicates no error) + const errorCodes = inverters + .filter((inv) => inv.info.ErrorCode !== 0 && inv.info.ErrorCode !== -1) + .map((inv) => String(inv.info.ErrorCode)); + + // If no errors are detected, return a simple confirmation message + if (errorCodes.length === 0) { + return "No errors detected. All inverters are operating normally."; + } + + // Prepare a status message with information about each inverter + const statusMessage = inverters + .map((inv) => `${inv.info.CustomName || `Inverter ${inv.id}`}: ${inv.info.InverterState}`) + .join(", "); + + // Use Raycast AI to analyze the error codes and provide troubleshooting guidance + return await AI.ask(` + Analyze this Fronius inverter error: + Error codes: ${errorCodes.join(", ")} + Status: ${statusMessage} + + Please provide: + 1. A brief explanation of what this error means + 2. Potential causes for this issue + 3. Recommended troubleshooting steps + + Keep it concise and practical. + `); + } catch (error) { + const errorMessage = error instanceof Error ? error.message : String(error); + throw new Error(`Failed to fetch inverter info: ${errorMessage}`); + } +} diff --git a/extensions/fronius-inverter/src/tools/optimizationSuggestions.ts b/extensions/fronius-inverter/src/tools/optimizationSuggestions.ts new file mode 100644 index 00000000000..0fb637b2b17 --- /dev/null +++ b/extensions/fronius-inverter/src/tools/optimizationSuggestions.ts @@ -0,0 +1,68 @@ +import { AI, getPreferenceValues } from "@raycast/api"; +import { fetchPowerFlowRealtimeData } from "../api"; +import { SiteData } from "../types"; + +interface Preferences { + baseUrl: string; +} + +// Extended site data interface to include optional E_Day property +interface ExtendedSiteData extends SiteData { + E_Day?: number; +} + +/** + * Provides optimization suggestions for the Fronius solar system + * + * This tool fetches real-time data from the Fronius API, calculates key performance + * metrics, and uses Raycast's AI capabilities to generate practical optimization + * suggestions tailored to the current system state. + * + * The suggestions focus on ways to improve energy efficiency, maximize self-consumption, + * optimize battery usage (if present), and enhance overall system performance. + * The recommendations are designed to be actionable by homeowners without requiring + * technical expertise or professional assistance. + * + * The tool uses current power production, estimated daily production, peak power, + * and grid export percentage to provide context-aware recommendations. + * + * @returns {Promise} Practical optimization suggestions based on current system performance + */ +export default async function optimizationSuggestions(): Promise { + // Get the base URL from user preferences + const { baseUrl } = getPreferenceValues(); + + try { + // Fetch the latest power flow data directly from the Fronius API + const powerResponse = await fetchPowerFlowRealtimeData(baseUrl); + const site = powerResponse.Body.Data.Site as ExtendedSiteData; + + // Calculate derived performance metrics for optimization analysis + const currentPower = site.P_PV; // Current solar production in watts + + // Try to use E_Day (today's production) if available, otherwise fall back to E_Total + const dailyProduction = site.E_Day || site.E_Total || 0; + const dailyLabel = site.E_Day ? "Today's energy production" : "Total energy production"; + + const peakPower = currentPower * 1.2; // Estimate peak power capacity (20% higher than current) + + // Calculate grid export percentage - how much of produced power is being exported + // A high percentage might indicate opportunities for better self-consumption + const gridExportPercentage = site.P_Grid < 0 && site.P_PV !== 0 ? (Math.abs(site.P_Grid) / site.P_PV) * 100 : 0; + + // Use Raycast AI to generate optimization suggestions based on the calculated metrics + return await AI.ask(` + Based on this Fronius solar system data: + - Current power: ${currentPower}W + - ${dailyLabel}: ${dailyProduction}Wh + - System peak power: ${peakPower}W + - Grid export percentage: ${gridExportPercentage}% + + Provide 2-3 practical suggestions to optimize energy usage and system performance. + Focus on actionable tips that a homeowner could implement. + `); + } catch (error) { + const errorMessage = error instanceof Error ? error.message : String(error); + throw new Error(`Failed to fetch power flow data: ${errorMessage}`); + } +}