Perle Systems DS1, TS2

API I/O Access Over TruePort

210 IOLAN DS1/TS2 User’s Guide, Version 3.4

Contents

Main Page T able of Contents Preface ...............................................................................17 Chapter 1 Introduction......................................................19 Chapter 2 Hardware and Connectivity ............................23 Chapter 3 Configuration Methods ...................................29 WebManager............................................................................... 35 Command Line Interface........................................................... 37 Menu............................................................................................ 38 DHCP/BOOTP............................................................................. 40 SNMP........................................................................................... 42 Chapter 4 Getting Started.................................................45 Chapter 5 Using DeviceManager and WebManager.......53 Chapter 6 Network Settings .............................................61 Chapter 7 Configuring Serial Ports .................................67 Page Advanced.................................................................................. 113 Chapter 8 Configuring Users .........................................117 Adding/Editing Users .............................................................. 119 Chapter 9 Configuring Security .....................................127 Chapter 10 Configuring I/O Interfaces...........................129 Channels................................................................................... 135 I/O UDP...................................................................................... 150 I/O Modbus Slave..................................................................... 152 Modbus I/O Access.................................................................. 153 TruePort I/O...............................................................................158 Chapter 11 Configuring the System ..............................165 Management..............................................................................166 Chapter 12 Controlling the I/O Channels ......................171 Chapter 13 System Administration................................173 Appendix A Virtual Modem AT Commands ..................185 Appendix B Pinouts and Cabling Diagrams .................187 Appendix C Setting Jumpers .........................................195 Appendix D I/O Wiring Diagrams...................................201 Wiring I/O Diagrams................................................................. 201 Appendix E TruePort Utility............................................207 Appendix F Accessories.................................................211 Page Preface About This Book Intended Audience Documentation Typeface Conventions Online Help Introduction About the IOLAN IOLAN Family Models IOLAN Features Hardware Software Accessing the IOLAN General Features Security Page Hardware and Connectivity IOLAN Components Whats Included What You Need to Supply Available Accessories Power Supply Specifications Desktop Models Serial Only Models I/O Models Getting to Know Your IOLAN DS1 TS2 I/O Top View End View Console/Serial Switch Console Mode Serial Mode Powering Up the IOLAN Serial Only Models +- I/O Models 9-30 VDC Left Right Configuration Methods Configuration Methods Overview Configures an IP Address Requires a Configured IP Address Easy Config Wizard DeviceManager Connecting to the IOLAN Using DeviceManager Page Using DeviceManager WebManager Access Platforms Connecting to the IOLAN Using WebManager Using WebManager Command Line Interface Connecting to the IOLAN Using the CLI Through the Network Through the Serial Port Using the CLI Menu Connecting to the IOLAN Using the Menu Using the Menu DHCP/BOOTP Connecting to the IOLAN Using DHCP/BOOTP Using DHCP/BOOTP DHCP/BOOTP Parameters SNMP Connecting to the IOLAN Using SNMP Using the SNMP MIB Page Getting Started Easy Configuration Wizard Setting Up the Network Using DeviceManager Using WebManager Using a Direct Serial Connection to Specify an IP Address Using a Direct Serial Connection to Enable BOOTP/DHCP Page Using ARP-Ping For an IPv6 Network Setting Up the Serial Port(s) Page Setting Up Users Using DeviceManager and WebManager Navigating DeviceManager/WebManager DeviceManager WebManager Using DeviceManager to Connect to the IOLAN Starting a New Session Assigning a Temporary IP Address to a New IOLAN Adding/Deleting Manual IOLANs Logging in to the IOLAN Using WebManager to Connect to the IOLAN Logging into the IOLAN Configuration Files Creating a New IOLAN Configuration in DeviceManager Opening an Existing Configuration File Managing the IOLAN Network Settings IP Settings IP Settings Advanced Advanced Host Table Adding/Editing a Host Route List Adding/Editing Routes Configuring Serial Ports Serial Ports Functionality Page Resetting a Serial Port Serial Port Profiles Common Tabs Hardware Tab Field Descriptions Page Packet Forwarding Tab Field Descriptions Page Console Management Profile Page Page Page TruePort Profile Page Adding/Editing Additional TruePort Hosts Adding/Editing a Multihost Entry Page TCP Sockets Profile Page Adding/Editing Additional Hosts Adding/Editing a Multihost Entry Page UDP Sockets Profile Page Page Terminal Profile Page Page Page User Service Settings Login Settings Telnet Settings Page Serial Tunneling Profile Page Virtual Modem Profile Page Page Phone Number to Host Mapping VModem Phone Number Entry Control Signal I/O Profile Input Signal Field Descriptions Output Signal Field Descriptions Modbus Gateway Profile Page Advanced Field Descriptions Modbus Slave IP Settings Field Descriptions Adding/Editing Modbus Slave IP Settings Page Modbus Slave Advanced Settings Field Descriptions Custom Application Profile General Tab Field Description Advanced Advanced Serial Settings Tab Modems Tab TruePort Bau d Rate Tab Page Configuring Users Page Adding/Editing Users General Tab Page Services Tab Advanced Tab Sessions Tab Page Serial Port Access Tab Page Configuring Security Services Functionality Field Descriptions Configuring I/O Interfaces Settings I/O Access Functionality Advanced Slave Modbus Settings Failsafe Timer Functionality UDP Functionality I/O UDP Settings Temperature Functionality Channels Analog Page Digital Input Page Page Digital Output Page Page Relay Page Page Temperature Page Alarm Settings Basic Analog Alarm Settings Advanced Analog Alarm Settings I/O UDP UDP Unicast Format Analog Data Digital/Relay Data Serial Pin Signal Data UDP Unicast Example I/O Modbus Slave Modbus Serial Application Connected to the Serial Port Modbus Serial Application Connected to the Network Modbus TCP Application Modbus I/O Access Function Codes I/O Coil/Register Descriptions Serial Port Coil/Register Descriptions A4/T4 Registers A4D2/A4R2 Registers D4/D2R2 Registers Serial Pin Signals TruePort I/O TruePort/Modbus Combination API Over TruePort Only Accessing I/O Data Via TruePort Introduction Setup Format of API Commands Get Commands Response Format Command Format Set Commands Command Format Successful Response Format Unsuccessful Response Format Error Codes I/O SNMP Traps Configuring the System Alerts Syslog Management SNMP Custom App/Plugin Field Description Advanced Login Tab Field Descriptions Bootup Files Tab Field Descriptions Message of the Day (MOTD) Tab Field Descriptions TFTP Tab Field Descriptions Controlling the I/O Channels I/O Channels Page System Administration Managing Configuration Files Saving Configuration Files Downloading Configuration Files Downloading Configuration Files to Multiple IOLANs Uploading Configuration Files Downloading IOLAN Firmware Calibrating I/O Calibrating Analog Input Calibrating Voltage Calibrating Current Calibrating Temperature Input Calibrating Analog Channels Resetting Calibration Data Setting the IOLANs Date and Time Rebooting the IOLAN Resetting the IOLAN to Factory Defaults Language Support Loading a Supplied Language Translation Guidance Software Upgrades and Language Files Downloading Terminal Definitions Creating Terminal Definition Files Resetting Configuration Parameters Lost Admin Password Page Virtual Modem AT Commands A Virtual Modem Initialization Commands Page Pinouts and Cabling Diagrams B Pin 1 Pin 14 Pin 25 DB25 Female Pin 13 Pin 1 Pin 25 Pin 14 RJ45 DB9 Male (Serial Only) DB9 Male I/O EIA-232 Cabling Diagrams Terminal DB25 Connector DB25 Female DB25 Male RJ45 DB9 Male Modem DB25 Connector DB25 Male RJ45 DB9 Male Setting Jumpers C 1-Port IOLAN IOLAN DB25 Male/Female IOLAN RJ45 IOLAN DB9 2-Port IOLAN Digital I/O Module Analog Input Module Page I/O Wiring Diagrams D Wiring I/O Diagrams Digital I/O Digital Input Wet Contact Digital Output Sink Digital Output Source Analog Input Current Volt age Temperature Input Thermocouple Relay Output Normally Open Contact Normally Closed Contact Page TruePort Utility E TruePort Network API I/O Access Over TruePort API Request Format API Response Format Error Codes Page Accessories F Starter Kit (Adapters/Cable) RJ45F to DB25M DTE Crossover Adapter RJ45F to DB25M DCE Modem Adapter RJ45F to DB25F DTE Crossover Adapter RJ45F to DB9M DTE Crossover Adapter RJ45F to DB9F DTE Crossover Adapter Sun/Cisco RJ45M Connector Cable for Rack Mount Models Troubleshooting G Hardware Problems Communication Issues DeviceManager Problems Host Problems Login Problems Problems with Terminals Unknown IP Address DHCP/BOOTP Problems Language Problems Long Reboot Cycle I/O Models Glossary Page Index A B C D M O P R S