Commit a88a6376 authored by H Hartley Sweeten's avatar H Hartley Sweeten Committed by Greg Kroah-Hartman

staging: comedi: pcmmio: tidy up the multi-line comments

Tidy up the multi-line comments are the beginning of the file to follow
the CodingStyle.
Signed-off-by: default avatarH Hartley Sweeten <hsweeten@visionengravers.com>
Reviewed-by: default avatarIan Abbott <abbotti@mev.co.uk>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 500821f3
/* /*
comedi/drivers/pcmmio.c * pcmmio.c
Driver for Winsystems PC-104 based multifunction IO board. * Driver for Winsystems PC-104 based multifunction IO board.
*
COMEDI - Linux Control and Measurement Device Interface * COMEDI - Linux Control and Measurement Device Interface
Copyright (C) 2007 Calin A. Culianu <calin@ajvar.org> * Copyright (C) 2007 Calin A. Culianu <calin@ajvar.org>
*
This program is free software; you can redistribute it and/or modify * This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by * it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or * the Free Software Foundation; either version 2 of the License, or
(at your option) any later version. * (at your option) any later version.
*
This program is distributed in the hope that it will be useful, * This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of * but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details. * GNU General Public License for more details.
*/ */
/* /*
Driver: pcmmio * Driver: pcmmio
Description: A driver for the PCM-MIO multifunction board * Description: A driver for the PCM-MIO multifunction board
Devices: [Winsystems] PCM-MIO (pcmmio) * Devices: (Winsystems) PCM-MIO [pcmmio]
Author: Calin Culianu <calin@ajvar.org> * Author: Calin Culianu <calin@ajvar.org>
Updated: Wed, May 16 2007 16:21:10 -0500 * Updated: Wed, May 16 2007 16:21:10 -0500
Status: works * Status: works
*
A driver for the relatively new PCM-MIO multifunction board from * A driver for the PCM-MIO multifunction board from Winsystems. This
Winsystems. This board is a PC-104 based I/O board. It contains * is a PC-104 based I/O board. It contains four subdevices:
four subdevices: *
subdevice 0 - 16 channels of 16-bit AI * subdevice 0 - 16 channels of 16-bit AI
subdevice 1 - 8 channels of 16-bit AO * subdevice 1 - 8 channels of 16-bit AO
subdevice 2 - first 24 channels of the 48 channel of DIO * subdevice 2 - first 24 channels of the 48 channel of DIO
(with edge-triggered interrupt support) * (with edge-triggered interrupt support)
subdevice 3 - last 24 channels of the 48 channel DIO * subdevice 3 - last 24 channels of the 48 channel DIO
(no interrupt support for this bank of channels) * (no interrupt support for this bank of channels)
*
Some notes: * Some notes:
*
Synchronous reads and writes are the only things implemented for AI and AO, * Synchronous reads and writes are the only things implemented for analog
even though the hardware itself can do streaming acquisition, etc. Anyone * input and output. The hardware itself can do streaming acquisition, etc.
want to add asynchronous I/O for AI/AO as a feature? Be my guest... *
* Asynchronous I/O for the DIO subdevices *is* implemented, however! They
Asynchronous I/O for the DIO subdevices *is* implemented, however! They are * are basically edge-triggered interrupts for any configuration of the
basically edge-triggered interrupts for any configuration of the first * channels in subdevice 2.
24 DIO-lines. *
* Also note that this interrupt support is untested.
Also note that this interrupt support is untested. *
* A few words about edge-detection IRQ support (commands on DIO):
A few words about edge-detection IRQ support (commands on DIO): *
* To use edge-detection IRQ support for the DIO subdevice, pass the IRQ
* To use edge-detection IRQ support for the DIO subdevice, pass the IRQ * of the board to the comedi_config command. The board IRQ is not jumpered
of the board to the comedi_config command. The board IRQ is not jumpered * but rather configured through software, so any IRQ from 1-15 is OK.
but rather configured through software, so any IRQ from 1-15 is OK. *
* Due to the genericity of the comedi API, you need to create a special
* Due to the genericity of the comedi API, you need to create a special * comedi_command in order to use edge-triggered interrupts for DIO.
comedi_command in order to use edge-triggered interrupts for DIO. *
* Use comedi_commands with TRIG_NOW. Your callback will be called each
* Use comedi_commands with TRIG_NOW. Your callback will be called each * time an edge is detected on the specified DIO line(s), and the data
time an edge is detected on the specified DIO line(s), and the data * values will be two sample_t's, which should be concatenated to form
values will be two sample_t's, which should be concatenated to form * one 32-bit unsigned int. This value is the mask of channels that had
one 32-bit unsigned int. This value is the mask of channels that had * edges detected from your channel list. Note that the bits positions
edges detected from your channel list. Note that the bits positions * in the mask correspond to positions in your chanlist when you
in the mask correspond to positions in your chanlist when you * specified the command and *not* channel id's!
specified the command and *not* channel id's! *
* To set the polarity of the edge-detection interrupts pass a nonzero value
* To set the polarity of the edge-detection interrupts pass a nonzero value * for either CR_RANGE or CR_AREF for edge-up polarity, or a zero
for either CR_RANGE or CR_AREF for edge-up polarity, or a zero * value for both CR_RANGE and CR_AREF if you want edge-down polarity.
value for both CR_RANGE and CR_AREF if you want edge-down polarity. *
* Configuration Options:
Configuration Options: * [0] - I/O port base address
[0] - I/O port base address * [1] - IRQ (optional -- for edge-detect interrupt support only,
[1] - IRQ (optional -- for edge-detect interrupt support only, * leave out if you don't need this feature)
leave out if you don't need this feature) */
*/
#include <linux/module.h> #include <linux/module.h>
#include <linux/interrupt.h> #include <linux/interrupt.h>
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment