1 // SPDX-License-Identifier: GPL-2.0+
4 * Comedi driver for Data Translation DT2821 series
6 * COMEDI - Linux Control and Measurement Device Interface
7 * Copyright (C) 1997-8 David A. Schleef <ds@schleef.org>
12 * Description: Data Translation DT2821 series (including DT-EZ)
14 * Devices: [Data Translation] DT2821 (dt2821), DT2821-F-16SE (dt2821-f),
15 * DT2821-F-8DI (dt2821-f), DT2821-G-16SE (dt2821-g),
16 * DT2821-G-8DI (dt2821-g), DT2823 (dt2823), DT2824-PGH (dt2824-pgh),
17 * DT2824-PGL (dt2824-pgl), DT2825 (dt2825), DT2827 (dt2827),
18 * DT2828 (dt2828), DT2928 (dt2829), DT21-EZ (dt21-ez), DT23-EZ (dt23-ez),
19 * DT24-EZ (dt24-ez), DT24-EZ-PGL (dt24-ez-pgl)
21 * Updated: Wed, 22 Aug 2001 17:11:34 -0700
23 * Configuration options:
24 * [0] - I/O port base address
25 * [1] - IRQ (optional, required for async command support)
26 * [2] - DMA 1 (optional, required for async command support)
27 * [3] - DMA 2 (optional, required for async command support)
28 * [4] - AI jumpered for 0=single ended, 1=differential
29 * [5] - AI jumpered for 0=straight binary, 1=2's complement
30 * [6] - AO 0 data format (deprecated, see below)
31 * [7] - AO 1 data format (deprecated, see below)
32 * [8] - AI jumpered for 0=[-10,10]V, 1=[0,10], 2=[-5,5], 3=[0,5]
33 * [9] - AO channel 0 range (deprecated, see below)
34 * [10]- AO channel 1 range (deprecated, see below)
37 * - AO commands might be broken.
38 * - If you try to run a command on both the AI and AO subdevices
39 * simultaneously, bad things will happen. The driver needs to
40 * be fixed to check for this situation and return an error.
41 * - AO range is not programmable. The AO subdevice has a range_table
42 * containing all the possible analog output ranges. Use the range
43 * that matches your board configuration to convert between data
44 * values and physical units. The format of the data written to the
45 * board is handled automatically based on the unipolar/bipolar
46 * range that is selected.
49 #include <linux/module.h>
50 #include <linux/delay.h>
51 #include <linux/gfp.h>
52 #include <linux/interrupt.h>
55 #include "../comedidev.h"
57 #include "comedi_isadma.h"
62 #define DT2821_ADCSR_REG 0x00
63 #define DT2821_ADCSR_ADERR BIT(15)
64 #define DT2821_ADCSR_ADCLK BIT(9)
65 #define DT2821_ADCSR_MUXBUSY BIT(8)
66 #define DT2821_ADCSR_ADDONE BIT(7)
67 #define DT2821_ADCSR_IADDONE BIT(6)
68 #define DT2821_ADCSR_GS(x) (((x) & 0x3) << 4)
69 #define DT2821_ADCSR_CHAN(x) (((x) & 0xf) << 0)
70 #define DT2821_CHANCSR_REG 0x02
71 #define DT2821_CHANCSR_LLE BIT(15)
72 #define DT2821_CHANCSR_TO_PRESLA(x) (((x) >> 8) & 0xf)
73 #define DT2821_CHANCSR_NUMB(x) ((((x) - 1) & 0xf) << 0)
74 #define DT2821_ADDAT_REG 0x04
75 #define DT2821_DACSR_REG 0x06
76 #define DT2821_DACSR_DAERR BIT(15)
77 #define DT2821_DACSR_YSEL(x) ((x) << 9)
78 #define DT2821_DACSR_SSEL BIT(8)
79 #define DT2821_DACSR_DACRDY BIT(7)
80 #define DT2821_DACSR_IDARDY BIT(6)
81 #define DT2821_DACSR_DACLK BIT(5)
82 #define DT2821_DACSR_HBOE BIT(1)
83 #define DT2821_DACSR_LBOE BIT(0)
84 #define DT2821_DADAT_REG 0x08
85 #define DT2821_DIODAT_REG 0x0a
86 #define DT2821_SUPCSR_REG 0x0c
87 #define DT2821_SUPCSR_DMAD BIT(15)
88 #define DT2821_SUPCSR_ERRINTEN BIT(14)
89 #define DT2821_SUPCSR_CLRDMADNE BIT(13)
90 #define DT2821_SUPCSR_DDMA BIT(12)
91 #define DT2821_SUPCSR_DS(x) (((x) & 0x3) << 10)
92 #define DT2821_SUPCSR_DS_PIO DT2821_SUPCSR_DS(0)
93 #define DT2821_SUPCSR_DS_AD_CLK DT2821_SUPCSR_DS(1)
94 #define DT2821_SUPCSR_DS_DA_CLK DT2821_SUPCSR_DS(2)
95 #define DT2821_SUPCSR_DS_AD_TRIG DT2821_SUPCSR_DS(3)
96 #define DT2821_SUPCSR_BUFFB BIT(9)
97 #define DT2821_SUPCSR_SCDN BIT(8)
98 #define DT2821_SUPCSR_DACON BIT(7)
99 #define DT2821_SUPCSR_ADCINIT BIT(6)
100 #define DT2821_SUPCSR_DACINIT BIT(5)
101 #define DT2821_SUPCSR_PRLD BIT(4)
102 #define DT2821_SUPCSR_STRIG BIT(3)
103 #define DT2821_SUPCSR_XTRIG BIT(2)
104 #define DT2821_SUPCSR_XCLK BIT(1)
105 #define DT2821_SUPCSR_BDINIT BIT(0)
106 #define DT2821_TMRCTR_REG 0x0e
107 #define DT2821_TMRCTR_PRESCALE(x) (((x) & 0xf) << 8)
108 #define DT2821_TMRCTR_DIVIDER(x) ((255 - ((x) & 0xff)) << 0)
111 #define DT2821_OSC_BASE 250 /* 4 MHz (in nanoseconds) */
112 #define DT2821_PRESCALE(x) BIT(x)
113 #define DT2821_PRESCALE_MAX 15
114 #define DT2821_DIVIDER_MAX 255
115 #define DT2821_OSC_MAX (DT2821_OSC_BASE * \
116 DT2821_PRESCALE(DT2821_PRESCALE_MAX) * \
119 static const struct comedi_lrange range_dt282x_ai_lo_bipolar = {
128 static const struct comedi_lrange range_dt282x_ai_lo_unipolar = {
137 static const struct comedi_lrange range_dt282x_ai_5_bipolar = {
146 static const struct comedi_lrange range_dt282x_ai_5_unipolar = {
155 static const struct comedi_lrange range_dt282x_ai_hi_bipolar = {
164 static const struct comedi_lrange range_dt282x_ai_hi_unipolar = {
174 * The Analog Output range is set per-channel using jumpers on the board.
175 * All of these ranges may not be available on some DT2821 series boards.
176 * The default jumper setting has both channels set for +/-10V output.
178 static const struct comedi_lrange dt282x_ao_range = {
188 struct dt282x_board {
190 unsigned int ai_maxdata;
196 unsigned int ao_maxdata;
199 static const struct dt282x_board boardtypes[] = {
202 .ai_maxdata = 0x0fff,
207 .ao_maxdata = 0x0fff,
210 .ai_maxdata = 0x0fff,
215 .ao_maxdata = 0x0fff,
218 .ai_maxdata = 0x0fff,
223 .ao_maxdata = 0x0fff,
226 .ai_maxdata = 0xffff,
230 .ao_maxdata = 0xffff,
232 .name = "dt2824-pgh",
233 .ai_maxdata = 0x0fff,
238 .name = "dt2824-pgl",
239 .ai_maxdata = 0x0fff,
246 .ai_maxdata = 0x0fff,
252 .ao_maxdata = 0x0fff,
255 .ai_maxdata = 0xffff,
259 .ao_maxdata = 0x0fff,
262 .ai_maxdata = 0x0fff,
266 .ao_maxdata = 0x0fff,
269 .ai_maxdata = 0xffff,
273 .ao_maxdata = 0xffff,
276 .ai_maxdata = 0x0fff,
281 .ao_maxdata = 0x0fff,
284 .ai_maxdata = 0xffff,
290 .ai_maxdata = 0x0fff,
295 .name = "dt24-ez-pgl",
296 .ai_maxdata = 0x0fff,
304 struct dt282x_private {
305 struct comedi_isadma *dma;
306 unsigned int ad_2scomp:1;
307 unsigned int divisor;
308 int dacsr; /* software copies of registers */
316 static int dt282x_prep_ai_dma(struct comedi_device *dev, int dma_index, int n)
318 struct dt282x_private *devpriv = dev->private;
319 struct comedi_isadma *dma = devpriv->dma;
320 struct comedi_isadma_desc *desc = &dma->desc[dma_index];
327 if (n > devpriv->ntrig * 2)
328 n = devpriv->ntrig * 2;
329 devpriv->ntrig -= n / 2;
332 comedi_isadma_set_mode(desc, devpriv->dma_dir);
334 comedi_isadma_program(desc);
339 static int dt282x_prep_ao_dma(struct comedi_device *dev, int dma_index, int n)
341 struct dt282x_private *devpriv = dev->private;
342 struct comedi_isadma *dma = devpriv->dma;
343 struct comedi_isadma_desc *desc = &dma->desc[dma_index];
346 comedi_isadma_set_mode(desc, devpriv->dma_dir);
348 comedi_isadma_program(desc);
353 static void dt282x_disable_dma(struct comedi_device *dev)
355 struct dt282x_private *devpriv = dev->private;
356 struct comedi_isadma *dma = devpriv->dma;
357 struct comedi_isadma_desc *desc;
360 for (i = 0; i < 2; i++) {
361 desc = &dma->desc[i];
362 comedi_isadma_disable(desc->chan);
366 static unsigned int dt282x_ns_to_timer(unsigned int *ns, unsigned int flags)
368 unsigned int prescale, base, divider;
370 for (prescale = 0; prescale <= DT2821_PRESCALE_MAX; prescale++) {
371 if (prescale == 1) /* 0 and 1 are both divide by 1 */
373 base = DT2821_OSC_BASE * DT2821_PRESCALE(prescale);
374 switch (flags & CMDF_ROUND_MASK) {
375 case CMDF_ROUND_NEAREST:
377 divider = DIV_ROUND_CLOSEST(*ns, base);
379 case CMDF_ROUND_DOWN:
380 divider = (*ns) / base;
383 divider = DIV_ROUND_UP(*ns, base);
386 if (divider <= DT2821_DIVIDER_MAX)
389 if (divider > DT2821_DIVIDER_MAX) {
390 prescale = DT2821_PRESCALE_MAX;
391 divider = DT2821_DIVIDER_MAX;
392 base = DT2821_OSC_BASE * DT2821_PRESCALE(prescale);
394 *ns = divider * base;
395 return DT2821_TMRCTR_PRESCALE(prescale) |
396 DT2821_TMRCTR_DIVIDER(divider);
399 static void dt282x_munge(struct comedi_device *dev,
400 struct comedi_subdevice *s,
404 struct dt282x_private *devpriv = dev->private;
409 dev_err(dev->class_dev,
410 "bug! odd number of bytes from dma xfer\n");
412 for (i = 0; i < nbytes / 2; i++) {
415 if (devpriv->ad_2scomp)
416 val = comedi_offset_munge(s, val);
422 static unsigned int dt282x_ao_setup_dma(struct comedi_device *dev,
423 struct comedi_subdevice *s,
426 struct dt282x_private *devpriv = dev->private;
427 struct comedi_isadma *dma = devpriv->dma;
428 struct comedi_isadma_desc *desc = &dma->desc[cur_dma];
429 unsigned int nsamples = comedi_bytes_to_samples(s, desc->maxsize);
432 nbytes = comedi_buf_read_samples(s, desc->virt_addr, nsamples);
434 dt282x_prep_ao_dma(dev, cur_dma, nbytes);
436 dev_err(dev->class_dev, "AO underrun\n");
441 static void dt282x_ao_dma_interrupt(struct comedi_device *dev,
442 struct comedi_subdevice *s)
444 struct dt282x_private *devpriv = dev->private;
445 struct comedi_isadma *dma = devpriv->dma;
446 struct comedi_isadma_desc *desc = &dma->desc[dma->cur_dma];
448 outw(devpriv->supcsr | DT2821_SUPCSR_CLRDMADNE,
449 dev->iobase + DT2821_SUPCSR_REG);
451 comedi_isadma_disable(desc->chan);
453 if (!dt282x_ao_setup_dma(dev, s, dma->cur_dma))
454 s->async->events |= COMEDI_CB_OVERFLOW;
456 dma->cur_dma = 1 - dma->cur_dma;
459 static void dt282x_ai_dma_interrupt(struct comedi_device *dev,
460 struct comedi_subdevice *s)
462 struct dt282x_private *devpriv = dev->private;
463 struct comedi_isadma *dma = devpriv->dma;
464 struct comedi_isadma_desc *desc = &dma->desc[dma->cur_dma];
465 unsigned int nsamples = comedi_bytes_to_samples(s, desc->size);
468 outw(devpriv->supcsr | DT2821_SUPCSR_CLRDMADNE,
469 dev->iobase + DT2821_SUPCSR_REG);
471 comedi_isadma_disable(desc->chan);
473 dt282x_munge(dev, s, desc->virt_addr, desc->size);
474 ret = comedi_buf_write_samples(s, desc->virt_addr, nsamples);
475 if (ret != desc->size)
478 devpriv->nread -= nsamples;
479 if (devpriv->nread < 0) {
480 dev_info(dev->class_dev, "nread off by one\n");
483 if (!devpriv->nread) {
484 s->async->events |= COMEDI_CB_EOA;
488 /* restart the channel */
489 dt282x_prep_ai_dma(dev, dma->cur_dma, 0);
491 dma->cur_dma = 1 - dma->cur_dma;
494 static irqreturn_t dt282x_interrupt(int irq, void *d)
496 struct comedi_device *dev = d;
497 struct dt282x_private *devpriv = dev->private;
498 struct comedi_subdevice *s = dev->read_subdev;
499 struct comedi_subdevice *s_ao = dev->write_subdev;
500 unsigned int supcsr, adcsr, dacsr;
503 if (!dev->attached) {
504 dev_err(dev->class_dev, "spurious interrupt\n");
508 adcsr = inw(dev->iobase + DT2821_ADCSR_REG);
509 dacsr = inw(dev->iobase + DT2821_DACSR_REG);
510 supcsr = inw(dev->iobase + DT2821_SUPCSR_REG);
511 if (supcsr & DT2821_SUPCSR_DMAD) {
512 if (devpriv->dma_dir == COMEDI_ISADMA_READ)
513 dt282x_ai_dma_interrupt(dev, s);
515 dt282x_ao_dma_interrupt(dev, s_ao);
518 if (adcsr & DT2821_ADCSR_ADERR) {
519 if (devpriv->nread != 0) {
520 dev_err(dev->class_dev, "A/D error\n");
521 s->async->events |= COMEDI_CB_ERROR;
525 if (dacsr & DT2821_DACSR_DAERR) {
526 dev_err(dev->class_dev, "D/A error\n");
527 s_ao->async->events |= COMEDI_CB_ERROR;
531 comedi_handle_events(dev, s);
533 comedi_handle_events(dev, s_ao);
535 return IRQ_RETVAL(handled);
538 static void dt282x_load_changain(struct comedi_device *dev, int n,
539 unsigned int *chanlist)
541 struct dt282x_private *devpriv = dev->private;
544 outw(DT2821_CHANCSR_LLE | DT2821_CHANCSR_NUMB(n),
545 dev->iobase + DT2821_CHANCSR_REG);
546 for (i = 0; i < n; i++) {
547 unsigned int chan = CR_CHAN(chanlist[i]);
548 unsigned int range = CR_RANGE(chanlist[i]);
550 outw(devpriv->adcsr |
551 DT2821_ADCSR_GS(range) |
552 DT2821_ADCSR_CHAN(chan),
553 dev->iobase + DT2821_ADCSR_REG);
555 outw(DT2821_CHANCSR_NUMB(n), dev->iobase + DT2821_CHANCSR_REG);
558 static int dt282x_ai_timeout(struct comedi_device *dev,
559 struct comedi_subdevice *s,
560 struct comedi_insn *insn,
561 unsigned long context)
565 status = inw(dev->iobase + DT2821_ADCSR_REG);
567 case DT2821_ADCSR_MUXBUSY:
568 if ((status & DT2821_ADCSR_MUXBUSY) == 0)
571 case DT2821_ADCSR_ADDONE:
572 if (status & DT2821_ADCSR_ADDONE)
582 * Performs a single A/D conversion.
583 * - Put channel/gain into channel-gain list
584 * - preload multiplexer
585 * - trigger conversion and wait for it to finish
587 static int dt282x_ai_insn_read(struct comedi_device *dev,
588 struct comedi_subdevice *s,
589 struct comedi_insn *insn,
592 struct dt282x_private *devpriv = dev->private;
597 /* XXX should we really be enabling the ad clock here? */
598 devpriv->adcsr = DT2821_ADCSR_ADCLK;
599 outw(devpriv->adcsr, dev->iobase + DT2821_ADCSR_REG);
601 dt282x_load_changain(dev, 1, &insn->chanspec);
603 outw(devpriv->supcsr | DT2821_SUPCSR_PRLD,
604 dev->iobase + DT2821_SUPCSR_REG);
605 ret = comedi_timeout(dev, s, insn,
606 dt282x_ai_timeout, DT2821_ADCSR_MUXBUSY);
610 for (i = 0; i < insn->n; i++) {
611 outw(devpriv->supcsr | DT2821_SUPCSR_STRIG,
612 dev->iobase + DT2821_SUPCSR_REG);
614 ret = comedi_timeout(dev, s, insn,
615 dt282x_ai_timeout, DT2821_ADCSR_ADDONE);
619 val = inw(dev->iobase + DT2821_ADDAT_REG);
621 if (devpriv->ad_2scomp)
622 val = comedi_offset_munge(s, val);
630 static int dt282x_ai_cmdtest(struct comedi_device *dev,
631 struct comedi_subdevice *s,
632 struct comedi_cmd *cmd)
634 const struct dt282x_board *board = dev->board_ptr;
635 struct dt282x_private *devpriv = dev->private;
639 /* Step 1 : check if triggers are trivially valid */
641 err |= comedi_check_trigger_src(&cmd->start_src, TRIG_NOW);
642 err |= comedi_check_trigger_src(&cmd->scan_begin_src,
643 TRIG_FOLLOW | TRIG_EXT);
644 err |= comedi_check_trigger_src(&cmd->convert_src, TRIG_TIMER);
645 err |= comedi_check_trigger_src(&cmd->scan_end_src, TRIG_COUNT);
646 err |= comedi_check_trigger_src(&cmd->stop_src, TRIG_COUNT | TRIG_NONE);
651 /* Step 2a : make sure trigger sources are unique */
653 err |= comedi_check_trigger_is_unique(cmd->scan_begin_src);
654 err |= comedi_check_trigger_is_unique(cmd->stop_src);
656 /* Step 2b : and mutually compatible */
661 /* Step 3: check if arguments are trivially valid */
663 err |= comedi_check_trigger_arg_is(&cmd->start_arg, 0);
664 err |= comedi_check_trigger_arg_is(&cmd->scan_begin_arg, 0);
665 err |= comedi_check_trigger_arg_max(&cmd->convert_arg, DT2821_OSC_MAX);
666 err |= comedi_check_trigger_arg_min(&cmd->convert_arg, board->ai_speed);
667 err |= comedi_check_trigger_arg_is(&cmd->scan_end_arg,
670 if (cmd->stop_src == TRIG_COUNT)
671 err |= comedi_check_trigger_arg_min(&cmd->stop_arg, 1);
672 else /* TRIG_EXT | TRIG_NONE */
673 err |= comedi_check_trigger_arg_is(&cmd->stop_arg, 0);
678 /* step 4: fix up any arguments */
680 arg = cmd->convert_arg;
681 devpriv->divisor = dt282x_ns_to_timer(&arg, cmd->flags);
682 err |= comedi_check_trigger_arg_is(&cmd->convert_arg, arg);
690 static int dt282x_ai_cmd(struct comedi_device *dev, struct comedi_subdevice *s)
692 struct dt282x_private *devpriv = dev->private;
693 struct comedi_isadma *dma = devpriv->dma;
694 struct comedi_cmd *cmd = &s->async->cmd;
697 dt282x_disable_dma(dev);
699 outw(devpriv->divisor, dev->iobase + DT2821_TMRCTR_REG);
701 devpriv->supcsr = DT2821_SUPCSR_ERRINTEN;
702 if (cmd->scan_begin_src == TRIG_FOLLOW)
703 devpriv->supcsr = DT2821_SUPCSR_DS_AD_CLK;
705 devpriv->supcsr = DT2821_SUPCSR_DS_AD_TRIG;
706 outw(devpriv->supcsr |
707 DT2821_SUPCSR_CLRDMADNE |
708 DT2821_SUPCSR_BUFFB |
709 DT2821_SUPCSR_ADCINIT,
710 dev->iobase + DT2821_SUPCSR_REG);
712 devpriv->ntrig = cmd->stop_arg * cmd->scan_end_arg;
713 devpriv->nread = devpriv->ntrig;
715 devpriv->dma_dir = COMEDI_ISADMA_READ;
717 dt282x_prep_ai_dma(dev, 0, 0);
718 if (devpriv->ntrig) {
719 dt282x_prep_ai_dma(dev, 1, 0);
720 devpriv->supcsr |= DT2821_SUPCSR_DDMA;
721 outw(devpriv->supcsr, dev->iobase + DT2821_SUPCSR_REG);
726 dt282x_load_changain(dev, cmd->chanlist_len, cmd->chanlist);
728 devpriv->adcsr = DT2821_ADCSR_ADCLK | DT2821_ADCSR_IADDONE;
729 outw(devpriv->adcsr, dev->iobase + DT2821_ADCSR_REG);
731 outw(devpriv->supcsr | DT2821_SUPCSR_PRLD,
732 dev->iobase + DT2821_SUPCSR_REG);
733 ret = comedi_timeout(dev, s, NULL,
734 dt282x_ai_timeout, DT2821_ADCSR_MUXBUSY);
738 if (cmd->scan_begin_src == TRIG_FOLLOW) {
739 outw(devpriv->supcsr | DT2821_SUPCSR_STRIG,
740 dev->iobase + DT2821_SUPCSR_REG);
742 devpriv->supcsr |= DT2821_SUPCSR_XTRIG;
743 outw(devpriv->supcsr, dev->iobase + DT2821_SUPCSR_REG);
749 static int dt282x_ai_cancel(struct comedi_device *dev,
750 struct comedi_subdevice *s)
752 struct dt282x_private *devpriv = dev->private;
754 dt282x_disable_dma(dev);
757 outw(devpriv->adcsr, dev->iobase + DT2821_ADCSR_REG);
760 outw(devpriv->supcsr | DT2821_SUPCSR_ADCINIT,
761 dev->iobase + DT2821_SUPCSR_REG);
766 static int dt282x_ao_insn_write(struct comedi_device *dev,
767 struct comedi_subdevice *s,
768 struct comedi_insn *insn,
771 struct dt282x_private *devpriv = dev->private;
772 unsigned int chan = CR_CHAN(insn->chanspec);
773 unsigned int range = CR_RANGE(insn->chanspec);
776 devpriv->dacsr |= DT2821_DACSR_SSEL | DT2821_DACSR_YSEL(chan);
778 for (i = 0; i < insn->n; i++) {
779 unsigned int val = data[i];
781 s->readback[chan] = val;
783 if (comedi_range_is_bipolar(s, range))
784 val = comedi_offset_munge(s, val);
786 outw(devpriv->dacsr, dev->iobase + DT2821_DACSR_REG);
788 outw(val, dev->iobase + DT2821_DADAT_REG);
790 outw(devpriv->supcsr | DT2821_SUPCSR_DACON,
791 dev->iobase + DT2821_SUPCSR_REG);
797 static int dt282x_ao_cmdtest(struct comedi_device *dev,
798 struct comedi_subdevice *s,
799 struct comedi_cmd *cmd)
801 struct dt282x_private *devpriv = dev->private;
805 /* Step 1 : check if triggers are trivially valid */
807 err |= comedi_check_trigger_src(&cmd->start_src, TRIG_INT);
808 err |= comedi_check_trigger_src(&cmd->scan_begin_src, TRIG_TIMER);
809 err |= comedi_check_trigger_src(&cmd->convert_src, TRIG_NOW);
810 err |= comedi_check_trigger_src(&cmd->scan_end_src, TRIG_COUNT);
811 err |= comedi_check_trigger_src(&cmd->stop_src, TRIG_COUNT | TRIG_NONE);
816 /* Step 2a : make sure trigger sources are unique */
818 err |= comedi_check_trigger_is_unique(cmd->stop_src);
820 /* Step 2b : and mutually compatible */
825 /* Step 3: check if arguments are trivially valid */
827 err |= comedi_check_trigger_arg_is(&cmd->start_arg, 0);
828 err |= comedi_check_trigger_arg_min(&cmd->scan_begin_arg, 5000);
829 err |= comedi_check_trigger_arg_is(&cmd->convert_arg, 0);
830 err |= comedi_check_trigger_arg_is(&cmd->scan_end_arg,
833 if (cmd->stop_src == TRIG_COUNT)
834 err |= comedi_check_trigger_arg_min(&cmd->stop_arg, 1);
835 else /* TRIG_EXT | TRIG_NONE */
836 err |= comedi_check_trigger_arg_is(&cmd->stop_arg, 0);
841 /* step 4: fix up any arguments */
843 arg = cmd->scan_begin_arg;
844 devpriv->divisor = dt282x_ns_to_timer(&arg, cmd->flags);
845 err |= comedi_check_trigger_arg_is(&cmd->scan_begin_arg, arg);
853 static int dt282x_ao_inttrig(struct comedi_device *dev,
854 struct comedi_subdevice *s,
855 unsigned int trig_num)
857 struct dt282x_private *devpriv = dev->private;
858 struct comedi_cmd *cmd = &s->async->cmd;
860 if (trig_num != cmd->start_src)
863 if (!dt282x_ao_setup_dma(dev, s, 0))
866 if (!dt282x_ao_setup_dma(dev, s, 1))
869 outw(devpriv->supcsr | DT2821_SUPCSR_STRIG,
870 dev->iobase + DT2821_SUPCSR_REG);
871 s->async->inttrig = NULL;
876 static int dt282x_ao_cmd(struct comedi_device *dev, struct comedi_subdevice *s)
878 struct dt282x_private *devpriv = dev->private;
879 struct comedi_isadma *dma = devpriv->dma;
880 struct comedi_cmd *cmd = &s->async->cmd;
882 dt282x_disable_dma(dev);
884 devpriv->supcsr = DT2821_SUPCSR_ERRINTEN |
885 DT2821_SUPCSR_DS_DA_CLK |
887 outw(devpriv->supcsr |
888 DT2821_SUPCSR_CLRDMADNE |
889 DT2821_SUPCSR_BUFFB |
890 DT2821_SUPCSR_DACINIT,
891 dev->iobase + DT2821_SUPCSR_REG);
893 devpriv->ntrig = cmd->stop_arg * cmd->chanlist_len;
894 devpriv->nread = devpriv->ntrig;
896 devpriv->dma_dir = COMEDI_ISADMA_WRITE;
899 outw(devpriv->divisor, dev->iobase + DT2821_TMRCTR_REG);
901 /* clear all bits but the DIO direction bits */
902 devpriv->dacsr &= (DT2821_DACSR_LBOE | DT2821_DACSR_HBOE);
904 devpriv->dacsr |= (DT2821_DACSR_SSEL |
906 DT2821_DACSR_IDARDY);
907 outw(devpriv->dacsr, dev->iobase + DT2821_DACSR_REG);
909 s->async->inttrig = dt282x_ao_inttrig;
914 static int dt282x_ao_cancel(struct comedi_device *dev,
915 struct comedi_subdevice *s)
917 struct dt282x_private *devpriv = dev->private;
919 dt282x_disable_dma(dev);
921 /* clear all bits but the DIO direction bits */
922 devpriv->dacsr &= (DT2821_DACSR_LBOE | DT2821_DACSR_HBOE);
924 outw(devpriv->dacsr, dev->iobase + DT2821_DACSR_REG);
927 outw(devpriv->supcsr | DT2821_SUPCSR_DACINIT,
928 dev->iobase + DT2821_SUPCSR_REG);
933 static int dt282x_dio_insn_bits(struct comedi_device *dev,
934 struct comedi_subdevice *s,
935 struct comedi_insn *insn,
938 if (comedi_dio_update_state(s, data))
939 outw(s->state, dev->iobase + DT2821_DIODAT_REG);
941 data[1] = inw(dev->iobase + DT2821_DIODAT_REG);
946 static int dt282x_dio_insn_config(struct comedi_device *dev,
947 struct comedi_subdevice *s,
948 struct comedi_insn *insn,
951 struct dt282x_private *devpriv = dev->private;
952 unsigned int chan = CR_CHAN(insn->chanspec);
961 ret = comedi_dio_insn_config(dev, s, insn, data, mask);
965 devpriv->dacsr &= ~(DT2821_DACSR_LBOE | DT2821_DACSR_HBOE);
966 if (s->io_bits & 0x00ff)
967 devpriv->dacsr |= DT2821_DACSR_LBOE;
968 if (s->io_bits & 0xff00)
969 devpriv->dacsr |= DT2821_DACSR_HBOE;
971 outw(devpriv->dacsr, dev->iobase + DT2821_DACSR_REG);
976 static const struct comedi_lrange *const ai_range_table[] = {
977 &range_dt282x_ai_lo_bipolar,
978 &range_dt282x_ai_lo_unipolar,
979 &range_dt282x_ai_5_bipolar,
980 &range_dt282x_ai_5_unipolar
983 static const struct comedi_lrange *const ai_range_pgl_table[] = {
984 &range_dt282x_ai_hi_bipolar,
985 &range_dt282x_ai_hi_unipolar
988 static const struct comedi_lrange *opt_ai_range_lkup(int ispgl, int x)
993 return ai_range_pgl_table[x];
998 return ai_range_table[x];
1001 static void dt282x_alloc_dma(struct comedi_device *dev,
1002 struct comedi_devconfig *it)
1004 struct dt282x_private *devpriv = dev->private;
1005 unsigned int irq_num = it->options[1];
1006 unsigned int dma_chan[2];
1008 if (it->options[2] < it->options[3]) {
1009 dma_chan[0] = it->options[2];
1010 dma_chan[1] = it->options[3];
1012 dma_chan[0] = it->options[3];
1013 dma_chan[1] = it->options[2];
1016 if (!irq_num || dma_chan[0] == dma_chan[1] ||
1017 dma_chan[0] < 5 || dma_chan[0] > 7 ||
1018 dma_chan[1] < 5 || dma_chan[1] > 7)
1021 if (request_irq(irq_num, dt282x_interrupt, 0, dev->board_name, dev))
1024 /* DMA uses two 4K buffers with separate DMA channels */
1025 devpriv->dma = comedi_isadma_alloc(dev, 2, dma_chan[0], dma_chan[1],
1028 free_irq(irq_num, dev);
1033 static void dt282x_free_dma(struct comedi_device *dev)
1035 struct dt282x_private *devpriv = dev->private;
1038 comedi_isadma_free(devpriv->dma);
1041 static int dt282x_initialize(struct comedi_device *dev)
1043 /* Initialize board */
1044 outw(DT2821_SUPCSR_BDINIT, dev->iobase + DT2821_SUPCSR_REG);
1045 inw(dev->iobase + DT2821_ADCSR_REG);
1048 * At power up, some registers are in a well-known state.
1049 * Check them to see if a DT2821 series board is present.
1051 if (((inw(dev->iobase + DT2821_ADCSR_REG) & 0xfff0) != 0x7c00) ||
1052 ((inw(dev->iobase + DT2821_CHANCSR_REG) & 0xf0f0) != 0x70f0) ||
1053 ((inw(dev->iobase + DT2821_DACSR_REG) & 0x7c93) != 0x7c90) ||
1054 ((inw(dev->iobase + DT2821_SUPCSR_REG) & 0xf8ff) != 0x0000) ||
1055 ((inw(dev->iobase + DT2821_TMRCTR_REG) & 0xff00) != 0xf000)) {
1056 dev_err(dev->class_dev, "board not found\n");
1062 static int dt282x_attach(struct comedi_device *dev, struct comedi_devconfig *it)
1064 const struct dt282x_board *board = dev->board_ptr;
1065 struct dt282x_private *devpriv;
1066 struct comedi_subdevice *s;
1069 ret = comedi_request_region(dev, it->options[0], 0x10);
1073 ret = dt282x_initialize(dev);
1077 devpriv = comedi_alloc_devpriv(dev, sizeof(*devpriv));
1081 /* an IRQ and 2 DMA channels are required for async command support */
1082 dt282x_alloc_dma(dev, it);
1084 ret = comedi_alloc_subdevices(dev, 3);
1088 /* Analog Input subdevice */
1089 s = &dev->subdevices[0];
1090 s->type = COMEDI_SUBD_AI;
1091 s->subdev_flags = SDF_READABLE;
1092 if ((it->options[4] && board->adchan_di) || board->adchan_se == 0) {
1093 s->subdev_flags |= SDF_DIFF;
1094 s->n_chan = board->adchan_di;
1096 s->subdev_flags |= SDF_COMMON;
1097 s->n_chan = board->adchan_se;
1099 s->maxdata = board->ai_maxdata;
1101 s->range_table = opt_ai_range_lkup(board->ispgl, it->options[8]);
1102 devpriv->ad_2scomp = it->options[5] ? 1 : 0;
1104 s->insn_read = dt282x_ai_insn_read;
1106 dev->read_subdev = s;
1107 s->subdev_flags |= SDF_CMD_READ;
1108 s->len_chanlist = s->n_chan;
1109 s->do_cmdtest = dt282x_ai_cmdtest;
1110 s->do_cmd = dt282x_ai_cmd;
1111 s->cancel = dt282x_ai_cancel;
1114 /* Analog Output subdevice */
1115 s = &dev->subdevices[1];
1116 if (board->dachan) {
1117 s->type = COMEDI_SUBD_AO;
1118 s->subdev_flags = SDF_WRITABLE;
1119 s->n_chan = board->dachan;
1120 s->maxdata = board->ao_maxdata;
1121 /* ranges are per-channel, set by jumpers on the board */
1122 s->range_table = &dt282x_ao_range;
1123 s->insn_write = dt282x_ao_insn_write;
1125 dev->write_subdev = s;
1126 s->subdev_flags |= SDF_CMD_WRITE;
1127 s->len_chanlist = s->n_chan;
1128 s->do_cmdtest = dt282x_ao_cmdtest;
1129 s->do_cmd = dt282x_ao_cmd;
1130 s->cancel = dt282x_ao_cancel;
1133 ret = comedi_alloc_subdev_readback(s);
1137 s->type = COMEDI_SUBD_UNUSED;
1140 /* Digital I/O subdevice */
1141 s = &dev->subdevices[2];
1142 s->type = COMEDI_SUBD_DIO;
1143 s->subdev_flags = SDF_READABLE | SDF_WRITABLE;
1146 s->range_table = &range_digital;
1147 s->insn_bits = dt282x_dio_insn_bits;
1148 s->insn_config = dt282x_dio_insn_config;
1153 static void dt282x_detach(struct comedi_device *dev)
1155 dt282x_free_dma(dev);
1156 comedi_legacy_detach(dev);
1159 static struct comedi_driver dt282x_driver = {
1160 .driver_name = "dt282x",
1161 .module = THIS_MODULE,
1162 .attach = dt282x_attach,
1163 .detach = dt282x_detach,
1164 .board_name = &boardtypes[0].name,
1165 .num_names = ARRAY_SIZE(boardtypes),
1166 .offset = sizeof(struct dt282x_board),
1168 module_comedi_driver(dt282x_driver);
1170 MODULE_AUTHOR("Comedi https://www.comedi.org");
1171 MODULE_DESCRIPTION("Comedi driver for Data Translation DT2821 series");
1172 MODULE_LICENSE("GPL");