Silicon Labs UG454 User guide

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 
About this Document ............................................................................................................................................. 3 
Getting Started with STM32 and RS9116W EVK .................................................................................................. 4 
1  RS9116W Evaluation Kit Contents .................................................................................................................... 4 
2  RS9116W EVK Overview................................................................................................................................... 5 
2.1  The RS9116 WiSeConnect .................................................................................................................................... 5 
2.2  Hardware Details ................................................................................................................................................... 6 
2.3  Supported Interfaces ............................................................................................................................................. 6 
3  RS9116W Hardware Requirements ................................................................................................................... 7 
4  RS9116W Software Requirements .................................................................................................................... 8 
5  RS9116W SPI headers on the EVK ................................................................................................................... 9 
5.1  Header Pin Orientations......................................................................................................................................... 9 
5.2  Pin Description ...................................................................................................................................................... 9 
6  Interfacing the STM32 NUCLEO with RS9116W EVK ..................................................................................... 10 
6.1  Steps for Interfacing via SPI Interface. ................................................................................................................. 10 
6.2  Steps for Interfacing via UART Interface .............................................................................................................. 11 
6.3  10-pin SPI Header Connection Details ................................................................................................................. 11 
6.4  UART Connection Details .................................................................................................................................... 11 
6.5  GPIO Connection Details for ULP Power Save .................................................................................................... 12 
6.6  GPIO Connection Details For LP Power Save ...................................................................................................... 12 
6.7  For Host MCU-based Reset ................................................................................................................................. 12 
7  Getting Started with Keil IDE............................................................................................................................ 12 
7.1  Introduction to Keil ............................................................................................................................................... 12 
7.2  Steps for Executing STM32 Reference Projects on the Keil IDE ........................................................................... 13 
8  Getting Started with STM32CubeIDE .............................................................................................................. 22 
8.1  Please follow the below Steps for executing STM32 reference projects on STM32CubeIDE ................................. 22 
STM32 Reference Projects .................................................................................................................................. 34 
1  STM32 Reference Projects and Example Details ............................................................................................ 34 
1.1  1. Reference projects details ................................................................................................................................ 34 
1.2  2.Reference Examples Details ............................................................................................................................. 35 
2  Steps for Executing STM32 Examples using Master Application (Sample Project) ......................................... 35 
2.1  Steps for Keil IDE: ............................................................................................................................................... 35 
2.2  Steps for STMCube IDE ...................................................................................................................................... 40 
3  Reference Projects for Keil Baremetal ............................................................................................................. 44 
3.1  Example1: Throughput Application....................................................................................................................... 44 
3.2  Example2: Wireless Firmware Upgradation .......................................................................................................... 53 
3.3  Example3: WLAN Station BLE Bridge .................................................................................................................. 58 
3.4  Example4: WLAN Station BLE Provisioning ......................................................................................................... 73 
3.5  Example5: WLAN Standby Associated Power Save ............................................................................................. 83 
3.6  Example6: Enterprise Ping Client (eap) ................................................................................................................ 91 
3.7  Example7: BT_Alone ..........................................................................................................................................105 
3.8  Example8: AWS_IoT ..........................................................................................................................................112 
3.9  Example9: sample_project ..................................................................................................................................116 
3.10 Example10: udp_client .......................................................................................................................................117 
4  Reference Projects for Keil Freertos .............................................................................................................. 123 
4.1  Example1: mqtt_client ........................................................................................................................................123 
4.2  Example2 : wlan_https_bt_spp_ble_dual_role .....................................................................................................130 
4.3  Example3: wlan_https_bt_spp_ble_provisioning .................................................................................................137 
4.4  Example4: wlan_throughput_bt_spp_ble_dual_role.............................................................................................143 
4.5  Example5:sample_project ...................................................................................................................................148 
4.6  Example6: udp_client .........................................................................................................................................148 
5  Reference projects for Cube Baremetal ......................................................................................................... 148 
5.1  Example1:eap ....................................................................................................................................................148 
5.2  Example2: Firmware_Upgrade............................................................................................................................148 
5.3  Example3: Power_save ......................................................................................................................................148 
5.4  Example4: Wlan_ble ...........................................................................................................................................149 
5.5  Example5: sample_project ..................................................................................................................................149 
6  Reference Projects for Cube Freertos ........................................................................................................... 149 
6.1  Example1: wlan_https_bt_spp_ble_dual_role......................................................................................................149 
6.2  Example2: wlan_https_bt_spp_ble_provisioning .................................................................................................149 
6.3  Example3: wlan_throughput_bt_spp_ble_dual_role.............................................................................................149 
6.4  Example4: sample_project ..................................................................................................................................149 
FreeRTOS Porting for STM32 ............................................................................................................................ 150 
AWS SDK Porting for RS9116W SAPIS in STM32 ........................................................................................... 166 
Revision History ................................................................................................................................................. 173 
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

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.

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

2.6.5 GPIO Connection Details for ULP Power Save

Table 4: ULP Power Save Connections

RS9116 PWR SAVE

GPIOs

peripheral J9 Header

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.

Page is loading ...

Silicon Labs UG454 User guide

Silicon Labs UG454 User guide

Related papers

Other documents