Enphase Energy IQ8P-3P / IQ Gateway Commercial 2

Gewerbliches PV-Mikrowechselrichtersystem

Die Enphase IQ8 Commercial Microinverters melden nur an ihr IQ Gateway Commercial 2, per Powerline-Kommunikation. Edge misst die Anlage über einen EpiSensor ZEM am PV-AC-Stromkreis. Die lokale API des Gateways stellt im LAN auch JSON über HTTPS bereit, aber jede Anfrage braucht ein Token aus der Cloud von Enphase: ein Jahr für den Anlagenbetreiber, 12 Stunden für einen Installateur.

Enphase IQ8 Commercial Microinverters mit IQ Gateway Commercial 2
  • IQ Gateway local API (JSON over HTTPS)

Gewerbliches PV-Mikrowechselrichtersystem

Einen Ingenieur fragen

Kompatibilität

Kompatibel mit EpiSensor Edge über einen EpiSensor ZEM am PV-AC-Stromkreis

Das Datenblatt der IQ8 Commercial nennt Powerline-Kommunikation als einzige Schnittstelle der Mikrowechselrichter, und die Überwachung erfordert ein IQ Gateway Commercial 2. Die Quellen veröffentlichen keine Modbus-Tabelle für das Gateway. Edge misst die PV-Erzeugung über einen EpiSensor ZEM mit Stromwandlern am AC-Stromkreis der Anlage. Die technische Kurzinformation TEB-00060-2.0 von Enphase dokumentiert lokale JSON-APIs am Gateway, die ein eigener Flow im Node-RED-Arbeitsbereich von Edge mit einem von Enphase ausgegebenen Bearer-Token lesen kann.

IQ8P-3P-72-E-US, IQ8P-3P-72-E-DOM-US und IQ8H-3P-72-E-US mit IQ Gateway Commercial 2 (ENV2-IQC2-AM3-3P), nach den Datenblättern DSH-00236-8.0 und DSH-00212-4.0 und der technischen Kurzinformation TEB-00060-2.0 (IQ-Gateway-Software 7.0.x oder neuer). Prüfung vor Ort: Vergleichen Sie die PV-Leistung des ZEM über dasselbe Intervall mit der Enphase App oder dem Erzeugungswert des Gateways. Keine Funktion für Enphase-Steuerung, Einspeisebegrenzung oder Netzprofil geht auf Edge über.

Anbinden mit

Anbindung an Edge

Für PV-Leistung und Energie am AC-Anschluss der Anlage, ohne Enphase-Konto oder Token

  • Kabelgebunden
  • Edge
  • Plattformen
Gewerbliches PV-Mikrowechselrichtersystem
Schnittstelle
Gateway
Edge
Ausgang
IQ8P-3P / IQ Gateway Commercial 2Strangstromkreise IQ8 Commercial, 120/208 VAC dreiphasig
EpiSensor ZEMMisst die gemeinsame AC-Ausgangsleistung der Mikrowechselrichter mit eigenen Stromwandlern und sendet über das EpiSensor-Funknetz
ZGW-20 GatewayFührt Edge lokal aus
EpiSensor EdgeProtokollclient und Punktmodell
KundenplattformMQTT · API · Dateien
Stromwandler am PV-AC-Stromkreis
EpiSensor Funk
Läuft lokal
Optionale Weitergabe
Eine Elektrofachkraft legt die Stromwandler des ZEM um die drei Phasen des PV-AC-Stromkreises, nach den Strangstromkreisen und innerhalb der Spannungs- und Stromnennwerte des ZEM. Der ZEM sendet über das EpiSensor-Funknetz, daher ändern sich keine Einstellung, kein Konto und keine Software bei Enphase. Details je Mikrowechselrichter bleiben in der Enphase App. Die Ausgabe zur Kundenplattform ist optional; Edge bleibt das führende lokale System.

Wenn der Anlagenbetreiber ein Enphase-Token bereitstellt und das IQ Gateway im selben LAN wie das Gateway mit Edge hängt

  • Kabelgebunden
  • Edge
  • Plattformen
