RETIME:
change the integration time
This page is part of the ING document
INS-DAS-24:
client-server interface for control of cameras
Purpose: change the demanded length of an integration.
Actors: udas_run client; udas_newtime client; udas_camera
server; camera.
Outline: udas_newtime sets a new duration for the current
integration. Server changes the integration, informing the camera if necessary.
Normal course of events:
-
udas_run is doing an integration; q.v. the INTEGRATE action. The
integration is an exposure timed by a shutter under control of camera.
-
udas_newtime invokes the RETIME action on server with these arguments:
-
Argument1 is the demanded duration in seconds.
-
Server detects the change in demanded time within one second.
-
Server tells camera of the new time.
-
Camera acknowleges the new time.
-
Server returns good status for RETIME to udas_newtime.
-
INTEGRATE finishes with good status at the time set in RETIME.
Variations:
-
The demanded time is less than that already integrated. INTEGRATE ends
immediately with good status.
-
No integration is in progress when RETIME is invoked. Server skips
steps 4 and 5.
-
The integration is a dark frame, not an exposure. Server skips steps 4
and 5.
-
The RETIME action fails. Server sends an error message to udas_newtime
and returns one of these stati:
-
the demanded time was negative:
UDAS__BADEXPTIME;
-
the camera rejected the command:
UDAS__CAMCMDFAIL;
-
the camera did not reply:
UDAS__CAMLINKDOWN.