Home

TAMS 3020 LAN I/O Gateway Installation and

1. GPIO specific SICL Functions CTRL igpioctrl GETWIDTH igpiogetwidth SETWIDTH igpiosetwidth STAT igpiostat If after querying the status of the Gateway and client connections as explained in the previous section you determine that the Gateway or a client s I O operation is hung or there is a deadlock situation between clients that are connected to the Gateway you can clear the Gateway to terminate all client connections However before clearing the Gateway you may want to forewarn users that any I O operations they have in progress and their client connections to the Gateway will be terminated The users will then need to re open new sessions on the Gateway after the clear has occurred 37 clear To terminate all client connections to the Gateway type the following gt clear Caution Any client operations in progress and client connections will be terminated by the clear command Once the clear occurs users who previously had open sessions on the Gateway will likely get either an I ERR_TIMEOUT or L ERR_NOCONN error message Again since the clear terminates all client connections those users will need to re open new sessions on the Gateway after the clear occurs 38 6 Troubleshooting This chapter explains how to troubleshoot problems you may encounter with the TAMS 3020 LAN I O Gateway This chapter includes information for e HPSICL LAN Error Codes and Messages e Network Connection Problems e Configurati
2. See Appendix C Related Software Documentation for the software manuals you should use Who Should Use This Guide This guide assumes that you are a Network Administrator who installs configures and maintains a local area network LAN including network related hardware like the TAMS 3020 LAN I O Gateway If you are not a Network Administrator that person must be readily available to provide assistance If you use HP UX or Linux workstations with the Gateway you must also have superuser root privileges on those systems If you will use a Windows 2000 or XP Professional workstation with the Gateway you must also have system administrator privileges on those workstations What Is in This Guide This guide contains the following chapters and appendices Chapter 1 Overview provides a brief overview of the TAMS 3020 LAN I O Gateway Chapter 2 Installation explains how to install the Gateway hardware on the LAN and HP IB bus Chapter 3 Configuration explains how to configure the Gateway on your network Chapter 4 Usage shows how to remotely communicate to instruments connected to the Gateway Chapter 5 Administration explains how to maintain the Gateway on the network Chapter 6 Troubleshooting provides ways to fix problems you may encounter with the Gateway Appendix A Technical Reference provides specifications and conformity information for the Gateway Appendix B Related Software Documentation lists the softwa
3. e HP BASIC UX 700 e TAMS BASIC LX Note The TAMS 3020 LAN I O Gateway supports all I O application operations by these software products except for parallel polling SICL commander sessions and asynchronous aborting The HP SICL and VISA products were originally developed by HP and then transferred to Agilent as part of the corporate restructuring Contact Agilent Technologies for purchase and support of those products TAMS SICL and VISA for HP UX 11i Documentation To use the LAN I O Gateway with TAMS SICL on a client computer you must configure the software first Documentation is provided as pdf and ps files on the software disk See Installation and Configuration Guide for HP UX I O Libraries installation xx for installation then Standard Instrument Control Libraries User s Guide siclug xx for information on using SICL TAMS SICL for RedHat Linux Documentation To use the LAN I O Gateway with TAMS SICL on a client computer you must configure the software first See Installation and Configuration Guide for Linux I O Libraries installation xx for the installation then Standard Instrument Control Libraries User s Guide siclug xx for information on using SICL 50 HP SICL Documentation To use the LAN I O Gateway you must configure the LAN client software provided with HP SICL See the Installing and Configuring the HP I O Libraries chapter of the HP 1 O Libraries Installation and Configuration Guide for
4. 0 0 0 0 subnetmask 0 0 0 0 lantimeout 0 iotimeout 120 maxconnections 0 HP IB Interface 0 gpibl gt Exiting the Configuration Utility cancel exit quit To exit the Configuration Utility there are several different commands available To exit without saving any changes you may have entered type one of the following commands gt cancel gt exit gt quit These commands simply exit the utility discarding any changes you may have specified If you simply close the window from which you are running the Configuration Utility changes entered will also be discarded save If you made any changes that you wish to retain type in gt save If there are changes to save the save command will clear any client operations in progress along with all client connections If the network parameters have been edited the system will also automatically reboot If no changes have been made to parameters the save command will notify you of that and not exit the Configuration Utility Global Commands 30 The following commands affect the operation of all interfaces installed in the Gateway including the LAN interface config The configured interfaces can be listed in several ways The config command shows a summary of the interfaces Note that the LAN interface is always configured and is not explicitly listed by the config command although its parameters are gt config hostname new_host_name hwaddress 00 02 B
5. opt sicl bin iwrite lan T3020 gpio Note that installing SICL on Windows workstation does not automatically set the execution path to include SICL commands so using the full path is necessary for the iread command to be found unless the path is manually added and the system rebooted Also the echo command works somewhat differently on Windows vs Linux HP UX so that example would operate differently on Windows 46 Of course for the first example to work an instrument capable of outputting data without first receiving a command must exist at bus address 22 For the second example to work some appropriate circuitry must be connected to the GPIO interface and the polarity of the handshake lines configured appropriately If no circuitry is attached any reads or writes will simply hang until timeouts are reached Aborting Pending Transactions If an I O operation is failing to complete due to a configuration problem the command usually can be aborted by a lt Ctrl C gt from the keyboard However this does not clear the I O operation being attempted at the Gateway box For example if an attempt is made to do an iread command from a non existent hpib device aborting the iread command leaves the interface in use until a timeout occurs or a clear command is done from the Configuration Utility Attempts to iread from an actual device will be blocked by the first I O operation This memory of uncompleted transactions can cause unexpected resul
6. Gateway on your subnet displays its networking parameters and then allows you to reconfigure the networking values to something compatible with your network This is all done from a remote client machine Installing t3020conf Utility Insert the CD that came with your 3020 into your CD drive of your client machine RedHat Linux or Windows The 3020 Gateway must be on the same subnet or accesible via subnetting as this client machine The client need not be the same machine as the intended client machine for running your SICL or VISA based applications RedHat Linux installation e Open a terminal window on your system all commands below are typed into this window e Ensure you are the root user if not su root Password e Find the mount point of your CD drive containing the TAMS disc One way to do this is as follows cat proc mounts grep iso9660 look at the results to see the CD drive mount point example results are as follows dev hdc media cdrecorder iso9660 ro 0 0 the mount point is the second field in this case media cdrecorder e rpm U media cdrecorder linux t3020conf noarch rpm This command will vary depending upon where your CD drive mount point is NOTE For Linux the t3020conf requires Python to be installed Python is by default included with RedHat Linux distributions The GUI version of t3020conf requires wxPython to be installed Appropriate versions of wxPython are automatically installed from the TAMS CD
7. Subnet Mask ion adolece 18 subnetmask 23 33 SUD NCS EE EE 10 subnetting coooooonocconccononnconocononnnonncnnc co nono nonnc nono no onnonncn neon nono 10 TCP IP Instrument Protocol See VXI 11 Protocol telnet 25 22 VEE 52 VUE 36 VISA VXI oriniai Sate neei este A EE 8 9 VX plug playa ceccecccecccscecsceesceseesseesceseceecsseeseeseceseeneenee 8 10 WATTADLY EE 64
8. The default value of 0 is a special case which does not limit the number of connections Due to overhead required internally to check this parameter using the default value is generally preferred for normal operation Remote Configuration via Telnet Remote Configuration can be from e From a RedHat Linux workstation e From an HP UX Unix workstation e From a Windows workstation Remote Configuration via telnet is the normal method of configuration if the t3020conf utility doesn t suffice Defauly Configuration must be used if the networking configuration is put in such a state that the 3020 Gateway can no longer be accessed through the network The following examples of Remote Configuration assume that the workstation being used for configuration and the Gateway reside on the same subnet 18 Remote Configuration The Gateway box can be remotely configured from a RedHat Linux machine an HP UX Unix machine or a Windows machine running Windows 98 2000 or XP Professional Jump down to the appropriate section based on what workstation will be used to set the configuration of the Gateway Remote Configuration from a RedHat Linux Workstation The Gateway is initially configured with an IP address of 192 0 0 192 and subnetting disabled Since this address will most likely not be in your local subnet routing from a RedHat workstation must be set up to allow initial communication with the Gateway until such time as the Gateway IP a
9. also called GPIB or IEEE 488 HP IB is a shared bus with up to fourteen external devices possible by daisy chaining the bus Each device including the interface card in the TAMS LAN I O Gateway must have a unique address on a HP IB bus See the manuals that came with the HP IB devices for information on setting the bus address The bus address of the interface card is configurable with the Configuration Utility with a default value of 21 Because the Gateway communicates with workstations or PC s by LAN there are few constraints on the distance between the computers and the instruments being communicated with This eliminates the short distance constraints normally associated with HP IB A typical application for the Gateway would have it located at a rack of instruments and provide access to those instruments to one or multiple workstations and PC s scattered throughout a facility or even facilities at differing geographic locations SICL and VISA provide the ability to communicate with remote instruments in the same manner as if they were connected locally to a computer Only the LAN address of the Gateway must be added to SICL or VISA commands in order to provide that functionality Software Firmware Architecture The TAMS 3020 LAN I O Gateway is supported with the following I O application software products Agilent SICL and VISA for HP UX 10 20 TAMS SICL and VISA for HP UX 11i Agilent SICL and VISA for Microsoft Windows 2000 or XP Profes
10. configuration procedures To develop and use HP SICL I O applications for the Gateway see the Using HP SICL with LAN chapter of the HP SICL User s Guide HP SICL functions including those that are LAN specific are fully defined in the HP SICL Reference Manual HP VISA To use the LAN I O Gateway you must configure the LAN client software provided with HP SICL and HP VISA See the Installing and Configuring the HP I O Libraries chapter of the HP LO Libraries Installation and Configuration Guide for configuration procedures To develop and use HP VISA I O applications for the Gateway see the Programming over LAN chapter of the HP VISA User s Guide HP VEE Documentation To use the LAN I O Gateway you must configure the HP SICL LAN client software provided with HP VEE See the Jnstalling the HP I O Libraries for HP VEE manual for configuration procedures To develop and use HP VEE UO applications for the Gateway see the Using Instruments chapter of the HP VEE Advanced Programming Techniques manual HP BASIC UX 700 Documentation Version 8 x To use the LAN I O Gateway you must configure the HP SICL LAN client software provided with HP BASIC UX 700 Version 8 x See the Installing and Configuring SICL for BASIC UX 8 x chapter of the Installing and Using HP BASIC UX 8 x manual for configuration procedures To develop and use HP BASIC UX 700 Version 8 x I O applications for the Gateway see The HP
11. different meanings Ifthe numbers are considered binary digits then a 0 represents a wildcard gt subnetmask 255 255 255 0 32 If subnetting is disabled then the default value of 0 0 0 0 is useable for the subnetmask If the gateway IP address is set to that of an external gateway then a subnetmask appropriate for your network must be used lantimeout The lantimeout command displays or sets the timeout used with LAN connections specified with a value of seconds The value must be between 0 and 23 The value of 0 is a special case that represents an infinite value i e no timeout Activity must be shown for each LAN connection within the specified amount of time or that connection will be closed by the Gateway and the associated resources freed A timeout is generally used to clear connections with clients that have died or to close connections opened by faulty application programs The actual timeout is substantially longer than that specified in the lantimeout command After the specified amount of time the system starts sending periodic keepalive probes to the client for approximately 11 minutes If no response is received at the end of that time then the connection is closed gt lantimeout 60 This example sets the lantimeout to 1 minute but the actual amount of time before the connection is closed is approximately 12 minutes maxconnections The maxconnections command displays or sets the maximum number of LAN connection
12. exception the source code distributed need not include anything that is normally distributed in either source or binary form with the major components compiler kernel and so on of the operating system on which the executable runs unless that component itself accompanies the executable If distribution of executable or object code is made by offering access to copy from a designated place then offering equivalent access to copy the source code from the same place counts as distribution of the source code even though third parties are not compelled to copy the source along with the object code 4 You may not copy modify sublicense or distribute the Program except as expressly provided under this License Any attempt otherwise to copy modify sublicense or distribute the Program is void and will automatically terminate your rights under this License However parties who have received copies or rights from you under this License will not have their licenses terminated so long as such parties remain in full compliance 5 You are not required to accept this License since you have not signed it However nothing else grants you permission to modify or distribute the Program or its derivative works These actions are prohibited by law if you do not accept this License Therefore by modifying or distributing the Program or any work based on the Program you indicate your acceptance of this License to do so and all its terms and conditio
13. original authors reputations Finally any free program is threatened constantly by software patents We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses in effect making the program proprietary To prevent this we have made it clear that any patent must be licensed for everyone s free use or not licensed at all The precise terms and conditions for copying distribution and modification follow GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING DISTRIBUTION AND MODIFICATION 0 This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License The Program below refers to any such program or work and a work based on the Program means either the Program or any derivative work under copyright law that is to say a work containing the Program or a portion of it either verbatim or with modifications and or translated into another language Hereinafter translation is included without limitation in the term modification Each licensee is addressed as you Activities other than copying distribution and modification are not covered by this License they are outside its scope The act of running the Program is not restricted and the output from the Program is covered only if its contents constitute a work based on the Program independent of having been made b
14. select the network interface device that is on the same subnet as your 3020 LAN Gateway The routing table for each device is also shown as these routing IP addresses may help you decide which device is communicating to the subnet where you placed your 3020 Gateway Once you click next button your subnet will be probed for 3020 Gateway machines Since this takes a few seconds the gauge on the Main Window will show the progress of the LAN probe C Hosts Page This page lists all potential 3020 Gateway machines found by the probe of your subnet The hostname and IP address of each discovered machine is shown in a list box Any machine on your subnet hooked to the device selected on the previous page that is configured to respond to VXI 11 or SICL LAN protocols will be shown Select the 3020 Gateway and then click on next to change the network values for the 3020 or cancel to quit If multiple machines are listed and you do not know which one is the 3020 Gateway here are some tips a The default IP address for the 3020 Gateway from the factory is 192 0 0 192 b Record the list of IP addresses click back power down your 3020 click next compare this new list with the old list of IP addresses The missing IP address will be the 3020 Gateway D New IP address Page This page shows the IP address of the 3020 Gateway you selected on the previous page and lets you enter a new IP address for the 3020 Notice that the hos
15. the common command telnet From the command line telnet 192 0 0 192 The response from the Gateway should be Gateway Configuration version 1 2 0 Copyright 2002 Test amp Measurement Systems Inc Type help by itself to get a list of valid commands gt The version number is subject to change The gt symbol is the prompt for the command line interface J g y promp Enter help in order to show the supported commands Enter help lt command gt to get a short description of what each command does If the commands are not being shown as they are typed then enter echo yes in order to turn on the terminal echo The config command displays a summary of the network parameter settings plus shows which interfaces are currently configured in the system gt config hostname T3020 hwaddress 00 02 B6 15 36 49 ip 192 0 0 192 gateway 0 0 0 0 subnetmask 0 0 0 0 lantimeout 0 iotimeout 120 maxconnections 0 HP IB Interface 0 gpibl gt In this sample output all parameters are set to factory default values and one interface is configured in the system The IP address of the Gateway must be changed to an address assigned by a local System Administrator for its use This should be an address within the local subnet in which the Gateway will be used To change the IP address from 192 0 0 192 to aaa bbb ccc ddd simply type 21 gt ip aaa bbb ccc ddd A host name was likely assigned by the System Administrat
16. the operation The network connection is down or the Gateway is down The server is busy performing an operation for a different client Use the Configuration Utility status command to verify the Gateway status You may need to increase the Client Timeout Delta configuration value on the LAN client using iosetup e open fails or I O operation fails Out of resources The Gateway was unable to open another session or perform the operation because it is out of resources Use the Configuration Utility status to determine the current Gateway status You may need to have a client terminate its connection or you may need to use the clear command to reclaim resources e iopen fails Error 2 bad hostname gethostbyname failed The iopen failed because the IP address of the hostname could not be determined Likely causes would be the hostname of the 3020 machine not being available via DNS or NIS due to improper configuration of those services at the client or at the name servers e LO operation fails No connection The connection to the Gateway failed because The network connection is down or the Gateway is down and a TCP IP network timeout occurred The Gateway was powered off and then powered on or a Configuration Utility reboot or clear command was executed either of which terminates any open client connections Sporadic failures may be caused by DNS or NIS lookup failures Try putting the name and IP address of the Gatew
17. well as the status of the device The Gateway is busy performing a very long transaction to a slow device or it is waiting for input from a device A client may be waiting for access to a device interface locked by another client Use the Configuration Utility status command to determine which clients have which devices or interface locked and which clients are waiting for those locks to be freed before they can proceed Check for possible deadlock situations and if possible make sure the clients owning locks and the connections to those clients are still up and functioning If you determine that the Gateway is truly hung you may be able to free it by terminating a particular client connection at the client thus freeing up the resources to allow the Gateway to proceed Otherwise you may have to use the Configuration Utility clear or reboot commands or power cycle the 3020 Caution Any client operations in progress and client connections will be terminated by the clear or reboot commands or by power cycling Command Line Examples From a Windows workstation read 34 characters from an HP IB clock at address 22 on interface hpib with Gateway hostname of T3020 gt Program Files Agilent lO Libraries bin iread c 34 lan T3020 hpib 22 01 01 21 00 22 01 01 21 00 22 From a Linux workstation write a string of characters without terminating characters to interface gpio with Gateway hostname of T3020 echo n helpme
18. 13 Commands Client Connection Management moccoconcnncncononononnnonncnnos 36 Exiting EA EE 31 GlObDalencioni cocino sense cue cotocssacsteenge cekcessecsivease tad 31 I O Interfaces 34 LAN Configuration occcocococoninnnnnnncononnnnnincnnnnnon n32 Mistelamnomug sseagdie idas ici 35 COMA EE 22 31 32 configuration utility STA 8 Configuration Toast adi 24 Configuration Remote DHCP addressing L EE Editing HP IB Parameter 35 64 ip 23 33 IP Address LAN Timeout LANIC ID lantimeout link level address ooooooocnnoncocnoonos See hardware address list34 MAC Address oocccccoccnccononcconancnconanoc nns See hardware address MAXCOMMECTIONS o on cece cece ce ceeeeeeeseeeeceteeeeeeeseeeeee 34 Maximum Connections coooconoccconnconnnonnnoonnccnononnconn ccoo ccoo 19 mounting rails H tstat uu ins Network Administrator ocooocccinoncconononoconanononnnnonnnanocnnanonos 3 Network Configuration Default Settings cuidat EEN Troubleshooting networking concepts Package Contents 0 0 eee ceceesceeeceecceeeeeeceaecaecaeeteeeeeeseees parameters default values St E 25 editing e s resetting WOU e gege eee oes de dd dee e routing UE ete ae a ete onde ded ene ences rubber feet csr ok Sok EA 7 software licensing static address 25s casts ttle ek A ERE ro B SSEN Ve subnet gateuw an Subnet Gateway Address 18
19. 6 15 51 29 ip 192 0 0 192 gateway 0 0 0 0 subnetmask 0 0 0 0 lantimeout 0 iotimeout 120 maxconnections 0 HP IB Interface 0 gpibl reset To restore all configuration parameters back to the factory default values enter gt reset Note that the IP address and other network parameters will return to default values so it may be necessary to use methods in Chapter 3 to re establish communication with the Gateway after using the reset command reboot To reboot the box after saving any parameters you may have changed enter gt reboot The reboot command will of course clear client operations in progress along with client connections It is not generally used in normal operation Several minutes are required for a reboot operation LAN Configuration Commands There are several commands used for configuring the LAN connection These display or change LAN parameters The config command can be used to display the current value of these parameters conveniently hostname The hostname command displays or changes the machine name of the Gateway box This may be entered as the machine name or the machine name plus domain There is no difference in functionality 31 gt hostname T3020 gt hostname hostname T3020 gt hostname T3020 mydomain gt hostname hostname T3020 mydomain hwaddress The hwaddress command displays the value of the MAC address This is an address that is permanently assigned to the physical int
20. B Parameters LU Logical unit number Must be a unique number for each interface in the Gateway box Symname Symbolic Name A name that uniquely identifies each interface in the Gateway box HP IB Address The address on the HP IB bus of the interface itself Each device on a bus must have a unique address Must be an integer between 0 and 30 inclusive iotimeout The iotimeout command displays or sets a timeout in seconds for all interfaces on the Gateway except the LAN interface The parameter must be an integer between 0 and 231 An I O operation must be complete within the specified amount of time or else it will be cleared by the system The value of 0 is a special case that represents no timeout set gt iotimeout 40 Miscellaneous Commands Other Configuration Utility commands not covered elsewhere include help echo and version 34 help The help command lists all commands available in the Configuration Utility echo The echo command is used to control echoing of characters that are typed to the Configuration Utility If your typing is not showing on the screen as it is typed then enter echo Yes If characters are being shown twice try echo No version The version command displays the revision number of the software contained in the Gateway box It cannot be changed without a firmware upgrade Two lines are output the first is the version of the Configuration Utility included and the second is the version of
21. SHOULD THE PROGRAM PROVE DEFECTIVE YOU ASSUME THE COST OF ALL NECESSARY SERVICING REPAIR OR CORRECTION 12 IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER OR ANY OTHER PARTY WHO MA Y MODIFY AND OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE BE LIABLE TO YOU FOR DAMAGES INCLUDING ANY GENERAL SPECIAL INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES END OF TERMS AND CONDITIONS Appendix How to Apply These Terms to Your New Programs If you develop a new program and you want it to be of the greatest possible use to the public the best way to achieve this is to make it free software which everyone can redistribute and change under these terms To do so attach the following notices to the program It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty and each file should have at least the copyright line and a pointer to where the full notice is found lt one line to give the program s name and a brief idea of what it does gt Copyright C 19yy lt name of author gt This program is free software you can redistribut
22. SICL LAN Interface chapter of the HP BASIC Interface Reference manual Version 7 1 To use the LAN I O Gateway you must configure the HP SICL LAN client software provided with HP BASIC UX 700 Version 7 1 See the Configuring HP SICL for Series 700 chapter of the Installing and Maintaining HP BASIC UX manual for configuration procedures To develop and use HP BASIC UX 700 Version 7 1 I O applications for the Gateway see the HP SICL LAN Interface chapter of the HP BASIC Interface Reference manual 51 TAMS BASIC LX Documentation In order to use the LAN I O Gateway you must configure the TAMS SICL LAN client software provided with TAMS BASIC LX Version 11 0 See the Basic for Linux Documentation TAMS PN 2047K for configuration procedures To develop and use TAMS BASIC LX applications for the Gateway see the siclug pdf or siclug ps file shipped in the iolibs directory of the installation disks 52 C Client Software Matrix SICL VISA Windows 98 2000 XP E2094x E2094x RedHat Enterprise Linux 82091 82091 HP UX 10 20 E2091x E2091x HP UX 11i 72091 72091 E2094x and E2091x products are available from Agilent Technologies The x denotes a revision letter Consult Agilent documentation for recommended version numbers for specific hardware configurations 72091 and 82091 products are available from TAMS Inc 53 D Software Licensing Certain elements of the TAMS 3020 LAN I O Gatewa
23. TAMS 3020 LAN I O Gateway Installation and Configuration Guide Printing History Edition 1 April 2006 How to Use This Guide Use this guide to install and configure the TAMS 3020 LAN I O Gateway for use with supported network equipped computer systems You can also use this guide to administer the Gateway on your network and to troubleshoot any problems you might encounter while installing or configuring the Gateway Network equipped computer systems that are supported for use with the LAN UO Gateway are e HP 9000 workstations running either HP UX 10 20 or 111 e 32 bit personal computers PC s running Microsoft Windows 2000 or XP Professional e 32 bit personal computers PC s running RedHat Enterprise Linux To use the Gateway for I O applications you must also have one or more of the following software products installed and configured on your network equipped computer system s e Agilent SICL and VISA for Microsoft Windows computers e Agilent SICL and VISA for HP UX 10 20 workstations e TAMS SICL and VISA for HP UX 11i workstations e TAMS SICL for RedHat Enterprise Linux workstations e HP Visual Engineering Environment HP VEE e Agilent HP BASIC UX for HP UX 10 20 workstations e TAMS BASIC for HP UX 11i workstations e TAMS BASIC for RedHat Enterprise Linux workstation Note Once you have used this guide to install and configure the Gateway please refer to the appropriate documentation for your software product s
24. able Use the Configuration Utility status command to get more information I ERR SYMNAME Invalid Symbolic Name The symbolic name passed to iopen was not recognized Use the Configuration Utility config or list command to verify the symname or LU is configured Verify using iosetup on the client that the LAN interface is configured I ERR TIMEOUT Timeout occurred A timeout occurred while performing an operation The device may be busy in a bad state or a longer timeout value may be needed for the operation of the device Verify the correct address was used in iopen Use the Configuration Utility status command to get more information Table 5 1 Common SICL LAN Errors 39 Network Connection Problems Before attempting to communicate with the TAMS 3020 LAN I O Gateway you may want to verify that the network connection and cabling are correct Do the following e Verify proper connections and network terminations visually Refer to the installation instructions in Chapter 2 e Power on the LAN I O Gateway Make sure it is fully booted by waiting 3 minutes e Make sure network packets are being transmitted on the same local subnet that is connected to the Gateway The packets do not need to be addressed to go to the Gateway You could use the ping command to generate network traffic e Use the t3020conf utility to see if it can find the 3020 Gateway on you LAN Configuration Problems This sec
25. ample the network and or client goes down is discussed in Chapter 5 Troubleshooting Basic Networking Concepts Client Server Model Throughout this manual the terms Client and Server will be used In this context the Server is the TAMS 3020 LAN I O Gateway product which receives requests from Clients workstations or PC s running user applications to perform various I O operations on interfaces installed in the Gateway Within each Client there may be multiple processes requesting I O and there may be multiple Clients logically connected to the Gateway across LAN The software to operate the Gateway is factory installed in the box However the Gateway can be remotely configured by using the TAMS t3020conf utility and or the telnet command available on any workstation that has networking software installed It is recommend to use the TAMS t3020conf from a Linux or Windows client for the initial network configuration of the TAMS 3020 LAN Gateway This utility program is not required but makes the network configuration easier and also features network discovery of the Gateway s IP address as there is no other easy way to find on your network a lost 3020 Gateway None of these software programs telnet TAMS t3020conf need to be run from the same machine as the intended client Rather they just need to be run from a machine on the same subnet or subnets linked by subnetting as the TAMS 3020 LAN Gateway For example suppose yo
26. at Linux the t3020conf can execute in one of two modes GUI or comand line CLI e Open a terminal window on your system e Change to the root user if you are not already su root Password e To execute in GUI mode opt t3020 bin t3020conf gui 14 e To execute in command line mode opt t3020 bin t3020conf cli Note if wxPython is not installed under your default version of Python on your machine only the CLI mode will be used regardless of how the program is started Launching this utility under Windows For Windows machines the installation created shortcuts to the t302conf program which always runs in GUI mode e On your desktop double click on the TAMS 3020conf icon OR e Click on Start gt Programs gt TAMS 3020 gt TAMS 3020conf OR e Use windows explorer to browse to and double click C Program Files T AMS 3020conf t3020conf Running in GUI mode Windows or Linux The are four windows plus some popup message windows which are displayed by the t3020conf GUI A Main Window This is the first page and simply consists of a start and exit button along with a status gauge used to show the progress of some lengthy tasks several seconds to a few minutes B Devices Page This window has a box showing all the active network interface devices on your machine and the routing table for each interface device Typically only one device is shown in which case just click on the next button If more than one device is shown
27. ation Continued Remote Configuration from a Windows Workstation The Gateway is initially configured with an IP address of 192 0 0 192 and subnetting disabled Since this address will most likely not be in your local subnet routing from a Windows workstation must be set up to allow initial communication with the Gateway until such a time as the Gateway IP address can be changed 19 Log in as a user with administrative privileges An example command to add the routing to the Gateway is route add 192 0 0 192 hostname or route p add 192 0 0 192 hostname The hostname parameter is the name or IP address of the Windows workstation being used The first command adds a route that does not survive a reboot while the second command adds one that does survive Additional help can be obtained by doing netstat help and route help commands After successfully performing the route add command as above a new entry should appear in netstat r output similar to Active Routes Network Destination Netmask Gateway Interface Metric 192 0 0 192 255 255 255 255 aaa bbb ccc ddd aaa bbb ccc ddd 1 This will allow the local machine at address aaa bbb ccc ddd to communicate with the Gateway box at 192 0 0 192 The route p add command would add a similar line under Persistent Routes Remote Configuration Continued At this point the required routing from the local workstation to the Gateway box should be in place Con
28. ation programs it may be useful to use SICL commands from the command line in order to verify basic connectivity See the Command Line Examples section at the end of this chapter if help is needed in diagnosing some of the problems indicated by the following error messages The following are common run time errors that may occur on a client that is using a TAMS 3020 LAN O Gateway e iopen fails Invalid address errors Error 3 lan_connect failed or Bad Address Use the Configuration Utility commands to verify that the interface address name and or logical unit configuration values are correct Also use iosetup on the client machine to verify that the LAN client is correctly configured e iopen fails No connection Error 6 lan core createSync failed The connection to the LAN I O Gateway failed for one of these reasons A TCP IP network timeout occurred because the network connection is down or the Gateway is down The Gateway has reached its maximum concurrent client connections and this new connection was refused Use the Configuration Utility status command to determine the current Gateway client connection status You may need to have a client close its connection or you may need to use the clear command in the Configuration Utility 44 e iopen fails Timeout The client has timed out The Gateway has not responded within the appropriate timeout time because A Linux firewall on the client is blocking
29. ay box in etc hosts for Linux or HP UX clients to avoid the need for DNS or NIS services across the network e I O operation fails Timeout There are several possible causes The client may be attempting a transaction to a non existent or powered off device Check the address used as well as the status of the device The network connection or Gateway has gone down since the previous I O operation The I O timeout specified is not long enough for the transaction to complete You may need to verify that the Gateway I O timeout configuration value is long enough if the client specified a timeout value of infinity The Gateway is busy performing an I O operation for another client or another client has the device interface locked Use the Configuration Utility status command to determine 45 if another client is currently executing an operation or if the required device interface is locked See the following discussion Gateway appears to be hung for more information Gateway appears to be hung There are several possible causes Note that for all of the following use of client timeouts and or Gateway timeouts the I O timeout and LAN timeout configuration values can be used to ensure that the Gateway will not hang indefinitely The network connection has gone down or the Gateway has gone down The Gateway may be attempting a transaction to a non existent or powered off device Check the address used as
30. blem may be improper configuration value s for the subnet gateway and or the subnet mask If this is the case the Gateway may be receiving requests from the client but routing the replies to the wrong place To fix network configuration values when using the remote configuration method do one of the following actions e Ifa client can successfully telnet to the Gateway use the Configuration Utility commands to fix the values Then reboot using the save command e Use the t3020conf utility if it can find the 3020 box to fix the values Caution Any client operations in progress and client connections will be terminated by the save command 41 Client Connection Problems Once the TAMS 3020 LAN I O Gateway has been successfully configured and the configuration has been verified individual clients might still have problems getting a connection to the Gateway The first step is to verify that the client system has network access to the Gateway 1 Use the ping command as follows e Onan HP UX or Linux client system enter gt ping hostname or JP address For example gt ping new_host_name PING new_host_name 64 byte packets 64 bytes from 128 10 0 3 icmp_seq 0 time 8 ms 64 bytes from 128 10 0 3 icmp_seq 1 time 3 ms 64 bytes from 128 10 0 3 icmp_seq 2 time 3 ms 64 bytes from 128 10 0 3 icmp_seq 3 time 3 ms Each line after the PING line is an example of a packet successfully reaching the Gateway If after severa
31. d above another option is to use a screwdriver to take the sheet metal off the top of the box and then the internal switch is easily accessible Testing Network Configuration At this point the network parameters should have been customized and the Gateway box accessible on the network Confirm this by executing a ping command from a remote workstation directed to the Gateway box C gt ping new_host_name Pinging new_host_name with 32 bytes of data Reply from 192 168 0 1 bytes 32 time lt 10ms TTL 225 Reply from 192 168 0 1 bytes 32 time lt 10ms TTL 225 23 Reply from 192 168 0 1 bytes 32 time lt 10ms TTL 225 Reply from 192 168 0 1 bytes 32 time lt 10ms TTL 225 Ping statistics for 192 168 0 1 Packets Sent 4 Received 4 Lost 0 0 loss Approximate round trip times in milli seconds Minimum Oms Maximum Oms Average Oms If reliable communication cannot be established review the appropriate section on network configuration Try pinging to 192 0 0 192 to see if the IP address did not get changed as expected As a last resort use the Default Configuration method above Default Parameter Values All Interfaces During configuration the default values for networking must be modified in order to give the Gateway box an IP address on a local subnet Installed HP IB interfaces may be usable with their default values The factory default values for networking parameters as well as the other possible interfaces ar
32. ddress can be changed Log in as root user on the workstation Determine what the device name of the Ethernet connection to be used to communicate with the Gateway is This is frequently eth0 Confirm that with a route command The last column of output is labeled Iface and shows what interfaces are being used for the various routes Generally ethO and lo will be the only two shown The eth0 interface is the physical interface to the LAN The command needed to add the routing with eth0 is route add host 192 0 0 192 dev eth0 Consult the manual pages for route and netstat if trouble is encountered in adding the proper route Now jump ahead to the section Remote Configuration Continued Remote Configuration from an HP UX Workstation The Gateway is initially configured with an IP address of 192 0 0 192 and subnetting disabled Since this address will most likely not be in your local subnet routing from an HP UX workstation must be set up to allow initial communication with the Gateway until such time as the Gateway IP address can be changed Log in as root user on the workstation Determine what the hostname of the HP UX workstation is with the uname n command The command needed to add the routing with eth0 is route add host 192 0 0 192 hostname Consult the manual pages for route and netstat if trouble is encountered in adding the proper route Now jump ahead to the section Remote Configur
33. e 1t and or modify it under the terms of the GNU General Public License as published by the Free Software Foundation either version 2 of the License or at your option any later version This program is distributed in the hope that it will be useful but WITHOUT ANY WARRANTY without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE See the GNU General Public License for more details 59 You should have received a copy of the GNU General Public License along with this program if not write to the Free Software Foundation Inc 675 Mass Ave Cambridge MA 02139 USA Also add information on how to contact you by electronic and paper mail If the program is interactive make it output a short notice like this when it starts in an interactive mode Gnomovision version 69 Copyright C 19yy name of author Gnomovision comes with ABSOLUTELY NO WARRANTY for details type show wl This is free software and you are welcome to redistribute it under certain conditions type show c for details The hypothetical commands show w and show c should show the appropriate parts of the General Public License Of course the commands you use may be called something other than show wi and show c they could even be mouse clicks or menu items whatever suits your program You should also get your employer if you work as a programmer or your school if any to sign a copyright disclaimer for the p
34. e shown in the following table See Chapter 4 for additional information on what values are appropriate for various parameters Network Parameters hostname T3020 ip 192 0 0 192 gateway 0 0 0 0 subnetmask 0 0 0 0 lantimeout 0 iotimeout 120 maxconnections 0 HP IB Parameters Symname gpibl gpib2 LU 8 9 HP IB Address 21 Note Where multiple entries are shown they re for the first and second installed interfaces The hardware address value for networking is programmed at the factory and cannot be changed It is unique for each Gateway box 24 Where to Go Now You have now finished configuring the network parameters of the TAMS 3020 LAN I O Gateway Continue on to Chapter 4 for an overview of communicating with instruments connected to your 3020 Gateway or go to Chapter 5 to learn to use all the commands provided by the Configuration Utility in the Gateway box Likewise if you ever encounter problems with the Gateway please refer to Chapter 6 Troubleshooting 25 4 Usage with SICL VISA Applications This chapter shows how to use the TAMS 3020 LAN I O Gateway to remotely access an instrument via the gateway This chapter is only meant as an overview of the steps needed to get a SICL or VISA application to work remotely with the 3020 Gateway rather than a local instrument The examples assume the client is either Red Hat Linux or HP UX For complete details refer to the SICL and VISA documentation l
35. e sure no other machine is using that IP address Use ping to see if another machine responds to that IP address 8 Asa last resort use the default configuration method to reset the 3020 configuration default IP is 192 0 0 192 Troubleshooting Remote Configuration via telnet If you are having trouble configuring the LAN I O Gateway using telnet with the default IP address of 192 0 0 192 do the following 1 Use the t3020conf utility if possible to configure the Gateway rather than the telnet method 2 Verify that the route command was performed properly Use the following command to display the network routing tables gt netstat r 3 Verify that the Gateway is on the same local subnet as the client system from which you are Telneting If not consult your Network Administrator to determine if the default IP address will work from a separate subnet or to find a client system on the same local subnet that you can use 4 Make sure no other device with an IP address of 192 0 0 192 exists on the local subnet including another 3020 Gateway Try a ping command with your 3020 Gateway powered off 5 Verify that the LAN cable is fully connect to the 3020 and the LED next to the connector is flashing green Troubleshooting Network Configuration If some of the network configuration values for the TAMS 3020 LAN I O Gateway are improperly configured one or more client systems may not be able to make a connection to the Gateway The pro
36. eis ee 40 Client Connection PS o tes pet ad at acs 42 Client Runtime EOS A A A cots ein doa Eder 44 A Technical Referente ra 48 SEET n 48 HP IB Characteristics A aareagsaenvedseatalaen see daca eee eies etree 48 BE 252 Nella Writ tl ee eecht 49 B Related Software DOCUMENTACION A a eben 50 TAMS SICL and VISA for HP UX 111 Documentatpon ccc eececececccccccceceeeeeececeeeees 50 TAMS SICL for RedHat Linux Documentaton 50 HP SICL Documentation esn r la dd dt rd Sedena 51 O a dando cad ald ata AT EE cad E las Malacca edas ea 51 HP VBE Documentation cl 51 HP BASIC UX 700 Documentation DEE 51 TAMS BASTOGEXD CUA OA tdi 52 C Client Software Matus OS 53 O BEG AAC CUS A ee 54 E Els id E E 61 o san cdot cusacyenag cats aun ceases e E decas one vaateaupecapeas secaa tee pachi at eas A 63 A AAA 64 1 Overview This chapter provides a general overview of the TAMS 3020 LAN I O Gateway including e Anexplanation of the contents of your TAMS 3020 product package e A brief overview of the TAMS 3020 LAN I O Gateway s functionality Figure 1 1 Components of the TAMS 3020 Product TAMS 3020 Package Contents Your TAMS 3020 product package contains the following items TAMS 3020 LAN I O Gateway Power cord Mounting rails CD containing this Manual and software for configuring the 3020 on your network As shown in Figure 1 3 the back panel of the Gateway has the following from right to left AC power switch AC power rec
37. eptacle RS 232 connector One RJ 45 connector for 10BaseT or 100BaseTX Ethertwist LAN Slots labeled gpib1 and gpib2 Card slots for use with supported PCI interface cards NOTE the RS 232 port is NOT supported for connection to instruments rather it is supported as a serial terminal port but is not needed at all in normal operation Mounting rails are included that allow the TAMS 3020 Gateway to be securely mounted with screws to a suitable base Attach the rails to the bottom or side of the Gateway with 6 32 screws supplied and attach the rails to a base with customer supplied hardware Use of these rails is optional and they will not be required in many situations Also included are four stick on rubber feet to avoid damage to tables if the unit is to be used on a table The unit can be used vertically or horizontally there is no restriction After determining in which orientation the unit will be used affix the rubber feet to the four corners of the bottom Product Overview The TAMS 3020 LAN I O Gateway combines hardware and firmware in a small box that provides a network gateway between network equipped computer systems and instruments The Gateway enables users of I O applications to obtain measurement data either locally or remotely from HP IB instrumentation The Gateway connects the local area network LAN from the computer system to one or more local instrumentation busses At this time the available bus is HP IB
38. erface in the Gateway box It is for information only and may be requested by the System Administrator for the subnet where the Gateway box resides gt hwaddress hwaddress 00 02 B6 15 51 29 The number represents a 48 bit address that is unique to the LAN interface contained in the Gateway box ip The ip command displays or changes the Internet Protocol address of the Gateway box To change simply enter the desired address in standard notation four decimal numbers separated by three dots gt ip 192 128 12 2 gateway The gateway command displays or changes the address of the subnet gateway This is a different use of the word than Gateway which is used in this document as an abbreviation for the product TAMS 3020 LAN I O Gateway On a subnet there usually is a machine with capabilities of routing traffic to other subnets The IP address of that machine should be used as a parameter for the gateway command Contact a System Administrator for that information if necessary Alternately the address 0 0 0 0 can be used to disable subnetting if there is no need to route traffic off the local subnet If all workstations are located on the same subnet as the 3020 then this situation applies subnetmask The subnetmask command is used to set the subnetmask to be used This is frequently 255 255 255 0 but check with your System Administrator to see if this is appropriate The same notation as is used for IP addresses is used but with
39. firm this with the ping command from the local workstation ping 192 0 0 192 Output similar to the following should be obtained Reply from 192 0 0 192 bytes 32 time lt 10ms TTL 255 Reply from 192 0 0 192 bytes 32 time lt 10ms TTL 255 Reply from 192 0 0 192 bytes 32 time lt 10ms TTL 255 Reply from 192 0 0 192 bytes 32 time lt 10ms TTL 255 Ping statistics for 192 0 0 192 Packets Sent 4 Received 4 Lost 0 0 loss Approximate round trip time in milli seconds Minimum Oms Maximum Oms Average Oms This shows four replies from the Gateway box On some platforms it may be necessary to type lt Ctrl C gt to terminate the ping command If the ping command cannot communicate successfully with the Gateway review the routing that should be in place the physical LAN cabling and make sure the Gateway is powered up Consult with your local System Administrator for assistance in dealing with 20 network problems It may be necessary to use the Default Configuration method of configuring the Gateway box although difficulties in communicating with it at the default address of 192 0 0 192 suggest that the same problems will occur when it is reconfigured to reside at a local subnet address Now communications with the Gateway box have been successfully demonstrated and we re ready to configure network parameters and interface card parameters to suit the local environment The utility used for communication with the Gateway is
40. forms to IEEE 488 1 1987 specifications Per this specification the following constraints exist Total Bus length Less than 2 meters x number of devices and no more than 20 meters total length Linear bus topology recommended Length between devices Less than 2 meters between each device or equivalent standard load Total number of devices 15 devices or less includes TAMS 3020 LAN I O Gateway 48 Address restrictions Address 31 is a reserved IEEE 488 address The TAMS 3020 LAN I O Gateway normally uses address 21 unless changed in the configuration table Drivers The TAMS 3020 LAN I O Gateway uses 48mA three state drivers E2 RS 232 Serial Terminal Refer to your serial terminal documentation and or PC hardware software documentation to setup a serial terminal to the 3020 Gateway The 3020 Gateway is expecting the following communication parameters to be used in your serial terminal software configuration Baud rate 38400 Parity Odd Data bits 8 Stop Bits 1 A serial terminal is not needed for this product It can be used to see the boot sequence and also once the 3020 is fully booted the current configuration values are displayed 49 B Related Software Documentation This appendix explains what software manuals you should follow to use the TAMS 3020 LAN I O Gateway with these I O application software products e TAMS SICL and VISA for HP UX 11i e TAMS SICL for RedHat Linux e HP SICL e HP VISA e HP VEE
41. ft of the connector and the nut used to screw in the RS 232 cable e Find a small straight rigid probe that can be inserted in the hole at least 1 inch Possible items include a paper clip bent straight a toothpick a twist tie bent straight You will need an item roughly at least 2 inches long to make room for your fingers holding one end of it and still be able to insert it the proper depth e Insert the probe in the hole until it stops It should go in straight but downward at about a 30 degree angle The insert should stop at roughly 1 inch deep and you might hear the switch click as it is engaged if you listen closely If the probe keeps going it is inserted at an incorrect angle try again e While holding the probe in place with the internal switch engaged power on the 3020 Gateway KEEP HOLDING THE PROBE IN PLACE FOR AT LEAST 7 SECONDS AFTER POWER UP The switch must be engaged during the first 7 seconds after power up or the 3020 Gateway will not change it s configuration e Wait 3 minutes for the 3020 Gateway to fully boot It will now be set to use the default network configuration as documented previously in this chapter IP address 192 0 0 192 After the above procedure the 3020 Gateway will be set to it s default configuration as documented previously in this chapter You may now use the t3020conf utility or telnet to remotely configure the 3020 Gateway on your network If you have trouble with the probe procedure documente
42. hen we speak of free software we are referring to freedom not price Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software and charge for this service if you wish that you receive source code or can get it if you want it that you can change the software or use pieces of it in new free programs and that you know you can do these things 54 To protect your rights we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights These restrictions translate to certain responsibilities for you if you distribute copies of the software or if you modify it For example if you distribute copies of such a program whether gratis or for a fee you must give the recipients all the rights that you have You must make sure that they too receive or can get the source code And you must show them these terms so they know their rights We protect your rights with two steps 1 copyright the software and 2 offer you this license which gives you legal permission to copy distribute and or modify the software Also for each author s protection and ours we want to make certain that everyone understands that there is no warranty for this free software Ifthe software is modified by someone else and passed on we want its recipients to know that what they have is not the original so that any problems introduced by others will not reflect on the
43. if needed by the above steps If wxPython is not installed the t3020conf will still be useable in a command line mode rather than GUI mode If Python is not installed on your Linux machine the t3020conf will not work in either mode go to www python org to download Python to your Linux machine Windows installation A installation wizard should automatically start once you insert your CD into the CD drive and close the door If not use the windows explorer to browse to your CD folder Double click on windows Setup exe Follow the instructions in the 3020conf installation wizard No additional software is needed Running t3020conf Utility Note The most important configuration value is the Internet Protocol IP address of the 3020 LAN Gateway Without a proper IP address the Gateway may appear dead or operate unexpectedly IP addresses for network devices are assigned by a designated Network Administrator in your workplace If you are not the Network Administrator you will need to contact the designated Network or System Administrator who can assign the TAMS 3020 Gateway s IP address for you The LAN Gateway product does not support DHCP addressing so a fixed IP address must be assigned to it Please refer to the appropriate sections of LAN Configuration Values which is later in this chapter for detailed descriptions of IP address hostname and other networking terms Launching this utility under RedHat Linux For RedH
44. ings of VISA do not include command line utilities although others may For instruments connected to the Gateway VXIp ug amp play drivers are frequently available to minimize the programming required under VISA Contact the maker of the instrument for information These are more commonly available for Windows clients rather than Linux HP UX The TAMS 3020 Gateway can handle application programs written in SICL and VISA simultaneously Different instruments on a bus can use the two different libraries but any one instrument must use the same library when being accessed See the www tamsinc com website for further details on supported configurations Where to Go Now Now that you understand how the TAMS 3020 LAN I O Gateway works you are ready to install and configure the Gateway Please continue on to the next chapter Installation 10 2 Installation This chapter explains how to install the TAMS 3020 LAN I O Gateway on the LAN and local busses for use with network equipped computer systems To complete the installation you will do the following 1 Ensure that you have the hardware and software required 2 Install the Gateway hardware by connecting it to the LAN HP IB busses and AC power The following sections explain how to complete these installation steps Prerequisites This section lists the hardware and software you need to install the TAMS 3020 LAN I O Gateway Hardware Requirements To install the Gateway
45. is method The utility is supported on Windows 98 Windows 2000 Windows XP or RedHat Linux operating systems If you only have HP UX machines available on your network you will not be able to use this utility 2 Use the standard operating system telnet facility from a remote client With this method all the configurable parameters provided by the 3020 LAN Gateway can be changed With this method the hostname or IP address of the 3020 must be know otherwise t3020conf should be used to find these values If you are familiar with using telnet and setting up the routing table route command on your client this method will be easy to do otherwise you may find it difficult 3 Access the reset switch inside the 3020 box If this switch is engaged while powering up the 3020 box the box will boot into the factory default network configuration In the rare case where the 3020 LAN Gateway network values have been incorrectly set such that the 3020 is unreachable on your network this method can be used to restore the default 3020 LAN Gateway values You will then have to use one of the methods above for final configuration on your local subnet Remote Configuration via t3020conf Utility This utility is designed to ease getting the initial setup of the 3020 LAN Gateway on your network completed It is also designed to help discover the current 3020 LAN Gateway network values in case they are unknown forgotten The t3020conf finds your 3020
46. isted in Appendix B After you have finished network configuration of the Gateway as outlined in the previous chapter the next step is to connection your instrument to the 3020 Gateway HP IP connector and then configure a virtual LAN device under your I O library SICL or VISA on your client machine Then you can run your SICL VISA application using this virtual LAN device on your client machine Connecting your instrument to the 3020 Gateway The 3020 supports up to 2 HP IB busses Your 3020 Gateway comes with either 1 or 2 HP IB interface cards if only one then obviously only one HP IB bus is available Plug your HP IB cable into the desired HP IB connector on the back of the 3020 box Notice the labels gpib1 and gpib2 as these are the symbolic HP IB device names used by the 3020 for the two HP IB interface cards that can be plugged into the 3020 Choosing a LAN protocol As previously mentioned there are two low level LAN protocols which are supported by the 3020 Gateway SICL LAN and VXI 11 LAN aka TCP IP instrument protocol SICL LAN was developed by Hewlett Packard transfered to Agilent Technologies and is the default choice when configuring a virtual LAN device on your system using TAMS iosetup VXI 11 LAN was developed by the VXIbus Consortium and permits the interoperability of LAN software from different vendors If your client application uses TAMS or Agilent VISA or SICL I O libraries then SICL LAN should be chose
47. ith the new values This is done automatically by the save command when required After the reboot the IP address of the Gateway is changed and further remote accesses to it via ping telnet or application programs must be done to the new address If the network parameters were successfully modified you may want to jump to the Testing Network Configuration section at the end of this chapter to verify proper operation If trouble was experienced in setting network parameters you may need to continue on with the Default Configuration section following The default values for all parameters are listed in the Default Values section of the chapter to allow you to decide if any further parameter value changes are needed for your system 22 Default Configuration This method can only be used to reset the 3020 Gateway configuration to the factory set defaults The main reason that this method is used is to recover from a situation when the box was programmed with an improper IP address subnet mask etc and can no longer respond on your network via telnet or t3020conf as described earlier in this chapter 3020 Gateway reset configuration procedure e Power off your 3020 Gateway and make sure it is sitting on it s bottom such that the power switch is near the upper right corner of the box e Locate the small round hole in the back plate of the 3020 This is on the left edge of the backplate near the RS 232 connector The hole is to the le
48. l seconds ping does not print any lines use lt Ctrl C gt to kill ping The ping command will then report on what it found For example new_host_name PING Statistics 7 packets transmitted 0 packets received 100 packet loss This indicates that the client was unable to contact the Gateway It could be that the Gateway is on a different subnet than the client see your Network Administrator or the Gateway could have incorrect network configuration values see the previous information on Troubleshooting Network Configuration e Ona Windows client system enter gt ping hostname or IP_address For example gt ping new_host_name Pinging new_host_name 128 10 0 3 with 32 bytes of data Reply from 128 10 0 3 bytes 32 time 10ms TTL 255 Reply from 128 10 0 3 bytes 32 time 10ms TTL 255 Reply from 128 10 0 3 bytes 32 time 10ms TTL 255 Reply from 128 10 0 3 bytes 32 time 10ms TTL 225 Each line after the Pinging line is an example of a packet successfully reaching the Gateway from the client system However 1f ping is unable to reach the host you will see a message similar to the following Pinging new_host_name 128 10 0 3 with 32 bytes of data Request timed out Request timed out Request timed out 42 This indicates that the client was unable to contact the Gateway It could be that the Gateway is on a different subnet than the client and subnetting is not properly configured see your Network Administrator
49. lan is the virtual SICL LAN name as specified to iosetup as the symbolic name T3020 is the host name for the 3020 fully quailified domain names or IP addresses are also acceptable spib1 is the 3020 interface symbolic name 22 is the HP IB bus address of the instrument A second example would be vxilan 213 166 109 8 gpib2 20 Here communication will be with VXI11 LAN protocol to a Gateway with IP address 213 166 109 8 and gpib2 interface card and onto HP IB bus address 20 Refer to your application documentation to see how a device address is specified to the application Configuration for VISA Make sure to first do the steps under Configuration with SICL which generates two LAN virtual devices named sicllan and vxilan Use iosetup to add two virtual LAN devices one for SICL LAN and one for VXI 11 LAN su root Password opt sicl bin iosetup click configure VISA in the Unconfigured interfaces list box select sicllan click on configure For the interface name any of the choices will work let s assume GPIB1 is chosen For Remote Hostname enter the TAMS 3020 Gateway hostname For Remote SICL interface name enter gpib1 or gpib2 Click on Automatically identify all devices at runtime 27 Click on ok Clike on ok on the main menu in the Unconfigured interfaces list box select vxilan click on configure For the in
50. lue is the IP address of the subnet gateway that allows the TAMS 3020 LAN I O Gateway to communicate with systems that are not on the local subnet Thus this is the subnet gateway where packets are sent which are destined for a device not on the local subnet as determined by the subnet mask setting See the explanation for the subnet mask configuration value Only one subnet gateway can be configured A value of 0 0 0 0 indicates that no subnetting is to be done which is the equivalent of setting the subnet gateway address to the IP address of the LAN I O Gateway A device on the network does not need a gateway if all communication with it will occur on its subnet Subnet Mask This value is used to enable the LAN I O Gateway to determine if an IP address is on the same local subnet as the LAN I O Gateway itself When an address is on a different subnet all packets must be sent to a subnet gateway The subnet mask is sometimes not needed with today s smart subnet gateways which automatically know when to forward packets between subnets A value of 0 0 0 0 indicates no subnetting is to be done That is no packets will be forwarded between subnets and the LAN I O Gateway must be used with clients that reside on the same subnet 17 LAN Timeout This has a value specified in seconds When set to 0 there is no limit on how long the system will wait for a LAN transaction to complete No keepalive probes are sent If set to a non zer
51. machines Routing is not required when communicating between machines on the same subnet Firewalls Some clients such as Linux workstations can be configured with firewalls In many applications the client will be shielded behind a larger firewall that provides adequate protection from the Internet Firewalls configured on the client or between the client and the Gateway can sometimes cause problems in communicating with the Gateway With one LAN interface a firewall at the client may need to be disabled to avoid problems If this is not feasible due to security concerns an additional LAN interface not shielded by the firewall may be added to the client to communicate with the Gateway SICL vs VISA SICL Standard Instrument Control Library was developed by HP and transferred to Agilent Itis a client side programming library that allows applications to be written to allow remote access to instruments across LAN as well as locally It also includes command line utilities that have that capability SICL is supported today by Agilent for Windows clients and by TAMS for HP UX and RedHat Linux clients It is recommended that new applications be written with VISA when feasible due to the larger number of vendors who support that standard VISA Virtual Instrument Software Architecture is standardized by the VXIplug amp play Systems Alliance to provide similar capabilities as SICL but with wider industry support The Agilent and TAMS offer
52. mands in depth explaining how you can use the commands to accomplish the following administration tasks e Querying the Gateway s Current Configuration e Modifying the Gateway s Configuration e Querying the Status of the Gateway and Client Connections e Terminating All Client Connections to the Gateway e Determining the Version of the Gateway s Firmware 28 Accessing the Configuration Utility Any time you need to use the Configuration commands follow this procedure to access the Configuration Utility 1 If you re using a Windows system login if required and open an MS DOS window For Windows 98 select Start Programs MS DOS Prompt For Windows 2000 select Start Programs Accessories Command Prompt For Windows XP Professional select Start Command Prompt If you re using an HP UX or RedHat Linux client system login Ifa graphical user interface GUI is in use open a window with a command line interface 2 Type the command telnet JP address or hostname lt Return gt Where e JP address is the IP address of the TAMS 3020 LAN I O Gateway The IP address is a required configuration value that was previously set for the Gateway via one of the configuration methods discussed in Chapter 3 Configuration e hostname is the hostname Internet domain name of the TAMS 3020 LAN I O Gateway The hostname is an optional configuration value that may have been previously set for the Gateway via one of
53. ment including an appropriate copyright notice and a notice that there is no warranty or else saying that you provide a warranty and that users may redistribute the program under these conditions and telling the user how to view a copy of this License Exception if the Program itself is interactive but does not normally print such an announcement your work based on the Program is not required to print an announcement These requirements apply to the modified work as a whole If identifiable sections of that work are not derived from the Program and can be reasonably considered independent and separate works in themselves then this License and 1ts terms do not apply to those sections when you distribute them as separate works But when you distribute the same sections as part of a whole which is a work based on the Program the distribution of the whole must be on the terms of this License whose permissions for other licensees extend to the entire whole and thus to each and every part regardless of who wrote it Thus it is not the intent of this section to claim rights or contest your rights to work written entirely by you rather the intent is to exercise the right to control the distribution of derivative or collective works based on the Program In addition mere aggregation of another work not based on the Program with the Program or with a work based on the Program on a volume of a storage or distribution medium does not bring the
54. n as the widest range of SICL operations will be permitted If your client application uses other vendors I O libraries then the VXI 11 LAN protocol should be chosen Configuration for SICL Use iosetup to add two virtual LAN devices one for SICL LAN and one for VXI 11 LAN su root Password opt sicl bin iosetup in the Available interfaces list box select VXI 11 LAN client click configure A menu will pop up for our example change the symbolic name to vxilan click ok in menu In the Available interfaces list box select SICL LAN client click configure A menu will pop up for our example change the symbolic name to sicllan click ok in menu click ok in main menu 26 Now we have two virtual LAN devices configured on our client machine named sicllan and vxilan which can be used to run SICL based applications on our client machine to a remote instrument connected to the 3020 Gateway Running a SICL application To run a SICL application the following information needs to be specified as the device address 1 virtual LAN device symbolic name configured by iosetup 2 hostname or IP address of 3020 Gateway 3 HP IB interface symbolic name and bus address This information is specified with syntax as follows lt virtual LAN name gt lt IP address hostname gt lt HP IB symbolic name gt lt HP IB address gt An example would be sicllan T3020 gpib1 22 sicl
55. n displayed to show a choose a interface device Default Network Configuration Settings The TAMS 3020 LAN Gateway is shipped from the factory with default settings for the configuration values listed in Table 3 1 You can use the methods described in the next section to change any of the configuration values as needed The TAMS 3020 LAN Gateway uses these default configuration values until you explicitly change any of these values and set any other configuration values The Gateway also reloads these values when the reset action method described later is done Parameter Default Value t3020conf configurable Hostname T3020 Yes IP address 192 0 0 192 Yes Subnet Gateway Address 0 0 0 0 Yes Subnet Mask 0 0 0 0 Yes LAN timeout 0 No T O timeout 120 No Maxconnections 0 No Table 3 1 Default Configuration Table List of Configuration Values This section provides a brief description of the configuration values that are used to configure the TAMS 3020 LAN I O Gateway on a network Later sections describe advanced methods to configure these values The t3020conf basic configuration method has previously been described 16 The following pages list the configuration values that are used to configure the LAN I O Gateway on a network The configuration values for interfaces other than LAN is also deferred until Chapter 4 Hostname This value configures the Internet domain name for the LAN I O Gateway This
56. name is used in some error and status messages but is not a required configuration setting The t3020conf utility displays hostnames after probing for machines on your subnet This can be a simple hostname or may be a fully qualified domain name Each period delimited field may be a maximum of 63 alphanumeric characters with a total of 254 characters Hardware Address This value is the unique address of the LAN interface in the TAMS 3020 LAN I O Gateway Note that this is also often called the link level address the Ethernet station address the MAC Address or the LANIC ID This address is uniquely programmed during manufacture and cannot be changed It can be read through the Configuration Utility but is not normally used during configuration You Network Administrator may want to be informed of this address for troubleshooting or security purposes IP Address This value is the Internet Protocol IP address of the LAN I O Gateway The IP address is a required value and is used for all IP and TCP IP communications with the LAN I O Gateway The IP address is represented in dotted decimal notation for example 15 1 222 201 This number is not assigned by TAMS rather it is assigned by your designated Network Administrator The LAN I O Gateway uses the default IP address of 192 0 0 192 as a temporary IP address until you configure a real IP address The t3020conf utility uses the IP address extensively Subnet Gateway Address This va
57. ns for copying distributing or modifying the Program or works based on it 6 Each time you redistribute the Program or any work based on the Program the recipient automatically receives a license from the original licensor to copy distribute or modify the Program subject to these terms and conditions You may not impose any further restrictions on the recipients exercise of the rights granted herein You are not responsible for enforcing compliance by third parties to this License 7 If as a consequence of a court judgment or allegation of patent infringement or for any other reason not limited to patent issues conditions are imposed on you whether by court order agreement or otherwise that contradict the conditions of this License they do not excuse you 57 from the conditions of this License If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations then as a consequence you may not distribute the Program at all For example if a patent license would not permit royalty free redistribution of the Program by all those who receive copies directly or indirectly through you then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program If any portion of this section is held invalid or unenforceable under any particular circumstance the balance of the section is intended to apply and the section as a
58. nux on at least one client this is not required but very useful software To learn how to install and configure these software products for use with the Gateway please refer to Appendix C Related Software Documentation Installing the Hardware This section explains how to install the LAN I O Gateway hardware by connecting it to the LAN and peripheral interface busses Make sure the HP IB instruments you will connect to the Gateway are working properly Connect the Gateway to the network as shown on the following pages Connect the LAN cable to the RJ 45 connector on the back panel of the Gateway For a 10BaseT network use Cat 3 or Cat 5 cabling For a 100BaseTX network use only Cat 5 cabling 3 Connect the HP IB cable s from the HP IB instrument s to the HP IB connector s on the back panel of the Gateway Tighten the small screws on the smaller HP IB connector gently with a small flat blade screwdriver Each connector on the back of the Gateway is connected to a separate bus Within each bus insure that unique bus addresses are used Linear topologies are recommended 4 Set the AC power switch to off 0 depressed connect the power cord to a power outlet and to the power receptacle Then turn the power switch to on The red power light should come on 5 The Gateway box takes about 2 to 3 minutes to boot and be ready for operation If you can successfully telnet to the Gateway then it is ready for operation Alterna
59. o value then the system waits that number of seconds for an inactive connection If no activity occurs during that amount of time then keepalive probes are sent periodically to the client for approximately 11 minutes to see if it is still alive If that time limit is also exceeded with no response then the connection will be marked as down dropped and the Gateway will release any resources which were allocated to the associated client The second time limit is fixed not configurable by the user UO Timeout This value sets the server I O timeout in seconds This configures the Gateway to use an I O timeout of the specified amount of seconds if the client requests a timeout of infinity If 0 is specified for this value and the client requests infinity then the Gateway will use a timeout of infinity as requested This timeout value may be used to ensure that the Gateway does not wait indefinitely for an I O operation This also allows the Gateway to detect certain network events such as a client connection being dropped which may otherwise go undetected If the Gateway detects such a condition it will release any resources such as locks associated with the client Maximum Connections This specifies the maximum number of client connections that can have open sessions This may be useful when troubleshooting or to control resource usage of client processes Anywhere from 1 to 40 connections can be specified in order to bound resource usage
60. on Problems e Client Connection Problems e Client Run time Errors Note Throughout the troubleshooting information in this chapter reference is often made to Configuration commands you can use to troubleshoot problems The Configuration Utility commands for the TAMS 3020 LAN I O Gateway are fully explained in Chapter 5 Administration Also reference is often made to various configuration values See Chapter 3 Configuration for descriptions of the configuration values used with the LAN I O Gateway as well as the methods used to configure the Gateway HP SICL LAN Error Codes and Messages The following table lists the more common SICL LAN error codes and messages that a client application might encounter when using the TAMS 3020 LAN I O Gateway The final column in the table Troubleshooting Explanation explains the error and suggests possible troubleshooting procedures to try Error Code Error Message Troubleshooting Explanation I ERR BADADDR Bad address The device interface address passed to iopen doesn t exist Use the Configuration Utility to verify that the symname and LU for the desired interface are correct I ERR NOCONN No connection The communication session with the Gateway was never established or the connection to a remote Gateway was dropped Use the Configuration Utility status command to get more information I ERR NORSRC Out of resources No more resources are avail
61. or along with the IP address Enter it as follows gt hostname new_host_name The line that says gateway 0 0 0 0 must also be changed if subnetting is to be enabled In the usage gateway refers to the subnet gateway a machine that routes packets into and out of the local subnet when required This is a different use of the term than Gateway which is used as shorthand for the TAMS 3020 LAN I O Gateway in this document If there is a computer designated as the gateway for the subnet on which the 3020 Gateway box resides then its IP address is appropriate here Simply type in its address gt gateway WWW XXX y Y Y ZZZ The default value of 0 0 0 0 is acceptable if no communication across subnets i e subnetting is to be done If subnetting is to be used then the subnetmask should also be configured at this time In most situations 255 255 255 0 is appropriate but check with your local System Administrator for confirmation Set the chosen subnetmask as follows gt subnetmask 255 255 255 0 The default value of 0 0 0 0 is acceptable if no communication across subnets i e subnetting is to be done None of these networking parameters have actually been changed yet in non volatile memory Do a config command to allow verification of the parameters and if they are satisfactory then enter the save command This is necessary to save the changed values in memory A reboot is also needed to allow the networking to be restarted w
62. or another peripheral such as a printer or plotter gateway A device that permits a network connection between the LAN that your computer understands and the instrument specific interface that your device understands instrument A device that accepts commands and performs a test or measurement function interface A connection and communication media between devices and controllers including mechanical electrical and protocol connections LAN Local Area Network lock A state that prohibits other users from accessing a resource such as a device or interface logical unit A logical unit is a number associated with an interface In SICL a logical unit uniquely identifies an interface Each interface on the controller must have a unique logical unit server Part of the client server model used in distributed computing The server is a computer system designated to act as a main servicer of requests from other client computer systems such as I O application requests networking requests and so forth 61 SICL The Standard Instrument Control Library which is client side software used for I O application programming SRQ Service Request An asynchronous request an interrupt from a remote device indicating that the device requires servicing symbolic name A name corresponding to a single interface This name uniquely identifies the interface on a controller or gateway If there is more than one interface on the controller
63. or gateway each interface must have a unique symbolic name VEE The HP Visual Engineering Environment which is software used for I O application programming VISA The Virtual Instrument Software Architecture library which is client side software used for I O application programming Available from multiple vendors 62 Warranty ONE YEAR LIMITED WARRANTY Test amp Measurement Systems Inc warrants to the purchaser that the product will be free of all defects in material and or workmanship for one year from the date of shipment to the customer In the event of malfunction or failure attributable directly to faulty material and or workmanship TAMS will at its option repair or replace the defective product or components to whatever extent it shall deem necessary to restore the product or component to proper operating condition TAMS may at its option repair or replace a defective unit with a new or refurbished unit The customer shall be solely responsible for the failure of any TAMS product resulting from accident abuse or misapplication of the product and TAMS assumes no liability as a consequence of such events under the terms of this warranty While TAMS has made every effort to provide clear and accurate technical information about the application of this product TAMS assumes no liability for any events arising out of the use of this technical information This Warranty gives you specific legal rights and you may also have
64. or the Gateway could have incorrect network configuration values see the previous information on Troubleshooting Network Configuration 2 Once ping works you can try the following rpcinfo commands from an HP UX or Linux client system using the Gateway IP name or IP address to verify proper operation of the SICL LAN and VXI 11 servers inside the Gateway gt rpcinfo p hostname or IP address This command should give the following response program vers proto port 100000 2 tcp 111 portmapper 100000 2 udp 111 portmapper 395180 1 tcp 1024 395183 1 tcp 1024 The port numbers for programs 395180 and 395183 may vary from the 1024 shown You can try the following two commands to verify operation of two servers inside the Gateway box gt rpcinfo t hostname or JD address 395180 program 395180 version 1 is ready and waiting and gt rpcinfo t hostname or IP_address 395183 program 395183 version ready and waiting The first command and response indicates the SICL LAN server in the Gateway box is operational while the second shows the VXI 11 server to be operational If either command fails to provide the indicated response try rebooting the Gateway box to recover If the problem persists contact TAMS for support These two servers should always be running to handle the SICL LAN and VXI 11 protocols respectively Note If the rpcinfo p command executes properly but rpcinfo t commands hang without completing this i
65. other rights which vary from state to state and from country to country This Warranty is in Lieu of all other express warranties which now or hereafter might otherwise arise with respect to this product ANY AND ALL IMPLIED WARRANTIES OF MERCHANT ABILITY AND FITNESS FOR PARTICULAR USE SHALL HAVE NO GREATER DURATION THAN THE PERIOD FOR THE EXPRESS WRITTEN WARRANTY APPLICABLE TO THIS PRODUCT AS SHOWN ABOVE AND SHALL TERMINATE AUTOMATICALLY AT THE EXPIRATION OF SUCH PERIOD Some states and countries do not allow limitations on how long an implied warranty lasts so this limitation may not apply to you No action shall be brought for breach of any implied or express warranty after one year subsequent to the expiration of the period of the express written warranty Incidental and consequential damages caused by malfunction defect or otherwise and with respect to breach of any express or implied warranty are not the responsibility of TAMS and to the extent permitted by law are hereby excluded both for property and to the extent not unconscionable for personal injury damage Some states do not allow the exclusion or limitation of incidental or consequential damages so the above limitation or exclusion may not apply to you 63 Index aborting transactions oococcnonicononocnononnnanononnnono noc nonncnnonnnns 48 addressing DACP ota ia iia 15 GE 15 application software 8 BASIC LX se BASIC U X 700 piin Ed 52 cabling I P 1B EE
66. other work under the scope of this License 3 You may copy and distribute the Program or a work based on it under Section 2 in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following a Accompany it with the complete corresponding machine readable source code which must be distributed under the terms of Sections and 2 above on a medium customarily used for software interchange or 56 b Accompany it with a written offer valid for at least three years to give any third party for a charge no more than your cost of physically performing source distribution a complete machine readable copy of the corresponding source code to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange or c Accompany it with the information you received as to the offer to distribute corresponding source code This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer in accord with Subsection b above The source code for a work means the preferred form of the work for making modifications to it For an executable work complete source code means all the source code for all modules it contains plus any associated interface definition files plus the scripts used to control compilation and installation of the executable However as a special
67. re manuals you should reference to use the Gateway with your I O application software Appendix C Client Software Matrix Appendix D Software License Appendix E Glossary Warranty Information Index TAMS 3020 Table of Contents a a dd sd 6 TAMS 3020 Package e 6 Eegeregie eeh eet 6 A eaea auc ce Oia eed a e lane bal date aurea a E 10 EE ee eeh 11 PESTE QUISTES A AN AD AA TA IIS 11 Installing the Hard ware is ob 12 Wier TOCAN EE 12 3 Network CON aos 13 Remote Configuration via t3020conf Ulm 13 Installing t3020conf UN A A citada 13 Running t3020conf Utility E 14 Default Network Configuration Sete DA 16 List of Configuration Valls ia td 16 Remote Configuration via Een Eelere 18 Detaplt NET Ee EE 23 VV TREES E Te 25 4 Usage with SICL VISA Applications cosita 26 Connecting your instrument to the 3020 Gateway cooooccocococcconocononononoconaconanonn cono ncconocnnnos 26 Choosing a LAN EE 26 Config ration for SIC Essie na iS 26 Running a Ee EEN 27 Configuration for VISA pt is 23 Runmins a VISA ppt o 28 A EE 28 Accessing the Configuration Uta td diia 29 Exiting the Configuration Ut a 30 Global CSG iT ATS aes cates cre e a ce seuaes veto va sansa ete sae Busnes E a se le aes eeu 30 LAN Configuration Command eege 31 TAO Interface Commands tos 33 Miscellaneous COMO d tr 34 Client Connection Management o e o at 35 Org LIE eer 39 HP SICL LAN Error Codes and Meggie dl bso 39 Network Connection Problems ii 40 Erl
68. rogram if necessary Here is a sample alter the names Yoyodyne Inc hereby disclaims all copyright interest in the program Gnomovision which makes passes at compilers written by James Hacker lt signature of Ty Coon gt 1 April 1989 Ty Coon President of Vice This General Public License does not permit incorporating your program into proprietary programs If your program is a subroutine library you may consider it more useful to permit linking proprietary applications with the library If this is what you want to do use the GNU Library General Public License instead of this License 60 E Glossary address A string uniquely identifying a particular interface or a device on that interface which is interpreted at the TAMS 3020 LAN I O Gateway to identify the interface or device client Part of the client server model used in distributed computing A client is a computer system that requests services from a server computer system such as I O application requests networking requests and so forth controller A computer used to communicate with a remote device such as an instrument In the communications between the controller and the device the controller is in charge of and controls the flow of communication that is it does the addressing and or other bus management device A unit that receives commands from a controller Typically a device is an instrument but could also be a computer acting in a non controller role
69. s allowed at any given time The value of 0 represents no limit enforced although the finite resources of the Gateway product will create some practical limit Specifying a parameter of 1 through 40 inclusive allows you to limit the number of simultaneous connections to that number gt maxconnections 8 UO Interface Commands The following commands concern the installed I O interfaces in the Gateway list The list command shows all the configured interfaces except LAN along with all the current settings of the parameters Depending on the number of interfaces and the height of the window on the workstation some information may scroll off the top gt list Configured interfaces HP IB Interface LU 7 Symname gpibl Location 0 Address 21 33 The Location parameter shown for HP IB indicates where the interfaces reside edit The edit command allows the parameters of one interface to be edited Specify either the symbolic name or the logical unit number LU of the interface gt edit gpibl LU 8 Symname gpibl HP IB Address 21 The edit command displays the current setting of each parameter and allows a new value to be entered If the current value is acceptable simply hit the Enter or Return key Where a limited number of parameter values are allowed they are listed inside square brackets Edit is used to modify parameters of all interfaces except for LAN Those parameters are listed below HP I
70. s generally caused by a firewall on the client or between the client and Gateway blocking access If this is seen on a RedHat Linux machine review the firewall configuration to see if it is active 3 The telnet command can be used from any supported workstation to verify if a client has network access to the Gateway as well If the telnet command returns the message connection refused 43 then connectivity on the network has been shown but there may be an internal error in the Gateway If one client has the Configuration Utility open and another client attempts to use the utility then an error is generated for that other client For Windows clients other than XP Professional the error is Connection to host lost For Windows XP Professional clients there generally will be no error message visible For a Linux or HP UX client the error is Connection closed by foreign host If a client opens the Configuration Utility and leaves it open due to a crash or network failure it may be necessary to power cycle the Gateway box to recover from that situation 4 The iclear command can be used to verify connectivity from the client to the server iclear lan T3020 hpib An error message of Bad address or Invalid address returned generally indicates that lan is not set up properly on the client machine Use the iosetup utility on the client to correct the problem Client Run time Errors When debugging problems involving applic
71. s new problems or concerns Each version is given a distinguishing version number If the Program specifies a version number of this License which applies to it and any later version you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation If the Program does not specify a version number of this License you may choose any version ever published by the Free Software Foundation 10 If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different write to the author to ask for permission For software which is copyrighted by the Free Software Foundation write to the Free Software Foundation we sometimes make exceptions for this Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally NO WARRANTY 58 11 BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE THERE IS NO WARRANTY FOR THE PROGRAM TO THE EXTENT PERMITTED BY APPLICABLE LAW EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND OR OTHER PARTIES PROVIDE THE PROGRAM AS IS WITHOUT WARRANTY OF ANY KIND EITHER EXPRESSED OR IMPLIED INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU
72. sional TAMS SICL and VISA for RedHat Linux TAMS 3020 configuration utility for RedHat Linux TAMS 3020 configuration utility for Windows 2000 or XP Professional VISA software is also available from other vendors VXIplug amp play drivers are available for many instruments to minimize programming required by the user Note HP IB interfaces installed in the LAN I O Gateway support all I O application operations provided by these software products except for parallel polling SICL commander sessions and asynchronous aborting Note There are two different LAN networking protocols used for communicating with instruments SICL LAN Protocol and the newer VXI 11 Protocol also known as the TCP IP Instrument Protocol The TAMS 3020 Gateway product supports use of either protocol One or both must be configured on the client in order to communicate with the server TAMS 3020 LAN I O Gateway How UO Application Software Works with the Gateway This subsection briefly summarizes how the software on a client computer system works with the TAMS 3020 LAN I O Gateway to complete I O application operations on attached instruments For more detailed information on how to use your software with the Gateway please refer Chapter 3 Usage or to your software documentation as listed in Appendix C Related Software Documentation Before trying to perform an I O application operation on a Gateway s interface the LAN client software in the client computer
73. system establishes a network connection to the LAN server the Gateway Once the client establishes a connection the client can begin to send I O requests to the Gateway The Gateway can have multiple clients connected and being serviced at any given time The maximum number of concurrent client connections depends on memory usage in the Gateway including the number of clients and the number of current sessions running on those clients If the maximum number of client connections to the Gateway has not been exceeded the connection is allowed to occur Although several instruments can be connected to the Gateway s HP IB bus only one I O operation can occur on the HP IB bus at any given time Therefore once a client s request begins to execute on the HP IB all other client requests for operations on the HP IB must wait until the current client request completes Client requests are serviced in a first come first served manner unless they are prohibited by interface or device locks Ifa client has a sequence of I O application operations to perform that should not be preempted the client should obtain a lock on the Gateway s HP IB interface or device Once the client s sequence has completed it should release its lock allowing other clients access When a client closes a connection the Gateway frees up the resources allocated to that client including any locks pending I O requests memory usage and so forth Abnormal termination for ex
74. terface name any of the choices will work let s assume GPIB2 is chosen For Remote Hostname enter the TAMS 3020 Gateway hostname For Remote SICL interface name enter gpib1 or gpib2 Click on Automatically identify all devices at runtime Click on ok Click on ok in the VISA cinfiguration window Now we have two virtual LAN devices configured on our client machine named GPIB1 and GPIB2 which can be used to run VISA based applications on our client machine to a remote instrument connected to the 3020 Gateway Running a VISA application There is no difference in running your VISA application to a 3020 Gateway as to a local HP IB interface except the virtual device name is given e g GPIB1 or GPIB2 using the above configuration rather than a local device name 5 Administration This chapter explains in more detail how to administer the TAMS 3020 LAN I O Gateway To administer the Gateway you will use the Configuration Utility provided in the LAN I O Gateway The Configuration Utility provides a command line interface for accomplishing administration tasks including configuration of the Gateway and querying the status of the Gateway The first section in this chapter Accessing the Configuration Utility explains how to access and exit the Configuration Utility and summarizes the various commands you can use to administer the Gateway The subsequent sections then cover the com
75. the configuration methods discussed in Chapter 3 Configuration The network administrator must have added this name to the DNS NIS local hosts file for this to work If you do not know the IP address or hostname of the Gateway return to Chapter 3 and follow the directions for running t3020conf to discover the Gateway IP address and hostname When using the Configuration Utility on some workstations it may not be possible to use a backspace key in order to correct typing mistakes This may cause commands that appear to be correct to be rejected by the utility It could cause unintended parameter values to be entered Rather than trying to backspace re enter the command without the mistakes Following is an example screen for a TAMS 3020 LAN I O Gateway Note that it may be necessary to enter an echo Yes command in order to have the information you type echoed back on the screen The information shown is a list of commands followed by a summary of the configuration of the Gateway box 1 O Configuration version 1 0 Copyright 2002 Test amp Measurement Systems Inc Type help by itself to get a list of valid commands gt help 29 Documented commands type help lt topic gt cancel echo gateway hwaddress lantimeout quit save version clear edit help iotimeout list reboot status config exit hostname ip maxconnections reset subnetmask gt config hostname T3020 hwaddress 00 02 B6 15 36 49 ip 192 0 0 192 gateway
76. the overall system release gt version Gateway Configuration version 1 0 You should have this information available if it is necessary to contact TAMS for product support Client Connection Management This section explains how to query the status ofthe Gateway and its client connections that is the LAN client computer systems that are connected to the Gateway to perform I O operations via the Gateway status To query the status of the Gateway and client connections via the Configuration Utility type gt status You now see the status screen which lists all current clients that are connected to this Gateway The following is an example status screen of clients connected to a TAMS 3020 LAN I O Gateway The meaning of the various fields listed on the status screen are _ServerID__ Client IP Addr ClientID_ Sess Operation Lock _ Device Intf 0x2008f624 15 1 4 247 4139 117 DEV gpibl 1 0x2008f624 15 1 4 247 4139 5 WRITE DEV gpib2 21 0x2008f624 15 1 4 247 4139 66 gpib2 0x2008f40c 190 2 49 138 27598 21 LOCK 7 21 0x2008f40c 190 2 49 138 27598 3 DEV 7 9 1 0x2008f40c 190 2 49 138 27598 14 DEV 7 9 2 0x2008f40c 190 2 49 138 27598 129 7 1 0x2008f1 f4 15 1 4 249 739 36 gpib2 1 0x2008f1 f4 15 1 4 249 739 8 READ gpib1 9 2 35 Server ID A unique process identification ID number for the client connection on this server this TAMS 3020 LAN I O Gateway Client IP Addr The IP address of the client computer system that is connected
77. tion and unlocks device 21 Also client 3 is waiting for client 2 to unlock device 9 2 primary secondary before it can perform the READ operation e If an Operation is specified for a given session and the session does have a Lock the operation is likely to be in progress and not waiting on another client to complete an operation For more information consult the documentation for your I O application software on how interface locks and device locks work in your software See Appendix C Related Software Documentation The following is a list of Operation field values and the SICL functions that correspond to them If you wish to terminate the client connections see the next section Terminating All Client Connections to the Gateway Operation SICL Function CLEAR iclear CLOSE iclose GETDEV igetdevaddr GETINTF igetintftype GETLU igetlu 36 GETSESS igetsesstype HINT ihint LOCAL ilocal LOCK ilock ONINTR ionintr ONSRQ ionsrq OPEN iopen READ iread READSTB ireadstb REMOTE iremote SETINTR isetintr TRIGGER itrigger ixtrig UNLOCK iunlock VERSION iversion WRITE iwrite HP IB specific SICL Functions ATNCTL igpibantctl BUSADDR igpibbusaddr BUSSTAT igpibbusstatus GETTI igpibgett1delay LLO igpibllo PASSCTL igpibpassctl RENCTL igpibrenctl SENDCMD igpibsendcmd SETTI igpibsettldelay RS 232 specific SICL Functions BREAK iserialbreak CTRL iserialctrl MCLCTRL iserialmclctrl MCLSTAT iserialmclstat STAT iserialstat
78. tion covers possible problems you may encounter when configuring the IP address and other network parameters for the TAMS 3020 LAN I O Gateway If you wish to return the Gateway to its default configuration values return to Chapter 3 and follow the instructions under the Default Configuration section Troubleshooting Remote Configuration via t3020conf If you having trouble configuring the LAN I O Gateway using t3020conf do the following 1 Make sure you have selected the correct 3020 host from the list if more than one appears 2 Make sure you have selected the correct LAN interface device from the list if more than one appears 3 Ifyou are not finding your 3020 Gateway in the list of hosts make sure the 3020 Gateway is fully booted by allowing at least 3 minutes prior to running the LAN probe portion of t3020conf 4 Verify that any firewalls are disabled on the system where t3020conf is being run 5 Verify that the LAN cable is fully connect to the 3020 and the LED next to the connector is flashing green 6 Verify that the Gateway is on the same local subnet as the client system from which you are running t3020conf If not consult your Network Administrator to determine if the default IP address will work from a separate subnet or to find a client system on the same local subnet that you can use 40 7 Verify that the IP address you are trying to change to is a valid IP address for the subnet the 3020 resides on Also mak
79. tively if the t3020 configuration utility can successfully discover the 3020 on your subnet then the 3020 has fully booted It is recommended to use the t3020conf utility as it takes care of any routing issues whereas telnet requires the routing table on your system be correct which may not be the case N Re Where to Go Now You have now finished installing the Gateway hardware Please continue on to the next chapter to configure the Gateway on your network 12 3 Network Configuration This chapter explains how to configure the TAMS 3020 LAN I O Gateway on your network You can use this chapter if you are configuring the Gateway for the first time on your network or if you need to change the Gateway s configuration in the future To configure the LAN I O Gateway on a network any of these three methods may be used 1 Use the t3020conf configuration utility from a remote client This utility is easy to use to setup the networking values needed to get the 3020 LAN Gateway ready to communicate with client machines on your network This utility is also very useful if you don t know the network values hostname IP address etc of your 3020 LAN Gateway The t3020conf is limited to configuring the 3020 network values and cannot be used to configure other 3020 values e g the number of connections allowed to the 3020 etc See the section Default Network Configuration Settings to see exactly which values can be configured with th
80. tname subnet mask and subnet gateway IP address are not asked for These values are all looked up by t3020conf program based on the IP address you enter Click on finish to reconfigure and reboot the 3020 This takes about 3 minutes so the gauge on the Main Window will show the progress Otherwise click on cancel or back if you don t want to reconfigure the 3020 15 Running in CLI mode Linux only The following shows a typical CLI session In this example there are two machines the t3020conf finds 192 0 0 192 and goofy mycompany com on the subnet The user selects machine 1 at 192 0 0 192 as the 3020 and then gives a new IP address of 206 543 63 188 for the 3020 Searching on your LAN subnetwork for configured machines takes 6 seconds Found these computer s configured as SICL VXI11 LAN servers NOTE Any computers with the T3020 default IP address are highlighted 1 192 0 0 192 192 0 0 HPLAN VXI11 2 206 543 62 5 goofy mycompany com HPLAN VX11 Enter the number which corresponds to the T3020 host 1 to 2 exit exit 2 Change the IP address of T3020 LAN server from 192 0 0 192 y or n n y Enter the new IP address in form xxx xxx xxx xxx 206 543 62 188 The T3020 has been reconfigured and is rebooting takes about 3 minutes Further configuration of T3020 can be done by running telnet 206 543 62 188 Note if multiple network interface devices were active on the machine then more messages would have bee
81. to this server Client ID A unique identification ID number for the client computer system s process Always 0 for a Windows 95 or Windows NT client Sess The unique session number of a client s communication channel with a device which can be any number 1 through 256 Operation The clients I O operation that is currently being performed on the associated device or interface A blank field indicates that no I O operation is currently executing The complete list of operations is provided later in this section Lock Indicates if the client has a lock on the associated device DEV or interface INTF A blank field indicates no lock Device Intf The device or interface on which the session is currently performing or will perform its I O operation Note that for SICL I O operations this relates to the device or interface specified in the iopen statement Also note the following e The Client IP Addr and Client ID are both needed to uniquely identify a client connection In the previous example clients 1 and 3 are separate processes on the same machine that is they have the same Client IP Addr e If an Operation is specified for a given session and the session does not have a Lock then the operation for the session may be waiting for another client to complete an I O operation or to unlock a device or the interface In the previous example client 2 is waiting to get a lock on device 21 after client 1 completes the WRITE opera
82. ts if you are not aware of the issue Liberal use of the status and clear commands may be needed until programs and scripts are debugged and hardware issues resolved Using the clear command in the Configuration Utility with operations pending can in some situations cause segmentation faults application errors or other serious errors to be reported by client side software For this reason it is preferable to abort the operation at the client first and then use the clear command to clean up pending operations in the Gateway box 47 A Technical Reference This appendix provides a technical reference of the following topics for the TAMS 3020 LAN I O Gateway e Specifications e HP IB Characteristics e Serial terminal communication specifications Specifications Power Supply e Maximum Output 40Watts e Output Voltage and Current Rating 5V 3A 12V 2A 5V 0 3A 12V90VAC to 264VAC 0 3A Input Voltage 9OVAC to 264VAC Input Frequency 47 to 63Hz Efficiency 70 typical Safety Standards Meets UL CSA VDE standards EMI Standards Meets FCC standards Environmental Specifications e Operating Temp 0 to 50 celsius degree Storage Temp 20 to 85 celsius degree Relative Humidity 5 to 95 non condensing Altitude 0 to 10 000ft Vibration operating Passed MIL STD 810F basic transportation vibration test Physical Specifications 90 w x 195 h x 217 d mm HP IB Characteristics The HP IB connection con
83. u want to use an HP UX client but you also have available a Linux client on the subnet that the TAMS 3020 LAN Gateway resides Then you can use the Linux machine to run TAMS t3020conf for the initial network configuration of the TAMS 3020 Then you can move to the HP UX client to run your SICL or VISA based user application SICL LAN vs VXI 11 There are two different low level protocols available to access devices remotely across LAN SICL LAN was developed originally by HP and transferred to Agilent VXI 11 is a newer protocol that is supported by a wider range of manufacturers including Agilent and TAMS The Gateway handles either protocol automatically and generally no difference in operation would be visible to the user based on the selection Subnets A subnet is a collection of Internet Protocol IP addresses Devices contained in the same subnet generally communicate with each other without difficulty Ifa client and the Gateway reside on different subnets then the subnet gateway must be configured for both devices which reside on their respective subnets These subnet gateways have the ability to route information between subnets The term subnetting refers to communication that crosses subnets Routing The act of specifying how to route network packets from one machine to another A client can set up routing to a limited number of devices or a subnet gateway may be used to provide the routing to a large number of
84. whole is intended to apply in other circumstances It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims this section has the sole purpose of protecting the integrity of the free software distribution system which is implemented by public license practices Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system it is up to the author donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License 8 If the distribution and or use of the Program is restricted in certain countries either by patents or by copyrighted interfaces the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries so that distribution is permitted only in or among countries not thus excluded In such case this License incorporates the limitation as if written in the body of this License 9 The Free Software Foundation may publish revised and or new versions of the General Public License from time to time Such new versions will be similar in spirit to the present version but may differ in detail to addres
85. y running the Program Whether that is true depends on what the Program does 1 You may copy and distribute verbatim copies of the Program s source code as you receive it in any medium provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty keep intact all the notices that refer to this License and to the absence of any warranty and give any other recipients of the Program a copy of this License along with the Program 55 You may charge a fee for the physical act of transferring a copy and you may at your option offer warranty protection in exchange for a fee 2 You may modify your copy or copies of the Program or any portion of it thus forming a work based on the Program and copy and distribute such modifications or work under the terms of Section 1 above provided that you also meet all of these conditions a You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change b You must cause any work that you distribute or publish that in whole or in part contains or is derived from the Program or any part thereof to be licensed as a whole at no charge to all third parties under the terms of this License c Ifthe modified program normally reads commands interactively when run you must cause 1t when started running for such interactive use in the most ordinary way to print or display an announce
86. y software are covered under Version 2 of the GNU General Public License GPL Others are Copyright 2002 2006 TAMS Inc Source code for the elements covered by the GNU General Public License is available for a nominal fee by contacting TAMS Inc at the following address TAMS Inc 750 14 St S W Loveland CO 80537 U S A info tamsinc com Your may further distribute those elements of the software covered by the General Public License subject to the conditions contained in that license A requirement for further distribution is that the following information be included in its entirety and without modification GNU GENERAL PUBLIC LICENSE Version 2 June 1991 Copyright C 1989 1991 Free Software Foundation Inc 675 Mass Ave Cambridge MA 02139 USA Everyone is permitted to copy and distribute verbatim copies of this license document but changing it is not allowed Preamble The licenses for most software are designed to take away your freedom to share and change it By contrast the GNU General Public License is intended to guarantee your freedom to share and change free software to make sure the software is free for all its users This General Public License applies to most of the Free Software Foundation s software and to any other program whose authors commit to using it Some other Free Software Foundation software is covered by the GNU Library General Public License instead You can apply it to your programs too W
87. you must have the following hardware The selection of HP IB instruments and cables of course is installation specific At a minimum one peripheral device is required e One or more of the following network equipped computer systems to act as the LAN client system s and or the network configuration system HP workstation running HP UX 10 20 or 111 32 bit personal computer PC running RedHat Linux Windows 2000 or Windows XP Professional e A local area network LAN to which the client system s and the TAMS 3020 LAN I O Gateway can connect via the appropriate LAN cables e The TAMS 3020 LAN I O Gateway e Power cord that will provide power to the Gateway e HP IB instrument s including the HP IB cable s needed to connect the Gateway to the instrument s Software Requirements Each client computer system that will access the Gateway must be running one of the following operating systems e HP UX version 10 20 or 11i for HP workstations e RedHat Enterprise Linux for 32 bit PC s e Microsoft Windows 98 2000 or XP Professional You must also have one or more of the following I O application products configured on each client workstation that you wish to use with the Gateway Agilent SICL and VISA for HP UX 10 20 TAMS SICL and VISA for HP UX 11i Agilent SICL and VISA for Microsoft Windows 98 2000 or XP Professional TAMS SICL and VISA for RedHat Linux 11 e TAMS t3020conf utility for Microsoft Windows or for Redhat Li

TAMS 3020 LAN I/O Gateway Installation and

Contents

Download Pdf Manuals

Related Search

Related Contents