Advertisement

Quick Links

TAMS 81622 PCI GPIO Card
for Linux
Installation & Operation Instructions

Advertisement

Table of Contents
loading

Summary of Contents for TAMS 81622

  • Page 1 TAMS 81622 PCI GPIO Card for Linux Installation & Operation Instructions...
  • Page 2 TAMS 81622 PCI GPIO Card Installation & Operation Instructions Test & Measurement Systems Inc. 750 14th Street SW Loveland, CO 80537 Telephone (970) 669 6553 (970) 669 3090 Web Site www.tamsinc.com Email info@tamsinc.com Copyright  Test & Measurement Systems Inc. 2000-2003...
  • Page 3: Table Of Contents

    Standard Instrument Control Library for Linux BASIC For Linux Additional GPIO Documentation Online Technical Information ..............12 Connector Pinouts TAMS 81622 Enhancements beyond the HP 2074/5 ....14 TAMS 81622 PCI DMA TAMS 81622 PCTL Delay Booting After Configuration Changes Appendix A: Wiring ..............17 Appendix B: File Locations ............
  • Page 4: General Information

    When you open your TAMS GPIO Card shipment, examine its contents. Note: The name of the product you have purchased is the TAMS 81622 (GPIO Card for Linux). It includes the TAMS 622-66501 GPIO card and the t61622 card driver for Red Hat Linux. See the ReadMe for the version supported.
  • Page 5: Overview Of The Tams 81622 Gpio Interface

    A PCI expansion slot is required to accommodate the GPIO interface card. The TAMS GPIO card has a rotary DIP switch on the upper edge to set the unique identifier for the card. This is the only switch that needs to be set prior to installing the card.
  • Page 6: Installing The Interface

    Installing the Interface This section explains how to install the TAMS GPIO interface in the computer. To complete the installation: 1. Make sure the computer is shut down properly, the power is turned off, and the power cord is unplugged.
  • Page 7: Driver Installation

    Refer to your platform specific operating system documentation or contact your system administrator. To install the t61622 driver it is not necessary for the TAMS 622-66501 interface card(s) to be present in the system. Note: You must have root permission to install the software.
  • Page 8 Appendix B is a reference for the Linux systems administrator, who might wish to know where these files are placed. You will still need to configure the new TAMS GPIO card as a SICL interface card, as covered in the next section.
  • Page 9: Interface Configuration

    Libraries” chapter of the I/O Libraries Installation and Configuration Guide for Linux. For each TAMS 622-66501 card that you want to configure in your system, you need to add a line to the file. While most users do not need to hwconfig.cf...
  • Page 10 SIGUSR2 SIGIO or SIGURG. A value of 0 sets the default signal which is SIGURG. A signal is used by the t61622 driver to notify applications about kernel events. You can select an alternate signal to avoid conflicts within your application.
  • Page 11 The t61622 driver provides an alternate delay configuration method. The delay may be expressed in nanoseconds or in microseconds. If the delay is expressed in nanoseconds the decimal value representing that delay should be suffixed with “ns”. If the delay is expressed in microseconds the decimal value representing delay should be suffixed with “us”.
  • Page 12: Related Software Documentation

    Select Code used to identify the interface in their BASIC programs. More information for the use of the GPIO interface is found on the TAMS BASIC Documentation CD. Relevant sections are the “Linux Highlights” section of the BASIC Language Reference, and the GPIO chapter of the BASIC Interface Reference on the CD.
  • Page 13: Technical Information

    Technical Information This section provides a detailed, functional description of the TAMS 81622 GPIO interface. You will need to understand this information in order to set the appropriate configuration values. This information should also be helpful when you are preparing and installing the GPIO cable.
  • Page 14: Connector Pinouts

    Connector Pinouts The following figure shows you the Pinouts on the TAMS 622-66501 GPIO interface connector. TAMS 622-66501 GPIO Connector Pinouts t n I s t l i l t...
  • Page 15: Tams 81622 Enhancements Beyond The Hp 2074/5

    TAMS 81622 Enhancements beyond the HP 2074/5 TAMS 81622 PCI DMA. The TAMS 81622 interface has two modes of transfer: DMA and interrupt driven. A program may control transfer mode used by calls to ihint(). See the SICL Reference Manual for more information.There are six values that could be specified to this call: •...
  • Page 16: Tams 81622 Pctl Delay

    The TAMS 81622 PCTL delay is configurable via the SICL iosetup utility or it may be changed at any time from within an application by a call to igpioctrl(id, I_GPIO_PCTL_DELAY, <val>...
  • Page 17 Changes take effect when a session on a newly configured interface is started for the first time within a process. Care should be taken when a running application is using the TAMS GPIO interface while it is reconfigured.
  • Page 18: Appendix A: Wiring

    Appendix A: Wiring Data Lines There are 32 data lines on the TAMS GPIO: 16 designated as data input, and 16 designated as data output. Color codes are provided for the TAMS 622-001 GPIO cable and the HP 5061-4209 GPIO cable.
  • Page 19 Data Output Lines The 16 data output lines are labeled DO0 through DO15. The following table lists the connector pin numbers and wire color codes for the data output lines. Data Output Lines t e l o l l o l l t e l o l l o l l...
  • Page 20 Peripheral Information Lines The following table lists the connector pin numbers and wire color codes for the peripheral information lines. Peripheral Information Lines o l l t e l t e l o l l t e l t e l...
  • Page 21: Appendix B: File Locations

    Appendix B: File Locations The installation procedure places files in the following directories : e l i o i t o i t i s / / l c b i l p i l b i l i l / <...
  • Page 22: Appendix C: Tams 61622 Sicl Extensions

    Appendix C: TAMS 81622 SICL Extensions All of the TAMS 81622 SICL extension functions are implemented by using the header file t61622sicl.h and the standard SICL functions igpioctrl and igpiostat. These two functions are described below: IGPIOCTRL Supported sessions: ......interface Affected by functions: .
  • Page 23 The TAMS 81622 PCTL delay function provides an extended PCTL delay control that was not available before. Besides the standard 0-7 values for delay used with HP cards, the delay of the TAMS 81622 may be set directly in nanoseconds.
  • Page 24 GPIO. If set to 1, polarity is reversed for these lines. • For DIN lines, 81622 extensions allow the user to set the polarity for each line independently. Setting the DIN polarity with standard GPIO SICL igpioctrl ) is still supported and will cause the I_GPIO_POLARITY, setting setting or clearing of all the DIN lines’...
  • Page 25 I_GPIO_T61622_LAT_RD, &lat) Clear latched lines igpioctrl(id, I_GPIO_T61622_LAT_CL, lat) TAMS 81622 line interrupt This function controls which lines can cause an interrupt. Interrupts on level transitions on DIN[0..15], STI[0..1] and EIR lines can be controlled individually. When the interrupt occurs depends upon the polarity: •...
  • Page 26 I_GPIO_T61622_PUL, 0) TAMS 81622 Board ID The 81622 is equipped with a rotary DIP switch. Its purpose is the identification of each GPIO board on a system with multiple GPIO cards. The user must set the switch position to a unique value for each card on the system and then can read its value by using the request I_GPIO_T61622_CID to check which physical card is associated with a specific opened session.
  • Page 27 DOUT polarity. Example: Get the DOUT value igpiostat(id, I_GPIO_T61622_DOUT, &dout) TAMS 61622 Macros The following is a table with all of the macro definitions passed to the TAMS 61622 SICL extension functions. Individual bits may be passed to select specific line(s).
  • Page 28 TAMS 61622 SICL extension function defines T61622_DIN 0x0000FFFF DIN[0..15] 16 bits T61622_DIN_L 0x000000FF DIN[0..7] 8 bits T61622_DIN_U 0x0000FF00 DIN[8..15] 8 bits T61622_STI 0x00030000 STI[0..1] 2 bits T61622_EIR 0x00040000 EIR 1 bit T61622_RDY 0x00080000 RDY 1 bit T61622_MORE 0x00100000 used inside driver only...
  • Page 29: Warranty Information

    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.
  • Page 30 TAMS 81622 GP-IO Card for Red Hat Linux Printed in USA E011.01.03 Part #81622-90004...

Table of Contents