2024.10.4
Home ▸ Integrations ▸

The Things Network

The thethingsnetwork integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] 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

  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.

    Application overview

  2. Under the integrations menu, enable the storage integration:

    Storage Integration

  3. Ensure you have an Uplink Payload Formatter for your device.

    Payload Formatters

  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).

    API keys

Configuration

To add the The Things Network hub to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select The Things Network.

  • Follow the instructions on screen to complete the setup.

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.