mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-31 23:36:50 +00:00
68 lines
2.5 KiB
Markdown
68 lines
2.5 KiB
Markdown
---
|
|
layout: page
|
|
title: "Loop Energy"
|
|
description: "Instructions how to integrate Loop Energy devices within Home Assistant."
|
|
date: 2016-04-02 22:00
|
|
sidebar: true
|
|
comments: false
|
|
sharing: true
|
|
footer: true
|
|
logo: loop.png
|
|
ha_category: Sensor
|
|
ha_release: 0.17
|
|
---
|
|
|
|
|
|
Integrate your [Loop Energy](https://www.your-loop.com/) 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](https://www.your-loop.com/). 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
|
|
|
|
```yaml
|
|
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:
|
|
|
|
```yaml
|
|
# 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.
|