WGM160P: Micrium OS + LwIP Wi-Fi FMAC Driver Example
The WGM160P Wi-Fi Module Radio Board is the best and fastest way to explore the capabilities of the WGM160P Wi-Fi Module, composed of an EFM32GG11 and a WF200. The referred capabilities are the ability to connect to Wi-Fi networks, but also to provide an Access Point to which other devices can connect. The kit contains a module board that can be connected to a Silicon Labs Wireless STK baseboard (WSTK).
This document describes how to run an HTTP Server example that toggles the LEDs on a WGM160P Wi-Fi Module Radio Board and a Silicon Labs Wireless STK baseboard.
This demonstration 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 WGM160P Wi-Fi Module Radio Board is a standalone module that can run once powered up through the USB port, but a Silicon Labs Wireless STK baseboard (SLWSTK6121A) is necessary to download the module. It also offers all the possibilities provided by Simplicity Studio (download, debug, energy analyzer, ...).
The required software includes Simplicity Studio and the Gecko SDK Suite (32-bit MCU, Micrium OS Kernel, and lwIP).
The example project available at: https://github.com/SiliconLabs/wfx-fullMAC-tools
The Micrium OS Kernel is designed to run on Silicon Labs devices only and it is free of charge. Lightweight IP (lwIP) is an open-source TCP/IP stack licensed under the BSD license.
Set up your Kit
Connect the WGM160P Module Board to the Silicon Labs Wireless STK baseboard.
Ensure that the power selector switch on the Silicon Labs Wireless STK baseboard is in the [AEM] position.
Provide power by connecting the [DBG] USB connector on the Silicon Labs Wireless STK baseboard to the PC using the provided USB cable.
Install Simplicity Studio and the SDK
Simplicity Studio is a free software suite needed to start developing your application.
Download the latest version of Simplicity Studio from the following link: http://www.silabs.com/simplicity-studio.
Create a Silicon Labs account.
Register your EFM32 Starter Kit by entering the Serial Number found in the packaging.
In the Installation Manager, select the option [Install by Device].
Connect the EFM32 Starter Kit, select it from the panel [Connected Devices] and move it to the panel [Selected Devices]
Sign in with your Silicon Labs account credentials and install the Gecko SDK Suite including support for 32-bit MCU and Micrium OS Kernel.
Clone the GitHub Repository
The example is hosted at GitHub. To download a copy of the example, go to the following link: https://github.com/SiliconLabs/wfx-fullMAC-tools. Press the Green button [Clone or Download] on the right side to download the repository as a zip file.
After the download is complete, extract the zip file to a folder on your PC with a short name to avoid any issues with long path names (e.g. C:\).
Import the Project
The project shares most of the EFM32GG11 project, thus it must be imported in order to compile successfully the WGM160P project. If not already done, start by following steps to import the EFM32GG11 project.
Open Simplicity Studio and press [File -> Import…].
Click the link [More Import Options...].
Select the option [General -> Existing Projects into Workspace] and click the button [Next].
Select the root directory by browsing to the location where you extracted the repository.
Click the button [Finish].
If the previous steps were done correctly, Simplicity Studio will display the project in the [Project Explorer] as shown below:
Start the Example
Right-Click over the project name to open the context menu and select [Debug As] and then the option [Silicon Labs ARM Program] to Build the Project and Launch a Debug Session.
While the toolchain builds the project and launches the debug session, open the Device Manager in Windows OS to see the COM Port Number assigned to the USB device [J-Link CDC UART Port].
Open a Serial Terminal application, such as PuTTY, configure it to the COM Port Number you found in the previous step, and set the UART settings to 115200 bps, 8 data bits, 1 stop bit and no parity.
After the Debug session is launched, the IDE will switch to the [Debug] perspective and will halt the CPU at the main entry point. Press the key [F8] to Resume execution.
Watch the application’s progress on the Serial Terminal. Wait 5 seconds if you want to use the default settings. The application will go through the following stages before it is ready:
WF200 Micrium OS LwIP Example FMAC Driver version 2.3.1 WF200 Firmware version 3.3.0 WF200 initialization successful Press <Enter> within 5 seconds to configure the demo... AP started Join the AP with SSID: silabs_softap
You are ready to move to the Wi-Fi commissioning demonstration page.