Home Assistant

Dweet.io

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: '{{ value_json.VARIABLE }}'

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.

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: '{{ value_json.VARIABLE }}'
    unit_of_measurement: "°C"

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