2 * comedi/drivers/rtd520.c
3 * Comedi driver for Real Time Devices (RTD) PCI4520/DM7520
5 * COMEDI - Linux Control and Measurement Device Interface
6 * Copyright (C) 2001 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.
21 * Description: Real Time Devices PCI4520/DM7520
22 * Devices: [Real Time Devices] DM7520HR-1 (DM7520), DM7520HR-8,
23 * PCI4520 (PCI4520), PCI4520-8
24 * Author: Dan Christian
25 * Status: Works. Only tested on DM7520-8. Not SMP safe.
27 * Configuration options: not applicable, uses PCI auto config
31 * Created by Dan Christian, NASA Ames Research Center.
33 * The PCI4520 is a PCI card. The DM7520 is a PC/104-plus card.
35 * 8/16 12 bit ADC with FIFO and channel gain table
36 * 8 bits high speed digital out (for external MUX) (or 8 in or 8 out)
37 * 8 bits high speed digital in with FIFO and interrupt on change (or 8 IO)
38 * 2 12 bit DACs with FIFOs
42 * timers: ADC sample, pacer, burst, about, delay, DA1, DA2
44 * 3 user timer/counters (8254)
47 * The DM7520 has slightly fewer features (fewer gain steps).
49 * These boards can support external multiplexors and multi-board
50 * synchronization, but this driver doesn't support that.
52 * Board docs: http://www.rtdusa.com/PC104/DM/analog%20IO/dm7520.htm
53 * Data sheet: http://www.rtdusa.com/pdf/dm7520.pdf
54 * Example source: http://www.rtdusa.com/examples/dm/dm7520.zip
55 * Call them and ask for the register level manual.
56 * PCI chip: http://www.plxtech.com/products/io/pci9080
59 * This board is memory mapped. There is some IO stuff, but it isn't needed.
61 * I use a pretty loose naming style within the driver (rtd_blah).
62 * All externally visible names should be rtd520_blah.
63 * I use camelCase for structures (and inside them).
64 * I may also use upper CamelCase for function names (old habit).
66 * This board is somewhat related to the RTD PCI4400 board.
68 * I borrowed heavily from the ni_mio_common, ni_atmio16d, mite, and
69 * das1800, since they have the best documented code. Driver cb_pcidas64.c
70 * uses the same DMA controller.
72 * As far as I can tell, the About interrupt doesn't work if Sample is
73 * also enabled. It turns out that About really isn't needed, since
74 * we always count down samples read.
76 * There was some timer/counter code, but it didn't follow the right API.
82 * Analog-In supports instruction and command mode.
84 * With DMA, you can sample at 1.15Mhz with 70% idle on a 400Mhz K6-2
85 * (single channel, 64K read buffer). I get random system lockups when
86 * using DMA with ALI-15xx based systems. I haven't been able to test
87 * any other chipsets. The lockups happen soon after the start of an
88 * acquistion, not in the middle of a long run.
90 * Without DMA, you can do 620Khz sampling with 20% idle on a 400Mhz K6-2
91 * (with a 256K read buffer).
93 * Digital-IO and Analog-Out only support instruction mode.
96 #include <linux/module.h>
97 #include <linux/pci.h>
98 #include <linux/delay.h>
99 #include <linux/interrupt.h>
101 #include "../comedidev.h"
103 #include "comedi_fc.h"
107 * Local Address Space 0 Offsets
109 #define LAS0_USER_IO 0x0008 /* User I/O */
110 #define LAS0_ADC 0x0010 /* FIFO Status/Software A/D Start */
111 #define FS_DAC1_NOT_EMPTY (1 << 0) /* DAC1 FIFO not empty */
112 #define FS_DAC1_HEMPTY (1 << 1) /* DAC1 FIFO half empty */
113 #define FS_DAC1_NOT_FULL (1 << 2) /* DAC1 FIFO not full */
114 #define FS_DAC2_NOT_EMPTY (1 << 4) /* DAC2 FIFO not empty */
115 #define FS_DAC2_HEMPTY (1 << 5) /* DAC2 FIFO half empty */
116 #define FS_DAC2_NOT_FULL (1 << 6) /* DAC2 FIFO not full */
117 #define FS_ADC_NOT_EMPTY (1 << 8) /* ADC FIFO not empty */
118 #define FS_ADC_HEMPTY (1 << 9) /* ADC FIFO half empty */
119 #define FS_ADC_NOT_FULL (1 << 10) /* ADC FIFO not full */
120 #define FS_DIN_NOT_EMPTY (1 << 12) /* DIN FIFO not empty */
121 #define FS_DIN_HEMPTY (1 << 13) /* DIN FIFO half empty */
122 #define FS_DIN_NOT_FULL (1 << 14) /* DIN FIFO not full */
123 #define LAS0_DAC1 0x0014 /* Software D/A1 Update (w) */
124 #define LAS0_DAC2 0x0018 /* Software D/A2 Update (w) */
125 #define LAS0_DAC 0x0024 /* Software Simultaneous Update (w) */
126 #define LAS0_PACER 0x0028 /* Software Pacer Start/Stop */
127 #define LAS0_TIMER 0x002c /* Timer Status/HDIN Software Trig. */
128 #define LAS0_IT 0x0030 /* Interrupt Status/Enable */
129 #define IRQM_ADC_FIFO_WRITE (1 << 0) /* ADC FIFO Write */
130 #define IRQM_CGT_RESET (1 << 1) /* Reset CGT */
131 #define IRQM_CGT_PAUSE (1 << 3) /* Pause CGT */
132 #define IRQM_ADC_ABOUT_CNT (1 << 4) /* About Counter out */
133 #define IRQM_ADC_DELAY_CNT (1 << 5) /* Delay Counter out */
134 #define IRQM_ADC_SAMPLE_CNT (1 << 6) /* ADC Sample Counter */
135 #define IRQM_DAC1_UCNT (1 << 7) /* DAC1 Update Counter */
136 #define IRQM_DAC2_UCNT (1 << 8) /* DAC2 Update Counter */
137 #define IRQM_UTC1 (1 << 9) /* User TC1 out */
138 #define IRQM_UTC1_INV (1 << 10) /* User TC1 out, inverted */
139 #define IRQM_UTC2 (1 << 11) /* User TC2 out */
140 #define IRQM_DIGITAL_IT (1 << 12) /* Digital Interrupt */
141 #define IRQM_EXTERNAL_IT (1 << 13) /* External Interrupt */
142 #define IRQM_ETRIG_RISING (1 << 14) /* Ext Trigger rising-edge */
143 #define IRQM_ETRIG_FALLING (1 << 15) /* Ext Trigger falling-edge */
144 #define LAS0_CLEAR 0x0034 /* Clear/Set Interrupt Clear Mask */
145 #define LAS0_OVERRUN 0x0038 /* Pending interrupts/Clear Overrun */
146 #define LAS0_PCLK 0x0040 /* Pacer Clock (24bit) */
147 #define LAS0_BCLK 0x0044 /* Burst Clock (10bit) */
148 #define LAS0_ADC_SCNT 0x0048 /* A/D Sample counter (10bit) */
149 #define LAS0_DAC1_UCNT 0x004c /* D/A1 Update counter (10 bit) */
150 #define LAS0_DAC2_UCNT 0x0050 /* D/A2 Update counter (10 bit) */
151 #define LAS0_DCNT 0x0054 /* Delay counter (16 bit) */
152 #define LAS0_ACNT 0x0058 /* About counter (16 bit) */
153 #define LAS0_DAC_CLK 0x005c /* DAC clock (16bit) */
154 #define LAS0_UTC0 0x0060 /* 8254 TC Counter 0 */
155 #define LAS0_UTC1 0x0064 /* 8254 TC Counter 1 */
156 #define LAS0_UTC2 0x0068 /* 8254 TC Counter 2 */
157 #define LAS0_UTC_CTRL 0x006c /* 8254 TC Control */
158 #define LAS0_DIO0 0x0070 /* Digital I/O Port 0 */
159 #define LAS0_DIO1 0x0074 /* Digital I/O Port 1 */
160 #define LAS0_DIO0_CTRL 0x0078 /* Digital I/O Control */
161 #define LAS0_DIO_STATUS 0x007c /* Digital I/O Status */
162 #define LAS0_BOARD_RESET 0x0100 /* Board reset */
163 #define LAS0_DMA0_SRC 0x0104 /* DMA 0 Sources select */
164 #define LAS0_DMA1_SRC 0x0108 /* DMA 1 Sources select */
165 #define LAS0_ADC_CONVERSION 0x010c /* A/D Conversion Signal select */
166 #define LAS0_BURST_START 0x0110 /* Burst Clock Start Trigger select */
167 #define LAS0_PACER_START 0x0114 /* Pacer Clock Start Trigger select */
168 #define LAS0_PACER_STOP 0x0118 /* Pacer Clock Stop Trigger select */
169 #define LAS0_ACNT_STOP_ENABLE 0x011c /* About Counter Stop Enable */
170 #define LAS0_PACER_REPEAT 0x0120 /* Pacer Start Trigger Mode select */
171 #define LAS0_DIN_START 0x0124 /* HiSpd DI Sampling Signal select */
172 #define LAS0_DIN_FIFO_CLEAR 0x0128 /* Digital Input FIFO Clear */
173 #define LAS0_ADC_FIFO_CLEAR 0x012c /* A/D FIFO Clear */
174 #define LAS0_CGT_WRITE 0x0130 /* Channel Gain Table Write */
175 #define LAS0_CGL_WRITE 0x0134 /* Channel Gain Latch Write */
176 #define LAS0_CG_DATA 0x0138 /* Digital Table Write */
177 #define LAS0_CGT_ENABLE 0x013c /* Channel Gain Table Enable */
178 #define LAS0_CG_ENABLE 0x0140 /* Digital Table Enable */
179 #define LAS0_CGT_PAUSE 0x0144 /* Table Pause Enable */
180 #define LAS0_CGT_RESET 0x0148 /* Reset Channel Gain Table */
181 #define LAS0_CGT_CLEAR 0x014c /* Clear Channel Gain Table */
182 #define LAS0_DAC1_CTRL 0x0150 /* D/A1 output type/range */
183 #define LAS0_DAC1_SRC 0x0154 /* D/A1 update source */
184 #define LAS0_DAC1_CYCLE 0x0158 /* D/A1 cycle mode */
185 #define LAS0_DAC1_RESET 0x015c /* D/A1 FIFO reset */
186 #define LAS0_DAC1_FIFO_CLEAR 0x0160 /* D/A1 FIFO clear */
187 #define LAS0_DAC2_CTRL 0x0164 /* D/A2 output type/range */
188 #define LAS0_DAC2_SRC 0x0168 /* D/A2 update source */
189 #define LAS0_DAC2_CYCLE 0x016c /* D/A2 cycle mode */
190 #define LAS0_DAC2_RESET 0x0170 /* D/A2 FIFO reset */
191 #define LAS0_DAC2_FIFO_CLEAR 0x0174 /* D/A2 FIFO clear */
192 #define LAS0_ADC_SCNT_SRC 0x0178 /* A/D Sample Counter Source select */
193 #define LAS0_PACER_SELECT 0x0180 /* Pacer Clock select */
194 #define LAS0_SBUS0_SRC 0x0184 /* SyncBus 0 Source select */
195 #define LAS0_SBUS0_ENABLE 0x0188 /* SyncBus 0 enable */
196 #define LAS0_SBUS1_SRC 0x018c /* SyncBus 1 Source select */
197 #define LAS0_SBUS1_ENABLE 0x0190 /* SyncBus 1 enable */
198 #define LAS0_SBUS2_SRC 0x0198 /* SyncBus 2 Source select */
199 #define LAS0_SBUS2_ENABLE 0x019c /* SyncBus 2 enable */
200 #define LAS0_ETRG_POLARITY 0x01a4 /* Ext. Trigger polarity select */
201 #define LAS0_EINT_POLARITY 0x01a8 /* Ext. Interrupt polarity select */
202 #define LAS0_UTC0_CLOCK 0x01ac /* UTC0 Clock select */
203 #define LAS0_UTC0_GATE 0x01b0 /* UTC0 Gate select */
204 #define LAS0_UTC1_CLOCK 0x01b4 /* UTC1 Clock select */
205 #define LAS0_UTC1_GATE 0x01b8 /* UTC1 Gate select */
206 #define LAS0_UTC2_CLOCK 0x01bc /* UTC2 Clock select */
207 #define LAS0_UTC2_GATE 0x01c0 /* UTC2 Gate select */
208 #define LAS0_UOUT0_SELECT 0x01c4 /* User Output 0 source select */
209 #define LAS0_UOUT1_SELECT 0x01c8 /* User Output 1 source select */
210 #define LAS0_DMA0_RESET 0x01cc /* DMA0 Request state machine reset */
211 #define LAS0_DMA1_RESET 0x01d0 /* DMA1 Request state machine reset */
214 * Local Address Space 1 Offsets
216 #define LAS1_ADC_FIFO 0x0000 /* A/D FIFO (16bit) */
217 #define LAS1_HDIO_FIFO 0x0004 /* HiSpd DI FIFO (16bit) */
218 #define LAS1_DAC1_FIFO 0x0008 /* D/A1 FIFO (16bit) */
219 #define LAS1_DAC2_FIFO 0x000c /* D/A2 FIFO (16bit) */
221 /*======================================================================
222 Driver specific stuff (tunable)
223 ======================================================================*/
225 /* We really only need 2 buffers. More than that means being much
226 smarter about knowing which ones are full. */
227 #define DMA_CHAIN_COUNT 2 /* max DMA segments/buffers in a ring (min 2) */
229 /* Target period for periodic transfers. This sets the user read latency. */
230 /* Note: There are certain rates where we give this up and transfer 1/2 FIFO */
231 /* If this is too low, efficiency is poor */
232 #define TRANS_TARGET_PERIOD 10000000 /* 10 ms (in nanoseconds) */
234 /* Set a practical limit on how long a list to support (affects memory use) */
235 /* The board support a channel list up to the FIFO length (1K or 8K) */
236 #define RTD_MAX_CHANLIST 128 /* max channel list that we allow */
238 /*======================================================================
240 ======================================================================*/
242 #define RTD_CLOCK_RATE 8000000 /* 8Mhz onboard clock */
243 #define RTD_CLOCK_BASE 125 /* clock period in ns */
245 /* Note: these speed are slower than the spec, but fit the counter resolution*/
246 #define RTD_MAX_SPEED 1625 /* when sampling, in nanoseconds */
247 /* max speed if we don't have to wait for settling */
248 #define RTD_MAX_SPEED_1 875 /* if single channel, in nanoseconds */
250 #define RTD_MIN_SPEED 2097151875 /* (24bit counter) in nanoseconds */
251 /* min speed when only 1 channel (no burst counter) */
252 #define RTD_MIN_SPEED_1 5000000 /* 200Hz, in nanoseconds */
254 /* Setup continuous ring of 1/2 FIFO transfers. See RTD manual p91 */
255 #define DMA_MODE_BITS (\
256 PLX_LOCAL_BUS_16_WIDE_BITS \
257 | PLX_DMA_EN_READYIN_BIT \
258 | PLX_DMA_LOCAL_BURST_EN_BIT \
260 | PLX_DMA_INTR_PCI_BIT \
261 | PLX_LOCAL_ADDR_CONST_BIT \
262 | PLX_DEMAND_MODE_BIT)
264 #define DMA_TRANSFER_BITS (\
265 /* descriptors in PCI memory*/ PLX_DESC_IN_PCI_BIT \
266 /* interrupt at end of block */ | PLX_INTR_TERM_COUNT \
267 /* from board to PCI */ | PLX_XFER_LOCAL_TO_PCI)
269 /*======================================================================
270 Comedi specific stuff
271 ======================================================================*/
274 * The board has 3 input modes and the gains of 1,2,4,...32 (, 64, 128)
276 static const struct comedi_lrange rtd_ai_7520_range = {
278 /* +-5V input range gain steps */
285 /* +-10V input range gain steps */
290 BIP_RANGE(10.0 / 16),
291 BIP_RANGE(10.0 / 32),
292 /* +10V input range gain steps */
297 UNI_RANGE(10.0 / 16),
298 UNI_RANGE(10.0 / 32),
302 /* PCI4520 has two more gains (6 more entries) */
303 static const struct comedi_lrange rtd_ai_4520_range = {
305 /* +-5V input range gain steps */
313 BIP_RANGE(5.0 / 128),
314 /* +-10V input range gain steps */
319 BIP_RANGE(10.0 / 16),
320 BIP_RANGE(10.0 / 32),
321 BIP_RANGE(10.0 / 64),
322 BIP_RANGE(10.0 / 128),
323 /* +10V input range gain steps */
328 UNI_RANGE(10.0 / 16),
329 UNI_RANGE(10.0 / 32),
330 UNI_RANGE(10.0 / 64),
331 UNI_RANGE(10.0 / 128),
335 /* Table order matches range values */
336 static const struct comedi_lrange rtd_ao_range = {
350 struct rtd_boardinfo {
352 int range_bip10; /* start of +-10V range */
353 int range_uni10; /* start of +10V range */
354 const struct comedi_lrange *ai_range;
357 static const struct rtd_boardinfo rtd520Boards[] = {
362 .ai_range = &rtd_ai_7520_range,
368 .ai_range = &rtd_ai_4520_range,
373 /* memory mapped board structures */
377 long ai_count; /* total transfer size (samples) */
378 int xfer_count; /* # to transfer data. 0->1/2FIFO */
379 int flags; /* flag event modes */
383 /* bit defines for "flags" */
384 #define SEND_EOS 0x01 /* send End Of Scan events */
385 #define DMA0_ACTIVE 0x02 /* DMA0 is active */
386 #define DMA1_ACTIVE 0x04 /* DMA1 is active */
389 Given a desired period and the clock period (both in ns),
390 return the proper counter value (divider-1).
391 Sets the original period to be the true value.
392 Note: you have to check if the value is larger than the counter range!
394 static int rtd_ns_to_timer_base(unsigned int *nanosec,
395 unsigned int flags, int base)
399 switch (flags & CMDF_ROUND_MASK) {
400 case CMDF_ROUND_NEAREST:
402 divider = (*nanosec + base / 2) / base;
404 case CMDF_ROUND_DOWN:
405 divider = (*nanosec) / base;
408 divider = (*nanosec + base - 1) / base;
412 divider = 2; /* min is divide by 2 */
414 /* Note: we don't check for max, because different timers
415 have different ranges */
417 *nanosec = base * divider;
418 return divider - 1; /* countdown is divisor+1 */
422 Given a desired period (in ns),
423 return the proper counter value (divider-1) for the internal clock.
424 Sets the original period to be the true value.
426 static int rtd_ns_to_timer(unsigned int *ns, unsigned int flags)
428 return rtd_ns_to_timer_base(ns, flags, RTD_CLOCK_BASE);
432 Convert a single comedi channel-gain entry to a RTD520 table entry
434 static unsigned short rtd_convert_chan_gain(struct comedi_device *dev,
435 unsigned int chanspec, int index)
437 const struct rtd_boardinfo *board = dev->board_ptr;
438 unsigned int chan = CR_CHAN(chanspec);
439 unsigned int range = CR_RANGE(chanspec);
440 unsigned int aref = CR_AREF(chanspec);
441 unsigned short r = 0;
445 /* Note: we also setup the channel list bipolar flag array */
446 if (range < board->range_bip10) {
449 r |= (range & 0x7) << 4;
450 } else if (range < board->range_uni10) {
453 r |= ((range - board->range_bip10) & 0x7) << 4;
457 r |= ((range - board->range_uni10) & 0x7) << 4;
461 case AREF_GROUND: /* on-board ground */
465 r |= 0x80; /* ref external analog common */
469 r |= 0x400; /* differential inputs */
472 case AREF_OTHER: /* ??? */
479 Setup the channel-gain table from a comedi list
481 static void rtd_load_channelgain_list(struct comedi_device *dev,
482 unsigned int n_chan, unsigned int *list)
484 if (n_chan > 1) { /* setup channel gain table */
487 writel(0, dev->mmio + LAS0_CGT_CLEAR);
488 writel(1, dev->mmio + LAS0_CGT_ENABLE);
489 for (ii = 0; ii < n_chan; ii++) {
490 writel(rtd_convert_chan_gain(dev, list[ii], ii),
491 dev->mmio + LAS0_CGT_WRITE);
493 } else { /* just use the channel gain latch */
494 writel(0, dev->mmio + LAS0_CGT_ENABLE);
495 writel(rtd_convert_chan_gain(dev, list[0], 0),
496 dev->mmio + LAS0_CGL_WRITE);
500 /* determine fifo size by doing adc conversions until the fifo half
501 empty status flag clears */
502 static int rtd520_probe_fifo_depth(struct comedi_device *dev)
504 unsigned int chanspec = CR_PACK(0, 0, AREF_GROUND);
506 static const unsigned limit = 0x2000;
507 unsigned fifo_size = 0;
509 writel(0, dev->mmio + LAS0_ADC_FIFO_CLEAR);
510 rtd_load_channelgain_list(dev, 1, &chanspec);
511 /* ADC conversion trigger source: SOFTWARE */
512 writel(0, dev->mmio + LAS0_ADC_CONVERSION);
513 /* convert samples */
514 for (i = 0; i < limit; ++i) {
515 unsigned fifo_status;
516 /* trigger conversion */
517 writew(0, dev->mmio + LAS0_ADC);
519 fifo_status = readl(dev->mmio + LAS0_ADC);
520 if ((fifo_status & FS_ADC_HEMPTY) == 0) {
526 dev_info(dev->class_dev, "failed to probe fifo size.\n");
529 writel(0, dev->mmio + LAS0_ADC_FIFO_CLEAR);
530 if (fifo_size != 0x400 && fifo_size != 0x2000) {
531 dev_info(dev->class_dev,
532 "unexpected fifo size of %i, expected 1024 or 8192.\n",
539 static int rtd_ai_eoc(struct comedi_device *dev,
540 struct comedi_subdevice *s,
541 struct comedi_insn *insn,
542 unsigned long context)
546 status = readl(dev->mmio + LAS0_ADC);
547 if (status & FS_ADC_NOT_EMPTY)
552 static int rtd_ai_rinsn(struct comedi_device *dev,
553 struct comedi_subdevice *s, struct comedi_insn *insn,
556 struct rtd_private *devpriv = dev->private;
557 unsigned int range = CR_RANGE(insn->chanspec);
561 /* clear any old fifo data */
562 writel(0, dev->mmio + LAS0_ADC_FIFO_CLEAR);
564 /* write channel to multiplexer and clear channel gain table */
565 rtd_load_channelgain_list(dev, 1, &insn->chanspec);
567 /* ADC conversion trigger source: SOFTWARE */
568 writel(0, dev->mmio + LAS0_ADC_CONVERSION);
570 /* convert n samples */
571 for (n = 0; n < insn->n; n++) {
573 /* trigger conversion */
574 writew(0, dev->mmio + LAS0_ADC);
576 ret = comedi_timeout(dev, s, insn, rtd_ai_eoc, 0);
581 d = readw(devpriv->las1 + LAS1_ADC_FIFO);
582 d = d >> 3; /* low 3 bits are marker lines */
584 /* convert bipolar data to comedi unsigned data */
585 if (comedi_range_is_bipolar(s, range))
586 d = comedi_offset_munge(s, d);
588 data[n] = d & s->maxdata;
591 /* return the number of samples read/written */
596 Get what we know is there.... Fast!
597 This uses 1/2 the bus cycles of read_dregs (below).
599 The manual claims that we can do a lword read, but it doesn't work here.
601 static int ai_read_n(struct comedi_device *dev, struct comedi_subdevice *s,
604 struct rtd_private *devpriv = dev->private;
605 struct comedi_async *async = s->async;
606 struct comedi_cmd *cmd = &async->cmd;
609 for (ii = 0; ii < count; ii++) {
610 unsigned int range = CR_RANGE(cmd->chanlist[async->cur_chan]);
613 if (0 == devpriv->ai_count) { /* done */
614 d = readw(devpriv->las1 + LAS1_ADC_FIFO);
618 d = readw(devpriv->las1 + LAS1_ADC_FIFO);
619 d = d >> 3; /* low 3 bits are marker lines */
621 /* convert bipolar data to comedi unsigned data */
622 if (comedi_range_is_bipolar(s, range))
623 d = comedi_offset_munge(s, d);
626 if (!comedi_buf_write_samples(s, &d, 1))
629 if (devpriv->ai_count > 0) /* < 0, means read forever */
636 Handle all rtd520 interrupts.
637 Runs atomically and is never re-entered.
638 This is a "slow handler"; other interrupts may be active.
639 The data conversion may someday happen in a "bottom half".
641 static irqreturn_t rtd_interrupt(int irq, void *d)
643 struct comedi_device *dev = d;
644 struct comedi_subdevice *s = dev->read_subdev;
645 struct rtd_private *devpriv = dev->private;
653 fifo_status = readl(dev->mmio + LAS0_ADC);
654 /* check for FIFO full, this automatically halts the ADC! */
655 if (!(fifo_status & FS_ADC_NOT_FULL)) /* 0 -> full */
658 status = readw(dev->mmio + LAS0_IT);
659 /* if interrupt was not caused by our board, or handled above */
663 if (status & IRQM_ADC_ABOUT_CNT) { /* sample count -> read FIFO */
665 * since the priority interrupt controller may have queued
666 * a sample counter interrupt, even though we have already
667 * finished, we must handle the possibility that there is
670 if (!(fifo_status & FS_ADC_HEMPTY)) {
672 if (ai_read_n(dev, s, devpriv->fifosz / 2) < 0)
675 if (0 == devpriv->ai_count)
677 } else if (devpriv->xfer_count > 0) {
678 if (fifo_status & FS_ADC_NOT_EMPTY) {
680 if (ai_read_n(dev, s, devpriv->xfer_count) < 0)
683 if (0 == devpriv->ai_count)
689 overrun = readl(dev->mmio + LAS0_OVERRUN) & 0xffff;
693 /* clear the interrupt */
694 writew(status, dev->mmio + LAS0_CLEAR);
695 readw(dev->mmio + LAS0_CLEAR);
697 comedi_handle_events(dev, s);
702 s->async->events |= COMEDI_CB_ERROR;
705 s->async->events |= COMEDI_CB_EOA;
707 /* clear the interrupt */
708 status = readw(dev->mmio + LAS0_IT);
709 writew(status, dev->mmio + LAS0_CLEAR);
710 readw(dev->mmio + LAS0_CLEAR);
712 fifo_status = readl(dev->mmio + LAS0_ADC);
713 overrun = readl(dev->mmio + LAS0_OVERRUN) & 0xffff;
715 comedi_handle_events(dev, s);
721 cmdtest tests a particular command to see if it is valid.
722 Using the cmdtest ioctl, a user can create a valid cmd
723 and then have it executed by the cmd ioctl (asynchronously).
725 cmdtest returns 1,2,3,4 or 0, depending on which tests
729 static int rtd_ai_cmdtest(struct comedi_device *dev,
730 struct comedi_subdevice *s, struct comedi_cmd *cmd)
735 /* Step 1 : check if triggers are trivially valid */
737 err |= cfc_check_trigger_src(&cmd->start_src, TRIG_NOW);
738 err |= cfc_check_trigger_src(&cmd->scan_begin_src,
739 TRIG_TIMER | TRIG_EXT);
740 err |= cfc_check_trigger_src(&cmd->convert_src, TRIG_TIMER | TRIG_EXT);
741 err |= cfc_check_trigger_src(&cmd->scan_end_src, TRIG_COUNT);
742 err |= cfc_check_trigger_src(&cmd->stop_src, TRIG_COUNT | TRIG_NONE);
747 /* Step 2a : make sure trigger sources are unique */
749 err |= cfc_check_trigger_is_unique(cmd->scan_begin_src);
750 err |= cfc_check_trigger_is_unique(cmd->convert_src);
751 err |= cfc_check_trigger_is_unique(cmd->stop_src);
753 /* Step 2b : and mutually compatible */
758 /* Step 3: check if arguments are trivially valid */
760 err |= cfc_check_trigger_arg_is(&cmd->start_arg, 0);
762 if (cmd->scan_begin_src == TRIG_TIMER) {
763 /* Note: these are time periods, not actual rates */
764 if (1 == cmd->chanlist_len) { /* no scanning */
765 if (cfc_check_trigger_arg_min(&cmd->scan_begin_arg,
767 rtd_ns_to_timer(&cmd->scan_begin_arg,
771 if (cfc_check_trigger_arg_max(&cmd->scan_begin_arg,
773 rtd_ns_to_timer(&cmd->scan_begin_arg,
778 if (cfc_check_trigger_arg_min(&cmd->scan_begin_arg,
780 rtd_ns_to_timer(&cmd->scan_begin_arg,
784 if (cfc_check_trigger_arg_max(&cmd->scan_begin_arg,
786 rtd_ns_to_timer(&cmd->scan_begin_arg,
792 /* external trigger */
793 /* should be level/edge, hi/lo specification here */
794 /* should specify multiple external triggers */
795 err |= cfc_check_trigger_arg_max(&cmd->scan_begin_arg, 9);
798 if (cmd->convert_src == TRIG_TIMER) {
799 if (1 == cmd->chanlist_len) { /* no scanning */
800 if (cfc_check_trigger_arg_min(&cmd->convert_arg,
802 rtd_ns_to_timer(&cmd->convert_arg,
806 if (cfc_check_trigger_arg_max(&cmd->convert_arg,
808 rtd_ns_to_timer(&cmd->convert_arg,
813 if (cfc_check_trigger_arg_min(&cmd->convert_arg,
815 rtd_ns_to_timer(&cmd->convert_arg,
819 if (cfc_check_trigger_arg_max(&cmd->convert_arg,
821 rtd_ns_to_timer(&cmd->convert_arg,
827 /* external trigger */
829 err |= cfc_check_trigger_arg_max(&cmd->convert_arg, 9);
832 err |= cfc_check_trigger_arg_is(&cmd->scan_end_arg, cmd->chanlist_len);
834 if (cmd->stop_src == TRIG_COUNT)
835 err |= cfc_check_trigger_arg_min(&cmd->stop_arg, 1);
837 err |= cfc_check_trigger_arg_is(&cmd->stop_arg, 0);
843 /* step 4: fix up any arguments */
845 if (cmd->scan_begin_src == TRIG_TIMER) {
846 arg = cmd->scan_begin_arg;
847 rtd_ns_to_timer(&arg, cmd->flags);
848 err |= cfc_check_trigger_arg_is(&cmd->scan_begin_arg, arg);
851 if (cmd->convert_src == TRIG_TIMER) {
852 arg = cmd->convert_arg;
853 rtd_ns_to_timer(&arg, cmd->flags);
854 err |= cfc_check_trigger_arg_is(&cmd->convert_arg, arg);
856 if (cmd->scan_begin_src == TRIG_TIMER) {
857 arg = cmd->convert_arg * cmd->scan_end_arg;
858 err |= cfc_check_trigger_arg_min(&cmd->scan_begin_arg,
870 Execute a analog in command with many possible triggering options.
871 The data get stored in the async structure of the subdevice.
872 This is usually done by an interrupt handler.
873 Userland gets to the data using read calls.
875 static int rtd_ai_cmd(struct comedi_device *dev, struct comedi_subdevice *s)
877 struct rtd_private *devpriv = dev->private;
878 struct comedi_cmd *cmd = &s->async->cmd;
881 /* stop anything currently running */
882 /* pacer stop source: SOFTWARE */
883 writel(0, dev->mmio + LAS0_PACER_STOP);
884 writel(0, dev->mmio + LAS0_PACER); /* stop pacer */
885 writel(0, dev->mmio + LAS0_ADC_CONVERSION);
886 writew(0, dev->mmio + LAS0_IT);
887 writel(0, dev->mmio + LAS0_ADC_FIFO_CLEAR);
888 writel(0, dev->mmio + LAS0_OVERRUN);
890 /* start configuration */
891 /* load channel list and reset CGT */
892 rtd_load_channelgain_list(dev, cmd->chanlist_len, cmd->chanlist);
894 /* setup the common case and override if needed */
895 if (cmd->chanlist_len > 1) {
896 /* pacer start source: SOFTWARE */
897 writel(0, dev->mmio + LAS0_PACER_START);
898 /* burst trigger source: PACER */
899 writel(1, dev->mmio + LAS0_BURST_START);
900 /* ADC conversion trigger source: BURST */
901 writel(2, dev->mmio + LAS0_ADC_CONVERSION);
902 } else { /* single channel */
903 /* pacer start source: SOFTWARE */
904 writel(0, dev->mmio + LAS0_PACER_START);
905 /* ADC conversion trigger source: PACER */
906 writel(1, dev->mmio + LAS0_ADC_CONVERSION);
908 writel((devpriv->fifosz / 2 - 1) & 0xffff, dev->mmio + LAS0_ACNT);
910 if (TRIG_TIMER == cmd->scan_begin_src) {
911 /* scan_begin_arg is in nanoseconds */
912 /* find out how many samples to wait before transferring */
913 if (cmd->flags & CMDF_WAKE_EOS) {
915 * this may generate un-sustainable interrupt rates
916 * the application is responsible for doing the
919 devpriv->xfer_count = cmd->chanlist_len;
920 devpriv->flags |= SEND_EOS;
922 /* arrange to transfer data periodically */
923 devpriv->xfer_count =
924 (TRANS_TARGET_PERIOD * cmd->chanlist_len) /
926 if (devpriv->xfer_count < cmd->chanlist_len) {
927 /* transfer after each scan (and avoid 0) */
928 devpriv->xfer_count = cmd->chanlist_len;
929 } else { /* make a multiple of scan length */
930 devpriv->xfer_count =
931 (devpriv->xfer_count +
932 cmd->chanlist_len - 1)
934 devpriv->xfer_count *= cmd->chanlist_len;
936 devpriv->flags |= SEND_EOS;
938 if (devpriv->xfer_count >= (devpriv->fifosz / 2)) {
939 /* out of counter range, use 1/2 fifo instead */
940 devpriv->xfer_count = 0;
941 devpriv->flags &= ~SEND_EOS;
943 /* interrupt for each transfer */
944 writel((devpriv->xfer_count - 1) & 0xffff,
945 dev->mmio + LAS0_ACNT);
947 } else { /* unknown timing, just use 1/2 FIFO */
948 devpriv->xfer_count = 0;
949 devpriv->flags &= ~SEND_EOS;
951 /* pacer clock source: INTERNAL 8MHz */
952 writel(1, dev->mmio + LAS0_PACER_SELECT);
953 /* just interrupt, don't stop */
954 writel(1, dev->mmio + LAS0_ACNT_STOP_ENABLE);
956 /* BUG??? these look like enumerated values, but they are bit fields */
958 /* First, setup when to stop */
959 switch (cmd->stop_src) {
960 case TRIG_COUNT: /* stop after N scans */
961 devpriv->ai_count = cmd->stop_arg * cmd->chanlist_len;
962 if ((devpriv->xfer_count > 0)
963 && (devpriv->xfer_count > devpriv->ai_count)) {
964 devpriv->xfer_count = devpriv->ai_count;
968 case TRIG_NONE: /* stop when cancel is called */
969 devpriv->ai_count = -1; /* read forever */
974 switch (cmd->scan_begin_src) {
975 case TRIG_TIMER: /* periodic scanning */
976 timer = rtd_ns_to_timer(&cmd->scan_begin_arg,
978 /* set PACER clock */
979 writel(timer & 0xffffff, dev->mmio + LAS0_PCLK);
984 /* pacer start source: EXTERNAL */
985 writel(1, dev->mmio + LAS0_PACER_START);
989 /* Sample timing within a scan */
990 switch (cmd->convert_src) {
991 case TRIG_TIMER: /* periodic */
992 if (cmd->chanlist_len > 1) {
993 /* only needed for multi-channel */
994 timer = rtd_ns_to_timer(&cmd->convert_arg,
996 /* setup BURST clock */
997 writel(timer & 0x3ff, dev->mmio + LAS0_BCLK);
1002 case TRIG_EXT: /* external */
1003 /* burst trigger source: EXTERNAL */
1004 writel(2, dev->mmio + LAS0_BURST_START);
1007 /* end configuration */
1009 /* This doesn't seem to work. There is no way to clear an interrupt
1010 that the priority controller has queued! */
1011 writew(~0, dev->mmio + LAS0_CLEAR);
1012 readw(dev->mmio + LAS0_CLEAR);
1014 /* TODO: allow multiple interrupt sources */
1015 /* transfer every N samples */
1016 writew(IRQM_ADC_ABOUT_CNT, dev->mmio + LAS0_IT);
1018 /* BUG: start_src is ASSUMED to be TRIG_NOW */
1019 /* BUG? it seems like things are running before the "start" */
1020 readl(dev->mmio + LAS0_PACER); /* start pacer */
1025 Stop a running data acquisition.
1027 static int rtd_ai_cancel(struct comedi_device *dev, struct comedi_subdevice *s)
1029 struct rtd_private *devpriv = dev->private;
1031 /* pacer stop source: SOFTWARE */
1032 writel(0, dev->mmio + LAS0_PACER_STOP);
1033 writel(0, dev->mmio + LAS0_PACER); /* stop pacer */
1034 writel(0, dev->mmio + LAS0_ADC_CONVERSION);
1035 writew(0, dev->mmio + LAS0_IT);
1036 devpriv->ai_count = 0; /* stop and don't transfer any more */
1037 writel(0, dev->mmio + LAS0_ADC_FIFO_CLEAR);
1041 static int rtd_ao_eoc(struct comedi_device *dev,
1042 struct comedi_subdevice *s,
1043 struct comedi_insn *insn,
1044 unsigned long context)
1046 unsigned int chan = CR_CHAN(insn->chanspec);
1047 unsigned int bit = (chan == 0) ? FS_DAC1_NOT_EMPTY : FS_DAC2_NOT_EMPTY;
1048 unsigned int status;
1050 status = readl(dev->mmio + LAS0_ADC);
1056 static int rtd_ao_winsn(struct comedi_device *dev,
1057 struct comedi_subdevice *s, struct comedi_insn *insn,
1060 struct rtd_private *devpriv = dev->private;
1062 int chan = CR_CHAN(insn->chanspec);
1063 int range = CR_RANGE(insn->chanspec);
1066 /* Configure the output range (table index matches the range values) */
1068 dev->mmio + ((chan == 0) ? LAS0_DAC1_CTRL : LAS0_DAC2_CTRL));
1070 /* Writing a list of values to an AO channel is probably not
1071 * very useful, but that's how the interface is defined. */
1072 for (i = 0; i < insn->n; ++i) {
1073 int val = data[i] << 3;
1075 /* VERIFY: comedi range and offset conversions */
1077 if ((range > 1) /* bipolar */
1078 && (data[i] < 2048)) {
1079 /* offset and sign extend */
1080 val = (((int)data[i]) - 2048) << 3;
1081 } else { /* unipolor */
1085 /* a typical programming sequence */
1086 writew(val, devpriv->las1 +
1087 ((chan == 0) ? LAS1_DAC1_FIFO : LAS1_DAC2_FIFO));
1088 writew(0, dev->mmio + ((chan == 0) ? LAS0_DAC1 : LAS0_DAC2));
1090 s->readback[chan] = data[i];
1092 ret = comedi_timeout(dev, s, insn, rtd_ao_eoc, 0);
1097 /* return the number of samples read/written */
1101 static int rtd_dio_insn_bits(struct comedi_device *dev,
1102 struct comedi_subdevice *s,
1103 struct comedi_insn *insn,
1106 if (comedi_dio_update_state(s, data))
1107 writew(s->state & 0xff, dev->mmio + LAS0_DIO0);
1109 data[1] = readw(dev->mmio + LAS0_DIO0) & 0xff;
1114 static int rtd_dio_insn_config(struct comedi_device *dev,
1115 struct comedi_subdevice *s,
1116 struct comedi_insn *insn,
1121 ret = comedi_dio_insn_config(dev, s, insn, data, 0);
1125 /* TODO support digital match interrupts and strobes */
1128 writew(0x01, dev->mmio + LAS0_DIO_STATUS);
1129 writew(s->io_bits & 0xff, dev->mmio + LAS0_DIO0_CTRL);
1131 /* clear interrupts */
1132 writew(0x00, dev->mmio + LAS0_DIO_STATUS);
1134 /* port1 can only be all input or all output */
1136 /* there are also 2 user input lines and 2 user output lines */
1141 static void rtd_reset(struct comedi_device *dev)
1143 struct rtd_private *devpriv = dev->private;
1145 writel(0, dev->mmio + LAS0_BOARD_RESET);
1146 udelay(100); /* needed? */
1147 writel(0, devpriv->lcfg + PLX_INTRCS_REG);
1148 writew(0, dev->mmio + LAS0_IT);
1149 writew(~0, dev->mmio + LAS0_CLEAR);
1150 readw(dev->mmio + LAS0_CLEAR);
1154 * initialize board, per RTD spec
1155 * also, initialize shadow registers
1157 static void rtd_init_board(struct comedi_device *dev)
1161 writel(0, dev->mmio + LAS0_OVERRUN);
1162 writel(0, dev->mmio + LAS0_CGT_CLEAR);
1163 writel(0, dev->mmio + LAS0_ADC_FIFO_CLEAR);
1164 writel(0, dev->mmio + LAS0_DAC1_RESET);
1165 writel(0, dev->mmio + LAS0_DAC2_RESET);
1166 /* clear digital IO fifo */
1167 writew(0, dev->mmio + LAS0_DIO_STATUS);
1168 writeb((0 << 6) | 0x30, dev->mmio + LAS0_UTC_CTRL);
1169 writeb((1 << 6) | 0x30, dev->mmio + LAS0_UTC_CTRL);
1170 writeb((2 << 6) | 0x30, dev->mmio + LAS0_UTC_CTRL);
1171 writeb((3 << 6) | 0x00, dev->mmio + LAS0_UTC_CTRL);
1172 /* TODO: set user out source ??? */
1175 /* The RTD driver does this */
1176 static void rtd_pci_latency_quirk(struct comedi_device *dev,
1177 struct pci_dev *pcidev)
1179 unsigned char pci_latency;
1181 pci_read_config_byte(pcidev, PCI_LATENCY_TIMER, &pci_latency);
1182 if (pci_latency < 32) {
1183 dev_info(dev->class_dev,
1184 "PCI latency changed from %d to %d\n",
1186 pci_write_config_byte(pcidev, PCI_LATENCY_TIMER, 32);
1190 static int rtd_auto_attach(struct comedi_device *dev,
1191 unsigned long context)
1193 struct pci_dev *pcidev = comedi_to_pci_dev(dev);
1194 const struct rtd_boardinfo *board = NULL;
1195 struct rtd_private *devpriv;
1196 struct comedi_subdevice *s;
1199 if (context < ARRAY_SIZE(rtd520Boards))
1200 board = &rtd520Boards[context];
1203 dev->board_ptr = board;
1204 dev->board_name = board->name;
1206 devpriv = comedi_alloc_devpriv(dev, sizeof(*devpriv));
1210 ret = comedi_pci_enable(dev);
1214 dev->mmio = pci_ioremap_bar(pcidev, 2);
1215 devpriv->las1 = pci_ioremap_bar(pcidev, 3);
1216 devpriv->lcfg = pci_ioremap_bar(pcidev, 0);
1217 if (!dev->mmio || !devpriv->las1 || !devpriv->lcfg)
1220 rtd_pci_latency_quirk(dev, pcidev);
1223 ret = request_irq(pcidev->irq, rtd_interrupt, IRQF_SHARED,
1224 dev->board_name, dev);
1226 dev->irq = pcidev->irq;
1229 ret = comedi_alloc_subdevices(dev, 4);
1233 s = &dev->subdevices[0];
1234 /* analog input subdevice */
1235 s->type = COMEDI_SUBD_AI;
1236 s->subdev_flags = SDF_READABLE | SDF_GROUND | SDF_COMMON | SDF_DIFF;
1238 s->maxdata = 0x0fff;
1239 s->range_table = board->ai_range;
1240 s->len_chanlist = RTD_MAX_CHANLIST;
1241 s->insn_read = rtd_ai_rinsn;
1243 dev->read_subdev = s;
1244 s->subdev_flags |= SDF_CMD_READ;
1245 s->do_cmd = rtd_ai_cmd;
1246 s->do_cmdtest = rtd_ai_cmdtest;
1247 s->cancel = rtd_ai_cancel;
1250 s = &dev->subdevices[1];
1251 /* analog output subdevice */
1252 s->type = COMEDI_SUBD_AO;
1253 s->subdev_flags = SDF_WRITABLE;
1255 s->maxdata = 0x0fff;
1256 s->range_table = &rtd_ao_range;
1257 s->insn_write = rtd_ao_winsn;
1259 ret = comedi_alloc_subdev_readback(s);
1263 s = &dev->subdevices[2];
1264 /* digital i/o subdevice */
1265 s->type = COMEDI_SUBD_DIO;
1266 s->subdev_flags = SDF_READABLE | SDF_WRITABLE;
1267 /* we only support port 0 right now. Ignoring port 1 and user IO */
1270 s->range_table = &range_digital;
1271 s->insn_bits = rtd_dio_insn_bits;
1272 s->insn_config = rtd_dio_insn_config;
1274 /* timer/counter subdevices (not currently supported) */
1275 s = &dev->subdevices[3];
1276 s->type = COMEDI_SUBD_COUNTER;
1277 s->subdev_flags = SDF_READABLE | SDF_WRITABLE;
1279 s->maxdata = 0xffff;
1281 rtd_init_board(dev);
1283 ret = rtd520_probe_fifo_depth(dev);
1286 devpriv->fifosz = ret;
1289 writel(ICS_PIE | ICS_PLIE, devpriv->lcfg + PLX_INTRCS_REG);
1294 static void rtd_detach(struct comedi_device *dev)
1296 struct rtd_private *devpriv = dev->private;
1299 /* Shut down any board ops by resetting it */
1300 if (dev->mmio && devpriv->lcfg)
1303 writel(readl(devpriv->lcfg + PLX_INTRCS_REG) &
1304 ~(ICS_PLIE | ICS_DMA0_E | ICS_DMA1_E),
1305 devpriv->lcfg + PLX_INTRCS_REG);
1306 free_irq(dev->irq, dev);
1311 iounmap(devpriv->las1);
1313 iounmap(devpriv->lcfg);
1315 comedi_pci_disable(dev);
1318 static struct comedi_driver rtd520_driver = {
1319 .driver_name = "rtd520",
1320 .module = THIS_MODULE,
1321 .auto_attach = rtd_auto_attach,
1322 .detach = rtd_detach,
1325 static int rtd520_pci_probe(struct pci_dev *dev,
1326 const struct pci_device_id *id)
1328 return comedi_pci_auto_config(dev, &rtd520_driver, id->driver_data);
1331 static const struct pci_device_id rtd520_pci_table[] = {
1332 { PCI_VDEVICE(RTD, 0x7520), BOARD_DM7520 },
1333 { PCI_VDEVICE(RTD, 0x4520), BOARD_PCI4520 },
1336 MODULE_DEVICE_TABLE(pci, rtd520_pci_table);
1338 static struct pci_driver rtd520_pci_driver = {
1340 .id_table = rtd520_pci_table,
1341 .probe = rtd520_pci_probe,
1342 .remove = comedi_pci_auto_unconfig,
1344 module_comedi_pci_driver(rtd520_driver, rtd520_pci_driver);
1346 MODULE_AUTHOR("Comedi http://www.comedi.org");
1347 MODULE_DESCRIPTION("Comedi low-level driver");
1348 MODULE_LICENSE("GPL");