drivers/comedi/drivers/adq12b.c

   1 // SPDX-License-Identifier: GPL-2.0+
   2 /*
   3  * adq12b.c
   4  * Driver for MicroAxial ADQ12-B data acquisition and control card
   5  * written by jeremy theler <thelerg@ib.cnea.gov.ar>
   6  *      instituto balseiro
   7  *      commission nacional de energia atomica
   8  *      universidad nacional de cuyo
   9  *      argentina
  10  *
  11  * COMEDI - Linux Control and Measurement Device Interface
  12  * Copyright (C) 2000 David A. Schleef <ds@schleef.org>
  13  */
  14
  15 /*
  16  * Driver: adq12b
  17  * Description: Driver for MicroAxial ADQ12-B data acquisition and control card
  18  * Devices: [MicroAxial] ADQ12-B (adq12b)
  19  * Author: jeremy theler <thelerg@ib.cnea.gov.ar>
  20  * Updated: Thu, 21 Feb 2008 02:56:27 -0300
  21  * Status: works
  22  *
  23  * Configuration options:
  24  *   [0] - I/O base address (set with hardware jumpers)
  25  *              address         jumper JADR
  26  *              0x300           1 (factory default)
  27  *              0x320           2
  28  *              0x340           3
  29  *              0x360           4
  30  *              0x380           5
  31  *              0x3A0           6
  32  *   [1] - Analog Input unipolar/bipolar selection
  33  *              selection       option  JUB
  34  *              bipolar         0       2-3 (factory default)
  35  *              unipolar        1       1-2
  36  *   [2] - Analog Input single-ended/differential selection
  37  *              selection       option  JCHA    JCHB
  38  *              single-ended    0       1-2     1-2 (factory default)
  39  *              differential    1       2-3     2-3
  40  *
  41  * Driver for the acquisition card ADQ12-B (without any add-on).
  42  *
  43  * - Analog input is subdevice 0 (16 channels single-ended or 8 differential)
  44  * - Digital input is subdevice 1 (5 channels)
  45  * - Digital output is subdevice 1 (8 channels)
  46  * - The PACER is not supported in this version
  47  */
  48
  49 #include <linux/module.h>
  50 #include <linux/delay.h>
  51 #include <linux/comedi/comedidev.h>
  52
  53 /* address scheme (page 2.17 of the manual) */
  54 #define ADQ12B_CTREG            0x00
  55 #define ADQ12B_CTREG_MSKP       BIT(7)  /* enable pacer interrupt */
  56 #define ADQ12B_CTREG_GTP        BIT(6)  /* enable pacer */
  57 #define ADQ12B_CTREG_RANGE(x)   ((x) << 4)
  58 #define ADQ12B_CTREG_CHAN(x)    ((x) << 0)
  59 #define ADQ12B_STINR            0x00
  60 #define ADQ12B_STINR_OUT2       BIT(7)  /* timer 2 output state */
  61 #define ADQ12B_STINR_OUTP       BIT(6)  /* pacer output state */
  62 #define ADQ12B_STINR_EOC        BIT(5)  /* A/D end-of-conversion */
  63 #define ADQ12B_STINR_IN_MASK    (0x1f << 0)
  64 #define ADQ12B_OUTBR            0x04
  65 #define ADQ12B_ADLOW            0x08
  66 #define ADQ12B_ADHIG            0x09
  67 #define ADQ12B_TIMER_BASE       0x0c
  68
  69 /* available ranges through the PGA gains */
  70 static const struct comedi_lrange range_adq12b_ai_bipolar = {
  71         4, {
  72                 BIP_RANGE(5),
  73                 BIP_RANGE(2),
  74                 BIP_RANGE(1),
  75                 BIP_RANGE(0.5)
  76         }
  77 };
  78
  79 static const struct comedi_lrange range_adq12b_ai_unipolar = {
  80         4, {
  81                 UNI_RANGE(5),
  82                 UNI_RANGE(2),
  83                 UNI_RANGE(1),
  84                 UNI_RANGE(0.5)
  85         }
  86 };
  87
  88 struct adq12b_private {
  89         unsigned int last_ctreg;
  90 };
  91
  92 static int adq12b_ai_eoc(struct comedi_device *dev,
  93                          struct comedi_subdevice *s,
  94                          struct comedi_insn *insn,
  95                          unsigned long context)
  96 {
  97         unsigned char status;
  98
  99         status = inb(dev->iobase + ADQ12B_STINR);
 100         if (status & ADQ12B_STINR_EOC)
 101                 return 0;
 102         return -EBUSY;
 103 }
 104
 105 static int adq12b_ai_insn_read(struct comedi_device *dev,
 106                                struct comedi_subdevice *s,
 107                                struct comedi_insn *insn,
 108                                unsigned int *data)
 109 {
 110         struct adq12b_private *devpriv = dev->private;
 111         unsigned int chan = CR_CHAN(insn->chanspec);
 112         unsigned int range = CR_RANGE(insn->chanspec);
 113         unsigned int val;
 114         int ret;
 115         int i;
 116
 117         /* change channel and range only if it is different from the previous */
 118         val = ADQ12B_CTREG_RANGE(range) | ADQ12B_CTREG_CHAN(chan);
 119         if (val != devpriv->last_ctreg) {
 120                 outb(val, dev->iobase + ADQ12B_CTREG);
 121                 devpriv->last_ctreg = val;
 122                 usleep_range(50, 100);  /* wait for the mux to settle */
 123         }
 124
 125         val = inb(dev->iobase + ADQ12B_ADLOW);  /* trigger A/D */
 126
 127         for (i = 0; i < insn->n; i++) {
 128                 ret = comedi_timeout(dev, s, insn, adq12b_ai_eoc, 0);
 129                 if (ret)
 130                         return ret;
 131
 132                 val = inb(dev->iobase + ADQ12B_ADHIG) << 8;
 133                 val |= inb(dev->iobase + ADQ12B_ADLOW); /* retriggers A/D */
 134
 135                 data[i] = val;
 136         }
 137
 138         return insn->n;
 139 }
 140
 141 static int adq12b_di_insn_bits(struct comedi_device *dev,
 142                                struct comedi_subdevice *s,
 143                                struct comedi_insn *insn, unsigned int *data)
 144 {
 145         /* only bits 0-4 have information about digital inputs */
 146         data[1] = (inb(dev->iobase + ADQ12B_STINR) & ADQ12B_STINR_IN_MASK);
 147
 148         return insn->n;
 149 }
 150
 151 static int adq12b_do_insn_bits(struct comedi_device *dev,
 152                                struct comedi_subdevice *s,
 153                                struct comedi_insn *insn,
 154                                unsigned int *data)
 155 {
 156         unsigned int mask;
 157         unsigned int chan;
 158         unsigned int val;
 159
 160         mask = comedi_dio_update_state(s, data);
 161         if (mask) {
 162                 for (chan = 0; chan < 8; chan++) {
 163                         if ((mask >> chan) & 0x01) {
 164                                 val = (s->state >> chan) & 0x01;
 165                                 outb((val << 3) | chan,
 166                                      dev->iobase + ADQ12B_OUTBR);
 167                         }
 168                 }
 169         }
 170
 171         data[1] = s->state;
 172
 173         return insn->n;
 174 }
 175
 176 static int adq12b_attach(struct comedi_device *dev, struct comedi_devconfig *it)
 177 {
 178         struct adq12b_private *devpriv;
 179         struct comedi_subdevice *s;
 180         int ret;
 181
 182         ret = comedi_request_region(dev, it->options[0], 0x10);
 183         if (ret)
 184                 return ret;
 185
 186         devpriv = comedi_alloc_devpriv(dev, sizeof(*devpriv));
 187         if (!devpriv)
 188                 return -ENOMEM;
 189
 190         devpriv->last_ctreg = -1;       /* force ctreg update */
 191
 192         ret = comedi_alloc_subdevices(dev, 3);
 193         if (ret)
 194                 return ret;
 195
 196         /* Analog Input subdevice */
 197         s = &dev->subdevices[0];
 198         s->type         = COMEDI_SUBD_AI;
 199         if (it->options[2]) {
 200                 s->subdev_flags = SDF_READABLE | SDF_DIFF;
 201                 s->n_chan       = 8;
 202         } else {
 203                 s->subdev_flags = SDF_READABLE | SDF_GROUND;
 204                 s->n_chan       = 16;
 205         }
 206         s->maxdata      = 0xfff;
 207         s->range_table  = it->options[1] ? &range_adq12b_ai_unipolar
 208                                          : &range_adq12b_ai_bipolar;
 209         s->insn_read    = adq12b_ai_insn_read;
 210
 211         /* Digital Input subdevice */
 212         s = &dev->subdevices[1];
 213         s->type         = COMEDI_SUBD_DI;
 214         s->subdev_flags = SDF_READABLE;
 215         s->n_chan       = 5;
 216         s->maxdata      = 1;
 217         s->range_table  = &range_digital;
 218         s->insn_bits    = adq12b_di_insn_bits;
 219
 220         /* Digital Output subdevice */
 221         s = &dev->subdevices[2];
 222         s->type         = COMEDI_SUBD_DO;
 223         s->subdev_flags = SDF_WRITABLE;
 224         s->n_chan       = 8;
 225         s->maxdata      = 1;
 226         s->range_table  = &range_digital;
 227         s->insn_bits    = adq12b_do_insn_bits;
 228
 229         return 0;
 230 }
 231
 232 static struct comedi_driver adq12b_driver = {
 233         .driver_name    = "adq12b",
 234         .module         = THIS_MODULE,
 235         .attach         = adq12b_attach,
 236         .detach         = comedi_legacy_detach,
 237 };
 238 module_comedi_driver(adq12b_driver);
 239
 240 MODULE_AUTHOR("Comedi https://www.comedi.org");
 241 MODULE_DESCRIPTION("Comedi low-level driver");
 242 MODULE_LICENSE("GPL");