ACKme Networks AMW006 Moray Instruction sheet

AMW006 Evaluation Guide
ARG-MW006E-100R •AMW006 Evaluation Guide October 20, 2014
©2014 ACKme Networks. http://ack.me
AMW006
Evaluation Guide
AMW006-E03
‘Moray’

AMW006 Evaluation Guide
ARG-MW006E-100R •AMW006 Evaluation Guide Page | i Page | i
©2014 ACKme Networks. http://ack.me October 20, 2014 October 20, 2014
Disclaimer
While the information provided in this document is
believed to be accurate, it is under development and
ACKme Networks reserves the right to make changes
without further notice to the product described herein
to improve reliability, function, or design, and makes no
guarantee or warranty concerning the accuracy of said
information, nor shall it be responsible for any loss or
damage of whatever nature resulting from the use of,
or reliance upon, such information. ACKme Networks
makes no warranties of any kind, whether express,
implied or arising by custom or course of trade or
performance, and specifically disclaims the implied
warranties of title, non-infringement, merchantability,
or fitness for a particular purpose.
No part of this document may be copied, reproduced,
stored in a retrieval system, or transmitted, in any form
or by any means, electronic, mechanical, photographic,
or otherwise, or used as the basis for manufacture or
sale of any items without the prior written consent of
ACKme Networks.
Trademarks
ACKme Networks and the ACKme Networks logo
are trademarks of ACKme Networks. WICED™
is a trademark of Cypress Semiconductor
Corporation. Other trademarks in this document
belong to their respective owners.
Copyright © 2014 ACKme Networks, Inc.
All rights reserved.
Document Number: ARG-MW006E
Release Date: October 20, 2014
Contact
http://ack.me/contact
About this User Guide
This guide provides information and basic usage
instructions for the WiConnect serial Wi-Fi application
and the AMW006 ‘Numbat’ module available from
ACKme Networks.
Evaluation boards covered by this guide include:
AMW006-E03 ‘Moray’(Revision 2)
Further information about WiConnect is available in the
WiConnect Reference manual online at:
http://wiconnect.ack.me
Organization
This document is organized into the following sections:
Introduction, Section 1
Feature Identification, Section 2
Using WiConnect, Section 3
Ordering Information, Section 4
Revision History & Glossary, Section 5
Appendix A –Setting up a Terminal Emulator
Appendix B –Evaluation Board Schematics

AMW006 Evaluation Guide
ARG-MW006E-100R •AMW006 Evaluation Guide Page | ii Page | ii
©2014 ACKme Networks. http://ack.me October 20, 2014 October 20, 2014
Contents
1 Introduction ...........................................................1
2 Feature Identification ............................................2
2.1 AMW006-E03 ‘Moray’ ....................................2
3 Using WiConnect....................................................3
3.1 Getting Help....................................................3
3.2 Scanning for Wi-Fi Networks ..........................4
3.3 Joining a Wi-Fi Network..................................4
Web Setup ..............................................4
Script Setup.............................................5
Manual Setup..........................................5
Wireless Protected Setup (WPS) ............6
3.4 Filesystem .......................................................7
3.5 Saving Custom Configurations........................7
3.6 UDP / TCP / TLS Clients ...................................8
3.7 HTTP / HTTPS Clients ......................................8
3.8 Using GPIOs ....................................................9
3.9 Factory Reset ................................................10
3.10 Save & Reboot ..............................................10
3.11 Command vs. Stream Mode .........................10
Command Mode ...................................11
Stream Mode ........................................11
3.12 Want more?..................................................11
4 Ordering Information...........................................12
5 Revision History & Glossary .................................13
5.1 Revision History ............................................13
5.2 Glossary ........................................................13
APPENDIX A –Configuring a Terminal Application
APPENDIX B –Evaluation Board Schematics

