background image

I/O Commands

188 

IOLAN Device Server User’s Guide, Version 1.8

trigger-level

Specify the value that will trigger an alarm, the measurement is based on the 

Type

 and 

Range

 that you specify. This value must not fall within the scope of the value used to 

clear an alarm.

clear-mode

Specifies whether an activated alarm must be 

Manually

 cleared, or can be cleared when 

the input drops below the specified value (when 

Trigger Type

 is 

High

) or goes above 

the specified value (when 

Trigger Type

 is 

Low

).

clear-level

Specify that value that will clear an alarm, the measurement is based on the 

Type

 and 

Range

 that you specify. This value must not fall within the scope of the value used to 

trigger an alarm.

snmp

Sends an SNMP trap when an alarm is triggered or cleared. The trap consists of the 
severity level and whether the alarm was triggered or cleared.

syslog

Sends a message to syslog when an alarm is triggered or cleared. The syslog entry 
includes the severity level and the value that caused the alarm to trigger or clear. The 
syslog message is associated with 

Level Critical

.

Summary of Contents for IOAN DS1

Page 1: ...IOLAN DS Family DS1 TS2 User s Guide Version 1 8 Part 5500162 18 November 2006...

Page 2: ...Limited 2004 2006 FCC Note The IOLAN Device Server has been found to comply with the limits for a Class A digital device pursuant to Part 15 of the FCC rules These limits are designed to provide reas...

Page 3: ...Technical Support Query 21 Who To Contact 21 Have Your Product Information Ready 21 Making a support query via the Perle web page 21 Repair Procedure 22 Feedback on this Manual 22 Chapter 1 Introducti...

Page 4: ...t s Included 27 What You Need to Supply 27 Available Accessories 27 Getting to Know Your Device Server 28 DS1 28 TS2 28 LED Guide 29 Console Mode vs Serial Mode 29 Powering Up the Device Server 29 Pow...

Page 5: ...RTD 4 Wire 37 Relay Output 37 Normally Open Contact 37 Normally Closed Contact 38 Setting an Initial IP Address 38 Using DeviceManager 39 Using a Direct Connection 40 Using DHCP BOOTP 40 Using ARP Pin...

Page 6: ...erver 55 Introduction 55 Configuring the Device Server 55 General Device Server Configuration 55 Device Server Services 55 TruePort 56 Hardware Configuration 56 Ethernet Connection 56 Serial Connectio...

Page 7: ...rtual Modems 64 BIDIR 64 TruePort 64 Signal I O 64 UDP 65 Serial Tunnel Settings 66 Setting Up Users 66 User Accounts 66 User Levels 67 Sessions 67 Users From LAN to Device Server to Serial Device 67...

Page 8: ...s 75 UDP 75 UDP Unicast Format 75 UDP Unicast Example 76 I O Modbus Slave 76 Modbus Serial Application Connected to the Serial Port 76 Modbus Serial Application Connected to the Network 77 Modbus TCP...

Page 9: ...evice Server 89 Adding Deleting Static Device Servers 89 Creating a New Device Server Configuration 90 Opening an Existing Configuration File 90 Connecting to a Device Server 90 Managing a Device Serv...

Page 10: ...ettings 105 Remote IP Slave Mappings 106 Custom App Settings 107 TruePort Settings 108 Packet Forwarding 109 Configuring Modems 111 Configuring I O 112 Global Settings 112 Temperature Settings 112 Fai...

Page 11: ...131 Getting a Configuration File 131 Configuring Multiple Device Servers 131 Downloading Device Server Firmware 132 Setting the Device Server s Date and Time 133 Rebooting the Device Server 133 Reset...

Page 12: ...m App 141 Show Modbus 141 Show Server 141 Hardware Commands 142 Set Ethernet 142 Show Hardware 142 Modbus Commands 142 Set Modbus Gateway 142 Show Modbus 143 TruePort Baud Commands 144 Set TruePort Re...

Page 13: ...58 Set Line Service 159 Set Modem 161 Set Termtype 161 Show Line 161 Line Service Commands 162 Set Custom App 162 Set Telnet Client 162 Set UDP 163 Set Vmodem 163 Set Modbus Slave Line 164 Set Modbus...

Page 14: ...st 171 Delete Host 171 Set Host 171 Show Hosts 171 Gateway Commands 172 Add Gateway 172 Delete Gateway 172 Set Gateway 173 Show Gateways 173 Logging Commands 174 Set Syslog 174 Show Syslog 174 Time Co...

Page 15: ...e 179 I O Commands 179 Global I O Commands 179 Set IO UDP 179 Set IO Failsafe 180 Set IO Modbus 180 Set IO Temperature Scale 180 Set Line 181 Set Line Service 181 Set IOChannel 181 Set IOChannel Mode...

Page 16: ...log Input Analog Temperature 193 Calibrate Analog 193 Reset Calibration 193 Appendix A Troubleshooting 195 Introduction 195 Hardware Problems 195 Communication Issues 195 DeviceManager Problems 196 Ho...

Page 17: ...odes 201 Appendix C Accessories 203 Introduction 203 Starter Kit Adapters Cable 203 RJ45F to DB25M DTE Crossover Adapter 204 RJ45F to DB25M DCE Modem Adapter 205 RJ45F to DB25F DTE Crossover Adapter 2...

