home-assistant.io/source/_components/sensor.dweet.markdown

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 variables:

• device (Required): Identification of the device (also known as thing).
• value_template (Required): The variable to extract a value from the content.
• name (Optional): Let you overwrite the name of the device in the frontend.
• unit_of_measurement (Optional): Defines the unit of measurement of the sensor, if any.

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