Lantronix xPico WiFi User manual

Part Number 900-691-R
Revision A July 2013
xPico Wi-Fi
Embedded Device Server
User Guide

xPico® Wi-Fi® Embedded Device Server User Guide 2
Intellectual Property
© 2013 Lantronix, Inc. All rights reserved. No part of the contents of this book may be transmitted
or reproduced in any form or by any means without the written permission of Lantronix.
Lantronix® and xPico® are registered trademarks of Lantronix, Inc. in the United States and other
countries. DeviceInstaller™ is a trademark of Lantronix, Inc. U.S. patents pending.
Windows® and Internet Explorer® are registered trademarks of Microsoft Corporation. Mozilla®
and Firefox® are registered trademarks of the Mozilla Foundation. Chrome™ is a trademark of
Google, Inc. Wi-Fi® is a registered trademark of Wi-Fi Alliance. All other trademarks and trade
names are the property of their respective holders.
Warranty
For details on the Lantronix warranty policy, please go to our web site at
www.lantronix.com/support/warranty.
Contacts
Lantronix, Inc. Corporate Headquarters
167 Technology Drive
Irvine, CA 92618, USA
Toll Free: 800-526-8766
Phone: [phone]
Fax: [phone]
Technical Support
Online: www.lantronix.com/support
Sales Offices
For a current list of our domestic and international sales offices, go to the Lantronix web site at
www.lantronix.com/about/contact.
Disclaimer
The information in this guide may change without notice. The manufacturer assumes no
responsibility for any errors that may appear in this guide.
Revision History
Date Rev. Comments
July 2013 A Initial document (firmware 1.0.0.0R7).

xPico® Wi-Fi® Embedded Device Server User Guide 3
Table of Contents
Intellectual Property ________________________________________________________2
Warranty _________________________________________________________________2
Contacts _________________________________________________________________2
Disclaimer ________________________________________________________________2
Revision History ___________________________________________________________2
List of Figures _____________________________________________________________6
List of Tables _____________________________________________________________7
1: Using This Guide 8
Purpose and Audience ______________________________________________________8
Summary of Chapters _______________________________________________________8
Additional Documentation ____________________________________________________8
2: Introduction 10
Key Features _____________________________________________________________10
Protocol Support _________________________________________________________12
Troubleshooting Capabilities _________________________________________________12
Configuration Methods _____________________________________________________12
Addresses and Port Numbers ________________________________________________12
Hardware Address _____________________________________________________12
IP Address ___________________________________________________________12
Port Numbers _________________________________________________________12
Product Information Label ___________________________________________________13
3: Configuration Using Web Manager 14
Accessing Web Manager ___________________________________________________14
Status Page ______________________________________________________________15
Web Manager Components _________________________________________________16
Navigating Web Manager ___________________________________________________16
4: Network Settings 18
Network 1 Interface (ap0) Configuration ________________________________________18
To Configure Network 1 Interface Settings ___________________________________18
To View Network 1 Interface Status ________________________________________19
Network 1 (ap0) Link Settings ________________________________________________19
To Configure Network 1 Link Settings ______________________________________19
To View Network 1 Link Status ____________________________________________20
Network 2 (wlan0) Interface Configuration ______________________________________20
To Configure Network 2 Interface Settings ___________________________________21