Page 18: ...Table of Contents 18 IOLAN Device Server User s Guide Version 1 8...

Page 19: ...amples in this guide z If you are using an external authentication application s working knowledge of the authentication application s z Knowledge of TFTP the transfer protocol the Device Server uses...

Page 20: ...ample of output Set the value to TRUE The typeface used for TRUE is also used when referring to an actual value or identifier that you should use or that is used in a code example subscribe project su...

Page 21: ...he following information ready Making a support query via the Perle web page If you have an internet connection please send details of your problem to Technical Support using the email links provided...

Page 22: ...t can submit repair details via a website form This form is on the Perle website www perle com in the Support area Click here to access our web site at the following URL http www perle com support_ser...

Page 23: ...le connection options There is also a line of DS models that support Analog Input Temperature Input Relay Output and or Digital I O z TS The model does everything the DS model does plus has two RJ45 s...

Page 24: ...and Rx activity indicators z External AC power supply or power over serial z LEDs for diagnostic testing z Self test on power up z Reset switch Software The Device Server software features include z M...

Page 25: ...ion to the serial port using a Serial Terminal or Terminal Emulation Software z From the network through the ethernet interface using reverse Telnet Port 23 z Through an SNMP agent using the Device Se...

Page 26: ...n 1 8 Network Security The Device Server provides a comprehensive suite of security features to allow an organization to implement robust security planning to prevent unauthorized access These include...

Page 27: ...s z Quick Start Guide for I O models a soft copy exists on the CD ROM z Warranty Card z A CD ROM containing documentation firmware DeviceManager etc z Administration cable consisting of an RJ45 DB9F a...

Page 28: ...TS2 This section describes the components found on the TS2 Device Server model Serial Activity Power LAN Connection LAN Activity Serial Connection Power Supply Console Serial Mode Switch Reset to Fac...

Page 29: ...vice Server accessed by the Admin user to configure manage the Device Server You can connect directly to the Device Server in Serial mode but the Device Server will not display all the messages inform...

Page 30: ...Device Server jumpers if you want to terminate the line I O Models Before you attach the Device Server to your network or try to configure it we suggest that you power it up to verify that it works p...

Page 31: ...ing from the box 2 Open the case by unscrewing the two side screws one on each side and lifting off the top of the case You should see the following 3 To turn line termination on locate and jumper bot...

Page 32: ...ew settings 2 Port Device Server To change the settings do the following 1 Unplug the Device Server from the electrical outlet and disconnect everything from the box 2 Open the case by unscrewing the...

Page 33: ...rounding screw and lifting off the top of the case You should see the following configuration for the Digital I O board 3 To configure either Channel 1 or Channel 3 depending on how many Digital chann...

Page 34: ...nfigure Channel 1 for Voltage no jumper should be set as shown this is the default setting To configure Channel 2 for Current jumper both J2 pins as shown 4 Close the Device Server case by replacing t...

Page 35: ...power source is supplied by the COM common connector Digital Output Sink For a Digital output sink ground configuration for channel D1 follow the diagram below Digital Output Source For a Digital out...

Page 36: ...d cable connect the positive wire to A1 the negative wire to A1 and optionally the shield to GND If you have the positive negative wires reversed the polarity of the voltage will be reversed Temperatu...

Page 37: ...D configuration connect the return wire to A1 the excite wire to A1 the sense wire to A1s and leave the fourth wire disconnected Relay Output Normally Open Contact To connect Relay channel R1 for a ci...

Page 38: ...r directly to a dumb terminal essentially logging directly into the Device Server Using this method you will need to configure and or manage the Device Server using either the Menu or CLI z DHCP BOOTP...

Page 39: ...rary IP address to to open a configuration session Type superuser the factory default Admin user password in the Login window and click OK 9 Expand the Server Configuration folder and select Server Yo...

Page 40: ...sing a direct connection see Chapter 3 Configuration Methods on page 51 and or Chapter 6 Command Line Interface on page 137 After you complete configuring the Device Server unplug the Device Server Ch...

Page 41: ...X Linux host type the following arp s a b c d aa bb cc dd ee ff On a Windows 98 or newer system type the following arp s a b c d aa bb cc dd ee ff where a b c d is the IPv4 address you want to tempora...

Page 42: ...ovides pinout information The power in pin pin 12 can be 9 30V DC Pinout EIA 232 EIA 422 EIA 485 Full Duplex EIA 485 Half Duplex 1 Shield Shield Shield Shield 2 out TxD 3 in RxD 4 out RTS 5 in CTS 6 i...

Page 43: ...The power in pin pin 12 can be 9 30V DC Pinout EIA 232 EIA 422 EIA 485 Full Duplex EIA 485 Half Duplex 1 Shield Shield Shield Shield 2 out RxD 3 in TxD 4 out CTS 5 in RTS 6 in DTR 7 GND GND GND GND 8...

Page 44: ...defines the pinouts for the DB9 male connection used on the 1 port Device Server that is serial only not I O The following table provides pinout information Pinout 10 pin Pinout 8 pin EIA 232 EIA 422...

Page 45: ...nnection used on the 1 port Device Server I O models The following table provides pinout information Pinout 9 pin EIA 232 EIA 422 485 Full Duplex EIA 485 Half Duplex 1 in DCD 2 in RxD RxD 3 out TxD Tx...

