IOLAN DS1/TS2 Command Line Interface Reference Guide Version 4.
Copyright Statement This document must not be reproduced in any way whatsoever, either printed or electronically, without the consent of: Perle Systems Limited, 60 Renfrew Drive Markham, ON Canada L3R 0E1 Perle reserves the right to make changes without further notice, to any products to improve reliability, function, or design. Perle, the Perle logo, and IOLAN are trademarks of Perle Systems Limited. Perle Systems Limited, 2004-2013.
Table of Contents Preface ...............................................................................11 About This Book ........................................................................ 11 Intended Audience.................................................................... 11 Typeface Conventions............................................................... 11 Contacting Technical Support.................................................. 12 Making a Technical Support Query ....................
Show Server............................................................................................ 19 Hardware Commands ................................................................ 20 Set Ethernet ............................................................................................ 20 Show Hardware....................................................................................... 20 Modbus Commands...................................................................
Syslog Console....................................................................................... 29 Show Sessions ....................................................................................... 29 Show Termtype....................................................................................... 29 Start ......................................................................................................... 29 Telnet ............................................................................
Set Line Initiate-Connection .................................................................. 51 Show Custom-App ................................................................................. 52 Show Interface ........................................................................................ 52 Show Modbus ......................................................................................... 52 Show Telnet-Client .................................................................................
Show Hosts ............................................................................................. 61 Gateway Commands.................................................................. 61 Add Gateway........................................................................................... 61 Delete Gateway ....................................................................................... 61 Set Gateway ............................................................................................
Custom Factory Default ............................................................ 69 Netload .................................................................................................... 69 Set ............................................................................................................ 70 MOTD Commands...................................................................... 70 Set MOTD ................................................................................................
Set IOChannel Digital Output (Serial Pins) .......................................... 79 Set IOChannel Relay .............................................................................. 79 Set IOChannel Analog (True Analog) ................................................... 80 Set IOChannel Analog (Temperature)................................................... 82 Set IOChannel IOExtension ................................................................... 84 Set IOChannel Multihost .....................
Preface About This Book This guide provides the information you need to configure the IOLAN using the Command Line Interface (CLI). Intended Audience This guide is for administrators who will be configuring the IOLAN. Some prerequisite knowledge is needed to understand the concepts and examples 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 IOLAN uses.
Contacting Technical Support Contacting Technical Support Making a Technical Support Query Who To Contact Note: Perle offers free technical support to Perle Authorised Distributors and Registered Perle Resellers. If you bought your product from a registered Perle supplier, you must contact their Technical Support department; they are qualified to deal with your problem.
Contacting Technical Support Repair Procedure Before sending a IOLAN for repair, you must contact your Perle supplier. If, however, you bought your product directly from Perle you can contact directly. Customers who are in Europe, Africa or Middle East 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_services/rma_form.
1 Introduction Chapter 1 Introduction This chapter provides the command line interface (CLI) options available for the IOLAN. The commands are grouped by function. CLI Conventions This section explains how to interpret the CLI syntax.If you are an existing Terminal Server customer and would like to configure the IOLAN in the native Terminal Server interface, you can type the command ts-config to display and use the native Terminal Server interface (you must have User Level Admin).
CLI Conventions z Options—Provides an explanation of each of the options for a command and the default value if there is one. Some commands do not have any options, so this category is absent. Command Shortcuts When you type a command, you can specify the shortest unique version of that command or you can press the ESC or TAB key to complete the command.
2 Server Commands Chapter 2 This chapter defines all the CLI commands associated with configuring the IOLAN’s server parameters. Server Commands Set Custom-App Description You can create a custom application that can run on the IOLAN using the Perle SDK. User Level Admin set custom-app server program-command-line Syntax Options program-command-line The name of the SDK program executable that has been already been downloaded to the IOLAN, plus any parameters you want to pass to the program.
Server Commands banner This parameter concerns the banner information (product name/software version). This banner information is presented to a user with a login prompt. For security reasons, you can turn off the display of this information. The default is Off. break Enables/disables the existing Reverse Telnet break signal and the out-of-band break signals for TruePort. The default value is Off.
Server Commands netmask The network subnet mask. For example, 255.255.0.0. oem-login When set, and a custom language file is in use, the login prompt will use the string defined in the language file as the login prompt instead of the default prompt, login:. password-limit The number of attempts a user is allowed to enter a password for a serial port connection from the network, before the connection is terminated and the user has to attempt to login again.
Server Commands pre-4.3g data-logging Enable the data logging feature previous toV4.3 firmware. Default: Disabled udp-always-arp This controls whether the IOLAN will attempt an ARP each time there is data to be transmitted and the ARP table does not have a valid ARP entry for the destination. When set to "off", a new ARP will only be attempted after a timeout period. Any data to be sent before the timeout elapses, will be silently discarded.
Hardware Commands User Level Admin, Normal show server Syntax Hardware Commands Set Ethernet Description Sets the hardware configuration for the Ethernet port(s).
Modbus Commands Modbus Commands Set Modbus Gateway Description Sets the Modbus parameters for the IOLAN when it is operating as a Modbus Gateway.
TruePort Baud Commands req-queuing When enabled, allows multiple, simultaneous messages to be queued and processed in order of reception. The default is On. remapped-id Specify the UID that will be inserted into the message header for the Slave Modbus serial device. Valid values are 1-247. ip-aliasing When enabled, allows for multiple requests to serial slaves (from an Ethernet Master/s] to be processed simultaneously. Default: Off Show Modbus Description Displays the Modbus Gateway parameters.
IPv6 Commands IPv6 Commands Set IPv6 Description Configures the basic IPv6 settings. User Level Admin set ipv6 [dhcpv6-settings ipv6-address on|off] Syntax [dhcp-settings network-prefix on|off] Set ipv6 enable-ipv6-addressing on|off [obtain-using auto-ipv6|dhcpv6] Options dhcpv6-settings Determines the types of information that the IOLAN will accept from the DHCPv6 server, IPv6 address(es) and/or network prefix(es). ivp6-address When enabled, the IOLAN will accept IPv6 address(es) from the DHCPv6 server.
IPv6 Commands Add Custom-IPv6 Description Adds a custom IPv6 address to the IOLAN. You can specify either a complete IPv6 address or an IPv6 network address. User Level Admin add custom-ipv6 method auto network-prefix Syntax [prefix-bits <0-64>] add custom-ipv6 method manual ipv6-address [prefix-bits <0-128>] Options method auto When this option is specified, the IOLAN will derive an IPv6 address from the entered network prefix and the IOLAN’s MAC address.
IPv6 Commands prefix-bits (auto) Specify the network prefix bits for the IPv6 address. Range: 0-64 Default: 64 method manual Specify this option when you want to enter a specific IPv6 address. ipv6-address Specify the complete IPv6 address. Field Format: IPv6 address prefix-bits (manual) Specify the network prefix bits for the IPv6 address. Range: 0-128 Default: 64 Delete Custom-IPv6 Description Deletes the specified custom IPv6 address.
3 User Commands Chapter 3 This chapter defines all the CLI commands available to users who are logged into the IOLAN. Commands for Users Logged Into the IOLAN Admin Description Changes a Normal-level user to the Admin user. When you press Enter after you type this command, you will be prompted for the Admin password. User Level Normal admin Syntax Help Description Displays help on using the command line interface (CLI).
Commands for Users Logged Into the IOLAN User Level Restricted, Normal, Admin logout Syntax Menu Description Switches from a command line based interface to Menu mode of operation. User Level Restricted, Normal, Admin menu Syntax Ping Description This command checks to see if a given host is reachable via an IP message. The specific message used is called a ping.
Commands for Users Logged Into the IOLAN Option wyse60|vt100|ansi|dumb|tvi925|ibm3151te|vt320|hp700|term1|term2|term3 Specifies the type of terminal connected to the line: z Dumb z WYSE60 z VT100 z ANSI z TVI925 z IBM3151TE z VT320 (specifically supporting VT320-7) z HP700 (specifically supporting HP700/44) z Term1, Term2, Term3 (user defined terminals) Set User Description Sets the current users settings. User Level Normal, Admin set user .
Commands for Users Logged Into the IOLAN User Level Normal, Admin set user . session 1|2|3|4|* [auto on|off] [type off|telnet] Syntax set user . session 1|2|3|4|* telnet-options [host ] [port ] [termtype ] [line-mode on|off] [map-cr-crlf on|off] [local-echo on|off] [echo <00-7f>] [eof <00-7f>] [erase <00-7f>] [intr <00-7f>] [quit <00-7f>] Options session Specifies the session number (or all, *) that you are configuring.
Commands for Users Logged Into the IOLAN Options 1|2|3|4 The number of the session that you want to start. Telnet Description Starts a telnet session to the specified host/IP address.
Configuring Users quit Defines the quit character. Typing the quit character closes and exits the current telnet session. This value is in hexadecimal with a default value of 1c (ASCII value FS). escape Defines the escape character. Returns you to the command line mode. This value is in hexadecimal with a default value of 1d (ASCII value GS). Version Description Displays firmware version and build. User Level Normal, Admin version Syntax Configuring Users Add User Description Adds a user.
Configuring Users hotkey-prefix The prefix that a user types to control the current session. The default value is hex 01, which corresponds to Ctrl-a (^a) (hex value 02 would be Ctrl-b (^b), etc.): z ^a number—To switch from one session to another, press ^a and then the required session number. For example, ^a 2 would switch you to session 2. Pressing ^a 0 will return you to the IOLAN Menu. z ^a n—Display the next session. The current session will remain active.
Configuring Users line-access Specifies the user access rights to each IOLAN device 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 IOLAN to the device. The on|off option is only for 1-port models. You can disable line access in 2-port + models by specifying 0 (zero). phone-number The phone number the IOLAN will dial to callback the user (you must have set Callback to On).
Configuring Users hotkey-prefix The prefix that a user types to control the current session. The default value is hex 01, which corresponds to Ctrl-a (^a) (hex value 02 would be Ctrl-b (^b), etc.): z ^a number—To switch from one session to another, press ^a and then the required session number. For example, ^a 2 would switch you to session 2. Pressing ^a 0 will return you to the IOLAN Menu. z ^a n—Display the next session. The current session will remain active.
Configuring Users line-access Specifies the user access rights to each IOLAN device 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 IOLAN to the device. The on|off option is only for 1-port models. You can disable line access in 2-port + models by specifying 0 (zero). service The type of service that the user will use.
4 Line Commands Chapter 4 This chapter defines all the CLI commands associated with configuring the IOLAN’s line parameters. 1-Port vs. 2-Port Line Commands If you are using a DS1 IOLAN, the admin user does not have the option of using the number or all (*) options in the line commands, as there is only one line. In an TS2 IOLAN, the admin user must specify . (current line), (line number), or * (sets value for all lines) when configuring lines.
Line Commands Elevated User Options set line .||* speed [50|75|110|134|150|200|300|600|1200|1800|2400|4800|9600|19,200|3 8,400|57,600|115,200|230,400|28,800|custom] Note: The save command must be executed by an admin user in order for this parameter to be permanently saved. break Specifies how a break is interpreted: z off—The IOLAN ignores the break key completely and it is not passed through to the host. This is the default setting. z local—The IOLAN deals with the break locally.
Line Commands flowin Determines if input flow control is to be used. Default is On. This is active only when Line Flow Control is set to Soft, Hard, or Both. flowout Determines if output flow control is to be used. Default is On. This is active only when Line Flow Control is set to Soft, Hard, or Both. hotkey-prefix The prefix that a user types to lock a line or redraw the Menu. The default value is hex 01, which corresponds to Ctrl-a (^a) (hex value 02 would be Ctrl-b (^b), etc.
Line Commands internet-address Used with reverse sessions, users can access serial devices connected to the IOLAN by the specified Internet Address (or host name that can be resolved by a DNS). You must reboot the IOLAN for the Internet Address to take affect (the kill line option does not apply to this parameter). keepalive Enables a per-connection TCP keepalive feature.
Line Commands send-name When enabled, the port name will be sent to the host upon session initiation. Default: Disabled session strings Controls the sending of ASCII strings to serial devices at session start and session termination as follows; z Send at Start—If configured, this string will be sent to the serial device when the serial device is detected (i.e. signals come up). The maximum size of this field is 128 bytes/characters. Non printable ascii characters must be entered in this format <027>.
Line Commands discard-characters-in-error When enabled, the IOLAN will discard characters received with a parity or framing error. Default: Disabled. Set Line Interface Description Configures line interface (hardware) parameters. User Level Admin set line .
Line Commands duplex Specify whether the line is Full Duplex (communication both ways at the same time) or Half Duplex (communication in one direction at a time). echo-suppression This parameter applies only to EIA-485 Half Duplex mode. All characters will be echoed 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.
Line Commands The IOLAN port number. The port number the target host is listening on for incoming connections. direct Direct connections bypass the IOLAN, enabling the user to log straight into a specific host. A direct connection is recommended where a user logging in to the IOLAN is not required. It is also recommended where multiple sessions are not a requirement. The message Press return to continue is displayed on the users screen.
Line Commands client-initiated When this option is turned on, the IOLAN will wait for a connection from the TruePort host (see the TruePort documentation for information on how to set up this feature on the TruePort host). When this option is turned off, the IOLAN will initiate the connection to the TruePort host. The default is off.
Line Service Commands Set Termtype Description Sets the terminal type for the current terminal session. term1, term2, and term3 refer to the user-uploadable custom terminal definitions. If these are not present, the default is wyse60.
Line Service Commands Set Telnet-Client Description Configures the Telnet parameters for the specified line. When the IOLAN initiates a Telnet connection to a host, it is acting as a Telnet client. User Level Normal, Admin set telnet-client line .
Line Service Commands Set UDP Description Configures the UDP settings for the serial line. User Level Normal, Admin set udp line .||* entry 1|2|3|4 Syntax both auto-learn|specific [] [] set udp line .||* entry 1|2|3|4 in any-port|auto-learn|specific [] [] set udp line .||* entry 1|2|3|4 out [] [] set udp line .
Line Service Commands Set Vmodem Description This command associates a phone number with an IP address and TCP port. This enables an existing modem application to issue a dial command with a phone number. The phone number will be searched in this table and if an exact match is found, the associated IP address and TCP port will be used to establish the connection. User Level Admin set vmodem line .
Line Service Commands signals dtr You can specify how the DTR signal pin acts during your modem application connection, as itself (DTR), as DCD, or as RI. signals rts You can specify how the RTS signal pin acts during your modem application connection, as itself (RTS), as DCD, or as RI. style One of the following: z Verbose—Return codes (strings) are sent to the connected device.
Line Service Commands Specify the IP address of the remote host that is receiving the vmodem connection. Select the hostname (from the host table) of the remote host that is receiving the vmodem connection. Specify the TCP port that the remote host is listening on for the vmodem connection. delete Deletes the specified entry from the phone number table. Set Modbus-Slave Line Description Sets the Modbus slave parameters for the line. User Level Admin set modbus-slave line .
Line Service Commands port The destination port of the remote Modbus TCP Slave that the IOLAN will connect to. protocol Specify the protocol that 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 address is then incremented for subsequent UID’s in that range. The Host option is not applicable for IPv6 addresses.
Line Service Commands specific-char Initiates a connection to the specified host only when the specified character is received by the serial port. Show Custom-App Description Shows the custom application line settings. User Level Admin show custom-app line .||* Syntax Show Interface Description Shows the network interface information. User Level Admin show interface [brief|ethernet] Syntax Show Modbus Description Shows the Modbus settings for a line.
Modem Commands Modem Commands Add Modem Description User Level Syntax Options Adds a modem. Admin add modem The name of the modem. Do not use spaces. The initialisation string of the modem; see your modem’s documentation. Delete Modem Description User Level Syntax Option Deletes a modem. Admin delete modem You can see a the list of modems that can be deleted by typing delete modem ?.
Packet Forwarding Commands Packet Forwarding Commands Set Packet-Forwarding Line Description The Packet Forwarding feature allows you to control how the data coming from a serial device is packetized before forwarding the packet onto the LAN network. This command configures packet forwarding options for serial devices attached to the serial line.
Packet Forwarding Commands custom-on-specific-events This section allows you to set a variety of packet definition options. The first criteria that is met causes the packet to be transmitted. For example, if you set a Force Transmit Timer of 1000 ms and a Packet Size of 100 bytes, whichever criteria is met first is what will cause the packet to be transmitted. custom-on-frame-definition This section allows you to control the frame that is transmitted by defining the start and end of frame character(s).
Packet Forwarding Commands force-transmit-timer When the specified amount of time, in milliseconds, elapses after the first character is received from the serial port, the packet is transmitted. After a packet is transmitted, the next character received starts the timer again. A value of zero (0) ignores this parameter. Valid values are 0-65535 ms. The default is 0. forwarding-rule Determines what is included in the Frame (based on the EOF1 or EOF1/EOF2) or Packet (based on Trigger1 or Trigger1/Trigger2).
5 Network Commands Chapter 5 This chapter defines all the CLI commands associated with configuring the IOLAN’s network parameters. SNMP Commands The IOLAN supports SNMP traps for restart and SNMP community authentication error. Add Community Description Adds an SNMP community (version 1 and version 2). User Level Admin add community | Syntax none|readonly|readwrite Options A name that will be sent to the IOLAN from an SNMP manager.
SNMP Commands | Defines the hosts (by IPv4 or IPv6 address) that will receive trap messages generated by the IOLAN. Up to four trap hosts can be defined. Select the version of trap you want the IOLAN to send. Valid options are v1, v2c or v3. Select between trap or inform. Inform requires the receiving host to acknowledge receipt of the trap. Delete Community Description User Level Syntax Option Deletes an SNMP community (version 1 and version 2).
SNMP Commands Set SNMP engine-id-string Description Configures SNMP v3 Engine ID. User Level Admin set snmp engine-id-string Syntax Options string The string entered in this field will be combined with the defined string in hex of 800007AE04 to form the engine id. Ensure each string is unique for each IOLAN. The default engine id uses the MAC address of the Ethernet interface to ensure that the engine id is unique to this agent. To set the engine id back to the default, enter a null string <"">.
TFTP Commands TFTP Commands Set Server TFTP Description User Level Syntax Options Configures the IOLANs TFTP client settings. Admin set server tftp [retry ] [timeout ] retry The number of times the IOLAN will attempt to transfer (using TFTP) a file to/from a host. Enter a value between 0 and 5. The default is 5. A value of 0 (zero) means that the IOLAN will not attempt a retry should TFTP fail.
Gateway Commands Show Hosts Description Shows the IOLAN host table. User Level Normal, Admin show hosts Syntax Gateway Commands Add Gateway Description Adds a gateway. You can configure up to twenty gateways.
Gateway Commands Set Gateway Description Configures the gateway. User Level Admin set gateway default Syntax set gateway host set gateway network | | Options You can view the configured gateways that can be deleted by typing delete gateway ?.
Logging Commands Logging Commands Set Syslog Description Configures the system log. User Level Admin set syslog Syntax [level emergency|alert|critical|error|warning|notice|info|debug] [primary-host ] [secondary-host ] Options level Choose the event level that triggers a syslog entry: z Emergency z Alert z Critical z Error z Warning z Notice z Info z Debug When you select a Level, all the levels that appear above it in the list also trigger a syslog entry.
6 Time Commands Chapter 6 This chapter defines all the CLI commands associated with configuring the IOLAN’s time parameters. Time Commands Set Time Description User Level Syntax Option Sets the IOLAN’s system clock. Admin set time Sets the IOLAN’s system time, using military time format. Show Time Description Shows the IOLAN system clock. User Level Normal, Admin show time Syntax Time/Date Setting Commands Set Date Description Sets the IOLAN’s system clock.
Time/Date Setting Commands Show Date Description Shows the date, according to the IOLAN system clock. User Level Normal, Admin show date Syntax Show Time Description Shows the IOLAN’s system clock.
7 Administration Commands Chapter 7 This chapter defines all the CLI commands associated with configuring the IOLAN’s administration parameters. Bootup Commands Reboot Description Reboots the IOLAN. You will be prompted to save configuration to FLASH, if there have been unsaved configuration changes. User Level Admin reboot Syntax Reset Description Resets the user profile or serial line to the default factory configuration. User Level Admin reset user .
Bootup Commands Set Bootup Description Specifies remote the TFTP host and pathname for files to be loaded after a IOLAN reboot. User Level Admin set bootup firmware host [file ] Syntax set bootup configuration host [file ] Options firmware file The path and file name (do not use a drive letter), relative to the default path of your TFTP server software, of the update software for the IOLAN that will be loaded when the IOLAN is rebooted.
TFTP File Transfer Commands TFTP File Transfer Commands Netload Description Transfers a file from a remote host to the IOLAN using the TFTP protocol. User Level Admin netload text-config|factory-default-config Syntax firmware|configuration| customlang|term1|term2|term3|customapp-file|serialt-buf Options text-config Specify this option if you are uploading a text-based configuration file to the IOLAN from a TFTP server.
Custom Factory Default Netsave Description Transfers a file from the IOLAN to a remote host using the TFTP protocol. User Level Admin netsave configuration|crash|serialt-buf|text-config Syntax Options configuration Specifies that you are going to upload a configuration file from the IOLAN to the specified host or IP address. crash Specifies that you are going to upload a crash file from the IOLAN to the specified host or IP address.
MOTD Commands Set Description Sets the current configuration on IOLAN to act as the factory default configuration. See the User Guide for directions on how to revert back to the original factory default configuration, if required. User Level Admin set config-to-factory-default Syntax MOTD Commands Set MOTD Description Specifies the server/file that contains the message of the day (MOTD) that is displayed when users log into the IOLAN.
8 Statistic Commands Chapter 8 This chapter defines all the CLI commands associated with configuring the IOLAN’s statistic parameters. Configuration Statistics Show Netstat Description User Level Syntax Options Shows currently used TCP/UDP sockets/ports. Admin show netstat [all] [listening] [tcp] [udp] [tcpv6] [updv6] all Displays all ports, including server (listening) ports; by default, listening ports are not displayed.
Run-Time Statistics Show Netstat Statistics Description Shows protocol (IP/ICMP/TCP/UDP) counters. User Level Admin show netstat statistics [ip] [ipv6] [icmp] [icmpv6] [tcp] [udp] Syntax [udp6] Show Routes Description Shows current information about IPv4 or IPv6 network routes. User Level Admin show routes [ipv6] Syntax Run-Time Statistics Delete Arp Description Delete entries from the IOLAN's ARP cache. Takes effect immediately; not related to configuration.
9 I/O Commands Chapter 9 This chapter defines all the CLI commands associated with configuring the IOLAN’s I/O parameters. Global I/O Commands Set IO UDP Description Sets the UDP settings for I/O unicast messages. User Level Admin set io udp [mode on|off] Syntax [broadcast-interval ] set io udp entry 1|2|3|4 disabled Options set io udp entry 1|2|3|4 [] mode Enables/disables UDP broadcast of I/O channel status (data).
Set Line Set IO Failsafe Description User Level Syntax Options Sets the failsafe (watchdog) settings for I/O. Admin set io failsafe [mode on|off] [timeout ] mode Enables/disables the Failsafe Timer. This is the global setting that must be enabled to set the Failsafe Action on the channel for digital outputs and relays. When this timer expires because of no I/O activity within the specified time interval, the Failsafe Action set for the channel determines the action on the output.
Set IOChannel Set IOChannel Set IOChannel Mode Description Sets general I/O channel settings for the specified channel, these settings are available to all channels and I/O serial pins. User Level Admin set iochannel [mode enabled|disabled] Syntax [description ] 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, allowing the settings to become active.
Set IOChannel trigger When the trigger condition is met, triggers the specified alarm action. Triggers can be: z Disabled—No alarm settings. This is the default. z Inactive—When the expected Digital input is active, going inactive will trigger an alarm. z Active—When the expected Digital input is inactive, going active will trigger an alarm. clear Specify Manual to manually clear an alarm.
Set IOChannel trigger When the trigger condition is met, triggers the specified alarm action. Triggers can be: z Disabled—No alarm settings. This is the default. z Inactive—When the expected Digital input is active, going inactive will trigger an alarm. z Active—When the expected Digital input is inactive, going active will trigger an alarm. clear Specify Manual to manually clear an alarm.
Set IOChannel type Specify the type of digital output: z Sink—Specifies that the channel will be grounded when active. z Source—Specifies that the channel will provide voltage when active. z Sink and Source—Specifies that channel will be grounded when it is inactive and will provide voltage when it is active. The default is Sink. active-signal-width 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.
Set IOChannel Set IOChannel Digital Output (Serial Pins) Description Sets the Digital output for serial pins RTS and DTR. This option is only available when the Line Service is set to Signal I/O. User Level Admin set iochannel rts|dtr [description ] Syntax [failsafe-action none|activate-outut|deactivate-output] [mode enabled|disabled] Options description Provide a description of the channel, making it easier to identify. The channel description can be up to 20 characters.
Set IOChannel active-to-inactive-delay When the I/O is commanded to an inactive state, this is the length of the delay before the command is executed. Valid values are 1-9999 x 100 ms. The default is 100 ms. inactive-to-active-delay When the I/O is commanded to an active state, this is the length of the delay before the command is executed. Valid values are 1-9999 x 100 ms. The default is 100 ms. active-signal-width How long the channel output will be active during the pulse mode.
Set IOChannel alarm Configures alarm settings when the Analog input 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 severity level trigger values must decrease in value with each subsequent level.
Set IOChannel Set IOChannel Analog (Temperature) Description Sets the Analog input channel settings for Temperature models.
Set IOChannel 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 severity level trigger values must 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 increase in value with each subsequent level.
Set IOChannel Set IOChannel IOExtension Description Configures the I/O extension options that allow you to connect the Digital Input channel or input serial signal pin (when the line is configured for signal-io) to Digital Output/Relay channels or output serial signal pins (when the line is configured for signal-io) on the same IOLAN, remote IOLAN(s), and/or TCP/IP applications running on local hosts.
Set IOChannel connection-method The connection-method is one of the following: z Client-Initiated—When specified, the channel/serial signal pin will wait for connections to be initiated by another I/O channel or a TCP/IP application. z Server-Initiated—When specified, the channel/serial signal pin initiates communication to another I/O channel or a TCP/IP application.
Set IOChannel Set IOChannel Multihost Description Configures up to 49 hosts/IOLANs that the Digital input channel or input serial signal pins (DSR, DCD, or CTS-when the line is configured for signal-io) will connect to. To see a list of configured hosts/IOLANs, enter the show iochannel command.
Set IOChannel Show IO Description Shows global I/O information (for example, UDP, TruePort, Modbus). Temperature input is Analog. User Level Admin show iochannel Syntax 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 channel numbers are a1-a4. rts|cts|dtr|dsr|dcd Specify the Digital output pins (RTS or DTR) or Digital input pins (CTS, DSR, or DCD).
I/O Channel Control Commands I/O Channel Control Commands The I/O commands in this section are used to manually manage the I/O channels. Digital Output Description Manages the Digital output channel status. Not all models have four digital channels, most have just two. User Level Admin iochannel d1|d2|d3|d4|cts|dsr|dcd clear alarm|input-latch Syntax Options alarm Clears the alarm.
Glossary This chapter provides definitions for IOLAN terms. BOOTP (BOOTstrap Protocol) An Internet protocol that enables a diskless workstation to discover its own IP address, the IP address of a BOOTP server on the network, and a file to be loaded into memory to boot the machine. This enables the workstation to boot without requiring a hard or floppy disk drive. Community (SNMP) An SNMP community is the group that devices and management stations running SNMP belong to.