xPico® Wi-Fi® Embedded Device Server User Guide 4
To View Network 2 Interface Status ________________________________________21
Network 2 (wlan0) Link Status _______________________________________________21
To View Network 2 Link Status ____________________________________________21
WLAN Profiles ____________________________________________________________22
To Configure WLAN Profiles _____________________________________________22
To Configure WLAN Profile Settings _______________________________________23
WLAN Quick Connect ______________________________________________________24
To Configure WLAN Quick Connect ________________________________________24
5: Line and Tunnel Settings 26
Line Settings _____________________________________________________________26
To Configure Line Settings _______________________________________________26
To View Line Status ____________________________________________________27
Tunnel Settings ___________________________________________________________27
Line Settings __________________________________________________________27
To View Tunnel Serial Settings ___________________________________________27
Packing Mode _________________________________________________________28
To Configure Tunnel Packing Mode Settings _________________________________29
Accept Mode __________________________________________________________29
To Configure Tunnel Accept Mode Settings __________________________________30
Disconnect Mode ______________________________________________________30
To Configure Tunnel Disconnect Mode Settings ______________________________31
Statistics _____________________________________________________________31
To View Tunnel Statistics ________________________________________________31
6: Services Settings 32
HTTP Settings ____________________________________________________________32
To Configure HTTP Settings _____________________________________________32
To View HTTP Status ___________________________________________________32
To Configure HTTP Access Control ________________________________________33
7: Maintenance and Diagnostics Settings 34
Filesystem Settings ________________________________________________________34
Filesystem ___________________________________________________________34
To View Filesystem Statistics _____________________________________________34
System Settings __________________________________________________________34
System Management ___________________________________________________35
To Reboot or Restore Factory Defaults _____________________________________35
Admin User ___________________________________________________________35
To Configure Admin User on the Device ____________________________________35

xPico® Wi-Fi® Embedded Device Server User Guide 5
8: Advanced Settings 36
XML Import and XML Export _________________________________________________36
To Import or Export XML Configuration _____________________________________36
9: Updating Firmware 37
Obtaining Firmware ________________________________________________________37
Loading New Firmware through Web Manager __________________________________37
Appendix A: Technical Support 39
Appendix B: Compliance 40
Federal Communication Commission Interference Statement _______________________42
Radiation Exposure Statement ____________________________________________42
End Product Labeling ___________________________________________________43
Manual Information To the End User _______________________________________43
Industry Canada Statement _________________________________________________43
Radiation Exposure Statement ____________________________________________43
Déclaration d'exposition aux radiations _____________________________________43
End Product Labeling ___________________________________________________44
Plaque signalétique du produit final ________________________________________44
Manual Information To the End User _______________________________________44
Manuel d'information à l'utilisateur final _____________________________________45
Antenna Requirement ___________________________________________________45
Appendix C: Binary to Hexadecimal Conversions 47
Converting Binary to Hexadecimal ____________________________________________47
Conversion Table ______________________________________________________47
Scientific Calculator ____________________________________________________47

xPico® Wi-Fi® Embedded Device Server User Guide 6
List of Figures
Figure 2-2 xPico Wi-Fi Product Label ________________________________________________13
Figure 3-1 Status Page ____________________________________________________________15
Figure 3-2 Components of the Web Manager Page ______________________________________16
Figure 9-1 Uploading New Firmware _________________________________________________37

xPico® Wi-Fi® Embedded Device Server User Guide 7
List of Tables
Table 2-1 Recommended Operating Conditions ________________________________________11
Table 3-3 Web Manager Pages _____________________________________________________17
Table 4-1 Network Interface Settings _________________________________________________18
Table 4-2 Network 1 (ap0) Link Settings ______________________________________________19
Table 4-3 Network Interface Settings _________________________________________________20
Table 4-4 Creating, Deleting or Enabling WLAN Profiles __________________________________22
Table 4-5 WLAN Profile Basic Settings _______________________________________________23
Table 4-6 WLAN Profile Security Settings _____________________________________________23
Table 4-7 WLAN Profile Advanced Settings ___________________________________________24
Table 4-8 WLAN Quick Connect ____________________________________________________25
Table 5-1 Line Configuration Settings ________________________________________________26
Table 5-2 Tunnel Line Settings _____________________________________________________27
Table 5-3 Tunnel Packing Mode Settings _____________________________________________28
Table 5-4 Tunnel Accept Mode Settings ______________________________________________29
Table 5-5 Tunnel Disconnect Mode Settings ___________________________________________31
Table 6-1 HTTP Settings __________________________________________________________32
Table 6-2 HTTP Access Control ____________________________________________________32
Table 7-1 File Display Settings _____________________________________________________34
Table 7-2 Management Settings ____________________________________________________35
Table 7-3 Admin User Settings _____________________________________________________35
Table 2-4 Europe – EU Declaration of Conformity _______________________________________41
Table 2-5 Approved Antenna(s) List _________________________________________________45

