Silicon Laboratories AMW007 User manual

UG370: Wireless Xpress AMW007 Kit
User's Guide
The AMW007 evaluation board is an excellent starting point to get familiar with the
AMW007 Wi-Fi module.
The evaluation board includes everything a developer needs to exercise the AMW007’s
UART interface and demonstrate data transfer over Wi-Fi. The board can operate stand-
alone by connecting a PC to the on-board CP2102N USB-to-UART bridge device. Alter-
natively, the board can be connected to a Silicon Labs EFM8 or EFM32 starter kit, where
a EFM8 or EFM32 microntroller can communicate with the AMW007 over UART.
The kit includes the following:
KEY FEATURES
• The AMW007 can connect to an existing
Wi-Fi network or be a Wi-Fi access point.
• UART interface and flow control pins use
Gecko OS command API to connect and
communicate across Wi-Fi
• Breakout test points for easy interface with
prototype boards
• Power sources include USB and EXP
Header
• AMW007 Evaluation Board
• 1 x micro USB cable
• Getting Started card
silabs.com | Building a more connected world. Rev. 1.1

1. Getting Started
Software
To set up the software for the AMW007 kit, either install Simplicity Studio, available at https://www.silabs.com/products/development-
tools/software/simplicity-studio to use Xpress Configurator or install a terminal program (e.g. Tera Term).
For most userss labeled AMW007, it will not be necessary to install a virtual comm port driver in order to interface with the AMW007 kit
using the on-board USB-to-UART bridge. Please see the section below for details.
AMW007 evaluation boards labeled AMW007-E04.2 or higher that are connected to Windows and Linux machines should be config-
ured to this driver automatically. However, if the board is not automatically recognized by the operating system, please download and
install the latest version of the CP210x VCP driver: https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-
drivers
Hardware
To set up the hardware for the AMW007 kit:
1. Connect the micro USB cable to AMW007 board and the other end to the PC.
2. Ensure the two blue LEDs labeled USB and 5V near the USB connector are on.
3. Connect to the virtual COM port using the terminal program.
• For Windows, use a terminal program (e.g. Tera Term) set to 115200, 8N1.
• For a Mac, the terminal can be accessed using [tty.usbserial]. There may be a modifier at the end of this for your computer.
Type [tty.usbserial_modifier 115200,8n1] to set the connection to the right settings. If using a utility like CoolTerm, make sure
the settings are configured to 115200, 8N1.
Note that AMW007 kits labeled AMW007-E04.2 and higher that are connected to Windows or Linux machines do not require a driver to
be installed in order to communicate with the board. However, if using a Mac or if the driver does not automatically install, please down-
load and install the driver from https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers.
UG370: Wireless Xpress AMW007 Kit User's Guide
Getting Started
silabs.com | Building a more connected world. Rev. 1.1 | 2

Check the Version
After connecting the board to the PC and opening the terminal program, press the [[RESET]] button on the board. You should see a
header with the version information for the device. Ensure this version is 2.1.5 or newer. If you find you are using an older version of
firmware, perform an over the air update on the board as described on docs.silabs.com.
help
The [help] command provides information both for commands and variables on the device.
Variables are system-level variables that determine the configuration of the AMW007 module.
Commands are actions that can be taken.
1. Type [help] to see the options for the help command.
2. Type [help commands] to see a list of commands supported by this module.
Figure 1.1. help
Commands used:
•https://docs.silabs.com/gecko-os/latest/cmd/commands#help
UG370: Wireless Xpress AMW007 Kit User's Guide
Getting Started
silabs.com | Building a more connected world. Rev. 1.1 | 3

