Instructions for accessing the EDAS HWP controller for the purpose of 
restarting Peter Ashton's HWP control program.  

(Also has instructions on retrieving and interpreting the debug file.)

July 14, 2014

The EDAS starts Peter's latest EDAS control program on boot-up.
As of July 14, 2014, this is Peter_EDAS_test_2_20.exe.
A summary of the various tested HWP control codes available:
* Larry's code (used prior to 2012) is called hwp.exe.
* Peter's November 2013 code is called Peter_EDAS_test.exe
* Peter's March 2014 code is called Peter_EDAS_test_2_20.exe.
* Dummy_HWP_control.exe - Does not actually move the motor
or read the encoder at all, but will return the angle 50 degrees.  
This is meant to be used if the EDAS is turned on but Box 3
is not installed.

To restart the HWP control program, you have to access the EDAS via 
its web server and then terminate whichever one of Peter's executable
files is running, and then restart it.

You will need the username and password: admin, admin

Here are the details:

If observing remotely, you can log into the EDAS as follows:
% tunnelopen.pl -l sharp@kilauea.submm.caltech.edu http://128.171.86.86

You can install tunnelopen.pl on your computer by following the
instructions for "remote observing" on the CSO Observers web pages.

Or, if you are at the telescope physically, or can access a web browser
on kilauea remotely, then open a web browser and go to this url: 

http://128.171.86.86

from HOME, go to "Application Manager" 

terminate Peter_EDAS_test_2_20.exe (or whichever version is running) by 
clicking the corresponding red stop sign

go back to HOME, and then go to "File Manager" (note this is slow - 
it takes 10 sec to get there)

From "File Manager" go to "Storage Card" (this is even slower - it 
takes 20 seconds)

Find Peter_EDAS_test_2_20.exe (or whichever one of Peter's executables
you wish to run) and push the green arrow to start it

This will take you to a window that allows you to add arguments to 
the command.  There are no arguments to add so just push "Run".

If you like, you can go back to applications manager just to verify 
that Peter_EDAS_test_2_20.exe (or whatever you started up) is running.

Finally, note that after doing the above steps you have to quit the 
IRC client and server, and restart them.  At that point you should
be able to talk to the EDAS.  

Note that we usually allow one or two minutes for Peter_EDAS_test_2_20.exe
to start up before starting the IRC server and client.


Instructions for retrieving the debug file from the EDAS:

If you like, you can download the file SHARP_HWPR_debug_output.txt.  You 
should do this after you quit Peter_EDAS_test_2_20.exe but before you
restart it.  The file is on the "storage card".  Just click the blue 
download arrow and save as "page source".  Please delete the file after you 
download it, to avoid clogging up the free space on the storage card.

Giles, Peter, and Nicholas have access to a python script that Peter 
wrote which can provide a graphical summary of the info in 
SHARP_HWPR_debug_output.txt.

The error codes generated by Peter have the following meanings:
-1: Error connecting to indexer/motor
-2: Error communicating with encoder
-3: Requested angle not in range 0 -> 360
-4: Final position is outside of angle tolerance
-6: Error in OpenandConfigurePort
-7: Error writing to analog output
-9: Requested move larger than limits

Note that if the EDAS never replies then the angle will be set to -10.