2 * comedi/drivers/dt2801.c
3 * Device Driver for DataTranslation DT2801
8 Description: Data Translation DT2801 series and DT01-EZ
11 Devices: [Data Translation] DT2801 (dt2801), DT2801-A, DT2801/5716A,
12 DT2805, DT2805/5716A, DT2808, DT2818, DT2809, DT01-EZ
14 This driver can autoprobe the type of board.
16 Configuration options:
17 [0] - I/O port base address
19 [2] - A/D reference 0=differential, 1=single-ended
29 [5] - D/A 1 range (same choices)
32 #include "../comedidev.h"
33 #include <linux/delay.h>
34 #include <linux/ioport.h>
36 #define DT2801_TIMEOUT 1000
38 /* Hardware Configuration */
39 /* ====================== */
41 #define DT2801_MAX_DMA_SIZE (64 * 1024)
44 #define DT2801_IOSIZE 2
46 /* define's & typedef's */
47 /* ====================== */
50 #define DT_C_RESET 0x0
51 #define DT_C_CLEAR_ERR 0x1
52 #define DT_C_READ_ERRREG 0x2
53 #define DT_C_SET_CLOCK 0x3
58 #define DT_C_SET_DIGIN 0x4
59 #define DT_C_SET_DIGOUT 0x5
60 #define DT_C_READ_DIG 0x6
61 #define DT_C_WRITE_DIG 0x7
63 #define DT_C_WRITE_DAIM 0x8
64 #define DT_C_SET_DA 0x9
65 #define DT_C_WRITE_DA 0xa
67 #define DT_C_READ_ADIM 0xc
68 #define DT_C_SET_AD 0xd
69 #define DT_C_READ_AD 0xe
71 /* Command modifiers (only used with read/write), EXTTRIG can be
72 used with some other commands.
74 #define DT_MOD_DMA (1<<4)
75 #define DT_MOD_CONT (1<<5)
76 #define DT_MOD_EXTCLK (1<<6)
77 #define DT_MOD_EXTTRIG (1<<7)
79 /* Bits in status register */
80 #define DT_S_DATA_OUT_READY (1<<0)
81 #define DT_S_DATA_IN_FULL (1<<1)
82 #define DT_S_READY (1<<2)
83 #define DT_S_COMMAND (1<<3)
84 #define DT_S_COMPOSITE_ERROR (1<<7)
88 #define DT2801_STATUS 1
91 static int dt2801_attach(struct comedi_device * dev, comedi_devconfig * it);
92 static int dt2801_detach(struct comedi_device * dev);
93 static struct comedi_driver driver_dt2801 = {
100 COMEDI_INITCLEANUP(driver_dt2801);
103 // ignore 'defined but not used' warning
104 static const struct comedi_lrange range_dt2801_ai_pgh_bipolar = { 4, {
112 static const struct comedi_lrange range_dt2801_ai_pgl_bipolar = { 4, {
121 // ignore 'defined but not used' warning
122 static const struct comedi_lrange range_dt2801_ai_pgh_unipolar = { 4, {
130 static const struct comedi_lrange range_dt2801_ai_pgl_unipolar = { 4, {
148 /* Typeid's for the different boards of the DT2801-series
149 (taken from the test-software, that comes with the board)
151 static const boardtype_t boardtypes[] = {
169 name: "dt2801/5716a",
185 name: "dt2805/5716a",
218 #define n_boardtypes ((sizeof(boardtypes))/(sizeof(boardtypes[0])))
219 #define boardtype (*(const boardtype_t *)dev->board_ptr)
222 const struct comedi_lrange *dac_range_types[2];
223 unsigned int ao_readback[2];
225 #define devpriv ((dt2801_private *)dev->private)
227 static int dt2801_ai_insn_read(struct comedi_device * dev, struct comedi_subdevice * s,
228 comedi_insn * insn, unsigned int * data);
229 static int dt2801_ao_insn_read(struct comedi_device * dev, struct comedi_subdevice * s,
230 comedi_insn * insn, unsigned int * data);
231 static int dt2801_ao_insn_write(struct comedi_device * dev, struct comedi_subdevice * s,
232 comedi_insn * insn, unsigned int * data);
233 static int dt2801_dio_insn_bits(struct comedi_device * dev, struct comedi_subdevice * s,
234 comedi_insn * insn, unsigned int * data);
235 static int dt2801_dio_insn_config(struct comedi_device * dev, struct comedi_subdevice * s,
236 comedi_insn * insn, unsigned int * data);
238 /* These are the low-level routines:
239 writecommand: write a command to the board
240 writedata: write data byte
241 readdata: read data byte
244 /* Only checks DataOutReady-flag, not the Ready-flag as it is done
245 in the examples of the manual. I don't see why this should be
247 static int dt2801_readdata(struct comedi_device * dev, int *data)
250 int timeout = DT2801_TIMEOUT;
253 stat = inb_p(dev->iobase + DT2801_STATUS);
254 if (stat & (DT_S_COMPOSITE_ERROR | DT_S_READY)) {
257 if (stat & DT_S_DATA_OUT_READY) {
258 *data = inb_p(dev->iobase + DT2801_DATA);
261 } while (--timeout > 0);
266 static int dt2801_readdata2(struct comedi_device * dev, int *data)
271 ret = dt2801_readdata(dev, &lb);
274 ret = dt2801_readdata(dev, &hb);
278 *data = (hb << 8) + lb;
282 static int dt2801_writedata(struct comedi_device * dev, unsigned int data)
285 int timeout = DT2801_TIMEOUT;
288 stat = inb_p(dev->iobase + DT2801_STATUS);
290 if (stat & DT_S_COMPOSITE_ERROR) {
293 if (!(stat & DT_S_DATA_IN_FULL)) {
294 outb_p(data & 0xff, dev->iobase + DT2801_DATA);
298 if (stat & DT_S_READY) {
299 printk("dt2801: ready flag set (bad!) in dt2801_writedata()\n");
303 } while (--timeout > 0);
308 static int dt2801_writedata2(struct comedi_device * dev, unsigned int data)
312 ret = dt2801_writedata(dev, data & 0xff);
315 ret = dt2801_writedata(dev, (data >> 8));
322 static int dt2801_wait_for_ready(struct comedi_device * dev)
324 int timeout = DT2801_TIMEOUT;
327 stat = inb_p(dev->iobase + DT2801_STATUS);
328 if (stat & DT_S_READY) {
332 stat = inb_p(dev->iobase + DT2801_STATUS);
334 if (stat & DT_S_COMPOSITE_ERROR) {
337 if (stat & DT_S_READY) {
340 } while (--timeout > 0);
345 static int dt2801_writecmd(struct comedi_device * dev, int command)
349 dt2801_wait_for_ready(dev);
351 stat = inb_p(dev->iobase + DT2801_STATUS);
352 if (stat & DT_S_COMPOSITE_ERROR) {
353 printk("dt2801: composite-error in dt2801_writecmd(), ignoring\n");
355 if (!(stat & DT_S_READY)) {
356 printk("dt2801: !ready in dt2801_writecmd(), ignoring\n");
358 outb_p(command, dev->iobase + DT2801_CMD);
363 static int dt2801_reset(struct comedi_device * dev)
369 DPRINTK("dt2801: resetting board...\n");
370 DPRINTK("fingerprint: 0x%02x 0x%02x\n", inb_p(dev->iobase),
371 inb_p(dev->iobase + 1));
373 /* pull random data from data port */
374 inb_p(dev->iobase + DT2801_DATA);
375 inb_p(dev->iobase + DT2801_DATA);
376 inb_p(dev->iobase + DT2801_DATA);
377 inb_p(dev->iobase + DT2801_DATA);
379 DPRINTK("dt2801: stop\n");
380 //dt2801_writecmd(dev,DT_C_STOP);
381 outb_p(DT_C_STOP, dev->iobase + DT2801_CMD);
383 //dt2801_wait_for_ready(dev);
387 stat = inb_p(dev->iobase + DT2801_STATUS);
388 if (stat & DT_S_READY)
392 printk("dt2801: timeout 1 status=0x%02x\n", stat);
394 //printk("dt2801: reading dummy\n");
395 //dt2801_readdata(dev,&board_code);
397 DPRINTK("dt2801: reset\n");
398 outb_p(DT_C_RESET, dev->iobase + DT2801_CMD);
399 //dt2801_writecmd(dev,DT_C_RESET);
404 stat = inb_p(dev->iobase + DT2801_STATUS);
405 if (stat & DT_S_READY)
409 printk("dt2801: timeout 2 status=0x%02x\n", stat);
412 DPRINTK("dt2801: reading code\n");
413 dt2801_readdata(dev, &board_code);
415 DPRINTK("dt2801: ok. code=0x%02x\n", board_code);
420 static int probe_number_of_ai_chans(struct comedi_device * dev)
426 for (n_chans = 0; n_chans < 16; n_chans++) {
427 stat = dt2801_writecmd(dev, DT_C_READ_ADIM);
428 dt2801_writedata(dev, 0);
429 dt2801_writedata(dev, n_chans);
430 stat = dt2801_readdata2(dev, &data);
442 static const struct comedi_lrange *dac_range_table[] = {
450 static const struct comedi_lrange *dac_range_lkup(int opt)
452 if (opt < 0 || opt > 5)
453 return &range_unknown;
454 return dac_range_table[opt];
457 static const struct comedi_lrange *ai_range_lkup(int type, int opt)
462 &range_dt2801_ai_pgl_unipolar :
463 &range_dt2801_ai_pgl_bipolar;
465 return (opt) ? &range_unipolar10 : &range_bipolar10;
467 return &range_unipolar5;
469 return &range_unknown;
476 [2] - a/d 0=differential, 1=single-ended
477 [3] - a/d range 0=[-10,10], 1=[0,10]
478 [4] - dac0 range 0=[-10,10], 1=[-5,5], 2=[-2.5,2.5] 3=[0,10], 4=[0,5]
479 [5] - dac1 range 0=[-10,10], 1=[-5,5], 2=[-2.5,2.5] 3=[0,10], 4=[0,5]
481 static int dt2801_attach(struct comedi_device * dev, comedi_devconfig * it)
483 struct comedi_subdevice *s;
484 unsigned long iobase;
485 int board_code, type;
489 iobase = it->options[0];
490 if (!request_region(iobase, DT2801_IOSIZE, "dt2801")) {
491 comedi_error(dev, "I/O port conflict");
494 dev->iobase = iobase;
496 /* do some checking */
498 board_code = dt2801_reset(dev);
500 /* heh. if it didn't work, try it again. */
502 board_code = dt2801_reset(dev);
504 for (type = 0; type < n_boardtypes; type++) {
505 if (boardtypes[type].boardcode == board_code)
508 printk("dt2801: unrecognized board code=0x%02x, contact author\n",
513 dev->board_ptr = boardtypes + type;
514 printk("dt2801: %s at port 0x%lx", boardtype.name, iobase);
516 n_ai_chans = probe_number_of_ai_chans(dev);
517 printk(" (ai channels = %d)", n_ai_chans);
519 if ((ret = alloc_subdevices(dev, 4)) < 0)
522 if ((ret = alloc_private(dev, sizeof(dt2801_private))) < 0)
525 dev->board_name = boardtype.name;
527 s = dev->subdevices + 0;
529 s->type = COMEDI_SUBD_AI;
530 s->subdev_flags = SDF_READABLE | SDF_GROUND;
532 s->n_chan = n_ai_chans;
535 s->n_chan = boardtype.ad_chan;
537 s->n_chan = boardtype.ad_chan / 2;
539 s->maxdata = (1 << boardtype.adbits) - 1;
540 s->range_table = ai_range_lkup(boardtype.adrangetype, it->options[3]);
541 s->insn_read = dt2801_ai_insn_read;
545 s->type = COMEDI_SUBD_AO;
546 s->subdev_flags = SDF_WRITABLE;
548 s->maxdata = (1 << boardtype.dabits) - 1;
549 s->range_table_list = devpriv->dac_range_types;
550 devpriv->dac_range_types[0] = dac_range_lkup(it->options[4]);
551 devpriv->dac_range_types[1] = dac_range_lkup(it->options[5]);
552 s->insn_read = dt2801_ao_insn_read;
553 s->insn_write = dt2801_ao_insn_write;
556 /* 1st digital subdevice */
557 s->type = COMEDI_SUBD_DIO;
558 s->subdev_flags = SDF_READABLE | SDF_WRITABLE;
561 s->range_table = &range_digital;
562 s->insn_bits = dt2801_dio_insn_bits;
563 s->insn_config = dt2801_dio_insn_config;
566 /* 2nd digital subdevice */
567 s->type = COMEDI_SUBD_DIO;
568 s->subdev_flags = SDF_READABLE | SDF_WRITABLE;
571 s->range_table = &range_digital;
572 s->insn_bits = dt2801_dio_insn_bits;
573 s->insn_config = dt2801_dio_insn_config;
582 static int dt2801_detach(struct comedi_device * dev)
585 release_region(dev->iobase, DT2801_IOSIZE);
590 static int dt2801_error(struct comedi_device * dev, int stat)
593 if (stat == -ETIME) {
594 printk("dt2801: timeout\n");
596 printk("dt2801: error %d\n", stat);
600 printk("dt2801: error status 0x%02x, resetting...\n", stat);
608 static int dt2801_ai_insn_read(struct comedi_device * dev, struct comedi_subdevice * s,
609 comedi_insn * insn, unsigned int * data)
615 for (i = 0; i < insn->n; i++) {
616 stat = dt2801_writecmd(dev, DT_C_READ_ADIM);
617 dt2801_writedata(dev, CR_RANGE(insn->chanspec));
618 dt2801_writedata(dev, CR_CHAN(insn->chanspec));
619 stat = dt2801_readdata2(dev, &d);
622 return dt2801_error(dev, stat);
630 static int dt2801_ao_insn_read(struct comedi_device * dev, struct comedi_subdevice * s,
631 comedi_insn * insn, unsigned int * data)
633 data[0] = devpriv->ao_readback[CR_CHAN(insn->chanspec)];
638 static int dt2801_ao_insn_write(struct comedi_device * dev, struct comedi_subdevice * s,
639 comedi_insn * insn, unsigned int * data)
641 dt2801_writecmd(dev, DT_C_WRITE_DAIM);
642 dt2801_writedata(dev, CR_CHAN(insn->chanspec));
643 dt2801_writedata2(dev, data[0]);
645 devpriv->ao_readback[CR_CHAN(insn->chanspec)] = data[0];
650 static int dt2801_dio_insn_bits(struct comedi_device * dev, struct comedi_subdevice * s,
651 comedi_insn * insn, unsigned int * data)
655 if (s == dev->subdevices + 4)
661 s->state &= ~data[0];
662 s->state |= (data[0] & data[1]);
663 dt2801_writecmd(dev, DT_C_WRITE_DIG);
664 dt2801_writedata(dev, which);
665 dt2801_writedata(dev, s->state);
667 dt2801_writecmd(dev, DT_C_READ_DIG);
668 dt2801_writedata(dev, which);
669 dt2801_readdata(dev, data + 1);
674 static int dt2801_dio_insn_config(struct comedi_device * dev, struct comedi_subdevice * s,
675 comedi_insn * insn, unsigned int * data)
679 if (s == dev->subdevices + 4)
685 dt2801_writecmd(dev, DT_C_SET_DIGOUT);
688 dt2801_writecmd(dev, DT_C_SET_DIGIN);
690 dt2801_writedata(dev, which);