Page 46: ...al DB25 Connector The following diagrams show how the null modem cable should be configured when connecting to a terminal DB25 DB25 Male DB25 Female IOLAN DS1 DB25 DTE Terminal DB25 DTE 2 TxD 3 RxD 3...

Page 47: ...Terminal DB25 DTE 10 pin 8 pin 4 DSR 3 20 DTR 3 RTS 2 5 CTS 5 TxD 4 3 RxD 6 RxD 5 2 TxD 7 GND 6 7 GND 8 CTS 7 4 RTS 9 DTR 8 6 DSR IOLAN DS1 DB9 Male Terminal DB25 DTE 3 TxD 3 RxD 2 RxD 2 TxD 7 RTS 5...

Page 48: ...ble should be configured when connecting to a DB25 modem DB25 Male RJ45 IOLAN DS1 DB25 DTE Modem DB25 DCE 2 TxD 2 RxD 3 RxD 3 TxD 4 RTS 4 CTS 5 CTS 5 RTS 6 DSR 6 DSR 7 GND 7 GND 8 DCD 8 DCD 20 DTR 20...

Page 49: ...49 EIA 232 Cabling Diagrams DB9 Male IOLAN DS1 DB9 Male Modem DB25 DCE 1 DCD 8 DCD 2 RxD 3 TxD 3 TxD 2 RxD 4 DTR 20 DTR 5 GND 7 GND 6 DSR 6 DSR 7 RTS 4 CTS 8 CTS 5 RTS...

Page 50: ...EIA 232 Cabling Diagrams 50 IOLAN Device Server User s Guide Version 1 8...

Page 51: ...D ROM included with the Device Server Through the DeviceManager you can z assign an IP address to new Device Servers z perform firmware updates z create configuration files which can be immediately do...

Page 52: ...ull explanation of how to use the CLI Menu The Menu is a window oriented Device Server configuration and user access option To manage the Device Server you will also need to use the CLI WebManager or...

Page 53: ...options available for a field you can scroll through those items by pressing the Space Bar or you can type l lowercase L to get a list of options use the up down arrows to highlight the option you wan...

Page 54: ...rameters under the ServicesInfo folder The first variable in each folder is the Status variable for example serviceStatus When you perform a GET on this variable one of the following values will be re...

Page 55: ...erver is it can run several predefined daemon and client applications The Device Server can run the following daemon applications z TelnetD z SPCD the TruePort daemon z DeviceManagerD z HTTPD z SNMPD...

Page 56: ...e Device Server to the serial device Ethernet Connection You need to know the ethernet interface speed and duplex as follows unless you are using the Auto detect option z 10 Mbps half or full duplex z...

Page 57: ...k in your environment if they don t configure as required 2 Set the Line Service parameter to Modbus Master for the Line connected to the Modbus serial Master 3 In the Modbus Master settings map the M...

Page 58: ...ice Server Each Modbus Master can communicate to UIDs 1 247 Modbus Slave Gateway The Device Server acts as a Slave Gateway when the Modbus Master resides on the TCP Ethernet network and the Modbus Sla...

Page 59: ...onfigured for those remote Modbus TCP Slaves Modbus Slave Settings When you have Modbus Slaves on the serial side of the Device Server configure the Line as a Modbus Slave There is only one Slave Gate...

Page 60: ...Master itself The Device Server will act as a Master Gateway for the Modbus serial Master and allow it to communicate to the remote Modbus TCP Slaves By configuring the Device Server s own IP address...

Page 61: ...the Modbus Slaves on the serial side of the Device Server the Device Server must also be configured to be a Slave Gateway The Modbus Slaves on a serial port attached to the Device Server must be conne...

Page 62: ...ock the door Users Connecting to Serial Devices For a user to connect to the serial device connected to the Device Server from the LAN the Line Service must be set to Rev Telnet The user will either a...

Page 63: ...vice is set to Dir Telnet When User Service Dir Telnet is selected the IP address of the HR_Server is specified as the target Host IP User Dennis will always have to log into the same server with this...

Page 64: ...o use multiple modems avoiding the associated costs of calls and connections The data is sent in raw format from the virtual modem and can be received by another Device Server or a host This data can...

Page 65: ...l UDP data received from hosts that have an IP address that falls within the range of 172 16 1 20 to 172 16 1 50 and Port 33010 will be sent to the serial device The Device Server will not send any da...

Page 66: ...he other port Setting Up Users You can create up to four users in addition to the Admin user who cannot be deleted A user can even represent a device like a barcode or a card swipe device that you wan...

Page 67: ...the prompt ends with a whereas all other users prompts ends with a or depending on the character set Sessions Sessions are defined for users who are coming in through a serial device going to a host o...

Page 68: ...efore if this number is set to 5 the total number of reverse sessions allowed on the line is 5 1 or 6 The default and minimum value is 0 which means that reverse Multisessions is disabled and you only...

Page 69: ...Device Server or to view statistics or traps you must set up a User in SNMP version 3 or a Community in SNMP version 1 2 to allow your SNMP manager to connect to the Device Server this can be done in...

Page 70: ...If as Admin user you change your language setting to Customlang you will see the text menus display in the new language when you save and exit the Change User form Translation Guidance To help you wi...

