home-assistant.io/source/_integrations/thethingsnetwork.markdown

title	description	ha_category	ha_release	ha_iot_class	ha_codeowners	ha_domain	ha_platforms	ha_integration_type	ha_config_flow
The Things Network	Instructions for how to integrate The Things Network within Home Assistant.	Hub Sensor	0.55	Cloud Polling	@angelnu	thethingsnetwork	sensor	hub	true

The thethingsnetwork {% term integration%} allows you to interact with the The Things Network from within Home Assistant. This community-driven and open network supports LoRaWAN for long-range (~5 to 15 km) communication with low bandwidth (51 bytes/message). 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	MQTT
Storage	thethingsnetwork
HTTP

There is currently support for the following device types within Home Assistant:

• Prerequisites
• Sensor

Prerequisites

1. Visit the The Things Network Console 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 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.