man5/lim_conf

Table of Contents

Name

lim_conf - limits processing configuration file

Description

LIMmngr(8) uses information from this file to determine what parameters to monitor and how to monitor them.

Configuration File Format

Each line in the configuration file is one entry. The file may contain blank lines. Lines starting with a # are treated as comment lines. | is used as a field separator.

Entries in the configuration file consist of a several fields all of which are required.

The fields appear in the file in this order: recid, c_lbl, c_ref, r_lbl, r_ref, ena_lbl, ena_ref, lim_lbl, lim_ref, del_lbl, del_ref, w_size, tmo, M, and B.

As already mentioned above each field is separated by a "|".

Whitespace, i.e. space characters may be used as padding within a field, for example to make the lines of the file "line up". The whitespace is removed when the file is loaded.

Extra whitespace before or after the Label and RefName fields is removed. However, as usual for AccelNET parameter tagnames whitespace within a label or refname is significant and must be entered properly into the configuration file.

Configuration File Field Description

Parameters marked "required" must be supplied with a valid AccelNET tagname.

Parameters marked "optional" may be supplied with a valid AccelNET tagname or with "NULL" in both the label and the refname fields.

Parameters not otherwise marked must be supplied with a valid value.

recid - required

An integer value used to identify an entry. There must be a unique value for every entry, however the values do not need to be contiguous.
c_lbl/c_ref - required

The tagname for the parameter which sets the value of the device being checked.

r_lbl/r_ref - required

The tagname for the parameter which reads the value of the device being checked.

ena_lbl/ena_ref - optional

The tagname for the parameter which indicates the device is enabled, for example, the power status control.

The expected values are:

0.0 = off
1.0 = on

If the tagname fields are "NULL" LIMmngr(8) will treat the entry as enabled at all times.

lim_lbl/lim_ref - optional

The tagname for the parameter which indicates the status of the limit check. This parameter must be writable by LIMmngr(8) .

The values used to update the parameter are:

0.0 = In Limit
1.0 = Out of Limit

del_lbl/del_ref - optional

The tagname for the parameter used to display the difference between the control and the readback.

This parameter must be writable by LIMmngr(8) .

w_size - required

The size of the in-limit window.

tmo - required

The amount of time (in seconds) to wait before declaring an error.

M/B - required

Scaling coefficients used to scale the readback to the control before subtracting the difference between them.

Examples

#
# Example LIMmngr configuration file
#
# This example contains two entries for monitoring an arc power supply.
# One lines monitors CR and the other monitors the VR.
#
# The power supply is current controlled so the CR test is a direct
# comparision between the CC and the CR
#
# The VR test is a bit more subtle. In this case we are assuming
# (somewhat fictiously) a linear relationship between the VR and CC.
# The M and B values are set to scale the VR to the CC.
#
# A single line of the configuration file is much too long to fit
# into the manual page so each line is broken into two parts.
#
# The 1st part of the header and the first part of the two example
# lines are shown together followed by a blank line and the remainder
# of the header lines and the examples.
#
# Normally in the configuration file each of these would be one
# contiguous line.
#
#
#recid|c_lbl |c_ref |r_lbl |r_ref |ena_lbl |ena_ref |
#-----|--------|--------|--------|--------|--------|--------|
1|ARC S1-1|CC |ARC S1-1|CR |ITX S1-1|PwrSR |

2|ARC S1-1|CC |ARC S1-1|VR |ITX S1-1|PwrSR |

lim_lbl |lim_ref |del_lbl |del_ref |w_size |tmo |M |B
--------|--------|--------|--------|--------|----|-----|----
ARC S1-1|LimitCR |ARC S1-1|DeltaCR |0.1 |2 |1.0 |0.0
ARC S1-1|LimitVR |ARC S1-1|DeltaVR |0.1 |2 |0.5 |0.0

Notes

See Also

LIMmngr.8

Manual page revision

$Id: lim_conf.5,v 1.0 2006/05/23 17:42:52 kitchen Exp $


Table of Contents