AMW006 Evaluation Guide
Introduction, Section 1
ARG-MW006E-100R •AMW006 Evaluation Guide Page | 1 Page | 1
©2014 ACKme Networks. http://ack.me October 20, 2014 October 20, 2014
1Introduction
The AMW006 ‘Numbat’ module is a fully certified small form factor, low power Wi-Fi networking module perfectly
suited to deeply embedded applications requiring medium/high data throughput in medium to high volume.
The module runs WiConnect firmware, ACKme Networks’easy-to-use and reliable serial Wi-Fi networking application
that includes an embedded TCP/IP networking stack with SSL/TLS/HTTPS security.
Evaluation of WiConnect and the AMW006 module is available with the AMW006-E03 ‘Moray’ evaluation board. The
evaluation board is shown in Figure 1 and its features are shown in Table 1.
Figure 1. AMW006 Moray Evaluation Board
Table 1. AMW006 Evaluation Board Features
Feature
AMW006-E03 ‘Moray’
Product Number
AMW006-E03
Module style
Surface mount
Serial Interface
USB-UART
Power supply
from USB
User LEDs
2 + 3
User Buttons
2
Reset Button
Yes
Expansion Headers
1 x 35-pin
Note! Customers that wish to evaluate the AMW006 module using Cypress WICED should obtain an
alternative evaluation board that provides AMW006 program and debug capability. See the AMW006-E01
‘Seabass’ WICED eval board.
AMW006-E03 ‘Moray’
(with AMW006 surface mount module)

AMW006 Evaluation Guide
Feature Identification, Section 2
ARG-MW006E-100R •AMW006 Evaluation Guide Page | 2 Page | 2
©2014 ACKme Networks. http://ack.me October 20, 2014 October 20, 2014
2Feature Identification
2.1 AMW006-E03 ‘Moray’
The Moray evaluation board comes complete with a surface mount AMW006 ‘Numbat’ module. Each pin on the
Numbat module is connected to the expansion header. Schematics for the board are provided in Appendix B.
Figure 2. AMW006-E03 Features
Table 2. AMW006-E03 Expansion Header Connections
AMW006
H6
AMW006
H8
AMW006
H8
AMW006
H7
GND
2
GND
12
UART0_TX
20
GND
27
VDD_DUT
3
GPIO 5
13
GPIO 13
21
GPIO 18
28
GPIO 0
4
GPIO 6
14
GPIO 14
22
GPIO 19
29
GPIO 1
5
GPIO 7
15
GPIO 15
23
GPIO 20
30
GPIO 2
6
GPIO 8
16
GPIO 16
24
GPIO 21
31
GPIO 3
7
UART0_RTS
17
GPIO 17
25
GPIO 22
32
GPIO 4
8
UART0_CTS
18
GND
26
GPIO 23
33
OSC_32K
9
UART0_RX
19
RESET_N
34
VDD_DUT
10
VDD_DUT
35
GND
11
GND
36
USB UART Tx LED
Expansion Header H7
USB UART Rx LED
User LED 1*
User Button 2*
User Button 1*
Reset Button
Used to reset the AMW006 module
Power LED
Thermistor
Expansion Header H6
USB Micro Connector
Provides power to the board &
USB-Serial UART to computer
Ground Hook
User LED 2*
AMW006 Module
System Indicator LEDs*
UART Header H4
Expansion Header H8
Antenna Connections
* User configurable

AMW006 Evaluation Guide
Using WiConnect, Section 3
ARG-MW006E-100R •AMW006 Evaluation Guide Page | 3 Page | 3
©2014 ACKme Networks. http://ack.me October 20, 2014 October 20, 2014
3Using WiConnect
To get started with WiConnect, plug the AMW006 evaluation board into the USB port of the computer and open a
terminal emulator as described in Appendix A. The USB cable provides the evaluation board with power and a serial
UART connection to the computer.
With the board connected to the computer, verify the power LED is illuminated. If the power LED is NOT illuminated,
try re-plugging the USB cable, or try a different USB cable.
Note! Be sure to use a quality USB cable. Inferior cables may result in reduced or intermittent operation
of the evaluation board.
3.1 Getting Help
WiConnect provides extensive help for each command and variable. To obtain a list of help options, type the help
command.
> help
The following help options are available ...
help all -> Print a list of all Commands and Variables
help commands -> Print a list of Commands
help variables -> Print a list of Variables
help <command> -> Print help for a specific Command
help <variable> -> Print help for a specific Variable
Additional help is available online at http://wiconnect.ack.me
To obtain help for a particular command or variable, type help <command> or help <variable>.
To obtain help for the wlan_scan variable, type help wlan_scan.
> help wlan_scan
Usage : wlan_scan [-v] [<channel> [ssid]]
Shortcut: scan
Brief : Initiate a Wi-Fi scan and return results; optionally specify
a channel and AP SSID to scan for. For verbose scans, -v must be the first argument
Computer with Terminal Emulator
Moray Evaluation Board
USB Serial

