2 comedi/drivers/cb_pcimdda.c
3 Computer Boards PCIM-DDA06-16 Comedi driver
4 Author: Calin Culianu <calin@ajvar.org>
6 COMEDI - Linux Control and Measurement Device Interface
7 Copyright (C) 2000 David A. Schleef <ds@schleef.org>
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
21 Description: Measurement Computing PCIM-DDA06-16
22 Devices: [Measurement Computing] PCIM-DDA06-16 (cb_pcimdda)
23 Author: Calin Culianu <calin@ajvar.org>
24 Updated: Mon, 14 Apr 2008 15:15:51 +0100
27 All features of the PCIM-DDA06-16 board are supported. This board
28 has 6 16-bit AO channels, and the usual 8255 DIO setup. (24 channels,
29 configurable in banks of 8 and 4, etc.). This board does not support commands.
31 The board has a peculiar way of specifying AO gain/range settings -- You have
32 1 jumper bank on the card, which either makes all 6 AO channels either
33 5 Volt unipolar, 5V bipolar, 10 Volt unipolar or 10V bipolar.
35 Since there is absolutely _no_ way to tell in software how this jumper is set
36 (well, at least according to the rather thin spec. from Measurement Computing
37 that comes with the board), the driver assumes the jumper is at its factory
38 default setting of +/-5V.
40 Also of note is the fact that this board features another jumper, whose
41 state is also completely invisible to software. It toggles two possible AO
42 output modes on the board:
44 - Update Mode: Writing to an AO channel instantaneously updates the actual
45 signal output by the DAC on the board (this is the factory default).
46 - Simultaneous XFER Mode: Writing to an AO channel has no effect until
47 you read from any one of the AO channels. This is useful for loading
48 all 6 AO values, and then reading from any one of the AO channels on the
49 device to instantly update all 6 AO values in unison. Useful for some
50 control apps, I would assume? If your jumper is in this setting, then you
51 need to issue your comedi_data_write()s to load all the values you want,
52 then issue one comedi_data_read() on any channel on the AO subdevice
53 to initiate the simultaneous XFER.
55 Configuration Options: not applicable, uses PCI auto config
59 This is a driver for the Computer Boards PCIM-DDA06-16 Analog Output
60 card. This board has a unique register layout and as such probably
61 deserves its own driver file.
63 It is theoretically possible to integrate this board into the cb_pcidda
64 file, but since that isn't my code, I didn't want to significantly
65 modify that file to support this board (I thought it impolite to do so).
67 At any rate, if you feel ambitious, please feel free to take
68 the code out of this file and combine it with a more unified driver
71 I would like to thank Timothy Curry <Timothy.Curry@rdec.redstone.army.mil>
72 for lending me a board so that I could write this driver.
74 -Calin Culianu <calin@ajvar.org>
77 #include <linux/module.h>
79 #include "../comedi_pci.h"
83 /* device ids of the cards we support -- currently only 1 card supported */
84 #define PCI_ID_PCIM_DDA06_16 0x0053
87 * Register map, 8-bit access only
89 #define PCIMDDA_DA_CHAN(x) (0x00 + (x) * 2)
90 #define PCIMDDA_8255_BASE_REG 0x0c
92 static int cb_pcimdda_ao_insn_write(struct comedi_device *dev,
93 struct comedi_subdevice *s,
94 struct comedi_insn *insn,
97 unsigned int chan = CR_CHAN(insn->chanspec);
98 unsigned long offset = dev->iobase + PCIMDDA_DA_CHAN(chan);
99 unsigned int val = s->readback[chan];
102 for (i = 0; i < insn->n; i++) {
106 * Write the LSB then MSB.
108 * If the simultaneous xfer mode is selected by the
109 * jumper on the card, a read instruction is needed
110 * in order to initiate the simultaneous transfer.
111 * Otherwise, the DAC will be updated when the MSB
114 outb(val & 0x00ff, offset);
115 outb((val >> 8) & 0x00ff, offset + 1);
117 s->readback[chan] = val;
122 static int cb_pcimdda_ao_insn_read(struct comedi_device *dev,
123 struct comedi_subdevice *s,
124 struct comedi_insn *insn,
127 unsigned int chan = CR_CHAN(insn->chanspec);
129 /* Initiate the simultaneous transfer */
130 inw(dev->iobase + PCIMDDA_DA_CHAN(chan));
132 return comedi_readback_insn_read(dev, s, insn, data);
135 static int cb_pcimdda_auto_attach(struct comedi_device *dev,
136 unsigned long context_unused)
138 struct pci_dev *pcidev = comedi_to_pci_dev(dev);
139 struct comedi_subdevice *s;
142 ret = comedi_pci_enable(dev);
145 dev->iobase = pci_resource_start(pcidev, 3);
147 ret = comedi_alloc_subdevices(dev, 2);
151 s = &dev->subdevices[0];
152 /* analog output subdevice */
153 s->type = COMEDI_SUBD_AO;
154 s->subdev_flags = SDF_WRITABLE | SDF_READABLE;
157 s->range_table = &range_bipolar5;
158 s->insn_write = cb_pcimdda_ao_insn_write;
159 s->insn_read = cb_pcimdda_ao_insn_read;
161 ret = comedi_alloc_subdev_readback(s);
165 s = &dev->subdevices[1];
166 /* digital i/o subdevice */
167 ret = subdev_8255_init(dev, s, NULL, PCIMDDA_8255_BASE_REG);
174 static struct comedi_driver cb_pcimdda_driver = {
175 .driver_name = "cb_pcimdda",
176 .module = THIS_MODULE,
177 .auto_attach = cb_pcimdda_auto_attach,
178 .detach = comedi_pci_detach,
181 static int cb_pcimdda_pci_probe(struct pci_dev *dev,
182 const struct pci_device_id *id)
184 return comedi_pci_auto_config(dev, &cb_pcimdda_driver,
188 static const struct pci_device_id cb_pcimdda_pci_table[] = {
189 { PCI_DEVICE(PCI_VENDOR_ID_CB, PCI_ID_PCIM_DDA06_16) },
192 MODULE_DEVICE_TABLE(pci, cb_pcimdda_pci_table);
194 static struct pci_driver cb_pcimdda_driver_pci_driver = {
195 .name = "cb_pcimdda",
196 .id_table = cb_pcimdda_pci_table,
197 .probe = cb_pcimdda_pci_probe,
198 .remove = comedi_pci_auto_unconfig,
200 module_comedi_pci_driver(cb_pcimdda_driver, cb_pcimdda_driver_pci_driver);
202 MODULE_AUTHOR("Calin A. Culianu <calin@rtlab.org>");
203 MODULE_DESCRIPTION("Comedi low-level driver for the Computerboards PCIM-DDA "
204 "series. Currently only supports PCIM-DDA06-16 (which "
205 "also happens to be the only board in this series. :) ) ");
206 MODULE_LICENSE("GPL");