Getting Started with an EFx32 Host#

This guide describes how to get started developing a RS9116W application on an EFx32 embedded host MCU using the WiSeConnect™ Simple Application Programming Interface (SAPI). For quick evaluation using only the EVK and a PC instead see Getting Started with PC using AT Commands.

Getting Started MCU Block DiagramGetting Started MCU Block Diagram

Getting started with application development on an EFx32 involves the following steps:

Download and Install Simplicity Studio#

Simplicity Studio is available for download at www.silabs.com/simplicity-studio. The steps outlined in this getting started guide require Simplicity Studio version 5.1.2 or later.

During installation, be sure to install the Technology Type: 32-Bit Microcontrollers. More details can be found at Simplicity Studio Installation Instructions


Note! The WiSeConnect™ Software Driver Package is automatically downloaded by Simplicity Studio. More details can be found in the section, Explore the WiSeConnect™ Software Driver Package.


Choose a host MCU Development Board#

The example projects provided with the WiSeConnect™ Software Driver Package are designed to work out-of-the-box with the EFR32MG21 Wireless Starter Kit (SLWSTK6006A) and the RS9116 Wi-Fi + Bluetooth Development Kit. Project files are provided for both the EFR32MG21 radio board version A (BRD4180A) and version B (BRD4180B)

The WiSeConnect™ driver software also works with other embedded host MCUs. Details on porting the driver to other host MCUs can be found in the RS9116W SAPI Porting Guide.

Update the RS9116W Firmware#

When you first receive a RS9116 EVK, or when updating to a new version of the WiSeConnect™ Software Driver Package, we recommend updating the RS9116W firmware to the latest available version. There are several ways to update firmware, but the recommended method to get started is outlined in the section, Updating RS9116W Firmware.


Note!
Disconnect the RS9116 EVK from the host MCU board before updating the firmware, the host MCU connections may interfere with the update process.


Connect the RS9116 EVK to the host MCU development board#

Connect the EFR32 Starter Kit, EXP adapter board and RS9116 EVB as illustrated in the following picture:

EFR32 STK to RS9116 EVK ConnectionsEFR32 STK to RS9116 EVK Connections


Note! The EXP adapter board is included in the RS9116 Evaluation Kit. If you have an older RS9116 Evaluation Kit that does not include the EXP adapter board, please request one through your local sales representative.


STEP 1. Connect the EXP adapter board to the EFR32 starter kit EXP header.

STEP 2. Connect the EXP adapter board to the SDIO/SPI connector of the RS9116 EVK using the 10-pin ribbon cable provided with the RS9116 EVK.

STEP 3. Connect the RST_PS pin on the RS9116 EVK to the pin labeled 11 on the J4 header of the EXP adapter board using a jumper wire.

STEP 4. Set the ISP switch on the RS9116 EVK to the OFF position.

STEP 5. Connect the RS9116 EVK to a PC using the USB interface labeled POWER. Note that this connection only provides power to the EVK. There is no USB communication over this connection.

STEP 6. Connect the EFR32 Starter Kit to a PC using the Mini USB connector on the EFR32 Starter Kit.

Complete hardware details of the RS9116 EVK can be found in the RS9116 EVK User's Guide.

Power Save GPIO Connections#

The instructions above enable basic operation between the host MCU and RS9116. Some low power examples require additional connections of the Ultra Low Power (ULP) GPIOs as detailed in the table below. These details are valid for any example provided in the WiSeConnect™ SDK unless otherwise noted in the readme documentation of a particular example.

Signal Name

EXP Adapter Board

RS9116 EVK

Notes

UULP_0 / UULP_3

J4 Pin 9

J9 Pin 5

If using a RS9116 EVK version 1.4 or newer connect UULP_0. Otherwise connect UULP_3

UULP_2

J4 Pin 7

J9 Pin 4


Note! The EXP Adapter Board pins referenced in the table above may differ for other EFx32 hosts.


Open a Featured Example Project in Simplicity Studio#

The WiSeConnect™ SDK includes a number of examples that are featured in Simplicity Studio. A list of the featured examples along with documentation detailing the operation each example can be found in: Featured Examples. More details on the contents of the software package can be found in: Explore the WiSeConnect™ Software Driver Package.

STEP 1. Open Simplicity Studio and navigate to the Launcher perspective.

Simplicity Studio LauncherSimplicity Studio Launcher

STEP 2. Under My Products add the RS9116W Evaluation Kit with EFR32MG21 by typing RS9116 then selecting the kit.

Simplicity Studio My ProductsSimplicity Studio My Products

The RS9116 Overview page should now display information about the RS9116 and EFR32MG21 kits.

Simplicity Studio Kit OverviewSimplicity Studio Kit Overview

STEP 3. With the product RS9116W Evaluation Kit with EFR32MG21 selected, navigate to the example projects by clicking on Example Projects & Demos then filter by the RS9116 WiSeConnect SDK as shown below.

Simplicity Studio Example ProductsSimplicity Studio Example Products


Note! The RS9116W Evaluation Kit with EFR32MG21 that was added in the previous step specifies the EFR32MG21 radio board version B (BRD4180B). If instead you are using a EFR32MG21 radio board version A (BRD4180A) then, prior to selecting an example project, you must select the board under Debug Adapters as shown below.


