HOWTO for clients of the iarc server

1. Start Up 

The iarc_server can be started without any command argument, was our client
software will issue command to it.

Open an xterm, and start the iarc_server.
  Then ic, xui, dv.
  The IC would connect to the iarc server.

2. Connections

The iarc_server creates a server port 8000 for clients.
   Only 1 client at at time. New client can connect if old one disconnect.
	Looks like just an input port.
	iarc_server seems to have a write thread, it does not write anything now
	(and can only output "still up")

The iarc_server opens a "./iarc_server.log" file in the cwd.

The iarc_server open a client port to 127.0.0.1:9020 for a netlog. 
The same information printed in iarc_server.log is echo'ed here.
If you would like the log data, then establish this server port before starting the iarc_server.

iarc_server

Run this a boot time. On bigdogh it reboots the machine if started after the computer
as been up for a while.

   iarc_server

Init

  open a socket localhost:8000

  "init -f $filename" 
    Issue a init command to the controller. This load the .lod DSP file into the controller,
    and does a PowerON command.

Now the controller is ready to to take data.

Go

There is an example with the parameters (comment to clarify)

go -r 4                        // ndr_readouts
   --itime_ndrs 0              // itime readouts
   -c 1                        // coadds
   -m RAW                      // readout mode: SINGLE, DOUBLE, RAMP, RAW
   -p 3                        // pixel time: 3, 5, 10
   -x 0 -y 0 -w 2048 -h 2048   // subarray x y wid hgt
   --dven on --dvhn localhost --dvp 30123 --dvbuf A  // dv stuff
   -f filename                // filename ie "basename.a.0001.fits"
   -n 1                       // N/A - says filename, but not used.

SINGLE readout mode notes

   n_image_count = (RESET, ITIME_NDR, NDR_CNT) x COADD
	Results is the sum(NDR_CNT) x COADDS.
 
DOUBLE readout mode notes

   n_image_count = (RESET, NDR_CNT, ITIME_NDR, NDR_CNT) x COADD  + COADD
	                "+COADD" - iarc 1st readout is just a array flush.

	Results are: ped(NDR_CNT) - sam(NDR_CNT) x COADDS.

RAMP readout mode notes

   n_image_count = (RESET, ITIME_NDR, NDR_CNT)

RAW readout mode notes


Aborts

anything est