EVRYTHNG Developer Hub

Welcome! Here's where you'll find what you need to start working with EVRYTHNG as quickly as possible. There are comprehensive guides, documentation, and support if you get stuck. We encourage you to dive in and explore.

Create Free Account Read Documentation

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.


1. Creating the EVRYTHNG Resources

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 identifier called 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.


2. Configuring the Sigfox Callback

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:

https://sigfox.evrythng.com/v1?var={batch}&access_token=$TRUSTED_APPLICATION_API_KEY

Replace $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:

https://sigfox.evrythng.com/v1/var={batch}&create=true&access_token=$TRUSTED_APPLICATION_API_KEY

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 env=us.

Finally, configure the line pattern as follows:

sigfoxId:{device};timestamp:{time};baseStation:{station};rssi:{rssi};seqNumber:{seqNumber};temp:{customData#temp}

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:

3. Geolocation with Spot'It

We also support Spot’It, SigFox’s brand new location service. If your contract includes Spot’It, you can use this service to automatically update the location property of your thng.

  1. Create a custom callback of the type “SERVICE” and select as subtype “GEOLOC”.
  2. The address of the callback is: https://sigfox.evrythng.com/v1/spotit?sigfoxId={device}&lat={lat}&lng={lng}&radius={radius}&seqNumber={seqNumber}&snr={snr}&time={time}&station={station}&rssi={rssi}&env=us&create=false&access_token=$TRUSTED_APPLICATION_API_KEY .
  3. Set “Use HTTP Method” to POST, enable “Use HTTP Method” and set the “Content-Type” to application/json. The body is left empty.
  4. 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.


4. Adding Sigfox Devices

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.

An ideal way to test this is with a prototyping device supporting SigFox such as the new official SigFox-enabled Arduino MKRFOX1200. We have a simple code example to get you started.


What's Next

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!

Sigfox