support for enlighten v4 API

briancmpbll / home_assistant_custom_envoy

171 stars 76 forks source link

support for enlighten v4 API #194

Closed ev1lm0nk3y closed 2 months ago

ev1lm0nk3y commented 2 months ago

Looks like there's a new API available for Enlighten https://developer-v4.enphase.com/docs.html

This seems to have quite a few more options for configuring the battery profile, better metrics regarding production and consumption and even a streaming API where all the info can be gathered for 30 - 300s.

catsmanac commented 2 months ago

Hi @ev1lm0nk3y, that new API is the Enphase Cloud API, not the local Envoy API.

If you wan to use it, you need a 'plan', paid or free. The free plan allows for 1000 hits a month and a max of 10/min. So that's less than twice an hour average data pulling.

As for the battery options, you may want to check if the HA core integration meets your needs as that has battery profiles and switch operations controllable these days.

Locally streaming directly from the Envoy requires a DIY/Installer account. @vincentwolsink has a custom integration for that case.

ev1lm0nk3y commented 2 months ago

After reading a lot of docs, it looks like the configuration capabilities that I seem to remember seeing just a month or 2 ago do not exists any longer. I could've sworn I was able to control the battery mode from HA. There doesn't seem to be any mention of battery_mode in the Gateway Local API docs, so it may have been removed in one of the last updates.

It also looks like the v4 API doesn't allow you to play with the configuration parameters until you wanna shell out $1k a month :roll_eyes: so I guess I'll need to figure out some other mechanism to link my home to OhmConnect. There are plenty of operations in the v4 API that wouldn't require polling very often, but I'm not sure if the free plan can access those features at the moment.

Feel free to close this if there will be no movement to adopt the API

catsmanac commented 2 months ago

Yes, that free plan they list is very minimal. But Home Assistants prime philosophy is local access, that API is something different.

Anyway, the HA Core enphase_envoy integration has some battery control, see https://www.home-assistant.io/integrations/enphase_envoy/:

Sensors for battery status and usage
Sensors for grid status
Sensors for the state of the Enpower’s 4 load-shedding relays
A switch allowing you to take your system on-grid and off-grid. Note that the Enpower has a slight delay built-in between receiving these commands and actually switching the system on or off grid.
A switch allowing you to enable or disable charging the Encharge/IQ Batteries from the power grid.
Support for changing the battery storage mode between full backup, self-consumption, and savings mode and setting the reserve battery level for outages.