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>
78 #include <linux/pci.h>
80 #include "../comedidev.h"
84 /* device ids of the cards we support -- currently only 1 card supported */
85 #define PCI_ID_PCIM_DDA06_16 0x0053
88 * Register map, 8-bit access only
90 #define PCIMDDA_DA_CHAN(x) (0x00 + (x) * 2)
91 #define PCIMDDA_8255_BASE_REG 0x0c
93 #define MAX_AO_READBACK_CHANNELS 6
95 struct cb_pcimdda_private {
96 unsigned int ao_readback[MAX_AO_READBACK_CHANNELS];
99 static int cb_pcimdda_ao_winsn(struct comedi_device *dev,
100 struct comedi_subdevice *s,
101 struct comedi_insn *insn,
104 struct cb_pcimdda_private *devpriv = dev->private;
105 unsigned int chan = CR_CHAN(insn->chanspec);
106 unsigned long offset = dev->iobase + PCIMDDA_DA_CHAN(chan);
107 unsigned int val = 0;
110 for (i = 0; i < insn->n; i++) {
114 * Write the LSB then MSB.
116 * If the simultaneous xfer mode is selected by the
117 * jumper on the card, a read instruction is needed
118 * in order to initiate the simultaneous transfer.
119 * Otherwise, the DAC will be updated when the MSB
122 outb(val & 0x00ff, offset);
123 outb((val >> 8) & 0x00ff, offset + 1);
126 /* Cache the last value for readback */
127 devpriv->ao_readback[chan] = val;
132 static int cb_pcimdda_ao_rinsn(struct comedi_device *dev,
133 struct comedi_subdevice *s,
134 struct comedi_insn *insn,
137 struct cb_pcimdda_private *devpriv = dev->private;
138 int chan = CR_CHAN(insn->chanspec);
139 unsigned long offset = dev->iobase + PCIMDDA_DA_CHAN(chan);
142 for (i = 0; i < insn->n; i++) {
143 /* Initiate the simultaneous transfer */
146 data[i] = devpriv->ao_readback[chan];
152 static int cb_pcimdda_auto_attach(struct comedi_device *dev,
153 unsigned long context_unused)
155 struct pci_dev *pcidev = comedi_to_pci_dev(dev);
156 struct cb_pcimdda_private *devpriv;
157 struct comedi_subdevice *s;
160 devpriv = comedi_alloc_devpriv(dev, sizeof(*devpriv));
164 ret = comedi_pci_enable(dev);
167 dev->iobase = pci_resource_start(pcidev, 3);
169 ret = comedi_alloc_subdevices(dev, 2);
173 s = &dev->subdevices[0];
174 /* analog output subdevice */
175 s->type = COMEDI_SUBD_AO;
176 s->subdev_flags = SDF_WRITABLE | SDF_READABLE;
179 s->range_table = &range_bipolar5;
180 s->insn_write = cb_pcimdda_ao_winsn;
181 s->insn_read = cb_pcimdda_ao_rinsn;
183 s = &dev->subdevices[1];
184 /* digital i/o subdevice */
185 ret = subdev_8255_init(dev, s, NULL,
186 dev->iobase + PCIMDDA_8255_BASE_REG);
193 static struct comedi_driver cb_pcimdda_driver = {
194 .driver_name = "cb_pcimdda",
195 .module = THIS_MODULE,
196 .auto_attach = cb_pcimdda_auto_attach,
197 .detach = comedi_pci_disable,
200 static int cb_pcimdda_pci_probe(struct pci_dev *dev,
201 const struct pci_device_id *id)
203 return comedi_pci_auto_config(dev, &cb_pcimdda_driver,
207 static const struct pci_device_id cb_pcimdda_pci_table[] = {
208 { PCI_DEVICE(PCI_VENDOR_ID_CB, PCI_ID_PCIM_DDA06_16) },
211 MODULE_DEVICE_TABLE(pci, cb_pcimdda_pci_table);
213 static struct pci_driver cb_pcimdda_driver_pci_driver = {
214 .name = "cb_pcimdda",
215 .id_table = cb_pcimdda_pci_table,
216 .probe = cb_pcimdda_pci_probe,
217 .remove = comedi_pci_auto_unconfig,
219 module_comedi_pci_driver(cb_pcimdda_driver, cb_pcimdda_driver_pci_driver);
221 MODULE_AUTHOR("Calin A. Culianu <calin@rtlab.org>");
222 MODULE_DESCRIPTION("Comedi low-level driver for the Computerboards PCIM-DDA "
223 "series. Currently only supports PCIM-DDA06-16 (which "
224 "also happens to be the only board in this series. :) ) ");
225 MODULE_LICENSE("GPL");