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/comedidev.h>
81 #include <linux/delay.h>
87 #include "comedi_fc.h"
90 #define DRV_NAME "ni_labpc"
92 #define LABPC_SIZE 32 // size of io region used by board
93 #define LABPC_TIMER_BASE 500 // 2 MHz master clock
95 /* Registers for the lab-pc+ */
97 //write-only registers
98 #define COMMAND1_REG 0x0
99 #define ADC_GAIN_MASK (0x7 << 4)
100 #define ADC_CHAN_BITS(x) ((x) & 0x7)
101 #define ADC_SCAN_EN_BIT 0x80 // enables multi channel scans
102 #define COMMAND2_REG 0x1
103 #define PRETRIG_BIT 0x1 // enable pretriggering (used in conjunction with SWTRIG)
104 #define HWTRIG_BIT 0x2 // enable paced conversions on external trigger
105 #define SWTRIG_BIT 0x4 // enable paced conversions
106 #define CASCADE_BIT 0x8 // use two cascaded counters for pacing
107 #define DAC_PACED_BIT(channel) (0x40 << ((channel) & 0x1))
108 #define COMMAND3_REG 0x2
109 #define DMA_EN_BIT 0x1 // enable dma transfers
110 #define DIO_INTR_EN_BIT 0x2 // enable interrupts for 8255
111 #define DMATC_INTR_EN_BIT 0x4 // enable dma terminal count interrupt
112 #define TIMER_INTR_EN_BIT 0x8 // enable timer interrupt
113 #define ERR_INTR_EN_BIT 0x10 // enable error interrupt
114 #define ADC_FNE_INTR_EN_BIT 0x20 // enable fifo not empty interrupt
115 #define ADC_CONVERT_REG 0x3
116 #define DAC_LSB_REG(channel) (0x4 + 2 * ((channel) & 0x1))
117 #define DAC_MSB_REG(channel) (0x5 + 2 * ((channel) & 0x1))
118 #define ADC_CLEAR_REG 0x8
119 #define DMATC_CLEAR_REG 0xa
120 #define TIMER_CLEAR_REG 0xc
121 #define COMMAND6_REG 0xe // 1200 boards only
122 #define ADC_COMMON_BIT 0x1 // select ground or common-mode reference
123 #define ADC_UNIP_BIT 0x2 // adc unipolar
124 #define DAC_UNIP_BIT(channel) (0x4 << ((channel) & 0x1)) // dac unipolar
125 #define ADC_FHF_INTR_EN_BIT 0x20 // enable fifo half full interrupt
126 #define A1_INTR_EN_BIT 0x40 // enable interrupt on end of hardware count
127 #define ADC_SCAN_UP_BIT 0x80 // scan up from channel zero instead of down to zero
128 #define COMMAND4_REG 0xf
129 #define INTERVAL_SCAN_EN_BIT 0x1 // enables 'interval' scanning
130 #define EXT_SCAN_EN_BIT 0x2 // enables external signal on counter b1 output to trigger scan
131 #define EXT_CONVERT_OUT_BIT 0x4 // chooses direction (output or input) for EXTCONV* line
132 #define ADC_DIFF_BIT 0x8 // chooses differential inputs for adc (in conjunction with board jumper)
133 #define EXT_CONVERT_DISABLE_BIT 0x10
134 #define COMMAND5_REG 0x1c // 1200 boards only, calibration stuff
135 #define EEPROM_WRITE_UNPROTECT_BIT 0x4 // enable eeprom for write
136 #define DITHER_EN_BIT 0x8 // enable dithering
137 #define CALDAC_LOAD_BIT 0x10 // load calibration dac
138 #define SCLOCK_BIT 0x20 // serial clock - rising edge writes, falling edge reads
139 #define SDATA_BIT 0x40 // serial data bit for writing to eeprom or calibration dacs
140 #define EEPROM_EN_BIT 0x80 // enable eeprom for read/write
141 #define INTERVAL_COUNT_REG 0x1e
142 #define INTERVAL_LOAD_REG 0x1f
143 #define INTERVAL_LOAD_BITS 0x1
145 // read-only registers
146 #define STATUS1_REG 0x0
147 #define DATA_AVAIL_BIT 0x1 // data is available in fifo
148 #define OVERRUN_BIT 0x2 // overrun has occurred
149 #define OVERFLOW_BIT 0x4 // fifo overflow
150 #define TIMER_BIT 0x8 // timer interrupt has occured
151 #define DMATC_BIT 0x10 // dma terminal count has occured
152 #define EXT_TRIG_BIT 0x40 // external trigger has occured
153 #define STATUS2_REG 0x1d // 1200 boards only
154 #define EEPROM_OUT_BIT 0x1 // programmable eeprom serial output
155 #define A1_TC_BIT 0x2 // counter A1 terminal count
156 #define FNHF_BIT 0x4 // fifo not half full
157 #define ADC_FIFO_REG 0xa
159 #define DIO_BASE_REG 0x10
160 #define COUNTER_A_BASE_REG 0x14
161 #define COUNTER_A_CONTROL_REG (COUNTER_A_BASE_REG + 0x3)
162 #define INIT_A0_BITS 0x14 // check modes put conversion pacer output in harmless state (a0 mode 2)
163 #define INIT_A1_BITS 0x70 // put hardware conversion counter output in harmless state (a1 mode 0)
164 #define COUNTER_B_BASE_REG 0x18
166 static int labpc_attach(comedi_device * dev, comedi_devconfig * it);
167 static int labpc_cancel(comedi_device * dev, comedi_subdevice * s);
168 static irqreturn_t labpc_interrupt(int irq, void *d PT_REGS_ARG);
169 static int labpc_drain_fifo(comedi_device * dev);
170 static void labpc_drain_dma(comedi_device * dev);
171 static void handle_isa_dma(comedi_device * dev);
172 static void labpc_drain_dregs(comedi_device * dev);
173 static int labpc_ai_cmdtest(comedi_device * dev, comedi_subdevice * s,
175 static int labpc_ai_cmd(comedi_device * dev, comedi_subdevice * s);
176 static int labpc_ai_rinsn(comedi_device * dev, comedi_subdevice * s,
177 comedi_insn * insn, lsampl_t * data);
178 static int labpc_ao_winsn(comedi_device * dev, comedi_subdevice * s,
179 comedi_insn * insn, lsampl_t * data);
180 static int labpc_ao_rinsn(comedi_device * dev, comedi_subdevice * s,
181 comedi_insn * insn, lsampl_t * data);
182 static int labpc_calib_read_insn(comedi_device * dev, comedi_subdevice * s,
183 comedi_insn * insn, lsampl_t * data);
184 static int labpc_calib_write_insn(comedi_device * dev, comedi_subdevice * s,
185 comedi_insn * insn, lsampl_t * data);
186 static int labpc_eeprom_read_insn(comedi_device * dev, comedi_subdevice * s,
187 comedi_insn * insn, lsampl_t * data);
188 static int labpc_eeprom_write_insn(comedi_device * dev, comedi_subdevice * s,
189 comedi_insn * insn, lsampl_t * data);
190 static unsigned int labpc_suggest_transfer_size(comedi_cmd cmd);
191 static void labpc_adc_timing(comedi_device * dev, comedi_cmd * cmd);
192 #ifdef CONFIG_COMEDI_PCI
193 static int labpc_find_device(comedi_device *dev, int bus, int slot);
195 static int labpc_dio_mem_callback(int dir, int port, int data,
197 static void labpc_serial_out(comedi_device * dev, unsigned int value,
198 unsigned int num_bits);
199 static unsigned int labpc_serial_in(comedi_device * dev);
200 static unsigned int labpc_eeprom_read(comedi_device * dev,
201 unsigned int address);
202 static unsigned int labpc_eeprom_read_status(comedi_device * dev);
203 static unsigned int labpc_eeprom_write(comedi_device * dev,
204 unsigned int address, unsigned int value);
205 static void write_caldac(comedi_device * dev, unsigned int channel,
210 MODE_SINGLE_CHAN_INTERVAL,
215 //analog input ranges
216 #define NUM_LABPC_PLUS_AI_RANGES 16
217 // indicates unipolar ranges
218 static const int labpc_plus_is_unipolar[NUM_LABPC_PLUS_AI_RANGES] = {
237 // map range index to gain bits
238 static const int labpc_plus_ai_gain_bits[NUM_LABPC_PLUS_AI_RANGES] = {
256 static const comedi_lrange range_labpc_plus_ai = {
257 NUM_LABPC_PLUS_AI_RANGES,
278 #define NUM_LABPC_1200_AI_RANGES 14
279 // indicates unipolar ranges
280 const int labpc_1200_is_unipolar[NUM_LABPC_1200_AI_RANGES] = {
297 // map range index to gain bits
298 const int labpc_1200_ai_gain_bits[NUM_LABPC_1200_AI_RANGES] = {
314 const comedi_lrange range_labpc_1200_ai = {
315 NUM_LABPC_1200_AI_RANGES,
334 //analog output ranges
335 #define AO_RANGE_IS_UNIPOLAR 0x1
336 static const comedi_lrange range_labpc_ao = {
344 /* functions that do inb/outb and readb/writeb so we can use
345 * function pointers to decide which to use */
346 static inline unsigned int labpc_inb(unsigned long address)
350 static inline void labpc_outb(unsigned int byte, unsigned long address)
354 static inline unsigned int labpc_readb(unsigned long address)
356 return readb((void *)address);
358 static inline void labpc_writeb(unsigned int byte, unsigned long address)
360 writeb(byte, (void *)address);
363 static const labpc_board labpc_boards[] = {
367 bustype: isa_bustype,
368 register_layout:labpc_1200_layout,
370 ai_range_table:&range_labpc_1200_ai,
371 ai_range_code:labpc_1200_ai_gain_bits,
372 ai_range_is_unipolar:labpc_1200_is_unipolar,
377 name: "lab-pc-1200ai",
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,
391 bustype: isa_bustype,
392 register_layout:labpc_plus_layout,
394 ai_range_table:&range_labpc_plus_ai,
395 ai_range_code:labpc_plus_ai_gain_bits,
396 ai_range_is_unipolar:labpc_plus_is_unipolar,
400 #ifdef CONFIG_COMEDI_PCI
405 bustype: pci_bustype,
406 register_layout:labpc_1200_layout,
408 ai_range_table:&range_labpc_1200_ai,
409 ai_range_code:labpc_1200_ai_gain_bits,
410 ai_range_is_unipolar:labpc_1200_is_unipolar,
414 // dummy entry so pci board works when comedi_config is passed driver name
417 .bustype = pci_bustype,
423 * Useful for shorthand access to the particular board structure
425 #define thisboard ((labpc_board *)dev->board_ptr)
427 static const int dma_buffer_size = 0xff00; // size in bytes of dma buffer
428 static const int sample_size = 2; // 2 bytes per sample
430 #define devpriv ((labpc_private *)dev->private)
432 static comedi_driver driver_labpc = {
433 .driver_name = DRV_NAME,
434 .module = THIS_MODULE,
435 .attach = labpc_attach,
436 .detach = labpc_common_detach,
437 .num_names = sizeof(labpc_boards) / sizeof(labpc_board),
438 .board_name = &labpc_boards[0].name,
439 .offset = sizeof(labpc_board),
442 #ifdef CONFIG_COMEDI_PCI
443 static DEFINE_PCI_DEVICE_TABLE(labpc_pci_table) = {
444 {PCI_VENDOR_ID_NATINST, 0x161, PCI_ANY_ID, PCI_ANY_ID, 0, 0, 0},
448 MODULE_DEVICE_TABLE(pci, labpc_pci_table);
449 #endif /* CONFIG_COMEDI_PCI */
451 static inline int labpc_counter_load(comedi_device * dev,
452 unsigned long base_address, unsigned int counter_number,
453 unsigned int count, unsigned int mode)
455 if (thisboard->memory_mapped_io)
456 return i8254_mm_load((void *)base_address, 0, counter_number,
459 return i8254_load(base_address, 0, counter_number, count, mode);
462 int labpc_common_attach(comedi_device * dev, unsigned long iobase,
463 unsigned int irq, unsigned int dma_chan)
467 unsigned long dma_flags, isr_flags;
470 printk("comedi%d: ni_labpc: %s, io 0x%lx", dev->minor, thisboard->name,
473 printk(", irq %u", irq);
476 printk(", dma %u", dma_chan);
481 printk("io base address is zero!\n");
484 // request io regions for isa boards
485 if (thisboard->bustype == isa_bustype) {
486 /* check if io addresses are available */
487 if (!request_region(iobase, LABPC_SIZE,
488 driver_labpc.driver_name)) {
489 printk("I/O port conflict\n");
493 dev->iobase = iobase;
495 if (thisboard->memory_mapped_io) {
496 devpriv->read_byte = labpc_readb;
497 devpriv->write_byte = labpc_writeb;
499 devpriv->read_byte = labpc_inb;
500 devpriv->write_byte = labpc_outb;
502 // initialize board's command registers
503 devpriv->write_byte(devpriv->command1_bits, dev->iobase + COMMAND1_REG);
504 devpriv->write_byte(devpriv->command2_bits, dev->iobase + COMMAND2_REG);
505 devpriv->write_byte(devpriv->command3_bits, dev->iobase + COMMAND3_REG);
506 devpriv->write_byte(devpriv->command4_bits, dev->iobase + COMMAND4_REG);
507 if (thisboard->register_layout == labpc_1200_layout) {
508 devpriv->write_byte(devpriv->command5_bits,
509 dev->iobase + COMMAND5_REG);
510 devpriv->write_byte(devpriv->command6_bits,
511 dev->iobase + COMMAND6_REG);
517 if (thisboard->bustype == pci_bustype
518 || thisboard->bustype == pcmcia_bustype)
519 isr_flags |= IRQF_SHARED;
520 if (comedi_request_irq(irq, labpc_interrupt, isr_flags,
521 driver_labpc.driver_name, dev)) {
522 printk("unable to allocate irq %u\n", irq);
530 printk(" invalid dma channel %u\n", dma_chan);
532 } else if (dma_chan) {
533 // allocate dma buffer
534 devpriv->dma_buffer =
535 kmalloc(dma_buffer_size, GFP_KERNEL | GFP_DMA);
536 if (devpriv->dma_buffer == NULL) {
537 printk(" failed to allocate dma buffer\n");
540 if (request_dma(dma_chan, driver_labpc.driver_name)) {
541 printk(" failed to allocate dma channel %u\n",
545 devpriv->dma_chan = dma_chan;
546 dma_flags = claim_dma_lock();
547 disable_dma(devpriv->dma_chan);
548 set_dma_mode(devpriv->dma_chan, DMA_MODE_READ);
549 release_dma_lock(dma_flags);
552 dev->board_name = thisboard->name;
554 if (alloc_subdevices(dev, 5) < 0)
557 /* analog input subdevice */
558 s = dev->subdevices + 0;
559 dev->read_subdev = s;
560 s->type = COMEDI_SUBD_AI;
562 SDF_READABLE | SDF_GROUND | SDF_COMMON | SDF_DIFF |
566 s->maxdata = (1 << 12) - 1; // 12 bit resolution
567 s->range_table = thisboard->ai_range_table;
568 s->do_cmd = labpc_ai_cmd;
569 s->do_cmdtest = labpc_ai_cmdtest;
570 s->insn_read = labpc_ai_rinsn;
571 s->cancel = labpc_cancel;
574 s = dev->subdevices + 1;
575 if (thisboard->has_ao) {
576 /* Could provide command support, except it only has a one sample
577 * hardware buffer for analog output and no underrun flag. */
578 s->type = COMEDI_SUBD_AO;
579 s->subdev_flags = SDF_READABLE | SDF_WRITABLE | SDF_GROUND;
580 s->n_chan = NUM_AO_CHAN;
581 s->maxdata = (1 << 12) - 1; // 12 bit resolution
582 s->range_table = &range_labpc_ao;
583 s->insn_read = labpc_ao_rinsn;
584 s->insn_write = labpc_ao_winsn;
585 /* initialize analog outputs to a known value */
586 for (i = 0; i < s->n_chan; i++) {
587 devpriv->ao_value[i] = s->maxdata / 2;
588 lsb = devpriv->ao_value[i] & 0xff;
589 msb = (devpriv->ao_value[i] >> 8) & 0xff;
590 devpriv->write_byte(lsb, dev->iobase + DAC_LSB_REG(i));
591 devpriv->write_byte(msb, dev->iobase + DAC_MSB_REG(i));
594 s->type = COMEDI_SUBD_UNUSED;
598 s = dev->subdevices + 2;
599 // if board uses io memory we have to give a custom callback function to the 8255 driver
600 if (thisboard->memory_mapped_io)
601 subdev_8255_init(dev, s, labpc_dio_mem_callback,
602 (unsigned long)(dev->iobase + DIO_BASE_REG));
604 subdev_8255_init(dev, s, NULL, dev->iobase + DIO_BASE_REG);
606 // calibration subdevices for boards that have one
607 s = dev->subdevices + 3;
608 if (thisboard->register_layout == labpc_1200_layout) {
609 s->type = COMEDI_SUBD_CALIB;
610 s->subdev_flags = SDF_READABLE | SDF_WRITABLE | SDF_INTERNAL;
613 s->insn_read = labpc_calib_read_insn;
614 s->insn_write = labpc_calib_write_insn;
616 for (i = 0; i < s->n_chan; i++)
617 write_caldac(dev, i, s->maxdata / 2);
619 s->type = COMEDI_SUBD_UNUSED;
622 s = dev->subdevices + 4;
623 if (thisboard->register_layout == labpc_1200_layout) {
624 s->type = COMEDI_SUBD_MEMORY;
625 s->subdev_flags = SDF_READABLE | SDF_WRITABLE | SDF_INTERNAL;
626 s->n_chan = EEPROM_SIZE;
628 s->insn_read = labpc_eeprom_read_insn;
629 s->insn_write = labpc_eeprom_write_insn;
631 for (i = 0; i < EEPROM_SIZE; i++) {
632 devpriv->eeprom_data[i] = labpc_eeprom_read(dev, i);
636 for (i = 0; i < EEPROM_SIZE; i++) {
637 printk(" %i:0x%x ", i, devpriv->eeprom_data[i]);
642 s->type = COMEDI_SUBD_UNUSED;
647 static int labpc_attach(comedi_device * dev, comedi_devconfig * it)
649 unsigned long iobase = 0;
650 unsigned int irq = 0;
651 unsigned int dma_chan = 0;
652 #ifdef CONFIG_COMEDI_PCI
656 /* allocate and initialize dev->private */
657 if (alloc_private(dev, sizeof(labpc_private)) < 0)
660 // get base address, irq etc. based on bustype
661 switch (thisboard->bustype) {
663 iobase = it->options[0];
664 irq = it->options[1];
665 dma_chan = it->options[2];
668 #ifdef CONFIG_COMEDI_PCI
669 retval = labpc_find_device(dev, it->options[0], it->options[1]);
673 retval = mite_setup(devpriv->mite);
676 iobase = (unsigned long)devpriv->mite->daq_io_addr;
677 irq = mite_irq(devpriv->mite);
679 printk(" this driver has not been built with PCI support.\n");
684 printk(" this driver does not support pcmcia cards, use ni_labpc_cs.o\n");
688 printk("bug! couldn't determine board type\n");
693 return labpc_common_attach(dev, iobase, irq, dma_chan);
696 // adapted from ni_pcimio for finding mite based boards (pc-1200)
697 #ifdef CONFIG_COMEDI_PCI
698 static int labpc_find_device(comedi_device *dev, int bus, int slot)
700 struct mite_struct *mite;
702 for (mite = mite_devices; mite; mite = mite->next) {
705 // if bus/slot are specified then make sure we have the right bus/slot
707 if (bus != mite->pcidev->bus->number
708 || slot != PCI_SLOT(mite->pcidev->devfn))
711 for (i = 0; i < driver_labpc.num_names; i++) {
712 if (labpc_boards[i].bustype != pci_bustype)
714 if (mite_device_id(mite) == labpc_boards[i].device_id) {
715 devpriv->mite = mite;
716 // fixup board pointer, in case we were using the dummy "ni_labpc" entry
717 dev->board_ptr = &labpc_boards[i];
722 printk("no device found\n");
728 int labpc_common_detach(comedi_device * dev)
730 printk("comedi%d: ni_labpc: detach\n", dev->minor);
733 subdev_8255_cleanup(dev, dev->subdevices + 2);
735 /* only free stuff if it has been allocated by _attach */
736 if (devpriv->dma_buffer)
737 kfree(devpriv->dma_buffer);
738 if (devpriv->dma_chan)
739 free_dma(devpriv->dma_chan);
741 comedi_free_irq(dev->irq, dev);
742 if (thisboard->bustype == isa_bustype && dev->iobase)
743 release_region(dev->iobase, LABPC_SIZE);
744 #ifdef CONFIG_COMEDI_PCI
746 mite_unsetup(devpriv->mite);
752 static void labpc_clear_adc_fifo(const comedi_device * dev)
754 devpriv->write_byte(0x1, dev->iobase + ADC_CLEAR_REG);
755 devpriv->read_byte(dev->iobase + ADC_FIFO_REG);
756 devpriv->read_byte(dev->iobase + ADC_FIFO_REG);
759 static int labpc_cancel(comedi_device * dev, comedi_subdevice * s)
763 comedi_spin_lock_irqsave(&dev->spinlock, flags);
764 devpriv->command2_bits &= ~SWTRIG_BIT & ~HWTRIG_BIT & ~PRETRIG_BIT;
765 devpriv->write_byte(devpriv->command2_bits, dev->iobase + COMMAND2_REG);
766 comedi_spin_unlock_irqrestore(&dev->spinlock, flags);
768 devpriv->command3_bits = 0;
769 devpriv->write_byte(devpriv->command3_bits, dev->iobase + COMMAND3_REG);
774 static enum scan_mode labpc_ai_scan_mode(const comedi_cmd * cmd)
776 if (cmd->chanlist_len == 1)
777 return MODE_SINGLE_CHAN;
779 /* chanlist may be NULL during cmdtest. */
780 if (cmd->chanlist == NULL)
781 return MODE_MULT_CHAN_UP;
783 if (CR_CHAN(cmd->chanlist[0]) == CR_CHAN(cmd->chanlist[1]))
784 return MODE_SINGLE_CHAN_INTERVAL;
786 if (CR_CHAN(cmd->chanlist[0]) < CR_CHAN(cmd->chanlist[1]))
787 return MODE_MULT_CHAN_UP;
789 if (CR_CHAN(cmd->chanlist[0]) > CR_CHAN(cmd->chanlist[1]))
790 return MODE_MULT_CHAN_DOWN;
792 rt_printk("ni_labpc: bug! this should never happen\n");
797 static int labpc_ai_chanlist_invalid(const comedi_device * dev,
798 const comedi_cmd * cmd)
800 int mode, channel, range, aref, i;
802 if (cmd->chanlist == NULL)
805 mode = labpc_ai_scan_mode(cmd);
807 if (mode == MODE_SINGLE_CHAN)
810 if (mode == MODE_SINGLE_CHAN_INTERVAL) {
811 if (cmd->chanlist_len > 0xff) {
813 "ni_labpc: chanlist too long for single channel interval mode\n");
818 channel = CR_CHAN(cmd->chanlist[0]);
819 range = CR_RANGE(cmd->chanlist[0]);
820 aref = CR_AREF(cmd->chanlist[0]);
822 for (i = 0; i < cmd->chanlist_len; i++) {
825 case MODE_SINGLE_CHAN_INTERVAL:
826 if (CR_CHAN(cmd->chanlist[i]) != channel) {
828 "channel scanning order specified in chanlist is not supported by hardware.\n");
832 case MODE_MULT_CHAN_UP:
833 if (CR_CHAN(cmd->chanlist[i]) != i) {
835 "channel scanning order specified in chanlist is not supported by hardware.\n");
839 case MODE_MULT_CHAN_DOWN:
840 if (CR_CHAN(cmd->chanlist[i]) !=
841 cmd->chanlist_len - i - 1) {
843 "channel scanning order specified in chanlist is not supported by hardware.\n");
848 rt_printk("ni_labpc: bug! in chanlist check\n");
853 if (CR_RANGE(cmd->chanlist[i]) != range) {
855 "entries in chanlist must all have the same range\n");
859 if (CR_AREF(cmd->chanlist[i]) != aref) {
861 "entries in chanlist must all have the same reference\n");
869 static int labpc_use_continuous_mode(const comedi_cmd * cmd)
871 if (labpc_ai_scan_mode(cmd) == MODE_SINGLE_CHAN)
874 if (cmd->scan_begin_src == TRIG_FOLLOW)
880 static unsigned int labpc_ai_convert_period(const comedi_cmd * cmd)
882 if (cmd->convert_src != TRIG_TIMER)
885 if (labpc_ai_scan_mode(cmd) == MODE_SINGLE_CHAN &&
886 cmd->scan_begin_src == TRIG_TIMER)
887 return cmd->scan_begin_arg;
889 return cmd->convert_arg;
892 static void labpc_set_ai_convert_period(comedi_cmd * cmd, unsigned int ns)
894 if (cmd->convert_src != TRIG_TIMER)
897 if (labpc_ai_scan_mode(cmd) == MODE_SINGLE_CHAN &&
898 cmd->scan_begin_src == TRIG_TIMER) {
899 cmd->scan_begin_arg = ns;
900 if (cmd->convert_arg > cmd->scan_begin_arg)
901 cmd->convert_arg = cmd->scan_begin_arg;
903 cmd->convert_arg = ns;
906 static unsigned int labpc_ai_scan_period(const comedi_cmd * cmd)
908 if (cmd->scan_begin_src != TRIG_TIMER)
911 if (labpc_ai_scan_mode(cmd) == MODE_SINGLE_CHAN &&
912 cmd->convert_src == TRIG_TIMER)
915 return cmd->scan_begin_arg;
918 static void labpc_set_ai_scan_period(comedi_cmd * cmd, unsigned int ns)
920 if (cmd->scan_begin_src != TRIG_TIMER)
923 if (labpc_ai_scan_mode(cmd) == MODE_SINGLE_CHAN &&
924 cmd->convert_src == TRIG_TIMER)
927 cmd->scan_begin_arg = ns;
930 static int labpc_ai_cmdtest(comedi_device * dev, comedi_subdevice * s,
937 /* step 1: make sure trigger sources are trivially valid */
939 tmp = cmd->start_src;
940 cmd->start_src &= TRIG_NOW | TRIG_EXT;
941 if (!cmd->start_src || tmp != cmd->start_src)
944 tmp = cmd->scan_begin_src;
945 cmd->scan_begin_src &= TRIG_TIMER | TRIG_FOLLOW | TRIG_EXT;
946 if (!cmd->scan_begin_src || tmp != cmd->scan_begin_src)
949 tmp = cmd->convert_src;
950 cmd->convert_src &= TRIG_TIMER | TRIG_EXT;
951 if (!cmd->convert_src || tmp != cmd->convert_src)
954 tmp = cmd->scan_end_src;
955 cmd->scan_end_src &= TRIG_COUNT;
956 if (!cmd->scan_end_src || tmp != cmd->scan_end_src)
960 stop_mask = TRIG_COUNT | TRIG_NONE;
961 if (thisboard->register_layout == labpc_1200_layout)
962 stop_mask |= TRIG_EXT;
963 cmd->stop_src &= stop_mask;
964 if (!cmd->stop_src || tmp != cmd->stop_src)
970 /* step 2: make sure trigger sources are unique and mutually compatible */
972 if (cmd->start_src != TRIG_NOW && cmd->start_src != TRIG_EXT)
974 if (cmd->scan_begin_src != TRIG_TIMER &&
975 cmd->scan_begin_src != TRIG_FOLLOW &&
976 cmd->scan_begin_src != TRIG_EXT)
978 if (cmd->convert_src != TRIG_TIMER && cmd->convert_src != TRIG_EXT)
980 if (cmd->stop_src != TRIG_COUNT &&
981 cmd->stop_src != TRIG_EXT && cmd->stop_src != TRIG_NONE)
984 // can't have external stop and start triggers at once
985 if (cmd->start_src == TRIG_EXT && cmd->stop_src == TRIG_EXT)
991 /* step 3: make sure arguments are trivially compatible */
993 if (cmd->start_arg == TRIG_NOW && cmd->start_arg != 0) {
998 if (!cmd->chanlist_len) {
1001 if (cmd->scan_end_arg != cmd->chanlist_len) {
1002 cmd->scan_end_arg = cmd->chanlist_len;
1006 if (cmd->convert_src == TRIG_TIMER) {
1007 if (cmd->convert_arg < thisboard->ai_speed) {
1008 cmd->convert_arg = thisboard->ai_speed;
1012 // make sure scan timing is not too fast
1013 if (cmd->scan_begin_src == TRIG_TIMER) {
1014 if (cmd->convert_src == TRIG_TIMER &&
1015 cmd->scan_begin_arg <
1016 cmd->convert_arg * cmd->chanlist_len) {
1017 cmd->scan_begin_arg =
1018 cmd->convert_arg * cmd->chanlist_len;
1021 if (cmd->scan_begin_arg <
1022 thisboard->ai_speed * cmd->chanlist_len) {
1023 cmd->scan_begin_arg =
1024 thisboard->ai_speed * cmd->chanlist_len;
1029 switch (cmd->stop_src) {
1031 if (!cmd->stop_arg) {
1037 if (cmd->stop_arg != 0) {
1042 // TRIG_EXT doesn't care since it doesn't trigger off a numbered channel
1050 /* step 4: fix up any arguments */
1052 tmp = cmd->convert_arg;
1053 tmp2 = cmd->scan_begin_arg;
1054 labpc_adc_timing(dev, cmd);
1055 if (tmp != cmd->convert_arg || tmp2 != cmd->scan_begin_arg)
1061 if (labpc_ai_chanlist_invalid(dev, cmd))
1067 static int labpc_ai_cmd(comedi_device * dev, comedi_subdevice * s)
1069 int channel, range, aref;
1070 unsigned long irq_flags;
1072 comedi_async *async = s->async;
1073 comedi_cmd *cmd = &async->cmd;
1074 enum transfer_type xfer;
1075 unsigned long flags;
1078 comedi_error(dev, "no irq assigned, cannot perform command");
1082 range = CR_RANGE(cmd->chanlist[0]);
1083 aref = CR_AREF(cmd->chanlist[0]);
1085 // make sure board is disabled before setting up aquisition
1086 comedi_spin_lock_irqsave(&dev->spinlock, flags);
1087 devpriv->command2_bits &= ~SWTRIG_BIT & ~HWTRIG_BIT & ~PRETRIG_BIT;
1088 devpriv->write_byte(devpriv->command2_bits, dev->iobase + COMMAND2_REG);
1089 comedi_spin_unlock_irqrestore(&dev->spinlock, flags);
1091 devpriv->command3_bits = 0;
1092 devpriv->write_byte(devpriv->command3_bits, dev->iobase + COMMAND3_REG);
1094 // initialize software conversion count
1095 if (cmd->stop_src == TRIG_COUNT) {
1096 devpriv->count = cmd->stop_arg * cmd->chanlist_len;
1098 // setup hardware conversion counter
1099 if (cmd->stop_src == TRIG_EXT) {
1100 // load counter a1 with count of 3 (pc+ manual says this is minimum allowed) using mode 0
1101 ret = labpc_counter_load(dev, dev->iobase + COUNTER_A_BASE_REG,
1104 comedi_error(dev, "error loading counter a1");
1107 } else // otherwise, just put a1 in mode 0 with no count to set its output low
1108 devpriv->write_byte(INIT_A1_BITS,
1109 dev->iobase + COUNTER_A_CONTROL_REG);
1111 // figure out what method we will use to transfer data
1112 if (devpriv->dma_chan && // need a dma channel allocated
1113 // dma unsafe at RT priority, and too much setup time for TRIG_WAKE_EOS for
1114 (cmd->flags & (TRIG_WAKE_EOS | TRIG_RT)) == 0 &&
1115 // only available on the isa boards
1116 thisboard->bustype == isa_bustype) {
1117 xfer = isa_dma_transfer;
1118 } else if (thisboard->register_layout == labpc_1200_layout && // pc-plus has no fifo-half full interrupt
1119 // wake-end-of-scan should interrupt on fifo not empty
1120 (cmd->flags & TRIG_WAKE_EOS) == 0 &&
1121 // make sure we are taking more than just a few points
1122 (cmd->stop_src != TRIG_COUNT || devpriv->count > 256)) {
1123 xfer = fifo_half_full_transfer;
1125 xfer = fifo_not_empty_transfer;
1126 devpriv->current_transfer = xfer;
1128 // setup command6 register for 1200 boards
1129 if (thisboard->register_layout == labpc_1200_layout) {
1130 // reference inputs to ground or common?
1131 if (aref != AREF_GROUND)
1132 devpriv->command6_bits |= ADC_COMMON_BIT;
1134 devpriv->command6_bits &= ~ADC_COMMON_BIT;
1135 // bipolar or unipolar range?
1136 if (thisboard->ai_range_is_unipolar[range])
1137 devpriv->command6_bits |= ADC_UNIP_BIT;
1139 devpriv->command6_bits &= ~ADC_UNIP_BIT;
1140 // interrupt on fifo half full?
1141 if (xfer == fifo_half_full_transfer)
1142 devpriv->command6_bits |= ADC_FHF_INTR_EN_BIT;
1144 devpriv->command6_bits &= ~ADC_FHF_INTR_EN_BIT;
1145 // enable interrupt on counter a1 terminal count?
1146 if (cmd->stop_src == TRIG_EXT)
1147 devpriv->command6_bits |= A1_INTR_EN_BIT;
1149 devpriv->command6_bits &= ~A1_INTR_EN_BIT;
1150 // are we scanning up or down through channels?
1151 if (labpc_ai_scan_mode(cmd) == MODE_MULT_CHAN_UP)
1152 devpriv->command6_bits |= ADC_SCAN_UP_BIT;
1154 devpriv->command6_bits &= ~ADC_SCAN_UP_BIT;
1155 // write to register
1156 devpriv->write_byte(devpriv->command6_bits,
1157 dev->iobase + COMMAND6_REG);
1160 /* setup channel list, etc (command1 register) */
1161 devpriv->command1_bits = 0;
1162 if (labpc_ai_scan_mode(cmd) == MODE_MULT_CHAN_UP)
1163 channel = CR_CHAN(cmd->chanlist[cmd->chanlist_len - 1]);
1165 channel = CR_CHAN(cmd->chanlist[0]);
1166 // munge channel bits for differential / scan disabled mode
1167 if (labpc_ai_scan_mode(cmd) != MODE_SINGLE_CHAN && aref == AREF_DIFF)
1169 devpriv->command1_bits |= ADC_CHAN_BITS(channel);
1170 devpriv->command1_bits |= thisboard->ai_range_code[range];
1171 devpriv->write_byte(devpriv->command1_bits, dev->iobase + COMMAND1_REG);
1172 // manual says to set scan enable bit on second pass
1173 if (labpc_ai_scan_mode(cmd) == MODE_MULT_CHAN_UP ||
1174 labpc_ai_scan_mode(cmd) == MODE_MULT_CHAN_DOWN) {
1175 devpriv->command1_bits |= ADC_SCAN_EN_BIT;
1176 /* need a brief delay before enabling scan, or scan list will get screwed when you switch
1177 * between scan up to scan down mode - dunno why */
1179 devpriv->write_byte(devpriv->command1_bits,
1180 dev->iobase + COMMAND1_REG);
1182 // setup any external triggering/pacing (command4 register)
1183 devpriv->command4_bits = 0;
1184 if (cmd->convert_src != TRIG_EXT)
1185 devpriv->command4_bits |= EXT_CONVERT_DISABLE_BIT;
1186 /* XXX should discard first scan when using interval scanning
1187 * since manual says it is not synced with scan clock */
1188 if (labpc_use_continuous_mode(cmd) == 0) {
1189 devpriv->command4_bits |= INTERVAL_SCAN_EN_BIT;
1190 if (cmd->scan_begin_src == TRIG_EXT)
1191 devpriv->command4_bits |= EXT_SCAN_EN_BIT;
1193 // single-ended/differential
1194 if (aref == AREF_DIFF)
1195 devpriv->command4_bits |= ADC_DIFF_BIT;
1196 devpriv->write_byte(devpriv->command4_bits, dev->iobase + COMMAND4_REG);
1198 devpriv->write_byte(cmd->chanlist_len,
1199 dev->iobase + INTERVAL_COUNT_REG);
1201 devpriv->write_byte(INTERVAL_LOAD_BITS,
1202 dev->iobase + INTERVAL_LOAD_REG);
1204 if (cmd->convert_src == TRIG_TIMER || cmd->scan_begin_src == TRIG_TIMER) {
1206 labpc_adc_timing(dev, cmd);
1207 // load counter b0 in mode 3
1208 ret = labpc_counter_load(dev, dev->iobase + COUNTER_B_BASE_REG,
1209 0, devpriv->divisor_b0, 3);
1211 comedi_error(dev, "error loading counter b0");
1215 // set up conversion pacing
1216 if (labpc_ai_convert_period(cmd)) {
1217 // load counter a0 in mode 2
1218 ret = labpc_counter_load(dev, dev->iobase + COUNTER_A_BASE_REG,
1219 0, devpriv->divisor_a0, 2);
1221 comedi_error(dev, "error loading counter a0");
1225 devpriv->write_byte(INIT_A0_BITS,
1226 dev->iobase + COUNTER_A_CONTROL_REG);
1228 // set up scan pacing
1229 if (labpc_ai_scan_period(cmd)) {
1230 // load counter b1 in mode 2
1231 ret = labpc_counter_load(dev, dev->iobase + COUNTER_B_BASE_REG,
1232 1, devpriv->divisor_b1, 2);
1234 comedi_error(dev, "error loading counter b1");
1239 labpc_clear_adc_fifo(dev);
1241 // set up dma transfer
1242 if (xfer == isa_dma_transfer) {
1243 irq_flags = claim_dma_lock();
1244 disable_dma(devpriv->dma_chan);
1245 /* clear flip-flop to make sure 2-byte registers for
1246 * count and address get set correctly */
1247 clear_dma_ff(devpriv->dma_chan);
1248 set_dma_addr(devpriv->dma_chan,
1249 virt_to_bus(devpriv->dma_buffer));
1250 // set appropriate size of transfer
1251 devpriv->dma_transfer_size = labpc_suggest_transfer_size(*cmd);
1252 if (cmd->stop_src == TRIG_COUNT &&
1253 devpriv->count * sample_size <
1254 devpriv->dma_transfer_size) {
1255 devpriv->dma_transfer_size =
1256 devpriv->count * sample_size;
1258 set_dma_count(devpriv->dma_chan, devpriv->dma_transfer_size);
1259 enable_dma(devpriv->dma_chan);
1260 release_dma_lock(irq_flags);
1261 // enable board's dma
1262 devpriv->command3_bits |= DMA_EN_BIT | DMATC_INTR_EN_BIT;
1264 devpriv->command3_bits &= ~DMA_EN_BIT & ~DMATC_INTR_EN_BIT;
1266 // enable error interrupts
1267 devpriv->command3_bits |= ERR_INTR_EN_BIT;
1268 // enable fifo not empty interrupt?
1269 if (xfer == fifo_not_empty_transfer)
1270 devpriv->command3_bits |= ADC_FNE_INTR_EN_BIT;
1272 devpriv->command3_bits &= ~ADC_FNE_INTR_EN_BIT;
1273 devpriv->write_byte(devpriv->command3_bits, dev->iobase + COMMAND3_REG);
1275 // startup aquisition
1278 // use 2 cascaded counters for pacing
1279 comedi_spin_lock_irqsave(&dev->spinlock, flags);
1280 devpriv->command2_bits |= CASCADE_BIT;
1281 switch (cmd->start_src) {
1283 devpriv->command2_bits |= HWTRIG_BIT;
1284 devpriv->command2_bits &= ~PRETRIG_BIT & ~SWTRIG_BIT;
1287 devpriv->command2_bits |= SWTRIG_BIT;
1288 devpriv->command2_bits &= ~PRETRIG_BIT & ~HWTRIG_BIT;
1291 comedi_error(dev, "bug with start_src");
1292 comedi_spin_unlock_irqrestore(&dev->spinlock, flags);
1296 switch (cmd->stop_src) {
1298 devpriv->command2_bits |= HWTRIG_BIT | PRETRIG_BIT;
1304 comedi_error(dev, "bug with stop_src");
1305 comedi_spin_unlock_irqrestore(&dev->spinlock, flags);
1308 devpriv->write_byte(devpriv->command2_bits, dev->iobase + COMMAND2_REG);
1309 comedi_spin_unlock_irqrestore(&dev->spinlock, flags);
1314 /* interrupt service routine */
1315 static irqreturn_t labpc_interrupt(int irq, void *d PT_REGS_ARG)
1317 comedi_device *dev = d;
1318 comedi_subdevice *s = dev->read_subdev;
1319 comedi_async *async;
1322 if (dev->attached == 0) {
1323 comedi_error(dev, "premature interrupt");
1331 // read board status
1332 devpriv->status1_bits = devpriv->read_byte(dev->iobase + STATUS1_REG);
1333 if (thisboard->register_layout == labpc_1200_layout)
1334 devpriv->status2_bits =
1335 devpriv->read_byte(dev->iobase + STATUS2_REG);
1337 if ((devpriv->status1_bits & (DMATC_BIT | TIMER_BIT | OVERFLOW_BIT |
1338 OVERRUN_BIT | DATA_AVAIL_BIT)) == 0
1339 && (devpriv->status2_bits & A1_TC_BIT) == 0
1340 && (devpriv->status2_bits & FNHF_BIT)) {
1344 if (devpriv->status1_bits & OVERRUN_BIT) {
1345 // clear error interrupt
1346 devpriv->write_byte(0x1, dev->iobase + ADC_CLEAR_REG);
1347 async->events |= COMEDI_CB_ERROR | COMEDI_CB_EOA;
1348 comedi_event(dev, s);
1349 comedi_error(dev, "overrun");
1353 if (devpriv->current_transfer == isa_dma_transfer) {
1354 // if a dma terminal count of external stop trigger has occurred
1355 if (devpriv->status1_bits & DMATC_BIT ||
1356 (thisboard->register_layout == labpc_1200_layout
1357 && devpriv->status2_bits & A1_TC_BIT)) {
1358 handle_isa_dma(dev);
1361 labpc_drain_fifo(dev);
1363 if (devpriv->status1_bits & TIMER_BIT) {
1364 comedi_error(dev, "handled timer interrupt?");
1366 devpriv->write_byte(0x1, dev->iobase + TIMER_CLEAR_REG);
1369 if (devpriv->status1_bits & OVERFLOW_BIT) {
1370 // clear error interrupt
1371 devpriv->write_byte(0x1, dev->iobase + ADC_CLEAR_REG);
1372 async->events |= COMEDI_CB_ERROR | COMEDI_CB_EOA;
1373 comedi_event(dev, s);
1374 comedi_error(dev, "overflow");
1377 // handle external stop trigger
1378 if (cmd->stop_src == TRIG_EXT) {
1379 if (devpriv->status2_bits & A1_TC_BIT) {
1380 labpc_drain_dregs(dev);
1381 labpc_cancel(dev, s);
1382 async->events |= COMEDI_CB_EOA;
1386 /* TRIG_COUNT end of acquisition */
1387 if (cmd->stop_src == TRIG_COUNT) {
1388 if (devpriv->count == 0) {
1389 labpc_cancel(dev, s);
1390 async->events |= COMEDI_CB_EOA;
1394 comedi_event(dev, s);
1398 // read all available samples from ai fifo
1399 static int labpc_drain_fifo(comedi_device * dev)
1401 unsigned int lsb, msb;
1403 comedi_async *async = dev->read_subdev->async;
1404 const int timeout = 10000;
1407 devpriv->status1_bits = devpriv->read_byte(dev->iobase + STATUS1_REG);
1409 for (i = 0; (devpriv->status1_bits & DATA_AVAIL_BIT) && i < timeout;
1411 // quit if we have all the data we want
1412 if (async->cmd.stop_src == TRIG_COUNT) {
1413 if (devpriv->count == 0)
1417 lsb = devpriv->read_byte(dev->iobase + ADC_FIFO_REG);
1418 msb = devpriv->read_byte(dev->iobase + ADC_FIFO_REG);
1419 data = (msb << 8) | lsb;
1420 cfc_write_to_buffer(dev->read_subdev, data);
1421 devpriv->status1_bits =
1422 devpriv->read_byte(dev->iobase + STATUS1_REG);
1425 comedi_error(dev, "ai timeout, fifo never empties");
1426 async->events |= COMEDI_CB_ERROR | COMEDI_CB_EOA;
1433 static void labpc_drain_dma(comedi_device * dev)
1435 comedi_subdevice *s = dev->read_subdev;
1436 comedi_async *async = s->async;
1438 unsigned long flags;
1439 unsigned int max_points, num_points, residue, leftover;
1442 status = devpriv->status1_bits;
1444 flags = claim_dma_lock();
1445 disable_dma(devpriv->dma_chan);
1446 /* clear flip-flop to make sure 2-byte registers for
1447 * count and address get set correctly */
1448 clear_dma_ff(devpriv->dma_chan);
1450 // figure out how many points to read
1451 max_points = devpriv->dma_transfer_size / sample_size;
1452 /* residue is the number of points left to be done on the dma
1453 * transfer. It should always be zero at this point unless
1454 * the stop_src is set to external triggering.
1456 residue = get_dma_residue(devpriv->dma_chan) / sample_size;
1457 num_points = max_points - residue;
1458 if (devpriv->count < num_points && async->cmd.stop_src == TRIG_COUNT)
1459 num_points = devpriv->count;
1461 // figure out how many points will be stored next time
1463 if (async->cmd.stop_src != TRIG_COUNT) {
1464 leftover = devpriv->dma_transfer_size / sample_size;
1465 } else if (devpriv->count > num_points) {
1466 leftover = devpriv->count - num_points;
1467 if (leftover > max_points)
1468 leftover = max_points;
1471 /* write data to comedi buffer */
1472 for (i = 0; i < num_points; i++) {
1473 cfc_write_to_buffer(s, devpriv->dma_buffer[i]);
1475 if (async->cmd.stop_src == TRIG_COUNT)
1476 devpriv->count -= num_points;
1478 // set address and count for next transfer
1479 set_dma_addr(devpriv->dma_chan, virt_to_bus(devpriv->dma_buffer));
1480 set_dma_count(devpriv->dma_chan, leftover * sample_size);
1481 release_dma_lock(flags);
1483 async->events |= COMEDI_CB_BLOCK;
1486 static void handle_isa_dma(comedi_device * dev)
1488 labpc_drain_dma(dev);
1490 enable_dma(devpriv->dma_chan);
1492 // clear dma tc interrupt
1493 devpriv->write_byte(0x1, dev->iobase + DMATC_CLEAR_REG);
1496 /* makes sure all data aquired by board is transfered to comedi (used
1497 * when aquisition is terminated by stop_src == TRIG_EXT). */
1498 static void labpc_drain_dregs(comedi_device * dev)
1500 if (devpriv->current_transfer == isa_dma_transfer)
1501 labpc_drain_dma(dev);
1503 labpc_drain_fifo(dev);
1506 static int labpc_ai_rinsn(comedi_device * dev, comedi_subdevice * s,
1507 comedi_insn * insn, lsampl_t * data)
1513 unsigned long flags;
1515 // disable timed conversions
1516 comedi_spin_lock_irqsave(&dev->spinlock, flags);
1517 devpriv->command2_bits &= ~SWTRIG_BIT & ~HWTRIG_BIT & ~PRETRIG_BIT;
1518 devpriv->write_byte(devpriv->command2_bits, dev->iobase + COMMAND2_REG);
1519 comedi_spin_unlock_irqrestore(&dev->spinlock, flags);
1521 // disable interrupt generation and dma
1522 devpriv->command3_bits = 0;
1523 devpriv->write_byte(devpriv->command3_bits, dev->iobase + COMMAND3_REG);
1525 /* set gain and channel */
1526 devpriv->command1_bits = 0;
1527 chan = CR_CHAN(insn->chanspec);
1528 range = CR_RANGE(insn->chanspec);
1529 devpriv->command1_bits |= thisboard->ai_range_code[range];
1530 // munge channel bits for differential/scan disabled mode
1531 if (CR_AREF(insn->chanspec) == AREF_DIFF)
1533 devpriv->command1_bits |= ADC_CHAN_BITS(chan);
1534 devpriv->write_byte(devpriv->command1_bits, dev->iobase + COMMAND1_REG);
1536 // setup command6 register for 1200 boards
1537 if (thisboard->register_layout == labpc_1200_layout) {
1538 // reference inputs to ground or common?
1539 if (CR_AREF(insn->chanspec) != AREF_GROUND)
1540 devpriv->command6_bits |= ADC_COMMON_BIT;
1542 devpriv->command6_bits &= ~ADC_COMMON_BIT;
1543 // bipolar or unipolar range?
1544 if (thisboard->ai_range_is_unipolar[range])
1545 devpriv->command6_bits |= ADC_UNIP_BIT;
1547 devpriv->command6_bits &= ~ADC_UNIP_BIT;
1548 // don't interrupt on fifo half full
1549 devpriv->command6_bits &= ~ADC_FHF_INTR_EN_BIT;
1550 // don't enable interrupt on counter a1 terminal count?
1551 devpriv->command6_bits &= ~A1_INTR_EN_BIT;
1552 // write to register
1553 devpriv->write_byte(devpriv->command6_bits,
1554 dev->iobase + COMMAND6_REG);
1556 // setup command4 register
1557 devpriv->command4_bits = 0;
1558 devpriv->command4_bits |= EXT_CONVERT_DISABLE_BIT;
1559 // single-ended/differential
1560 if (CR_AREF(insn->chanspec) == AREF_DIFF)
1561 devpriv->command4_bits |= ADC_DIFF_BIT;
1562 devpriv->write_byte(devpriv->command4_bits, dev->iobase + COMMAND4_REG);
1564 // initialize pacer counter output to make sure it doesn't cause any problems
1565 devpriv->write_byte(INIT_A0_BITS, dev->iobase + COUNTER_A_CONTROL_REG);
1567 labpc_clear_adc_fifo(dev);
1569 for (n = 0; n < insn->n; n++) {
1570 /* trigger conversion */
1571 devpriv->write_byte(0x1, dev->iobase + ADC_CONVERT_REG);
1573 for (i = 0; i < timeout; i++) {
1574 if (devpriv->read_byte(dev->iobase +
1575 STATUS1_REG) & DATA_AVAIL_BIT)
1580 comedi_error(dev, "timeout");
1583 lsb = devpriv->read_byte(dev->iobase + ADC_FIFO_REG);
1584 msb = devpriv->read_byte(dev->iobase + ADC_FIFO_REG);
1585 data[n] = (msb << 8) | lsb;
1591 // analog output insn
1592 static int labpc_ao_winsn(comedi_device * dev, comedi_subdevice * s,
1593 comedi_insn * insn, lsampl_t * data)
1596 unsigned long flags;
1602 channel = CR_CHAN(insn->chanspec);
1604 // turn off pacing of analog output channel
1605 /* note: hardware bug in daqcard-1200 means pacing cannot
1606 * be independently enabled/disabled for its the two channels */
1607 comedi_spin_lock_irqsave(&dev->spinlock, flags);
1608 devpriv->command2_bits &= ~DAC_PACED_BIT(channel);
1609 devpriv->write_byte(devpriv->command2_bits, dev->iobase + COMMAND2_REG);
1610 comedi_spin_unlock_irqrestore(&dev->spinlock, flags);
1613 if (thisboard->register_layout == labpc_1200_layout) {
1614 range = CR_RANGE(insn->chanspec);
1615 if (range & AO_RANGE_IS_UNIPOLAR)
1616 devpriv->command6_bits |= DAC_UNIP_BIT(channel);
1618 devpriv->command6_bits &= ~DAC_UNIP_BIT(channel);
1619 // write to register
1620 devpriv->write_byte(devpriv->command6_bits,
1621 dev->iobase + COMMAND6_REG);
1624 lsb = data[0] & 0xff;
1625 msb = (data[0] >> 8) & 0xff;
1626 devpriv->write_byte(lsb, dev->iobase + DAC_LSB_REG(channel));
1627 devpriv->write_byte(msb, dev->iobase + DAC_MSB_REG(channel));
1629 // remember value for readback
1630 devpriv->ao_value[channel] = data[0];
1635 // analog output readback insn
1636 static int labpc_ao_rinsn(comedi_device * dev, comedi_subdevice * s,
1637 comedi_insn * insn, lsampl_t * data)
1642 data[0] = devpriv->ao_value[CR_CHAN(insn->chanspec)];
1647 static int labpc_calib_read_insn(comedi_device * dev, comedi_subdevice * s,
1648 comedi_insn * insn, lsampl_t * data)
1653 data[0] = devpriv->caldac[CR_CHAN(insn->chanspec)];
1658 static int labpc_calib_write_insn(comedi_device * dev, comedi_subdevice * s,
1659 comedi_insn * insn, lsampl_t * data)
1661 int channel = CR_CHAN(insn->chanspec);
1666 write_caldac(dev, channel, data[0]);
1670 static int labpc_eeprom_read_insn(comedi_device * dev, comedi_subdevice * s,
1671 comedi_insn * insn, lsampl_t * data)
1676 data[0] = devpriv->eeprom_data[CR_CHAN(insn->chanspec)];
1681 static int labpc_eeprom_write_insn(comedi_device * dev, comedi_subdevice * s,
1682 comedi_insn * insn, lsampl_t * data)
1684 int channel = CR_CHAN(insn->chanspec);
1687 // only allow writes to user area of eeprom
1688 if (channel < 16 || channel > 127) {
1689 printk("eeprom writes are only allowed to channels 16 through 127 (the pointer and user areas)");
1696 ret = labpc_eeprom_write(dev, channel, data[0]);
1703 // utility function that suggests a dma transfer size in bytes
1704 static unsigned int labpc_suggest_transfer_size(comedi_cmd cmd)
1709 if (cmd.convert_src == TRIG_TIMER)
1710 freq = 1000000000 / cmd.convert_arg;
1711 // return some default value
1715 // make buffer fill in no more than 1/3 second
1716 size = (freq / 3) * sample_size;
1718 // set a minimum and maximum size allowed
1719 if (size > dma_buffer_size)
1720 size = dma_buffer_size - dma_buffer_size % sample_size;
1721 else if (size < sample_size)
1727 // figures out what counter values to use based on command
1728 static void labpc_adc_timing(comedi_device * dev, comedi_cmd * cmd)
1730 const int max_counter_value = 0x10000; // max value for 16 bit counter in mode 2
1731 const int min_counter_value = 2; // min value for 16 bit counter in mode 2
1732 unsigned int base_period;
1734 // if both convert and scan triggers are TRIG_TIMER, then they both rely on counter b0
1735 if (labpc_ai_convert_period(cmd) && labpc_ai_scan_period(cmd)) {
1736 // pick the lowest b0 divisor value we can (for maximum input clock speed on convert and scan counters)
1737 devpriv->divisor_b0 = (labpc_ai_scan_period(cmd) - 1) /
1738 (LABPC_TIMER_BASE * max_counter_value) + 1;
1739 if (devpriv->divisor_b0 < min_counter_value)
1740 devpriv->divisor_b0 = min_counter_value;
1741 if (devpriv->divisor_b0 > max_counter_value)
1742 devpriv->divisor_b0 = max_counter_value;
1744 base_period = LABPC_TIMER_BASE * devpriv->divisor_b0;
1746 // set a0 for conversion frequency and b1 for scan frequency
1747 switch (cmd->flags & TRIG_ROUND_MASK) {
1749 case TRIG_ROUND_NEAREST:
1750 devpriv->divisor_a0 =
1751 (labpc_ai_convert_period(cmd) +
1752 (base_period / 2)) / base_period;
1753 devpriv->divisor_b1 =
1754 (labpc_ai_scan_period(cmd) +
1755 (base_period / 2)) / base_period;
1758 devpriv->divisor_a0 =
1759 (labpc_ai_convert_period(cmd) + (base_period -
1761 devpriv->divisor_b1 =
1762 (labpc_ai_scan_period(cmd) + (base_period -
1765 case TRIG_ROUND_DOWN:
1766 devpriv->divisor_a0 =
1767 labpc_ai_convert_period(cmd) / base_period;
1768 devpriv->divisor_b1 =
1769 labpc_ai_scan_period(cmd) / base_period;
1772 // make sure a0 and b1 values are acceptable
1773 if (devpriv->divisor_a0 < min_counter_value)
1774 devpriv->divisor_a0 = min_counter_value;
1775 if (devpriv->divisor_a0 > max_counter_value)
1776 devpriv->divisor_a0 = max_counter_value;
1777 if (devpriv->divisor_b1 < min_counter_value)
1778 devpriv->divisor_b1 = min_counter_value;
1779 if (devpriv->divisor_b1 > max_counter_value)
1780 devpriv->divisor_b1 = max_counter_value;
1781 // write corrected timings to command
1782 labpc_set_ai_convert_period(cmd,
1783 base_period * devpriv->divisor_a0);
1784 labpc_set_ai_scan_period(cmd,
1785 base_period * devpriv->divisor_b1);
1786 // if only one TRIG_TIMER is used, we can employ the generic cascaded timing functions
1787 } else if (labpc_ai_scan_period(cmd)) {
1788 unsigned int scan_period;
1790 scan_period = labpc_ai_scan_period(cmd);
1791 /* calculate cascaded counter values that give desired scan timing */
1792 i8253_cascade_ns_to_timer_2div(LABPC_TIMER_BASE,
1793 &(devpriv->divisor_b1), &(devpriv->divisor_b0),
1794 &scan_period, cmd->flags & TRIG_ROUND_MASK);
1795 labpc_set_ai_scan_period(cmd, scan_period);
1796 } else if (labpc_ai_convert_period(cmd)) {
1797 unsigned int convert_period;
1799 convert_period = labpc_ai_convert_period(cmd);
1800 /* calculate cascaded counter values that give desired conversion timing */
1801 i8253_cascade_ns_to_timer_2div(LABPC_TIMER_BASE,
1802 &(devpriv->divisor_a0), &(devpriv->divisor_b0),
1803 &convert_period, cmd->flags & TRIG_ROUND_MASK);
1804 labpc_set_ai_convert_period(cmd, convert_period);
1808 static int labpc_dio_mem_callback(int dir, int port, int data,
1809 unsigned long iobase)
1812 writeb(data, (void *)(iobase + port));
1815 return readb((void *)(iobase + port));
1819 // lowlevel write to eeprom/dac
1820 static void labpc_serial_out(comedi_device * dev, unsigned int value,
1821 unsigned int value_width)
1825 for (i = 1; i <= value_width; i++) {
1826 // clear serial clock
1827 devpriv->command5_bits &= ~SCLOCK_BIT;
1828 // send bits most significant bit first
1829 if (value & (1 << (value_width - i)))
1830 devpriv->command5_bits |= SDATA_BIT;
1832 devpriv->command5_bits &= ~SDATA_BIT;
1834 devpriv->write_byte(devpriv->command5_bits,
1835 dev->iobase + COMMAND5_REG);
1836 // set clock to load bit
1837 devpriv->command5_bits |= SCLOCK_BIT;
1839 devpriv->write_byte(devpriv->command5_bits,
1840 dev->iobase + COMMAND5_REG);
1844 // lowlevel read from eeprom
1845 static unsigned int labpc_serial_in(comedi_device * dev)
1847 unsigned int value = 0;
1849 const int value_width = 8; // number of bits wide values are
1851 for (i = 1; i <= value_width; i++) {
1853 devpriv->command5_bits |= SCLOCK_BIT;
1855 devpriv->write_byte(devpriv->command5_bits,
1856 dev->iobase + COMMAND5_REG);
1858 devpriv->command5_bits &= ~SCLOCK_BIT;
1860 devpriv->write_byte(devpriv->command5_bits,
1861 dev->iobase + COMMAND5_REG);
1862 // read bits most significant bit first
1864 devpriv->status2_bits =
1865 devpriv->read_byte(dev->iobase + STATUS2_REG);
1866 if (devpriv->status2_bits & EEPROM_OUT_BIT) {
1867 value |= 1 << (value_width - i);
1874 static unsigned int labpc_eeprom_read(comedi_device * dev, unsigned int address)
1877 const int read_instruction = 0x3; // bits to tell eeprom to expect a read
1878 const int write_length = 8; // 8 bit write lengths to eeprom
1880 // enable read/write to eeprom
1881 devpriv->command5_bits &= ~EEPROM_EN_BIT;
1883 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1884 devpriv->command5_bits |= EEPROM_EN_BIT | EEPROM_WRITE_UNPROTECT_BIT;
1886 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1888 // send read instruction
1889 labpc_serial_out(dev, read_instruction, write_length);
1890 // send 8 bit address to read from
1891 labpc_serial_out(dev, address, write_length);
1893 value = labpc_serial_in(dev);
1895 // disable read/write to eeprom
1896 devpriv->command5_bits &= ~EEPROM_EN_BIT & ~EEPROM_WRITE_UNPROTECT_BIT;
1898 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1903 static unsigned int labpc_eeprom_write(comedi_device * dev,
1904 unsigned int address, unsigned int value)
1906 const int write_enable_instruction = 0x6;
1907 const int write_instruction = 0x2;
1908 const int write_length = 8; // 8 bit write lengths to eeprom
1909 const int write_in_progress_bit = 0x1;
1910 const int timeout = 10000;
1913 // make sure there isn't already a write in progress
1914 for (i = 0; i < timeout; i++) {
1915 if ((labpc_eeprom_read_status(dev) & write_in_progress_bit) ==
1920 comedi_error(dev, "eeprom write timed out");
1923 // update software copy of eeprom
1924 devpriv->eeprom_data[address] = value;
1926 // enable read/write to eeprom
1927 devpriv->command5_bits &= ~EEPROM_EN_BIT;
1929 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1930 devpriv->command5_bits |= EEPROM_EN_BIT | EEPROM_WRITE_UNPROTECT_BIT;
1932 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1934 // send write_enable instruction
1935 labpc_serial_out(dev, write_enable_instruction, write_length);
1936 devpriv->command5_bits &= ~EEPROM_EN_BIT;
1938 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1940 // send write instruction
1941 devpriv->command5_bits |= EEPROM_EN_BIT;
1943 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1944 labpc_serial_out(dev, write_instruction, write_length);
1945 // send 8 bit address to write to
1946 labpc_serial_out(dev, address, write_length);
1948 labpc_serial_out(dev, value, write_length);
1949 devpriv->command5_bits &= ~EEPROM_EN_BIT;
1951 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1953 // disable read/write to eeprom
1954 devpriv->command5_bits &= ~EEPROM_EN_BIT & ~EEPROM_WRITE_UNPROTECT_BIT;
1956 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1961 static unsigned int labpc_eeprom_read_status(comedi_device * dev)
1964 const int read_status_instruction = 0x5;
1965 const int write_length = 8; // 8 bit write lengths to eeprom
1967 // enable read/write to eeprom
1968 devpriv->command5_bits &= ~EEPROM_EN_BIT;
1970 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1971 devpriv->command5_bits |= EEPROM_EN_BIT | EEPROM_WRITE_UNPROTECT_BIT;
1973 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1975 // send read status instruction
1976 labpc_serial_out(dev, read_status_instruction, write_length);
1978 value = labpc_serial_in(dev);
1980 // disable read/write to eeprom
1981 devpriv->command5_bits &= ~EEPROM_EN_BIT & ~EEPROM_WRITE_UNPROTECT_BIT;
1983 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
1988 // writes to 8 bit calibration dacs
1989 static void write_caldac(comedi_device * dev, unsigned int channel,
1992 if (value == devpriv->caldac[channel])
1994 devpriv->caldac[channel] = value;
1996 // clear caldac load bit and make sure we don't write to eeprom
1997 devpriv->command5_bits &=
1998 ~CALDAC_LOAD_BIT & ~EEPROM_EN_BIT & ~EEPROM_WRITE_UNPROTECT_BIT;
2000 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
2002 // write 4 bit channel
2003 labpc_serial_out(dev, channel, 4);
2004 // write 8 bit caldac value
2005 labpc_serial_out(dev, value, 8);
2007 // set and clear caldac bit to load caldac value
2008 devpriv->command5_bits |= CALDAC_LOAD_BIT;
2010 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
2011 devpriv->command5_bits &= ~CALDAC_LOAD_BIT;
2013 devpriv->write_byte(devpriv->command5_bits, dev->iobase + COMMAND5_REG);
2016 #ifdef CONFIG_COMEDI_PCI
2017 COMEDI_PCI_INITCLEANUP(driver_labpc, labpc_pci_table);
2019 COMEDI_INITCLEANUP(driver_labpc);
2022 EXPORT_SYMBOL_GPL(labpc_common_attach);
2023 EXPORT_SYMBOL_GPL(labpc_common_detach);
2024 EXPORT_SYMBOL_GPL(range_labpc_1200_ai);
2025 EXPORT_SYMBOL_GPL(labpc_1200_ai_gain_bits);
2026 EXPORT_SYMBOL_GPL(labpc_1200_is_unipolar);