Enphase Energy IQ8P-3P / IQ Gateway Commercial 2

Système de micro-onduleurs photovoltaïques commercial

Les micro-onduleurs Enphase IQ8 Commercial ne communiquent qu’avec leur IQ Gateway Commercial 2, par courant porteur en ligne. Edge mesure l’installation par un EpiSensor ZEM sur le circuit CA photovoltaïque. L’API locale de la passerelle sert aussi du JSON en HTTPS sur le LAN, mais chaque requête nécessite un jeton délivré par le cloud Enphase : un an pour le propriétaire du système, 12 heures pour un installateur.

Micro-onduleurs Enphase IQ8 Commercial avec IQ Gateway Commercial 2
  • IQ Gateway local API (JSON over HTTPS)

Système de micro-onduleurs photovoltaïques commercial

Interroger un ingénieur

compatibilité

Compatible avec EpiSensor Edge par un EpiSensor ZEM sur le circuit CA photovoltaïque

La fiche technique IQ8 Commercial indique le courant porteur en ligne comme seule interface des micro-onduleurs, et la surveillance nécessite une IQ Gateway Commercial 2. Les sources ne publient aucune table Modbus pour la passerelle. Edge mesure la production photovoltaïque par un EpiSensor ZEM avec des TC sur le circuit CA de l’installation. La note technique Enphase TEB-00060-2.0 documente des API JSON locales sur la passerelle, qu’un flux personnalisé dans l’espace de travail Node-RED d’Edge peut lire avec un jeton bearer délivré par Enphase.

IQ8P-3P-72-E-US, IQ8P-3P-72-E-DOM-US et IQ8H-3P-72-E-US avec IQ Gateway Commercial 2 (ENV2-IQC2-AM3-3P), d’après les fiches techniques DSH-00236-8.0 et DSH-00212-4.0 et la note technique TEB-00060-2.0 (logiciel IQ Gateway 7.0.x ou ultérieur). Vérification sur site : comparez la puissance photovoltaïque du ZEM avec l’Enphase App ou la mesure de production de la passerelle sur le même intervalle. Aucune fonction de commande Enphase, de limitation d’injection ou de profil réseau n’est transférée à Edge.

Connectez-le avec

Itinéraire vers Edge

Pour la puissance et l’énergie photovoltaïques au raccordement CA de l’installation, sans compte ni jeton Enphase

  • Filaire
  • Edge
  • Plateformes
Système de micro-onduleurs photovoltaïques commercial
Interface
Gateway
Edge
Sortie
IQ8P-3P / IQ Gateway Commercial 2Circuits de branche IQ8 Commercial, 120/208 VAC triphasé
EpiSensor ZEMMesure la sortie CA regroupée des micro-onduleurs avec ses propres TC et transmet par le réseau sans fil EpiSensor
ZGW-20 GatewayHéberge Edge localement
EpiSensor EdgeClient de protocole + modèle de points
Plateforme du clientMQTT · API · fichiers
TC sur le circuit CA photovoltaïque
Sans fil EpiSensor
S’exécute localement
Données transmises en option
Un électricien qualifié pose les TC du ZEM sur les trois phases du circuit CA photovoltaïque, en aval des circuits de branche et dans les limites de tension et de courant propres au ZEM. Le ZEM transmet par le réseau sans fil EpiSensor : aucun réglage, compte ou logiciel Enphase ne change. Le détail par micro-onduleur reste dans l’Enphase App. La sortie vers la plateforme du client est facultative ; Edge reste le système local de référence.

Lorsque le propriétaire du site fournit un jeton Enphase et que la passerelle est sur le même LAN que le Gateway exécutant Edge

  • Filaire
  • Edge
  • Plateformes
Système de micro-onduleurs photovoltaïques commercial
Interface
Gateway
Edge
Sortie
IQ8P-3P / IQ Gateway Commercial 2Micro-onduleurs IQ8 Commercial, courant porteur en ligne
Ethernet protégéLAN segmenté
ZGW-20 GatewayHéberge Edge localement
EpiSensor EdgeClient de protocole + modèle de points
Plateforme du clientMQTT · API · fichiers
Ethernet
Ethernet protégé
S’exécute localement
Données transmises en option
La passerelle sert son API locale en HTTPS avec un certificat auto-signé. Chaque requête porte l’en-tête Authorization: Bearer suivi d’un jeton généré depuis le cloud Enphase pour le numéro de série de cette passerelle. Un jeton propriétaire dure un an et un jeton installateur 12 heures : le flux a donc besoin d’un plan de renouvellement. Seules des requêtes GET sont utilisées. La sortie vers la plateforme du client est facultative ; Edge reste le système local de référence.

Modèles

