.. _photonicScienceCamera:

*********************
PhotonicScienceCamera
*********************

In addition to expected parameters offered by the `GenicamCamera` class,
`PhotonicScienceCamera` features a few more.

.. _photonicScienceCamera-parameters:

PhotonicScienceCamera expected parameters
=========================================

The main parameters available for the PhotonicScienceCamera are

* `X Offset` [pixel]: the X offset (left offset) for the area of interest.
* `Y Offset` [pixel]: the Y offset (top offset) for the area of interest.
* `X Binning` [pixel]: the number of horizontal photo-sensitive cells that
  must be combined (added) together.
* `Y Binning` [pixel]: the number of vertical photo-sensitive cells that
  must be combined (added) together.
* `Raw Exposure Time`: the exposure time in device-specific unit.
* `Trigger Mode`: trigger mode selector, e.g. "freerun",
  "Hardware_rising_edge".
* `Pixel Format`: the format of the pixel to use during the acquisition, e.g.
  "Mono8", "Mono16".
* `Sensor Width` [pixel], read-only: the effective width of the sensor.
* `Sensor Height` [pixel], read-only: the effective height of the sensor.
* `Max Width` [pixel], read-only: maximum width of the image after binning,
  decimation or any other function changing the horizontal dimensions.
* `Max Height` [pixel], read-only: maximum height of the image after binning,
  decimation or any other function changing the vertical dimensions.

More expert-level parameters are available, and should normally not differ
from the default set on the device class.


.. _photonicScienceCamera-troubleshooting:

Troubleshooting
===============

The camera goes regularly to UNKNOWN state
------------------------------------------

A known issue for Photonic Science cameras connected to the XFEL network,
is that at regular time every day (ca 9 AM, 12 PM, 15 PM, ...) they
loose network connection. The reason could not be understood yet. The only
know way to recover is by a camera power cycle (see the general
:ref:`genicamCameras-troubleshooting` Section too).

When possible, it should considered the option of connection the camera
to the control server directly, or via a switch, but without connecting it
the the XFEL network. This configuration has proven to be unaffected by the
disconnection issue.