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
Released on: | Jan. 29, 2024 |
Requires: | Indigo v2022.1.0+ |
Download this release |
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
Released on: | May 2, 2023 |
Requires: | Indigo v2022.1.0+ |
Download 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
Released on: | May 13, 2022 |
Requires: | Indigo v2022.1.0+ |
Download this release |
Python 3 Indigo 2022.1 Version
Released on: | June 26, 2020 |
Requires: | Indigo v7.0.2 thru v2022.2 |
Download this release |
Another fix (productionWattsNow) for unmetered Envoy-S (made hard by lack of device...in my defence...) Hopefully last one
Released on: | June 25, 2020 |
Requires: | Indigo v7.0.2 thru v2022.2 |
Download this release |
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
Released on: | June 23, 2020 |
Requires: | Indigo v7.0.2 thru v2022.2 |
Download this release |
Bug fix for Legacy device not updating Fix for DeviceUpdated time for legacy Fix for Sensor, add PowerStatus showing idle/producing states
Released on: | June 23, 2020 |
Requires: | Indigo v7.0.2 thru v2022.2 |
Download this release |
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
Released on: | April 10, 2020 |
Requires: | Indigo v7.0.2 thru v2022.2 |
Download this release |
Change to how panels are created/updated, allows editing and re-generation Remove some github code - USE Plugin Store Few fixes here and there
Released on: | Sept. 6, 2018 |
Requires: | Indigo v5.0.0 thru v2022.2 |
Download this release |
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
Released on: | June 7, 2018 |
Requires: | Indigo v5.0.0 thru v2022.2 |
Download this release |
Fix for Generate Panels deleting main device in some circumstances! Allows GeneratePanel to add new microinverters if ever upgraded
Released on: | June 28, 2017 |
Requires: | Indigo v5.0.0 thru v2022.2 |
Download 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)
Released on: | Jan. 17, 2017 |
Requires: | Indigo v5.0.0 thru v2022.2 |
Download this release |
Minor fixes for calculation to keep inline with report data (Negative results = exporting, positive results = Watts being used)
Released on: | Jan. 16, 2017 |
Requires: | Indigo v5.0.0 thru v2022.2 |
Download this release |
Fix for missing netConsumption and storage result from production.json Should calculate it if missing Likely needs testing.
Released on: | Dec. 25, 2016 |
Requires: | Indigo v5.0.0 thru v2022.2 |
Download this release |
Add Envoy Legacy Support (limited reporting) Fix for UiValue code error for panels
Released on: | Dec. 24, 2016 |
Requires: | Indigo v5.0.0 thru v2022.2 |
Download 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)
Released on: | Dec. 21, 2016 |
Requires: | Indigo v5.0.0 thru v2022.2 |
Download this release |
0.0.6 Beta Release