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.
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 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,
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.
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.
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.
WARNING: DO THE UPGRADE STEP FIRST. Sigfox cannot be held responsible if, by not upgrading, you destroy critical data in your Sens'it.
The Sens'it device has several built-in sensors:
- temperature and humidity,
- accelerometer and magnetometer,
- 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).
The brand new sensit.io website allows developers to rely on Webhooks for their notification system.
Webhooks are only available through the web application
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.
Sens'it devices are usually given by Sigfox or Sigfox Operators (SOs) during tradeshows and IoT events.
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 is also available as a fully customizable device (both firmware and casing design) through the Sens'it Generic offer.