Digi Connect® Family and ConnectPort™ TS Family User’s Guide Digi Connect Family Products: Digi Connect SP Digi Connect Wi-SP Digi Connect ME Digi Connect ME 4 MB Digi Connect Wi-ME Digi Connect EM Digi Connect Wi-EM Digi Connect ES 4/8 SB Digi Connect ES 4/8 SB with Switch Digi ConnectPort TS Products: ConnectPort TS 4x4 ConnectPort TS 4x2 ConnectPort TS W ConnectPort TS 8 ConnectPort TS 8 MEI ConnectPort TS 16 90000565_L
©Digi International Inc. 2010. All Rights Reserved. The Digi logo, Digi Connect, iDigi, ConnectPort, Digi SureLink, Digi Dialserv NetSilicon, NET+Works, NET+OS, NET+, are trademarks or registered trademarks of Digi International, Inc. All other trademarks mentioned in this document are the property of their respective owners. Information in this document is subject to change without notice and does not represent a commitment on the part of Digi International.
Contents Contents........................................................................................................................................................................................3 About this guide...........................................................................................................................................................................7 Purpose ................................................................................................................
Configuration interfaces ..........................................................................................................................................31 Monitoring capabilities and interfaces ....................................................................................................................40 Device administration .............................................................................................................................................
Configuration through the Java applet interface .............................................................................................................126 Accessing the Java applet interface.......................................................................................................................126 Differences between web and Java applet interfaces ............................................................................................126 System requirements ..........................
Enable/disable access to network services ............................................................................................................161 Administration from the command-line interface ...........................................................................................................162 Chapter 6: Latency Tuning ..................................................................................................................................................163 What is Latency? .......
About this guide Purpose This guide describes and shows how to configure, monitor, and administer Digi devices. Audience This guide is intended for those responsible for setting up Digi devices. It assumes some familiarity with networking concepts and protocols. A glossary is provided with definitions for networking terms and features discussed in the content. Scope This guide focuses on configuration, monitoring, and administration of Digi devices.
Integration documentation: For customers who purchase the Digi Connect Integration Kit for product customization, the Integration Kit includes such resources as development board schematics for module products, firmware release notes, hardware reference manuals, specifications, and documentation for the sample applications.
Introduction Introduction C H A P T E R 1 This chapter introduces Digi devices and their product families, types of connections and data paths in which Digi devices can be used, and the interface options available for configuring, monitoring, and administering Digi devices. Important Safety Information To avoid contact with electrical current: Never install electrical wiring during an electrical storm.
Introduction The Digi Connect Family Digi Connect Family products include: Digi Connect SP™ The Digi Connect SP (Single Port) device server is the ideal platform for custom web- and network-enabled embedded applications. Combining Digi and NetSilicon technology, it eliminates the hardware design effort and delivers a true device networking solution that is powerful enough to meet future performance requirements.
Introduction Digi Connect Wi-ME™ The Digi Connect Wi-ME (Wireless Micro Embedded) is a fully customizable and secure 802.11b wireless device server. It is based on the common platform design approach of the Digi Connect family of embedded products, which minimizes design risk and reduces time to market by allowing customers to easily accommodate both wired and wireless network functionality in a single future-proof product design.
Introduction Digi Connect Wi-EM™ The Digi Connect Wi-EM (Wireless Embedded Module) device server is a fully customizable and secure 802.11b wireless embedded module that provides integration flexibility in a variety of connection options.
Introduction Digi ConnectPort™ TS products Digi ConnectPort TS (Terminal Server) products provide serial over Ethernet connectivity for applications today and into the future. They support IPv4 and IPv6 Ethernet protocols. The Digi ConnectPort TS 8 MEI product is the same size as the Digi ConnectPort TS 8 (RS-232 only) and is the smallest 8-port device with a Multiple Electrical Interface (MEI) in the industry.
Introduction Features This is an overview of key features in Digi devices. Software features are covered in more detail in the next three chapters. Hardware specifications and are covered in Chapter 7, "Specifications and certifications". User interfaces There are several user interfaces for configuring and monitoring Digi devices, including the following. Some of these user interfaces can be customized.
Introduction Quick reference for configuring features This guide primarily focuses on configuring, monitoring, and administering Digi devices from the web interface. This table provides a quick reference for configuring features and performing device tasks, and where to find the features and settings in the web interface and this guide. Click the page number in the Page column to jump to instructions on configuring or using the feature. Some features are configurable from the command line interface only.
Introduction Feature/task Path to feature in the web interface See page Connection management: Management > Serial Ports 145 Management > Connections > Active System Connections 145 Configuration > Network > Advanced Network Settings 82 Ekahau Client™ device-location software Applications > Ekahau Client 120 Ethernet settings Configuration > Network > Advanced Network Settings 82 General Purpose Input/Output (GPIO) pins Configuration > GPIO 93 Event logging for the Digi device Management
Introduction Feature/task Path to feature in the web interface See page Multiple Electrical Interface (MEI) Currently available in ConnectPort TS models only, and configurable from command line only. See the set switches command in the Connect Family Command Reference.
Introduction Feature/task Path to feature in the web interface See page Security/access control features: Control access to inbound ports Enable/disable command-line access Secure Shell Server (SSH) Establish/change user name for a user Issue a new/changed password to a user Set permissions associated with various services and commands Configuration > Serial Ports > port > Port Profile Settings > TCP Sockets or UDP Sockets or Custom port profile 84 Configuration > Serial P
Introduction Feature/task Path to feature in the web interface See page Simple Network Management Protocol (SNMP): Configure SNMP through the web interface Configuration > System > Simple Network Management Protocol (SNMP) Settings 102 Enable/disable SNMP service Configuration > Network > Network Services 74 Enable/disable SNMP alarm Configuration > Alarms > alarm > Send SNMP trap to following destination when alarm occurs 97, 98 Use Basic network and serial settings configurabl
Introduction Hardware features A summary of hardware features, including power-supply information, is in "Hardware specifications" on page 169. For detailed hardware specifications, see the Hardware Reference and data sheet for your Digi Connect product. Network interface features A detailed list of network interface features is in Chapter 7, "Specifications and certifications". See also the data sheet for your Digi product.
Introduction IP protocol support All Digi devices include a Robust on-board TCP/IP stack with a built-in web server.
Introduction Serial data communication over TCP and UDP Digi devices support serial data communication over TCP and UDP. Key features include: Serial data communication over TCP, also known as autoconnect and tcpserial can automatically perform the following functions: – Establish bidirectional TCP connections, known as autoconnections, between the serial device and a server or other network device. Autoconnections can be made based on data and or serial hardware signals.
Introduction Simple Network Management Protocol (SNMP) Simple Network Management Protocol (SNMP) is a protocol for managing and monitoring network devices. SNMP architecture enables a network administrator to manage nodes--servers, workstations, routers, switches, hubs, etc.--on an IP network; manage network performance, find and solve network problems, and plan for network growth. Digi devices support SNMP Versions 1 and 2.
Introduction Point-to-Point Protocol (PPP) The Point-to-Point Protocol (PPP) transports multi-protocol packets over point-to-point links. PPP encapsulates the data packet, allows the server to inform the dial-up client of its IP address (or client to request the IP address), authenticates the exchange, negotiates multiple protocols, and reassembles the data packet for network communication.
Introduction RealPort software Digi devices use the patented RealPort COM/TTY port redirection for Microsoft Windows, UNIX, and Linux environments. RealPort software provides a virtual connection to serial devices, no matter where they reside on the network. The software is installed directly on the host PC and allows applications to talk to devices across a network as though the devices were directly attached to the host. Actually, the devices are connected to a Digi device somewhere on the network.
Introduction Security features in Digi devices Secure access and authentication One password, one permission level. Passwords can be issued to device users. Selective enabling/disabling network services such as ADDP, RealPort, Encrypted RealPort, HTTP/HTTPS, LPD, Remote Login, Remote Shell, SNMP, and Telnet. Can control access to inbound ports. Can control access to specific devices, IP addresses, or networks through IP filtering.
Introduction Configuration management Once a Digi device is configured and running, configuration-management tasks need to be periodically performed, such as: Upgrading firmware Copying configurations to and from a remote host Software and factory resets Rebooting the device Memory management File management For more information on these configuration-management tasks, see Chapter 5, "Digi device administration".
Introduction Supported connections and data paths in Digi devices Digi devices allow for several kinds of connections and paths for data flow between the Digi device and other entities. These connections can be grouped into two main categories: Network services, in which a remote entity initiates a connection to a Digi device. Network/serial clients, in which a Digi device initiates a network connection or opens a serial port for communication.
Introduction Network services associated with serial ports in general RealPort: A single TCP connection manages (potentially) multiple serial ports. Modem emulation, also known as pseudo-modem (pool): A TCP connection to the “pool” port is interpreted as an incoming call to an available pseudo-modem in the “pool” of available port numbers.
Introduction Network/serial clients A network/serial client connection is one in which a Digi device initiates a network connection or opens a serial port for communication.
Introduction Interfaces for configuring, monitoring, and administering Digi devices There are several interfaces for configuring, monitoring, and administering Digi devices. These interfaces are covered in more detail later in this guide. Configuration capabilities Device configuration involves setting values and enabling features for such areas as: Network configuration: Specifying the device’s IP address settings, network-service settings, and advanced network settings.
Introduction The Digi Device Setup wizard The Digi Device Setup Wizard is a wizard for quick initial configuration of Digi devices. It is available from the Digi Support site and also provided on the Software and Documentation CD shipped with each product. It assigns an IP address for the device, configures the device’s serial port parameters based on a selected configuration scenario called a port profile, and determines whether RealPort software needs to be installed.
Introduction Digi Device Discovery utility The Digi Device Discovery utility locates Digi devices on a network and allows for opening the web interface for discovered devices, configuring network settings, and rebooting the device.
Introduction iDigi™ Platform interface The iDigi Platform provides remote network management of all connected hardware. In contrast to the one-user-to-one device model of other Digi device interfaces, the iDigi Platform uses a oneuser-to-many-devices interface model. By providing a central point of access to remote devices or groups of devices, the iDigi Platform makes it easier for you to manage many devices.
Introduction Web interface A web interface is provided as an easy way to configure and monitor Digi devices. Configurable features are grouped into several categories. These categories vary by product; examples include Network, Serial Port, GPIO (for all products except Digi Connect SP, Digi Connect Wi-SP), Alarms, System, Remote Management, UsersSecurity. Most of the configurable features are arranged by most basic settings on a page, with associated and advanced settings accessible from that page.
Introduction Java applet interface An alternative configuration interface is provided with Digi Connect Family products, in the form of a Java applet. This interface provides many, but not all, of the configuration choices available through the web interface. The Java applet is primarily intended as a sample alternative interface for embedded products. Embedded product manufacturers can use the applet as a base for their custom user interface.
Introduction The Java applet interface is a completely customizable interface. For example, the web interface can be changed by replacing the Digi logo with your company logo or changing the colors used in the interface workspace. The Java applet can also be used as a basis for further interface development. That is, if the Java applet is adequate for most configuration needs, but needs some modifications, the applet’s operation can be customized.
Introduction Command-line interface Digi devices can be configured by issuing commands from the command line. The command-line interface allows communication directly without a graphical interface. To access the command line from the Digi Device Discovery utility, click Telnet to command line.
Introduction Simple Network Management Protocol (SNMP) Simple Network Management Protocol (SNMP) is a protocol for managing and monitoring network devices. The SNMP architecture enables a network administrator to manage nodes-servers, workstations, routers, switches, hubs, etc.--on an IP network; manage network performance, find and solve network problems, and plan for network growth. Digi devices support SNMP Versions 1 and 2. SNMP is easy to implement in extensive networks.
Introduction Monitoring capabilities and interfaces Monitoring Digi devices includes such tasks as checking device status, viewing information on a device’s GPIO pins, checking runtime state, viewing serial port operations, and reviewing network statistics, and managing their connections. There are several interfaces for monitoring Digi devices and managing their connections.
Introduction Device administration Periodically, administrative tasks need to be performed on Digi devices, such as uploading and managing files, changing the password for logging onto the device, backing up and restoring device configurations, updating firmware, restoring the configuration to factory defaults, and rebooting. As with configuration and monitoring, administration can be done from a number of interfaces, including the web interface, command line, and the iDigi Platform.
Hardware installation Hardware installation C H A P T E R 2 This section details requirements and recommendations for installing ConnectPort TS Family products. For the Digi Connect ES, see the Hardware Setup Guide. For all other Digi Connect Family products, see their Hardware Reference Manuals for hardware-installation details.
Hardware installation Rack mounting (ConnectPort TS 16 only) ConnectPort TS 16 models can be optionally mounted to a rack, available separately. Installation 1 Attach enclosed bracket ears to rack as shown in illustration. Rack shown in illustration is not included with Digi device. 2 Follow safety and installation considerations when placing the Digi device on the rack.
Hardware installation Safety and installation considerations Physical location and spacing Install equipment in Restricted Access Areas only (dedicated equipment rooms/closets) in accordance with Articles 110-16, 110-17, and 110-18 of the National Electrical Code, ANSI/NFPA 70. To ensure proper ventilation and air flow for units, provide at least 12 inches (30 centimeters) of clearance on all sides for each unit. Distribute weight evenly in the rack to avoid overloading.
Configure Digi devices Configure Digi devices C H A P T E R 3 This chapter describes how to configure a Digi device. It covers these topics: "Default IP address and methods for assigning an IP address" on page 46 "Configuration through the iDigi Platform" on page 50 "Configuration through the Digi Device Setup Wizard" on page 56.
Configure Digi devices Default IP address and methods for assigning an IP address All products that have a cellular (WAN) interface ship with static IP address for the Ethernet port of 192.168.1.1 and DHCP server enabled by default. The Ethernet port of the laptop should be configured to automatically receive an IP address and DNS server address. All products that only have an Ethernet or Wi-Fi (LAN) interface ship with DHCP client enabled by default.
Configure Digi devices Assign an IP address using the Digi Device Setup Wizard The Digi Device Setup Wizard is included on the Software and Documentation CD for your product. Using this wizard is the easiest way to assign an IP address and initially configure Digi devices. It discovers Digi devices on a network, configures an IP address for a Digi device, and configures basic serial port parameters according to how the device will be used.
Configure Digi devices Configure an IP address using DHCP An IP address can also be configured using Dynamic Host Configuration Protocol (DHCP). DHCP is an Internet protocol for automating the configuration of computers that use TCP/IP. DHCP can be used to automatically assign IP addresses and deliver TCP/IP stack configuration parameters. As mentioned previously, all products that have a cellular (WAN) interface ship with static IP address for the Ethernet port of 192.168.1.
Configure Digi devices Configure an IP address from the command-line interface The set network command configures an IP address from the command line. Include the following parameters: ip=device ip: The IP address for the device. gateway=gateway: The network gateway IP address. submask=device submask: The device subnet mask. dhcp=off: Turns off use of the Dynamic Host Configuration Protocol (DHCP), so that the IP address assigned is permanent.
Configure Digi devices Configuration through the iDigi Platform The iDigi Platform is an on-demand service. After creating an iDigi account, you can connect to the iDigi Platform. There are no infrastructure requirements. Remote devices and enterprise business applications connect to the iDigi Platform via standards-based Web Services. Create an Account on iDigi.com To get started using iDigi, set up an account on the iDigi Platform. 1 Navigate to http://www.idigi.com.
Configure Digi devices Add the Digi device to the idigi.com Device List To add your Digi device to the device list, follow these steps: 1 Log into the iDigi.com user portal using the username and password you just created. The iDigi Platform interface is displayed. 2 In the Devices list, Click the button on the toolbar to display the Add Devices dialog. Locate and select your device from the list of locally discovered devices and click the OK button.
Configure Digi devices Note If the device is not locally accessible or cannot be automatically discovered, you can still add it by clicking the Add Manually button and enter the MAC address found on the bottom of the device. If you manually add your device however, you must also configure the device to connect to the iDigi Connectivity Server. See “Manually configure a Digi device to connect to the iDigi Platform” on page 109.
Configure Digi devices iDigi Platform views for configuring and managing Digi devices The iDigi Platform has several views for configuring and managing network devices. Device list The iDigi device list displays all the devices in your network. This view allows for viewing and accessing devices regardless of their physical location, even devices behind firewalls.
Configure Digi devices Device operations menu In the device list, right-clicking on a selected device displays the device operations menu for performing key device-management tasks, such as file management, restoring the device to factory defaults, updating firmware, and displaying device properties. The image shows the operations menu and the operations available under Administration and Firmware.
Configure Digi devices Device properties view Selecting Properties from the device operations menu displays a system summary of the selected device, and a menu of configuration settings, similar to the menu on the home page of the web interface for a Digi device. For more information on iDigi Platform To learn more about the iDigi Platform and the services it provides, see the iDigi Device Management and Web Services Tutorial.
Configure Digi devices Configuration through the Digi Device Setup Wizard The Digi Device Setup Wizard configures Digi devices according to one of several port profiles, or configuration scenarios that characterize the manner in which the Digi device will be used. Depending on the Digi device, the wizard configures several other features. To run the wizard, insert the Software & Documentation CD packaged with your Digi device in your computer’s CD/DVD drive. The first screen of the wizard is displayed.
Configure Digi devices Verify configuration settings On the Verify Configuration screen, clicking Next shows the configuration settings that will be uploaded to the Digi device. Save settings The Save Settings page is displayed while the configuration settings are uploaded to the Digi device. Other messages and wizards may be displayed during this step; click OK on message boxes and Next on wizard screens to continue the installation process.
Configure Digi devices Configuration through the web interface Open the web interface To open the web interface, either enter the Digi device’s URL in a web browser and log on to the device, if required, or use the Digi Device Discovery utility to locate it and open its web interface. By entering the Digi device’s IP address in a web browser 1 In the URL address bar of a web browser, enter the IP address of the device.
Configure Digi devices If using the Software and Documentation CD, follow these steps: 1 On the main page Software and Documentation CD, click software - install optional software. 2 Select Device Discovery Utility and click Install. 3 Follow the prompts of the Setup Wizard to install the Digi Device Discovery Utility software. Discover devices From the start menu, select Start > Programs > Digi Connect > Digi Device Discovery. The Digi Device Discovery application is displayed.
Configure Digi devices Organization of the web interface The Home page When the web interface is opened, the Home page is displayed. Here is the Home page for Digi Connect ME: And here is the Home page for a Digi Connect Wi-ME. Note the additional Application menu item.
Configure Digi devices The left side of the Home page has a menu of choices that display pages for configuration, management, and administration tasks, and to log out of the web interface. This chapter focuses on the choices under Configuration and Applications. For details on monitoring Digi devices and the choices under Management, see Chapter 4, "Monitor and manage Digi devices". For details on the tasks under Administration, see Chapter 5, "Digi device administration".
Configure Digi devices Apply and save changes The web interface runs locally on the device, which means that the interface always maintains and displays the latest settings in the Digi device. On each screen, the Apply button is used to save any changes to the configuration settings to the Digi device. Cancel changes To cancel changes to configuration settings, click the Refresh or Reload button on the web browser. This causes the browser to reload the page.
Configure Digi devices Change the IP address from the web interface, as needed Normally, IP addresses are assigned to Digi devices either through DHCP or the Digi Device Setup Wizard. This procedure assumes that the Digi device already has an IP address and you simply want to change it. 1 Open a web browser and enter the Digi device’s current IP address in the URL address bar. 2 If security is enabled for the Digi device, a login prompt is displayed. Enter the user name and password for the device.
Configure Digi devices Network configuration settings The Network configuration pages include: Ethernet IP settings: For viewing IP address settings and changing as needed. See page 66. WiFi IP settings: For setting the IP address used for wireless LAN communication. See page 70. WiFi LAN settings: For setting basic options for wireless LAN devices such as network name and network connection options. See page 70.
Configure Digi devices Alternatives for configuring network communications There are three ways a Digi device can be configured on the network. Using dynamic settings: All network settings will be assigned automatically by the network, using a protocol called DHCP. Contact your network administrator to find out if a DHCP server is available. Using static settings: All network settings are set manually and will not change. The IP address and subnet mask are mandatory.
Configure Digi devices Ethernet IP settings or Ethernet Switch IP Settings Ethernet Uplink IP Settings (for Digi Connect ES 4/8 SB with Switch) The Ethernet IP Settings page configure how the IP address of the Digi device is obtained, either by DHCP or by using a static IP address, subnet mask, and default gateway. For more information about how these settings are assigned and used in your organization, contact your network administrator.
Configure Digi devices Ethernet IP Settings (for Digi Connect ES 4/8 SB with Switch only) This section describes configuring and deploying Digi Connect ES4/8 SB with Switch devices in a network. The Digi Connect ES4/8 SB with Switch has two Ethernet interfaces: Ethernet Uplink: An uplink interface, that connects to the central data management system network. The uplink interface provides a single Internet Protocol (IP) address for all communication to and from the devices at a single location.
Configure Digi devices Assuming the network topology just described, here are the steps for configuring the Ethernet interfaces of each Digi Connect ES 4/8 SB with Switch device for installation. These steps apply to a single Digi Connect ES 4/8 SB with Switch and its connected Ethernet and serial devices, and must be performed for each Digi Connect ES 4/8 SB with Switch deployed. 1 Connect a laptop to one of the Ethernet Switch ports on the Digi Connect ES 4/ 8 SB with Switch and open the web interface.
Configure Digi devices Deploy the Digi Connect ES 4/8 SB with Switch To deploy the Digi Connect ES 4/8 SB with Switch after network configuration: 1 Install the Digi Connect ES 4/8 SB with Switch in the desired location. 2 Connect the Digi Connect ES 4/8 SB with Switch to the main/business Ethernet network through the Ethernet Uplink connection, using a straight-through Ethernet cable. 3 Connect the network devices to the Ethernet Switch ports, using straight-through Ethernet cables.
Configure Digi devices WiFi IP settings The WiFi IP settings configure how the IP address of a Wi-Fi-enabled Digi device is obtained. It has the same settings as the Ethernet IP settings page. WiFi LAN settings Digi devices with Wi-Fi (wireless LAN) capability contain a wireless network interface that may be used to communicate to wireless networks using 802.11b8 technology.
Configure Digi devices WiFi security settings The WiFi security settings specify the wireless security settings that the wireless network uses. Multiple security and authentication modes may be chosen depending on the configuration of the access point or wireless network. The wireless device will automatically select and determine the authentication and encryption methods to use while associating to the wireless network.
Configure Digi devices Data Encryption: Multiple encryption methods can be selected. – Use any available encryption method: enables all of the methods. The actual method used will be determined by the capabilities of the wireless network. – Use the following selected method(s): Selects one or more encryption methods. Open System: No encryption is used over the wireless link. Open System encryption is valid only with Open System and Shared Key authentication.
Configure Digi devices WiFi 802.1x authentication settings These settings are not required based on the current Wi-Fi authentication settings. They are only configurable when WEP with 802.1x authentication or WPA with 802.1x authentication are enabled on the WiFi Security Settings tab. EAP Methods: These are the types of Extensible Authentication Protocols (EAP) or outer protocols that are allowed to establish the initial connection with an authentication server or access point.
Configure Digi devices Network services settings The Network Services page shows a set of common network services that are available for Digi devices, and the network port on which the service is running. Common network services can be enabled and disabled, and the TCP port on which the network service listens can be configured. Disabling services may be done for security purposes. That is, certain services can be disabled so the device runs only those services specifically needed.
Configure Digi devices The table shows network services, services provided, and the default network port number for each service. Service Services provided Default network port number Device Discovery, also known as Advanced Digi Discovery Protocol (ADDP) Discovery of Digi devices on a network. Disabling this service disables use of the Digi Device Discovery utility to locate the device, either on its own or as part of running the Digi Device Setup Wizard.
Configure Digi devices Service Services provided Default network port number Telnet Server Allows users an interactive Telnet session to the Digi device’s command-line interface. If disabled, users cannot Telnet to the device. 23 Telnet Passthrough Allows a Telnet connection directly to the serial port, often referred to as reverse Telnet. 2001 Transmission Control Protocol (TCP) Echo Used for testing the ability to send and receive over a TCP connection, similar to a ping.
Configure Digi devices IP filtering settings You can better restrict your device on the network by only allowing certain devices or networks to connect. This is better known as IP Filtering or Access Control Lists (ACL). By enabling IP filtering, you are telling the device to only accept connections from specific and known IP addresses or networks.
Configure Digi devices IP forwarding settings When a Digi device acts as a router and communicates on both a private and public network with different interfaces, it is sometimes necessary to forward certain connections to other devices. This is also known as Network Address Translation (NAT) or Port Forwarding. When an incoming connection is made to the device on the private network, the IP port is searched for in the table of port forwarding entries.
Configure Digi devices – Enable DMZ Forwarding to this IP address: DMZ Forwarding allows you to specify a single host (DMZ Server) on the private (internal) network that is available to anyone with access to the NAT Public Interface IP address, for any TCP- and UDP-based services that haven't been configured. Services enabled directly on the Digi device take precedence over (are not overridden by) DMZ Forwarding.
Configure Digi devices – Forward TCP/UDP/FTP connections from external networks to the following internal devices: Specifies a list of connections based on a specific IP port and where those connections should be forwarded to. Typically the connecting devices come from the public side of the network and are redirected to a device on the private side of the network. It is possible to forward a single port or a range of ports.
Configure Digi devices Socket tunnel settings A Socket Tunnel can be used to connect two network devices: one on the Digi device’s local network and the other on the remote network. This is especially useful for providing SSL data protection when the local devices do not support the SSL protocol. One of the endpoint devices is configured to initiate the socket tunnel. The tunnel is initiated when that device opens a TCP socket to the Digi device device on the configured port number.
Configure Digi devices Advanced network settings The Advanced Network Settings are used to further define the network interface. These settings rarely need to be changed. Contact your network administrator for more information about these settings. IP Settings These settings are used to fine-tune IP address settings. Host Name: The host name to be placed in the DHCP Option 12 field. This is an optional setting which is only used when DHCP is enabled.
Configure Digi devices Ethernet Interface Speed: The Ethernet speed the Digi device uses on the Ethernet network. – 10: The device operates at 10 megabits per second (Mbps) only. – 100: The device operates at 100 Mbps only. – auto: The device senses the Ethernet speed of the network and adjusts automatically. The default is auto. If one side of the Ethernet connection is using auto (negotiating), the other side can set the Ethernet speed to whatever value is desired.
Configure Digi devices Serial port settings Use the Serial Port Configuration page to establish a port profile for the serial port of the Digi device. The Serial Port Configuration page includes the currently selected port profile for the serial port, detailed configuration settings for the serial port, dependent on the port profile selected, and links to basic and advanced serial settings.
Configure Digi devices RealPort profile The RealPort profile maps a COM or TTY port to a serial port. This profile configures a Digi device to create a virtual COM port on a PC, known as COM Port Redirection. The PC applications send data to this virtual COM port and RealPort sends the data across the network to the Digi device. Data is routed to the serial device connected to the Digi device’s serial port. The network is transparent to both the application and the serial device.
Configure Digi devices TCP Sockets profile The TCP Sockets profile allows serial devices to communicate over a TCP network. The TCP Server allows other network devices to initiate a TCP connection to the serial device attached to the serial port of the Digi device. Automatic TCP connections (autoconnection) The TCP Client allows the Digi device to automatically establish a TCP connection to an application or a network, known as autoconnection.
Configure Digi devices UDP Sockets profile The UDP Sockets profile allows serial devices to communicate using UDP. The UDP Server configuration allows the serial port to receive data from one or more systems or devices on the network. The UDP Client configuration allows the automatic distribution of serial data from one host to many devices at the same time using UDP sockets. The port numbering conventions shown in the TCP Sockets Profile also apply to UDP sockets.
Configure Digi devices Local Configuration profile The Local Configuration profile allows for connecting standard terminals or terminal emulation programs to the serial port in order to use the serial port as a console to access the command line interface. Profile settings enable and disable access to the command line.
Configure Digi devices Custom Profile The Custom port profile displays all serial-port settings, which can be changed as needed. Use the Custom profile only if the use of the serial port does not fit into any of the predefined port profiles, for example, if network connections involve a mix of TCP and UDP sockets. Basic serial settings After selecting a port profile, the profile settings are displayed. Choose the appropriate features for your environment.
Configure Digi devices Advanced serial settings The advanced serial settings further define the serial interface, including whether port buffering (also known as port logging), RTS Toggle, and RCI over Serial are enabled as general serial interface options. You can also define how specific aspects of TCP and UDP serial communications should operate, including timeouts and whether a socket ID is sent.
Configure Digi devices TCP settings The TCP Settings are displayed only when the current serial port is configured with the TCP Sockets or the Custom Profile. The settings are as follows: Send Socket ID: Include an optional identifier string with the data sent over the network. The Socket ID can be 1 to 256 ASCII characters.
Configure Digi devices Close connection after the following number of idle seconds: Enable to close an idle connection. Use the Timeout field to enter the number of seconds that the connection will be idle before it is closed. This can be 1 to 65000 seconds. Close connection when DCD goes low: When selected, the connection will be closed when the DCD (Data Carrier Detected) signal goes low.
Configure Digi devices GPIO pins All Digi Connect Family devices except Digi Connect SP and Digi Connect Wi-SP have several General Purpose IO (GPIO) pins. In normal operation, GPIO pins are used for the serial signals CTS, DCD, DSR, DTR, and RTS. On Digi Connect EM and Wi-EM, both sets of RXD/TXD signals are also configured. These GPIO pins can be used for either standard serial communication signalling or a user-defined purpose, such as when a significant event occurs in the device.
Configure Digi devices Additional implementation required for input and output choices Changing the GPIO pin settings from Serial to Input or Output means you are responsible for implementing how the pins and signals will work, including developing any applications, signalhandling, and hardware.
Configure Digi devices Alarms The Alarms page is for configuring device alarms and displaying alarm settings. Device alarms are used to send email messages or SNMP traps when certain device events occur. These events include changes in GPIO signals, certain data patterns being detected in the data stream Alarm notification settings On the Alarms page, the Alarm Notification Settings control the following: Enable alarm notifications: Enables or disables all alarm processing for the Digi Connect device.
Configure Digi devices Alarm conditions The Alarm Conditions part of the Alarms page shows a list of all of the alarms. Up to 32 alarms can be configured for a Digi device, and they can be enabled and disabled individually. Alarm list and status The alarm list displays the current status of each alarm. This list can be used to list to view alarm status at a glance, then view more details for each alarm as needed. Enable: Checkbox indicates whether the alarm is currently enabled or disabled.
Configure Digi devices Alarm configuration To configure an alarm, click on it. The configuration page for individual alarms has two sections. Alarm conditions For specifying the conditions on which the alarm is based, such as GPIO pin state changes, serial data pattern matching, signal strength (RSSI), or data usage. Alarm conditions include: Send alarms based on GPIO pin states: Click this radio button to specify that this alarm is sent when the specified GPIO pin states are detected.
Configure Digi devices Alarm destinations The Alarm Destination part of the page defines how alarm notifications are sent, either as an email message or an SNMP trap, or both, and where the alarm notification is sent. Send E-mail to the following recipients when alarm occurs: Select the checkbox to specify that the alarm should be sent as an email message. Then specify the following information: – To: The email address to which this alarm notification email message will be sent.
Configure Digi devices System settings The System Configuration page configures device identity and description information, date and time settings, and settings for Simple Network Management Protocol (SNMP). Device identity settings The device identity settings create a description of the Digi device’s name, contact, and location. This information can be useful for identifying a specific Digi device when working with a large number of devices in multiple locations.
Configure Digi devices Date and Time settings The Date and Time settings set the Coordinated Universal Time (UTC) and/or system time and date on a device, or sets the offset from UTC for the device's system time. Set Date and Time Click the Set button to configure the hours, minutes, seconds, month, day, and year on the device. If offset is set to 00:00, the device's system time and UTC are the same.
Configure Digi devices Time Source Settings The time source settings configure access to up to five external time sources that can be used to set and maintain time on the device. Type: Specifies the type of time source for this entry. – sntp server: The device uses its SNTP client to poll the NTP/SNTP server, specified by the FQDN, for time. – cellular: The device polls the cellular service for time. Interval: Specifies the interval in seconds between polls of a time source.
Configure Digi devices Simple Network Management Protocol (SNMP) Simple Network Management Protocol (SNMP) is a protocol that can be used to manage and monitor network devices. Digi devices can be configured to use SNMP features, or SNMP can be disabled entirely for security reasons. To configure SNMP settings, click the Simple Network Management Protocol link at the bottom of the System Configuration page.
Configure Digi devices Number Description Location Digi Login Traps MIB Indicates when users attempt to log into the device, and whether the attempt was successful. http://ftp1.digi.com/support/utilities/ Digi Part number 40002339_x.mib Digi Structures of Management (SMI) MIB Data structures for managing hosts and gateways on a network. http://ftp1.digi.com/support/utilities/ Digi Part number 40002195_x.mib Digi Connect Mobile Traps MIB A Digi enterprise MIB for sending alarms as SNMP traps.
Configure Digi devices SNMP Configuration settings: Enable Simple Network Management Protocol (SNMP): This checkbox enables or disables use of SNMP. – The Public community and Private community fields specify passwords required to get or set SNMP-managed objects. Changing public and private community names from their defaults is recommended to prevent unauthorized access to the device. Public community: The password required to get SNMP-managed objects. The default is public.
Configure Digi devices Remote management settings The Remote Management configuration page sets up the connection to the iDigi Platform remote management server so the Digi device knows how to connect to the server. The iDigi Platform allows devices to be configured and managed from remote locations. To use the iDigi Platform as a remote manager of a Digi device, follow the procedures that begin on page 50. There are two pages of remote management settings: Connections and Advanced settings.
Configure Digi devices A server-initiated connection works the opposite way. The remote management server opens a TCP connection, and the Digi device must be listening for the connection to the remote management server to occur. An advantage of server-initiated connections is that you are not charged for sending the keep-alive bytes that are used in client-initiated connections.
Configure Digi devices Advanced remote management settings The default settings for remote management usually work for most situations. These Advanced settings are used in advanced situations. They are used to configure the idle timeout for the connection between the Digi device and the remote management server, and the keep-alive settings of the various interfaces (TCP and HTTP for mobile and Ethernet network connections). These settings should only be changed when the defaults do not properly work.
Configure Digi devices – HTTP over Proxy Settings: The settings required to communicate over a proxy network using HTTP. These settings apply when Automatic or HTTP over Proxy connection methods are selected. Hostname: The name of the proxy host. TCP Port: The network port number for the TCP network service on the proxy host. Username: Password: The username and password for logging on to the proxy host.
Configure Digi devices Manually configure a Digi device to connect to the iDigi Platform To use iDigi Platform as a device manager for your Digi device, you need to manually configure the Digi device to connect to iDigi Platform. 1 Open the web interface for the Digi device and go to Configuration > Remote Management. 2 On the Remote Management settings page, enter the URL of the iDigi Platform connectivity server (for example, sd1-na.idigi.
Configure Digi devices User settings User settings involve several areas: User authentication: whether authentication is required for users accessing the Digi device, and the information required to access it.Depending on the Digi product, multiple users and their authentication information can be defined. User authentication settings are on the Users settings page. User access settings: the device interfaces that a user can access, such as the command line or web interface.
Configure Digi devices More-than-two-user model User definitions are exactly the same as the two-user model, with the addition of user groups and more users. The set group command defines user groups; see the Digi Connect Family Command Reference for command description. Currently, there is no web interface page for defining user groups. Special feature for Digi Connect ME only Digi Connect ME uses the two-user model, but the login prompt (password authentication) can be disabled.
Configure Digi devices Password authentication By default, Digi Connect Family devices have password authentication enabled. That means when a login prompt is displayed when accessing the device by opening the web interface or issuing a telnet command. Disable password authentication Password authentication can be disabled as needed. In the web interface: 1 On the Main menu, click Users. 2 On the Users Configuration page, check the Enable password authentication check box. 3 Click Apply.
Configure Digi devices Add users Digi Connect Family products allow multiple users to be defined. For those products, the Users Configuration page shows the currently defined users and allows you to add more user definitions. To add a user definition: 1 On the Main menu, click Users. 2 On the Users Configuration page, click New. 3 On the Add New Users page, specify the user name and password to be used for login. The password can be from 4 through 16 characters long and is case-sensitive.
Configure Digi devices User permissions settings The User Permissions page is used to define whether and how users can use services and configuration settings for the Digi device. For example, you can disable a user’s access to certain parts of the web interface, or allow them to display settings only but not change them. The list of services and the user permissions available for them vary by Digi device and the features supported in the product.
Configure Digi devices User permissions and effects Permission Setting Effect None The user will not have permission to execute this setting. Read Self The user will be able to display their own settings, but not those of other users. Read The user has permission to read the setting for all users, but does not have permission to modify or write the setting. Read/Write Self The user has permission to read and write their own setting, but not those of other users.
Configure Digi devices Applications Several Digi devices support additional configurable applications. For most devices, these applications are accessed from the main menu under Applications. Some devices have an Applications link under Configuration. Python ® program management Digi incorporates a Python development environment into Digi devices.
Configure Digi devices Digi Python Custom Development Environment page Python functions can be used to obtain data from attached and integrated sensors on Digi products that have embedded XBee RF modules, such as the Drop-in Networking Accessories. The Digi Python Custom Development Environment page is an access point: for such information. http://www.digi.com/technology/drop-in-networking/python.jsp Python Support Forum on digi.
Configure Digi devices RealPort configuration RealPort software must be installed and configured on each PC that uses the RealPort ports on the Digi device. This RealPort software is available for downloading from the Digi Support site.It is also on the Software and Documentation CD, and can be loaded from the Digi Device Setup Wizard. Install RealPort software From the Digi Support site: 1 From a browser, go to www.digi.com. 2 Click the Support link and select Drivers.
Configure Digi devices RealPort configuration settings Applications > Realport displays a page for configuring the RealPort application. Settings on this page include: RealPort Settings – Enable Keep-Alives: Enables sending of RealPort keep-alives. These keep-alives are messages inside the RealPort protocol, sent approximately every 10 seconds, to tell whoever is connected that the connection is still alive. RealPort keep-alives are different from TCP keep-alives, which are done at the TCP layer.
Configure Digi devices Ekahau Client™ For Digi devices with Wi-Fi capability, clicking Ekahau Client displays a page for configuring Ekahau Client device-location software. The Ekahau Client feature provides integrated support for Ekahau's Wi-Fi device-location solution, called the Ekahau Positioning Engine, on the Digi Connect Wi-ME, Digi Connect Wi-EM, and Digi Connect Wi-SP products.
Configure Digi devices Ekahau Client configuration settings include: Enable Ekahau Positioning Engine Client™: Enables or disables the Ekahau Positioning Engine Client feature. – Ekahau Server Settings: Configures how the Ekahau Positioning Engine Client communicates with the server. – Server Hostname: The hostname or IP address of the Ekahau Positioning Engine. The maximum length of this option is 50 characters. The default is 8548.
Configure Digi devices Industrial Automation/Modbus Bridge Industrial Automation is supported in these Digi devices: Digi Connect SP, Digi Connect Wi-SP, Digi Connect ME 4 MB, Digi Connect Wi-ME, Digi Connect EM, Digi Connect Wi-EM. Currently, from the web interface, it is only possible to select a different port profile than Industrial Automation, or change the serial port settings, such as baud rate and parity.
Configure Digi devices Alternative configuration options for Digi Connect Wi-SP If configuring the Digi Connect Wi-SP with a serial connection, there are several configuration options. Configure with an Access Point - Infrastructure Mode 1 Configure the network using an access point with the SSID - Connect and all encryption disabled (such as WEP & WPA). 2 Power up the device. 3 Launch the Discovery program and proceed with the configuration.
Configure Digi devices 5 Select COM1 and click OK. 6 Set the port settings to 9600, 8, None, 1, None (default settings) click Apply then OK.
Configure Digi devices 8 Use the set wlan command to configure wireless network settings. This command is described in the Digi Connect Family Command Reference, available for download from the Digi Support site and also on the Software and Documentation CD for command descriptions. 9 After configuring the Digi Connect Wi-SP parameters to function within your network, disconnect the power supply and the serial cable from the Digi Connect Wi-SP.
Configure Digi devices Configuration through the Java applet interface A Java applet interface is available as an alternative device interface. Accessing the Java applet interface The Java Applet interface can be temporarily launched as a device interface, or can be set as the default interface. In some cases, a system administrator may have already set it as the default. To launch the Java Applet interface, go to the Home page of the web interface.
Configure Digi devices The Home page When the Java applet interface for a Digi device is opened, the Home page is displayed. The left side of the home page has a menu of choices that link to pages for configuration, management, and administration tasks. This section focuses on the links under Configuration and Management. For details on using the links under Administration, see Chapter 5, "Digi device administration". The System Summary section notes all currently available device-description information.
Configure Digi devices Saving, canceling, and refreshing configuration settings The configuration screens in the Java applet interface contain several buttons: Save, Cancel, and Refresh. Save: Saves changed values to the Digi device. Cancel: Resets only those changes that have been made prior to clicking Save to the initial values on the particular page.
Configure Digi devices Network settings To configure network settings, click the Network link. Network settings are organized on three tabs: Basic: Shows how the device’s IP address is obtained, either by DHCP or by using a static IP address, subnet mask, and default gateway. Contact your network administrator if you do not know what these settings mean, or when they need to be entered or referenced.
Configure Digi devices Alarms To configure alarms in the Java Applet interface, go to Management > Alarms. The checkbox at the top of the screen shows whether alarms are currently enabled or disabled. The Email Server Information fields show the IP address of the email server used to send emails when conditions that trigger an alarm occur, and the text to include in the “from” field of an alarmtriggered email. The Alarm List shows all the alarms that are currently defined for a device.
Configure Digi devices Configuration through the command line Configuring a Digi devicethrough the command-line interface consists of entering a series of commands to set values in the device. The Digi Connect Family Command Reference describes the commands used to configure, monitor, administer, and operate Digi devices. Access the command line To configure devices using commands, first access the command line.
Configure Digi devices Here are some examples of commands used to configure Digi device. See the Introduction of the Digi Connect Family Command Reference for a complete list of features and tasks that can be configured and performed from the command line.
Configure Digi devices To configure: Use this command: Telnet control commands: send Telnet control command to last active Telnet session; set Telnet operating options send mode users user groups, and passwords set user set group newpass user permissions for various services and command line interface commands set permissions wireless devices set wlan 133
Configure Digi devices Configuration through Simple Network Management Protocol (SNMP) Configuring Digi devices through Simple Network Management protocol uses a subset of standard MIBs for network and serial configuration, plus several Digi enterprise MIBs for device identification and alarm handling. These MIBs are listed and described on page 102, and must be loaded into a network management station (NMS). The standard and Digi Enterprise MIBs allow for very basic network and serial configuration.
Monitor and manage Digi devices Monitor and manage Digi devices C H A P T E R 4 The port, device, system, and network activities of Digi devices can be monitored from a variety of interfaces. Changes in data flow may indicate problems or activities that may require immediate attention. In addition, connections and network services can be managed. This chapter discusses monitoring and connection-management capabilities and tasks in Digi devices.
Monitor and manage Digi devices Monitoring capabilities from the iDigi Platform Digi devices can be monitored and managed from iDigi Platform; for example. Displaying detailed state information and statistics about a device, such as device up time, amount of used and free memory, network settings, XBee network overview and detailed information on network nodes. Mobile settings Monitoring the state of the device’s connection and see a connection report and connection history statistics.
Monitor and manage Digi devices Monitoring capabilities in the web and Java applet interfaces Several device monitoring and connection-management capabilities are available in the web interface and Java applet interface. including system information and statistics, and connection management information.
Monitor and manage Digi devices Total/Used/Free Memory The amount of memory (RAM) available, currently in use, and currently not being used. GPIO information The GPIO page displays the current state of the General Purpose I/O pins on the Digi device. The state of pins configured for output can be changed, as discussed in "GPIO pins" on page 93. Alarms can be issued when GPIO pins change state, as discussed in "Alarms" on page 95.
Monitor and manage Digi devices Serial port information The Serial page of System Information lists the serial ports that are configured for the Digi device. Click on a port to view the detailed serial port information. Serial port diagnostics page The Serial Port Diagnostics page of system information provides details that may aid in troubleshooting serial communication problems. Configuration The Configuration section includes the electrical interface (Port Type) and basic serial settings.
Monitor and manage Digi devices Serial statistics The Serial statistics section includes data counters and error tracking that will help determine the quality of data that is being sent or received. If the error counters are accumulating, there may be a problem in the Digi device. Total Data In: Total number of data bytes received. Total Data Out: Total number of data bytes transmitted.
Monitor and manage Digi devices Network statistics Network statistics are detailed statistics about network and protocol activity that may aid in troubleshooting network communication problems. Statistics displayed are those gathered since the unit was last rebooted. If an error counter accumulates at an unexpected rate for that type of counter, there may be a problem in the Digi device. Ethernet Connection Statistics Speed Ethernet link speed: 10 or 100 Mbps.
Monitor and manage Digi devices IP Statistics Datagrams Received Datagrams Forwarded Number of datagrams received or forwarded. Forwarding Displays whether forwarding is enabled or disabled. No Routes Number of outgoing datagrams for which no route to the destination IP could be found. Routing Discards Number of outgoing datagrams which have been discarded. Default Time-To-Live Number of routers an IP packet can pass through before being discarded.
Monitor and manage Digi devices UDP statistics Datagrams Received Datagrams Sent Number of datagrams received or sent. Bad Datagrams Received Number of bad datagrams that were received. This number does not include the value contained by No Ports. No Ports Number of received datagrams that were discarded because the specified port was invalid. ICMP statistics Messages Received Number of messages received. Bad Messages Received Number of received messages with errors.
Monitor and manage Digi devices WiFi LAN statistics The WiFi LAN Statistics section displays more detailed wireless statistics that may aid in troubleshooting network communication problems in wireless Digi devices.
Monitor and manage Digi devices Manage connections and services The Management menu is for viewing and managing connections and services for the Digi device. Manage serial ports Management > Serial Ports provides an overview of the serial ports and their connections. Clicking Connections displays the active connections for that serial port. The view can be refreshed to see any new serial-port connections list, and connections can be disconnected as needed.
Monitor and manage Digi devices Monitoring capabilities from the command line There are several commands for monitoring Digi devices and managing their connections. For complete descriptions of these commands, see the Digi Connect Family Command Reference.
Monitor and manage Digi devices info commands info commands displays statistical information about a device over time. The statistics displayed are those gathered since the tables containing the statistics were last cleared. Statistics include: Device statistics. info device displays such details as product, MAC address, boot, POST, and firmware versions, memory usage, utilization, and uptime. Ethernet statistics.
Monitor and manage Digi devices Commands for managing connections and sessions close: Closes active sessions that were opened by connect, rlogin, and telnet commands. connect: Makes a connection, or establishes a connection, with a serial port. exit and quit: These commands terminate a currently active session. who and kill: The who command displays a global list of connections. The list of connections includes those associated with a serial port or the command-line interface.
Monitor and manage Digi devices Monitoring Capabilities from SNMP Device monitoring capabilities from SNMP include, among other things: Network statistics, defined in RFC 1213, MIB-II Port statistics, defined in RFCs 1316 and 1317 Device information, defined in Digi enterprise MIB DIGI-DEVICE-INFO.mib For more information on the statistics available through the standard RFCs listed above, refer to the RFCs available on the IETF web site (www.ietf.org).
Digi device administration Digi device administration C H A P T E R 5 This chapter discusses the administration tasks that need to be performed on Digi devices periodically, such as file management, changing the password used for logging onto the device, backing up and restoring device configurations, updating firmware and Boot/POST code, restoring the device configuration to factory defaults, and rebooting the device.
Digi device administration File management The File Management page of the web interface uploads custom files to a Digi device, such as the files for a custom applet, or a custom image file of your company logo. Custom applets allow the flexibility to alter the interface either by adding a different company logo, changing colors, or moving information to different locations. If custom applets or the sample Java applet is not used, using this feature is not necessary.
Digi device administration X.509 Certificate/Key Management The X.509 Certificate/Key Management pages are for loading and managing X.509 certificates and public/private host key pairs that are public key infrastructure (PKI) based security. There are separate pages of settings for the certificate databases and key management. Certificate Authorities (CAs) / Certificate Revocation Lists (CRLs) The Certificate Authority (CA) database is used to load certificate authority digital certificates.
Digi device administration Virtual Private Network (VPN) Identities The Virtual Private Networking (VPN) Identities database is used to load host certificates and keys. Identity certificates and keys allow for IPSec authentication and secure key exchange with ISAKMP/IKE using RSA or DSA signatures. The VPN identity certificate must be issued by a CA trusted by the peer. Upload VPN Identity Keys and Certificates: Use this section to upload VPN RSA or DSA identity keys and certificates.
Digi device administration Secure Sockets Layer (SSL) / Transport Layer Security (TLS) Certificates The Secure Sockets Layer (SSL) and Transport Layer Security (TLS) databases are used to load host certificates and keys, as well as peer certificates and revocations. Identity Certificates and Keys – Upload SSL/TLS Identity Keys and Certificates: use this section to upload SSL/TLS RSA or DSA identity keys and certificates. Identity certificate and key files may be in ASN.
Digi device administration Backup/restore device configurations Once a Digi device is configured, backing up the configuration settings is recommended in case problems occur later, firmware is upgraded, or hardware is added. If multiple devices need to be configured, the backup/restore feature can be used as a convenience, where the first device’s configuration settings is backed up to a file, then the file is loaded onto the other devices.
Digi device administration Restore a device configuration to factory defaults Restoring a Digi device to its factory default settings clears all current configuration settings except the IP address settings and host key settings. In addition, any files that were loaded into the device through the File Management page such as custom-interface files and applet files are retained. See "File management" on page 151 for information on loading and deleting files.
Digi device administration Using the Reset button If the Digi device cannot be accessed from the web interface, the configuration can be restored to factory defaults by using the Reset button. 1 Power off the Digi device. 2 Locate the Reset button or pin on your device. Here is the reset button for a Digi Connect SP unit. For Digi Connect EM or Digi Connect Wi-EM, the Reset button is located between P3 and CR1, as shown: Reset button Digi Connect ME and Digi Connect Wi-ME do not have a reset button.
Digi device administration For Digi Connect ME and Digi Connect Wi-ME, short pin 20 (the /init pin) to ground during boot up to restore the module to factory defaults. Note that shorting pin 14 simply reboots the unit but does not restore the configuration. 4 After a few seconds you may see a 1-1-1 blink once on some devices. 5 Wait until you see the Status LED blink a 1-5-1 pattern, then release the reset button. 6 Wait for the device to boot up.
Digi device administration Display system information System information displays the model, MAC address, firmware version, boot version, and POST version of the Digi device. It also displays memory available: total, used, and free, and tracks CPU percent utilization and the uptime. From the web interface menu, select Administration > System Information. Select General, GPIO, Serial, Network, or Diagnostics for the appropriate information.
Digi device administration Administration from the Java applet interface In the Java applet device interface, administration tasks are also organized under Administration in the main menu. There are fewer choices than in the web interface: Backup/Restore: Backs up or restores a Digi device configuration. Restore Factory Defaults: Restores a Digi device’s configuration to factory defaults.
Digi device administration Display system information System information displays the model, MAC address, and the version levels for firmware, boot code, and POST code in the Digi device. It also displays memory available: total, used, and free, and tracks CPU percent utilization and the uptime.To display system information, from the main menu, click Administration > System Administration. Select General, GPIO, Serial or Network for the appropriate information.
Digi device administration Administration from the command-line interface Administrative tasks for Digi devices can also be performed from the command line. Here are several device-administration tasks and the commands used to perform them. See the Digi Connect Family Command Reference for more complete command descriptions.
Latency Tuning Latency Tuning C H A P T E R 6 What is Latency? This section discusses latency and a recommended process for defining and addressing latency issues in your network and application. Latency is the amount of time a packet takes to travel from source to destination. Together, latency and bandwidth define the speed and capacity of a network.
Latency Tuning Step 1: Determine the characteristics of your application Consider your application in terms of traffic pattern and amount of traffic generated.
Latency Tuning Step 4: Optimize the network and transport layers Depending on the results produced in steps 1, 2, and 3, optimize the network and transport layers. Optimizing the network and transport layers, may include, but is not limited to, these recommendations: Isolate any unnecessary TCP/IP traffic from the network. Choose smaller packets to reduce transit times through intermediate networking devices, as most of these devices are store-and-forward.
Latency Tuning Command options for optimizing network and transport layers A major contributor to latency for the network and transport layers is unnecessary retransmissions of data. The command-line interface has several command options to help you reduce these unnecessary retransmissions. Note that these options are available through the command-line interface only, and not the Web user interface. For complete descriptions of these commands and options, see the Digi Connect Family Command Reference.
Latency Tuning Considerations for using latency-related command options There are several considerations for using these latency-related command options: Changing the options from their defaults may violate RFCs. Decrementing the values for these options increases the amount of network activity, for example, there will be increased retransmissions. For a peer-to-peer application, you need to consider both sides of the connection and how options are set.
Specifications and certifications Specifications and certifications C H A P T E R 7 This chapter provides hardware specifications, additional feature detail, and regulatory statements and certifications for Digi devices.
Specifications and certifications Hardware specifications See hardware references for some Connect Family product specifications Several Digi Connect products have Hardware Reference Manuals, which include hardware specifications. The specifications listed here are for products that do not have an accompanying Hardware Reference Manual.
Specifications and certifications ConnectPort TS 8 specifications Specification Environmental Power requirements Dimensions USB interface Value Ambient temperature 32 to 140F (0 to 60C) Relative humidity 5 to 95% (non-condensing) Storage and transport temperature -40 to 185F (-40 to 85C) Altitude 12000 feet (3657.
Specifications and certifications ConnectPort TS 16 specifications Specification Environmental Power requirements Dimensions USB interface Value Ambient temperature 32 to 131F (0 to 55C) Relative humidity 5 to 95% (non-condensing) Storage and transport temperature -40 to 185F (-40 to 85C) Altitude 6500 feet (2000 meters) Serial Port Protection (ESD) +15 kV human body model AC power range 100-240 VAC, 50/60 Hz, 0.
Specifications and certifications ConnectPort TS 4x4 and ConnectPort TS 4x2 specifications Specification Environmental Power requirements Dimensions Value Operating temperature 32 to 140F (0 to 60C) Storage and transport temperature -40F to 185F (-40 C to 85 C) Relative humidity 5 to 95% (non-condensing) Ethernet isolation 1500VAC min per IEEE802.3/ANSI X3.
Specifications and certifications Wireless networking features The following table shows key wireless-networking features that can be configured in Wi-Fienabled Digi products. For more details and up-to-date information on support of these features, see the readme file for your Digi product. Wireless feature Description Standard 802.11bg Frequency 2.4 GHz Data Rates Up to 54 Mbps with automatic rate fallback Modulation DBPSK (1 Mbps), DQPSK (2 Mbps), CCK (11, 5.
Specifications and certifications Wireless feature Description Ekahau Client™ Provides integrated support for Ekahau's Wi-Fi device-location solution. Ekahau offers a complete access point vendor-independent real-time location system for wireless LAN devices that is capable of pinpointing wireless LAN devices such as the Digi Connect products, laptops, PDAs, or other intelligent Wi-Fi enabled devices. The solution provides floor-, room- and door-level accuracy of up to 3.5 feet (1 m).
Specifications and certifications Regulatory information and certifications RF exposure statement Digi Connect Wi-SP, Digi Connect Wi-EM, and Digi Connect Wi-ME The Digi Connect Family wireless devices Digi Connect Wi-SP, Digi Connect Wi-EM, and Digi Connect Wi-ME comply with the RF exposure limits for humans as called out in RSS-102. These devices are exempt from RF evaluation based on its operating frequency of 2400 MHz, and effective radiated power of 100 milliwatts.
Specifications and certifications Modifications (FCC 15.21) Changes or modifications to this equipment not expressly approved by Digi may void the user's authority to operate this equipment. Cables (FCC 15.27) Shielded cables must be used to remain within the Class A limitations.
Specifications and certifications .International EMC (Electromagnetic Emissions/Immunity/Safety) standards These products comply with the requirements of following Electromagnetic Emissions/Immunity/ Safety standards. There are no user-serviceable parts inside the product. Contact your Digi representative through "Digi contact information" on page 8 for repair information.
Troubleshooting Troubleshooting C H A P T E R 8 This chapter provides information on resources and processes available for troubleshooting your Digi device. Troubleshooting Resources There are several resources available to you for support of your Digi product or resolving configuration difficulties at Digi’s Support site, http://www.digi.com/support/ Try these troubleshooting steps to eliminate your problem.
Troubleshooting System status LEDs Digi devices have several LEDs that indicate system status, link integrity, and link activity. Digi Connect Family LEDs Digi Connect LEDs provide information on port activity, diagnostics, and Ethernet activity. Digi Connect SP Digi Connect SP has three LEDs: Ethernet Link and Ethernet Activity, which are connected directly to the hardware; and the Power LED, which is software programmable.
Troubleshooting Digi Connect Wi-SP Digi Connect Wi-SP has three LEDs: Wi-Fi Link and Wi-Fi Activity, which are connected directly to the hardware; and the Power LED, which is software programmable. Digi Connect Wi-SP - Back 9 to 30VDC ,37A-.
Troubleshooting Digi Connect ME The Digi Connect ME module has two LEDs that are located near the upper corners of the Ethernet port (see the following figure). Note The LEDs are the same for a module with or without a JTAG connector. Digi Connect ME - Back Ethernet Link Status LED Ethernet Activity Status LED Ethernet Port LED/button Color and Light Pattern Description Ethernet Link LED Solid yellow Ethernet link is up. Ethernet Activity LED Blinking green Ethernet traffic is on the link.
Troubleshooting Digi Connect Wi-ME Wi-Fi Link Status LED LED/button Wi-Fi Link Status LED Wi-Fi Activity Status LED Color and Light Pattern Wi-Fi Activity Status LED Description Solid yellow Unit is associated with an access point. Yellow, blinking slowly Unit is in ad hoc mode. Yellow, blinking quickly unit is scanning for a network Off The Wi-Fi link is idle. Blinking green Wi-Fi traffic is on the link.
Troubleshooting Digi Connect EM and Digi Connect Wi-EM Digi Connect EM and Digi Connect Wi-EM modules provide two hardware options for LEDs, with or without on board LED array. The integration kit provides predefined LED behavior. With the development kit, some LED behavior can be determined by your implementation. See the following table for more information. .
Troubleshooting Digi Connect ES 4/8 SB and Digi Connect 4/8 SB with Switch Digi Connect ES connectors, LEDs, and controls Attention: Consult accompanying documentation 250V F1A 3 100-240 V 50 - 60 Hz, 0.2A MAX 1 Dangerous Voltage 8 2 7 6 8 4 UPLINK 5 6 UPLINK 5 13 4 10 4 4 3 7 3 3 9 2 2 2 1 1 1 MAC 11 00:00:00:00:00 12 250V F1A Off On 100-240V 50 - 60 Hz, 0.
Troubleshooting LED/button Ethernet Uplink LED Ethernet Switch LEDs Serial LED Find Me/Locator LED Power Color and Light Pattern Description Solid green Ethernet Uplink connection is up but no traffic is on the line. Blinking green Traffic is on the Ethernet Uplink connection. Off Ethernet Uplink connection is disconnected. Solid green Ethernet Switch connection is up but there is no activity on the line.
Troubleshooting ConnectPort TS Family Products ConnectPort TS 4x2 and ConnectPort TS 4x4 ConnectPort TS 4x2 - Back Ethernet Ports Serial Ports Ethernet Ethernet Activity Link LED LED ConnectPort TS 4x4 - Back Ethernet Ports Serial Ports Ethernet Ethernet Activity Link LED LED ConnectPort TS 4x4 and ConnectPort TS 4x2 - Front Reset Status button Power LED LED 186
Troubleshooting LED/button Color and Light Pattern Description Power LED Solid Green Power is applied. Status LED Green Blinks during product initialization and factory reset, using the light patterns below. This LED should never blink during normal operation. If it blinks constantly, contact Digi Technical Support. 1-1-1 blinking green Firmware is initializing. 1-5-1 blinking green Device configuration has been restored to its factory defaults.
Troubleshooting ConnectPort TS W ConnectPort TS W - Top Panel Reset button on side panel Power LED Status Wi-Fi Wi-Fi LED Link Activity LED LED Wi-Fi Signal Strength LEDs ConnectPort TS W - Front Panel Antenna Connector Power Connector Ethernet Ethernet Activity Link LED LED Serial Transmit LED USB Ethernet Connector Connector Serial Receive LED Serial Ports 188
Troubleshooting LED/button Color and Light Pattern Description Power LED Solid Green Power is applied. Status LED Green Blinks during product initialization and factory reset, using the light patterns below. This LED should never blink during normal operation. If it blinks constantly, contact Digi Technical Support. 1-1-1 blinking green Firmware is initializing. 1-5-1 blinking green Device configuration has been restored to its factory defaults.
Troubleshooting ConnectPort TS 8 and ConnectPort TS 8 MEI ConnectPort TS 8 and ConnectPort TS 8 MEI - Front Panel Power LED Fuse Good LED Diag C1 and (system C2 LEDs status) LED Reset button ConnectPort TS 8 and ConnectPort TS 8 MEI - Back Panel Serial Serial Transmit Receive LED LED Serial Ports Ethernet Link Ethernet USB Ports LED Activity Power LED Connector 190
Troubleshooting LED/button Color and Light Pattern Description Power LED Solid Green Power is applied. Fuse Good LED Solid Green Power is applied and the fuse is good. If this LED is not illuminated when power is applied, the fuse is blown and needs to be replaced. Diag LED Amber Blinks during product initialization and factory reset, using the light patterns below. This LED should never blink during normal operation. If it blinks constantly, contact Digi Technical Support.
Troubleshooting ConnectPort TS 16 ConnectPort TS 16- Front Panel Power LED Reset Diag (system button status) LED ConnectPort TS 16- Back Panel USB Ports Serial Ports Serial Serial Transmit Receive LED LED Ethernet Ethernet Link Activity LED Power Connector 192
Troubleshooting LED/button Color and Light Pattern Description Power LED Solid Green Power is applied. Diag LED Amber Blinks during product initialization and factory reset, using the light patterns below. This LED should never blink during normal operation. If it blinks constantly, contact Digi Technical Support. 1-1-1 blinking amber Firmware is initializing. 1-5-1 blinking amber Device configuration has been restored to its factory defaults.
Glossary • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • •• • • • 802.11 The IEEE standard for wireless Local Area Networks. It uses three different physical layers, 802.11a, 802.11b and 802.11g. access control list See IP filtering. Address Resolution Protocol (ARP) A protocol for mapping an Internet Protocol address () to a physical machine address that is recognized in the local network.
configuration applet See Java applet interface. configuration management Managing the files and settings that contain device configuration information. Configuration management tasks include copying device configuration files to and from a remote host, upgrading device firmware, and resetting the device configuration to factory defaults. CTS Clear to Send. device server A one- or two-port intelligent network device that converts serial data into network data.
File Transfer Protocol (FTP) A standard Internet protocol that specifies the simplest way to exchange files between computers on the Internet. HyperText Transfer Protocol (HTTP) An application protocol in the TCP/IP suite that defines the rules for transferring files (text, graphic images, sound, video, and other multimedia files) on the World Wide web (WWW).
NAT NAT (Network Address Translation) is the translation of an Internet Protocol address () used in one network to a different IP address known in another network through a NAT table that does the global-to-local and local-to-global IP address mapping. This increases security since each outgoing or incoming request must go through a translation process that also authenticates the request or matches it to a previous request.
Remote Command Interface (RCI) A programmatic interface for configuring and controlling Connect family devices. RCI is an XML-based request/response protocol that allows a caller to query and modify device configurations, access statistics, reboot the device, and reset the device to factory defaults. Unlike other configuration interfaces that are designed for a user, such as the command-line or browser interfaces, RCI is designed to be used by a program.
Simple Mail Transfer Protocol (SMTP) A TCP/IP protocol used in sending and receiving e-mail. Since it is limited in its ability to queue messages at the receiving end, it is usually used with one of two other protocols, POP3 or IMAP, that let the user save messages in a server mailbox and download them periodically from the server. SMTP usually is implemented to operate over Internet port 25. An alternative to SMTP that is widely used in Europe is X.400.
Trivial File Transfer Protocol (TFTP) An Internet software utility for transferring files that is simpler to use than the File Transfer Protocol (FTP) but less capable. It is used where user authentication and directory visibility are not required. TFTP uses the User Datagram Protocol (UDP) rather than the Transmission Control Protocol (TCP). TFTP is described formally in Request for Comments (RFC) 1350.
Mouser Electronics Authorized Distributor Click to View Pricing, Inventory, Delivery & Lifecycle Information: Digi International: DC-ME-01T-MF-10