man8/actARtask
Table of Contents
actARtask - ACT analog read module I/O service
actARtask <argument
list>
Analog read I/O service for ACT modules.
This program supports
all analog input ACT modules.
Base modules consist of 16 channels. Expansion
(or mezzanine) modules contain 8 channels and can be installed only on
analog base modules (input or output).
Each channel provides a 16bit ADC
(VDC).
- Input channels can be individually programmed to any of the following
gains.
10V (Unipolar or Bipolar)
5V (Unipolar or Bipolar)
2.5V (Unipolar or Bipolar)
1.25V (Unipolar or Bipolar)
The gain affects the value needed for DRkey
in the param table.
The Unipolar gains should use a DRkey of U.
The Bipolar gains should use a DRkey of I, P, or N.
Identification information
and calibration data is stored in the onboard flash memory of each module.
Argument processing is done using Unix long argument syntax.
The
values of all the parameters listed here (whether or not they were supplied
on the command line) are printed on stderr when the program starts.
- --dbman_host
<hn>
The host where dbman is running.
If this argument is not supplied the default
is "localhost".
The DBMAN_HOST environment variable is used if present.
- --dbman_name <rn>
Sets the name the program will use to register with dbman.
- --dev <path>
The device path to open.
If this argument is not supplied the default is
"/dev/kbuss".
- --drv <drv>
The driver key to use.
If this argument is not specified the default is
"KBUSS_1".
- --cmin <C>
The minimum crate number.
If this argument is not supplied the default
is "0".
- --cmax <C>
The maximum crate number.
If this argument is not supplied the default
is "15".
- --log_flag <logging>
If this argument has the value "bad", I/O trasactions with bad status will
be logged each time the status changes.
If this argument has the value "all", I/O trasactions will be logged whenever
the binary data value changes.
- --raw
Normally the calibration table is read from the onboard flash and utilized.
If this flag is set, the program will ignore the calibration data and send
the raw value to the ADC.
This is primarily for diagnostic purposes.
- --diag
Don’t close stdin and stdout and allow SIGINT to kill the program.
- --show_tbl
Print the contents of various tables to stderr.
- --verbose=<level>
Print more information. If <level> is missing it defaults to 1.
- --persist
Run the program in persist mode.
- --tagname_ctl
parameter name to use for task control.
- --tagname_status
parameter name to use for reporting task status.
- --help
Print the help information to stderr.
- ACTadcV
- required
Analog Reads.
This record must be present in the database for the module to be serviced
by the program.
There should be 1 entry for each ADC channel available on the module.
DTkey
should always be set to U.
Crate defines the module’s address.
Slot defines
the channel count.
0 = 8 Channels
1 = 16 Channels
2 = 24 Channels
This value should be consistent across all entries for a given module.
ChanNo defines the ADC channel, starting from 0. For example, a 16 channel
module will use ChanNo values of 0 to 15.
- ACTadcGN - optional
Gain Controls.
This record optionally defines the gain setting of a channel.
If this entry
is not present for a channel, it will default to the 10V Unipolar gain.
Valid Gains
0x00 = 10V Unipolar
0x40 = 10V Bipolar
0x01 = 5V Unipolar
0x41 = 5V Bipolar
0x02 = 2.5V Unipolar
0x42 = 2.5V Bipolar
0x03 = 1.25V Unipolar
0x43 = 1.25V Bipolar
The database entry should match with the corresponding
ACTadcV entry.
Although it is not recommended, these can be mapped to tagnames
and are updated upon change. Scaling issues will arise.
Polling
is normally performed at 1Hz.
Fast polling at 10Hz is supported.
#
# this example limits service to address 0 thru 3
# dbman is running on the same host
#
actARtask --cmin 0 --cmax 3
#
#
# this example ignores the calibration data
#
actARtask --raw
$Id: actARtask.8,v 1.0 2009/10/08 20:21:05
stodola Exp $
Table of Contents
NARA 5SDH-2
