2.6 KiB
layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release, ha_iot_class
layout | title | description | date | sidebar | comments | sharing | footer | logo | ha_category | ha_release | ha_iot_class |
---|---|---|---|---|---|---|---|---|---|---|---|
page | Dweet.io | Instructions on how to integrate Dweet.io sensors within Home Assistant. | 2015-12-10 10:15 | true | false | true | true | dweet.png | Sensor | 0.10 | Cloud Polling |
The dweet
sensor platform allows you to get details from your devices which are publishing their values to Dweet.io.
To use Dweet.io in your installation, add the following to your configuration.yaml
file:
# Example configuration.yaml entry
sensor:
- platform: dweet
device: THING_NAME
value_template: '{% raw %}{{ value_json.VARIABLE }}{% endraw %}'
{% configuration %}
device:
description: Identification of the device (also known as thing
).
required: true
type: string
value_template:
description: The variable to extract a value from the content.
required: true
type: template
name:
description: Let you overwrite the name of the device in the frontend.
required: false
default: Dweet.io Sensor
type: string
unit_of_measurement:
description: Defines the unit of measurement of the sensor, if any.
required: false
type: string
{% endconfiguration %}
{% linkable_title Full configuration sample %}
A full configuration entry could look like the sample below.
# Example configuration.yaml entry
sensor:
- platform: dweet
name: Temperature
device: THING_NAME
value_template: '{% raw %}{{ value_json.VARIABLE }}{% endraw %}'
unit_of_measurement: "°C"
{% linkable_title Interacting with Dweet.io %}
You can easily send dweets from the command-line to test your sensor with curl
.
$ curl -H 'Content-Type: application/json' -d '{"temperature": 40, "humidity": 65}' https://dweet.io/dweet/for/ha-sensor
will give you a response like the one below:
{"this":"succeeded","by":"dweeting","the":"dweet","with":{"thing":"ha-sensor","created":"2015-12-10T09:43:31.133Z","content":{"temperature":40,"humidity":65}}}
The dweepy module gives you another option to work with Dweet.io.
Send a dweet.
$ python3
>>> import dweepy
>>> dweepy.dweet_for('ha-sensor', {'temperature': '23', 'humiditiy':'81'})
{'thing': 'ha-sensor', 'created': '2015-12-10T09:46:08.559Z', 'content': {'humiditiy': 81, 'temperature': 23}}
Receive the latest dweet.
>>> dweepy.get_latest_dweet_for('ha-sensor')
[{'thing': 'ha-sensor'', 'created': '2015-12-10T09:43:31.133Z', 'content': {'humidity': 65, 'temperature': 40}}]