Gewerbliches PV-Mikrowechselrichtersystem
Schnittstelle
Gateway
Edge
Ausgang
IQ8P-3P / IQ Gateway Commercial 2Mikrowechselrichter IQ8 Commercial, Powerline-Kommunikation
Geschütztes EthernetSegmentiertes LAN
ZGW-20 GatewayFührt Edge lokal aus
EpiSensor EdgeProtokollclient und Punktmodell
KundenplattformMQTT · API · Dateien
Ethernet
Geschütztes Ethernet
Läuft lokal
Optionale Weitergabe
Das IQ Gateway stellt seine lokale API über HTTPS mit einem selbstsignierten Zertifikat bereit. Jede Anfrage trägt den Header Authorization: Bearer, gefolgt von einem Token, das in der Enphase-Cloud für die Seriennummer dieses Gateways erzeugt wird. Ein Betreiber-Token gilt ein Jahr und ein Installateur-Token 12 Stunden, der Flow braucht also einen Plan zur Erneuerung. Es werden nur GET-Anfragen verwendet. Die Ausgabe zur Kundenplattform ist optional; Edge bleibt das führende lokale System.

Modelle

Herunterladen
ModelleSchnittstelleAnbindung an Edge
IQ8P-3P-72-E-US / IQ8P-3P-72-E-DOM-US480 VA Spitze, 475 VA dauerhaft; Powerline-Kommunikation zum GatewayDen zusammengefassten AC-Stromkreis mit einem ZEM messen; Meldungen je Gerät kommen von /api/v1/production/inverters.
IQ8H-3P-72-E-US384 VA Spitze, 380 VA dauerhaft; nicht mehr hergestelltAn bestehenden Standorten dieselben Wege wie beim IQ8P-3P.
IQ Gateway Commercial 2 (ENV2-IQC2-AM3-3P)Fragt bis zu 276 Mikrowechselrichter ab; WLAN, optional Ethernet, abrechnungsgenaue Erzeugungs-StromwandlerSeine lokale API mit einem Betreiber-Token lesen oder es unverändert lassen und den Weg über den ZEM nutzen.

Technische Daten

Die Mikrowechselrichter IQ8P-3P und IQ8H-3P sind für kleine gewerbliche Dreiphasen-Vierleiter-Anlagen mit 120/208 VAC ausgelegt, mit einem PV-Modul je Mikrowechselrichter. Sie kommunizieren per Powerline-Kommunikation mit dem IQ Gateway Commercial 2, und beide Überwachungsoptionen brauchen dieses Gateway.2

Spitzenausgangsleistung
480 VA (IQ8P-3P); 384 VA (IQ8H-3P)2
Nennspannung
208 V (183 bis 229 V) oder 220 V (198 bis 242 V), L-L, 60 Hz2
Mikrowechselrichter je 20-A-Strangstromkreis
12 (IQ8P-3P); 15 (IQ8H-3P)2
Kommunikation der Mikrowechselrichter
Powerline-Kommunikation (PLC)2
Gehäuse der Mikrowechselrichter
NEMA Type 6 / IP67; -40 bis 65 °C2
Kapazität des Gateways
Bis zu 276 abgefragte Mikrowechselrichter3
Schnittstellen des Gateways
WLAN 802.11 b/g/n, optional Ethernet, digitale E/A, lokale API3
Erzeugungsmessung im Gateway
Abrechnungsgenau, ±0,5 %, drei Erzeugungs-Stromwandler 400 A enthalten3
Gültigkeit des Tokens der lokalen API
1 Jahr (Anlagenbetreiber); 12 Stunden (Installateur)1

Schnittstelle

Dokumentierte Messwerte und Grenzen der Integration für IQ8P-3P / IQ Gateway Commercial 2.

  • GET /info braucht kein Token und liefert Seriennummer, Teilenummer und Softwareversion des Gateways (zum Beispiel D7.4.22) als XML.
  • GET /api/v1/production/inverters liefert je Mikrowechselrichter serialNumber, lastReportDate (Epochensekunden), devType, lastReportWatts und maxReportWatts. Laut Enphase wird es alle fünf Minuten aktualisiert.
  • GET /ivp/pdm/energy liefert wattHoursToday, wattHoursSevenDays, wattHoursLifetime und wattsNow für die Mikrowechselrichter (pcu) und die Erzeugungs- und Verbrauchszähler des Gateways (eim).
  • GET /ivp/meters/readings liefert die Werte der Erzeugungs- und Verbrauchs-Stromwandler (activePower in W, reactivePower in var, voltage, current, freq, kumulierte Energie) je Zähler und je Phasenkanal, alle fünf Minuten aktualisiert.
  • GET /ivp/meters/gridReading liefert Spannung, Strom, Frequenz sowie Wirk- und Blindleistung je Phase am Netzanschluss. Negative Wirkleistung bedeutet Einspeisung.
  • Anfragen an die lokale API tragen Authorization: Bearer <token>; die Kurzinformation kennzeichnet nur /info als ohne Token zugänglich. Das Gateway verwendet ein selbstsigniertes Zertifikat.

