ST Sigfox S2-LP User manual

Introduction
The STSW-S2LP-SFX-DK is an evaluation SW package for Sigfox networking with the S2-LP high performance, ultra-low power
RF transceiver. It is designed to operate in the majority of radio configuration zones (RCZ) described by Sigfox.
The STSW-S2LP-SFX-DK SW package supports the STEVAL-FKI868V1, STEVAL-FKI868V2, STEVAL-FKI915V1, X-NUCLEO-
S2868A2 and X-NUCLEO-S2915A1 kit platforms.
In addition, the package includes the STDES-MONARCH, the STEVAL-FKI001V1 and support for the STEVAL-IDB007V2 and
STEVAL-IDB008V2 (kits to be used in conjunction with the shields included in the above mentioned kits). The latter solution
enables the support for BlueNRG1/2 System-on-Chip alternatively to the STM32 microcontroller.
It provides an S2-LP Sigfox library with a complete set of APIs to develop embedded applications.
The S2-LP - Sigfox Demo GUI PC application provides an interactive interface to transmit messages to the Sigfox network and
program the STEVAL-FKI nodes with the Sigfox ID to set the node for network communication.
For details regarding the BlueNRG-1/-2 hardware and software development kit, refer to STSW-BLUENRG1/2-DK.
Getting started with the Sigfox S2-LP kit
UM2169
User manual
UM2169 - Rev 6 - March 2020
For further information contact your local STMicroelectronics sales office.
www.st.com

1Sigfox S2-LP kit content
The package includes:
• the Sigfox Demo GUI and corresponding firmware to:
– prepare the board with ID/PAC/Key from the pool assigned to ST devices (see Section 4 Demo
description)
– run a demo that transmits user defined messages to the Sigfox network (see Section 5 Push button
demo description)
• a framework to develop embedded Sigfox-enabled applications, with examples in the source code.
• an application note which describes the Sigfox firmware framework based on the S2-LP transceiver and on
both STM32 MCU and BlueNRG1/2 SoC, with guidelines on how to develop solutions that are optimized for
power.
• the Sigfox Flasher, a tool and related software APIs to store Sigfox credentials and manufacturing calibration
values (frequency offset and RSSI), in a secure way, into the MCU internal Flash.
UM2169
Sigfox S2-LP kit content
UM2169 - Rev 6 page 2/31

2Requirements
2.1 Hardware requirements
A Windows® PC with:
• 2 USB ports
• 135 MB free hard disk space
At least one of the following ST evaluation kits:
•STEVAL-FKI868V2 or X-NUCLEO-S2868A2 (for RC1, RC3, RC5 and RC6) kit with STM32 Nucleo-64
development board or STEVAL-IDB007V2/IDB008V2 board
•STEVAL-FKI915V1 or X-NUCLEO-S2915A1 (for RCZ2 and RCZ4) with STM32 Nucleo-64 development
board or STEVAL-IDB007V2/IDB008V2 board
•STEVAL-FKI001V1 development kit
2.2 Software prerequisites
• Microsoft Windows 7 or later
• Adobe Acrobat Reader 6.0 or later
• BlueNRG-1 ST-LINK-Utility
•STM32CubeProgrammer
One of the following integrated development environments (to develop embedded Sigfox-enabled applications):
1. IAR EWARM 8.32.1 or later
2. Keil MDK-ARM µVision 5.17 or later
UM2169
Requirements
UM2169 - Rev 6 page 3/31

3Board registration
3.1 ST-side registration
This registration procedure has to be performed only once via the ST GUI.
Step 1.
STM32 STEVAL-FKI001V1
Connect the STM32 Nucleo-64 development board to a PC
via USB. Windows should automatically recognize the board
as a hard drive
Figure 1. NUCLEO disk drive
Connect the STEVAL-FKI001V1 development board to a PC
via USB and connect an ST-Link programmer to the
JTAG/SWD connector.
Step 2.
STM32 STEVAL-FKI001V1
Flash the development board by simply dragging the
appropriate bin file (in the Binaries/Sigfox_CLI_Demo_Project
folder) to the NODE drive. Choose the bin file according to
your STM32 Nucleo-64 development board:
– SIGFOX_CLI_DEMO_NUCLEO_XX.bin
Open the BlueNRG-1 ST-LINK Utility and flash the
development board by simply dragging the
SIGFOX_CLI_DEMO_FKI001V1.hex file (in the Binaries/
Sigfox_CLI_Demo_Project folder) into the application window
and select [Target]>[Program] and then press [Start].
UM2169
Board registration
UM2169 - Rev 6 page 4/31

Step 3. Open the ST Sigfox GUI and the COM port associated with the development board.
Figure 2. Sigfox Demo GUI main window
UM2169
ST-side registration
UM2169 - Rev 6 page 5/31

Step 4. Click on the [Open] button.
If the board does not contain Sigfox data, a Board Preparation wizard appears.
Figure 3. ST Registration procedure 1/3
UM2169
ST-side registration
UM2169 - Rev 6 page 6/31

Step 5. Click the [Next] button
You will be prompted to complete a short form with your:
– name
– company name
– e-mail address
– radio configuration zone (RCZ) number
Note: You must specify the correct RC zone to avoid generating an incorrect ID. Please refer to https://
build.sigfox.com/sigfox-radio-configurations-rc for the updated list of Sigfox Radio Configuration (RC) zones.
Figure 4. ST Registration procedure 2/3
UM2169
ST-side registration
UM2169 - Rev 6 page 7/31

Step 6. Click on the [Generate mail] button
A window appears with the e-mail data you need to send.
Figure 5. Generated mail pop-up
Step 7. Send an email with the Destination Address, Subject and e-mail text shown in the popup window
You will receive an answer (at the e-mail address you specified previously) with an activation string
Step 8. Paste the activation string you receive in the text box and click Next
Figure 6. ST Registration procedure 3/3
UM2169
ST-side registration
UM2169 - Rev 6 page 8/31

Step 9. If the activation string is correct, the board is programmed with the Sigfox account data and the ID and
PAC is shown on the final page
The board is now ready and you can register the board in its own Sigfox backend
3.2 Sigfox side registration
Visit https://buy.sigfox.com/activate for ST development kit registration.
Step 1. Insert the country where the board should operate the ID and PAC of the board.
Step 2. Then fill a form to obtain an account on the sigfox backend.
An e-mail will be sent to the specified e-mail address.
Step 3. Choose a password and sign in to its own backend from https://backend.sigfox.com.
Step 4. Go to the DEVICE section.
This section provides a list of registered devices and other data.
Figure 7. Sigfox device page
Step 5. Click on the device ID to access a node summary page:
Figure 8. Sigfox device information
UM2169
Sigfox side registration
UM2169 - Rev 6 page 9/31

Step 6. Click on messages to show a list of all sent messages.
For each message, the following information is shown:
– the date and time
– the data in hex (so if the transmission occurred with the S2-LP Sigfox GUI, the data should be the
transmitted message in hex)
– the location of the node (link to a map)
– a link quality indicator (SNR bar)
Figure 9. Sigfox device messages
UM2169
Sigfox side registration
UM2169 - Rev 6 page 10/31