xPico® Wi-Fi® Embedded Device Server User Guide 8
1: Using This Guide
Purpose and Audience
This guide provides the information needed to configure, use, and update the xPico® Wi-Fi®
embedded device server. It is intended for software developers and system integrators who are
embedding this product into their designs.
Summary of Chapters
The remaining chapters in this guide include:
Additional Documentation
Visit the Lantronix Web site at www.lantronix.com/support/documentation for the latest
documentation and the following additional documentation.
Chapter Description
2: Introduction Main features of the product and the protocols it supports.
Includes technical specifications.
3: Configuration Using Web Manager Instructions for accessing Web Manager and using it to configure
settings for the device.
4: Network Settings Instructions for configuring network settings.
5: Line and Tunnel Settings Instructions for configuring line and tunnel settings.
6: Services Settings Instructions for configuring HTTP settings.
7: Maintenance and Diagnostics
Settings
Instructions to maintain the xPico Wi-Fi, view statistics, files, and
diagnose problems.
8: Advanced Settings Provides additional information on security settings available.
9: Updating Firmware Instructions for obtaining the latest firmware and updating the
xPico Wi-Fi.
Appendix A: Technical Support Instructions for contacting Lantronix Technical Support.
Appendix B: Compliance Lantronix compliance information.
Appendix C: Binary to Hexadecimal
Conversions
Instructions for converting binary values to hexadecimals.
Document Description
xPico Wi-Fi Embedded Device
Server Integration Guide
Information about the xPico Wi-Fi hardware, testing the device server
using the demonstration board, and integrating the unit into your
product.
xPico Wi-Fi Evaluation Kit
Embedded Device Server Quick
Start Guide
Instructions for getting the xPico Wi-Fi up and running.

1: Using This Guide
xPico® Wi-Fi® Embedded Device Server User Guide 9
xPico Wi-Fi Evaluation Kit
Embedded Device Server User
Guide
Information needed to use the xPico Wi-Fi on the evaluation board.
Com Port Redirector Quick Start
and Online Help
Instructions for using the Lantronix Windows-based utility to create
virtual com ports.
Document (continued) Description

xPico® Wi-Fi® Embedded Device Server User Guide 10
2: Introduction
This chapter summarizes the basic information and features of the xPico Wi-Fi embedded device
server. It provides an overview of key features and describes suitable applications.
Key Features
Wireless LAN Interface:
IEEE 802.11 b/g and IEEE 802.11n (single stream)
WLAN interface (2.4 GHz only)
IEEE 802.11 d/h/i/j/k/w/r
u.FL connector for external antenna
Serial Interface:
Two Serial CMOS Ports (3.3V, 5V tolerant)1
1200 to 921.6Kbps
Flow control: XON/XOFF, RTS/CTS (Line 1 only)
Lantronix tunneling application (Line 1 only)
Host Interface:
Dual Serial Port, SPI, USB2.0 (device)
8 GPIO
Network Protocols: TCP/IP, UDP/IP, DHCP Server (software-enabled Access Point
interface), ARP, ICMP, DHCP Client (WLAN interface), Auto-IP, DNS
Networking Capabilities:
Soft Access Point with DHCP Server
Roaming: continually tracks Wi-Fi signal strength within range, resulting in smooth and
automatic transition between access points without delay.
QuickConnect: Dynamic Profiles facilitate easy and rapid connections to access points
Management and Control:
Web Server
CLI (Serial Monitor Port)
XML Configuration Import and Export (XCR, XML Status Export [XSR])
Field upgradable firmware (OTA)
Security:
IEEE 802.11i Support – WPA-Personal, WPA2-Personal
256-bit AES Encryption
1. For xPico Wi-Fi 5V tolerant pins, in order to sustain a voltage higher than Vcc+0.3, the internal pull up/pull down resistors must
be disabled.

