Enphase Energy IQ8P-3P / IQ Gateway Commercial 2

Sistema di microinverter FV commerciale

I microinverter Enphase IQ8 Commercial comunicano solo con il loro IQ Gateway Commercial 2, tramite comunicazione su linea elettrica. Edge misura il campo FV tramite un EpiSensor ZEM sul circuito CA del fotovoltaico. L’API locale del gateway fornisce anche JSON su HTTPS nella LAN, ma ogni richiesta richiede un token rilasciato dal cloud Enphase: un anno per il proprietario dell’impianto, 12 ore per un installatore.

Microinverter Enphase IQ8 Commercial con IQ Gateway Commercial 2
  • IQ Gateway local API (JSON over HTTPS)

Sistema di microinverter FV commerciale

Chiedi a un tecnico

Compatibilità

Compatibile con EpiSensor Edge tramite un EpiSensor ZEM sul circuito CA del fotovoltaico

La scheda tecnica IQ8 Commercial indica la comunicazione su linea elettrica come unica interfaccia dei microinverter, e il monitoraggio richiede un IQ Gateway Commercial 2. Le fonti non pubblicano alcuna mappa Modbus per il gateway. Edge misura la produzione FV tramite un EpiSensor ZEM con TA sul circuito CA del campo. La nota tecnica Enphase TEB-00060-2.0 documenta API JSON locali sul gateway che un flow personalizzato nell’area di lavoro Node-RED di Edge può leggere con un bearer token rilasciato da Enphase.

IQ8P-3P-72-E-US, IQ8P-3P-72-E-DOM-US e IQ8H-3P-72-E-US con IQ Gateway Commercial 2 (ENV2-IQC2-AM3-3P), secondo le schede tecniche DSH-00236-8.0 e DSH-00212-4.0 e la nota tecnica TEB-00060-2.0 (software IQ Gateway 7.0.x o successivo). Verifica in sito: confrontare la potenza FV dello ZEM con l’Enphase App o con la lettura di produzione del gateway sullo stesso intervallo. Nessuna funzione Enphase di controllo, limitazione dell’immissione o profilo di rete passa a Edge.

Collegalo con

Collegamento a Edge

Per potenza ed energia FV al collegamento CA del campo, senza account né token Enphase

  • Cablato
  • Edge
  • Piattaforme
Sistema di microinverter FV commerciale
Interfaccia
Gateway
Edge
Uscita
IQ8P-3P / IQ Gateway Commercial 2Circuiti di ramo IQ8 Commercial, 120/208 VAC trifase
EpiSensor ZEMMisura l’uscita CA complessiva dei microinverter con i propri TA e trasmette sulla rete wireless EpiSensor
ZGW-20 GatewayOspita Edge in locale
EpiSensor EdgeClient di protocollo + modello di punti
Piattaforma del clienteMQTT · API · file
TA sul circuito CA FV
Wireless EpiSensor
Funziona in locale
Invio facoltativo dei dati
Un elettricista qualificato installa i TA dello ZEM sulle tre fasi del circuito CA del fotovoltaico, a valle dei circuiti di ramo ed entro i valori nominali di tensione e corrente dello ZEM. Lo ZEM trasmette sulla rete wireless EpiSensor, quindi nessuna impostazione, account o software Enphase cambia. Il dettaglio per microinverter resta nell’Enphase App. L’invio alla piattaforma del cliente è facoltativo; Edge resta il sistema locale di riferimento.

Quando il proprietario del sito fornisce un token Enphase e il gateway è sulla stessa LAN del Gateway che esegue Edge

  • Cablato
  • Edge
  • Piattaforme
Sistema di microinverter FV commerciale
Interfaccia
Gateway
Edge
Uscita
IQ8P-3P / IQ Gateway Commercial 2Microinverter IQ8 Commercial, comunicazione su linea elettrica
Ethernet protettaLAN segmentata
ZGW-20 GatewayOspita Edge in locale
EpiSensor EdgeClient di protocollo + modello di punti
Piattaforma del clienteMQTT · API · file
Ethernet
Ethernet protetta
Funziona in locale
Invio facoltativo dei dati
Il gateway fornisce la sua API locale su HTTPS con un certificato autofirmato. Ogni richiesta porta l’intestazione Authorization: Bearer seguita da un token generato dal cloud Enphase per il numero di serie di quel gateway. Un token del proprietario dura un anno e uno dell’installatore 12 ore, quindi il flow richiede un piano di rinnovo. Si usano solo richieste GET. L’invio alla piattaforma del cliente è facoltativo; Edge resta il sistema locale di riferimento.

Modelli

