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 bool pcmad_range_is_bipolar(struct comedi_subdevice *s,
  79                                    unsigned int range)
  80 {
  81         return s->range_table->range[range].min < 0;
  82 }
  83
  84 static int pcmad_ai_insn_read(struct comedi_device *dev,
  85                               struct comedi_subdevice *s,
  86                               struct comedi_insn *insn,
  87                               unsigned int *data)
  88 {
  89         unsigned int chan = CR_CHAN(insn->chanspec);
  90         unsigned int range = CR_RANGE(insn->chanspec);
  91         unsigned int val;
  92         int ret;
  93         int i;
  94
  95         for (i = 0; i < insn->n; i++) {
  96                 outb(chan, dev->iobase + PCMAD_CONVERT);
  97
  98                 ret = pcmad_ai_wait_for_eoc(dev, TIMEOUT);
  99                 if (ret)
 100                         return ret;
 101
 102                 val = inb(dev->iobase + PCMAD_LSB) |
 103                       (inb(dev->iobase + PCMAD_MSB) << 8);
 104
 105                 /* data is shifted on the pcmad12, fix it */
 106                 if (s->maxdata == 0x0fff)
 107                         val >>= 4;
 108
 109                 if (pcmad_range_is_bipolar(s, range)) {
 110                         /* munge the two's complement value */
 111                         val ^= ((s->maxdata + 1) >> 1);
 112                 }
 113
 114                 data[i] = val;
 115         }
 116
 117         return insn->n;
 118 }
 119
 120 static int pcmad_attach(struct comedi_device *dev, struct comedi_devconfig *it)
 121 {
 122         const struct pcmad_board_struct *board = comedi_board(dev);
 123         struct comedi_subdevice *s;
 124         int ret;
 125
 126         ret = comedi_request_region(dev, it->options[0], 0x04);
 127         if (ret)
 128                 return ret;
 129
 130         ret = comedi_alloc_subdevices(dev, 1);
 131         if (ret)
 132                 return ret;
 133
 134         s = &dev->subdevices[0];
 135         s->type         = COMEDI_SUBD_AI;
 136         if (it->options[1]) {
 137                 /* 8 differential channels */
 138                 s->subdev_flags = SDF_READABLE | AREF_DIFF;
 139                 s->n_chan       = 8;
 140         } else {
 141                 /* 16 single-ended channels */
 142                 s->subdev_flags = SDF_READABLE | AREF_GROUND;
 143                 s->n_chan       = 16;
 144         }
 145         s->len_chanlist = 1;
 146         s->maxdata      = board->ai_maxdata;
 147         s->range_table  = it->options[2] ? &range_bipolar10 : &range_unipolar5;
 148         s->insn_read    = pcmad_ai_insn_read;
 149
 150         return 0;
 151 }
 152
 153 static struct comedi_driver pcmad_driver = {
 154         .driver_name    = "pcmad",
 155         .module         = THIS_MODULE,
 156         .attach         = pcmad_attach,
 157         .detach         = comedi_legacy_detach,
 158         .board_name     = &pcmad_boards[0].name,
 159         .num_names      = ARRAY_SIZE(pcmad_boards),
 160         .offset         = sizeof(pcmad_boards[0]),
 161 };
 162 module_comedi_driver(pcmad_driver);
 163
 164 MODULE_AUTHOR("Comedi http://www.comedi.org");
 165 MODULE_DESCRIPTION("Comedi low-level driver");
 166 MODULE_LICENSE("GPL");