Simplicity Studio Debug Adapter BRD4180ASimplicity Studio Debug Adapter BRD4180A

STEP 4. Click the Create button for the project that you wish to open. This will display the New Project Wizard which will allow you to rename your project, choose the location of your project and select whether you want the project files linked to the original location or copied into the new project location. Typically, the default settings should be used for all options. Click Finish to exit the wizard and create the new project.

Simplicity Studio New Project WizardSimplicity Studio New Project Wizard


Note! The mention of "SDK" in the New Project Wizardand in the Simplicity IDE refers to the EFR32 platform SDK known as the Gecko SDK (GSDK) and not the RS9116 WiSeConnect™ SDK.


STEP 5. After creating the project, Simplicity Studio will launch the Simplicity IDE allowing you to build, run and debug the project.

Simplicity Studio IDE with New ProjectSimplicity Studio IDE with New Project

Build, Run and Debug an Example Project on the Development Kit#

Simplicity Studio Build Debug Program ToolbarSimplicity Studio Build Debug Program Toolbar

You can flash, run and debug the newly created example project simply by clicking on the Debug icon in the Simplicity IDE toolbar. This will build the project, flash it onto the attached STK and open the Debugger Perspective. Unless configured otherwise, the debugger will automatically break execution at the beginning of main allowing the user to step, run, or otherwise debug the application. More details on using the debugger tools can be found at: Using the Debuggers.

To build the project without flashing and executing it, simply click on the Build icon in the Simplicity IDE toolbar. This will build the selected default configuration (debug or release).

A pre-built image can be programmed onto a device using the Flash Programmer which is available by clicking the Program icon in the Simplicity IDE toolbar.

Example specific details such as how to configure and operate the example can be found in Example Applications. The same information is also available in the readme file available with the example project source code.

Explore the WiSeConnect™ Software Driver Package#

Simplicity Studio automatically downloads the official WiSeConnect™ SDK repository from the Silicon Labs GitHub space. Therefore no action is required to integrate the software into Simplicity Studio.

For advanced situations, the integration between Simplicity Studio and the The WiSeConnect™ SDK GitHub repository can be managed using the External Repos settings in Simplicity Studio. To view or edit the external repos settings go to Preferences > Simplicity Studio > External Repos as shown below. Here you can add, edit, update, or remove repos. You can also select a specific branch, tag or a commit that you would like to use.

Simplicity Studio External Repo SettingsSimplicity Studio External Repo Settings

Once downloaded, Simplicity Studio will store the repository in the Simplicity Studio installation folder under ./developer/repos. On a Windows PC this is typicall found at C:\SiliconLabs\SimplicityStudio\v5\developer\repos. You can explore the WiSeConnect™ SDK here.


Note! Simplicity Studio will not download the full contents of the WiSeConnect™ SDK GitHub repo until the user opens one of the features example projects as described in: Open a Featured Example Project in Simplicity Studio


The WiSeConnect™ SDK is organized into the main folders described below.

Folder

Description

examples

Contains host MCU example projects. The example projects are divided into featured, snippets and at_commands as described below in Example Project Types.

firmware

Contains RS9116 firmware image

platforms

Contains platform specific source code for various available platforms. Other platforms can be supported by following the RS9116W SAPI Porting Guide.

resources

Contains various resources for the example projects and sapi including device certificates and scripts.

sapi

Contains the source code files for the WiSeConnect™ Simple Application Programming Interface (SAPI).

third party

Contains third party source code and tools such as freeRTOS, AWS SDK and more.

utilities

Contains varous utilities useful for evaluation and application developent.

Example Project Types#

The examples included in the WiSeConnect™ SDK are divided into the following types:

Import Snippet Example Projects into Simplicity Studio#

Snippet example projects are available in the WiSeConnect™ SDK in the subfolder folder ./examples/snippets. More information about the location of the WiSeConnect™ SDK, the folder structure and the example types can be found in: Explore the WiSeConnect™ Software Driver Package.

Snippet example projects can be easily imported into Simplicity Studio using the steps below:

STEP 1. Select File > Import ... from the Simplicity Studio menu.

STEP 2. Click Browse and navigate to the projects folder in the snippet example that you are wanting to import. In this example we are using the WLAN Station Ping example found at C:\SiliconLabs\SimplicityStudio\v5\developer\repos\wiseconnect\examples\snippets\wlan\station_ping\projects.

Simplicity Studio Import Project WizardSimplicity Studio Import Project Wizard STEP 3. The project names include the EFx32 board number associated with the project (e.g. brd4180a). Select the project associated with the the board you are using and click Next.

Simplicity Studio Import Project WizardSimplicity Studio Import Project Wizard STEP 4. Ensure there are no unresolved settings then click Next

Simplicity Studio Import Project WizardSimplicity Studio Import Project Wizard

STEP 5. Click Finish. The Simplicity IDE will be displayed with the imported project. You can now build, run and debug the project.

Simplicity Studio IDE with Imported ProjectSimplicity Studio IDE with Imported Project