diff --git a/source/_components/sensor.loop_energy.markdown b/source/_components/sensor.loop_energy.markdown index 0d6aa9c0c11..533215c7f40 100644 --- a/source/_components/sensor.loop_energy.markdown +++ b/source/_components/sensor.loop_energy.markdown @@ -14,22 +14,48 @@ ha_category: Sensor Integrate your [Loop Energy](https://www.your-loop.com/) meter information into Home Assistant. -To enable the Loop Energy sensor, add the following lines to your `configuration.yaml`: +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 +```` +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: ELECRITCAL_SERIAL - electricity_secret: ELECTRICAL_OFFSET + electricity_serial: ELECTRICAL_SERIAL + electricity_secret: ELECTRICAL_SECRET gas_serial: GAS_SERIAL gas_secret: GAS_SECRET ``` Configuration variables: -- **electricity_serial** (*Required*): Serial of your electricity sensor -- **electricity_secret** (*Required*): Secret for your electricity Sensor -- **gas_serial** (*Required*): Serial for your gas sensor. -- **gas_secret** (*Required*): Secret for your gas sensor. +- **electricity_serial** (*Required*): Serial number of your electricity sensor +- **electricity_secret** (*Required*): Secret key for your electricity sensor +- **gas_serial** (*Required*): Serial number for your gas sensor. +- **gas_secret** (*Required*): Secret key for your gas sensor. +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.