mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-31 23:36:50 +00:00
62 lines
2.5 KiB
Markdown
62 lines
2.5 KiB
Markdown
---
|
|
title: The Things Network
|
|
description: Instructions for how to integrate The Things Network within Home Assistant.
|
|
ha_category:
|
|
- Hub
|
|
- Sensor
|
|
ha_release: 0.55
|
|
ha_iot_class: Cloud Polling
|
|
ha_codeowners:
|
|
- '@angelnu'
|
|
ha_domain: thethingsnetwork
|
|
ha_platforms:
|
|
- sensor
|
|
ha_integration_type: hub
|
|
ha_config_flow: true
|
|
---
|
|
|
|
The `thethingsnetwork` {% term integration%} allows you to interact with the [The Things Network](https://www.thethingsnetwork.org) from within Home Assistant. This community-driven and open network supports [LoRaWAN](https://www.lora-alliance.org/) for long-range (~5 to 15 km) communication with low bandwidth (51 bytes/message). [Gateways](https://www.thethingsnetwork.org/docs/gateways/) transfer the received data from the sensors to The Things Network.
|
|
|
|
The Things Network supports various integrations to make the data available:
|
|
|
|
| The Things Network Integration | Home Assistant platform |
|
|
|---|---|
|
|
| [MQTT](https://www.thethingsindustries.com/docs/integrations/mqtt) | [`MQTT`](/integrations/mqtt) |
|
|
| [Storage](https://www.thethingsindustries.com/docs/integrations/storage) | [`thethingsnetwork`](#setup) |
|
|
| [HTTP](https://www.thethingsindustries.com/docs/integrations/webhooks) | |
|
|
|
|
There is currently support for the following device types within Home Assistant:
|
|
|
|
- [Prerequisites](#prerequisites)
|
|
- [Sensor](#sensor)
|
|
|
|
|
|
## Prerequisites
|
|
|
|
|
|
1. Visit the [The Things Network Console](https://console.thethingsnetwork.org/) website, log in with your The Things Network credentials, choose your application from **Applications**.
|
|
- The **Application ID** is used to identify the scope of your data.
|
|
|
|
|
|
|
|
2. Under the integrations menu, enable the storage integration:
|
|
|
|
|
|
|
|
3. Ensure you have an [Uplink Payload Formatter](https://www.thethingsindustries.com/docs/integrations/payload-formatters/) for your device.
|
|
|
|
|
|
|
|
4. You need an API key to be able to read the data from your application.
|
|
- The minimum required rights are `Read Application Traffic (uplink and downlink)`.
|
|
|
|
|
|
|
|
|
|
{% include integrations/config_flow.md %}
|
|
|
|
|
|
## Sensor
|
|
|
|
All uplink messages decoded by The Things Network (including a `decoded_payload` entry) will be processes by this integration. Each field in `decoded_payload` will be added as a Home Assistant sensor entity.
|