mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-16 05:46:52 +00:00
🚜 Merges The Things Network component pages (#9115)
This commit is contained in:
parent
41c122f9fb
commit
96e9ec612b
@ -1,82 +0,0 @@
|
|||||||
---
|
|
||||||
layout: page
|
|
||||||
title: "The Things Network Sensor"
|
|
||||||
description: "Instructions on how to integrate The Things Network sensors into Home Assistant."
|
|
||||||
date: 2017-09-30 08:00
|
|
||||||
sidebar: true
|
|
||||||
comments: false
|
|
||||||
sharing: true
|
|
||||||
footer: true
|
|
||||||
logo: thethingsnetwork.png
|
|
||||||
ha_category: Sensor
|
|
||||||
ha_iot_class: Local Polling
|
|
||||||
ha_release: 0.55
|
|
||||||
---
|
|
||||||
|
|
||||||
The `thethingsnetwork` sensor platform allows you to get data from a [The Things Network Storage Integration](https://www.thethingsnetwork.org/docs/applications/storage/).
|
|
||||||
|
|
||||||
This platform requires that the [The Things Network component](/components/thethingsnetwork/) is set up and the [The Things Network Storage Integration](https://www.thethingsnetwork.org/docs/applications/storage/) as well.
|
|
||||||
|
|
||||||
## {% linkable_title Prerequisites %}
|
|
||||||
|
|
||||||
Visit the [The Things Network Console](https://console.thethingsnetwork.org/) website, log in with your The Things Network credentials, choose your application from **Applications** and go to **Integrations**.
|
|
||||||
|
|
||||||
Add a new integration.
|
|
||||||
|
|
||||||
<p class='img'>
|
|
||||||
<img src='/images/components/thethingsnetwork/add_integration.png' />
|
|
||||||
Add a The Things Network integration
|
|
||||||
</p>
|
|
||||||
|
|
||||||
Select **Data Storage**.
|
|
||||||
|
|
||||||
<p class='img'>
|
|
||||||
<img src='/images/components/thethingsnetwork/choose_integration.png' />
|
|
||||||
Choose a The Things Network integration
|
|
||||||
</p>
|
|
||||||
|
|
||||||
Click **Add integration** to finish the process.
|
|
||||||
|
|
||||||
<p class='img'>
|
|
||||||
<img src='/images/components/thethingsnetwork/confirm_integration.png' />
|
|
||||||
Add a The Things Network Data Storage integration
|
|
||||||
</p>
|
|
||||||
|
|
||||||
When done, the status of the integration should be **Running**. You could check the output after clicking on **go to platform** in an interactive web interface.
|
|
||||||
|
|
||||||
<p class='img'>
|
|
||||||
<img src='/images/components/thethingsnetwork/storage_integration.png' />
|
|
||||||
Add a The Things Network integration
|
|
||||||
</p>
|
|
||||||
|
|
||||||
Select **Devices** to get the ID of your device that you want to use.
|
|
||||||
|
|
||||||
<p class='img'>
|
|
||||||
<img src='/images/components/thethingsnetwork/devices.png' />
|
|
||||||
Devices overview
|
|
||||||
</p>
|
|
||||||
|
|
||||||
## {% linkable_title Configuration %}
|
|
||||||
|
|
||||||
To enable this platform, add the following lines to your `configuration.yaml`:
|
|
||||||
|
|
||||||
```yaml
|
|
||||||
# Example configuration.yaml entry
|
|
||||||
sensor:
|
|
||||||
- platform: thethingsnetwork
|
|
||||||
device_id: ha-demo
|
|
||||||
values:
|
|
||||||
sensor_value: unit of measurement
|
|
||||||
voltage: V
|
|
||||||
```
|
|
||||||
|
|
||||||
{% configuration %}
|
|
||||||
device_id:
|
|
||||||
description: The ID of the device.
|
|
||||||
required: true
|
|
||||||
type: string
|
|
||||||
values:
|
|
||||||
description: The sensor values with their unit of measurement
|
|
||||||
required: true
|
|
||||||
type: list
|
|
||||||
{% endconfiguration %}
|
|
@ -8,9 +8,13 @@ comments: false
|
|||||||
sharing: true
|
sharing: true
|
||||||
footer: true
|
footer: true
|
||||||
logo: thethingsnetwork.png
|
logo: thethingsnetwork.png
|
||||||
ha_category: Hub
|
ha_category:
|
||||||
|
- Hub
|
||||||
|
- Sensor
|
||||||
ha_release: 0.55
|
ha_release: 0.55
|
||||||
ha_iot_class: Configurable
|
ha_iot_class: Configurable
|
||||||
|
redirect_from:
|
||||||
|
- /components/sensor.thethingsnetwork/
|
||||||
---
|
---
|
||||||
|
|
||||||
The `thethingsnetwork` component allows one to interact with the [The Things Network](https://www.thethingsnetwork.org). This community-driven and open network supports [LoRaWAN](https://www.lora-alliance.org/) for long range (~5 to 15km) communication with a low bandwidth (51 bytes/message). [Gateways](https://www.thethingsnetwork.org/docs/gateways/) transfers the received data from the sensors to the The Things Network.
|
The `thethingsnetwork` component allows one to interact with the [The Things Network](https://www.thethingsnetwork.org). This community-driven and open network supports [LoRaWAN](https://www.lora-alliance.org/) for long range (~5 to 15km) communication with a low bandwidth (51 bytes/message). [Gateways](https://www.thethingsnetwork.org/docs/gateways/) transfers the received data from the sensors to the The Things Network.
|
||||||
@ -20,9 +24,13 @@ The Things network support various integrations to make the data available:
|
|||||||
| The Things Network Integration | Home Assistant platform |
|
| The Things Network Integration | Home Assistant platform |
|
||||||
|---|---|
|
|---|---|
|
||||||
| [MQTT](https://www.thethingsnetwork.org/docs/applications/mqtt/) | |
|
| [MQTT](https://www.thethingsnetwork.org/docs/applications/mqtt/) | |
|
||||||
| [Storage](https://www.thethingsnetwork.org/docs/applications/storage/) | [`thethingsnetwork`](/components/sensor.thethingsnetwork/) |
|
| [Storage](https://www.thethingsnetwork.org/docs/applications/storage/) | [`thethingsnetwork`](#sensor) |
|
||||||
| [HTTP](https://www.thethingsnetwork.org/docs/applications/http/) | |
|
| [HTTP](https://www.thethingsnetwork.org/docs/applications/http/) | |
|
||||||
|
|
||||||
|
There is currently support for the following device types within Home Assistant:
|
||||||
|
|
||||||
|
- [Sensor](#sensor)
|
||||||
|
|
||||||
## {% linkable_title Setup %}
|
## {% linkable_title Setup %}
|
||||||
|
|
||||||
Visit the [The Things Network Console](https://console.thethingsnetwork.org/) website, log in with your The Things Network credentials, choose your application from **Applications**.
|
Visit the [The Things Network Console](https://console.thethingsnetwork.org/) website, log in with your The Things Network credentials, choose your application from **Applications**.
|
||||||
@ -62,3 +70,73 @@ access_key:
|
|||||||
required: true
|
required: true
|
||||||
type: string
|
type: string
|
||||||
{% endconfiguration %}
|
{% endconfiguration %}
|
||||||
|
|
||||||
|
## {% linkable_title Sensor %}
|
||||||
|
|
||||||
|
The `thethingsnetwork` sensor platform allows you to get data from a [The Things Network Storage Integration](https://www.thethingsnetwork.org/docs/applications/storage/).
|
||||||
|
|
||||||
|
This platform requires that the [The Things Network component](#configuration) is set up and the [The Things Network Storage Integration](https://www.thethingsnetwork.org/docs/applications/storage/) as well.
|
||||||
|
|
||||||
|
### {% linkable_title Prerequisites %}
|
||||||
|
|
||||||
|
Visit the [The Things Network Console](https://console.thethingsnetwork.org/) website, log in with your The Things Network credentials, choose your application from **Applications** and go to **Integrations**.
|
||||||
|
|
||||||
|
Add a new integration.
|
||||||
|
|
||||||
|
<p class='img'>
|
||||||
|
<img src='/images/components/thethingsnetwork/add_integration.png' />
|
||||||
|
Add a The Things Network integration
|
||||||
|
</p>
|
||||||
|
|
||||||
|
Select **Data Storage**.
|
||||||
|
|
||||||
|
<p class='img'>
|
||||||
|
<img src='/images/components/thethingsnetwork/choose_integration.png' />
|
||||||
|
Choose a The Things Network integration
|
||||||
|
</p>
|
||||||
|
|
||||||
|
Click **Add integration** to finish the process.
|
||||||
|
|
||||||
|
<p class='img'>
|
||||||
|
<img src='/images/components/thethingsnetwork/confirm_integration.png' />
|
||||||
|
Add a The Things Network Data Storage integration
|
||||||
|
</p>
|
||||||
|
|
||||||
|
When done, the status of the integration should be **Running**. You could check the output after clicking on **go to platform** in an interactive web interface.
|
||||||
|
|
||||||
|
<p class='img'>
|
||||||
|
<img src='/images/components/thethingsnetwork/storage_integration.png' />
|
||||||
|
Add a The Things Network integration
|
||||||
|
</p>
|
||||||
|
|
||||||
|
Select **Devices** to get the ID of your device that you want to use.
|
||||||
|
|
||||||
|
<p class='img'>
|
||||||
|
<img src='/images/components/thethingsnetwork/devices.png' />
|
||||||
|
Devices overview
|
||||||
|
</p>
|
||||||
|
|
||||||
|
### {% linkable_title Configuration %}
|
||||||
|
|
||||||
|
To enable this platform, add the following lines to your `configuration.yaml`:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# Example configuration.yaml entry
|
||||||
|
sensor:
|
||||||
|
- platform: thethingsnetwork
|
||||||
|
device_id: ha-demo
|
||||||
|
values:
|
||||||
|
sensor_value: unit of measurement
|
||||||
|
voltage: V
|
||||||
|
```
|
||||||
|
|
||||||
|
{% configuration %}
|
||||||
|
device_id:
|
||||||
|
description: The ID of the device.
|
||||||
|
required: true
|
||||||
|
type: string
|
||||||
|
values:
|
||||||
|
description: The sensor values with their unit of measurement
|
||||||
|
required: true
|
||||||
|
type: list
|
||||||
|
{% endconfiguration %}
|
Loading…
x
Reference in New Issue
Block a user