Preface RUGGEDCOM DIRECTOR v1.4 User Guide 09/2017 RC1299-EN-01 Introduction 1 User Interface 2 Using RUGGEDCOM DIRECTOR 3 Theory of Operation 4 RUGGEDCOM DIRECTOR User Guide Copyright (c) 2017 Siemens Canada Ltd All rights reserved. Dissemination or reproduction of this document, or evaluation and communication of its contents, is not authorized except where expressly permitted. Violations are liable for damages. All rights reserved, particularly for the purposes of patent application or trademark registration. This document contains proprietary information, which is protected by copyright. All rights are reserved. No part of this document may be photocopied, reproduced or translated to another language without the prior written consent of Siemens Canada Ltd. Disclaimer Of Liability Siemens has verified the contents of this document against the hardware and/or software described. However, deviations between the product and the documentation may exist. Siemens shall not be liable for any errors or omissions contained herein or for consequential damages in connection with the furnishing, performance, or use of this material. The information given in this document is reviewed regularly and any necessary corrections will be included in subsequent editions. We appreciate any suggested improvements. We reserve the right to make technical improvements without notice. Registered Trademarks RUGGEDCOMTM and ROSTM are trademarks of Siemens Canada Ltd. Other designations in this manual might be trademarks whose use by third parties for their own purposes would infringe the rights of the owner. Open Source RUGGEDCOM DIRECTOR contains Open Source Software. For license conditions, refer to the associated License Conditions document. Security Information Siemens provides products and solutions with industrial security functions that support the secure operation of plants, machines, equipment and/or networks. They are important components in a holistic industrial security concept. With this in mind, Siemens' products and solutions undergo continuous development. Siemens recommends strongly that you regularly check for product updates. For the secure operation of Siemens products and solutions, it is necessary to take suitable preventive action (e.g. cell protection concept) and integrate each component into a holistic, state-of-the-art industrial security concept. Third-party products that may be in use should also be considered. For more information about industrial security, visit http://www.siemens.com/industrialsecurity. To stay informed about product updates as they occur, sign up for a product-specific newsletter. For more information, visit http:// support.automation.siemens.com. Warranty Refer to the License Agreement for the applicable warranty terms and conditions, if any. For warranty details, visit www.siemens.com/ruggedcom or contact a Siemens customer service representative. Contacting Siemens Address Siemens Canada Ltd Industry Sector 300 Applewood Crescent Concord, Ontario Canada, L4K 5C7 ii Telephone Toll-free: 1 888 264 0006 Tel: +1 905 856 5288 Fax: +1 905 856 1995 E-mail ruggedcom.info.i-ia@siemens.com Web www.siemens.com/ruggedcom RUGGEDCOM DIRECTOR Table of Contents User Guide Table of Contents Preface ............................................................................................................. v Alerts .................................................................................................................................................. v Accessing Documentation .................................................................................................................... vi Training .............................................................................................................................................. vi Customer Support ............................................................................................................................... vi Chapter 1 Introduction ..................................................................................................... 1 1.1 Features ....................................................................................................................................... 2 1.2 Security Recommendations ............................................................................................................ 2 1.3 Data Execution Prevention ............................................................................................................. 3 1.4 Use Cases ..................................................................................................................................... 3 1.5 Requirements ............................................................................................................................... 3 1.5.1 System Requirements ......................................................................................................... 4 1.5.2 Installation Notes ............................................................................................................... 4 1.5.3 Enabling Telnet Client In Windows ...................................................................................... 4 1.5.4 Microsoft Windows Firewall ................................................................................................ 5 Chapter 2 User Interface ................................................................................................... 7 2.1 Main Window ............................................................................................................................... 7 2.1.1 Connection Table ............................................................................................................... 8 2.1.2 Main Window Display Columns ........................................................................................... 8 2.1.2.1 Color-Coded Indicators ............................................................................................ 9 2.1.2.2 Operations On Table Entries ................................................................................... 10 2.1.3 Main Window Buttons ...................................................................................................... 11 2.1.4 Main Window Menu Bar ................................................................................................... 11 2.2 Dialog Boxes ............................................................................................................................... 13 2.2.1 Add a Virtual Serial Port ................................................................................................... 13 2.2.2 Configure a Serial Device .................................................................................................. 15 2.2.3 Start ROS Trace ................................................................................................................ 16 Chapter 3 Using RUGGEDCOM DIRECTOR ......................................................................... 17 3.1 Configuring a New Virtual Serial Port Connection .......................................................................... 17 iii Table of Contents RUGGEDCOM DIRECTOR User Guide 3.2 Multiple Connections to the Same Port ......................................................................................... 18 3.3 Configuring Multiple Connections At Once ................................................................................... 18 3.4 Configuration Auto-Saving ........................................................................................................... 19 3.5 ROS Trace ................................................................................................................................... 19 3.5.1 Starting and Stopping ROS Trace ....................................................................................... 19 3.5.2 ROS Trace Files ................................................................................................................ 20 3.5.3 Configuring ROS Trace ...................................................................................................... 21 3.5.4 Sample Trace File ............................................................................................................. 21 Chapter 4 Theory of Operation ........................................................................................ 27 4.1 Principles of Operation ................................................................................................................ 27 4.2 Serial Control Signals .................................................................................................................. 28 iv RUGGEDCOM DIRECTOR Preface User Guide Preface This guide describes the RUGGEDCOM DIRECTOR serial redirection software utility which, in conjunction with RUGGEDCOM server networking products, extends the reach of traditional serial communications across IP networks. It contains instructions and guidelines on how to use the software, as well as some general theory. It is intended for use by network technical support personnel who are familiar with the operation of networks. It is also recommended for us by network and system planners, system programmers, and line technicians. CONTENTS * "Alerts" * "Accessing Documentation" * "Training" * "Customer Support" Alerts The following types of alerts are used when necessary to highlight important information. DANGER! DANGER alerts describe imminently hazardous situations that, if not avoided, will result in death or serious injury. WARNING! WARNING alerts describe hazardous situations that, if not avoided, may result in serious injury and/or equipment damage. CAUTION! CAUTION alerts describe hazardous situations that, if not avoided, may result in equipment damage. IMPORTANT! IMPORTANT alerts provide important information that should be known before performing a procedure or step, or using a feature. NOTE NOTE alerts provide additional information, such as facts, tips and details. Alerts v RUGGEDCOM DIRECTOR Preface User Guide Accessing Documentation The latest user documentation for RUGGEDCOM DIRECTOR v1.4 is available online at www.siemens.com/ruggedcom. To request or inquire about a user document, contact Siemens Customer Support. Training Siemens offers a wide range of educational services ranging from in-house training of standard courses on networking, Ethernet switches and routers, to on-site customized courses tailored to the customer's needs, experience and application. Siemens' Educational Services team thrives on providing our customers with the essential practical skills to make sure users have the right knowledge and expertise to understand the various technologies associated with critical communications network infrastructure technologies. Siemens' unique mix of IT/Telecommunications expertise combined with domain knowledge in the utility, transportation and industrial markets, allows Siemens to provide training specific to the customer's application. For more information about training services and course availability, visit www.siemens.com/ruggedcom or contact a Siemens Sales representative. Customer Support Customer support is available 24 hours, 7 days a week for all Siemens customers. For technical support or general information, contact Siemens Customer Support through any of the following methods: Online Visit http://www.siemens.com/automation/support-request to submit a Support Request (SR) or check on the status of an existing SR. Telephone Call a local hotline center to submit a Support Request (SR). To locate a local hotline center, visit http:// www.automation.siemens.com/mcms/aspa-db/en/automation-technology/Pages/default.aspx. Mobile App Install the Industry Online Support app by Siemens AG on any Android, Apple iOS or Windows mobile device and be able to: * * * * vi Access Siemens' extensive library of support documentation, including FAQs and manuals Submit SRs or check on the status of an existing SR Contact a local Siemens representative from Sales, Technical Support, Training, etc. Ask questions or share knowledge with fellow Siemens customers and the support community Accessing Documentation RUGGEDCOM DIRECTOR Chapter 1 User Guide Introduction Introduction RUGGEDCOM DIRECTOR is a software utility that creates virtual COM port-style serial device interfaces on computer systems running the following operating systems: Microsoft Windows 7 (32 and 64 bit), Windows 7 Embedded (32 bit, running on an APE card), Windows 8 (32 and 64 bit), Windows 10 (32 and 64 bit), and Microsoft Windows Server 2012 (64 bit). Each virtual serial port is connected across an IP network to a corresponding serial interface on a RUGGEDCOM server device. Application software that ordinarily connects to a given device via local serial port hardware can thus be made to connect, transparently, to the same device via a remote ROS-based serial server, located anywhere within reach of an IP network. RUGGEDCOM DIRECTOR is installed as a service in Windows. This means virtual serial port connections configured using RUGGEDCOM DIRECTOR run in the background by default, even when RUGGEDCOM DIRECTOR is not running. Following a system reboot, previously configured connections will resume automatically. When RUGGEDCOM DIRECTOR is restarted, active virtual connections are visible in the main window. NOTE Virtual serial port traffic (bytes) and IP traffic (packets) are only counted when the RUGGEDCOM DIRECTOR user interface is running. IMPORTANT! RUGGEDCOM DIRECTOR is intended to control only legacy serial devices over IP, as all information in serial communication traces is in plain text, including any possible login credentials required for accessing remote devices. Legacy telecontrol protocols that need RUGGEDCOM DIRECTOR do not normally require login information. Using RUGGEDCOM DIRECTOR to control ROS devices in such a manner is not recommended. RUGGEDCOM DIRECTOR has no access control and no security features to handle sensitive data. Using the Windows login mechanism, make sure the use of RUGGEDCOM DIRECTOR and access to the configuration data is only possible by authorized personnel. CONTENTS * Section 1.1, "Features" * Section 1.2, "Security Recommendations" * Section 1.3, "Data Execution Prevention" * Section 1.4, "Use Cases" * Section 1.5, "Requirements" 1 Chapter 1 Introduction RUGGEDCOM DIRECTOR User Guide Section 1.1 Features * Transparent COM-port virtualization and redirection via IP. * No application level support is necessary. RUGGEDCOM DIRECTOR provides an application interface identical to that of hardware COM-ports. * Compact, detailed main window displays a complete summary all configured connections. * Supports up to 128 simultaneous connections. * Detailed port status, logging and tracing. * Built-in knowledge of all models of RUGGEDCOM server devices assists in the configuration of multiple connections. * Convenient Telnet connection to serial server management interface. * Background mode operation in System Tray. * Access throughout the program to context-sensitive help. Section 1.2 Security Recommendations The computer system running RUGGEDCOM DIRECTOR and the RUGGEDCOM DIRECTOR software should be appropriately secured. Authentication * Replace the default passwords for all user accounts and processes (where applicable). * Use strong passwords. Avoid weak passwords such as password1, 123456789, abcdefgh, etc. * Make sure passwords are protected and not shared with unauthorized personnel. * Passwords should not be re-used across different user names and systems, or after they expire. * Record passwords (including device passwords) in a safe, secure, off-line location for future retrieval should they be misplaced. * File transfer protocols - FTP, HTTP, NFS and Windows File sharing - should not allow unauthenticated access to RUGGEDCOM DIRECTOR software, configuration or database directories. Physical/Remote Access * Make sure RUGGEDCOM DIRECTOR is deployed behind a corporate firewall. * Be aware of any non-secure protocols enabled on the device. While some protocols, such as HTTPS, SSH and SNMPv3, are secure, others, such as Telnet and RCDP, were not designed for this purpose. Appropriate safeguards against non-secure protocols should be taken to prevent unauthorized access to RUGGEDCOM DIRECTOR and the network. * Use RUGGEDCOM DIRECTOR in a secured environment with controlled and monitored network access and local machine access. * SSH connections to RUGGEDCOM ROS devices via RUGGEDCOM DIRECTOR do not use strict host key checking. Make sure to verify the identity of any RUGGEDCOM ROS devices before connecting to them. 2 Features RUGGEDCOM DIRECTOR User Guide Chapter 1 Introduction Policy * Periodically audit the use, installation and configuration of RUGGEDCOM DIRECTOR to make sure it complies with these recommendations and/or any internal security policies. * Review the user documentation for other Siemens products used in coordination with RUGGEDCOM DIRECTOR for further security recommendations. * For increased security, Siemens recommends enabling Data Execution Prevention (DEP) when using RUGGEDCOM DIRECTOR. For more information about DEP, refer to Section 1.3, "Data Execution Prevention". * For the latest information on security issues for Siemens products, visit the Industrial Security website [http://www.industry.siemens.com/topics/global/en/industrial-security/news-alerts/Pages/alerts.aspx] or the ProductCERT Security Advisories website [http://www.siemens.com/innovation/en/technology-focus/ siemens-cert/cert-security-advisories.htm]. Updates to Siemens Product Security Advisories can be obtained by subscribing to the RSS feed on the Siemens ProductCERT Security Advisories website, or by following @ProductCert on Twitter. Section 1.3 Data Execution Prevention Data Execution Prevention (DEP) helps protect workstations by monitoring programs to make sure they use system memory safely. If DEP notices a program using memory incorrectly, it automatically closes the program and sends a notification. For increased security, Siemens recommends enabling DEP when using RUGGEDCOM DIRECTOR. For more information about DEP, including instructions on how to enable DEP, visit www.microsoft.com. Section 1.4 Use Cases Some common uses of RUGGEDCOM DIRECTOR are: * Remote Monitoring/Control: Serial devices may be controlled or monitored from computer systems at remote sites. * Consolidation/Centralization: Multiple software applications running on a single central computer system can access serial devices at various remote sites across an IP network. Section 1.5 Requirements This section sets out the hardware, software, and networking environment required in order to correctly install and operate Siemens's RUGGEDCOM DIRECTOR serial redirector application. CONTENTS * Section 1.5.1, "System Requirements" * Section 1.5.2, "Installation Notes" * Section 1.5.3, "Enabling Telnet Client In Windows" Data Execution Prevention 3 Chapter 1 RUGGEDCOM DIRECTOR Introduction User Guide * Section 1.5.4, "Microsoft Windows Firewall" Section 1.5.1 System Requirements RUGGEDCOM DIRECTOR must be installed and run with administrative privileges on a computer running Microsoft Windows. It has been tested against and verified to operate correctly under Microsoft Windows 7 (32 and 64 bit), Windows 7 Embedded (32 bit, running on an APE card), Windows 8 (32 and 64 bit), Windows 10 (32 and 64 bit), and Microsoft Windows Server 2012 (64 bit). RUGGEDCOM DIRECTOR must be run on a computer with a network card installed. The network card must be configured to use TCP/IP and have a valid IPv4 address. An Internet connection is not required to install and run RUGGEDCOM DIRECTOR but Microsoft Internet Explorer is required to make use of the integrated online Help (accessed via Help links within the software). Section 1.5.2 Installation Notes The installation program contains the RUGGEDCOM DIRECTOR application, integrated online help, PDF documentation, and all supporting software libraries required by the application. The RUGGEDCOM DIRECTOR installation program unpacks all files into a user-selectable directory. NOTE The online Help is displayed in a Web browser running with full administrator privileges. During installation, you have the option to disable the online Help. Select No when asked if you want to install the user guide, and this will disable the online Help. Section 1.5.3 Enabling Telnet Client In Windows To take advantage of the RUGGEDCOM DIRECTOR Telnet connection feature, Telnet Client must be enabled in Microsoft Windows. In some Windows versions, this option is disabled by default. For more information about enabling the Telnet Client, visit www.microsoft.com. The following steps outline the typical Telnet Client enable procedure in Windows: 4 1. Open the Control Panel. 2. Click on Programs and Features. 3. In Programs and Features, click on Turn Windows features on or off. 4. In the list of Windows features, check the box beside: "Telnet Client". 5. Click OK. System Requirements RUGGEDCOM DIRECTOR User Guide Chapter 1 Introduction Section 1.5.4 Microsoft Windows Firewall Depending on the settings of the network firewall built in to Microsoft Windows operating systems, a warning similar to the following might be displayed when RUGGEDCOM DIRECTOR attempts to make a network connection to a RUGGEDCOM server: Figure 1: Windows Firewall Warning If this warning is displayed, it is recommended to allow access for RUGGEDCOM DIRECTOR to operate correctly. Microsoft Windows Firewall 5 Chapter 1 Introduction 6 RUGGEDCOM DIRECTOR User Guide Microsoft Windows Firewall RUGGEDCOM DIRECTOR User Guide Chapter 2 User Interface User Interface The RUGGEDCOM DIRECTOR user interface centers on a main window, which displays all configured virtual serial port connections along with basic status and statistical information, along with commonly needed controls. CONTENTS * Section 2.1, "Main Window" * Section 2.2, "Dialog Boxes" Section 2.1 Main Window The RUGGEDCOM DIRECTOR main window is displayed after initialization: Figure 2: Main Window The RUGGEDCOM DIRECTOR main window consists of four main components: * A series of columns summarizing key information. * A column of navigational buttons on the right side of the window. * A menu bar across the top of the window with a series of drop-down menus. * A status bar along the bottom of the window, which displays context-sensitive program status. Main Window 7 Chapter 2 RUGGEDCOM DIRECTOR User Interface User Guide This section describes these components in more detail. CONTENTS * Section 2.1.1, "Connection Table" * Section 2.1.2, "Main Window Display Columns" * Section 2.1.3, "Main Window Buttons" * Section 2.1.4, "Main Window Menu Bar" Section 2.1.1 Connection Table The main window display lists all the remote serial connections configured in RUGGEDCOM DIRECTOR. The connection list may be customized in the following ways: * Sorting: The entire display may be sorted on the basis of any one of the columns (including the Server IP:Port column). Clicking on a column title will sort the whole list in increasing order of the items in that column. Clicking again will sort in decreasing order. * Resizing: Each column may be resized by clicking and dragging the rightmost edge of a column title. Section 2.1.2 Main Window Display Columns Figure 3: Main Window Display Columns RUGGEDCOM DIRECTOR's main window displays configuration, status, and connection statistics for each serial redirector configuration entry. The columns displayed are: 8 Status Indicator The color of the indicator in the leftmost column represents the status of the corresponding connection, and changes in real time in response to changes in status. For more information on this feature, see the section on Section 2.1.2.1, "Color-Coded Indicators". Server Name The serial server name, to identify a particular connection. The name may be entered manually or generated automatically. Connection Table RUGGEDCOM DIRECTOR Chapter 2 User Guide User Interface Virtual Port Virtual serial port number (e.g. COM5, COM6, etc.). Server IP: Port The IP address and port number of the serial server to which the corresponding virtual serial port is redirected (e.g. 192.168.0.1:5555). Connection Status The connection status represents the network connection between RUGGEDCOM DIRECTOR and the corresponding serial server. Rx Chars The number of bytes received via the virtual serial port. Tx chars The number of bytes transmitted via the virtual serial port. Rx Packets The number of packets received via the virtual serial port. Tx Packets The number of packets transmitted via the virtual serial port. CONTENTS * Section 2.1.2.1, "Color-Coded Indicators" * Section 2.1.2.2, "Operations On Table Entries" Section 2.1.2.1 Color-Coded Indicators An icon in the leftmost column of each entry displays the status of RUGGEDCOM DIRECTOR's connection to the corresponding serial server: * Green indicates that the connection is established and is ready to use. * Red indicates that an error has occurred on this connection. * Gray indicates that the connection is stopped or has not yet been started. If the indicator is red, the status bar at the bottom of the window will display a brief explanation when the list item is clicked on. The interpretation of the status indication varies slightly for TCP versus UDP connections. TCP Connection Status Summary Connected The corresponding virtual serial port connection has been started, RUGGEDCOM DIRECTOR has successfully established a network connection with the RUGGEDCOM server and is ready to pass data on the virtual serial port. Error An attempt to start the corresponding virtual serial port connection has been made, but RUGGEDCOM DIRECTOR cannot connect to the specified serial server. Stopped The corresponding virtual serial port connection has been stopped by the user. UDP Connection Status Summary Since UDP is not a connection-oriented protocol, the status of UDP-based virtual serial port connections must be reported differently. Started Color-Coded Indicators The corresponding virtual serial port connection has been started, and RUGGEDCOM DIRECTOR is able to reach the serial server via the network. 9 Chapter 2 RUGGEDCOM DIRECTOR User Interface User Guide Error The corresponding virtual serial port connection has been started, and RUGGEDCOM DIRECTOR is not able to reach the serial server via the network. Stopped The corresponding virtual serial port connection has been stopped by the user. Section 2.1.2.2 Operations On Table Entries Several operations and shortcuts are supported when clicking on individual list entries in the main window: * Clicking or Double-clicking on an entry selects the entry. * Right-clicking on an entry brings up the Right Mouse menu (note that all actions in the menu will apply to all currently highlighted entries rather than to only the entry that is being right-clicked). * Shift-clicking on an entry selects a range of information between a previously clicked entry and the one currently being shift-clicked. * Ctrl-clicking on an entry toggles the selection state of the corresponding item. This allows the detailed selection of a group, or of a discontinuous range. Right Mouse Menu The Right Mouse Menu, illustrated below, is accessed by right-clicking anywhere in the main window. Actions in this menu will apply to highlighted entries rather than only the entry that is being right-clicked. Figure 4: Right Mouse Menu 10 Add Add a virtual serial port configuration to the list via the Add Virtual Port dialog box. For more information, refer to Section 2.2.1, "Add a Virtual Serial Port". Remove Remove the selected virtual serial ports from the list. Start Enable bidirectional communication on the selected virtual serial port connection(s). Stop Disable bidirectional communication on the selected virtual serial port connection(s). Configure Display the configuration editor for the selected COM port. For more information, refer to Section 2.2.2, "Configure a Serial Device". Telnet Open a Telnet session to the corresponding serial server's management interface. Operations On Table Entries RUGGEDCOM DIRECTOR Chapter 2 User Guide User Interface Section 2.1.3 Main Window Buttons Five buttons are located in a column to the right of the main display window. These provide rapid and convenient access to the most commonly required functions of RUGGEDCOM DIRECTOR. The buttons are described below. Add virtual serial ports. Remove virtual serial ports from a list. Show COM port details. Show the configuration editor. Open a Telnet session. Section 2.1.4 Main Window Menu Bar Figure 5: Main Menu Bar The following sections describe the commands that are accessible from the main menu bar (pictured above) at the top of the main window. File Menu Figure 6: File Menu Save session Save the current configuration to a specified file. Load session Load a configuration from a specified file. Exit Terminate RUGGEDCOM DIRECTOR. Main Window Buttons 11 Chapter 2 RUGGEDCOM DIRECTOR User Interface User Guide View Menu Figure 7: View Menu Telnet Open a Telnet session to the selected serial server's management interface. Device Menu Figure 8: Device Menu Add Add virtual serial ports to the list (bring up an Add Virtual Port dialog box). For more information, refer to Section 2.2.1, "Add a Virtual Serial Port". Remove Remove the selected virtual serial ports from the list. Start Enable bidirectional communication on the selected virtual serial port connection(s). Stop Disable bidirectional communication on the selected virtual serial port connection(s). Configure Show the configuration editor for the selected COM port. For more information, refer to Section 2.2.2, "Configure a Serial Device". ROS Trace Menu Figure 9: ROS Trace Menu 12 Start ROS Trace Open the Start ROS Trace dialog box, which will start a ROS Trace. For more information, refer to Section 2.2.3, "Start ROS Trace" and Section 3.5, "ROS Trace". Stop ROS Trace Stop a ROS Trace. Show in folder Display a Windows Explorer folder that contains ROS Trace files (output files). Main Window Menu Bar RUGGEDCOM DIRECTOR Chapter 2 User Guide User Interface Help Menu Figure 10: Help Menu User guide Open the user guide for RUGGEDCOM DIRECTOR. About RUGGEDCOM DIRECTOR Show the version number and support information. NOTE Selecting No for the option to install the user guide during installation disables the online Help. If the online Help is disabled, selecting User guide displays a dialog box that says "Help file not found." Section 2.2 Dialog Boxes This section describes in detail the special-function dialog windows referred to from various places in the main interface window. CONTENTS * Section 2.2.1, "Add a Virtual Serial Port" * Section 2.2.2, "Configure a Serial Device" * Section 2.2.3, "Start ROS Trace" Section 2.2.1 Add a Virtual Serial Port This dialog box is used to create a configuration set by specifying information for a remote RUGGEDCOM server, which may serve several serial port connections at once. Dialog Boxes 13 Chapter 2 RUGGEDCOM DIRECTOR User Interface User Guide Figure 11: Add Virtual Serial Port Dialog Box Server Model The model of RUGGEDCOM server to connect to. Number of ports The number of ports to configure. This parameter is filled in automatically by RUGGEDCOM DIRECTOR based on the RUGGEDCOM server model, but may be overridden. IP Address:Port The IP address and starting port number of the serial server. Note that the ending port number is generated based on the starting port and the total number to configure. Server Name A name that identifies a particular configuration. The name is generated automatically but may be overridden. Transport Method The IP protocol to use for connections in this configuration. Briefly, TCP guarantees delivery at the potential cost of increased latency, and UDP does not guarantee delivery, but can offer lower latency. Local Port (UDP only) The starting UDP port number of local (to RUGGEDCOM DIRECTOR's system) connections to the serial server. Note that the ending port number is generated based on the starting port and the total number to configure. Note also that for TCP connections, this parameter is neither displayed nor needed. Virtual Serial Port The virtual system COM ports to create for this configuration. Note that the starting port is specified, and the remainder are automatically created incrementally, skipping any ports that may already have been allocated. Add Add the virtual serial port configuration to RUGGEDCOM DIRECTOR. Cancel Cancel the operation. Help Display user guide information about the dialog box. NOTE The number of ports that may be configured at a time is between one and the maximum serial port supported by the selected model of RUGGEDCOM server. The default IP port will be filled in after the 14 Add a Virtual Serial Port RUGGEDCOM DIRECTOR Chapter 2 User Guide User Interface server model is chosen. A unique name will be generated each time based on the server model and any existing configuration. Section 2.2.2 Configure a Serial Device This dialog box is used to modify the settings of an existing single configured connection. Figure 12: Configure Device Dialog Box IP Address:Port The IP address of the serial server and port number of the virtual serial port connection. Server Name A name that identifies the connection. Transport Method The IP protocol to use for connections in this configuration. Briefly, TCP guarantees delivery at the potential cost of increased latency, and UDP does not guarantee delivery, but can offer lower latency. Note that the transport method cannot be changed for an existing connection. Virtual Serial Port The virtual system COM ports to use for this connection. OK Save the configuration. Cancel Cancel the reconfiguration. Help Display user guide information about the dialog box. Configure a Serial Device 15 Chapter 2 RUGGEDCOM DIRECTOR User Interface User Guide Section 2.2.3 Start ROS Trace This dialog box is used to start a ROS Trace. For more information on this feature, see Section 3.5, "ROS Trace". Figure 13: Start ROS Trace Dialog Box The buttons on the Start ROS Trace dialog box are: 16 Start Start a ROS Trace. Cancel Cancel a ROS Trace. Start ROS Trace RUGGEDCOM DIRECTOR Chapter 3 User Guide Using RUGGEDCOM DIRECTOR Using RUGGEDCOM DIRECTOR This section describes how to configure RUGGEDCOM DIRECTOR. CONTENTS * Section 3.1, "Configuring a New Virtual Serial Port Connection" * Section 3.2, "Multiple Connections to the Same Port" * Section 3.3, "Configuring Multiple Connections At Once" * Section 3.4, "Configuration Auto-Saving" * Section 3.5, "ROS Trace" Section 3.1 Configuring a New Virtual Serial Port Connection To configure one or more virtual serial port connections between RUGGEDCOM DIRECTOR and a RUGGEDCOM server device, one must first configure the server to provide as many RawSocket connections as required. Once these are configured, RUGGEDCOM DIRECTOR can then be configured to connect to the server ports. NOTE For more information about how to configure RawSocket connections, refer to the ROS User Guide for the RUGGEDCOM device available at www.siemens.com/ruggedcom. The following information is needed at the server in order to configure a RawSocket connection that may be connected to using RUGGEDCOM DIRECTOR: * RUGGEDCOM server serial port number(s) * Connection method (TCP or UDP) * RUGGEDCOM DIRECTOR IP address * TCP port number or UDP port numbers at both server and RUGGEDCOM DIRECTOR ends The following information is needed at RUGGEDCOM DIRECTOR in order to configure a virtual serial port connection to a RUGGEDCOM server: * Starting COM port number * Connection method (TCP or UDP) * IP address/remote TCP port number or IP address/local and remote UDP port numbers * RUGGEDCOM server model For detail on configuring a new connection or series of connections, refer to Section 2.2.1, "Add a Virtual Serial Port". Configuring a New Virtual Serial Port Connection 17 Chapter 3 RUGGEDCOM DIRECTOR Using RUGGEDCOM DIRECTOR User Guide Section 3.2 Multiple Connections to the Same Port It is possible to connect several RUGGEDCOM DIRECTOR virtual serial ports to the same serial port on a RUGGEDCOM server. It is important to set the MaxConns parameter for the RawSocket configuration to accept as many connections as are required. Section 3.3 Configuring Multiple Connections At Once RUGGEDCOM DIRECTOR will create virtual COM ports for as many serial ports as are supported by the model of RUGGEDCOM server being connected to. Any of these automatically created configuration entries may be modified afterwards. For example, RUGGEDCOM DIRECTOR will create a configuration RS400 consisting of four serial ports. If only three connections are needed, the surplus one may be deleted. NOTE The main window displays only the counted packets for one TCP connection to the same port of a serial server at a time. For more information about the main window display, refer to Section 2.1.2, "Main Window Display Columns". In order for RUGGEDCOM DIRECTOR's auto-configuration process to work, the following convention must be followed for the server's own configuration. For all server serial ports that are to be used with RUGGEDCOM DIRECTOR: * All of a given server's serial ports must share the same IP address as the server itself. * The connection protocol (TCP or UDP) must be common to all ports. * The TCP or UDP port numbers of each port must be in sequence. A typical RUGGEDCOM DIRECTOR/server configuration is illustrated below: Figure 14: Add Range Configuration Only currently unassigned COM ports will be displayed in the selection drop box. The auto-configuration process skips unavailable COM port numbers when creating a series of virtual ports. For example, if the user wants to add three ports starting with COM5, but COM 7 and 8 are in use, then RUGGEDCOM DIRECTOR will create configurations for COM5, COM6, and COM9. To remove an existing virtual port form the list, simply select the relevant line in the main window and press the Remove button. 18 Multiple Connections to the Same Port RUGGEDCOM DIRECTOR Chapter 3 User Guide Using RUGGEDCOM DIRECTOR Section 3.4 Configuration Auto-Saving Connections configured using RUGGEDCOM DIRECTOR are persistent: configuration information is saved automatically at the time RUGGEDCOM DIRECTOR is terminated, and is reloaded each time RUGGEDCOM DIRECTOR is started. NOTE Configuration is usually saved explicitly via the Save session option. For more information, refer to "File Menu". NOTE When multiple simultaneous connections have been saved, RUGGEDCOM DIRECTOR can take several minutes to reload the connections at start up. Section 3.5 ROS Trace RUGGEDCOM DIRECTOR has a tracing feature called ROS Trace. Using ROS Trace, you can set up a remote server and enable tracing on a ROS device. ROS Trace then listens for any incoming data from a ROS device. The status of ROS Trace is displayed in the bottom right corner of the page. Depending on the status, the status message will say "ROS Trace Enabled(Port#)", "ROS Trace Disabled" or "ROS Trace Error". If an error occurs, ROS Trace automatically turns off. This section describes ROS Trace in more detail. CONTENTS * Section 3.5.1, "Starting and Stopping ROS Trace" * Section 3.5.2, "ROS Trace Files" * Section 3.5.3, "Configuring ROS Trace" * Section 3.5.4, "Sample Trace File" Section 3.5.1 Starting and Stopping ROS Trace To start ROS Trace, do the following: 1. To start ROS Trace, click on the ROS Trace menu on the main menu bar, and then click Start ROS Trace. The Start ROS Trace dialog box appears. Configuration Auto-Saving 19 Chapter 3 Using RUGGEDCOM DIRECTOR RUGGEDCOM DIRECTOR User Guide Figure 15: Start ROS Trace dialog box 2. Enter a port number. 3. Click Start. ROS Trace starts. 4. In the main window, click on a port from the list. 5. Click 6. Enter your ROS user name and press Enter. 7. Enter your ROS password and press Enter. 8. Configure ROS as required to run the ROS Trace. For information on how to configure ROS, see the ROS User Guide. to open a Telnet session. Clicking Show in Folder on the ROS Trace menu opens a Windows Explorer folder that contains ROS Trace files (output files). To stop ROS Trace, click on the ROS Trace menu on the main menu bar, and then click Stop ROS Trace. Click yes when prompted. Section 3.5.2 ROS Trace Files ROS Trace files are stored in the folder named ROSTraceFiles, which is located inside the RUGGEDCOM DIRECTOR folder. This folder is created during installation. If not, it is created when the ROS Trace server gets data from ROS devices. A text file is created for each ROS device. The name of the ROS Trace file is the IP address of the device. Example: C:\Program Files\RUGGEDCOM\RUGGEDCOM RUGGEDCOM DIRECTOR\ROSTraceFiles\{IP Address}(1).txt {IP Address} is the IP address of the ROS device. By default, ROS Trace keeps two files for each device (the default value of NumberOfROSTraceFiles is set to 2 in the configuration file). If the file name contains a (1), this means it contains the most recent incoming data. A file name containing (2) is the archived file that has reached the maximum size (rolled over). If the file with (1) reaches maximum size, it will become (2), and the existing (2), which is the oldest entry, is deleted. In the ROS Trace file, the date stamp is created by the trace server and the time stamp is created by the ROS device. Example: 20 ROS Trace Files RUGGEDCOM DIRECTOR Chapter 3 User Guide [08/1/2012] [08/1/2012] 31 [08/1/2012] 32 [08/1/2012] 33 [08/1/2012] 34 [08/1/2012] 34 [08/1/2012] 34 [08/1/2012] 61 [08/1/2012] 73 Using RUGGEDCOM DIRECTOR 08/01 07:57:50.301 TRACE Connected to 1093741c, port 5330 07:58:12.697 RawSocket Port 2, tx msg 1b 07:58:12.738 RawSocket Port 2, tx msg 1b 07:58:12.779 RawSocket Port 2, tx msg 1b 07:58:56.744 RawSocket Port 3, tx msg 1b 07:58:56.804 RawSocket Port 3, tx msg 1b 07:58:57.001 RawSocket Port 3, tx msg 1b 08/01 08:02:50.012 RawSocket Port 4, tx msg 1b 08:02:50.462 RawSocket Port 4, tx msg 1b Section 3.5.3 Configuring ROS Trace The ROS configuration file is called RCDIRECTOR.ini. It is located in the RUGGEDCOM DIRECTOR folder in your workstation. The number of ROS Trace files can be changed in the configuration file. The parameter to be modified is called NumberOfROSTraceFiles. The maximum size of each text file can be configured by changing the value of the ROSTraceFileSize in the configuration file. The unit is in megabytes (MB). After changing the configuration file, restart ROS Trace and then the changes will take effect. It is recommended not to change the value of the ROSTraceBufferSize parameter. If the incoming data is larger than the buffer provided, ROS Trace generates an error. The default values for the parameters described in this section are as follows: * NumberOfROSTraceFiles = 2 * ROSTraceFileSize = 10 * ROSTraceBufferSize = 512 Section 3.5.4 Sample Trace File RUGGEDCOM Director(TM) Serial Trace ---General Information--Serial port: COM5 Server Name: RS910 #1 Model: RS910 IP: 172.30.85.2 Port: 50001 Transport method: TCP ---Traffic Count--Serial (bytes) RX: 2822 TX: 26 Configuring ROS Trace 21 Chapter 3 RUGGEDCOM DIRECTOR Using RUGGEDCOM DIRECTOR User Guide IP (packets) RX: 15 TX: 18 ---Data--[2/4/2010 9:47:20] >> 1 bytes 0D [2/4/2010 9:47:21] << 432 bytes 1B 5B 30 3B 32 32 3B 32 37 3B 32 1B 5B 30 6D 1B 5B 32 4A 1B 5B 31 3F 32 35 68 0D 0A 20 20 20 20 20 20 20 20 20 20 20 20 52 75 67 67 65 72 61 74 69 6E 67 20 53 79 73 33 2E 37 2E 33 20 28 53 65 70 20 30 39 20 31 37 3A 32 39 29 20 20 20 20 20 20 20 20 0D 0A 20 20 20 43 6F 70 79 72 69 67 68 74 20 28 67 67 65 64 43 6F 6D 2C 20 32 30 41 6C 6C 20 72 69 67 68 74 73 20 76 65 64 0D 0A 0D 0A 20 20 20 20 79 73 74 65 6D 20 4E 61 6D 65 3A 53 53 30 31 0D 0A 20 20 20 20 20 63 61 74 69 6F 6E 3A 20 20 20 20 61 74 69 6F 6E 0D 0A 20 20 20 20 6F 6E 74 61 63 74 3A 20 20 20 20 6E 74 61 63 74 0D 0A 20 20 20 20 72 6F 64 75 63 74 3A 20 20 20 20 39 30 30 4C 2D 48 49 44 2D 54 58 0A 20 20 20 20 20 20 20 20 4D 41 72 65 73 73 3A 20 20 20 30 30 2D 2D 30 30 2D 32 31 2D 37 33 0D 0A 20 20 20 53 65 72 69 61 6C 20 4E 3A 20 52 53 39 30 30 4C 2D 30 35 31 39 0D 0A 0D 0A 20 20 20 20 20 74 65 72 20 55 73 65 72 20 4E 61 22 . 35 3B 20 65 74 31 20 20 63 30 72 20 20 20 20 20 20 20 20 54 43 30 20 75 30 20 6D 3B 31 20 64 65 35 20 20 29 38 65 20 20 20 20 20 20 20 20 58 20 41 20 6D 37 20 65 32 48 20 20 6D 20 20 20 20 20 73 20 20 20 4C 20 20 20 20 56 41 2D 20 62 2D 20 3A 34 1B 20 4F 20 32 20 20 52 2D 65 20 50 4C 6F 20 43 20 52 31 64 44 20 65 30 45 20 6D 5B 20 70 76 30 20 20 75 20 72 53 41 6F 63 43 6F 50 53 0D 64 43 20 72 30 6E 20 .[0;22;27;25;24m .[0m.[2J.[1;1H.[ ?25h.. Rugged Op erating System v 3.7.3 (Sep 15 20 09 17:29) .. Copyright (c) Ru ggedCom, 2008 All rights reser ved.... S ystem Name: PA SS01.. Lo cation: Loc ation.. C ontact: Co ntact.. P roduct: RS 900L-HID-TXTXV1. . MAC Add ress: 00-0A-DC -00-21-73.. Serial Number : RS900L-0507-00 19.... En ter User Name: [2/4/2010 9:47:30] >> 1 bytes 61 a [2/4/2010 9:47:30] << 1 bytes 61 a [2/4/2010 9:47:31] >> 2 bytes 64 6D dm [2/4/2010 9:47:31] >> 1 bytes 69 i [2/4/2010 9:47:31] >> 1 bytes 6E n [2/4/2010 9:47:33] << 4 bytes 64 6D 69 6E dmin [2/4/2010 9:47:34] >> 1 bytes 0D . Sample Trace File RUGGEDCOM DIRECTOR Chapter 3 User Guide Using RUGGEDCOM DIRECTOR [2/4/2010 9:47:35] << 28 bytes 0D 0A 0D 0A 20 20 20 20 20 20 20 20 45 6E 74 65 72 20 50 61 73 73 77 6F 72 64 3A 20 .... Ente r Password: [2/4/2010 9:47:35] >> 1 bytes 61 a [2/4/2010 9:47:35] << 1 bytes 78 x [2/4/2010 9:47:35] >> 1 bytes 64 d [2/4/2010 9:47:35] >> 1 bytes 6D m [2/4/2010 9:47:35] << 1 bytes 78 x [2/4/2010 9:47:35] << 1 bytes 78 x [2/4/2010 9:47:36] >> 1 bytes 69 i [2/4/2010 9:47:36] >> 1 bytes 6E n [2/4/2010 9:47:36] << 1 bytes 78 x [2/4/2010 9:47:36] << 1 bytes 78 x [2/4/2010 9:47:36] >> 1 bytes 0D . [2/4/2010 9:47:37] << 1132 bytes 1B 5B 30 6D 1B 5B 31 3B 30 48 1B 30 3B 32 32 3B 32 37 3B 32 35 3B 31 3B 31 48 1B 5B 3F 32 35 6C 50 1B 5B 30 3B 32 32 3B 32 37 3B 32 1B 5B 31 3B 33 35 48 4D 61 69 6E 1B 5B 30 3B 32 32 3B 32 37 3B 32 1B 5B 31 3B 36 35 48 20 20 20 61 61 63 63 65 73 73 1B 5B 3F 32 35 1B 5B 32 3B 30 48 1B 5B 32 4B 1B 1B 5B 32 4B 1B 5B 34 3B 30 48 1B 35 3B 30 48 1B 5B 32 4B 1B 5B 36 32 4B 1B 5B 37 3B 30 48 1B 5B 32 30 48 1B 5B 32 4B 1B 5B 39 3B 30 1B 5B 31 30 3B 30 48 1B 5B 32 4B 30 48 1B 5B 32 4B 1B 5B 31 32 3B 4B 1B 5B 31 33 3B 30 48 1B 5B 32 3B 30 48 1B 5B 32 4B 1B 5B 31 35 Sample Trace File 5B 32 41 35 20 35 64 6C 5B 5B 3B 4B 48 1B 30 4B 3B 32 34 53 3B 4D 3B 6D 1B 33 32 30 1B 1B 5B 48 1B 30 4B 6D 53 32 65 32 69 5B 3B 4B 48 5B 5B 31 1B 5B 48 1B 1B 30 34 6E 34 6E 30 30 1B 1B 38 32 31 5B 31 1B 5B 5B 31 6D 75 6D 20 6D 48 5B 5B 3B 4B 3B 32 34 5B .[0m.[1;0H.[2K.[ 0;22;27;25;24m.[ 1;1H.[?25lPASS01 .[0;22;27;25;24m .[1;35HMain Menu .[0;22;27;25;24m .[1;65H admin access.[?25l.[0m .[2;0H.[2K.[3;0H .[2K.[4;0H.[2K.[ 5;0H.[2K.[6;0H.[ 2K.[7;0H.[2K.[8; 0H.[2K.[9;0H.[2K .[10;0H.[2K.[11; 0H.[2K.[12;0H.[2 K.[13;0H.[2K.[14 ;0H.[2K.[15;0H.[ 23 Chapter 3 RUGGEDCOM DIRECTOR Using RUGGEDCOM DIRECTOR 32 37 5B 32 1B 5B 48 35 6E 3B 48 5B 5B 74 32 67 3B 48 30 39 73 6D 63 32 61 1B 1B 74 32 33 61 35 77 30 31 73 5B 32 30 6C 34 6D 37 37 5B 1B 30 32 35 37 61 37 3B 20 24 4B 3B 32 30 5B 32 1B 3B 69 32 45 30 36 61 34 67 32 53 3B 3B 1B 1B 75 35 73 5B 5B 20 3B 30 62 3B 6F 3B 35 1B 32 32 3B 70 6D 53 3B 3B 30 5B 48 35 6C 3B 69 3B 35 20 1B 30 4B 3B 32 33 5B 32 73 37 74 3B 3B 74 6D 72 37 70 32 33 5B 5B 72 3B 73 30 31 46 32 48 6C 32 72 32 3B 5B 34 3B 31 1B 20 2D 32 32 3B 30 1B 3B 50 32 6E 35 3B 20 5B 48 1B 30 4B 3B 32 34 74 3B 68 32 33 73 1B 65 3B 61 32 30 30 31 69 32 65 3B 32 69 37 4D 65 34 6B 32 33 30 3B 32 3B 5B 1B 53 35 35 32 6D 5B 32 41 35 20 3B 32 34 31 1B 5B 48 1B 30 4B 6D 72 32 65 32 30 1B 5B 67 32 6E 3B 48 3B 30 74 34 73 32 3B 6C 3B 41 73 6D 20 3B 30 3B 31 37 32 30 5B 68 3B 3B 32 1B 32 34 53 3B 4D 32 34 20 36 5B 31 1B 5B 48 1B 1B 61 35 72 3B 48 5B 37 61 35 6E 32 56 32 3B 79 6D 20 32 33 74 32 43 1B 1B 44 32 48 31 48 3B 37 3B 30 65 32 34 3B 5B 4B 6D 53 32 65 34 6D 41 3B 32 39 5B 32 1B 5B 5B 74 3B 6E 32 45 30 3B 74 3B 69 37 69 32 33 1B 1B 6F 3B 30 65 35 20 5B 5B 69 37 44 3B 3C 32 3B 32 3B 6C 34 6D 32 30 1B 1B 30 34 6E 6D 1B 4C User Guide 30 4B 3B 32 32 5B 30 34 69 32 65 37 74 3B 33 69 32 6E 3B 72 3B 30 5B 5B 66 32 48 72 3B 41 30 31 73 3B 69 32 43 35 32 32 31 6C 6D 58 37 4B 5B 5B 31 6D 75 1B 5B 41 48 1B 30 4B 3B 32 3B 3B 6F 34 74 3B 68 32 30 6F 34 67 32 74 32 48 30 31 20 37 4D 69 32 64 3B 34 63 32 61 37 54 3B 35 3B 3B 1B 20 2D 3B 1B 30 31 1B 1B 1B 5B 31 52 1B 5B 48 1B 30 4B 32 33 6E 6D 20 32 65 32 48 6E 6D 20 35 75 37 50 3B 31 53 3B 75 6E 34 64 32 3B 6F 35 67 3B 52 32 3B 32 32 5B 1B 4C 32 5B 3B 3B 5B 5B 5B 30 3B 4D 5B 31 1B 5B 48 1B 32 30 1B 1B 50 35 72 3B 4C 1B 1B 54 3B 61 3B 6F 32 3B 65 32 6C 67 6D 72 32 33 76 3B 6E 32 4C 34 34 37 37 30 5B 6F 35 30 32 31 30 31 30 3B 36 53 32 38 5B 32 1B 5B 3B 48 5B 5B 6F 3B 6E 37 69 5B 5B 72 32 6C 32 72 32 33 72 35 74 1B 1B 65 3B 30 65 32 6F 35 3E 6D 6D 3B 3B 3B 30 67 3B 6D 32 48 3B 3B 3B 32 35 21 4B 3B 32 31 5B 32 32 41 30 35 72 32 65 3B 6E 30 38 65 34 20 35 74 3B 30 76 3B 69 5B 5B 73 32 48 72 34 73 3B 1B 20 5A 32 32 32 3B 6F 32 1B 3B 1B 32 33 32 32 48 1B 30 4B 3B 32 34 37 64 3B 3B 74 34 74 32 6B 3B 3B 65 6D 4C 3B 20 32 48 69 32 63 30 31 73 37 4E 79 6D 74 34 5B 20 2D 35 35 32 31 75 34 5B 32 5B 32 35 32 3B 20 5B 48 1B 30 4B 3B 3B 6D 32 33 73 6D 20 35 20 32 33 1B 1B 41 32 53 37 43 63 34 61 3B 33 20 3B 65 1B 1B 69 6D 30 1B 48 3B 3B 3B 3B 74 6D 31 37 3F 3B 48 3B 32 20 31 1B 5B 48 1B 30 32 69 32 30 1B 1B 53 3B 41 32 30 5B 5B 4E 34 65 3B 6C 65 6D 73 32 3B 54 32 74 5B 5B 63 1B 3B 5B 65 32 34 32 32 1B 20 3B 3B 32 32 4D 32 37 20 2K.[16;0H.[2K.[1 7;0H.[2K.[18;0H. [2K.[19;0H.[2K.[ 20;0H.[2K.[21;0H .[2K.[22;0H.[2K. [23;0H.[2K.[24;0 H.[2K.[0;22;27;2 5;24m.[4;30HAdmi nistration.[0;22 ;27;25;24m.[5;30 HEthernet Ports. [0;22;27;25;24m. [6;30HEthernet S tats.[0;22;7;25; 24m.[7;30HLink A ggregation.[0;22 ;27;25;24m.[8;30 HSpanning Tree.[ 0;22;27;25;24m.[ 9;30HVirtual LAN s.[0;22;27;25;24 m.[10;30HPort Se curity.[0;22;27; 25;24m.[11;30HCl asses of Service .[0;22;27;25;24m .[12;30HMulticas t Filtering.[0;2 2;27;25;24m.[13; 30HMAC Address T ables.[0;22;27;2 5;24m.[14;30HNet work Discovery.[ 0;22;27;25;24m.[ 15;30HDiagnostic s.[0;1;27;25;4m. [24;1H<CTRL>.[0; 22;27;25;24m .[ 0;1;27;25;4mZ-He lp.[0;22;27;25;2 4m .[0;1;27;25;4 mS-Shell.[0;22;2 7;25;24m .[0;1;2 7;25;4mX-Logout. [0;22;27;25;24m .[0m.[0K.[0m.[1; 0H.[2K.[0;22;27; 25;24m.[1;1H.[?2 5lPASS01.[0;22;2 7;25;24m.[1;35HM ain Menu.[0;22;2 7;5;24m.[0;22;27 ;5;24m.[1;65H 4 ALARMS! [2/4/2010 9:47:38] >> 3 bytes 1B 5B 41 .[A [2/4/2010 9:47:38] >> 3 bytes 1B 5B 41 .[A [2/4/2010 9:47:38] << 75 bytes 1B 5B 30 3B 32 32 3B 32 37 3B 32 35 3B 32 34 6D 1B 5B 37 3B 33 30 48 4C 69 6E 6B 20 41 67 67 72 .[0;22;27;25;24m .[7;30HLink Aggr Sample Trace File RUGGEDCOM DIRECTOR Chapter 3 User Guide 65 67 61 74 69 6F 6E 1B 32 35 3B 32 34 6D 1B 5B 65 72 6E 65 74 20 53 74 Using RUGGEDCOM DIRECTOR 5B 30 3B 32 32 3B 37 3B 36 3B 33 30 48 45 74 68 61 74 73 [2/4/2010 9:47:38] >> 3 bytes 1B 5B 41 [2/4/2010 9:47:38] << 73 1B 5B 30 3B 32 32 3B 32 1B 5B 36 3B 33 30 48 45 53 74 61 74 73 1B 5B 30 3B 32 34 6D 1B 5B 35 3B 6E 65 74 20 50 6F 72 74 bytes 37 3B 74 68 3B 32 33 30 73 .[A 32 65 32 48 35 72 3B 45 3B 6E 37 74 32 65 3B 68 34 74 32 65 6D 20 35 72 [2/4/2010 9:47:38] >> 3 bytes 1B 5B 41 [2/4/2010 9:47:39] << 73 1B 5B 30 3B 32 32 3B 32 1B 5B 35 3B 33 30 48 45 50 6F 72 74 73 1B 5B 30 3B 32 34 6D 1B 5B 34 3B 69 73 74 72 61 74 69 6F bytes 37 3B 74 68 3B 32 33 30 6E [2/4/2010 9:47:39] << 71 1B 5B 30 3B 32 32 3B 32 1B 5B 34 3B 33 30 48 41 61 74 69 6F 6E 1B 5B 30 3B 32 34 6D 1B 5B 31 35 6E 6F 73 74 69 63 73 bytes 37 3B 64 6D 3B 32 3B 33 .[0;22;27;25;24m .[6;30HEthernet Stats.[0;22;7;25 ;24m.[5;30HEther net Ports .[A 32 65 32 48 35 72 3B 41 3B 6E 37 64 32 65 3B 6D 34 74 32 69 6D 20 35 6E .[0;22;27;25;24m .[5;30HEthernet Ports.[0;22;7;25 ;24m.[4;30HAdmin istration 32 69 32 30 35 6E 3B 48 3B 69 37 44 32 73 3B 69 34 74 32 61 6D 72 35 67 .[0;22;27;25;24m .[4;30HAdministr ation.[0;22;7;25 ;24m.[15;30HDiag nostics [2/4/2010 9:47:39] >> 1 bytes 0D [2/4/2010 9:47:39] << 928 bytes 1B 5B 3F 32 35 6C 1B 5B 30 6D 1B 1B 5B 32 4B 1B 5B 33 3B 30 48 1B 34 3B 30 48 1B 5B 32 4B 1B 5B 35 32 4B 1B 5B 36 3B 30 48 1B 5B 32 30 48 1B 5B 32 4B 1B 5B 38 3B 30 1B 5B 39 3B 30 48 1B 5B 32 4B 1B 48 1B 5B 32 4B 1B 5B 31 31 3B 30 1B 5B 31 32 3B 30 48 1B 5B 32 4B 30 48 1B 5B 32 4B 1B 5B 31 34 3B 4B 1B 5B 31 35 3B 30 48 1B 5B 32 3B 30 48 1B 5B 32 4B 1B 5B 31 37 32 4B 1B 5B 31 38 3B 30 48 1B 5B 39 3B 30 48 1B 5B 32 4B 1B 5B 32 5B 32 4B 1B 5B 32 31 3B 30 48 1B 32 32 3B 30 48 1B 5B 32 4B 1B 5B 1B 5B 32 4B 1B 5B 32 34 3B 30 48 5B 30 3B 32 32 3B 37 3B 32 35 3B 34 3B 32 38 48 43 6F 6E 66 69 67 6C 61 72 6D 73 1B 5B 30 3B 32 32 35 3B 32 34 6D 1B 5B 35 3B 32 38 20 4C 61 74 63 68 65 64 20 41 6C 5B 30 3B 32 32 3B 32 37 3B 32 35 5B 36 3B 32 38 48 43 6C 65 61 72 68 65 64 20 41 6C 61 72 6D 73 1B 3B 32 37 3B 32 35 3B 32 34 6D 1B Sample Trace File egation.[0;22;7; 25;24m.[6;30HEth ernet Stats . 5B 5B 3B 4B 48 5B 48 1B 30 4B 3B 32 30 5B 32 1B 32 75 3B 48 61 3B 20 5B 5B 32 32 30 1B 1B 31 1B 5B 48 1B 30 4B 3B 32 33 5B 34 72 32 56 72 32 4C 30 37 3B 4B 48 5B 5B 30 5B 31 1B 5B 48 1B 30 4B 3B 32 6D 65 37 69 6D 34 61 3B 3B 30 1B 1B 37 32 3B 32 33 5B 31 1B 5B 48 1B 30 4B 1B 20 3B 65 73 6D 74 32 32 48 5B 5B 3B 4B 30 4B 3B 32 36 5B 31 1B 5B 48 1B 5B 41 32 77 1B 1B 63 32 38 .[?25l.[0m.[2;0H .[2K.[3;0H.[2K.[ 4;0H.[2K.[5;0H.[ 2K.[6;0H.[2K.[7; 0H.[2K.[8;0H.[2K .[9;0H.[2K.[10;0 H.[2K.[11;0H.[2K .[12;0H.[2K.[13; 0H.[2K.[14;0H.[2 K.[15;0H.[2K.[16 ;0H.[2K.[17;0H.[ 2K.[18;0H.[2K.[1 9;0H.[2K.[20;0H. [2K.[21;0H.[2K.[ 22;0H.[2K.[23;0H .[2K.[24;0H.[2K. [0;22;7;25;24m.[ 4;28HConfigure A larms.[0;22;27;2 5;24m.[5;28HView Latched Alarms. [0;22;27;25;24m. [6;28HClear Latc hed Alarms.[0;22 ;27;25;24m.[7;28 25 Chapter 3 RUGGEDCOM DIRECTOR Using RUGGEDCOM DIRECTOR 48 1B 1B 74 3B 65 63 34 72 6F 34 61 5B 5B 69 6D 30 1B 48 3B 3B 3B 3B 74 6D 31 37 3F 3B 48 32 32 48 26 56 5B 5B 65 32 77 73 6D 6F 6E 6D 63 30 31 63 1B 3B 5B 65 32 34 32 32 1B 20 3B 3B 32 32 44 32 3B 20 69 30 38 6D 35 20 1B 1B 64 1B 1B 74 3B 32 65 5B 32 30 6C 34 6D 37 37 5B 1B 30 32 35 37 69 3B 32 20 65 3B 3B 20 3B 43 5B 5B 75 5B 5B 6F 32 3B 1B 32 32 3B 70 6D 53 3B 3B 30 5B 48 35 6C 3B 61 32 37 20 77 32 32 4C 32 50 30 31 63 30 31 72 32 32 5B 34 3B 31 1B 20 2D 32 32 3B 30 1B 3B 50 32 67 37 3B 20 20 32 38 6F 34 55 3B 30 74 3B 31 79 3B 38 30 3B 32 3B 5B 1B 53 35 35 32 6D 5B 32 41 35 6E 3B 35 20 53 3B 48 67 6D 20 32 3B 20 32 3B 20 32 48 3B 31 37 32 30 5B 68 3B 3B 32 1B 32 34 53 3B 6F 35 3B 20 User Guide 79 32 43 1B 1B 44 32 32 49 32 32 44 37 52 31 48 3B 37 3B 30 65 32 34 3B 5B 4B 6D 53 32 73 3B 32 34 73 37 6C 5B 5B 69 3B 38 6E 3B 38 65 3B 65 3B 3C 32 3B 32 3B 6C 34 6D 32 30 1B 1B 30 34 74 32 34 20 74 3B 65 30 39 61 32 48 66 32 48 66 32 73 32 43 35 32 32 31 6C 6D 58 37 4B 5B 5B 31 6D 69 34 6D 41 65 32 61 3B 3B 67 37 56 6F 37 4C 61 35 65 37 54 3B 35 3B 3B 1B 20 2D 3B 1B 30 31 1B 1B 63 6D 1B 4C 6D 35 72 32 32 6E 3B 69 72 3B 6F 75 3B 74 3B 52 32 3B 32 32 5B 1B 4C 32 5B 3B 3B 5B 5B 73 1B 5B 41 20 3B 20 32 38 6F 32 65 6D 32 61 6C 32 20 32 4C 34 34 37 37 30 5B 6F 35 30 32 31 30 31 1B 5B 31 52 4C 32 53 3B 48 73 35 77 61 35 64 74 34 44 35 3E 6D 6D 3B 3B 3B 30 67 3B 6D 32 48 3B 3B 5B 30 3B 4D 6F 34 79 32 56 74 3B 20 74 3B 20 73 6D 65 3B 1B 20 5A 32 32 32 3B 6F 32 1B 3B 1B 32 33 30 3B 36 53 67 6D 73 37 69 69 32 50 69 32 46 1B 1B 76 34 5B 20 2D 35 35 32 31 75 34 5B 32 5B 32 34 3B 32 35 21 HView System Log .[0;22;27;25;24m .[8;28HClear Sys tem Log.[0;22;27 ;25;24m.[9;28HVi ew CPU Diagnosti cs.[0;22;27;25;2 4m.[10;28HView P roduct Informati on.[0;22;27;25;2 4m.[11;28HLoad F actory Defaults. [0;22;27;25;24m. [12;28HReset Dev ice.[0;1;27;25;4 m.[24;1H<CTRL>.[ 0;22;27;25;24m .[0;1;27;25;4mZHelp.[0;22;27;25 ;24m .[0;1;27;25 ;4mS-Shell.[0;22 ;27;25;24m .[0;1 ;27;25;4mX-Logou t.[0;22;27;25;24 m .[0m.[0K.[0m.[ 1;0H.[2K.[0;22;2 7;25;24m.[1;1H.[ ?25lPASS01.[0;22 ;27;25;24m.[1;34 HDiagnostics.[0; 22;27;5;24m.[0;2 2;27;5;24m.[1;65 H 4 ALARMS! Sample Trace File RUGGEDCOM DIRECTOR User Guide Chapter 4 Theory of Operation Theory of Operation This section describes the operation of RUGGEDCOM DIRECTOR from a network perspective. CONTENTS * Section 4.1, "Principles of Operation" * Section 4.2, "Serial Control Signals" Section 4.1 Principles of Operation RUGGEDCOM DIRECTOR is capable of creating up to 128 virtual serial ports connected to ports on RUGGEDCOM server devices. Applications on the same system as RUGGEDCOM DIRECTOR can use these virtual ports as though they were physical serial ports. No special configuration or modification is necessary to existing applications. For each virtual serial port connection, RUGGEDCOM DIRECTOR monitors data transmitted via the port by connected applications, and either encapsulates them in either UDP datagrams, or transmits them in a TCP stream, depending on the connection method specified at configuration time. The encapsulated data is received by the RUGGEDCOM server at the other end of the TCP/IP or UDP/IP network connection, and transmitted via its configured physical serial port. The connection is bidirectional. Serial traffic originating at a serial device is received by the RUGGEDCOM server, transmitted via TCP or UDP to RUGGEDCOM DIRECTOR, and forwarded to the serial application. Figure 16: Principles Of Operation Principles of Operation 27 Chapter 4 RUGGEDCOM DIRECTOR Theory of Operation User Guide Section 4.2 Serial Control Signals RUGGEDCOM DIRECTOR will only support control signals locally (i.e. between RUGGEDCOM DIRECTOR and connected applications). Only serial data is forwarded across the network. The full set of signals that RUGGEDCOM DIRECTOR presents to an application connecting to one of its virtual serial ports is listed below: Parameter Description Transmitted Data (TxD) Binary data sent from the PC to the serial device. Received Data (RxD) Binary data received by the PC from the serial device. Request To Send (RTS) The serial application asserts the RTS signal in order to signal that it wishes to transmit data. Clear To Send (CTS) When a serial device (in this case, RUGGEDCOM DIRECTOR) receives an RTS signal, it in turn asserts CTS back to the application, indicating that data can be transmitted. RUGGEDCOM DIRECTOR does this unconditionally. Data Terminal Ready (DTR) Asserted by the PC to indicate that it is ready to be connected. Data Set Ready (DSR) Asserted by a serial device (in this case, RUGGEDCOM DIRECTOR) to indicate that it is powered on and is ready to receive data from the PC. RTS, CTS, DTR, DSR signals are only simulated locally between serial applications and RUGGEDCOM DIRECTOR. These control signals will not be transmitted in either direction over the network. The figure below illustrates the serial signals. Figure 17: Serial Signals 28 Serial Control Signals