Télécharger
ModèlesinterfaceItinéraire vers Edge
IQ8P-3P-72-E-US / IQ8P-3P-72-E-DOM-US480 VA en crête, 475 VA en continu ; courant porteur en ligne vers la passerelleMesurez le circuit CA regroupé avec un ZEM ; les rapports par unité proviennent de /api/v1/production/inverters.
IQ8H-3P-72-E-US384 VA en crête, 380 VA en continu ; plus fabriquéMêmes chemins que l’IQ8P-3P sur les sites existants.
IQ Gateway Commercial 2 (ENV2-IQC2-AM3-3P)Interroge jusqu’à 276 micro-onduleurs ; Wi-Fi, Ethernet en option, TC de production de qualité facturationLisez son API locale avec un jeton propriétaire, ou laissez-la telle quelle et utilisez le chemin ZEM.

Spécifications

Les micro-onduleurs IQ8P-3P et IQ8H-3P sont conçus pour les petits systèmes commerciaux triphasés quatre fils en 120/208 VAC, avec un module PV par micro-onduleur. Ils communiquent avec l’IQ Gateway Commercial 2 par courant porteur en ligne, et les deux options de surveillance nécessitent cette passerelle.2

Puissance de sortie en crête
480 VA (IQ8P-3P) ; 384 VA (IQ8H-3P)2
Tension nominale
208 V (183 à 229 V) ou 220 V (198 à 242 V), L-L, 60 Hz2
Micro-onduleurs par circuit de branche de 20 A
12 (IQ8P-3P) ; 15 (IQ8H-3P)2
Communication des micro-onduleurs
Courant porteur en ligne (CPL)2
Enveloppe des micro-onduleurs
NEMA Type 6 / IP67 ; -40 à 65 °C2
Capacité de la passerelle
Jusqu’à 276 micro-onduleurs interrogés3
Interfaces de la passerelle
Wi-Fi 802.11 b/g/n, Ethernet en option, E/S numériques, API locale3
Comptage de production de la passerelle
Qualité facturation, ±0,5 %, trois TC de production 400 A fournis3
Validité du jeton de l’API locale
1 an (propriétaire du système) ; 12 heures (installateur)1

interface

Mesures documentées et limites d'intégration pour IQ8P-3P / IQ Gateway Commercial 2.

  • GET /info ne nécessite aucun jeton et renvoie en XML le numéro de série de la passerelle, sa référence et la version logicielle (par exemple D7.4.22).
  • GET /api/v1/production/inverters renvoie, par micro-onduleur, serialNumber, lastReportDate (secondes epoch), devType, lastReportWatts et maxReportWatts. Enphase indique une mise à jour toutes les cinq minutes.
  • GET /ivp/pdm/energy renvoie wattHoursToday, wattHoursSevenDays, wattHoursLifetime et wattsNow pour les micro-onduleurs (pcu) et pour les compteurs de production et de consommation de la passerelle (eim).
  • GET /ivp/meters/readings renvoie les valeurs des TC de production et de consommation (activePower en W, reactivePower en var, voltage, current, freq, énergie cumulée) par compteur et par canal de phase, mises à jour toutes les cinq minutes.
  • GET /ivp/meters/gridReading renvoie par phase la tension, le courant, la fréquence et les puissances active et réactive au raccordement au réseau. Une puissance active négative signifie une injection.
  • Les requêtes à l’API locale portent Authorization: Bearer <token> ; la note n’indique que /info comme accessible sans jeton. La passerelle utilise un certificat auto-signé.

appréciation

Micro-onduleurs IQ8P-3P et IQ8H-3P avec IQ Gateway Commercial 2, d’après les fiches techniques DSH-00236-8.0 et DSH-00212-4.0 et la note technique TEB-00060-2.0. Comparez la mesure du ZEM ou de l’API avec l’Enphase App sur le même intervalle.

Interopérabilitélimité
L’API locale est documentée avec ses points d’accès et des exemples JSON, mais chaque lecture dépend d’un jeton délivré par le cloud avec une durée de vie fixe, et aucune table Modbus n’est publiée.13
précisionSoutenu avec des conditions
Les TC de production de la passerelle sont de qualité facturation à ±0,5 % ; les valeurs de l’API locale sont mises à jour toutes les cinq minutes.13
sécuritéSoutenu avec des conditions
À partir du logiciel 7.0.x, les API locales nécessitent un jeton bearer en HTTPS ; le certificat de la passerelle est auto-signé.1
fiabilitélimité
Les valeurs sont mises à jour toutes les cinq minutes et les jetons installateur expirent après 12 heures : le chemin API doit gérer le renouvellement et les données périmées.1
rudesseSoutenu avec des conditions
Les micro-onduleurs sont NEMA Type 6 / IP67 de -40 à 65 °C ; la passerelle est IP30 et doit être installée à l’intérieur ou dans un coffret NEMA 3R.23
ÉvolutivitéSoutenu avec des conditions
Une passerelle interroge jusqu’à 276 micro-onduleurs ; les sites plus grands nécessitent une passerelle et un jeton par numéro de série de passerelle.13
Cycle de vieSoutenu avec des conditions
Les fiches techniques et la note technique ont un historique des révisions ; l’IQ8H-3P n’est plus fabriqué.12

