2 comedi/drivers/ni_labpc.c
3 Driver for National Instruments Lab-PC series boards and compatibles
4 Copyright (C) 2001, 2002, 2003 Frank Mori Hess <fmhess@users.sourceforge.net>
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 ************************************************************************
24 Description: National Instruments Lab-PC (& compatibles)
25 Author: Frank Mori Hess <fmhess@users.sourceforge.net>
26 Devices: [National Instruments] Lab-PC-1200 (labpc-1200),
27 Lab-PC-1200AI (labpc-1200ai), Lab-PC+ (lab-pc+), PCI-1200 (ni_labpc)
30 Tested with lab-pc-1200. For the older Lab-PC+, not all input ranges
31 and analog references will work, the available ranges/arefs will
32 depend on how you have configured the jumpers on your board
33 (see your owner's manual).
35 Kernel-level ISA plug-and-play support for the lab-pc-1200
37 yet been added to the driver, mainly due to the fact that
38 I don't know the device id numbers. If you have one
40 please file a bug report at https://bugs.comedi.org/
41 so I can get the necessary information from you.
43 The 1200 series boards have onboard calibration dacs for correcting
44 analog input/output offsets and gains. The proper settings for these
45 caldacs are stored on the board's eeprom. To read the caldac values
46 from the eeprom and store them into a file that can be then be used by
47 comedilib, use the comedi_calibrate program.
49 Configuration options - ISA boards:
50 [0] - I/O port base address
51 [1] - IRQ (optional, required for timed or externally triggered conversions)
52 [2] - DMA channel (optional)
54 Configuration options - PCI boards:
58 The Lab-pc+ has quirky chanlist requirements
59 when scanning multiple channels. Multiple channel scan
60 sequence must start at highest channel, then decrement down to
61 channel 0. The rest of the cards can scan down like lab-pc+ or scan
62 up from channel zero. Chanlists consisting of all one channel
63 are also legal, and allow you to pace conversions in bursts.
70 341309a (labpc-1200 register manual)
77 /* #define LABPC_DEBUG enable debugging messages */
79 #include <linux/interrupt.h>
80 #include "../comedidev.h"
82 #include <linux/delay.h>
88 #include "comedi_fc.h"
91 #define DRV_NAME "ni_labpc"
93 #define LABPC_SIZE 32 /* size of io region used by board */
94 #define LABPC_TIMER_BASE 500 /* 2 MHz master clock */
96 /* Registers for the lab-pc+ */
98 /* write-only registers */
99 #define COMMAND1_REG 0x0
100 #define ADC_GAIN_MASK (0x7 << 4)
101 #define ADC_CHAN_BITS(x) ((x) & 0x7)
102 #define ADC_SCAN_EN_BIT 0x80 /* enables multi channel scans */
103 #define COMMAND2_REG 0x1
104 #define PRETRIG_BIT 0x1 /* enable pretriggering (used in conjunction with SWTRIG) */
105 #define HWTRIG_BIT 0x2 /* enable paced conversions on external trigger */
106 #define SWTRIG_BIT 0x4 /* enable paced conversions */
107 #define CASCADE_BIT 0x8 /* use two cascaded counters for pacing */
108 #define DAC_PACED_BIT(channel) (0x40 << ((channel) & 0x1))
109 #define COMMAND3_REG 0x2
110 #define DMA_EN_BIT 0x1 /* enable dma transfers */
111 #define DIO_INTR_EN_BIT 0x2 /* enable interrupts for 8255 */
112 #define DMATC_INTR_EN_BIT 0x4 /* enable dma terminal count interrupt */
113 #define TIMER_INTR_EN_BIT 0x8 /* enable timer interrupt */
114 #define ERR_INTR_EN_BIT 0x10 /* enable error interrupt */
115 #define ADC_FNE_INTR_EN_BIT 0x20 /* enable fifo not empty interrupt */
116 #define ADC_CONVERT_REG 0x3
117 #define DAC_LSB_REG(channel) (0x4 + 2 * ((channel) & 0x1))
118 #define DAC_MSB_REG(channel) (0x5 + 2 * ((channel) & 0x1))
119 #define ADC_CLEAR_REG 0x8
120 #define DMATC_CLEAR_REG 0xa
121 #define TIMER_CLEAR_REG 0xc
122 #define COMMAND6_REG 0xe /* 1200 boards only */
123 #define ADC_COMMON_BIT 0x1 /* select ground or common-mode reference */
124 #define ADC_UNIP_BIT 0x2 /* adc unipolar */
125 #define DAC_UNIP_BIT(channel) (0x4 << ((channel) & 0x1)) /* dac unipolar */
126 #define ADC_FHF_INTR_EN_BIT 0x20 /* enable fifo half full interrupt */
127 #define A1_INTR_EN_BIT 0x40 /* enable interrupt on end of hardware count */
128 #define ADC_SCAN_UP_BIT 0x80 /* scan up from channel zero instead of down to zero */
129 #define COMMAND4_REG 0xf
130 #define INTERVAL_SCAN_EN_BIT 0x1 /* enables 'interval' scanning */
131 #define EXT_SCAN_EN_BIT 0x2 /* enables external signal on counter b1 output to trigger scan */
132 #define EXT_CONVERT_OUT_BIT 0x4 /* chooses direction (output or input) for EXTCONV* line */
133 #define ADC_DIFF_BIT 0x8 /* chooses differential inputs for adc (in conjunction with board jumper) */
134 #define EXT_CONVERT_DISABLE_BIT 0x10
135 #define COMMAND5_REG 0x1c /* 1200 boards only, calibration stuff */
136 #define EEPROM_WRITE_UNPROTECT_BIT 0x4 /* enable eeprom for write */
137 #define DITHER_EN_BIT 0x8 /* enable dithering */
138 #define CALDAC_LOAD_BIT 0x10 /* load calibration dac */
139 #define SCLOCK_BIT 0x20 /* serial clock - rising edge writes, falling edge reads */
140 #define SDATA_BIT 0x40 /* serial data bit for writing to eeprom or calibration dacs */
141 #define EEPROM_EN_BIT 0x80 /* enable eeprom for read/write */
142 #define INTERVAL_COUNT_REG 0x1e
143 #define INTERVAL_LOAD_REG 0x1f
144 #define INTERVAL_LOAD_BITS 0x1
146 /* read-only registers */
147 #define STATUS1_REG 0x0
148 #define DATA_AVAIL_BIT 0x1 /* data is available in fifo */
149 #define OVERRUN_BIT 0x2 /* overrun has occurred */
150 #define OVERFLOW_BIT 0x4 /* fifo overflow */
151 #define TIMER_BIT 0x8 /* timer interrupt has occured */
152 #define DMATC_BIT 0x10 /* dma terminal count has occured */
153 #define EXT_TRIG_BIT 0x40 /* external trigger has occured */
154 #define STATUS2_REG 0x1d /* 1200 boards only */
155 #define EEPROM_OUT_BIT 0x1 /* programmable eeprom serial output */
156 #define A1_TC_BIT 0x2 /* counter A1 terminal count */
157 #define FNHF_BIT 0x4 /* fifo not half full */
158 #define ADC_FIFO_REG 0xa
160 #define DIO_BASE_REG 0x10
161 #define COUNTER_A_BASE_REG 0x14
162 #define COUNTER_A_CONTROL_REG (COUNTER_A_BASE_REG + 0x3)
163 #define INIT_A0_BITS 0x14 /* check modes put conversion pacer output in harmless state (a0 mode 2) */
164 #define INIT_A1_BITS 0x70 /* put hardware conversion counter output in harmless state (a1 mode 0) */
165 #define COUNTER_B_BASE_REG 0x18
167 static int labpc_attach(struct comedi_device *dev, struct comedi_devconfig *it);
168 static int labpc_cancel(struct comedi_device *dev, struct comedi_subdevice *s);
169 static irqreturn_t labpc_interrupt(int irq, void *d);
170 static int labpc_drain_fifo(struct comedi_device *dev);
171 static void labpc_drain_dma(struct comedi_device *dev);
172 static void handle_isa_dma(struct comedi_device *dev);
173 static void labpc_drain_dregs(struct comedi_device *dev);
174 static int labpc_ai_cmdtest(struct comedi_device *dev,
175 struct comedi_subdevice *s, struct comedi_cmd *cmd);
176 static int labpc_ai_cmd(struct comedi_device *dev, struct comedi_subdevice *s);
177 static int labpc_ai_rinsn(struct comedi_device *dev, struct comedi_subdevice *s,
178 struct comedi_insn *insn, unsigned int *data);
179 static int labpc_ao_winsn(struct comedi_device *dev, struct comedi_subdevice *s,
180 struct comedi_insn *insn, unsigned int *data);
181 static int labpc_ao_rinsn(struct comedi_device *dev, struct comedi_subdevice *s,
182 struct comedi_insn *insn, unsigned int *data);
183 static int labpc_calib_read_insn(struct comedi_device *dev,
184 struct comedi_subdevice *s,
185 struct comedi_insn *insn, unsigned int *data);
186 static int labpc_calib_write_insn(struct comedi_device *dev,
187 struct comedi_subdevice *s,
188 struct comedi_insn *insn, unsigned int *data);
189 static int labpc_eeprom_read_insn(struct comedi_device *dev,
190 struct comedi_subdevice *s,
191 struct comedi_insn *insn, unsigned int *data);
192 static int labpc_eeprom_write_insn(struct comedi_device *dev,
193 struct comedi_subdevice *s,
194 struct comedi_insn *insn,
196 static unsigned int labpc_suggest_transfer_size(struct comedi_cmd cmd);
197 static void labpc_adc_timing(struct comedi_device *dev, struct comedi_cmd *cmd);
198 #ifdef CONFIG_COMEDI_PCI
199 static int labpc_find_device(struct comedi_device *dev, int bus, int slot);
201 static int labpc_dio_mem_callback(int dir, int port, int data,
203 static void labpc_serial_out(struct comedi_device *dev, unsigned int value,
204 unsigned int num_bits);
205 static unsigned int labpc_serial_in(struct comedi_device *dev);
206 static unsigned int labpc_eeprom_read(struct comedi_device *dev,
207 unsigned int address);
208 static unsigned int labpc_eeprom_read_status(struct comedi_device *dev);
209 static unsigned int labpc_eeprom_write(struct comedi_device *dev,
210 unsigned int address,
212 static void write_caldac(struct comedi_device *dev, unsigned int channel,
217 MODE_SINGLE_CHAN_INTERVAL,
222 /* analog input ranges */
223 #define NUM_LABPC_PLUS_AI_RANGES 16
224 /* indicates unipolar ranges */
225 static const int labpc_plus_is_unipolar[NUM_LABPC_PLUS_AI_RANGES] = {
244 /* map range index to gain bits */
245 static const int labpc_plus_ai_gain_bits[NUM_LABPC_PLUS_AI_RANGES] = {
264 static const struct comedi_lrange range_labpc_plus_ai = {
265 NUM_LABPC_PLUS_AI_RANGES,
286 #define NUM_LABPC_1200_AI_RANGES 14
287 /* indicates unipolar ranges */
288 const int labpc_1200_is_unipolar[NUM_LABPC_1200_AI_RANGES] = {
305 /* map range index to gain bits */
306 const int labpc_1200_ai_gain_bits[NUM_LABPC_1200_AI_RANGES] = {
323 const struct comedi_lrange range_labpc_1200_ai = {
324 NUM_LABPC_1200_AI_RANGES,
343 /* analog output ranges */
344 #define AO_RANGE_IS_UNIPOLAR 0x1
345 static const struct comedi_lrange range_labpc_ao = {
353 /* functions that do inb/outb and readb/writeb so we can use
354 * function pointers to decide which to use */
355 static inline unsigned int labpc_inb(unsigned long address)
360 static inline void labpc_outb(unsigned int byte, unsigned long address)
365 static inline unsigned int labpc_readb(unsigned long address)
367 return readb((void *)address);
370 static inline void labpc_writeb(unsigned int byte, unsigned long address)
372 writeb(byte, (void *)address);
375 static const struct labpc_board_struct labpc_boards[] = {
377 .name = "lab-pc-1200",
379 .bustype = isa_bustype,
380 .register_layout = labpc_1200_layout,
382 .ai_range_table = &range_labpc_1200_ai,
383 .ai_range_code = labpc_1200_ai_gain_bits,
384 .ai_range_is_unipolar = labpc_1200_is_unipolar,
386 .memory_mapped_io = 0,
389 .name = "lab-pc-1200ai",
391 .bustype = isa_bustype,
392 .register_layout = labpc_1200_layout,
394 .ai_range_table = &range_labpc_1200_ai,
395 .ai_range_code = labpc_1200_ai_gain_bits,
396 .ai_range_is_unipolar = labpc_1200_is_unipolar,
398 .memory_mapped_io = 0,
403 .bustype = isa_bustype,
404 .register_layout = labpc_plus_layout,
406 .ai_range_table = &range_labpc_plus_ai,
407 .ai_range_code = labpc_plus_ai_gain_bits,
408 .ai_range_is_unipolar = labpc_plus_is_unipolar,
410 .memory_mapped_io = 0,
412 #ifdef CONFIG_COMEDI_PCI
417 .bustype = pci_bustype,
418 .register_layout = labpc_1200_layout,
420 .ai_range_table = &range_labpc_1200_ai,
421 .ai_range_code = labpc_1200_ai_gain_bits,
422 .ai_range_is_unipolar = labpc_1200_is_unipolar,
424 .memory_mapped_io = 1,
426 /* dummy entry so pci board works when comedi_config is passed driver name */
429 .bustype = pci_bustype,
435 * Useful for shorthand access to the particular board structure
437 #define thisboard ((struct labpc_board_struct *)dev->board_ptr)
439 static const int dma_buffer_size = 0xff00; /* size in bytes of dma buffer */
440 static const int sample_size = 2; /* 2 bytes per sample */
442 #define devpriv ((struct labpc_private *)dev->private)
444 static struct comedi_driver driver_labpc = {
445 .driver_name = DRV_NAME,
446 .module = THIS_MODULE,
447 .attach = labpc_attach,
448 .detach = labpc_common_detach,
449 .num_names = ARRAY_SIZE(labpc_boards),
450 .board_name = &labpc_boards[0].name,
451 .offset = sizeof(struct labpc_board_struct),
454 #ifdef CONFIG_COMEDI_PCI
455 static DEFINE_PCI_DEVICE_TABLE(labpc_pci_table) = {
457 PCI_VENDOR_ID_NATINST, 0x161, PCI_ANY_ID, PCI_ANY_ID, 0, 0, 0}, {
461 MODULE_DEVICE_TABLE(pci, labpc_pci_table);
462 #endif /* CONFIG_COMEDI_PCI */
464 static inline int labpc_counter_load(struct comedi_device *dev,
465 unsigned long base_address,
466 unsigned int counter_number,
467 unsigned int count, unsigned int mode)
469 if (thisboard->memory_mapped_io)
470 return i8254_mm_load((void *)base_address, 0, counter_number,
473 return i8254_load(base_address, 0, counter_number, count, mode);
476 int labpc_common_attach(struct comedi_device *dev, unsigned long iobase,
477 unsigned int irq, unsigned int dma_chan)
479 struct comedi_subdevice *s;
481 unsigned long dma_flags, isr_flags;
484 printk("comedi%d: ni_labpc: %s, io 0x%lx", dev->minor, thisboard->name,
487 printk(", irq %u", irq);
490 printk(", dma %u", dma_chan);
495 printk("io base address is zero!\n");
498 /* request io regions for isa boards */
499 if (thisboard->bustype == isa_bustype) {
500 /* check if io addresses are available */
501 if (!request_region(iobase, LABPC_SIZE,
502 driver_labpc.driver_name)) {
503 printk("I/O port conflict\n");
507 dev->iobase = iobase;
509 if (thisboard->memory_mapped_io) {
510 devpriv->read_byte = labpc_readb;
511 devpriv->write_byte = labpc_writeb;
513 devpriv->read_byte = labpc_inb;
514 devpriv->write_byte = labpc_outb;
516 /* initialize board's command registers */
517 devpriv->write_byte(devpriv->command1_bits, dev->iobase + COMMAND1_REG);
518 devpriv->write_byte(devpriv->command2_bits, dev->iobase + COMMAND2_REG);
519 devpriv->write_byte(devpriv->command3_bits, dev->iobase + COMMAND3_REG);
520 devpriv->write_byte(devpriv->command4_bits, dev->iobase + COMMAND4_REG);
521 if (thisboard->register_layout == labpc_1200_layout) {
522 devpriv->write_byte(devpriv->command5_bits,
523 dev->iobase + COMMAND5_REG);
524 devpriv->write_byte(devpriv->command6_bits,
525 dev->iobase + COMMAND6_REG);
531 if (thisboard->bustype == pci_bustype)
532 isr_flags |= IRQF_SHARED;
533 if (request_irq(irq, labpc_interrupt, isr_flags,
534 driver_labpc.driver_name, dev)) {
535 printk("unable to allocate irq %u\n", irq);
541 /* grab dma channel */
543 printk(" invalid dma channel %u\n", dma_chan);
545 } else if (dma_chan) {
546 /* allocate dma buffer */
547 devpriv->dma_buffer =
548 kmalloc(dma_buffer_size, GFP_KERNEL | GFP_DMA);
549 if (devpriv->dma_buffer == NULL) {
550 printk(" failed to allocate dma buffer\n");
553 if (request_dma(dma_chan, driver_labpc.driver_name)) {
554 printk(" failed to allocate dma channel %u\n",
558 devpriv->dma_chan = dma_chan;
559 dma_flags = claim_dma_lock();
560 disable_dma(devpriv->dma_chan);
561 set_dma_mode(devpriv->dma_chan, DMA_MODE_READ);
562 release_dma_lock(dma_flags);
565 dev->board_name = thisboard->name;
567 if (alloc_subdevices(dev, 5) < 0)
570 /* analog input subdevice */
571 s = dev->subdevices + 0;
572 dev->read_subdev = s;
573 s->type = COMEDI_SUBD_AI;
575 SDF_READABLE | SDF_GROUND | SDF_COMMON | SDF_DIFF | SDF_CMD_READ;
578 s->maxdata = (1 << 12) - 1; /* 12 bit resolution */
579 s->range_table = thisboard->ai_range_table;
580 s->do_cmd = labpc_ai_cmd;
581 s->do_cmdtest = labpc_ai_cmdtest;
582 s->insn_read = labpc_ai_rinsn;
583 s->cancel = labpc_cancel;
586 s = dev->subdevices + 1;
587 if (thisboard->has_ao) {
588 /* Could provide command support, except it only has a one sample
589 * hardware buffer for analog output and no underrun flag. */
590 s->type = COMEDI_SUBD_AO;
591 s->subdev_flags = SDF_READABLE | SDF_WRITABLE | SDF_GROUND;
592 s->n_chan = NUM_AO_CHAN;
593 s->maxdata = (1 << 12) - 1; /* 12 bit resolution */
594 s->range_table = &range_labpc_ao;
595 s->insn_read = labpc_ao_rinsn;
596 s->insn_write = labpc_ao_winsn;
597 /* initialize analog outputs to a known value */
598 for (i = 0; i < s->n_chan; i++) {
599 devpriv->ao_value[i] = s->maxdata / 2;
600 lsb = devpriv->ao_value[i] & 0xff;
601 msb = (devpriv->ao_value[i] >> 8) & 0xff;
602 devpriv->write_byte(lsb, dev->iobase + DAC_LSB_REG(i));
603 devpriv->write_byte(msb, dev->iobase + DAC_MSB_REG(i));
606 s->type = COMEDI_SUBD_UNUSED;
610 s = dev->subdevices + 2;
611 /* if board uses io memory we have to give a custom callback function to the 8255 driver */
612 if (thisboard->memory_mapped_io)
613 subdev_8255_init(dev, s, labpc_dio_mem_callback,
614 (unsigned long)(dev->iobase + DIO_BASE_REG));
616 subdev_8255_init(dev, s, NULL, dev->iobase + DIO_BASE_REG);
618 /* calibration subdevices for boards that have one */
619 s = dev->subdevices + 3;
620 if (thisboard->register_layout == labpc_1200_layout) {
621 s->type = COMEDI_SUBD_CALIB;
622 s->subdev_flags = SDF_READABLE | SDF_WRITABLE | SDF_INTERNAL;
625 s->insn_read = labpc_calib_read_insn;
626 s->insn_write = labpc_calib_write_insn;
628 for (i = 0; i < s->n_chan; i++)
629 write_caldac(dev, i, s->maxdata / 2);
631 s->type = COMEDI_SUBD_UNUSED;
634 s = dev->subdevices + 4;
635 if (thisboard->register_layout == labpc_1200_layout) {
636 s->type = COMEDI_SUBD_MEMORY;
637 s->subdev_flags = SDF_READABLE | SDF_WRITABLE | SDF_INTERNAL;
638 s->n_chan = EEPROM_SIZE;
640 s->insn_read = labpc_eeprom_read_insn;
641 s->insn_write = labpc_eeprom_write_insn;
643 for (i = 0; i < EEPROM_SIZE; i++) {
644 devpriv->eeprom_data[i] = labpc_eeprom_read(dev, i);
648 for (i = 0; i < EEPROM_SIZE; i++) {
649 printk(" %i:0x%x ", i, devpriv->eeprom_data[i]);
654 s->type = COMEDI_SUBD_UNUSED;
659 static int labpc_attach(struct comedi_device *dev, struct comedi_devconfig *it)
661 unsigned long iobase = 0;
662 unsigned int irq = 0;
663 unsigned int dma_chan = 0;
664 #ifdef CONFIG_COMEDI_PCI
668 /* allocate and initialize dev->private */
669 if (alloc_private(dev, sizeof(struct labpc_private)) < 0)
672 /* get base address, irq etc. based on bustype */
673 switch (thisboard->bustype) {
675 iobase = it->options[0];
676 irq = it->options[1];
677 dma_chan = it->options[2];
680 #ifdef CONFIG_COMEDI_PCI
681 retval = labpc_find_device(dev, it->options[0], it->options[1]);
685 retval = mite_setup(devpriv->mite);
688 iobase = (unsigned long)devpriv->mite->daq_io_addr;
689 irq = mite_irq(devpriv->mite);
691 printk(" this driver has not been built with PCI support.\n");
697 (" this driver does not support pcmcia cards, use ni_labpc_cs.o\n");
701 printk("bug! couldn't determine board type\n");
706 return labpc_common_attach(dev, iobase, irq, dma_chan);
709 /* adapted from ni_pcimio for finding mite based boards (pc-1200) */
710 #ifdef CONFIG_COMEDI_PCI
711 static int labpc_find_device(struct comedi_device *dev, int bus, int slot)
713 struct mite_struct *mite;
715 for (mite = mite_devices; mite; mite = mite->next) {
718 /* if bus/slot are specified then make sure we have the right bus/slot */
720 if (bus != mite->pcidev->bus->number
721 || slot != PCI_SLOT(mite->pcidev->devfn))
724 for (i = 0; i < driver_labpc.num_names; i++) {
725 if (labpc_boards[i].bustype != pci_bustype)
727 if (mite_device_id(mite) == labpc_boards[i].device_id) {
728 devpriv->mite = mite;
729 /* fixup board pointer, in case we were using the dummy "ni_labpc" entry */
730 dev->board_ptr = &labpc_boards[i];
735 printk("no device found\n");
741 int labpc_common_detach(struct comedi_device *dev)
743 printk("comedi%d: ni_labpc: detach\n", dev->minor);
746 subdev_8255_cleanup(dev, dev->subdevices + 2);
748 /* only free stuff if it has been allocated by _attach */
749 if (devpriv->dma_buffer)
750 kfree(devpriv->dma_buffer);
751 if (devpriv->dma_chan)
752 free_dma(devpriv->dma_chan);
754 free_irq(dev->irq, dev);
755 if (thisboard->bustype == isa_bustype && dev->iobase)
756 release_region(dev->iobase, LABPC_SIZE);
757 #ifdef CONFIG_COMEDI_PCI
759 mite_unsetup(devpriv->mite);
765 static void labpc_clear_adc_fifo(const struct comedi_device *dev)
767 devpriv->write_byte(0x1, dev->iobase + ADC_CLEAR_REG);
768 devpriv->read_byte(dev->iobase + ADC_FIFO_REG);
769 devpriv->read_byte(dev->iobase + ADC_FIFO_REG);
772 static int labpc_cancel(struct comedi_device *dev, struct comedi_subdevice *s)
776 spin_lock_irqsave(&dev->spinlock, flags);
777 devpriv->command2_bits &= ~SWTRIG_BIT & ~HWTRIG_BIT & ~PRETRIG_BIT;
778 devpriv->write_byte(devpriv->command2_bits, dev->iobase + COMMAND2_REG);
779 spin_unlock_irqrestore(&dev->spinlock, flags);
781 devpriv->command3_bits = 0;
782 devpriv->write_byte(devpriv->command3_bits, dev->iobase + COMMAND3_REG);
787 static enum scan_mode labpc_ai_scan_mode(const struct comedi_cmd *cmd)
789 if (cmd->chanlist_len == 1)
790 return MODE_SINGLE_CHAN;
792 /* chanlist may be NULL during cmdtest. */
793 if (cmd->chanlist == NULL)
794 return MODE_MULT_CHAN_UP;
796 if (CR_CHAN(cmd->chanlist[0]) == CR_CHAN(cmd->chanlist[1]))
797 return MODE_SINGLE_CHAN_INTERVAL;
799 if (CR_CHAN(cmd->chanlist[0]) < CR_CHAN(cmd->chanlist[1]))
800 return MODE_MULT_CHAN_UP;
802 if (CR_CHAN(cmd->chanlist[0]) > CR_CHAN(cmd->chanlist[1]))
803 return MODE_MULT_CHAN_DOWN;
805 printk("ni_labpc: bug! this should never happen\n");
810 static int labpc_ai_chanlist_invalid(const struct comedi_device *dev,
811 const struct comedi_cmd *cmd)
813 int mode, channel, range, aref, i;
815 if (cmd->chanlist == NULL)
818 mode = labpc_ai_scan_mode(cmd);
820 if (mode == MODE_SINGLE_CHAN)
823 if (mode == MODE_SINGLE_CHAN_INTERVAL) {
824 if (cmd->chanlist_len > 0xff) {
826 "ni_labpc: chanlist too long for single channel interval mode\n");
831 channel = CR_CHAN(cmd->chanlist[0]);
832 range = CR_RANGE(cmd->chanlist[0]);
833 aref = CR_AREF(cmd->chanlist[0]);
835 for (i = 0; i < cmd->chanlist_len; i++) {
838 case MODE_SINGLE_CHAN_INTERVAL:
839 if (CR_CHAN(cmd->chanlist[i]) != channel) {
841 "channel scanning order specified in chanlist is not supported by hardware.\n");
845 case MODE_MULT_CHAN_UP:
846 if (CR_CHAN(cmd->chanlist[i]) != i) {
848 "channel scanning order specified in chanlist is not supported by hardware.\n");
852 case MODE_MULT_CHAN_DOWN:
853 if (CR_CHAN(cmd->chanlist[i]) !=
854 cmd->chanlist_len - i - 1) {
856 "channel scanning order specified in chanlist is not supported by hardware.\n");
861 printk("ni_labpc: bug! in chanlist check\n");
866 if (CR_RANGE(cmd->chanlist[i]) != range) {
868 "entries in chanlist must all have the same range\n");
872 if (CR_AREF(cmd->chanlist[i]) != aref) {
874 "entries in chanlist must all have the same reference\n");
882 static int labpc_use_continuous_mode(const struct comedi_cmd *cmd)
884 if (labpc_ai_scan_mode(cmd) == MODE_SINGLE_CHAN)
887 if (cmd->scan_begin_src == TRIG_FOLLOW)
893 static unsigned int labpc_ai_convert_period(const struct comedi_cmd *cmd)
895 if (cmd->convert_src != TRIG_TIMER)
898 if (labpc_ai_scan_mode(cmd) == MODE_SINGLE_CHAN &&
899 cmd->scan_begin_src == TRIG_TIMER)
900 return cmd->scan_begin_arg;
902 return cmd->convert_arg;
905 static void labpc_set_ai_convert_period(struct comedi_cmd *cmd, unsigned int ns)
907 if (cmd->convert_src != TRIG_TIMER)
910 if (labpc_ai_scan_mode(cmd) == MODE_SINGLE_CHAN &&
911 cmd->scan_begin_src == TRIG_TIMER) {
912 cmd->scan_begin_arg = ns;
913 if (cmd->convert_arg > cmd->scan_begin_arg)
914 cmd->convert_arg = cmd->scan_begin_arg;
916 cmd->convert_arg = ns;
919 static unsigned int labpc_ai_scan_period(const struct comedi_cmd *cmd)
921 if (cmd->scan_begin_src != TRIG_TIMER)
924 if (labpc_ai_scan_mode(cmd) == MODE_SINGLE_CHAN &&
925 cmd->convert_src == TRIG_TIMER)
928 return cmd->scan_begin_arg;
931 static void labpc_set_ai_scan_period(struct comedi_cmd *cmd, unsigned int ns)
933 if (cmd->scan_begin_src != TRIG_TIMER)
936 if (labpc_ai_scan_mode(cmd) == MODE_SINGLE_CHAN &&
937 cmd->convert_src == TRIG_TIMER)
940 cmd->scan_begin_arg = ns;
943 static int labpc_ai_cmdtest(struct comedi_device *dev,
944 struct comedi_subdevice *s, struct comedi_cmd *cmd)
950 /* step 1: make sure trigger sources are trivially valid */
952 tmp = cmd->start_src;
953 cmd->start_src &= TRIG_NOW | TRIG_EXT;
954 if (!cmd->start_src || tmp != cmd->start_src)
957 tmp = cmd->scan_begin_src;
958 cmd->scan_begin_src &= TRIG_TIMER | TRIG_FOLLOW | TRIG_EXT;
959 if (!cmd->scan_begin_src || tmp != cmd->scan_begin_src)
962 tmp = cmd->convert_src;
963 cmd->convert_src &= TRIG_TIMER | TRIG_EXT;
964 if (!cmd->convert_src || tmp != cmd->convert_src)
967 tmp = cmd->scan_end_src;
968 cmd->scan_end_src &= TRIG_COUNT;
969 if (!cmd->scan_end_src || tmp != cmd->scan_end_src)
973 stop_mask = TRIG_COUNT | TRIG_NONE;
974 if (thisboard->register_layout == labpc_1200_layout)
975 stop_mask |= TRIG_EXT;
976 cmd->stop_src &= stop_mask;
977 if (!cmd->stop_src || tmp != cmd->stop_src)
983 /* step 2: make sure trigger sources are unique and mutually compatible */
985 if (cmd->start_src != TRIG_NOW && cmd->start_src != TRIG_EXT)
987 if (cmd->scan_begin_src != TRIG_TIMER &&
988 cmd->scan_begin_src != TRIG_FOLLOW &&
989 cmd->scan_begin_src != TRIG_EXT)
991 if (cmd->convert_src != TRIG_TIMER && cmd->convert_src != TRIG_EXT)
993 if (cmd->stop_src != TRIG_COUNT &&
994 cmd->stop_src != TRIG_EXT && cmd->stop_src != TRIG_NONE)
997 /* can't have external stop and start triggers at once */
998 if (cmd->start_src == TRIG_EXT && cmd->stop_src == TRIG_EXT)
1004 /* step 3: make sure arguments are trivially compatible */
1006 if (cmd->start_arg == TRIG_NOW && cmd->start_arg != 0) {
1011 if (!cmd->chanlist_len) {
1014 if (cmd->scan_end_arg != cmd->chanlist_len) {
1015 cmd->scan_end_arg = cmd->chanlist_len;
1019 if (cmd->convert_src == TRIG_TIMER) {
1020 if (cmd->convert_arg < thisboard->ai_speed) {
1021 cmd->convert_arg = thisboard->ai_speed;
1025 /* make sure scan timing is not too fast */
1026 if (cmd->scan_begin_src == TRIG_TIMER) {
1027 if (cmd->convert_src == TRIG_TIMER &&
1028 cmd->scan_begin_arg <
1029 cmd->convert_arg * cmd->chanlist_len) {
1030 cmd->scan_begin_arg =
1031 cmd->convert_arg * cmd->chanlist_len;
1034 if (cmd->scan_begin_arg <
1035 thisboard->ai_speed * cmd->chanlist_len) {
1036 cmd->scan_begin_arg =
1037 thisboard->ai_speed * cmd->chanlist_len;
1042 switch (cmd->stop_src) {
1044 if (!cmd->stop_arg) {
1050 if (cmd->stop_arg != 0) {
1055 /* TRIG_EXT doesn't care since it doesn't trigger off a numbered channel */
1063 /* step 4: fix up any arguments */
1065 tmp = cmd->convert_arg;
1066 tmp2 = cmd->scan_begin_arg;
1067 labpc_adc_timing(dev, cmd);
1068 if (tmp != cmd->convert_arg || tmp2 != cmd->scan_begin_arg)
1074 if (labpc_ai_chanlist_invalid(dev, cmd))
1080 static int labpc_ai_cmd(struct comedi_device *dev, struct comedi_subdevice *s)
1082 int channel, range, aref;
1083 unsigned long irq_flags;
1085 struct comedi_async *async = s->async;
1086 struct comedi_cmd *cmd = &async->cmd;
1087 enum transfer_type xfer;
1088 unsigned long flags;
1091 comedi_error(dev, "no irq assigned, cannot perform command");
1095 range = CR_RANGE(cmd->chanlist[0]);
1096 aref = CR_AREF(cmd->chanlist[0]);
1098 /* make sure board is disabled before setting up aquisition */
1099 spin_lock_irqsave(&dev->spinlock, flags);
1100 devpriv->command2_bits &= ~SWTRIG_BIT & ~HWTRIG_BIT & ~PRETRIG_BIT;
1101 devpriv->write_byte(devpriv->command2_bits, dev->iobase + COMMAND2_REG);
1102 spin_unlock_irqrestore(&dev->spinlock, flags);
1104 devpriv->command3_bits = 0;
1105 devpriv->write_byte(devpriv->command3_bits, dev->iobase + COMMAND3_REG);
1107 /* initialize software conversion count */
1108 if (cmd->stop_src == TRIG_COUNT) {
1109 devpriv->count = cmd->stop_arg * cmd->chanlist_len;
1111 /* setup hardware conversion counter */
1112 if (cmd->stop_src == TRIG_EXT) {
1113 /* load counter a1 with count of 3 (pc+ manual says this is minimum allowed) using mode 0 */
1114 ret = labpc_counter_load(dev, dev->iobase + COUNTER_A_BASE_REG,
1117 comedi_error(dev, "error loading counter a1");
1120 } else /* otherwise, just put a1 in mode 0 with no count to set its output low */
1121 devpriv->write_byte(INIT_A1_BITS,
1122 dev->iobase + COUNTER_A_CONTROL_REG);
1124 /* figure out what method we will use to transfer data */
1125 if (devpriv->dma_chan && /* need a dma channel allocated */
1126 /* dma unsafe at RT priority, and too much setup time for TRIG_WAKE_EOS for */
1127 (cmd->flags & (TRIG_WAKE_EOS | TRIG_RT)) == 0 &&
1128 /* only available on the isa boards */
1129 thisboard->bustype == isa_bustype) {
1130 xfer = isa_dma_transfer;
1131 } else if (thisboard->register_layout == labpc_1200_layout && /* pc-plus has no fifo-half full interrupt */
1132 /* wake-end-of-scan should interrupt on fifo not empty */
1133 (cmd->flags & TRIG_WAKE_EOS) == 0 &&
1134 /* make sure we are taking more than just a few points */
1135 (cmd->stop_src != TRIG_COUNT || devpriv->count > 256)) {
1136 xfer = fifo_half_full_transfer;
1138 xfer = fifo_not_empty_transfer;
1139 devpriv->current_transfer = xfer;
1141 /* setup command6 register for 1200 boards */
1142 if (thisboard->register_layout == labpc_1200_layout) {
1143 /* reference inputs to ground or common? */
1144 if (aref != AREF_GROUND)
1145 devpriv->command6_bits |= ADC_COMMON_BIT;
1147 devpriv->command6_bits &= ~ADC_COMMON_BIT;
1148 /* bipolar or unipolar range? */
1149 if (thisboard->ai_range_is_unipolar[range])
1150 devpriv->command6_bits |= ADC_UNIP_BIT;
1152 devpriv->command6_bits &= ~ADC_UNIP_BIT;
1153 /* interrupt on fifo half full? */
1154 if (xfer == fifo_half_full_transfer)
1155 devpriv->command6_bits |= ADC_FHF_INTR_EN_BIT;
1157 devpriv->command6_bits &= ~ADC_FHF_INTR_EN_BIT;
1158 /* enable interrupt on counter a1 terminal count? */
1159 if (cmd->stop_src == TRIG_EXT)
1160 devpriv->command6_bits |= A1_INTR_EN_BIT;
1162 devpriv->command6_bits &= ~A1_INTR_EN_BIT;
1163 /* are we scanning up or down through channels? */
1164 if (labpc_ai_scan_mode(cmd) == MODE_MULT_CHAN_UP)
1165 devpriv->command6_bits |= ADC_SCAN_UP_BIT;
1167 devpriv->command6_bits &= ~ADC_SCAN_UP_BIT;
1168 /* write to register */
1169 devpriv->write_byte(devpriv->command6_bits,
1170 dev->iobase + COMMAND6_REG);
1173 /* setup channel list, etc (command1 register) */
1174 devpriv->command1_bits = 0;
1175 if (labpc_ai_scan_mode(cmd) == MODE_MULT_CHAN_UP)
1176 channel = CR_CHAN(cmd->chanlist[cmd->chanlist_len - 1]);
1178 channel = CR_CHAN(cmd->chanlist[0]);
1179 /* munge channel bits for differential / scan disabled mode */
1180 if (labpc_ai_scan_mode(cmd) != MODE_SINGLE_CHAN && aref == AREF_DIFF)
1182 devpriv->command1_bits |= ADC_CHAN_BITS(channel);
1183 devpriv->command1_bits |= thisboard->ai_range_code[range];
1184 devpriv->write_byte(devpriv->command1_bits, dev->iobase + COMMAND1_REG);
1185 /* manual says to set scan enable bit on second pass */
1186 if (labpc_ai_scan_mode(cmd) == MODE_MULT_CHAN_UP ||
1187 labpc_ai_scan_mode(cmd) == MODE_MULT_CHAN_DOWN) {
1188 devpriv->command1_bits |= ADC_SCAN_EN_BIT;
1189 /* need a brief delay before enabling scan, or scan list will get screwed when you switch
1190 * between scan up to scan down mode - dunno why */
1192 devpriv->write_byte(devpriv->command1_bits,
1193 dev->iobase + COMMAND1_REG);
1195 /* setup any external triggering/pacing (command4 register) */
1196 devpriv->command4_bits = 0;
1197 if (cmd->convert_src != TRIG_EXT)
1198 devpriv->command4_bits |= EXT_CONVERT_DISABLE_BIT;
1199 /* XXX should discard first scan when using interval scanning
1200 * since manual says it is not synced with scan clock */
1201 if (labpc_use_continuous_mode(cmd) == 0) {
1202 devpriv->command4_bits |= INTERVAL_SCAN_EN_BIT;
1203 if (cmd->scan_begin_src == TRIG_EXT)
1204 devpriv->command4_bits |= EXT_SCAN_EN_BIT;
1206 /* single-ended/differential */
1207 if (aref == AREF_DIFF)
1208 devpriv->command4_bits |= ADC_DIFF_BIT;
1209 devpriv->write_byte(devpriv->command4_bits, dev->iobase + COMMAND4_REG);
1211 devpriv->write_byte(cmd->chanlist_len,
1212 dev->iobase + INTERVAL_COUNT_REG);
1214 devpriv->write_byte(INTERVAL_LOAD_BITS,
1215 dev->iobase + INTERVAL_LOAD_REG);
1217 if (cmd->convert_src == TRIG_TIMER || cmd->scan_begin_src == TRIG_TIMER) {
1219 labpc_adc_timing(dev, cmd);
1220 /* load counter b0 in mode 3 */
1221 ret = labpc_counter_load(dev, dev->iobase + COUNTER_B_BASE_REG,
1222 0, devpriv->divisor_b0, 3);
1224 comedi_error(dev, "error loading counter b0");
1228 /* set up conversion pacing */
1229 if (labpc_ai_convert_period(cmd)) {
1230 /* load counter a0 in mode 2 */
1231 ret = labpc_counter_load(dev, dev->iobase + COUNTER_A_BASE_REG,
1232 0, devpriv->divisor_a0, 2);
1234 comedi_error(dev, "error loading counter a0");
1238 devpriv->write_byte(INIT_A0_BITS,
1239 dev->iobase + COUNTER_A_CONTROL_REG);
1241 /* set up scan pacing */
1242 if (labpc_ai_scan_period(cmd)) {
1243 /* load counter b1 in mode 2 */
1244 ret = labpc_counter_load(dev, dev->iobase + COUNTER_B_BASE_REG,
1245 1, devpriv->divisor_b1, 2);
1247 comedi_error(dev, "error loading counter b1");
1252 labpc_clear_adc_fifo(dev);
1254 /* set up dma transfer */
1255 if (xfer == isa_dma_transfer) {
1256 irq_flags = claim_dma_lock();
1257 disable_dma(devpriv->dma_chan);
1258 /* clear flip-flop to make sure 2-byte registers for
1259 * count and address get set correctly */
1260 clear_dma_ff(devpriv->dma_chan);
1261 set_dma_addr(devpriv->dma_chan,
1262 virt_to_bus(devpriv->dma_buffer));
1263 /* set appropriate size of transfer */
1264 devpriv->dma_transfer_size = labpc_suggest_transfer_size(*cmd);
1265 if (cmd->stop_src == TRIG_COUNT &&
1266 devpriv->count * sample_size < devpriv->dma_transfer_size) {
1267 devpriv->dma_transfer_size =
1268 devpriv->count * sample_size;
1270 set_dma_count(devpriv->dma_chan, devpriv->dma_transfer_size);
1271 enable_dma(devpriv->dma_chan);
1272 release_dma_lock(irq_flags);
1273 /* enable board's dma */
1274 devpriv->command3_bits |= DMA_EN_BIT | DMATC_INTR_EN_BIT;
1276 devpriv->command3_bits &= ~DMA_EN_BIT & ~DMATC_INTR_EN_BIT;
1278 /* enable error interrupts */
1279 devpriv->command3_bits |= ERR_INTR_EN_BIT;
1280 /* enable fifo not empty interrupt? */
1281 if (xfer == fifo_not_empty_transfer)
1282 devpriv->command3_bits |= ADC_FNE_INTR_EN_BIT;
1284 devpriv->command3_bits &= ~ADC_FNE_INTR_EN_BIT;
1285 devpriv->write_byte(devpriv->command3_bits, dev->iobase + COMMAND3_REG);
1287 /* startup aquisition */
1290 /* use 2 cascaded counters for pacing */
1291 spin_lock_irqsave(&dev->spinlock, flags);
1292 devpriv->command2_bits |= CASCADE_BIT;
1293 switch (cmd->start_src) {
1295 devpriv->command2_bits |= HWTRIG_BIT;
1296 devpriv->command2_bits &= ~PRETRIG_BIT & ~SWTRIG_BIT;
1299 devpriv->command2_bits |= SWTRIG_BIT;
1300 devpriv->command2_bits &= ~PRETRIG_BIT & ~HWTRIG_BIT;
1303 comedi_error(dev, "bug with start_src");
1307 switch (cmd->stop_src) {
1309 devpriv->command2_bits |= HWTRIG_BIT | PRETRIG_BIT;
1315 comedi_error(dev, "bug with stop_src");
1318 devpriv->write_byte(devpriv->command2_bits, dev->iobase + COMMAND2_REG);
1319 spin_unlock_irqrestore(&dev->spinlock, flags);
1324 /* interrupt service routine */
1325 static irqreturn_t labpc_interrupt(int irq, void *d)
1327 struct comedi_device *dev = d;
1328 struct comedi_subdevice *s = dev->read_subdev;
1329 struct comedi_async *async;
1330 struct comedi_cmd *cmd;
1332 if (dev->attached == 0) {
1333 comedi_error(dev, "premature interrupt");
1341 /* read board status */
1342 devpriv->status1_bits = devpriv->read_byte(dev->iobase + STATUS1_REG);
1343 if (thisboard->register_layout == labpc_1200_layout)
1344 devpriv->status2_bits =
1345 devpriv->read_byte(dev->iobase + STATUS2_REG);
1347 if ((devpriv->status1_bits & (DMATC_BIT | TIMER_BIT | OVERFLOW_BIT |
1348 OVERRUN_BIT | DATA_AVAIL_BIT)) == 0
1349 && (devpriv->status2_bits & A1_TC_BIT) == 0
1350 && (devpriv->status2_bits & FNHF_BIT)) {
1354 if (devpriv->status1_bits & OVERRUN_BIT) {
1355 /* clear error interrupt */
1356 devpriv->write_byte(0x1, dev->iobase + ADC_CLEAR_REG);
1357 async->events |= COMEDI_CB_ERROR | COMEDI_CB_EOA;
1358 comedi_event(dev, s);
1359 comedi_error(dev, "overrun");
1363 if (devpriv->current_transfer == isa_dma_transfer) {
1364 /* if a dma terminal count of external stop trigger has occurred */
1365 if (devpriv->status1_bits & DMATC_BIT ||
1366 (thisboard->register_layout == labpc_1200_layout
1367 && devpriv->status2_bits & A1_TC_BIT)) {
1368 handle_isa_dma(dev);
1371 labpc_drain_fifo(dev);
1373 if (devpriv->status1_bits & TIMER_BIT) {
1374 comedi_error(dev, "handled timer interrupt?");
1376 devpriv->write_byte(0x1, dev->iobase + TIMER_CLEAR_REG);
1379 if (devpriv->status1_bits & OVERFLOW_BIT) {
1380 /* clear error interrupt */
1381 devpriv->write_byte(0x1, dev->iobase + ADC_CLEAR_REG);
1382 async->events |= COMEDI_CB_ERROR | COMEDI_CB_EOA;
1383 comedi_event(dev, s);
1384 comedi_error(dev, "overflow");
1387 /* handle external stop trigger */
1388 if (cmd->stop_src == TRIG_EXT) {
1389 if (devpriv->status2_bits & A1_TC_BIT) {
1390 labpc_drain_dregs(dev);
1391 labpc_cancel(dev, s);
1392 async->events |= COMEDI_CB_EOA;
1396 /* TRIG_COUNT end of acquisition */
1397 if (cmd->stop_src == TRIG_COUNT) {
1398 if (devpriv->count == 0) {
1399 labpc_cancel(dev, s);
1400 async->events |= COMEDI_CB_EOA;
1404 comedi_event(dev, s);
1408 /* read all available samples from ai fifo */
1409 static int labpc_drain_fifo(struct comedi_device *dev)
1411 unsigned int lsb, msb;
1413 struct comedi_async *async = dev->read_subdev->async;
1414 const int timeout = 10000;
1417 devpriv->status1_bits = devpriv->read_byte(dev->iobase + STATUS1_REG);
1419 for (i = 0; (devpriv->status1_bits & DATA_AVAIL_BIT) && i < timeout;
1421 /* quit if we have all the data we want */
1422 if (async->cmd.stop_src == TRIG_COUNT) {
1423 if (devpriv->count == 0)
1427 lsb = devpriv->read_byte(dev->iobase + ADC_FIFO_REG);
1428 msb = devpriv->read_byte(dev->iobase + ADC_FIFO_REG);
1429 data = (msb << 8) | lsb;
1430 cfc_write_to_buffer(dev->read_subdev, data);
1431 devpriv->status1_bits =
1432 devpriv->read_byte(dev->iobase + STATUS1_REG);
1435 comedi_error(dev, "ai timeout, fifo never empties");
1436 async->events |= COMEDI_CB_ERROR | COMEDI_CB_EOA;
1443 static void labpc_drain_dma(struct comedi_device *dev)
1445 struct comedi_subdevice *s = dev->read_subdev;
1446 struct comedi_async *async = s->async;
1448 unsigned long flags;
1449 unsigned int max_points, num_points, residue, leftover;
1452 status = devpriv->status1_bits;
1454 flags = claim_dma_lock();
1455 disable_dma(devpriv->dma_chan);
1456 /* clear flip-flop to make sure 2-byte registers for
1457 * count and address get set correctly */
1458 clear_dma_ff(devpriv->dma_chan);
1460 /* figure out how many points to read */
1461 max_points = devpriv->dma_transfer_size / sample_size;
1462 /* residue is the number of points left to be done on the dma
1463 * transfer. It should always be zero at this point unless
1464 * the stop_src is set to external triggering.
1466 residue = get_dma_residue(devpriv->dma_chan) / sample_size;
1467 num_points = max_points - residue;
1468 if (devpriv->count < num_points && async->cmd.stop_src == TRIG_COUNT)
1469 num_points = devpriv->count;
1471 /* figure out how many points will be stored next time */
1473 if (async->cmd.stop_src != TRIG_COUNT) {
1474 leftover = devpriv->dma_transfer_size / sample_size;
1475 } else if (devpriv->count > num_points) {
1476 leftover = devpriv->count - num_points;
1477 if (leftover > max_points)
1478 leftover = max_points;
1481 /* write data to comedi buffer */
1482 for (i = 0; i < num_points; i++) {
1483 cfc_write_to_buffer(s, devpriv->dma_buffer[i]);
1485 if (async->cmd.stop_src == TRIG_COUNT)
1486 devpriv->count -= num_points;
1488 /* set address and count for next transfer */
1489 set_dma_addr(devpriv->dma_chan, virt_to_bus(devpriv->dma_buffer));
1490 set_dma_count(devpriv->dma_chan, leftover * sample_size);
1491 release_dma_lock(flags);
1493 async->events |= COMEDI_CB_BLOCK;
1496 static void handle_isa_dma(struct comedi_device *dev)
1498 labpc_drain_dma(dev);
1500 enable_dma(devpriv->dma_chan);
1502 /* clear dma tc interrupt */
1503 devpriv->write_byte(0x1, dev->iobase + DMATC_CLEAR_REG);
1506 /* makes sure all data aquired by board is transfered to comedi (used
1507 * when aquisition is terminated by stop_src == TRIG_EXT). */
1508 static void labpc_drain_dregs(struct comedi_device *dev)
1510 if (devpriv->current_transfer == isa_dma_transfer)
1511 labpc_drain_dma(dev);
1513 labpc_drain_fifo(dev);
1516 static int labpc_ai_rinsn(struct comedi_device *dev, struct comedi_subdevice *s,
1517 struct comedi_insn *insn, unsigned int *data)
1523 unsigned long flags;
1525 /* disable timed conversions */
1526 spin_lock_irqsave(&dev->spinlock, flags);
1527 devpriv->command2_bits &= ~SWTRIG_BIT & ~HWTRIG_BIT & ~PRETRIG_BIT;
1528 devpriv->write_byte(devpriv->command2_bits, dev->iobase + COMMAND2_REG);
1529 spin_unlock_irqrestore(&dev->spinlock, flags);
1531 /* disable interrupt generation and dma */
1532 devpriv->command3_bits = 0;
1533 devpriv->write_byte(devpriv->command3_bits, dev->iobase + COMMAND3_REG);
1535 /* set gain and channel */
1536 devpriv->command1_bits = 0;
1537 chan = CR_CHAN(insn->chanspec);
1538 range = CR_RANGE(insn->chanspec);
1539 devpriv->command1_bits |= thisboard->ai_range_code[range];
1540 /* munge channel bits for differential/scan disabled mode */
1541 if (CR_AREF(insn->chanspec) == AREF_DIFF)
1543 devpriv->command1_bits |= ADC_CHAN_BITS(chan);
1544 devpriv->write_byte(devpriv->command1_bits, dev->iobase + COMMAND1_REG);
1546 /* setup command6 register for 1200 boards */
1547 if (thisboard->register_layout == labpc_1200_layout) {
1548 /* reference inputs to ground or common? */
1549 if (CR_AREF(insn->chanspec) != AREF_GROUND)
1550 devpriv->command6_bits |= ADC_COMMON_BIT;
1552 devpriv->command6_bits &= ~ADC_COMMON_BIT;
1553 /* bipolar or unipolar range? */
1554 if (thisboard->ai_range_is_unipolar[range])
1555 devpriv->command6_bits |= ADC_UNIP_BIT;
1557 devpriv->command6_bits &= ~ADC_UNIP_BIT;
1558 /* don't interrupt on fifo half full */
1559 devpriv->command6_bits &= ~ADC_FHF_INTR_EN_BIT;
1560 /* don't enable interrupt on counter a1 terminal count? */
1561 devpriv->command6_bits &= ~A1_INTR_EN_BIT;
1562 /* write to register */
1563 devpriv->write_byte(devpriv->command6_bits,
1564 dev->iobase + COMMAND6_REG);
1566 /* setup command4 register */
1567 devpriv->command4_bits = 0;
1568 devpriv->command4_bits |= EXT_CONVERT_DISABLE_BIT;
1569 /* single-ended/differential */
1570 if (CR_AREF(insn->chanspec) == AREF_DIFF)
1571 devpriv->command4_bits |= ADC_DIFF_BIT;
1572 devpriv->write_byte(devpriv->command4_bits, dev->iobase + COMMAND4_REG);
1574 /* initialize pacer counter output to make sure it doesn't cause any problems */
1575 devpriv->write_byte(INIT_A0_BITS, dev->iobase + COUNTER_A_CONTROL_REG);
1577 labpc_clear_adc_fifo(dev);
1579 for (n = 0; n < insn->n; n++) {
1580 /* trigger conversion */
1581 devpriv->write_byte(0x1, dev->iobase + ADC_CONVERT_REG);
1583 for (i = 0; i < timeout; i++) {
1584 if (devpriv->read_byte(dev->iobase +
1585 STATUS1_REG) & DATA_AVAIL_BIT)
1590 comedi_error(dev, "timeout");
1593 lsb = devpriv->read_byte(dev->iobase + ADC_FIFO_REG);
1594 msb = devpriv->read_byte(dev->iobase + ADC_FIFO_REG);
1595 data[n] = (msb << 8) | lsb;
1601 /* analog output insn */
1602 static int labpc_ao_winsn(struct comedi_device *dev, struct comedi_subdevice *s,
1603 struct comedi_insn *insn, unsigned int *data)
1606 unsigned long flags;
1609 channel = CR_CHAN(insn->chanspec);
1611 /* turn off pacing of analog output channel */
1612 /* note: hardware bug in daqcard-1200 means pacing cannot
1613 * be independently enabled/disabled for its the two channels */
1614 spin_lock_irqsave(&dev->spinlock, flags);
1615 devpriv->command2_bits &= ~DAC_PACED_BIT(channel);
1616 devpriv->write_byte(devpriv->command2_bits, dev->iobase + COMMAND2_REG);
1617 spin_unlock_irqrestore(&dev->spinlock, flags);
1620 if (thisboard->register_layout == labpc_1200_layout) {
1621 range = CR_RANGE(insn->chanspec);
1622 if (range & AO_RANGE_IS_UNIPOLAR)
1623 devpriv->command6_bits |= DAC_UNIP_BIT(channel);
1625 devpriv->command6_bits &= ~DAC_UNIP_BIT(channel);
1626 /* write to register */
1627 devpriv->write_byte(devpriv->command6_bits,
1628 dev->iobase + COMMAND6_REG);
1631 lsb = data[0] & 0xff;
1632 msb = (data[0] >> 8) & 0xff;
1633 devpriv->write_byte(lsb, dev->iobase + DAC_LSB_REG(channel));
1634 devpriv->write_byte(msb, dev->iobase + DAC_MSB_REG(channel));
1636 /* remember value for readback */
1637 devpriv->ao_value[channel] = data[0];
1642 /* analog output readback insn */
1643 static int labpc_ao_rinsn(struct comedi_device *dev, struct comedi_subdevice *s,
1644 struct comedi_insn *insn, unsigned int *data)
1646 data[0] = devpriv->ao_value[CR_CHAN(insn->chanspec)];
1651 static int labpc_calib_read_insn(struct comedi_device *dev,
1652 struct comedi_subdevice *s,
1653 struct comedi_insn *insn, unsigned int *data)
1655 data[0] = devpriv->caldac[CR_CHAN(insn->chanspec)];
1660 static int labpc_calib_write_insn(struct comedi_device *dev,
1661 struct comedi_subdevice *s,
1662 struct comedi_insn *insn, unsigned int *data)
1664 int channel = CR_CHAN(insn->chanspec);
1666 write_caldac(dev, channel, data[0]);
1670 static int labpc_eeprom_read_insn(struct comedi_device *dev,
1671 struct comedi_subdevice *s,
1672 struct comedi_insn *insn, unsigned int *data)
1674 data[0] = devpriv->eeprom_data[CR_CHAN(insn->chanspec)];
1679 static int labpc_eeprom_write_insn(struct comedi_device *dev,
1680 struct comedi_subdevice *s,
1681 struct comedi_insn *insn, unsigned int *data)
1683 int channel = CR_CHAN(insn->chanspec);
1686 /* only allow writes to user area of eeprom */
1687 if (channel < 16 || channel > 127) {
1689 ("eeprom writes are only allowed to channels 16 through 127 (the pointer and user areas)");
1693 ret = labpc_eeprom_write(dev, channel, data[0]);
1700 /* utility function that suggests a dma transfer size in bytes */
1701 static unsigned int labpc_suggest_transfer_size(struct comedi_cmd cmd)
1706 if (cmd.convert_src == TRIG_TIMER)
1707 freq = 1000000000 / cmd.convert_arg;
1708 /* return some default value */
1712 /* make buffer fill in no more than 1/3 second */
1713 size = (freq / 3) * sample_size;
1715 /* set a minimum and maximum size allowed */
1716 if (size > dma_buffer_size)
1717 size = dma_buffer_size - dma_buffer_size % sample_size;
1718 else if (size < sample_size)
1724 /* figures out what counter values to use based on command */
1725 static void labpc_adc_timing(struct comedi_device *dev, struct comedi_cmd *cmd)
1727 const int max_counter_value = 0x10000; /* max value for 16 bit counter in mode 2 */
1728 const int min_counter_value = 2; /* min value for 16 bit counter in mode 2 */
1729 unsigned int base_period;
1731 /* if both convert and scan triggers are TRIG_TIMER, then they both rely on counter b0 */
1732 if (labpc_ai_convert_period(cmd) && labpc_ai_scan_period(cmd)) {
1733 /* pick the lowest b0 divisor value we can (for maximum input clock speed on convert and scan counters) */
1734 devpriv->divisor_b0 = (labpc_ai_scan_period(cmd) - 1) /
1735 (LABPC_TIMER_BASE * max_counter_value) + 1;
1736 if (devpriv->divisor_b0 < min_counter_value)
1737 devpriv->divisor_b0 = min_counter_value;
1738 if (devpriv->divisor_b0 > max_counter_value)
1739 devpriv->divisor_b0 = max_counter_value;
1741 base_period = LABPC_TIMER_BASE * devpriv->divisor_b0;
1743 /* set a0 for conversion frequency and b1 for scan frequency */
1744 switch (cmd->flags & TRIG_ROUND_MASK) {
1746 case TRIG_ROUND_NEAREST:
1747 devpriv->divisor_a0 =
1748 (labpc_ai_convert_period(cmd) +
1749 (base_period / 2)) / base_period;
1750 devpriv->divisor_b1 =
1751 (labpc_ai_scan_period(cmd) +
1752 (base_period / 2)) / base_period;
1755 devpriv->divisor_a0 =
1756 (labpc_ai_convert_period(cmd) + (base_period -
1758 devpriv->divisor_b1 =
1759 (labpc_ai_scan_period(cmd) + (base_period -
1762 case TRIG_ROUND_DOWN:
1763 devpriv->divisor_a0 =
1764 labpc_ai_convert_period(cmd) / base_period;
1765 devpriv->divisor_b1 =
1766 labpc_ai_scan_period(cmd) / base_period;
1769 /* make sure a0 and b1 values are acceptable */
1770 if (devpriv->divisor_a0 < min_counter_value)
1771 devpriv->divisor_a0 = min_counter_value;
1772 if (devpriv->divisor_a0 > max_counter_value)
1773 devpriv->divisor_a0 = max_counter_value;
1774 if (devpriv->divisor_b1 < min_counter_value)
1775 devpriv->divisor_b1 = min_counter_value;
1776 if (devpriv->divisor_b1 > max_counter_value)
1777 devpriv->divisor_b1 = max_counter_value;
1778 /* write corrected timings to command */
1779 labpc_set_ai_convert_period(cmd,
1780 base_period * devpriv->divisor_a0);
1781 labpc_set_ai_scan_period(cmd,
1782 base_period * devpriv->divisor_b1);
1783 /* if only one TRIG_TIMER is used, we can employ the generic cascaded timing functions */
1784 } else if (labpc_ai_scan_period(cmd)) {
1785 unsigned int scan_period;
1787 scan_period = labpc_ai_scan_period(cmd);
1788 /* calculate cascaded counter values that give desired scan timing */
1789 i8253_cascade_ns_to_timer_2div(LABPC_TIMER_BASE,
1790 &(devpriv->divisor_b1),
1791 &(devpriv->divisor_b0),
1793 cmd->flags & TRIG_ROUND_MASK);
1794 labpc_set_ai_scan_period(cmd, scan_period);
1795 } else if (labpc_ai_convert_period(cmd)) {
1796 unsigned int convert_period;
1798 convert_period = labpc_ai_convert_period(cmd);
1799 /* calculate cascaded counter values that give desired conversion timing */
1800 i8253_cascade_ns_to_timer_2div(LABPC_TIMER_BASE,
1801 &(devpriv->divisor_a0),
1802 &(devpriv->divisor_b0),
1804 cmd->flags & TRIG_ROUND_MASK);
1805 labpc_set_ai_convert_period(cmd, convert_period);
1809 static int labpc_dio_mem_callback(int dir, int port, int data,
1810 unsigned long iobase)
1813 writeb(data, (void *)(iobase + port));
1816 return readb((void *)(iobase + port));
1820 /* lowlevel write to eeprom/dac */
1821 static void labpc_serial_out(struct comedi_device *dev, unsigned int value,
1822 unsigned int value_width)
1826 for (i = 1; i <= value_width; i++) {
1827 /* clear serial clock */
1828 devpriv->command5_bits &= ~SCLOCK_BIT;
1829 /* send bits most significant bit first */
1830 if (value & (1 << (value_width - i)))
1831 devpriv->command5_bits |= SDATA_BIT;
1833 devpriv->command5_bits &= ~SDATA_BIT;
1835 devpriv->write_byte(devpriv->command5_bits,
1836 dev->iobase + COMMAND5_REG);
1837 /* set clock to load bit */
1838 devpriv->command5_bits |= SCLOCK_BIT;
1840 devpriv->write_byte(devpriv->command5_bits,
1841 dev->iobase + COMMAND5_REG);
1845 /* lowlevel read from eeprom */
1846 static unsigned int labpc_serial_in(struct comedi_device *dev)
1848 unsigned int value = 0;
1850 const int value_width = 8; /* number of bits wide values are */
1852 for (i = 1; i <= value_width; i++) {
1853 /* set serial clock */
1854 devpriv->command5_bits |= SCLOCK_BIT;
1856 devpriv->write_byte(devpriv->command5_bits,
1857 dev->iobase + COMMAND5_REG);
1858 /* clear clock bit */
1859 devpriv->command5_bits &= ~SCLOCK_BIT;
1861 devpriv->write_byte(devpriv->command5_bits,
1862 dev->iobase + COMMAND5_REG);
1863 /* read bits most significant bit first */
1865 devpriv->status2_bits =
1866 devpriv->read_byte(dev->iobase + STATUS2_REG);
1867 if (devpriv->status2_bits & EEPROM_OUT_BIT) {
1868 value |= 1 << (value_width - i);
1875 static unsigned int labpc_eeprom_read(struct comedi_device *dev,
1876 unsigned int address)
1879 const int read_instruction = 0x3; /* bits to tell eeprom to expect a read */
1880 const int write_length = 8; /* 8 bit write lengths to eeprom */
1882 /* enable read/write to eeprom */
1883 devpriv->command5_bits &= ~EEPROM_EN_BIT;
1885 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1886 devpriv->command5_bits |= EEPROM_EN_BIT | EEPROM_WRITE_UNPROTECT_BIT;
1888 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1890 /* send read instruction */
1891 labpc_serial_out(dev, read_instruction, write_length);
1892 /* send 8 bit address to read from */
1893 labpc_serial_out(dev, address, write_length);
1895 value = labpc_serial_in(dev);
1897 /* disable read/write to eeprom */
1898 devpriv->command5_bits &= ~EEPROM_EN_BIT & ~EEPROM_WRITE_UNPROTECT_BIT;
1900 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1905 static unsigned int labpc_eeprom_write(struct comedi_device *dev,
1906 unsigned int address, unsigned int value)
1908 const int write_enable_instruction = 0x6;
1909 const int write_instruction = 0x2;
1910 const int write_length = 8; /* 8 bit write lengths to eeprom */
1911 const int write_in_progress_bit = 0x1;
1912 const int timeout = 10000;
1915 /* make sure there isn't already a write in progress */
1916 for (i = 0; i < timeout; i++) {
1917 if ((labpc_eeprom_read_status(dev) & write_in_progress_bit) ==
1922 comedi_error(dev, "eeprom write timed out");
1925 /* update software copy of eeprom */
1926 devpriv->eeprom_data[address] = value;
1928 /* enable read/write to eeprom */
1929 devpriv->command5_bits &= ~EEPROM_EN_BIT;
1931 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1932 devpriv->command5_bits |= EEPROM_EN_BIT | EEPROM_WRITE_UNPROTECT_BIT;
1934 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1936 /* send write_enable instruction */
1937 labpc_serial_out(dev, write_enable_instruction, write_length);
1938 devpriv->command5_bits &= ~EEPROM_EN_BIT;
1940 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1942 /* send write instruction */
1943 devpriv->command5_bits |= EEPROM_EN_BIT;
1945 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1946 labpc_serial_out(dev, write_instruction, write_length);
1947 /* send 8 bit address to write to */
1948 labpc_serial_out(dev, address, write_length);
1950 labpc_serial_out(dev, value, write_length);
1951 devpriv->command5_bits &= ~EEPROM_EN_BIT;
1953 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1955 /* disable read/write to eeprom */
1956 devpriv->command5_bits &= ~EEPROM_EN_BIT & ~EEPROM_WRITE_UNPROTECT_BIT;
1958 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1963 static unsigned int labpc_eeprom_read_status(struct comedi_device *dev)
1966 const int read_status_instruction = 0x5;
1967 const int write_length = 8; /* 8 bit write lengths to eeprom */
1969 /* enable read/write to eeprom */
1970 devpriv->command5_bits &= ~EEPROM_EN_BIT;
1972 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1973 devpriv->command5_bits |= EEPROM_EN_BIT | EEPROM_WRITE_UNPROTECT_BIT;
1975 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1977 /* send read status instruction */
1978 labpc_serial_out(dev, read_status_instruction, write_length);
1980 value = labpc_serial_in(dev);
1982 /* disable read/write to eeprom */
1983 devpriv->command5_bits &= ~EEPROM_EN_BIT & ~EEPROM_WRITE_UNPROTECT_BIT;
1985 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1990 /* writes to 8 bit calibration dacs */
1991 static void write_caldac(struct comedi_device *dev, unsigned int channel,
1994 if (value == devpriv->caldac[channel])
1996 devpriv->caldac[channel] = value;
1998 /* clear caldac load bit and make sure we don't write to eeprom */
1999 devpriv->command5_bits &=
2000 ~CALDAC_LOAD_BIT & ~EEPROM_EN_BIT & ~EEPROM_WRITE_UNPROTECT_BIT;
2002 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
2004 /* write 4 bit channel */
2005 labpc_serial_out(dev, channel, 4);
2006 /* write 8 bit caldac value */
2007 labpc_serial_out(dev, value, 8);
2009 /* set and clear caldac bit to load caldac value */
2010 devpriv->command5_bits |= CALDAC_LOAD_BIT;
2012 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
2013 devpriv->command5_bits &= ~CALDAC_LOAD_BIT;
2015 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
2018 #ifdef CONFIG_COMEDI_PCI
2019 COMEDI_PCI_INITCLEANUP(driver_labpc, labpc_pci_table);
2021 COMEDI_INITCLEANUP(driver_labpc);
2024 EXPORT_SYMBOL_GPL(labpc_common_attach);
2025 EXPORT_SYMBOL_GPL(labpc_common_detach);
2026 EXPORT_SYMBOL_GPL(range_labpc_1200_ai);
2027 EXPORT_SYMBOL_GPL(labpc_1200_ai_gain_bits);
2028 EXPORT_SYMBOL_GPL(labpc_1200_is_unipolar);