drivers/staging/comedi/drivers/pcmad.c

   1 /*
   2  * pcmad.c
   3  * Hardware driver for Winsystems PCM-A/D12 and PCM-A/D16
   4  *
   5  * COMEDI - Linux Control and Measurement Device Interface
   6  * Copyright (C) 2000,2001 David A. Schleef <ds@schleef.org>
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  */
  18
  19 /*
  20  * Driver: pcmad
  21  * Description: Winsystems PCM-A/D12, PCM-A/D16
  22  * Devices: (Winsystems) PCM-A/D12 [pcmad12]
  23  *          (Winsystems) PCM-A/D16 [pcmad16]
  24  * Author: ds
  25  * Status: untested
  26  *
  27  * This driver was written on a bet that I couldn't write a driver
  28  * in less than 2 hours.  I won the bet, but never got paid.  =(
  29  *
  30  * Configuration options:
  31  *   [0] - I/O port base
  32  *   [1] - IRQ (unused)
  33  *   [2] - Analog input reference (must match jumpers)
  34  *         0 = single-ended (16 channels)
  35  *         1 = differential (8 channels)
  36  *   [3] - Analog input encoding (must match jumpers)
  37  *         0 = straight binary (0-5V input range)
  38  *         1 = two's complement (+-10V input range)
  39  */
  40
  41 #include <linux/module.h>
  42 #include "../comedidev.h"
  43
  44 #define PCMAD_STATUS            0
  45 #define PCMAD_LSB               1
  46 #define PCMAD_MSB               2
  47 #define PCMAD_CONVERT           1
  48
  49 struct pcmad_board_struct {
  50         const char *name;
  51         unsigned int ai_maxdata;
  52 };
  53
  54 static const struct pcmad_board_struct pcmad_boards[] = {
  55         {
  56                 .name           = "pcmad12",
  57                 .ai_maxdata     = 0x0fff,
  58         }, {
  59                 .name           = "pcmad16",
  60                 .ai_maxdata     = 0xffff,
  61         },
  62 };
  63
  64 #define TIMEOUT 100
  65
  66 static int pcmad_ai_wait_for_eoc(struct comedi_device *dev,
  67                                  int timeout)
  68 {
  69         int i;
  70
  71         for (i = 0; i < timeout; i++) {
  72                 if ((inb(dev->iobase + PCMAD_STATUS) & 0x3) == 0x3)
  73                         return 0;
  74         }
  75         return -ETIME;
  76 }
  77
  78 static int pcmad_ai_insn_read(struct comedi_device *dev,
  79                               struct comedi_subdevice *s,
  80                               struct comedi_insn *insn,
  81                               unsigned int *data)
  82 {
  83         unsigned int chan = CR_CHAN(insn->chanspec);
  84         unsigned int range = CR_RANGE(insn->chanspec);
  85         unsigned int val;
  86         int ret;
  87         int i;
  88
  89         for (i = 0; i < insn->n; i++) {
  90                 outb(chan, dev->iobase + PCMAD_CONVERT);
  91
  92                 ret = pcmad_ai_wait_for_eoc(dev, TIMEOUT);
  93                 if (ret)
  94                         return ret;
  95
  96                 val = inb(dev->iobase + PCMAD_LSB) |
  97                       (inb(dev->iobase + PCMAD_MSB) << 8);
  98
  99                 /* data is shifted on the pcmad12, fix it */
 100                 if (s->maxdata == 0x0fff)
 101                         val >>= 4;
 102
 103                 if (comedi_range_is_bipolar(s, range)) {
 104                         /* munge the two's complement value */
 105                         val ^= ((s->maxdata + 1) >> 1);
 106                 }
 107
 108                 data[i] = val;
 109         }
 110
 111         return insn->n;
 112 }
 113
 114 static int pcmad_attach(struct comedi_device *dev, struct comedi_devconfig *it)
 115 {
 116         const struct pcmad_board_struct *board = comedi_board(dev);
 117         struct comedi_subdevice *s;
 118         int ret;
 119
 120         ret = comedi_request_region(dev, it->options[0], 0x04);
 121         if (ret)
 122                 return ret;
 123
 124         ret = comedi_alloc_subdevices(dev, 1);
 125         if (ret)
 126                 return ret;
 127
 128         s = &dev->subdevices[0];
 129         s->type         = COMEDI_SUBD_AI;
 130         if (it->options[1]) {
 131                 /* 8 differential channels */
 132                 s->subdev_flags = SDF_READABLE | AREF_DIFF;
 133                 s->n_chan       = 8;
 134         } else {
 135                 /* 16 single-ended channels */
 136                 s->subdev_flags = SDF_READABLE | AREF_GROUND;
 137                 s->n_chan       = 16;
 138         }
 139         s->len_chanlist = 1;
 140         s->maxdata      = board->ai_maxdata;
 141         s->range_table  = it->options[2] ? &range_bipolar10 : &range_unipolar5;
 142         s->insn_read    = pcmad_ai_insn_read;
 143
 144         return 0;
 145 }
 146
 147 static struct comedi_driver pcmad_driver = {
 148         .driver_name    = "pcmad",
 149         .module         = THIS_MODULE,
 150         .attach         = pcmad_attach,
 151         .detach         = comedi_legacy_detach,
 152         .board_name     = &pcmad_boards[0].name,
 153         .num_names      = ARRAY_SIZE(pcmad_boards),
 154         .offset         = sizeof(pcmad_boards[0]),
 155 };
 156 module_comedi_driver(pcmad_driver);
 157
 158 MODULE_AUTHOR("Comedi http://www.comedi.org");
 159 MODULE_DESCRIPTION("Comedi low-level driver");
 160 MODULE_LICENSE("GPL");