Page 71: ...le to page through sessions properly When installed the Device Server has several defined terminal types Dumb WYSE60 VT100 ANSI TVI925 IBM3151 VT320 and HP700 If you are not using or cannot emulate an...

Page 72: ...pairs These pairs map the characters used by the terminal for graphics characters to those of the standard VT100 character set Include only the following character pairs jx kx lx mx qx tx ux and xx w...

Page 73: ...se drive letters in the file path Resetting Configuration Parameters You can reset the Device Server to its factory settings through any of the following methods z You can push in the recessed button...

Page 74: ...l path pre fixed by a hostname IP address IPv4 or IPv6 and file name of a termcap file for a specific terminal type Creating Custom Applications You can create custom applications for the Device Serve...

Page 75: ...a data format for example digital data or you do not have any channels configured for a data format it will be included in UDP broadcast package with a Total Length of 0 zero and no data following Ea...

Page 76: ...Modbus Slave If you have a Modbus serial or TCP application it can access I O connected to the Device Server when the I O Global Modbus Slave is enabled You must supply a unique UID for the Device Se...

Page 77: ...odbus serial or Modbus serial TruePort Function Codes The following function codes are supported by the Device Server z 01 read coils z 03 read multiple holding registers z 04 read input registers z 0...

Page 78: ...G_IR_CURR_RAW 2086 2118 2150 2182 R MB_REG_IR_MIN_RAW 2087 2119 2151 2183 R MB_REG_IR_MAX_RAW 2088 2120 2152 2184 R MB_REG_IR_ALARM_LEVEL 2089 2121 2153 2185 R Data Model A1 A2 A3 A4 D1 R1 D2 R2 R W C...

Page 79: ...6146 6147 6148 R MB_REG_DI_SENSOR_ALARM_STATE 6209 6210 6211 6212 R W MB_REG_DO_SENSOR 6657 6658 6659 6660 R W Holding Registers MB_REG_HR_DI_SENSOR_LATCH 6145 6146 6147 6148 R W MB_REG_HR_DO_SENSOR_...

Page 80: ...nning TruePort must be in Modbus ASCII or Modbus RTU mode API Over TruePort Only If you have a custom application that talks to a serial port you can use TruePort as a virtual serial port to communica...

Page 81: ...e to active or active to inactive z You can choose to invert the signal which is useful if your sensor is wired in such a way that closed is actually inactive whereas closed is normally considered act...

Page 82: ...usly or for a specified number of pulse counts z You can choose to manually activate deactivate the Digital output and then specify a delay before the output goes from inactive to active or active to...

Page 83: ...sor with an alarm set to send a syslog message if the temperature rises above 31o C z Pt100 a 385 50 to 150C z Pt100 a 392 50 to 150C z Pt1000 a 385 40 to 160C z Pt100 a 385 0 to 100C z Pt100 a 392 0...

Page 84: ...ed to monitor humidity transducers which are in place to help prevent freezer burn If the humidity reaches a certain percentage monitored by an Analog channel a syslog message is sent to the Monitorin...

Page 85: ...ed see Failsafe Timer on page 74 for more information In our industrial freezer warehouse a Device Server A4R2 is used to monitor humidity transducers which are used to help prevent freezer burn If th...

Page 86: ...ent you will need a calibration meter that is better than 1 current precision Each channel needs to be calibrated individually Calibrating Temperature Input To calibrate an Analog Temperature input ch...

Page 87: ...viceManager has already been installed if you still need to install the DeviceManager see Using DeviceManager on page 39 Starting a New Session When you start the DeviceManager application the New Ses...

Page 88: ...erver window will be empty To add Device Servers to the Device Server List you can do either of the following z Click the Search Local Network button This searches the local network segment and automa...

Page 89: ...vice Server type in the factory default Admin password superuser and click OK The DeviceManager will display a window indicating that it is trying to authenticate and connect you on the Device Server...

Page 90: ...binary format dme or as a text file txt which can be edited with a text editor Either configuration version can be imported into the DeviceManager Connecting to a Device Server To connect to a Device...

Page 91: ...ntains the Device Server s factory default settings Working With the Device Server Configuration When you connect to a Device Server the configuration that is saved to FLASH is automatically uploaded...

Page 92: ...name for your domain your location in the global network Like Hostname it is a symbolic rather than a numerical identifier See IPv6 Network on page 41 for information on how to determine your IPv6 add...

Page 93: ...erver side applications will get a socket connection refused until z All data from previous connections on that serial port has drained z There are no other connections z Up to a 1 second interconnect...

Page 94: ...me When enabled the Server Name is displayed in the Device Server login prompt CLI prompt WebManager login screen and the heading of the Menu The default value is Off Ethernet Speed and Duplex Define...

Page 95: ...configuring each Line Service DS Port The Device Server port number Terminal Type Specifies the type of terminal connected to the line z Dumb z WYSE60 z VT100 z ANSI z TVI925 z IBM3151TE z VT320 speci...

Page 96: ...to the user and transmitted across the serial ports Some EIA 485 applications require local echo to be enabled in order to monitor the loopback data to determine that line contention has occurred If y...

Page 97: ...rk on the line If your user is remote and will be dialing in via modem or ISDN TA set this parameter to In if the Device Server is being used as a router set this parameter to either In Out or Both de...

