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,
This section gives you access to the SDK. It 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.
Your Sens'it can be registered as a devkit on Sigfox Buy so that you may access its data. The PDF file provided below contains the necessary procedure.
Sigfox Cloud is the central platform behind all Sigfox-connected solutions. Through it, solution providers can access information on messages from their devices: content, receiving base stations, date, etc. The device messages are available in raw form: it's up to you to turn it into data that is meaningful to you.
By default, a Sens'it uses a special format for data. That Payload (the content of a message) is then displayed on Sigfox Cloud. The PDF below shows you the way to properly decode the payload.
INFORMATION: Turning your Sens'it device into a devkit makes it lose its connection to sensit.io. To reinstate it, you must follow the Callback procedure, presented in the "Sensit.io App" section below.
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 sensit.io platform displays your device's data in a useful dashboard. The displayed data is retrieved from the Sigfox backend.
The Sigfox backend and Sens'it device communicate through a tool called Sigfox Callback. As a devkit, your Sens'it can set as many callbacks as needed.
Below is the procedure to configure both types of callback (uplink and downlink) to send data to sensit.io.
When sending data with your device, you must fractionate the information payload. The idea is to have the platform display compartmentalized pieces of data, for easier analysis.
You can find below documents explaining how the Sens'it payload is configured, and how to set your callbacks.
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.
The Sens'it 3 device is available since May 15th 2018, along with the Sens'it Discovery end-to-end solution.
Sens'it devices are usually given by Sigfox or Sigfox Operators (SOs) during tradeshows and IoT events.
DigiKey has a stock of Sens'it 3 for several Radio Configurations:
- RC1: Europe, Oman, Iran, South Africa, Tunisia, UAE
- RC2: USA, Mexico, Brazil
- RC3: Japan
- RC4: Australia, New Zealand, Singapore, Taiwan, Hong Kong, Colombia, Argentina, Costa Rica, Thailand, Malaysia, Ecuador, Panama, El Salvador
Yadom also sells Sens'it 3 for RC1.
You can still buy Sens'it 2 on the Conrad website in some European countries.
Check with your SO for local availability.
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.