2 comedi/drivers/ni_mio_cs.c
3 Hardware driver for NI PCMCIA MIO E series cards
5 COMEDI - Linux Control and Measurement Device Interface
6 Copyright (C) 1997-2000 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.
18 You should have received a copy of the GNU General Public License
19 along with this program; if not, write to the Free Software
20 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
25 Description: National Instruments DAQCard E series
28 Devices: [National Instruments] DAQCard-AI-16XE-50 (ni_mio_cs),
29 DAQCard-AI-16E-4, DAQCard-6062E, DAQCard-6024E, DAQCard-6036E
30 Updated: Thu Oct 23 19:43:17 CDT 2003
32 See the notes in the ni_atmio.o driver.
35 The real guts of the driver is in ni_mio_common.c, which is
36 included by all the E series drivers.
38 References for specifications:
40 341080a.pdf DAQCard E Series Register Level Programmer Manual
44 #include "../comedidev.h"
46 #include <linux/delay.h>
51 #include <pcmcia/cs_types.h>
52 #include <pcmcia/cs.h>
53 #include <pcmcia/cistpl.h>
54 #include <pcmcia/ds.h>
67 #define MAX_N_CALDACS 32
69 static const struct ni_board_struct ni_boards[] = {
71 .name = "DAQCard-ai-16xe-50",
74 .ai_fifo_depth = 1024,
76 .gainlkup = ai_gain_8,
82 .num_p0_dio_channels = 8,
84 .caldac = {dac8800, dac8043},
87 .name = "DAQCard-ai-16e-4",
90 .ai_fifo_depth = 1024,
92 .gainlkup = ai_gain_16,
98 .num_p0_dio_channels = 8,
100 .caldac = {mb88341}, /* verified */
102 {.device_id = 0x02c4,
103 .name = "DAQCard-6062E",
106 .ai_fifo_depth = 8192,
108 .gainlkup = ai_gain_16,
112 .ao_fifo_depth = 2048,
113 .ao_range_table = &range_bipolar10,
116 .num_p0_dio_channels = 8,
118 .caldac = {ad8804_debug}, /* verified */
120 {.device_id = 0x075e,
121 .name = "DAQCard-6024E", /* specs incorrect! */
124 .ai_fifo_depth = 1024,
126 .gainlkup = ai_gain_16,
131 .ao_range_table = &range_bipolar10,
134 .num_p0_dio_channels = 8,
136 .caldac = {ad8804_debug},
138 {.device_id = 0x0245,
139 .name = "DAQCard-6036E", /* specs incorrect! */
142 .ai_fifo_depth = 1024,
144 .gainlkup = ai_gain_4,
149 .ao_range_table = &range_bipolar10,
152 .num_p0_dio_channels = 8,
154 .caldac = {ad8804_debug},
157 {.device_id = 0x0000, /* unknown */
158 .name = "DAQCard-6715",
163 .num_p0_dio_channels = 8,
164 .caldac = {mb88341, mb88341},
167 /* N.B. Update ni_mio_cs_ids[] when entries added above. */
170 #define interrupt_pin(a) 0
172 #define IRQ_POLARITY 1
174 #define NI_E_IRQ_FLAGS IRQF_SHARED
178 struct pcmcia_device *link;
182 #define devpriv ((struct ni_private *)dev->private)
184 /* How we access registers */
186 #define ni_writel(a, b) (outl((a), (b)+dev->iobase))
187 #define ni_readl(a) (inl((a)+dev->iobase))
188 #define ni_writew(a, b) (outw((a), (b)+dev->iobase))
189 #define ni_readw(a) (inw((a)+dev->iobase))
190 #define ni_writeb(a, b) (outb((a), (b)+dev->iobase))
191 #define ni_readb(a) (inb((a)+dev->iobase))
193 /* How we access windowed registers */
195 /* We automatically take advantage of STC registers that can be
196 * read/written directly in the I/O space of the board. The
197 * DAQCard devices map the low 8 STC registers to iobase+addr*2. */
199 static void mio_cs_win_out(struct comedi_device *dev, uint16_t data, int addr)
203 spin_lock_irqsave(&devpriv->window_lock, flags);
205 ni_writew(data, addr * 2);
207 ni_writew(addr, Window_Address);
208 ni_writew(data, Window_Data);
210 spin_unlock_irqrestore(&devpriv->window_lock, flags);
213 static uint16_t mio_cs_win_in(struct comedi_device *dev, int addr)
218 spin_lock_irqsave(&devpriv->window_lock, flags);
220 ret = ni_readw(addr * 2);
222 ni_writew(addr, Window_Address);
223 ret = ni_readw(Window_Data);
225 spin_unlock_irqrestore(&devpriv->window_lock, flags);
230 static int mio_cs_attach(struct comedi_device *dev,
231 struct comedi_devconfig *it);
232 static int mio_cs_detach(struct comedi_device *dev);
233 static struct comedi_driver driver_ni_mio_cs = {
234 .driver_name = "ni_mio_cs",
235 .module = THIS_MODULE,
236 .attach = mio_cs_attach,
237 .detach = mio_cs_detach,
240 #include "ni_mio_common.c"
242 static int ni_getboardtype(struct comedi_device *dev,
243 struct pcmcia_device *link);
245 /* clean up allocated resources */
246 /* called when driver is removed */
247 static int mio_cs_detach(struct comedi_device *dev)
249 mio_common_detach(dev);
251 /* PCMCIA layer frees the IO region */
254 free_irq(dev->irq, dev);
260 static void mio_cs_config(struct pcmcia_device *link);
261 static void cs_release(struct pcmcia_device *link);
262 static void cs_detach(struct pcmcia_device *);
264 static struct pcmcia_device *cur_dev = NULL;
265 static const dev_info_t dev_info = "ni_mio_cs";
266 static dev_node_t dev_node = {
272 static int cs_attach(struct pcmcia_device *link)
274 link->io.Attributes1 = IO_DATA_PATH_WIDTH_16;
275 link->io.NumPorts1 = 16;
276 link->irq.Attributes = IRQ_TYPE_EXCLUSIVE;
277 link->irq.IRQInfo1 = IRQ_LEVEL_ID;
278 link->conf.Attributes = CONF_ENABLE_IRQ;
279 link->conf.IntType = INT_MEMORY_AND_IO;
288 static void cs_release(struct pcmcia_device *link)
290 pcmcia_disable_device(link);
293 static void cs_detach(struct pcmcia_device *link)
295 DPRINTK("cs_detach(link=%p)\n", link);
297 if (link->dev_node) {
302 static int mio_cs_suspend(struct pcmcia_device *link)
304 DPRINTK("pm suspend\n");
309 static int mio_cs_resume(struct pcmcia_device *link)
311 DPRINTK("pm resume\n");
315 static void mio_cs_config(struct pcmcia_device *link)
320 int manfid = 0, prodid = 0;
323 DPRINTK("mio_cs_config(link=%p)\n", link);
325 tuple.TupleData = (cisdata_t *) buf;
326 tuple.TupleOffset = 0;
327 tuple.TupleDataMax = 255;
328 tuple.Attributes = 0;
330 tuple.DesiredTuple = CISTPL_CONFIG;
331 ret = pcmcia_get_first_tuple(link, &tuple);
332 ret = pcmcia_get_tuple_data(link, &tuple);
333 ret = pcmcia_parse_tuple(&tuple, &parse);
334 link->conf.ConfigBase = parse.config.base;
335 link->conf.Present = parse.config.rmask[0];
338 tuple.DesiredTuple = CISTPL_LONGLINK_MFC;
339 tuple.Attributes = TUPLE_RETURN_COMMON | TUPLE_RETURN_LINK;
340 info->multi(first_tuple(link, &tuple, &parse) == 0);
343 tuple.DesiredTuple = CISTPL_MANFID;
344 tuple.Attributes = TUPLE_RETURN_COMMON;
345 if ((pcmcia_get_first_tuple(link, &tuple) == 0) &&
346 (pcmcia_get_tuple_data(link, &tuple) == 0)) {
347 manfid = le16_to_cpu(buf[0]);
348 prodid = le16_to_cpu(buf[1]);
350 /* printk("manfid = 0x%04x, 0x%04x\n",manfid,prodid); */
352 tuple.DesiredTuple = CISTPL_CFTABLE_ENTRY;
353 tuple.Attributes = 0;
354 ret = pcmcia_get_first_tuple(link, &tuple);
355 ret = pcmcia_get_tuple_data(link, &tuple);
356 ret = pcmcia_parse_tuple(&tuple, &parse);
359 printk(" index: 0x%x\n", parse.cftable_entry.index);
360 printk(" flags: 0x%x\n", parse.cftable_entry.flags);
361 printk(" io flags: 0x%x\n", parse.cftable_entry.io.flags);
362 printk(" io nwin: 0x%x\n", parse.cftable_entry.io.nwin);
363 printk(" io base: 0x%x\n", parse.cftable_entry.io.win[0].base);
364 printk(" io len: 0x%x\n", parse.cftable_entry.io.win[0].len);
365 printk(" irq1: 0x%x\n", parse.cftable_entry.irq.IRQInfo1);
366 printk(" irq2: 0x%x\n", parse.cftable_entry.irq.IRQInfo2);
367 printk(" mem flags: 0x%x\n", parse.cftable_entry.mem.flags);
368 printk(" mem nwin: 0x%x\n", parse.cftable_entry.mem.nwin);
369 printk(" subtuples: 0x%x\n", parse.cftable_entry.subtuples);
373 link->io.NumPorts1 = 0x20;
374 link->io.IOAddrLines = 5;
375 link->io.Attributes1 = IO_DATA_PATH_WIDTH_AUTO;
377 link->io.NumPorts1 = parse.cftable_entry.io.win[0].len;
378 link->io.IOAddrLines =
379 parse.cftable_entry.io.flags & CISTPL_IO_LINES_MASK;
380 link->io.NumPorts2 = 0;
384 for (base = 0x000; base < 0x400; base += 0x20) {
385 link->io.BasePort1 = base;
386 ret = pcmcia_request_io(link, &link->io);
387 /* printk("RequestIO 0x%02x\n",ret); */
393 link->irq.IRQInfo1 = parse.cftable_entry.irq.IRQInfo1;
394 link->irq.IRQInfo2 = parse.cftable_entry.irq.IRQInfo2;
395 ret = pcmcia_request_irq(link, &link->irq);
397 printk("pcmcia_request_irq() returned error: %i\n", ret);
399 /* printk("RequestIRQ 0x%02x\n",ret); */
401 link->conf.ConfigIndex = 1;
403 ret = pcmcia_request_configuration(link, &link->conf);
404 /* printk("RequestConfiguration %d\n",ret); */
406 link->dev_node = &dev_node;
409 static int mio_cs_attach(struct comedi_device *dev, struct comedi_devconfig *it)
411 struct pcmcia_device *link;
415 DPRINTK("mio_cs_attach(dev=%p,it=%p)\n", dev, it);
417 link = cur_dev; /* XXX hack */
421 dev->driver = &driver_ni_mio_cs;
422 dev->iobase = link->io.BasePort1;
424 irq = link->irq.AssignedIRQ;
426 printk("comedi%d: %s: DAQCard: io 0x%04lx, irq %u, ",
427 dev->minor, dev->driver->driver_name, dev->iobase, irq);
433 printk(" board fingerprint:");
434 for (i = 0; i < 32; i += 2) {
435 printk(" %04x %02x", inw(dev->iobase + i),
436 inb(dev->iobase + i + 1));
439 printk(" board fingerprint (windowed):");
440 for (i = 0; i < 10; i++) {
441 printk(" 0x%04x", win_in(i));
447 dev->board_ptr = ni_boards + ni_getboardtype(dev, link);
449 printk(" %s", boardtype.name);
450 dev->board_name = boardtype.name;
452 ret = request_irq(irq, ni_E_interrupt, NI_E_IRQ_FLAGS,
455 printk(" irq not available\n");
460 /* allocate private area */
461 ret = ni_alloc_private(dev);
465 devpriv->stc_writew = &mio_cs_win_out;
466 devpriv->stc_readw = &mio_cs_win_in;
467 devpriv->stc_writel = &win_out2;
468 devpriv->stc_readl = &win_in2;
470 ret = ni_E_init(dev, it);
478 static int get_prodid(struct comedi_device *dev, struct pcmcia_device *link)
484 tuple.TupleData = (cisdata_t *) buf;
485 tuple.TupleOffset = 0;
486 tuple.TupleDataMax = 255;
487 tuple.DesiredTuple = CISTPL_MANFID;
488 tuple.Attributes = TUPLE_RETURN_COMMON;
489 if ((pcmcia_get_first_tuple(link, &tuple) == 0) &&
490 (pcmcia_get_tuple_data(link, &tuple) == 0)) {
491 prodid = le16_to_cpu(buf[1]);
497 static int ni_getboardtype(struct comedi_device *dev,
498 struct pcmcia_device *link)
503 id = get_prodid(dev, link);
505 for (i = 0; i < n_ni_boards; i++) {
506 if (ni_boards[i].device_id == id) {
511 printk("unknown board 0x%04x -- pretend it is a ", id);
518 MODULE_LICENSE("GPL");
520 static struct pcmcia_device_id ni_mio_cs_ids[] = {
521 PCMCIA_DEVICE_MANF_CARD(0x010b, 0x010d), /* DAQCard-ai-16xe-50 */
522 PCMCIA_DEVICE_MANF_CARD(0x010b, 0x010c), /* DAQCard-ai-16e-4 */
523 PCMCIA_DEVICE_MANF_CARD(0x010b, 0x02c4), /* DAQCard-6062E */
524 PCMCIA_DEVICE_MANF_CARD(0x010b, 0x075e), /* DAQCard-6024E */
525 PCMCIA_DEVICE_MANF_CARD(0x010b, 0x0245), /* DAQCard-6036E */
529 MODULE_DEVICE_TABLE(pcmcia, ni_mio_cs_ids);
531 struct pcmcia_driver ni_mio_cs_driver = {
533 .remove = &cs_detach,
534 .suspend = &mio_cs_suspend,
535 .resume = &mio_cs_resume,
536 .id_table = ni_mio_cs_ids,
537 .owner = THIS_MODULE,
543 int init_module(void)
545 pcmcia_register_driver(&ni_mio_cs_driver);
546 comedi_driver_register(&driver_ni_mio_cs);
550 void cleanup_module(void)
552 pcmcia_unregister_driver(&ni_mio_cs_driver);
554 while (cur_dev != NULL)
555 cs_detach(cur_dev->handle);
557 comedi_driver_unregister(&driver_ni_mio_cs);