2: Introduction
xPico® Wi-Fi® Embedded Device Server User Guide 11
Architecture:
ARM Cortex-M3 class processor with on-chip Flash and SRAM
1MB Flash and 128KB SRAM
SPI Flash 1 MB
Power: Input Voltage: 3.3VDC
Table 2-1 Recommended Operating Conditions
Physical Interface: 40-pin Board-to-Board SMT Connector
Environmental:
Operating Temperature: –40°to +85° C
Storage Temperature : –40°to +85° C
Relative Humidity: 0% to 90% non-condensing
Certifications: FCC, IC, EU, Japan, UL, CE
Packaging:
Dimensions: 24mm (L) x 16.5mm (W) x 5.64mm (H)
Weight: 2.5g
Warranty: 5-Year Limited
Parameter Symbol Min Typical Max Units
TX Power @ 16.5dBm, 802.11b, 11Mbps ICC 330 380 mA
TX Power @ 15dBm, 802.11g, 6Mbps ICC 300 345 mA
TX Power @ 13dBm, 802.11g, 54Mbps ICC 255 295 mA
TX Power @ 14.5dBm, 802.11n, MCS0 ICC 290 335 mA
TX Power @ 12dBm, 802.11n, MCS7 ICC 230 265 mA
RX Power @ 802.11b, 11Mbps ICC 125 150 mA
RX Power @ 802.11g, 54Mbps ICC 125 150 mA
RX Power @ 802.11n, MCS7 ICC 125 150 mA
Power Management State 1 @ 25°C ICC 6μA
Power Management State 1 @ +85°C ICC 12 μA
Power Management State 1 @ -40°C ICC 5μA

2: Introduction
xPico® Wi-Fi® Embedded Device Server User Guide 12
Protocol Support
The xPico Wi-Fi intelligent gateway contains a full-featured IP stack. Supported protocols include:
IEEE 802.11 b/g and IEEE 802.11n (single stream) WLAN interface (2.4 GHz only)
802.11i - WPA-Personal, WPA2-Personal
Soft-AP with DHCP Server
HTTP Server
TCP/IP, UDP/IP, DHCP Server (Software enabled Access Point interface), ARP, ICMP, DHCP
Client (WLAN interface), Auto-IP, DNS
Troubleshooting Capabilities
The xPico Wi-Fi offers the abilty to view system log messages.
Configuration Methods
After installation, the xPico Wi-Fi embedded device server requires configuration. For the unit to
operate correctly on a network, it must have a unique IP address on the network. These methods
may be used for logging into the xPico Wi-Fi and assigning IP addresses and other configurable
settings:
Web Manager: View and configure settings easily through a web browser using the Lantronix
Web Manager. See “Configuration Using Web Manager” on page 14.
XML: The xPico Wi-Fi supports XML import and XML export through a terminal emulator
software such as Tera Term. See “XML Import and XML Export” on page 36.
Addresses and Port Numbers
Hardware Address
The hardware address is also referred to as the physical address or MAC address. Sample
hardware address:
00-80-A3-FF-FF-FF
00:80:A3:FF:FF:FF
IP Address
Every device connected to an IP network must have a unique IPv4 address. This address
references the specific unit.
Port Numbers
TCP Port 80: HTTP Server (Web Manager configuration)
TCP Port 10001: Tunnel

2: Introduction
xPico® Wi-Fi® Embedded Device Server User Guide 13
Product Information Label
The product information label on the unit contains the following information about the specific unit:
Lantronix Datamatrix Code
Product Revision
Part Number
Serial Number Hardware Address (MAC Address)
Manufacturing Date Code
Figure 2-2 xPico Wi-Fi Product Label

xPico® Wi-Fi® Embedded Device Server User Guide 14
3: Configuration Using Web Manager
This chapter describes how to configure the xPico Wi-Fi embedded device server using Web
Manager, the Lantronix browser-based configuration tool. The unit’s configuration is stored in
nonvolatile memory and is retained without power. All changes take effect immediately, unless
otherwise noted. It contains the following sections:
Accessing Web Manager
Web Manager Components
Navigating Web Manager
Accessing Web Manager
To access Web Manager, perform the following steps:
1. Open a standard web browser. Lantronix supports the latest version of Internet Explorer,
Mozilla Firefox, Safari or Chrome.
2. Enter the IP address or hostname of the xPico Wi-Fi in the address bar. The IP address may
have been assigned manually or automatically by DHCP.
3. Enter your username and password.The factory-default username is “admin” and the
password is “PASSWORD” (all capitalized). The Status web page displays product
information, network settings, line settings, and tunneling settings.

