home-assistant.io/source/_components/sensor.loop_energy.markdown
2016-04-30 16:39:56 +02:00

2.5 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release
layout title description date sidebar comments sharing footer logo ha_category ha_release
page Loop Energy Instructions how to integrate Loop Energy devices within Home Assistant. 2016-04-02 22:00 true false true true loop.png Sensor 0.17

Integrate your Loop Energy meter information into Home Assistant.

To use this sensor you need the the client serial number and secret keys for your devices.

The library used to get the data isn't officially supported and the only way to get the keys is to log into loop energy's website and type a command into your browser console.

To do this log into Loop Energy. Once you're logged in you should be able see see your live readings on the webpage.

You can then open your browser's console window, how you do this varies by browser but in Chrome you click on `More Tools / Developer Tools' and click on the console window. You then type:-

Drupal.settings.navetas_realtime.

This should show something like

client_ip: "127.0.0.1"
gas_secret: "GAS_SECRET"
gas_serial: "GAS_SERIAL"
host: "www.your-loop.com"
...
secret: "ELECTRICAL_SECRET"
serial: "ELECTRICAL_SERIAL"

The serial and secret tokens are the ones you need. If you just have an electricity monitor - then you won't see the gas keys.

Now you have the keys, add the following lines to your configuration.yaml, replacing the SERIAL and SECRET keys with the ones you found in the console:

# Example configuration.yaml entry
sensor:
  platform: loopenergy
  electricity_serial: ELECTRICAL_SERIAL
  electricity_secret: ELECTRICAL_SECRET
  gas_serial: GAS_SERIAL
  gas_secret: GAS_SECRET
  gas_type: metric
  gas_calorific: 39.11

Configuration variables:

  • electricity_serial (Required): Serial number of your electricity sensor
  • electricity_secret (Required): Secret key for your electricity sensor
  • gas_serial (Optional): Serial number for your gas sensor.
  • gas_secret (Optional): Secret key for your gas sensor.
  • gas_type (Optional): Type of meter imperial or metric, defaults to metric.
  • gas_calorific (Optional): Calorific value of your gas supply (usually on your gas bill) - defaults to 39.11.

The electricity readings are updated every 10 seconds and the gas readings every 15 minutes.

The gas readings are experimental and not all gas meters are properly supported - so if the data you see doesn't agree with the readings you see via loop energy please report an issue.