Created: Mon Apr 12 16:00:21 PDT 2004 Last Revised: Fri Aug 18 18:32:30 PDT 2006 Palomar LGS Adaptive Optics System User's Guide Version 3.0 1. General AO Command Syntax The general syntax for an LGS AO command consists of a command name followed by zero or more {NAME, value} pairs separated by commas (or spaces) as follows: CMD_NAME {PARAM = } 1.1 Command Summary The following is a summary of the LGS AO command set. The detailed description and syntax for each command are provided in subsequent sections. DM TTM , RATE = LLT , RATE = WFS_CAM , ID = , RATE = , BIAS = , GAIN = , DELAY = , INT_TIME = WHITE_LIGHT , PWR = LGS_WHITE_LIGHT VIDEO CAM = , INT_TIME = , INTERVAL = GET_FRINGE_MAP LOG WFP = , DATA = , INTERVAL = LOAD WFP = , = OPEN {STIM_SHUTTER | SCI_CAM_SHUTTER} CLOSE {STIM_SHUTTER | SCI_CAM_SHUTTER} MOVE OFFSET { | } REQPOS SET = SAVE RESTORE RESET {SYSTEM | } STOP {SYSTEM | } SHUTDOWN TCS BTO 2. DM Control Command Syntax: DM {ON | OFF} 3. Tip-Tilt Control Command Syntax: TTM {ON | OFF}, RATE = {1 .. 2000} LLT {ON | OFF}, RATE = {1 .. 2000} 4. WFS Camera Control Command Syntax: WFS_CAM {ON | OFF}, ID = {HO | LO}, RATE = , BIAS = , GAIN = , DELAY = , INT_TIME = where: = {30 | 50 | 100 | 150 | 200 | 250 | 300 .. 1000 | 1250 | 1500 | 1750 | 2000} Hz = {0 .. 1023} = {0 .. 3} = delay time in usec 5. White Light Control Command Syntax: WHITE_LIGHT {ON | OFF}, PWR = {0.0 .. 100} LGS_WHITE_LIGHT {ON | OFF} 6. Video Control Command Syntax: VIDEO CAM = {ACQ | ALIGNMENT | STIMULUS | OFF}, INT_TIME = , INTERVAL = where: = {100 .. 10**7} usec = {1 .. 30} (The max image display rate currently is limited to 5 fps.) 7. Get Fringe Map Command Syntax: GET_FRINGE_MAP 8. LOG Command Syntax: LOG WFP = , DATA = , INTERVAL = where: = {HO | LO} = {(PIXELS, CENTROIDS, SUBAP_FLUX, DM_POSITIONS, DM_RESIDUALS, TTM_POSITIONS, LO_RESIDUALS, WFP_STATUS) | NONE | ALL} = {1 .. 500} -- Number of WFS camera frames per log sample (max is 400Hz) Examples: LOG WFP = HO, DATA = (CENTROIDS, SUBAP_FLUX), INTERVAL = 10 LOG WFP = LO, DATA = ALL LOG WFP = LO, INTERVAL = 1 9. LOAD Command Syntax: LOAD WFP = ,
= where: = {HO | LO}
= {PIXEL_OFFSETS | PIXEL_GAINS | CENT_OFFSETS | RECONSTRUCTOR | ACTUATOR_MAP | DM_CALIB_POS} 10. SET Command Syntax: SET = system_parameter value ---------------- ----- STIM_FW {CLOSED | PUPIL | STAR | OPEN} ALIGN_FW {CLOSED | PUPIL | STAR | OPEN} DM_PROP_GAIN {0.0 .. MAX_FLT} DM_INTEGRAL_GAIN {0.0 .. MAX_FLT} TTM_PROP_GAIN {0.0 .. MAX_FLT} TTM_INTEGRAL_GAIN {0.0 .. MAX_FLT} LLT_PROP_GAIN {0.0 .. MAX_FLT} LLT_INTEGRAL_GAIN {0.0 .. MAX_FLT} AVG_DM_POS {0.0 .. 4096} HO_MIN_SUBAP_FLUX LO_MIN_SUBAP_FLUX 11. OPEN and CLOSE Commands Syntax: OPEN {STIM_SHUTTER | SCI_CAM_SHUTTER} CLOSE {STIM_SHUTTER | SCI_CAM_SHUTTER} 12. Motor Move Command Syntax: MOVE OFFSET { | } where: is one of the following motor names: ACQ_Z Acquisition camera focus FQ_RELAY FQPM relay FQ_STIM FQPM stimulus LLT_A LLT_B Laser launch telescope x,y LOWFS_X LOWFS_Y Low order WFS x,y SPM_X Stimulus package mirror SSM1_A SSM1_B Science steering mirror 1 x,y SSM2_A SSM2_B Science steering mirror 2 x,y SPSM_X1 SPSM_X2 SPSM_X3 Interferometer PZT drive A,B,C TTM_A TTM_B Tip/tilt mirror x,y WFS_Z High order WFS focus WHITE_X White light x WHITE_Z White light focus = {IMAGE_X | IMAGE_Y | PUPIL_X | PUPIL_Y | SPSM_X} 13. Motor Position Request Command Syntax: REQPOS 14. System/Motor Reset Command Reset system or motor to default state. Syntax: RESET {SYSTEM | } 15. Stop Command Syntax: STOP {SYSTEM | } 16. System Shutdown Command Save the state of the AO system and shutdown hardware. Syntax: SHUTDOWN 17. TCS Pass-through Command TCS control commands are passed through as is to the TCS as . Syntax: TCS 18. BTO Pass-through Command BTO control commands are passed through as is to the BTO as . Syntax: BTO