Configuration

Lire le dernier rapport d’un micro-onduleur dans l’API locale

Une requête HTTPS GET en lecture seule sur le LAN du site, avec l’exemple de réponse publié par Enphase dans la note technique TEB-00060-2.0. Le jeton est un espace réservé ; l’exemple est celui d’Enphase, pas un relevé de site.

Requête
GET https://<gateway IP>/api/v1/production/inverters avec les en-têtes Accept: application/json et Authorization: Bearer <token>.
Exemple de réponse Enphase
[{"serialNumber": "121935144671", "lastReportDate": 1654171836, "devType": 1, "lastReportWatts": 15, "maxReportWatts": 38}]
Décodage
lastReportWatts 15 est la dernière puissance active transmise, en W. maxReportWatts 38 est la puissance la plus élevée jamais transmise par cette unité, pas une valeur nominale.
Horodatage
lastReportDate 1654171836 est exprimé en secondes epoch : 2 juin 2022, 12:10:36 UTC. Utilisez-le comme heure de la valeur, pas comme heure de la requête.
Échec d’authentification
Sans jeton valide, la requête échoue ; l’exemple curl d’Enphase utilise -f pour qu’une redirection non authentifiée apparaisse comme une erreur. Traitez-la comme une donnée manquante et renouvelez le jeton.

Acceptation : Acceptez le chemin API lorsque la somme des lastReportWatts des unités, ou wattsNow de production.pcu, concorde avec la puissance photovoltaïque du ZEM sur la même fenêtre de cinq minutes. Gardez le ZEM comme mesure continue lorsque le jeton expire.

  1. Commencer par le ZEM sur le circuit photovoltaïque

    Mesurez l’installation là où ses circuits de branche se regroupent, avec des TC du ZEM sur les trois phases et le sens de soutirage relevé. Cela ne nécessite aucun compte Enphase et continue de fonctionner si un jeton expire. Comparez sa puissance avec l’Enphase App sur le même intervalle.

  2. Décider qui détient le jeton

    Ce guide s’appuie sur la note technique TEB-00060-2.0. Un jeton s’obtient sur entrez.enphaseenergy.com ou sur enlighten.enphaseenergy.com/entrez-auth-token?serial_num= suivi du numéro de série de la passerelle, après connexion avec des identifiants Enphase. Le jeton du propriétaire du système dure un an ; celui d’un installateur 12 heures. Convenez avec le propriétaire de qui le génère et le renouvelle.

  3. Vérifier la passerelle sans jeton

    Depuis le LAN du site, envoyez GET https://<gateway IP>/info. La passerelle répond sans jeton et renvoie le numéro de série et la version logicielle. À partir du logiciel 7.0.x, les autres API locales de la note nécessitent le jeton.

  4. Lire la production avec le jeton bearer

    Envoyez GET https://<gateway IP>/ivp/pdm/energy avec les en-têtes Accept: application/json et Authorization: Bearer <token>. Acceptez le certificat auto-signé de la passerelle pour cet hôte uniquement. Mappez wattsNow et wattHoursLifetime sous production.pcu.

  5. Respecter l’intervalle de mise à jour et laisser la commande à Enphase

    Enphase met à jour les valeurs des onduleurs et des compteurs toutes les cinq minutes : n’interrogez pas plus souvent et gardez lastReportDate comme horodatage de la valeur. La limitation d’injection, les profils réseau et les E/S numériques de la passerelle restent dans le système Enphase.

Questions fréquentes

L’API locale de l’Enphase IQ Gateway nécessite-t-elle un jeton ?
Oui, à partir du logiciel IQ Gateway 7.0.x. Le jeton est généré depuis le cloud Enphase pour le numéro de série de la passerelle. Le jeton du propriétaire du système est valable un an et celui d’un installateur 12 heures. La note indique /info comme accessible sans jeton.1
À quelle fréquence les valeurs de l’API locale changent-elles ?
Enphase indique que les relevés des compteurs, la production par micro-onduleur et les rapports de consommation sont mis à jour toutes les cinq minutes. Une interrogation plus rapide renvoie les mêmes valeurs.1
Que signifie une valeur réseau négative ?
Sur /ivp/meters/gridReading, une puissance active négative signifie une injection sur le réseau et une valeur positive un soutirage.1

Sources

  1. Accessing IQ Gateway local APIs and local UI using token, note technique TEB-00060-2.0-EN, juin 2025 (s’ouvre dans un nouvel onglet) Enphase Energy
  2. Fiche technique IQ8 Commercial Microinverters DSH-00236-8.0-EN, juin 2026 (s’ouvre dans un nouvel onglet) Enphase Energy
  3. Fiche technique IQ Gateway Commercial 2 DSH-00212-4.0-EN-US, mai 2025 (s’ouvre dans un nouvel onglet) Enphase Energy

Lecture complémentaire

Les noms de produits et les marques commerciales appartiennent à leurs propriétaires. La publication ne suppose pas d'approbation ou d'une relation commerciale.