"How To's" for the G0 Target Controls system. ----------------------------------------------- 14-jun-2001 This file is located in /group/gzero/g0targ/how-to-doc.txt and at www.jlab.org/~beise/g0-exp/TargetControls/how-to-doc.txt ------------------------------------------------------------- I. The Controls Screens and MEDM *** To start the system: Preferred is to log in as g0targ on gzerol2.acc.jlab.org If you are not in the test lab, log in as gzero, or log in as yourself to jlabh1.jlab.org. You should be a member of "gzero" group to use this method. (If you aren't, send a request to Steve Wood, saw@jlab.org) Go to /group/gzero/g0targ/bin As "gzero" or "g0targ", you can just type cd $G0TGT Type medm. This will start the medm executable. The primary g0 controls window should open (its /group/gzero/g0targ/screens/g0menu.adl). Then start the system by clicking on the "Execute" button. If the IOC is connected, the heart will be blue and yellow. Screens can be edited by clicking on the "Edit" button. From this primary you can get to all other screens. Click on "menu" to get a short menu of useful screens. *** To reboot the VME crate: You can reboot from either gzerol2 or jlabh1, but at present you can only restore the initial parameters from jlabh1. Sue is working on this issue. Click on the button called "Diagnostics", then on "IOC Save/Restore/Reboot" Click on the drop-down menu to the left of the "Reboot" button, choose a reason for rebooting, then click on the "Reboot" button. The reboot process will take a minute or so. The heartbeat will turn white and stay white until the IOC finishes rebooting, when it will then turn yellow. When it is yellow, go back to the IOC/Save/Restore screen and click on the ! on the left. Choose "Normal Restore". This will restore parameters in the file /group/gzero/g0targ/burt/REBOOT/snapfiles/iocgo1/normal/g0conv.snap (This directory location is also $G0SNAP when you are "gzero" or "g0targ".) You can also reboot the crate by pushing the yellow reset button at the crate. Then be sure to restore the startup parameters following the above procedure. *** To modify the conversion factors for the analog signals: Back at the heartbeat window, go to "Diagnostics", then "Analog Channels". This is a display of the raw analog signals. To see the raw voltage, click on the left button and click on "No conversion". To see the converted values, click on "Linear" conversion. EGUL and EGUF are the "engineering unit" lowest and full-scale values. Consult an expert if you are not sure what values to enter. In general, EGUL = rval(0V), EGUF = rval(maxvolts), where rval is the desired valued in the appropriate units. For all the pressure transducers, "maxvolts" is 5 V. For some of the other signals, "maxvolts" is 10V, so it is useful to check. This can be done by doing the following: cd $G0TGT source g0conv.setup caget .INP where is an EPICS variable name (such as "gvc3" or "gpt2"). The last number in the list is the maximum voltage. *** How to print a screen If you are in the test lab, there are two printers upstairs, called tl210hp (HP laserjet 4MV) tlhpc1 (HP color laserjet) From Linux, the print command is "rlpr -Hprtsrv -P" From jlabh1, its "lp -d" At the moment, it is necessary to put these commands into the print setup for medm. In the control window (the one with the "Edit" and "Execute" buttons), click on "File" --> "Print Setup". Change the print command as desired. In this window you can also set up print to a file if preferred. Then go to the screen for which you want a hardcopy, right click in the screen, then click on "print". -------------------------------------------------- II. The Channel Archiver/Logger (Aamer Rauf) To view the data visit http://gzerol2.acc.jlab.org/~g0targ. LIST: A click on this button shows the list of all the channels (variables) being logged. INFO: Would provide the date and time a particular channel started logging, and the date and time it archived last. PLOT: A click on this button plots up to 100 variables at a time. The time window for these plots can be chosen using 'Start:-End:' 'Day' and 'Time' buttons. The fineness (or coarsness) of the plot can be changed by setting the field value in the 'Interpolate' text entry. For Example, a value of 0 means that all the values in the selected time window are shown whereas a value of 30 shows a plot of data points obtained at 30 seconds intervals. GET: This command gives a 'tabulated' data in 'Date Time Var1 [Var2 ...]' format. Note that time stamps are in h:m:s:ns format.Enabling 'Status' option adds another column indicating how many times a certain value was repeated, when was channel disconnected etc.. Without 'Fill' option the tabulated data for 2 channels, for instance, will look like: Time gpt4 [psi] gpt5 [psi] 6/26/2001 12:00:00.025708381 39.4493 #N/A 6/26/2001 12:00:01.992356443 #N/A 10.5148 6/26/2001 12:00:02.025689461 39.4493 #N/A 6/26/2001 12:00:02.992346983 #N/A 10.4958 6/26/2001 12:00:03.025680001 39.5638 #N/A 6/26/2001 12:00:03.992337523 #N/A 10.2859 whereas with 'Fill' option enabled the data looks like: Time gpt4 [psi] gpt5 [psi] 6/26/2001 12:00:00.025708381 39.4493 #N/A 6/26/2001 12:00:01.992356443 39.4493 10.5148 6/26/2001 12:00:02.025689461 39.4493 10.5148 6/26/2001 12:00:02.992346983 39.4493 10.4958 6/26/2001 12:00:03.025680001 39.5638 10.4958 6/26/2001 12:00:03.992337523 39.5638 10.2859 That is, the previous value of the channel is repeated filling what used to end up as '#N/A' in the original data. ROUND: option rounds the time stamps of multiple channels in the table to within n seconds so that channels sampled at 'almost' the same time appear on the same output line. DEBUG: This command gives information about the CGI script, environment variables etc..