Silicon Laboratories BGTool WGM110 User Manual
Silicon Laboratories BGTool WGM110 User Manual

Silicon Laboratories BGTool WGM110 User Manual

Wizard gecko

Advertisement

Quick Links

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.
silabs.com | Building a more connected world.
KEY POINTS
• Setting up BGTool
• BGTool walkthrough
• Practical configuration examples
Rev. 1.2

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the BGTool WGM110 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

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.
  • Page 2: Table Of Contents

    Table of Contents 1. Introduction ....... . 1 1.1 Compatible Products .
  • Page 3: Introduction

    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.
  • Page 4: Preparations

    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.
  • Page 5: Installing The Driver

    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.
  • Page 6: Using Bgtool Software

    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.
  • Page 7: Log View

    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.
  • Page 8: Device Details View

    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.
  • Page 9: Network View

    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.
  • Page 10: Network View - Access Point Mode (Ap)

    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.
  • Page 12: Network View - Station Mode (Sta)

    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.
  • Page 13: Certificate Management

    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.
  • Page 14: Data Routing View

    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].
  • Page 15: Add Endpoints

    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.
  • Page 16: Data View

    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. •...
  • Page 17: Persistent Store View

    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.
  • Page 18: I/O Ports View

    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 •...
  • Page 20: Peripherals View

    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).
  • Page 21: Firmware Update View

    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...
  • Page 23: Examples

    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.
  • Page 25: Capturing Button Clicks On The Wgm110 Wstk

    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.
  • Page 26: Creating A Tcp Server

    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.
  • Page 27: Transmitting Data

    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.
  • Page 28: Revision History

    UG160: Wizard Gecko BGTool™ User's Guide Revision History 5. Revision History 5.1 Revision 1.2 March 31st, 2017 Changes: • Network View with AP Mode figure updated • Added: DHCP server settings to Access Point Mode Controls table • Firmware Update View paragraph updated 5.2 Revision 1.1 May 23rd, 2016 Changes:...
  • Page 29 Trademark Information Silicon Laboratories Inc.® , Silicon Laboratories®, Silicon Labs®, SiLabs® and the Silicon Labs logo®, Bluegiga®, Bluegiga Logo®, Clockbuilder®, CMEMS®, DSPLL®, EFM®, EFM32®, EFR, Ember®, Energy Micro, Energy Micro logo and combinations thereof, "the world’s most energy friendly microcontrollers", Ember®, EZLink®, EZRadio®, EZRadioPRO®, Gecko®, ISOmodem®, Precision32®, ProSLIC®, Simplicity Studio®, SiPHY®, Telegesis, the Telegesis Logo®, USBXpress®...

Table of Contents