2 comedi/drivers/pcmmio.c
3 Driver for Winsystems PC-104 based multifunction IO board.
5 COMEDI - Linux Control and Measurement Device Interface
6 Copyright (C) 2007 Calin A. Culianu <calin@ajvar.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.
24 Description: A driver for the PCM-MIO multifunction board
25 Devices: [Winsystems] PCM-MIO (pcmmio)
26 Author: Calin Culianu <calin@ajvar.org>
27 Updated: Wed, May 16 2007 16:21:10 -0500
30 A driver for the relatively new PCM-MIO multifunction board from
31 Winsystems. This board is a PC-104 based I/O board. It contains
33 subdevice 0 - 16 channels of 16-bit AI
34 subdevice 1 - 8 channels of 16-bit AO
35 subdevice 2 - first 24 channels of the 48 channel of DIO (with edge-triggered interrupt support)
36 subdevice 3 - last 24 channels of the 48 channel DIO (no interrupt support for this bank of channels)
40 Synchronous reads and writes are the only things implemented for AI and AO,
41 even though the hardware itself can do streaming acquisition, etc. Anyone
42 want to add asynchronous I/O for AI/AO as a feature? Be my guest...
44 Asynchronous I/O for the DIO subdevices *is* implemented, however! They are
45 basically edge-triggered interrupts for any configuration of the first
48 Also note that this interrupt support is untested.
50 A few words about edge-detection IRQ support (commands on DIO):
52 * To use edge-detection IRQ support for the DIO subdevice, pass the IRQ
53 of the board to the comedi_config command. The board IRQ is not jumpered
54 but rather configured through software, so any IRQ from 1-15 is OK.
56 * Due to the genericity of the comedi API, you need to create a special
57 comedi_command in order to use edge-triggered interrupts for DIO.
59 * Use comedi_commands with TRIG_NOW. Your callback will be called each
60 time an edge is detected on the specified DIO line(s), and the data
61 values will be two sample_t's, which should be concatenated to form
62 one 32-bit unsigned int. This value is the mask of channels that had
63 edges detected from your channel list. Note that the bits positions
64 in the mask correspond to positions in your chanlist when you
65 specified the command and *not* channel id's!
67 * To set the polarity of the edge-detection interrupts pass a nonzero value
68 for either CR_RANGE or CR_AREF for edge-up polarity, or a zero
69 value for both CR_RANGE and CR_AREF if you want edge-down polarity.
71 Configuration Options:
72 [0] - I/O port base address
73 [1] - IRQ (optional -- for edge-detect interrupt support only, leave out if you don't need this feature)
76 #include <linux/interrupt.h>
77 #include "../comedidev.h"
78 #include <linux/pci.h> /* for PCI devices */
80 /* This stuff is all from pcmuio.c -- it refers to the DIO subdevices only */
81 #define CHANS_PER_PORT 8
82 #define PORTS_PER_ASIC 6
83 #define INTR_PORTS_PER_ASIC 3
84 #define MAX_CHANS_PER_SUBDEV 24 /* number of channels per comedi subdevice */
85 #define PORTS_PER_SUBDEV (MAX_CHANS_PER_SUBDEV/CHANS_PER_PORT)
86 #define CHANS_PER_ASIC (CHANS_PER_PORT*PORTS_PER_ASIC)
87 #define INTR_CHANS_PER_ASIC 24
88 #define INTR_PORTS_PER_SUBDEV (INTR_CHANS_PER_ASIC/CHANS_PER_PORT)
89 #define MAX_DIO_CHANS (PORTS_PER_ASIC*1*CHANS_PER_PORT)
90 #define MAX_ASICS (MAX_DIO_CHANS/CHANS_PER_ASIC)
91 #define SDEV_NO ((int)(s - dev->subdevices))
92 #define CALC_N_DIO_SUBDEVS(nchans) ((nchans)/MAX_CHANS_PER_SUBDEV + (!!((nchans)%MAX_CHANS_PER_SUBDEV)) /*+ (nchans > INTR_CHANS_PER_ASIC ? 2 : 1)*/)
94 #define ASIC_IOSIZE (0x0B)
95 #define PCMMIO48_IOSIZE ASIC_IOSIZE
97 /* Some offsets - these are all in the 16byte IO memory offset from
98 the base address. Note that there is a paging scheme to swap out
99 offsets 0x8-0xA using the PAGELOCK register. See the table below.
101 Register(s) Pages R/W? Description
102 --------------------------------------------------------------
103 REG_PORTx All R/W Read/Write/Configure IO
104 REG_INT_PENDING All ReadOnly Quickly see which INT_IDx has int.
105 REG_PAGELOCK All WriteOnly Select a page
106 REG_POLx Pg. 1 only WriteOnly Select edge-detection polarity
107 REG_ENABx Pg. 2 only WriteOnly Enable/Disable edge-detect. int.
108 REG_INT_IDx Pg. 3 only R/W See which ports/bits have ints.
110 #define REG_PORT0 0x0
111 #define REG_PORT1 0x1
112 #define REG_PORT2 0x2
113 #define REG_PORT3 0x3
114 #define REG_PORT4 0x4
115 #define REG_PORT5 0x5
116 #define REG_INT_PENDING 0x6
117 #define REG_PAGELOCK 0x7 /* page selector register, upper 2 bits select a page
118 and bits 0-5 are used to 'lock down' a particular
119 port above to make it readonly. */
123 #define REG_ENAB0 0x8
124 #define REG_ENAB1 0x9
125 #define REG_ENAB2 0xA
126 #define REG_INT_ID0 0x8
127 #define REG_INT_ID1 0x9
128 #define REG_INT_ID2 0xA
130 #define NUM_PAGED_REGS 3
132 #define FIRST_PAGED_REG 0x8
133 #define REG_PAGE_BITOFFSET 6
134 #define REG_LOCK_BITOFFSET 0
135 #define REG_PAGE_MASK (~((0x1<<REG_PAGE_BITOFFSET)-1))
136 #define REG_LOCK_MASK ~(REG_PAGE_MASK)
139 #define PAGE_INT_ID 3
141 typedef int (*comedi_insn_fn_t) (struct comedi_device *, struct comedi_subdevice *,
142 struct comedi_insn *, unsigned int *);
144 static int ai_rinsn(struct comedi_device *, struct comedi_subdevice *, struct comedi_insn *,
146 static int ao_rinsn(struct comedi_device *, struct comedi_subdevice *, struct comedi_insn *,
148 static int ao_winsn(struct comedi_device *, struct comedi_subdevice *, struct comedi_insn *,
152 * Board descriptions for two imaginary boards. Describing the
153 * boards in this way is optional, and completely driver-dependent.
154 * Some drivers use arrays such as this, other do not.
156 struct pcmmio_board {
158 const int dio_num_asics;
159 const int dio_num_ports;
160 const int total_iosize;
163 const int n_ai_chans;
164 const int n_ao_chans;
165 const struct comedi_lrange *ai_range_table, *ao_range_table;
166 comedi_insn_fn_t ai_rinsn, ao_rinsn, ao_winsn;
169 static const struct comedi_lrange ranges_ai =
170 { 4, {RANGE(-5., 5.), RANGE(-10., 10.), RANGE(0., 5.), RANGE(0.,
174 static const struct comedi_lrange ranges_ao =
175 { 6, {RANGE(0., 5.), RANGE(0., 10.), RANGE(-5., 5.), RANGE(-10., 10.),
176 RANGE(-2.5, 2.5), RANGE(-2.5, 7.5)}
179 static const struct pcmmio_board pcmmio_boards[] = {
189 .ai_range_table = &ranges_ai,
190 .ao_range_table = &ranges_ao,
191 .ai_rinsn = ai_rinsn,
192 .ao_rinsn = ao_rinsn,
193 .ao_winsn = ao_winsn},
197 * Useful for shorthand access to the particular board structure
199 #define thisboard ((const struct pcmmio_board *)dev->board_ptr)
201 /* this structure is for data unique to this subdevice. */
202 struct pcmmio_subdev_private {
205 /* for DIO: mapping of halfwords (bytes) in port/chanarray to iobase */
206 unsigned long iobases[PORTS_PER_SUBDEV];
209 unsigned long iobase;
214 /* The below is only used for intr subdevices */
216 int asic; /* if non-negative, this subdev has an interrupt asic */
217 int first_chan; /* if nonnegative, the first channel id for
219 int num_asic_chans; /* the number of asic channels in this subdev
220 that have interrutps */
221 int asic_chan; /* if nonnegative, the first channel id with
222 respect to the asic that has interrupts */
223 int enabled_mask; /* subdev-relative channel mask for channels
224 we are interested in */
232 unsigned int shadow_samples[8]; /* the last unsigned int data written */
237 /* this structure is for data unique to this hardware driver. If
238 several hardware drivers keep similar information in this structure,
239 feel free to suggest moving the variable to the struct comedi_device struct. */
240 struct pcmmio_private {
243 unsigned char pagelock; /* current page and lock */
244 unsigned char pol[NUM_PAGED_REGS]; /* shadow of POLx registers */
245 unsigned char enab[NUM_PAGED_REGS]; /* shadow of ENABx registers */
247 unsigned long iobase;
251 struct pcmmio_subdev_private *sprivs;
255 * most drivers define the following macro to make it easy to
256 * access the private structure.
258 #define devpriv ((struct pcmmio_private *)dev->private)
259 #define subpriv ((struct pcmmio_subdev_private *)s->private)
261 * The struct comedi_driver structure tells the Comedi core module
262 * which functions to call to configure/deconfigure (attach/detach)
263 * the board, and also about the kernel module that contains
266 static int pcmmio_attach(struct comedi_device *dev, struct comedi_devconfig *it);
267 static int pcmmio_detach(struct comedi_device *dev);
269 static struct comedi_driver driver = {
270 .driver_name = "pcmmio",
271 .module = THIS_MODULE,
272 .attach = pcmmio_attach,
273 .detach = pcmmio_detach,
274 /* It is not necessary to implement the following members if you are
275 * writing a driver for a ISA PnP or PCI card */
276 /* Most drivers will support multiple types of boards by
277 * having an array of board structures. These were defined
278 * in pcmmio_boards[] above. Note that the element 'name'
279 * was first in the structure -- Comedi uses this fact to
280 * extract the name of the board without knowing any details
281 * about the structure except for its length.
282 * When a device is attached (by comedi_config), the name
283 * of the device is given to Comedi, and Comedi tries to
284 * match it by going through the list of board names. If
285 * there is a match, the address of the pointer is put
286 * into dev->board_ptr and driver->attach() is called.
288 * Note that these are not necessary if you can determine
289 * the type of board in software. ISA PnP, PCI, and PCMCIA
290 * devices are such boards.
292 .board_name = &pcmmio_boards[0].name,
293 .offset = sizeof(struct pcmmio_board),
294 .num_names = ARRAY_SIZE(pcmmio_boards),
297 static int pcmmio_dio_insn_bits(struct comedi_device *dev, struct comedi_subdevice *s,
298 struct comedi_insn *insn, unsigned int *data);
299 static int pcmmio_dio_insn_config(struct comedi_device *dev, struct comedi_subdevice *s,
300 struct comedi_insn *insn, unsigned int *data);
302 static irqreturn_t interrupt_pcmmio(int irq, void *d);
303 static void pcmmio_stop_intr(struct comedi_device *, struct comedi_subdevice *);
304 static int pcmmio_cancel(struct comedi_device *dev, struct comedi_subdevice *s);
305 static int pcmmio_cmd(struct comedi_device *dev, struct comedi_subdevice *s);
306 static int pcmmio_cmdtest(struct comedi_device *dev, struct comedi_subdevice *s,
307 struct comedi_cmd *cmd);
309 /* some helper functions to deal with specifics of this device's registers */
310 static void init_asics(struct comedi_device *dev); /* sets up/clears ASIC chips to defaults */
311 static void switch_page(struct comedi_device *dev, int asic, int page);
313 static void lock_port(struct comedi_device *dev, int asic, int port);
314 static void unlock_port(struct comedi_device *dev, int asic, int port);
318 * Attach is called by the Comedi core to configure the driver
319 * for a particular board. If you specified a board_name array
320 * in the driver structure, dev->board_ptr contains that
323 static int pcmmio_attach(struct comedi_device *dev, struct comedi_devconfig *it)
325 struct comedi_subdevice *s;
326 int sdev_no, chans_left, n_dio_subdevs, n_subdevs, port, asic,
328 unsigned long iobase;
329 unsigned int irq[MAX_ASICS];
331 iobase = it->options[0];
332 irq[0] = it->options[1];
334 printk("comedi%d: %s: io: %lx ", dev->minor, driver.driver_name,
337 dev->iobase = iobase;
339 if (!iobase || !request_region(iobase,
340 thisboard->total_iosize, driver.driver_name)) {
341 printk("I/O port conflict\n");
346 * Initialize dev->board_name. Note that we can use the "thisboard"
347 * macro now, since we just initialized it in the last line.
349 dev->board_name = thisboard->name;
352 * Allocate the private structure area. alloc_private() is a
353 * convenient macro defined in comedidev.h.
355 if (alloc_private(dev, sizeof(struct pcmmio_private)) < 0) {
356 printk("cannot allocate private data structure\n");
360 for (asic = 0; asic < MAX_ASICS; ++asic) {
361 devpriv->asics[asic].num = asic;
362 devpriv->asics[asic].iobase =
363 dev->iobase + 16 + asic * ASIC_IOSIZE;
364 devpriv->asics[asic].irq = 0; /* this gets actually set at the end of
365 this function when we
367 spin_lock_init(&devpriv->asics[asic].spinlock);
370 chans_left = CHANS_PER_ASIC * thisboard->dio_num_asics;
371 n_dio_subdevs = CALC_N_DIO_SUBDEVS(chans_left);
372 n_subdevs = n_dio_subdevs + 2;
374 kcalloc(n_subdevs, sizeof(struct pcmmio_subdev_private), GFP_KERNEL);
375 if (!devpriv->sprivs) {
376 printk("cannot allocate subdevice private data structures\n");
380 * Allocate the subdevice structures. alloc_subdevice() is a
381 * convenient macro defined in comedidev.h.
383 * Allocate 1 AI + 1 AO + 2 DIO subdevs (24 lines per DIO)
385 if (alloc_subdevices(dev, n_subdevs) < 0) {
386 printk("cannot allocate subdevice data structures\n");
392 s = dev->subdevices + sdev_no;
393 s->private = devpriv->sprivs + sdev_no;
394 s->maxdata = (1 << thisboard->ai_bits) - 1;
395 s->range_table = thisboard->ai_range_table;
396 s->subdev_flags = SDF_READABLE | SDF_GROUND | SDF_DIFF;
397 s->type = COMEDI_SUBD_AI;
398 s->n_chan = thisboard->n_ai_chans;
399 s->len_chanlist = s->n_chan;
400 s->insn_read = thisboard->ai_rinsn;
401 subpriv->iobase = dev->iobase + 0;
402 /* initialize the resource enable register by clearing it */
403 outb(0, subpriv->iobase + 3);
404 outb(0, subpriv->iobase + 4 + 3);
408 s = dev->subdevices + sdev_no;
409 s->private = devpriv->sprivs + sdev_no;
410 s->maxdata = (1 << thisboard->ao_bits) - 1;
411 s->range_table = thisboard->ao_range_table;
412 s->subdev_flags = SDF_READABLE;
413 s->type = COMEDI_SUBD_AO;
414 s->n_chan = thisboard->n_ao_chans;
415 s->len_chanlist = s->n_chan;
416 s->insn_read = thisboard->ao_rinsn;
417 s->insn_write = thisboard->ao_winsn;
418 subpriv->iobase = dev->iobase + 8;
419 /* initialize the resource enable register by clearing it */
420 outb(0, subpriv->iobase + 3);
421 outb(0, subpriv->iobase + 4 + 3);
426 for (; sdev_no < (int)dev->n_subdevices; ++sdev_no) {
429 s = dev->subdevices + sdev_no;
430 s->private = devpriv->sprivs + sdev_no;
432 s->range_table = &range_digital;
433 s->subdev_flags = SDF_READABLE | SDF_WRITABLE;
434 s->type = COMEDI_SUBD_DIO;
435 s->insn_bits = pcmmio_dio_insn_bits;
436 s->insn_config = pcmmio_dio_insn_config;
437 s->n_chan = min(chans_left, MAX_CHANS_PER_SUBDEV);
438 subpriv->dio.intr.asic = -1;
439 subpriv->dio.intr.first_chan = -1;
440 subpriv->dio.intr.asic_chan = -1;
441 subpriv->dio.intr.num_asic_chans = -1;
442 subpriv->dio.intr.active = 0;
445 /* save the ioport address for each 'port' of 8 channels in the
447 for (byte_no = 0; byte_no < PORTS_PER_SUBDEV; ++byte_no, ++port) {
448 if (port >= PORTS_PER_ASIC) {
453 subpriv->iobases[byte_no] =
454 devpriv->asics[asic].iobase + port;
456 if (thisasic_chanct <
457 CHANS_PER_PORT * INTR_PORTS_PER_ASIC
458 && subpriv->dio.intr.asic < 0) {
459 /* this is an interrupt subdevice, so setup the struct */
460 subpriv->dio.intr.asic = asic;
461 subpriv->dio.intr.active = 0;
462 subpriv->dio.intr.stop_count = 0;
463 subpriv->dio.intr.first_chan = byte_no * 8;
464 subpriv->dio.intr.asic_chan = thisasic_chanct;
465 subpriv->dio.intr.num_asic_chans =
467 subpriv->dio.intr.first_chan;
468 s->cancel = pcmmio_cancel;
469 s->do_cmd = pcmmio_cmd;
470 s->do_cmdtest = pcmmio_cmdtest;
472 subpriv->dio.intr.num_asic_chans;
474 thisasic_chanct += CHANS_PER_PORT;
476 spin_lock_init(&subpriv->dio.intr.spinlock);
478 chans_left -= s->n_chan;
481 asic = 0; /* reset the asic to our first asic, to do intr subdevs */
487 init_asics(dev); /* clear out all the registers, basically */
489 for (asic = 0; irq[0] && asic < MAX_ASICS; ++asic) {
491 && request_irq(irq[asic], interrupt_pcmmio,
492 IRQF_SHARED, thisboard->name, dev)) {
494 /* unroll the allocated irqs.. */
495 for (i = asic - 1; i >= 0; --i) {
496 free_irq(irq[i], dev);
497 devpriv->asics[i].irq = irq[i] = 0;
501 devpriv->asics[asic].irq = irq[asic];
504 dev->irq = irq[0]; /* grr.. wish comedi dev struct supported multiple
508 printk("irq: %u ", irq[0]);
509 if (irq[1] && thisboard->dio_num_asics == 2)
510 printk("second ASIC irq: %u ", irq[1]);
512 printk("(IRQ mode disabled) ");
515 printk("attached\n");
521 * _detach is called to deconfigure a device. It should deallocate
523 * This function is also called when _attach() fails, so it should be
524 * careful not to release resources that were not necessarily
525 * allocated by _attach(). dev->private and dev->subdevices are
526 * deallocated automatically by the core.
528 static int pcmmio_detach(struct comedi_device *dev)
532 printk("comedi%d: %s: remove\n", dev->minor, driver.driver_name);
534 release_region(dev->iobase, thisboard->total_iosize);
536 for (i = 0; i < MAX_ASICS; ++i) {
537 if (devpriv && devpriv->asics[i].irq)
538 free_irq(devpriv->asics[i].irq, dev);
541 if (devpriv && devpriv->sprivs)
542 kfree(devpriv->sprivs);
547 /* DIO devices are slightly special. Although it is possible to
548 * implement the insn_read/insn_write interface, it is much more
549 * useful to applications if you implement the insn_bits interface.
550 * This allows packed reading/writing of the DIO channels. The
551 * comedi core can convert between insn_bits and insn_read/write */
552 static int pcmmio_dio_insn_bits(struct comedi_device *dev, struct comedi_subdevice *s,
553 struct comedi_insn *insn, unsigned int *data)
560 reading a 0 means this channel was high
561 writine a 0 sets the channel high
562 reading a 1 means this channel was low
563 writing a 1 means set this channel low
565 Therefore everything is always inverted. */
567 /* The insn data is a mask in data[0] and the new data
568 * in data[1], each channel cooresponding to a bit. */
570 #ifdef DAMMIT_ITS_BROKEN
572 printk("write mask: %08x data: %08x\n", data[0], data[1]);
577 for (byte_no = 0; byte_no < s->n_chan / CHANS_PER_PORT; ++byte_no) {
578 /* address of 8-bit port */
579 unsigned long ioaddr = subpriv->iobases[byte_no],
580 /* bit offset of port in 32-bit doubleword */
581 offset = byte_no * 8;
582 /* this 8-bit port's data */
583 unsigned char byte = 0,
584 /* The write mask for this port (if any) */
585 write_mask_byte = (data[0] >> offset) & 0xff,
586 /* The data byte for this port */
587 data_byte = (data[1] >> offset) & 0xff;
589 byte = inb(ioaddr); /* read all 8-bits for this port */
591 #ifdef DAMMIT_ITS_BROKEN
593 printk("byte %d wmb %02x db %02x offset %02d io %04x, data_in %02x ", byte_no, (unsigned)write_mask_byte, (unsigned)data_byte, offset, ioaddr, (unsigned)byte);
596 if (write_mask_byte) {
597 /* this byte has some write_bits -- so set the output lines */
598 byte &= ~write_mask_byte; /* clear bits for write mask */
599 byte |= ~data_byte & write_mask_byte; /* set to inverted data_byte */
600 /* Write out the new digital output state */
603 #ifdef DAMMIT_ITS_BROKEN
605 printk("data_out_byte %02x\n", (unsigned)byte);
607 /* save the digital input lines for this byte.. */
608 s->state |= ((unsigned int)byte) << offset;
611 /* now return the DIO lines to data[1] - note they came inverted! */
614 #ifdef DAMMIT_ITS_BROKEN
616 printk("s->state %08x data_out %08x\n", s->state, data[1]);
622 /* The input or output configuration of each digital line is
623 * configured by a special insn_config instruction. chanspec
624 * contains the channel to be changed, and data[0] contains the
625 * value COMEDI_INPUT or COMEDI_OUTPUT. */
626 static int pcmmio_dio_insn_config(struct comedi_device *dev, struct comedi_subdevice *s,
627 struct comedi_insn *insn, unsigned int *data)
629 int chan = CR_CHAN(insn->chanspec), byte_no = chan / 8, bit_no =
631 unsigned long ioaddr;
634 /* Compute ioaddr for this channel */
635 ioaddr = subpriv->iobases[byte_no];
638 writing a 0 an IO channel's bit sets the channel to INPUT
639 and pulls the line high as well
641 writing a 1 to an IO channel's bit pulls the line low
643 All channels are implicitly always in OUTPUT mode -- but when
644 they are high they can be considered to be in INPUT mode..
646 Thus, we only force channels low if the config request was INPUT,
647 otherwise we do nothing to the hardware. */
650 case INSN_CONFIG_DIO_OUTPUT:
651 /* save to io_bits -- don't actually do anything since
652 all input channels are also output channels... */
653 s->io_bits |= 1 << chan;
655 case INSN_CONFIG_DIO_INPUT:
656 /* write a 0 to the actual register representing the channel
657 to set it to 'input'. 0 means "float high". */
659 byte &= ~(1 << bit_no);
660 /**< set input channel to '0' */
662 /* write out byte -- this is the only time we actually affect the
663 hardware as all channels are implicitly output -- but input
664 channels are set to float-high */
667 /* save to io_bits */
668 s->io_bits &= ~(1 << chan);
671 case INSN_CONFIG_DIO_QUERY:
672 /* retreive from shadow register */
675 io_bits & (1 << chan)) ? COMEDI_OUTPUT : COMEDI_INPUT;
687 static void init_asics(struct comedi_device *dev)
689 ASIC chip to defaults */
692 for (asic = 0; asic < thisboard->dio_num_asics; ++asic) {
694 unsigned long baseaddr = devpriv->asics[asic].iobase;
696 switch_page(dev, asic, 0); /* switch back to page 0 */
698 /* first, clear all the DIO port bits */
699 for (port = 0; port < PORTS_PER_ASIC; ++port)
700 outb(0, baseaddr + REG_PORT0 + port);
702 /* Next, clear all the paged registers for each page */
703 for (page = 1; page < NUM_PAGES; ++page) {
705 /* now clear all the paged registers */
706 switch_page(dev, asic, page);
707 for (reg = FIRST_PAGED_REG;
708 reg < FIRST_PAGED_REG + NUM_PAGED_REGS; ++reg)
709 outb(0, baseaddr + reg);
712 /* DEBUG set rising edge interrupts on port0 of both asics */
713 /*switch_page(dev, asic, PAGE_POL);
714 outb(0xff, baseaddr + REG_POL0);
715 switch_page(dev, asic, PAGE_ENAB);
716 outb(0xff, baseaddr + REG_ENAB0); */
719 switch_page(dev, asic, 0); /* switch back to default page 0 */
724 static void switch_page(struct comedi_device *dev, int asic, int page)
726 if (asic < 0 || asic >= thisboard->dio_num_asics)
727 return; /* paranoia */
728 if (page < 0 || page >= NUM_PAGES)
729 return; /* more paranoia */
731 devpriv->asics[asic].pagelock &= ~REG_PAGE_MASK;
732 devpriv->asics[asic].pagelock |= page << REG_PAGE_BITOFFSET;
734 /* now write out the shadow register */
735 outb(devpriv->asics[asic].pagelock,
736 devpriv->asics[asic].iobase + REG_PAGELOCK);
740 static void lock_port(struct comedi_device *dev, int asic, int port)
742 if (asic < 0 || asic >= thisboard->dio_num_asics)
743 return; /* paranoia */
744 if (port < 0 || port >= PORTS_PER_ASIC)
745 return; /* more paranoia */
747 devpriv->asics[asic].pagelock |= 0x1 << port;
748 /* now write out the shadow register */
749 outb(devpriv->asics[asic].pagelock,
750 devpriv->asics[asic].iobase + REG_PAGELOCK);
754 static void unlock_port(struct comedi_device *dev, int asic, int port)
756 if (asic < 0 || asic >= thisboard->dio_num_asics)
757 return; /* paranoia */
758 if (port < 0 || port >= PORTS_PER_ASIC)
759 return; /* more paranoia */
760 devpriv->asics[asic].pagelock &= ~(0x1 << port) | REG_LOCK_MASK;
761 /* now write out the shadow register */
762 outb(devpriv->asics[asic].pagelock,
763 devpriv->asics[asic].iobase + REG_PAGELOCK);
767 static irqreturn_t interrupt_pcmmio(int irq, void *d)
770 struct comedi_device *dev = (struct comedi_device *) d;
772 for (asic = 0; asic < MAX_ASICS; ++asic) {
773 if (irq == devpriv->asics[asic].irq) {
775 unsigned triggered = 0;
776 unsigned long iobase = devpriv->asics[asic].iobase;
777 /* it is an interrupt for ASIC #asic */
778 unsigned char int_pend;
780 spin_lock_irqsave(&devpriv->asics[asic].spinlock, flags);
782 int_pend = inb(iobase + REG_INT_PENDING) & 0x07;
786 for (port = 0; port < INTR_PORTS_PER_ASIC;
788 if (int_pend & (0x1 << port)) {
790 io_lines_with_edges = 0;
791 switch_page(dev, asic,
793 io_lines_with_edges =
797 if (io_lines_with_edges)
798 /* clear pending interrupt */
804 io_lines_with_edges <<
812 spin_unlock_irqrestore(&devpriv->asics[asic]. spinlock, flags);
815 struct comedi_subdevice *s;
816 /* TODO here: dispatch io lines to subdevs with commands.. */
817 printk("PCMMIO DEBUG: got edge detect interrupt %d asic %d which_chans: %06x\n", irq, asic, triggered);
818 for (s = dev->subdevices + 2;
819 s < dev->subdevices + dev->n_subdevices;
821 if (subpriv->dio.intr.asic == asic) { /* this is an interrupt subdev, and it matches this asic! */
825 spin_lock_irqsave(&subpriv->dio.intr.spinlock, flags);
827 oldevents = s->async->events;
829 if (subpriv->dio.intr.active) {
836 & ((0x1 << subpriv->dio.intr.num_asic_chans) - 1)) << subpriv->dio.intr.first_chan;
837 if (mytrig & subpriv->
851 ch = CR_CHAN(s->async->cmd.chanlist[n]);
852 if (mytrig & (1U << ch)) {
856 /* Write the scan to the buffer. */
857 if (comedi_buf_put(s->async, ((short *) &val)[0])
860 (s->async, ((short *) &val)[1])) {
861 s->async->events |= (COMEDI_CB_BLOCK | COMEDI_CB_EOS);
863 /* Overflow! Stop acquisition!! */
864 /* TODO: STOP_ACQUISITION_CALL_HERE!! */
870 /* Check for end of acquisition. */
876 /* stop_src == TRIG_COUNT */
877 if (subpriv->dio.intr.stop_count > 0) {
882 if (subpriv->dio.intr.stop_count == 0) {
883 s->async->events |= COMEDI_CB_EOA;
884 /* TODO: STOP_ACQUISITION_CALL_HERE!! */
894 spin_unlock_irqrestore(&subpriv->dio.intr.spinlock, flags);
898 comedi_event(dev, s);
909 return IRQ_NONE; /* interrupt from other source */
913 static void pcmmio_stop_intr(struct comedi_device *dev, struct comedi_subdevice *s)
915 int nports, firstport, asic, port;
917 asic = subpriv->dio.intr.asic;
919 return; /* not an interrupt subdev */
921 subpriv->dio.intr.enabled_mask = 0;
922 subpriv->dio.intr.active = 0;
923 s->async->inttrig = 0;
924 nports = subpriv->dio.intr.num_asic_chans / CHANS_PER_PORT;
925 firstport = subpriv->dio.intr.asic_chan / CHANS_PER_PORT;
926 switch_page(dev, asic, PAGE_ENAB);
927 for (port = firstport; port < firstport + nports; ++port) {
928 /* disable all intrs for this subdev.. */
929 outb(0, devpriv->asics[asic].iobase + REG_ENAB0 + port);
933 static int pcmmio_start_intr(struct comedi_device *dev, struct comedi_subdevice *s)
935 if (!subpriv->dio.intr.continuous && subpriv->dio.intr.stop_count == 0) {
936 /* An empty acquisition! */
937 s->async->events |= COMEDI_CB_EOA;
938 subpriv->dio.intr.active = 0;
941 unsigned bits = 0, pol_bits = 0, n;
942 int nports, firstport, asic, port;
943 struct comedi_cmd *cmd = &s->async->cmd;
945 asic = subpriv->dio.intr.asic;
947 return 1; /* not an interrupt
949 subpriv->dio.intr.enabled_mask = 0;
950 subpriv->dio.intr.active = 1;
951 nports = subpriv->dio.intr.num_asic_chans / CHANS_PER_PORT;
952 firstport = subpriv->dio.intr.asic_chan / CHANS_PER_PORT;
954 for (n = 0; n < cmd->chanlist_len; n++) {
955 bits |= (1U << CR_CHAN(cmd->chanlist[n]));
956 pol_bits |= (CR_AREF(cmd->chanlist[n])
957 || CR_RANGE(cmd->chanlist[n]) ? 1U : 0U)
958 << CR_CHAN(cmd->chanlist[n]);
961 bits &= ((0x1 << subpriv->dio.intr.num_asic_chans) -
962 1) << subpriv->dio.intr.first_chan;
963 subpriv->dio.intr.enabled_mask = bits;
965 { /* the below code configures the board to use a specific IRQ from 0-15. */
967 /* set resource enable register to enable IRQ operation */
968 outb(1 << 4, dev->iobase + 3);
969 /* set bits 0-3 of b to the irq number from 0-15 */
970 b = dev->irq & ((1 << 4) - 1);
971 outb(b, dev->iobase + 2);
972 /* done, we told the board what irq to use */
975 switch_page(dev, asic, PAGE_ENAB);
976 for (port = firstport; port < firstport + nports; ++port) {
978 bits >> (subpriv->dio.intr.first_chan + (port -
979 firstport) * 8) & 0xff, pol =
980 pol_bits >> (subpriv->dio.intr.first_chan +
981 (port - firstport) * 8) & 0xff;
982 /* set enab intrs for this subdev.. */
984 devpriv->asics[asic].iobase + REG_ENAB0 + port);
985 switch_page(dev, asic, PAGE_POL);
987 devpriv->asics[asic].iobase + REG_ENAB0 + port);
993 static int pcmmio_cancel(struct comedi_device *dev, struct comedi_subdevice *s)
997 spin_lock_irqsave(&subpriv->dio.intr.spinlock, flags);
998 if (subpriv->dio.intr.active)
999 pcmmio_stop_intr(dev, s);
1000 spin_unlock_irqrestore(&subpriv->dio.intr.spinlock, flags);
1006 * Internal trigger function to start acquisition for an 'INTERRUPT' subdevice.
1009 pcmmio_inttrig_start_intr(struct comedi_device *dev, struct comedi_subdevice *s,
1010 unsigned int trignum)
1012 unsigned long flags;
1018 spin_lock_irqsave(&subpriv->dio.intr.spinlock, flags);
1019 s->async->inttrig = 0;
1020 if (subpriv->dio.intr.active) {
1021 event = pcmmio_start_intr(dev, s);
1023 spin_unlock_irqrestore(&subpriv->dio.intr.spinlock, flags);
1026 comedi_event(dev, s);
1033 * 'do_cmd' function for an 'INTERRUPT' subdevice.
1035 static int pcmmio_cmd(struct comedi_device *dev, struct comedi_subdevice *s)
1037 struct comedi_cmd *cmd = &s->async->cmd;
1038 unsigned long flags;
1041 spin_lock_irqsave(&subpriv->dio.intr.spinlock, flags);
1042 subpriv->dio.intr.active = 1;
1044 /* Set up end of acquisition. */
1045 switch (cmd->stop_src) {
1047 subpriv->dio.intr.continuous = 0;
1048 subpriv->dio.intr.stop_count = cmd->stop_arg;
1052 subpriv->dio.intr.continuous = 1;
1053 subpriv->dio.intr.stop_count = 0;
1057 /* Set up start of acquisition. */
1058 switch (cmd->start_src) {
1060 s->async->inttrig = pcmmio_inttrig_start_intr;
1064 event = pcmmio_start_intr(dev, s);
1067 spin_unlock_irqrestore(&subpriv->dio.intr.spinlock, flags);
1070 comedi_event(dev, s);
1077 * 'do_cmdtest' function for an 'INTERRUPT' subdevice.
1080 pcmmio_cmdtest(struct comedi_device *dev, struct comedi_subdevice *s, struct comedi_cmd *cmd)
1085 /* step 1: make sure trigger sources are trivially valid */
1087 tmp = cmd->start_src;
1088 cmd->start_src &= (TRIG_NOW | TRIG_INT);
1089 if (!cmd->start_src || tmp != cmd->start_src)
1092 tmp = cmd->scan_begin_src;
1093 cmd->scan_begin_src &= TRIG_EXT;
1094 if (!cmd->scan_begin_src || tmp != cmd->scan_begin_src)
1097 tmp = cmd->convert_src;
1098 cmd->convert_src &= TRIG_NOW;
1099 if (!cmd->convert_src || tmp != cmd->convert_src)
1102 tmp = cmd->scan_end_src;
1103 cmd->scan_end_src &= TRIG_COUNT;
1104 if (!cmd->scan_end_src || tmp != cmd->scan_end_src)
1107 tmp = cmd->stop_src;
1108 cmd->stop_src &= (TRIG_COUNT | TRIG_NONE);
1109 if (!cmd->stop_src || tmp != cmd->stop_src)
1115 /* step 2: make sure trigger sources are unique and mutually compatible */
1117 /* these tests are true if more than one _src bit is set */
1118 if ((cmd->start_src & (cmd->start_src - 1)) != 0)
1120 if ((cmd->scan_begin_src & (cmd->scan_begin_src - 1)) != 0)
1122 if ((cmd->convert_src & (cmd->convert_src - 1)) != 0)
1124 if ((cmd->scan_end_src & (cmd->scan_end_src - 1)) != 0)
1126 if ((cmd->stop_src & (cmd->stop_src - 1)) != 0)
1132 /* step 3: make sure arguments are trivially compatible */
1134 /* cmd->start_src == TRIG_NOW || cmd->start_src == TRIG_INT */
1135 if (cmd->start_arg != 0) {
1140 /* cmd->scan_begin_src == TRIG_EXT */
1141 if (cmd->scan_begin_arg != 0) {
1142 cmd->scan_begin_arg = 0;
1146 /* cmd->convert_src == TRIG_NOW */
1147 if (cmd->convert_arg != 0) {
1148 cmd->convert_arg = 0;
1152 /* cmd->scan_end_src == TRIG_COUNT */
1153 if (cmd->scan_end_arg != cmd->chanlist_len) {
1154 cmd->scan_end_arg = cmd->chanlist_len;
1158 switch (cmd->stop_src) {
1160 /* any count allowed */
1163 if (cmd->stop_arg != 0) {
1175 /* step 4: fix up any arguments */
1177 /* if (err) return 4; */
1182 static int adc_wait_ready(unsigned long iobase)
1184 unsigned long retry = 100000;
1186 if (inb(iobase + 3) & 0x80)
1191 /* All this is for AI and AO */
1192 static int ai_rinsn(struct comedi_device *dev, struct comedi_subdevice *s,
1193 struct comedi_insn *insn, unsigned int *data)
1196 unsigned long iobase = subpriv->iobase;
1199 1. write the CMD byte (to BASE+2)
1200 2. read junk lo byte (BASE+0)
1201 3. read junk hi byte (BASE+1)
1202 4. (mux settled so) write CMD byte again (BASE+2)
1203 5. read valid lo byte(BASE+0)
1204 6. read valid hi byte(BASE+1)
1206 Additionally note that the BASE += 4 if the channel >= 8
1209 /* convert n samples */
1210 for (n = 0; n < insn->n; n++) {
1211 unsigned chan = CR_CHAN(insn->chanspec), range =
1212 CR_RANGE(insn->chanspec), aref =
1213 CR_AREF(insn->chanspec);
1214 unsigned char command_byte = 0;
1215 unsigned iooffset = 0;
1216 short sample, adc_adjust = 0;
1219 chan -= 8, iooffset = 4; /* use the second dword for channels > 7 */
1221 if (aref != AREF_DIFF) {
1223 command_byte |= 1 << 7; /* set bit 7 to indicate single-ended */
1226 adc_adjust = 0x8000; /* bipolar ranges (-5,5 .. -10,10 need to be adjusted -- that is.. they need to wrap around by adding 0x8000 */
1229 command_byte |= 1 << 6; /* odd-numbered channels have bit 6 set */
1232 /* select the channel, bits 4-5 == chan/2 */
1233 command_byte |= ((chan / 2) & 0x3) << 4;
1235 /* set the range, bits 2-3 */
1236 command_byte |= (range & 0x3) << 2;
1238 /* need to do this twice to make sure mux settled */
1239 outb(command_byte, iobase + iooffset + 2); /* chan/range/aref select */
1241 adc_wait_ready(iobase + iooffset); /* wait for the adc to say it finised the conversion */
1243 outb(command_byte, iobase + iooffset + 2); /* select the chan/range/aref AGAIN */
1245 adc_wait_ready(iobase + iooffset);
1247 sample = inb(iobase + iooffset + 0); /* read data lo byte */
1248 sample |= inb(iobase + iooffset + 1) << 8; /* read data hi byte */
1249 sample += adc_adjust; /* adjustment .. munge data */
1252 /* return the number of samples read/written */
1256 static int ao_rinsn(struct comedi_device *dev, struct comedi_subdevice *s,
1257 struct comedi_insn *insn, unsigned int *data)
1260 for (n = 0; n < insn->n; n++) {
1261 unsigned chan = CR_CHAN(insn->chanspec);
1262 if (chan < s->n_chan)
1263 data[n] = subpriv->ao.shadow_samples[chan];
1268 static int wait_dac_ready(unsigned long iobase)
1270 unsigned long retry = 100000L;
1272 /* This may seem like an absurd way to handle waiting and violates the
1273 "no busy waiting" policy. The fact is that the hardware is
1274 normally so fast that we usually only need one time through the loop
1275 anyway. The longer timeout is for rare occasions and for detecting
1276 non-existant hardware. */
1279 if (inb(iobase + 3) & 0x80)
1286 static int ao_winsn(struct comedi_device *dev, struct comedi_subdevice *s,
1287 struct comedi_insn *insn, unsigned int *data)
1290 unsigned iobase = subpriv->iobase, iooffset = 0;
1292 for (n = 0; n < insn->n; n++) {
1293 unsigned chan = CR_CHAN(insn->chanspec), range =
1294 CR_RANGE(insn->chanspec);
1295 if (chan < s->n_chan) {
1296 unsigned char command_byte = 0, range_byte =
1297 range & ((1 << 4) - 1);
1299 chan -= 4, iooffset += 4;
1300 /* set the range.. */
1301 outb(range_byte, iobase + iooffset + 0);
1302 outb(0, iobase + iooffset + 1);
1304 /* tell it to begin */
1305 command_byte = (chan << 1) | 0x60;
1306 outb(command_byte, iobase + iooffset + 2);
1308 wait_dac_ready(iobase + iooffset);
1310 outb(data[n] & 0xff, iobase + iooffset + 0); /* low order byte */
1311 outb((data[n] >> 8) & 0xff, iobase + iooffset + 1); /* high order byte */
1312 command_byte = 0x70 | (chan << 1); /* set bit 4 of command byte to indicate data is loaded and trigger conversion */
1313 /* trigger converion */
1314 outb(command_byte, iobase + iooffset + 2);
1316 wait_dac_ready(iobase + iooffset);
1318 subpriv->ao.shadow_samples[chan] = data[n]; /* save to shadow register for ao_rinsn */
1325 * A convenient macro that defines init_module() and cleanup_module(),
1328 COMEDI_INITCLEANUP(driver);