enphaseapi

This is a module to interact w/ the Enphase Envoy solar controllers. It is designed to interact directly w/ the controller, and NOT use the Enlighten cloud API. This is for people who do not want their personal information sold to third parties.

It will consist of two parts, the data logger part, that will issue requests and write the output to a file (see the file start), and a second part which will parse the log files and allow you to interact with the data, such as fetch the data for a particular time.

Note: This code was written quickly so that I wouldn’t lose the data on my recently installed system. It needs to be updated to be use proper TDD, which likely could have caught some of the bugs/errors such as when the Envoy goes off-line.

Credentials

There are two files that are used for credentials. The first is creds.txt. The format of this file is:

<ip> <username> <password>

ip is the IP or hostname of the envoy controller. The username is usually envoy. The password is what is set.

To get streaming line information (voltage, frequency, pf, etc), you need the installer password. This password is installed in the file creds.inst.txt.

Scripts

There are two scripts. One is start, and this one provides the collection of per panel and overall production information.

The second is streaming. This outputs detailed, per second information about the power line, including voltage, power, and power factor.