xSenso User Guide xSenso 2100 xSenso 21A2 xSenso 21R2 Part Number 900-629-R Revision B March 2013
Copyright & Trademark © 2013 Lantronix, Inc. All rights reserved. No part of the contents of this book may be transmitted or reproduced in any form or by any means without the written permission of Lantronix. Lantronix® is a registered trademark and DeviceInstaller and xSenso are trademarks of Lantronix, Inc. Windows® and Internet Explorer® are registered trademarks of Microsoft Corporation. Mozilla® and Firefox® are registered trademarks of the Mozilla Foundation. Chrome™ is a trademark of Google.
Table of Contents Copyright & Trademark ______________________________________________________ 2 Warranty _________________________________________________________________ 2 Contacts _________________________________________________________________ 2 Disclaimer ________________________________________________________________ 2 Revision History ___________________________________________________________ 2 List of Figures ____________________________________________________________ 10 List of Tables _________
: Installation of xSenso 21A2 28 Package Contents _________________________________________________________ 28 User-Supplied Items _______________________________________________________ 28 xSenso 21A2 Isolation Block Diagram _________________________________________ 29 Hardware Components _____________________________________________________ 29 Front/Top Panel _______________________________________________________ 29 Side Panels __________________________________________________________ 32 Back Panel _
9: Analog Input, Output and Relay Settings 53 DAQ Format _____________________________________________________________ 53 To Configure DAQ Settings ______________________________________________ 54 Analog Input _____________________________________________________________ 55 To Configure Analog Settings _____________________________________________ 56 Analog Output ____________________________________________________________ 56 To Configure Analog Output Settings _______________________________________ 57
15: Services Settings 77 DNS Settings _____________________________________________________________ 77 To View or Configure DNS Settings: _______________________________________ 77 FTP Settings _____________________________________________________________ 78 To Configure FTP Settings _______________________________________________78 Syslog Settings ___________________________________________________________ 78 To View or Configure Syslog Settings: ______________________________________ 79 HTTP Settings __
ICMP Settings _________________________________________________________ 95 To Configure ICMP Network Stack Settings __________________________________ 95 ARP Settings _________________________________________________________ 95 To Configure ARP Network Stack Settings __________________________________ 95 SMTP Settings ________________________________________________________ 96 To Configure ARP Network Stack Settings __________________________________ 96 Diagnostics __________________________________________
XML: Export Status ____________________________________________________ 107 To Export in XML Format _______________________________________________ 107 XML: Import Configuration ______________________________________________108 Import Configuration from External File ____________________________________ 108 Import Configuration from the Filesystem ___________________________________ 108 To Import Configuration in XML Format ____________________________________ 108 19: Security in Detail 109 Public Key In
Appendix A: Technical Specifications 116 Analog Inputs ________________________________________________________ 116 Analog Outputs _______________________________________________________ 116 Relay Ports __________________________________________________________ 116 Architecture _________________________________________________________ 117 Network Interface _____________________________________________________ 117 Management _________________________________________________________ 117 Security ___________
List of Figures Figure 2-1 Sample xSenso Configuration ______________________________________________ 16 Figure 2-2 Sample Applications _____________________________________________________ 17 Figure 2-3 xSenso Wiring Diagram ___________________________________________________ 19 Figure 2-4 xSenso Product Label ____________________________________________________ 21 Figure 3-1 xSenso 2100 Isolation Block Diagram ________________________________________ 23 Figure 3-2 xSenso , Front View______________________
List of Tables Table 3-4 Analog Input LEDs _______________________________________________________ 24 Table 3-5 Ethernet LEDs __________________________________________________________ 25 Table 4-4 Analog Input and Analog Output LEDs _______________________________________ 31 Table 4-5 Ethernet LEDs __________________________________________________________ 31 Table 5-4 Analog Input and Relay Output LEDs ________________________________________ 37 Table 5-5 Ethernet LEDs ____________________________________
Table 15-8 SMTP Network Stack Settings _____________________________________________ 83 Table 16-1 SSH Server Host Keys ___________________________________________________ 85 Table 16-2 SSH Client Known Hosts _________________________________________________ 86 Table 16-3 SSH Server Authorized Users _____________________________________________ 87 Table 16-4 SSH Client Users _______________________________________________________ 87 Table 16-5 Certificate and Key Generation Settings ________________________
1: Using This Guide Purpose and Audience This guide provides the information needed to configure, use, and update the xSenso. It is intended for software developers and system integrators who are installing this product into their designs. Summary of Chapters The remaining chapters in this guide include: Chapter Description 2: Introduction Main features of the product and the protocols it supports. Includes technical specifications.
1: Using This Guide Chapter (continued) Description Appendix C: Binary to Hexadecimal Conversions Instructions for converting binary values to hexadecimals. Appendix D: Compliance Lantronix compliance information. Appendix E: USB-CDC-ACM Device Driver File for Windows Hosts Information about the device driver file for windows host. Additional Documentation Visit the Lantronix Web site at www.lantronix.com/support/documentation for the latest documentation and the following additional documentation.
2: Introduction xSenso is a compact DIN-rail or wall mount solution that enables sensors with analog outputs (voltage or current) to easily and transparently send real-time data to any node on the network or over the Internet. xSenso is an ideal solution for remote monitoring and data logging of critical events in process control and automation applications. With its low port density, xSenso can be affordably installed in dispersed locations.
2: Introduction Figure 2-1 Sample xSenso Configuration Figure 2-1 is an example of how the xSenso can send sensor data (e.g., temperature and humidity readings), over shared networks or the internet to a PC, laptop, or a smart phone. Third party data acquisition applications (e.g., DASYLab, LabVIEW or MATLAB) can also be interfaced with the xSenso to read and log the sensor’s data.
2: Introduction Figure 2-2 Sample Applications 3 1 2 Note: See Sample Applications on page 16 for an explanation of Figure 2-2. Protocol Support The xSenso device server contains a full-featured IP stack. Supported protocols include: ARP, HTTP, HTTPS, SMTP AUTH, SNMP v1/v2c/v3, Modbus TCP, UDP/IP, TCP/IP, SSH, SSL, TLS, RSS, UPnP, ICMP, BOOTP, DHCP, Auto IP, Telnet, SNTP, FTP, FTPS, DNS, TFTP, XML and Syslog for network communications and management. TFTP for uploading/downloading files.
2: Introduction Troubleshooting Capabilities The xSenso offers a comprehensive diagnostic toolset that lets you troubleshoot problems quickly and easily. Available from the CLI or Web Manager, the diagnostic tools let you: View memory and IP socket information. Perform ping and traceroute operations. Conduct forward or reverse DNS lookup operations. View all processes currently running on the xSenso, including CPU utilization. View system log messages.
2: Introduction a. DeviceInstaller installation directory (typically at c:\Program File\Lantronix\Device Installer\4.3). b. Follow the instructions inAppendix E: USB-CDC-ACM Device Driver File for Windows Hosts to create the .inf file and follow the windows driver installation steps as outlined above. 2. Connect the USB cable to the MGMT (USB) port of the xSenso device. 3. Connect the USB cable from the xSenso to the USB port on your computer. 4. Apply power.
2: Introduction Addresses and Port Numbers Hardware Address The hardware address is also referred to as the Ethernet address, physical address, or MAC address. Sample hardware address: 00---14-1B-18 00:::14:1B:18 IP Address Every device connected to an IP network must have a unique IP address. This address references the specific unit. Port Numbers Every TCP connection and every UDP datagram is defined by a destination and source IP address, and a destination and source port number.
2: Introduction Figure 2-4 xSenso Product Label Bar Code Serial Number Part Number Revision Manufacturing Date Code Country of Origin & Manufacture xSenso User Guide 21
3: Installation of xSenso This chapter describes how to install the xSenso analog device server.
3: Installation of xSenso xSenso 2100 Isolation Block Diagram Figure 3-1 xSenso 2100 Isolation Block Diagram Hardware Components Front/Top Panel The following components are located on the front panel (Figure 3-2) of the xSenso : USB Port - for managing and configuring xSenso device. RJ-45 Ethernet Port (with Ethernet LEDs) - can connect to an Ethernet (10 Mbps) or Fast Ethernet (100 Mbps) network.
3: Installation of xSenso Figure 3-3 xSenso Top/Front View Table 3-4 and Table 3-5 below explain the LED information displayed in Figure 3-2 and Figure 3-3 above. Table 3-4 Analog Input LEDs LED Color ON OFF “X” on top of xSenso device (Diagnostic) Orange ORANGE ON - power present No power ORANGE Blink - during boot process after power cycle or reset.
3: Installation of xSenso Table 3-5 Ethernet LEDs Ethernet LEDs Description Left (L) GREEN ON - 100 Mbps link established GREEN Blink - 100Mbps activity AMBER ON - 10 Mbps link established AMBER Blink - 10 Mbps activity Right (R) GREEN ON - Full duplex OFF - Half duplex Reset Button You can reset the xSenso to factory default settings, including clearing the network settings. The IP address, gateway, and netmask are set to 00s. To reset the unit to factory defaults: 1.
3: Installation of xSenso Figure 3-6 xSenso, Side View 9-30 VDC Barrel Locking Power Input Excitation Voltage Input Current Input Back Panel On the xSenso back panel, there is a mounting bracket with a sliding orange clip which allows you to mount and dismount the device from a DIN rail, as shown in Figure 3-3. There are also four rubber feet that can be attached to the bottom-side of the device, if the xSenso is to be placed on a flat surface.
3: Installation of xSenso Connect your RJ-45 Ethernet cable to the RJ-45 port of the unit. The xSenso supports a power range of 9 to 30 VDC. You can power up the device with barrelpower connector and/or the 3 pin terminal connector for backup power supply. Note: As soon as you plug the device into power, the device/sensors powers up automatically, the self-test begins, and LEDs would indicate the device's status Perform the following steps to install your device: 1.
4: Installation of xSenso 21A2 This chapter describes how to install the xSenso 21A2 device server. It contains the following sections: Package Contents User-Supplied Items Hardware Components Hardware Components Installing the xSenso Package Contents The xSenso package includes the following items: One xSenso 21A2 device Three 3-contact Terminal Block Plug - screw type for Power Input Port and Analog Output Ports.
4: Installation of xSenso 21A2 xSenso 21A2 Isolation Block Diagram Figure 4-1 xSenso 21A2 Isolation Block Diagram Hardware Components Front/Top Panel The following components are located on the front panel (Figure 4-2) of the xSenso 21A2: USB Port - for managing and configuring xSenso device. RJ-45 Ethernet Port (with Ethernet LEDs) - can connect to an Ethernet (10 Mbps) or Fast Ethernet (100 Mbps) network.
4: Installation of xSenso 21A2 LED Indicators The Analog Input LEDs, the Analog Output LEDs, the Ethernet LEDs, and the Diagnostic “X” LED are all located on the front panel of the xSenso device (Figure 4-3). Figure 4-2 xSenso 21A2, Front View Diagnostic “X” LED Ethernet LEDs L R USB Port Ethernet Port Analog Analog Output Input LEDs LEDs Reset Figure 4-3 xSenso 21A2 Top/Front View Table 4-4 and Table 4-5 below explain the LED information displayed in Figure 4-2 and Figure 4-3 above.
4: Installation of xSenso 21A2 Table 4-4 Analog Input and Analog Output LEDs LED Color “X” on top of xSenso device (Diagnostic) Orange ON OFF ORANGE ON - power present No power ORANGE Blink - during boot process after power cycle or reset. Also blink patterns represent error conditions: Analog Input 1 Green or Orange Input Type (voltage or current) Analog Input 2 Green or Orange Analog Output 2 Green or Orange Green or Orange Output not utlized.
4: Installation of xSenso 21A2 To reboot the unit without resetting the unit to factory defaults: 1. Place the end of a paper clip or similar object into the RST (reset) opening (see Figure 4-2) and press and hold down micro switch during a power cycle for 3 to 5 seconds. 2. Remove the paper clip to release the button. The unit will reboot.
4: Installation of xSenso 21A2 Figure 4-7 xSenso Bottom/Back Panel View Installing the xSenso Be sure to place or mount the device securely on a flat horizontal or vertical surface. The device comes with mounting brackets for mounting the device vertically, for example on a wall. If using AC power, avoid outlets controlled by a wall switch.
5: Installation of xSenso 21R2 This chapter describes how to install the xSenso 21R2 device server.
5: Installation of xSenso 21R2 xSenso 21R2 Block Diagram Figure 5-1 xSenso 21R2 Isolation Block Diagram Hardware Components Front/Top Panel The following components are located on the front panel (Figure 5-2) of the xSenso 21R2: USB Port - for managing and configuring xSenso device. RJ-45 Ethernet Port (with Ethernet LEDs) - can connect to an Ethernet (10 Mbps) or Fast Ethernet (100 Mbps) network.
5: Installation of xSenso 21R2 Figure 5-2 xSenso 21R2, Front View Diagnostic “X” LED Ethernet LEDs L R USB Port Ethernet Port Relay Analog Output Input LEDs LEDs Reset Figure 5-3 xSenso 21R2 Top/Front View Table 5-4 and Table 5-5 below explain the LED information displayed in Figure 5-2 and Figure 5-3 above.
5: Installation of xSenso 21R2 Table 5-4 Analog Input and Relay Output LEDs LED Color “X” on top of xSenso device (Diagnostic) Orange ON OFF ORANGE ON - power present No power ORANGE Blink - during boot process after power cycle or reset.
5: Installation of xSenso 21R2 To reboot the unit without resetting the unit to factory defaults: 1. Place the end of a paper clip or similar object into the RST (reset) opening (see Figure 5-2) and press and hold down micro switch during a power cycle for 3 to 5 seconds. 2. Remove the paper clip to release the button. The unit will reboot.
5: Installation of xSenso 21R2 Figure 5-7 xSenso Bottom/Back Panel View Installing the xSenso Be sure to place or mount the device securely on a flat horizontal or vertical surface. The device comes with mounting brackets for mounting the device vertically, for example on a wall. If using AC power, avoid outlets controlled by a wall switch.
6: Using DeviceInstaller This chapter covers the steps for locating a xSenso unit and viewing its properties and device details. DeviceInstaller is a free utility program provided by Lantronix that discovers, configures, upgrades and manages Lantronix Device Servers. Notes: For instructions on using DeviceInstaller to configure the IP address and related settings or for more advanced features, see the DeviceInstaller Online Help. Auto IP generates a random IP address in the range of 169.254.0.
6: Using DeviceInstaller Current Settings Description Group Configurable field. Enter a group to categorize the xSenso. Double-click the field, type in the value, and press Enter to complete. This group name is local to this PC and is not visible on other PCs or laptops using DeviceInstaller. Comments Configurable field. Enter comments for the xSenso. Double-click the field, type in the value, and press Enter to complete.
7: Configuration Using Web Manager This chapter describes how to configure xSenso using Web Manager, the Lantronix browserbased configuration tool. The unit’s configuration is stored in nonvolatile memory and is retained without power. All changes take effect immediately, unless otherwise noted.
7: Configuration Using Web Manager Figure 7-1 xSenso Home Pages There are three xSenso models. The Home page for each model is identical except for these differences: 1) The xSenso model can be identified to the right of the Product Type in the Home page. 2) xSenso 21A2 has two additional output status fields. 3) xSenso 21R2 has two additional relay status fields. 4. Click the Admin tab to get to the Admin > Device Status page.
7: Configuration Using Web Manager Figure 7-2 Device Status Pages There are three xSenso models. The Device Status page for each model is identical except for these differences: 1) The xSenso model can be identified to the right of the Product Type in the Home page. 2) xSenso 21A2 has two additional output status fields. 3) xSenso 21R2 has two additional relay status fields.
7: Configuration Using Web Manager xSenso Home and Device Status Pages The xSenso Home page is the first page that appears after you log into Web Manager. The Device Status page appears when you click Status in the Admin tab/page in Web Manager. The xSenso Home page and the Device Status pages show overlapping information. For most users, the xSenso Home page contains the basic product and status information necessary.
7: Configuration Using Web Manager Live Reading Pages and Configuration Pages There are five tabs that span the top of the Web Manager page. Beyond the xSenso Home page accessed through the Home tab at the top left, you may access the other Web Manager pages through the four other tabs. The Reading, Chart and Logging tab/pages provide live data on the analog input signals and the Setup and Admin tab/pages provide configuration menus: Reading: view live readings of analog input, output and relay data.
7: Configuration Using Web Manager Web Manager Components The layout of a typical Web Manager page is below. Figure 7-5 Components of the Web Manager Page Items to configure Header Links to subpages Logout button Tabs/Pages Menu Bar (only in the Setup and Admin tab/ pages) Footer Information and Help Area Web Manager pages have these sections: The Home, Reading, Chart, Logging, Setup and Admin tabs at the top of the page provide direct access to each Web Manager page of the same name.
7: Configuration Using Web Manager At the bottom of most pages, the current configuration is displayed. In some cases, you can reset or clear a setting. The information or help area shows information or instructions associated with the page. A Logout link is available at the upper right corner of every Setup and Admin page. In Chrome or Safari, it is necessary to close out of the browser to completely logout. If necessary, reopen the browser to log back in.
7: Configuration Using Web Manager Web Manager Page (continued) Description See Page FTP Shows statistics and lets you change the current configuration for the File Transfer Protocol (FTP) server. 78 HTTP Shows HyperText Transfer Protocol (HTTP) statistics and lets you change the 79 current configuration and authentication settings. Logging Shows analog input, output and relay information through a live log and provides log file configuration options.
8: Network Settings The Network Settings show the status of the Ethernet interface/link and let you configure the settings on the device. Interface settings are related to the configuration of the IP and related protocols. Link settings are related to the physical link connection, which carries the IP traffic. The xSenso contains one network interface. The Ethernet interface is also called interface 1 or eth0. Notes: Some settings require a reboot to take effect. These settings are noted below.
8: Network Settings Network Interface Settings (continued) Description Hostname Enter the hostname for the interface. It must begin with a letter or number, continue with a sequence of letters, numbers, or hyphens, and end with a letter or number. Note: This setting will take effect immediately, but will not register the hostname with a DNS server until the next reboot. Domain Enter the domain name suffix for the interface.
8: Network Settings Network Link Settings Physical link parameters can be configured for an Ethernet (eth0) Network Interface (see Table 8-2). Table 8-2 Network 1 (eth0) Link Settings Network 1 Ethernet (eth0) Link Settings Description Speed Select the Ethernet link speed. (Default is Auto) Duplex Auto = Auto-negotiation of Link Speed 10 Mbps = Force 10 Mbps 100 Mbps = Force 100 Mbps Select the Ethernet link duplex mode.
9: Analog Input, Output and Relay Settings The xSenso supports two analog inputs (Figure 9-1) each of which may be configured to sense one of four analog signal ranges (±100mV, ±1V, ±10V and ±20mA) with options for selecting simple offset or scale and offset. xSenso 2100, xSenso 21A2 and xSenso 21R2 have the same analog inputs but xSenso 21A2 additionally has two analog outputs and xSenso 21R2 has two relay outputs.
9: Analog Input, Output and Relay Settings Command (continued) Description Example xSenso Model AOUT2 xSenso 21A2 ROUT1 Writes Output 2 value. AOUT2 +10.0\r Value must have float format: [+/-]. SUBMITTED Reads Relay 1 current setting. ROUT1\r xSenso 21R2 +1 ROUT2 Reads Relay 2 current setting. ROUT2\r xSenso 21R2 +0 ROUT* Reads all current relay settings.
9: Analog Input, Output and Relay Settings Analog Input Table 9-4 Analog Input Settings Input Settings Description Display Select to enable or disable a scaled input value to be displayed with designated title and units in the web manager, XML and CLI analog chanel as well as Tunnel and Action Connect application. You can hide an input by disabling it if you are not using it. Title Enter the analog input title as it will appear in web manager, XML and CLI.
9: Analog Input, Output and Relay Settings To Configure Analog Settings Using Web Manager To configure analog input, go to the Setup tab/page and click Analog Input > Input 1 > Configuration in the menu. Using the CLI To enter the analog input command level: enable -> config -> analog -> input Using XML Include in your file: Analog Output Note: Analog output is only available on the xSenso 21A2.
9: Analog Input, Output and Relay Settings Input Settings Alarm Type Description Select alarm type to enable monitoring for high and/or low analog output readings: Select either High or High and Low to enable monitoring for a reading at or above the specified Alarm High value. Select Low or High and Low to enable monitoring for a reading at or below the specified Alarm Low value.
9: Analog Input, Output and Relay Settings Input Settings (continued) Latch Description Enable or disable Latch controls which determine how a relay will be turned off. Selecting Enabled will require a user to explicitly reset latched relay and then turn it off. Selecting Disabled, the relay will automaticaly turn off after any and all of the alarm triggers are no longer active.
10: Chart Note: Lantronix recommends using the latest version of Chrome when viewing and configuring the Chart tab. The xSenso Chart tab provides access to live charted analog input, output and relay information on the Chart page. The chart is configurable and includes an optional alarm indication function. Chart will poll data sample from xSenso every second.
10: Chart Data Chart Configuration Table 10-2 Data Chart Settings Data Chart Settings Description Last Select the span of time to be charted: Input 1/Input 2 Output 1/Output2 Relay 1/Relay 2 Minute (charts one full minute at 1 second intervals) Hour (charts one full hour at 5 second intervals) Day (charts one full day at 1 minute intervals) Week (charts one full week at 10 minute intervals) Month (charts one full month at 1 hour intervals) Select from the drop-down menu to indicate the input,
11: Logging The xSenso Logging tab/page provides access to the data logging feature available with browsers that support HTML5 and filesystem API (e.g., Chrome). Users can run customized data logs through this page. Upon the first visit, the browser will ask for your permission to allow this device to store data on your PC. Choose Ok. Browser will poll data from xSenso every period (1 minute default) as configured by user.
11: Logging Figure 11-2 xSenso 21A2 Logging Tab Figure 11-3 xSenso 21R2 Logging Tab xSenso User Guide 62
11: Logging Data Logging Configuration Table 11-4 Data Logging Settings Data Logging Settings Description Filename Enter the filename of the log file. This will be saved in the browser's sandbox filesystem. Period Specify in seconds, how often the browser will poll data from the xSenso device. Title Specify the title as it will appear in the log files. You can use this besides the filename to identify each data logging session. Header‘ Check to enable or disable the header in the log files.
12: Reading The xSenso Reading tab provides access to a live readings page of analog inputs, outputs and relays.
12: Reading Figure 12-2 xSenso 21A2 Reading Tab Figure 12-3 xSenso 21R2 Reading Tab Data Reading Configuration To View Data Reading Settings Using Web Manager To view live readings information, click the Reading tab to get to the Reading page.
13: Action Settings Actions can be configured for alarms and reports available in the xSenso. Certain alarms and reports are available in all the xSenso products whereas the output alarms are only available in the xSenso 21A2 as seen in Table 13-1 xSenso Alarms and Reports below.
13: Action Settings Contol Analog Output Settings (continued) Description Output Select the output number from the drop-down menu. Additional Analog Output configuration fields become available if a specific output number is selected. Selecting "None" stops control of analog output and does not reset the output value. Alarm Value Provide the value to be asserted on the selected Analog Output when the alarm is turned on.
13: Action Settings Make Connection Settings (continued) Description SSH Username Specify the SSH Client User for the SSH outgoing connection if the SSH protocol is selected for this connection. You may select from the drop-down menu of existing users or you may enter a new user name. This configuration field is only available if the SSH protocol is selected. AES Encrypt Key Enter an AES encryption key to encrypt outgoing data and select Hexadecimal or Text.
13: Action Settings Send Email Settings Description Normal Reminder Interval Specify how long to wait in minutes after the alarm stays off before another normal email is sent. If this is a status report, a normal email is sent periodically according to the stated reminder interval. Blank the display field to disable reminders. Email will only be sent once by default. Table 13-5 FTP Put Settings FTP Put Settings Description Add an Action (drop-down menu) Select FTP Put for the alarm or report.
13: Action Settings Table 13-6 HTTP Post Settings HTTP Post Settings Description Add an Action (drop-down menu) Select HTTP Post for the alarm or report. The Host field will appear. You can create up to 2 connections. Repeat entry for the fields below of each HTTP Post Host. Host Enter the HTTP server IP address or hostname to be connected to. Multiple HTTP Post configuration options will appear.
13: Action Settings Table 13-8 SNMP Trap Settings SNMP Settings Description Add an Action (drop-down menu) Select SNMP Trap for the alarm or report. State Check to enable or disable: Reporting Introduce additional SNMP Trap configuration fields when enabled.
13: Action Settings Using XML Include in your file: To Configure Input 1 and 2 Alarm Settings Using Web Manager To configure input 1 and input 2 alarms, go to the Setup tab/page, click Action in the menu, and select Input (1 or 2) Alarm from the drop-down menu.
14: Tunnel and Modbus Settings The xSenso 2100, xSenso 21A2 and xSenso 21R2 have two tunnels through which you may view statistics or configure the Accept Mode. The Modbus configuration page allows configuration of Modbus servers listening on the TCP ports. Tunnel Settings Tunneling parameters are configured using the Tunnel menu and submenus. The Tunnel settings allow you to configure how the Network tunneling operates.
14: Tunnel and Modbus Settings Tunnel Accept Mode Settings (continued) Description TCP Keep Alive Enter the time, in milliseconds, the xSenso waits during a silent TCP connection before checking if the currently connected network device is still on the network. If the unit gets no response after 1 attempt, it drops the connection. Enter 0 to disable. Block Network Set whether Block Network is enabled for debugging purposes.
14: Tunnel and Modbus Settings Modbus Settings The Modbus server, if enabled, is active on TCP port 502. If present, the additional TCP port is also used. Modbus TCP parameters are configured using the Modbus menu and submenus under Admin. Table 14-2 Modbus Settings Modbus Settings Description TCP Server State Click to turn the TCP server state On or Off. The TCP port is 502. Additional TCP Server Port If present, the Modbus server also listens on this TCP port.
14: Tunnel and Modbus Settings Table 14-4 3xxxx Read Only Registers (Function Codes 4 and 23) Device Address Modbus Address Description 30001 0x0000 Input 1 high word of float (Float AB CD) 30002 0x0001 Input 1 low word of float (Float AB CD) 30003 0x0002 Input 2 high word of float (Float AB CD) 30004 0x0003 Input 2 low word of float (Float AB CD) Table 14-5 4xxxx Read/Write Holding Registers (Function Codes 3, 16 and 23) Device Address Modbus Address Description 40001 0x0000 Output 1 h
15: Services Settings DNS Settings This section describes the active run-time settings for the domain name system (DNS) protocol. The primary and secondary DNS addresses come from the active interface. The static addresses from the Network Interface configuration settings may be overridden by DHCP. Note: The blue text in the XML command strings of this chapter are to be replaced with a user-specified name.
15: Services Settings FTP Settings The FTP protocol can be used to upload and download user files, and upgrade the xSenso firmware. A configurable option is provided to enable or disable access via this protocol. Table 15-2 FTP Settings FTP Settings Description State Select to enable or disable the FTP server: Enabled (default) Disabled To Configure FTP Settings Using Web Manager To configure FTP, go to the Admin tab/page and click FTP in the menu.
15: Services Settings Syslog Settings (continued) Severity Log Level Description Specify the minimum level of system message the should log. This setting applies to all syslog facilities. The drop-down list in the Web Manager is in descending order of severity (e.g., Emergency is more severe than Alert.) To View or Configure Syslog Settings: Using Web Manager To configure the Syslog, go to the Admin tab/page and click Syslog in the menu.
15: Services Settings HTTP Settings (continued) Description Max Timeout Enter the maximum time for the HTTP server to wait when receiving a request. This prevents Denial-of-Service (DoS) attacks. The default is 10 seconds. Max Bytes Enter the maximum number of bytes the HTTP server accepts when receiving a request. The default is 40 KB (this prevents DoS attacks).
15: Services Settings Table 15-5 HTTP Authentication Settings HTTP Authentication Description Settings URI Enter the Uniform Resource Identifier (URI). Note: The URI must begin with ‘/’ to refer to the filesystem. Auth Type Select the authentication type: None = no authentication is necessary. Basic = encodes passwords using Base64. Digest = encodes passwords using MD5. SSL = can only be accessed over SSL (no password is required).
15: Services Settings RSS Settings Description Clear Click the button to clear RSS feed data. To Configure RSS Settings Using Web Manager To configure RSS, go to the Admin tab/page and click RSS in the menu. Using the CLI To enter the RSS command level: enable -> config -> rss Using XML Include in your file: SNMP Settings Simple Network management Protocol (SNMP) settings may be viewed and configured in this section.
15: Services Settings RSS Settings Description System Description Update the system description, as necessary. The default system information includes the manufacturer name, xSenso model name, version and the serial number of the device. System Location Specify a system location for the SNMP setting. Lantronix MIB File Click the Lantronix MIB file name to save and load it into the MIB browser and trap receiver.
15: Services Settings To Configure SMTP Network Stack Settings Using Web Manager To configure SMTP protocol settings, go to the Admin tab/page and click SMTP in the menu.
16: Security Settings The xSenso device supports Secure Shell (SSH) and Secure Sockets Layer (SSL). SSH is a network protocol for securely accessing a remote device. SSH provides a secure, encrypted communication channel between two hosts over a network. It provides authentication and message integrity services. Secure Sockets Layer (SSL) is a protocol that manages data transmission security over the Internet.
16: Security Settings RSS Settings (continued) Description Public Key Enter the path and name of the existing public key you want to upload. In WebManager, you can also browse to the public key to be uploaded. Key Type Select a key type to use for the new key: Bit Size RSA DSA Select a bit length for the new key: 512 768 1024 Note: SSH Keys from other programs may be converted to the required format. Use Open SSH to perform the conversion.
16: Security Settings Table 16-3 SSH Server Authorized Users RSS Settings Description Username Enter a new username or edit an existing one. Password Enter a new password or edit an existing one. Public RSA Key Enter the path and name of the existing public RSA key you want to use with this user. In WebManager, you can also browse to the public RSA key to be uploaded. If authentication is successful with the key, no password is required.
16: Security Settings RSS Settings (continued) Bit Size Description Select the bit length of the new key: 512 768 1024 Using a larger Bit Size takes more time to generate the key. Approximate times are: 1 second for a 512 bit RSA key 1 second for a 768 bit RSA key 1 second for a 1024 bit RSA key 2 seconds for a 512 bit DSA key 2 seconds for a 768 bit DSA key 20 seconds for a 1024 bit DSA key Note: Some SSH clients require RSA host keys to be at least 1024 bits long.
16: Security Settings Certificate and Key Generation The xSenso can generate self signed certificates and their corresponding keys. This can be done for both the rsa and dsa certificate formats. Certificates can be identified on the xSenso by a name provided at generation time. Table 16-5 Certificate and Key Generation Settings Certificate Generation Settings Description Country (2 Letter Code) Enter the 2-letter country code to be assigned to the new self-signed certificate.
16: Security Settings Using XML Not applicable. Certificate Upload Settings SSL certificates identify the xSenso to peers. Certificate and key pairs can be uploaded to the xSenso through either the CLI or XML import mechanisms. Certificates can be identified on the xSenso by a name provided at upload time. Table 16-6 Upload Certificate Settings Upload Certificate Settings Description New Certificate SSL certificate to be uploaded. RSA or DSA certificates are allowed.
16: Security Settings Trusted Authorities One or more authority certificates are needed to verify a peer's identity. These certificates do not require a private key. SSL certificate for HTTPS and FTPS connections under Action must be uploaded here. Table 16-7 Trusted Authority Settings Trusted Authorities Settings Description Authority SSL authority certificate. RSA or DSA certificates are allowed. The format of the authority certificate can be PEM or PKCS7.
17: Maintenance and Diagnostics Settings Filesystem Settings Use the file system to list, view, add, remove, and transfer files. The xSenso uses a flash file system to store files. File Display It is possible to view the list of existing files, and to view their contents in the ASCII or hexadecimal formats. Table 17-1 File Display Settings File Display Commands Description ls Displays a list of files on the xSenso, and their respective sizes. cat Displays the specified file in ASCII format.
17: Maintenance and Diagnostics Settings File Modification The xSenso allows for the creation and removal of files on its filesystem. Table 17-2 File Modification Settings File Modification Commands Description rm Removes the specified file from the file system. touch Creates the specified file as an empty file. cp Creates a copy of a file. mkdir Creates a directory on the file system. rmdir Removes a directory from the file system. format Format the file system and remove all data.
17: Maintenance and Diagnostics Settings To Transfer or Modify Filesystem Files Using Web Manager To create a new file or directory, upload an existing file, copy or move a file, o to the Admin tab/page, click Filesystem in the menu and select Browse. Using the CLI To enter the Filesystem command level: enable -> filesystem Using XML Not applicable. Protocol Stack Settings There are various low level network stack specific items that are available for configuration.
17: Maintenance and Diagnostics Settings ICMP Settings Table 17-5 ICMP Network Stack Settings Protocol Stack ICMP Settings Description State The State selection is used to turn on/off processing of ICMP messages. This includes both incoming and outgoing messages. Choose Enabled or Disabled. To Configure ICMP Network Stack Settings Using Web Manager To configure ICMP protocol settings, go to the Admin tab/page, click Protocol Stack in the menu and select ICMP.
17: Maintenance and Diagnostics Settings Using XML Include in your file: SMTP Settings Table 17-7 SMTP Settings SMTP Settings Description Relay Address Enter the Relay Address to be used to direct all outbound email messages through a mail server. Relay Port Enter the Relay Port number to be used for all outbound email messages through the mail server.
17: Maintenance and Diagnostics Settings Using XML Include in your file: IP Sockets You can view the list of listening and connected IP sockets. To View the List of IP Sockets Using Web Manager To view IP Sockets, go to the Admin tab/page, click Diagnostics in the menu and select IP Sockets.
17: Maintenance and Diagnostics Settings Traceroute Here you can trace a packet from the xSenso to an Internet host, showing how many hops the packet requires to reach the host and how long each hop takes. If you visit a web site whose pages appear slowly, you can use traceroute to determine where the longest delays are occurring. Table 17-9 Traceroute Settings Diagnostics: Traceroute Settings Description Host Enter the IP address or DNS hostname.
17: Maintenance and Diagnostics Settings Using XML Include in your file: and Memory The memory information shows the total, used, and available memory (in kilobytes). To View Memory Usage Using Web Manager To view memory information, go to the Admin tab/page, click Diagnostics in the menu and select Memory.
17: Maintenance and Diagnostics Settings Threads The xSenso Threads information shows details of threads in the ltrx_evo task which can be useful for technical experts in debugging. To View Thread Information Using Web Manager To view thread information, go to the Admin tab/page, click Diagnostics in the menu and select Threads. Using the CLI To enter the command level: enable -> device, show task state Clock The current date or time configured in xSenso can be viewed and modified.
17: Maintenance and Diagnostics Settings To Configure the Clock Using Web Manager To view configure clock information, go to the Admin tab/page and click Clock in the menu. Using the CLI To enter the command level: enable -> config -> clock Using the XML Include in your file: System Settings The xSenso System settings allow for rebooting the device, restoring factory defaults, uploading new firmware and updating a system’s short and long name.
17: Maintenance and Diagnostics Settings Using XML Include in your file: Discovery and Query Port The current statistics and configuration options for device discovery, including Query Port are available for the xSenso. Table 17-13 Discovery Settings Discovery Description Query Port Server State Select to enable or disable the query port server from responding to autodiscovery messages on port 0x77FE.
18: Advanced Settings Email Settings View and configure email alerts relating to events occurring within the system. Table 18-1 Email Configuration Email – Configuration Settings Description Configure SMTP Click this link to set SMTP Settings on a separate Web Manager page. To Enter the email address to which the email alerts will be sent. Multiple addresses are separated by semicolon (;). Required field if an email is to be sent. CC Enter the email address to which the email alerts will be copied.
18: Advanced Settings Using the CLI To enter Email command level: enable -> email 1 Using XML Include in your file: Command Line Interface Settings The Command Line Interface settings allow you to control how users connect to and interact with the xSenso's command line. It is possible to configure access via the Telnet and SSH protocols, in addition to general CLI options.
18: Advanced Settings Telnet Settings The telnet settings control CLI access to the xSenso over the Telnet protocol. Table 18-3 Telnet Settings Telnet Settings Description Telnet State Enable or Disable CLI access via telnet Telnet Port Enter an alternative Telnet Port to override the default used by the CLI server. Blank the field to restore the default. Telnet Max Sessions Specify the maximum number of concurrent Telnet sessions that will be allowed.
18: Advanced Settings To Configure SSH Settings Using Web Manager To configure SSH settings, go to the Admin tab/page, click CLI in the menu and select Configuration. Using the CLI To enter the SSH command level: enable -> config -> cli -> ssh Using XML Include in your file: and XML Settings The xSenso allows for the configuration of units using an XML configuration record (XCR).
18: Advanced Settings XML Export Configuration Settings (continued) Description Groups to Export Check the configuration groups that are to be exported to the XML configuration record. The group list should be comma delimited and encased in double quotes. The list of available groups can be viewed with the “xcr list” command. To Export Configuration in XML Format Using Web Manager To export configuration format, go to the Admin tab/page, click XML in the menu and select Export Configuration.
18: Advanced Settings Using XML Not applicable. XML: Import Configuration Here you can import a system configuration from an XML file. The XML data can be imported from a file on the file system or pasted into a CLI session. The groups to import can be specified at the command line, the default is all groups. Import Configuration from External File This import option requires entering the path and file name of the external XCR file you want to import.
19: Security in Detail Public Key Infrastructure Public key infrastructure (PKI) is based on an encryption technique that uses two keys: a public key and private key. Public keys can be used to encrypt messages which can only be decrypted using the private key. This technique is referred to as asymmetric encryption, as opposed to symmetric encryption, in which a single secret key is used by both parties.
19: Security in Detail through any number of intermediate authorities, ultimately to the agent that needs to prove its authenticity. Obtaining Certificates Signed certificates are typically obtained from well-known CAs, such as VeriSign. This is done by submitting a certificate request for a CA, typically for a fee.
19: Security in Detail Steel Belted RADIUS Steel Belted RADIUS is a commercial RADIUS server from Juniper Networks that provides a GUI administration interface. It also provides a certificate request and self-signed certificate generator. The self-signed certificate has extension .sbrpvk and is in the PKCS12 format. OpenSSL can convert this into a PEM format certificate and key: openssl pkcs12 -in sbr_certkey.sbrpvk -nodes -out sbr_certkey.pem The sbr_certkey.pem file contains both certificate and key.
20: Updating Firmware Obtaining Firmware Obtain the most up-to-date firmware and release notes for the unit from the Lantronix Web site (www.lantronix.com/support/downloads/) or by using anonymous FTP (ftp://ftp.lantronix.com/). Loading New Firmware through Web Manager Reload the firmware using the device web manager Filesystem page. To upload new firmware: 1. Select the Setup tab/page and click System in the menu bar. The Setup > System page appears. Figure 20-1 Uploading New Firmware 2.
20: Updating Firmware 4. Click Upload to install the firmware on the xSenso. 5. Click OK in the confirmation popup which appears. The firmware will be installed and the device will automatically reboot afterwards. 6. Close and reopen the web manager internet browser to view the device’s updated web pages. Note: Alternatively, firmware may be updated by sending the file to the xSenso over a FTP or TFTP connection.
21: Branding the xSenso This chapter describes how to brand your xSenso by using Web Manager and Command Line Interface (CLI). It contains the following sections on customization: Web Manager Customization Short and Long Name Customization Web Manager Customization Customize the Web Manager's appearance by modifying index.html, style.css, and the product logo. The style (fonts, colors, and spacing) of the Web Manager is controlled with style.css. The text and graphics are controlled with index.html.
21: Branding the xSenso Short and Long Name Customization You can customize the short and long names in your xSenso. The names display in the CLI show command and in the System web page in the Current Configuration table. The short name is used for the show command. Both names display in the CLI Product Type field. Table 21-1 Short and Long Name Settings Name Settings Description Short Name Enter a short name for the system name. A maximum of 32 characters are allowed.
Appendix A: Technical Specifications Analog Inputs Channels: (2) Differential inputs (screw terminal connections) Resolution: 16 bits Sigma-Delta A/D conversion Input Mode: Voltage/Current Input Range: ±100 mV, ±1V, ±10V, ±20 mA Scaling: Configurable offset or scale and offset Alarm Triggers: Low, high, or range watermarks Accuracy: - +/-100 mV Range accuracy = +/-0.
Appendix A: Technical Specifications Rated current: 3A Rated voltage: 250 VAC Contact rating on relays: - 30VDC 3A, 250VAC 3A, 100000 cycles (IEC 61810) - 30VDC 3A, 240VAC 3A, 100000 cycles (UL 508) Isolation between relay contacts and internal circuitry: 4000 VAC Isolation between relay open contacts: 1000 VAC UL rating: Class 2 Note: Wires attached to the relay terminal blocks must be rated 90°C or higher! Connect Analog Inputs and Analog Outputs only to IEC Class III or NEC Cl
Appendix A: Technical Specifications DAQ Server: Tunnel Accept, Modbus and SNMP (Lantronix xSenso MIB) Client: Action Connect mode, HTTP Post, FTP Put and SNMP Trap Software Customizable real-time reading and chart view Analog input data can be logged on the PC from which the browser connection is made.
Appendix B: Technical Support If you are unable to resolve an issue using the information in this documentation, please contact Technical Support: Technical Support US Check our online knowledge base or send a question to Technical Support at http://www.lantronix.com/support. Technical Support Europe, Middle East, Africa Phone: +33 13 930 4172 Email: eu_techsupp@lantronix.com or eu_support@lantronix.com Firmware downloads, FAQs, and the most up-to-date documentation are available at http://www.lantronix.
Appendix C: Binary to Hexadecimal Conversions Many of the unit's configuration procedures require you to assemble a series of options (represented as bits) into a complete command (represented as a byte). The resulting binary value must be converted to a hexadecimal representation. Use this chapter to learn to convert binary values to hexadecimals or to look up hexadecimal values in the tables of configuration options.
Appendix C: Binary to Hexadecimal Conversions Figure C-2 Windows Scientific Calculator 4. Click Hex. The hexadecimal value appears.
Appendix D: Compliance (According to ISO/IEC Guide 17050-1, 17050-2 and EN 45014) Manufacturer's Name & Address: Lantronix, Inc. 167 Technology Drive, Irvine, CA 92618 USA Product Name Model: xSenso 2100, xSenso 21A2 and xSenso 21R2 Conforms to the following standards or other normative documents: Emissions FCC Part 15 Subpart B Industry Canada ICES-003 Issue 4 February 2004 CISPR 11:2003 + A1:2004 + A2:2006 - Industrial, Scientific, and Medical VCCI V-3/2010.
Appendix D: Compliance Manufacturer's Contact: Lantronix, Inc.
Appendix E: USB-CDC-ACM Device Driver File for Windows Hosts The following file may be used to enable Windows to recognize the USB-CDC-ACM connection to the xSenso's USB Device port. Create the linux-cdc-acm.inf file on the Windows host somewhere using the contents provided below. When Windows prompts for a device driver for the USB connection, point it to this file. Note: For Windows 7 installation, it is recommended to manually install the driver before plugging in the USB cable to the device port.
Appendix E: USB-CDC-ACM Device Driver File for Windows Hosts ;----------------------------------------------------------------------; Vista-64bit Sections ;----------------------------------------------------------------------[DriverInstall.NTamd64] include=mdmcpq.inf CopyFiles=DriverCopyFiles.NTamd64 AddReg=DriverInstall.NTamd64.AddReg [DriverCopyFiles.NTamd64] USBSER.sys,,,0x20 [DriverInstall.NTamd64.AddReg] HKR,,DevLoader,,*ntkern HKR,,NTMPDriver,,USBSER.sys HKR,,EnumPropPages32,,"MsPorts.
