Enphase Envoy Plugin  

Developer: Glenn's Plugins     Like this plugin? Show your appreciation!
Category: Energy Monitoring
Github: Github Repo
Assistance: Get help!   
Plugin ID: com.GlennNZ.indigoplugin.EnphaseEnvoy
Latest release: v0.6.8 released on Jan. 29, 2024
Requires: Indigo v2022.1.0 or higher
(Check the Releases tab below for older releases that may have different requirements)
  Download latest release

Enphase Envoy-S Plugin (including per Panel Individual Data/Monitoring)

https://github.com/Ghawken/IndigoEnphaseEnvoy/releases/latest

Emphase is a per panel solar generation solution - via the use of roof based microinverters. This plugin monitors each panels output, and reports all useful data from the solar Enphase system via the Envoy-S. See:[url]http://www.enphase.com[/url] & For a international map of their thousands of installs see. (last count I see 540,000 installations.... :P ) (gotta be some Indigo users out there ???) [url]https://enphase.com/en-us/map[/url]

This Plugin connects the the local Enphase [i]Envoy-S[/i] device and pulls all information; including individual panel output (regardless of whether you have that option with your install)

It connects locally to the envoy device - and does not use the enlighten / web-service API. The local connection provides much more information, is more UpToDate and can be pulled every few minutes without problem. Having compared the two over some time there is no comparison to this minute-minute data.

[size=100]Usage/Installation:[/size]

Install Plugin - from Github as above.
(once installed can update from within Plugin)

I recommend you Create a New Folder for devices. Whilst you might only have one device - the Enphase Envoy-S: If you choose to use panel monitoring (and there is no reason not to - individual panel devices will be created in that folder)

Create "Enphase - Envoy-S Device" (the Panel devices must be generated by the plugin if needed)

Enter your IP address for you local Envoy (ideally will need static IP)

Enter your Envoy Serial Number (located on web page as seen below:)

Save.

The Plugin has a number of Custom states - showing current production, consumption, and net power (negative indicating exporting power).
(amongst others)

Device states change from importing to exporting for triggering activity/control pages.

If that's all you want/need - leave it at that. :lol:


But: If you want Per Panel data (and no negative) - go back into the Envoy-S device & enable per Panel data and click the newly appeared generate panels button. (if change mind - this button will change to delete after checkbox unticked - beware though - if you re-generate panels a while later the Plugin will create a whole lot of new Devices which will mean Control Panels etc will need to be redone)

This will generate a PanelDevice for each Panel you have installed.

This shows current Panel output and any status reports and custom states as you can see.

This is still a work in progress, and expect some ongoing modifications(in fact can already see some typos on the pictures posted :<) - but hopefully useful for someone.

Glenn

Release details
Released on: Jan. 29, 2024
Requires: Indigo v2022.1.0+
Changes in this release

Enphase Plugin 0.6.8

Changelog

0.6.8 Log all endpoints tried not just successful ones

0.6.7 Add code to display installer password (unused) Add new endpoints which may or may require installer access

0.6.6

Add Checkbox to Envoy-S Device Edit page to set Device as unMetered Needed for Firmware >7 Unmetered Envoy devices that now, with Firmware >7 don't report much data

Changes since pre-release

0.6.5

Allow redirect for serial Number as seems to have moved to https (verify=False as per all https calls) Check check_jwt locally to create a Session ID Move to using requests.Sessions across all calls so that cookies are applied across all, and we use a single session for all calls. Debug log cookies with production 0.6.7 Add code to display installer password (unused) Add new endpoints which may or may require installer access

0.6.6

Add Checkbox to Envoy-S Device Edit page to set Device as unMetered Needed for Firmware >7 Unmetered Envoy devices that now, with Firmware >7 don't report much data

0.6.5

Allow redirect for serial Number as seems to have moved to https (verify=False as per all https calls) Check check_jwt locally to create a Session ID Move to using requests.Sessions across all calls so that cookies are applied across all, and we use a single session for all calls. Debug log cookies with production

Release details
Released on: May 2, 2023
Requires: Indigo v2022.1.0+
Changes in this release

0.6.1 Finalising support for Firmware >=7 that requires a token from Enphase

