How to integrate with WiTTRA

How to integrate with WiTTRA

This guide will walk you through the process of integrating any device with the WiTTRA Network and TagoIO. By following the steps outlined below, you will be able to set up your device for uplink operations.


Uplink Configuration
To configure uplink communication, follow these three main steps:

1) TagoIO Setup
  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., WiTTRA-Integration).
    3. Click Save.
  3. Copy the Authorization Token:
    1. After creation, copy the authorization token. You will need this in later steps.
Alert
Note: you need to create only one Authorization for all your devices.

2) Setting up WiTTRA
Access your WiTTRA portal, log in, and follow the steps:
  1. Create a "Webhook" in your webhook settings.
  2. Fill in the required fields:
    1. URL: Use the endpoint format https://wittra.middleware.REGION.tago.io/uplink.
      1. Replace REGION with your deployment region (e.g., us-e1, eu-w1).
        For a list of available regions, visit TagoIO Network Integration.
    2. Token: Set its value to the authorization token you copied in Step 1. (generated at Step 1)
  3. Click on Add Webhook

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 WiTTRA.
    2. The Device EUI must match exactly to establish a successful connection between WiTTRA and TagoIO.
  2. Select the Appropriate Network and Device Type:
    1. Choose the WiTTRA 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.