How to integrate TagoIO with Chirpstack LoRaWAN

How to integrate TagoIO with Chirpstack LoRaWAN

This tutorial provides a step-by-step guide to integrate Chirpstack v3/v4 with the TagoIO Platform. By following these instructions, you will enable uplink and downlink operations, allowing data exchange between your LoRaWAN devices and the TagoIO application.

Prerequisites

Before you begin, ensure you have the following:
  • Chirpstack server: A deployed Chirpstack instance locally or in the cloud
  • LoRaWAN Device: Ensure your device is connect to Chirpstack and transmitting data.

Step 1: Create Authorization in TagoIO

  1. Access Authorizations:
    1. Go to Devices.
    2. Click on Authorizations at the top of the page.
  2. Create a New Authorization:
    1. Click the Create Authorization button.
    2. Provide a meaningful name for the authorization (e.g., Chirpstack-Integration).
    3. (Optional) Enter your Downlink URL and Bearer Token from Chirpstack into the Additional Parameters section.
      1. Format: Downlink URL;Bearer Token
        Example: https://mychirpstack.io;eyJhbGciOiJIUzI1NiIsInR...
    4. Click Save.
  3. Copy the Authorization Token:
    1. After creation, copy the authorization token. You will need this in later steps.
Notes
Note:  You only need to create one Authorization for all your Chirpstack devices. 

Step 2: Setup Integration in Chirpstack

    Go to the Chirpstack website and create a new HTTP integration. You can create the integration by going to Application > Choose your Application > Integration, click on create, and select HTTP as an option.

    Configure the Integration:

    Field
    Description
    Integration Kind
    Select HTTP Integration
    Headers
    You will need to setup two headers for this integration:

    Header Key
    Header Value
    Authorization
    Set its value to the authorization token you copied in Step 1.
    Content-Type
    application-json

    Uplink data URL
    Use the endpoint format https://chirpstack.middleware.REGION.tago.io. Replace REGION with your deployment region (e.g., us-e1, eu-w1).
    For a list of available regions, visit TagoIO Network Integration.

    chirpstack integration

    Info
    The endpoint https://chirpstack.middleware.tago.io points to the USA region. As we are committed to continuing support for this endpoint, we recommend that users in the USA region update their webhooks to https://chirpstack.middleware.us-e1.tago.io.


    Step 3: Add Device in TagoIO

    To integrate your device with the TagoIO Platform, follow these guidelines:
    1. Ensure Device EUI Consistency:
      1. When creating the device in TagoIO, use the exact same Device EUI that is configured in Chirpstack.
      2. The Device EUI must match exactly to establish a successful connection between Chirpstack and TagoIO.
    2. Select the Appropriate Network and Device Type:
      1. Choose the LoRaWAN Chirpstack Network during the device setup process.
      2. Select the correct device type from the available options. If your device is not listed, you can add support through connectors.
    3. Add Device Support via Connectors (If Necessary):
      1. If your device type is not available in the default list, enhance its compatibility by utilizing connectors.
      2. For more information on available connectors and how to use them, refer to the Connector Overview.
    For detailed instructions on adding devices, visit the Adding Devices page.


    Finalizing Setup

    1. Power On Your Devices:
      1. Turn on your LoRaWAN device and gateway to initiate data transmission.
    2. Verify Data Reception:
      1. In TagoIO, navigate to the Device and into the Data tab to confirm that data is being received.
      2. Alternatively, use the Live Inspector within your device settings to monitor incoming data in real-time.

    With data successfully flowing into TagoIO, you can start creating Dashboards, Analyses, and Actions to visualize and manage your device data effectively.