From 44dabdd7e09571c8b74769cd82dcb3a2266b2787 Mon Sep 17 00:00:00 2001 From: Frank Mori Hess Date: Sat, 28 Jan 2006 15:19:42 +0000 Subject: [PATCH] Added new driver for Winsystems PCM DA-12 AO board from calin@ajvar.org (Calin A. Culianu). --- comedi/drivers/Makefile.am | 4 +- comedi/drivers/pcmda12.c | 321 +++++++++++++++++++++++++++++++++++++ 2 files changed, 324 insertions(+), 1 deletion(-) create mode 100644 comedi/drivers/pcmda12.c diff --git a/comedi/drivers/Makefile.am b/comedi/drivers/Makefile.am index bae128de..3ac293af 100644 --- a/comedi/drivers/Makefile.am +++ b/comedi/drivers/Makefile.am @@ -141,6 +141,7 @@ module_PROGRAMS = \ pcm3724.ko \ pcm3730.ko \ pcmad.ko \ + pcmda12.ko \ poc.ko \ pcl711.ko \ pcl724.ko \ @@ -226,7 +227,6 @@ ni_daq_dio24_ko_SOURCES = ni_daq_dio24.c ni_at_ao_ko_SOURCES = ni_at_ao.c pcm3730_ko_SOURCES = pcm3730.c pcmad_ko_SOURCES = pcmad.c -poc_ko_SOURCES = poc.c pcl711_ko_SOURCES = pcl711.c pcl724_ko_SOURCES = pcl724.c pcl725_ko_SOURCES = pcl725.c @@ -235,7 +235,9 @@ pcl730_ko_SOURCES = pcl730.c pcl812_ko_SOURCES = pcl812.c pcl816_ko_SOURCES = pcl816.c pcl818_ko_SOURCES = pcl818.c +pcmda12_ko_SOURCES = pcmda12.c pcmuio_ko_SOURCES = pcmuio.c +poc_ko_SOURCES = poc.c quatech_daqp_cs_ko_SOURCES = quatech_daqp_cs.c comedi_parport_ko_SOURCES = comedi_parport.c comedi_rt_timer_ko_SOURCES = comedi_rt_timer.c diff --git a/comedi/drivers/pcmda12.c b/comedi/drivers/pcmda12.c new file mode 100644 index 00000000..382ef092 --- /dev/null +++ b/comedi/drivers/pcmda12.c @@ -0,0 +1,321 @@ +/* + comedi/drivers/pcmda12.c + Driver for Winsystems PC-104 based PCM-D/A-12 8-channel AO board. + + COMEDI - Linux Control and Measurement Device Interface + Copyright (C) 2006 Calin A. Culianu + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. +*/ +/* +Driver: pcmda12.o +Description: A driver for the Winsystems PCM-D/A-12 +Devices: (Winsystems) PCM-D/A-12 [pcmda12] +Author: Calin Culianu +Updated: Fri, 13 Jan 2006 12:01:01 -0500 +Status: works + +A driver for the relatively straightforward-to-program PCM-D/A-12. +This board doesn't support commands, and the only way to set its +analog output range is to jumper the board. As such, +comedi_data_write() ignores the range value specified. + +The board uses 16 consecutive I/O addresses starting at the I/O port +base address. Each address corresponds to the LSB then MSB of a +particular channel from 0-7. + +Note that the board is not ISA-PNP capable and thus +needs the I/O port comedi_config parameter. + +Note that passing a nonzero value as the second config option will +enable "simultaneous xfer" mode for this board, in which AO writes +will not take effect until a subsequent read of any AO channel. This +is so that one can speed up programming by preloading all AO registers +with values before simultaneously setting them to take effect with one +read command. + +Configuration Options: + [0] - I/O port base address + [1] - Do Simultaneous Xfer (see description) +*/ + + +#include + +#include /* for PCI devices */ + +#define MIN(a,b) ( ((a) < (b)) ? (a) : (b) ) +#define SDEV_NO ((int)(s - dev->subdevices)) +#define CHANS 8 +#define IOSIZE 16 +#define LSB(x) ((unsigned char)((x) & 0xff)) +#define MSB(x) ((unsigned char)((((unsigned short)(x))>>8) & 0xff)) +#define LSB_PORT(chan) (dev->iobase + (chan)*2) +#define MSB_PORT(chan) (LSB_PORT(chan)+1) +#define BITS 12 + +/* + * Bords + */ +typedef struct pcmda12_board_struct +{ + char * const name; +} pcmda12_board; + +/* note these have no effect and are merely here for reference.. + these are configured by jumpering the board! */ +static comedi_lrange pcmda12_ranges = +{ + 3, + { + UNI_RANGE( 5 ), UNI_RANGE( 10 ), BIP_RANGE( 5 ) + } +}; + +static pcmda12_board pcmda12_boards[] = +{ + { + name: "pcmda12", + }, +}; + +/* + * Useful for shorthand access to the particular board structure + */ +#define thisboard ((pcmda12_board *)dev->board_ptr) + +typedef struct +{ + lsampl_t ao_readback[CHANS]; + int simultaneous_xfer_mode; +} pcmda12_private; + +#define devpriv ((pcmda12_private *)(dev->private)) + +/* + * The comedi_driver structure tells the Comedi core module + * which functions to call to configure/deconfigure (attach/detach) + * the board, and also about the kernel module that contains + * the device code. + */ +static int pcmda12_attach(comedi_device *dev, comedi_devconfig *it); +static int pcmda12_detach(comedi_device *dev); + +static void zero_chans(comedi_device *dev); + +static comedi_driver driver = +{ + driver_name: "pcmda12", + module: THIS_MODULE, + attach: pcmda12_attach, + detach: pcmda12_detach, +/* It is not necessary to implement the following members if you are + * writing a driver for a ISA PnP or PCI card */ + /* Most drivers will support multiple types of boards by + * having an array of board structures. These were defined + * in pcmda12_boards[] above. Note that the element 'name' + * was first in the structure -- Comedi uses this fact to + * extract the name of the board without knowing any details + * about the structure except for its length. + * When a device is attached (by comedi_config), the name + * of the device is given to Comedi, and Comedi tries to + * match it by going through the list of board names. If + * there is a match, the address of the pointer is put + * into dev->board_ptr and driver->attach() is called. + * + * Note that these are not necessary if you can determine + * the type of board in software. ISA PnP, PCI, and PCMCIA + * devices are such boards. + */ + board_name: pcmda12_boards, + offset: sizeof(pcmda12_board), + num_names: sizeof(pcmda12_boards) / sizeof(pcmda12_board), +}; + +static int ao_winsn(comedi_device *dev,comedi_subdevice *s, + comedi_insn *insn,lsampl_t *data); +static int ao_rinsn(comedi_device *dev,comedi_subdevice *s, + comedi_insn *insn,lsampl_t *data); + +/* + * Attach is called by the Comedi core to configure the driver + * for a particular board. If you specified a board_name array + * in the driver structure, dev->board_ptr contains that + * address. + */ +static int pcmda12_attach(comedi_device *dev, comedi_devconfig *it) +{ + comedi_subdevice *s; + int iobase; + + iobase = it->options[0]; + printk("comedi%d: %s: io: %x %s ", dev->minor, driver.driver_name, iobase, it->options[1] ? "simultaneous xfer mode enabled" : ""); + + if ( !request_region(iobase, + IOSIZE, + driver.driver_name) ) { + printk("I/O port conflict\n"); + return -EIO; + } + dev->iobase = iobase; + + +/* + * Initialize dev->board_name. Note that we can use the "thisboard" + * macro now, since we just initialized it in the last line. + */ + dev->board_name = thisboard->name; + +/* + * Allocate the private structure area. alloc_private() is a + * convenient macro defined in comedidev.h. + */ + if (alloc_private(dev, sizeof(pcmda12_private)) < 0) { + printk("cannot allocate private data structure\n"); + return -ENOMEM; + } + + memset(devpriv, 0, sizeof(*devpriv)); + + devpriv->simultaneous_xfer_mode = it->options[1]; + + /* + * Allocate the subdevice structures. alloc_subdevice() is a + * convenient macro defined in comedidev.h. + * + * Allocate 2 subdevs (32 + 16 DIO lines) or 3 32 DIO subdevs for the + * 96-channel version of the board. + */ + if ( alloc_subdevices(dev, 1) < 0 ) { + printk("cannot allocate subdevice data structures\n"); + return -ENOMEM; + } + + s = dev->subdevices; + s->private = NULL; + s->maxdata = (0x1<range_table = &pcmda12_ranges; + s->type = COMEDI_SUBD_AO; + s->subdev_flags = SDF_READABLE|SDF_WRITABLE; + s->n_chan = CHANS; + s->insn_write = &ao_winsn; + s->insn_read = &ao_rinsn; + + zero_chans(dev); /* clear out all the registers, basically */ + + printk("attached\n"); + + return 1; +} + + +/* + * _detach is called to deconfigure a device. It should deallocate + * resources. + * This function is also called when _attach() fails, so it should be + * careful not to release resources that were not necessarily + * allocated by _attach(). dev->private and dev->subdevices are + * deallocated automatically by the core. + */ +static int pcmda12_detach(comedi_device *dev) +{ + printk("comedi%d: %s: remove\n", dev->minor, driver.driver_name); + if (dev->iobase) + release_region(dev->iobase, IOSIZE); + return 0; +} + +static void zero_chans(comedi_device *dev) /* sets up an + ASIC chip to defaults */ +{ + int i; + for (i = 0; i < CHANS; ++i) { +/* /\* do this as one instruction?? *\/ */ +/* outw(0, LSB_PORT(chan)); */ + outb(0, LSB_PORT(i)); + outb(0, MSB_PORT(i)); + } + inb(LSB_PORT(0)); /* update chans. */ +} + + +static int ao_winsn(comedi_device *dev, comedi_subdevice *s, comedi_insn *insn, + lsampl_t *data) +{ + int i; + int chan = CR_CHAN(insn->chanspec); + + /* Writing a list of values to an AO channel is probably not + * very useful, but that's how the interface is defined. */ + for (i = 0; i < insn->n ; ++i) { + +/* /\* do this as one instruction?? *\/ */ +/* outw(data[i], LSB_PORT(chan)); */ + + /* Need to do this as two instructions due to 8-bit bus?? */ + /* first, load the low byte */ + outb(LSB(data[i]), LSB_PORT(chan)); + /* next, write the high byte */ + outb(MSB(data[i]), MSB_PORT(chan)); + + /* save shadow register */ + devpriv->ao_readback[chan] = data[i]; + + if (!devpriv->simultaneous_xfer_mode) + inb(LSB_PORT(chan)); + } + + /* return the number of samples written */ + return i; +} + +/* AO subdevices should have a read insn as well as a write insn. + + Usually this means copying a value stored in devpriv->ao_readback. + However, since this driver supports simultaneous xfer then sometimes + this function actually accomplishes work. + + Simultaneaous xfer mode is accomplished by loading ALL the values + you want for AO in all the channels, then READing off one of the AO + registers to initiate the instantaneous simultaneous update of all + DAC outputs, which makes all AO channels update simultaneously. + This is useful for some control applications, I would imagine. +*/ +static int ao_rinsn(comedi_device *dev, comedi_subdevice *s, comedi_insn *insn, + lsampl_t *data) +{ + int i; + int chan = CR_CHAN(insn->chanspec); + + + for (i = 0; i < insn->n; i++) { + if (devpriv->simultaneous_xfer_mode) + inb(LSB_PORT(chan)); + /* read back shadow register */ + data[i] = devpriv->ao_readback[chan]; + } + + return i; +} + + + +/* + * A convenient macro that defines init_module() and cleanup_module(), + * as necessary. + */ +COMEDI_INITCLEANUP(driver); + + -- 2.26.2