Staging: comedi: remove C99 comments in pcl816.c
[linux-2.6] / drivers / staging / comedi / drivers / dt2815.c
1 /*
2    comedi/drivers/dt2815.c
3    Hardware driver for Data Translation DT2815
4
5    COMEDI - Linux Control and Measurement Device Interface
6    Copyright (C) 1999 Anders Blomdell <anders.blomdell@control.lth.se>
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    You should have received a copy of the GNU General Public License
19    along with this program; if not, write to the Free Software
20    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21
22  */
23 /*
24 Driver: dt2815
25 Description: Data Translation DT2815
26 Author: ds
27 Status: mostly complete, untested
28 Devices: [Data Translation] DT2815 (dt2815)
29
30 I'm not sure anyone has ever tested this board.  If you have information
31 contrary, please update.
32
33 Configuration options:
34   [0] - I/O port base base address
35   [1] - IRQ (unused)
36   [2] - Voltage unipolar/bipolar configuration
37           0 == unipolar 5V  (0V -- +5V)
38           1 == bipolar 5V  (-5V -- +5V)
39   [3] - Current offset configuration
40           0 == disabled  (0mA -- +32mAV)
41           1 == enabled  (+4mA -- +20mAV)
42   [4] - Firmware program configuration
43           0 == program 1 (see manual table 5-4)
44           1 == program 2 (see manual table 5-4)
45           2 == program 3 (see manual table 5-4)
46           3 == program 4 (see manual table 5-4)
47   [5] - Analog output 0 range configuration
48           0 == voltage
49           1 == current
50   [6] - Analog output 1 range configuration (same options)
51   [7] - Analog output 2 range configuration (same options)
52   [8] - Analog output 3 range configuration (same options)
53   [9] - Analog output 4 range configuration (same options)
54   [10] - Analog output 5 range configuration (same options)
55   [11] - Analog output 6 range configuration (same options)
56   [12] - Analog output 7 range configuration (same options)
57 */
58
59 #include "../comedidev.h"
60
61 #include <linux/ioport.h>
62 #include <linux/delay.h>
63
64 static const struct comedi_lrange range_dt2815_ao_32_current = { 1, {
65                         RANGE_mA(0, 32)
66         }
67 };
68 static const struct comedi_lrange range_dt2815_ao_20_current = { 1, {
69                         RANGE_mA(4, 20)
70         }
71 };
72
73 #define DT2815_SIZE 2
74
75 #define DT2815_DATA 0
76 #define DT2815_STATUS 1
77
78 static int dt2815_attach(struct comedi_device * dev, struct comedi_devconfig * it);
79 static int dt2815_detach(struct comedi_device * dev);
80 static struct comedi_driver driver_dt2815 = {
81       driver_name:"dt2815",
82       module:THIS_MODULE,
83       attach:dt2815_attach,
84       detach:dt2815_detach,
85 };
86
87 COMEDI_INITCLEANUP(driver_dt2815);
88
89 static void dt2815_free_resources(struct comedi_device * dev);
90
91 struct dt2815_private {
92
93         const struct comedi_lrange *range_type_list[8];
94         unsigned int ao_readback[8];
95 };
96
97
98 #define devpriv ((struct dt2815_private *)dev->private)
99
100 static int dt2815_wait_for_status(struct comedi_device * dev, int status)
101 {
102         int i;
103
104         for (i = 0; i < 100; i++) {
105                 if (inb(dev->iobase + DT2815_STATUS) == status)
106                         break;
107         }
108         return status;
109 }
110
111 static int dt2815_ao_insn_read(struct comedi_device * dev, struct comedi_subdevice * s,
112         struct comedi_insn * insn, unsigned int * data)
113 {
114         int i;
115         int chan = CR_CHAN(insn->chanspec);
116
117         for (i = 0; i < insn->n; i++) {
118                 data[i] = devpriv->ao_readback[chan];
119         }
120
121         return i;
122 }
123
124 static int dt2815_ao_insn(struct comedi_device * dev, struct comedi_subdevice * s,
125         struct comedi_insn * insn, unsigned int * data)
126 {
127         int i;
128         int chan = CR_CHAN(insn->chanspec);
129         unsigned int status;
130         unsigned int lo, hi;
131
132         for (i = 0; i < insn->n; i++) {
133                 lo = ((data[i] & 0x0f) << 4) | (chan << 1) | 0x01;
134                 hi = (data[i] & 0xff0) >> 4;
135
136                 status = dt2815_wait_for_status(dev, 0x00);
137                 if (status != 0) {
138                         rt_printk
139                                 ("dt2815: failed to write low byte on %d reason %x\n",
140                                 chan, status);
141                         return -EBUSY;
142                 }
143
144                 outb(lo, dev->iobase + DT2815_DATA);
145
146                 status = dt2815_wait_for_status(dev, 0x10);
147                 if (status != 0x10) {
148                         rt_printk
149                                 ("dt2815: failed to write high byte on %d reason %x\n",
150                                 chan, status);
151                         return -EBUSY;
152                 }
153                 devpriv->ao_readback[chan] = data[i];
154         }
155         return i;
156 }
157
158 /*
159   options[0]   Board base address
160   options[1]   IRQ (not applicable)
161   options[2]   Voltage unipolar/bipolar configuration
162                  0 == unipolar 5V  (0V -- +5V)
163                  1 == bipolar 5V  (-5V -- +5V)
164   options[3]   Current offset configuration
165                  0 == disabled  (0mA -- +32mAV)
166                  1 == enabled  (+4mA -- +20mAV)
167   options[4]   Firmware program configuration
168                  0 == program 1 (see manual table 5-4)
169                  1 == program 2 (see manual table 5-4)
170                  2 == program 3 (see manual table 5-4)
171                  3 == program 4 (see manual table 5-4)
172   options[5]   Analog output 0 range configuration
173                  0 == voltage
174                  1 == current
175   options[6]   Analog output 1 range configuration
176   ...
177   options[12]   Analog output 7 range configuration
178                  0 == voltage
179                  1 == current
180  */
181
182 static int dt2815_attach(struct comedi_device * dev, struct comedi_devconfig * it)
183 {
184         struct comedi_subdevice *s;
185         int i;
186         const struct comedi_lrange *current_range_type, *voltage_range_type;
187         unsigned long iobase;
188
189         iobase = it->options[0];
190         printk("comedi%d: dt2815: 0x%04lx ", dev->minor, iobase);
191         if (!request_region(iobase, DT2815_SIZE, "dt2815")) {
192                 printk("I/O port conflict\n");
193                 return -EIO;
194         }
195
196         dev->iobase = iobase;
197         dev->board_name = "dt2815";
198
199         if (alloc_subdevices(dev, 1) < 0)
200                 return -ENOMEM;
201         if (alloc_private(dev, sizeof(struct dt2815_private)) < 0)
202                 return -ENOMEM;
203
204         s = dev->subdevices;
205         /* ao subdevice */
206         s->type = COMEDI_SUBD_AO;
207         s->subdev_flags = SDF_WRITABLE;
208         s->maxdata = 0xfff;
209         s->n_chan = 8;
210         s->insn_write = dt2815_ao_insn;
211         s->insn_read = dt2815_ao_insn_read;
212         s->range_table_list = devpriv->range_type_list;
213
214         current_range_type = (it->options[3])
215                 ? &range_dt2815_ao_20_current : &range_dt2815_ao_32_current;
216         voltage_range_type = (it->options[2])
217                 ? &range_bipolar5 : &range_unipolar5;
218         for (i = 0; i < 8; i++) {
219                 devpriv->range_type_list[i] = (it->options[5 + i])
220                         ? current_range_type : voltage_range_type;
221         }
222
223         /* Init the 2815 */
224         outb(0x00, dev->iobase + DT2815_STATUS);
225         for (i = 0; i < 100; i++) {
226                 /* This is incredibly slow (approx 20 ms) */
227                 unsigned int status;
228
229                 comedi_udelay(1000);
230                 status = inb(dev->iobase + DT2815_STATUS);
231                 if (status == 4) {
232                         unsigned int program;
233                         program = (it->options[4] & 0x3) << 3 | 0x7;
234                         outb(program, dev->iobase + DT2815_DATA);
235                         printk(", program: 0x%x (@t=%d)\n", program, i);
236                         break;
237                 } else if (status != 0x00) {
238                         printk("dt2815: unexpected status 0x%x (@t=%d)\n",
239                                 status, i);
240                         if (status & 0x60) {
241                                 outb(0x00, dev->iobase + DT2815_STATUS);
242                         }
243                 }
244         }
245
246         printk("\n");
247
248         return 0;
249 }
250
251 static void dt2815_free_resources(struct comedi_device * dev)
252 {
253         if (dev->iobase)
254                 release_region(dev->iobase, DT2815_SIZE);
255 }
256
257 static int dt2815_detach(struct comedi_device * dev)
258 {
259         printk("comedi%d: dt2815: remove\n", dev->minor);
260
261         dt2815_free_resources(dev);
262
263         return 0;
264 }