1 // SPDX-License-Identifier: GPL-2.0+
4 * Data Translation DT3000 series driver
6 * COMEDI - Linux Control and Measurement Device Interface
7 * Copyright (C) 1999 David A. Schleef <ds@schleef.org>
12 * Description: Data Translation DT3000 series
13 * Devices: [Data Translation] DT3001 (dt3000), DT3001-PGL, DT3002, DT3003,
14 * DT3003-PGL, DT3004, DT3005, DT3004-200
16 * Updated: Mon, 14 Apr 2008 15:41:24 +0100
19 * Configuration Options: not applicable, uses PCI auto config
21 * There is code to support AI commands, but it may not work.
23 * AO commands are not supported.
27 * The DT3000 series is Data Translation's attempt to make a PCI
28 * data acquisition board. The design of this series is very nice,
29 * since each board has an on-board DSP (Texas Instruments TMS320C52).
30 * However, a few details are a little annoying. The boards lack
31 * bus-mastering DMA, which eliminates them from serious work.
32 * They also are not capable of autocalibration, which is a common
33 * feature in modern hardware. The default firmware is pretty bad,
34 * making it nearly impossible to write an RT compatible driver.
35 * It would make an interesting project to write a decent firmware
38 * Data Translation originally wanted an NDA for the documentation
39 * for the 3k series. However, if you ask nicely, they might send
40 * you the docs without one, also.
43 #include <linux/module.h>
44 #include <linux/delay.h>
45 #include <linux/interrupt.h>
47 #include "../comedi_pci.h"
50 * PCI BAR0 - dual-ported RAM location definitions (dev->mmio)
52 #define DPR_DAC_BUFFER (4 * 0x000)
53 #define DPR_ADC_BUFFER (4 * 0x800)
54 #define DPR_COMMAND (4 * 0xfd3)
55 #define DPR_SUBSYS (4 * 0xfd3)
56 #define DPR_SUBSYS_AI 0
57 #define DPR_SUBSYS_AO 1
58 #define DPR_SUBSYS_DIN 2
59 #define DPR_SUBSYS_DOUT 3
60 #define DPR_SUBSYS_MEM 4
61 #define DPR_SUBSYS_CT 5
62 #define DPR_ENCODE (4 * 0xfd4)
63 #define DPR_PARAMS(x) (4 * (0xfd5 + (x)))
64 #define DPR_TICK_REG_LO (4 * 0xff5)
65 #define DPR_TICK_REG_HI (4 * 0xff6)
66 #define DPR_DA_BUF_FRONT (4 * 0xff7)
67 #define DPR_DA_BUF_REAR (4 * 0xff8)
68 #define DPR_AD_BUF_FRONT (4 * 0xff9)
69 #define DPR_AD_BUF_REAR (4 * 0xffa)
70 #define DPR_INT_MASK (4 * 0xffb)
71 #define DPR_INTR_FLAG (4 * 0xffc)
72 #define DPR_INTR_CMDONE BIT(7)
73 #define DPR_INTR_CTDONE BIT(6)
74 #define DPR_INTR_DAHWERR BIT(5)
75 #define DPR_INTR_DASWERR BIT(4)
76 #define DPR_INTR_DAEMPTY BIT(3)
77 #define DPR_INTR_ADHWERR BIT(2)
78 #define DPR_INTR_ADSWERR BIT(1)
79 #define DPR_INTR_ADFULL BIT(0)
80 #define DPR_RESPONSE_MBX (4 * 0xffe)
81 #define DPR_CMD_MBX (4 * 0xfff)
82 #define DPR_CMD_COMPLETION(x) ((x) << 8)
83 #define DPR_CMD_NOTPROCESSED DPR_CMD_COMPLETION(0x00)
84 #define DPR_CMD_NOERROR DPR_CMD_COMPLETION(0x55)
85 #define DPR_CMD_ERROR DPR_CMD_COMPLETION(0xaa)
86 #define DPR_CMD_NOTSUPPORTED DPR_CMD_COMPLETION(0xff)
87 #define DPR_CMD_COMPLETION_MASK DPR_CMD_COMPLETION(0xff)
88 #define DPR_CMD(x) ((x) << 0)
89 #define DPR_CMD_GETBRDINFO DPR_CMD(0)
90 #define DPR_CMD_CONFIG DPR_CMD(1)
91 #define DPR_CMD_GETCONFIG DPR_CMD(2)
92 #define DPR_CMD_START DPR_CMD(3)
93 #define DPR_CMD_STOP DPR_CMD(4)
94 #define DPR_CMD_READSINGLE DPR_CMD(5)
95 #define DPR_CMD_WRITESINGLE DPR_CMD(6)
96 #define DPR_CMD_CALCCLOCK DPR_CMD(7)
97 #define DPR_CMD_READEVENTS DPR_CMD(8)
98 #define DPR_CMD_WRITECTCTRL DPR_CMD(16)
99 #define DPR_CMD_READCTCTRL DPR_CMD(17)
100 #define DPR_CMD_WRITECT DPR_CMD(18)
101 #define DPR_CMD_READCT DPR_CMD(19)
102 #define DPR_CMD_WRITEDATA DPR_CMD(32)
103 #define DPR_CMD_READDATA DPR_CMD(33)
104 #define DPR_CMD_WRITEIO DPR_CMD(34)
105 #define DPR_CMD_READIO DPR_CMD(35)
106 #define DPR_CMD_WRITECODE DPR_CMD(36)
107 #define DPR_CMD_READCODE DPR_CMD(37)
108 #define DPR_CMD_EXECUTE DPR_CMD(38)
109 #define DPR_CMD_HALT DPR_CMD(48)
110 #define DPR_CMD_MASK DPR_CMD(0xff)
112 #define DPR_PARAM5_AD_TRIG(x) (((x) & 0x7) << 2)
113 #define DPR_PARAM5_AD_TRIG_INT DPR_PARAM5_AD_TRIG(0)
114 #define DPR_PARAM5_AD_TRIG_EXT DPR_PARAM5_AD_TRIG(1)
115 #define DPR_PARAM5_AD_TRIG_INT_RETRIG DPR_PARAM5_AD_TRIG(2)
116 #define DPR_PARAM5_AD_TRIG_EXT_RETRIG DPR_PARAM5_AD_TRIG(3)
117 #define DPR_PARAM5_AD_TRIG_INT_RETRIG2 DPR_PARAM5_AD_TRIG(4)
119 #define DPR_PARAM6_AD_DIFF BIT(0)
121 #define DPR_AI_FIFO_DEPTH 2003
122 #define DPR_AO_FIFO_DEPTH 2048
124 #define DPR_EXTERNAL_CLOCK 1
125 #define DPR_RISING_EDGE 2
127 #define DPR_TMODE_MASK 0x1c
129 #define DPR_CMD_TIMEOUT 100
131 static const struct comedi_lrange range_dt3000_ai = {
140 static const struct comedi_lrange range_dt3000_ai_pgl = {
159 struct dt3k_boardtype {
163 const struct comedi_lrange *adrange;
164 unsigned int ai_is_16bit:1;
165 unsigned int has_ao:1;
168 static const struct dt3k_boardtype dt3k_boardtypes[] = {
172 .adrange = &range_dt3000_ai,
176 [BOARD_DT3001_PGL] = {
177 .name = "dt3001-pgl",
179 .adrange = &range_dt3000_ai_pgl,
186 .adrange = &range_dt3000_ai,
192 .adrange = &range_dt3000_ai,
196 [BOARD_DT3003_PGL] = {
197 .name = "dt3003-pgl",
199 .adrange = &range_dt3000_ai_pgl,
206 .adrange = &range_dt3000_ai,
212 .name = "dt3005", /* a.k.a. 3004-200 */
214 .adrange = &range_dt3000_ai,
221 struct dt3k_private {
223 unsigned int ai_front;
224 unsigned int ai_rear;
227 static void dt3k_send_cmd(struct comedi_device *dev, unsigned int cmd)
230 unsigned int status = 0;
232 writew(cmd, dev->mmio + DPR_CMD_MBX);
234 for (i = 0; i < DPR_CMD_TIMEOUT; i++) {
235 status = readw(dev->mmio + DPR_CMD_MBX);
236 status &= DPR_CMD_COMPLETION_MASK;
237 if (status != DPR_CMD_NOTPROCESSED)
242 if (status != DPR_CMD_NOERROR)
243 dev_dbg(dev->class_dev, "%s: timeout/error status=0x%04x\n",
247 static unsigned int dt3k_readsingle(struct comedi_device *dev,
248 unsigned int subsys, unsigned int chan,
251 writew(subsys, dev->mmio + DPR_SUBSYS);
253 writew(chan, dev->mmio + DPR_PARAMS(0));
254 writew(gain, dev->mmio + DPR_PARAMS(1));
256 dt3k_send_cmd(dev, DPR_CMD_READSINGLE);
258 return readw(dev->mmio + DPR_PARAMS(2));
261 static void dt3k_writesingle(struct comedi_device *dev, unsigned int subsys,
262 unsigned int chan, unsigned int data)
264 writew(subsys, dev->mmio + DPR_SUBSYS);
266 writew(chan, dev->mmio + DPR_PARAMS(0));
267 writew(0, dev->mmio + DPR_PARAMS(1));
268 writew(data, dev->mmio + DPR_PARAMS(2));
270 dt3k_send_cmd(dev, DPR_CMD_WRITESINGLE);
273 static void dt3k_ai_empty_fifo(struct comedi_device *dev,
274 struct comedi_subdevice *s)
276 struct dt3k_private *devpriv = dev->private;
283 front = readw(dev->mmio + DPR_AD_BUF_FRONT);
284 count = front - devpriv->ai_front;
286 count += DPR_AI_FIFO_DEPTH;
288 rear = devpriv->ai_rear;
290 for (i = 0; i < count; i++) {
291 data = readw(dev->mmio + DPR_ADC_BUFFER + rear);
292 comedi_buf_write_samples(s, &data, 1);
294 if (rear >= DPR_AI_FIFO_DEPTH)
298 devpriv->ai_rear = rear;
299 writew(rear, dev->mmio + DPR_AD_BUF_REAR);
302 static int dt3k_ai_cancel(struct comedi_device *dev,
303 struct comedi_subdevice *s)
305 writew(DPR_SUBSYS_AI, dev->mmio + DPR_SUBSYS);
306 dt3k_send_cmd(dev, DPR_CMD_STOP);
308 writew(0, dev->mmio + DPR_INT_MASK);
313 static int debug_n_ints;
315 /* FIXME! Assumes shared interrupt is for this card. */
316 /* What's this debug_n_ints stuff? Obviously needs some work... */
317 static irqreturn_t dt3k_interrupt(int irq, void *d)
319 struct comedi_device *dev = d;
320 struct comedi_subdevice *s = dev->read_subdev;
326 status = readw(dev->mmio + DPR_INTR_FLAG);
328 if (status & DPR_INTR_ADFULL)
329 dt3k_ai_empty_fifo(dev, s);
331 if (status & (DPR_INTR_ADSWERR | DPR_INTR_ADHWERR))
332 s->async->events |= COMEDI_CB_ERROR;
335 if (debug_n_ints >= 10)
336 s->async->events |= COMEDI_CB_EOA;
338 comedi_handle_events(dev, s);
342 static int dt3k_ns_to_timer(unsigned int timer_base, unsigned int *nanosec,
345 int divider, base, prescale;
347 /* This function needs improvment */
348 /* Don't know if divider==0 works. */
350 for (prescale = 0; prescale < 16; prescale++) {
351 base = timer_base * (prescale + 1);
352 switch (flags & CMDF_ROUND_MASK) {
353 case CMDF_ROUND_NEAREST:
355 divider = DIV_ROUND_CLOSEST(*nanosec, base);
357 case CMDF_ROUND_DOWN:
358 divider = (*nanosec) / base;
361 divider = (*nanosec) / base;
364 if (divider < 65536) {
365 *nanosec = divider * base;
366 return (prescale << 16) | (divider);
371 base = timer_base * (1 << prescale);
373 *nanosec = divider * base;
374 return (prescale << 16) | (divider);
377 static int dt3k_ai_cmdtest(struct comedi_device *dev,
378 struct comedi_subdevice *s, struct comedi_cmd *cmd)
380 const struct dt3k_boardtype *board = dev->board_ptr;
384 /* Step 1 : check if triggers are trivially valid */
386 err |= comedi_check_trigger_src(&cmd->start_src, TRIG_NOW);
387 err |= comedi_check_trigger_src(&cmd->scan_begin_src, TRIG_TIMER);
388 err |= comedi_check_trigger_src(&cmd->convert_src, TRIG_TIMER);
389 err |= comedi_check_trigger_src(&cmd->scan_end_src, TRIG_COUNT);
390 err |= comedi_check_trigger_src(&cmd->stop_src, TRIG_COUNT);
395 /* Step 2a : make sure trigger sources are unique */
396 /* Step 2b : and mutually compatible */
398 /* Step 3: check if arguments are trivially valid */
400 err |= comedi_check_trigger_arg_is(&cmd->start_arg, 0);
402 if (cmd->scan_begin_src == TRIG_TIMER) {
403 err |= comedi_check_trigger_arg_min(&cmd->scan_begin_arg,
405 err |= comedi_check_trigger_arg_max(&cmd->scan_begin_arg,
409 if (cmd->convert_src == TRIG_TIMER) {
410 err |= comedi_check_trigger_arg_min(&cmd->convert_arg,
412 err |= comedi_check_trigger_arg_max(&cmd->convert_arg,
416 err |= comedi_check_trigger_arg_is(&cmd->scan_end_arg,
419 if (cmd->stop_src == TRIG_COUNT)
420 err |= comedi_check_trigger_arg_max(&cmd->stop_arg, 0x00ffffff);
422 err |= comedi_check_trigger_arg_is(&cmd->stop_arg, 0);
427 /* step 4: fix up any arguments */
429 if (cmd->scan_begin_src == TRIG_TIMER) {
430 arg = cmd->scan_begin_arg;
431 dt3k_ns_to_timer(100, &arg, cmd->flags);
432 err |= comedi_check_trigger_arg_is(&cmd->scan_begin_arg, arg);
435 if (cmd->convert_src == TRIG_TIMER) {
436 arg = cmd->convert_arg;
437 dt3k_ns_to_timer(50, &arg, cmd->flags);
438 err |= comedi_check_trigger_arg_is(&cmd->convert_arg, arg);
440 if (cmd->scan_begin_src == TRIG_TIMER) {
441 arg = cmd->convert_arg * cmd->scan_end_arg;
442 err |= comedi_check_trigger_arg_min(&cmd->
454 static int dt3k_ai_cmd(struct comedi_device *dev, struct comedi_subdevice *s)
456 struct comedi_cmd *cmd = &s->async->cmd;
458 unsigned int chan, range, aref;
459 unsigned int divider;
460 unsigned int tscandiv;
462 for (i = 0; i < cmd->chanlist_len; i++) {
463 chan = CR_CHAN(cmd->chanlist[i]);
464 range = CR_RANGE(cmd->chanlist[i]);
466 writew((range << 6) | chan, dev->mmio + DPR_ADC_BUFFER + i);
468 aref = CR_AREF(cmd->chanlist[0]);
470 writew(cmd->scan_end_arg, dev->mmio + DPR_PARAMS(0));
472 if (cmd->convert_src == TRIG_TIMER) {
473 divider = dt3k_ns_to_timer(50, &cmd->convert_arg, cmd->flags);
474 writew((divider >> 16), dev->mmio + DPR_PARAMS(1));
475 writew((divider & 0xffff), dev->mmio + DPR_PARAMS(2));
478 if (cmd->scan_begin_src == TRIG_TIMER) {
479 tscandiv = dt3k_ns_to_timer(100, &cmd->scan_begin_arg,
481 writew((tscandiv >> 16), dev->mmio + DPR_PARAMS(3));
482 writew((tscandiv & 0xffff), dev->mmio + DPR_PARAMS(4));
485 writew(DPR_PARAM5_AD_TRIG_INT_RETRIG, dev->mmio + DPR_PARAMS(5));
486 writew((aref == AREF_DIFF) ? DPR_PARAM6_AD_DIFF : 0,
487 dev->mmio + DPR_PARAMS(6));
489 writew(DPR_AI_FIFO_DEPTH / 2, dev->mmio + DPR_PARAMS(7));
491 writew(DPR_SUBSYS_AI, dev->mmio + DPR_SUBSYS);
492 dt3k_send_cmd(dev, DPR_CMD_CONFIG);
494 writew(DPR_INTR_ADFULL | DPR_INTR_ADSWERR | DPR_INTR_ADHWERR,
495 dev->mmio + DPR_INT_MASK);
499 writew(DPR_SUBSYS_AI, dev->mmio + DPR_SUBSYS);
500 dt3k_send_cmd(dev, DPR_CMD_START);
505 static int dt3k_ai_insn_read(struct comedi_device *dev,
506 struct comedi_subdevice *s,
507 struct comedi_insn *insn,
511 unsigned int chan, gain, aref;
513 chan = CR_CHAN(insn->chanspec);
514 gain = CR_RANGE(insn->chanspec);
515 /* XXX docs don't explain how to select aref */
516 aref = CR_AREF(insn->chanspec);
518 for (i = 0; i < insn->n; i++)
519 data[i] = dt3k_readsingle(dev, DPR_SUBSYS_AI, chan, gain);
524 static int dt3k_ao_insn_write(struct comedi_device *dev,
525 struct comedi_subdevice *s,
526 struct comedi_insn *insn,
529 unsigned int chan = CR_CHAN(insn->chanspec);
530 unsigned int val = s->readback[chan];
533 for (i = 0; i < insn->n; i++) {
535 dt3k_writesingle(dev, DPR_SUBSYS_AO, chan, val);
537 s->readback[chan] = val;
542 static void dt3k_dio_config(struct comedi_device *dev, int bits)
545 writew(DPR_SUBSYS_DOUT, dev->mmio + DPR_SUBSYS);
547 writew(bits, dev->mmio + DPR_PARAMS(0));
549 /* XXX write 0 to DPR_PARAMS(1) and DPR_PARAMS(2) ? */
551 dt3k_send_cmd(dev, DPR_CMD_CONFIG);
554 static int dt3k_dio_insn_config(struct comedi_device *dev,
555 struct comedi_subdevice *s,
556 struct comedi_insn *insn,
559 unsigned int chan = CR_CHAN(insn->chanspec);
568 ret = comedi_dio_insn_config(dev, s, insn, data, mask);
572 dt3k_dio_config(dev, (s->io_bits & 0x01) | ((s->io_bits & 0x10) >> 3));
577 static int dt3k_dio_insn_bits(struct comedi_device *dev,
578 struct comedi_subdevice *s,
579 struct comedi_insn *insn,
582 if (comedi_dio_update_state(s, data))
583 dt3k_writesingle(dev, DPR_SUBSYS_DOUT, 0, s->state);
585 data[1] = dt3k_readsingle(dev, DPR_SUBSYS_DIN, 0, 0);
590 static int dt3k_mem_insn_read(struct comedi_device *dev,
591 struct comedi_subdevice *s,
592 struct comedi_insn *insn,
595 unsigned int addr = CR_CHAN(insn->chanspec);
598 for (i = 0; i < insn->n; i++) {
599 writew(DPR_SUBSYS_MEM, dev->mmio + DPR_SUBSYS);
600 writew(addr, dev->mmio + DPR_PARAMS(0));
601 writew(1, dev->mmio + DPR_PARAMS(1));
603 dt3k_send_cmd(dev, DPR_CMD_READCODE);
605 data[i] = readw(dev->mmio + DPR_PARAMS(2));
611 static int dt3000_auto_attach(struct comedi_device *dev,
612 unsigned long context)
614 struct pci_dev *pcidev = comedi_to_pci_dev(dev);
615 const struct dt3k_boardtype *board = NULL;
616 struct dt3k_private *devpriv;
617 struct comedi_subdevice *s;
620 if (context < ARRAY_SIZE(dt3k_boardtypes))
621 board = &dt3k_boardtypes[context];
624 dev->board_ptr = board;
625 dev->board_name = board->name;
627 devpriv = comedi_alloc_devpriv(dev, sizeof(*devpriv));
631 ret = comedi_pci_enable(dev);
635 dev->mmio = pci_ioremap_bar(pcidev, 0);
640 ret = request_irq(pcidev->irq, dt3k_interrupt, IRQF_SHARED,
641 dev->board_name, dev);
643 dev->irq = pcidev->irq;
646 ret = comedi_alloc_subdevices(dev, 4);
650 /* Analog Input subdevice */
651 s = &dev->subdevices[0];
652 s->type = COMEDI_SUBD_AI;
653 s->subdev_flags = SDF_READABLE | SDF_GROUND | SDF_DIFF;
654 s->n_chan = board->adchan;
655 s->maxdata = board->ai_is_16bit ? 0xffff : 0x0fff;
656 s->range_table = &range_dt3000_ai; /* XXX */
657 s->insn_read = dt3k_ai_insn_read;
659 dev->read_subdev = s;
660 s->subdev_flags |= SDF_CMD_READ;
661 s->len_chanlist = 512;
662 s->do_cmd = dt3k_ai_cmd;
663 s->do_cmdtest = dt3k_ai_cmdtest;
664 s->cancel = dt3k_ai_cancel;
667 /* Analog Output subdevice */
668 s = &dev->subdevices[1];
670 s->type = COMEDI_SUBD_AO;
671 s->subdev_flags = SDF_WRITABLE;
674 s->range_table = &range_bipolar10;
675 s->insn_write = dt3k_ao_insn_write;
677 ret = comedi_alloc_subdev_readback(s);
682 s->type = COMEDI_SUBD_UNUSED;
685 /* Digital I/O subdevice */
686 s = &dev->subdevices[2];
687 s->type = COMEDI_SUBD_DIO;
688 s->subdev_flags = SDF_READABLE | SDF_WRITABLE;
691 s->range_table = &range_digital;
692 s->insn_config = dt3k_dio_insn_config;
693 s->insn_bits = dt3k_dio_insn_bits;
695 /* Memory subdevice */
696 s = &dev->subdevices[3];
697 s->type = COMEDI_SUBD_MEMORY;
698 s->subdev_flags = SDF_READABLE;
701 s->range_table = &range_unknown;
702 s->insn_read = dt3k_mem_insn_read;
707 static struct comedi_driver dt3000_driver = {
708 .driver_name = "dt3000",
709 .module = THIS_MODULE,
710 .auto_attach = dt3000_auto_attach,
711 .detach = comedi_pci_detach,
714 static int dt3000_pci_probe(struct pci_dev *dev,
715 const struct pci_device_id *id)
717 return comedi_pci_auto_config(dev, &dt3000_driver, id->driver_data);
720 static const struct pci_device_id dt3000_pci_table[] = {
721 { PCI_VDEVICE(DT, 0x0022), BOARD_DT3001 },
722 { PCI_VDEVICE(DT, 0x0023), BOARD_DT3002 },
723 { PCI_VDEVICE(DT, 0x0024), BOARD_DT3003 },
724 { PCI_VDEVICE(DT, 0x0025), BOARD_DT3004 },
725 { PCI_VDEVICE(DT, 0x0026), BOARD_DT3005 },
726 { PCI_VDEVICE(DT, 0x0027), BOARD_DT3001_PGL },
727 { PCI_VDEVICE(DT, 0x0028), BOARD_DT3003_PGL },
730 MODULE_DEVICE_TABLE(pci, dt3000_pci_table);
732 static struct pci_driver dt3000_pci_driver = {
734 .id_table = dt3000_pci_table,
735 .probe = dt3000_pci_probe,
736 .remove = comedi_pci_auto_unconfig,
738 module_comedi_pci_driver(dt3000_driver, dt3000_pci_driver);
740 MODULE_AUTHOR("Comedi http://www.comedi.org");
741 MODULE_DESCRIPTION("Comedi driver for Data Translation DT3000 series boards");
742 MODULE_LICENSE("GPL");