Enphase

From Domoticz
Jump to navigation Jump to search

Domoticz supports the Enphase inverters. For each solar panel a measuring device can be created.

From Stable 2023.1 the Enphase integration has been updated to support Inverters (IQ7/8) and Storage (battery) on firmware 5 and 7.

Firmware 7 supports Authorization tokens, these are also supported.

Create Hardware

  • Type: Select Enphase Envoy with LAN (HTTP) interface
  • Enabled/Disabled: you can disable the hardware gateway. The created devices stay active (but greyed out) but will not be updated.
  • Name: Enter a meaningful name for the Enphase Gateway
  • Select Log Levels:
    • Info: Shows info logging about the hardware and its devices in the log file or log page. This will normally generate the most log lines
    • Status: Shows Status logging in the log file or log page.
    • Error: Shows Error logging in the log file or log page.
  • Data Timeout: Enable Data Timeout if needed (1 minute to 24 hours). Domoticz will restart the Hardware thread/plugin if after the set timeout still no data is received by the gateway.
  • Enter Enphase LAN IP address and port (default 80)
  • Enter Username and password of Enphase online (not the installer account). If Token is requested leave empty an store the Token in Domoticz (see Token section)
  • Set polling interval ( (5/10/20/30/60/120 seconds)
  • Poll Inverters: Enable individual Inverters if needed. This will create a kWh device fore every individual inverter for monitoring.
  • Site ID: Fill the Site ID (top left in enlighten site) to be able to switch on/off power generation. A separate on/off switch will be created.


Click on ADD to add the gateway to Domoticz. .


Inverter Devices

After adding the Domoticz Hardware Gateway a General kWh Device type production is created that monitors the complete installation of all inverters.

If Poll Inverters is enabled also a similar kWh device is created for each individual inverter.

Please check the device list (menu Setup - Devices) for new created Enphase devices and activate the if needed.

Note: Domoticz is only monitoring the inverter from 1 our before Sunrise to 1 hour after Sunset. If you enable/start the device outside this timeframe (in the dark) not all devices will be created immediately but only after the inverters become active.

Note: In a previous version of this integration a P1 Smart meter was created. This device is deprecated from 2023.1 Enphase integration and will not be updated anymore if present.


Storage (battery devices)

If the installation consists a storage facility the additional devices are created for monitoring the battery

  • percentage device showing the battery level
  • a Usage, Electric device that ways how much Watt device drawn or charged (negative value) from the battery
  • a text device showing the mode (charging/discharging/idle)


Authentication Token

Note: Only when asked for.

When you are using Firmware 7 and you go directly to your Enphase Envoy's IP address you can be asked to create a token (points you to the website https://entrez.enphaseenergy.com/ to do so)

Then copy this token and past it into the Enphase Envoy Autthentication page (see screenshot below) and submit to login the website.

This token is valid for at least a year when you do so.

Once you have done this, then you can use it in Domoticz.

When Domoticz logs in with the user/password it will read and store the token internally in a UserVariable starting with 'EnphaseToken_'

You can also use the contents of this uservariable to login to your system (instead of creating a new token)