Professional Documents
Culture Documents
Warranty
For details on the Lantronix warranty policy, please go to our Web site at www.lantronix.com/support/warranty.
Contacts
Lantronix Corporate Headquarters 167 Technology Drive Irvine, CA 92618, USA Toll Free: Phone: Fax: 800-526-8766 949-453-3995 949-450-7249
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
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. Note: This product has been designed to comply with the limits for a Class B digital device pursuant to Part 15 of FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation. This equipment generates, uses, and can radiate radio frequency energy, and if not installed and used in accordance with this guide, may cause harmful interference to radio communications. Changes or modifications to this device not explicitly approved by Lantronix will void the user's authority to operate this device. Note: With the purchase of xPico, the OEM agrees to an OEM firmware license agreement that grants the OEM a non-exclusive, royalty-free firmware license to use and distribute the binary firmware image provided, only to the extent necessary to use the xPico hardware. For further details, please see the xPico OEM firmware license agreement.
Revision History
Date April 2012 January 2013 Rev. A B Comments Initial release for firmware version 6.8.0.0. Updated for firmware version 6.8.0.3.
For the latest revision of this product document, please check our online documentation at www.lantronix.com/support/documentation.
Table of Contents
Copyright and Trademark ............................................................................................. 2 Warranty ....................................................................................................................... 2 Contacts........................................................................................................................ 2 Disclaimer ..................................................................................................................... 3 Revision History ............................................................................................................ 3 List of Tables ................................................................................................................ 8 List of Figures ............................................................................................................... 8
2. Introduction
11
Capabilities ................................................................................................................. 11 Applications ................................................................................................................ 11 Protocol Support ......................................................................................................... 12 Configuration Methods ............................................................................................... 12 Addresses and Port Numbers .................................................................................... 12 Hardware Address ............................................................................................... 12 IP Address ............................................................................................................ 13 Port Numbers ....................................................................................................... 13 Product Information Label .......................................................................................... 13
3. Using DeviceInstaller
14
Installing DeviceInstaller ............................................................................................. 14 Assigning an IP Address ............................................................................................ 14 Accessing the xPico Using DeviceInstaller ................................................................ 15 Viewing the Current Configuration ............................................................................. 15
18
Accessing Web-Manager Using DeviceInstaller ........................................................ 18 Network Configuration ................................................................................................ 19 Network Mode ...................................................................................................... 20 Automatic IP Address Configuration .................................................................... 20 Static IP Address Configuration ........................................................................... 21 Ethernet Configuration ......................................................................................... 21
Table of Contents
Server Configuration ................................................................................................... 22 Server Configuration ............................................................................................ 23 Advanced ............................................................................................................. 23 Host List Configuration ............................................................................................... 23 Retry Settings....................................................................................................... 24 Host Information ................................................................................................... 24 Channel 1 and 2 Configuration ................................................................................... 24 Serial Settings ...................................................................................................... 25 Connection Settings - TCP .................................................................................. 27 Connection Settings - UDP .................................................................................. 30 Configurable Pin Settings ........................................................................................... 32 Configurable Pin Functions .................................................................................. 32 Apply Settings ............................................................................................................. 33 Apply Defaults ............................................................................................................ 33
34
Accessing Setup Mode ............................................................................................... 34 Telnet Connection ................................................................................................ 34 Serial Port Connection ......................................................................................... 35 Exiting Setup Mode .................................................................................................... 36
37
Server Configuration (Option 0) ................................................................................. 37 IP Address .................................................................................................................. 37 Set Gateway IP Address ............................................................................................ 38 Netmask: Number of Bits for Host Part ...................................................................... 38 Set DNS Server IP Address ....................................................................................... 38 Change Telnet/Web-Manager Password ................................................................... 38 DHCP Name ............................................................................................................... 39
40
Channel 1 (Option 1) or Channel 2 (Option 2) ........................................................... 40 Baudrate ..................................................................................................................... 40 I/F (Interface) Mode .................................................................................................... 41 Flow ............................................................................................................................ 41 Port Number ............................................................................................................... 42 Connect Mode ............................................................................................................ 42 a) Incoming Connection ....................................................................................... 43 b) Response ......................................................................................................... 44
Table of Contents
c) Active Startup ................................................................................................... 44 d) Datagram Type ................................................................................................ 47 e) Modem Mode ................................................................................................... 47 Send the Escape Sequence (+++) in Modem Mode .................................................. 49 Show IP addr after 'RING' .......................................................................................... 49 Auto Increment Source Port ....................................................................................... 49 Remote IP Address .................................................................................................... 50 Remote Port ............................................................................................................... 50 DisConnMode ............................................................................................................. 50 Flush Mode (Buffer Flushing) ..................................................................................... 51 Pack Control ............................................................................................................... 51 Packing Interval.................................................................................................... 52 Trailing Characters ............................................................................................... 52 Send Characters .................................................................................................. 52 DisConnTime (Inactivity Timeout) .............................................................................. 53 Send Characters ......................................................................................................... 53 Telnet Terminal Type .................................................................................................. 53 Channel (Port) Password ........................................................................................... 53
54
Expert Settings (Option 5) .......................................................................................... 54 TCP Keepalive time in seconds ........................................................................... 54 ARP Cache timeout in seconds ........................................................................... 55 CPU Performance ................................................................................................ 55 Disable Monitor Mode at bootup .......................................................................... 55 HTTP Port Number .............................................................................................. 55 MTU Size ............................................................................................................. 55 TCP Re-Transmission Timeout............................................................................ 56 Enable alternate MAC .......................................................................................... 56 Ethernet Connection Type ................................................................................... 56 Security Settings (Option 6)........................................................................................ 56 Disable SNMP ...................................................................................................... 57 SNMP Community Name ..................................................................................... 57 Disable Telnet Setup ............................................................................................ 57 Disable TFTP Firmware Upgrade ........................................................................ 58 Disable Port 77FE (Hex) ...................................................................................... 58 Disable Web Server ............................................................................................. 58 Disable Web Setup .............................................................................................. 58
Table of Contents
Disable ECHO Ports ............................................................................................ 58 Enable Encryption ................................................................................................ 59 Enable Enhanced Password ................................................................................ 60 Disable Port 77F0 (Hex) ...................................................................................... 60 Default Settings (Option 7) ......................................................................................... 60 Channel 1 and Channel 2 Configuration Defaults ............................................... 60 Expert Settings Defaults ...................................................................................... 61 Security Settings Defaults .................................................................................... 61
9. GPIO Interface
62
Configurable Pins ....................................................................................................... 62 Features ............................................................................................................... 62 Control Protocol .......................................................................................................... 63 Guidelines ............................................................................................................ 63 Commands ........................................................................................................... 63 Examples .................................................................................................................... 65
67
Obtaining Firmware .................................................................................................... 67 Reloading Firmware ................................................................................................... 67 Using TFTP: Graphical User Interface ................................................................. 67 Using TFTP: Command Line Interface ................................................................ 68 Recovering the Firmware Using the Serial Port and DeviceInstaller ................... 69
70
Entering Monitor Mode Using the Serial Port ............................................................. 70 Entering Monitor Mode Using the Network Port ......................................................... 70 Monitor Mode Commands .................................................................................... 70
12. Troubleshooting
73
77
Converting Binary to Hexadecimal ............................................................................. 77 Conversion Table ................................................................................................. 77 Scientific Calculator ............................................................................................. 77
B: Compliance
79
List of Tables
Table 6-1. BootP/DHCP/AutoIP Options ____________________________________________ 37 Table 6-2. Standard IP Network Netmasks __________________________________________ 38 Table 7-1. Interface Mode Options ________________________________________________ 41 Table 7-2. RS232 Interface Mode Settings __________________________________________ 41 Table 7-3. Flow Control Options __________________________________________________ 42 Table 7-4. Reserved Port Numbers ________________________________________________ 42 Table 7-5. Connect Mode Options ________________________________________________ 43 Table 7-6. Manual Connection Address Example _____________________________________ 45 Table 7-7. Modem Mode Messages _______________________________________________ 47 Table 7-8. Modem Mode Commands ______________________________________________ 48 Table 7-9. Disconnect Mode Options ______________________________________________ 50 Table 7-10. Flush Mode Options __________________________________________________ 51 Table 7-11. Pack Control Options _________________________________________________ 52 Table 10-1. Firmware Files ______________________________________________________ 67 Table 11-1. Monitor Mode Commands _____________________________________________ 71 Table 11-2. Command Response Codes ___________________________________________ 72
List of Figures
Figure 2-1. Product Label _______________________________________________________ 13 Figure 4-1. Web-Manager Login Window ___________________________________________ 19 Figure 4-2. Lantronix Web-Manager _______________________________________________ 19 Figure 4-3. Network Settings _____________________________________________________ 20 Figure 4-4. Server Settings ______________________________________________________ 22 Figure 4-5. Hostlist Settings _____________________________________________________ 24 Figure 4-6. Channel Serial Settings _______________________________________________ 25 Figure 4-7. TCP Connection Settings ______________________________________________ 28 Figure 4-8. UDP Connection Settings ______________________________________________ 31 Figure 4-9. Configurable Pins Settings _____________________________________________ 32 Figure 4-10. Apply Settings and Apply Defaults ______________________________________ 33 Figure 5-1. MAC Address _______________________________________________________ 35 Figure 5-2. Setup Menu Options __________________________________________________ 35 Figure 7-1. Serial Port Parameters ________________________________________________ 40 Figure 7-2. Hostlist Option _______________________________________________________ 46 Figure 8-1. Expert Settings ______________________________________________________ 54 Figure 8-2. Security Settings _____________________________________________________ 56 Figure 10-1. TFTP Window ______________________________________________________ 68
Chapter Summary
The remaining chapters in this guide include:
Document 2: Introduction 3: Using DeviceInstaller 4: Configuration Using Web Manager 5: Configuration via Telnet or Serial Port (Setup Mode) Description Describes the main features of the xPico and the protocols it supports. Provides information for getting your unit up and running, using DeviceInstaller to assign an IP address. Details using the Web-Manager to set parameters such as port and server properties. Provides instructions for accessing Setup Mode (command line interface) using a Telnet connection through the network or a terminal or terminal emulation program through the serial port. Details the network (server) settings Details the serial port settings. Details expert and security settings and explains how to reset the unit to factory default values. Provides instructions for configuring the eight General Purpose I/O pins (CP1-8). Provides instructions for obtaining the latest firmware and updating the xPico. Provides instructions for accessing and using the command line interface for monitoring the network and diagnosing problems. Describes common problems and error messages and how to contact Lantronix Technical Support. Provides instructions for converting binary numbers to hexadecimals. Provides compliance information.
6: Setup Mode: Server Configuration 7: Setup Mode: Channel Configuration 8: Setup Mode: Advanced Settings 9: GPIO Interface 10: Firmware Upgrades 11: Monitor Mode
Additional Documentation
Visit the Lantronix Web site at www.lantronix.com/support/documentation for the latest documentation and the following additional documentation.
Document xPico Quick Start xPico Integration Guide Description Provides the steps for getting the xPico evaluation board up and running. Provides information about the xPico hardware, testing the xPico using the evaluation board, and integrating the xPico into your product. Instructions for using the xPico on the xPico evaluation board. Provides information on using the Windows-based utility to create a virtual com port. Provides information on using DeviceInstaller to configure IP addresses and locate Lantronix devices on the network.
xPico Development Kit Quick Start Com Port Redirector User Guide DeviceInstaller Online Help
10
2. Introduction
This chapter summarizes the xPico device servers features and the basic information needed to get started.
Capabilities
The xPico device server has the following capabilities: Connects devices through a TCP data channel or through a Telnet connection to computers or to another device server. The xPico also supports UDP datagrams. Contains a web [HTTP] server allowing presentation of custom content and easy configuration through a browser. Has eight programmable I/O pins used to monitor or control attached devices.
Applications
The xPico device server connects serial devices such as those listed below to Ethernet networks using the IP protocol family. ATM machines CNC controllers Data collection devices Environmental sensors Universal Power Supply (UPS) management units Telecommunications equipment Data display devices Security alarms and access control devices Handheld instruments Modems Time/attendance clocks and terminals
11
2: Introduction
Protocol Support
The xPico 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 target. Supported protocols include: ARP, TCP/IP, UDP/IP, BOOTP, ICMP, Telnet, TFTP, AutoIP, DHCP, HTTP, and SNMP for network communications and management. TCP/IP, UDP/IP, and Telnet for connections to the serial port. TFTP for firmware and web page updates. IP for addressing, routing, and data block handling over the network. User Datagram Protocol (UDP) for typical datagram applications in which devices interact with other devices without maintaining a point-to-point connection.
Configuration Methods
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 to assign an IP address and configure the unit: DeviceInstaller: Assign an IP address and view the current xPico configuration using a Graphical User Interface (GUI) on a PC attached to a network. (See 3 Using DeviceInstaller.) Web-Manager: Through a web interface, configure the xPico and its settings using the xPicos Web-Manager. (See 4 Configuration Using Web Manager Serial & Telnet Ports: There are two approaches to accessing Serial Mode. Make a Telnet connection to the network port (9999) or connect a terminal (or a PC running a terminal emulation program) to the units serial port. (See 5 Configuration via Telnet or Serial Port (Setup Mode) )
Note: Make note of the MAC address. It is needed to locate the xPico using DeviceInstaller.
12
2: Introduction
IP Address
Every device connected to an IP network must have a unique IP address. This address is used to reference the specific unit. The xPico is automatically assigned an IP address on DHCP-enabled networks, as it is DHCP-enabled by default.
Port Numbers
Every TCP connection and every UDP datagram is defined by a destination IP address and a port number. For example, a Telnet application commonly uses port number 23. A port number is similar to an extension on a phone system. The unit's serial channel (port) can be associated with a specific TCP/UDP port number. Port number 9999 is reserved for access to the unit's Setup (configuration) Mode window. Ports 0-1024 are reserved as well. For more information on reserved port numbers, see to Table 7-4. Reserved Port Numbers on page 42.
13
3. Using DeviceInstaller
This chapter covers the steps for getting the xPico device server online and viewing its current configuration. Note: DeviceInstaller is a free utility program provided by Lantronix that discovers, configures, upgrades, and manages Lantronix Device Servers. It can be downloaded from the Lantronix website at www.lantronix.com/support/downloads. For instructions on using DeviceInstaller to configure the IP address and related settings or for more advanced features, see the DeviceInstaller Online Help.
Installing DeviceInstaller
To install DeviceInstaller: 1. Download the latest version of DeviceInstaller from http://www.lantronix.com/downloads. 2. Run the executable to start the installation process. 3. Respond to the installation wizard prompts. (If prompted to select an installation type, select Typical).
Assigning an IP Address
The units IP address must be configured before it can work correctly on a network. You have several options for assigning an IP to your unit. We recommend that you manually assign the IP address over the network using DeviceInstaller. Note: To use a serial connection instead of an Ethernet connection to configure the device, see 5 Configuration via Telnet or Serial Port (Setup Mode) on page 35. The units IP address is normally set to 0.0.0.0 at the factory. The hardware address is on the product label. The unit is DHCP enabled as the default. To assign an IP address manually: 1. Click StartPrograms LantronixDeviceInstallerDeviceInstaller. If your PC has more than one network adapter, a message displays. Select an adapter and click OK. Note: If the unit already has an IP address (e.g., DHCP has assigned an IP address), click the Search icon and select the unit from the list of Lantronix device servers on the local network.
14
3: Using DeviceInstaller
3. If prompted, enter the hardware address (on the product label) and click Next. 4. Select Assign a specific IP address and click Next. 5. Enter the IP address. The Subnet mask displays automatically based on the IP address; if desired, you may change it. On a local network, you can leave the Default gateway blank (all zeros). Click Next. 6. Click the Assign button and wait several seconds until a confirmation message displays. Click Finish. 7. Select the device from the main window list and select Ping from the Tools menu. The Ping Device dialog box shows the IP address of the selected unit. 8. From the Tools menu, click the Ping button. The results display in the Status window. Click the Clear Status button to clear the window so you can ping the device again. Note: If you do not receive Reply messages, make sure the unit is properly attached to the network and that the IP address assigned is valid for the particular network segment you are working with. If you are not sure, check with your systems administrator. 9. Click the Close button to close the dialog box and return to the main window.
Name
Configurable field. A name that identifies the xPico. Double-click the field, type in the value, and press Enter to complete. This name is not visible on other PCs or laptops using DeviceInstaller.
15
3: Using DeviceInstaller
Non-configurable field. Displays the name associated with xPicos current IP address, if the IP address was obtained dynamically. To change the DHCP device name, see Configuration Using Web Manager or Configuration via Telnet or Serial Port (Setup Mode). Configurable field. A group name to categorize the xPico. Double-click the field, type in the value, and press Enter to complete. This group name is not visible on other PCs or laptops using DeviceInstaller. Configurable field. Information about the xPico. Double-click the field, type in the value, and press Enter to complete. This description or comment is not visible on other PCs or laptops using DeviceInstaller. Non-configurable field. Displays the xPicos device family as xPico. Non-configurable field. Displays the device type as xPico. Non-configurable field. Displays the xPicos ID embedded within the unit. Non-configurable field. Displays the xPicos hardware (or MAC) address. Non-configurable field. Displays the firmware currently installed on the xPico. Non-configurable field. Displays the full version nomenclature of the firmware. Non-configurable field. Displays the xPicos status as online, offline, unreachable (the xPico is on a different subnet), or busy (the xPico is currently performing a task). Non-configurable field. Displays the xPicos current IP address. To change the IP address, see Assigning an IP Address on page 14. Displays Dynamically if the xPico automatically received an IP address (e.g., from DHCP). Displays Statically if the IP address was configured manually. If the IP address was assigned dynamically, the following fields appear: Obtain via DHCP with value of True or False. Obtain via BOOTP with value of True or False. Obtain via RARP with value of True or False Obtain via Auto IP with value of True or False Non-configurable field. Displays the xPicos current subnet mask. To change the subnet mask, see Assigning an IP Address on page 14. Non-configurable field. Displays the xPicos current gateway. To change the gateway, see Assigning an IP Address on page 14. Non-configurable field. Displays the number of COB partitions supported. Non-configurable field. Displays the number of ports on the xPico. Non-configurable field. Displays 1-65s, the xPicos TCP keepalive value. The default setting is 45.
Group
Comments
Device Family Type ID Hardware Address Firmware Version Extended Firmware Version Online Status
IP Address
Subnet Mask
Gateway
16
3: Using DeviceInstaller
Telnet Supported Telnet Port Web Port Maximum Baud Rate Supported Firmware Upgradeable Supports Configurable Pins Supports Email Triggers Supports AES Data Stream Supports 485 Supports 921K Baud Rate Supports HTTP Server Supports HTTP Setup Supports 230K Baud Rate Supports GPIO
Non-configurable field. Indicates if Telnet sessions are permitted. Non-configurable field. Displays the xPicos port for Telnet sessions. Non-configurable field. Displays the xPicos port for WebManager configuration. Non-configurable field. Displays the xPicos maximum baud rate. Note: the xPico may not currently be running at this rate. Non-configurable field. Displays True, indicating the xPicos firmware is upgradeable as newer version become available. Non-configurable field. Displays True, indicating configurable pins are available on the xPico. Non-configurable field. Displays False, indicating email triggers are not supported on xPico. Non-configurable field. Displays True. xPico supports AES encryption. Non-configurable field. Displays True. xPico supports the RS485 protocol. Non-configurable field. Displays True. xPico supports baud rates up to 921600 bits per second (bps). Non-configurable field. Displays True. Non-configurable field. Displays True. Non-configurable field. Displays True. Non-configurable field. Displays True, indicating the xPico supports General Purpose Input Output (GPIO).
17
18
7. Perform one of the following: If no Telnet password has been defined (default), leave both fields blank and click OK. If a Telnet password has been defined, leave the username blank, type in the password, and then click OK. The Web-Manager displays.
Figure 4-2. Lantronix Web-Manager
Network Configuration
The units network values display when you select Network from the main menu. The following sections describe the configurable parameters on the Network Settings page.
19
Network Mode
1. Click Network from the main menu. 2. Note the following:
Network Mode Wired Only is the only choice. It enables the Ethernet network connectivity.
DHCP
20
Protocol (DHCP) to assign a leased IP address to the xPico unit automatically. Enable is the default. AutoIP Select Enable to permit the xPico to generate an IP in the 169.254.x.x address range with a Class B subnet. Enable is the default. Enter the desired host name for the xPico.
Note: Disabling BOOTP, DHCP, and AutoIP (all three checkboxes) is not advised as the only available IP assignment method will then be ARP or serial port. 4. When you are finished, click the OK button. 5. On the main menu, click Apply Settings.
DNS Server
4. When you are finished, click the OK button. 5. On the main menu, click Apply Settings.
Ethernet Configuration
You must specify the speed and direction of data transmission. To specify how data will be transmitted: 1. On the main menu, click Network. 2. Enter the following (as necessary):
21
Auto Negotiate
With this option, the Ethernet port auto-negotiates the speed and duplex with the hardware endpoint to which it is connected. This is the default. If this option is not selected, the complete the fields that become available:
Speed: The speed of data transmission. The default is 100 Mbps. Duplex: The direction of data transmission. The default is Full.
3. When you are finished, click the OK button. 4. On the main menu, click Apply Settings.
Server Configuration
The units server values display when you select Server from the main menu. The following sections describe the configurable parameters on the Server Settings page.
Figure 4-4. Server Settings
To configure the xPicos device server settings: 1. On the main menu, click Server. 2. Configure or modify the following fields:
22
Server Configuration
Advanced Password Select whether to enable advanced password: Enable: selecting this option enables advanced password creation, allowing you to create passwords up to 16 bytes in length. Disable: selecting this option disables advanced password creation, allowing you to create basic passwords up to 4 bytes in length. Enter the password required for Telnet configuration and Web Manager access. Re-enter the password required for Telnet configuration and Web Manager access.
Advanced
ARP Cache Timeout When the unit communicates with another device on the network, it adds an entry into its ARP table. ARP Cache timeout defines the number of seconds (1-600) before it refreshes this table. TCP Keepalive time defines how many seconds the unit waits during an inactive connection before checking its status. If the unit does not receive a response, it drops that connection. Enter a value between 0 and 60 seconds. 0 disables keepalive. The default setting is 45. Select Disable to disable entry into the monitor mode using the 'yyy' or 'xx1' key sequence at startup. This field prevents the unit from entering monitor mode by interpreting the stream of characters that are received during the device server's initialization at startup. Select the xPicos performance mode. Higher performance settings require more energy. Regular is 48 Mhz; High is 88 Mhz. The default is Regular. This option allows the configuration of the web server port number. The valid range is 1-65535. The default port is 80. Not applicable for this product. The Maximum Transmission Unit (MTU) is the largest physical packet size a network can transmit for TCP and UDP. Enter between 512 and 1400 bytes. The default is 1400 bytes. The desired TCP re-transmission timeout value. If the ACK is not received for a packet sent from the xPico device, then the unit will retransmit the data. The valid range is 500-4000 msec.
TCP Keepalive
3. When you are finished, click the OK button. 4. On the main menu, click Apply Settings.
23
The host list supports a minimum of 1 and a maximum of 12 entries. Each entry contains an IP address and a port number. Note: The host list is disabled for Manual and Modem Mode. The unit does not accept a data connection from a remote device when the hostlist option is enabled. To configure the xPicos host list: 1. On the main menu, click Hostlist.
Figure 4-5. Hostlist Settings
Retry Settings
Retry Counter Retry Timeout Enter the value for the number of times the xPico should attempt to retry connecting to the host list. Enter the duration (in milliseconds) the xPico should abandon attempting a connection to the host list.
Host Information
Host Address Port Enter or modify the hosts IP address. Enter the target port number.
3. When you are finished, click the OK button. 4. On the main menu, click Apply Settings.
24
Note: Directions for configuring Channel 1 serial settings and connection apply for Channel 2 configuration, except where indicated.
Serial Settings
To configure the channels serial settings: 1. On the main menu, click Serial Settings (under Channel 1) to display the Serial Settings window.
Figure 4-6. Channel Serial Settings
Channel 1
Disable Serial Port When selected, disables communication through the serial port. The serial port is enabled by default. Note: This checkbox only applies to Channel 2.
Port Settings
Protocol From the drop-down menu, select the protocol type for the selected channel. Channel 1: RS232, RS422/RS485 4 wire or RS485 2 wire protocols. Channel 2: RS232 only Flow control manages data flow between devices in a network to ensure it is processed efficiently. Too much data arriving before a
Flow Control
25
device is prepared to manage it causes lost or retransmitted data. None is the default. Channel 1: None, Xon/Xoff, Xon/Xoff Pass Chars to Host or CTS/RTS (hardware). Channel 2: None, Xon/Xoff or Xon/Xoff Pass Chars to Host Baud Rate The unit and attached serial device, such as a modem, must agree on a speed or baud rate to use for the serial connection. Valid baud rates are 300, 600, 1200, 2400, 4800, 9600 (default), 19200, 38400, 57600, 115200, or 230400, 460800, or 921600 Note: It is recommended to use hardware flow control for baud
Indicates the number of bits in a transmitted data package. The default is 8. Checks for the parity bit. The default is None. The stop bit follows the data and parity bits in serial communication. It indicates the end of transmission. The default is 1.
Pack Control
Enable Packing Select to enable packing on the xPico. Two firmware-selectable packing algorithms define how and when packets are sent to the network. The standard algorithm is optimized for applications in which the unit is used in a local environment, allowing for very small delays for single characters, while keeping the packet count low. The alternate packing algorithm minimizes the packet count on the network and is especially useful in applications in a routed Wide Area Network (WAN). Adjusting parameters in this mode can economize the network data stream. Disabled by default. Idle Gap Time Match 2 Byte Sequence Select the maximum time for inactivity. The default time is 12 milliseconds. Use to indicate the end of a series of data to be sent as one group. The sequence must occur sequentially to indicate end of the data collection to the xPico. The default is No. Use to indicate the end of a series of data to be sent as one group. Set this value to 00 if specific functions are not needed. After the detection of the byte sequence, indicates whether to send the data frame or the entire buffer. Select Yes to send only the data frame. The default setting is No. Select the number of bytes to send after the end-of-sequence characters. The default is None.
26
from the network to the device. The default is No. At Time of Disconnect Select Yes to clear the input buffer when the network connection to or from the device is disconnected. The default is No.
3. When you are finished, click the OK button. 4. On the main menu, click Apply Settings.
27
28
Connect Protocol
Protocol From the drop-down menu, select TCP.
Password
Endpoint Configuration
Local Port Auto increment for active connect Enter the local port number. Select to auto-increment the local port number for new outgoing connections. The range of auto-incremented port numbers is 50,000 to 59,999 and loops back to the beginning when the maximum range is reached. Enter the remote port number. Enter the IP address of the remote device.
Common Options
Telnet Com Port Cntrl This field is available for configuration only when Active
29
Connect is set to None. Select Enable to permit Telnet communication to the unit. The Telnet Com Port Cntrl feature is used in conjunction with the Com Port Redirector (CPR) utility. (See the CPR online Help for details.) Terminal Name This field is available for configuration only when Telnet Mode is set to Enable. Use the terminal name for the Telnet terminal type. Enter only one name. When this option is enabled, the unit also reacts to the end of record (EOR) and binary options, which can be used for applications such as terminal emulation to IBM hosts. A single character is transmitted to the serial port when there is a change in connection state. Default setting is None. If this option is set to True, the device server scrolls through the host list until it connects to a device listed in the host list table. Once it connects, the unit stops trying to connect to any others. If this connection fails, the unit continues to scroll through the table until it connects to another IP in the host list. The host list is disabled for Manual Mode and for Modem Mode. The unit will not accept a data connection from a remote device when the host list option is enabled. Select Blink for the status LEDs to blink upon connection or None for no LED output.
LED
Disconnect Mode
On Mdm_Ctrl_In Drop Set to Yes for the network connection to or from the serial port to disconnect (drop) when Modem Control In transitions from an asserted state to not asserted state. The default setting is No. When set to Yes, the TCP connection closes even if the remote site does not acknowledge the disconnect request. Select Yes to drop the connection when Ctrl-D or Hex 04 is detected. Both Telnet Com Port Cntrl and Check EOT (Ctrl+ D) must be enabled for Disconnect with EOT to function properly. Ctrl+D is only detected going from the serial port to the network. The default setting is No. Use this parameter to set an inactivity timeout. The unit drops the connection if there is no activity on the serial line before the set time expires. Enter time in the format mm:ss, where m is the number of minutes and s is the number of seconds. To disable the inactivity timeout, enter 00:00.
Inactivity Timeout
3. When you are finished, click the OK button. 4. On the main menu, click Apply Settings.
30
Connect Protocol
Protocol Select UDP from the drop-down menu.
Datagram Mode
Datagram Type Configures the remote IP or network broadcast address and the remote port. Enter 01 for directed or broadcast UDP. The default setting is 00. Select Yes to accept incoming UDP datagrams.
Accept Incoming
Endpoint Configuration
Local Port Remote Port Remote Host Use Broadcast Enter the local port number. Enter the port number of the remote device. Enter the IP address of the remote device. Select to broadcast the UDP datagram. The default is not to broadcast. Note: Datagrams are sent as subnet-directed broadcasts. The table is enabled when Datagram Type is set to FD. Enter values between 1 and 255 to identify units on the local network of device servers. Note: Lantronix Tech Support supports Datagram type 01. Datagram Type FD is for OEM use.
31
3. When you are finished, click the OK button. 4. On the main menu, click Apply Settings.
32
2-wire and 4-wire mode on OEM hardware design. Serial Channel 1 Status LED Serial Channel 2 Status LED Indicates channel 1 status and extended diagnostics. Indicates channel 2 status and extended diagnostics.
3. When you are finished, click the OK button. 4. On the main menu, click Apply Settings.
Apply Settings
1. To save and apply the configuration changes to the device server, click the Apply Settings button. Note: Clicking OK on each page does not change the configuration on the device. Clicking the OK button tells the xPico what changes to use; the Apply Settings button makes the changes permanent and reboots the xPico.
Apply Defaults
1. Click the Apply Defaults button to set the device server back to the default settings. For details see Default Settings on page 60. 2. Click Yes to set factory settings or click No to cancel.
Figure 4-10. Apply Settings and Apply Defaults
33
34
To establish a Telnet connection: 1. From the Windows Start menu, click Run and type the following command, where x.x.x.x is the IP address, and 9999 is the units fixed network configuration port number:
Windows: telnet x.x.x.x 9999 UNIX: telnet x.x.x.x:9999
3. To enter Setup Mode, press Enter within 5 seconds. The configuration settings display, followed by the Change Setup menu.
Figure 5-2. Setup Menu Options Change Setup: 0 Server 1 Channel 1 2 Channel 2 5 Expert 6 Security 7 Defaults 8 Exit without save 9 Save and exit
Your choice ?
4. Select an option on the menu by entering the number of the option in the Your choice ? field and pressing Enter. 5. To enter a value for a parameter, type the value and press Enter, or to confirm a current value, just press Enter. 6. When you are finished, save the new configuration (option 9). The unit reboots.
35
Note: The easiest way to enter Setup Mode is to hold down the x key at the terminal (or emulation) while resetting the unit. You must do this within three seconds of resetting the xPico. At this point, the screen display is the same as when you use a Telnet connection. To continue, go to step 4, above, in the section, Telnet Connection .
36
IP Address
If DHCP is not used to assign IP addresses, enter the IP address manually. The IP address must be set to a unique value in the network. Enter each octet and press Enter between each section. The current value displays in parentheses.
IP Address : ( 0) ( 0) ( 0) ( 0) _
If DHCP is used, the third octet of the IP address sets the BootP/DHCP/AutoIP options. The following table shows the bits you can manually configure to force the xPico to disable AutoIP, DHCP, or BootP. To disable an option, set the appropriate bit.
Table 6-1. BootP/DHCP/AutoIP Options
Options
AutoIP DHCP BootP
Bit
0 1 2
For example, if the third octet is 0.0.5.0, the AutoIP and BootP options are disabled; only DHCP is enabled. (The value 5 results from adding the binary equivalents of 0 and 2.) This is the most common setting when using DHCP.
37
Note: Class A: 24 bits; Class B: 16 bits; Class C: 8 bits The unit prompts for the number of host bits to be entered, then calculates the netmask, which appears in standard decimal-dot notation (for example, 255.255.255.0) when the saved parameters display.
Table 6-2. Standard IP Network Netmasks
Network Class
A B C
Host Bits
24 16 8
Netmask
255.0.0.0 255.255.0.0 255.255.255.0
38
An enhanced password setting (for Telnet access only) of 16 characters is available under Security Settings (Option 6) on page 56. Note: You do not need a password to access the Setup Mode window by a serial connection.
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 DHCP Name: If you do not change the DHCP name, and you are using an IP of 0.0.0.0, then the DHCP name defaults to CXXXXXX (XXXXXX is the last 6 digits of the MAC address shown on the label on the bottom/side of the unit). For example, if the MAC address is 00-20-4A-12-34-56, then the default DHCP name is C123456. Custom DHCP Name: You can create your own DHCP name. If you are using an IP address of 0.0.0.0, then the last option in Server configuration is Change DHCP device name. This option allows you to change the DHCP name to an alphanumeric name (LTX in our example).
Change DHCP device name (not set) ? (N) Y Enter new DHCP device name : LTX
Numeric DHCP Name: You can change the DHCP name by specifying the last octet of the IP address. When you use this method, the DHCP name is LTXYY where YY is what you chose for the last octet of the IP address. If the IP address you specify is 0.0.0.12, then the DHCP name is LTX12. This method only works with 2 digit numbers (01-99).
39
Baudrate
The unit and attached serial device, such as a modem, must agree on a speed or baud rate to use for the serial connection. Valid baud rates are 300, 600, 1200, 2400, 4800, 9600 (default), 19200, 38400, 57600, 115200, and 230400 bits per second. xPico also supports high-performance baud rates of 460800 and 921600 bits per second. (See CPU Performance on page 55).
Baudrate (9600) ? _
40
The following table displays available I/F Mode options: Note: All bit positions in the table that are blank represent dont care bits for that particular option, which can be set to either a 0 or 1 value.
Table 7-1. Interface Mode Options
1
0 0 1
0
0 1 1
RS-422/485 RS-485 2-wire 7 Bit 8 Bit No Parity Even Parity Odd Parity 1 stop bit 2 stop bits
(1)
1 1 0 1 0 0 1 1 1 0 1 1
0 1
(1) 2 stop bits are implemented by the software. This might influence performance.
The following table demonstrates how to build some common Interface Mode settings:
Table 7-2. RS232 Interface Mode Settings
Binary
0100 1100 0111 1000
Hex
4C 78
Flow
Flow control sets the local handshaking method for stopping serial input/output.
Flow (00) ? _
41
Hex
00 01 02 05
Port Number
The setting represents the source port number in TCP connections. It is the number that identifies the channel for remote initiating connections.
Port No (10001) ? _
The default setting for Port 1 is 10001. The default setting for Port 2 is 10002. The range is 1-65535, except for the following reserved port numbers:
Table 7-4. Reserved Port Numbers
Port Numbers
1 1024 9999 14000-14009 30704 30718
Reserved for
Reserved (well known ports) Telnet setup Reserved for Redirector Reserved (77F0h) Reserved (77FEh)
WARNING: We recommend that you not use the reserved port numbers for this setting as incorrect operation may result. Use Port 0 for the outgoing local port to change with each connection. The port range is 50,000 to 59,999. Each subsequent connection increments the number by 1 (it wraps back around to 50,000). Only use this automatic port increment feature to initiate a connection using TCP. Set the port to a non-zero value when the unit is in a passive mode or when using UDP instead of TCP.
Connect Mode
Connect Mode defines how the unit makes a connection, and how it reacts to incoming connections over the network.
ConnectMode (C0) ? _
Enter Connect Mode options in hexadecimal notation. Note: All bit positions in the table that are blank represent dont care bits, for that particular option, which can be set to either a 0 or 1 value.
42
0 0 1
0 1 1
0 0 0
0 1
0 0 0 0 0 0 0 0 1 0
0 0 0 0 1 1
0 0 1 1 0 0
0 1 0 1 0 1
0 0 0 0 0 0
0 1 1 0 1 1 1
1 1 1 1 1
1 1 1 1 0 1 0 1
a) Incoming Connection
Never Accept Incoming Accept with active Modem Control In Always Accept Rejects all external connection attempts. Accepts external connection requests only when the Modem Control In input is asserted. Cannot be used with Modem Mode. Accepts any incoming connection when a connection is not already established. Default setting.
43
b) 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. The IP address of the host connecting to the CoBos device will be provided when you use verbose mode. This option is overridden when the Active Start Modem Mode or Active Start Host List is in effect. Default setting is Nothing (quiet).
c) Active Startup
No Active Startup With Any Character With active Modem Control In With a Specific Start Character Does not attempt to initiate a connection under any circumstance. Default setting. Attempts to connect when any character is received from the serial port. Attempts to connect when the Modem Control In input changes from not asserted to asserted. Attempts to connect when it receives a specific start character from the serial port. The default start character is carriage return.
44
Manual Connection
Attempts to connect when directed by a command string received from the serial port. The first character of the command string must be a C (ASCII 0x43), and the last character must be either a carriage return (ASCII 0x0D) or a line feed (0x0A). No blanks or space characters may be in the command string. Between the first and last command string characters must be a full or partial destination IP address and may be a destination port number. The IP address must be in standard decimal-dot notation and may be a partial address, representing the least significant 1, 2, or 3 bytes of the remote IP address. The period is required between each pair of IP address numbers. If present, the port number must follow the IP address, must be presented as a decimal number in the range 1-65535, and must be preceded by a forward slash (ASCII 0x2F). The slash separates the IP address and the port number. If you omit the port number from a command string, the internally stored remote port number starts a connection. If a partial IP address is presented in a command string, it is interpreted to be the least significant bytes of the IP address and uses the internally stored remote IP address to provide the most significant bytes of the IP address. If the IP address entered is 0.0.0.0/0, the device server enters Monitor Mode. For example, if the remote IP address already configured in the unit is 129.1.2.3, then an example command string would be C3/7. (This would connect to 129.1.2.3 and port 7.) You may also use a different ending for the connection string. For example, C50.1/23 would connect you to 129.1.50.1 and port 23. If an IP address does not follow the first command string character (which is "C"), the subsequent character string is interpreted as the host name and domain to be used in DNS lookup. This character string can include a destination port number as well. The port number can be preceded by either a forward slash (/) or a colon ( : ).
Command String
C121.2.4.5/1 C5 C28.10/12 C0.0.0.0/0 Cwww.lantronix.com/80
45
Command String
Baudrate (9600) ? I/F Mode (4C) ? Flow (00) ? Port No (10001) ? ConnectMode (C0) ? 25 Send '+++' in Modem Mode (Y) ? Show IP addr after 'RING' (Y) ? Auto increment source port (N) ? Hostlist 01. IP : 02. IP : 03. IP : : 172.019.205.011 172.019.205.012 172.019.205.013 Port : 00001 Port : 00002 Port : 00003
Change Hostlist ? (N) ? Hostlist Retrycounter (3) ? Hostlist Retrytimeout (250) ? DisConnMode (00) ? FlushMode (00) ? DisConnTime (00:00) ?: SendChar 1 (00) ? SendChar 2 (00) ?
To enable the hostlist: 1. Enter a Connect Mode of 0x20 (2X), where X is any digit. The menu shows you a list of current entries already defined in the product. 2. To delete, modify, or add an entry, select Yes. If you enter an IP address of 0.0.0.0, that entry and all others after it are deleted. 3. After completing the hostlist, repeat the previous step if necessary to edit the hostlist again. 4. For Retrycounter, enter the number of times the Lantronix unit should try to make a good network connection to a hostlist entry that it has successfully ARPed. The range is 1-15, with the default set to 3. 5. For Retrytimeout, enter the number of seconds the unit should wait before failing an attempted connection. The time is stored as units of milliseconds in the range of 10-65535. The default is 250.
46
d) Datagram Type
Directed UDP When selecting this option, you are prompted for the Datagram type. Enter 01 for directed or broadcast UDP. Datagrams of type 01 can be sent as a broadcast by enabling the Send as Broadcast option. The default is not to broadcast. When the UDP option is in effect, the unit never attempts to initiate a TCP connection because it uses UDP datagrams to send and receive data.
e) Modem Mode
In Modem (Emulation) Mode, the unit presents a modem interface to the attached serial device. It accepts AT-style modem commands and handles the modem signals correctly. Normally, there is a modem connected to a local PC and a modem connected to a remote machine. A user must dial from the local PC to the remote machine, accumulating phone charges for each connection. Modem Mode allows you to replace modems with xPicos, and to use an Ethernet connection instead of a phone call. By not having to change communications applications, you avoid potentially expensive phone calls. To select Modem Mode, set the Connect Mode to C6 (no echo), D6 (echo with full verbose), D7 (echo with numeric response), CF (modem responses only, numeric response), or CE (modem responses only, full verbose). Note: If the unit is in Modem Mode, and the serial port is idle, the unit can still accept network TCP connections to the serial port if Connect Mode is set to C6 (no echo), D6 (echo with full verbose), D7 (echo with numeric response, CF (modem responses only, numeric response), or CE (modem responses only, full verbose).
Without Echo In Modem Mode, echo refers to the echo of all of the characters entered in command mode; it does not mean to echo data that is transferred. Quiet Mode (without echo) refers to the modem not sending an answer to the commands received (or displaying what was typed). Full Verbose: The unit echoes modem commands and responds to a command with a message string shown in the table below. Numeric Response: The unit echoes modem commands and responds to a command with a numeric response. Full Verbose: The unit does not echo modem commands and responds to a command with a message string shown in the table below. Numeric Response: The unit does not echo modem commands and responds to a command with a numeric response.
Message
Full Verbose OK CONNECT NO CARRIER RING n.n.n.n.
Meaning
Command was executed without error. A network connection has been established. A network connection has been closed. A remote device, having IP address n.n.n.n, is connecting to this device.
47
Message
Numeric Response 0 1 2 3 4
Meaning
Received commands must begin with the two-character sequence AT and be terminated with a carriage return character. The unit ignores any character sequence received not starting with AT, and only recognizes and processes single AT-style commands. The unit treats compound AT commands as unrecognized commands. If the Full Verbose option is in effect, the unit responds to an unrecognized command string that is otherwise formatted correctly (begins with AT and ends with carriage return) with the "OK" message and takes no further action. If the Numeric Response option is in effect, the unit responds to an unrecognized command string that is otherwise formatted correctly with the "OK" message and takes no further action. When an active connection is in effect, the unit transfers data and does not process commands received from the serial interface. When a connection is terminated or lost, the unit reverts to command mode. When an active connection is in effect, the unit terminates the connection if it receives the following sequence from the attached serial device: No serial data is received for one second. The character sequence +++ is received, with no more than one second between each two characters. No serial data is received for one second after the last + character. At this time, the unit responds affirmatively per the selected echo/response mode. 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 strings. If this sequence is not followed, the unit remains in data transfer mode.
Table 7-8. Modem Mode Commands
Function
Makes a connection to an IP address (x.x.x.x) and a remote port number (pppp). Makes a connection to an IP address (x.x.x.x) and the remote port number defined within the unit.
48
Function
Forces the unit into Monitor Mode if a remote IP address and port number are defined within the unit. Forces the unit into Monitor Mode if a remote IP address and port number are not defined within the unit. Makes a connection to an IP address (x.x.x.x) and the remote port number defined within the unit. Hangs up the connection (Entered as +++ATH ). Enables or disables connections from the network going to the serial port. n=0 disables the ability to make a connection from the network to the serial port.
ATD or ATDT
ATDx.x.x.x ATH
ATS0=n n=1-9 enables the ability to make a connection from the network to the serial port. n>1-9 is invalid. Enables or disables character echo and responses. n=0 disables character echo and responses. n=1 enables character echo and responses. Enables numeric response or full verbose. n=0 enables numeric response. n=1 enables full verbose.
ATEn
ATVn
Note: The unit recognizes these AT commands as single commands such as ATE0 or ATV1; it does not recognize compound commands such as ATE0V.
Disable or enable the xPicos ability to send the escape sequence. The default is Y (Yes) (send the escape sequence).
Disable or enable the xPico's ability to show the IP address after RING in Modem Mode. The default is Y (Yes), to show the IP address.
49
Y (Yes) auto increment the source port. The xPico increments the port number used with each new connection.
Remote IP Address
This is the destination IP address used with an outgoing connection.
Remote IP Address : (000) (000) (000) (000)_
Note: This option does not display when Hostlist is enabled from the ConnectMode prompt (see Connect Mode on page 42 for more information).
Remote Port
You must set the remote TCP port number for the unit to make outgoing connections. This parameter defines the port number on the target host to which a connection is attempted.
Remote Port (0) ? _
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). Note: This option does not display when Hostlist is enabled from the ConnectMode prompt (see Connect Mode on page 42 for more information).
DisConnMode
This setting determines the conditions under which the unit will cause a network connection to terminate.
DisConnMode (00) ? _
Notes: In DisConnMode (Disconnect Mode), Modem Control In drop either drops the connection or is ignored. All bit positions in the table that are blank represent dont care bits, for that particular option, which can be set to either a 0 or 1 value.
Table 7-9. Disconnect Mode Options
7
1 0
1 1 0 1
50
0
1
(1) The Telnet Com Port Control feature is used in conjunction with Com Port Redirector. The unit sends the Terminal Type upon an outgoing connection. (2) A password is required for a connection to the serial port from the network. (3) The TCP connection closes even if the remote site does not acknowledge the disconnection. (4) When there is a network connection to or from the serial port, the state LED turns off instead of blinking. (5) When Ctrl+D or Hex 04 is detected, the connection is dropped. Both Telnet Com Port Cntrl and Disconnect with EOT must be enabled for Disconnect with EOT to function properly. Ctrl+D is only detected going from the serial port to the network. (6) When Modem Control In transitions from a high state to a low state, the network connection to or from the serial port drops.
You can also select between two different packing algorithms. Note: All bit positions in the table that are blank represent dont care bits, for that particular option, which can be set to either a 0 or 1 value.
Table 7-10. Flush Mode Options
Function
Input Buffer (Serial to Network) Clear with a connection initiated from the device to the network Clear with a connection initiated from the network to the device Clear when the network connection to or from the device is disconnected Output Buffer (Network to Serial) Clear with a connection initiated from the device to the network Clear with a connection initiated from the network to the device Clear when the network connection to or from the device is disconnected Alternate Packing Algorithm (Pack Control) Enable
4
1
1 1
1 1 1
Pack Control
The packing algorithms define how and when packets are sent to the network. The standard algorithm is optimized for applications in which the unit is used in a local environment, allowing for very small delays for single characters, while keeping the packet count low. The alternate packing algorithm minimizes the packet count on the network and is especially useful in applications in a routed Wide Area Network (WAN). Adjusting parameters in this mode can economize the network data stream.
51
Pack control settings are enabled in Flush Mode. Set this value to 00 if you do not need specific functions. Note: All bit positions in the table that are blank represent dont care bits, for that particular option, which can be set to either a 0 or 1 value.
Table 7-11. Pack Control Options
Option
Packing Interval Interval: 12ms Interval: 52ms Interval: 250ms Interval: 5sec Trailing Characters None One Two Send Characters 2-Byte Send Character Sequence Send Immediately After Send chars
0 0 1 1
0 1 0 1
0 0 1
0 1 0
1 1
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.
Trailing Characters
In some applications, CRC, Checksum, or other trailing characters follow the end-ofsequence character; this option helps to adapt frame transmission to the frame boundary.
Send Characters
If 2-Byte Send Character Sequence is enabled, the unit interprets the sendchars as a 2-byte sequence; if this option is not enabled, the unit interprets them independently. If Send Immediately After Characters is not set, any characters already in the serial buffer are included in the transmission after a "transmit" condition is found. If this option is set, the unit sends immediately after recognizing the transmit condition (sendchar or timeout). Note: A transmission might occur if status information needs to be exchanged or an acknowledgment needs to be sent.
52
To disable the inactivity timeout, enter 00:00. Range is 0 (disabled) to 5999 seconds (99 minutes, 59 seconds). Default is 0.
Send Characters
Enter up to two characters in hexadecimal representation in sendchar.
SendChar 1 ( 0) ? _ SendChar 2 ( 0) ? _
If the unit receives a character on the serial line that matches one of these characters, it sends the character immediately, along with any awaiting characters, to the TCP connection. This action minimizes the response time for specific protocol characters on the serial line (for example, ETX, EOT). Setting the first sendchar to 00 disables the recognition of the characters. Alternatively, the unit can interpret two characters as a sequence (see Pack Control on page 51).
53
54
CPU Performance
This option allows you to increase the CPU performance required to use the higher baud rates on the serial interface (460800 bps and 921600 bps). The standard CPU performance mode supports up to 230400 bps.
CPU performance (0=Regular, 1=Low, 2=High): (0) ?
Notes: If a baud rate of 460 Kbps or 920 Kbps is set and the high performance mode is disabled, the operation of the serial channel would be out of the specified error tolerance, thereby leading to inconsistent speed settings on the two ends of the serial channel. Increasing CPU clock speed consumes more power and generates more heat. This reduces the maximum operating temperature specification. See the appropriate product brief for details.
MTU Size
The Maximum Transmission Unit (MTU) is the largest physical packet size a network can transmit for TCP and UDP. Enter between 512 and 1400 bytes. The default is 1400 bytes.
MTU Size: (1400) ? _
55
56
Disable SNMP
This setting allows you to disable the SNMP protocol on the unit for security reasons.
Disable SNMP (N) ? _
57
The default setting is the N (No) option, which enables remote configuration. You can configure the unit by using DeviceInstaller, web pages, Telnet, or serial configuration. The Y (Yes) option disables remote configuration and web sites. Note: The Y (Yes) option disables many of the GUI tools for configuring the unit, including the embedded Web-Manager tool.
58
Enable Encryption
Rijndael is the block cipher algorithm chosen by the National Institute of Science and Technology (NIST) as the Advanced Encryption Standard (AES) to be used by the US government. The xPico supports 128-, 192-, and 256-bit encryption key lengths. Note: Configuring encryption should be done through a local connection to the serial port of the xPico, or via a secured network connection. Initial configuration information, including the encryption key, is sent in clear text over the network. To configure AES encryption on the xPico:
1. When prompted to enable encryption, select Y. 2. When prompted, enter the encryption key length. The xPico supports 128-, 192-, and 256-bit encryption key lengths. 3. When prompted to change keys, select Y. 4. At the Enter Keys prompt, 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. Hexadecimal values are 0-9 and A-F.
For a 128-bit key length, enter 32 hexadecimal characters. For a 192-bit key length, enter 48 hexadecimal characters. For a 256-bit key length, enter 64 hexadecimal characters
5. Continue pressing Enter until you return to the Change Setup menu. 6. From the Change Setup menu, select option 9 to save and exit. Encryption only applies to the port selected for data tunneling (default 10001 for Channel 1 and 10002 for Channel 2), regardless of whether you are using TCP or UDP. Generally, one of these situations applies: Encrypted xPico-to-xPico communication. Be sure to configure both modules with the same encryption key. Third-party application to xPico-encrypted communication: xPico uses standard AES encryption protocols. To communicate successfully, products and applications on the peer side must use the same protocols and the same encryption key as the xPico.
59
Lantronix Secure Com Port Redirector provides an encrypted connection from Windows-based applications to the xPico. Information about SCPR is at www.lantronix.com/device-networking/utilities-tools/scpr A 30-day trial version of SCPR is available. Note: Developers can license the Lantronix Encryption Library Suite. See www.lantronix.com/device-networking/utilities-tools.
60
Hostlist retry timeout Start character for serial channel 1 (or channel 2) All other parameters
61
9. GPIO Interface
Configurable Pins
The xPico has eight pins (CP1-8) that you can configure for General Purpose I/O (GPIO). Note: You can also configure the pins for serial port control lines, such as hardware control, modem control (CTS, RTS, DTR, and DCD), and diagnostic outputs to LED, using DeviceInstaller. You can use these GPIO pins to control devices such as relays, servers, lights, monitor switches, sensors, and even processes such as data transfer. You can set the functions for the eight pins independently and in any combination. The initial directions (input/output) and active levels (active low or high) at boot up can also be configured through 77FE, for example, by using DeviceInstaller. This chapter describes how the directions, active levels, and states can be dynamically controlled and probed through special port 77F0. The configurable pins default configuration is: Function: General Purpose Input Active Level: Active Low
Features
TCP and UDP can be used. The protocol supports up to 32 GPIO for future products. Function configuration can be retrieved. Input or output selection can be retrieved and controlled. Active low or high selection can be retrieved and controlled. Active or inactive selection can be retrieved and controlled. 77F0 can be disabled. Every change of state (active/inactive) requires a command over TCP or UDP, and thus is not very fast. If you use this port for data transfer, the throughput is low, usually up to 1 Kbps.
62
9: GPIO Interface
Control Protocol
The GPIO control protocol is a simple, proprietary protocol.
Guidelines
The GPIO control protocol is described from the PC side. Send means from PC to xPico. Response comes from xPico to PC. The protocol allows for control of up to 32 GPIOs. How many are actually available depends on the product. xPico has only eight. The parameters are four bytes long and represent GPIOs 0-31, with GPIO0 in bit 0 of the first byte (Little Endian). Parameter bits for configurable pins not configured as GPIOs are undefined for Get commands and ignored on Set commands. Every command consists of nine bytes: one command type of one byte and two parameters of four bytes each.
Command 0 1 Parameter 1 2 3 4 5 Parameter 2 6 7 8
On some commands, one or all parameters are ignored. For UDP, command type and parameters need to be in the same datagram. Responses to valid commands are always five bytes long, consisting of the returned command byte and as parameters in the current or updated values. In case of an invalid command, only one byte with value 0FFh is returned.
Command 0 1 Parameter 1 2 3 4
When sending a command (TCP and UDP), wait for the response before sending the next command.
Commands
Byte 0 Command Types
10h 11h 12h 13h 19h 1Ah 1Bh Get functions Get directions (input or output) Get active levels (high active or low active) Get current states (active or not active) Set directions Set active levels Set current states
There is no Set functions command. Since the pins function depends on the hardware in which the xPico is embedded, that configuration is only allowed using 77FE. Settings changed by any of the Set commands are not stored and are lost when the unit is powered down or rebooted.
63
9: GPIO Interface
64
9: GPIO Interface
Examples
Example 1: PC sends command 10h to find out which configurable pins are available as GPIO. PC -> xPico: 10h, 00h, 00h, 00h, 00h, 00h, 00h, 00h, 00h xPico -> PC: 10h, 03h, 00h, 00h, 00h Command details:
65
9: GPIO Interface
10h = command 10h 00h, 00h, 00h, 00h = ignored 00h, 00h, 00h, 00h = ignored Response details: 10h = response to command 10h 03h, 00h, 00h, 00h = bits 0 and 1 are 1 CP1 and CP2 are configured as GPIOs. bit 2 is 0 CP3 is configured as either serial control or diagnostics. The other bits are ignored because there are only eight configurable pins on the xPico. Example 2: PC sends command 1Bh to change the current states of GPIO 0 and 1. PC -> xPico: 1Bh, 01h, 00h, 00h, 00h, 00h, 00h, 00h, 00h xPico -> PC: 1Bh, 05h, 00h, 00h, 00h Command details: 1Bh = command 1Bh 01h, 00h, 00h, 00h = the mask that determines which GPIOs will be changed. bit 0 is 1 GPIO0 will be changed. bit 1 is 0 GPIO1 will remain the same. 00h, 00h, 00h, 00h = the new states bit 0 is 0 GPIO0 will become 0. bit 1 is ignored since it is masked out. Response details: 1Bh = response to command 1Bh 05h, 00h, 00h, 00h = bit 0 is 1 GPIO0 = 1 bit 1 is 0 GPIO1 = 0 bit 2 is 1 GPIO2 = 1 The other bits are ignored because there are only eight configurable pins on the xPico.
66
Reloading Firmware
There are several ways to update the unit's internal operational code (*.ROM): using DeviceInstaller (the preferred way), using TFTP, or using the serial port. You can also update the unit's internal Web interface (*.COB) using TFTP or DeviceInstaller. Here are typical names for those files. Check the Lantronix web site for the latest versions and release notes.
Table 10-1. Firmware Files ROM File xpico_6800.rom COB xpico_webm_1900.cob
Please refer to the DeviceInstaller online Help for information about reloading firmware using DeviceInstaller. The other methods are discussed below.
67
6. Click the Put button to transfer the file to the unit. The unit performs a power reset after the firmware has been loaded and stored. After the firmware has been loaded and stored, which takes approximately 8 seconds to complete, the unit performs a power reset.
The following examples demonstrate the TFTP command sequence to download the .rom file and the .cob file:
tftp i 192.168.1.111 put xpico_6800 X6 tftp i 192.168.1.111 put xpico_webm_1900.cob WEB1
68
69
70
Table 11-1. Monitor Mode Commands Command VS x.x.x.x GC x.x.x.x SC x.x.x.x PI x.x.x.x AT TT NC RS QU G0, G1, ....,Ge, Gf S0, S1,...,Se, Sf GM SS Command Name Version Get Configuration Send Configuration Ping ARP Table TCP Connection Table Network Connection Reset Quit Get configuration from memory page Set configuration to memory page Get MAC address Set Security record Function Queries software header record (16 bytes) of unit with IP address x.x.x.x. Gets configuration of unit with IP address x.x.x.x as hex records (120 bytes). Sets configuration of unit with IP address x.x.x.x from hex records. Pings unit with IP address x.x.x.x to check device status. Shows the units ARP table entries. Shows all incoming and outgoing TCP connections. Shows the units IP address, gateway, subnet mask, and DNS server. Resets the units power. Exits diagnostics mode. Gets a memory page of configuration information from the device. Sets a memory page of configuration information on the device. Shows the unit's 6-byte MAC address. Sets the Security record without the encryption key and length parameters. The entire record must still be written, but the encryption-specific bytes do not need to be provided (they can be null since they are not overwritten). Initiates a wireless scan if the wireless interface is enabled. Reports any stations found, including BSSID, SSID, and RSSI. If SA is followed by a string, the string is used to filter SSIDs before reporting. If the BSS does not broadcast its SSID, only the BSSID and RSSI are returned. Reports the network interfaces statuses. Includes potentially negotiated parameters like speed/duplex for Ethernet or BSSID, encryption, authentication for wireless interfaces. Example: co 192.168.0.10 8 192.168.0.1 10001 192.168.1.10 with 192.168.0.10 = IP address of the xPico 8 = number of hostbits 192.168.0.1 = gateway IP address 10001 = port number of the xPico Channel 1 192.168.1.10 = IP address of the DNS Server The xPico stores the setup and performs a reset. It sends an X before the reset if the command was OK.
SA
Scan
NS
Network Status
co
Note: Entering any of the commands listed above generates one of the following command response codes:
71
Table 11-2. Command Response Codes Response 0> 1> 2> 8> 9> Meaning OK; no error No answer from remote device Cannot reach remote device or no answer Wrong parameter(s) Invalid command
72
12. 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 display. When troubleshooting, always ensure that the physical connections (power cable, network cable, and serial cable) are secure. Note: Some unexplained errors might be caused by duplicate IP addresses on the network. Make sure that your unit's IP address is unique. When troubleshooting the following problems, make sure that the xPico is powered up. Confirm that you are using a good network connection.
When you Telnet to port 9999, the "Press Enter to go into Setup Mode" message displays. However, nothing happens when you press Enter, or your connection is closed.
Telnet to port 9999 again, but press Enter as soon as you see the "Press Enter to go into Setup Mode" message.
73
12: Troubleshooting
Problem/Message When you Telnet to port 1 to assign an IP address to the device server, the Telnet window does not respond for a long time.
Reason You may have entered the Ethernet address incorrectly with the ARP command.
Solution Confirm that the Ethernet address that you entered with the ARP command is correct. The Ethernet address may only include numbers 0-9 and letters A-F. In Windows and usually in Unix, the segments of the Ethernet address are separated by dashes. In some forms of Unix, the Ethernet address is segmented with colons. 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. Make sure that the Link LED is lit. If the Link LED is not lit, then the device server is not properly plugged into the network. Double-check the parameters that you specified. Note: You cannot assign an IP address to a device server through a router.
The IP address you are trying to assign is not on your logical subnet.
The device server may not be plugged into the network properly.
When you try to assign an IP with DeviceInstaller, you get the following : "No response from device! Verify the IP, Hardware Address and Network Class. Please try again."
The cause is most likely one of the following: The hardware address you specified is incorrect. The IP address you are trying to assign is not a valid IP for your logical subnet. You did not choose the correct subnet mask.
The device server is not communicating with the serial device to which it is attached.
The most likely reason is the wrong serial settings were chosen.
The serial settings for the serial device and the device server must match. The default serial settings for the device server are RS-232, 9600 baud, 8 character bits, no parity, 1 stop bit, no flow control. Double-check everything in the problem above. Confirm that Caps Lock is not on.
When you try to enter the setup mode on the device server using the serial port, you get no response.
The issue is most likely something covered in the previous problem, or possibly, you have Caps Lock on.
74
12: Troubleshooting
Problem/Message You can ping the device server, but not Telnet to the device server on port 9999.
Reason There may be an IP address conflict on your network You are not Telneting to port 9999. The Telnet configuration port (9999) is disabled within the device server security settings.
Solution Turn the device server off and then issue the following commands at the DOS prompt of your computer: ARP -D X.X.X.X (X.X.X.X is the IP of the device server). PING X.X.X.X (X.X.X.X is the IP of the device server). If you get a response, then there is a duplicate IP address on the network. If you do not get a response, use the serial port to verify that Telnet is not disabled. You can check to see whether there is a socket connection to or from the device server by checking the state of CPx, if one of the CPs has been configured for Serial Channel Status LED functionality. If the state of CPx is blinking consistently, then there is a good socket connection. If the state of CPx is low, use the Connect Mode option C0 for making a connection to the device server from the network. Use Connect Mode option C1 or C5 for a connection to the network from the device server. See the full list of Connect Mode options in Connect Mode
The device server appears to be set up correctly, but you are not communicating with your device attached to the device server across the network.
If you are sure that the serial port setting is correct, then you may not be connecting to the correct socket of the device server. Another possibility is that the device server is not set up correctly to make a good socket connection to the network.
When connecting to the WebManager within the device server, the "No Connection With The Device Server" message displays.
Your computer is not able to connect to port 30718 (77FEh) on the device server.
Make sure that port 30718 (77FEh) is not blocked with any router that you are using on the network. Also, make sure that port 77FEh is not disabled within the Security settings of the device server.
75
12: Troubleshooting
Technical Support
If you are experiencing an error that is not described in this chapter, or if you are unable to fix the error, you have the following options: Technical Support US Check our online knowledge base or send a question to Technical Support at http://www.lantronix.com/support. Phone: (800) 422-7044 (US Only) (949) 453-7198
Technical Support Europe, Middle East, and Africa Phone: +33 (0)1 39 30 4172 +49 (0) 180 500 13 53 (Germany Only)
Email: eu_techsupp@lantronix.com or eu_support@lantronix.com Firmware downloads, FAQs, and the most up-to-date documentation are available at www.lantronix.com/support. When you report a problem, please provide the following information: Your name, and your company name, address, and phone number Lantronix model number Lantronix MAC number Software version (on the first screen shown when you Telnet to port 9999) Description of the problem Status of the unit when the problem occurred (please try to include information on user and network activity at the time of the problem).
76
Conversion Table
Hexadecimal digits have values ranging from 0 to F, which are represented as 0-9, A (for 10), B (for 11), etc. To convert a binary value (for example, 0100 1100) to a hexadecimal representation, the upper and lower four bits are treated separately, resulting in a two-digit hexadecimal number (in this case, 4C). Use the following table to convert values from binary to hexadecimal. Decimal
0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
Binary
0000 0001 0010 0011 0100 0101 0110 0111 1000 1001 1010 1011 1100 1101 1110 1111
Hex
0 1 2 3 4 5 6 7 8 9 A B C D E F
Scientific Calculator
Another simple way to convert binary to hexadecimals is to use a scientific calculator, such as the one available on Windows operating systems. For example: 1. On the Windows Start menu, click Programs AccessoriesCalculator. 2. On the View menu, select Scientific. The scientific calculator displays. 3. Select Bin (Binary), and type the number to convert.
77
78
B: Compliance
RoHS Notice
All Lantronix products in the following families are China RoHS-compliant and free of the following hazardous substances and elements:
Lead (Pb) Cadmium (Cd) Product Family Name Mercury (Hg) Hexavalent Chromium (Cr (VI)) Toxic or hazardous Substances and Elements Lead Mercury Cadmium Hexavalent (Pb) (Hg) (Cd) Chromium (Cr (VI)) 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 Polybrominated biphenyls (PBB) Polybrominated diphenyl ethers (PBDE) Polybrominated biphenyls (PBB) 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 Polybrominated diphenyl ethers (PBDE) 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
UDS1100 and 2100 EDS MSS100 IntelliBox XPress DR & XPress-DR+ SecureBox 1101 & 2101 WiBox UBox MatchPort SLC XPort WiPort SLB SLP SCS SLS DSC PremierWave Micro125 xPico xPrintServer
O: toxic or hazardous substance contained in all of the homogeneous materials for this part is below the limit requirement in SJ/T11363-2006. X: toxic or hazardous substance contained in at least one of the homogeneous materials used for this part is above the limit requirement in SJ/T11363-2006.
79