Summary of Contents for Silicon Laboratories BGTool WGM110
Page 1
UG160: Wizard Gecko BGTool™ User's Guide This user's guide walks you through the basic uses of the BGTool. This KEY POINTS tool allows the developer to quickly test and evaluate Silicon Lab’s Wiz- • Setting up BGTool ® ard Gecko Wi-Fi Module and its features.
UG160: Wizard Gecko BGTool™ User's Guide Introduction 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 BGAPI binary protocol used by the host to control the Wi-Fi software running on the WGM110 Module.
UG160: Wizard Gecko BGTool™ User's Guide Preparations 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.
UG160: Wizard Gecko BGTool™ User's Guide Preparations 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.
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software 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.
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software 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.
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software 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.
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software 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.
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software 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.
Page 11
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software Access Point Mode Controls Device + Path Defines the HTTP server root location for the specified resource path. Example: 192.168.1.1/logs can be configured to use the built-in microSD card slot on the WGM110 Radio Board as its root destination.
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software 3.4.2 Network View - Station Mode (STA) Selecting the Network Operating mode as "STA mode" enables the control of WGM110 Module parameters as a Wi-Fi client. To read current settings from the Module, click the [Retrieve info] button. The [Open WPA settings] button will open a user interface allowing you to manage security certificates and WPA settings.
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software 3.4.3 Certificate Management Connecting to WPA Enterprise networks requires the right certificates to be provisioned on the client side. From the Certificates view you can manage the Wi-Fi module certificates storage. From the WPA settings view you can configure the needed parameters to allow the Wi-Fi module to take part in a WPA Enterprise protected wireless network.
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software WPA settings EAP type Select the EAP type, enter the Network Access Identifier (NAI) used during authentication and press [Set EAP configuration]. CA certificate Select the CA certificate used to verify the authentication server certificate during authentication and press [Set CA certificate].
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software 3.5.2 Add Endpoints This section discusses how to create TCP and UDP clients and servers. Table 3.1. TCP/UDP Server Settings End point details Type: TCP or UDP Server Defines the type of the endpoint. Route The target destination for data.
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software 3.5.3 Data View This view is used to send data to an endpoint, and it also shows data received from the BGAPI endpoint. To send data to an endpoint: • Select the endpoint ID to which you want to send the data. •...
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software 3.7 Persistent Store View Persistent Store view can be used to access the local PS key store and to retrieve and store keys and their values. Figure 3.10. PS Store View Persistent Store View Refresh Retrieves the WGM110 stored PS key values.
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software 3.8 I/O Ports View This view allows you to view and configure the I/O ports of your WGM110 Module. You can configure whether the ports are inputs or outputs, change the state of outputs, and also enable and configure interrupts. BGTool does not have the capability to read the current GPIO configuration from the connected Module.
Page 19
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software I/O Ports View GPIO There are two columns in this part. They are used to define settings as follows: mode Left column • Defines pin state. Options are: • Input disabled •...
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software I/O Ports View Read All Reads the current state of all pins configured as either inputs or outputs from the Module and updates these values into the "Value" column. Note: This command does not read the current pin configuration settings from the Module, but only reads the output state of the pins (0 or 1).
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software 3.10 Firmware Update View The firmware update view can be used to build the .bin file and to perform a DFU update for your local device. If you have a .bin file already available, you do not need to build it again, and you can directly proceed to the DFU update part.
Page 22
UG160: Wizard Gecko BGTool™ User's Guide Using BGTool Software 7. Wait for the update to finish. Figure 3.14. DFU Firmware Update (UART DFU Upload) silabs.com | Building a more connected world. Rev. 1.2 | 20...
UG160: Wizard Gecko BGTool™ User's Guide Examples 4. Examples This section contains several examples showing how BGTool is used together with the WGM110 Wireless Starter Kit (WSTK). Note: Always remember to RESET the WGM110 Module before trying out any of the examples to ensure you have a clean starting point.
Page 24
UG160: Wizard Gecko BGTool™ User's Guide Examples 1. Configure WSTK PIN PC0 (LED0) and WSTK PIN PC1 (LED1) as "Output Push-Pull", and for both pins save the configuration by clicking the [Set] button. 2. Make sure they are configured as "Output Push-Pull" I/Os. 3.
UG160: Wizard Gecko BGTool™ User's Guide Examples 4.3 Capturing Button Clicks on the WGM110 WSTK In the I/O Ports View, perform the following configurations: Figure 4.3. I/O Port Configuration for Button Click Event 1. Configure the WSTK PINS PA2 (Push button PB0), PA6 (Push button PB1), PE14 (Push button BTN2) and PD5 (Push button BTN3) as "Input", and save the configuration for each pin individually by clicking the [Set] button.
UG160: Wizard Gecko BGTool™ User's Guide Examples 4.4.2 Creating a TCP Server To create a TCP Server, go to the Data Routing View in BGTool. Figure 4.6. Creating a New Endpoint 1. To create a TCP Server, select "TCP server" from the Add endpoint tool. 2.
UG160: Wizard Gecko BGTool™ User's Guide Examples 4.4.5 Transmitting Data To send data to the TCP client, perform the following steps: 1. Change the destination endpoint ID in the "Destination endpoint:" field of Data View to "3". 2. Type in the data you want to send into the entry field (in the example below "Hello World"). 3.
Need help?
Do you have a question about the BGTool WGM110 and is the answer not in the manual?
Questions and answers