Bewertung

Mikrowechselrichter IQ8P-3P und IQ8H-3P mit IQ Gateway Commercial 2, nach den Datenblättern DSH-00236-8.0 und DSH-00212-4.0 und der technischen Kurzinformation TEB-00060-2.0. Vergleichen Sie den Wert von ZEM oder API über dasselbe Intervall mit der Enphase App.

InteroperabilitätEingeschränkt
Die lokale API ist mit Endpunkten und JSON-Beispielen dokumentiert, aber jeder Lesezugriff hängt von einem in der Cloud ausgegebenen Token mit fester Laufzeit ab, und eine Modbus-Tabelle ist nicht veröffentlicht.13
GenauigkeitUnter Bedingungen unterstützt
Die Erzeugungs-Stromwandler des Gateways sind mit ±0,5 % abrechnungsgenau; die Werte der lokalen API werden alle fünf Minuten aktualisiert.13
SicherheitUnter Bedingungen unterstützt
Ab Software 7.0.x brauchen die lokalen APIs ein Bearer-Token über HTTPS; das Zertifikat des Gateways ist selbstsigniert.1
ZuverlässigkeitEingeschränkt
Die Werte werden alle fünf Minuten aktualisiert, und Installateur-Tokens laufen nach 12 Stunden ab; der API-Weg braucht also Erneuerung und eine Behandlung veralteter Werte.1
RobustheitUnter Bedingungen unterstützt
Die Mikrowechselrichter sind NEMA Type 6 / IP67 von -40 bis 65 °C; das Gateway ist IP30 und braucht einen Platz in Innenräumen oder ein Gehäuse NEMA 3R.23
SkalierbarkeitUnter Bedingungen unterstützt
Ein Gateway fragt bis zu 276 Mikrowechselrichter ab; größere Standorte brauchen je Gateway-Seriennummer ein Gateway und ein Token.13
LebenszyklusUnter Bedingungen unterstützt
Datenblätter und technische Kurzinformation tragen Revisionshistorien; der IQ8H-3P wird nicht mehr hergestellt.12

Einrichtung

Letzte Meldung eines Mikrowechselrichters aus der lokalen API lesen

Ein nur lesendes HTTPS GET im Standort-LAN, mit der eigenen Beispielantwort von Enphase aus der technischen Kurzinformation TEB-00060-2.0. Das Token ist ein Platzhalter; das Beispiel stammt von Enphase, nicht von einem erfassten Standort.

Anfrage
GET https://<gateway IP>/api/v1/production/inverters mit den Headern Accept: application/json und Authorization: Bearer <token>.
Beispielantwort von Enphase
[{"serialNumber": "121935144671", "lastReportDate": 1654171836, "devType": 1, "lastReportWatts": 15, "maxReportWatts": 38}]
Dekodierung
lastReportWatts 15 ist die zuletzt gemeldete Wirkleistung in W. maxReportWatts 38 ist die höchste Leistung, die dieses Gerät je gemeldet hat, kein Nennwert.
Zeitstempel
lastReportDate 1654171836 sind Epochensekunden: 2. Juni 2022, 12:10:36 UTC. Verwenden Sie ihn als Zeitpunkt des Werts, nicht als Zeitpunkt der Anfrage.
Authentifizierungsfehler
Ohne gültiges Token schlägt die Anfrage fehl; das curl-Beispiel von Enphase verwendet -f, damit eine nicht authentifizierte Weiterleitung als Fehler erscheint. Behandeln Sie das als fehlende Daten und erneuern Sie das Token.

