Sigfox Workshop with Akeru & TheThings.io
2 likes1,078 views
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.
![How to request a downlink
Same AT command, with additional parameters
AT$SF=[hex byte]*, 2, 1](https://image.slidesharecdn.com/20160309-sigfoxakeruthethingsworshop-160309132838/85/Sigfox-Workshop-with-Akeru-TheThings-io-21-320.jpg)
![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](https://image.slidesharecdn.com/20160309-sigfoxakeruthethingsworshop-160309132838/85/Sigfox-Workshop-with-Akeru-TheThings-io-22-320.jpg)
![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](https://image.slidesharecdn.com/20160309-sigfoxakeruthethingsworshop-160309132838/85/Sigfox-Workshop-with-Akeru-TheThings-io-35-320.jpg)
Sigfox Workshop with 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
- 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 [email protected] [email protected] twitter: @thethingsiO