Get started with your Akeru board * Register * Send an hello world message * Set up a callback * Downlink messages Go further

1. Workshop
SIGFOX MAKERS TOUR
USING AN AKERU DEV BOARD

2. Contribute back

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. Useful resources
Github
http://github.com/sigfox/makers-tour-resources
http://github.com.nicolsc
Add your own !
Q&A
http://sigfox.cloud.answerhub.com/

5. First steps
USING AN AKERU BOARD

6. Register
http://backend.sigfox.com/activate
Kit provider :
Country :
Device ID: sticker
PAC: check the list

7. HELLO WORLD

8. Hello World Sketch
Open the Arduino IDE
Select the board
Board type : Arduino Uno
Try one of the File > Examples samples

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

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

11. First callback

12. Callback setup
Device Type menu
Enter the Callbacks menu
Select new default callback

13. Callback setup

14. Callback setup
TYPE : DATA UPLINK
Choose a CHANNEL : URL | EMAIL
Email is good for a quick try
If you choose URL, you can then set the method, content-
type, and format the body as you wish

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

16. Downlink

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

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

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

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

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

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

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

24. Go further
USING AN AKERU BOARD

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

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

27. 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/