Command Line Usage
==================

A separate command line user interface became unnecessary when INDI was 
introduced to XmCCD with Version 3.0. INDI offers a versatile solution which
will be easier for us to maintain. 

Here's how to use INDI on the command line from any computer connected to the
INDI server (see the file REMOTE to enable this feature):

1. Start the indiserver from the directory in which you want to save 
   image files on the computer connected to the camera
   
   cd image_directory
   indiserver ccd
   
   where indiserver and ccd are in the path (usually /usr/local/bin)
   

2. From your local computer of choice (it can be the same one, of course)

     getINDI ccd.*.*
   
   will report all the values you can control. As a partial list you might see 
   
     ccd.sequence.run=Off
     ccd.image_exposure.time=1
     ccd.track_exposure.time=0.4000000000000000222
     ccd.temperature_control.setting=-10
     ccd.camera_temperature.reading=-10
     ccd.cooler.power=Off
     ccd.image_region_control.option=Off
     ccd.image_region.x=1
     ccd.image_region.y=1
     ccd.image_region.w=3072
     ccd.image_region.h=2048
     ccd.track_region_control.option=Off
     ccd.track_region.x=1
     ccd.track_region.y=1
     ccd.track_region.w=657
     ccd.track_region.h=495   

   To take an exposure you would change the Sequence command to on:
      
      setINDI 'ccd.sequence.run=On'
   
   and similarly for any other value.  There is a list of parameters in indiccd.
   Note the use of the single quote here, sometimes needed to get
   the string through to the XML that makes this work.
   
   Other INDI clients may be running, so several processes can talk to the
   server, and a telescope operator may monitor and assist the work done by 
   a user at another site.
   
   Clearly the setINDI and getINDI commands may be imbedded in scripts so
   you can make your own short commands, or even run the camera from
   a web interface.