DanielGallo / GivEnergy-Smart-Home-Display

A web-based smart home display for showing live GivEnergy inverter data
1 stars 2 forks source link

GivEnergy Dashboard

Introduction

This is a web-based application for showing a live summary of energy data from one or more GivEnergy inverters.

Data can be summarised if you are using a single inverter, or multiple inverters on a single phase, or multiple inverters in a 3-phase environment.

It is designed to fetch its data from GivTCP, and is bundled within recent versions of GivTCP.

User interface

Landscape example

The user interface of the web app is rendered completely using SVG. The only external dependencies for the user interface are a little use of jQuery. The rest of the app consists of pure JavaScript and CSS.

Data is obtained from the inverter by using REST requests to GivTCP on the local network.

The web app can run on a mobile, tablet, or desktop browser, and is designed to run in both portrait and landscape modes. It should render correctly on all devices/browsers. Let me know if you spot any rendering issues!

Portait example

Setup

This web app is bundled with recent versions of GivTCP.

  1. Follow the installation instructions for GivTCP and set this up somewhere on your local network so that it's running 24/7. This runs inside a Docker container.
  2. When you configure GivTCP, you will need to set a few GivTCP parameters in the Docker Compose file in order to use this web app:
    1. WEB_DASH - set to True to enable this web dashboard.
    2. WEB_DASH_PORT - set it to the default port 3000.
  3. If you have multiple inverters and want the name of each inverter to be shown in the web app, you will also need to set the following parameters:
    1. INVERTOR_NAME_1 - a short friendly display name for the first inverter.
    2. INVERTOR_NAME_2 - a short friendly display name for the second inverter, etc.

Usage

The web app is accessed from the same network address as GivTCP, and will run on port 3000 by default. So you should be able to launch the web app via http://10.0.0.210:3000 (assumes 10.0.0.210 is the host where GivTCP is running).

You can append additional query-string parameters to show more advanced information:

For example, you can append these query-string parameters like this:

http://10.0.0.210:3000?ShowAdvancedInfo=true&ShowTime=true

Other Notes