Scarica
ModelliInterfacciaCollegamento a Edge
IQ8P-3P-72-E-US / IQ8P-3P-72-E-DOM-US480 VA di picco, 475 VA continui; comunicazione su linea elettrica verso il gatewayMisurare il circuito CA complessivo con uno ZEM; i dati per unità provengono da /api/v1/production/inverters.
IQ8H-3P-72-E-US384 VA di picco, 380 VA continui; non più prodottoStessi percorsi dell’IQ8P-3P sui siti esistenti.
IQ Gateway Commercial 2 (ENV2-IQC2-AM3-3P)Interroga fino a 276 microinverter; Wi-Fi, Ethernet opzionale, TA di produzione di livello fiscaleLeggerne l’API locale con un token del proprietario, oppure lasciarlo invariato e usare il percorso con lo ZEM.

Specifiche

I microinverter IQ8P-3P e IQ8H-3P sono progettati per piccoli impianti commerciali trifase a quattro fili a 120/208 VAC, con un modulo FV per microinverter. Comunicano con l’IQ Gateway Commercial 2 tramite comunicazione su linea elettrica, ed entrambe le opzioni di monitoraggio richiedono quel gateway.2

Potenza di uscita di picco
480 VA (IQ8P-3P); 384 VA (IQ8H-3P)2
Tensione nominale
208 V (da 183 a 229 V) o 220 V (da 198 a 242 V), L-L, 60 Hz2
Microinverter per circuito di ramo da 20 A
12 (IQ8P-3P); 15 (IQ8H-3P)2
Comunicazione dei microinverter
Comunicazione su linea elettrica (PLC)2
Involucro dei microinverter
NEMA Type 6 / IP67; da -40 a 65 °C2
Capacità del gateway
Fino a 276 microinverter interrogati3
Interfacce del gateway
Wi-Fi 802.11 b/g/n, Ethernet opzionale, I/O digitali, API locale3
Misura di produzione del gateway
Livello fiscale, ±0,5 %, tre TA di produzione da 400 A inclusi3
Validità del token dell’API locale
1 anno (proprietario dell’impianto); 12 ore (installatore)1

Interfaccia

Misure documentate e limiti di integrazione per IQ8P-3P / IQ Gateway Commercial 2.

  • GET /info non richiede token e restituisce in XML numero di serie, codice e versione software del gateway (per esempio D7.4.22).
  • GET /api/v1/production/inverters restituisce, per ogni microinverter, serialNumber, lastReportDate (secondi epoch), devType, lastReportWatts e maxReportWatts. Enphase indica che si aggiorna una volta ogni cinque minuti.
  • GET /ivp/pdm/energy restituisce wattHoursToday, wattHoursSevenDays, wattHoursLifetime e wattsNow per i microinverter (pcu) e per i contatori di produzione e consumo del gateway (eim).
  • GET /ivp/meters/readings restituisce i valori dei TA di produzione e consumo (activePower in W, reactivePower in var, tensione, corrente, freq, energia cumulata) per contatore e per canale di fase, aggiornati una volta ogni cinque minuti.
  • GET /ivp/meters/gridReading restituisce per fase tensione, corrente, frequenza e potenza attiva e reattiva al punto di connessione alla rete. Una potenza attiva negativa indica immissione.
  • Le richieste all’API locale portano Authorization: Bearer <token>; la nota indica solo /info come accessibile senza token. Il gateway usa un certificato autofirmato.

Valutazione

Microinverter IQ8P-3P e IQ8H-3P con IQ Gateway Commercial 2, secondo le schede tecniche DSH-00236-8.0 e DSH-00212-4.0 e la nota tecnica TEB-00060-2.0. Confrontare la lettura dello ZEM o dell’API con l’Enphase App sullo stesso intervallo.

InteroperabilitàLimitato
L’API locale è documentata con endpoint e JSON di esempio, ma ogni lettura dipende da un token rilasciato dal cloud con durata fissa e non è pubblicata alcuna mappa Modbus.13
AccuratezzaSupportato a determinate condizioni
I TA di produzione del gateway sono di livello fiscale a ±0,5 %; i valori dell’API locale si aggiornano ogni cinque minuti.13
SicurezzaSupportato a determinate condizioni
Con il software 7.0.x o successivo le API locali richiedono un bearer token su HTTPS; il certificato del gateway è autofirmato.1
AffidabilitàLimitato
Le letture si aggiornano ogni cinque minuti e i token dell’installatore scadono dopo 12 ore, quindi il percorso via API richiede la gestione del rinnovo e dei dati non aggiornati.1
RobustezzaSupportato a determinate condizioni
I microinverter sono NEMA Type 6 / IP67 da -40 a 65 °C; il gateway è IP30 e richiede una posizione interna o un involucro NEMA 3R.23
ScalabilitàSupportato a determinate condizioni
Un gateway interroga fino a 276 microinverter; i siti più grandi richiedono un gateway e un token per ogni numero di serie del gateway.13
Ciclo di vitaSupportato a determinate condizioni
Le schede tecniche e la nota tecnica riportano la cronologia delle revisioni; l’IQ8H-3P non è più prodotto.12

