man8/SRStask

Table of Contents

Name

SRStask - Stanford Research current amplifier I/O service

Synopsis

SRStask <argument list>

Description

Serial I/O service for a Stanford Research SR570 current amplifier.

The program expects to find a large number of RefNames some of which are prefixed with SRS and corresponding to the parameter names given in the SRS manual. Others are used by SRStask to control the amplifier and for processing of the voltage output into a current.

Arguments

--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 of present.

This argument overrides all.

--local <path>

The pathname of the local device to connect to.
--remote <host>,<sock>

The host and socket to connect to in remote mode.
--label <label>

A label from the database.
--config_tbl <file>

The pathname of a file in which to store configuration information. Presently the offsets are the only thing stored. See the section SRStask offset processing RefNames for more information.

If the file does not exist when the program is started it is created.

Argument Usage

Argument processing is done using Unix long argument syntax. No specefic order of arguments is required. Note that local or remote mode must be specified.

For remote mode the port number is extracted from /etc/services.

Amplifier Control Database RefNames

The RefNames in this group relate directly to functions in the current amplifier.

Please consult the manual for the current amplifier for more information.

SRSsens

Current amplifier input Sensitivity

SRSsucm

Sensitivity Calibration mode

SRSsucv

Sensitivity uncalibrated value

SRSioon

Input offset status control

SRSiolv

Input offset level

SRSiosn

Input offset sign

SRSiouc

Input offset mode

SRSiouv

Input offset uncalibrated value

SRSbson

Input Bias status control

SRSbslv

Input Bias level

SRSfltt

Filter selection

SRSlfrq

Low Pass filter frequency

SRShfrq

High Pass filter frequency

SRSrold

Filter clear

SRSgnmd

Gain Mode

SRSinvt

Output Invert

SRSblnk

Input Blanking

SRStask control RefNames

RefNames in this section are used by SRStask to manage the current amplifier.

SRSautoC

Autoranging control. Actuating this parameter begins an autorange sequence.

SRSautoR

Autoranging status read. This parameter indicates the state of autoranging, active or nop.

SRSrst

Reset. This causes the computer to resend all values to the amplifier.

SRSscale and SRSoffse

These parameter are written to by SRStask. They contain the current values of the scaling coefficents needed to convert a voltage supplied by the current amplifier into a current read. The voltage is assumed to be scaled from -5 to 5 volts and will be converted to a current by multiplying by SRSscale and adding SRSoffse.

These scaling coefficents may be used by other programs needing to scale voltage to current. For example TRtask does this.

Vr

Amplifier voltage read. This parameter comes from an ADC elsewhere in the system which is assumed to be scaled from -5 to 5 volts.

If this parameter is not present the autorange function will not work and will write a nasty message into the logging file.

Cr

If this parameter is present SRStask will process the incoming VR data into a current read and update the database.

There are two possible ways of providing a current read from an SRS amplifier. One method uses a VR and CR which are processed by SRStask.

The second method uses SRSscale and SRSoffse to allow another task to process the voltage read. This method is used by TRtask to process blocks of AMS data from the multicups.

SRStask offset processing RefNames

RefNames of the form of_* are used to provide an offset correction for each input range of the current amplifier. The name is of the form of_<range_name> where range_name corresponds to an input range.

The offset value for each amplifier range is stored in a configuration file. The values are loaded from the config file into the AccelNET database when SRStask is started. If an offset value is changed by operator command the configuration file is updated with the new value.

Valid RefNames are: of_1pA, of_2pA, of_5pA, of_10pA, of_20pA, of_50pA, of_100pA, of_200pA, of_500pA, of_1nA, of_2nA, of_5nA, of_10nA, of_20nA, of_50nA, of_100nA, of_200nA, of_500nA, of_1uA, of_2uA, of_5uA, of_10uA, of_20uA, of_50uA, of_100uA, of_200uA, of_500uA, and of_1mA.

I/O polling rates

Polling is not done since the current amplifier doesn’t have any data to read.

Notes

The ownership of most of the controls needs to be GPIBtsk. This is odd and may be changed in the future.

Examples

SRStask --dbman_host csdev1 --local /dev/com2 --label "SRS 02-1" --config_tbl /AccelNET/nec/data/srs021_config.dat
SRStask --dbman_host csdev1 --remote csdev11,ETSraw1 --label "SRS 02-1" --config_tbl /AccelNET/nec/data/srs021_config.dat

Note that the label will need to be quoted for the shell to treat it as a single argument.

Note also that the example lines are very long and have probably been wrapped by the software which produced the formatted manual page.

Manual page revision

$Id: SRStask.8,v 1.7 2007/07/17 16:30:45 kitchen Exp $

Table of Contents