man8/INTmngr

Table of Contents

Name

INTmngr - AMS Integrator manager

Synopsis

INTmngr <arguments>

Description

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.

Arguments

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.

Configuration name usage

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.

Examples


#
#    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|

Notes

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.

See Also

libmngr(3mngr)

Manual page revision

$Id: INTmngr.8,v 1.3 2008/03/10 19:51:43 kitchen Exp $


Table of Contents