home-assistant.io/source/_components/sensor.dweet.markdown
Ashton Campbell 9e6b9cb658 Fixed common spelling mistakes (#3544)
* fix spelling errors

* Update binary_sensor.xiaomi_aqara.markdown

Reverts to previous revision before spell check.

* Update tellstick.markdown

Reverts to previous revision before spell check.

* Update owntracks_two_mqtt_broker.markdown

Reverts to previous revision before spell check.

* Update cla_sign.html

Reverts to previous revision before spell check.

* Update credits.markdown

Reverts to previous revision before spell check.

* Update api.markdown

Fixed spell checker changing noone to no one.
2017-10-08 00:39:32 +02:00

2.4 KiB

layout title description date sidebar comments sharing footer logo ha_category ha_release ha_iot_class
page Dweet.io Instructions 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}}]