Commit 12cba5c9 authored by Arno Tiemersma's avatar Arno Tiemersma Committed by Greg Kroah-Hartman

staging: comedi: daqboard2000: Use preferred comment style

Use the preferred block comment style for the copyright and driver
description header comments.
Signed-off-by: default avatarArno Tiemersma <arno.tiemersma@gmail.com>
Reviewed-by: default avatarIan Abbott <abbotti@mev.co.uk>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent cbba89f8
/* /*
comedi/drivers/daqboard2000.c * comedi/drivers/daqboard2000.c
hardware driver for IOtech DAQboard/2000 * hardware driver for IOtech DAQboard/2000
*
COMEDI - Linux Control and Measurement Device Interface * COMEDI - Linux Control and Measurement Device Interface
Copyright (C) 1999 Anders Blomdell <anders.blomdell@control.lth.se> * Copyright (C) 1999 Anders Blomdell <anders.blomdell@control.lth.se>
*
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: daqboard2000 * Driver: daqboard2000
Description: IOTech DAQBoard/2000 * Description: IOTech DAQBoard/2000
Author: Anders Blomdell <anders.blomdell@control.lth.se> * Author: Anders Blomdell <anders.blomdell@control.lth.se>
Status: works * Status: works
Updated: Mon, 14 Apr 2008 15:28:52 +0100 * Updated: Mon, 14 Apr 2008 15:28:52 +0100
Devices: [IOTech] DAQBoard/2000 (daqboard2000) * Devices: [IOTech] DAQBoard/2000 (daqboard2000)
*
Much of the functionality of this driver was determined from reading * Much of the functionality of this driver was determined from reading
the source code for the Windows driver. * the source code for the Windows driver.
*
The FPGA on the board requires fimware, which is available from * The FPGA on the board requires fimware, which is available from
http://www.comedi.org in the comedi_nonfree_firmware tarball. * http://www.comedi.org in the comedi_nonfree_firmware tarball.
*
Configuration options: not applicable, uses PCI auto config * Configuration options: not applicable, uses PCI auto config
*/ */
/* /*
This card was obviously never intended to leave the Windows world, * This card was obviously never intended to leave the Windows world,
since it lacked all kind of hardware documentation (except for cable * since it lacked all kind of hardware documentation (except for cable
pinouts, plug and pray has something to catch up with yet). * pinouts, plug and pray has something to catch up with yet).
*
With some help from our swedish distributor, we got the Windows sourcecode * With some help from our swedish distributor, we got the Windows sourcecode
for the card, and here are the findings so far. * for the card, and here are the findings so far.
*
1. A good document that describes the PCI interface chip is 9080db-106.pdf * 1. A good document that describes the PCI interface chip is 9080db-106.pdf
available from http://www.plxtech.com/products/io/pci9080 * available from http://www.plxtech.com/products/io/pci9080
*
2. The initialization done so far is: * 2. The initialization done so far is:
a. program the FPGA (windows code sans a lot of error messages) * a. program the FPGA (windows code sans a lot of error messages)
b. * b.
*
3. Analog out seems to work OK with DAC's disabled, if DAC's are enabled, * 3. Analog out seems to work OK with DAC's disabled, if DAC's are enabled,
you have to output values to all enabled DAC's until result appears, I * you have to output values to all enabled DAC's until result appears, I
guess that it has something to do with pacer clocks, but the source * guess that it has something to do with pacer clocks, but the source
gives me no clues. I'll keep it simple so far. * gives me no clues. I'll keep it simple so far.
*
4. Analog in. * 4. Analog in.
Each channel in the scanlist seems to be controlled by four * Each channel in the scanlist seems to be controlled by four
control words: * control words:
*
Word0: * Word0:
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
! | | | ! | | | ! | | | ! | | | ! * ! | | | ! | | | ! | | | ! | | | !
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
*
Word1: * Word1:
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
! | | | ! | | | ! | | | ! | | | ! * ! | | | ! | | | ! | | | ! | | | !
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| | | | | | | * | | | | | | |
+------+------+ | | | | +-- Digital input (??) * +------+------+ | | | | +-- Digital input (??)
| | | | +---- 10 us settling time * | | | | +---- 10 us settling time
| | | +------ Suspend acquisition (last to scan) * | | | +------ Suspend acquisition (last to scan)
| | +-------- Simultaneous sample and hold * | | +-------- Simultaneous sample and hold
| +---------- Signed data format * | +---------- Signed data format
+------------------------- Correction offset low * +------------------------- Correction offset low
*
Word2: * Word2:
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
! | | | ! | | | ! | | | ! | | | ! * ! | | | ! | | | ! | | | ! | | | !
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| | | | | | | | | | * | | | | | | | | | |
+-----+ +--+--+ +++ +++ +--+--+ * +-----+ +--+--+ +++ +++ +--+--+
| | | | +----- Expansion channel * | | | | +----- Expansion channel
| | | +----------- Expansion gain * | | | +----------- Expansion gain
| | +--------------- Channel (low) * | | +--------------- Channel (low)
| +--------------------- Correction offset high * | +--------------------- Correction offset high
+----------------------------- Correction gain low * +----------------------------- Correction gain low
Word3: * Word3:
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
! | | | ! | | | ! | | | ! | | | ! * ! | | | ! | | | ! | | | ! | | | !
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ * +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| | | | | | | | | * | | | | | | | | |
+------+------+ | | +-+-+ | | +-- Low bank enable * +------+------+ | | +-+-+ | | +-- Low bank enable
| | | | | +---- High bank enable * | | | | | +---- High bank enable
| | | | +------ Hi/low select * | | | | +------ Hi/low select
| | | +---------- Gain (1,?,2,4,8,16,32,64) * | | | +---------- Gain (1,?,2,4,8,16,32,64)
| | +-------------- differential/single ended * | | +-------------- differential/single ended
| +---------------- Unipolar * | +---------------- Unipolar
+------------------------- Correction gain high * +------------------------- Correction gain high
*
999. The card seems to have an incredible amount of capabilities, but * 999. The card seems to have an incredible amount of capabilities, but
trying to reverse engineer them from the Windows source is beyond my * trying to reverse engineer them from the Windows source is beyond my
patience. * patience.
*
*/ */
#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