3: Configuration Using Web Manager
xPico® Wi-Fi® Embedded Device Server User Guide 15
Status Page
The Status page is the first to appear after you log into Web Manager. The Status page also
appears when you click Status tab in Web Manager.
Figure 3-1 Status Page

3: Configuration Using Web Manager
xPico® Wi-Fi® Embedded Device Server User Guide 16
Web Manager Components
The layout of a typical Web Manager page is below.
Figure 3-2 Components of the Web Manager Page
Navigating Web Manager
The Web Manager provides an intuitive point-and-click interface. A menu bar on the left side of
each page provides links you can click to navigate between pages. Some pages are read-only,
while others let you change configuration settings.
Note: There may be times when you must reboot the xPico Wi-Fi for the new
configuration settings to take effect. The chapters that follow indicate when a change
requires a reboot. Anytime you reboot the unit, this operation will take some time to
complete. Please wait a minimum of 10-20 seconds after rebooting the unit before
attempting to make any subsequent connections.
Menu Bar
Links to
subpages
Items to
configure
Information
and Help Area
Header
Configuration and/or Status Area
Footer

3: Configuration Using Web Manager
xPico® Wi-Fi® Embedded Device Server User Guide 17
Table 3-3 Web Manager Pages
Web Manager Page Description See
Page
Status Shows product information, network, line status, and tunneling settings. 15
Filesystem Shows file system statistics and lets you perform filesystem operations. 34
HTTP Shows HyperText Transfer Protocol (HTTP) status and lets you change the
current configuration and authentication settings.
32
Line Shows statistics and lets you change the current configuration and Command
mode settings of a serial line.
26
Network Shows status and lets you configure the network interface. 18
System Lets you reboot the device, restore factory defaults and upload new firmware. 34
Tunnel Lets you change the current configuration settings for an incoming tunnel
connection.
27
WLAN Profiles Lets you view, edit, delete and create a WLAN profile on a device. 22
Quick Connect Lets you scan for available network in vicinity and create WLAN profile
easily.
24

xPico® Wi-Fi® Embedded Device Server User Guide 18
4: Network Settings
The Network Settings show the status of the Software enabled Access Point (SoftAP) or WLAN
interface/link and let you configure the settings on the device. Interface settings are related to the
configuration of the IP and related protocols. Link settings are related to the physical link
connection, which carries the IP traffic.
The xPico Wi-Fi embedded device server contains two network interfaces. The Software enabled
Access Point interface is also called interface 1 or ap0, and the WLAN interface is called interface
2 or wlan0.
Note: All network settings require a reboot to take effect. Wait a minimum of 10-20
seconds after rebooting the unit before attempting to make any subsequent connections.
Network 1 Interface (ap0) Configuration
Table 4-1 shows the network interface settings that can be configured. These settings apply to the
Software enabled Access Point (ap0) interface.
Table 4-1 Network Interface Settings
To Configure Network 1 Interface Settings
Using Web Manager
To modify Software enabled Access Point (ap0) settings, go to Network on the menu and
select Network 1 -> Interface -> Configuration.
Using XML via CLI
Include in your file: <configgroup name = "Interface" instance = "ap0">
Network (ap0) Interface
Settings
Description
State Click to enable or disable the SoftAP. If enabled, the DHCP server will assign IP
addresses to the SoftAP’s clients. The DHCP Server manages up to 4 client IP
addresses and the first IP address will be the next IP address after the Access
Point’s IP address (see IP Address description below).
Note: A DHCP lease lasts for a day. If the IP network is managed manually, a
static IP can be used outside the range of the DHCP address pool.
IP Address Enter the static IP address to use for the interface. You may enter it in one of
the following ways:
Alone (i.e., 192.168.1.1)
In CIDR format (i.e., 192.168.1.1/24)
With an explicit mask (i.e., 192.168.1.1 255.255.255.0)

