2 comedi/drivers/cb_pcimdas.c
3 Comedi driver for Computer Boards PCIM-DAS1602/16
5 COMEDI - Linux Control and Measurement Device Interface
6 Copyright (C) 2000 David A. Schleef <ds@schleef.org>
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
25 Description: Measurement Computing PCI Migration series boards
26 Devices: [ComputerBoards] PCIM-DAS1602/16 (cb_pcimdas)
27 Author: Richard Bytheway
28 Updated: Wed, 13 Nov 2002 12:34:56 +0000
31 Written to support the PCIM-DAS1602/16 on a 2.4 series kernel.
33 Configuration Options:
37 Developed from cb_pcidas and skel by Richard Bytheway (mocelet@sucs.org).
38 Only supports DIO, AO and simple AI in it's present form.
39 No interrupts, multi channel or FIFO AI, although the card looks like it could support this.
40 See http://www.measurementcomputing.com/PDFManuals/pcim-das1602_16.pdf for more details.
43 #include "../comedidev.h"
45 #include <linux/delay.h>
46 #include <linux/interrupt.h>
48 #include "comedi_pci.h"
52 /* #define CBPCIMDAS_DEBUG */
53 #undef CBPCIMDAS_DEBUG
55 #define PCI_VENDOR_ID_COMPUTERBOARDS 0x1307
57 /* Registers for the PCIM-DAS1602/16 */
59 /* sizes of io regions (bytes) */
60 #define BADR0_SIZE 2 /* ?? */
71 /* AI and Counter Constants */
73 #define MAIN_CONN_DIO 1
75 #define ADC_CONV_STAT 3
80 #define CLK8254_1_DATA 8
81 #define CLK8254_2_DATA 9
82 #define CLK8254_3_DATA 10
83 #define CLK8254_CONTROL 11
84 #define USER_COUNTER 12
85 #define RESID_COUNT_H 13
86 #define RESID_COUNT_L 14
88 /* Board description */
89 struct cb_pcimdas_board {
91 unsigned short device_id;
92 int ai_se_chans; /* Inputs in single-ended mode */
93 int ai_diff_chans; /* Inputs in differential mode */
94 int ai_bits; /* analog input resolution */
95 int ai_speed; /* fastest conversion period in ns */
96 int ao_nchan; /* number of analog out channels */
97 int ao_bits; /* analogue output resolution */
98 int has_ao_fifo; /* analog output has fifo */
99 int ao_scan_speed; /* analog output speed for 1602 series (for a scan, not conversion) */
100 int fifo_size; /* number of samples fifo can hold */
101 int dio_bits; /* number of dio bits */
102 int has_dio; /* has DIO */
103 const struct comedi_lrange *ranges;
106 static const struct cb_pcimdas_board cb_pcimdas_boards[] = {
108 .name = "PCIM-DAS1602/16",
113 .ai_speed = 10000, /* ?? */
116 .has_ao_fifo = 0, /* ?? */
117 .ao_scan_speed = 10000,
122 /* .ranges = &cb_pcimdas_ranges, */
126 /* This is used by modprobe to translate PCI IDs to drivers. Should
127 * only be used for PCI and ISA-PnP devices */
128 static DEFINE_PCI_DEVICE_TABLE(cb_pcimdas_pci_table) = {
130 PCI_VENDOR_ID_COMPUTERBOARDS, 0x0056, PCI_ANY_ID, PCI_ANY_ID, 0, 0, 0},
135 MODULE_DEVICE_TABLE(pci, cb_pcimdas_pci_table);
137 #define N_BOARDS 1 /* Max number of boards supported */
140 * Useful for shorthand access to the particular board structure
142 #define thisboard ((const struct cb_pcimdas_board *)dev->board_ptr)
144 /* this structure is for data unique to this hardware driver. If
145 several hardware drivers keep similar information in this structure,
146 feel free to suggest moving the variable to the struct comedi_device struct. */
147 struct cb_pcimdas_private {
150 /* would be useful for a PCI device */
151 struct pci_dev *pci_dev;
160 /* Used for AO readback */
161 unsigned int ao_readback[2];
164 unsigned short int port_a; /* copy of BADR4+0 */
165 unsigned short int port_b; /* copy of BADR4+1 */
166 unsigned short int port_c; /* copy of BADR4+2 */
167 unsigned short int dio_mode; /* copy of BADR4+3 */
172 * most drivers define the following macro to make it easy to
173 * access the private structure.
175 #define devpriv ((struct cb_pcimdas_private *)dev->private)
178 * The struct comedi_driver structure tells the Comedi core module
179 * which functions to call to configure/deconfigure (attach/detach)
180 * the board, and also about the kernel module that contains
183 static int cb_pcimdas_attach(struct comedi_device *dev,
184 struct comedi_devconfig *it);
185 static int cb_pcimdas_detach(struct comedi_device *dev);
186 static struct comedi_driver driver_cb_pcimdas = {
187 .driver_name = "cb_pcimdas",
188 .module = THIS_MODULE,
189 .attach = cb_pcimdas_attach,
190 .detach = cb_pcimdas_detach,
193 static int cb_pcimdas_ai_rinsn(struct comedi_device *dev,
194 struct comedi_subdevice *s,
195 struct comedi_insn *insn, unsigned int *data);
196 static int cb_pcimdas_ao_winsn(struct comedi_device *dev,
197 struct comedi_subdevice *s,
198 struct comedi_insn *insn, unsigned int *data);
199 static int cb_pcimdas_ao_rinsn(struct comedi_device *dev,
200 struct comedi_subdevice *s,
201 struct comedi_insn *insn, unsigned int *data);
204 * Attach is called by the Comedi core to configure the driver
205 * for a particular board. If you specified a board_name array
206 * in the driver structure, dev->board_ptr contains that
209 static int cb_pcimdas_attach(struct comedi_device *dev,
210 struct comedi_devconfig *it)
212 struct comedi_subdevice *s;
213 struct pci_dev *pcidev;
217 printk("comedi%d: cb_pcimdas: ", dev->minor);
220 * Allocate the private structure area.
222 if (alloc_private(dev, sizeof(struct cb_pcimdas_private)) < 0)
226 * Probe the device to determine what device in the series it is.
230 for (pcidev = pci_get_device(PCI_ANY_ID, PCI_ANY_ID, NULL);
232 pcidev = pci_get_device(PCI_ANY_ID, PCI_ANY_ID, pcidev)) {
233 /* is it not a computer boards card? */
234 if (pcidev->vendor != PCI_VENDOR_ID_COMPUTERBOARDS)
236 /* loop through cards supported by this driver */
237 for (index = 0; index < N_BOARDS; index++) {
238 if (cb_pcimdas_boards[index].device_id !=
241 /* was a particular bus/slot requested? */
242 if (it->options[0] || it->options[1]) {
243 /* are we on the wrong bus/slot? */
244 if (pcidev->bus->number != it->options[0] ||
245 PCI_SLOT(pcidev->devfn) != it->options[1]) {
249 devpriv->pci_dev = pcidev;
250 dev->board_ptr = cb_pcimdas_boards + index;
255 printk("No supported ComputerBoards/MeasurementComputing card found on "
256 "requested position\n");
261 printk("Found %s on bus %i, slot %i\n", cb_pcimdas_boards[index].name,
262 pcidev->bus->number, PCI_SLOT(pcidev->devfn));
264 /* Warn about non-tested features */
265 switch (thisboard->device_id) {
269 printk("THIS CARD IS UNSUPPORTED.\n"
270 "PLEASE REPORT USAGE TO <mocelet@sucs.org>\n");
273 if (comedi_pci_enable(pcidev, "cb_pcimdas")) {
274 printk(" Failed to enable PCI device and request regions\n");
278 devpriv->BADR0 = pci_resource_start(devpriv->pci_dev, 0);
279 devpriv->BADR1 = pci_resource_start(devpriv->pci_dev, 1);
280 devpriv->BADR2 = pci_resource_start(devpriv->pci_dev, 2);
281 devpriv->BADR3 = pci_resource_start(devpriv->pci_dev, 3);
282 devpriv->BADR4 = pci_resource_start(devpriv->pci_dev, 4);
284 #ifdef CBPCIMDAS_DEBUG
285 printk("devpriv->BADR0 = 0x%lx\n", devpriv->BADR0);
286 printk("devpriv->BADR1 = 0x%lx\n", devpriv->BADR1);
287 printk("devpriv->BADR2 = 0x%lx\n", devpriv->BADR2);
288 printk("devpriv->BADR3 = 0x%lx\n", devpriv->BADR3);
289 printk("devpriv->BADR4 = 0x%lx\n", devpriv->BADR4);
292 /* Dont support IRQ yet */
294 /* if(request_irq(devpriv->pci_dev->irq, cb_pcimdas_interrupt, IRQF_SHARED, "cb_pcimdas", dev )) */
296 /* printk(" unable to allocate irq %u\n", devpriv->pci_dev->irq); */
297 /* return -EINVAL; */
299 /* dev->irq = devpriv->pci_dev->irq; */
301 /* Initialize dev->board_name */
302 dev->board_name = thisboard->name;
305 * Allocate the subdevice structures. alloc_subdevice() is a
306 * convenient macro defined in comedidev.h.
308 if (alloc_subdevices(dev, 3) < 0)
311 s = dev->subdevices + 0;
312 /* dev->read_subdev=s; */
313 /* analog input subdevice */
314 s->type = COMEDI_SUBD_AI;
315 s->subdev_flags = SDF_READABLE | SDF_GROUND;
316 s->n_chan = thisboard->ai_se_chans;
317 s->maxdata = (1 << thisboard->ai_bits) - 1;
318 s->range_table = &range_unknown;
319 s->len_chanlist = 1; /* This is the maximum chanlist length that */
320 /* the board can handle */
321 s->insn_read = cb_pcimdas_ai_rinsn;
323 s = dev->subdevices + 1;
324 /* analog output subdevice */
325 s->type = COMEDI_SUBD_AO;
326 s->subdev_flags = SDF_WRITABLE;
327 s->n_chan = thisboard->ao_nchan;
328 s->maxdata = 1 << thisboard->ao_bits;
329 s->range_table = &range_unknown; /* ranges are hardware settable, but not software readable. */
330 s->insn_write = &cb_pcimdas_ao_winsn;
331 s->insn_read = &cb_pcimdas_ao_rinsn;
333 s = dev->subdevices + 2;
334 /* digital i/o subdevice */
335 if (thisboard->has_dio)
336 subdev_8255_init(dev, s, NULL, devpriv->BADR4);
338 s->type = COMEDI_SUBD_UNUSED;
340 printk("attached\n");
346 * _detach is called to deconfigure a device. It should deallocate
348 * This function is also called when _attach() fails, so it should be
349 * careful not to release resources that were not necessarily
350 * allocated by _attach(). dev->private and dev->subdevices are
351 * deallocated automatically by the core.
353 static int cb_pcimdas_detach(struct comedi_device *dev)
355 #ifdef CBPCIMDAS_DEBUG
357 printk("devpriv->BADR0 = 0x%lx\n", devpriv->BADR0);
358 printk("devpriv->BADR1 = 0x%lx\n", devpriv->BADR1);
359 printk("devpriv->BADR2 = 0x%lx\n", devpriv->BADR2);
360 printk("devpriv->BADR3 = 0x%lx\n", devpriv->BADR3);
361 printk("devpriv->BADR4 = 0x%lx\n", devpriv->BADR4);
364 printk("comedi%d: cb_pcimdas: remove\n", dev->minor);
366 free_irq(dev->irq, dev);
368 if (devpriv->pci_dev) {
370 comedi_pci_disable(devpriv->pci_dev);
371 pci_dev_put(devpriv->pci_dev);
379 * "instructions" read/write data in "one-shot" or "software-triggered"
382 static int cb_pcimdas_ai_rinsn(struct comedi_device *dev,
383 struct comedi_subdevice *s,
384 struct comedi_insn *insn, unsigned int *data)
389 int chan = CR_CHAN(insn->chanspec);
390 unsigned short chanlims;
393 /* only support sw initiated reads from a single channel */
395 /* check channel number */
396 if ((inb(devpriv->BADR3 + 2) & 0x20) == 0) /* differential mode */
397 maxchans = thisboard->ai_diff_chans;
399 maxchans = thisboard->ai_se_chans;
401 if (chan > (maxchans - 1))
402 return -ETIMEDOUT; /* *** Wrong error code. Fixme. */
404 /* configure for sw initiated read */
405 d = inb(devpriv->BADR3 + 5);
406 if ((d & 0x03) > 0) { /* only reset if needed. */
408 outb(d, devpriv->BADR3 + 5);
410 outb(0x01, devpriv->BADR3 + 6); /* set bursting off, conversions on */
411 outb(0x00, devpriv->BADR3 + 7); /* set range to 10V. UP/BP is controlled by a switch on the board */
413 /* write channel limits to multiplexer, set Low (bits 0-3) and High (bits 4-7) channels to chan. */
414 chanlims = chan | (chan << 4);
415 outb(chanlims, devpriv->BADR3 + 0);
417 /* convert n samples */
418 for (n = 0; n < insn->n; n++) {
419 /* trigger conversion */
420 outw(0, devpriv->BADR2 + 0);
422 #define TIMEOUT 1000 /* typically takes 5 loops on a lightly loaded Pentium 100MHz, */
423 /* this is likely to be 100 loops on a 2GHz machine, so set 1000 as the limit. */
425 /* wait for conversion to end */
426 for (i = 0; i < TIMEOUT; i++) {
427 busy = inb(devpriv->BADR3 + 2) & 0x80;
436 d = inw(devpriv->BADR2 + 0);
438 /* mangle the data as necessary */
439 /* d ^= 1<<(thisboard->ai_bits-1); // 16 bit data from ADC, so no mangle needed. */
444 /* return the number of samples read/written */
448 static int cb_pcimdas_ao_winsn(struct comedi_device *dev,
449 struct comedi_subdevice *s,
450 struct comedi_insn *insn, unsigned int *data)
453 int chan = CR_CHAN(insn->chanspec);
455 /* Writing a list of values to an AO channel is probably not
456 * very useful, but that's how the interface is defined. */
457 for (i = 0; i < insn->n; i++) {
460 outw(data[i] & 0x0FFF, devpriv->BADR2 + DAC0_OFFSET);
463 outw(data[i] & 0x0FFF, devpriv->BADR2 + DAC1_OFFSET);
468 devpriv->ao_readback[chan] = data[i];
471 /* return the number of samples read/written */
475 /* AO subdevices should have a read insn as well as a write insn.
476 * Usually this means copying a value stored in devpriv. */
477 static int cb_pcimdas_ao_rinsn(struct comedi_device *dev,
478 struct comedi_subdevice *s,
479 struct comedi_insn *insn, unsigned int *data)
482 int chan = CR_CHAN(insn->chanspec);
484 for (i = 0; i < insn->n; i++)
485 data[i] = devpriv->ao_readback[chan];
491 * A convenient macro that defines init_module() and cleanup_module(),
494 COMEDI_PCI_INITCLEANUP(driver_cb_pcimdas, cb_pcimdas_pci_table);