mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-18 06:46:58 +00:00
🚜 Merges/Redirect Dweet.io component pages (#9015)
This commit is contained in:
Klaas Schoute
Fabian Affolter
parent
036b83ac2c
commit
8ac6d9a032
@ -8,8 +8,13 @@ comments: false
|
|||||||
sharing: true
|
sharing: true
|
||||||
footer: true
|
footer: true
|
||||||
logo: dweet.png
|
logo: dweet.png
|
||||||
ha_category: "History"
|
ha_category:
|
||||||
|
- History
|
||||||
|
- Sensor
|
||||||
ha_release: 0.19
|
ha_release: 0.19
|
||||||
|
ha_iot_class: Cloud Polling
|
||||||
|
redirect_from:
|
||||||
|
- /components/sensor.dweet/
|
||||||
---
|
---
|
||||||
|
|
||||||
The `dweet` component makes it possible to transfer details collected with Home Assistant to [Dweet.io](http://dweet.io/) and visualize them with [freeboard.io](https://freeboard.io). Keep in mind that your information will be public!
|
The `dweet` component makes it possible to transfer details collected with Home Assistant to [Dweet.io](http://dweet.io/) and visualize them with [freeboard.io](https://freeboard.io). Keep in mind that your information will be public!
|
||||||
@ -18,11 +23,16 @@ The `dweet` component makes it possible to transfer details collected with Home
|
|||||||
<img src='{{site_root}}/images/screenshots/dweet-freeboard.png' />
|
<img src='{{site_root}}/images/screenshots/dweet-freeboard.png' />
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
|
||||||
<p class='note warning'>
|
<p class='note warning'>
|
||||||
The publishing interval is limited to 1 second. This means that it's possible to miss fast changes.
|
The publishing interval is limited to 1 second. This means that it's possible to miss fast changes.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
There is currently support for the following device types within Home Assistant:
|
||||||
|
|
||||||
|
- [Sensor](#sensor)
|
||||||
|
|
||||||
|
## {% linkable_title Configuration %}
|
||||||
|
|
||||||
To use the `dweet` component in your installation, add the following to your `configuration.yaml` file:
|
To use the `dweet` component in your installation, add the following to your `configuration.yaml` file:
|
||||||
|
|
||||||
```yaml
|
```yaml
|
||||||
@ -47,3 +57,88 @@ whitelist:
|
|||||||
type: list
|
type: list
|
||||||
{% endconfiguration %}
|
{% endconfiguration %}
|
||||||
|
|
||||||
|
## {% linkable_title Sensor %}
|
||||||
|
|
||||||
|
The `dweet` sensor platform allows you to get details from your devices which are publishing their values to [Dweet.io](https://dweet.io/).
|
||||||
|
|
||||||
|
### {% linkable_title Configuration %}
|
||||||
|
|
||||||
|
To use Dweet.io sensors in your installation, add the following to your `configuration.yaml` file:
|
||||||
|
|
||||||
|
{% raw %}
|
||||||
|
```yaml
|
||||||
|
# Example configuration.yaml entry
|
||||||
|
sensor:
|
||||||
|
- platform: dweet
|
||||||
|
device: THING_NAME
|
||||||
|
value_template: '{{ 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.
|
||||||
|
|
||||||
|
{% raw %}
|
||||||
|
```yaml
|
||||||
|
# Example configuration.yaml entry
|
||||||
|
sensor:
|
||||||
|
- platform: dweet
|
||||||
|
name: Temperature
|
||||||
|
device: THING_NAME
|
||||||
|
value_template: '{{ value_json.VARIABLE }}'
|
||||||
|
unit_of_measurement: "°C"
|
||||||
|
```
|
||||||
|
{% endraw %}
|
||||||
|
|
||||||
|
### {% linkable_title Interacting with Dweet.io %}
|
||||||
|
|
||||||
|
You can easily send dweets from the command-line to test your sensor with `curl`.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ 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:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{"this":"succeeded","by":"dweeting","the":"dweet","with":{"thing":"ha-sensor","created":"2015-12-10T09:43:31.133Z","content":{"temperature":40,"humidity":65}}}
|
||||||
|
```
|
||||||
|
|
||||||
|
The [dweepy](https://github.com/paddycarey/dweepy) module gives you another option to work with [Dweet.io](https://dweet.io/).
|
||||||
|
|
||||||
|
Send a dweet.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ 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.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
>>> dweepy.get_latest_dweet_for('ha-sensor')
|
||||||
|
[{'thing': 'ha-sensor'', 'created': '2015-12-10T09:43:31.133Z', 'content': {'humidity': 65, 'temperature': 40}}]
|
||||||
|
```
|
||||||
@ -1,98 +0,0 @@
|
|||||||
---
|
|
||||||
layout: page
|
|
||||||
title: "Dweet.io"
|
|
||||||
description: "Instructions on how to integrate Dweet.io sensors within Home Assistant."
|
|
||||||
date: 2015-12-10 10:15
|
|
||||||
sidebar: true
|
|
||||||
comments: false
|
|
||||||
sharing: true
|
|
||||||
footer: true
|
|
||||||
logo: dweet.png
|
|
||||||
ha_category: Sensor
|
|
||||||
ha_release: "0.10"
|
|
||||||
ha_iot_class: Cloud Polling
|
|
||||||
---
|
|
||||||
|
|
||||||
The `dweet` sensor platform allows you to get details from your devices which are publishing their values to [Dweet.io](https://dweet.io/).
|
|
||||||
|
|
||||||
## {% linkable_title Configuration %}
|
|
||||||
|
|
||||||
To use Dweet.io sensors in your installation, add the following to your `configuration.yaml` file:
|
|
||||||
|
|
||||||
{% raw %}
|
|
||||||
```yaml
|
|
||||||
# Example configuration.yaml entry
|
|
||||||
sensor:
|
|
||||||
- platform: dweet
|
|
||||||
device: THING_NAME
|
|
||||||
value_template: '{{ 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.
|
|
||||||
|
|
||||||
{% raw %}
|
|
||||||
```yaml
|
|
||||||
# Example configuration.yaml entry
|
|
||||||
sensor:
|
|
||||||
- platform: dweet
|
|
||||||
name: Temperature
|
|
||||||
device: THING_NAME
|
|
||||||
value_template: '{{ value_json.VARIABLE }}'
|
|
||||||
unit_of_measurement: "°C"
|
|
||||||
```
|
|
||||||
{% endraw %}
|
|
||||||
|
|
||||||
### {% linkable_title Interacting with Dweet.io %}
|
|
||||||
|
|
||||||
You can easily send dweets from the command-line to test your sensor with `curl`.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
$ 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:
|
|
||||||
|
|
||||||
```json
|
|
||||||
{"this":"succeeded","by":"dweeting","the":"dweet","with":{"thing":"ha-sensor","created":"2015-12-10T09:43:31.133Z","content":{"temperature":40,"humidity":65}}}
|
|
||||||
```
|
|
||||||
|
|
||||||
The [dweepy](https://github.com/paddycarey/dweepy) module gives you another option to work with [Dweet.io](https://dweet.io/).
|
|
||||||
|
|
||||||
Send a dweet.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
$ 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.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
>>> dweepy.get_latest_dweet_for('ha-sensor')
|
|
||||||
[{'thing': 'ha-sensor'', 'created': '2015-12-10T09:43:31.133Z', 'content': {'humidity': 65, 'temperature': 40}}]
|
|
||||||
```
|
|
||||||
Loading…
x
Reference in New Issue
Block a user