Provisioning for Telematics Guru on the Sigfox Backend
If you have registered Oysters on a private Sigfox account, and wish to connect them to Telematics Guru, you need to configure your Sigfox account to forward the data. This is done by adding a callback to the device type that you are using for your Oysters.
First, log in to your private Sigfox account at backend.sigfox.com.
Locate the device type that the Oysters are using, and click on the device type name:
In the information tab for the device type, click Edit:
Now set the downlink mode to Callback. You must do this even if you are not planning on supporting downlinks, as leaving it set to DIRECT will send downlinks and cause unintentional reprogramming.
If you want to see more detail in the device messages tab on backend.sigfox.com, you can optionally change the payload parsing from Regular (raw payload) to Custom grammar, and populate the custom configuration field with:
Type:0:uint:4::3 InTrip:0:bool:4 FixFailed:0:bool:5 Lat:1:int:32:little-endian Long:5:int:32:little-endian Heading:9:uint:8 Speed:10:uint:8 Vbat:11:uint:8
Now go to the Callbacks tab, and click the New button in the top right:
Now select Custom callback:
For Telematics Guru:
Fill in the Type, Channel, Url pattern, Use HTTP Method, Content type, and Body shown below.
The URL shown is in the form:
http://<device-region>.telematics.guru:8081
The device region in the URL is important to target the correct regional instance of Telematics Guru. Refer to this article for an explanation of the regions and the device specific URLs. A short summary is:
Region | Device URL |
---|---|
Global (old) | http://telematics.guru:8081 |
APAC01 | http://device-apac01.telematics.guru:8081 |
APAC02 | http://device-apac02.telematics.guru:8081 |
APAC03 | http://device-apac03.telematics.guru:8081 |
EMEA01 | http://device-emea01.telematics.guru:8081 |
EMEA02 | http://device-emea02.telematics.guru:8081 |
EMEA03 | http://device-emea03.telematics.guru:8081 |
AMER01 | http://device-amer01.telematics.guru:8081 |
AMER02 | http://device-amer02.telematics.guru:8081 |
Based on which server your Partner account is hosted you will need to use the related URL.
The full text of the Body field is:
{
"device":"{device}",
"time":"{time}",
"data":"{data}",
"seqNumber":"{seqNumber}",
"deviceTypeId":"{deviceTypeId}",
"ack":"{ack}"
}
NB: The available variables differ depending on the subscriptions, the variables on the Body text should match the ones that are available to you on your account.
Finally, select your new callback as the default for downlinks, by clicking the Downlink radio button:
It is possible to setup multiple callbacks to deliver data to multiple platforms. Be sure to select the correct one for the downlink messages.