AMW006 Evaluation Guide
Using WiConnect, Section 3
ARG-MW006E-100R •AMW006 Evaluation Guide Page | 4 Page | 4
©2014 ACKme Networks. http://ack.me October 20, 2014 October 20, 2014
3.2 Scanning for Wi-Fi Networks
To scan for Wi-Fi networks in range, use the wlan_scan command. Each AP in range is listed on a separate line.
> wlan_scan -v
!3 networks found
! # Ch RSSI MAC BSSID Rate Security Mode Len Network (SSID)
# 0 06 -27 84:1B:5E:29:9D:F7 450.0 WPA2-Mixed Inf 17 YOUR_NETWORK_NAME
# 1 11 -73 2C:B0:5D:31:6F:6A 300.0 WPA2-AES Inf 6 button
# 2 11 -73 EC:1A:59:36:5B:6C 144.4 WPA2-Mixed Inf 5 ACKme
3.3 Joining a Wi-Fi Network
Several methods are available to configure and join the AMW006 module to a Wi-Fi network.
Web Setup
WiConnect provides the option to use a web browser running on a network client (such as a smartphone, tablet or
computer) to select the remote Wi-Fi network the AMW006 module should join, and to enter a password for the
remote network.
When web setup is used, it is helpful to think of the network client as the keyboard and display for the module as
shown in Figure 3.
Figure 3. Web setup using a network client
To start web setup mode, enter the command setup web. WiConnect starts the local network and web server as
indicated by the final message: In progress.
> setup web
[Disassociated]
IPv4 address: 10.10.10.1
Web setup started with the SSID: WiConnect-102F1A
In progress
Remote Network
Name: YOUR_NETWORK_NAME
Local Network
Name: WiConnect-######
Password: password

