Sigfox discovery workshop using an Arduino MKRFOX board. * Getting started with the MKRFOX * Getting started with the Sigfox Cloud * First messages over the Sigfox network * Downlink feature * Callback settings * Events configuration * IFTTT demo * API configuration Session held in Cape Town on November 8th, 2017

1. Sigfox & Arduino
Workshop
Cape Town, November 8th, 2017

2. Contact
Head of Technology Adoption @Sigfox
nicolas.lesconnec@sigfox.com
Twitter : @nlesconnec

3. About the MKRFOX
Arduino+Sigfox starter kit

4. Overview
Product released spring 2017
Full sigfox service included
Cortex M0 MCU
Sigfox chipset : Atmel/Microchip ATA8520

5. Atmel/Microchip ATA8520
Compatible with Sigfox RC1 (Europe +
S.Africa)
Adressed using SPI
Datasheet : http://atmel.com

6. Setup the Arduino IDE
Select your board using the Tools > Port
menu
Set the board as Arduino MKRFOX1200

7. Retrieve your board information
Copy the code from http://github.com/sigfox/
mkrfox-init

8. Upload to your board & open the monitor

9. Online onboarding
http://backend.sigfox.com/activate/arduino/
Provider: Arduino
Country : !South Africa
ID/PAC : Retrieved before

10. Getting started
with Sigfox

11. Finding your way
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

12. List of your device types

14. Devices associated to a device type

15. Device information

16. Hello World
https://github.com/nicolsc/mkrfox-hello-world-bool
#include <SigFox.h>
void setup() {
Serial.begin(9600);while (!Serial){}
SigFox.debug();
Serial.println("Device IDt" + SigFox.ID());
delay(100);
SigFox.sendBit(1);
}
void loop(){}

17. Check device messages

18. Hello World (again)
https://github.com/nicolsc/mkrfox-hello-world
#include <SigFox.h>
void setup() {
SigFox.begin();
short valA = 7700;
float valB = 654.32;
SigFox.beginPacket();
SigFox.write(valA);
//SigFox.write(valB);
SigFox.endPacket();
}
void loop(){}

19. Set Callback (device type)

22. Advanced features

23. Topics
Downlink callback
API Access
Event monitoring
Geolocation callback
Advanced callbacks with custom payloads

24. Frame parsing

25. 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

28. 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();

29. Set a custom grammer
valA & valB are shorts : 16 bytes
valC is a 32 bytes float
valA::uint:16:little-endian
valB::uint:16:little-endian
valC::float:32:little-endian

30. Downlink

31. How does it work?
Downlink flag included in Sigfox message
20 sec after first frame transmission, the chipset
wakes up and waits for downlink response (25 sec
window)

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

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

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

35. Downlink callback
To send the response from your own server, change
the Downlink mode to CALLBACK
Then create a DATA > BIDIR callback
Make sure you comply with the expected JSON
format

36. API Access

37. Create credentials
Credentials are handled at the Group level
In your group, select API Access in the left panel
Click the New button in the top right corner
Select the rights (read, write) to grant

38. API Documentation
You now have an « API Documentation »
link next to your API Credentials
Documentation is tailored to the user rights
associated to each credential pair

39. API credentials

40. Get Device messages
GET Request to
https://backend.sigfox.com/api/
devices/{device}/messages

41. Curl example
curl -X GET
https://backend.sigfox.com/api/
devices/2C01C2/messages
--user {apiLogin}:{apiPassword}

42. Curl example
{"data":[{"device":"2C01C2","time":
1491779962,"data":"0123cafe","snr":"46.59","linkQuality":"E
XCELLENT","seqNumber":5,"rinfos":[{"tap":"10FC","delay":
1.6480000019073486,"lat":"-23.0","lng":"-43.0"},
{"tap":"10E9","delay":
0.7059999704360962,"lat":"-23.0","lng":"-43.0"}]}]}

43. Event monitoring

44. 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

45. 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

46. Geolocation
Callback

47. Geolocation Callback
⚠Under deployment in South Africa. Availability Q1
2018
Create a new Service > Geoloc callback
Use following URL to center the map:
https://maps.googleapis.com/maps/api/staticmap?center={lat},{lng}
&zoom=13&scale=1&size=600x300

49. Advanced Callbacks
with IFTTT

50. Advanced Callbacks
Goal: Save chipset temperature in a Google Drive
spreadsheet
How: Transfer message to IFTTT webhook and save
content to a linked GDrive spreadsheet

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

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

53. IFTTT Applet

54. IFTTT Applet

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

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

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

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