libcamera  v0.0.0
Supporting cameras in Linux since 2019
raspberrypi.h
1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
2 /*
3  * Copyright (C) 2019-2020, Raspberry Pi Ltd.
4  *
5  * raspberrypi.h - Image Processing Algorithm interface for Raspberry Pi
6  */
7 #ifndef __LIBCAMERA_IPA_INTERFACE_RASPBERRYPI_H__
8 #define __LIBCAMERA_IPA_INTERFACE_RASPBERRYPI_H__
9 
10 #include <libcamera/control_ids.h>
11 #include <libcamera/controls.h>
12 
13 enum RPiOperations {
14  RPI_IPA_ACTION_V4L2_SET_STAGGERED = 1,
15  RPI_IPA_ACTION_V4L2_SET_ISP,
16  RPI_IPA_ACTION_STATS_METADATA_COMPLETE,
17  RPI_IPA_ACTION_RUN_ISP,
18  RPI_IPA_ACTION_RUN_ISP_AND_DROP_FRAME,
19  RPI_IPA_ACTION_SET_SENSOR_CONFIG,
20  RPI_IPA_ACTION_EMBEDDED_COMPLETE,
21  RPI_IPA_EVENT_SIGNAL_STAT_READY,
22  RPI_IPA_EVENT_SIGNAL_ISP_PREPARE,
23  RPI_IPA_EVENT_QUEUE_REQUEST,
24  RPI_IPA_EVENT_LS_TABLE_ALLOCATION,
25 };
26 
27 enum RPiIpaMask {
28  ID = 0x0ffff,
29  STATS = 0x10000,
30  EMBEDDED_DATA = 0x20000,
31  BAYER_DATA = 0x40000
32 };
33 
34 /* Size of the LS grid allocation. */
35 #define MAX_LS_GRID_SIZE (32 << 10)
36 
37 namespace libcamera {
38 
39 /* List of controls handled by the Raspberry Pi IPA */
40 static const ControlInfoMap RPiControls = {
41  { &controls::AeEnable, ControlInfo(false, true) },
42  { &controls::ExposureTime, ControlInfo(0, 999999) },
43  { &controls::AnalogueGain, ControlInfo(1.0f, 32.0f) },
44  { &controls::AeMeteringMode, ControlInfo(0, static_cast<int32_t>(controls::MeteringModeMax)) },
45  { &controls::AeConstraintMode, ControlInfo(0, static_cast<int32_t>(controls::ConstraintModeMax)) },
46  { &controls::AeExposureMode, ControlInfo(0, static_cast<int32_t>(controls::ExposureModeMax)) },
47  { &controls::ExposureValue, ControlInfo(0.0f, 16.0f) },
48  { &controls::AwbEnable, ControlInfo(false, true) },
49  { &controls::ColourGains, ControlInfo(0.0f, 32.0f) },
50  { &controls::AwbMode, ControlInfo(0, static_cast<int32_t>(controls::AwbModeMax)) },
51  { &controls::Brightness, ControlInfo(-1.0f, 1.0f) },
52  { &controls::Contrast, ControlInfo(0.0f, 32.0f) },
53  { &controls::Saturation, ControlInfo(0.0f, 32.0f) },
54  { &controls::Sharpness, ControlInfo(0.0f, 16.0f, 1.0f) },
55 };
56 
57 } /* namespace libcamera */
58 
59 #endif /* __LIBCAMERA_IPA_INTERFACE_RASPBERRYPI_H__ */
Camera control identifiers.
Framework to manage controls related to an object.
const Control< float > Brightness
Specify a fixed brightness parameter. Positive values (up to 1.0) produce brighter images; negative v...
@ ConstraintModeMax
Maximum allowed value (place any new values above here).
Definition: control_ids.h:57
const Control< int32_t > AeExposureMode
Specify an exposure mode for the AE algorithm to use. These specify how the desired total exposure is...
const Control< int32_t > AwbMode
Specify the range of illuminants to use for the AWB algorithm. The modes supported are platform speci...
const Control< bool > AwbEnable
Enable or disable the AWB.
const Control< int32_t > ExposureTime
Exposure time (shutter speed) for the frame applied in the sensor device. This value is specified in ...
@ MeteringModeMax
Maximum allowed value (place any new values above here).
Definition: control_ids.h:49
@ ExposureModeMax
Maximum allowed value (place any new values above here).
Definition: control_ids.h:65
const Control< float > Contrast
Specify a fixed contrast parameter. Normal contrast is given by the value 1.0; larger values produce ...
const Control< float > ExposureValue
Specify an Exposure Value (EV) parameter. The EV parameter will only be applied if the AE algorithm i...
const Control< bool > AeEnable
Enable or disable the AE.
const Control< float > Saturation
Specify a fixed saturation parameter. Normal saturation is given by the value 1.0; larger values prod...
const Control< int32_t > AeMeteringMode
Specify a metering mode for the AE algorithm to use. The metering modes determine which parts of the ...
@ AwbModeMax
Maximum allowed value (place any new values above here).
Definition: control_ids.h:84
const Control< float > AnalogueGain
Analogue gain value applied in the sensor device. The value of the control specifies the gain multipl...
const Control< Span< const float > > ColourGains
Pair of gain values for the Red and Blue colour channels, in that order. ColourGains can only be appl...
const Control< float > Sharpness
A value of 0.0 means no sharpening. The minimum value means minimal sharpening, and shall be 0....
const Control< int32_t > AeConstraintMode
Specify a constraint mode for the AE algorithm to use. These determine how the measured scene brightn...