This document provides information about a workshop on using Sigfox and The Things Network for IoT projects. It includes instructions on contributing experiments and code samples, available job opportunities, useful resources like documentation and GitHub repositories, how to register devices and use the The Things Network data management platform. It also covers sending "Hello World" messages over Sigfox, setting up callbacks, requesting and handling downlink messages, and an example sketch that sends random numbers to The Things Network analytics.

1. Workshop
AKERU + THETHINGS.IO

2. Contribute

3. Contribute
Don’t forget to publish your experiments
Code Samples, HW design, fails … will be useful to other
people
We all start by copy/pasting ;)
Your own website, github, hackster.io, instructables … your
call!

4. We’re hiring !
Maker In Residence
(internship)
Build useful and/or funny
prototypes
Test new hardware
Publish & document them
Field Evangelist Europe
Run workshops
Talk at conferences
Support the
community

5. Useful Resources
Workshop slides
http://bit.ly/SigfoxMakersTour
Q&A
http://
sigfox.cloud.answerhub.com/
Github
http://github.com/sigfox/makers-tour-resources
http://github.com/nicolsc
http://github.com/thethings/thethings.iO-Sigfox-SDK
Add your own !

6. Register
http://backend.sigfox.com/activate
Provider: Snootlab
Country : Ireland
Device ID: sticker on the board
PAC: check the list

7. The things.io
Data management platform
Free to use for attendees

8. thethings.iO analytics (1 of 3)
Go to https://sigfox.thethings.io

9. Register @ thethings.iO
https://sigfox.thethings.io
Register user
Create a Sigfox product

10. HELLO WORLD

11. Hello World Sketch
Open the Arduino IDE
Select the board
Board type : Arduino Uno
Port : USB-something

12. Hello World Sketch
#include <SoftwareSerial.h>
SoftwareSerial sigfox(5,4);
void setup(){
Serial.begin(9600);
sigfox.begin(9600);
sigfox.write("AT$SF=48 45 4c 4c 4f 20 57 4f 52 4c 44r");
}
void loop(){
while (sigfox.available()){
Serial.print(sigfox.read());
}
}

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

14. First callback

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

16. Callback setup
TYPE : DATA UPLINK
Choose a CHANNEL : URL (EMAIL for a quick test)
Url pattern: URL of your own server
Use HTTP method: GET/POST/PUT

17. 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
Click the arrow to display details.
KO means at least one of the callbacks failed

18. Downlink

19. How does it work ?
Send a message, with a downlink flag
Once message is sent, the module gets back to sleep
After 20s, it will wake up automatically, in Rx mode
It will wait 20s for a downlink message
Afterwards it will get back to sleep

20. Downlink setup
To setup an automatic callback :
Device Type > Info > Edit
In the Downlink data settings, set the following :
Downlink Mode : DIRECT
Set the following value : 123400000BADCAFE

21. How to request a downlink
Same AT command, with additional parameters
AT$SF=[hex byte]*, 2, 1

22. Handle the response
When entering Rx mode, the module will display
+RX BEGIN
Received frame (if any) will be displayed as:
+RX= [byte] [byte] [byte] [byte] [byte] [byte] [byte] [byte]
End of Rx mode
+RX END

23. Downlink callback
In Device Type > Info > Edit
change Downlink mode to CALLBACK
Create a new default callback, with TYPE : DATA |
BIDIR
Then set up your URL

24. Sample input output
AT$SF=55 50 4C 49 4E 4B, 2, 1
OK
+RX BEGIN
+RX=44 4F 57 4E 4C 49 4E 4B
+RX END

25. Sample code
Arduino
https://github.com/sigfox/makers-tour-resources/tree/
master/Akeru/downlink
Server side
https://github.com/nicolsc/sigfox-downlink
PR welcome in different languages

26. FIRST SKETCH
WITH THETHINGS.IO CODE

27. Random number Sketch
Download the akeru library inside thethings.iO sigfox github
and place it to your Documents > Arduino > Libraries folder.
Open the Arduino IDE
Copy & Paste thethings.iO Arduino code from thethings.iO
Sigfox github
Board type : Arduino Uno

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 Statistics menu from the left navigation
column

29. thethings.iO analytics (1 of 3)
Go to Things Manager > Product Details

30. thethings.iO analytics (2 of 3)

31. TheThings.io callback
TYPE : DATA UPLINK
Choose a CHANNEL : URL
Url pattern: Paste your subscription URL
Use HTTP method: POST

32. thethings.iO analytics (3 of 3)
Go to Cloud Code > Functions
Edit the sigfox_parser Function (thethings.iO
github)

33. thethings.iO analytics (3 of 3)
Make a cool dashboard!

34. Go further
USING AN AKERU BOARD

35. Other AT commands
AT&V : Detailed info about the module
AT$SF=[hex byte]* : Send a frame
ATS300=[int] Schedule the emission of a keep-alive frame every [int] hours
AT&W : Save settings
ATI26 :Module temperature in °C
ATI27 : Module idle power supply voltage

36. Other AT commands
Arduino sample code + link to full references of
the TD1208 module
https://github.com/sigfox/makers-tour-resources/tree/
master/Akeru/mirror

37. Use the module only
The module has a Cortex M3 than you can
reprogram
Checkout the TD Next website for instructions
http://rfmodules.td-next.com/sdk/

38. Keep in touch
Nicolas
nicolas.lesconnec@sigf
ox.com
twitter: @nlesconnec
Anthony
anthony.charbonnier@sigf
ox.com
twitter: @Anth0_
Carles & Bastian carles@thethings.io bastian@thethings.io
twitter: @thethingsiO