1 // SPDX-License-Identifier: GPL-2.0+
3 * comedi/drivers/mite.c
4 * Hardware driver for NI Mite PCI interface chip
6 * COMEDI - Linux Control and Measurement Device Interface
7 * Copyright (C) 1997-2002 David A. Schleef <ds@schleef.org>
11 * The PCI-MIO E series driver was originally written by
12 * Tomasz Motylewski <...>, and ported to comedi by ds.
14 * References for specifications:
16 * 321747b.pdf Register Level Programmer Manual (obsolete)
17 * 321747c.pdf Register Level Programmer Manual (new)
18 * DAQ-STC reference manual
20 * Other possibly relevant info:
22 * 320517c.pdf User manual (obsolete)
23 * 320517f.pdf User manual (new)
25 * 320906c.pdf maximum signal ratings
26 * 321066a.pdf about 16x
27 * 321791a.pdf discontinuation of at-mio-16e-10 rev. c
28 * 321808a.pdf about at-mio-16e-10 rev P
29 * 321837a.pdf discontinuation of at-mio-16de-10 rev d
30 * 321838a.pdf about at-mio-16de-10 rev N
36 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
38 #include <linux/module.h>
39 #include <linux/slab.h>
40 #include <linux/log2.h>
42 #include "../comedi_pci.h"
49 #define MITE_UNKNOWN_DMA_BURST_REG 0x28
50 #define UNKNOWN_DMA_BURST_ENABLE_BITS 0x600
52 #define MITE_PCI_CONFIG_OFFSET 0x300
53 #define MITE_CSIGR 0x460 /* chip signature */
54 #define CSIGR_TO_IOWINS(x) (((x) >> 29) & 0x7)
55 #define CSIGR_TO_WINS(x) (((x) >> 24) & 0x1f)
56 #define CSIGR_TO_WPDEP(x) (((x) >> 20) & 0x7)
57 #define CSIGR_TO_DMAC(x) (((x) >> 16) & 0xf)
58 #define CSIGR_TO_IMODE(x) (((x) >> 12) & 0x3) /* pci=0x3 */
59 #define CSIGR_TO_MMODE(x) (((x) >> 8) & 0x3) /* minimite=1 */
60 #define CSIGR_TO_TYPE(x) (((x) >> 4) & 0xf) /* mite=0, minimite=1 */
61 #define CSIGR_TO_VER(x) (((x) >> 0) & 0xf)
63 #define MITE_CHAN(x) (0x500 + 0x100 * (x))
64 #define MITE_CHOR(x) (0x00 + MITE_CHAN(x)) /* channel operation */
65 #define CHOR_DMARESET BIT(31)
66 #define CHOR_SET_SEND_TC BIT(11)
67 #define CHOR_CLR_SEND_TC BIT(10)
68 #define CHOR_SET_LPAUSE BIT(9)
69 #define CHOR_CLR_LPAUSE BIT(8)
70 #define CHOR_CLRDONE BIT(7)
71 #define CHOR_CLRRB BIT(6)
72 #define CHOR_CLRLC BIT(5)
73 #define CHOR_FRESET BIT(4)
74 #define CHOR_ABORT BIT(3) /* stop without emptying fifo */
75 #define CHOR_STOP BIT(2) /* stop after emptying fifo */
76 #define CHOR_CONT BIT(1)
77 #define CHOR_START BIT(0)
78 #define MITE_CHCR(x) (0x04 + MITE_CHAN(x)) /* channel control */
79 #define CHCR_SET_DMA_IE BIT(31)
80 #define CHCR_CLR_DMA_IE BIT(30)
81 #define CHCR_SET_LINKP_IE BIT(29)
82 #define CHCR_CLR_LINKP_IE BIT(28)
83 #define CHCR_SET_SAR_IE BIT(27)
84 #define CHCR_CLR_SAR_IE BIT(26)
85 #define CHCR_SET_DONE_IE BIT(25)
86 #define CHCR_CLR_DONE_IE BIT(24)
87 #define CHCR_SET_MRDY_IE BIT(23)
88 #define CHCR_CLR_MRDY_IE BIT(22)
89 #define CHCR_SET_DRDY_IE BIT(21)
90 #define CHCR_CLR_DRDY_IE BIT(20)
91 #define CHCR_SET_LC_IE BIT(19)
92 #define CHCR_CLR_LC_IE BIT(18)
93 #define CHCR_SET_CONT_RB_IE BIT(17)
94 #define CHCR_CLR_CONT_RB_IE BIT(16)
95 #define CHCR_FIFO(x) (((x) & 0x1) << 15)
96 #define CHCR_FIFODIS CHCR_FIFO(1)
97 #define CHCR_FIFO_ON CHCR_FIFO(0)
98 #define CHCR_BURST(x) (((x) & 0x1) << 14)
99 #define CHCR_BURSTEN CHCR_BURST(1)
100 #define CHCR_NO_BURSTEN CHCR_BURST(0)
101 #define CHCR_BYTE_SWAP_DEVICE BIT(6)
102 #define CHCR_BYTE_SWAP_MEMORY BIT(4)
103 #define CHCR_DIR(x) (((x) & 0x1) << 3)
104 #define CHCR_DEV_TO_MEM CHCR_DIR(1)
105 #define CHCR_MEM_TO_DEV CHCR_DIR(0)
106 #define CHCR_MODE(x) (((x) & 0x7) << 0)
107 #define CHCR_NORMAL CHCR_MODE(0)
108 #define CHCR_CONTINUE CHCR_MODE(1)
109 #define CHCR_RINGBUFF CHCR_MODE(2)
110 #define CHCR_LINKSHORT CHCR_MODE(4)
111 #define CHCR_LINKLONG CHCR_MODE(5)
112 #define MITE_TCR(x) (0x08 + MITE_CHAN(x)) /* transfer count */
113 #define MITE_MCR(x) (0x0c + MITE_CHAN(x)) /* memory config */
114 #define MITE_MAR(x) (0x10 + MITE_CHAN(x)) /* memory address */
115 #define MITE_DCR(x) (0x14 + MITE_CHAN(x)) /* device config */
116 #define DCR_NORMAL BIT(29)
117 #define MITE_DAR(x) (0x18 + MITE_CHAN(x)) /* device address */
118 #define MITE_LKCR(x) (0x1c + MITE_CHAN(x)) /* link config */
119 #define MITE_LKAR(x) (0x20 + MITE_CHAN(x)) /* link address */
120 #define MITE_LLKAR(x) (0x24 + MITE_CHAN(x)) /* see tnt5002 manual */
121 #define MITE_BAR(x) (0x28 + MITE_CHAN(x)) /* base address */
122 #define MITE_BCR(x) (0x2c + MITE_CHAN(x)) /* base count */
123 #define MITE_SAR(x) (0x30 + MITE_CHAN(x)) /* ? address */
124 #define MITE_WSCR(x) (0x34 + MITE_CHAN(x)) /* ? */
125 #define MITE_WSER(x) (0x38 + MITE_CHAN(x)) /* ? */
126 #define MITE_CHSR(x) (0x3c + MITE_CHAN(x)) /* channel status */
127 #define CHSR_INT BIT(31)
128 #define CHSR_LPAUSES BIT(29)
129 #define CHSR_SARS BIT(27)
130 #define CHSR_DONE BIT(25)
131 #define CHSR_MRDY BIT(23)
132 #define CHSR_DRDY BIT(21)
133 #define CHSR_LINKC BIT(19)
134 #define CHSR_CONTS_RB BIT(17)
135 #define CHSR_ERROR BIT(15)
136 #define CHSR_SABORT BIT(14)
137 #define CHSR_HABORT BIT(13)
138 #define CHSR_STOPS BIT(12)
139 #define CHSR_OPERR(x) (((x) & 0x3) << 10)
140 #define CHSR_OPERR_MASK CHSR_OPERR(3)
141 #define CHSR_OPERR_NOERROR CHSR_OPERR(0)
142 #define CHSR_OPERR_FIFOERROR CHSR_OPERR(1)
143 #define CHSR_OPERR_LINKERROR CHSR_OPERR(1) /* ??? */
144 #define CHSR_XFERR BIT(9)
145 #define CHSR_END BIT(8)
146 #define CHSR_DRQ1 BIT(7)
147 #define CHSR_DRQ0 BIT(6)
148 #define CHSR_LERR(x) (((x) & 0x3) << 4)
149 #define CHSR_LERR_MASK CHSR_LERR(3)
150 #define CHSR_LBERR CHSR_LERR(1)
151 #define CHSR_LRERR CHSR_LERR(2)
152 #define CHSR_LOERR CHSR_LERR(3)
153 #define CHSR_MERR(x) (((x) & 0x3) << 2)
154 #define CHSR_MERR_MASK CHSR_MERR(3)
155 #define CHSR_MBERR CHSR_MERR(1)
156 #define CHSR_MRERR CHSR_MERR(2)
157 #define CHSR_MOERR CHSR_MERR(3)
158 #define CHSR_DERR(x) (((x) & 0x3) << 0)
159 #define CHSR_DERR_MASK CHSR_DERR(3)
160 #define CHSR_DBERR CHSR_DERR(1)
161 #define CHSR_DRERR CHSR_DERR(2)
162 #define CHSR_DOERR CHSR_DERR(3)
163 #define MITE_FCR(x) (0x40 + MITE_CHAN(x)) /* fifo count */
165 /* common bits for the memory/device/link config registers */
166 #define CR_RL(x) (((x) & 0x7) << 21)
167 #define CR_REQS(x) (((x) & 0x7) << 16)
168 #define CR_REQS_MASK CR_REQS(7)
169 #define CR_ASEQ(x) (((x) & 0x3) << 10)
170 #define CR_ASEQDONT CR_ASEQ(0)
171 #define CR_ASEQUP CR_ASEQ(1)
172 #define CR_ASEQDOWN CR_ASEQ(2)
173 #define CR_ASEQ_MASK CR_ASEQ(3)
174 #define CR_PSIZE(x) (((x) & 0x3) << 8)
175 #define CR_PSIZE8 CR_PSIZE(1)
176 #define CR_PSIZE16 CR_PSIZE(2)
177 #define CR_PSIZE32 CR_PSIZE(3)
178 #define CR_PORT(x) (((x) & 0x3) << 6)
179 #define CR_PORTCPU CR_PORT(0)
180 #define CR_PORTIO CR_PORT(1)
181 #define CR_PORTVXI CR_PORT(2)
182 #define CR_PORTMXI CR_PORT(3)
183 #define CR_AMDEVICE BIT(0)
185 static unsigned int MITE_IODWBSR_1_WSIZE_bits(unsigned int size)
187 return (ilog2(size) - 1) & 0x1f;
190 static unsigned int mite_retry_limit(unsigned int retry_limit)
192 unsigned int value = 0;
195 value = 1 + ilog2(retry_limit);
201 static unsigned int mite_drq_reqs(unsigned int drq_line)
203 /* This also works on m-series when using channels (drq_line) 4 or 5. */
204 return CR_REQS((drq_line & 0x3) | 0x4);
207 static unsigned int mite_fifo_size(struct mite *mite, unsigned int channel)
209 unsigned int fcr_bits = readl(mite->mmio + MITE_FCR(channel));
210 unsigned int empty_count = (fcr_bits >> 16) & 0xff;
211 unsigned int full_count = fcr_bits & 0xff;
213 return empty_count + full_count;
216 static u32 mite_device_bytes_transferred(struct mite_channel *mite_chan)
218 struct mite *mite = mite_chan->mite;
220 return readl(mite->mmio + MITE_DAR(mite_chan->channel));
224 * mite_bytes_in_transit() - Returns the number of unread bytes in the fifo.
225 * @mite_chan: MITE dma channel.
227 u32 mite_bytes_in_transit(struct mite_channel *mite_chan)
229 struct mite *mite = mite_chan->mite;
231 return readl(mite->mmio + MITE_FCR(mite_chan->channel)) & 0xff;
233 EXPORT_SYMBOL_GPL(mite_bytes_in_transit);
235 /* returns lower bound for number of bytes transferred from device to memory */
236 static u32 mite_bytes_written_to_memory_lb(struct mite_channel *mite_chan)
238 u32 device_byte_count;
240 device_byte_count = mite_device_bytes_transferred(mite_chan);
241 return device_byte_count - mite_bytes_in_transit(mite_chan);
244 /* returns upper bound for number of bytes transferred from device to memory */
245 static u32 mite_bytes_written_to_memory_ub(struct mite_channel *mite_chan)
247 u32 in_transit_count;
249 in_transit_count = mite_bytes_in_transit(mite_chan);
250 return mite_device_bytes_transferred(mite_chan) - in_transit_count;
253 /* returns lower bound for number of bytes read from memory to device */
254 static u32 mite_bytes_read_from_memory_lb(struct mite_channel *mite_chan)
256 u32 device_byte_count;
258 device_byte_count = mite_device_bytes_transferred(mite_chan);
259 return device_byte_count + mite_bytes_in_transit(mite_chan);
262 /* returns upper bound for number of bytes read from memory to device */
263 static u32 mite_bytes_read_from_memory_ub(struct mite_channel *mite_chan)
265 u32 in_transit_count;
267 in_transit_count = mite_bytes_in_transit(mite_chan);
268 return mite_device_bytes_transferred(mite_chan) + in_transit_count;
271 static void mite_sync_input_dma(struct mite_channel *mite_chan,
272 struct comedi_subdevice *s)
274 struct comedi_async *async = s->async;
276 unsigned int nbytes, old_alloc_count;
278 old_alloc_count = async->buf_write_alloc_count;
279 /* write alloc as much as we can */
280 comedi_buf_write_alloc(s, async->prealloc_bufsz);
282 nbytes = mite_bytes_written_to_memory_lb(mite_chan);
283 if ((int)(mite_bytes_written_to_memory_ub(mite_chan) -
284 old_alloc_count) > 0) {
285 dev_warn(s->device->class_dev,
286 "mite: DMA overwrite of free area\n");
287 async->events |= COMEDI_CB_OVERFLOW;
291 count = nbytes - async->buf_write_count;
293 * it's possible count will be negative due to conservative value
294 * returned by mite_bytes_written_to_memory_lb
297 comedi_buf_write_free(s, count);
298 comedi_inc_scan_progress(s, count);
299 async->events |= COMEDI_CB_BLOCK;
303 static void mite_sync_output_dma(struct mite_channel *mite_chan,
304 struct comedi_subdevice *s)
306 struct comedi_async *async = s->async;
307 struct comedi_cmd *cmd = &async->cmd;
308 u32 stop_count = cmd->stop_arg * comedi_bytes_per_scan(s);
309 unsigned int old_alloc_count = async->buf_read_alloc_count;
310 u32 nbytes_ub, nbytes_lb;
312 bool finite_regen = (cmd->stop_src == TRIG_NONE && stop_count != 0);
314 /* read alloc as much as we can */
315 comedi_buf_read_alloc(s, async->prealloc_bufsz);
316 nbytes_lb = mite_bytes_read_from_memory_lb(mite_chan);
317 if (cmd->stop_src == TRIG_COUNT && (int)(nbytes_lb - stop_count) > 0)
318 nbytes_lb = stop_count;
319 nbytes_ub = mite_bytes_read_from_memory_ub(mite_chan);
320 if (cmd->stop_src == TRIG_COUNT && (int)(nbytes_ub - stop_count) > 0)
321 nbytes_ub = stop_count;
323 if ((!finite_regen || stop_count > old_alloc_count) &&
324 ((int)(nbytes_ub - old_alloc_count) > 0)) {
325 dev_warn(s->device->class_dev, "mite: DMA underrun\n");
326 async->events |= COMEDI_CB_OVERFLOW;
332 * This is a special case where we continuously output a finite
333 * buffer. In this case, we do not free any of the memory,
334 * hence we expect that old_alloc_count will reach a maximum of
340 count = nbytes_lb - async->buf_read_count;
342 comedi_buf_read_free(s, count);
343 async->events |= COMEDI_CB_BLOCK;
348 * mite_sync_dma() - Sync the MITE dma with the COMEDI async buffer.
349 * @mite_chan: MITE dma channel.
350 * @s: COMEDI subdevice.
352 void mite_sync_dma(struct mite_channel *mite_chan, struct comedi_subdevice *s)
354 if (mite_chan->dir == COMEDI_INPUT)
355 mite_sync_input_dma(mite_chan, s);
357 mite_sync_output_dma(mite_chan, s);
359 EXPORT_SYMBOL_GPL(mite_sync_dma);
361 static unsigned int mite_get_status(struct mite_channel *mite_chan)
363 struct mite *mite = mite_chan->mite;
367 spin_lock_irqsave(&mite->lock, flags);
368 status = readl(mite->mmio + MITE_CHSR(mite_chan->channel));
369 if (status & CHSR_DONE) {
372 mite->mmio + MITE_CHOR(mite_chan->channel));
374 spin_unlock_irqrestore(&mite->lock, flags);
379 * mite_ack_linkc() - Check and ack the LINKC interrupt,
380 * @mite_chan: MITE dma channel.
381 * @s: COMEDI subdevice.
382 * @sync: flag to force a mite_sync_dma().
384 * This will also ack the DONE interrupt if active.
386 void mite_ack_linkc(struct mite_channel *mite_chan,
387 struct comedi_subdevice *s,
390 struct mite *mite = mite_chan->mite;
393 status = mite_get_status(mite_chan);
394 if (status & CHSR_LINKC) {
395 writel(CHOR_CLRLC, mite->mmio + MITE_CHOR(mite_chan->channel));
399 mite_sync_dma(mite_chan, s);
401 if (status & CHSR_XFERR) {
402 dev_err(s->device->class_dev,
403 "mite: transfer error %08x\n", status);
404 s->async->events |= COMEDI_CB_ERROR;
407 EXPORT_SYMBOL_GPL(mite_ack_linkc);
410 * mite_done() - Check is a MITE dma transfer is complete.
411 * @mite_chan: MITE dma channel.
413 * This will also ack the DONE interrupt if active.
415 int mite_done(struct mite_channel *mite_chan)
417 struct mite *mite = mite_chan->mite;
421 mite_get_status(mite_chan);
422 spin_lock_irqsave(&mite->lock, flags);
423 done = mite_chan->done;
424 spin_unlock_irqrestore(&mite->lock, flags);
427 EXPORT_SYMBOL_GPL(mite_done);
429 static void mite_dma_reset(struct mite_channel *mite_chan)
431 writel(CHOR_DMARESET | CHOR_FRESET,
432 mite_chan->mite->mmio + MITE_CHOR(mite_chan->channel));
436 * mite_dma_arm() - Start a MITE dma transfer.
437 * @mite_chan: MITE dma channel.
439 void mite_dma_arm(struct mite_channel *mite_chan)
441 struct mite *mite = mite_chan->mite;
445 * memory barrier is intended to insure any twiddling with the buffer
446 * is done before writing to the mite to arm dma transfer
449 spin_lock_irqsave(&mite->lock, flags);
452 writel(CHOR_START, mite->mmio + MITE_CHOR(mite_chan->channel));
453 spin_unlock_irqrestore(&mite->lock, flags);
455 EXPORT_SYMBOL_GPL(mite_dma_arm);
458 * mite_dma_disarm() - Stop a MITE dma transfer.
459 * @mite_chan: MITE dma channel.
461 void mite_dma_disarm(struct mite_channel *mite_chan)
463 struct mite *mite = mite_chan->mite;
466 writel(CHOR_ABORT, mite->mmio + MITE_CHOR(mite_chan->channel));
468 EXPORT_SYMBOL_GPL(mite_dma_disarm);
471 * mite_prep_dma() - Prepare a MITE dma channel for transfers.
472 * @mite_chan: MITE dma channel.
473 * @num_device_bits: device transfer size (8, 16, or 32-bits).
474 * @num_memory_bits: memory transfer size (8, 16, or 32-bits).
476 void mite_prep_dma(struct mite_channel *mite_chan,
477 unsigned int num_device_bits, unsigned int num_memory_bits)
479 struct mite *mite = mite_chan->mite;
480 unsigned int chcr, mcr, dcr, lkcr;
482 mite_dma_reset(mite_chan);
484 /* short link chaining mode */
485 chcr = CHCR_SET_DMA_IE | CHCR_LINKSHORT | CHCR_SET_DONE_IE |
488 * Link Complete Interrupt: interrupt every time a link
489 * in MITE_RING is completed. This can generate a lot of
490 * extra interrupts, but right now we update the values
491 * of buf_int_ptr and buf_int_count at each interrupt. A
492 * better method is to poll the MITE before each user
493 * "read()" to calculate the number of bytes available.
495 chcr |= CHCR_SET_LC_IE;
496 if (num_memory_bits == 32 && num_device_bits == 16) {
498 * Doing a combined 32 and 16 bit byteswap gets the 16 bit
499 * samples into the fifo in the right order. Tested doing 32 bit
500 * memory to 16 bit device transfers to the analog out of a
501 * pxi-6281, which has mite version = 1, type = 4. This also
502 * works for dma reads from the counters on e-series boards.
504 chcr |= CHCR_BYTE_SWAP_DEVICE | CHCR_BYTE_SWAP_MEMORY;
506 if (mite_chan->dir == COMEDI_INPUT)
507 chcr |= CHCR_DEV_TO_MEM;
509 writel(chcr, mite->mmio + MITE_CHCR(mite_chan->channel));
512 mcr = mite_retry_limit(64) | CR_ASEQUP;
513 switch (num_memory_bits) {
524 pr_warn("bug! invalid mem bit width for dma transfer\n");
527 writel(mcr, mite->mmio + MITE_MCR(mite_chan->channel));
530 dcr = mite_retry_limit(64) | CR_ASEQUP;
531 dcr |= CR_PORTIO | CR_AMDEVICE | mite_drq_reqs(mite_chan->channel);
532 switch (num_device_bits) {
543 pr_warn("bug! invalid dev bit width for dma transfer\n");
546 writel(dcr, mite->mmio + MITE_DCR(mite_chan->channel));
549 writel(0, mite->mmio + MITE_DAR(mite_chan->channel));
551 /* the link is 32bits */
552 lkcr = mite_retry_limit(64) | CR_ASEQUP | CR_PSIZE32;
553 writel(lkcr, mite->mmio + MITE_LKCR(mite_chan->channel));
555 /* starting address for link chaining */
556 writel(mite_chan->ring->dma_addr,
557 mite->mmio + MITE_LKAR(mite_chan->channel));
559 EXPORT_SYMBOL_GPL(mite_prep_dma);
561 static struct mite_channel *__mite_request_channel(struct mite *mite,
562 struct mite_ring *ring,
563 unsigned int min_channel,
564 unsigned int max_channel)
566 struct mite_channel *mite_chan = NULL;
571 * spin lock so mite_release_channel can be called safely
574 spin_lock_irqsave(&mite->lock, flags);
575 for (i = min_channel; i <= max_channel; ++i) {
576 mite_chan = &mite->channels[i];
577 if (!mite_chan->ring) {
578 mite_chan->ring = ring;
583 spin_unlock_irqrestore(&mite->lock, flags);
588 * mite_request_channel_in_range() - Request a MITE dma channel.
589 * @mite: MITE device.
590 * @ring: MITE dma ring.
591 * @min_channel: minimum channel index to use.
592 * @max_channel: maximum channel index to use.
594 struct mite_channel *mite_request_channel_in_range(struct mite *mite,
595 struct mite_ring *ring,
596 unsigned int min_channel,
597 unsigned int max_channel)
599 return __mite_request_channel(mite, ring, min_channel, max_channel);
601 EXPORT_SYMBOL_GPL(mite_request_channel_in_range);
604 * mite_request_channel() - Request a MITE dma channel.
605 * @mite: MITE device.
606 * @ring: MITE dma ring.
608 struct mite_channel *mite_request_channel(struct mite *mite,
609 struct mite_ring *ring)
611 return __mite_request_channel(mite, ring, 0, mite->num_channels - 1);
613 EXPORT_SYMBOL_GPL(mite_request_channel);
616 * mite_release_channel() - Release a MITE dma channel.
617 * @mite_chan: MITE dma channel.
619 void mite_release_channel(struct mite_channel *mite_chan)
621 struct mite *mite = mite_chan->mite;
624 /* spin lock to prevent races with mite_request_channel */
625 spin_lock_irqsave(&mite->lock, flags);
626 if (mite_chan->ring) {
627 mite_dma_disarm(mite_chan);
628 mite_dma_reset(mite_chan);
630 * disable all channel's interrupts (do it after disarm/reset so
631 * MITE_CHCR reg isn't changed while dma is still active!)
633 writel(CHCR_CLR_DMA_IE | CHCR_CLR_LINKP_IE |
634 CHCR_CLR_SAR_IE | CHCR_CLR_DONE_IE |
635 CHCR_CLR_MRDY_IE | CHCR_CLR_DRDY_IE |
636 CHCR_CLR_LC_IE | CHCR_CLR_CONT_RB_IE,
637 mite->mmio + MITE_CHCR(mite_chan->channel));
638 mite_chan->ring = NULL;
640 spin_unlock_irqrestore(&mite->lock, flags);
642 EXPORT_SYMBOL_GPL(mite_release_channel);
645 * mite_init_ring_descriptors() - Initialize a MITE dma ring descriptors.
646 * @ring: MITE dma ring.
647 * @s: COMEDI subdevice.
648 * @nbytes: the size of the dma ring (in bytes).
650 * Initializes the ring buffer descriptors to provide correct DMA transfer
651 * links to the exact amount of memory required. When the ring buffer is
652 * allocated by mite_buf_change(), the default is to initialize the ring
653 * to refer to the entire DMA data buffer. A command may call this function
654 * later to re-initialize and shorten the amount of memory that will be
657 int mite_init_ring_descriptors(struct mite_ring *ring,
658 struct comedi_subdevice *s,
661 struct comedi_async *async = s->async;
662 struct mite_dma_desc *desc = NULL;
663 unsigned int n_full_links = nbytes >> PAGE_SHIFT;
664 unsigned int remainder = nbytes % PAGE_SIZE;
667 dev_dbg(s->device->class_dev,
668 "mite: init ring buffer to %u bytes\n", nbytes);
670 if ((n_full_links + (remainder > 0 ? 1 : 0)) > ring->n_links) {
671 dev_err(s->device->class_dev,
672 "mite: ring buffer too small for requested init\n");
676 /* We set the descriptors for all full links. */
677 for (i = 0; i < n_full_links; ++i) {
678 desc = &ring->descs[i];
679 desc->count = cpu_to_le32(PAGE_SIZE);
680 desc->addr = cpu_to_le32(async->buf_map->page_list[i].dma_addr);
681 desc->next = cpu_to_le32(ring->dma_addr +
682 (i + 1) * sizeof(*desc));
685 /* the last link is either a remainder or was a full link. */
687 desc = &ring->descs[i];
688 /* set the lesser count for the remainder link */
689 desc->count = cpu_to_le32(remainder);
690 desc->addr = cpu_to_le32(async->buf_map->page_list[i].dma_addr);
693 /* Assign the last link->next to point back to the head of the list. */
694 desc->next = cpu_to_le32(ring->dma_addr);
697 * barrier is meant to insure that all the writes to the dma descriptors
698 * have completed before the dma controller is commanded to read them
703 EXPORT_SYMBOL_GPL(mite_init_ring_descriptors);
705 static void mite_free_dma_descs(struct mite_ring *ring)
707 struct mite_dma_desc *descs = ring->descs;
710 dma_free_coherent(ring->hw_dev,
711 ring->n_links * sizeof(*descs),
712 descs, ring->dma_addr);
720 * mite_buf_change() - COMEDI subdevice (*buf_change) for a MITE dma ring.
721 * @ring: MITE dma ring.
722 * @s: COMEDI subdevice.
724 int mite_buf_change(struct mite_ring *ring, struct comedi_subdevice *s)
726 struct comedi_async *async = s->async;
727 struct mite_dma_desc *descs;
728 unsigned int n_links;
730 mite_free_dma_descs(ring);
732 if (async->prealloc_bufsz == 0)
735 n_links = async->prealloc_bufsz >> PAGE_SHIFT;
737 descs = dma_alloc_coherent(ring->hw_dev,
738 n_links * sizeof(*descs),
739 &ring->dma_addr, GFP_KERNEL);
741 dev_err(s->device->class_dev,
742 "mite: ring buffer allocation failed\n");
746 ring->n_links = n_links;
748 return mite_init_ring_descriptors(ring, s, n_links << PAGE_SHIFT);
750 EXPORT_SYMBOL_GPL(mite_buf_change);
753 * mite_alloc_ring() - Allocate a MITE dma ring.
754 * @mite: MITE device.
756 struct mite_ring *mite_alloc_ring(struct mite *mite)
758 struct mite_ring *ring;
760 ring = kmalloc(sizeof(*ring), GFP_KERNEL);
763 ring->hw_dev = get_device(&mite->pcidev->dev);
773 EXPORT_SYMBOL_GPL(mite_alloc_ring);
776 * mite_free_ring() - Free a MITE dma ring and its descriptors.
777 * @ring: MITE dma ring.
779 void mite_free_ring(struct mite_ring *ring)
782 mite_free_dma_descs(ring);
783 put_device(ring->hw_dev);
787 EXPORT_SYMBOL_GPL(mite_free_ring);
789 static int mite_setup(struct comedi_device *dev, struct mite *mite,
792 resource_size_t daq_phys_addr;
793 unsigned long length;
796 unsigned int unknown_dma_burst_bits;
799 pci_set_master(mite->pcidev);
801 mite->mmio = pci_ioremap_bar(mite->pcidev, 0);
805 dev->mmio = pci_ioremap_bar(mite->pcidev, 1);
808 daq_phys_addr = pci_resource_start(mite->pcidev, 1);
809 length = pci_resource_len(mite->pcidev, 1);
812 writel(0, mite->mmio + MITE_IODWBSR);
813 dev_dbg(dev->class_dev,
814 "mite: using I/O Window Base Size register 1\n");
815 writel(daq_phys_addr | WENAB |
816 MITE_IODWBSR_1_WSIZE_bits(length),
817 mite->mmio + MITE_IODWBSR_1);
818 writel(0, mite->mmio + MITE_IODWCR_1);
820 writel(daq_phys_addr | WENAB, mite->mmio + MITE_IODWBSR);
823 * Make sure dma bursts work. I got this from running a bus analyzer
824 * on a pxi-6281 and a pxi-6713. 6713 powered up with register value
825 * of 0x61f and bursts worked. 6281 powered up with register value of
826 * 0x1f and bursts didn't work. The NI windows driver reads the
827 * register, then does a bitwise-or of 0x600 with it and writes it back.
829 * The bits 0x90180700 in MITE_UNKNOWN_DMA_BURST_REG can be
830 * written and read back. The bits 0x1f always read as 1.
831 * The rest always read as zero.
833 unknown_dma_burst_bits = readl(mite->mmio + MITE_UNKNOWN_DMA_BURST_REG);
834 unknown_dma_burst_bits |= UNKNOWN_DMA_BURST_ENABLE_BITS;
835 writel(unknown_dma_burst_bits, mite->mmio + MITE_UNKNOWN_DMA_BURST_REG);
837 csigr_bits = readl(mite->mmio + MITE_CSIGR);
838 mite->num_channels = CSIGR_TO_DMAC(csigr_bits);
839 if (mite->num_channels > MAX_MITE_DMA_CHANNELS) {
840 dev_warn(dev->class_dev,
841 "mite: bug? chip claims to have %i dma channels. Setting to %i.\n",
842 mite->num_channels, MAX_MITE_DMA_CHANNELS);
843 mite->num_channels = MAX_MITE_DMA_CHANNELS;
846 /* get the wpdep bits and convert it to the write port fifo depth */
847 wpdep = CSIGR_TO_WPDEP(csigr_bits);
851 dev_dbg(dev->class_dev,
852 "mite: version = %i, type = %i, mite mode = %i, interface mode = %i\n",
853 CSIGR_TO_VER(csigr_bits), CSIGR_TO_TYPE(csigr_bits),
854 CSIGR_TO_MMODE(csigr_bits), CSIGR_TO_IMODE(csigr_bits));
855 dev_dbg(dev->class_dev,
856 "mite: num channels = %i, write post fifo depth = %i, wins = %i, iowins = %i\n",
857 CSIGR_TO_DMAC(csigr_bits), wpdep,
858 CSIGR_TO_WINS(csigr_bits), CSIGR_TO_IOWINS(csigr_bits));
860 for (i = 0; i < mite->num_channels; i++) {
861 writel(CHOR_DMARESET, mite->mmio + MITE_CHOR(i));
862 /* disable interrupts */
863 writel(CHCR_CLR_DMA_IE | CHCR_CLR_LINKP_IE | CHCR_CLR_SAR_IE |
864 CHCR_CLR_DONE_IE | CHCR_CLR_MRDY_IE | CHCR_CLR_DRDY_IE |
865 CHCR_CLR_LC_IE | CHCR_CLR_CONT_RB_IE,
866 mite->mmio + MITE_CHCR(i));
868 mite->fifo_size = mite_fifo_size(mite, 0);
869 dev_dbg(dev->class_dev, "mite: fifo size is %i.\n", mite->fifo_size);
874 * mite_attach() - Allocate and initialize a MITE device for a comedi driver.
875 * @dev: COMEDI device.
876 * @use_win1: flag to use I/O Window 1 instead of I/O Window 0.
878 * Called by a COMEDI drivers (*auto_attach).
880 * Returns a pointer to the MITE device on success, or NULL if the MITE cannot
881 * be allocated or remapped.
883 struct mite *mite_attach(struct comedi_device *dev, bool use_win1)
885 struct pci_dev *pcidev = comedi_to_pci_dev(dev);
890 mite = kzalloc(sizeof(*mite), GFP_KERNEL);
894 spin_lock_init(&mite->lock);
895 mite->pcidev = pcidev;
896 for (i = 0; i < MAX_MITE_DMA_CHANNELS; ++i) {
897 mite->channels[i].mite = mite;
898 mite->channels[i].channel = i;
899 mite->channels[i].done = 1;
902 ret = mite_setup(dev, mite, use_win1);
912 EXPORT_SYMBOL_GPL(mite_attach);
915 * mite_detach() - Unmap and free a MITE device for a comedi driver.
916 * @mite: MITE device.
918 * Called by a COMEDI drivers (*detach).
920 void mite_detach(struct mite *mite)
930 EXPORT_SYMBOL_GPL(mite_detach);
932 static int __init mite_module_init(void)
936 module_init(mite_module_init);
938 static void __exit mite_module_exit(void)
941 module_exit(mite_module_exit);
943 MODULE_AUTHOR("Comedi http://www.comedi.org");
944 MODULE_DESCRIPTION("Comedi helper for NI Mite PCI interface chip");
945 MODULE_LICENSE("GPL");