Claiming Your Device
The Zentri Device Management Service (ZentriDMS) tracks GeckoOS devices, their owners, their firmware configuration and many oth-
er details. The DMS handles Over-the-Air (OTA) updates, providing a secure way to update devices in the field. You need a free DMS
account before using DMS features like OTA.
To create an account go to the DMS Signup page. The DMS username (your email address) and password you register are used when
you claim your device. To claim your device, in the terminal, issue the dms claim command:
GeckoOS command Description
dms claim YOUR_DMS_USERNAME YOUR_DMS_PASSWORD
Request POST /claim
Connecting (https): ota.zentri.com:443
Starting TLS
{"result":"ok"}
claims your device. GeckoOS response shows a successful result
Once you have successfully claimed your device, you can OTA.
Performing an OTA
Use OTA to update to the latest version of your device's GeckoOS product, or to load a development GeckoOS device with a specific
GeckoOS product or version. You need to claim your device before performing an OTA. See above.
To OTA, in the GeckoOS terminal, issue the ota command:
Gecko OS command Description
ota
Disassociated]
UUID: 06413041000000002E0049001951343438333231
Connecting to network
Security type from probe: WPA2-AES
Request POST /ota
Connecting (https): ota.zentri.com:443
Starting TLS
Bundle size: 729088, Free space: 823296, Core size: 425984
Bundle version: ZENTRI-AMW106-3.4.1.0, 2017-09-01T03:14:19Z, ZentriOS-W-3.4.1.0
Updates your device via the DMS
server
GeckoOS displays progress mes-
sages
For full details of the DMS claim and OTA update process, see docs.silabs.com.
UG370: Wireless Xpress AMW007 Kit User's Guide
Getting Started
silabs.com | Building a more connected world. Rev. 1.1 | 4

2. Kit Block Diagram
An overview of the AMW007 evaluation board is shown in the figure below.
AMW007
Module
2 x Buttons
2 x LEDs
CP2102N
UART-to-
USB bridge
Wi-Fi
UART
USB Micro
Connector
USB Expansion
Header
From PC
Figure 2.1. AMW007 Evaluation Board Block Diagram
UG370: Wireless Xpress AMW007 Kit User's Guide
Kit Block Diagram
silabs.com | Building a more connected world. Rev. 1.1 | 5

3. Kit Hardware Layout
The layout of the AMW007 evaluation board is shown below.
AMW007 Module
CP2102N
USB-to-serial
USB
Expansion Header
Buttons and LEDs
Reset Button
Figure 3.1. AMW007 Evaluation Board Hardware Layout
UG370: Wireless Xpress AMW007 Kit User's Guide
Kit Hardware Layout
silabs.com | Building a more connected world. Rev. 1.1 | 6

4. Power and Operation
4.1 Power Selection
The AMW007 evaluation board is designed to be powered by two different sources:
• External regulator via 5V from USB connector
• External regulator via 5V from expansion header
The figure shows how the different power sources are connected to the AMW007.
AMW
Module
Regulator
USB Micro
Connector
5V
Expansion
Header
3.3V
5V
Automatically
Switches
Figure 4.1. AMW007 Power Supply
When the USB is connected, the AMW007 is powered from the external regulator, and the external regulator is powered by the USB
cable.
The external regulator also be powered externally through the 5V and GND pins of the expansion header when the board is attached to
a power supply or an EFM MCU Starter Kit.
When power is provided through the USB or an external power supply, the AMW007 module can act as a stand alone device. When it
is connected to an EFM MCU Starter Kit through the expansion header, the AMW007 acts as a peripheral to the MCU.
4.2 Stand-alone
In stand-alone mode, the AMW007 on the evaluation board can be communicated with using the USB-to-UART bridge device. Simply
connect to the CP2102N’s virtual COM port in a terminal program and send commands to the AMW007.
Note: By default, the AMW007 communicates at 115200 baud, though this is a configurable setting.
UG370: Wireless Xpress AMW007 Kit User's Guide
Power and Operation
silabs.com | Building a more connected world. Rev. 1.1 | 7

