staging: comedi: ni_pcimio: fix block comments

Fix the checkpatch.pl issues:
WARNING: Block comments use * on subsequent lines

Signed-off-by: H Hartley Sweeten <hsweeten@visionengravers.com>
Reviewed-by: Ian Abbott <abbotti@mev.co.uk>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
This commit is contained in:
H Hartley Sweeten 2016-06-20 11:39:30 -07:00 committed by Greg Kroah-Hartman
parent 15203e5a79
commit 8b1bb11d63

View file

@ -1,111 +1,106 @@
/*
comedi/drivers/ni_pcimio.c
Hardware driver for NI PCI-MIO E series cards
* Comedi driver for NI PCI-MIO E series cards
*
* COMEDI - Linux Control and Measurement Device Interface
* Copyright (C) 1997-8 David A. Schleef <ds@schleef.org>
*
* 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
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*/
COMEDI - Linux Control and Measurement Device Interface
Copyright (C) 1997-8 David A. Schleef <ds@schleef.org>
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
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
*/
/*
Driver: ni_pcimio
Description: National Instruments PCI-MIO-E series and M series (all boards)
Author: ds, John Hallen, Frank Mori Hess, Rolf Mueller, Herbert Peremans,
Herman Bruyninckx, Terry Barnaby
Status: works
Devices: [National Instruments] PCI-MIO-16XE-50 (ni_pcimio),
PCI-MIO-16XE-10, PXI-6030E, PCI-MIO-16E-1, PCI-MIO-16E-4, PCI-6014, PCI-6040E,
PXI-6040E, PCI-6030E, PCI-6031E, PCI-6032E, PCI-6033E, PCI-6071E, PCI-6023E,
PCI-6024E, PCI-6025E, PXI-6025E, PCI-6034E, PCI-6035E, PCI-6052E,
PCI-6110, PCI-6111, PCI-6220, PCI-6221, PCI-6224, PXI-6224,
PCI-6225, PXI-6225, PCI-6229, PCI-6250,
PCI-6251, PXI-6251, PCIe-6251, PXIe-6251,
PCI-6254, PCI-6259, PCIe-6259,
PCI-6280, PCI-6281, PXI-6281, PCI-6284, PCI-6289,
PCI-6711, PXI-6711, PCI-6713, PXI-6713,
PXI-6071E, PCI-6070E, PXI-6070E,
PXI-6052E, PCI-6036E, PCI-6731, PCI-6733, PXI-6733,
PCI-6143, PXI-6143
Updated: Mon, 09 Jan 2012 14:52:48 +0000
* Driver: ni_pcimio
* Description: National Instruments PCI-MIO-E series and M series (all boards)
* Author: ds, John Hallen, Frank Mori Hess, Rolf Mueller, Herbert Peremans,
* Herman Bruyninckx, Terry Barnaby
* Status: works
* Devices: [National Instruments] PCI-MIO-16XE-50 (ni_pcimio),
* PCI-MIO-16XE-10, PXI-6030E, PCI-MIO-16E-1, PCI-MIO-16E-4, PCI-6014,
* PCI-6040E, PXI-6040E, PCI-6030E, PCI-6031E, PCI-6032E, PCI-6033E,
* PCI-6071E, PCI-6023E, PCI-6024E, PCI-6025E, PXI-6025E, PCI-6034E,
* PCI-6035E, PCI-6052E,
* PCI-6110, PCI-6111, PCI-6220, PCI-6221, PCI-6224, PXI-6224,
* PCI-6225, PXI-6225, PCI-6229, PCI-6250,
* PCI-6251, PXI-6251, PCIe-6251, PXIe-6251,
* PCI-6254, PCI-6259, PCIe-6259,
* PCI-6280, PCI-6281, PXI-6281, PCI-6284, PCI-6289,
* PCI-6711, PXI-6711, PCI-6713, PXI-6713,
* PXI-6071E, PCI-6070E, PXI-6070E,
* PXI-6052E, PCI-6036E, PCI-6731, PCI-6733, PXI-6733,
* PCI-6143, PXI-6143
* Updated: Mon, 09 Jan 2012 14:52:48 +0000
*
* These boards are almost identical to the AT-MIO E series, except that
* they use the PCI bus instead of ISA (i.e., AT). See the notes for the
* ni_atmio.o driver for additional information about these boards.
*
* Autocalibration is supported on many of the devices, using the
* comedi_calibrate (or comedi_soft_calibrate for m-series) utility.
* M-Series boards do analog input and analog output calibration entirely
* in software. The software calibration corrects the analog input for
* offset, gain and nonlinearity. The analog outputs are corrected for
* offset and gain. See the comedilib documentation on
* comedi_get_softcal_converter() for more information.
*
* By default, the driver uses DMA to transfer analog input data to
* memory. When DMA is enabled, not all triggering features are
* supported.
*
* Digital I/O may not work on 673x.
*
* Note that the PCI-6143 is a simultaineous sampling device with 8
* convertors. With this board all of the convertors perform one
* simultaineous sample during a scan interval. The period for a scan
* is used for the convert time in a Comedi cmd. The convert trigger
* source is normally set to TRIG_NOW by default.
*
* The RTSI trigger bus is supported on these cards on subdevice 10.
* See the comedilib documentation for details.
*
* Information (number of channels, bits, etc.) for some devices may be
* incorrect. Please check this and submit a bug if there are problems
* for your device.
*
* SCXI is probably broken for m-series boards.
*
* Bugs:
* - When DMA is enabled, COMEDI_EV_CONVERT does not work correctly.
*/
These boards are almost identical to the AT-MIO E series, except that
they use the PCI bus instead of ISA (i.e., AT). See the notes for
the ni_atmio.o driver for additional information about these boards.
Autocalibration is supported on many of the devices, using the
comedi_calibrate (or comedi_soft_calibrate for m-series) utility.
M-Series boards do analog input and analog output calibration entirely
in software. The software calibration corrects
the analog input for offset, gain and
nonlinearity. The analog outputs are corrected for offset and gain.
See the comedilib documentation on comedi_get_softcal_converter() for
more information.
By default, the driver uses DMA to transfer analog input data to
memory. When DMA is enabled, not all triggering features are
supported.
Digital I/O may not work on 673x.
Note that the PCI-6143 is a simultaineous sampling device with 8 convertors.
With this board all of the convertors perform one simultaineous sample during
a scan interval. The period for a scan is used for the convert time in a
Comedi cmd. The convert trigger source is normally set to TRIG_NOW by default.
The RTSI trigger bus is supported on these cards on
subdevice 10. See the comedilib documentation for details.
Information (number of channels, bits, etc.) for some devices may be
incorrect. Please check this and submit a bug if there are problems
for your device.
SCXI is probably broken for m-series boards.
Bugs:
- When DMA is enabled, COMEDI_EV_CONVERT does
not work correctly.
*/
/*
The PCI-MIO E series driver was originally written by
Tomasz Motylewski <...>, and ported to comedi by ds.
References:
341079b.pdf PCI E Series Register-Level Programmer Manual
340934b.pdf DAQ-STC reference manual
322080b.pdf 6711/6713/6715 User Manual
320945c.pdf PCI E Series User Manual
322138a.pdf PCI-6052E and DAQPad-6052E User Manual
ISSUES:
need to deal with external reference for DAC, and other DAC
properties in board properties
deal with at-mio-16de-10 revision D to N changes, etc.
need to add other CALDAC type
need to slow down DAC loading. I don't trust NI's claim that
two writes to the PCI bus slows IO enough. I would prefer to
use udelay(). Timing specs: (clock)
AD8522 30ns
DAC8043 120ns
DAC8800 60ns
MB88341 ?
*/
* The PCI-MIO E series driver was originally written by
* Tomasz Motylewski <...>, and ported to comedi by ds.
*
* References:
* 341079b.pdf PCI E Series Register-Level Programmer Manual
* 340934b.pdf DAQ-STC reference manual
*
* 322080b.pdf 6711/6713/6715 User Manual
*
* 320945c.pdf PCI E Series User Manual
* 322138a.pdf PCI-6052E and DAQPad-6052E User Manual
*
* ISSUES:
* - need to deal with external reference for DAC, and other DAC
* properties in board properties
* - deal with at-mio-16de-10 revision D to N changes, etc.
* - need to add other CALDAC type
* - need to slow down DAC loading. I don't trust NI's claim that
* two writes to the PCI bus slows IO enough. I would prefer to
* use udelay().
* Timing specs: (clock)
* AD8522 30ns
* DAC8043 120ns
* DAC8800 60ns
* MB88341 ?
*/
#include <linux/module.h>
#include <linux/delay.h>
@ -119,13 +114,14 @@ SCXI is probably broken for m-series boards.
#define PCIDMA
/* These are not all the possible ao ranges for 628x boards.
They can do OFFSET +- REFERENCE where OFFSET can be
0V, 5V, APFI<0,1>, or AO<0...3> and RANGE can
be 10V, 5V, 2V, 1V, APFI<0,1>, AO<0...3>. That's
63 different possibilities. An AO channel
can not act as it's own OFFSET or REFERENCE.
*/
/*
* These are not all the possible ao ranges for 628x boards.
* They can do OFFSET +- REFERENCE where OFFSET can be
* 0V, 5V, APFI<0,1>, or AO<0...3> and RANGE can
* be 10V, 5V, 2V, 1V, APFI<0,1>, AO<0...3>. That's
* 63 different possibilities. An AO channel
* can not act as it's own OFFSET or REFERENCE.
*/
static const struct comedi_lrange range_ni_M_628x_ao = {
8, {
BIP_RANGE(10),