Minor changes

This commit is contained in:
Fabian Affolter 2016-10-20 22:57:06 +02:00
parent 51d7e21661
commit 27c8cf3e78
No known key found for this signature in database
GPG Key ID: DDF3D6F44AAB1336

View File

@ -1,7 +1,7 @@
--- ---
layout: page layout: page
title: "Emoncms Sensor" title: "Emoncms Sensor"
description: "Instructions on how to integrate emoncms feeds as sensors into Home Assistant." description: "Instructions on how to integrate Emoncms feeds as sensors into Home Assistant."
date: 2016-09-08 00:15 date: 2016-09-08 00:15
logo: emoncms.png logo: emoncms.png
sidebar: true sidebar: true
@ -14,102 +14,96 @@ ha_iot_class: "Local Polling"
--- ---
The `emoncms` sensor platform creates sensors for the feeds available in your local or cloud based version of [emoncms](https://emoncms.org). The `emoncms` sensor platform creates sensors for the feeds available in your local or cloud based version of [Emoncms](https://emoncms.org).
To enable this sensor, add the following lines to your `configuration.yaml`, it will list all feeds as a sensor: To enable this sensor, add the following lines to your `configuration.yaml`, it will list all feeds as a sensor:
```yaml ```yaml
# Example configuration.yaml entry using cloud based emoncms # Example configuration.yaml entry using cloud based Emoncms
sensor: sensor:
platform: emoncms platform: emoncms
api_key: put your emoncms read api key here api_key: API_KEY
url: https://emoncms.org url: https://emoncms.org
id: 1 id: 1
``` ```
## {% linkable_title Configuration variables %} ## {% linkable_title Configuration variables %}
- **api_key** (*Required*): The read api key for your emoncms user. - **api_key** (*Required*): The read API key for your Emoncms user.
- **url** (*Required*): The base url of emoncms, use "https://emoncms.org" for the cloud based version. - **url** (*Required*): The base URL of Emoncms, use "https://emoncms.org" for the cloud based version.
- **id** (*Required*): Positive Integer identifier for the sensor. Must be unique if you specify multiple emoncms sensors. - **id** (*Required*): Positive integer identifier for the sensor. Must be unique if you specify multiple Emoncms sensors.
- **include_only_feed_id** (*optional*): Positive integer list of emoncms feed id's. Only the feeds with feed id's specified here will be displayed. Can not be specified if `exclude_feed_id` is specified. - **include_only_feed_id** (*Optional*): Positive integer list of Emoncms feed IDs. Only the feeds with feed IDs specified here will be displayed. Can not be specified if `exclude_feed_id` is specified.
- **exclude_feed_id** (*optional*): Positive integer list of emoncms feed id's. All the feeds will be displayed as sensors except the ones listed here. Can not be specified if `include_only_feed_id` is specified. - **exclude_feed_id** (*Optional*): Positive integer list of Emoncms feed IDs. All the feeds will be displayed as sensors except the ones listed here. Can not be specified if `include_only_feed_id` is specified.
- **sensor_names** (*optional*): Dictionary of names for the sensors created that are created based on feedid. The dictionary consists of feedid:name pairs. Sensors for feeds with their feedid mentioned here will get the chosen name instead of the default name - **sensor_names** (*Optional*): Dictionary of names for the sensors created that are created based on feed ID. The dictionary consists of `feedid: name` pairs. Sensors for feeds with their feed ID mentioned here will get the chosen name instead of the default name
- **value_template** (*Optional*): Defines a [template](/topics/templating/) to alter the feed value. - **value_template** (*Optional*): Defines a [template](/topics/templating/) to alter the feed value.
- **scan_interval** (*Optional*): Defines the update interval of the sensor in seconds. - **scan_interval** (*Optional*): Defines the update interval of the sensor in seconds.
- **unit_of_measurement** (*Optional*): Defines the unit of measurement of for all the sensors. default is "W". - **unit_of_measurement** (*Optional*): Defines the unit of measurement of for all the sensors. default is "W".
## {% linkable_title Default naming scheme %} ## {% linkable_title Default naming scheme %}
The names of the sensors created by this component, will be a combination of static text, `id` from the config and `feedid` from the emoncms feed, unless `sensor_names` is used. The names of the sensors created by this component, will be a combination of static text, `id` from the config and `feedid` from the Emoncms feed, unless `sensor_names` is used. An example name would be `emoncms1_feedid_10`.
An example name would be "emoncms1_feedid_10"
## {% linkable_title Examples %} ### {% linkable_title Examples %}
In this section you find some more examples of how this sensor can be used. In this section you find some more examples of how this sensor can be used.
Display only feeds with their feed IDs specified in `include_only_feed_id`.
```yaml ```yaml
# Display only feeds with their feed id's specified in "include_only_feed_id" # Example configuration.yaml entry
sensor: sensor:
- platform: emoncms - platform: emoncms
api_key: put your emoncms read api key here api_key: API_KEY
url: https://emoncms.org url: https://emoncms.org
id: 1 id: 1
unit_of_measurement: "W" unit_of_measurement: "W"
include_only_feed_id: include_only_feed_id:
- 107 - 107
- 106
- 105 - 105
``` ```
Display all feeds except feeds with their feed id specified in `exclude_feed_id`.
```yaml ```yaml
# Display all feeds except feeds with their feed id specified in "exclude_feed_id" # Example configuration.yaml entry
sensor: sensor:
- platform: emoncms - platform: emoncms
api_key: put your emoncms read api key here api_key: API_KEY
url: https://emoncms.org url: https://emoncms.org
id: 1 id: 1
unit_of_measurement: "KWH" unit_of_measurement: "KWH"
exclude_feed_id: exclude_feed_id:
- 107 - 107
- 106
- 105 - 105
``` ```
Display only feeds with their feed id's specified in `include_only_feed_id` and give the feed sensors a name using "sensor_names". You don't have to specify all feeds names in "sensor_names", the remaining sensor names will be chosen based on "id" and the Emoncms `feedid`.
```yaml ```yaml
# Display only feeds with their feed id's specified in "include_only_feed_id" and give the feed sensors a name using "sensor_names". You don't have to specify all feeds names in "sensor_names", the remaining sensor names will be chosen based on "id" and the emoncms feedid # Example configuration.yaml entry
sensor: sensor:
- platform: emoncms - platform: emoncms
api_key: put your emoncms read api key here api_key: API_KEY
url: https://emoncms.org url: https://emoncms.org
id: 1 id: 1
unit_of_measurement: "KW" unit_of_measurement: "KW"
include_only_feed_id: include_only_feed_id:
- 5 - 5
- 18
- 29
- 48
- 61
- 110
- 116
- 120 - 120
sensor_names: sensor_names:
5: "feed 1" 5: "feed 1"
18: "feed 2"
29: "feed 3"
48: "kwh feed" 48: "kwh feed"
61: "amp feed" 61: "amp feed"
110: "watt feed" 110: "watt feed"
``` ```
Use a `value_template` to add 1500 to the feed value for all specified feed IDs in `include_feed_id`.
```yaml ```yaml
# Use a "value_template" to add 1500 to the feed value for all specified feed id's in "include_feed_id" # Example configuration.yaml entry
sensor: sensor:
- platform: emoncms - platform: emoncms
api_key: put your emoncms read api key here api_key: API_KEY
url: https://emoncms.org url: https://emoncms.org
scan_interval: 15 scan_interval: 15
id: 1 id: 1
@ -117,16 +111,15 @@ sensor:
include_only_feed_id: include_only_feed_id:
- 107 - 107
- 106 - 106
- 105
- 61
``` ```
Display feeds from the same Emoncms instance with 2 groups of feeds, diffrent `scan_interval` and a diffrent `unit_of_measurement`.
```yaml ```yaml
# Display feeds from the same emoncms instance with 2 groups of feeds, diffrent scan_interval and a diffrent unit_of_measurement # Example configuration.yaml entry
sensor: sensor:
- platform: emoncms - platform: emoncms
api_key: put your emoncms read api key here api_key: API_KEY
url: https://emoncms.org url: https://emoncms.org
scan_interval: 30 scan_interval: 30
id: 1 id: 1
@ -134,7 +127,6 @@ sensor:
include_only_feed_id: include_only_feed_id:
- 107 - 107
- 106 - 106
- 105
- platform: emoncms - platform: emoncms
api_key: put your emoncms read api key here api_key: put your emoncms read api key here
url: https://emoncms.org url: https://emoncms.org
@ -143,7 +135,5 @@ sensor:
unit_of_measurement: "A" unit_of_measurement: "A"
include_only_feed_id: include_only_feed_id:
- 108 - 108
- 109
- 110
- 61 - 61
``` ```