Giter VIP home page Giter VIP logo

enphase_gateway's Introduction

enphase_logo

Control4 Enphase Envoy/IQ Gateway Solar Driver

Overview

This driver is used to get the solar values from an Enphase Envoy/IQ Gateway unit. It stores the values in variables, so you can do any kind of programming with it. Also the driver provides a simple webview, where you can see the values.

Following values are supported:

  • Consumption
  • Solar Production
  • Grid Power
  • Excess Solar
  • Total values for the day (Production & Consumption)
  • Current Line Voltage
  • Enpower Connected
  • Grid Status

Envoy/IQ Gateway requirements

An Enphase Envoy S (Metered) or IQ Gateway is required, this will not work with the Standard (Non-metered) Gateways.

Supported Models:

  • IQ Gateway
  • Envoy S Metered

Configuring the driver

Enter your Enphase Enlighten Username (e-mail) and Password (Required if your Envoy is running firmware version 7 or higher).

NOTE: If you run multiple Envoy gateways, change the Discovery Mode propery to "Manual" and set the Envoy IP to use for this driver instance.

Properties

Driver Version Shows the version of the driver.

Debug Mode Set debug mode to On or Off.

Polling Interval Choose the time in seconds at which the Gateway should be read for updated data.

Discovery Mode Choose the Envoy discover mode. Auto or Manual.

Envoy IP (Only Available if Discovery Mode is Manual) If using "Manual" Discovery Mode, enter the Envoy IP address.

Username Your Enlighten Username. Required if firmware is v7 or higher

Password Your Enlighten Password. Required if firmware is v7 or higher

Serial Number (read-only) Serial number of your Gateway.

Part Number (read-only) Part number of your Gateway.

Software Version (read-only) Current software version running on your Gateway.

Production (kW) (read-only) Production from the solar panels.

Consumption (kW) (read-only) Consumption of all loads.

Grid (kW) (read-only) Power from or to the grid.

Production Today (kWh) (read-only) Total solar power produced today.

Consumption Today (kWh) (read-only) Total power used today in your home (both solar and grid, if any).

Excess Solar (kW) (read-only) Current excess solar available for use.

Current Voltage (v) (read-only) Current voltage reading from the Envoy.

Current Voltage (v) (read-only) Current voltage reading from the Envoy.

Enpower Connected (read-only) If there is an Enpower connected to the system. (true/false)

Grid Status (read-only) Current Grid Status. (closed/opened)

Variables

PRODUCTION_KW (Int) Power in kW from the solar panels.

CONSUMPTION_KW (Int) Consumption of all loads in kW.

GRID_POWER_KW (Int) Power in kW from or to the grid.

DAILY_ENERGY_PRODUCTION_KWH (Int) Daily energy produced in kWh.

DAILY_ENERGY_CONSUMPTION_KWH (Int) Daily energy consumed in kWh.

EXCESS_SOLAR (Bool) If there is currently excess solar.

EXCESS_SOLAR_KW (Int) Excess energy available in kW.

CURRENT_VOLTAGE (Int) Current voltage reading from the Envoy in volts.

ENPOWER_CONNECTED (Bool) If there is an Enpower connected to the system. (true/false)

GRID_STATUS (String) Current Grid Status. (closed/opened)

Limitations

  • Daily energy kWh grid import/export totals are not available currently.

Release Notes: (BETA Version)

  • v1

    • Initial release
  • v2

    • Added MDNS discovery of Envoy Gateway
  • v3

    • Changed to using different URLs for data (will swap to Stream/websocket data later)
  • v4

    • Added Authorization option for Envoy version 7 or higher
  • v5

    • Additional settings/changes for Authorization
  • v6

    • Additional settings/changes for Authorization
  • v7

    • Add Envoy Readings URL selection
  • v8

    • Bug fixes
  • v9

    • Bug fixes
  • v10

    • Fix for ivp/meters/readings data
  • v11

    • Update to WebView design
  • v12

    • Update to UI Icon and WebView design
  • v13

    • Bug fix for version check
  • v14

    • Bug fix for authentication and session token problem
  • v15

    • Revamped WebView to use watched Variables instead of DataToUI
  • v16

    • Bug fix for if gAuth gets set back to false
    • Re-instated DataToUI as a backup if Watched Variable data does not populate in WebView
  • v17

    • Bug fix for errors
  • v18

    • Added CURRENT_VOLTAGE variable and properties to gather the current voltage reading from the Envoy.
  • v19

    • Added Enpower & Grid Status variables and properties.
  • v20

    • Added Discovery Mode (Auto/Manual) for the ability to manually set which Envoy IP to use. (Useful if you run multiple Envoy Gateways)

Compiled Driver Available from Releases:

https://github.com/Leighm0/enphase_gateway/releases

Disclaimer:

This software is neither affiliated with nor endorsed by either Control4 or Enphase® Energy.

enphase_gateway's People

Stargazers

 avatar  avatar

Watchers

 avatar

enphase_gateway's Issues

Questions on Data Harvesting

Hi Leigh,

Thanks for creating this driver, it looks really great. I've implemented it on one of my test projects and we instantly managed to integrate the device and started to get data almost immediately.

However, we didn't get all the data, please see the following pics. We haven't received any data values for Energy Consumption, Excess KW and Grid Power KW.

I don't know if there are any settings we should be looking at, or if we need to have an Enlighten API Licence?

Capture-Composer-Variables-DataValues

Capture-Composer-SystemDesign-DataValues

Thanks again, keen to hear what your thoughts are.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.