Page is loading ...
silabs.com | Building a more connected world. 1 | Page
PRELIMINARY | Subject to change.
UG454: RS9116W with STM32 User's Guide
Version 1.2
10/21/2020
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 2 | Page
PRELIMINARY | Subject to change.
Table of Contents
1 About this Document ............................................................................................................................................. 3
2 Getting Started with STM32 and RS9116W EVK .................................................................................................. 4
2.1 RS9116W Evaluation Kit Contents .................................................................................................................... 4
2.2 RS9116W EVK Overview................................................................................................................................... 5
2.2.1 The RS9116 WiSeConnect .................................................................................................................................... 5
2.2.2 Hardware Details ................................................................................................................................................... 6
2.2.3 Supported Interfaces ............................................................................................................................................. 6
2.3 RS9116W Hardware Requirements ................................................................................................................... 7
2.4 RS9116W Software Requirements .................................................................................................................... 8
2.5 RS9116W SPI headers on the EVK ................................................................................................................... 9
2.5.1 Header Pin Orientations......................................................................................................................................... 9
2.5.2 Pin Description ...................................................................................................................................................... 9
2.6 Interfacing the STM32 NUCLEO with RS9116W EVK ..................................................................................... 10
2.6.1 Steps for Interfacing via SPI Interface. ................................................................................................................. 10
2.6.2 Steps for Interfacing via UART Interface .............................................................................................................. 11
2.6.3 10-pin SPI Header Connection Details ................................................................................................................. 11
2.6.4 UART Connection Details .................................................................................................................................... 11
2.6.5 GPIO Connection Details for ULP Power Save .................................................................................................... 12
2.6.6 GPIO Connection Details For LP Power Save ...................................................................................................... 12
2.6.7 For Host MCU-based Reset ................................................................................................................................. 12
2.7 Getting Started with Keil IDE............................................................................................................................ 12
2.7.1 Introduction to Keil ............................................................................................................................................... 12
2.7.2 Steps for Executing STM32 Reference Projects on the Keil IDE ........................................................................... 13
2.8 Getting Started with STM32CubeIDE .............................................................................................................. 22
2.8.1 Please follow the below Steps for executing STM32 reference projects on STM32CubeIDE ................................. 22
3 STM32 Reference Projects .................................................................................................................................. 34
3.1 STM32 Reference Projects and Example Details ............................................................................................ 34
3.1.1 1. Reference projects details ................................................................................................................................ 34
3.1.2 2.Reference Examples Details ............................................................................................................................. 35
3.2 Steps for Executing STM32 Examples using Master Application (Sample Project) ......................................... 35
3.2.1 Steps for Keil IDE: ............................................................................................................................................... 35
3.2.2 Steps for STMCube IDE ...................................................................................................................................... 40
3.3 Reference Projects for Keil Baremetal ............................................................................................................. 44
3.3.1 Example1: Throughput Application....................................................................................................................... 44
3.3.2 Example2: Wireless Firmware Upgradation .......................................................................................................... 53
3.3.3 Example3: WLAN Station BLE Bridge .................................................................................................................. 58
3.3.4 Example4: WLAN Station BLE Provisioning ......................................................................................................... 73
3.3.5 Example5: WLAN Standby Associated Power Save ............................................................................................. 83
3.3.6 Example6: Enterprise Ping Client (eap) ................................................................................................................ 91
3.3.7 Example7: BT_Alone ..........................................................................................................................................105
3.3.8 Example8: AWS_IoT ..........................................................................................................................................112
3.3.9 Example9: sample_project ..................................................................................................................................116
3.3.10 Example10: udp_client .......................................................................................................................................117
3.4 Reference Projects for Keil Freertos .............................................................................................................. 123
3.4.1 Example1: mqtt_client ........................................................................................................................................123
3.4.2 Example2 : wlan_https_bt_spp_ble_dual_role .....................................................................................................130
3.4.3 Example3: wlan_https_bt_spp_ble_provisioning .................................................................................................137
3.4.4 Example4: wlan_throughput_bt_spp_ble_dual_role.............................................................................................143
3.4.5 Example5:sample_project ...................................................................................................................................148
3.4.6 Example6: udp_client .........................................................................................................................................148
3.5 Reference projects for Cube Baremetal ......................................................................................................... 148
3.5.1 Example1:eap ....................................................................................................................................................148
3.5.2 Example2: Firmware_Upgrade............................................................................................................................148
3.5.3 Example3: Power_save ......................................................................................................................................148
3.5.4 Example4: Wlan_ble ...........................................................................................................................................149
3.5.5 Example5: sample_project ..................................................................................................................................149
3.6 Reference Projects for Cube Freertos ........................................................................................................... 149
3.6.1 Example1: wlan_https_bt_spp_ble_dual_role......................................................................................................149
3.6.2 Example2: wlan_https_bt_spp_ble_provisioning .................................................................................................149
3.6.3 Example3: wlan_throughput_bt_spp_ble_dual_role.............................................................................................149
3.6.4 Example4: sample_project ..................................................................................................................................149
4 FreeRTOS Porting for STM32 ............................................................................................................................ 150
5 AWS SDK Porting for RS9116W SAPIS in STM32 ........................................................................................... 166
6 Revision History ................................................................................................................................................. 173
7 References .......................................................................................................................................................... 174
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 3 | Page
PRELIMINARY | Subject to change.
1 About this Document
This document provides the following information:
1. The RS9116W Module's Evaluation Kit (EVK)
2. Evaluating RS9116W EVK in WiSeConnect mode with Host MCU as STM32 NUCLEO-F411RE
3. RS9116W Interface pin configurations (for SPI, UART, and Power Save) with STM32
4. STM32 projects execution on the KEIL and STM32CubeIDE
Note: STM32 NUCLEO-F411RE will be referred to as STM32 or STM32 NUCLEO in further documentation
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 4 | Page
PRELIMINARY | Subject to change.
2 Getting Started with STM32 and RS9116W EVK
2.1 RS9116W Evaluation Kit Contents
The RS9116 Module Evaluation Kit comes with the following components:
1. RS9116 I/O Baseboard
2. RS9116 Wireless Daughter Card
3. Micro A/B-type USB cable
4. SDIO Connector*
5. SPI Connector
Note: The SDIO host interface is currently not supported
1) Single Band EVK:
The below image is for the RS9116 connectivity Single Band ( 2.4Ghz) Evaluation kit. This contains the SDIO adaptor
cable, SPI cable, IO baseboard, and Wireless daughter card.
Figure 1: Single band Evaluation Kit Contents
2) Dual Band EVK:
The below image is for the RS9116 connectivity Dual Band ( 2.4/5 GHz) Evaluation kit. This contains the SDIO
adaptor cable, SPI cable, IO baseboard, and Wireless daughter card.
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 5 | Page
PRELIMINARY | Subject to change.
Figure 2: Dual Band Evaluation Kit Contents
It is highly recommended to use the Micro A/B type USB cable that comes with the kit. If a longer cable is
needed, ensure to use a USB-IF certified cable which can supply a peak current of at least 500mA.
Note:
For WiSeConnect, the user needs only the Micro A/B-type USB cable and the SPI connector.
For n-link, the user needs only the Micro A/B-type USB cable.
Latest EVK user guide, firmware, and reference projects can be downloaded from our website:
https://docs.silabs.com/rs9116/
2.2 RS9116W EVK Overview
2.2.1 The RS9116 WiSeConnect
The RS9116 WiSeConnect module family is based on Silicon Labs RS9116 ultra-low-power, single spatial stream,
dual-band 802.11n + BT 5/BLE Convergence SoC. The RS9116 Module Evaluation Kit (EVK) is a platform for
evaluating the RS9116 modules with multiple Host Processors/MCUs over interfaces like SDIO*, USB, USB-CDC, SPI
and UART.
The EVK includes sample driver, supplicant, applications to test the following:
• Wireless Functionality for Wi-Fi, BT/BLE
• Wireless co-existence
• Security modes
• Throughputs
• Power Consumption
• Firmware Upgrade
Solution Highlights
• Offers WLAN, and Bluetooth protocols along with Wi-Fi Direct™, WPA/WPA2-PSK, WPA/WPA2-Enterprise (EAP-
TLS, EAP-FAST, EAP-TTLS, PEAP-MS-CHAP-V2, LEAP).
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 6 | Page
PRELIMINARY | Subject to change.
• Provides a feature-rich networking stack embedded in the device, thus providing a fully-integrated solution for
embedded wireless applications.
• Can be interfaced to 8/16/32-bit host processors through SPI, SDIO*, UART, USB and USB-CDC interfaces.
• Integrates a multi-threaded MAC processor with integrated analog peripherals and support for digital peripherals,
baseband digital signal processor, analog front-end, crystal oscillator, calibration OTP memory, dual-band RF
transceiver, dual-band high-power amplifiers, baluns, diplexers, diversity switch and Quad-SPI Flash thus
providing a fully-integrated solution for embedded wireless applications.
• Operates in industrial (-40°C to +85°C) temperature range.
• Choice of several module packages (with and without antenna) options depending on system requirements.
• Co-existence of multiple wireless protocols managed by an internal protocol arbitration manager.
2.2.2 Hardware Details
This section describes RS9116 EVK's various components and headers.
The OneBox-Embedded software for the WiSeConnect modules supports UART, SPI, USB and USB-CDC interfaces
to connect to the Host MCU.
As shown in the image below, the RS9116 EVK has four USB connectors for the Power, USB, USB-CDC and UART
connections. The UART signals of the module are converted to USB using an onboard circuit. The board also has
SDIO*/SPI Header.
2.2.3 Supported Interfaces
The board is designed to configure the EVK module to use the interface on which the power supply is detected. The
SDIO* and SPI interfaces require a power supply to be provided to the EVK module over the POWER port using a
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 7 | Page
PRELIMINARY | Subject to change.
USB cable. Hence, for these interfaces on the EVK module, it is required that the USB Power connection will be
provided first, followed by the SDIO* or SPI connection.
Follow the below steps to use the EVK module with different interfaces:
1. USB, UART, USB-CDC Modes
a. Connect the Micro A/B-type USB cable between a USB port of a PC/Laptop and the micro-USB port
labeled USB, UART or USB-CDC on the EVK.
2. SPI Mode
a. Connect the Micro A/B-type USB cable between a USB port of a PC/Laptop and the micro-USB port
labeled POWER on the EVK.
b. Connect the 10-pin header of the SPI Adaptor Cable to the EVK. Connect the other wires of this
connector to the SPI signals of a Host MCU platform. The details of the SPI header are given in
RS9116W SPI headers on the EVK.
3. SDIO Mode*
a. Connect the Micro A/B-type USB cable between a USB port of a PC/Laptop and the micro-USB port
labeled POWER on the EVK.
b. SDIO* adaptor cable connector has two ends. Connect the one end 10-pin header of the SDIO* Adaptor
Cable to the EVK module. And Connect the other end of the connector to the SDIO* signals of the Host
MCU platform. The details of the 10-pin Header are given in the following sections.
4. ISP Switch
ISP switch shall be used for In-system programming firmware downloading utility.
Make sure the ISP switch is in the OFF state. If it is ON state you will not get the boot loader messages.
There is a 2-pin inline jumper available for measuring the current being sourced by the module during different stages
of operation. This is labeled as "MEASUREMENT" on the baseboard. The user may connect a power meter or an
ammeter to this jumper to measure the current.
*The SDIO host interface is currently not supported.
Note
If the baseboard Rev is 1.1 or below, then follow the below procedure:
1. For SDIO*/SPI, insert the USB into the Power port first before the SDIO*/SPI connector is connected to the
Host platform.
2. For USB and USB-CDC, please connect the USB port to the Host platform first before connecting the USB for
the Power port.
2.3 RS9116W Hardware Requirements
RS9116W EVK
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 8 | Page
PRELIMINARY | Subject to change.
STM32 NUCLEO-F411RE board
(not included in EVK Kit)
Click here for Specifications
SPI Cable
Two Micro A/B-type USB Cables
(One Micro A/B-type USB cable to connect between PC and STM32 board)
( Second cable connect between PC and EVK power port)
Access point (2.4GHz)
802.11 b/g/n compliant Wi-Fi AP
For STM32CubeIDE: Integrated development environment
PC with 64 bit Windows OS (x86 arch). Cube IDE works only on 64-bit systems.
For Keil IDE:
PC with 64 bit Windows OS (x86 arch).
Note
All the user documents, firmware release packages, certifications of the module and other materials related to
the RS9116 based Modules are available on the website https://docs.silabs.com/rs9116.
2.4 RS9116W Software Requirements
Requirement for STM32CubeIDE
1. STM32CubeIDE v1.0.2
2. Java Platform SE binary (x86 only)
Requirement for Keil IDE
1. Keil uVision5 v5.24.2.0
Other Third-Party Software
1. iperf
2. Python 2.7.0
3. STMCubeMX
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 9 | Page
PRELIMINARY | Subject to change.
2.5 RS9116W SPI headers on the EVK
2.5.1 Header Pin Orientations
Figure 3: SPI header Pin Orientations
2.5.2 Pin Description
Table 1: SPI Header Pins
Pin
Number
Pin Name
Direction
Description
1
NC
-
This pin must be left open.
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 10 | Page
PRELIMINARY | Subject to change.
Pin
Number
Pin Name
Direction
Description
2
SPI_CS
Input
SPI slave select from the host (active low)
3
GND
-
Ground
4
VDD
-
Supply voltage
5
SPI_CLK
Input
Serial clock input from the host. The clock can be up to 80 MHz
6
GND
-
Ground
7
SPI_MOSI
Input
SPI data input
8
SPI_MISO
Output
SPI data output
9
SPI_INTR
Output
Active high-level triggered interrupt, used in SPI mode. The interrupt is raised by the
EVB to indicate there is data to be read by the Host.
10
NC
-
No Connection
Note
Signal Integrity Guidelines for SPI/SDIO interface: Glitches in the SPI/SDIO clock can potentially take the
SPI/SDIO interface out of synchronization. The quality and integrity of the clock line need to be maintained. In
case a cable is used for the board to board connection, the following steps are recommended (please note that
this is not an exhaustive list of guidelines and depending on individual cases additional steps may be needed.):
1. Minimize the length of the SPI/SDIO bus cable to as small as possible, preferably to within an inch or two.
2. Increase the number of ground connections between the EVB and the Host processor PCB.
2.6 Interfacing the STM32 NUCLEO with RS9116W EVK
2.6.1 Steps for Interfacing via SPI Interface.
1. Connect the RS9116W EVK to the STM32 NUCLEO board using the 10-pin SPI header connector.
2. Connect the STM32 with Mini USB cable to the Windows PC.
With this connection, STM32 is powered-up and also power-up the 9116EVK via SPI connected.
3. It is also recommended to power-up the RS9116 EVK by connecting the USB cable between the PC and POWER
interface of the 9116 EVK.
Now the STM32 NUCLEO board is operational to execute projects using STM32CubeIDE or Keil IDE on the
Windows PC.
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 11 | Page
PRELIMINARY | Subject to change.
Figure 4: STM32 NUCLEO Board with RS9116W EVK
2.6.2 Steps for Interfacing via UART Interface
1. Connect the RS9116W EVK to the STM32 NUCLEO board using the GPIO peripheral card.
2. Connect the STM32 with Mini USB cable to the Windows PC.
With this connection, STM32 is powered-up and also power-up the 9116EVK via the UART connected.
3. It is also recommended to power-up the RS9116 EVK by connecting the USB cable between the PC and POWER
interface of the 9116 EVK.
Pin Interfacing details - RS9116 EVK to STM32
2.6.3 10-pin SPI Header Connection Details
Table 2: SPI Connections
RS9116 EVK
SPI J4 Header Pin #
STM32 Nucleo
CN10 Header Pin #
Function
2
17
CS
3
9
GND
4
7
VCC
5
11
CLK
7
15
MOSI
8
13
MISO
9
21
INT
2.6.4 UART Connection Details
With GPIO peripheral Card on RS9116W EVK and with RS9116W Module
Table 3: UART Connections
RS9116 EVK
GPIOs peripheral
J1 Header Pin #
RS9116 Module
STM32 Nucleo
CN10 Header Pin #
Function
11
GPIO_8
21
TX
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 12 | Page
PRELIMINARY | Subject to change.
RS9116 EVK
GPIOs peripheral
J1 Header Pin #
RS9116 Module
STM32 Nucleo
CN10 Header Pin #
Function
13
GPIO_9
33
RX
GND
GND
GND
GND
2.6.5 GPIO Connection Details for ULP Power Save
Table 4: ULP Power Save Connections
RS9116 PWR SAVE
GPIOs
peripheral J9 Header
Pin
STM32 Nucleo
CN10 Header
Pin #
Function
Comment
UULP_2
2
GPIO
UULP_0
4
GPIO
RS9116 EVK Rev 1.4 Base Board + Rev 1.5 Daughter Board
and above version
UULP_3
RS9116 EVK Below Rev 1.4 Base Board + Rev 1.5 Daughter
Board
2.6.6 GPIO Connection Details For LP Power Save
Table 5: LP Power Save Connections
RS9116 PWR SAVE GPIOs
peripheral
J9 Header Pin
STM32 Nucleo
CN10 Header
Pin #
Function
Comment
UULP_5
2
GPIO
UULP_0
4
GPIO
RS9116 EVK Rev 1.4 Base Board + Rev 1.5 Daughter
Board and above version
UULP_3
RS9116 EVK Below Rev 1.4 Base Board + Rev 1.5
Daughter Board
2.6.7 For Host MCU-based Reset
Table 6: MCU-based Reset
RS9116 PWR SAVE GPIOs
peripheral J9 Header Pin
STM32 Nucleo
CN10 Header Pin #
Function
Comment
RST_PS
6
RESET
Reset from the host via GPIO
2.7 Getting Started with Keil IDE
2.7.1 Introduction to Keil
Keil MDK is the software development environment for a wide range of Arm Cortex-M based microcontroller devices.
It includes the µVision IDE and debugger, ARM C/C++ compiler, and essential middleware components. KEIL IDE
supports Windows OS only.
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 13 | Page
PRELIMINARY | Subject to change.
2.7.2 Steps for Executing STM32 Reference Projects on the Keil IDE
1. Connect the setup environment of RS9116 EVK and STM32 NUCLEO with the PC
a. Make sure SPI cable connected between RS9116 EVK and STM32 board
b. Connect the STM32 board power port to the PC (via USB cable)
c. It is recommended to connect the POWER port of RS9116 EVK to the PC (via USB cable)
2. Download and Install KEIL IDE from the below link.
https://www.keil.com/demo/eval/arm.htm#/DOWNLOAD
Please note the above downloaded Keil IDE is for Evaluation purposes only and the usage is limited to 32KB
program sizes. This Keil Evaluation version is not sufficient to compile and build STM32 projects.
So Please get the licensed version of the KEIL IDE to execute STM32 Reference projects and Examples in the
package.
3. Navigate to the below Release package link for accessing Keil projects.
RS9116.NB0.WC.GENR.OSI.x.x.x.xx\host\platforms\STM32\Reference_Projects\Keil_Baremetal\Projects\SPI
Open any project folder (in the SPI folder) as per the user requirement and double-click the ".uVision5 Project"
and then it will be redirected to KEIL IDE for viewing the project source.
Note: Keil_Baremetal projects are non-OS based projects.
4. Please follow Steps 5 to 13 for settings project configuration for any Keil project.
Please follow Steps 14- 16 for Compile/building the project and then debug on the STM32 target.
5. Click on the 'Options for Target icon'. after a click, one popup window will open. and then click on the 'Device' icon
and select the device STM32F411RE. Only need to select device STM32F411RE if earlier not included in the
project.
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 14 | Page
PRELIMINARY | Subject to change.
6. Then click on the 'Target' icon. Update the Xtal frequency according to requirements. by default it is 25MHz. Also,
verify the Read/Write Memory Area section.
7. Then click on the 'Output' icon. Enter the Executable name and then select the 'Create Executable:' option as
shown below Image.
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 15 | Page
PRELIMINARY | Subject to change.
8. Then click on the 'Listing' icon. Select the 'Assembler Listing' option and also select the 'Linker Listing' section as
shown below Image.
9. Then click on the 'User' icon and set as per the below image.
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 16 | Page
PRELIMINARY | Subject to change.
10. Then click on the 'C/C++' icon. Refer to the Preprocessor symbols, Update the pre-defined Macros provided in the
'Define' section if needed. It's depending on the application requirement.
For Ex: If anyone working with SPI communication then needs to enable 'RSI_SPI_INTERFACE', for WIFI needs
to enable 'RSI_WLAN_ENABLE' etc.
Optimization settings:
If the user doesn't have a valid Keil license but has an Evaluation copy then KEIL might produce a Code size limit
error while building STM32 projects/examples.
With the Evaluation version, the user can try with optimization level (level 2/3) to avoid the Code size limit
error. Still, the optimization level will not ensure the proper building of the STM32 projects. The final
recommendation is to get a valid Keil license.
11. Then click on the 'Linker' icon and verify it as per the below image.
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 17 | Page
PRELIMINARY | Subject to change.
12. Then click on the Debug icon, and select the 'ST-Link Debugger' for debugging.
Then click on the Settings. the 'Cortex-M Target Driver setup' window will open. In this window, 'Debug Adapter'
sub-section, select 'Unit' as 'ST-LINK/V2-1'.
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 18 | Page
PRELIMINARY | Subject to change.
Then
click on the 'Trace' icon and verify the below display setting in the image.
Then
click on the 'Flash Download' icon and verify the setting as per the below image.
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 19 | Page
PRELIMINARY | Subject to change.
Then click on the 'Pack' icon and verify the setting as per the below image. and then click on 'OK'.
13. Then click on the 'Utilities' icon and verify the setting as per the below image. and then click on 'OK'.
UG454: RS9116W with STM32 User's Guide
Version 1.2
silabs.com | Building a more connected world. 20 | Page
PRELIMINARY | Subject to change.
14. In the Project workspace, click on the Build icon to build the project. Refer to the highlighted part in the
screenshot.
The project compiles and builds without errors then moves to the next step. In case of build errors, then correct
them and rebuild the project.
Note:
While building the project, Incase if the user observes the below template of the error then the issue is there with a
longer project path. To avoid this error during the building, please keep the Release package content in the
shorter path.
/
