Staging: comedi: adl_paci9118: organized entry comments
PATCH 1/1 Staging: comedi: adl_paci9118: organized entry comments
Introductory comments organized according to Linux's comment coding style.
Signed-off-by Sam Asadi <[email protected]>
--- drivers/staging/comedi/drivers/adl_pci9118.c | 109 +++++++++++++------------- 1 file changed, 55 insertions(+), 54 deletions(-)
drivers/staging/comedi/drivers/adl_pci9118.c +55 -54
@@ -7,61 +7,62 @@* * Author: Michal Dobes <[email protected]> * -*/ +*/ +/* -Driver: adl_pci9118 -Description: Adlink PCI-9118DG, PCI-9118HG, PCI-9118HR -Author: Michal Dobes <[email protected]> -Devices: [ADLink] PCI-9118DG (pci9118dg), PCI-9118HG (pci9118hg), -PCI-9118HR (pci9118hr) -Status: works - -This driver supports AI, AO, DI and DO subdevices. -AI subdevice supports cmd and insn interface, -other subdevices support only insn interface. -For AI: -- If cmd->scan_begin_src=TRIG_EXT then trigger input is TGIN (pin 46). -- If cmd->convert_src=TRIG_EXT then trigger input is EXTTRG (pin 44). -- If cmd->start_src/stop_src=TRIG_EXT then trigger input is TGIN (pin 46). -- It is not necessary to have cmd.scan_end_arg=cmd.chanlist_len but -cmd.scan_end_arg modulo cmd.chanlist_len must by 0. -- If return value of cmdtest is 5 then you've bad channel list -(it isn't possible mixture S.E. and DIFF inputs or bipolar and unipolar -ranges). - -There are some hardware limitations: -a) You cann't use mixture of unipolar/bipoar ranges or differencial/single -ended inputs. -b) DMA transfers must have the length aligned to two samples (32 bit), -so there is some problems if cmd->chanlist_len is odd. This driver tries -bypass this with adding one sample to the end of the every scan and discard -it on output but this cann't be used if cmd->scan_begin_src=TRIG_FOLLOW -and is used flag TRIG_WAKE_EOS, then driver switch to interrupt driven mode -with interrupt after every sample. -c) If isn't used DMA then you can use only mode where -cmd->scan_begin_src=TRIG_FOLLOW. - -Configuration options: -[0] - PCI bus of device (optional) -[1] - PCI slot of device (optional) -If bus/slot is not specified, then first available PCI -card will be used. -[2] - 0= standard 8 DIFF/16 SE channels configuration -n = external multiplexer connected, 1 <= n <= 256 -[3] - 0=autoselect DMA or EOC interrupts operation -1 = disable DMA mode -3 = disable DMA and INT, only insn interface will work -[4] - sample&hold signal - card can generate signal for external S&H board -0 = use SSHO(pin 45) signal is generated in onboard hardware S&H logic -0 != use ADCHN7(pin 23) signal is generated from driver, number say how -long delay is requested in ns and sign polarity of the hold -(in this case external multiplexor can serve only 128 channels) -[5] - 0=stop measure on all hardware errors -2 | = ignore ADOR - A/D Overrun status -8|=ignore Bover - A/D Burst Mode Overrun status -256|=ignore nFull - A/D FIFO Full status - -*/ +* Driver: adl_pci9118 +* Description: Adlink PCI-9118DG, PCI-9118HG, PCI-9118HR +* Author: Michal Dobes <[email protected]> +* Devices: [ADLink] PCI-9118DG (pci9118dg), PCI-9118HG (pci9118hg), +* PCI-9118HR (pci9118hr) +* Status: works +* +* This driver supports AI, AO, DI and DO subdevices. +* AI subdevice supports cmd and insn interface, +* other subdevices support only insn interface. +* For AI: +* - If cmd->scan_begin_src=TRIG_EXT then trigger input is TGIN (pin 46). +* - If cmd->convert_src=TRIG_EXT then trigger input is EXTTRG (pin 44). +* - If cmd->start_src/stop_src=TRIG_EXT then trigger input is TGIN (pin 46). +* - It is not necessary to have cmd.scan_end_arg=cmd.chanlist_len but +* cmd.scan_end_arg modulo cmd.chanlist_len must by 0. +* - If return value of cmdtest is 5 then you've bad channel list +* (it isn't possible mixture S.E. and DIFF inputs or bipolar and unipolar +* ranges). +* +* There are some hardware limitations: +* a) You cann't use mixture of unipolar/bipoar ranges or differencial/single +* ended inputs. +* b) DMA transfers must have the length aligned to two samples (32 bit), +* so there is some problems if cmd->chanlist_len is odd. This driver tries +* bypass this with adding one sample to the end of the every scan and discard +* it on output but this cann't be used if cmd->scan_begin_src=TRIG_FOLLOW +* and is used flag TRIG_WAKE_EOS, then driver switch to interrupt driven mode +* with interrupt after every sample. +* c) If isn't used DMA then you can use only mode where +* cmd->scan_begin_src=TRIG_FOLLOW. +* +* Configuration options: +* [0] - PCI bus of device (optional) +* [1] - PCI slot of device (optional) +* If bus/slot is not specified, then first available PCI +* card will be used. +* [2] - 0= standard 8 DIFF/16 SE channels configuration +* n = external multiplexer connected, 1 <= n <= 256 +* [3] - 0=autoselect DMA or EOC interrupts operation +* 1 = disable DMA mode +* 3 = disable DMA and INT, only insn interface will work +* [4] - sample&hold signal - card can generate signal for external S&H board +* 0 = use SSHO(pin 45) signal is generated in onboard hardware S&H logic +* 0 != use ADCHN7(pin 23) signal is generated from driver, number say how +* long delay is requested in ns and sign polarity of the hold +* (in this case external multiplexor can serve only 128 channels) +* [5] - 0=stop measure on all hardware errors +* 2 | = ignore ADOR - A/D Overrun status +* 8|=ignore Bover - A/D Burst Mode Overrun status +* 256|=ignore nFull - A/D FIFO Full status +* +*/ /* * FIXME
Signature · 1 line
1.7.10.4