.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH NGINJECT 1 "JULY 2010" "pvss_mockup" "User Commands"
.SH NAME
nginject \- 
.SH SYNOPSIS
.B nginject
.I [options]
.I [<target>[@state]]
.I <action> ...

.SH DESCRIPTION
.B nginject
is the primary tool to control several parts of the ALICE TRD from the
command line.

Currently \fBnginject\fR supports sending commands either directly or
via the InterCom Layer to the FEE, switching of PCU channels, ORI
power adjustments and basic high voltage control. \fBnginject\fR waits
for an acknowledge of the command on an appropriate DIM service and
only returns when the service changed to the expected value.



.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
display help message
.TP
\fB\-q\fR, \fB\-\-quiet\fR
decrease verbosity
.TP
\fB\-v\fR, \fB\-\-verbose\fR
decrease verbosity
.TP
\fB\-w\fR, \fB\-\-ignore\-wingdb\fR
send to all specified chambers without checking wingDB
.TP
\fB\-s\fR, \fB\-\-stylesheet\fR=\fISTYLESHEET\fR
filter output with 
.B xsltproc
using stylesheet
.I STYLESHEET


.SH TARGETS

The target specifies which ROCs the commands will be sent
to. Shell-style wildcards can be used to specify multiple ROCs.
Only one target can be specified at a time.

If the command 
.B wing_showrocs
is available or the option --ignore-wingdb is set, it will only use the ROCs listed 
in its output, otherwise 
.B nginject 
will assume that the all 540 ROCs in the full TRD are available.

.TP
\fISM_S_L\fR \fBTRD-FEE_\fISM_S_L\fR \fBtrd-fee_\fISM_S_L\fR 
send to super-module \fISM\fR, stack \fIS\fR layer \fIL\fR
.TP
\fBsm\fISM\fR
send to all ROCs in super-module \fISM\fR
.TP
\fBall\fR
send to all available ROCs

.SH STATES

If a state is specified on the command line, only ROCs that are in
that state will receive the commands specified on the command
line. This can be used to bring all ROCs to the same state easily. 

Several forms are possible for each state:

.TP
\fBstdby standby\fR
send only to ROCs in state \fBSTANDBY\fR
.TP
\fBstdby_init init\fR
send only to ROCs in state \fBSTANDBY_INITIALIZED\fR
.TP
\fBconfigured cfg\fR
send only to ROCs in state \fBCONFIGURED\fR
.TP
\fBerror err\fR
send only to ROCs in state \fBERROR\fR


.SH ACTIONS

The action items determine the commands to be executed for the
selected chambers. The available action items are:


.TP
\fBon\fR
switch the PCU channels for this chamber on
.TP
\fBoff\fR
switch the PCU channels for this chamber off
.TP
\fI<number>\fR or \fBtag:\fI<number>\fR 
send a tag to the InterCom Layer, which will call the CommandCoder 
and send the resulting configuration to the FeeServer
.TP
\fBdatx:\fI<filename>\fR
convert the .datx file into a binary configuration file and send it 
to the FeeServer
.TP
\fB-\fR
convert standard input, which must be in datx format, into a binary 
configuration file and send it to the FeeServer
.TP
\fBanode:on\fR \fBdrift:on\fR
turn the anode or drift voltage on
.TP
\fBanode:off\fR \fBdrift:off\fR
turn the anode or drift voltage off
.TP
\fBanode:v=\fIvolt\fR \fBdrift:v=\fIvolt\fR
set the anode or drift voltage to \fIvolt\fR
.TP
\fBanode:i=\fIcurr\fR \fBdrift:i=\fIcurr\fR
set the anode or drift current limit to \fIcurr\fR
.TP
\fBori:\fIpwr\fR
adjust the optical power of the ORIs to \fIpwr\fR



.SH BUGS
HV commands return when the setting is read back from the hardware,
not when the desired voltage is reached.

.SH AUTHORS
Tom Dietel, Jochen Klein