Page 98: ...l send a gratuitous ACK to the network peer either ensuring the connection stays active OR causing a dropped connection condition to be recognised by the reverse raw service Applications using this fe...

Page 99: ...by the user for the telnet session any parameters that are also available in the user s configuration are overridden by the user s definitions See Telnet Settings on page 100 for information on the Te...

Page 100: ...target host is listening on for incoming connections Terminal Type Type of terminal attached to this line for example ANSI or WYSE60 Host Name The name of the target host Port The port number the targ...

Page 101: ...the end of file character When Line Mode is On entering the eof character as the first character on a line sends the character to the remote host This value is in hexadecimal with a default value of 4...

Page 102: ...om and or send messages to End IP Address The last host IP address in the range of IP addresses for IPV4 not required for IPV6 that the Device Server will listen for messages from and or send messages...

Page 103: ...6 for more information about how to configure the Device Server for a serial tunnelling It is important that the Client Tunnel Port parameter reflect the DS Port set for the Line when the Device Serve...

Page 104: ...igures the parameters for Modbus Slaves residing on the serial side of the Device Server See Modbus Configuration on page 57 for more information about how to configure the Device Server for a Modbus...

Page 105: ...wing parameters Modbus RTU Select this option if the Modbus Slave is configured using the Modbus RTU protocol Modbus ASCII Select this option if the Modbus Slave is configured using the Modbus ASCII p...

Page 106: ...Server will automatically increment the last digit of the configured IP address Therefore you can specify a UID range of 1 100 and the Device Server will route Master Modbus messages to all Modbus Sla...

Page 107: ...program executable that has been already been downloaded to the Device Server plus any parameters you want to pass to the program Maximum of 80 characters Use the shell CLI command as described in th...

Page 108: ...IP connection can be initiated from the Device Server to the configured host or from the host to the Device Server depending on the settings Configure the following parameters Host Name The name of t...

Page 109: ...he network A value of zero 0 ignores this parameter Valid values are 0 65535 ms The default is 0 Force Transmit Timer When the specified amount of time in milliseconds elapses after the first characte...

Page 110: ...aracter Specifies the End of Frame character which defines when the frame is ready to be transmitted The actual transmission of the frame is based on the Trigger Forwarding Rule Valid values are in he...

Page 111: ...configure a modem if there is a modem connected to the Device Server Configure the following parameters Modem Name The name of the modem Do not use spaces Modem Initialisation String The initialisatio...

Page 112: ...nually in the I O Status Control or programatically Temperature Scale Select the temperature scale that will be used to display temperature data either Fahrenheit or Celsius The default is Celsius Thi...

Page 113: ...assigning to the Device Server which is acting as a Modbus slave Enable I O TruePort Service Enables disables serial Modbus application access to the I O over the network using the TruePort COM redire...

Page 114: ...ange of IP addresses Start IP Address The first host IP address in the range of IP addresses for IPV4 or IPV6 that the Device Server will listen for messages from and or send messages to End IP Addres...

Page 115: ...software configuration so if you change this setting to Output you will have to also change the internal hardware jumpers Type Specify the type of digital output z Sink Specifies that the channel will...

Page 116: ...dth How long the channel output will be active during the pulse mode Valid values are 1 9999 x 100 ms The default is 100 ms Failsafe Action When there has been no I O activity within the specified tim...

Page 117: ...Clear Mode Specify Manual to manually clear an alarm Specify Auto to automatically clear the alarm when the trigger condition changes for example if the Trigger is Inactive and the alarm is triggered...

Page 118: ...t will go inactive after the specified time interval after it is manually started The default is Manual Pulse Mode When the Output is Pulse you can have it pulse in a Continuous manner or specify a pu...

Page 119: ...rs Configure the following parameters Enable Channel Enables the channel allowing the settings to become active Description Provide a description of the channel making it easier to identify The channe...

Page 120: ...hin the scope of the value used to clear an alarm Clear alarm when input value is Specify that value that will clear an alarm the measurement is based on the Type and Range that you specify This value...

Page 121: ...decrease in value with each subsequent level If the Trigger Type is High an alarm is triggered when the input is higher than the specified Trigger value other severity level trigger values must incre...

Page 122: ...user Configure the following parameters Enable Channel Enables the channel allowing the settings to become active Description Provide a description of the channel making it easier to identify The chan...

Page 123: ...ve The highest numbered active session will be displayed z a m To exit a session and return to the Device Server You will be returned to where you left off The session will be left running z a l Lower...

Page 124: ...o the Device Server otherwise Customlang defaults to English Service The type of service that the user will use Host IP When the User Service is set to Telnet or TCP_clear the target host IP address I...

Page 125: ...page 122 Configuring the Network The network configuration parameters define the network that the Device Server will be operating within Configuring Hosts One of the first things you will probably wan...

Page 126: ...ver from an SNMP manager This name will define the permissions of the manager Internet Address The IP address of the SNMP manager that will send requests to the Device Server If the address is 0 0 0 0...

Page 127: ...the Device Server will wait for a successful transmit or receipt of TFTP packets before retrying a TFTP transfer Enter a value between 3 and 10 The default is 3 seconds Host You can specify up to twen...

Page 128: ...messages will be displayed on the host s monitor Secondary Host If the Device Server cannot communicate with the primary host then the Device Server will attempt to send system log messages to this p...

