This is a custom HACS integration for Enphase Gateways.
Please be aware that this custom integration does not overwrite the "enphase_envoy" core integration (see: Limitations).
Installation
Prerequisites:
- Please ensure that the "enphase_envoy" core integration is disabled.
- Ensure that custom integrations overwriting the core integration are disabled.
- Running two or more integrations accessing your Enphase gateway will result in unexpected behaviour and errors.
Installation:
- Install HACS if you haven't already
- Add this repository as a custom integration repository in HACS
- Restart home assistant
- Add the integration through the home assistant configuration flow
Supported Devices
Gateways:
- Envoy-S Metered (with CT's enabled or disabled)
- Envoy-S Standard
- Envoy-R
Metrics:
| Envoy-R | Envoy-S Standard | Envoy-S Metered (CT's disabled) |
Envoy-S Metered (CT's enabled) |
|
|---|---|---|---|---|
| Current power production | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
| Today's energy production | :heavy_check_mark: | :heavy_check_mark: | :x: | :heavy_check_mark: |
| Last seven days energy production | :heavy_check_mark: | :heavy_check_mark: | :x: | :heavy_check_mark: |
| Lifetime energy production | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
| Single inverter production | :x: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |
| Current power consumption | :x: | :x: | :x: | :heavy_check_mark: |
| Today's energy consumption | :x: | :x: | :x: | :heavy_check_mark: |
| Last seven days energy consumption | :x: | :x: | :x: | :heavy_check_mark: |
| Lifetime energy consumption | :x: | :x: | :x: | :heavy_check_mark: |
| Aggregated ENCHARGE metrics * | :x: | :x: | :white_circle: | :heavy_check_mark: |
* ENCHARGE storage required
* Currently in beta phase
Batteries:
- Legacy Enphase batteries: AC Battery *
- 1st-generation IQ Batteries: IQ Battery 3/10
- 2nd-generation IQ Batteries: IQ Battery 3T/10T
- 3rd-generation IQ Batteries: IQ Battery 5P *
* These devices are supported but not tested
Available entities:
| AC Battery | IQ Battery | |
|---|---|---|
| Power | :heavy_check_mark: | :heavy_check_mark: |
| Charging power | :heavy_check_mark: | :heavy_check_mark: |
| Discharging power | :heavy_check_mark: | :heavy_check_mark: |
| Apparent power | :x: | :heavy_check_mark: |
| Current energy capacity | :heavy_check_mark: | :heavy_check_mark: |
| State of charge | :heavy_check_mark: | :heavy_check_mark: |
| Temperature | :x: | :heavy_check_mark: |
Usage
-
Username / Password / Use Enlighten #73\ When configuring the Envoy with firmware 7 or higher specify your Enphase Enlighten username and password, the envoy serial number and check the 'Use Enlighten' box at the bottom. This will allow the integration to collect a token from the enphase website and use it to access the Envoy locally. It does this at first configuration, at each HA startup or at reload of the integration. The Enphase web-site is known to be slow or satured at times. When an Unknown Error is reported during configuration try again until success. #81 \ \ Upon changing your password on the Enphase web site you will have to update the password information in HA. To update it, delete the envoy integration from the Settings / Integrations window. Restart HA and then in Integrations window configure it again. All data is kept and will show again once it's configured.
-
#75 Invalid Port and IPV6 autodetect \ HA performs auto discovery for Envoy on the network. When it identifies an Envoy it will use the Envoy serial number to identify a configured Envoy and then update the IP addres of the Envoy. If the auto discovery returns an IPV6 address it will update the Envoy with reported IPv6 address even if it was configured with an IPv4 address before. This causes the integration to fail as IPv6 addresses cause issues in the communication to the Envoy. \ \ To solve this and prevent this from happening again, remove the Envoy in the Integrations panel, restart HA and configure the Envoy again with the IPv4 address. This may require to change the IP address to the IPv4 on the auto detected Envoy or add manually an Envoy Integration. \ \ Then open the System options on the Envoy Integrations menu (3 vertical dots). In the System options panel de-activate the Enable Newly Added Entities option to turn it off. This will cause the Envoy Intgeration to ignore autodetect updates and keep the configured IP address. Make sure the Envoy is using a fixed IP address to avoid loosing connection if it changes its IP.
Limitations
-
Multiple integrations
- This custom integration uses a different domain than the "enphase_envoy" core integration.
- Thereby it does not overwrite the "enphase_envoy" core integration.
- Running two or more integrations accessing your Enphase gateway will result in unexpected behaviour and errors.
Tribute
This integration is based on work done by the following:
- https://github.com/jesserizzo/envoy_reader by @jesserizzo and contributors
- https://github.com/DanBeard/enphase_envoy by @DanBeard and contributors
- https://github.com/briancmpbll/home_assistant_custom_envoy by @briancmpbll and contributors