Sigfox

Sigfox

Sigfox is a relatively low-cost wireless network technology that requires low power to connect, and that is implemented by lost cost hardware modules.

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

Uplink is the process to send data from the devices to TagoIO. The Downlink is used to send data back to the devices. Learn how to perform downlink for SigFox .

Follow these steps to setup the Sigfox Backend and TagoIO.

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., Sigfox-Integration).
    3. Click Save.
  3. Copy the Authorization Token:
    1. After creation, copy the authorization token. You will need this in later steps. 
The Authorization should be generated by TagoIO by acessing the Service Authorization page; no Additional Parameters are needed.

Step 2: Set Up Integration in Sigfox

On the Sigfox Backend Portal, you will need to create a callback type 'uplink'. We will use the Data Uplink option to obtain the basic information in the messages.

If your contract with Sigfox allows you to get more information like RSSI, SNR, STATION, you can use the Advanced Data option.

Go to your Sigfox console and create a new Callback. You can create a new callback under the menu DEvice Type > Callback > New > Custom Callback
Configure the Callback:

Field
Description
Type
Data & Uplink
Channel
URL
URL
Use the endpoint format sigfox.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.
Use HTTP Method
POST
Send SNI
Check the box Send SNI
Headers
Add two rows in the Headers section inside the header and value fields:

header value
 device  {device}
authorization<authorization generated by TagoIO>
Content-type
application/json
Body
Copy and paste the JSON text below.

  1. [{
  2.     "variable": "device",
  3.     "value": "{device}",
  4.     "serie": "{time}"
  5. },{
  6.     "variable": "data",
  7.     "value": "{data}",
  8.     "serie": "{time}"
  9. },{
  10.     "variable": "seqNumber",
  11.     "value": "{seqNumber}",
  12.     "serie": "{time}"
  13. }]


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

Information about Downlink can be found at Sigfox - Downlink documentation.

You also can create your own parse scripts to process variables from the payload.  


    • Related Articles

    • Sigfox - Downlink

      TagoIO is ready to receive data from and send data to Sigfox devices. The Downlink is used to send data back to the module every time it checks in – the data to be sent down should be ready prior to the check-in. This tutorial explains how to setup a ...

    • Thinxtra Xkit for Sigfox

      This tutorial explains how to connect the Xkit from Thinxtra with TagoIO. This Sigfox board can be connected to a PC, Mac, Arduino, Raspberry PI, and other platforms. Here is a diagram of Xkit board's pinout, you can click here for more details. Xkit ...

    • Adeunis with Sigfox

      TagoIO supports most Adeunis devices by providing the perfect integration with Sigfox backend. Also, it parses the data by extracting the measured variables in real-time. Adeunis + Sigfox + TagoIO diagram All data sent by your device will be readily ...

    • Sens'it with Sigfox

      TagoIO is fully integrated with Sens'it v2 and v3 devices by providing the perfect integration with Sigfox backend and parsing the data by extracting the measured variables in real-time. Sens'it + Sigfox + TagoIO    Connectivity DiagramAll data sent ...

    • Sigfox using 'Advanced Data'

      The Advanced Data option allows you to receive additional information like SNR, RSSI, STATION, and others.  The type of information available will depend on your Data Plan contracted with Sigfox. On the Sigfox Backend Portal, create a callback type ...