iOS Energy Widget

A Scriptable.app-based iOS widget which visualizes the energy production and energy consumption of your house from the last 24 hours, including forecast data.

Data is read from a Grafana server with an InfluxDB time-series database as data store, or from a regulary updated, server-hosted file.

Examples

Styles - selected via widget parameter:

• Small widget:

  • style=1

    

  • style=4

    

• Medium widget:

  • style=1;time-range=last-24h

    

  • style=1;time-range=today

    

  • style=2;time-range=last-24h

    

  • style=3;time-range=last-24h

    

  • style=3;time-range=today

    

Visualized data:

• Circles - from left to right / from top-left to bottom-right:

  • Consumption mix (in kWh): photovoltaics consumption (yellow), battery consumption (orange), grid consumption (red); with a full circle of 15 or sum
  • Grid feed (in kWh): energy fed into the grid (green); with a full circle of 25 or sum
  • Production mix (in kWh): photovoltaics consumption (yellow), battery charge (blue), grid feed (green); with a full circle of 30 or sum
  • Battery state: current battery charge level as percentage

• Timeline:

  • Stacked values in 15-minutes intervals
  • A gray line visualizes the forecast data

Runtime Configuration

Widget parameters:

• style: visual style of the widget; valid values: 1, 2, 3, 4
• time-range: time range to display; valid values: last-24h, today
• server: server section to use; valid values are defined by the data: servers: configuration section, e.g. grafana or file

Widget parameters are passed as key1=value1;key2=value2;....

Static Configuration

To configure the widget, edit the C constant in the configuration section of the widget.

Time-series, based on 15min intervals:

• photovoltaics: consume:: Photovoltaics energy, directly consumed by your house
• photovoltaics: forecast:: Forecast of the photovoltaics energy production (optional)
• battery: charge:: Energy used to charge your battery (optional)
• battery: consume:: Energy consumed from your battery (optional)
• battery: level:: Current charge level of your battery (optional)
• grid: feed:: Energy fed into the power grid
• grid: consume:: Energy consumed from the power grid

For optional time-series, just remove the query field.

Servers:

• servers: grafana:: Connection details for the Grafana server
• servers: file:: Connection details for a server-hosted file with the current measurements / Grafana query results

Tools for Offline Rendering and Configuration

The dev folder contains a development environment for offline rendering of the widget, without an iOS device. For this, the development environment implements some of the Scriptable.app APIs and renders the widget via the canvas library. Note that the API coverage is not complete and the rendering is not 100% pixel perfect.

To install the development environment, install Node.js, and then run npm install inside the dev folder.

Scripts:

• render-png.js: Renders a PNG image from the widget

  Example:

  node dev/render-png.js configured-widget.js medium 'style=1;time-range=last-24h' 0.333 > image.png
  

• render-data-file.js: Renders a time-series data file which can be uploaded to a server and consumed by a file configuration of the widget

  Example:

  node dev/render-data-file.js configured-widget.js 'server=grafana' > data.js
  

• server.js: Starts a web server which renders the widget, and a web browser which triggers rendering of the widget and displays the rendered widget

  Example:

  node dev/server.js configured-widget.js medium 'style=1'
  

  Just reload the web page to reload the widget file and get it rendered.