Page 129: ...dress of the server that contains the configuration or firmware file If you use a host name it must exist in the Device Server s host table or be resolved by DNS Firmware File The path and file name d...

Page 130: ...he Device Server s environment Kill Channel Resets the highlighted channel click on a channel to highlight it Clear Alarm Clears the alarm Note that if the condition that tripped the alarm still exist...

Page 131: ...ext when you select Tools Get Configuration Import from File The DeviceManager can also get the configuration from the Device Server it s connected to when you select Tools Get Configuration Upload fr...

Page 132: ...complete you will be prompted to reboot the Device Server You can choose to reboot the Device Server at another time by selecting Tools Reboot Server Upgrading the firmware does not affect the Device...

Page 133: ...configuration parameters and click the Apply button you can reset the line to test the changes by selecting Tools Kill Line If you are happy with the configuration changes you can download the config...

Page 134: ...nal Type Term2 in the Line window to use that terminal definition See Creating Terminal Definition Files on page 71 for information on creating custom terminal definitions Downloading a Language File...

Page 135: ...proceed You are now prompted to apply 20 mA to the positive and negative terminals Once that is done click Yes to proceed Once calibration is successfully completed click OK to finish the process Res...

Page 136: ...e following parameters z Statistics Specify whether or not you want to have the statistics automatically refresh and the refresh rate Retry The number of times the DeviceManager will attempt to transf...

Page 137: ...will use the following command to break down the command syntax set service dhcp bootp on off telnetd on off httpd on off snmpd on off spcd on off syslog on off dmgrd on off Square brackets show the o...

Page 138: ...plete the option as it was typed Command Options When you are typing commands on the command line while connected to the Device Server you can view the options by typing a question mark after any part...

Page 139: ...r specifies Line 1 Description Sets server parameters User Level Admin Syntax set server banner on off bypass password on off domain string flush on close on off internet IPV4_address name string oem...

Page 140: ...hat serial port has drained z There are no other connections z Up to a 1 second interconnection poll timer has expired This also enables a per connection keepalive TCP keepalive feature After approxim...

Page 141: ...on process in the Device Server on port 161 spcd SPC Trueport daemon process in the Device Server on port 688 syslog Syslog client process in the Device Server dmgrd DeviceManager daemon process in th...

Page 142: ...or the Device Server User Level Admin Syntax set modbus gateway addr mode embedded re mapped broadcast on off char timeout number req next delay number exceptions on off idle timer number mess timeout...

Page 143: ...e connection The default is 10 seconds mess timeout Time to wait in milliseconds for a response message from a Modbus TCP or serial slave depending if the Modbus Gateway is a Master Gateway or Slave G...

Page 144: ...00 4800 9600 19200 38400 57600 115200 230400 28800 custom baud_rate The actual baud rate that runs between the Device Server and the connected serial device You can also specify a custom baud rate val...

Page 145: ...t_size _of_packets Options hostname IP_address The name host name or DNS name or IP address of the machine you are trying to ping verify the connection with packet_size Enter the number of data bytes...

Page 146: ...ou to the Device Server Menu z a n Display the next session The current session will remain active The lowest numbered active session will be displayed z a p Display the previous session The current s...

Page 147: ...ser logs into the Device Server telnet options See Set Telnet Client on page 162 Description Shows the users who are on the line User Level Admin Syntax show line users Description Starts stops or dis...

Page 148: ...to carriage return line feed CRLF The default value is Off local echo Toggles between local echo of entered characters and suppressing local echo Local echo is used for normal processing while suppre...

Page 149: ...1d ASCII value GS Description Displays firmware version and build User Level Normal Admin Syntax version Description Adds a user You can add and configure up to four users in the Device Server User L...

Page 150: ...paces and locks the line Next the user must retype the password to unlock the line z r When you switch from a session back to the Menu the screen may not be redrawn correctly If this happens use this...

Page 151: ...ice line Options are z Read Write Users are given read and write access to the line z Read In Users are given access to read only outbound data data that is going from the Device Server to the device...

Page 152: ...l be left running z a l Lowercase L Locks the line until the user unlocks it The user is prompted for a password any password excluding spaces and locks the line Next the user must retype the password...

Page 153: ...word the user will need to enter to login to the Device Server line access Specifies the user access rights to each Device Server device line Options are z Read Write Users are given read and write ac...

Page 154: ...et set user username session 1 2 3 4 telnet options host config_host port TCP_port termtype terminal_name line mode on off map cr crlf on off local echo on off echo 00 7f eof 00 7f erase 00 7f intr 00...

Page 155: ...DN TA set this parameter to In if the Device Server is being used as a router set this parameter to either In Out or Both depending on which end of the link your Device Server is situated and how you...

Page 156: ...d from the peripheral is not passed to the client properly If the client wishes to make the break act like an interrupt key for example when the stty options ignbrk and brkintr are set flowin Determin...

Page 157: ...user for a password and a confirmation motd Enables disables the message of the day on the line user For DSLogin line service makes this a line that is dedicated to the specified user Only this user w...

Page 158: ...134 150 200 300 600 1200 1800 2400 4800 9600 19200 38400 57600 115200 230400 28800 custom baud_rate Options eia 232 eia422 485 Specifies the type of line that is being used with the Device Server Sel...

