EVRYTHNG is an official Sigfox platform partner, providing an IoT platform for Sigfox devices through a scalable bridge. This allows Sigfox devices to send data to EVRYTHNG where our Platform tools such as the ADI storage (as Thngs), the Reactor or our Analytics can be used to add value to the data collected by the Sigfox device.
This page is a step by step tutorial on how to connect a Sigfox device to the EVRYTHNG platform.
Log into the EVRYTHNG Dashboard and start by creating a project and a corresponding application. Make a note the 'Trusted API Key' of your application as this will be the API key used to authenticate incoming Sigfox requests later on.
Next, create a product to represent the type of Sigfox device, and a number of Thngs corresponding to each one. Make sure to add an
sigfoxId with the Sigfox ID of the device. This will let the EVRYTHNG Platform know which Thng a particular Sigfox message corresponds to, and will be embedded in the message. An example is shown below:
Alternatively you can let the Sigfox - EVRYTHNG bridge create Thngs automatically based on incoming messages. We will show you how to do this below.
Now you can configure the Sigfox service to push the data coming from your devices to EVRYTHNG.
This is done using the callback functionality of the Sigfox backend. Make sure you select a callback of Type:
DATA - UPLINK and
BATCH_URL as Channel.
In the Custom Payload Config add the custom properties of your Sigfox device (e.g., here a temperature value as an unsigned integer). Then, configure the URL patterns to point to the SigFox - EVRYTHNG secure bridge:
$TRUSTED_APPLICATION_API_KEY with the Trusted App API Key you got in step 1 via the EVRYTHNG Dashboard. If you would like the bridge to automatically create EVRYTHNG Thngs for a given Sigfox device ID (if the device was not found), add
create=true to the query parameters. For example:
If your EVRYTHNG account is in the European EVRYTHNG platform, add the query parameter
env=eu. The default value for the env query parameter is
Finally, configure the line pattern as follows:
Note that the only required field is the
sigfoxId, all other fields are optional. Here, "temp" is an example of custom property that we wish to push to the EVRYTHNG Platform (temp corresponding to the Custom Payload Config). Here’s how this will look on the EVRYTHNG Thng corresponding to the device:
- Create a custom callback of the type “SERVICE” and select as subtype “GEOLOC”.
- The address of the callback is:
- Set “Use HTTP Method” to POST, enable “Use HTTP Method” and set the “Content-Type” to
application/json. The body is left empty.
- Test the setup by posting a position manually:
curl -H "Content-Type: application/json" \ -X POST "https://sigfox.evrythng.com/v1/spotit?sigfoxId=18B9C7&lat=0.525&lng=-0.0875&radius=7208&seqNumber=16&snr=8.25&time=1493220508&station=1DA5&rssi=-136.00&env=us&create=false&access_token=$TRUSTED_APPLICATION_API_KEY"
The location will then appear in the location widget of the corresponding Thng.
You can now test the integration with the Sigfox Device Simulator and should start seeing the Properties updating as the messages come through the bridge.
Your Sigfox devices can now communicate with EVRYTHNG where you can build your IoT apps. Check our other walkthroughs here on the Developer Hub to learn more. Should you want to trial SigFox and EVRYTHNG for a pilot or commercial project, do not hesitate to contact us!