User Guide Digi TS W Family 9000329_B
Digi International Inc. 2003. All Rights Reserved. e Digi logo, PortServer, Connectware, Digi One, and RealPort are trademarks or registered trademarks of Digi International, Inc.
Contents Chapter 1 Introduction Setup Overview ..................................................................................... 9 Step A: Plan........................................................................................................ 9 Step B: Set Up the Hardware ............................................................................. 9 Step C: Install and Setup Digi Port Authority-Remote ........................................ 9 Step D: Configure an IP Address ......................
Manual Configuration Procedure ...................................................................... 21 Example to Set IP Address............................................................................... 21 Example to Set Subnet Mask ........................................................................... 21 Example to Set Gateway Mask ........................................................................ 21 Manual Configuration Example ............................................................
Chapter 9 Configuring IP Routing Configuring Static Routes....................................................................53 Related Information .......................................................................................... 53 Procedure ......................................................................................................... 53 Example: Route Using the Ethernet Interface .................................................. 53 Example: Route Using a PPP Link ....................
Chapter 11 Configuring the Digi Device for IA(Industrial Automation) Configuring Modbus ............................................................................ 63 Modbus Configuration Procedure ..................................................................... 63 Configuring the User-Defined Protocol................................................ 63 Modbus Configuration Procedure .....................................................................
Chapter 16 Configuring Power Over the Serial Ports Serial Power Feature........................................................................... 75 Configuring RI Power .......................................................................... 75 RI Power In....................................................................................................... 75 RI Power Out .................................................................................................... 76 Configuring DTR Power......
Contents
Introduction Chapter 3 Setup Overview This section provides an overview of the setup process. Step A: Plan Before beginning setup, consider the following: • How to assign an IP address to the Digi device’s Ethernet interface, which can be accomplished in a number of ways. See "Configuring the IP Address" on page 19. • How to configure serial ports. A key consideration is whether to use RealPort.
Step F: Configure Other Features as Required See the following for information on setting up other features: • "Configuring PPP" on page 31 • "Configuring Autoconnection" on page 49 • "Configuring IP Routing" on page 53 • "Configuring Security Features" on page 57 • "Configuring DNS" on page 65 About Entering Commands on the Command Line If you use the command line, you will find the commands needed within each chapter.
Digi One/PortServer TS Command Reference This online manual, available on the Software and Documentation CD, provides complete information on commands. RealPort Setup Guides These online manuals provide information on setting up servers for RealPort software. Online Help for the Web UI This context-sensitive online help provides information on configuration fields used with web browser configuration interface. About Configuration Methods Use this section to learn about configuration methods.
Configuration Prerequisites Accessing the Command Line from a Locally-Connected Terminal Use this procedure to access the command line and the configuration from a terminal connected to one of the device server’s serial ports. 1. Connect a terminal or PC to a serial port on the device server. For a Windows HyperTerminal connection, use the cable that came in the package. 2. Configure the parameters of the terminal or terminal emulation software to work with the Digi serial port.
Configuring Wireless Chapter 4 Configuration Considerations The PortServer TS 4 W works ONLY with the radio provided. You can use the wizard to configure your wireless device available on the Software and Documentation CD. You will need an Ethernet cable and a network PC to configure the wireless device server. After assigning the IP address, access the device from your browser by entering the IP address in the URL address bar. Install Radio Place your country sticker on the back of the radio.
2. Insert CD, the wizard will automatically pop up. Follow wizard either for Microsoft Windows or Unix to configure the device. If you do not want to use the wizard click Cancel and follow the remaining procedure to set up the IP address and configure the device through the web interface. 3. Select Discover Digi Device (from the CD). 4. Select the wireless device and assign the IP address. 5. Click Set IP. 6. Enter the IP address, Subnet, and Gateway mask and click OK. 7.
9. Click Network from the left navigation bar. 10. Enter parameters, click Apply to save then click Wireless LAN Settings.
11. Enter the parameters and click Apply to save and Advanced Network Settings for more settings.
12. Enter parameters, click Apply to save. 13. Unplug the Ethernet cable from the device server, disconnect the power, and power the unit up (reboot). Configuration is complete.
Chapter 4 Configuring Wireless
Configuring the IP Address Chapter 5 Options for Configuring the IP Address and Mask The device server IP address can be configured using the following methods: • With Digi Port Authority-Remote, a Digi utility on the Software and Documentation CD. • By updating the ARP table on a server and then pinging the Digi device (called ARP-Ping, see "Configuring the IP Address Using ARP-Ping" on page 20).
• • • That the Digi device has DHCP client turned on. This is the default setting and it will be on unless it was turned off. That you do not have a DHCP server to serve IP address. If you do, use the DHCP procedure. See "Configuring an IP Address using DHCP and RARP" on page 22. That you have installed Digi Port Authority-Remote version 2.01.11 or later.
4. Ping the Digi device using the IP address just assigned. The following is an example: ping 143.191.2.1 The ping will probably time out before there is a response from the Digi device. 5. Wait a few seconds and then ping the Digi device again. The Digi device replies to the ping, indicating that the IP address has been configured.
boot action=reset Configuring an IP Address using DHCP and RARP About DHCP and RARP When the device server boots, it transmits a DHCP request and a RARP request. This continues until an address is assigned. Procedure To use RARP or DHCP follow these steps: 1. Set up an entry for an address on a DHCP or RARP server. If you intend to use RealPort, do the following: • Reserve a permanent IP address. • Record the IP address. You will need it when you configure the RealPort driver. 2.
Setting Up RealPort Chapter 6 About RealPort This section provides a brief introduction to RealPort. What is RealPort? RealPort is a feature that allows network-based host systems to use the ports of the device server as though they were the host system’s own ports, appearing and behaving as local ports to the network-based host. RealPort Advantages RealPort provides the following advantages: • It expands the number of ports available to the host system.
Chapter 6 Setting Up RealPort
Configuring the Serial Ports Chapter 7 Options for Configuring the Serial Ports The device server serial ports can be configured using the following methods: • Through the web interface • From the command line using the set config command ("Configuring the Serial Port Settings from the Command Line" on page 26.) The serial ports can also be changed using the web interface or command line. Configuring the Serial Port Settings with the Web Interface 1.
5. Click Change Profile and select a profile based on the device you have connected to your port. Custom will expose all settings. 6. Click Apply to save the profile. The interface will determine any additional settings and advise you what tab to click next. 7. A port profile or port options page will come up and ask for additional parameters if needed. Enter the appropriate parameters and click Apply.
Configuring PPP Chapter 8 Configuring Inbound PPP Connections Use this section to configure simple inbound PPP connections from the command line. For information on fine-tuning PPP connections, see the set user command in the Digi One/PortServer TS Command Reference. Note: CHAP authentication works between two Digi devices. CHAP will be negotiated to PAP for all other connections Procedure for Command Line 1.
set user name=name ipaddr=ip-address where • name is the user’s name • ip-address is one of the following: (a) A standard IP address in dotted decimal format. (b) 0.0.0.0, which means the remote user will supply the IP address (c) ippool, which means that the user will be assigned an IP address from an IP address pool. See the set ippool command in the Digi One/PortServer TS Command Reference. Example: set user name=pppin ipaddr=ippool 6.
Procedure 1. To configure the port for a modem, enter the following command: set ports range=range dev=device where range is the port or ports and device is one of the following: • mout for outbound only modem connections • mio for bidirectional modem connections. See the set ports command in the Digi One/PortServer TS Command Reference for more information. Example: set ports range=3 device=mout 2.
7. To configure this user for outbound connections, enter the following command: set user name=name outgoing=on device=device where device is either the Digi-supplied device or the outbound device created earlier in this procedure Example: set user name=pppout outgoing=on device=gendialer 8. To configure an IP address for the local end of the PPP connection, enter the following command: set user name=name localipaddr=ip-address where name is the user’s name and ip-address is one of the following: • 0.0.
Filters for PPP Connections Use the following table for additional configurations. set user Field passpacket keepup bringup logpacket Chapter 8 Configuring PPP Description Example Causes a packet to be passed or blocked Filter causes incoming packets from an IP address to be accepted and packets from all other IP addresses to be blocked Causes the idletimeout timer to be reset and a connection maintained.
Chapter 8 Configuring PPP
Modem Emulation Chapter 9 Modem Emulation (Digi One TS and PortServer TS 2/4 MEI only) Modem emulation enables a system administrator to configure a networked Digi device server to act as a modem. The Digi device server emulates modem responses to a serial device and seamlessly sends and receives data over an Ethernet network instead of a PSTN (Public Switched Telephone Network).
application if the remote side closes the TCP connection. User Scenario-Diagram B Workstation Serial cable O NE TS #1 Digi One TS D IGI Ethernet Workstation #2 Digi One TS 192.168.25.30 D IGI O NE TS Serial cable In Diagram B, two Digi device servers will replace modems on both sides of the connection. The initiation of the connection occurs with either of the Digi device servers. If both ends are Digi device servers, the TCP listening port number is 50001 for port 1.
Originating, Answering, and Disconnecting Calls In the following table, an application requests a TCP session with the Digi device server. The table displays the responses of the Digi device server and application as they negotiate a TCP connection. Application AT Command Digi Device Server Response AT&F ATDT ipaddress:TCPport#
+++
ATH Notes OK. AT command request to restore defaults to factory settings-Digi device server responds OK. Receives request to start a TCP session. CONNECT 115200.
server.
represents a one second pause. Disconnecting Calls-Digi Device Server The Digi device server sends a NO CARRIER response to the serial port when the network connection is dropped.
Modem Emulation AT Command Set AT Function Command ATA Result Code Answer command: The Digi Device Server will go off hook and answer a TCP connection request. This command directs the Digi Device Server to go on-line, dial according to the IP address entered as follow 191.1.2.3:12 and attempt to establish a TCP connection. If no dial string is supplied, the Digi Device Server will respond no dial tone.
AT Result Code Function Command ATIn Identification command I0 reports product code. Example: Digi Device server I1 reports 255 I2 reports “OK” I3 reports “OK” I4 reports DIGI DS_TS I5 reports “OK” I6 reports “OK” I7 reports “OK” I8 reports “ERROR” I9 reports “ERROR” ATLn Accepted but ignored. OK n=0 or 3 ERROR Otherwise ATMn Accepted but ignored. OK n=0 or 3 ERROR Otherwise ATNn Accepted but ignored. OK n=0 or 1 ERROR Otherwise ATOn Return to On-Line Data Mode.
AT Function Command Result Code ATXn Accepted but ignored. OK n=0 to 3 ERROR Otherwise ATYn Accepted but ignored. OK n=0 or 1 ERROR Otherwise ATZn Accepted but ignored. (Soft Reset and restore Profile). OK n=0 or 1 ERROR Otherwise AT&Cn DCD Option. The Digi Device Server controls the DCD output in accordance with the parameter supplied. The parameter value, if valid is written to S21 bit 5. &C0 DCD remains ON at all times.
AT Result Code Function Command AT&Mn Accepted but ignored. OK n=0, 1, 2 ERROR Otherwise AT&Pn Accepted but ignored. OK n=0, 1, 2 ERROR Otherwise AT&Qn Accepted but ignored. OK n=0 to 8 ERROR Otherwise AT&Rn RTS/CTS Option This selects how the Digi Device Server controls CTS. CTS is modified if hardware flow control is selected (see &K command). The parameter value, if valid, is written to S21 bit2. &R0CTS reflects the ability of the modem to transmit data.
AT Result Code Function Command AT\Gn Accepted but ignored. OK n=0 or 1 ERROR Otherwise AT\Kn Accepted but ignored. OK n=0 to 5 ERROR Otherwise AT\Nn Operating Mode This command controls the preferred error correcting mode to be negotiated in a subsequent data connection. \N0 Selects normal speed buffered mode \N1 Serial interface selected - Selects direct mode \N2 Accepted but ignored. \N3 Accepted but ignored. \N4 Accepted but ignored. \N5 Accepted but ignored.
S-Registers Register Function 42 Range Units Saved S0 Rings to Auto-Answer Sets the number of rings required before the Digi Device Server automatically answers a call. Setting this register to Zero disables autoanswer mode. 0-255 Rings S1 Ring Counter S1 is incremented each time the modem detects a ring signal on the telephone line. S1 is cleared if no rings occur over an eight second interval.
Register Function S13 Reserved S14 General Bit Mapped Options Status Indicates the status of command options. Default:138 (8Ah) (10001010b) Bit 0This bit is ignored. Bit 1Command echo (En) 0 =Disabled (E0) 1 =Enabled (E1) (Default.) Bit 2Quiet mode (Qn) 0 =Send result codes (Q0) (Default.) 1 =Do not send result codes (Q1) Bit 3Result codes (Vn) 0 =Numeric (V0) 1 =Verbose (V1) (Default.) Bit 4Reserved Bit 5Tone (T)/Pulse (P) 0 =Tone (T) (Default.
Register 44 Function Range Units Saved Default S21 General Bit Mapped Options Status Indicates the status of command options. Default:52 (34h) (00110100b) Bit 0Set by &Jn command but ignored otherwise. 0 =&J0 (Default.) 1 =&J1 Bit 1Reserved Bit 2CTS behavior (&Rn) 0 =CTS tracks RTS (&R0) 1 =CTS always on (&R1) (Default.) Bits 3-4DTR behavior (&Dn) 0 =&D0 selected 1 =&D1 selected 2 =&D2 selected (Default.) 3 =&D3 selected Bit 5RLSD (DCD) behavior (&Cn) 0 =&C0 selected 1 =&C1 selected (Default.
Register Function Range Units Saved Default S23 General Bit Mapped Options Status Indicates the status of command options. Default:62 (3Dh) (00111110b) Bit 0Grant RDL 0 =RDL not allowed (&T5) (Default.) 1 =RDL allowed (&T4) Bits 1-3DTE Rate 0 =0 - 300 bps 1 =600 bps 2 =1200 bps 3 =2400 bps 4 =4800 bps 5 =9600 bps 6 =19200 bps 7 =38400 bps or higher (Default.) Bits 4-5Assumed DTE parity 0 =even 1 =not used 2 =odd 3 =none (Default.) Bits 6-7not action applied S24 Accepted but ignored.
Register S37 General Bit Mapped Options Status Telnet support for modem emulation.
Register Function Range Units Saved Default S91 Accepted but ignored. 0-15 dBm 10 (Country dependent) S92 Accepted but ignored. 0-15 dBm 10 (Country dependent) S95 Accepted but ignored. - - * 0 * Register value may be stored in one of two user profiles with the &W command.
Chapter 9 Modem Emulation
Configuring Autoconnection Chapter 10 About Autoconnection The autoconnection feature allows you to configure a user to access the device server and then be automatically connected to a host on the LAN. You can implement autoconnection in the following ways: • By port where all port users are automatically connected to the same host. The device server is completely transparent to them.
7. Check Automatically connect to a ... Be sure to specify the following: • Hostname or IP address that will be the destination • Service • Destination TCP port number, which determines the type of connection for this user (such as 23 for Telnet) 8. Click Next and Verify the settings. 9. Click Finish to save settings. Configuring TCP Socket Communication TCP socket communication enables serial devices to communicate with each other over an Ethernet network as though they were connected by a serial cable.
Procedure for Configuring Inbound or Outbound Socket Communication 1. Access the web interface by entering the device server IP address in a browser’s URL window. 2. Log on to the Digi One/PortServer TS as root. The default password is dbps. 3. Click Serial Ports. 4. Click the port number you want to configure. 5.
Chapter 10 Configuring Autoconnection
Configuring IP Routing Chapter 11 Configuring Static Routes This section describes how to configure device server for static routes. Related Information See the set route command in the Digi One/PortServer TS Command Reference.
• • The metric field indicates that packets to this subnet will pass through two routers The gateway field indicates that all packets using this route are to be forwarded to the device at IP address 191.21.21.2. set route net=199.21.33.44 mask=255.255.255.255 metric=2 wannname=ppp1 gateway=199.21.21.2 Configuring Dynamic Routes Using RIP This section describes how to configure the device server for dynamic routing.
192.150.75.0 Router 187.100.46.9 Digi Device PPP set forwarding state=active poisonreverse=on splithorizon=on set user name=link1...netrouting=off Configuring Proxy ARP This section describes how to configure device server for Proxy ARP. Related Information See the set forwarding command in the Digi One/PortServer TS Command Reference.
Chapter 11 Configuring IP Routing
Chapter 12 Configuring Security Features Controlling Access to the Configuration Controlling access of device server restricts access to the configuration by defining the following types of users: • The root user, who has unlimited access to device server commands. He or she can view any configuration table and change any configuration parameter. The root is identified by the user name root and must supply a password to be authenticated. The default root password is dbps.
Example: set logins range=1-2 login=off passwd=off Procedure for Changing a User’s Access Requirements To configure a user so that he or she does not have to specify a password when accessing an inbound port, supply a set user command that specifies the following: set user name=name password=off where name is a name to identify the user Example: set user name=user1 password=off Controlling Access to Outbound Ports This section describes methods for controlling access to outbound serial ports.
• By user where a user is required to login and may be required to supply a password, but once the user is authenticated, an automatic connection to a host is made. For information on configuring autoconnection, see "Configuring Autoconnection" on page 49. Method 2: Menus Menus select destination systems without having to access the device server command line. For information on configuring menus, see the description of the set menu command in the Digi One/PortServer TS Command Reference.
Password Protection To configure simple password authentication for an SSH user, no SSH-specific configuration is required.
• • • • • • • • RealPort Reverse TCP Reverse Telnet Remote login Remote shell SNMP SSH Telnet Service Levels These are the secure access levels: • Secure, which means that SSH is the only service available to inbound users • High, which means that SSH, HTTP, SNMP, and RealPort services are available to inbound users • Normal, which means all services are available • Custom, which means you can select services to turn off. The default service level is normal, which means that all services are available.
Chapter 12 Configuring Security Features
Chapter 13 Configuring the Digi Device for IA (Industrial Automation) Configuring Modbus Modbus is a protocol that defines how devices in an industrial automation (IA) environment communicate. It specifies that a controlling unit, called a master, manages one or more units, called slaves. The protocol specifies that only the master may initiate communication. Slaves may only respond.
• • All message packets are bounded by fixed header and trailer strings. Each protocol request is followed by a single response. Modbus Configuration Procedure Use the setia command from the See the Digi One/PortServer TS Command Reference for information. • Configure the serial port for serial communication parameters (baud rate, data bits, parity and stop bits) required by the connected IA device. • Choose User-defined as the serial-port protocol.
Configuring DNS Chapter 14 About the Domain Name System This section discusses key concepts of the domain name system. Purpose of DNS The domain name system maps domain names to information associated with these names, such as IP addresses.
amalgamated.com. Configuration Procedures Procedure for Using a Name Server To configure a DNS server, enter the following command: set config domain=domain myname=name dns=ip-address where • domain is the domain in which the device server will reside • name is a DNS name for device server • ip-address is the IP address of a name server Example: set config domain=digi.com myname=poe dns=204.221.1.
Configuring SNMP Chapter 15 About SNMP and the Device Server Agent This section introduces SNMP and network management in TCP/IP networks and it describes the device server agent.
• • • Read-write for the character-stream devices using SMIv2 MIB (RFC 1658) Read-write for the RS-232-like hardware devices MIB (RFC 1659) Read-write for the device server IP Network Control Protocol of the Point-to-Point Protocol MIB (RFC 1473) Message Support The SNMP agent supports the Set, Get, GetNext, and Trap messages as defined in RFC 1157.
Configuring Users Chapter 16 About Configuring Users Although it is not required, the device server is often configured to accommodate the requirements of particular users.
Configuring a User: Web Interface Use this section to configure users with from the web interface. 1. Access the web interface by entering the device server IP address in a browser’s URL window. 2. Log on to the device server as root. The default password is dbps. 3. Click Users under Configuration. 4. Click New User. 5. Enter the user name and password (password is optional). 6. Select the profile for user. 7. Enter appropriate parameters, click Next, and verify settings.
Chapter 17 Managing the OS and Configuration Upgrading the Firmware This section describes how to upgrade the firmware, which can be done from the web interface using HTTP or FTP. HTTP or TFTP Upgrade Procedure If your hardware is okay, make sure you are running the latest firmware version available. Check the Digi Support site for the latest firmware and/or POST updates for your device: http://ftp.digi.com/support/firmware 1. Download a copy of the firmware file. 2.
HTTP Procedure 1. Access the web interface by entering the device server IP address in a browser’s URL window. 2. Log on to the device server as root. The default password is dbps. 3. From the main menu, choose Admin > HTTP CpConf. 4. To copy a file from the host you are on do the following: — Choose Browse, select the file, and then choose Submit. — Follow the prompts to complete this procedure. 5. To copy a file to a remote host, do the following: — Right click on the Download current config link.
Commands for Resetting the Configuration to Defaults Use the revert command to reset the configuration to factory defaults or the latest version stored in NVRAM. See the Digi One/PortServer TS Command Reference for complete information. Note: You can also use the range field on this command to define a range of ports with the serial, port, line, flow, keys, and login options.
Chapter 17 Managing the OS and Configuration
Chapter 18 Configuring Power Over the Serial Ports Serial Power Feature The Serial Power feature available for the Digi One TS, PortServer TS 2 MEI, and PortServer TS 4 MEI allows the Digi device to power a serial device (power out) or use a serial device to power the Digi device (power in). The advantage of this feature is to eliminate an external power supply. Power out is available on all ports through Ring Indicator (RI) or Data Terminal Ready (DTR).
2. Close the device unit enclosure. RI Power Out Ring Indicator (RI) power out is available on all ports. The total power budget for this feature is one (1) watt not to exceed 5 volts @ up to 200mA on any single port. The following procedure assumes the unit will only be used for RI power out. 1. Set the port DIP switches to the following places: switch 1 and 3 are up and 2 and 4 are down (see "Serial Power Table" on page 77 for illustration). 2. Enable the RI power through the web interface. 3.
instructions to reset. From the command line use the two examples below for additional information. display circuitbreaker Display the status of the circuit breaker set configuration circuitbreaker=reset Reset the circuit breaker Note: set configuration print will also give the status of the circuitbreaker state. Serial Power Table Use this table for summary information for a serial power setup. .
Chapter 18 Configuring Power Over the Serial Ports
Reference and Certifications Chapter 19 Interpreting the LEDs LEDs LED Power Radio Signal Strength Status (Link) ACT Color Green (labeled PWR) Yellow State On Power detected Steady blinking Waiting for an IP address Blinking 1-1-1 Starting the EOS Blinking 1-3-1 Starting the TFTP process Blinking 1-5-1 Configuration returned to factory defaults Off No power detected Varying brightness Signal strength relates to brightness or dimness of the light On Physical network detected Off No
Device Server EIA 232/422/485 Switch Settings Switch Settings Function 1 2 3 4 EIA-232 Up Down Down Down EIA-422/485 Full-duplex Down Up Down EIA-485 half-duplex Down Down Up If up, termination.
Standard Models Specifications Power Requirements (Standard Models) 2-contact barrel connector +9 to +30 VDC 525 mA (max) external power supply Environmental Ambient temperature 0 to 50° Celsius 32 to 131° Fahrenheit Relative humidity 5% to 90% non-condensing Altitude 0 to 12,000 feet 0 to 3,658 meters Mechanical Length 13.33 centimeters 5.25 inches Width 8.25 centimeters 3.25 inches Height 3.842 centimeters 1.306 inches Weight .
• • Connect the equipment into an outlet on a circuit different from that to which the receiver is connected. Consult the dealer or an experienced radio/TV technician for help. Labeling Requirements (FCC 15.19) This device complies with Part 15 of FCC rules. Operation is subject to the following two conditions: (1) this device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. Modifications (FCC 15.
Digi Contacts World Wide Web: http://digi.com email digi.info@digi.com Telephone (U.S.
Chapter 19 Reference and Certifications