Page 159: ...is affected by the length of the cable You can also specify a custom baud rate valid values are 50 230400 Description Sets the service for the line For services that need further configuration see Li...

Page 160: ...ection on an external machine attached to a port For example to access machines like protocol converters statistical multiplexors or machines like routers firewalls servers etc dslogin The default con...

Page 161: ...3 refer to the user uploadable custom terminal definitions If these are not present the default is wyse60 User Level Restricted Normal Admin Syntax set termtype wyse60 vt100 ansi dumb tvi925 ibm3151te...

Page 162: ...e Type of terminal attached to this line for example ANSI or WYSE60 line mode When On keyboard input is not sent to the remote host until Enter is pressed otherwise input is sent every time a key is p...

Page 163: ...ons outbound_port The port that the Device Server will use to relay messages to servers hosts The Device Server will listen for UDP packets on the port configured by the DS Port parameter start_ip_add...

Page 164: ...connected device otherwise these indications are suppressed Description Sets the Modbus slave parameters for the line SSL TLS can be enabled and configured for this Line Service User Level Admin Synt...

Page 165: ...t is used between the Modbus Master and Modbus Slave s either TCP or UDP range mode If you specify Host the IP address is used for the first UID specified in the range The last octect in the IPv4 addr...

Page 166: ...escription Shows the UDP settings for the line User Level Admin Syntax show udp Description Show the vmodem settings for the line User Level Normal Admin Syntax show vmodem Description Adds a modem Us...

Page 167: ...rding rule trigger1 trigger 1 trigger 2 strip trigger sof1 0x0 FF sof2 0x0 FF start frame transmit on off Options enable end trigger1 Enable or disable the end trigger1 hex character enable end trigge...

Page 168: ...OF1 EOF2 Trigger1 or Trigger1 Trigger2 depending on your settings z Trigger 1 Includes the EOF1 EOF1 EOF2 Trigger1 or Trigger1 Trigger2 depending on your settings plus the first byte that follows the...

Page 169: ...ost ip_address The host name of the SNMP community that will send requests to the Device Server The IP address of the SNMP manager that will send requests to the Device Server If the address is 0 0 0...

Page 170: ...p_number Option config_trap_number When you add an SNMP trap it gets assigned to a number To delete the SNMP trap you need to specify the number of the trap that you want to delete To see which trap i...

Page 171: ...t or receipt of TFTP packets before retrying a TFTP transfer Enter a value between 3 and 10 The default is 3 seconds Description Adds a host to the Device Server host table User Level Admin Syntax add...

Page 172: ...le default host network Specify the type of gateway z Default A gateway which provides general access beyond your local network z Host A gateway reserved for accessing a specific host external to your...

Page 173: ...eneral access beyond your local network z Host A gateway reserved for accessing a specific host external to your local network z Network A gateway reserved for accessing a specific network external to...

Page 174: ...lect Error all Error Critical Alert and Emergency events will be logged primary host The first preconfigured host that the Device Server will attempt to send system log messages to messages will be di...

Page 175: ...rding to the Device Server system clock User Level Normal Admin Syntax show date Description Shows the Device Server s system clock User Level Normal Admin Syntax show time Description Reboots the Dev...

Page 176: ...rebooted host The host name or IP address of the server that contains the configuration or firmware file If you use a host name it must exist in the Device Server s host table or be resolved by DNS De...

Page 177: ...that you are going to upload a configuration file from the Device Server to the specified host or IP address crash Specifies that you are going to upload a crash file from the Device Server to the spe...

Page 178: ...istening Displays server listening ports by default listening ports are not displayed tcp Displays TCP port statistics udp Displays UDP port statistics tcpv6 Displays TCPv6 port statistics udpv6 Displ...

Page 179: ...and seconds since the last reboot power cycle User Level Admin Syntax uptime Description Sets the UDP settings for I O unicast messages User Level Admin Syntax set io udp mode on off broadcast interv...

Page 180: ...ed time interval the Failsafe Action set for the channel determines the action on the output timeout The number of seconds that must elapse with no I O activity before the channel Failsafe Action is t...

Page 181: ...nabled disabled description string Options i o_channel Specify the channel number for example d2 or a4 Temperature models use Analog input so the channel numbers are a1 a4 mode Enables the channel all...

Page 182: ...r an alarm clear Specify Manual to manually clear an alarm Specify Auto to automatically clear the alarm when the trigger condition changes for example if the Trigger is Inactive and the alarm is trig...

Page 183: ...e going active will trigger an alarm clear Specify Manual to manually clear an alarm Specify Auto to automatically clear the alarm when the trigger condition changes for example if the Trigger is Inac...

Page 184: ...is 100 ms inactive signal width How long the channel output will remain inactive during pulse mode Valid values are 1 9999 x 100 ms The default is 100 ms failsafe action When there has been no I O act...

Page 185: ...en the Line Service is set to Signal I O User Level Admin Syntax set iochannel rts dtr description string failsafe action none activate outut deactivate output mode enabled disabled Options descriptio...

Page 186: ...started The default is Manual pulse When the Output is Pulse you can have it pulse in a Continuous manner or specify a pulse Count each count consists of an active inactive sequence The default is Co...

