machineQ LoRaWAN™

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

Follow these steps in order to integrate your devices. You may skip some steps depending on your situation. For example, if you have already generated an authorization and added it to machineQ, you can skip to Step 4.

Step 1: Generate an Application at machineQ

First, make sure you create an Application in machineQ Central so that the integration with TagoIO can be authorized.

Go to your machineQ Central, and follow this machineQ tutorial to generate a Client ID and a Client Secret that you will need to input in TagoIO later.

Access Authorizations

1. Go to Devices. 2. Click on Authorizations at the top of the page.

Create a New Authorization

1. Click the Create Authorization button. 2. Provide a meaningful name for the authorization (e.g., _MachineQ-Integration_). 3. Enter your Client ID and Client Secret from Step 2 into the Additional Parameters section:

Format: CLIENT_ID;CLIENT_SECRET

- Example: 64025-24054-230495-64034;ABT_QWzsSQAAH__HAwr...

4. Click Save.

Copy the Authorization Token

After creation, copy the authorization token. You will need this in later steps.

> _You must enter your Client ID and Client Secret separated by a semicolon in > the Additional parameter field._\ > _Only one Authorization per application is necessary. Don't do it for each > device._

Step 2: Create Authorization in TagoIO

_(Content for creating an authorization token in TagoIO should be added here if needed.)_

Step 3: Add Integration to machineQ

Access the machineQ Central, enter into the _Integration_ section, click on _Add Output Profile_, and select Restful API. The output format can be left as “extended”.

Fill in the following fields:

| Field | Value | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | Enter a unique identifier (e.g., _tagoio-integration_). | | URL | Use the endpoint format https://machineq.middleware.REGION.tago.io/uplink. Replace REGION with your deployment region (e.g., us-e1, eu-w1). | | Token Type | Enter the word Authorization. | | Token Value | Set its value to the TagoIO Authorization token you copied in Step 2. |

Step 4: Add Device in TagoIO

To integrate your device with the TagoIO Platform, follow these guidelines:

1. Ensure Device EUI Consistency

When creating the device in TagoIO, use the _exact same Device EUI_ that is

configured in MachineQ.

The Device EUI must match exactly to establish a successful connection

between MachineQ and TagoIO.

2. Select the Appropriate Network and Device Type

Choose the MachineQ Network during the device setup process.

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

If your device type is not available in the default list, enhance its

compatibility by utilizing connectors.

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

Turn on your LoRaWAN device and gateway to initiate data transmission.

2. Verify Data Reception

In TagoIO, navigate to the Device and into the Data tab to confirm that

data is being received.

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, adding notifications, and creating scripts to process your data.

Learn how to perform downlink for LoRaWAN: downlink for LoRaWAN.