3 * Comedi driver for standard parallel port
5 * For more information see:
6 * http://retired.beyondlogic.org/spp/parallel.htm
8 * COMEDI - Linux Control and Measurement Device Interface
9 * Copyright (C) 1998,2001 David A. Schleef <ds@schleef.org>
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
23 * Driver: comedi_parport
24 * Description: Standard PC parallel port
26 * Status: works in immediate mode
27 * Devices: (standard) parallel port [comedi_parport]
28 * Updated: Tue, 30 Apr 2002 21:11:45 -0700
30 * A cheap and easy way to get a few more digital I/O lines. Steal
31 * additional parallel ports from old computers or your neighbors'
35 * 0: I/O port base for the parallel port.
38 * Parallel Port Lines:
40 * pin subdev chan type name
41 * ----- ------ ---- ---- --------------
58 * 17 2 3 DO select printer
61 * When an IRQ is configured subdevice 3 pretends to be a digital
62 * input subdevice, but it always returns 0 when read. However, if
63 * you run a command with scan_begin_src=TRIG_EXT, it uses pin 10
64 * as a external trigger, which can be used to wake up tasks.
67 #include <linux/module.h>
68 #include <linux/interrupt.h>
70 #include "../comedidev.h"
72 #include "comedi_fc.h"
77 #define PARPORT_DATA_REG 0x00
78 #define PARPORT_STATUS_REG 0x01
79 #define PARPORT_CTRL_REG 0x02
80 #define PARPORT_CTRL_IRQ_ENA (1 << 4)
81 #define PARPORT_CTRL_BIDIR_ENA (1 << 5)
83 static int parport_data_reg_insn_bits(struct comedi_device *dev,
84 struct comedi_subdevice *s,
85 struct comedi_insn *insn,
88 if (comedi_dio_update_state(s, data))
89 outb(s->state, dev->iobase + PARPORT_DATA_REG);
91 data[1] = inb(dev->iobase + PARPORT_DATA_REG);
96 static int parport_data_reg_insn_config(struct comedi_device *dev,
97 struct comedi_subdevice *s,
98 struct comedi_insn *insn,
104 ret = comedi_dio_insn_config(dev, s, insn, data, 0xff);
108 ctrl = inb(dev->iobase + PARPORT_CTRL_REG);
110 ctrl &= ~PARPORT_CTRL_BIDIR_ENA;
112 ctrl |= PARPORT_CTRL_BIDIR_ENA;
113 outb(ctrl, dev->iobase + PARPORT_CTRL_REG);
118 static int parport_status_reg_insn_bits(struct comedi_device *dev,
119 struct comedi_subdevice *s,
120 struct comedi_insn *insn,
123 data[1] = inb(dev->iobase + PARPORT_STATUS_REG) >> 3;
128 static int parport_ctrl_reg_insn_bits(struct comedi_device *dev,
129 struct comedi_subdevice *s,
130 struct comedi_insn *insn,
135 if (comedi_dio_update_state(s, data)) {
136 ctrl = inb(dev->iobase + PARPORT_CTRL_REG);
137 ctrl &= (PARPORT_CTRL_IRQ_ENA | PARPORT_CTRL_BIDIR_ENA);
139 outb(ctrl, dev->iobase + PARPORT_CTRL_REG);
147 static int parport_intr_insn_bits(struct comedi_device *dev,
148 struct comedi_subdevice *s,
149 struct comedi_insn *insn,
156 static int parport_intr_cmdtest(struct comedi_device *dev,
157 struct comedi_subdevice *s,
158 struct comedi_cmd *cmd)
162 /* Step 1 : check if triggers are trivially valid */
164 err |= cfc_check_trigger_src(&cmd->start_src, TRIG_NOW);
165 err |= cfc_check_trigger_src(&cmd->scan_begin_src, TRIG_EXT);
166 err |= cfc_check_trigger_src(&cmd->convert_src, TRIG_FOLLOW);
167 err |= cfc_check_trigger_src(&cmd->scan_end_src, TRIG_COUNT);
168 err |= cfc_check_trigger_src(&cmd->stop_src, TRIG_NONE);
173 /* Step 2a : make sure trigger sources are unique */
174 /* Step 2b : and mutually compatible */
176 /* Step 3: check if arguments are trivially valid */
178 err |= cfc_check_trigger_arg_is(&cmd->start_arg, 0);
179 err |= cfc_check_trigger_arg_is(&cmd->scan_begin_arg, 0);
180 err |= cfc_check_trigger_arg_is(&cmd->convert_arg, 0);
181 err |= cfc_check_trigger_arg_is(&cmd->scan_end_arg, cmd->chanlist_len);
182 err |= cfc_check_trigger_arg_is(&cmd->stop_arg, 0);
187 /* Step 4: fix up any arguments */
189 /* Step 5: check channel list if it exists */
194 static int parport_intr_cmd(struct comedi_device *dev,
195 struct comedi_subdevice *s)
199 ctrl = inb(dev->iobase + PARPORT_CTRL_REG);
200 ctrl |= PARPORT_CTRL_IRQ_ENA;
201 outb(ctrl, dev->iobase + PARPORT_CTRL_REG);
206 static int parport_intr_cancel(struct comedi_device *dev,
207 struct comedi_subdevice *s)
211 ctrl = inb(dev->iobase + PARPORT_CTRL_REG);
212 ctrl &= ~PARPORT_CTRL_IRQ_ENA;
213 outb(ctrl, dev->iobase + PARPORT_CTRL_REG);
218 static irqreturn_t parport_interrupt(int irq, void *d)
220 struct comedi_device *dev = d;
221 struct comedi_subdevice *s = dev->read_subdev;
224 ctrl = inb(dev->iobase + PARPORT_CTRL_REG);
225 if (!(ctrl & PARPORT_CTRL_IRQ_ENA))
228 comedi_buf_put(s, 0);
229 s->async->events |= COMEDI_CB_BLOCK | COMEDI_CB_EOS;
231 comedi_event(dev, s);
235 static int parport_attach(struct comedi_device *dev,
236 struct comedi_devconfig *it)
238 struct comedi_subdevice *s;
241 ret = comedi_request_region(dev, it->options[0], 0x03);
245 if (it->options[1]) {
246 ret = request_irq(it->options[1], parport_interrupt, 0,
247 dev->board_name, dev);
249 dev->irq = it->options[1];
252 ret = comedi_alloc_subdevices(dev, dev->irq ? 4 : 3);
256 /* Digial I/O subdevice - Parallel port DATA register */
257 s = &dev->subdevices[0];
258 s->type = COMEDI_SUBD_DIO;
259 s->subdev_flags = SDF_READABLE | SDF_WRITABLE;
262 s->range_table = &range_digital;
263 s->insn_bits = parport_data_reg_insn_bits;
264 s->insn_config = parport_data_reg_insn_config;
266 /* Digial Input subdevice - Parallel port STATUS register */
267 s = &dev->subdevices[1];
268 s->type = COMEDI_SUBD_DI;
269 s->subdev_flags = SDF_READABLE;
272 s->range_table = &range_digital;
273 s->insn_bits = parport_status_reg_insn_bits;
275 /* Digial Output subdevice - Parallel port CONTROL register */
276 s = &dev->subdevices[2];
277 s->type = COMEDI_SUBD_DO;
278 s->subdev_flags = SDF_WRITABLE;
281 s->range_table = &range_digital;
282 s->insn_bits = parport_ctrl_reg_insn_bits;
285 /* Digial Input subdevice - Interrupt support */
286 s = &dev->subdevices[3];
287 dev->read_subdev = s;
288 s->type = COMEDI_SUBD_DI;
289 s->subdev_flags = SDF_READABLE | SDF_CMD_READ;
292 s->range_table = &range_digital;
293 s->insn_bits = parport_intr_insn_bits;
295 s->do_cmdtest = parport_intr_cmdtest;
296 s->do_cmd = parport_intr_cmd;
297 s->cancel = parport_intr_cancel;
300 outb(0, dev->iobase + PARPORT_DATA_REG);
301 outb(0, dev->iobase + PARPORT_CTRL_REG);
306 static struct comedi_driver parport_driver = {
307 .driver_name = "comedi_parport",
308 .module = THIS_MODULE,
309 .attach = parport_attach,
310 .detach = comedi_legacy_detach,
312 module_comedi_driver(parport_driver);
314 MODULE_AUTHOR("Comedi http://www.comedi.org");
315 MODULE_DESCRIPTION("Comedi: Standard parallel port driver");
316 MODULE_LICENSE("GPL");