Home

Documentation

Project Support

Changes in Version 3 of GraspSwControllerCmdExpose

Author:
crae
Timestamp:
Mon Sep 17 08:19:17 2012

Legend:

Unmodified
Added
Removed
Modified

  • GraspSwControllerCmdExpose

    v2 v3
    1 1  '''[wiki:GraspSwControllerCmd expose]''' 
    2 2  [[TracNav(GraspContents)]] 
    3 3  ||Command:||'''expose'''|| 
    4 4  ||Contexts:||Network socket, serial console, stage2 only|| 
    5 5  ||Function:||Take an exposure (integration)|| 
    6 6  ||Required Parameters:||None.|| 
    7 7  ||Optional Parameters:|| || 
    8 8  ||'''nowait'''||Starts a non-blocking exposure. If specified, expose command exits before exposure is complete. Remaining exposure is handled in the background allowing the controller to process other commands during exposure. (>= r5641 stage2 ONLY)|| 
    9    ||'''abort'''||||Aborts any non-blocking exposure currently in progress and closes the shutter. (>= r5641 stage2 ONLY)|| 
      9  ||'''abort'''||Aborts any non-blocking exposure currently in progress and closes the shutter. (>= r5641 stage2 ONLY)|| 
    10 10  === Usage === 
    11 11  This command is used after setting up parameters for an exposure.  The last [wiki:GraspSwControllerCmdEtype etype] and [wiki:GraspSwControllerCmdEtime etime] commands used since the controller booted will apply.  For example, a 45 second DARK exposure (no shutter activation) is performed as follows: 
    12 12  {{{ 
    13 13  etype dark 
    14 14  etime 45000 
    15 15  expose 
    16 16  }}} 
    17 17  This command is typically preceded by [wiki:GraspSwControllerCmdClean clean] and followed by [wiki:GraspSwControllerCmdReadout readout]. 
    18 18  By default, the expose command does not exit until the exposure is complete. This blocks the controller from handling any other commands for the duration of the exposure. 
    19    As of stage 2 r5641, an optional ''nowait'' parameter was added to allow the exposure to be handled in the background without blocking command handling during the exposure. For example, a 30 second OBJECT exposure run in the background would be performed as follows: 
      19  As of stage 2 r5641, an optional '''nowait''' parameter is available to allow the exposure to be handled in the background without blocking command handling during the exposure. For example, a 30 second OBJECT exposure run in the background would be performed as follows: 
    20 20  {{{ 
    21 21  etype object 
    22 22  etime 30000 
    23 23  expose nowait 
    24 24  }}} 
    25 25  The status of the exposure can then be polled with the [wiki:GraspSwControllerCmdExposing exposing] command. 
    26    If an exposure launched in the background needs to be stopped prematurely before the entire etime has elapsed, the ''abort'' option can be specified to cut the exposure short and close the shutter: 
      26  If an exposure launched in the background needs to be stopped prematurely before the entire etime has elapsed, the '''abort''' option can be specified to cut the exposure short and close the shutter: 
    26 26  {{{ 
    27 27  expose abort 
    28 28  }}} 
    29 29  Aborting the exposure will result in an unpredictable exposure time. The actual shutter close time (and thus exposure duration) can be determined with the [wiki:GraspSwControllerCmdExposing exposing] command.