Configurazione

Leggere l’ultimo dato di un microinverter dall’API locale

Una GET HTTPS in sola lettura sulla LAN del sito, con la risposta di esempio della nota tecnica Enphase TEB-00060-2.0. Il token è un segnaposto; l’esempio è di Enphase, non una cattura da un sito.

Richiesta
GET https://<gateway IP>/api/v1/production/inverters con le intestazioni Accept: application/json e Authorization: Bearer <token>.
Risposta di esempio Enphase
[{"serialNumber": "121935144671", "lastReportDate": 1654171836, "devType": 1, "lastReportWatts": 15, "maxReportWatts": 38}]
Decodifica
lastReportWatts 15 è l’ultima potenza attiva riportata in W. maxReportWatts 38 è la potenza più alta mai riportata da quell’unità, non un valore nominale.
Timestamp
lastReportDate 1654171836 è in secondi epoch: 2 giugno 2022, 12:10:36 UTC. Usarlo come ora del valore, non come ora della richiesta.
Autenticazione fallita
Senza un token valido la richiesta fallisce; l’esempio curl di Enphase usa -f perché un reindirizzamento non autenticato risulti come errore. Trattarlo come dato mancante e rinnovare il token.

Criterio di verifica: Accettare il percorso via API quando la somma di lastReportWatts tra le unità, o wattsNow di production.pcu, concorda con la potenza FV dello ZEM nella stessa finestra di cinque minuti. Mantenere lo ZEM come misura continua quando il token scade.

  1. Iniziare con lo ZEM sul circuito FV

    Misurare il campo dove si uniscono i suoi circuiti di ramo, con TA dello ZEM su tutte e tre le fasi e il verso di importazione registrato. Non serve alcun account Enphase e la misura continua a funzionare se un token scade. Confrontarne la potenza con l’Enphase App sullo stesso intervallo.

  2. Decidere chi possiede il token

    Questa guida usa la nota tecnica TEB-00060-2.0. Un token si ottiene da entrez.enphaseenergy.com oppure da enlighten.enphaseenergy.com/entrez-auth-token?serial_num= seguito dal numero di serie del gateway, accedendo con credenziali Enphase. Il token del proprietario dell’impianto dura un anno; quello di un installatore 12 ore. Concordare con il proprietario chi lo genera e lo rinnova.

  3. Verificare il gateway senza token

    Dalla LAN del sito, GET https://<gateway IP>/info. Risponde senza token e restituisce numero di serie e versione software. Con il software 7.0.x o successivo le altre API locali della nota richiedono il token.

  4. Leggere la produzione con il bearer token

    Inviare GET https://<gateway IP>/ivp/pdm/energy con le intestazioni Accept: application/json e Authorization: Bearer <token>. Accettare il certificato autofirmato del gateway solo per quell’host. Mappare wattsNow e wattHoursLifetime sotto production.pcu.

  5. Rispettare l’intervallo di aggiornamento e lasciare il controllo a Enphase

    Enphase aggiorna le letture di inverter e contatori una volta ogni cinque minuti, quindi non interrogare più spesso e usare lastReportDate come timestamp del valore. Limitazione dell’immissione, profili di rete e I/O digitali del gateway restano nel sistema Enphase.

Domande comuni

L’API locale dell’Enphase IQ Gateway richiede un token?
Sì, con il software IQ Gateway 7.0.x o successivo. Il token si genera dal cloud Enphase per il numero di serie del gateway. Il token del proprietario dell’impianto vale un anno e quello di un installatore 12 ore. La nota indica /info come accessibile senza token.1
Ogni quanto cambiano i valori dell’API locale?
Enphase indica che le letture dei contatori e i dati di produzione e consumo per microinverter si aggiornano una volta ogni cinque minuti. Interrogare più spesso restituisce gli stessi valori.1
Che cosa significa una lettura di rete negativa?
Su /ivp/meters/gridReading una potenza attiva negativa indica immissione in rete e un valore positivo indica prelievo.1

Fonti

  1. Accessing IQ Gateway local APIs and local UI using token, nota tecnica TEB-00060-2.0-EN, giugno 2025 (si apre in una nuova scheda) Enphase Energy
  2. Scheda tecnica IQ8 Commercial Microinverters DSH-00236-8.0-EN, giugno 2026 (si apre in una nuova scheda) Enphase Energy
  3. Scheda tecnica IQ Gateway Commercial 2 DSH-00212-4.0-EN-US, maggio 2025 (si apre in una nuova scheda) Enphase Energy

Approfondimenti

I nomi e i marchi dei prodotti appartengono ai rispettivi titolari. La pubblicazione non implica approvazione né un rapporto commerciale.