Note: This version for full functionality requires cryptography module to be installed. pip3 install cryptography Run above from Terminal.

Hopefully will run without cryptography - just limit function, to manual token only (which will not be able to check expiry date of)

Adds: Plugin will login to enphase with details and create own token Valid for a year with then ongoing local access only. Checks token validity and when expired should update. Remove redirects from endpoint testing Remove Serial Number as seems to be still accessible in all versions PluginConfig changes

Release details
Released on: May 13, 2022
Requires: Indigo v2022.1.0+
Changes in this release

0.4.0

Python 3 Indigo 2022.1 Version

Release details
Released on: June 26, 2020
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

0.3.1

Another fix (productionWattsNow) for unmetered Envoy-S (made hard by lack of device...in my defence...) Hopefully last one

Release details
Released on: June 25, 2020
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

0.3.0

Re-write timing of calls, Panels 2 minutes, main devices 1 minute, with extra delays for each device that is created. Fix for serialno error. Add panelLastUpdated string and UTC Number to Envoy-S Device States - showing last time successfully received Panel Data

Release details
Released on: June 23, 2020
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

0.2.8

Bug fix for Legacy device not updating Fix for DeviceUpdated time for legacy Fix for Sensor, add PowerStatus showing idle/producing states

Release details
Released on: June 23, 2020
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

0.2.7

Combines support for Envoy-S devices into the one Plugin Device (Supports Envoy-S Metered and unmetered) Bug fix for legacy device updates (which shouldn't be needed) for those with Envoy-S unmetered anymore

Release details
Released on: April 10, 2020
Requires: Indigo v7.0.2 thru v2022.2
Changes in this release

Enphase Plugin

0.2.5

Change to how panels are created/updated, allows editing and re-generation Remove some github code - USE Plugin Store Few fixes here and there

Release details
Released on: Sept. 6, 2018
Requires: Indigo v5.0.0 thru v2022.2
Changes in this release

Enphase Envoy Indigo Plugin

0.1.8 Fix for updating code. Add option to open Pluginstore (checks against github releases) Fix for Refresh Devices manually via menu (Warning - cannot refresh envoy to frequently -- if hammer envoy will timeout and freeze; typically takes an hour or two to come back to life; worse case need to restart)

0.1.7 Add Last Communication state from Panel to Panel Device (this is reported time by Panel to Envoy-S - not related to Plugin communication) Can be used to check if micro-inverter issues

Release details
Released on: June 7, 2018
Requires: Indigo v5.0.0 thru v2022.2
Changes in this release

0.1.6

Fix for Generate Panels deleting main device in some circumstances! Allows GeneratePanel to add new microinverters if ever upgraded

Release details
Released on: June 28, 2017
Requires: Indigo v5.0.0 thru v2022.2
Changes in this release

0.1.5

Fixes for Envoy new 14th June 2017 software (avoids storage percent full error)

(Will have slower look/check and see whether new software exposes any further useful information)

Release details
Released on: Jan. 17, 2017
Requires: Indigo v5.0.0 thru v2022.2
Changes in this release

Minor fixes for calculation to keep inline with report data (Negative results = exporting, positive results = Watts being used)

Release details
Released on: Jan. 16, 2017
Requires: Indigo v5.0.0 thru v2022.2
Changes in this release

Fix for missing netConsumption and storage result from production.json Should calculate it if missing Likely needs testing.

Release details
Released on: Dec. 25, 2016
Requires: Indigo v5.0.0 thru v2022.2
Changes in this release

Add Envoy Legacy Support (limited reporting) Fix for UiValue code error for panels

Release details
Released on: Dec. 24, 2016
Requires: Indigo v5.0.0 thru v2022.2
Changes in this release

Updated logic for checks. Deals with timeouts; and no connection without error. Changed to timing to enable best use, without 'hammering' envoy-s Fix for UiImages - green for exporting; red for a not producing panel Correctly removes states and UI images on stop (for triggers based on wattage) Added a few states (powergenerating true/false, amongst others)

Release details
Released on: Dec. 21, 2016
Requires: Indigo v5.0.0 thru v2022.2
Changes in this release

0.0.6 Beta Release