stv0g/comedilib
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

comedi_config: Various changes to man page

Browse source
This commit is contained in:
Ian Abbott 2017-04-21 16:35:31 +01:00
parent 7d4414c7a3
commit 43806f72fc
1 changed files with 61 additions and 39 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

100
man/comedi_config.8
View file

@ -1,9 +1,13 @@
.TH comedi_config 8 "" .TH comedi_config 8 ""
.SH NAME .SH NAME
\fBcomedi_config\fR - COMEDI configuration utility comedi_config \- COMEDI configuration utility
.SH SYNOPSIS .SH SYNOPSIS
\fBcomedi_config\fR [-vVq] /dev/comediN <driver> .B comedi_config
[<option1>[,<option2>...]] [\fI\,OPTION\/\fR]... /dev/comedi\fIN\fR \fI\,driver\/\fR
[\fI\,param1\/\fR[,\fI\,param2\/\fR]...]
.br
.B comedi_config
[\fI\,OPTION\/\fR]... -r /dev/comedi\fIN\fR
.br .br
.SH DESCRIPTION .SH DESCRIPTION
\fBcomedi_config\fR is used to configure \fBcomedi\fR drivers. \fBcomedi_config\fR is used to configure \fBcomedi\fR drivers.
@ -13,11 +17,11 @@ to use this utility.
Each control and measurement device is associated with a Each control and measurement device is associated with a
particular \fBcomedi\fR device file \fB/dev/comedi\fRN, where particular \fBcomedi\fR device file \fB/dev/comedi\fRN, where
N is 0,1,2,3, etc. N is 0,1,2,3, etc.
\fBComedi_config\fR allows you to associate a particular \fBcomedi_config\fR allows you to associate a particular
driver and device with a \fBcomedi\fR device file, and also driver and device with a \fBcomedi\fR device file, and also
configure driver parameters for the particular device. configure driver parameters for the particular device.
\fBComedi_config\fR can be used with optional \fBcomedi_config\fR can be used with optional
parameters which are driver dependent. Parameters are parameters which are driver dependent. Parameters are
specified by comma-delimited list of integers. The integers specified by comma-delimited list of integers. The integers
may be expressed as decimal, hexidecimal (starting with 0x) may be expressed as decimal, hexidecimal (starting with 0x)
@ -32,55 +36,61 @@ address and interrupt level.
More information about the parameters required by individual More information about the parameters required by individual
drivers can be found in the \fBcomedi\fR documentation, in drivers can be found in the \fBcomedi\fR documentation, in
the file \fBdrivers.txt\fR. the file \fBdrivers.txt\fR, and in the
.UR http://www.comedi.org/doc/lowleveldrivers.html
Kernel drivers
.UE
section of the
.UR http://www.comedi.org/doc/index.html
\fBComedilib\fR manual
.UE .
.SH OPTIONS .SH OPTIONS
\fBcomedi_config\fR recognizes the following options: \fBcomedi_config\fR recognizes the following options:
\fB-q, --quiet\fR don't print output while running.
\fB-v, --verbose\fR print verbose output while running.
\fB-V, --version\fR print version number and exit.
\fB-r, --remove\fR remove previously configured driver.
.TP .TP
.BI "--read-buffer " "size" \fB\-q\fR, \fB\-\-quiet\fR
set read buffer size to Don't print output while running.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Print verbose output while running.
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version number and exit.
.TP
\fB\-r\fR, \fB\-\-remove\fR
Remove (unconfigure) previously configured device.
.TP
\fB\-\-read-buffer\fR \fIsize\fR
Set read buffer size to
.I size .I size
kilobytes. The default size is 64k. kilobytes. The default size is 64k.
.TP .TP
.BI "--write-buffer " "size" \fB\-\-write-buffer\fR \fIsize\fR
set write buffer size to Set write buffer size to
.I size .I size
kilobytes. The default size is 64k. kilobytes. The default size is 64k.
.TP .TP
.BI "--subdevice-buffer " "num,size[,num,size...]" \fB\-\-subdevice-buffer\fR \fInum\/\fR,\,\fIsize\/\fR[,\,\fInum\/\fR,\,\fIsize\/\fR]...
set subdevice Set subdevice
.I num .I num
buffer size to buffer size to
.I size .I size
kilobytes. More than one \fInum\fR,\fIsize\fR pair may be kilobytes. More than one \fInum\fR,\fIsize\fR pair may be
specified, and the option may be used several times. specified, and the option may be used several times.
.TP .TP
.BI "-i, --init-data, --init-data0 " "file" \fB\-i\fR, \fB\-\-init-data\fR, \fB\-\-init-data0\fR \fIfile\fR
upload initialization data (typically firmware) from Upload initialization data (typically firmware) from
.I file .I file
to board. to board.
.TP .TP
.BI "--init-data1 " "file" \fB\-\-init-data1\fR \fIfile\fR
.TP .TP
.BI "--init-data2 " "file" \fB\-\-init-data2\fR \fIfile\fR
.TP .TP
.BI "--init-data3 " "file" \fB\-\-init-data3\fR \fIfile\fR
Some drivers require more than one file for initialization Some drivers require more than one file for initialization
data. Use these data. Use these
options to specify additional initialization data files. options to specify additional initialization data files.
@ -92,9 +102,11 @@ See the driver-specific documentation for further details.
[This section has not been implemented yet.] [This section has not been implemented yet.]
A list of device configurations can be put into the file A list of device configurations can be put into the file
\fB/etc/comedi.conf\fR. This file takes the form \fB/etc/comedi.conf\fR. This file takes the form:
<device> <driver> <param1>,<param2>,... .EX
<device> <driver> <param1>,<param2>,...
.EE
These configurations will be read and performed when the These configurations will be read and performed when the
switch \fB-a\fR is used. This is potentially useful when switch \fB-a\fR is used. This is potentially useful when
@ -105,22 +117,30 @@ run from an initialization script.
A National Instruments PCI-MIO E series board can be A National Instruments PCI-MIO E series board can be
configured to use /dev/comedi0 using the command: configured to use /dev/comedi0 using the command:
comedi_config /dev/comedi0 ni_pcimio .EX
comedi_config /dev/comedi0 ni_pcimio
.EE
A National Instruments AT-MIO E series board can be A National Instruments AT-MIO E series board can be
configured to use /dev/comedi3 using the command: configured to use /dev/comedi3 using the command:
comedi_config /dev/comedi3 ni_atmio 0x220,3 .EX
comedi_config /dev/comedi3 ni_atmio 0x220,3
.EE
This tells the driver that the board is configured This tells the driver that the board is configured
for I/O base 0x220 and IRQ 3. for I/O base 0x220 and IRQ 3.
.SH ADDITIONAL INFORMATION .SH ADDITIONAL INFORMATION
Additional text documentation can be found in /usr/doc/comedilib-0.7.11. Additional documentation may be found in the
The current version of \fBComedi\fR and \fBComedilib\fR can be .UR http://www.comedi.org/doc/install.html
obtained from ftp://ftp.comedi.org/pub/comedi. The Comedi web site Configuration section
is located at http://www.comedi.org/comedi. .UE
of the
.UR http://www.comedi.org/doc/index.html
\fBComedilib\fR manual
.UE .
.SH SEE ALSO .SH SEE ALSO
@ -132,5 +152,7 @@ is located at http://www.comedi.org/comedi.
.SH AUTHOR .SH AUTHOR
David Schleef, <ds@schleef.org> .MT ds@schleef.org
David Schleef
.ME