2 comedi/drivers/adq12b.c
3 driver for MicroAxial ADQ12-B data acquisition and control card
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: driver for MicroAxial ADQ12-B data acquisition and control card
26 Devices: [MicroAxial] ADQ12-B (adq12b)
27 Author: jeremy theler <thelerg@ib.cnea.gov.ar>
28 Updated: Thu, 21 Feb 2008 02:56:27 -0300
31 Driver for the acquisition card ADQ12-B (without any add-on).
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
38 If you do not specify any options, they will default to
40 # comedi_config /dev/comedi0 adq12b 0x300,0,0
42 option 1: I/O base address. The following table is provided as a help
43 of the hardware jumpers.
46 0x300 1 (factory default)
53 option 2: unipolar/bipolar ADC selection: 0 -> bipolar, 1 -> unipolar
55 selection comedi_config option JUB
56 bipolar 0 2-3 (factory default)
59 option 3: single-ended/differential AI selection: 0 -> SE, 1 -> differential
61 selection comedi_config option JCHA JCHB
62 single-ended 0 1-2 1-2 (factory default)
63 differential 1 2-3 2-3
66 written by jeremy theler <thelerg@ib.cnea.gov.ar>
69 comision nacional de energia atomica
70 universidad nacional de cuyo
74 + changed supported devices string (missused the [] and ())
82 #include "../comedidev.h"
84 // address scheme (page 2.17 of the manual)
85 #define ADQ12B_SIZE 16
87 #define ADQ12B_CTREG 0x00
88 #define ADQ12B_STINR 0x00
89 #define ADQ12B_OUTBR 0x04
90 #define ADQ12B_ADLOW 0x08
91 #define ADQ12B_ADHIG 0x09
92 #define ADQ12B_CONT0 0x0c
93 #define ADQ12B_CONT1 0x0d
94 #define ADQ12B_CONT2 0x0e
95 #define ADQ12B_COWORD 0x0f
97 // mask of the bit at STINR to check end of conversion
98 #define ADQ12B_EOC 0x20
102 // available ranges through the PGA gains
103 static const struct comedi_lrange range_adq12b_ai_bipolar
= { 4, {
110 static const struct comedi_lrange range_adq12b_ai_unipolar
= { 4, {
119 typedef struct adq12b_board_struct
{
128 static const adq12b_board adq12b_boards
[] = {
137 // potentially, more adq-based deviced will be added
140 ai_chans: 16, // this is just for reference, hardcoded again later
147 #define thisboard ((const adq12b_board *)dev->board_ptr)
150 int unipolar
; /* option 2 of comedi_config (1 is iobase) */
151 int differential
; /* option 3 of comedi_config */
154 unsigned int digital_state
;
157 #define devpriv ((adq12b_private *)dev->private)
160 * The struct comedi_driver structure tells the Comedi core module
161 * which functions to call to configure/deconfigure (attach/detach)
162 * the board, and also about the kernel module that contains
165 static int adq12b_attach(struct comedi_device
*dev
,comedi_devconfig
*it
);
166 static int adq12b_detach(struct comedi_device
*dev
);
167 static struct comedi_driver driver_adq12b
={
168 driver_name
: "adq12b",
170 attach
: adq12b_attach
,
171 detach
: adq12b_detach
,
172 board_name
: &adq12b_boards
[0].name
,
173 offset
: sizeof(adq12b_board
),
174 num_names
: sizeof(adq12b_boards
) / sizeof(adq12b_board
),
177 static int adq12b_ai_rinsn(struct comedi_device
*dev
,struct comedi_subdevice
*s
,struct comedi_insn
*insn
,unsigned int *data
);
178 static int adq12b_di_insn_bits(struct comedi_device
*dev
,struct comedi_subdevice
*s
, struct comedi_insn
*insn
,unsigned int *data
);
179 static int adq12b_do_insn_bits(struct comedi_device
*dev
,struct comedi_subdevice
*s
, struct comedi_insn
*insn
,unsigned int *data
);
182 * Attach is called by the Comedi core to configure the driver
183 * for a particular board. If you specified a board_name array
184 * in the driver structure, dev->board_ptr contains that
187 static int adq12b_attach(struct comedi_device
*dev
,comedi_devconfig
*it
)
189 struct comedi_subdevice
*s
;
190 unsigned long iobase
;
191 int unipolar
, differential
;
193 iobase
= it
->options
[0];
194 unipolar
= it
->options
[1];
195 differential
= it
->options
[2];
197 printk("comedi%d: adq12b called with options base=0x%03lx, %s and %s\n",dev
->minor
, iobase
, (unipolar
==1)?"unipolar":"bipolar", (differential
==1)?"differential":"single-ended");
199 /* if no address was specified, try the default 0x300 */
201 printk("comedi%d: adq12b warning: I/O base address not specified. Trying the default 0x300.\n", dev
->minor
);
205 printk("comedi%d: adq12b: 0x%04lx ", dev
->minor
, iobase
);
206 if (!request_region(iobase
, ADQ12B_SIZE
, "adq12b")) {
207 printk("I/O port conflict\n");
210 dev
->iobase
= iobase
;
213 * Initialize dev->board_name. Note that we can use the "thisboard"
214 * macro now, since we just initialized it in the last line.
216 dev
->board_name
= thisboard
->name
;
219 * Allocate the private structure area. alloc_private() is a
220 * convenient macro defined in comedidev.h.
222 if(alloc_private(dev
, sizeof(adq12b_private
)) < 0)
225 /* fill in devpriv structure */
226 devpriv
->unipolar
= unipolar
;
227 devpriv
->differential
= differential
;
228 devpriv
->digital_state
= 0;
229 /* initialize channel and range to -1 so we make sure we always write
230 at least once to the CTREG in the instruction */
231 devpriv
->last_channel
= -1;
232 devpriv
->last_range
= -1;
236 * Allocate the subdevice structures. alloc_subdevice() is a
237 * convenient macro defined in comedidev.h.
239 if(alloc_subdevices(dev
, 3)<0)
242 s
= dev
->subdevices
+0;
243 /* analog input subdevice */
244 s
->type
= COMEDI_SUBD_AI
;
246 s
->subdev_flags
= SDF_READABLE
|SDF_GROUND
|SDF_DIFF
;
247 s
->n_chan
= thisboard
->ai_diff_chans
;
249 s
->subdev_flags
= SDF_READABLE
|SDF_GROUND
;
250 s
->n_chan
= thisboard
->ai_se_chans
;
254 s
->range_table
= &range_adq12b_ai_unipolar
;
256 s
->range_table
= &range_adq12b_ai_bipolar
;
259 s
->maxdata
= (1 << thisboard
->ai_bits
)-1;
262 s
->len_chanlist
= 4; /* This is the maximum chanlist length that
263 the board can handle */
264 s
->insn_read
= adq12b_ai_rinsn
;
267 s
= dev
->subdevices
+1;
268 /* digital input subdevice */
269 s
->type
= COMEDI_SUBD_DI
;
270 s
->subdev_flags
= SDF_READABLE
;
271 s
->n_chan
=thisboard
->di_chans
;
273 s
->range_table
= &range_digital
;
274 s
->insn_bits
= adq12b_di_insn_bits
;
276 s
= dev
->subdevices
+2;
277 /* digital output subdevice */
278 s
->type
= COMEDI_SUBD_DO
;
279 s
->subdev_flags
= SDF_WRITABLE
;
280 s
->n_chan
= thisboard
->do_chans
;
282 s
->range_table
= &range_digital
;
283 s
->insn_bits
= adq12b_do_insn_bits
;
286 printk("attached\n");
293 * _detach is called to deconfigure a device. It should deallocate
295 * This function is also called when _attach() fails, so it should be
296 * careful not to release resources that were not necessarily
297 * allocated by _attach(). dev->private and dev->subdevices are
298 * deallocated automatically by the core.
300 static int adq12b_detach(struct comedi_device
*dev
)
303 release_region(dev
->iobase
, ADQ12B_SIZE
);
307 printk("comedi%d: adq12b: removed\n",dev
->minor
);
313 * "instructions" read/write data in "one-shot" or "software-triggered"
317 static int adq12b_ai_rinsn(struct comedi_device
*dev
,struct comedi_subdevice
*s
,struct comedi_insn
*insn
,unsigned int *data
)
321 unsigned char hi
, lo
, status
;
323 /* change channel and range only if it is different from the previous */
324 range
= CR_RANGE(insn
->chanspec
);
325 channel
= CR_CHAN(insn
->chanspec
);
326 if (channel
!= devpriv
->last_channel
|| range
!= devpriv
->last_range
) {
327 outb((range
<< 4) | channel
, dev
->iobase
+ ADQ12B_CTREG
);
328 comedi_udelay(50); /* wait for the mux to settle */
331 /* trigger conversion */
332 status
= inb(dev
->iobase
+ ADQ12B_ADLOW
);
334 /* convert n samples */
335 for(n
=0; n
< insn
->n
; n
++){
337 /* wait for end of convertion */
341 status
= inb(dev
->iobase
+ ADQ12B_STINR
);
342 status
= status
& ADQ12B_EOC
;
343 } while (status
== 0 && ++i
< TIMEOUT
);
344 // } while (++i < 10);
347 hi
= inb(dev
->iobase
+ ADQ12B_ADHIG
);
348 lo
= inb(dev
->iobase
+ ADQ12B_ADLOW
);
350 //rt_printk("debug: chan=%d range=%d status=%d hi=%d lo=%d\n", channel, range, status, hi, lo);
351 data
[n
] = (hi
<< 8) | lo
;
355 /* return the number of samples read/written */
360 static int adq12b_di_insn_bits(struct comedi_device
*dev
,struct comedi_subdevice
*s
, struct comedi_insn
*insn
,unsigned int *data
)
363 /* only bits 0-4 have information about digital inputs */
364 data
[1] = (inb(dev
->iobase
+ADQ12B_STINR
) & (0x1f));
370 static int adq12b_do_insn_bits(struct comedi_device
*dev
,struct comedi_subdevice
*s
, struct comedi_insn
*insn
,unsigned int *data
)
374 for (channel
= 0; channel
< 8; channel
++)
375 if (((data
[0]>>channel
) & 0x01) != 0)
376 outb((((data
[1]>>channel
)&0x01)<<3) | channel
, dev
->iobase
+ ADQ12B_OUTBR
);
378 /* store information to retrieve when asked for reading */
380 devpriv
->digital_state
&= ~data
[0];
381 devpriv
->digital_state
|= (data
[0]&data
[1]);
384 data
[1] = devpriv
->digital_state
;
391 * A convenient macro that defines init_module() and cleanup_module(),
394 COMEDI_INITCLEANUP(driver_adq12b
);