AMW006 Evaluation Guide
Using WiConnect, Section 3
ARG-MW006E-100R •AMW006 Evaluation Guide Page | 5 Page | 5
©2014 ACKme Networks. http://ack.me October 20, 2014 October 20, 2014
Open the Wi-Fi settings on your smartphone, tablet or computer and join the network called WiConnect-######
(where ###### are the last 6 digits of the Wi-Fi module MAC address). The password for the network is simply:
password. The local network name and password, and the web address may be customised to suit your needs, see
the online WiConnect Reference Manual for further information.
After joining the local network, open a web browser on the network client and go to setup.com. The WiConnect web
page appears (see Figure 3), and a scan begins for Wi-Fi access points in range. Select the remote network you wish
to join, enter the network password then select Save & Exit and follow the prompts.
Once the settings are successfully saved, WiConnect prints Web Setup Mode exited to the terminal. Check that
the settings were successfully saved using get wlan.ssid and get wlan.passkey.
Web Setup Mode exited
> get wlan.ssid
YOUR_NETWORK_NAME
> get wlan.passkey
YOUR_NETWORK_PASSWORD
Script Setup
If you prefer instead to enter configuration details for the Wi-Fi network, WiConnect provides a default setup script
to step you through the process. The setup script is provided as a file called default_setup.script on the
WiConnect file system. The setup script may be customised as required.
> setup cmd
> Enter Wi-Fi network name:
set wlan.ssid YOUR_NETWORK_NAME
Set OK
> Enter Wi-Fi network password:
set wlan.passkey YOUR_NETWORK_PASSWORD
Set OK
>
set wlan.auto_join.enabled true
Set OK
> Saving settings
save
Saved
Success
>
network_up
[2014-05-17 | 11:48:31: Associating to YOUR_NETWORK_NAME]
In progress
> Security type from probe: WPA2-Mixed
Obtaining IPv4 address via DHCP
IPv4 address: 192.168.0.31
[2014-05-17 | 11:48:41: Associated]
> Exiting Cmd Setup Mode
Manual Setup
It is straightforward to manually enter the name and password for the network using the wlan.ssid and
wlan.passkey variables too. Be sure to save afterwards, or the values will be lost when the module reboots. Any
subsequent command requiring network access, such as an ICMP (Internet Control Message Protocol) ping,
automatically results in the module attempting to join the network.

AMW006 Evaluation Guide
Using WiConnect, Section 3
ARG-MW006E-100R •AMW006 Evaluation Guide Page | 6 Page | 6
©2014 ACKme Networks. http://ack.me October 20, 2014 October 20, 2014
> set wlan.ssid YOUR_NETWORK_NAME
Set OK
> set wlan.passkey YOUR_NETWORK_PASSWORD
Set OK
> save
Saved
Success
> ping -g
[Associating to YOUR_NETWORK_NAME]
Security type from probe: WPA2-Mixed
Obtaining IPv4 address via DHCP
IPv4 address: 192.168.0.31
[Associated]
Ping reply in 25ms
The network up –scommand provides a shortcut to the process, by scanning for wireless Access Points, offering a
choice of networks to join and automatically saving the ssid and passkey:
> network_up -s
Scanning for networks...
! 3 networks found
! # Ch RSSI MAC (BSSID) Network (SSID)
# 0 1 -40 4C:55:CC:10:2E:50 ABC
# 1 1 -32 9C:D6:43:28:50:A0 myAP
# 2 6 -77 30:85:A9:E7:9C:B0 DEF
Type the number # that matches your Network: 1
Type the password for your Network : secretpassword
[Associating to myAP]
> In progress
> Security type from probe: WPA2-AES
Obtaining IPv4 address via DHCP
IPv4 address: 10.5.6.94
[Associated]
Wireless Protected Setup (WPS)
WPS is a Wi-Fi provisioning method originally intended to simplify the process of connecting Wi-Fi clients to Wi-Fi
Access Points. WPS offers both a push-button and PIN entry method for configuration. In reality, WPS push-button
(as opposed to PIN) is the only method that has gained some level of adoption in the industry, however WPS
naturally only works when the Wi-Fi AP supports WPS.
Many AP vendors choose not to test and certify APs with the Wi-Fi Alliance, and the lack of a standard WPS logo next
to the WPS button on an AP often means many users are unaware that WPS is available. The potential for equipment
incompatibility and added user confusion mean it is unwise to rely on WPS as the primary method of Wi-Fi
provisioning in the real world.
Incompatibility and confusion aside, WiConnect provides full support for WPS1.0 & WPS2.0 and the underlying WPS
engine has passed Wi-Fi certification. To use WPS in push-button mode, simply enter the wps command into
WiConnect, then press the WPS button on your router (if the router supports WPS, and it is enabled, and you can
find the button), and wait for the magic to happen.

AMW006 Evaluation Guide
Using WiConnect, Section 3
ARG-MW006E-100R •AMW006 Evaluation Guide Page | 7 Page | 7
©2014 ACKme Networks. http://ack.me October 20, 2014 October 20, 2014
3.4 Filesystem
ACKme Wi-Fi modules running WiConnect include a serial flash memory and a filesystem that provides users with the
ability to read and write files. A quick example showing how to create, manipulate then delete a file is provided
below.
> file_create hello.txt 13
my hello data
File created
Success
> ls
! # Size Version Filename
# 0 1853 2.0.0 /favicon.ico.gz
# 1 18067 2.0.0 /setup/images.png
# 2 10525 2.0.0 /setup/index.css.gz
# 3 10143 2.0.0 /setup/index.html
# 4 39233 2.0.0 /setup/index.js.gz
# 5 32297 2.0.0 command_help.csv
# 6 135 2.0.0 default_setup.script
# 7 1236 2.0.0 geotrust_ca.pem
# 8 279 1.0.0 gpio_config_init.csv
# 9 13 1.0.0 hello.txt
# 10 212736 2.0.0 upgrade_app.exe
# 11 176920 2.0.0 wiconnect.exe
# 12 203261 5.26.230 wifi_fw.bin
> file_open hello.txt
[Opened: 0]
0
> stream_read 0 5
my he
> stream_read 0 50
llo data
[Closed: 0]
> file_delete hello.txt
File deleted
Success
Note! When reading the contents of a file using stream_read, the file is automatically closed if the end of
file is reached.
3.5 Saving Custom Configurations
All available WiConnect variables may be saved to a file as a custom configuration. Saved configuration may then be
loaded at a later date. This feature is particularly useful for saving configuration variables prior to an over-the-air
(OTA) upgrade, and then restoring the configuration afterwards.
> save my_config.csv
Success
> load my_config.csv
Configuration successfully loaded