Silicon Laboratories BGTool WGM110 Bedienungsanleitung
UG160: Wizard Gecko BGTool™ User's
Guide
This user's guide walks you through the basic uses of the BGTool. This
tool allows the developer to quickly test and evaluate Silicon Lab’s Wiz-
ard Gecko Wi-Fi® Module and its features.
KEY POINTS
•Setting up BGTool
• BGTool walkthrough
• Practical configuration examples
silabs.com | Building a more connected world. Rev. 1.2
Table of Contents
1. Introduction ................................1
1.1 Compatible Products ...........................1
1.2 Notations Used in This Guide ........................1
2. Preparations ...............................2
2.1 Preparing the Wizard Gecko Module Wireless Starter Kit (WSTK) ............2
2.2 Installing the Driver ............................3
3. Using BGTool Software ...........................4
3.1 Connection Setup View...........................4
3.2 Log View ...............................5
3.3 Device Details View ............................6
3.4 Network View ..............................7
3.4.1 Network View - Access Point Mode (AP) ....................8
3.4.2 Network View - Station Mode (STA) ......................10
3.4.3 Certificate Management ..........................11
3.5 Data Routing View ............................12
3.5.1 DNS Look-up .............................12
3.5.2 Add Endpoints .............................13
3.5.3 Data View ..............................14
3.6 mDNS View ..............................14
3.7 Persistent Store View ...........................15
3.8 I/O Ports View ..............................16
3.9 Peripherals View .............................18
3.10 Firmware Update View ..........................19
4. Examples ................................ 21
4.1 Starting the Module in Wi-Fi Access Point Mode ..................21
4.2 Turning on the LEDs in WGM110 WSTK .....................21
4.3 Capturing Button Clicks on the WGM110 WSTK ..................23
4.4 TCP Server Example ...........................23
4.4.1 Creating a Wi-Fi Access Point ........................23
4.4.2 Creating a TCP Server ..........................24
4.4.3 Creating a TCP Connection ........................24
4.4.4 Checking the TCP Connection Status .....................24
4.4.5 Transmitting Data ............................25
5. Revision History .............................26
5.1 Revision 1.2 ..............................26
5.2 Revision 1.1 ..............................26
5.3 Revision 1.0 ..............................26
silabs.com | Building a more connected world. Rev. 1.2
1. Introduction
BGTool is a simple terminal type user interface application that allows a developer to quickly test and evaluate Silicon Lab’s Wizard
Gecko Wi-Fi Module. The main purpose of the BGTool is to hide the complexity of the BGAPITM binary protocol used by the host to
control the Wi-Fi software running on the WGM110 Module. It offers a more user-friendly approach to the BGAPI protocol. BGTool can
also be used effectively for quick prototyping and debugging of Wi-Fi applications. This user's guide walks you through the basic uses
of BGTool.
The BGTool user interface philosophy is to allow the developer to reproduce and trigger the individual BGAPI defined protocol com-
mands, results, and events. BGTool includes the most essential BGAPI functions. This tool does not in itself validate the rationale or
correctness of the sequence of BGAPI commands input by the user. It sends the commands to the WGM110 and displays the events
received back. This gives the developer total freedom to play around with the BGAPI commands.
Figure 1.1. BGTool Application
1.1 Compatible Products
BGTool can currently be used with Silicon Labs' latest Wizard Gecko WGM110 Wi-Fi Devices. BGTool application requires Windows 7
or later OS release.
1.2 Notations Used in This Guide
The following notations are used to distinguish between clicking or pressing buttons and selecting values.
• Clicking a button in the graphical user interface: [Set], [Cancel], [Open] etc.
• Selecting a value or setting: "Input Disabled", "Without pull-up", "Not enabled" etc.
Names of UI windows, screens, views and tabs: Connect to Module, Network View, Persistent Store View.
Commands written into the Log view BGAPI commands entry field: "wifi_cmd_sme_start_scan(0, 0103)".
Events displayed in the Log view: wifi_evt_sme_wifi_is_on.
Names or suffix of configuration files: "project.xml", ".bin" etc.
References to other manuals and guides: Name of Manual or Guide.
UG160: Wizard Gecko BGTool™ User's Guide
Introduction
silabs.com | Building a more connected world. Rev. 1.2 | 1
2. Preparations
If you have not used BGTool before, some preparations are required.
2.1 Preparing the Wizard Gecko Module Wireless Starter Kit (WSTK)
To prepare the WSTK, do the following (refer to the figure below):
1. Connect the WSTK Expansion Board to the WSTK Main Board as shown.
2. Connect the WSTK WGM110 Wi-Fi Module Radio Board to the WSTK Main board as shown.
3. Turn the power switch marked [BAT USB AEM] of the WSTK Main Board to "AEM" position.
4. Connect the WSTK to a PC using the supplied mini USB cable.
Verify the following:
1. That the USB Connection Indicator (blue LED) marked "SEGGER" on the Main Board turns on or starts blinking.
2. That the LCD display turns on and shows the Silicon Labs logo.
Figure 2.1. WGM110 Setup for BGTool Connection
UG160: Wizard Gecko BGTool™ User's Guide
Preparations
silabs.com | Building a more connected world. Rev. 1.2 | 2
2.2 Installing the Driver
1. Download the latest Wi-Fi software from Silicon Labs’ website: http://www.silabs.com/start-wgm.
2. Install the Wi-Fi software to your PC according to the on-screen instructions.
3. If not already done, download and install the latest "J-Link debugger" drivers from https://www.segger.com/jlink-software.html.
4. Once you connect the Wireless Starter Kit to the PC, the kit should be recognized as a J-link device.
5. To verify that everything was installed correctly, you should see JLink CDC UART and J-Link driver devices as shown in the figure
below.
Figure 2.2. Windows Device Manager
The CDC UART Port is used for communication between the WGM110 and BGTool, and the J-Link for uploading new firmware into the
WGM110 Module.
UG160: Wizard Gecko BGTool™ User's Guide
Preparations
silabs.com | Building a more connected world. Rev. 1.2 | 3
3. Using BGTool Software
This section contains brief step-by-step instructions on how to use the BGTool software.
After starting BGTool, the first task is to connect the Wizard Gecko Wi-Fi® Module Wireless Starter Kit SLWSTK6120A to your PC. This
is done through the Connect to Module UI pop-up window.
Once you are connected, BGTool moves into the Interactive user interface mode from where you can control and try out various Wiz-
ard Gecko Module features. This is the main part of the tool. It provides a versatile graphical user interface (GUI) which can be used to
configure and issue commands to the connected Wizard Gecko Wi-Fi Module. Included in the GUI is an embedded Log View, which
shows the commands, responses, and events generated over the connection interface between the Wi-Fi Module and the PC.
From the BGTool top row View tab, you can move into the Upload Tool with which you can compile and flash new firmware images to
the connected Wizard Gecko Wi-Fi Module.
3.1 Connection Setup View
This view simply shows the available COM ports on the PC and allows you to open the COM port to which the WGM110 Wi-Fi Module
is connected.
Figure 3.1. Connection Setup View
Controls
Connect with Select from the drop down list the correct COM port having the "Jlink CDC UART".
Baud rate Select from the drop down list the correct baud rate.
Default value: 115200
Open Press to connect with the Wireless Starter Kit on the selected COM port.
To get connected, choose the "JLink" connection from the drop-down list and use the default baud rate of "115200". To establish the
connection from your PC to the WGM110 Module, click the [Open] button.
UG160: Wizard Gecko BGTool™ User's Guide
Using BGTool Software
silabs.com | Building a more connected world. Rev. 1.2 | 4
3.2 Log View
The bottom part of each screen contains the Log View, used for displaying BGAPI events, commands, and responses and for entering
BGAPI commands by using the BGAPI commands field.
Figure 3.2. Log View
Controls
Log view Shows the user BGAPI commands sent by BGTool to the WGM110 Module and also the BGAPI re-
sponses and events the WGM110 Module sends back to BGTool, displayed in human readable for-
mat.
BGAPI commands This input field can be used to send commands manually to WGM110 Module.
Commands can be sent in the following formats:
<command>(parameter1, parameter2, ...)
ASCII format
wifi_cmd_sme_start_scan(0, 0103)
Send Clicking the Send button will result in the BGAPI command being sent to the connected Wi-Fi Mod-
ule.
Settings This drop-down list allows you to affect which elements are printed in the log window and whether
the log is scrolling or not.
Save Saves the BGAPI log to a user defined file.
Clear Clears the BGAPI log.
UG160: Wizard Gecko BGTool™ User's Guide
Using BGTool Software
silabs.com | Building a more connected world. Rev. 1.2 | 5
3.3 Device Details View
This view can be opened by clicking the [Device Details] button in the bottom part of BGTool. From this view, you can set the MAC
address of the Module and retrieve the Modules hardware and software details.
Figure 3.3. Device Details View
Controls
Get mac Retrieves the current set MAC address from the device.
Set mac Configures a new MAC address to the device.
Reset device Resets the device and retrieves the hardware and software details to the UI.
UG160: Wizard Gecko BGTool™ User's Guide
Using BGTool Software
silabs.com | Building a more connected world. Rev. 1.2 | 6
3.4 Network View
This view provides basic control of the WGM110 network. For example, from this view the user can turn the Wi-Fi radio of the WGM110
Module on or off, scan and connect to Access Points, and configure the IP address.
Figure 3.4. Network View
Controls
Wi-Fi on/off Enables or disables the Wi-Fi radio in the WGM110 Module.
Operating mode Configure the Wi-Fi Module either into Wi-Fi Station (STA) or Access Point (AP) mode.
Retrieve info Retrieve attributes stored in the WGM110 Module into BGTool UI.
Get When in Station Mode: pressing the [Get] button retrieves the current RSSI value for the connected
Wi-Fi Access Point.
Auto-check When in Station mode: checking the Auto-check box will make the UI periodically refresh and show
the RSSI value for the the connected Wi-Fi Access Point. The refresh interval can be set manually.
UG160: Wizard Gecko BGTool™ User's Guide
Using BGTool Software
silabs.com | Building a more connected world. Rev. 1.2 | 7
3.4.1 Network View - Access Point Mode (AP)
Selecting the Network Operating mode as "AP Mode" enables the control of WGM110 Module parameters as a Wi-Fi Access Point.
To read current settings from the Module, click the [Retrieve info] button.
Figure 3.5. Network View with AP Mode
Access Point Mode Controls
Visibility Toggles Access Point visibility between hidden and visible.
Security Changes the security mode and indicates which security mode is currently in use:
Options:
•No security
• WPA2
• WPA
• WEP
SSID Defines the AP SSID name.
Channel Defines the AP Channel.
Password Define password for the Wi-Fi AP.
HTTP Server on Enables or disables the built-in HTTP server.
DHCP Server on Enables or disables the built-in DHCP server.
DNS Server on Enables or disables the built-in DNS server.
DHCP First Address Defines first address of DHCP server address pool
DHCP Server Netmask Defines DHCP server netmask
DHCP Server Lease Time Defines DHCP server address lease timeout in seconds
UG160: Wizard Gecko BGTool™ User's Guide
Using BGTool Software
silabs.com | Building a more connected world. Rev. 1.2 | 8
Inhaltsverzeichnis
Andere Silicon Laboratories WLAN-Router Handbücher