Page 187: ...trigger is activated level You can specify up to five alarm trigger clear severity levels If the Trigger Type is Low an alarm is triggered when the input drops below the specified Trigger value other...

Page 188: ...goes above the specified value when Trigger Type is Low clear level Specify that value that will clear an alarm the measurement is based on the Type and Range that you specify This value must not fall...

Page 189: ...ng to measure temperature either RTD or thermocouple The default is RTD range Specify the temperature range that you want to measure For RTD the range is z 1 Pt100 a 385 50 to 150C This is the default...

Page 190: ...m is triggered when the input is higher than the specified Trigger value other severity level trigger values must increase in value with each subsequent level trigger level Specify the value that will...

Page 191: ...ser Level Admin Syntax show iochannel i o_channel show iochannel rts cts dtr dsr dcd Options i o_channel Specify the channel number for example d2 or a4 Temperature models use Analog input so the chan...

Page 192: ...ut Clears the latch value Description Manages the Digital input channel status User Level Admin Syntax iochannel d1 d2 d3 d4 rts dtr output activate deactivate Option output Manually activates deactiv...

Page 193: ...l automatically start requesting that the minimum and maximum calibration values be applied to the requested Analog channel See Calibrating Analog Input on page 86 or Calibrating Temperature Input on...

Page 194: ...I O Commands 194 IOLAN Device Server User s Guide Version 1 8...

Page 195: ...re this problem appears contact your distributor otherwise see the Perle web site www Perle com for factory service information Note no factory service can be done on a Device Server that has not been...

Page 196: ...ccess a host on a local network verify z The network address is correct z The subnet mask is set correctly and reflects the network configuration z The broadcast address is set correctly and reflects...

Page 197: ...eyboard nothing happens or your sessions keep swapping z Change your Hotkey Prefix character The function keys on the keyboards of some terminals like WYSE60 send character sequences which begin with...

Page 198: ...s in your bootfile has no TFTP server running z Verify that lease data in your DHCP server manager is correct z Reset or restart the DHCP server Language Problems In a customised language the text str...

Page 199: ...evice Server You use TruePort when you want to connect extra terminals to a server using a Device Server rather than a multi port serial card TruePort is especially useful when you want to improve sec...

Page 200: ...sters on page 78 A4D2 A4R2 Registers on page 78 or D4 D2R2 Registers on page 79 for this value 2 Number of registers n Data for write Some values must be read written as a unit consisting of 2 consecu...

Page 201: ...er or slave 02 Illegal Data Address The data address received in the query is not an allowable address for the server or slave 03 Illegal Data Value A value contained in the query data field is not an...

Page 202: ...API I O Access Over TruePort 202 IOLAN Device Server User s Guide Version 1 8...

Page 203: ...to find out how to order the products listed in this appendix Starter Kit Adapters Cable The IOLAN Starter Kit includes the following z RJ45F to DB25M DTE Crossover Adapter z RJ45F to DB25M DCE Modem...

Page 204: ...1 8 RJ45F to DB25M DTE Crossover Adapter The following diagram shows the IOLAN Device Server RJ45F DB25M DTE crossover adapter pinouts This is model number DBA0011 RJ45F DB25M DTE TxD 4 3 RxD RxD 5 2...

Page 205: ...DB25M DCE Modem Adapter The following diagram shows the IOLAN Device Server RJ45FJDB25M DCE modem adapter pinouts This is model number DBA0013 RJ45F DB25M TxD 4 3 RxD RxD 5 2 TxD GND 6 7 GND DTR 8 20...

Page 206: ...on 1 8 RJ45F to DB25F DTE Crossover Adapter The following diagram shows the IOLAN Device Server RJ45JDB25F DTE crossover adapter pinouts This is model number DBA0010 RJ45F DB25F TxD 4 3 RxD RxD 5 2 Tx...

Page 207: ...to DB9M DTE Crossover Adapter The following diagram shows the IOLAN Device Server RJ45JDB9M crossover adapter pinouts This is model number DBA0021 RJ45F DB9M TxD 4 2 RxD RxD 5 3 TxD GND 6 5 GND DTR 8...

Page 208: ...able for Rack Mount Models This is a 3 meter RJ45MJRJ45M 8 wire Sun Cisco modular cable The following diagram shows how the IOLAN DS RJ45M cable is configured when connecting to the supplied Sun Cisco...

Page 209: ...Device Server User database Modem Initialization String A series of commands sent to the modem by a communications program at start up These commands tell a modem how to set itself up in order to com...

Page 210: ...Glossary 210 IOLAN Device Server User s Guide Version 1 8...

Page 211: ...wnloading to multiple servers 131 editing 91 formats 90 configuring hardware 56 configuring multiple Device Servers 131 connecting to Device Server setting IP address 38 connecting to the Device Serve...

Page 212: ...s configuration overview 57 example scenario 60 gateway settings 58 I O access 77 line settings 59 TruePort 80 mode console 29 serial 29 models Device Server 23 modem parameters 111 MOTD parameters 12...

Page 213: ...anager 39 direct connect 40 IPv6 41 signal I O general 64 silent connections 64 SNMP parameters 126 supported traps 126 using 54 syslog parameters 128 T technical support contacting 21 online 21 produ...

Page 214: ...Index 214 IOLAN Device Server User s Guide Version 1 8...

Reviews: