home-assistant.io/source/_components/sensor.dweet.markdown
2018-11-06 08:13:18 +01:00

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}}]