share/man/man4/pcii.4

   1 .\" Copyright (c) 2010, Joerg Wunsch
   2 .\" All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\"
  13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  16 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  18 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  19 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  23 .\" SUCH DAMAGE.
  24 .\"
  25 .\" $FreeBSD$
  26 .\"
  27 .Dd January 24, 2010
  28 .Dt PCII 4
  29 .Os
  30 .Sh NAME
  31 .Nm pcii
  32 .Nd National Instruments PCIIA GPIB controller driver
  33 .Sh SYNOPSIS
  34 .Cd "device pcii"
  35 .Pp
  36 In
  37 .Pa /boot/device.hints :
  38 .Cd hint.pcii.0.at="isa"
  39 .Cd hint.pcii.0.port="0x2e1"
  40 .Cd hint.pcii.0.irq="7"
  41 .Cd hint.pcii.0.drq="1"
  42 .Sh DESCRIPTION
  43 The
  44 .Nm
  45 driver provides support for driving an IEEE-488 bus, also called
  46 IEC-625 (or just "IEC bus"), or HP-IB (Hewlett Packard Instrument
  47 Bus), or GPIB (General Purpose Instrument Bus).
  48 The driver supports National Instruments PCIIA cards (sometimes
  49 also referred to as PC2A) and compatibles.
  50 These cards use a NEC \(mcPD7210 controller IC as the main
  51 interface between the host computer and the instrument bus.
  52 .Ss IO memory space layout
  53 The PCIIA cards use a very specific IO memory space allocation layout.
  54 The address bits A0 through A9 (which have traditionally been the only
  55 address bits evaluated on IBM PC XT extension cards) are hardwired to
  56 address 0x2e1.
  57 Bits A10 through A12 are used by the \(mcPD7210 register select lines.
  58 This makes the individual 7210 registers being 0x400 bytes apart in the
  59 ISA bus address space.
  60 Address bits A13 and A14 are compared to a DIP switch setting on the
  61 card, allowing for up to 4 different cards being installed (at base
  62 addresses 0x2e1, 0x22e1, 0x42e1, and 0x62e1, respectively).
  63 A15 has been used to select an optional on-board time-of-day clock
  64 chip (MM58167A) on the original PCIIA rather than the \(mcPD7210
  65 (which is not implemented on later boards and clones).
  66 Finally, the IO addresses 0x2f0 ... 0x2f7 are used for a
  67 .Em special interrupt handling feature
  68 (re-enable interrupts so the IRQ can be shared), where actually only
  69 address 0x2f0 plus the actual IRQ level is required for each card.
  70 Some clones do not appear to require this special IRQ handling, and
  71 are thus likely to not support the shared IRQ feature.
  72 .Pp
  73 Only the base address of the card needs to be specified in the ISA
  74 device hints; the driver takes care to derive all other IO addresses
  75 needed during the probe phase.
  76 .Ss Supported cards
  77 The following cards are known to be supported:
  78 .Bl -bullet -offset indent
  79 .It
  80 B&C Microsystems PC488A-0
  81 .It
  82 National Instruments GPIB-PCII/PCIIA (in PCIIa mode)
  83 .It
  84 Axiom AX5488
  85 .El
  86 .Sh SEE ALSO
  87 .Xr gpib 3 ,
  88 .Xr gpib 4 ,
  89 .Xr device.hints 5
  90 .Sh HISTORY
  91 The
  92 .Nm
  93 driver was written by Poul-Henning Kamp, and first appeared in
  94 .Fx 5.4 .
  95 .Sh AUTHORS
  96 This manual page was written by
  97 .An J\(:org Wunsch .