4: Network Settings
xPico® Wi-Fi® Embedded Device Server User Guide 19
To View Network 1 Interface Status
Using Web Manager
In Network Interface Status, you can view both the current operational settings as well as the
settings that would take effect upon a device reboot.
To view current access point (ap0) settings, go to Network on the menu and select Network 1
-> Interface -> Status.
Using XML via CLI
Look for the status header: <statusgroup name = "Interface" instance = "ap0">
Network 1 (ap0) Link Settings
Physical link parameters can be configured for an access point (ap0) Network Interface (see
Table 4-2).
Table 4-2 Network 1 (ap0) Link Settings
To Configure Network 1 Link Settings
Using Web Manager
To modify network (ap0) Link information, click Network on the menu and select Network 1 >
Link > Configuration.
Network 1 (ap0) Link
Settings
Description
Network Name (SSID) Specify the name of the wireless network (SSID) for the SoftAP.
Channel Specify the channel for the SoftAP.
Suite Specify the security suite to be used for the SoftAP.
None = no authentication or encryption method will be used.
WPA = WiFi Protected Access
WPA2 = Robust Secure Network.
Encryption Select one or more encryption types, listed from strongest to least strong.
CCMP = Uses AES as basis and is the strongest encryption option.
TKIP = Uses WEP as the basis, but adds extra checks and variations for
added protection.
Passphrase Select the passphrase which may consist of up to 63 characters.
Note: This configuration option becomes available only when suites WPA
or WPA2 are selected. Lantronix recommends using a passphrase of 20
characters or more for maximum security. Spaces and punctuation
characters are permitted. The passphrase input is not the same as ASCII
input (as used on some products.) ASCII is translated directly into
hexadecimal bytes according to the ASCII table, while a possibly larger
passphrase is hashed into a key and provides better security through a
larger range of key values.

4: Network Settings
xPico® Wi-Fi® Embedded Device Server User Guide 20
Using XML via CLI
Include in your file: <configgroup name = "Access Point" instance = "ap0">
To View Network 1 Link Status
Using Web Manager
In Network Link Status, you can view the current operational settings.
To view current network (ap0) settings, go to Network on the menu and select Network 1 ->
Link -> Status.
Using XML via CLI
Look for the status header: <statusgroup name = "Interface" instance = "ap0">
Network 2 (wlan0) Interface Configuration
This page is used to configure the network 2 interface on the device. To see the effect of these
items after a reboot, view the Status page.
Table 4-3 Network Interface Settings
Network Interface
Settings
Description
State Click to enable or disable the WLAN interface.
DHCP Client Select to turn the DHCP client either On or Off. If enabled, any configured IP
address, network mask, gateway or hostname will be ignored. DHCP will auto-
discover and eclipse those configured items. When DHCP fails to discover an
IP address, a new address will automaticaly be generated using AutoIP. This
address will be within the 169.254.x.x space. At boot up, after the physical
link is up, the xPico Wi-Fi will attempt to obtain IP settings from a DHCP server
and will periodically renew these settings with the server.
Note: Click renew on Interface Status page to force DHCP lease renewal.
IP Address Enter the static IP address to use for the interface. You may enter it in one of
the following ways:
Alone (i.e., 192.168.1.1)
In CIDR format (i.e., 192.168.1.1/24)
With an explicit mask (i.e., 192.168.1.1 255.255.255.0)
Note: This setting will be used if Static IP is active (DHCP Client is Off).
Default Gateway Enter the IP address of the router for this network.
Note: This setting will be used if Static IP is active (DHCP Client is Off).
Hostname Enter the hostname for the interface. It must begin with a letter, continue with a
letter, number or hyphen, and must end with a letter or number. The device will
not register the hostname with a DNS server until the next reboot.
Primary DNS Enter the IP address of the primary Domain Name Server.
Note: This setting will be used when Static IP is active.