Commands to be implemented in TCS

Here follows a few notes about commands required for First Light AO.

Other commands have been defined in the AOS interface documentation, but they will be implemented as need arises.

Relevant Documents

Note: for your convenience a copy of the document is attached and available with direct links. You should, anyway, check for possible new versions in the CAN archive.

• AO Supervisor Functional Description. (CAN 486f009)

StartObs

This command has to be issued at the beginning of operations. Its only purposeis to be sure that the AOS is running and has connection with the AO Supervisor.

It will return an error if the AO system is not ready to go.

This should be sent by the procedure or subsystem which sets up the telescope for operation requiring, at least, the adaptive secondary up and running.

PresetFlat

This command must be issued by any instrument who needs the adaptive secondary in seeing limited mode. The commands provides the capability to select a specific mirror shape. With no specification the "default" shape is selected.

It should be issued by the procedure executed when the instrument sends an IIF "PresetTelescope" command

PresetAO

This command must be issued by an instrument which needs full AO. Arguments must be specified which refer to coordinates (Doug Miller is the reference person on this point)

Again from the procedure corresponding to PresetTelescope()

AcquireRefAO

This command must be issued after presetAO

Note: AcquireRefAO must be issued with the telescope tracking (and guiding ?) on target. Whoever is sending this command to AOS must check this condition before issuing the command. If the condition is true from the beginning, PresetAO and AcquireRefAO can be issued just one after the other.

Again from the procedure corresponding to PresetTelescope()

CheckRefAO

The command does all the steps required to acquire the reference star, without actually moving the WFS stages and returns the ammount of offsset needed to put the reference star in the top of the pyramid.

Those values can be used to offset the telescope so that the reference star is in the right position (as opposed to moving the WFS stages).

A following AcquireRefAO command will perform star acquisition without moving the stages because the star is altready in the right spot.

StartAO

The final step of the procedure corresponding to PresetTelescope(). It is intended to be sent when the instrument is ready to start the observation. When this command returns OK, the loop is closed and the telescope is diffraction limited.

Pause, Resume

These have specific IIF calls

Stop

If there is something like a "Deauthorize()" call in IIF, this should call Stop.

Terminate

Issued by any procedure which shuts down the telescope

OffsetXY

This should correspond to the IIF call OffsetPointing()

OffsetZ

This should correspond to IIF MoveFocus()