Sens'it for Developers

Sens'it Discovery introduces developers to the possibilities of Sigfox through a complete end-to-end platform. Here we give you the tools to use it as devkit.

2018 saw the release of Sens'it 3. One of the many improvements of this new edition is how the Sens'it project was conceived as a playground for developers of all kinds. 

You can access and rework almost everything around the Sens'it hardware: 

  • build your own firmware with the Sens'it SDK, 
  • reroute the app's data flow with Webhooks
  • use your own platform through callbacks on the Sigfox Cloud, using the devkit connectivity. 

All of this makes it possible for you to rely on Sens'it for your custom proof-of-concepts.

Combined with the Sens'it Generic offer, which allows companies to add their branding on the device itself, Sens'it becomes your one-stop-shop for any IoT idea you might want to develop and explore!

Sens'it 2 and Sens'it 3 side by side

Sens'it as a Devkit

Sens'it Discovery is a Sigfox end-to-end solution. It combines a device, Sigfox connectivity and a web/mobile app (sensit.io). It uses the standard Discovery firmware.

The link between the device and the sensit.io app is Sigfox Cloud. This is where device makers can view their raw data and reroute it to their own server using callbacks. By default, Sens'it Discovery doesn't give access to raw data on the sensit.io app. The app's API parses the raw bytes from Sigfox Cloud to present the data in a friendly interface.

The sensit.io dashboard

If you wish to view your raw data in the Sigfox Cloud, you need to first activate your Sens'it as a devkit. As a developer, you can request access to the Sigfox Cloud from the Sigfox Buy website: simply follow the instructions to activate the devkit. Once activated, you can browse your raw data, and enjoy devkit connectivity. 

Note that this will detach your Sens'it Discovery from the sensit.io app for now. 

Now that you have unlinked your Sens'it from sensit.io, it is up to you to create a link to a custom platform, using the callbacks on the Sigfox Cloud. The callback procedure is described in the document below. You now have two ways to view your data: Sigfox Cloud for the raw bytes, and sensit.io for the friendly interface.

If you wish to use the Sens'it data on your own platform, know that Sens'it uses a custom format for the data it sends over the Sigfox radio network. The data payload is detailed for both Sens'it 2 and Sens'it 3 Discovery in the documents below.

You can rely on the Sens'it Payload Parser and Serializer, an open-source project which works with both Sens'it 2 and Sens'it 3 Discovery payloads.

To go further, you can build your own firmware using the Sens'it SDK. See the next section.

Sens'it SDK

Sens'it is a configurable device: you can adapt it to many use cases and build your own usage. The number of sensors, along with its ability to communicate wherever there is Sigfox coverage, open it to a wide array of possibilities.   

About the Sens'it SDK

The Sens'it Software Development Kit (SDK) makes it possible for you to change the behavior of the Sens'it device. 

Using this SDK, you can:

  • Use multiple sensors at the same time,
  • Modify the data that is sent,
  • Change the way data is sent,
  • etc.

You'll find several sample files in the Sens'it archive, which you can download below.

The SDK contains all the information required to create your Sens'it-based application. The documentation provided in the Zip archive will also help you respect the Sigfox norms and usages. We invite you to open the README.txt file for an overview, and browse the auto-generated API doc for the full details. 

Upgrading your Sens'it

To use this SDK, you need to upgrade your Sens'it. This way, your Sens'it and your SDK will match.  

We strongly advise you to perform the upgrade step before you do anything else. If you don't, flashing a firmware built with this SDK will erase critical data on the device, essentially bricking it.  

The upgrade process is detailed in the README.txt file, found in the SDK archive.

License agreement

Please make sure to read the license agreement linked below. By downloading and/or using the SDK, you acknowledge that you have read and accepted the terms and conditions set in that document. The license agreement is also available in the SDK archive, in the 'doc' folder.

System requirements

The Sens'it SDK has been tested on Ubuntu, Mac OS X, and Windows.

It has been designed for both Sens'it 2 and Sens'it 3.

Downloading the SDK

The Sens'it Software Development Kit (SDK) contains the C code and makefile that will help you create your own applications for the Sens'it. 

The archive also contains the full API documentation.

By downloading the SDK archive, you accept the terms of use.

You need to sign up or log in to access to this information.

Sens'it Hardware

 The Sens'it device has several built-in sensors:  

  • temperature and humidity,
  • luminosity,  
  • accelerometer and magnetometer,  
  • button, 
  • reed switch (magnet detector).  

It also features two indicators:  

  • RGB led,
  • white led.  

Because it is an onboarding device, Sens'it must work on all Sigfox Radio Configurations (RCs). That's why we integrated a custom hardware radio implementation. This way, Sens'it can send messages in all RCs. All RC-specific signals are matched with a different "path". This path is software-configurable. The antenna is custom-designed by Sigfox. 

Both Sens'it 2 and 3 use the following components:

  • ST HTS221 for the temperature and humidity sensor,
  • LiteON LTR329 for the light detector,
  • NXP FXOS8700 for the accelerometer and magnetometer,
  • Coto CT10-1540-G4 for the reed swtich,
  • TI CC1125 for the RF transceiver,
  • STM 32F042 for the microcontroller unit (MCU).

Sign up or log in to get access to private resources.

Sensit.io webhooks

The brand new sensit.io website allows developers to rely on Webhooks for their notification system. 

What are Webhooks?

Webhooks make it possible to trigger an action in an automatic fashion, through custom callbacks. This way, developers can interact with third-party services through the Sens'it API. 

In the case of sensit.io, webhooks open all kind of new ways for Sens'it users to get notified, or simply to transfer parsed Sens'it data to third-party services using HTTP POST requests.

How to use webhook on sensit.io?

Webhook are implemented on the sensit.io app as a type of notification medium, in addition to email and SMS.

In the app, open the "Notifications" page and create a notification (or edit an existing one). In the notification setting page, the "Send via" section contains an "HTTP" switch, which you can click to open the webhook form.

Adding a webhook requires three information:

  • The URL of the targetted platform,
  • The headers for the HTTP request you want to send,
  • The body of the message being sent.

There is no one way to write your webhook: these three settings depend on the third-party services you are targetting. To know how to fill these fields, please refer to the service's own documentation on the topic.

Our templating engine, Nunjucks, which parses the body of your webhooks to replace values, also enables you to condition which information are printed and when. Read the Nunjunks templating documentation.

Get your Sens'it

Sens'it devices are usually given by Sigfox or Sigfox Operators (SOs) during tradeshows and IoT events.

Get your Sens'it.

If you need to buy small quantities of Sens'it devices (starting at 20 units), contact us directly. You must first connect with your Build account.

We are looking for new ways to make Sens'it widely available.

Sens'it Generic

Sens'it is also available as a fully customizable device (both firmware and casing design) through the Sens'it Generic offer.

Learn more on sensit.io.