Page 2 - XPortTM User Guide; Copyright and Trademark; Lantronix Corporate Headquarters
XPort™ User Guide 2 Copyright and Trademark © 2004, Lantronix. 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. Printed in the United States of America. XPort, with its patent-pending t...
Page 3 - Disclaimer and Revisions; With the purchase of XPortTM, the OEM agrees to an OEM; Date; to find the earlier documentation.
XPort™ User Guide 3 Disclaimer and Revisions Operation of this equipment in a residential area is likely to cause interference, in which case the user, at his or her own expense, will be required to take whatever measures may be required to correct the interference. Changes or modifications to this ...
Page 4 - Contents; : Using Setup Mode for Configuration
XPort™ User Guide 4 Contents 1: Using This Guide 7 Purpose and Audience________________________________________________ 7 Chapter Summary ___________________________________________________ 7 Additional Documentation _____________________________________________ 8 2: Introduction 9 Capabilities ____...
Page 6 - : Updating Firmware
Contents XPort™ User Guide 6 Disable TFTP Firmware Upgrade __________________________________________ 41 Disable Port 77FE (Hex) _________________________________________________ 41 Disable Web Server _____________________________________________________ 41 Disable ECHO Ports________________________...
Page 7 - Purpose and Audience; This document covers XPortTM Device Server versions XP1001000-01,; Chapter Summary; The remaining chapters in this guide include:
XPort™ User Guide 7 1: Using This Guide Purpose and Audience This guide provides the information needed to configure, use and update the XPort™ and is intended for software developers and system integrators who are embedding the XPort in their designs. The information in this guide is relevant to XP...
Page 8 - Additional Documentation; XPort Quick Start
1: Using This Guide XPort™ User Guide 8 Additional Documentation The following guides are available on the product CD and the Lantronix web site ( www.lantronix.com ) . XPort Quick Start Provides the steps for getting the XPort evaluation board up and running. XPort Integration Guide Provides inform...
Page 10 - Protocol Support; Other supported protocols include:; Addresses and Port Numbers; Hardware Address
2: Introduction XPort™ User Guide 10 Protocol Support The XPort device server uses the Internet Protocol (IP) for network communications. It uses the Transmission Control Protocol (TCP) to assure that no data is lost or duplicated, and that everything sent to the connection arrives correctly at the ...
Page 11 - Assigning an IP Address; You can manually assign the IP address using a graphical user
2: Introduction XPort™ User Guide 11 Assigning an IP Address For the unit to operate correctly on a network, it must have a unique IP address on the network. There are three basic methods for logging into the device server and assigning the IP address: DHCP: By default, Dynamic Host Configuration Pr...
Page 12 - Required Information; Using DeviceInstaller to Assign an IP Address; Note; Installing DeviceInstaller; displays the main window.
XPort™ User Guide 12 3: Getting Started This chapter covers the steps for getting the XPort device server online and working. Required Information Hardware Address You need to know the unit’s hardware address (also known as MAC address), which is on the product label. It is in the format: 00-20-4a-X...
Page 13 - For more information about Device Installer, see the; If you do not receive “Reply” messages, make sure the unit is
3: Getting Started XPort™ User Guide 13 a) Click the Start button on the Task Bar and select Run . b) Enter your CD drive letter, colon, backslash, Launch.exe (e.g., D:\Launch.exe). 3. Click the DeviceInstaller button. The installation wizard window displays. 4. Respond to the installation wizard pr...
Page 14 - Using Web-Manager to Configure the Unit; The examples in this section show a typical device. Your device may; Search; You can also open your JAVA-enabled web browser and enter the
3: Getting Started XPort™ User Guide 14 Using Web-Manager to Configure the Unit You must configure the unit so that it can communicate on a network with your serial device. For example, you must set the way the unit will respond to serial and network traffic, how it will handle serial packets, and w...
Page 15 - Update Settings; , explains the configuration settings in; Unit Configuration Settings; Unit Configuration
3: Getting Started XPort™ User Guide 15 On the left side of the screen, Web-Manager has the following menu options (buttons): Unit Configuration Server Properties Port Properties Factory Settings1 Update Settings Select Channel 4. Use the menu to navigate to subpages for the configuratio...
Page 16 - Click the; Server Properties; button to display the following page:; Telnet Password; field, enter a password to prevent unauthorized access to
3: Getting Started XPort™ User Guide 16 This page displays the current Server Configuration and the Port Configuration settings. Note: The following examples represent typical web pages. See the Lantronix web site for the latest version. Server Properties Click the Server Properties button to displa...
Page 17 - Security Settings; You do not need a password to access the Setup Mode window via a; Port Properties; Edit the following fields as necessary:; Speed
3: Getting Started XPort™ User Guide 17 characters. (An enhanced password setting of 16 characters is available under Security Settings on the Telnet Setup Mode window.) Note: You do not need a password to access the Setup Mode window via a serial connection. Port Properties Click the Port Propertie...
Page 18 - Connect Mode Settings; Dedicated Connection; Flush Mode Input Buffer
3: Getting Started XPort™ User Guide 18 the baud rates 460800 and 921600 bps (see High CPU Performance mode on page 39) Character Size 8, 7 Parity None, Even, Odd Stop Bit 1,2 Flow Control None, XON/XOFF, XON/XOFF Pass Characters to Host, CTS/RTS (Hardware) Connect Mode Settings UDP Datagram Mode En...
Page 19 - Packing Algorithm; Additional Settings
3: Getting Started XPort™ User Guide 19 On Active Connection Enable, Disable On Passive Connection Enable, Disable At Time To Disconnect Enable, Disable Packing Algorithm Packing Algorithm Enable, Disable Idle Time Packing Interval 12 ms, Interval 52 ms, Interval 250 ms, Interval 5000 ms Trailing Ch...
Page 20 - Factory Settings; Factory Defaults
3: Getting Started XPort™ User Guide 20 Factory Settings Click the Factory Settings button to set the device server back to the factory default settings . For details see page Factory Defaults on page 43 . Update Settings Click the Update Settings button to send all changed settings to the device se...
Page 21 - Lantronix Sales Associate.; Accessing Setup Mode; Using a Telnet Connection; from the main window list, and click the Telnet icon; Start; Be sure to include a space between the IP address and 9999.; OK
XPort™ User Guide 21 4: Using Setup Mode for Configuration You must configure the unit so that it can communicate on a network with your serial device. You can configure it using a web browser, as described in 3:Getting Started , or using the following procedures locally or remotely: Use a Telnet ...
Page 22 - Figure 4-2 Setup Menu Options; Using the Serial Port; The easiest way to enter Setup Mode is to hold down the x key at
4: Using Setup Mode for Configuration XPort™ User Guide 22 3. To enter the Setup Mode, press Enter within 5 seconds . The configuration settings display, followed by the setup menu options. Figure 4-2 Setup Menu Options Change Setup: 0 Server configuration 1 Channel 1 configuration 3 E-mail settings...
Page 23 - Figure 4-3 Setup Mode Configuration Parameters
4: Using Setup Mode for Configuration XPort™ User Guide 23 Figure 4-3 Setup Mode Configuration Parameters
Page 24 - Server Configuration (Network Configuration); The unit’s basic network parameters display when you select; Server configuration; fields display; Figure 4-4. Server Configuration Parameters; IP Address; The IP address must be set to a unique value in your network.; Set Gateway IP Address; and enter the address.; Netmask: Number of Bits for Host Part; Network Class; Change Telnet Configuration Password; You don’t need a password to access the Setup Mode window via a
4: Using Setup Mode for Configuration XPort™ User Guide 24 Server Configuration (Network Configuration) The unit’s basic network parameters display when you select Server configuration (option 0 ). The IP Address , Set Gateway IP Address , and Netmask fields display the current values. Figure 4-4. S...
Page 25 - DHCP Name; Default DHCP Name; Channel 1 Configuration (Serial Port Parameters); You must enter some values in hexadecimal notation.; Baudrate
4: Using Setup Mode for Configuration XPort™ User Guide 25 DHCP Name If a DHCP server has automatically assigned the IP address and network settings, you can discover the unit by using the DeviceInstaller network search feature. There are three methods for assigning DHCP names to the unit. Default...
Page 26 - If attempting to select an I/F Mode bit that pertains to RS-422/485 on; Table 4-3. Common Interface Mode Settings; Common I/F Mode Setting; Interface Mode Options
4: Using Setup Mode for Configuration XPort™ User Guide 26 4800, 9600 (default), 19200, 38400, 57600, 115200, and 230400 bits per second. XPort-03 and greater units also support high-performance baud rates of 460800, and 921600 bits per second (see Expert Settings on page 38 ). I/F (Interface) Mode ...
Page 27 - Flow; Flow Control Option; Port Number; Port Numbers Reserved for; Telnet setup
4: Using Setup Mode for Configuration XPort™ User Guide 27 Flow Flow control sets the local handshaking method for stopping serial input/output. Use the following table to select flow control options: Table 4-5. Flow Control Options Flow Control Option Hex No flow control 00 XON/XOFF flow control 01...
Page 28 - Connect Mode; Connect Mode Option; Incoming Connection
4: Using Setup Mode for Configuration XPort™ User Guide 28 Connect Mode Connect Mode defines how the unit makes a connection, and how it reacts to incoming connections over the network. Enter Connect Mode options in hexadecimal notation. Table 4-7. Connect Mode Options Connect Mode Option 7 6 5 4 3 ...
Page 29 - Command String
4: Using Setup Mode for Configuration XPort™ User Guide 29 Response Character Response A single character is transmitted to the serial port when there is a change in connection state: C = connected, D = disconnected, N = host unreachable. This option is overridden when the Active Start Modem Mode or...
Page 30 - Hostlist
4: Using Setup Mode for Configuration XPort™ User Guide 30 Command String Result if remote IP is 129.1.2.3 and remote port is 1234 C0.0.0.0/0 Connects to 129.1.28.10, port 12; enters Monitor Mode Autostart (Automatic Connection) If you enable autostart, the unit automatically connects to the remote ...
Page 31 - Datagram Type; Directed UDP; Modem Mode; Without Echo
4: Using Setup Mode for Configuration XPort™ User Guide 31 DisConnTime (00:00) ?: SendChar 1 (00) ? SendChar 2 (00) ? To enable the hostlist: 1. Enter a Connect Mode of 0x20 ( 2 X), where X is any digit. The menu shows you a list of current entries already defined in the product. 2. To delete, modif...
Page 32 - Message; Full Verbose; AT
4: Using Setup Mode for Configuration XPort™ User Guide 32 Full Verbose The unit echoes modem commands and responds to a command with a message string shown in the table below. 1-Character Response The unit echoes modem commands and responds to a command with a single character response. Table 4-11....
Page 33 - ATH; is received, terminated with a carriage return. The; Function; The unit recognizes these AT commands as single commands such as; Remote IP Address
4: Using Setup Mode for Configuration XPort™ User Guide 33 The character string ATH is received, terminated with a carriage return. The unit responds affirmatively according to the selected echo/response mode and drops the network connection. The serial interface reverts to accepting command strin...
Page 34 - DisConnMode; In DisConnMode (Disconnect Mode), DTR drop either drops the; Disconnect Mode Option; Flush Mode Options
4: Using Setup Mode for Configuration XPort™ User Guide 34 Note: To connect an ASCII terminal to a host using the unit for login purposes, use the remote port number 23 (Internet standard port number for Telnet services). DisConnMode This setting determines the conditions under which the unit will c...
Page 35 - Alternate Packing Algorithm (Pack Control); Pack Control; Pack control settings are enabled in Flush Mode. Set this value to; Option; Packing Interval; Send Characters
4: Using Setup Mode for Configuration XPort™ User Guide 35 Function 7 6 5 4 3 2 1 0 Clear when the network connection to or from the device is disconnected 1 Output Buffer (Network to Serial) Clear with a connection that is initiated from the device to the network 1 Clear with a connection initiated...
Page 36 - Telnet Terminal Type
4: Using Setup Mode for Configuration XPort™ User Guide 36 Packing Interval: Packing Interval defines how long the unit should wait before sending accumulated characters. This wait period is between successive network segments containing data. For alternate packing, the default interval is 12 ms. Tr...
Page 37 - Mail server; Domain
4: Using Setup Mode for Configuration XPort™ User Guide 37 E-mail Settings Note: You can change these settings via Telnet or serial connections only, not on the Web-Manager. To configure e-mail settings via DeviceInstaller, see E-mail Notification in the DeviceInstaller User Guide on the CD. The uni...
Page 38 - Trigger Setup; If the serial sequence is set to; Serial Sequence; If the configurable pins are all set to; L is for normal priority H is for high priority.; Re-notification interval; Expert Settings
4: Using Setup Mode for Configuration XPort™ User Guide 38 Trigger Setup A trigger event can occur when the unit receives two bytes of a specified sequence on the serial port, or because of a specified combination of conditions on the configurable pins. If the serial sequence is set to 00,00 , the t...
Page 40 - We recommend that you set security over the dedicated network or; Disable SNMP; public; name is a string of 1 to 13 characters.; Disable Telnet Setup
4: Using Setup Mode for Configuration XPort™ User Guide 40 configure one of the configurable pins to RS485_TXEN. To change the configurable pins’ settings, use DeviceInstaller or send setup records to port 77FE. Security Settings You can change security settings via Telnet or serial connections only...
Page 41 - Disable TFTP Firmware Upgrade; Recovering the Firmware Using the Serial Port; Disable Web Server; This option displays; only; if you purchased the encrypted version of the Lantronix
4: Using Setup Mode for Configuration XPort™ User Guide 41 Disable TFTP Firmware Upgrade This setting defaults to the N (No) option. The Y (Yes) option disables the use of TFTP to perform network firmware upgrades. With this option, you can download firmware upgrades over the serial port using Devic...
Page 42 - Encryption; Encryption Tutorial; Enter
4: Using Setup Mode for Configuration XPort™ User Guide 42 Encryption only applies to the port selected for tunneling (default 10001), regardless of whether you are using TCP or UDP. Generally, one of two situations applies. Encrypted XPort-to-XPort communication (and in the future, XPort communic...
Page 43 - Enter Keys; Enable Enhanced Password; Channel 1 Configuration Defaults
4: Using Setup Mode for Configuration XPort™ User Guide 43 6. When prompted to change keys, press Y . 7. At the Enter Keys prompts, enter your encryption key. The encryption keys are entered in hexadecimal. The hexadecimal values are echoed as asterisks to prevent onlookers from seeing the key. Hexa...
Page 44 - Exit Configuration Mode; or
4: Using Setup Mode for Configuration XPort™ User Guide 44 Expert Settings Defaults TCP keepalive 45 (seconds) ARP cache timeout 600 (seconds) High CPU performance mode (XPort-03 or greater only) Disabled HTTP port number 0 (resulting in an operational value of 80) SMTP port number 0 (resulting in a...
Page 46 - Guidelines; Send; Get; Commands; Byte 0 Command Types; Set functions
5: GPIO Interface XPort™ User Guide 46 Guidelines The GPIO control protocol is described from the PC side. Send means from PC to XPort. Response comes from XPort to PC. The protocol allows for control of up to 32 GPIOs. How many are actually available depends on the product. XPort has only three. Th...
Page 48 - Examples; PC sends command 1 to find out which configurable pins are; CP1 and CP2 are configured as GPIOs.
5: GPIO Interface XPort™ User Guide 48 Command 1Ah, Set Active Levels Send: 2 parameters Bytes 1-4: Mask Bit X 1 means the direction for GPIO X will be updated with the value in the second parameter. 0 means the active type for that GPIO will not change. Bytes 5-8: New Active Levels Bit X 1 means GP...
Page 50 - Obtaining Firmware; typical; ROM File; Using TFTP
XPort™ User Guide 50 6: Updating Firmware Obtaining Firmware You can obtain the most up-to-date firmware and release notes for the unit from the Lantronix web site ( www.lantronix.com ) or by using anonymous FTP (ftp.lantronix.com). Reloading Firmware There are several ways to update the unit's inte...
Page 52 - : Monitoring the Network; Entering Monitor Mode via the Serial Port; To enter Monitor Mode locally:; zzz; Entering Monitor Mode via the Network Port; All commands must be in capital letters.
XPort™ User Guide 52 7: Monitoring the Network Monitor Mode is a command-line interface used for diagnostic purposes. There are two ways to enter Monitor Mode: locally via the serial port or remotely via the network. Entering Monitor Mode via the Serial Port To enter Monitor Mode locally: 1. Follow ...
Page 53 - Responses to some of the commands are given in Intel Hex format.; Response
7: Monitoring the Network XPort™ User Guide 53 Table 7-1. Monitor Mode Commands Command Command Name Function VS x.x.x.x Version Queries software header record (16 bytes) of unit with IP address x.x.x.x. GC x.x.x.x Get Configuration Gets configuration of unit with IP address x.x.x.x as hex records (...
Page 54 - Problems and Error Messages; Reason
XPort™ User Guide 54 8: Troubleshooting This chapter discusses how you can diagnose and fix errors quickly without having to contact a dealer or Lantronix. It helps to connect a terminal to the serial port while diagnosing an error to view summary messages that may be displayed. When troubleshooting...
Page 55 - Caps Lock
8: Troubleshooting XPort™ User Guide 55 Problem/Message Reason Solution The IP address you are trying to assign is not on your logical subnet. Confirm that your PC has an IP address and that it is in the same logical subnet that you are trying to assign to the device server. The device server may no...
Page 57 - Technical Support
8: Troubleshooting XPort™ User Guide 57 Technical Support If you are experiencing an error that is not described in this user guide, or if you are unable to fix the error, you may: Check our online knowledge base at http://www.lantronix.com/support . Contact Technical Support in the US: Phone: 8...