drivers/staging/comedi/drivers/pcmda12.c

   1 // SPDX-License-Identifier: GPL-2.0+
   2 /*
   3  * pcmda12.c
   4  * Driver for Winsystems PC-104 based PCM-D/A-12 8-channel AO board.
   5  *
   6  * COMEDI - Linux Control and Measurement Device Interface
   7  * Copyright (C) 2006 Calin A. Culianu <calin@ajvar.org>
   8  */
   9
  10 /*
  11  * Driver: pcmda12
  12  * Description: A driver for the Winsystems PCM-D/A-12
  13  * Devices: [Winsystems] PCM-D/A-12 (pcmda12)
  14  * Author: Calin Culianu <calin@ajvar.org>
  15  * Updated: Fri, 13 Jan 2006 12:01:01 -0500
  16  * Status: works
  17  *
  18  * A driver for the relatively straightforward-to-program PCM-D/A-12.
  19  * This board doesn't support commands, and the only way to set its
  20  * analog output range is to jumper the board. As such,
  21  * comedi_data_write() ignores the range value specified.
  22  *
  23  * The board uses 16 consecutive I/O addresses starting at the I/O port
  24  * base address. Each address corresponds to the LSB then MSB of a
  25  * particular channel from 0-7.
  26  *
  27  * Note that the board is not ISA-PNP capable and thus needs the I/O
  28  * port comedi_config parameter.
  29  *
  30  * Note that passing a nonzero value as the second config option will
  31  * enable "simultaneous xfer" mode for this board, in which AO writes
  32  * will not take effect until a subsequent read of any AO channel. This
  33  * is so that one can speed up programming by preloading all AO registers
  34  * with values before simultaneously setting them to take effect with one
  35  * read command.
  36  *
  37  * Configuration Options:
  38  *   [0] - I/O port base address
  39  *   [1] - Do Simultaneous Xfer (see description)
  40  */
  41
  42 #include <linux/module.h>
  43 #include "../comedidev.h"
  44
  45 /* AI range is not configurable, it's set by jumpers on the board */
  46 static const struct comedi_lrange pcmda12_ranges = {
  47         3, {
  48                 UNI_RANGE(5),
  49                 UNI_RANGE(10),
  50                 BIP_RANGE(5)
  51         }
  52 };
  53
  54 struct pcmda12_private {
  55         int simultaneous_xfer_mode;
  56 };
  57
  58 static int pcmda12_ao_insn_write(struct comedi_device *dev,
  59                                  struct comedi_subdevice *s,
  60                                  struct comedi_insn *insn,
  61                                  unsigned int *data)
  62 {
  63         struct pcmda12_private *devpriv = dev->private;
  64         unsigned int chan = CR_CHAN(insn->chanspec);
  65         unsigned int val = s->readback[chan];
  66         unsigned long ioreg = dev->iobase + (chan * 2);
  67         int i;
  68
  69         for (i = 0; i < insn->n; ++i) {
  70                 val = data[i];
  71                 outb(val & 0xff, ioreg);
  72                 outb((val >> 8) & 0xff, ioreg + 1);
  73
  74                 /*
  75                  * Initiate transfer if not in simultaneaous xfer
  76                  * mode by reading one of the AO registers.
  77                  */
  78                 if (!devpriv->simultaneous_xfer_mode)
  79                         inb(ioreg);
  80         }
  81         s->readback[chan] = val;
  82
  83         return insn->n;
  84 }
  85
  86 static int pcmda12_ao_insn_read(struct comedi_device *dev,
  87                                 struct comedi_subdevice *s,
  88                                 struct comedi_insn *insn,
  89                                 unsigned int *data)
  90 {
  91         struct pcmda12_private *devpriv = dev->private;
  92
  93         /*
  94          * Initiate simultaneaous xfer mode by reading one of the
  95          * AO registers. All analog outputs will then be updated.
  96          */
  97         if (devpriv->simultaneous_xfer_mode)
  98                 inb(dev->iobase);
  99
 100         return comedi_readback_insn_read(dev, s, insn, data);
 101 }
 102
 103 static void pcmda12_ao_reset(struct comedi_device *dev,
 104                              struct comedi_subdevice *s)
 105 {
 106         int i;
 107
 108         for (i = 0; i < s->n_chan; ++i) {
 109                 outb(0, dev->iobase + (i * 2));
 110                 outb(0, dev->iobase + (i * 2) + 1);
 111         }
 112         /* Initiate transfer by reading one of the AO registers. */
 113         inb(dev->iobase);
 114 }
 115
 116 static int pcmda12_attach(struct comedi_device *dev,
 117                           struct comedi_devconfig *it)
 118 {
 119         struct pcmda12_private *devpriv;
 120         struct comedi_subdevice *s;
 121         int ret;
 122
 123         ret = comedi_request_region(dev, it->options[0], 0x10);
 124         if (ret)
 125                 return ret;
 126
 127         devpriv = comedi_alloc_devpriv(dev, sizeof(*devpriv));
 128         if (!devpriv)
 129                 return -ENOMEM;
 130
 131         devpriv->simultaneous_xfer_mode = it->options[1];
 132
 133         ret = comedi_alloc_subdevices(dev, 1);
 134         if (ret)
 135                 return ret;
 136
 137         s = &dev->subdevices[0];
 138         s->type         = COMEDI_SUBD_AO;
 139         s->subdev_flags = SDF_READABLE | SDF_WRITABLE;
 140         s->n_chan       = 8;
 141         s->maxdata      = 0x0fff;
 142         s->range_table  = &pcmda12_ranges;
 143         s->insn_write   = pcmda12_ao_insn_write;
 144         s->insn_read    = pcmda12_ao_insn_read;
 145
 146         ret = comedi_alloc_subdev_readback(s);
 147         if (ret)
 148                 return ret;
 149
 150         pcmda12_ao_reset(dev, s);
 151
 152         return 0;
 153 }
 154
 155 static struct comedi_driver pcmda12_driver = {
 156         .driver_name    = "pcmda12",
 157         .module         = THIS_MODULE,
 158         .attach         = pcmda12_attach,
 159         .detach         = comedi_legacy_detach,
 160 };
 161 module_comedi_driver(pcmda12_driver);
 162
 163 MODULE_AUTHOR("Comedi http://www.comedi.org");
 164 MODULE_DESCRIPTION("Comedi low-level driver");
 165 MODULE_LICENSE("GPL");