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 <linux/comedi/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(value: val & 0xff, port: ioreg); |
72 | outb(value: (val >> 8) & 0xff, port: 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(port: 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(port: 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(value: 0, port: dev->iobase + (i * 2)); |
110 | outb(value: 0, port: dev->iobase + (i * 2) + 1); |
111 | } |
112 | /* Initiate transfer by reading one of the AO registers. */ |
113 | inb(port: 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, start: it->options[0], len: 0x10); |
124 | if (ret) |
125 | return ret; |
126 | |
127 | devpriv = comedi_alloc_devpriv(dev, size: sizeof(*devpriv)); |
128 | if (!devpriv) |
129 | return -ENOMEM; |
130 | |
131 | devpriv->simultaneous_xfer_mode = it->options[1]; |
132 | |
133 | ret = comedi_alloc_subdevices(dev, num_subdevices: 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 https://www.comedi.org" ); |
164 | MODULE_DESCRIPTION("Comedi low-level driver" ); |
165 | MODULE_LICENSE("GPL" ); |
166 | |