staging: rts5139: Fix typo in rts5139
[deliverable/linux.git] / drivers / staging / comedi / drivers / adq12b.c
CommitLineData
27b3f921
JT
1/*
2 comedi/drivers/adq12b.c
3 driver for MicroAxial ADQ12-B data acquisition and control card
4
5 COMEDI - Linux Control and Measurement Device Interface
6 Copyright (C) 2000 David A. Schleef <ds@schleef.org>
7
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.
12
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.
17
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.
21
22*/
23/*
24Driver: adq12b
25Description: driver for MicroAxial ADQ12-B data acquisition and control card
26Devices: [MicroAxial] ADQ12-B (adq12b)
27Author: jeremy theler <thelerg@ib.cnea.gov.ar>
28Updated: Thu, 21 Feb 2008 02:56:27 -0300
29Status: works
30
31Driver for the acquisition card ADQ12-B (without any add-on).
32
33 - Analog input is subdevice 0 (16 channels single-ended or 8 differential)
34 - Digital input is subdevice 1 (5 channels)
35 - Digital output is subdevice 1 (8 channels)
36 - The PACER is not supported in this version
37
38If you do not specify any options, they will default to
39
40 # comedi_config /dev/comedi0 adq12b 0x300,0,0
41
42 option 1: I/O base address. The following table is provided as a help
43 of the hardware jumpers.
44
d2e01434
BA
45 address jumper JADR
46 0x300 1 (factory default)
47 0x320 2
48 0x340 3
49 0x360 4
50 0x380 5
51 0x3A0 6
27b3f921
JT
52
53 option 2: unipolar/bipolar ADC selection: 0 -> bipolar, 1 -> unipolar
54
d2e01434
BA
55 selection comedi_config option JUB
56 bipolar 0 2-3 (factory default)
57 unipolar 1 1-2
27b3f921
JT
58
59 option 3: single-ended/differential AI selection: 0 -> SE, 1 -> differential
60
d2e01434 61 selection comedi_config option JCHA JCHB
27b3f921
JT
62 single-ended 0 1-2 1-2 (factory default)
63 differential 1 2-3 2-3
64
27b3f921
JT
65 written by jeremy theler <thelerg@ib.cnea.gov.ar>
66
67 instituto balseiro
25985edc 68 commission nacional de energia atomica
27b3f921
JT
69 universidad nacional de cuyo
70 argentina
71
72 21-feb-2008
73 + changed supported devices string (missused the [] and ())
74
75 13-oct-2007
76 + first try
77
78
79*/
80
81#include "../comedidev.h"
82
56e9e166 83/* address scheme (page 2.17 of the manual) */
27b3f921
JT
84#define ADQ12B_SIZE 16
85
86#define ADQ12B_CTREG 0x00
87#define ADQ12B_STINR 0x00
88#define ADQ12B_OUTBR 0x04
89#define ADQ12B_ADLOW 0x08
90#define ADQ12B_ADHIG 0x09
91#define ADQ12B_CONT0 0x0c
92#define ADQ12B_CONT1 0x0d
93#define ADQ12B_CONT2 0x0e
94#define ADQ12B_COWORD 0x0f
95
56e9e166 96/* mask of the bit at STINR to check end of conversion */
27b3f921
JT
97#define ADQ12B_EOC 0x20
98
99#define TIMEOUT 20
100
56e9e166 101/* available ranges through the PGA gains */
9ced1de6 102static const struct comedi_lrange range_adq12b_ai_bipolar = { 4, {
0a85b6f0
MT
103 BIP_RANGE(5),
104 BIP_RANGE(2),
105 BIP_RANGE(1),
106 BIP_RANGE(0.5)
107 }
108};
27b3f921 109
9ced1de6 110static const struct comedi_lrange range_adq12b_ai_unipolar = { 4, {
0a85b6f0
MT
111 UNI_RANGE(5),
112 UNI_RANGE(2),
113 UNI_RANGE(1),
114 UNI_RANGE
115 (0.5)
116 }
117};
27b3f921 118
47c6e958 119struct adq12b_board {
0a85b6f0
MT
120 const char *name;
121 int ai_se_chans;
122 int ai_diff_chans;
123 int ai_bits;
124 int di_chans;
125 int do_chans;
47c6e958 126};
27b3f921 127
47c6e958 128#define thisboard ((const struct adq12b_board *)dev->board_ptr)
27b3f921 129
1ade3157 130struct adq12b_private {
0a85b6f0
MT
131 int unipolar; /* option 2 of comedi_config (1 is iobase) */
132 int differential; /* option 3 of comedi_config */
133 int last_channel;
134 int last_range;
135 unsigned int digital_state;
1ade3157 136};
27b3f921 137
1ade3157 138#define devpriv ((struct adq12b_private *)dev->private)
27b3f921
JT
139
140/*
632d391b
HS
141 * "instructions" read/write data in "one-shot" or "software-triggered"
142 * mode.
27b3f921 143 */
27b3f921 144
0a85b6f0
MT
145static int adq12b_ai_rinsn(struct comedi_device *dev,
146 struct comedi_subdevice *s, struct comedi_insn *insn,
632d391b
HS
147 unsigned int *data)
148{
149 int n, i;
150 int range, channel;
151 unsigned char hi, lo, status;
152
153 /* change channel and range only if it is different from the previous */
154 range = CR_RANGE(insn->chanspec);
155 channel = CR_CHAN(insn->chanspec);
156 if (channel != devpriv->last_channel || range != devpriv->last_range) {
157 outb((range << 4) | channel, dev->iobase + ADQ12B_CTREG);
158 udelay(50); /* wait for the mux to settle */
159 }
160
161 /* trigger conversion */
162 status = inb(dev->iobase + ADQ12B_ADLOW);
163
164 /* convert n samples */
165 for (n = 0; n < insn->n; n++) {
166
167 /* wait for end of conversion */
168 i = 0;
169 do {
170 /* udelay(1); */
171 status = inb(dev->iobase + ADQ12B_STINR);
172 status = status & ADQ12B_EOC;
173 } while (status == 0 && ++i < TIMEOUT);
174 /* } while (++i < 10); */
175
176 /* read data */
177 hi = inb(dev->iobase + ADQ12B_ADHIG);
178 lo = inb(dev->iobase + ADQ12B_ADLOW);
179
180 /* printk("debug: chan=%d range=%d status=%d hi=%d lo=%d\n",
181 channel, range, status, hi, lo); */
182 data[n] = (hi << 8) | lo;
183
184 }
185
186 /* return the number of samples read/written */
187 return n;
188}
189
0a85b6f0
MT
190static int adq12b_di_insn_bits(struct comedi_device *dev,
191 struct comedi_subdevice *s,
632d391b
HS
192 struct comedi_insn *insn, unsigned int *data)
193{
194
195 /* only bits 0-4 have information about digital inputs */
196 data[1] = (inb(dev->iobase + ADQ12B_STINR) & (0x1f));
197
198 return 2;
199}
200
0a85b6f0
MT
201static int adq12b_do_insn_bits(struct comedi_device *dev,
202 struct comedi_subdevice *s,
632d391b
HS
203 struct comedi_insn *insn, unsigned int *data)
204{
205 int channel;
206
207 for (channel = 0; channel < 8; channel++)
208 if (((data[0] >> channel) & 0x01) != 0)
209 outb((((data[1] >> channel) & 0x01) << 3) | channel,
210 dev->iobase + ADQ12B_OUTBR);
211
212 /* store information to retrieve when asked for reading */
213 if (data[0]) {
214 devpriv->digital_state &= ~data[0];
215 devpriv->digital_state |= (data[0] & data[1]);
216 }
217
218 data[1] = devpriv->digital_state;
219
220 return 2;
221}
27b3f921 222
f7cbd7aa 223static int adq12b_attach(struct comedi_device *dev, struct comedi_devconfig *it)
27b3f921 224{
0a85b6f0
MT
225 struct comedi_subdevice *s;
226 unsigned long iobase;
227 int unipolar, differential;
228
229 iobase = it->options[0];
230 unipolar = it->options[1];
231 differential = it->options[2];
232
7df1735b
BA
233 printk(KERN_INFO "comedi%d: adq12b called with options base=0x%03lx, "
234 "%s and %s\n", dev->minor, iobase,
235 (unipolar == 1) ? "unipolar" : "bipolar",
0a85b6f0
MT
236 (differential == 1) ? "differential" : "single-ended");
237
238 /* if no address was specified, try the default 0x300 */
239 if (iobase == 0) {
7df1735b
BA
240 printk(KERN_WARNING "comedi%d: adq12b warning: I/O base "
241 "address not specified. Trying the default 0x300.\n",
242 dev->minor);
0a85b6f0
MT
243 iobase = 0x300;
244 }
245
246 printk("comedi%d: adq12b: 0x%04lx ", dev->minor, iobase);
247 if (!request_region(iobase, ADQ12B_SIZE, "adq12b")) {
248 printk("I/O port conflict\n");
249 return -EIO;
250 }
251 dev->iobase = iobase;
27b3f921
JT
252
253/*
254 * Initialize dev->board_name. Note that we can use the "thisboard"
255 * macro now, since we just initialized it in the last line.
256 */
0a85b6f0 257 dev->board_name = thisboard->name;
27b3f921
JT
258
259/*
260 * Allocate the private structure area. alloc_private() is a
261 * convenient macro defined in comedidev.h.
262 */
0a85b6f0
MT
263 if (alloc_private(dev, sizeof(struct adq12b_private)) < 0)
264 return -ENOMEM;
27b3f921
JT
265
266/* fill in devpriv structure */
0a85b6f0
MT
267 devpriv->unipolar = unipolar;
268 devpriv->differential = differential;
27b3f921
JT
269 devpriv->digital_state = 0;
270/* initialize channel and range to -1 so we make sure we always write
271 at least once to the CTREG in the instruction */
0a85b6f0
MT
272 devpriv->last_channel = -1;
273 devpriv->last_range = -1;
27b3f921
JT
274
275/*
276 * Allocate the subdevice structures. alloc_subdevice() is a
277 * convenient macro defined in comedidev.h.
278 */
0a85b6f0
MT
279 if (alloc_subdevices(dev, 3) < 0)
280 return -ENOMEM;
281
282 s = dev->subdevices + 0;
283 /* analog input subdevice */
284 s->type = COMEDI_SUBD_AI;
285 if (differential) {
286 s->subdev_flags = SDF_READABLE | SDF_GROUND | SDF_DIFF;
287 s->n_chan = thisboard->ai_diff_chans;
288 } else {
289 s->subdev_flags = SDF_READABLE | SDF_GROUND;
290 s->n_chan = thisboard->ai_se_chans;
291 }
292
d2e01434 293 if (unipolar)
0a85b6f0 294 s->range_table = &range_adq12b_ai_unipolar;
d2e01434 295 else
0a85b6f0 296 s->range_table = &range_adq12b_ai_bipolar;
0a85b6f0
MT
297
298 s->maxdata = (1 << thisboard->ai_bits) - 1;
299
300 s->len_chanlist = 4; /* This is the maximum chanlist length that
301 the board can handle */
302 s->insn_read = adq12b_ai_rinsn;
303
304 s = dev->subdevices + 1;
305 /* digital input subdevice */
306 s->type = COMEDI_SUBD_DI;
307 s->subdev_flags = SDF_READABLE;
308 s->n_chan = thisboard->di_chans;
309 s->maxdata = 1;
310 s->range_table = &range_digital;
311 s->insn_bits = adq12b_di_insn_bits;
312
313 s = dev->subdevices + 2;
314 /* digital output subdevice */
315 s->type = COMEDI_SUBD_DO;
316 s->subdev_flags = SDF_WRITABLE;
317 s->n_chan = thisboard->do_chans;
318 s->maxdata = 1;
319 s->range_table = &range_digital;
320 s->insn_bits = adq12b_do_insn_bits;
321
7df1735b 322 printk(KERN_INFO "attached\n");
0a85b6f0
MT
323
324 return 0;
27b3f921
JT
325}
326
71b5f4f1 327static int adq12b_detach(struct comedi_device *dev)
27b3f921 328{
0a85b6f0
MT
329 if (dev->iobase)
330 release_region(dev->iobase, ADQ12B_SIZE);
27b3f921 331
0a85b6f0 332 kfree(devpriv);
27b3f921 333
7df1735b 334 printk(KERN_INFO "comedi%d: adq12b: removed\n", dev->minor);
27b3f921 335
0a85b6f0 336 return 0;
27b3f921
JT
337}
338
632d391b
HS
339static const struct adq12b_board adq12b_boards[] = {
340 {
341 .name = "adq12b",
342 .ai_se_chans = 16,
343 .ai_diff_chans = 8,
344 .ai_bits = 12,
345 .di_chans = 5,
346 .do_chans = 8,
347 },
348};
27b3f921 349
632d391b
HS
350static struct comedi_driver driver_adq12b = {
351 .driver_name = "adq12b",
352 .module = THIS_MODULE,
353 .attach = adq12b_attach,
354 .detach = adq12b_detach,
355 .board_name = &adq12b_boards[0].name,
356 .offset = sizeof(struct adq12b_board),
357 .num_names = ARRAY_SIZE(adq12b_boards),
358};
27b3f921 359
7114a280
AT
360static int __init driver_adq12b_init_module(void)
361{
362 return comedi_driver_register(&driver_adq12b);
363}
632d391b 364module_init(driver_adq12b_init_module);
7114a280
AT
365
366static void __exit driver_adq12b_cleanup_module(void)
367{
368 comedi_driver_unregister(&driver_adq12b);
369}
7114a280 370module_exit(driver_adq12b_cleanup_module);
90f703d3
AT
371
372MODULE_AUTHOR("Comedi http://www.comedi.org");
373MODULE_DESCRIPTION("Comedi low-level driver");
374MODULE_LICENSE("GPL");
This page took 0.29309 seconds and 5 git commands to generate.