1 // SPDX-License-Identifier: GPL-2.0+
2 /*
3 * comedi/drivers/cb_pcimdda.c
4 * Computer Boards PCIM-DDA06-16 Comedi driver
5 * Author: Calin Culianu <calin@ajvar.org>
6 *
7 * COMEDI - Linux Control and Measurement Device Interface
8 * Copyright (C) 2000 David A. Schleef <ds@schleef.org>
9 */
10 /*
11 * Driver: cb_pcimdda
12 * Description: Measurement Computing PCIM-DDA06-16
13 * Devices: [Measurement Computing] PCIM-DDA06-16 (cb_pcimdda)
14 * Author: Calin Culianu <calin@ajvar.org>
15 * Updated: Mon, 14 Apr 2008 15:15:51 +0100
16 * Status: works
17 *
18 * All features of the PCIM-DDA06-16 board are supported.
19 * This board has 6 16-bit AO channels, and the usual 8255 DIO setup.
20 * (24 channels, configurable in banks of 8 and 4, etc.).
21 * This board does not support commands.
22 *
23 * The board has a peculiar way of specifying AO gain/range settings -- You have
24 * 1 jumper bank on the card, which either makes all 6 AO channels either
25 * 5 Volt unipolar, 5V bipolar, 10 Volt unipolar or 10V bipolar.
26 *
27 * Since there is absolutely _no_ way to tell in software how this jumper is set
28 * (well, at least according to the rather thin spec. from Measurement Computing
29 * that comes with the board), the driver assumes the jumper is at its factory
30 * default setting of +/-5V.
31 *
32 * Also of note is the fact that this board features another jumper, whose
33 * state is also completely invisible to software. It toggles two possible AO
34 * output modes on the board:
35 *
36 * - Update Mode: Writing to an AO channel instantaneously updates the actual
37 * signal output by the DAC on the board (this is the factory default).
38 * - Simultaneous XFER Mode: Writing to an AO channel has no effect until
39 * you read from any one of the AO channels. This is useful for loading
40 * all 6 AO values, and then reading from any one of the AO channels on the
41 * device to instantly update all 6 AO values in unison. Useful for some
42 * control apps, I would assume? If your jumper is in this setting, then you
43 * need to issue your comedi_data_write()s to load all the values you want,
44 * then issue one comedi_data_read() on any channel on the AO subdevice
45 * to initiate the simultaneous XFER.
46 *
47 * Configuration Options: not applicable, uses PCI auto config
48 */
49
50 /*
51 * This is a driver for the Computer Boards PCIM-DDA06-16 Analog Output
52 * card. This board has a unique register layout and as such probably
53 * deserves its own driver file.
54 *
55 * It is theoretically possible to integrate this board into the cb_pcidda
56 * file, but since that isn't my code, I didn't want to significantly
57 * modify that file to support this board (I thought it impolite to do so).
58 *
59 * At any rate, if you feel ambitious, please feel free to take
60 * the code out of this file and combine it with a more unified driver
61 * file.
62 *
63 * I would like to thank Timothy Curry <Timothy.Curry@rdec.redstone.army.mil>
64 * for lending me a board so that I could write this driver.
65 *
66 * -Calin Culianu <calin@ajvar.org>
67 */
68
69 #include <linux/module.h>
70 #include <linux/comedi/comedi_pci.h>
71 #include <linux/comedi/comedi_8255.h>
72
73 /* device ids of the cards we support -- currently only 1 card supported */
74 #define PCI_ID_PCIM_DDA06_16 0x0053
75
76 /*
77 * Register map, 8-bit access only
78 */
79 #define PCIMDDA_DA_CHAN(x) (0x00 + (x) * 2)
80 #define PCIMDDA_8255_BASE_REG 0x0c
81
cb_pcimdda_ao_insn_write(struct comedi_device * dev,struct comedi_subdevice * s,struct comedi_insn * insn,unsigned int * data)82 static int cb_pcimdda_ao_insn_write(struct comedi_device *dev,
83 struct comedi_subdevice *s,
84 struct comedi_insn *insn,
85 unsigned int *data)
86 {
87 unsigned int chan = CR_CHAN(insn->chanspec);
88 unsigned long offset = dev->iobase + PCIMDDA_DA_CHAN(chan);
89 unsigned int val = s->readback[chan];
90 int i;
91
92 for (i = 0; i < insn->n; i++) {
93 val = data[i];
94
95 /*
96 * Write the LSB then MSB.
97 *
98 * If the simultaneous xfer mode is selected by the
99 * jumper on the card, a read instruction is needed
100 * in order to initiate the simultaneous transfer.
101 * Otherwise, the DAC will be updated when the MSB
102 * is written.
103 */
104 outb(val & 0x00ff, offset);
105 outb((val >> 8) & 0x00ff, offset + 1);
106 }
107 s->readback[chan] = val;
108
109 return insn->n;
110 }
111
cb_pcimdda_ao_insn_read(struct comedi_device * dev,struct comedi_subdevice * s,struct comedi_insn * insn,unsigned int * data)112 static int cb_pcimdda_ao_insn_read(struct comedi_device *dev,
113 struct comedi_subdevice *s,
114 struct comedi_insn *insn,
115 unsigned int *data)
116 {
117 unsigned int chan = CR_CHAN(insn->chanspec);
118
119 /* Initiate the simultaneous transfer */
120 inw(dev->iobase + PCIMDDA_DA_CHAN(chan));
121
122 return comedi_readback_insn_read(dev, s, insn, data);
123 }
124
cb_pcimdda_auto_attach(struct comedi_device * dev,unsigned long context_unused)125 static int cb_pcimdda_auto_attach(struct comedi_device *dev,
126 unsigned long context_unused)
127 {
128 struct pci_dev *pcidev = comedi_to_pci_dev(dev);
129 struct comedi_subdevice *s;
130 int ret;
131
132 ret = comedi_pci_enable(dev);
133 if (ret)
134 return ret;
135 dev->iobase = pci_resource_start(pcidev, 3);
136
137 ret = comedi_alloc_subdevices(dev, 2);
138 if (ret)
139 return ret;
140
141 s = &dev->subdevices[0];
142 /* analog output subdevice */
143 s->type = COMEDI_SUBD_AO;
144 s->subdev_flags = SDF_WRITABLE | SDF_READABLE;
145 s->n_chan = 6;
146 s->maxdata = 0xffff;
147 s->range_table = &range_bipolar5;
148 s->insn_write = cb_pcimdda_ao_insn_write;
149 s->insn_read = cb_pcimdda_ao_insn_read;
150
151 ret = comedi_alloc_subdev_readback(s);
152 if (ret)
153 return ret;
154
155 s = &dev->subdevices[1];
156 /* digital i/o subdevice */
157 return subdev_8255_init(dev, s, NULL, PCIMDDA_8255_BASE_REG);
158 }
159
160 static struct comedi_driver cb_pcimdda_driver = {
161 .driver_name = "cb_pcimdda",
162 .module = THIS_MODULE,
163 .auto_attach = cb_pcimdda_auto_attach,
164 .detach = comedi_pci_detach,
165 };
166
cb_pcimdda_pci_probe(struct pci_dev * dev,const struct pci_device_id * id)167 static int cb_pcimdda_pci_probe(struct pci_dev *dev,
168 const struct pci_device_id *id)
169 {
170 return comedi_pci_auto_config(dev, &cb_pcimdda_driver,
171 id->driver_data);
172 }
173
174 static const struct pci_device_id cb_pcimdda_pci_table[] = {
175 { PCI_DEVICE(PCI_VENDOR_ID_CB, PCI_ID_PCIM_DDA06_16) },
176 { 0 }
177 };
178 MODULE_DEVICE_TABLE(pci, cb_pcimdda_pci_table);
179
180 static struct pci_driver cb_pcimdda_driver_pci_driver = {
181 .name = "cb_pcimdda",
182 .id_table = cb_pcimdda_pci_table,
183 .probe = cb_pcimdda_pci_probe,
184 .remove = comedi_pci_auto_unconfig,
185 };
186 module_comedi_pci_driver(cb_pcimdda_driver, cb_pcimdda_driver_pci_driver);
187
188 MODULE_AUTHOR("Calin A. Culianu <calin@rtlab.org>");
189 MODULE_DESCRIPTION("Comedi low-level driver for the Computerboards PCIM-DDA series. Currently only supports PCIM-DDA06-16 (which also happens to be the only board in this series. :) ) ");
190 MODULE_LICENSE("GPL");
191