| |
1 |
'''[wiki:GraspSwControllerCmd exposing]''' |
| |
2 |
|
| |
3 |
[[TracNav(GraspContents)]] |
| |
4 |
|
| |
5 |
||Command:||'''exposing'''|| |
| |
6 |
||Contexts:||Network socket, serial console, stage2 only|| |
| |
7 |
||Function:||Polls status of non-blocking exposure|| |
| |
8 |
||Required Parameters:||None.|| |
| |
9 |
|
| |
10 |
=== Usage === |
| |
11 |
|
| |
12 |
If an non-blocking exposure was launched (see the [wiki:GraspSwControllerCmdExpose expose] command), the controller has no means to signal the completion of the exposure back to the user. Instead, the ''exposing'' command may be used to poll the status of the exposure. |
| |
13 |
|
| |
14 |
Like the [wiki:GraspSwControllerCmdVersion version] command, the exposing command returns data on the socket indicating the status of any exposure in progress. The controller can return one of three statuses: |
| |
15 |
|
| |
16 |
* '''not started''': no exposure has been started. |
| |
17 |
* '''exposing''': an exposure has been started in the background and is still in progress. |
| |
18 |
* '''complete''' timestamp1 timestamp2: a backgrounded exposure has completed. The two timestamps are the shutter open and close times respectively. If the controller is synced to an NTP server, then the timestamps will be in real-world time, otherwise they will reflect the controller's uptime at the time the shutter was opened and closed respectively. |
| |
19 |
|
| |
20 |
Note that an aborted exposure (see the [wiki:GraspSwControllerCmdExpose expose] command) will show "complete", and the timestamps will reflect that the exposure was cut short. |
