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 back to the devices. Learn how to perform downlink for SigFox .
Follow these steps to setup the Sigfox Backend and TagoIO.
From your TagoIO account, go to the Devices section, click on 'Add Devices', and filter by Sigfox. Then, search for the device that you want to add. If you don't find it, select the type Custom Sigfox Device.
When selecting Custom Sigfox Device, a payload parse will NOT included on the new device. You will need to add your own parser to extract values.
After a device is created, a standard parser is included in the 'Payload Parser' tab based on the selected connector (unless you selected Custom Sigfox). Later, you can add your own script to execute any calculation or to parse more data.
Then, you need to create an Authorization and use it in the Orbiwise setup later.
The Authorization should be generated by TagoIO by acessing the Service Authorization page; no Additional Parameters are needed.
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.
Click on the Device Type and select your device from the list. Click on the Callback button, then click on New, and select the option Custom callback.
Configure the uplink with the instructions below.
Let's setup the callback using the option 'Data Uplink':
- Type: DATA
& UPLINK
- Channel: URL
- URL: https://sigfox.middleware.tago.io/uplink
- 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.
[{ "variable": "device", "value": "{device}", "serie": "{time}" },{ "variable": "data", "value": "{data}", "serie": "{time}" },{ "variable": "seqNumber", "value": "{seqNumber}", "serie": "{time}" }]
Your uplink integration is now complete!
Information about Downlink can be found at Sigfox - Downlink documentation.
You also can create your own parse scripts to process variables from the payload.