Permalink
Branch: master
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
149 lines (125 sloc) 6.28 KB

Gphoto2 CCD driver

https://github.com/gphoto/libgphoto2

Supported devices

Cameras supported by libgphoto2

Supported platforms

This driver depends on 3rd party library and is supported on Linux (Intel 32/64 bit and ARM v6/7/8).

License

INDIGO Astronomy open-source license (libgphoto2 is released under LGPL-2.1).

Use

indigo_server indigo_ccd_gphoto2

Functionality and issues

Camera detection and support

The driver indigo_ccd_gphoto2 uses the camera detection method from libgphoto2. If the camera is not detected, then the used libgphoto2 version is perhaps outdated or the camera is currently not supported by libgphoto2. This can be verified with gphoto2 and the following commands:

>gphoto2 --version

and

>gphoto2 --auto-detect

Please visit the website libgphoto2 and check for the up-to-date version or in case the camera is not supported by the latest version, please file an issue.

Manual mode and focus

Make sure the camera is in "M" mode, such that both aperture and shutterspeed can be controlled by the driver. In addition make sure manual focus is enabled and not auto focus. The indigo_ccd_gphoto2 driver is developed for the domain of amateur astronomy, therefore any auto settings limit the functionality of the driver.

Shutterspeed and bulb setting

Most cameras are operated either in shutterspeed setting or bulb setting. In shutterspeed setting, typical predefined exposure value are: 1/4000, 1/3200, 1/2500, ..., 1/5, 1/4, 0.3, 0.4, ..., 20, 25, 30 seconds. If the camera is in shutterspeed setting, then an exposure value closest to the predefined values is selected. For instance, if an exposure value of 24 seconds is chosen, then the predefined value of 25 seconds is selected by the indigo_ccd_gphoto2 driver. In bulb setting, any non-negative exposure value can be chosen, for instance exactly 24 seconds or 180 seconds. If highly precise exposure values below 1 seconds are required it is advised to operate in the shutterspeed setting, otherwise in bulb setting. Note, if exposure time is set to 0 seconds and camera is in non-bulb, then current shutterspeed value is used. For example, the current shutterspeed value is set to 5 seconds and the exposure time is set to 0 seconds. The camera exposures for 5 seconds although an exposure time of 0 seconds was specified. In other words, triggering an exposure of 0 seconds actually, triggers an exposure of current shutterspeed value.

Mirror lockup

Fast-flipping mirror can cause vibrations of the camera and the mount. Mirror lockup makes the mirror flip up for a couple of seconds before the shutter is activated to avoid this problem. Currently mirror lockup works only for EOS cameras which support the "Custom Functions Ex" functionality, namely the command to enable mirror lockup: "20,1,3,14,1,60f,1,1", and the command to disable mirror lockup: "20,1,3,14,1,60f,1,0". For testing whether your camera supports this functionality, connect your camera in INDIGO with the indigo_ccd_gphoto2 driver and try to enable enable mirror lockup. If the mirror lockup light turns green, then mirror lockup functionality works for your camera. Alternatively, test the following commands with gphoto2 for enabling mirror lockup:

>gphoto2 --set-config customfuncex=20,1,3,14,1,60f,1,1

and for disabling mirror lockup:

>gphoto2 --set-config customfuncex=20,1,3,14,1,60f,1,0

FITS format and debayering

FITS conversion and debayering is performed with library LibRaw. The debayering options are currently fixed and set as follows:

  • Disable LibRaw's default histogram transformation.
  • Disable LibRaw's default gamma curve transformation.
  • Disable automatic white balance obtained after averaging over the entire image.
  • Disable white balance from the camera (if possible).
  • No embedded color profile application.

For debayering one can choose between algorithms:

  • None
  • None (2x2 binning mono)
  • Linear interpolation,
  • VNG,
  • PPG,
  • AHD,
  • DCB,
  • DHT.

The default algorithm is 'None', that is, the data is delivered in raw format, e.g. RGGBRGGB...RGGB according to a bayer pattern inferred by LibRaw. It is thus the client side which has to debayer the data. To help the client side inferring the appropriate bayer pattern, it is embedded as a FIT keyword of the form, e.g.

BAYERPAT= 'RGGB' / Bayer color pattern

The choice 'None (2x2 binning mono)' creates a FIT file of dimension width/2 x height/2 where each pixel is a superpixel of the form (R + G + G + B)/4. The data is thus 2x2 binned and monocolor. This choice is useful for focusing, aligment and other routines where FIT data has to be efficiently transported to a client in short intervals. Note that 2x2 binning reduces the data size by a factor of 4 and at the same time doubles the SNR. On course the data can also be debayered by the driver, where the prefered debayering algorithm is VNG which computationally intensive however very good. Linear interpolation is a very basic interpolation but it is faster compared to VNG. This debayered FIT output is currently 3 colors (RGB) each 16-bit and has the following FIT keyword embedded

CTYPE3= 'rgb' / Coordinate axis red=1, green=2, blue=3

Image format FITS/RAW/JPEG

Setting the INDIGO image format to FITS, RAW or JPEG requires a corresponding format on the DSLR camera (also called compression format). Typical compression formats for Canon EOS are:

  • Large Fine JPEG
  • Large Normal JPEG
  • Medium Fine JPEG
  • Medium Normal JPEG
  • Small Fine JPEG
  • Small Normal JPEG
  • Smaller JPEG
  • Tiny JPEG
  • RAW + Large Fine JPEG
  • RAW

or for Nikon:

  • JPEG Basic
  • JPEG Normal
  • JPEG Fine
  • NEF (Raw)
  • NEF+Basic
  • NEF+Normal
  • NEF+Fine

Setting INDIGO image format to FITS or RAW sets the compression format on the DSLR camera to 'RAW' for Canon EOS and 'NEF (Raw)' or 'NEF+Basic' for Nikon cameras. Setting INDIGO image format to JPEG sets the compression format to 'Large Fine JPEG', 'JPEG Fine' respectively.

Status: Stable

Driver is developed and tested with:

  • Nikon D50 (USB)
  • Nikon D7000 (USB)
  • Canon EOS 600D (USB)
  • Canon EOS 700D (USB)
  • Canon EOS 1100D (USB)

Issues:

Bulb exposures currently work only with EOS cameras.