Wi-Fi Commissioning Micrium OS Example
This document describes how to connect the WF(M)200 Wi-Fi Expansion Board to Silicon Labs Starter Kit and run the Wi-Fi Commissioning example. The example is based on the combo capacity of the WF(M)200, meaning its ability to behave simultaneously as an Access Point and as a Station to demonstrate a typical use case of field deployment where an operator installs the device and configures it to connect to a specific Access Point using a Web page.
This demo runs the Wi-Fi Full MAC driver meant to communicate with the WF(M)200 Silicon Labs Wi-Fi transceivers.
- SoftAP: WF(M)200 configured in Wi-Fi Software-enabled Access Point mode
- Station: WF(M)200 configured in Wi-Fi Station mode
- AP: Any 'home network' or 'office network' Wi-Fi Access Point
- Device: The PC or phone used to access the demo
The WF(M)200 Wi-Fi Expansion Board contains a Wi-Fi module. To use the board, a MCU Starter Kit is required, where the MCU will be the host that communicates and controls the Wi-Fi module.
- One of the two Wi-Fi® expansion kits listed below:
WF200 Wi-Fi® Expansion Kit SLEXP8022A
WFM200 Wi-Fi® Expansion Kit SLEXP8023A
- One of the Silicon Labs Starter Kit natively supporting the connection with the WF(M)200 Wi-Fi Expansion Board:
EFM32 Giant Gecko GG11 Starter Kit – SLSTK3701A
EFR32MG Zigbee and Thread Starter Kit – SLWSTK6000B
The required software includes Simplicity Studio v5 and the Gecko SDK Suite (32-bit MCU SDK v6.0 or newer, Gecko Platform SDK v3.1 or newer, and Micrium OS Kernel SDK v5.10 or newer)
The example project and the Wi-Fi Full MAC driver (available in the Gecko Platform SDK)
The main software components used by this example are as follows:
Micrium OS Kernel, which is a Real-Time Operating System (RTOS) designed to run on Silicon Labs devices only. It is provided free of charge.
Lightweight IP (LwIP), which is an open-source TCP/IP stack licensed under the BSD license.
Set up Your Kit
Connect the WF(M)200 Wi-Fi Expansion Kit to the Silicon Labs Starter Kit.
Ensure that the power selector switch on the Silicon Labs Starter Kit is in the [AEM] position.
Set the power selector switch on the WF(M)200 Wi-Fi Expansion Board accordingly to your Silicon Labs Starter Kit. Please refer to the pictures below to know the switch position.
Set the communication interface switch to the [SPI] position (or [SDIO] if your Silicon Labs Starter Kit supports it and the WFx Bus SDIO component is installed).
Provide power by connecting the [DBG] USB connector on the Silicon Labs Starter Kit to the PC using the provided USB cable.
Install Simplicity Studio 5 and the SDKs
Simplicity Studio 5 is a free software suite needed to start developing your application. To install Simplicity Studio 5, follow this procedure by selecting the options [Install by connecting device(s)] and [Auto].
Get the Example
An SDK with a version 3.1 or higher is necessary. If this does not match your case, install it from the Simplicity Studio Installation Manager
Connect the Silicon Labs Starter Kit and open Simplicity Studio 5.
Select the [Launcher] perspective.
From the [Debug Adapters] panel on the left top corner, select your Silicon Labs Starter Kit.
Ensure that an SDK is selected in the [General Information] tile of the [Overview] tab.
Select the [EXAMPLE PROJECTS] tab in [Launcher] perspective.
Search for the example [Platform - Wi-Fi Commissioning Micrium OS Kernel] from the Software Examples list as illustrated in the image below. Notice the search field, which makes it easy to find the example by entering wi-fi.
Click on the [Create] button of the example.
Click on [Finish].
At the end of this procedure, Simplicity Studio has created the project in your workspace and your display will be similar to the picture below:
Studio 5 Created Project
Start the Example
Start a console in Studio with a right click on the Silicon Labs Starter Kit in the [Debug Adapters] panel and select [Launch console].
Select the [Serial 1] tab from the console window and make sure the console is connected. To do that, Check the icon in the bottom left corner of the console panel. If its status is console not connected. See the image below. Then, the serial console is not yet connected. Press [Enter] in the console, the icon should change its status to console connected. See the image below.
Compile the example. For more information about how to build a project, see a dedicated section of the Simplicity Studio 5 documentation.
See the Compilation Errors section if errors occur during the first compilation.
Open the Simplicity Flash Programmer. For more information about the Flash Programmer, see a dedicated section of the Simplicity Studio 5 documentation.
Browse to the wifi_commissioning_micriumos.hex file created in the build folder inside your workspace.
- Click on [Program] to flash the Silicon Labs Starter Kit with the example.
Logs appear in the console input field once the programming is done to look like the image below:
You are ready to move to the Wi-Fi commissioning demonstration page.