Lantronix 900-691-R User Manual
xPico Wi-Fi
Embedded Device Server
User Guide
Part Number 900-691-R
Revision D February 2014
Intellectual Property
© 2014 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. U.S. Patents 7,309,260; 8,024,446; 8,219,661; 7,698,405. Additional 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: 949-453-3990
Fax: 949-453-3995
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).
November 2013 B Updated serial port information.
January 2014 C Updated for firmware 1.1.0.2. to include new CPM, diagnostics, modem
February 2014 D Updated for firmware version 1.1.0.2R10.
.
emulation, monitor, performance, SPI, XML, CLI and command
reference information.
xPico® Wi-Fi® Embedded Device Server User Guide 2
Table of Contents
Intellectual Property ________________________________________________________2
Warranty _________________________________________________________________2
Contacts _________________________________________________________________2
Disclaimer ________________________________________________________________2
Revision History ___________________________________________________________2
List of Figures _____________________________________________________________8
List of Tables _____________________________________________________________9
1: Using This Guide 11
Purpose and Audience _____________________________________________________11
Summary of Chapters ______________________________________________________11
Additional Documentation ___________________________________________________12
2: Introduction 13
Key Features _____________________________________________________________13
Protocol Support _________________________________________________________14
Troubleshooting Capabilities _________________________________________________14
Configuration Methods _____________________________________________________15
Addresses and Port Numbers ________________________________________________15
Hardware Address _____________________________________________________15
IP Address ___________________________________________________________15
Port Numbers _________________________________________________________15
Product Information Label ___________________________________________________15
3: Configuration Using Web Manager 17
Accessing Web Manager ___________________________________________________17
Status Page ______________________________________________________________18
Web Manager Components _________________________________________________19
Navigating Web Manager ___________________________________________________19
4: Network Settings 21
Network 1 Interface (ap0) Configuration ________________________________________21
To Configure Network 1 Interface Settings ___________________________________21
To View Network 1 Interface Status ________________________________________22
Network 1 (ap0) Link Settings ________________________________________________22
To Configure Network 1 Link Settings ______________________________________23
To View Network 1 Link Status ____________________________________________23
Network 2 (wlan0) Interface Configuration ______________________________________24
xPico® Wi-Fi® Embedded Device Server User Guide 3
To Configure Network 2 Interface Settings ___________________________________24
To View Network 2 Interface Status ________________________________________25
Network 2 (wlan0) Link Status _______________________________________________25
To View Network 2 Link Status ____________________________________________25
WLAN Profiles ____________________________________________________________25
To Configure WLAN Profiles _____________________________________________26
To Configure WLAN Profile Settings _______________________________________26
WLAN Quick Connect ______________________________________________________28
To Configure WLAN Quick Connect ________________________________________28
5: Interface Settings 30
Line Settings _____________________________________________________________30
To Configure Line Settings _______________________________________________31
To View Line Status ____________________________________________________31
Serial Perpheral Interface (SPI) Settings _______________________________________32
To Configure SPI Settings _______________________________________________32
To View SPI Status _____________________________________________________33
6: Tunnel Settings 34
Tunnel Settings ___________________________________________________________34
Line Settings __________________________________________________________34
To View Tunnel Serial Settings ___________________________________________34
Packing Mode _________________________________________________________35
To Configure Tunnel Packing Mode Settings _________________________________36
Accept Mode __________________________________________________________36
To Configure Tunnel Accept Mode Settings __________________________________37
Connect Mode ________________________________________________________38
To Configure Tunnel Connect Mode Settings ________________________________39
Disconnect Mode ______________________________________________________39
To Configure Tunnel Disconnect Mode Settings ______________________________40
Statistics _____________________________________________________________40
To View Tunnel Statistics ________________________________________________40
Modem Emulation Settings __________________________________________________40
7: Configurable Pin Manager 43
Configurable Pin Status ____________________________________________________43
Roles ___________________________________________________________________44
To Configure CPM Settings ______________________________________________45
8: Services Settings 46
HTTP Settings ____________________________________________________________46
To Configure HTTP Settings and Access Control _____________________________46
xPico® Wi-Fi® Embedded Device Server User Guide 4
To View HTTP Status ___________________________________________________47
9: Maintenance and Diagnostics Settings 48
File System Settings _______________________________________________________48
File System Statistics ___________________________________________________48
To View File System Statistics, Compact or Format the File System _______________48
File Display ___________________________________________________________48
To Display Files _______________________________________________________48
File Manipulation ______________________________________________________49
To Transfer or Modify File System Files _____________________________________49
Device Settings ___________________________________________________________49
Device Management ____________________________________________________49
To Save Configuration, Reboot, Restore Factory Defaults or Upload Firmware ______50
Admin User ______________________________________________________________50
To Configure Admin User on the Device ____________________________________50
Diagnostics Settings _______________________________________________________51
To View Hardware Status ________________________________________________51
To View IP Socket Status ________________________________________________51
To View Buffer Pool Status _______________________________________________51
10: Advanced Settings 52
XML Import and XML Export _________________________________________________52
To Import or Export XML Configuration _____________________________________52
Performance Settings ______________________________________________________53
To Configure Performance _______________________________________________54
11: Monitor 55
Monitor Settings __________________________________________________________55
Explorer _____________________________________________________________55
Configuration _________________________________________________________57
To Configure Monitor ___________________________________________________59
Example: Data Capture on a Serial Device _____________________________________60
Initialization ___________________________________________________________60
Polling _______________________________________________________________61
Filtering ______________________________________________________________62
Data Mining __________________________________________________________63
Presenting ___________________________________________________________64
DATA CAPTURE ON SPI ___________________________________________________65
12: Branding the xPico Wi-Fi Unit 66
Web Manager Customization ________________________________________________66
Changing the Presentation _______________________________________________66
xPico® Wi-Fi® Embedded Device Server User Guide 5
Path Format __________________________________________________________66
Other Overridable Files _________________________________________________67
13: Updating Firmware 68
Obtaining Firmware ________________________________________________________68
Loading New Firmware through Web Manager __________________________________68
Appendix A: Command Reference 70
Conventions _____________________________________________________________70
XML Architecture and Device Control __________________________________________70
Configuration Using Serial Port _______________________________________________71
Boot to CLI ___________________________________________________________71
Navigating the CLI Hierarchy ________________________________________________72
Using Keyboard Shortcuts and CLI ____________________________________________72
Understanding the CLI Level Hierarchy ________________________________________73
Configuration Using XML ___________________________________________________73
XML Configuration Record Document Type Definition _____________________________74
Quick Tour of XML Syntax __________________________________________________75
Declaration ___________________________________________________________75
Element Start and End Tags _____________________________________________75
Element Attributes _____________________________________________________75
Record, Group, Item, and Value Tags _________________________________________76
XML for xPicoWi-Fi Embedded Device Server ___________________________________77
Appendix B: WebAPI 100
Export Status Group ______________________________________________________100
Export Configuration Group ________________________________________________100
Take Status Action _______________________________________________________101
Import Configuration Group _________________________________________________102
Appendix C: Technical Support 103
North America ___________________________________________________________103
Europe, Middle East, Africa (EMEA) __________________________________________103
Japan _________________________________________________________________103
Asia / Pacific (APAC) _____________________________________________________103
China __________________________________________________________________103
Latin America & Caribbean _________________________________________________104
Online _________________________________________________________________104
Appendix D: Compliance 105
Federal Communication Commission Interference Statement ______________________107
Radiation Exposure Statement ___________________________________________107
xPico® Wi-Fi® Embedded Device Server User Guide 6
End Product Labeling __________________________________________________108
Manual Information To the End User ______________________________________108
Industry Canada Statement ________________________________________________108
Radiation Exposure Statement ___________________________________________108
Déclaration d'exposition aux radiations ____________________________________108
End Product Labeling __________________________________________________109
Plaque signalétique du produit final _______________________________________109
Manual Information To the End User ______________________________________109
Manuel d'information à l'utilisateur final ____________________________________110
Antenna Requirement __________________________________________________110
Appendix E: Binary to Hexadecimal Conversions 112
Converting Binary to Hexadecimal ___________________________________________112
Conversion Table _____________________________________________________112
Scientific Calculator ___________________________________________________112
xPico® Wi-Fi® Embedded Device Server User Guide 7
List of Figures
Figure 2-1 xPico Wi-Fi Product Label ________________________________________________16
Figure 3-1 Status Page ____________________________________________________________18
Figure 3-2 Components of the Web Manager Page ______________________________________19
Figure 11-7 Monitor Initialization ____________________________________________________60
Figure 11-8 Monitor Polling (1 of 2)___________________________________________________61
Figure 11-9 Monitor Polling (2 of 2)___________________________________________________61
Figure 11-10 Monitor Filtering (1 of 2)_________________________________________________62
Figure 11-11 Monitor Filtering (2 of 2)_________________________________________________62
Figure 11-12 Monitor Data Mining (1 of 2) _____________________________________________63
Figure 11-13 Monitor Data Mining (2 of 2) _____________________________________________63
Figure 11-14 Monitor Presenting_____________________________________________________64
Figure 11-15 Monitor CLI Command Level_____________________________________________64
Figure 11-16 Monitor XML Commands________________________________________________65
Figure 13-1 Uploading New Firmware ________________________________________________68
Figure A-2 Root Level Commands ___________________________________________________73
Figure A-3 DTD for XCRs __________________________________________________________74
Figure A-4 XML Example __________________________________________________________75
Figure A-5 XML Example __________________________________________________________76
Figure E-2 Windows Scientific Calculator _____________________________________________113
Figure E-3 Hexadecimal Values in the Scientific Calculator ______________________________113
xPico® Wi-Fi® Embedded Device Server User Guide 8
List of Tables
Table 3-3 Web Manager Pages _____________________________________________________20
Table 4-1 Network Interface Settings _________________________________________________21
Table 4-2 Network 1 (ap0) Link Settings ______________________________________________22
Table 4-3 Network Interface Settings _________________________________________________24
Table 4-4 Creating, Deleting or Enabling WLAN Profiles __________________________________26
Table 4-5 WLAN Profile Basic Settings _______________________________________________27
Table 4-6 WLAN Profile Security Settings _____________________________________________27
Table 4-7 WLAN Profile Advanced Settings ___________________________________________28
Table 4-8 WLAN Quick Connect ____________________________________________________29
Table 5-1 Line Configuration Settings ________________________________________________30
Table 5-2 SPI Configuration Settings _________________________________________________32
Table 6-1 Tunnel Line Settings _____________________________________________________34
Table 6-2 Tunnel Packing Mode Settings _____________________________________________35
Table 6-3 Tunnel Accept Mode Settings ______________________________________________36
Table 6-4 Tunnel Connect Mode Settings _____________________________________________38
Table 6-5 Tunnel Disconnect Mode Settings ___________________________________________39
Table 6-6 Modem Emulation Settings ________________________________________________40
Table 6-7 Modem Emulation Commands and Descriptions _____________________________41
Table 7-1 Current Configurable Pins _________________________________________________43
Table 7-2 CP Status ______________________________________________________________43
Table 7-3 Role Configuration _______________________________________________________45
Table 8-1 HTTP Settings __________________________________________________________46
Table 9-1 File System Statistics Settings ______________________________________________48
Table 9-2 Device Management Settings ______________________________________________49
Table 9-3 Admin User Settings _____________________________________________________50
Table 10-1 Performance Settings ___________________________________________________53
Table 11-1 Monitor Explorer Settings _________________________________________________55
Table 11-2 Monitor Initialization Settings ______________________________________________57
Table 11-3 Monitor Control Settings _________________________________________________57
Table 11-4 Monitor Poll Settings ____________________________________________________58
Table 11-5 Monitor Filter Settings ___________________________________________________58
Table 11-6 Monitor Data Settings ___________________________________________________59
Table A-1 Keyboard Shortcuts ______________________________________________________72
Table D-1 Country Certifications ___________________________________________________105
Table D-2 Country Transmitter IDs _________________________________________________105
xPico® Wi-Fi® Embedded Device Server User Guide 9
Table D-3 Safety _______________________________________________________________106
Table D-4 Europe – EU Declaration of Conformity _____________________________________106
Table D-5 Approved Antenna(s) List ________________________________________________110
Table E-1 Binary to Hexadecimal Conversion _________________________________________112
xPico® Wi-Fi® Embedded Device Server User Guide 10
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:
Chapter Description
2: Introduction Main features of the product and the protocols it supports.
3: Configuration Using Web Manager Instructions for accessing Web Manager and using it to configure
4: Network Settings Instructions for configuring network settings.
5: Interface Settings Instructions for configuring various interface settings.
6: Tunnel Settings Instructions for configuring tunnel settings.
7: Configurable Pin Manager Information about the Configurable Pin Manager (CPM) and how
8: Services Settings Instructions for configuring HTTP settings.
9: Maintenance and Diagnostics
Settings
10: Advanced Settings Provides additional information on security settings available.
11: Monitor Instructions for configuring monitor settings.
12: Branding the xPico Wi-Fi Unit Instructions for branding the Web Manager user interface.
13: Updating Firmware Instructions for obtaining the latest firmware and updating the
Appendix A: Command Reference Information on configuring settings using XML or the command
Appendix B: WebAPI Instructions for viewing status information and configuring a unit
Appendix C: Technical Support Instructions for contacting Lantronix Technical Support.
Appendix D: Compliance Lantronix compliance information.
Appendix E: Binary to Hexadecimal
Conversions
Includes technical specifications.
settings for the device.
to set the configurable pins to work with a device.
Instructions to maintain the xPico Wi-Fi, view statistics, files, and
diagnose problems.
xPico Wi-Fi.
line interface.
through HTTP request.
Instructions for converting binary values to hexadecimals.
xPico® Wi-Fi® Embedded Device Server User Guide 11
Additional Documentation
Visit the Lantronix Web site at www.lantronix.com/support/documentation for the latest
documentation and the following additional documentation.
Document Description
xPico Wi-Fi Embedded Device
Server Integration Guide
xPico Wi-Fi Evaluation Kit
Embedded Device Server Quick
Start Guide
xPico Wi-Fi Evaluation Kit
Embedded Device Server User
Guide
1: Using This Guide
Information about the xPico Wi-Fi hardware, testing the device server
using the demonstration board, and integrating the unit into your
product.
Instructions for getting the xPico Wi-Fi unit up and running.
Information needed to use the xPico Wi-Fi embedded device serer on
the evaluation board.
xPico® Wi-Fi® Embedded Device Server User Guide 12
2: Introduction
This chapter summarizes the basic information and features of the xPico Wi-Fi embedded device
server.
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
- IEEE 802.11i Support - WEP(Client only), WPA-Personal, WPA2-Personal
- u.FL connector for external antenna
- Soft Access Point with DHCP Server
- Simultaneous SoftAP and Client
- 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
Host Interface:
- Serial Interface
Two Serial CMOS Ports 1200 to 921.6 Kbps
Flow control: XON/XOFF, RTS/CTS (Line 1 only)
Lantronix tunneling application
Modem Emulation Mode
- SPI Interface
Configurable slave/master SPI interface that can be clocked at 30MHz.
- USB Interface 2.0 (device)
USB2.0 (12 Mbps) Full Speed Device port interfaces for connection to an upstream USB
device.
Support for USB CDC Serial profile (Future Release, contact Lantronix for more
information).
- GPIO Interface
8 configurable general purpose Input/Output pins
Custom pin manager
Network Protocols: TCP/IP, UDP/IP, DHCP Server (software-enabled Access Point
interface), ARP, ICMP, DHCP Client (WLAN interface), Auto-IP, DNS, HTTP
Management and Control:
- Web Server
xPico® Wi-Fi® Embedded Device Server User Guide 13
- CLI (Serial Monitor Port)
- XML Configuration Import and Export (XCR, XML Status Export [XSR])
- WebAPI
- Field upgradable firmware (OTA)
- Power Management Framework
- OEM Support Kit
- Simple Customization and device configuration management
Security:
- 256-bit AES encryption
Architecture:
- ARM Cortex-M3 class processor with on-chip Flash and SRAM
- 1 MB Flash and 128KB SRAM
- SPI Flash 1 MB
- Zero Host Load Driver
Physical Interface: 40-pin Board-to-Board SMT Connector
2: Introduction
Certifications: FCC, IC, EU, Japan, UL, CE
Warranty: 5-Year Limited
Protocol Support
The xPico Wi-Fi embedded device server 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 device offers the abilty to view Trouble Log messages (see Line Settings on page
30).
xPico® Wi-Fi® Embedded Device Server User Guide 14
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 17.
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 52.
Command Mode: Access the Command Mode (CLI) by connecting a PC or other host
running a terminal emulation program to the unit’s serial port. See “Command Reference” on
page 70.
Addresses and Port Numbers
Hardware Address
The hardware address is also referred to as the physical address or MAC address. Sample
hardware address:
2: Introduction
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 (Line 1)
TCP Port 10002: Tunnel (Line 2)
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
xPico® Wi-Fi® Embedded Device Server User Guide 15
Figure 2-1 xPico Wi-Fi Product Label
2: Introduction
xPico® Wi-Fi® Embedded Device Server User Guide 16
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 browsers.
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.
xPico® Wi-Fi® Embedded Device Server User Guide 17
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.
3: Configuration Using Web Manager
Figure 3-1 Status Page
xPico® Wi-Fi® Embedded Device Server User Guide 18
Web Manager Components
Menu Bar
Links to
subpages
Items to
configure
Information
and Help Area
Header
Configuration and/or Status Area
Footer
The layout of a typical Web Manager page is below.
Figure 3-2 Components of the Web Manager Page
3: Configuration Using Web Manager
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.
xPico® Wi-Fi® Embedded Device Server User Guide 19
3: Configuration Using Web Manager
Table 3-3 Web Manager Pages
Web Manager Page Description See
Page
Status Shows product information, network, line status, and tunneling settings. 18
CPM Shows information about the Configurable Pins Manager (CPM) and how to
set the configurable pins and roles to work with a device.
Device Lets you reboot the device, restore factory defaults and upload new firmware. 49
Diagnostics Lets you perform various diagnostic procedures. 51
File System Shows file system statistics and lets you perform file system operations. 48
HTTP Shows HyperText Transfer Protocol (HTTP) status and lets you change the
current configuration and authentication settings.
Line Shows statistics and lets you change the current configuration and Command
mode settings of a serial line.
Modem Emulation Lets you view and configure Modem Emulation. 40
Monitor Lets you query and capture information during serial port to serial device
connection.
Network Shows status and lets you configure the network interface. 21
Quick Connect Lets you scan for available network in vicinity and create WLAN profile easily. 28
Performance Lets you change settings effecting performance. 53
SPI Lets you configure SPI settings. 32
Tunnel Lets you change the current configuration settings for an incoming tunnel
connection.
Users Lets you configure Admin User password. 50
43
46
34
55
34
WLAN Profiles Lets you view, edit, delete and create a WLAN profile on a device. 25
xPico® Wi-Fi® Embedded Device Server User Guide 20
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 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
Network (ap0) Interface
Settings
State Click to enable or disable the SoftAP. If enabled, the DHCP server will assign IP
IP Address Enter the static IP address to use for the interface. You may enter it in one of
Description
addresses to the SoftAP’s clients. A maximum of four clients can be connected
to the SoftAP interface if the STA interface is disabled. If the STA interface is
enabled a maximum of three clients may be connected.
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.
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)
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 ap0 -> Interface -> Configuration.
Using CLI
To enter the Interface command level: config -> Interface <instance>
Using XML
Include in your file: <configgroup name = "Interface" instance = "ap0">
xPico® Wi-Fi® Embedded Device Server User Guide 21
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 ap0 ->
Interface -> Status.
Using CLI
To enter the Interface command level: status -> Interface <instance>
Using XML
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).
4: Network Settings
Table 4-2 Network 1 (ap0) Link Settings
Network 1 (ap0) Link
Settings
SSID Specify the name of the wireless network (SSID) for the SoftAP.
Channel Specify the channel for the SoftAP.
Suite
Encryption
Passphrase
Description
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.
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.
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.
xPico® Wi-Fi® Embedded Device Server User Guide 22
4: Network Settings
Network 1 (ap0) Link
Settings (continued)
Mode Select the desired mode for the link connection from the drop-down menu:
Uptime Enter the length of uptime for the link connection.
Description
Always Up: when enabled, the SoftAP is always on.
Triggered: when enabled, the SoftAP operates in Triggered mode.
Triggered AP mode is a means to enable the xPico Wi-Fi SoftAP via a
hardware signal. This allows a user to have the SoftAP operating only
when an external signal/button is activated. This might be useful when
power consumption is a concern yet the SoftAP is needed. One
potential use is device provisioning. When triggered, the SoftAP will
remain active for the configured uptime waiting for a client to connect. If
no client connects before the uptime expires, the SoftAP goes back
down. If one or more clients connect, the SoftAP will remain active until
the last client disconnects, at which point it will go down. Refer to
Chapter 7: Configurable Pin Manager for details on how to set up the
xPico Wi-Fi unit for this feature
To Configure Network 1 Link Settings
Using Web Manager
To modify network (ap0) Link information, click Network on the menu and select apo > Link >
Configuration.
Using CLI
To enter the Access Point command level: config -> Access Point
Using XML
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 ap0 -> Link ->
Status.
Using CLI
To enter the Access Point command level: status -> Access Point
Using XML
Look for the status header: <statusgroup name = "Access Point" instance =
"ap0">
xPico® Wi-Fi® Embedded Device Server User Guide 23
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
4: Network Settings
Network Interface
Settings
State Click to enable or disable the WLAN interface.
DHCP Client Click to enable or disable the DHCP client. If enabled, any configured IP
IP Address Enter the static IP address to use for the interface. You may enter it in one of
Default Gateway Enter the IP address of the router for this network.
Hostname Enter the hostname for the interface. It must begin with a letter, continue with a
Primary DNS Enter the IP address of the primary Domain Name Server.
Description
address, network mask, gateway or hostname will be ignored. DHCP will autodiscover 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.
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).
Note: This setting will be used if Static IP is active (DHCP Client is Off).
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.
Note: This setting will be used when Static IP is active.
Secondary DNS Enter the IP address of the secondary Domain Name Server.
Note: This setting will be used when Static IP is active.
To Configure Network 2 Interface Settings
Using Web Manager
To modify network 2 WLAN interface information, click Network on the menu and select
wlan0 > Interface > Configuration.
Using CLI
To enter the Interface command level: config -> Interface <instance>
xPico® Wi-Fi® Embedded Device Server User Guide 24
4: Network Settings
Using XML
Include in your file: <configgroup name = "Interface" instance = "wlan0">
To View Network 2 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 affect upon a device reboot.
To view current access piont (ap0) settings, go to Network on the menu and select wlan0 ->
Interface -> Status.
Using CLI
To enter the WLAN command level: status -> WLAN
Using XML
Look for the status header: <statusgroup name = "Interface" instance =
"wlan0">
Network 2 (wlan0) Link Status
This page shows status of a Link on the device.
To View Network 2 Link Status
Using Web Manager
To view network 2 link interface information, click Network on the menu and select wlan0 >
Link > Status.
Using CLI
To enter the WLAN command level: status -> WLAN
Using XML
Include in your file: <configgroup name = "Interface" instance = "wlan0">
WLAN Profiles
A WLAN profile defines all of the settings necessary to establish a wireless connection with an
access point (in infrastructure mode). A maximum of four profiles can exist on the xPico Wi-Fi
embedded device server at a time and only one profile may be active at any given time.
The xPico Wi-Fi device supports dynamic profiles. Dynamic Profiles are the ones created via
QuickConnect.
xPico® Wi-Fi® Embedded Device Server User Guide 25
4: Network Settings
WLAN Profile WEP Settings
WEP is a simple and efficient security mode encrypting the data via the RC4 algorithm. However,
WEP has become more vulnerable due to advances in hacking technology. State of the art
equipment can find WEP keys in five minutes. For stronger security, please use WPA, or better,
WPA2 with AES (CCMP). WEP is only supported on the STA interface.
WLAN Profile WPA and WPA2 Settings
WPA is a security standard specified by the WiFi Alliance and is a close derivative of an early draft
of the IEEE802.11i specification. WEP was becoming vulnerable when finalizing the IEEE802.11i
standard was still far away. WPA2 is WiFi’s subset of the broad IEEE802.11i standard to enforce
better interoperability. The xPico Wi-Fi embedded device server is compliant with both WPA2 and
IEEE802.11i.
To Configure WLAN Profiles
You can view, edit, create or delete a WLAN profile.
Using WebManager
Click WLAN Profiles on the menu.
Using CLI
To enter the WLAN Profile command level: config -> WLAN Profile <instance>
Using XML
Include in your file: <configgroup name = "WLAN Profile" instance = "name">
Table 4-4 Creating, Deleting or Enabling WLAN Profiles
WLAN Profile Basic Settings Description
Create new profile Type the name of the new profile to be created into the Create new
WLAN Profile field. Then, click the Submit button which appears to
create the profile. Once created, the profile name may be clicked so you
may edit profile settings.
Delete (checkbox) Click the Delete checkbox beside the profile(s) to be deleted. Two
buttons will appear:
Click the Apply button to delete the profile for testing purposes. If the
device reboots, this change will not be applied.
Click the Submit button to permanently delete profile(s).
View or Edit
(link to specific profile)
Click on a specific WLAN Profile name to edit the WLAN profile basic
settings.
To Configure WLAN Profile Settings
Using Web Manager
To view or edit an existing WLAN profile, click WLAN Profiles on the menu and select an
existing profile (see Table 4-5, Table 4-6 and Table 4-7).
xPico® Wi-Fi® Embedded Device Server User Guide 26
4: Network Settings
Using CLI
To enter the WLAN Profile command level: config -> WLAN Profile <instance>
Using XML
Include in your file: <configgroup name = "WLAN Profile" instance = "name">
Table 4-5 WLAN Profile Basic Settings
WLAN Profile Basic
Description
Settings
Network Name (SSID) Specify the name of the wireless network (SSID.)
State Select to enable or disable this profile.
Table 4-6 WLAN Profile Security Settings
WLAN Profile
Security Settings
Suite Specify the security suite to be used for this profile.
Key Size Select the appropriate key size in bits. Select 40 for WEP40 and WEP64; select
TX Key Index Select one of four index listing keys for transmitting data. Reception is allowed
Key 1-4 Enter one or more encryption keys in hexadecimal format. Enter 10 hexadecimal
WPAx Key Type Select the format of the security key.
WPAx Key Enter the WPAx key.
Description
None = no authentication or encryption method will be used.
WEP = Wired Equivalent Privacy
WPA = WiFi Protected Access
WPA2 = Robust Secure Network.
104 for WEP104 and WEP128.
Note: This option is available if WEP suite is selected above.
with all four keys.
Note: For operability with some products that generate four identical keys from a
passphrase, this index must be one. This option is available if WEP suite is
selected above.
digits (0-9, a-f) for WEP40 and 26 for WEP104. The configured keys are not
shown for security reasons.
Note: This option is available if WEP suite is selected above.
Note: This configuration option becomes available only when suites, WPA or
WPA2 are selected.
Note: This configuration option becomes available only when suites, WPA or
WPA2 are selected and the Hex key type is selected.
xPico® Wi-Fi® Embedded Device Server User Guide 27
4: Network Settings
WLAN Profile
Security Settings
WPAX Passphrase Select the password consists of up to 63 characters.
WPAx Encryption Select one or more encryption types, listed from strongest to least strong. At least
Description
Note: 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. This configuration option becomes
available only when suites, WEP, WPA or WPA2 are selected.
one selection will have to match the Access Points intended to connect with.
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.
Note: In case the encryption settings on the Access Point(s) can still be chosen,
the capabilities of the Access Point(s) and the other clients that need to use the
network need to be taken into account.This configuration option becomes
available only when suites WPA or WPA2 are selected.
Table 4-7 WLAN Profile Advanced Settings
WLAN Profile Advanced Settings Description
TX Power Maximum Specify the maximum transmission output power in dBm.
Power Management Select to Enable or Disable power management, which reduces the
Power Management Interval Select number of beacons (100 msec interval) between 1 and 5. The
WLAN Quick Connect
WLAN QuickConnect allows users to view and add up to four WLAN profiles from a list of up to 20
wireless devices sorted by RSSI. Details of the selected network are pre-populated, so little or no
configuration is required by the user.
To Configure WLAN Quick Connect
Using Web Manager
To view or edit an existing WLAN Quick Connect settings, click QuickConnect on the menu.
overall power consumption of the xPico Wi-Fi unit, but can increase
latency.
Enabled = allows the xPico Wi-Fi to turn off the receiver when it is
idling.
Disabled = keeps the receiver on at all times.
above-mentioned latency can be up to this number “X” 100 msec.
Using CLI
Not applicable.
xPico® Wi-Fi® Embedded Device Server User Guide 28
Using XML
Not applicable.
4: Network Settings
Table 4-8 WLAN Quick Connect
WLAN Quick Connect
Settings
Network Name (search field) Enter a network name and click Scan to search for a network.
Scan “<network SSID>” Perform a scan for devices within range of the xPico Wi-Fi. Including the
Network Name (link) Lists the SSID of a network. Click a specific Network Name to display the
BSSID Lists the basic service set identifier. This is a unique 48-bits address that
CH Provides the channel number of a network.
RSSI Displays an instantaneous value indicating the signal strength of the
Security Suite Lists the security suite of a network (e.g., WEP, WPA, WPA2).
Description
optional network SSID limits the scan to devices configured with the
specified network SSID. Omitting the network SSID performs a scan for all
devices in range.
Quick Connect profile. If you provide the Password for a specific Quick
Connect Profile, you can add that profile to your list of WLAN Profiles. Up
to four WLAN profiles may be added, and only one may be connected at
any given time.
identifies the access point that creates the wireless network.
network. The best to worst signal strength is indicated by green, yellow and
red respectively.
Note: RSSI reported in scan results is a single sampling.
xPico® Wi-Fi® Embedded Device Server User Guide 29
5: Interface Settings
Line Settings
The Line Settings allow configuration of the serial lines (ports). Some settings may be specific to
only certain lines. Such settings are noted below.
Note: The settings described below apply to both Line 1 and Line 2 unless otherwise
noted.
Table 5-1 Line Configuration Settings
Line Settings Description
Name Enter a name or short description for the line, if desired. By default, there is
no name specified. A name that contains white space must be quoted.
State Select to Enable or Disable the operational state of the Line. The default is
an enabled state.
Protocol Set the operational protocol for the Line. The default is Tunnel for Line 1 and
Command Line for Line 2. Choices are:
Command Line
Modem Emulation
Monitor
None
Trouble Log
Tunnel = Serial-Network tunneling protocol (Line 1 only)
Baud Rate Set the Baud Rate (speed) of the Line. The default is 9600.
A custom speed or any set speed between 1200 and 921600 may be
selected: 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200, 230400,
460800, 921600. If a custom speed is selected, indicate the bits per second in
the field which appears.
Parity Set the Parity of the Line. The default is None.
Note: Serial lines do not support the following Data Bit/Parity combinations:
a) 7 Data Bits with No Parity and 1 Stop Bit.
b) 8 Data Bits with 2 Stop Bits.
Data Bits Set the number of data bits for the Line. The default is 8.
Note: Serial lines do not support the following Data Bit/Parity combinations:
a) 7 Data Bits with No Parity and 1 Stop Bit.
b) 8 Data Bits with 2 Stop Bits.
Stop Bits Set the number of stop bits for the Line. The default is 1.
Flow Control Set the flow control for the Line. The default is None. Hardware flow control is
only supported on Line 1.
Xon Char Specify the Xon Character which is used when Flow Control is set to
Software. Set the prefix in one of the three ways:
Prefix decimal with prefix hexadecimal and 0x
Prefix hexadecimal with 0x
Prefix as a single control character with <control>
xPico® Wi-Fi® Embedded Device Server User Guide 30
Loading...