Sigfox - Downlink

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

It's essential to carefully follow all the steps outlined in the Sigfox network documentation in order to send downlinks. The completion of Step D is crucial so that TagoIO can accurately authenticate your downlink.

Downlink TagoIO to SigfoxDownlink Diagram 

Information about Uplink can be found in this tutorial.

The downlink serves to send responses from TagoIO to Sigfox, ensuring that the data transition is working correctly. The downlink configuration will be separated into two parts: (1) TagoIO setup, and (2) Sigfox setup using the Sigfox Portal.

1. TagoIO setup

1. Find your device that you just created by clicking on the Device (left menu), go to it, and click on the tab "Configuration parameters";
2. Create a parameter for your device;
A. In Key of the parameter, you should type downlinkData
B. The message that you want to send to your Sigfox device goes in the Value, and must have 8 bytes;
C. Click on Save button.

Example of 8 bytes downlinkData: 00000000ada1b2c3

D. You need to create an Authorization and use it in the Orbiwise setup later. 

NOTE: If you already have created an authorization, you can just copy it.

The Authorization should be generated by TagoIO by acessing the Service Authotization page; no Additional Parameters are needed.

2. Sigfox setup

Go to the sigfox portal and perform the following steps:

1. Click on Device Type;
2. After clicking Device type, the list of your devices will appear in Sigfox, choose one;
3. Click in the Callback button;
4. Click the New button;
5. Select the option Custom callback;
6. Configure the downlink.

CALLBACK CONFIGURATION

- Type:  DATA & BIDIR
- Channel: URL
- URL pattern:
 https://sigfox.middleware.tago.io/downlink
- 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} Required. Enter text exactly as shown.
 authorization your_secret_code_here

 <authorization generated by TagoIO>

- Content-type: application/json
- Body: Copy and paste the JSON text below into the body field. This JSON will take care of the parse to prepare the data coming from your Sigfox module to TagoIO.

[{
    "variable": "device",
    "value": "{device}",
    "serie": "{time}"
},{
    "variable": "data",
    "value": "{data}",
    "serie": "{time}"
},{
    "variable": "seqNumber",
    "value": "{seqNumber}",
    "serie": "{time}"
}]

Your downlink integration is completed. 

You can also send data from your the Dashboard using the Input Form widget. A script to perform a write in the parameter tab must be created using the Analysis.


    • Related Articles

    • 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. Uplink is the process to send data from the devices to TagoIO. The Downlink is used to send data ...
    • 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 ...
    • Downlink for LoRaWAN™

      TagoIO will send downlink messages to your devices through Configuration Parameters. To do that, just add a parameter called downlink, and uncheck the switch to 'Unread'. Your LoRaWAN TM provider may allow more downlink parameters. Most network ...
    • 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 ...