Hands On IoT Workshop, using an Arduino MKRFOX board (March 2019) First steps on the Sigfox network : * Send first messages * Use the Sigfox Cloud to check incoming data * Set up first callbacks to push data * Complex frame handling * Downlink communication * Event monitoring

1. Sigfox workshop
Copenhagen Business School
March 28, 2019

2. About me
Nicolas Lesconnec
Head of Technology Adoption @Sigfox
Email : nicolas.lesconnec@sigfox.com

3. What is Sigfox ?

4. CONFIDENTIAL
The first and global 0G Network
4
IoT
Bringing the 4th
industrial revolution to all sectors
BACK-UP BROADBAND
Secondary connectivity & additional services for systems using
broadband networks
0G
Cost
efficient
Low
Power
Global
Network

5. Sigfox architecture
x

6. They turn into actions
and insights
through the customer IT
They can be analyzed on
Big Data
analytics platforms
Devices integrate a
connectivity module
Partners with specific
applications for your
business
Interoperability with
top-tier Big Data
platforms
Ecosystem of
certified vendors
Royalty free
Standard and easy
access
Global network with
high capacity
Small messages
optimized for
sensor data
Devices send data Messages are
transmitted through the
sigfox network
They are stored in the
sigfox cloud
Sigfox architecture
6

8. High capacity

9. Small messages
1 % duty cycle for Objects
Up to 6 messages/hour
UPLINK
12-Byte payload
- Sensor data
- Event status
- GPS fix
- Application data
DOWNLINK
8-Byte payload
- Action / actuator trigger
- Device management
- Application parameter setting
10 % duty cycle for Base Stations
4 guaranteed downlink msg/day
SIGFOX
CLOUD

10. High Energy Efficiency
Designed to maximize
energy efficiency
No Pairing
10 to 50mA during a few
seconds (25mW; 14dB)
depending on the chip and
the size of the payload
Idle consumption: negligible
Idle state
Communication state
6 nA
30 mA
Current
Time
~6 sec
99.x% of the time
✓
✓
✓
✓

11. Security

12. Let’s play !

13. Platforms we will use
• Sigfox Cloud : https://backend.sigfox.com
• Online Arduino IDE : https://create.arduino.cc

14. Useful Resources
• Sigfox Build (documentation): http://build.sigfox.com
• Arduino MKRFOX: https://www.arduino.cc/en/Main.ArduinoBoardMKRFox1200
• Slack Community : https://sigfoxbuilders.herokuapp.com/
• Online Q&A http://ask.sigfox.com

15. Find your way in the Sigfox Backend
The Sigfox Cloud is organized around 3 concepts :
• Group : Contract & User rights
• Device Type : Family of devices sharing the same
properties
• Device : A unique device

16. List of your device types

18. Devices associated to a device type

19. Device information

20. Getting started with
the Arduino MKRFOX

21. Using the Arduino Online IDE
Create an account on
https://create.arduino.cc
Follow the instructions to install the
browser plugin

22. Board will show up in the menu

23. Setup the Arduino IDE
Select your board using the Tools > Port
menu
Set the board as Arduino MKRFOX1200
If board not present, add it using Boards Manager =>
search for MKRFox and install Arduino SAMD boards

24. Other option: install the IDE on your laptop
Download from
https://www.arduino.cc/en/Main/Software
You will need to install all drivers and
libraries

25. Setup the Arduino IDE
Install the following libraries (Sketch =>
Include Library => Manage Libraries)
• Arduino Sigfox for MKRFox1200
• Arduino Low Power
• RTCZero

26. Hello World

27. Hello World
Copy/paste from Github :
• https://github.com/nicolsc/mkrfox-hello-world
Upload to your board using the Arduino Editor or IDE

28. Message received ?
http://backend.sigfox.com
Navigate to the devices menu in the top bar
Click on the ID of your device
Enter the messages menu from the left navigation
column

29. Check device messages

30. Callback setup
Device Type menu
Click on your device type name
Enter the Callbacks menu
Select new default callback

35. Callback status
In the Devices > Messages panel, you have a indicator of the
callback status (an arrow)
Black : in progress
Green : Callback OK
Red : Callback KO (at least one of the callbacks failed)
Click the arrow to display details.

37. Frame parsing

38. Sigfox payload display feature
Using a « simple » grammar, you can ask
Sigfox to parse your incoming data
This is done at the device type level

41. Parsing the Hello World sample
Modify the sketch to send 3 values in a same message
short valA = 7700;
short valB = 128;
float valC = 654.32;
SigFox.beginPacket();
SigFox.write(valA);
SigFox.write(valB);
SigFox.write(valC);
SigFox.endPacket();

42. Set a custom grammar
valA & valB are shorts : 16 bits
valC is a 32 bits float
valA::uint:16:little-endian valB::uint:16:little-endian valC::float:32:little-endian

43. Get real world data
https://github.com/nicolsc/mkrfox-send-
internal-temperature

44. Downlink Callback

45. Bi-directional communication
Requested by the device to the network
Static downlink message size of 8 bytes
Agreed frequency of downlink
✓
✓
✓

46. Downlink Callback setup
Automatic callback: Device Type >
Informations > Edit
Set Downlink mode to DIRECT
Enter an 8 bytes value

49. Sample code
Simple change
SigFox.endPacket(); to
SigFox.endPacket(true);
This will request a response from the
network

50. Handle the response
https://github.com/nicolsc/mkrfox-downlink
void loop(){
while (SigFox.available()) {
Serial.print("0x");
Serial.println(SigFox.read(), HEX);
}
}

51. Geolocation

52. Geoloc callback
Simply create a SERVICE > GEOLOC
callback, and receive latitude + longitude +
accuracy

53. Geolocation Callback
Create a new
Service > Geoloc
callback
Use following URL
to center the map:
https://maps.googleapis.com/m
aps/api/staticmap?center={lat},{
lng}&zoom=13&scale=1&size=6
00x300&maptype=roadmap&for
mat=png&visual_refresh=true

54. Advanced Callbacks
with IFTTT

55. Advanced Callbacks
Goal: Save live information in a Google Drive
spreadsheet
How: Transfer message to IFTTT webhook and
save content to a linked GDrive spreadsheet

56. IFTTT?
IF this THEN that
Free service to create conditional
statements (no coding)

57. IFTTT Applet
Create new applet « IF Webhooks THEN Google
Spreadsheet »
Webhook: custom URL to listen to HTTP requests

58. IFTTT Applet

59. IFTTT Applet

60. IFTTT Applet
Value[1-3] are variables
forwarded by webhook
Value1 will contain Temp
Value2 will contain Light

61. Callback Configuration
Retrieve your IFTTT webhook URL here:
https://ifttt.com/maker_webhooks >
Documentation

62. Callback Configuration
Create a new Custom
Callback (> Device
Type)
Configure custom
payload , URL pattern
and JSON content

63. Running Demo App
Send a message
Check your Google Doc
has been
created/updated

64. Event monitoring

65. Monitor break in sequence number
New Event: Device > Event Configuration > New
Select Event Type « Out of message sequence »
Select « EMAIL » as channel and enter your email
address and email content

66. Monitor break in sequence number
Remove the antenna to simulate a coverage issue
Send a message
Re-attach the antenna and send a new message
Check reception of email notification

67. Thank you !
nicolas.lesconnec@sigfox.com