A module for interacting w/ the Enphase Enjoy solar controller. It currently has a simple program for logging data, such as production and per panel data.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

README.md 1.5 KiB

4 years ago
1234567891011121314151617181920212223242526272829303132333435363738394041424344
  1. enphaseapi
  2. ==========
  3. This is a module to interact w/ the Enphase Envoy solar controllers.
  4. It is designed to interact directly w/ the controller, and NOT use
  5. the Enlighten cloud API. This is for people who do not want their
  6. personal information sold to third parties.
  7. It will consist of two parts, the data logger part, that will issue
  8. requests and write the output to a file (see the file start), and a
  9. second part which will parse the log files and allow you to interact
  10. with the data, such as fetch the data for a particular time.
  11. Note: This code was written quickly so that I wouldn't lose the data
  12. on my recently installed system. It needs to be updated to be use proper
  13. TDD, which likely could have caught some of the bugs/errors such as when
  14. the Envoy goes off-line.
  15. Credentials
  16. -----------
  17. There are two files that are used for credentials. The first is
  18. `creds.txt`. The format of this file is:
  19. ```
  20. <ip> <username> <password>
  21. ```
  22. `ip` is the IP or hostname of the envoy controller. The `username` is
  23. usually `envoy`. The password is what is set.
  24. To get streaming line information (voltage, frequency, pf, etc), you
  25. need the installer password. This password is installed in the file
  26. `creds.inst.txt`.
  27. Scripts
  28. -------
  29. There are two scripts. One is `start`, and this one provides the
  30. collection of per panel and overall production information.
  31. The second is `streaming`. This outputs detailed, per second
  32. information about the power line, including voltage, power, and
  33. power factor.