Abnahmekriterium: Übernehmen Sie den API-Weg, wenn die Summe von lastReportWatts über alle Geräte oder production.pcu wattsNow über dasselbe Fünf-Minuten-Fenster mit der PV-Leistung des ZEM übereinstimmt. Behalten Sie den ZEM als laufende Messung, wenn das Token abläuft.

  1. Mit dem ZEM am PV-Stromkreis beginnen

    Messen Sie die Anlage dort, wo ihre Strangstromkreise zusammenlaufen, mit Stromwandlern des ZEM an allen drei Phasen und festgehaltener Bezugsrichtung. Das braucht kein Enphase-Konto und funktioniert weiter, wenn ein Token abläuft. Vergleichen Sie seine Leistung über dasselbe Intervall mit der Enphase App.

  2. Klären, wem das Token gehört

    Dieser Leitfaden verwendet die technische Kurzinformation TEB-00060-2.0. Ein Token kommt von entrez.enphaseenergy.com oder von enlighten.enphaseenergy.com/entrez-auth-token?serial_num= gefolgt von der Seriennummer des Gateways, angemeldet mit Enphase-Zugangsdaten. Das Token des Anlagenbetreibers gilt ein Jahr, das eines Installateurs 12 Stunden. Vereinbaren Sie mit dem Betreiber, wer es erzeugt und erneuert.

  3. Gateway ohne Token prüfen

    Senden Sie aus dem Standort-LAN GET https://<gateway IP>/info. Die Anfrage wird ohne Token beantwortet und liefert Seriennummer und Softwareversion. Ab Software 7.0.x brauchen die anderen lokalen APIs der Kurzinformation das Token.

  4. Erzeugung mit dem Bearer-Token lesen

    Senden Sie GET https://<gateway IP>/ivp/pdm/energy mit den Headern Accept: application/json und Authorization: Bearer <token>. Akzeptieren Sie das selbstsignierte Zertifikat des Gateways nur für diesen Host. Ordnen Sie wattsNow und wattHoursLifetime unter production.pcu zu.

  5. Aktualisierungsintervall beachten und Steuerung bei Enphase lassen

    Enphase aktualisiert die Werte der Wechselrichter und Zähler alle fünf Minuten; fragen Sie daher nicht schneller ab und verwenden Sie lastReportDate als Zeitstempel des Werts. Einspeisebegrenzung, Netzprofile und die digitalen E/A des Gateways bleiben im Enphase-System.

Häufige Fragen

Braucht die lokale API des Enphase IQ Gateway ein Token?
Ja, ab IQ-Gateway-Software 7.0.x. Das Token wird in der Enphase-Cloud für die Seriennummer des Gateways erzeugt. Das Token eines Anlagenbetreibers gilt ein Jahr, das eines Installateurs 12 Stunden. Die Kurzinformation kennzeichnet /info als ohne Token zugänglich.1
Kann Edge die Mikrowechselrichter IQ8 direkt lesen?
Nein. Die Mikrowechselrichter kommunizieren nur per Powerline-Kommunikation mit dem IQ Gateway Commercial 2. Edge liest die lokale API des Gateways oder misst den PV-Stromkreis mit einem ZEM.23
Wie oft ändern sich die Werte der lokalen API?
Laut Enphase werden Zählerwerte, die Erzeugung je Mikrowechselrichter und die Verbrauchsmeldungen alle fünf Minuten aktualisiert. Schnelleres Abfragen liefert dieselben Werte.1
Was bedeutet ein negativer Netzwert?
An /ivp/meters/gridReading bedeutet eine negative Wirkleistung Einspeisung ins Netz und ein positiver Wert Bezug.1

Quellen

  1. Accessing IQ Gateway local APIs and local UI using token, technical brief TEB-00060-2.0-EN, June 2025 (öffnet in einem neuen Tab) Enphase Energy
  2. IQ8 Commercial Microinverters, Datenblatt DSH-00236-8.0-EN, Juni 2026 (öffnet in einem neuen Tab) Enphase Energy
  3. IQ Gateway Commercial 2, Datenblatt DSH-00212-4.0-EN-US, Mai 2025 (öffnet in einem neuen Tab) Enphase Energy

Weiterführende Informationen

Produktnamen und Marken gehören ihren jeweiligen Inhabern. Die Veröffentlichung bedeutet weder eine Empfehlung noch eine Geschäftsbeziehung.