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 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.
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:
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.
EXP Adapter Board
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
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.
STEP 2. Under My Products add the
RS9116W Evaluation Kit with EFR32MG21 by typing
RS9116 then selecting the kit.
The RS9116 Overview page should now display information about the RS9116 and EFR32MG21 kits.
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.
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.
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.
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.
Build, Run and Debug an Example Project on the Development Kit#
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).
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.
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.
Contains host MCU example projects. The example projects are divided into
Contains RS9116 firmware image
Contains platform specific source code for various available platforms. Other platforms can be supported by following the RS9116W SAPI Porting Guide.
Contains various resources for the example projects and sapi including device certificates and scripts.
Contains the source code files for the WiSeConnect™ Simple Application Programming Interface (SAPI).
Contains third party source code and tools such as freeRTOS, AWS SDK and more.
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:
Featured - Full featured projects that perform a key aspect of RS9116 evaluation or use-case. Featured examples are available directly from Simplicity Studio. Using a featured example is described in :Open a Featured Example Project in Simplicity Studio
Snippets - Smaller projects that focus on one particular feature or API. Snippets can be easily imported into Simplcity Studio as described in: Import Snippet Example Projects into Simplicity Studio.
AT commands - Pre-built Tera Term scripts used for evaluating the RS9116 directly from a PC. More details can be found in: Getting Started with RS9116 EVK and WiSeConnect™.
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
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
STEP 4. Ensure there are no unresolved settings then click