4.2.1 AMW007 as an Access Point
To set up the AMW007 as an access point using a terminal program:
1. Connect to the AMW007 expansion board's COM port using a terminal program.
2. Set/Get commands access variables that configure operation and features in the device. Type [set setup.web.ssid] to ["GeckoOS
#"], where [#] is a unique SSID that will be easy to see on a list of other SSIDs as shown in Figure 1.3. Ensure this SSID does not
match any nearby SSIDs. Note that you will need quotes around the network name if it contains spaces.
Note: The [Get/Set] commands access variables that configure operation and features in the device. [Get] reads a variable from
RAM and [Set] writes a new value to that variable in RAM.
3. To read the password on the network, call [get setup.web.passkey]. The default password is "password". Set the password for
the network by calling [set setup.web.passkey].
4. Type [save] to save the new SSID values.
Note: The [save] command saves the [ssid] variable to flash.
5. Type [setup web] to enable the module as a Wi-Fi access point.
Note: By default, Gecko OS evaluation boards are configured to enter Setup Web mode when you hold down Button 2, press Re-
set, and continue to hold down Button 2 for at least three seconds.
Figure 4.2. setup web / set setup.web.ssid / save / get setup.web.passkey
UG370: Wireless Xpress AMW007 Kit User's Guide
Power and Operation
silabs.com | Building a more connected world. Rev. 1.1 | 8

6. Configure GPIO 5 to be an input by executing the command 'gpio_dir 5 in'. Note that this is done to illustrate additional capability in
step 9 of this QSG. This command is not typically required to configure your device.
7. Using your computer or phone, connect to the Gecko OS access point [Gecko OS #] using the password.
Figure 4.3. Connecting to the Gecko OS Access Point
8. Using a web browser, go to setup.com.
9. Click the [GPIOs] area on the left side of the browser.
Figure 4.4. Navigating to the Module's index.html
UG370: Wireless Xpress AMW007 Kit User's Guide
Power and Operation
silabs.com | Building a more connected world. Rev. 1.1 | 9

10. Press and hold the [BUTTON 2] switch on the AMW007 board to change the GPIO toggle on the webpage. Note that the GPIO
state is able to be read because that GPIO was configured as an input earlier in this tutorial.
Figure 4.5. Toggling the GPIO Using the Buttons
Please see https://docs.silabs.com/ for a complete description of all commands and variables used in this tutorial.
4.2.2 Connecting to an Existing Network
Connecting to an Existing Network using a Terminal Program
To connect to an existing Wi-Fi network using a terminal program:
1. Connect to the AMW007 expansion board using a terminal program.
2. If the AMW007 was previously configured as an access point, type [reboot] to disable the AMW007 as an access point.
3. Use the [scan] command to find all the networks in range.
Figure 4.6. scan
Please see https://docs.silabs.com/ for a complete description of all commands and variables used in this tutorial.
UG370: Wireless Xpress AMW007 Kit User's Guide
Power and Operation
silabs.com | Building a more connected world. Rev. 1.1 | 10

Connecting to a Network
The [wlan.ssid] and [wlan.passkey] variables set the Wi-Fi network name and password, respectively.
1. Type [set wlan.ssid "Wi-Fi network name"]. The ["Wi-Fi network name"] value is the name of the network you'd like to connect
to.
Note: Use quotes around the network name if it contains spaces.
2. Type [set wlan.passkey password]. The [password] value is the password for the network defined by the ssid.
3. Type [save] to save the new values.
4. Type [network_up] to turn on the network.
You should now be connected to the network.
Figure 4.7. set wlan.ssid / set wlan.passkey / save / network_up
Note: To automatically join the network defined by [ssid] and [passkey] each time the module is powered on or rebooted, type [set
wlan.auto_join.enabled 1].
Commands used:
•https://docs.silabs.com/gecko-os/latest/cmd/commands#set
•https://docs.silabs.com/gecko-os/latest/cmd/commands#save
•https://docs.silabs.com/gecko-os/latest/cmd/commands#network-up
UG370: Wireless Xpress AMW007 Kit User's Guide
Power and Operation
silabs.com | Building a more connected world. Rev. 1.1 | 11

Looking for Files
GeckoOS includes full operating system commands like [ls -l]. To test this out:
1. Type [ls] to get a basic file list.
2. Type [ls -l] to view the type, flags, and other information for files in the operating system filesystem.
Figure 4.8. ls / ls -l
Please see https://docs.silabs.com/ for a complete description of all commands and variables used in this tutorial.
UG370: Wireless Xpress AMW007 Kit User's Guide
Power and Operation
silabs.com | Building a more connected world. Rev. 1.1 | 12

Reading from a File
Data sources like files and network sockets are called streams in GeckoOS. To read from one of these files:
1. Type [ls] to get a list of the files, if you don't already have it.
2. Use [file_open] to open the file. Type [file_open webapp/index.html] to open this file.
3. Type [stream_list] to view all of the open streams. Since we only have one stream open at the moment, it should have the handle
of [0].
4. Type [stream_read 0 100] to read 100 bytes from stream 0, or unauthorized.html.
Figure 4.9. ls / file_open / stream_list / stream_read
Commands used:
•https://docs.silabs.com/gecko-os/latest/cmd/commands#ls
•https://docs.silabs.com/gecko-os/latest/cmd/commands#file-open
•https://docs.silabs.com/gecko-os/latest/cmd/commands#stream-list
•https://docs.silabs.com/gecko-os/latest/cmd/commands#stream-read
Reading from a Website
To read data from a website:
1. Type [http_get www.google.com] to open a stream with the Google homepage. This should now be stream [1].
2. Type [stream_read 1 1000] to read the first 1000 bytes from the site (stream 1).
Figure 4.10. http_get / stream_read
Please see https://docs.silabs.com/ for a complete description of all commands and variables used in this tutorial.
UG370: Wireless Xpress AMW007 Kit User's Guide
Power and Operation
silabs.com | Building a more connected world. Rev. 1.1 | 13

Closing a Stream
To close a stream:
1. Type [stream_close 0] to close the open stream to the unauthorized.html file.
2. Type [stream_list] to view the open streams. The open stream to the website should be the only item in the list.
Figure 4.11. stream_close / stream_list
Please see https://docs.silabs.com/ for a complete description of all commands and variables used in this tutorial.
UG370: Wireless Xpress AMW007 Kit User's Guide
Power and Operation
silabs.com | Building a more connected world. Rev. 1.1 | 14

5. Peripherals
The starter kit has a set of peripherals that showcase some of the features of the AMW007 module.
Be aware that some I/O routed to peripherals are also routed to the breakout pads. This must be taken into consideration when using
the breakout pads for your application.
5.1 Push Buttons and LEDs
The board includes 2 active-high LEDs and 2 mechanical buttons to exercise I/O capabilities of the AMW007. The connections are
shown in the following table.
Table 5.1. LEDs and Buttons Connected to AMW007
AMW007 Pin LED/Button
GPIO0 BUTTON1
GPIO1 LED1 (red)
GPIO4 LED2 (green)
GPIO5 BUTTON2
UG370: Wireless Xpress AMW007 Kit User's Guide
Peripherals
silabs.com | Building a more connected world. Rev. 1.1 | 15

6. Connectors
6.1 Test Points
The test points located to the left and right of the module. Test points are available for the AMW007's power/ground pins, UART pins,
all GPIOs, reset pin, wake pin, chip enable pin, boot select pin, and debug TX pin.
Test Points
Figure 6.1. Test Points
6.2 Expansion Header
On the left hand side of the board is a female expansion header to connect to a Silicon Labs EFM8 Starter Kit (STK). The connecter
contains a number of output and communication pins that can be used to communicate with the MCU on the STK. Additionally, the 3V3
and 5V power rails are also available. The figure below shows the pin assignment of the expansion header.
19
17
15
13
11
9
7
5
3
1
20
18
16
14
12
10
8
6
4
2
EBID_SDA
EBID_SCL
See Schematic
NC
NC
NC
GPIO_5
GPIO_0
NC
GND
3V3
5V
/RESET
UART_TX*
UART_RX*
NC
NC
NC
NC
NC
AMW007 pin
Power
Ground
Reserved (Board Identification)
* Only when CP2102N UART-to-USB bridge is unpowered
Top-side view, with connector on left side of the board
Figure 6.2. Expansion Header
UG370: Wireless Xpress AMW007 Kit User's Guide
Connectors
silabs.com | Building a more connected world. Rev. 1.1 | 16

7. Simplicity Studio
Simplicity Studio contains tools to configure and evaluate the AMW007.
7.1 Xpress Configurator
Xpress Configurator is a GUI tool used to configure parameters of the AMW007, save those values, and export settings in a number of
useful ways.
Note: All configuration of the AMW007 executes across the serial interface, and any step taken by Xpress Configurator can be repro-
duced by an embedded host connected to the AMW007's UART interface.
All communication between the AMW007 expansion board and the Xpress Configurator can be seen in the terminal window embedded
in the Xpress Configurator tool.
Figure 7.1. Simplicity Studio Xpress Configurator
UG370: Wireless Xpress AMW007 Kit User's Guide
Simplicity Studio
silabs.com | Building a more connected world. Rev. 1.1 | 17

8. Schematics, Assembly Drawings, and BOM
8.1 Board Files
The schematics, assembly drawings and bill of materials (BOM) for the AMW007 evaluation board are available through Simplicity Stu-
dio when the kit documentation package has been installed. To access these documents, click the [Kit Documentation] tile after se-
lecting the device in the left pane.
UG370: Wireless Xpress AMW007 Kit User's Guide
Schematics, Assembly Drawings, and BOM
silabs.com | Building a more connected world. Rev. 1.1 | 18

http://www.silabs.com
Silicon Laboratories Inc.
400 West Cesar Chavez
Austin, TX 78701
USA
Simplicity Studio
One-click access to MCU and
wireless tools, documentation,
software, source code libraries &
more. Available for Windows,
Mac and Linux!
IoT Portfolio
www.silabs.com/IoT
SW/HW
www.silabs.com/simplicity
Quality
www.silabs.com/quality
Support and Community
community.silabs.com
Disclaimer
Silicon Labs intends to provide customers with the latest, accurate, and in-depth documentation of all peripherals and modules available for system and software implementers using or
intending to use the Silicon Labs products. Characterization data, available modules and peripherals, memory sizes and memory addresses refer to each specific device, and "Typical"
parameters provided can and do vary in different applications. Application examples described herein are for illustrative purposes only. Silicon Labs reserves the right to make changes
without further notice and limitation to product information, specifications, and descriptions herein, and does not give warranties as to the accuracy or completeness of the included
information. Silicon Labs shall have no liability for the consequences of use of the information supplied herein. This document does not imply or express copyright licenses granted
hereunder to design or fabricate any integrated circuits. The products are not designed or authorized to be used within any Life Support System without the specific written consent of
Silicon Labs. A "Life Support System" is any product or system intended to support or sustain life and/or health, which, if it fails, can be reasonably expected to result in significant personal
injury or death. Silicon Labs products are not designed or authorized for military applications. Silicon Labs products shall under no circumstances be used in weapons of mass
destruction including (but not limited to) nuclear, biological or chemical weapons, or missiles capable of delivering such weapons.
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®, Micrium, Precision32®, ProSLIC®, Simplicity Studio®, SiPHY®, Telegesis, the Telegesis Logo®, USBXpress®, Zentri,Z-Wave, and others are trademarks or
registered trademarks of Silicon Labs. ARM, CORTEX, Cortex-M3 and THUMB are trademarks or registered trademarks of ARM Holdings. Keil is a registered trademark of ARM
Limited. All other products or brand names mentioned herein are trademarks of their respective holders.