Lantronix PremierWave User Manual
PremierWave EN
Embedded System on Module
User Guide
Part Number 900-579
Revision G March 2017
Intellectual Property
© 2017 Lantronix, Inc. All rights reserved. No part of the contents of this publication may be
transmitted or reproduced in any form or by any means without the written permission of Lantronix.
Lantronix and PremierWave are registered trademarks of Lantronix, Inc. in the United States and
other countries. DeviceInstaller is a trademark of Lantronix, Inc.
Patented: patents.lantronix.com
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.
Safari is a registered trademark of Apple Inc. Wi-Fi is a trademark of Wi-Fi Alliance Corporation.
Python is a trademark of Python Software Foundation. All other trademarks and trade names are
the property of their respective holders.
Open Source Software
Some applications are Open Source software licensed under the Berkeley Software Distribution
(BSD) license, the GNU General Public License (GPL) as published by the Free Software
Foundation (FSF), or the Python Software Foundation (PFS) License Agreement for Python 2.7.3
(Python License). Lantronix grants you no right to receive source code to the Open Source
software; however, in some cases, rights and access to source code for certain Open Source
software may be available directly from Lantronix’ licensors. Your use of each Open Source
component or software is subject to the terms of the applicable license. The BSD license is
available at http://opensource.org/licenses. The GNU General Public License is available at
http://www.gnu.org/licenses/
Docs/license.html. Your use of each Open Source component or software is subject to the terms
of the applicable license.
OPEN SOURCE SOFTWARE IS DISTRIBUTED WITHOUT ANY WARRANTY, INCLUDING ANY
IMPLIED WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
SEE THE APPLICABLE LICENSE AGREEMENT FOR ADDITIONAL INFORMATION.
; additional patents pending.
. The Python License is available at http://cmpt165.csil.sfu.ca/Python-
Warranty
For details on the Lantronix warranty policy, please go to our web site at
www.lantronix.com/support/warranty
.
Contacts
Lantronix, Inc.
7535 Irvine Center Drive
Suite 100
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
PremierWave® EN Embedded System on Module User Guide 2
.
Disclaimer
All information contained herein is provided “AS IS.” Lantronix undertakes no obligation to
update the information in this publication. Lantronix does not make, and specifically disclaims,
all warranties of any kind (express, implied or otherwise) regarding title, non-infringement, fitness,
quality, accuracy, completeness, usefulness, suitability or performance of the information provided
herein. Lantronix shall have no liability whatsoever to any user for any damages, losses and
causes of action (whether in contract or in tort or otherwise) in connection with the user’s access or
usage of any of the information or content contained herein. The information and specifications
contained in this document are subject to change without notice.
Revision History
Date Rev. Comments
January 2011 A Initial document.
July 2011 B Updated document to firmware release 7.2.0.0. Includes the new
July 2011 C Added chapter on OEM branding capabilities.
February 2013 D Updated document to firmware release 7.3.0.1R7.
January 2015 E Updated document to firmware release 7.9.0.1.
August 2015 F Updated restriction information related to the line 3 tunnel, the tunnel 3
March 2017 G Updated document to firmware release 8.0.0.0. Changes include adding
Bridging feature.
connect mode, and AdHoc mode connection. Updated SPI interface
support information.
Modbus, IPv6, TCP Keep Alive, IKEv2, and updating log verbosity,
network settings, system setup, email setup, settings for WLAN Quick
Connect and WLAN profile settings, and compliance updates.
PremierWave® EN Embedded System on Module User Guide 3
Table of Contents
Intellectual Property ________________________________________________________2
Open Source Software ______________________________________________________2
Warranty _________________________________________________________________2
Contacts _________________________________________________________________2
Disclaimer ________________________________________________________________3
Revision History ___________________________________________________________3
List of Figures ____________________________________________________________11
List of Tables _____________________________________________________________12
1: Using This Guide 15
Purpose and Audience _____________________________________________________15
Summary of Chapters ______________________________________________________15
Additional Documentation ___________________________________________________16
2: Introduction 17
Key Features _____________________________________________________________17
Applications ______________________________________________________________18
Protocol Support _________________________________________________________18
Troubleshooting Capabilities _________________________________________________18
Configuration Methods _____________________________________________________19
Addresses and Port Numbers ________________________________________________19
Hardware Address _____________________________________________________19
IP Address ___________________________________________________________19
Port Numbers _________________________________________________________19
Product Information Label ___________________________________________________20
3: Using DeviceInstaller 21
Accessing PremierWave EN Using DeviceInstaller _______________________________21
Device Detail Summary _____________________________________________________22
4: Configuration Using Web Manager 24
Accessing Web Manager ___________________________________________________24
Device Status Page ________________________________________________________25
Web Manager Components _________________________________________________26
Navigating Web Manager ___________________________________________________27
5: Network Settings 30
Network 1 Status __________________________________________________________30
Network 1 (eth0) Interface Settings ____________________________________________30
PremierWave® EN Embedded System on Module User Guide 4
To Configure Network 1 Interface Settings ___________________________________32
Network 1 (eth0) Link Settings _______________________________________________33
Network 1 (eth0) QoS ______________________________________________________33
To Configure Network 1 QoS Settings ______________________________________34
Network 1 (eth0) Failover ___________________________________________________35
To Configure Network 1 Failover Settings ___________________________________35
Network 2 Status __________________________________________________________35
Network 2 (wlan0) Interface Settings __________________________________________36
To Configure Network 2 Interface Settings ___________________________________37
SmartRoam __________________________________________________________37
Network 2 (wlan0) Link Settings ______________________________________________38
To Configure Network 2 Link Settings ______________________________________38
Network 2 (wlan0) QoS _____________________________________________________39
To Configure Network 2 QoS Settings ______________________________________40
WLAN Link Status and Scan Commands ____________________________________40
To View WLAN Link Scan and Status Information _____________________________42
Network 2 (wlan0) Failover __________________________________________________42
To Configure Network 2 Failover Settings ___________________________________43
WLAN Profiles ____________________________________________________________43
To Configure WLAN Profiles _____________________________________________43
To Configure WLAN Profile Basic Settings ___________________________________44
To Configure WLAN Profile Advanced Settings _______________________________45
WLAN Profile Security Settings ___________________________________________46
To Configure WLAN Profile Security Settings ________________________________47
WLAN Profile WEP Settings ______________________________________________47
To Configure WLAN Profile WEP Settings ___________________________________49
WLAN Profile WPA and WPA2/IEEE802.11i Settings __________________________49
To Configure WLAN Profile WPA and WPA/IEEE802.11i Settings ________________ 51
WLAN Quick Connect ______________________________________________________51
To Configure WLAN Quick Connect ________________________________________52
Gateway ________________________________________________________________52
Status _______________________________________________________________52
WAN ________________________________________________________________53
WAN MAC Address Filters _______________________________________________53
To Configure Gateway WAN Settings ______________________________________53
Port Forwarding _______________________________________________________54
To Configure Gateway Port Forwarding Settings ______________________________55
Static Routes _________________________________________________________55
To Configure Gateway Static Route Settings _________________________________55
DHCP Server _________________________________________________________56
To Configure Gateway DHCP Server Settings ________________________________ 56
Static Lease Listing ____________________________________________________56
Routing Protocols ______________________________________________________57
PremierWave® EN Embedded System on Module User Guide 5
To Configure Gateway Routing Protocol Settings _____________________________58
Virtual IP _____________________________________________________________58
To Configure Gateway Virtual IP __________________________________________58
DDNS __________________________________________________________________59
To Configure Gateway WAN Settings ______________________________________59
VPN ____________________________________________________________________60
To Configure VPN Settings ______________________________________________61
GRE Settings ____________________________________________________________62
To Configure Tunnel Serial Settings ________________________________________62
6: Action Settings 63
Alarms and Reports _______________________________________________________63
Actions _________________________________________________________________63
To Configure Action Settings _____________________________________________64
Python __________________________________________________________________65
IDE _________________________________________________________________65
Applications ______________________________________________________________65
To Configure Application Settings _________________________________________66
7: Line and Tunnel Settings 67
Line Statistics ____________________________________________________________67
USB-CDC-ACM _______________________________________________________67
Line Settings _____________________________________________________________68
To Configure Line Settings _______________________________________________68
To Configure Line Command Mode ________________________________________70
Tunnel Statistics __________________________________________________________71
To View Tunnel Statistics ________________________________________________71
Tunnel Settings ___________________________________________________________71
Serial Settings ________________________________________________________71
To Configure Tunnel Serial Settings ________________________________________72
Packing Mode _________________________________________________________72
To Configure Tunnel Packing Mode Settings _________________________________73
Accept Mode __________________________________________________________73
To Configure Tunnel Accept Mode Settings __________________________________76
Connect Mode ________________________________________________________76
Connecting Multiple Hosts _______________________________________________79
Host List Promotion ____________________________________________________80
Disconnect Mode ______________________________________________________80
To Configure Tunnel Disconnect Mode Settings ______________________________80
Modem Emulation ______________________________________________________81
To Configure Tunnel Modem Emulation Settings ______________________________82
PremierWave® EN Embedded System on Module User Guide 6
8: Terminal and Host Settings 83
Terminal Settings _________________________________________________________83
To Configure the Terminal Network Connection _______________________________84
To Configure the Terminal Line Connection __________________________________84
Host Configuration ________________________________________________________84
To Configure Host Settings ______________________________________________85
9: Configurable Pin Manager 86
CPM: Configurable Pins ____________________________________________________86
CPM: Groups _________________________________________________________87
To Configure CPM Settings ______________________________________________88
10: Network Services 89
DNS Settings _____________________________________________________________89
To View or Configure DNS Settings: _______________________________________89
FTP Settings _____________________________________________________________90
To Configure FTP Settings _______________________________________________90
Syslog Settings ___________________________________________________________90
To View or Configure Syslog Settings ______________________________________91
HTTP Settings ____________________________________________________________91
To Configure HTTP Settings _____________________________________________92
To Configure HTTP Authentication _________________________________________93
RSS Settings _____________________________________________________________93
To Configure RSS Settings ______________________________________________94
SNMP Settings ___________________________________________________________94
To Configure SNMP Settings _____________________________________________95
Discovery _______________________________________________________________95
To Configure Discovery _________________________________________________95
SMTP Settings ___________________________________________________________96
To Configure SMTP Settings _____________________________________________96
Email Settings ____________________________________________________________96
To View, Configure, and Send Email _______________________________________97
11: Security Settings 98
Public Key Infrastructure ____________________________________________________98
TLS (SSL) _______________________________________________________________98
Digital Certificates _________________________________________________________99
Trusted Authorities ________________________________________________________99
Obtaining Certificates ______________________________________________________99
Self-Signed Certificates _____________________________________________________99
Certificate Formats ________________________________________________________99
OpenSSL _______________________________________________________________100
PremierWave® EN Embedded System on Module User Guide 7
Steel Belted RADIUS _____________________________________________________100
Free RADIUS ___________________________________________________________100
SSH Settings ____________________________________________________________101
SSH Server Host Keys _________________________________________________101
SSH Client Known Hosts _______________________________________________102
SSH Server Authorized Users ___________________________________________102
SSH Client Users _____________________________________________________ 103
To Configure SSH Settings _____________________________________________104
SSL Settings ____________________________________________________________104
Create a New Credential _______________________________________________104
To Create a New Credential _____________________________________________105
Upload Certificate _____________________________________________________105
Certificate and Key Generation __________________________________________106
To Configure an Existing SSL Credential ___________________________________107
Trusted Authorities ____________________________________________________107
12: Maintenance and Diagnostics Settings 109
Filesystem Settings _______________________________________________________109
Statistics ____________________________________________________________109
To View Statistics _____________________________________________________109
File Display __________________________________________________________109
To Display Files ______________________________________________________110
File Modification ______________________________________________________110
File Transfer _________________________________________________________110
To Transfer or Modify Filesystem Files _____________________________________111
Protocol Stack Settings ____________________________________________________111
IP Settings __________________________________________________________111
To Configure IP Protocol Stack Settings ___________________________________112
ICMP Settings ________________________________________________________112
To Configure ICMP Protocol Stack Settings _________________________________112
To View ICMP Protocol Stack Settings _____________________________________112
ARP Settings ________________________________________________________113
To Configure ARP Network Stack Settings _________________________________113
Diagnostics _____________________________________________________________114
Hardware ___________________________________________________________114
To View Hardware Information ___________________________________________114
IP Sockets __________________________________________________________114
To View the List of IP Sockets ___________________________________________114
Ping _______________________________________________________________114
To Ping a Remote Host ________________________________________________115
Traceroute __________________________________________________________115
To Perform a Traceroute _______________________________________________115
Log ________________________________________________________________116
PremierWave® EN Embedded System on Module User Guide 8
To Configure the Diagnostic Log Output ___________________________________116
Memory _____________________________________________________________116
To View Memory Usage ________________________________________________116
Processes ___________________________________________________________117
To View Process Information ____________________________________________117
Threads ____________________________________________________________117
To View Thread Information _____________________________________________117
Clock __________________________________________________________________117
To Specify Clock Setting Method _________________________________________118
System Settings _________________________________________________________118
To Reboot or Restore Factory Defaults ____________________________________119
13: Management Interface Settings 120
Command Line Interface Settings ____________________________________________120
Basic CLI Settings ____________________________________________________120
To View and Configure Basic CLI Settings __________________________________120
Telnet Settings _______________________________________________________121
To Configure Telnet CLI Settings _________________________________________121
SSH CLI Settings _____________________________________________________121
To Configure SSH Settings _____________________________________________122
XML Settings ____________________________________________________________122
XML: Export Configuration ______________________________________________122
To Export Configuration in XML Format ____________________________________123
XML: Export Status ____________________________________________________123
To Export in XML Format _______________________________________________123
XML: Import Configuration ______________________________________________124
To Import Configuration in XML Format ____________________________________125
14: Bridging 126
Bridging Configuration _____________________________________________________126
To configure and enable bridging: ________________________________________126
Bridging Operation _______________________________________________________127
Bridge Configuration ______________________________________________________127
To View or Configure Bridge Settings _____________________________________127
15: Security in Detail 129
Public Key Infrastructure ___________________________________________________129
TLS (SSL) ______________________________________________________________129
Digital Certificates ________________________________________________________129
Trusted Authorities _______________________________________________________129
Obtaining Certificates _____________________________________________________130
Self-Signed Certificates ____________________________________________________130
PremierWave® EN Embedded System on Module User Guide 9
Certificate Formats _______________________________________________________130
OpenSSL _______________________________________________________________130
Steel Belted RADIUS _____________________________________________________131
Free RADIUS ___________________________________________________________131
16: Updating Firmware 132
Obtaining Firmware _______________________________________________________132
Loading New Firmware through Web Manager _________________________________132
Loading New Firmware through FTP _________________________________________134
17: Branding the PremierWave EN Device 135
Web Manager Customization _______________________________________________135
Short and Long Name Customization _________________________________________136
To Customize Short or Long Names ______________________________________136
Appendix A: Lantronix Technical Support 137
Appendix B: Binary to Hexadecimal Conversions 138
Converting Binary to Hexadecimal ___________________________________________138
Conversion Table _____________________________________________________138
Scientific Calculator ___________________________________________________138
Appendix C: Compliance 140
Appendix D: USB-CDC-ACM Device Driver File
for Windows Hosts 142
Creating a USB-CDC-ACM Device Driver File __________________________________142
Installing the USB-CDC-ACM Device Driver File ________________________________ 145
PremierWave® EN Embedded System on Module User Guide 10
List of Figures
Figure 2-1 PremierWave EN Unit Product Label ________________________________________20
Figure 4-1 Device Status Page ______________________________________________________25
Figure 4-2 Components of the Web Manager Page ______________________________________26
Figure 16-1 Uploading New Firmware _______________________________________________133
PremierWave® EN Embedded System on Module User Guide 11
List of Tables
Table 4-3 Web Manager Pages ____________________________________________________ 27
Table 5-1 Network Interface Settings ________________________________________________ 30
Table 5-2 Network 1 (eth0) Link Settings _____________________________________________ 33
Table 5-3 Network 1 (eth0) QoS Settings _____________________________________________ 34
Table 5-4 Adding or Deleting Network 1 (eth0) QoS Settings______________________________ 34
Table 5-5 Network 1 (eth0) Failover Settings __________________________________________ 35
Table 5-6 Network 2 (wlan0) Interface Settings ________________________________________ 36
Table 5-7 Network 2 (wlan0) Link Settings ____________________________________________ 38
Table 5-8 Network 2 (wlan0) QoS Settings____________________________________________ 39
Table 5-9 Adding or Deleting Network 2 (wlan0) QoS Settings ____________________________ 39
Table 5-10 Network 2 Link Scan____________________________________________________ 40
Table 5-11 Network 2 Link Scan Results on Web Manager _______________________________ 40
Table 5-12 Network 2 Link Status___________________________________________________ 41
Table 5-13 Network 2 (wlan0) Failover Settings ________________________________________ 42
Table 5-14 Creating, Deleting or Enabling WLAN Profiles ________________________________ 44
Table 5-15 WLAN Profile Basic Settings______________________________________________ 44
Table 5-16 WLAN Profile Advanced Settings __________________________________________ 45
Table 5-17 WLAN Profile Security Settings ___________________________________________ 46
Table 5-18 Additional WEP Settings for WLAN Profile. __________________________________ 48
Table 5-19 WLAN Profile WPA and WPA2/IEEE802.11i Settings __________________________ 49
Table 5-20 WLAN Quick Connect___________________________________________________ 51
Table 5-21 WAN Configuration _____________________________________________________ 53
Table 5-22 Adding a New MAC Address Filters ________________________________________ 53
Table 5-23 Port Forwarding Rules List _______________________________________________ 54
Table 5-24 Adding a New Port Forwarding Rule________________________________________ 54
Table 5-25 Static Route Setting Routes ______________________________________________ 55
Table 5-26 Adding a New Static Route _______________________________________________ 55
Table 5-27 DHCP Settings ________________________________________________________ 56
Table 5-28 Static Lease Listing_____________________________________________________ 57
Table 5-29 Add a Static Lease _____________________________________________________ 57
Table 5-30 Routing Protocol Settings ________________________________________________ 57
Table 5-31 Virtual IP Settings ______________________________________________________ 58
Table 5-32 Adding a Virtual IP _____________________________________________________ 58
Table 5-33 DDNS Configuration ____________________________________________________ 59
Table 5-34 VPN Configuration _____________________________________________________ 60
PremierWave® EN Embedded System on Module User Guide 12
Table 5-35 GRE Settings _________________________________________________________ 62
Table 6-1 Action Settings _________________________________________________________ 63
Table 6-2 Script Settings__________________________________________________________ 66
Table 7-1 Line Configuration Settings________________________________________________ 68
Table 7-2 Line Command Mode Settings _____________________________________________ 70
Table 7-3 Tunnel Serial Settings____________________________________________________ 71
Table 7-4 Tunnel Packing Mode Settings _____________________________________________ 72
Table 7-5 Tunnel Accept Mode Settings______________________________________________ 74
Table 7-6 Tunnel Connect Mode Settings_____________________________________________ 77
Table 7-7 Tunnel Disconnect Mode Settings __________________________________________ 80
Table 7-8 Tunnel Modem Emulation Settings__________________________________________ 81
Table 8-1 Terminal on Network and Line Settings ______________________________________ 83
Table 8-2 Host Configuration ______________________________________________________ 84
Table 9-1 Current Configurable Pins_________________________________________________ 86
Table 9-2 CP Status _____________________________________________________________ 86
Table 9-3 CPM Group Current Configuration __________________________________________ 87
Table 9-4 CPM Group Status ______________________________________________________ 87
Table 10-1 DNS Settings _________________________________________________________ 89
Table 10-2 FTP Settings __________________________________________________________ 90
Table 10-3 Syslog Settings ________________________________________________________ 90
Table 10-4 HTTP Settings_________________________________________________________ 91
Table 10-5 HTTP Authentication Settings _____________________________________________ 93
Table 10-6 RSS Settings__________________________________________________________ 93
Table 10-7 SNMP Settings ________________________________________________________ 94
Table 10-8 Discovery Settings _____________________________________________________ 95
Table 10-9 SMTP Settings ________________________________________________________ 96
Table 10-10 Email Configuration____________________________________________________ 96
Table 11-1 SSH Server Host Keys _________________________________________________ 101
Table 11-2 SSH Client Known Hosts _______________________________________________ 102
Table 11-3 SSH Server Authorized Users ___________________________________________ 102
Table 11-4 SSH Client Users _____________________________________________________ 103
Table 11-5 Create New Keys _____________________________________________________ 103
Table 11-6 Create a New Credentials_______________________________________________ 105
Table 11-7 Upload Certificate Settings ______________________________________________ 105
Table 11-8 Certificate and Key Generation Settings____________________________________ 106
Table 12-1 File Statistics_________________________________________________________ 109
Table 12-2 File Display Settings ___________________________________________________ 109
Table 12-3 File Modification Settings _______________________________________________ 110
PremierWave® EN Embedded System on Module User Guide 13
Table 12-4 File Transfer Settings __________________________________________________ 110
Table 12-5 IP Protocol Stack Settings ______________________________________________ 111
Table 12-6 ICMP Protocol Stack Settings____________________________________________ 112
Table 12-7 ARP Protocol Stack Settings ____________________________________________ 113
Table 12-8 Ping Settings_________________________________________________________ 114
Table 12-9 Traceroute Settings____________________________________________________ 115
Table 12-10 Log Settings ________________________________________________________ 116
Table 12-11 Clock Settings_______________________________________________________ 117
Table 12-12 System Settings _____________________________________________________ 118
Table 13-1 CLI Configuration Settings ______________________________________________ 120
Table 13-2 Telnet Settings _______________________________________________________ 121
Table 13-3 SSH Settings_________________________________________________________ 121
Table 13-4 XML Exporting Configuration ____________________________________________ 122
Table 13-5 Exporting Status ______________________________________________________ 123
Table 13-6 Import Configuration from Filesystem Settings ______________________________ 124
Table 14-1 Bridge Settings _______________________________________________________ 127
Table 17-1 Short and Long Name Settings___________________________________________ 136
PremierWave® EN Embedded System on Module User Guide 14
1: Using This Guide
Purpose and Audience
This guide provides the information needed to configure, use, and update the Lantronix®
PremierWave® EN embedded system on module (SOM). 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. Includes
3: Using DeviceInstaller Instructions for viewing the device and configuration using UPnP and
4: Configuration Using Web
Manager
5: Network Settings Instructions for configuring network settings.
6: Action Settings Instructions for configuring alarm settings.
7: Line and Tunnel Settings Instructions for configuring line and tunnel settings.
8: Terminal and Host Settings Instructions for configuring terminal and host settings.
9: Configurable Pin Manager Information about the Configurable Pin Manager (CPM) including
10: Network Services Instructions for configuring DNS, FTP, HTTP and Syslog settings.
11: Security Settings Instructions for configuring SSL security settings.
12: Maintenance and Diagnostics
Settings
13: Management Interface Settings Instructions for configuring CLI and XML settings.
14: Bridging Instructions for bridging configuration.
15: Security in Detail
16: Updating Firmware Instructions for obtaining and updating the latest firmware for the
17: Branding the PremierWave EN
Device
Appendix A: Lantronix Technical
Support
Appendix B: Binary to Hexadecimal
Conversions
Appendix C: Compliance Lantronix compliance information.
Appendix D: USB-CDC-ACM Device
Driver File for Windows Hosts
technical specifications.
the DeviceInstaller utility.
Instructions for accessing Web Manager and using it to configure
settings for the device.
how to set the configurable pins to work with a device and
instructions for accessing Web Manager and using it to configure
settings for the device.
Instructions to view statistics, files, and diagnose problems.
PremierWave device.
Instructions on how to brand your device.
Instructions for contacting Lantronix Technical Support.
Instructions for converting binary values to hexadecimals.
Information about the device driver file for windows host.
PremierWave® EN Embedded System on Module User Guide 15
Additional Documentation
Visit the Lantronix Web site at www.lantronix.com/support/documentation for the latest
documentation and the following additional documentation.
Document Description
PremierWave EN Embedded
System on Module Integration
Guide
PremierWave Embedded EN
System on Module Command
Reference
PremierWave EN Embedded
System on Module Quick Start
PremierWave Embedded
System on Module Evaluation
Board User Guide
DeviceInstaller™ Utility Online
Help
Com Port Redirector Quick Start
and Online Help
1: Using This Guide
Information about the PremierWave hardware, testing the device
server using the demonstration board, and integrating the unit into your
product.
Instructions for accessing Command Mode (the command line
interface) using a Telnet connection, SSH connection or through the
serial port. Detailed information about the commands. Also provides
details for XML configuration and status.
Instructions for getting the PremierWave evaluation board device up
and running.
Information needed to use the PremierWave on the evaluation board.
Instructions for using the Windows® operating system-based utility to
locate the embedded device server and to view its current settings.
Instructions for using the Windows operating system-based utility to
create virtual com ports.
Secure Com Port Redirector
User Guide
Instructions for using the Windows operating system-based utility to
create secure virtual com ports.
PremierWave® EN Embedded System on Module User Guide 16
2: Introduction
The PremierWave EN embedded system on module is a complete network-enabling solution in a
30 (1.181) X 55 (2.165) X 6.45 (0.248) package. This compact system on module empowers
original equipment manufacturers (OEMs) to go to market quickly and easily with Ethernet and/or
wireless networking and web page serving capabilities built into their products. [DIMS = mm (in.)]
Key Features
Power Supply: Regulated 3.3V input required. There are internal step down regulators to
convert to processor core and memory required voltages: a step-down converter to 1.5V for
the processor core and 1.8V for the memory subsystem. All voltages have LC filtering to
minimize noises and emissions.
Controller: 32-bit ARM9 microprocessor running at 400 megahertz (Mhz) with 32 KB Data
Cache and 32 Kilobytes (KB). Instruction Cache
Memory: Up to 64 MB SDRAM, 256 MB NAND Flash (64 MB default). Up to 16 MB serial SPI
Flash (8 MB default).
Ethernet: 10/100 megabits per second (Mbps) Ethernet transceiver.
Wireless: Dual Band 802.11 a/b/g/n with an on-board antenna and option for external
antennas and diversity.
Serial Ports: Two high speed RS232/RS422/RS485* serial ports with all hardware
handshaking signals. Baud rate is software selectable (300 bps to 921600 bps). One emulated
serial port on the USB Device Port (up to Full Speed 12 Mbps), using standard CDC/ACM
protocol.
USB Ports: Two USB 2.0 full speedOne USB 2.0 Full Speed (12 Mbps) host device port
Master/Slave high speed SPI interface
I2C interface
Configurable I/O Pins (CPs): Up to nine pins are configurable as general purpose I/Os if no
DTR or DCD is used on serial ports. Not 5V tolerant.
Interface Signals: 3.3V-level interface signals.
Configuration via CLI, XML and HTTP
Ethernet to wireless tunneling
Lantronix® SmartRoam™ technology
Temperature Range: Operates over a temperature range of -40°C to +85°C (-40°F to 158°F).
The storage temperature range is -40°C to 85°C (-40°F to 185°F).
PremierWave® EN Embedded System on Module User Guide 17
Applications
The PremierWave EN embedded system on module is suitable for these application scenarios:
ATM machines
CNC controllers
Data collection devices
Universal Power Supply (UPS) management unit
Telecommunications equipment
Data display devices
Security alarms and access control devices
Handheld instruments
Modems
Time/attendance clocks and terminals
Patient Monitoring Devices
Glucose Analyzers
2: Introduction
Infusion Pumps
Protocol Support
The PremierWave EN embedded system on module contains a full-featured IP networking stack:
ARP, SNMP v1/v2c/v3, IPv4, UDP, TCP, ICMP, BOOTP, DHCP, Auto IP, Telnet, FTP,
FTPS,DNS, TFTP, SSH, SSL/TLS, and Syslog for network communications and
management.
TCP, UDP, SSH, SSL and Telnet tunneling to the serial port.
TFTP for uploading/downloading files.
FTP and HTTP/HTTPS for firmware upgrades and uploading/downloading files.
SMTP AUTH, HTTP/HTTPS Post, FTP/FTPS Put and SNMP Traps
Troubleshooting Capabilities
The PremierWave EN device server offers a comprehensive diagnostic toolset that lets you
troubleshoot problems quickly and easily. Available from the CLI or Web Manager, the diagnostic
tools let you:
View critical hardware, memory, buffer pool, IP socket information and routing table
Perform ping and traceroute operations
Conduct forward or reverse DNS lookup operations
View all processes currently running on the PremierWave EN embedded system on module
including CPU utilization
View system log messages
PremierWave® EN Embedded System on Module User Guide 18
Configuration Methods
After installation, the PremierWave EN unit requires configuration. For the unit to operate correctly
on a network, it must have a unique IP address on the network. There are four basic methods for
logging into the PremierWave EN embedded system on module and assigning IP addresses and
other configurable settings:
Web Manager: View and configure all settings easily through a web browser using the
Lantronix Web Manager. (See Configuration Using Web Manager on page 24.)
DeviceInstaller: Configure the IP address and related settings and view current settings on
the PremierWave EN embedded system on module using a Graphical User Interface (GUI) on
a PC attached to a network. You will need the latest version of the Lantronix®
DeviceInstaller™ utility. (See Accessing the PremierWave XC HSPA+ Device Using
DeviceInstaller on page 30.)
Command Mode: There are a few methods for accessing Command Mode (CLI): making a
Telnet or SSH connection, or connecting a PC or other host running a terminal emulation
program to the unit’s serial port. (See the PremierWave EN Embedded System on Module
Command Reference for instructions and available commands.)
XML: The PremierWave EN embedded system on module supports XML-based configuration
and setup records that make device configuration transparent to users and administrators.
XML is easily editable with a standard text or XML editor. (See the PremierWave EN
Embedded System on Module Command Reference for instructions and commands).
2: Introduction
Addresses and Port Numbers
Hardware Address
The hardware address is also referred to as the Ethernet address, physical address, or MAC
address. The first three bytes of the Ethernet address are fixed and identify the unit as a Lantronix
product. The fourth, fifth, and sixth bytes are unique numbers assigned to each unit. Sample
hardware address:
00-80-A3-14-1B-18
00:80:A3:14:1B:18
IP Address
Every device connected to an IP network must have a unique IPv4 address. This address
references the specific unit.
Port Numbers
Every TCP connection and every UDP datagram is defined by a destination and source IP
address, and a destination and source port number. For example, a Telnet server commonly uses
TCP port number 23.
The following is a list of the default server port numbers running on the PremierWave EN
embedded system on module:
TCP Port 22: SSH Server (Command Mode configuration)
TCP Port 23: Telnet Server (Command Mode configuration)
PremierWave® EN Embedded System on Module User Guide 19
TCP Port 80: HTTP (Web Manager Configuration)
Note: The hardware address on the label is
also the product serial number. The hardware
address on the label is the address for the
Ethernet (eth0) interface. The WLAN (wlan0)
interface uses the Ethernet address "+1". For
example, if the product label hardware address
is 00-80-A3-14-1B-18, then the Ethernet
address is 00-80-A3-14-1B-18 and the WLAN
address is 00-80-A3-14-1B-19.
Bar Code
MAC Address
Part Number
Country of Origin
& Manufacture
Revision
Manufacturing
Date Code
TCP Port 21: FTP
UDP Port 30718: LDP (Lantronix Discovery Protocol) port
TCP/UDP Port 10001: Tunnel 1 (see note below)
Note: Additional TCP/UDP ports and tunnels will be available, depending on the product
type. The default numbering of each additional TCP/UDP port and corresponding tunnel
will increase sequentially (i.e., TCP/UDP Port 1000X: Tunnel X).
Product Information Label
The product information label on the unit contains the following information about the specific unit:
Part Number
Hardware Address (MAC Address)
Country of Origin
Product Revision
2: Introduction
Manufacturing Date Code
Figure 2-1 PremierWave EN Unit Product Label
PremierWave® EN Embedded System on Module User Guide 20
3: Using DeviceInstaller
This chapter covers the steps for locating an PremierWave EN unit and viewing its properties and
device details. The Lantronix® DeviceInstaller™ application is a free utility program provided by
Lantronix that discovers, configures, upgrades and manages Lantronix device servers.
Notes:
For instructions on using the DeviceInstaller utility to configure the IP address and
related settings or for more advanced features, see the DeviceInstaller Online Help.
Auto IP generates a random IP address in the range of 169.254.0.1 to
169.254.255.254, with a netmask of 255.255.0.0, if no BOOTP or DHCP server is
found. These addresses are not routable.
Accessing PremierWave EN Using DeviceInstaller
Note: Make note of the MAC address. It may be needed to perform various functions in
the DeviceInstaller application.
To use the DeviceInstaller utility, first install the latest version from the downloads page on the
Lantronix web site www.lantronix.com/downloads
1. Run the executable to start the installation process and respond to the installation wizard
prompts. (If prompted to select an installation type, select Typical.)
.
2. Click Start -> All Programs -> Lantronix -> DeviceInstaller 4.3 -> DeviceInstaller.
3. When DeviceInstaller starts, it will perform a network device search. To perform another
search, click Search.
4. Expand the PremierWave folder by clicking the + symbol next to the folder icon. The list of
available Lantronix PremierWave EN devices appears.
5. Select the PremierWave EN unit by expanding its entry and clicking on its IP address to view
its configuration.
6. On the right page, click the Device Details tab. The current PremierWave EN device
configuration appears. This is only a subset of the full configuration; the full configuration may
be accessed via Web Manager, CLI or XML.
PremierWave® EN Embedded System on Module User Guide 21
Device Detail Summary
Note: The settings are Display Only in this table unless otherwise noted
Current Settings Description
Name Shows “PremierWave EN”.
DHCP Device Name
Group
Comments
Device Family Shows the PremierWave EN device family type as “”PremierWave“.
Short Name Shows “premierwave_en” by default.
Long Name Shows “Lantronix ”PremierWave EN” by default.
Type Shows the device type as “PremierWave”.
ID Shows the PremierWave EN ID embedded within the unit.
Hardware Address Shows the PremierWave EN hardware (MAC) address.
Firmware Version Shows the firmware currently installed on the PremierWave EN.
Extended Firmware Version Provides additional information on the firmware version.
Online Status Shows the PremierWave EN status as Online, Offline, Unreachable (the
IP Address Shows the PremierWave EN current IP address. To change the IP address,
IPV6 Link Local Address Shows the current PremierWave IPv6 link local address.
IPV6 Global Address Shows the current PremierWave IPv6 global address.
IP Address was Obtained Appears “Dynamically” if the PremierWave EN unit automatically received
Subnet Mask Shows the subnet mask specifying the network segment on which the
Gateway Shows the IP address of the router of this network. There is no default.
Interfaces Shows information about the Ethernet (eth0) and wireless (wlan0)
Number of Serial Ports Shows the number of serial ports on this PremierWave EN embedded
3: Using DeviceInstaller
Displays one of the names the PremierWave EN device will send to the
DHCP server if it is configured to obtain an address in this manner.
Configurable field. Enter a group to categorize the PremierWave EN unit.
Double-click the field, type in the value, and press Enter to complete. This
group name is local to this PC and is not visible on other PCs or laptops
using DeviceInstaller.
Configurable field. Enter comments for the PremierWave EN device.
Double-click the field, type in the value, and press Enter to complete. This
description or comment is local to this PC and is not visible on other PCs or
laptops using DeviceInstaller.
PremierWave EN device is on a different subnet), or Busy (the
PremierWave EN is currently performing a task).
click the Assign IP button on the DeviceInstaller menu bar.
an IP address (e.g., from DHCP). Appears “Statically” if the IP address was
configured manually.
If the IP address was assigned dynamically, the following fields appear:
Obtain via DHCP with values of True or False.
Obtain via BOOTP with values of True or False.
PremierWave EN device resides.
interfaces for your PremierWave unit. Click the + sign beside eth0 or wlan0,
and then the Status and Configuration subcategories to view status and
configuration information on these interfaces.
device serverdevice server.
PremierWave® EN Embedded System on Module User Guide 22
3: Using DeviceInstaller
Current Settings Description
Supports Configurable Pins Shows True, indicating configurable pins are available on the PremierWave
EN embedded device server device server.
Supports Email Triggers Shows True, indicating email triggers are available on the PremierWave
embedded device serverdevice server.
Telnet Supported Indicates whether Telnet is enabled on this PremierWave EN embedded
device serverdevice server.
Telnet Port Shows the PremierWave EN port for Telnet sessions.
Web Port
Firmware Upgradable
Shows the PremierWave EN port for Web Manager configuration (if Web
Enabled field is True).
Shows True, indicating the PremierWave firmware is upgradable as newer
versions become available.
PremierWave® EN Embedded System on Module User Guide 23
4: Configuration Using Web Manager
This chapter describes how to configure the PremierWave EN embedded system on module using
Web Manager, the Lantronix browser-based configuration tool. The unit’s configuration is stored in
non-volatile memory and is retained without power. All changes take effect immediately, unless
otherwise noted. It contains the following sections:
Accessing Web Manager
Device Status Page
Web Manager Components
Navigating Web Manager
Accessing Web Manager
Note: You can also access the Web Manager by selecting the Web Configuration tab on
the DeviceInstaller application window.
To access Web Manager, perform the following steps:
1. Open a standard web browser. Lantronix supports the latest versions of Internet Explorer,
Mozilla Firefox, Safari or Chrome web browsers.
2. Enter the IP address or hostname of the PremierWave EN unit in the address bar. The IP
address may have been assigned manually using DeviceInstaller (see the PremierWave EN
Embedded System on Module Quick Start Guide) or automatically by DHCP.
3. Enter your username and password. The factory-default username is “admin” and “PASS” is
the default password. The Device Status web page displays configurations including network
settings, line settings, tunneling settings, and product information.
PremierWave® EN Embedded System on Module User Guide 24
Device Status Page
The Device Status page is the first to appear after you log into Web Manager. The Device Status
page also appears when you click Status in the menu bar in Web Manager.
4: Configuration Using Web Manager
Figure 4-1 Device Status Page
PremierWave® EN Embedded System on Module User Guide 25
4: Configuration Using Web Manager
Menu Bar
Links to
subpages
Items to
configure
Information
and Help Area
Header
Configuration and/or Status Area
Footer
Logout
button
Note: The Logout button is available on any web page. Logging out of the web page forces
re-authentication the next time the web page is accessed.
Web Manager Components
The layout of a typical Web Manager page is below.
Figure 4-2 Components of the Web Manager Page
PremierWave® EN Embedded System on Module User Guide 26
4: Configuration Using Web Manager
Web Manager pages have these sections:
The menu bar always appears at the left side of the page, regardless of the page shown. The
menu bar lists the names of the pages available in the Web Manager. To bring up a page, click it in
the menu bar.
The main area of the page has these additional sections:
Links near the top of many pages, such as the one in the example above, enable you to link to
additional subpages. On some pages, you must also select the item you are configuring, such
as a tunnel.
In the middle of many pages, you can select or enter new configuration settings. Some pages
show status or statistics in this area rather than allow you to enter settings.
At the bottom of most pages, the current configuration is displayed. In some cases, you can
reset or clear a setting.
When a parameter is changed on the page, a Submit button will appear. Click on this button
to save the change.
The information or help area shows information or instructions associated with the page.
A Logout link is available at the upper right corner of every page. In Chrome or Safari, it is
necessary to close out of the browser to completely logout. If necessary, reopen the browser
to log back in.
The footer appears at the very bottom of the page. It contains copyright information and a link
to the Lantronix home 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 from one page to another. Some pages are
read-only, while others let you change configuration settings.
Note: There may be times when you must reboot the PremierWave EN device 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 25-30 seconds after rebooting the unit before
attempting to make any subsequent connections.
Web Manager Page Description See
Status Shows product information, network, line, and tunneling settings. 25
Actions Allows you to view and configure the actions for a specific alarm or report. 63
Table 4-3 Web Manager Pages
Page
Applications Allows you to view and configure Application settings. 65
Bridge Allows you to configure a bridge and shows the current operational state
of the bridge.
CLI Shows Command Line Interface (CLI) statistics and lets you change the
current CLI configuration settings.
126
120
PremierWave® EN Embedded System on Module User Guide 27
4: Configuration Using Web Manager
Web Manager Page
(continued)
Clock Allows you to view and configure the current date, time and time zone as it
CPM Shows information about the Configurable Pins Manager (CPM) and how
Diagnostics Lets you perform various diagnostic procedures. 114
Discovery Allows you to view and modify the configuration and statistics for device
DDNS Alllows you to view and configure DDNS settings. 59
DNS Shows the current configuration of the DNS subsystem and the DNS
Email Shows email statistics and lets you clear the email log, configure email
Filesystem Shows file system statistics and lets you browse the file system to view a
FTP Shows statistics and lets you change the current configuration for the File
Gateway Shows statistics and lets you change the current configuration for the
GRE Alllows you to view and configure GRE settings. 62
Description See
Page
118
displays in web manager.
86
to set the configurable pins and pin groups to work with a device.
95
discovery.
89
cache.
96
settings, and send an email.
109
file, create a file or directory, upload files using HTTP, copy a file, move a
file, or perform TFTP actions.
90
Transfer Protocol (FTP) server.
52
gateway.
Host Lets you view and change settings for a host on the network. 84
HTTP Shows HyperText Transfer Protocol (HTTP) statistics 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.
Modbus Shows the current connection status of the Modubs servers listening on
the TCP ports and configure Modbus TCP server.
Network Shows status and lets you configure the network interface. 30
Protocol Stack Lets you perform lower level network stack-specific activities. 111
RSS Lets you change current Really Simple Syndication (RSS) settings. 93
SmartRoam Lets you configure SmartRoam options through Network Link Settings. 37
SMTP Shows and allows modification of the current configuration of SMTP. 96
SNMP Shows and allows modification of the current configuration of SNMP. 96
SSH Lets you change the configuration settings for SSH server host keys, SSH
server authorized users, SSH client known hosts, and SSH client users.
SSL Lets you upload an existing certificate or create a new self-signed
certificate.
Syslog Lets you specify the severity of events to log and the server and ports to
which the syslog should be sent.
System Lets you reboot device, restore factory defaults, upload new firmware, and
change the device long and short names.
Terminal Lets you change current settings for a terminal. 83
91
68
122
101
104
90
118
PremierWave® EN Embedded System on Module User Guide 28
4: Configuration Using Web Manager
Web Manager Page
(continued)
Tunnel Lets you change the current configuration settings for an incoming tunnel
VPN Lets you view and configure VPN settings. 60
WLAN Profiles Lets you view, edit, delete and create a WLAN profile on a device. 43
WLAN Quick Connect Lets you change configuration settings for the Quick Connect. 51
XML Lets you export XML configuration and status records, and import XML
Description See
Page
71
connection.
122
configuration records.
PremierWave® EN Embedded System on Module User Guide 29
5: Network Settings
The Network Settings show the status of the PremierWave EN device interface/link and lets 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 PremierWave EN device server contains two interfaces.The Ethernet interface is called
Network 1 or eth0, and the WLAN interface is called Network 2 or wlan0.
Notes:.
Some settings require a reboot to take effect. These settings are noted below.
Wait a minimum of 25-30 seconds after rebooting the unit before attempting to make
any subsequent connections.
The blue text in the XML command strings of this chapter are to be replaced with a
user-specified name.
Network 1 Status
In the Network 1 status pages, you can view both the current interface operational settings as well
as the settings that would take effect upon a device reboot, as well as Link, QoS and Failover
status information.
To view Ethernet (eth0) Interface status, click Network on the menu and select Network 1 ->
Interface -> Status.
To view Ethernet (eth0) Link status, click Network on the menu and select Network 1 -> Link
-> Status.
To view Ethernet (eth0) QoS status, click Network on the menu and select Network 1 -> QoS
-> Status.
To view Ethernet (eth0) Failover status, click Network on the menu and select Network 1 ->
Failover -> Status.
Network 1 (eth0) Interface Settings
Table 5-1 shows the network interface settings that can be configured.
These settings apply to both the Network 1 Ethernet (eth0) and the Network 2 WLAN (wlan0)
interfaces, but are configured independently for each interface.
Table 5-1 Network Interface Settings
Network Interface
Settings
State Select to enable or disable the interface.
IPv4 State Select to enable of disable the IPv4 state.
Description
PremierWave® EN Embedded System on Module User Guide 30
Loading...