SDK - Querying camera information
Camera Operation details
- SDK Fundamentals
- SDK Deep dive
- Extended features
- CAMAPI usage
- Tools and Software support
- Software release and Update
- Contact Us
If you are writing software to control the camera, a question the software developer is often curious about is "what is the camera state?" From a simple viewpoint, the camera state is just the value of the camera state variable returned by CAMAPI get_camstatus(). A more in-depth description would include the level of what ever is being filled and the status flags (also returned by get_camstatus()). Example status flags include missing storage device, storage full, and genlock no signal. Other values are changing as well, such as the temperature of the image sensor, amount of available storage space, either in the RAM holding frames to be saved or available space on the storage device. With burst capture, the state information gets more complex as you want information on which burst buffer is active.
CAMAPI camera state, status, and information reporting support
There are three APIs support by CAMAPI that return camera state, status, and information.
The CAMAPI get_camstatus() method returns the current camera state information in a dictionary. Refer to http://10.11.12.13/static/host/camconstants.py for enumeration binding. The returned dictionary contains the following entries:
|1 .. 8
|Current camera state:
1 = UNCONFIGURED
|0 .. 100
|Percentage complete for the current state. Has meaning for states RUNNING, TRIGGERED, and SAVING.
0 .. 31
|FPGA internal temperature in degrees Celsius.
|Image sensor internal temperature in degrees Celsius.
|0x00 .. 0xFF
|Internal calibration value. Not intended for customer use.
|Seconds since 1970.
The CAMAPI get_storage_info() method returns the current camera removable storage information in a dictionary with the following entries:
|Number of total storage bytes reported by the file system on the active partition.
|Location where video files and metadata files are stored (unless overridden via the trigger() method base_filename parameter). Useful when accessing the files via the http://10.11.12.13/static URL with the mount point appended.
|Number of bytes reported by the file system on the active partition available to store user data.
replacing 10.11.12.13 with your camera's IP address as necessary.
The CAMAPI get_caminfo() method returns camera information that will not change until the camera is power cycled (and likely won't change then either). The get_caminfo() method returns a dictionary with the following entries:
|Optional, only present if FPGA has been initialized.
Camera Operation details