Commit 6434b47d authored by Rasmus Linusson's avatar Rasmus Linusson Committed by Greg Kroah-Hartman

staging: comedi: cb_pcimdda: Fix multi-line comments

Add asterisks to multi-line comments currently missing them
Signed-off-by: default avatarRasmus Linusson <rasmus@linusson.org>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent dda68765
/* /*
comedi/drivers/cb_pcimdda.c * comedi/drivers/cb_pcimdda.c
Computer Boards PCIM-DDA06-16 Comedi driver * Computer Boards PCIM-DDA06-16 Comedi driver
Author: Calin Culianu <calin@ajvar.org> * Author: Calin Culianu <calin@ajvar.org>
*
COMEDI - Linux Control and Measurement Device Interface * COMEDI - Linux Control and Measurement Device Interface
Copyright (C) 2000 David A. Schleef <ds@schleef.org> * Copyright (C) 2000 David A. Schleef <ds@schleef.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: cb_pcimdda * Driver: cb_pcimdda
Description: Measurement Computing PCIM-DDA06-16 * Description: Measurement Computing PCIM-DDA06-16
Devices: [Measurement Computing] PCIM-DDA06-16 (cb_pcimdda) * Devices: [Measurement Computing] PCIM-DDA06-16 (cb_pcimdda)
Author: Calin Culianu <calin@ajvar.org> * Author: Calin Culianu <calin@ajvar.org>
Updated: Mon, 14 Apr 2008 15:15:51 +0100 * Updated: Mon, 14 Apr 2008 15:15:51 +0100
Status: works * Status: works
*
All features of the PCIM-DDA06-16 board are supported. This board * All features of the PCIM-DDA06-16 board are supported. This board
has 6 16-bit AO channels, and the usual 8255 DIO setup. (24 channels, * has 6 16-bit AO channels, and the usual 8255 DIO setup. (24 channels,
configurable in banks of 8 and 4, etc.). This board does not support commands. * configurable in banks of 8 and 4, etc.). This board does not support commands.
*
The board has a peculiar way of specifying AO gain/range settings -- You have * The board has a peculiar way of specifying AO gain/range settings -- You have
1 jumper bank on the card, which either makes all 6 AO channels either * 1 jumper bank on the card, which either makes all 6 AO channels either
5 Volt unipolar, 5V bipolar, 10 Volt unipolar or 10V bipolar. * 5 Volt unipolar, 5V bipolar, 10 Volt unipolar or 10V bipolar.
*
Since there is absolutely _no_ way to tell in software how this jumper is set * Since there is absolutely _no_ way to tell in software how this jumper is set
(well, at least according to the rather thin spec. from Measurement Computing * (well, at least according to the rather thin spec. from Measurement Computing
that comes with the board), the driver assumes the jumper is at its factory * that comes with the board), the driver assumes the jumper is at its factory
default setting of +/-5V. * default setting of +/-5V.
*
Also of note is the fact that this board features another jumper, whose * Also of note is the fact that this board features another jumper, whose
state is also completely invisible to software. It toggles two possible AO * state is also completely invisible to software. It toggles two possible AO
output modes on the board: * output modes on the board:
*
- Update Mode: Writing to an AO channel instantaneously updates the actual * - Update Mode: Writing to an AO channel instantaneously updates the actual
signal output by the DAC on the board (this is the factory default). * signal output by the DAC on the board (this is the factory default).
- Simultaneous XFER Mode: Writing to an AO channel has no effect until * - Simultaneous XFER Mode: Writing to an AO channel has no effect until
you read from any one of the AO channels. This is useful for loading * you read from any one of the AO channels. This is useful for loading
all 6 AO values, and then reading from any one of the AO channels on the * all 6 AO values, and then reading from any one of the AO channels on the
device to instantly update all 6 AO values in unison. Useful for some * device to instantly update all 6 AO values in unison. Useful for some
control apps, I would assume? If your jumper is in this setting, then you * control apps, I would assume? If your jumper is in this setting, then you
need to issue your comedi_data_write()s to load all the values you want, * need to issue your comedi_data_write()s to load all the values you want,
then issue one comedi_data_read() on any channel on the AO subdevice * then issue one comedi_data_read() on any channel on the AO subdevice
to initiate the simultaneous XFER. * to initiate the simultaneous XFER.
*
Configuration Options: not applicable, uses PCI auto config * Configuration Options: not applicable, uses PCI auto config
*/ */
/* /*
This is a driver for the Computer Boards PCIM-DDA06-16 Analog Output * This is a driver for the Computer Boards PCIM-DDA06-16 Analog Output
card. This board has a unique register layout and as such probably * card. This board has a unique register layout and as such probably
deserves its own driver file. * deserves its own driver file.
*
It is theoretically possible to integrate this board into the cb_pcidda * It is theoretically possible to integrate this board into the cb_pcidda
file, but since that isn't my code, I didn't want to significantly * file, but since that isn't my code, I didn't want to significantly
modify that file to support this board (I thought it impolite to do so). * modify that file to support this board (I thought it impolite to do so).
*
At any rate, if you feel ambitious, please feel free to take * At any rate, if you feel ambitious, please feel free to take
the code out of this file and combine it with a more unified driver * the code out of this file and combine it with a more unified driver
file. * file.
*
I would like to thank Timothy Curry <Timothy.Curry@rdec.redstone.army.mil> * I would like to thank Timothy Curry <Timothy.Curry@rdec.redstone.army.mil>
for lending me a board so that I could write this driver. * for lending me a board so that I could write this driver.
*
-Calin Culianu <calin@ajvar.org> * -Calin Culianu <calin@ajvar.org>
*/ */
#include <linux/module.h> #include <linux/module.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