Table of Contents
INTmngr - AMS Integrator manager
INTmngr <arguments>
This
program manages an NEC current integrator. It can handle N integrators simultaneously.
This program is for use with the older NEC integrator which has analog
outputs and sends its data to a transient recorder. This program is needed
to bring all of the relevant pieces together since the functionality is
spread between several programs.
The new integrator (PPCI) does not use
this program. All of the functionality is encapsulated in PPCItask(8)
which
is the program used to manage the integrator.
See the NOTES section below.
Argument processing is done using Unix long argument syntax.
- --mngr
<fn>
The pathname to the CONFLIST file from which to obtain the configuration
information.
If this is not specified it defaults to "MNGRconf" in the
current working directory (i.e. the directory where the program was started).
- --mngr_pn <pn>
The program name to use when processing the CONFLIST file.
If this is not
specified it defaults to "INTmngr".
- --conf <fn>
The pathname of the CONFIG_TBL used to store the scaling and offset information.
If this file does not exist it will be created when the program is started.
If the file is created at startup time scaling values will be the default
values and the offsets will be set to zero.
If the file pathname is not
specified on the command line no file will be created or used.
- --diag
If the program is started in this mode stdout and stdin are left open and
signals are set so the program may be killed by SIGINT.
- --verbose=<n>
Normally the program does it’s work silently. This sets the level of logging
information. The number
If no argument is provided the default level is
1.
0 - work normally
1 - print additional information
- --help
Print the help message to stderr and exit.
The configuration
file uses the
libmngr(3mngr)
facility to connect internal parameters to
the AccelNET database. The mappings for this program are given below.
Parameters
needed by this program can be combined with parameters belonging to other
programs. The "program name" field in the configuration file differentiates
the entries.
INTmngr uses "INTmngr" as the program name when searching the
file.
All groups are used. Each group represents the controls for one integrator.
If the parameters marked required are missing from the configuration file
the program will not function properly.
- file1 - required
- This parameter is
used to establish the existence of an integrator. Since so many other parameters
are optional it was decided to have a separate MNGRconf entry to do this.
The Label field should be filled in with the group number.
- comm1 - optional
The power status control for the integrator.
At this time the program doesn’t
use this parameter and it can be ignored.
- comm2 - optional
The mode control.
Usually this is named ModeSC in the AccelNET database.
This is a 1 bit control, 2_channel/combined.
0.0 = 2_channel
1.0 = combined
- comm3 - required
Gain status control.
Usually this is named GainSC in the AccelNET database.
There should be a gain status control for each integrator channel if the
channel is to be used.
Index 0 is the gain for channel 1 and Index 1 is
the gain for channel 2.
- read1 - required
The integration time.
Usually this is named DeltaT in the AccelNET database.
- read2 - not in use
The integrator voltage read.
At this time the program doesn’t use this.
- ctl1 - required
The scale value.
Usually this is named SRSscale in the AccelNET database.
The control key should be set to RSet.
This parameter should be owned
by whatever task INTmngr registers as and the permissions set for direct
update for the owner.
- ctl2 - required
The offset value.
Usually this is named SRSoffse in the AccelNET database.
The control key should be set to RSet.
This parameter should be writable
by whatever task INTmngr registers as and the permissions set for direct
update for the owner.
- int0 - optional
- The scaling values for channel one.
The integrator has ten ranges so there should be a parameter for each
range.
The index field is used to associate an entry with a range. Index
0 corresponds to range 0 and so forth.
- int1 - optional
- The offset values
for channel one.
The integrator has ten ranges so there should be a parameter
for each range.
The index field is used to associate an entry with a range.
Index 0 corresponds to range 0 and so forth.
- int2 - optional
- The scaling
values for channel two.
The integrator has ten ranges so there should be
a parameter for each range.
The index field is used to associate an entry
with a range. Index 0 corresponds to range 0 and so forth.
- int3 - optional
- The
offset values for channel one.
The integrator has ten ranges so there should
be a parameter for each range.
The index field is used to associate an
entry with a range. Index 0 corresponds to range 0 and so forth.
#
#
Sample config file for INTmngr
#
#
# common controls
#
INTmngr|g1|file1 |0|g1 |NULL |
INTmngr|g1|comm1 |0|INT 01-n|PwrSC |
INTmngr|g1|comm2 |0|INT 01-n|ModeSC |
#
# general elements
#
INTmngr|g1|comm3 |0|INT 01-1|GainSC |
INTmngr|g1|comm3 |1|INT 01-2|GainSC |
#
INTmngr|g1|read1 |0|GATE 1 |DeltaT |
INTmngr|g1|read1 |1|GATE 3 |DeltaT |
#
INTmngr|g1|read2 |0|INT 01-1|VR |
INTmngr|g1|read2 |1|INT 01-2|VR |
#
#
INTmngr|g1|ctl1 |0|INT 01-1|SRSscale|
INTmngr|g1|ctl1 |1|INT 01-2|SRSscale|
#
INTmngr|g1|ctl2 |0|INT 01-1|SRSoffse|
INTmngr|g1|ctl2 |1|INT 01-2|SRSoffse|
#
#
# channel 1 - scaling and offset elements
#
INTmngr|g1|int0 |0|INT 01-1|sc_rang0|
INTmngr|g1|int0 |1|INT 01-1|sc_rang1|
INTmngr|g1|int0 |2|INT 01-1|sc_rang2|
INTmngr|g1|int0 |3|INT 01-1|sc_rang3|
INTmngr|g1|int0 |4|INT 01-1|sc_rang4|
INTmngr|g1|int0 |5|INT 01-1|sc_rang5|
INTmngr|g1|int0 |6|INT 01-1|sc_rang6|
INTmngr|g1|int0 |7|INT 01-1|sc_rang7|
INTmngr|g1|int0 |8|INT 01-1|sc_rang8|
INTmngr|g1|int0 |9|INT 01-1|sc_rang9|
#
INTmngr|g1|int1 |0|INT 01-1|of_rang0|
INTmngr|g1|int1 |1|INT 01-1|of_rang1|
INTmngr|g1|int1 |2|INT 01-1|of_rang2|
INTmngr|g1|int1 |3|INT 01-1|of_rang3|
INTmngr|g1|int1 |4|INT 01-1|of_rang4|
INTmngr|g1|int1 |5|INT 01-1|of_rang5|
INTmngr|g1|int1 |6|INT 01-1|of_rang6|
INTmngr|g1|int1 |7|INT 01-1|of_rang7|
INTmngr|g1|int1 |8|INT 01-1|of_rang8|
INTmngr|g1|int1 |9|INT 01-1|of_rang9|
#
# channel 2 - scaling and offset elements
#
INTmngr|g1|int2 |0|INT 01-2|sc_rang0|
INTmngr|g1|int2 |1|INT 01-2|sc_rang1|
INTmngr|g1|int2 |2|INT 01-2|sc_rang2|
INTmngr|g1|int2 |3|INT 01-2|sc_rang3|
INTmngr|g1|int2 |4|INT 01-2|sc_rang4|
INTmngr|g1|int2 |5|INT 01-2|sc_rang5|
INTmngr|g1|int2 |6|INT 01-2|sc_rang6|
INTmngr|g1|int2 |7|INT 01-2|sc_rang7|
INTmngr|g1|int2 |8|INT 01-2|sc_rang8|
INTmngr|g1|int2 |9|INT 01-2|sc_rang9|
#
INTmngr|g1|int3 |0|INT 01-2|of_rang0|
INTmngr|g1|int3 |1|INT 01-2|of_rang1|
INTmngr|g1|int3 |2|INT 01-2|of_rang2|
INTmngr|g1|int3 |3|INT 01-2|of_rang3|
INTmngr|g1|int3 |4|INT 01-2|of_rang4|
INTmngr|g1|int3 |5|INT 01-2|of_rang5|
INTmngr|g1|int3 |6|INT 01-2|of_rang6|
INTmngr|g1|int3 |7|INT 01-2|of_rang7|
INTmngr|g1|int3 |8|INT 01-2|of_rang8|
INTmngr|g1|int3 |9|INT 01-2|of_rang9|
Eventually this program will support
autoranging the integrator. The PwrSC and VR will then be needed.
Older contracts
used NUMmngr2 to implement some of the functionality provided by this program.
The calculations needed to produce the values for SRSscale and SRSoffset
were done this way along with the logic needed to choose the correct sc_rangN
and of_rangN for a given range.
When upgrading, one needs to remove this
information from NUMmngr’s configuration files before using this program.
libmngr(3mngr)
$Id: INTmngr.8,v 1.3 2008/03/10
19:51:43 kitchen Exp $
Table of Contents