You are here: Foswiki>FLAO Web>IrcCommands (17 Nov 2009, LucaFini)Edit Attach

IIF and IRTC Commands

Introduction:

Communication to the IIF (Instrument InterFace) subsystem of the TCS and to the IRTC (InfraRed Test Camera) is accomplished with the IRC (InfraRed Client) command. The IRC command is an executable that can be called at a command line that send requests to the IIF or the IRTC, waits for the request to be implemented and returns information about the requested command. There many possible arguments to the IRC command are listed and described in the Documents section below.

Documentation

  • IRS User Manual: CAN Document 609g021e.pdf
  • AO IRC commands: AO IRC Commands (pdf)
  • % irc -help "command" (at a shell prompt, % irc -list for possible commands)
  • IDL> irc_help (at an IDL prompt on the machine aotcs.arcetri.astro.it)

IIF Commands

When the IRC command is invoked with an IIF request, the IRC communicates directly to the IIF (via an ICE interface).
IRTC Commands

When the IRC command is invoked with an IRTC request, the IRC communicates to the IRS (InfraRed Server) which communicates to the IRTC

NOTE: The TCS/IIF must be running in order for requests to be sent to the IRTC, even though this communication path does not include the IIF. If an IRTC request is made without the IIF running, the IRC command will return and error.

Starting the TCS/IIF/IRS

The TCS, IIF and IRS in Arcetri will run on the CentOS unix machine:

tcstest.arcetri.astro.it (193.206.155.87) located on in the Solar Tower Lab.

The username is adopt (ask somebody for password).

It is suggested that you login twice so that all the processes needed for IRC commands can be started in one terminal and the messages the TCS/IIF/IRS outputs to /var/log/messages

Terminal 1

To viewing the log output:

  • % sudo tail -f /var/log/messages

Terminal 2

Check if the TCS processes are running:

  • % netconfig ps

To start the TCS/IIF/IRS processes:

  • % netconfig ps
  • % netconfig start
  • % netconfig start LSS
  • % netconfig start IIF
  • % irs &

To check that the required subsystems are running:

  • % netconfig ps

Click here to see the output of the above commands

Using the IRC Command

Command line "irc" command

The IRC command can be executed in a shell, say the csh. The IRC command prints out information about the requested command. It also sets the environment variable status to 1/0 depending on the failure/success of the IRC command.

IRC Commands to the IIF

Several IIF examples are:

  • % irc GetParameter /home/tcs/idl/wfsc/irc/irc_dd.dat
  • % irc OffsetPointing 0.0, 0.0, 0.5 RADEC MOUNT true REL left

The file /home/tcs/idl/wfsc/irc/irc_dd.dat contains a list of Data Dictionary variable to retrieve

Click here to see the output of the above commands

IRC Commands to the IRTC

Several IRTC examples are:

  • % irc GetFOV

The IRC command can be used request the IRTC to acquire and save either a single image, or a cube of images, and save them to disk. For example:

  • % irc GetImage
  • % irc GetSeqImages 10

Note that the name of the single image fits file is returned to the IRC command, but the name of the cube fit (note fit, not fits) file is not returned to the IRC command to take a sequence of images. The files are saved in the directory listed on the IRTC GUI.

Click here to see the output of the above commands

IDL routines to send "irc" command

I have written a set of IDL routines to send irc requests to the IIF and to the IRTC. These can be found in home directory ~/idl/wfsc/irc. On the machine aotcs.arcetri.astro.it these routines are automatically set in the IDL_PATH. A description of the IDL setup on aotcs and how to initialize IDL to properly communicate via the irc commands

IDL IRC Commands to the IIF

A couple examples of irc routines:

IDL IRC Commands to the IRTC

  • IDL> irc_getfov, retval, DEBUG=debug
  • IDL> irc_getimage, filename, retval, EXP=exp, RATE=rate, DEBUG=debug, SILENT=silent
  • IDL> irc_getseqimage, num, filename, retval, EXP=exp, RATE=rate, DEBUG=debug, SILENT=silent


DougMiller - 2009-08-25
Topic revision: r6 - 17 Nov 2009, LucaFini
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback