Home | History | Annotate | Download | only in common
      1 /* Copyright (c) 2012-2013, The Linux Foundation. All rights reserved.
      2  *
      3  * Redistribution and use in source and binary forms, with or without
      4  * modification, are permitted provided that the following conditions are
      5  * met:
      6  *     * Redistributions of source code must retain the above copyright
      7  *       notice, this list of conditions and the following disclaimer.
      8  *     * Redistributions in binary form must reproduce the above
      9  *       copyright notice, this list of conditions and the following
     10  *       disclaimer in the documentation and/or other materials provided
     11  *       with the distribution.
     12  *     * Neither the name of The Linux Foundation nor the names of its
     13  *       contributors may be used to endorse or promote products derived
     14  *       from this software without specific prior written permission.
     15  *
     16  * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED
     17  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
     18  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT
     19  * ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
     20  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     21  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     22  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
     23  * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
     24  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
     25  * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
     26  * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     27  *
     28  */
     29 
     30 #ifndef __QCAMERA_TYPES_H__
     31 #define __QCAMERA_TYPES_H__
     32 
     33 #include <stdint.h>
     34 #include <pthread.h>
     35 #include <inttypes.h>
     36 #include <media/msmb_camera.h>
     37 
     38 #define CAM_MAX_NUM_BUFS_PER_STREAM 24
     39 #define MAX_METADATA_PAYLOAD_SIZE 1024
     40 
     41 #define CEILING32(X) (((X) + 0x0001F) & 0xFFFFFFE0)
     42 #define CEILING16(X) (((X) + 0x000F) & 0xFFF0)
     43 #define CEILING4(X)  (((X) + 0x0003) & 0xFFFC)
     44 #define CEILING2(X)  (((X) + 0x0001) & 0xFFFE)
     45 
     46 #define MAX_ZOOMS_CNT 64
     47 #define MAX_SIZES_CNT 24
     48 #define MAX_EXP_BRACKETING_LENGTH 32
     49 #define MAX_ROI 5
     50 #define MAX_STREAM_NUM_IN_BUNDLE 4
     51 #define MAX_NUM_STREAMS          8
     52 
     53 typedef enum {
     54     CAM_HAL_V1 = 1,
     55     CAM_HAL_V3 = 3
     56 } cam_hal_version_t;
     57 
     58 typedef enum {
     59     CAM_STATUS_SUCCESS,       /* Operation Succeded */
     60     CAM_STATUS_FAILED,        /* Failure in doing operation */
     61     CAM_STATUS_INVALID_PARM,  /* Inavlid parameter provided */
     62     CAM_STATUS_NOT_SUPPORTED, /* Parameter/operation not supported */
     63     CAM_STATUS_ACCEPTED,      /* Parameter accepted */
     64     CAM_STATUS_MAX,
     65 } cam_status_t;
     66 
     67 typedef enum {
     68     CAM_POSITION_BACK,
     69     CAM_POSITION_FRONT
     70 } cam_position_t;
     71 
     72 typedef enum {
     73     CAM_FLICKER_NONE,
     74     CAM_FLICKER_50_HZ,
     75     CAM_FLICKER_60_HZ
     76 } cam_flicker_t;
     77 
     78 typedef enum {
     79     CAM_FORMAT_JPEG = 0,
     80     CAM_FORMAT_YUV_420_NV12 = 1,
     81     CAM_FORMAT_YUV_420_NV21,
     82     CAM_FORMAT_YUV_420_NV21_ADRENO,
     83     CAM_FORMAT_YUV_420_YV12,
     84     CAM_FORMAT_YUV_422_NV16,
     85     CAM_FORMAT_YUV_422_NV61,
     86     CAM_FORMAT_YUV_420_NV12_VENUS,
     87 
     88     /* Please note below are the defintions for raw image.
     89      * Any format other than raw image format should be declared
     90      * before this line!!!!!!!!!!!!! */
     91 
     92     /* Note: For all raw formats, each scanline needs to be 16 bytes aligned */
     93 
     94     /* Packed YUV/YVU raw format, 16 bpp: 8 bits Y and 8 bits UV.
     95      * U and V are interleaved with Y: YUYV or YVYV */
     96     CAM_FORMAT_YUV_RAW_8BIT_YUYV,
     97     CAM_FORMAT_YUV_RAW_8BIT_YVYU,
     98     CAM_FORMAT_YUV_RAW_8BIT_UYVY,
     99     CAM_FORMAT_YUV_RAW_8BIT_VYUY,
    100 
    101     /* QCOM RAW formats where data is packed into 64bit word.
    102      * 8BPP: 1 64-bit word contains 8 pixels p0 - p7, where p0 is
    103      *       stored at LSB.
    104      * 10BPP: 1 64-bit word contains 6 pixels p0 - p5, where most
    105      *       significant 4 bits are set to 0. P0 is stored at LSB.
    106      * 12BPP: 1 64-bit word contains 5 pixels p0 - p4, where most
    107      *       significant 4 bits are set to 0. P0 is stored at LSB. */
    108     CAM_FORMAT_BAYER_QCOM_RAW_8BPP_GBRG,
    109     CAM_FORMAT_BAYER_QCOM_RAW_8BPP_GRBG,
    110     CAM_FORMAT_BAYER_QCOM_RAW_8BPP_RGGB,
    111     CAM_FORMAT_BAYER_QCOM_RAW_8BPP_BGGR,
    112     CAM_FORMAT_BAYER_QCOM_RAW_10BPP_GBRG,
    113     CAM_FORMAT_BAYER_QCOM_RAW_10BPP_GRBG,
    114     CAM_FORMAT_BAYER_QCOM_RAW_10BPP_RGGB,
    115     CAM_FORMAT_BAYER_QCOM_RAW_10BPP_BGGR,
    116     CAM_FORMAT_BAYER_QCOM_RAW_12BPP_GBRG,
    117     CAM_FORMAT_BAYER_QCOM_RAW_12BPP_GRBG,
    118     CAM_FORMAT_BAYER_QCOM_RAW_12BPP_RGGB,
    119     CAM_FORMAT_BAYER_QCOM_RAW_12BPP_BGGR,
    120     /* MIPI RAW formats based on MIPI CSI-2 specifiction.
    121      * 8BPP: Each pixel occupies one bytes, starting at LSB.
    122      *       Output with of image has no restrictons.
    123      * 10BPP: Four pixels are held in every 5 bytes. The output
    124      *       with of image must be a multiple of 4 pixels.
    125      * 12BPP: Two pixels are held in every 3 bytes. The output
    126      *       width of image must be a multiple of 2 pixels. */
    127     CAM_FORMAT_BAYER_MIPI_RAW_8BPP_GBRG,
    128     CAM_FORMAT_BAYER_MIPI_RAW_8BPP_GRBG,
    129     CAM_FORMAT_BAYER_MIPI_RAW_8BPP_RGGB,
    130     CAM_FORMAT_BAYER_MIPI_RAW_8BPP_BGGR,
    131     CAM_FORMAT_BAYER_MIPI_RAW_10BPP_GBRG,
    132     CAM_FORMAT_BAYER_MIPI_RAW_10BPP_GRBG,
    133     CAM_FORMAT_BAYER_MIPI_RAW_10BPP_RGGB,
    134     CAM_FORMAT_BAYER_MIPI_RAW_10BPP_BGGR,
    135     CAM_FORMAT_BAYER_MIPI_RAW_12BPP_GBRG,
    136     CAM_FORMAT_BAYER_MIPI_RAW_12BPP_GRBG,
    137     CAM_FORMAT_BAYER_MIPI_RAW_12BPP_RGGB,
    138     CAM_FORMAT_BAYER_MIPI_RAW_12BPP_BGGR,
    139     /* Ideal raw formats where image data has gone through black
    140      * correction, lens rolloff, demux/channel gain, bad pixel
    141      * correction, and ABF.
    142      * Ideal raw formats could output any of QCOM_RAW and MIPI_RAW
    143      * formats, plus plain8 8bbp, plain16 800, plain16 10bpp, and
    144      * plain 16 12bpp */
    145     CAM_FORMAT_BAYER_IDEAL_RAW_QCOM_8BPP_GBRG,
    146     CAM_FORMAT_BAYER_IDEAL_RAW_QCOM_8BPP_GRBG,
    147     CAM_FORMAT_BAYER_IDEAL_RAW_QCOM_8BPP_RGGB,
    148     CAM_FORMAT_BAYER_IDEAL_RAW_QCOM_8BPP_BGGR,
    149     CAM_FORMAT_BAYER_IDEAL_RAW_QCOM_10BPP_GBRG,
    150     CAM_FORMAT_BAYER_IDEAL_RAW_QCOM_10BPP_GRBG,
    151     CAM_FORMAT_BAYER_IDEAL_RAW_QCOM_10BPP_RGGB,
    152     CAM_FORMAT_BAYER_IDEAL_RAW_QCOM_10BPP_BGGR,
    153     CAM_FORMAT_BAYER_IDEAL_RAW_QCOM_12BPP_GBRG,
    154     CAM_FORMAT_BAYER_IDEAL_RAW_QCOM_12BPP_GRBG,
    155     CAM_FORMAT_BAYER_IDEAL_RAW_QCOM_12BPP_RGGB,
    156     CAM_FORMAT_BAYER_IDEAL_RAW_QCOM_12BPP_BGGR,
    157     CAM_FORMAT_BAYER_IDEAL_RAW_MIPI_8BPP_GBRG,
    158     CAM_FORMAT_BAYER_IDEAL_RAW_MIPI_8BPP_GRBG,
    159     CAM_FORMAT_BAYER_IDEAL_RAW_MIPI_8BPP_RGGB,
    160     CAM_FORMAT_BAYER_IDEAL_RAW_MIPI_8BPP_BGGR,
    161     CAM_FORMAT_BAYER_IDEAL_RAW_MIPI_10BPP_GBRG,
    162     CAM_FORMAT_BAYER_IDEAL_RAW_MIPI_10BPP_GRBG,
    163     CAM_FORMAT_BAYER_IDEAL_RAW_MIPI_10BPP_RGGB,
    164     CAM_FORMAT_BAYER_IDEAL_RAW_MIPI_10BPP_BGGR,
    165     CAM_FORMAT_BAYER_IDEAL_RAW_MIPI_12BPP_GBRG,
    166     CAM_FORMAT_BAYER_IDEAL_RAW_MIPI_12BPP_GRBG,
    167     CAM_FORMAT_BAYER_IDEAL_RAW_MIPI_12BPP_RGGB,
    168     CAM_FORMAT_BAYER_IDEAL_RAW_MIPI_12BPP_BGGR,
    169     CAM_FORMAT_BAYER_IDEAL_RAW_PLAIN8_8BPP_GBRG,
    170     CAM_FORMAT_BAYER_IDEAL_RAW_PLAIN8_8BPP_GRBG,
    171     CAM_FORMAT_BAYER_IDEAL_RAW_PLAIN8_8BPP_RGGB,
    172     CAM_FORMAT_BAYER_IDEAL_RAW_PLAIN8_8BPP_BGGR,
    173     CAM_FORMAT_BAYER_IDEAL_RAW_PLAIN16_8BPP_GBRG,
    174     CAM_FORMAT_BAYER_IDEAL_RAW_PLAIN16_8BPP_GRBG,
    175     CAM_FORMAT_BAYER_IDEAL_RAW_PLAIN16_8BPP_RGGB,
    176     CAM_FORMAT_BAYER_IDEAL_RAW_PLAIN16_8BPP_BGGR,
    177     CAM_FORMAT_BAYER_IDEAL_RAW_PLAIN16_10BPP_GBRG,
    178     CAM_FORMAT_BAYER_IDEAL_RAW_PLAIN16_10BPP_GRBG,
    179     CAM_FORMAT_BAYER_IDEAL_RAW_PLAIN16_10BPP_RGGB,
    180     CAM_FORMAT_BAYER_IDEAL_RAW_PLAIN16_10BPP_BGGR,
    181     CAM_FORMAT_BAYER_IDEAL_RAW_PLAIN16_12BPP_GBRG,
    182     CAM_FORMAT_BAYER_IDEAL_RAW_PLAIN16_12BPP_GRBG,
    183     CAM_FORMAT_BAYER_IDEAL_RAW_PLAIN16_12BPP_RGGB,
    184     CAM_FORMAT_BAYER_IDEAL_RAW_PLAIN16_12BPP_BGGR,
    185 
    186     /* generic 8-bit raw */
    187     CAM_FORMAT_JPEG_RAW_8BIT,
    188     CAM_FORMAT_META_RAW_8BIT,
    189 
    190     CAM_FORMAT_MAX
    191 } cam_format_t;
    192 
    193 typedef enum {
    194     /* applies to HAL 1 */
    195     CAM_STREAM_TYPE_DEFAULT,       /* default stream type */
    196     CAM_STREAM_TYPE_PREVIEW,       /* preview */
    197     CAM_STREAM_TYPE_POSTVIEW,      /* postview */
    198     CAM_STREAM_TYPE_SNAPSHOT,      /* snapshot */
    199     CAM_STREAM_TYPE_VIDEO,         /* video */
    200 
    201     /* applies to HAL 3 */
    202     CAM_STREAM_TYPE_CALLBACK,      /* app requested callback */
    203     CAM_STREAM_TYPE_NON_ZSL_SNAPSHOT, /* non zsl snapshot */
    204     CAM_STREAM_TYPE_IMPL_DEFINED, /* opaque format: could be display, video enc, ZSL YUV */
    205 
    206     /* applies to both HAL 1 and HAL 3 */
    207     CAM_STREAM_TYPE_METADATA,      /* meta data */
    208     CAM_STREAM_TYPE_RAW,           /* raw dump from camif */
    209     CAM_STREAM_TYPE_OFFLINE_PROC,  /* offline process */
    210     CAM_STREAM_TYPE_MAX,
    211 } cam_stream_type_t;
    212 
    213 typedef enum {
    214     CAM_PAD_NONE = 1,
    215     CAM_PAD_TO_2 = 2,
    216     CAM_PAD_TO_4 = 4,
    217     CAM_PAD_TO_WORD = CAM_PAD_TO_4,
    218     CAM_PAD_TO_8 = 8,
    219     CAM_PAD_TO_16 = 16,
    220     CAM_PAD_TO_32 = 32,
    221     CAM_PAD_TO_64 = 64,
    222     CAM_PAD_TO_1K = 1024,
    223     CAM_PAD_TO_2K = 2048,
    224     CAM_PAD_TO_4K = 4096,
    225     CAM_PAD_TO_8K = 8192
    226 } cam_pad_format_t;
    227 
    228 typedef enum {
    229     /* followings are per camera */
    230     CAM_MAPPING_BUF_TYPE_CAPABILITY,  /* mapping camera capability buffer */
    231     CAM_MAPPING_BUF_TYPE_PARM_BUF,    /* mapping parameters buffer */
    232 
    233     /* followings are per stream */
    234     CAM_MAPPING_BUF_TYPE_STREAM_BUF,        /* mapping stream buffers */
    235     CAM_MAPPING_BUF_TYPE_STREAM_INFO,       /* mapping stream information buffer */
    236     CAM_MAPPING_BUF_TYPE_OFFLINE_INPUT_BUF, /* mapping offline process input buffer */
    237     CAM_MAPPING_BUF_TYPE_MAX
    238 } cam_mapping_buf_type;
    239 
    240 typedef struct {
    241     cam_mapping_buf_type type;
    242     uint32_t stream_id;   /* stream id: valid if STREAM_BUF */
    243     uint32_t frame_idx;   /* frame index: valid if type is STREAM_BUF */
    244     int32_t plane_idx;    /* planner index. valid if type is STREAM_BUF.
    245                            * -1 means all planners shanre the same fd;
    246                            * otherwise, each planner has its own fd */
    247     unsigned long cookie; /* could be job_id(uint32_t) to identify mapping job */
    248     int fd;               /* origin fd */
    249     uint32_t size;        /* size of the buffer */
    250 } cam_buf_map_type;
    251 
    252 typedef struct {
    253     cam_mapping_buf_type type;
    254     uint32_t stream_id;   /* stream id: valid if STREAM_BUF */
    255     uint32_t frame_idx;   /* frame index: valid if STREAM_BUF or HIST_BUF */
    256     int32_t plane_idx;    /* planner index. valid if type is STREAM_BUF.
    257                            * -1 means all planners shanre the same fd;
    258                            * otherwise, each planner has its own fd */
    259     unsigned long cookie; /* could be job_id(uint32_t) to identify unmapping job */
    260 } cam_buf_unmap_type;
    261 
    262 typedef enum {
    263     CAM_MAPPING_TYPE_FD_MAPPING,
    264     CAM_MAPPING_TYPE_FD_UNMAPPING,
    265     CAM_MAPPING_TYPE_MAX
    266 } cam_mapping_type;
    267 
    268 typedef struct {
    269     cam_mapping_type msg_type;
    270     union {
    271         cam_buf_map_type buf_map;
    272         cam_buf_unmap_type buf_unmap;
    273     } payload;
    274 } cam_sock_packet_t;
    275 
    276 typedef enum {
    277     CAM_MODE_2D = (1<<0),
    278     CAM_MODE_3D = (1<<1)
    279 } cam_mode_t;
    280 
    281 typedef struct {
    282     uint32_t len;
    283     uint32_t y_offset;
    284     uint32_t cbcr_offset;
    285 } cam_sp_len_offset_t;
    286 
    287 typedef struct{
    288     uint32_t len;
    289     uint32_t offset;
    290     int32_t offset_x;
    291     int32_t offset_y;
    292     int32_t stride;
    293     int32_t scanline;
    294 } cam_mp_len_offset_t;
    295 
    296 typedef struct {
    297     uint32_t width_padding;
    298     uint32_t height_padding;
    299     uint32_t plane_padding;
    300 } cam_padding_info_t;
    301 
    302 typedef struct {
    303     int num_planes;
    304     union {
    305         cam_sp_len_offset_t sp;
    306         cam_mp_len_offset_t mp[VIDEO_MAX_PLANES];
    307     };
    308     uint32_t frame_len;
    309 } cam_frame_len_offset_t;
    310 
    311 typedef struct {
    312     int32_t width;
    313     int32_t height;
    314 } cam_dimension_t;
    315 
    316 typedef struct {
    317     cam_frame_len_offset_t plane_info;
    318 } cam_stream_buf_plane_info_t;
    319 
    320 typedef struct {
    321     float min_fps;
    322     float max_fps;
    323 } cam_fps_range_t;
    324 
    325 typedef struct {
    326     int32_t min_sensitivity;
    327     int32_t max_sensitivity;
    328 } cam_sensitivity_range_t;
    329 
    330 typedef enum {
    331     CAM_HFR_MODE_OFF,
    332     CAM_HFR_MODE_60FPS,
    333     CAM_HFR_MODE_90FPS,
    334     CAM_HFR_MODE_120FPS,
    335     CAM_HFR_MODE_150FPS,
    336     CAM_HFR_MODE_MAX
    337 } cam_hfr_mode_t;
    338 
    339 typedef struct {
    340     cam_hfr_mode_t mode;
    341     cam_dimension_t dim;
    342     uint8_t frame_skip;
    343     uint8_t livesnapshot_sizes_tbl_cnt;                     /* livesnapshot sizes table size */
    344     cam_dimension_t livesnapshot_sizes_tbl[MAX_SIZES_CNT];  /* livesnapshot sizes table */
    345 } cam_hfr_info_t;
    346 
    347 typedef enum {
    348     CAM_WB_MODE_AUTO,
    349     CAM_WB_MODE_CUSTOM,
    350     CAM_WB_MODE_INCANDESCENT,
    351     CAM_WB_MODE_FLUORESCENT,
    352     CAM_WB_MODE_WARM_FLUORESCENT,
    353     CAM_WB_MODE_DAYLIGHT,
    354     CAM_WB_MODE_CLOUDY_DAYLIGHT,
    355     CAM_WB_MODE_TWILIGHT,
    356     CAM_WB_MODE_SHADE,
    357     CAM_WB_MODE_OFF,
    358     CAM_WB_MODE_MAX
    359 } cam_wb_mode_type;
    360 
    361 typedef enum {
    362     CAM_ANTIBANDING_MODE_OFF,
    363     CAM_ANTIBANDING_MODE_60HZ,
    364     CAM_ANTIBANDING_MODE_50HZ,
    365     CAM_ANTIBANDING_MODE_AUTO,
    366     CAM_ANTIBANDING_MODE_AUTO_50HZ,
    367     CAM_ANTIBANDING_MODE_AUTO_60HZ,
    368     CAM_ANTIBANDING_MODE_MAX,
    369 } cam_antibanding_mode_type;
    370 
    371 /* Enum Type for different ISO Mode supported */
    372 typedef enum {
    373     CAM_ISO_MODE_AUTO,
    374     CAM_ISO_MODE_DEBLUR,
    375     CAM_ISO_MODE_100,
    376     CAM_ISO_MODE_200,
    377     CAM_ISO_MODE_400,
    378     CAM_ISO_MODE_800,
    379     CAM_ISO_MODE_1600,
    380     CAM_ISO_MODE_MAX
    381 } cam_iso_mode_type;
    382 
    383 typedef enum {
    384     CAM_AEC_MODE_FRAME_AVERAGE,
    385     CAM_AEC_MODE_CENTER_WEIGHTED,
    386     CAM_AEC_MODE_SPOT_METERING,
    387     CAM_AEC_MODE_SMART_METERING,
    388     CAM_AEC_MODE_USER_METERING,
    389     CAM_AEC_MODE_SPOT_METERING_ADV,
    390     CAM_AEC_MODE_CENTER_WEIGHTED_ADV,
    391     CAM_AEC_MODE_MAX
    392 } cam_auto_exposure_mode_type;
    393 
    394 typedef enum {
    395     CAM_AE_MODE_OFF,
    396     CAM_AE_MODE_ON,
    397     CAM_AE_MODE_MAX
    398 } cam_ae_mode_type;
    399 
    400 typedef enum {
    401     CAM_FOCUS_ALGO_AUTO,
    402     CAM_FOCUS_ALGO_SPOT,
    403     CAM_FOCUS_ALGO_CENTER_WEIGHTED,
    404     CAM_FOCUS_ALGO_AVERAGE,
    405     CAM_FOCUS_ALGO_MAX
    406 } cam_focus_algorithm_type;
    407 
    408 /* Auto focus mode */
    409 typedef enum {
    410     CAM_FOCUS_MODE_AUTO,
    411     CAM_FOCUS_MODE_INFINITY,
    412     CAM_FOCUS_MODE_MACRO,
    413     CAM_FOCUS_MODE_FIXED,
    414     CAM_FOCUS_MODE_EDOF,
    415     CAM_FOCUS_MODE_CONTINOUS_VIDEO,
    416     CAM_FOCUS_MODE_CONTINOUS_PICTURE,
    417     CAM_FOCUS_MODE_MAX
    418 } cam_focus_mode_type;
    419 
    420 typedef enum {
    421     CAM_SCENE_MODE_OFF,
    422     CAM_SCENE_MODE_AUTO,
    423     CAM_SCENE_MODE_LANDSCAPE,
    424     CAM_SCENE_MODE_SNOW,
    425     CAM_SCENE_MODE_BEACH,
    426     CAM_SCENE_MODE_SUNSET,
    427     CAM_SCENE_MODE_NIGHT,
    428     CAM_SCENE_MODE_PORTRAIT,
    429     CAM_SCENE_MODE_BACKLIGHT,
    430     CAM_SCENE_MODE_SPORTS,
    431     CAM_SCENE_MODE_ANTISHAKE,
    432     CAM_SCENE_MODE_FLOWERS,
    433     CAM_SCENE_MODE_CANDLELIGHT,
    434     CAM_SCENE_MODE_FIREWORKS,
    435     CAM_SCENE_MODE_PARTY,
    436     CAM_SCENE_MODE_NIGHT_PORTRAIT,
    437     CAM_SCENE_MODE_THEATRE,
    438     CAM_SCENE_MODE_ACTION,
    439     CAM_SCENE_MODE_AR,
    440     CAM_SCENE_MODE_FACE_PRIORITY,
    441     CAM_SCENE_MODE_BARCODE,
    442     CAM_SCENE_MODE_MAX
    443 } cam_scene_mode_type;
    444 
    445 typedef enum {
    446     CAM_EFFECT_MODE_OFF,
    447     CAM_EFFECT_MODE_MONO,
    448     CAM_EFFECT_MODE_NEGATIVE,
    449     CAM_EFFECT_MODE_SOLARIZE,
    450     CAM_EFFECT_MODE_SEPIA,
    451     CAM_EFFECT_MODE_POSTERIZE,
    452     CAM_EFFECT_MODE_WHITEBOARD,
    453     CAM_EFFECT_MODE_BLACKBOARD,
    454     CAM_EFFECT_MODE_AQUA,
    455     CAM_EFFECT_MODE_EMBOSS,
    456     CAM_EFFECT_MODE_SKETCH,
    457     CAM_EFFECT_MODE_NEON,
    458     CAM_EFFECT_MODE_MAX
    459 } cam_effect_mode_type;
    460 
    461 typedef enum {
    462     CAM_FLASH_MODE_OFF,
    463     CAM_FLASH_MODE_AUTO,
    464     CAM_FLASH_MODE_ON,
    465     CAM_FLASH_MODE_TORCH,
    466     CAM_FLASH_MODE_SINGLE,
    467     CAM_FLASH_MODE_MAX
    468 } cam_flash_mode_t;
    469 
    470 typedef enum {
    471     CAM_FLASH_FIRING_LEVEL_0,
    472     CAM_FLASH_FIRING_LEVEL_1,
    473     CAM_FLASH_FIRING_LEVEL_2,
    474     CAM_FLASH_FIRING_LEVEL_3,
    475     CAM_FLASH_FIRING_LEVEL_4,
    476     CAM_FLASH_FIRING_LEVEL_5,
    477     CAM_FLASH_FIRING_LEVEL_6,
    478     CAM_FLASH_FIRING_LEVEL_7,
    479     CAM_FLASH_FIRING_LEVEL_8,
    480     CAM_FLASH_FIRING_LEVEL_9,
    481     CAM_FLASH_FIRING_LEVEL_10,
    482     CAM_FLASH_FIRING_LEVEL_MAX
    483 } cam_flash_firing_level_t;
    484 
    485 
    486 typedef enum {
    487     CAM_AEC_TRIGGER_IDLE,
    488     CAM_AEC_TRIGGER_START
    489 } cam_aec_trigger_type_t;
    490 
    491 typedef enum {
    492     CAM_AF_TRIGGER_IDLE,
    493     CAM_AF_TRIGGER_START,
    494     CAM_AF_TRIGGER_CANCEL
    495 } cam_af_trigger_type_t;
    496 
    497 typedef enum {
    498     CAM_AE_STATE_INACTIVE,
    499     CAM_AE_STATE_SEARCHING,
    500     CAM_AE_STATE_CONVERGED,
    501     CAM_AE_STATE_LOCKED,
    502     CAM_AE_STATE_FLASH_REQUIRED,
    503     CAM_AE_STATE_PRECAPTURE
    504 } cam_ae_state_t;
    505 
    506 typedef enum {
    507     CAM_NOISE_REDUCTION_MODE_OFF,
    508     CAM_NOISE_REDUCTION_MODE_FAST,
    509     CAM_NOISE_REDUCTION_MODE_HIGH_QUALITY
    510 } cam_noise_reduction_mode_t;
    511 
    512 typedef enum {
    513     CAM_EDGE_MODE_OFF,
    514     CAM_EDGE_MODE_FAST,
    515     CAM_EDGE_MODE_HIGH_QUALITY,
    516 } cam_edge_mode_t;
    517 
    518 typedef enum {
    519     CAM_BLACK_LEVEL_LOCK_OFF,
    520     CAM_BLACK_LEVEL_LOCK_ON,
    521 } cam_black_level_lock_t;
    522 
    523 typedef enum {
    524     CAM_LENS_SHADING_MAP_MODE_OFF,
    525     CAM_LENS_SHADING_MAP_MODE_ON,
    526 } cam_lens_shading_map_mode_t;
    527 
    528 typedef enum {
    529     CAM_FACE_DETECT_MODE_OFF,
    530     CAM_FACE_DETECT_MODE_SIMPLE,
    531     CAM_FACE_DETECT_MODE_FULL,
    532 } cam_face_detect_mode_t;
    533 
    534 typedef enum {
    535     CAM_TONEMAP_MODE_CONTRAST_CURVE,
    536     CAM_TONEMAP_MODE_FAST,
    537     CAM_TONEMAP_MODE_HIGH_QUALITY,
    538 } cam_tonemap_mode_t;
    539 
    540 typedef struct  {
    541     int32_t left;
    542     int32_t top;
    543     int32_t width;
    544     int32_t height;
    545 } cam_rect_t;
    546 
    547 typedef struct  {
    548     cam_rect_t rect;
    549     int32_t weight; /* weight of the area, valid for focusing/metering areas */
    550 } cam_area_t;
    551 
    552 typedef enum {
    553     CAM_STREAMING_MODE_CONTINUOUS, /* continous streaming */
    554     CAM_STREAMING_MODE_BURST,      /* burst streaming */
    555     CAM_STREAMING_MODE_MAX
    556 } cam_streaming_mode_t;
    557 
    558 #define CAM_REPROCESS_MASK_TYPE_WNR (1<<0)
    559 
    560 /* event from server */
    561 typedef enum {
    562     CAM_EVENT_TYPE_MAP_UNMAP_DONE  = (1<<0),
    563     CAM_EVENT_TYPE_AUTO_FOCUS_DONE = (1<<1),
    564     CAM_EVENT_TYPE_ZOOM_DONE       = (1<<2),
    565     CAM_EVENT_TYPE_DAEMON_DIED     = (1<<3),
    566     CAM_EVENT_TYPE_MAX
    567 } cam_event_type_t;
    568 
    569 typedef enum {
    570     CAM_EXP_BRACKETING_OFF,
    571     CAM_EXP_BRACKETING_ON
    572 } cam_bracket_mode;
    573 
    574 typedef struct {
    575     cam_bracket_mode mode;
    576     char values[MAX_EXP_BRACKETING_LENGTH];  /* user defined values */
    577 } cam_exp_bracketing_t;
    578 
    579 typedef enum {
    580     CAM_AEC_ROI_OFF,
    581     CAM_AEC_ROI_ON
    582 } cam_aec_roi_ctrl_t;
    583 
    584 typedef enum {
    585     CAM_AEC_ROI_BY_INDEX,
    586     CAM_AEC_ROI_BY_COORDINATE,
    587 } cam_aec_roi_type_t;
    588 
    589 typedef struct {
    590     uint32_t x;
    591     uint32_t y;
    592 } cam_coordinate_type_t;
    593 
    594 typedef struct {
    595     int32_t numerator;
    596     int32_t denominator;
    597 } cam_rational_type_t;
    598 
    599 typedef struct {
    600     cam_aec_roi_ctrl_t aec_roi_enable;
    601     cam_aec_roi_type_t aec_roi_type;
    602     union {
    603         cam_coordinate_type_t coordinate[MAX_ROI];
    604         uint32_t aec_roi_idx[MAX_ROI];
    605     } cam_aec_roi_position;
    606 } cam_set_aec_roi_t;
    607 
    608 typedef struct {
    609     uint32_t frm_id;
    610     uint8_t num_roi;
    611     cam_rect_t roi[MAX_ROI];
    612     int32_t weight[MAX_ROI];
    613     uint8_t is_multiwindow;
    614 } cam_roi_info_t;
    615 
    616 typedef enum {
    617     CAM_WAVELET_DENOISE_YCBCR_PLANE,
    618     CAM_WAVELET_DENOISE_CBCR_ONLY,
    619     CAM_WAVELET_DENOISE_STREAMLINE_YCBCR,
    620     CAM_WAVELET_DENOISE_STREAMLINED_CBCR
    621 } cam_denoise_process_type_t;
    622 
    623 typedef struct {
    624     int denoise_enable;
    625     cam_denoise_process_type_t process_plates;
    626 } cam_denoise_param_t;
    627 
    628 #define CAM_FACE_PROCESS_MASK_DETECTION    (1<<0)
    629 #define CAM_FACE_PROCESS_MASK_RECOGNITION  (1<<1)
    630 typedef struct {
    631     int fd_mode;               /* mask of face process */
    632     int num_fd;
    633 } cam_fd_set_parm_t;
    634 
    635 typedef struct {
    636     int8_t face_id;            /* unique id for face tracking within view unless view changes */
    637     int8_t score;              /* score of confidence (0, -100) */
    638     cam_rect_t face_boundary;  /* boundary of face detected */
    639     cam_coordinate_type_t left_eye_center;  /* coordinate of center of left eye */
    640     cam_coordinate_type_t right_eye_center; /* coordinate of center of right eye */
    641     cam_coordinate_type_t mouth_center;     /* coordinate of center of mouth */
    642     uint8_t smile_degree;      /* smile degree (0, -100) */
    643     uint8_t smile_confidence;  /* smile confidence (0, 100) */
    644     uint8_t face_recognised;   /* if face is recognised */
    645     int8_t gaze_angle;         /* -90 -45 0 45 90 for head left to rigth tilt */
    646     int8_t updown_dir;         /* up down direction (-90, 90) */
    647     int8_t leftright_dir;      /* left right direction (-90, 90) */
    648     int8_t roll_dir;           /* roll direction (-90, 90) */
    649     int8_t left_right_gaze;    /* left right gaze degree (-50, 50) */
    650     int8_t top_bottom_gaze;    /* up down gaze degree (-50, 50) */
    651     uint8_t blink_detected;    /* if blink is detected */
    652     uint8_t left_blink;        /* left eye blink degeree (0, -100) */
    653     uint8_t right_blink;       /* right eye blink degree (0, - 100) */
    654 } cam_face_detection_info_t;
    655 
    656 typedef struct {
    657     uint32_t frame_id;                         /* frame index of which faces are detected */
    658     uint8_t num_faces_detected;                /* number of faces detected */
    659     cam_face_detection_info_t faces[MAX_ROI];  /* detailed information of faces detected */
    660 } cam_face_detection_data_t;
    661 
    662 #define CAM_HISTOGRAM_STATS_SIZE 256
    663 typedef struct {
    664     uint32_t max_hist_value;
    665     uint32_t hist_buf[CAM_HISTOGRAM_STATS_SIZE]; /* buf holding histogram stats data */
    666 } cam_histogram_data_t;
    667 
    668 typedef struct {
    669     cam_histogram_data_t r_stats;
    670     cam_histogram_data_t b_stats;
    671     cam_histogram_data_t gr_stats;
    672     cam_histogram_data_t gb_stats;
    673 } cam_bayer_hist_stats_t;
    674 
    675 typedef enum {
    676     CAM_HISTOGRAM_TYPE_BAYER,
    677     CAM_HISTOGRAM_TYPE_YUV
    678 } cam_histogram_type_t;
    679 
    680 typedef struct {
    681     cam_histogram_type_t type;
    682     union {
    683         cam_bayer_hist_stats_t bayer_stats;
    684         cam_histogram_data_t yuv_stats;
    685     };
    686 } cam_hist_stats_t;
    687 
    688 enum cam_focus_distance_index{
    689   CAM_FOCUS_DISTANCE_NEAR_INDEX,  /* 0 */
    690   CAM_FOCUS_DISTANCE_OPTIMAL_INDEX,
    691   CAM_FOCUS_DISTANCE_FAR_INDEX,
    692   CAM_FOCUS_DISTANCE_MAX_INDEX
    693 };
    694 
    695 typedef struct {
    696   float focus_distance[CAM_FOCUS_DISTANCE_MAX_INDEX];
    697 } cam_focus_distances_info_t;
    698 
    699 /* Different autofocus cycle when calling do_autoFocus
    700  * CAM_AF_COMPLETE_EXISTING_SWEEP: Complete existing sweep
    701  * if one is ongoing, and lock.
    702  * CAM_AF_DO_ONE_FULL_SWEEP: Do one full sweep, regardless
    703  * of the current state, and lock.
    704  * CAM_AF_START_CONTINUOUS_SWEEP: Start continous sweep.
    705  * After do_autoFocus, HAL receives an event: CAM_AF_FOCUSED,
    706  * or CAM_AF_NOT_FOCUSED.
    707  * cancel_autoFocus stops any lens movement.
    708  * Each do_autoFocus call only produces 1 FOCUSED/NOT_FOCUSED
    709  * event, not both.
    710  */
    711 typedef enum {
    712     CAM_AF_COMPLETE_EXISTING_SWEEP,
    713     CAM_AF_DO_ONE_FULL_SWEEP,
    714     CAM_AF_START_CONTINUOUS_SWEEP
    715 } cam_autofocus_cycle_t;
    716 
    717 typedef enum {
    718     CAM_AF_SCANNING,
    719     CAM_AF_FOCUSED,
    720     CAM_AF_NOT_FOCUSED
    721 } cam_autofocus_state_t;
    722 
    723 typedef struct {
    724     cam_autofocus_state_t focus_state;           /* state of focus */
    725     cam_focus_distances_info_t focus_dist;       /* focus distance */
    726 } cam_auto_focus_data_t;
    727 
    728 typedef struct {
    729     uint32_t stream_id;
    730     cam_rect_t crop;
    731 } cam_stream_crop_info_t;
    732 
    733 typedef struct {
    734     uint8_t num_of_streams;
    735     cam_stream_crop_info_t crop_info[MAX_NUM_STREAMS];
    736 } cam_crop_data_t;
    737 
    738 typedef enum {
    739     DO_NOT_NEED_FUTURE_FRAME,
    740     NEED_FUTURE_FRAME,
    741 } cam_prep_snapshot_state_t;
    742 
    743 typedef struct {
    744     float gains[4];
    745 } cam_color_correct_gains_t;
    746 
    747 typedef struct {
    748     uint32_t min_frame_idx;
    749     uint32_t max_frame_idx;
    750 } cam_frame_idx_range_t;
    751 
    752 typedef  struct {
    753     uint8_t is_stats_valid;               /* if histgram data is valid */
    754     cam_hist_stats_t stats_data;          /* histogram data */
    755 
    756     uint8_t is_faces_valid;               /* if face detection data is valid */
    757     cam_face_detection_data_t faces_data; /* face detection result */
    758 
    759     uint8_t is_focus_valid;               /* if focus data is valid */
    760     cam_auto_focus_data_t focus_data;     /* focus data */
    761 
    762     uint8_t is_crop_valid;                /* if crop data is valid */
    763     cam_crop_data_t crop_data;            /* crop data */
    764 
    765     uint8_t is_prep_snapshot_done_valid;  /* if prep snapshot done is valid */
    766     cam_prep_snapshot_state_t prep_snapshot_done_state;  /* prepare snapshot done state */
    767 
    768     /* if good frame idx range is valid */
    769     uint8_t is_good_frame_idx_range_valid;
    770     /* good frame idx range, make sure:
    771      * 1. good_frame_idx_range.min_frame_idx > current_frame_idx
    772      * 2. good_frame_idx_range.min_frame_idx - current_frame_idx < 100 */
    773     cam_frame_idx_range_t good_frame_idx_range;
    774 
    775     char private_metadata[MAX_METADATA_PAYLOAD_SIZE];
    776 
    777 } cam_metadata_info_t;
    778 
    779 typedef enum {
    780     CAM_INTF_PARM_HAL_VERSION,
    781     /* common between HAL1 and HAL3 */
    782     CAM_INTF_PARM_ANTIBANDING,
    783     CAM_INTF_PARM_EXPOSURE_COMPENSATION,
    784     CAM_INTF_PARM_AEC_LOCK,
    785     CAM_INTF_PARM_FPS_RANGE,
    786     CAM_INTF_PARM_AWB_LOCK,
    787     CAM_INTF_PARM_WHITE_BALANCE,
    788     CAM_INTF_PARM_EFFECT,
    789     CAM_INTF_PARM_BESTSHOT_MODE,
    790     CAM_INTF_PARM_DIS_ENABLE,
    791     CAM_INTF_PARM_LED_MODE,
    792     CAM_INTF_META_HISTOGRAM, /* 10 */
    793     CAM_INTF_META_FACE_DETECTION,
    794     CAM_INTF_META_AUTOFOCUS_DATA,
    795 
    796     /* specific to HAl1 */
    797     CAM_INTF_PARM_QUERY_FLASH4SNAP,
    798     CAM_INTF_PARM_EXPOSURE,
    799     CAM_INTF_PARM_SHARPNESS,
    800     CAM_INTF_PARM_CONTRAST,
    801     CAM_INTF_PARM_SATURATION,
    802     CAM_INTF_PARM_BRIGHTNESS,
    803     CAM_INTF_PARM_ISO,
    804     CAM_INTF_PARM_ZOOM, /* 20 */
    805     CAM_INTF_PARM_ROLLOFF,
    806     CAM_INTF_PARM_MODE,             /* camera mode */
    807     CAM_INTF_PARM_AEC_ALGO_TYPE,    /* auto exposure algorithm */
    808     CAM_INTF_PARM_FOCUS_ALGO_TYPE,  /* focus algorithm */
    809     CAM_INTF_PARM_AEC_ROI,
    810     CAM_INTF_PARM_AF_ROI,
    811     CAM_INTF_PARM_FOCUS_MODE,
    812     CAM_INTF_PARM_SCE_FACTOR,
    813     CAM_INTF_PARM_FD,
    814     CAM_INTF_PARM_MCE, /* 30 */
    815     CAM_INTF_PARM_HFR,
    816     CAM_INTF_PARM_REDEYE_REDUCTION,
    817     CAM_INTF_PARM_WAVELET_DENOISE,
    818     CAM_INTF_PARM_HISTOGRAM,
    819     CAM_INTF_PARM_ASD_ENABLE,
    820     CAM_INTF_PARM_RECORDING_HINT,
    821     CAM_INTF_PARM_HDR,
    822     CAM_INTF_PARM_FRAMESKIP,
    823     CAM_INTF_PARM_ZSL_MODE,  /* indicating if it's running in ZSL mode */
    824     CAM_INTF_PARM_HDR_NEED_1X, /* if HDR needs 1x output */ /* 40 */
    825     CAM_INTF_PARM_LOCK_CAF,
    826     CAM_INTF_PARM_VIDEO_HDR,
    827     CAM_INTF_PARM_ROTATION,
    828     CAM_INTF_META_CROP_DATA,
    829     CAM_INTF_META_PREP_SNAPSHOT_DONE,
    830     CAM_INTF_META_GOOD_FRAME_IDX_RANGE,
    831 
    832     /* stream based parameters */
    833     CAM_INTF_PARM_DO_REPROCESS,
    834     CAM_INTF_PARM_SET_BUNDLE,
    835 
    836     /* specific to HAL3 */
    837     /* Whether the metadata maps to a valid frame number */
    838     CAM_INTF_META_FRAME_NUMBER_VALID,
    839     /* Number of pending requests yet to be processed */
    840     CAM_INTF_META_PENDING_REQUESTS,
    841     /* COLOR CORRECTION.*/
    842     CAM_INTF_META_COLOR_CORRECT_MODE,
    843     /* A transform matrix to chromatically adapt pixels in the CIE XYZ (1931)
    844      * color space from the scene illuminant to the sRGB-standard D65-illuminant. */
    845     CAM_INTF_META_COLOR_CORRECT_TRANSFORM, /* 50 */
    846     /*Color channel gains in the Bayer raw domain in the order [RGeGoB]*/
    847     CAM_INTF_META_COLOR_CORRECT_GAINS,
    848     /*The best fit color transform matrix calculated by the stats*/
    849     CAM_INTF_META_PRED_COLOR_CORRECT_TRANSFORM,
    850     /*The best fit color channels gains calculated by the stats*/
    851     CAM_INTF_META_PRED_COLOR_CORRECT_GAINS,
    852     /* CONTROL */
    853 //    CAM_INTF_META_REQUEST_ID,
    854     /* A frame counter set by the framework. Must be maintained unchanged in
    855      * output frame. */
    856     CAM_INTF_META_FRAME_NUMBER,
    857     /* Whether AE is currently updating the sensor exposure and sensitivity
    858      * fields */
    859     CAM_INTF_META_AEC_MODE,
    860     /* List of areas to use for metering */
    861     CAM_INTF_META_AEC_ROI,
    862     /* Whether the HAL must trigger precapture metering.*/
    863     CAM_INTF_META_AEC_PRECAPTURE_TRIGGER,
    864     /* The ID sent with the latest CAMERA2_TRIGGER_PRECAPTURE_METERING call */
    865     CAM_INTF_META_AEC_PRECAPTURE_ID,
    866     /* Current state of AE algorithm */
    867     CAM_INTF_META_AEC_STATE,
    868     /* List of areas to use for focus estimation */
    869     CAM_INTF_META_AF_ROI,
    870     /* Whether the HAL must trigger autofocus. */
    871     CAM_INTF_META_AF_TRIGGER,
    872     /* Current state of AF algorithm */
    873     CAM_INTF_META_AF_STATE,
    874     /* The ID sent with the latest CAMERA2_TRIGGER_AUTOFOCUS call */
    875     CAM_INTF_META_AF_TRIGGER_ID,
    876     /* List of areas to use for illuminant estimation */
    877     CAM_INTF_META_AWB_REGIONS,
    878     /* Current state of AWB algorithm */
    879     CAM_INTF_META_AWB_STATE,
    880     /*Whether black level compensation is frozen or free to vary*/
    881     CAM_INTF_META_BLACK_LEVEL_LOCK,
    882     /* Information to 3A routines about the purpose of this capture, to help
    883      * decide optimal 3A strategy */
    884     CAM_INTF_META_CAPTURE_INTENT,
    885     /* Overall mode of 3A control routines. We need to have this parameter
    886      * because not all android.control.* have an OFF option, for example,
    887      * AE_FPS_Range, aePrecaptureTrigger */
    888     CAM_INTF_META_MODE,
    889     /* DEMOSAIC */
    890     /* Controls the quality of the demosaicing processing */
    891     CAM_INTF_META_DEMOSAIC,
    892     /* EDGE */
    893     /* Operation mode for edge enhancement */
    894     CAM_INTF_META_EDGE_MODE,
    895     /* Control the amount of edge enhancement applied to the images.*/
    896     /* 1-10; 10 is maximum sharpening */
    897     CAM_INTF_META_SHARPNESS_STRENGTH,
    898     /* FLASH */
    899     /* Power for flash firing/torch, 10 is max power; 0 is no flash. Linear */
    900     CAM_INTF_META_FLASH_POWER,
    901     /* Firing time of flash relative to start of exposure, in nanoseconds*/
    902     CAM_INTF_META_FLASH_FIRING_TIME,
    903     /* Current state of the flash unit */
    904     CAM_INTF_META_FLASH_STATE,
    905     /* GEOMETRIC */
    906     /* Operating mode of geometric correction */
    907     CAM_INTF_META_GEOMETRIC_MODE,
    908     /* Control the amount of shading correction applied to the images */
    909     CAM_INTF_META_GEOMETRIC_STRENGTH,
    910     /* HOT PIXEL */
    911     /* Set operational mode for hot pixel correction */
    912     CAM_INTF_META_HOTPIXEL_MODE,
    913     /* LENS */
    914     /* Size of the lens aperture */
    915     CAM_INTF_META_LENS_APERTURE,
    916     /* State of lens neutral density filter(s) */
    917     CAM_INTF_META_LENS_FILTERDENSITY,
    918     /* Lens optical zoom setting */
    919     CAM_INTF_META_LENS_FOCAL_LENGTH,
    920     /* Distance to plane of sharpest focus, measured from frontmost surface
    921      * of the lens */
    922     CAM_INTF_META_LENS_FOCUS_DISTANCE,
    923     /* The range of scene distances that are in sharp focus (depth of field) */
    924     CAM_INTF_META_LENS_FOCUS_RANGE,
    925     /* Whether optical image stabilization is enabled. */
    926     CAM_INTF_META_LENS_OPT_STAB_MODE,
    927     /*Whether the hal needs to output the lens shading map*/
    928     CAM_INTF_META_LENS_SHADING_MAP_MODE,
    929     /* Current lens status */
    930     CAM_INTF_META_LENS_STATE,
    931     /* NOISE REDUCTION */
    932     /* Mode of operation for the noise reduction algorithm */
    933     CAM_INTF_META_NOISE_REDUCTION_MODE,
    934    /* Control the amount of noise reduction applied to the images.
    935     * 1-10; 10 is max noise reduction */
    936     CAM_INTF_META_NOISE_REDUCTION_STRENGTH,
    937     /* SCALER */
    938     /* Top-left corner and width of the output region to select from the active
    939      * pixel array */
    940     CAM_INTF_META_SCALER_CROP_REGION,
    941     /* The estimated scene illumination lighting frequency */
    942     CAM_INTF_META_SCENE_FLICKER,
    943     /* SENSOR */
    944     /* Duration each pixel is exposed to light, in nanoseconds */
    945     CAM_INTF_META_SENSOR_EXPOSURE_TIME,
    946     /* Duration from start of frame exposure to start of next frame exposure,
    947      * in nanoseconds */
    948     CAM_INTF_META_SENSOR_FRAME_DURATION,
    949     /* Gain applied to image data. Must be implemented through analog gain only
    950      * if set to values below 'maximum analog sensitivity'. */
    951     CAM_INTF_META_SENSOR_SENSITIVITY,
    952     /* Time at start of exposure of first row */
    953     CAM_INTF_META_SENSOR_TIMESTAMP,
    954     /* SHADING */
    955     /* Quality of lens shading correction applied to the image data */
    956     CAM_INTF_META_SHADING_MODE,
    957     /* Control the amount of shading correction applied to the images.
    958      * unitless: 1-10; 10 is full shading compensation */
    959     CAM_INTF_META_SHADING_STRENGTH,
    960     /* STATISTICS */
    961     /* State of the face detector unit */
    962     CAM_INTF_META_STATS_FACEDETECT_MODE,
    963     /* Operating mode for histogram generation */
    964     CAM_INTF_META_STATS_HISTOGRAM_MODE,
    965     /* Operating mode for sharpness map generation */
    966     CAM_INTF_META_STATS_SHARPNESS_MAP_MODE,
    967     /* A 3-channel sharpness map, based on the raw sensor data,
    968      * If only a monochrome sharpness map is supported, all channels
    969      * should have the same data
    970      */
    971     CAM_INTF_META_STATS_SHARPNESS_MAP,
    972 
    973     /* TONEMAP */
    974     /* Table mapping blue input values to output values */
    975     CAM_INTF_META_TONEMAP_CURVE_BLUE,
    976     /* Table mapping green input values to output values */
    977     CAM_INTF_META_TONEMAP_CURVE_GREEN,
    978     /* Table mapping red input values to output values */
    979     CAM_INTF_META_TONEMAP_CURVE_RED,
    980     /* Tone map mode */
    981     CAM_INTF_META_TONEMAP_MODE,
    982     CAM_INTF_META_FLASH_MODE,
    983     /* 2D array of gain factors for each color channel that was used to
    984      * compensate for lens shading for this frame */
    985     CAM_INTF_META_LENS_SHADING_MAP,
    986     CAM_INTF_META_PRIVATE_DATA,
    987     /* Indicates streams this request needs buffers on */
    988     CAM_INTF_META_STREAM_TYPE_MASK,
    989     CAM_INTF_PARM_MAX
    990 } cam_intf_parm_type_t;
    991 
    992 /*****************************************************************************
    993  *                 Code for HAL3 data types                                  *
    994  ****************************************************************************/
    995 typedef enum {
    996     CAM_INTF_METADATA_MAX
    997 } cam_intf_metadata_type_t;
    998 
    999 typedef enum {
   1000     CAM_INTENT_CUSTOM,
   1001     CAM_INTENT_PREVIEW,
   1002     CAM_INTENT_STILL_CAPTURE,
   1003     CAM_INTENT_VIDEO_RECORD,
   1004     CAM_INTENT_VIDEO_SNAPSHOT,
   1005     CAM_INTENT_ZERO_SHUTTER_LAG,
   1006     CAM_INTENT_MAX,
   1007 } cam_intent_t;
   1008 
   1009 typedef enum {
   1010     /* Full application control of pipeline. All 3A routines are disabled,
   1011      * no other settings in android.control.* have any effect */
   1012     CAM_CONTROL_OFF,
   1013     /* Use settings for each individual 3A routine. Manual control of capture
   1014      * parameters is disabled. All controls in android.control.* besides sceneMode
   1015      * take effect */
   1016     CAM_CONTROL_AUTO,
   1017     /* Use specific scene mode. Enabling this disables control.aeMode,
   1018      * control.awbMode and control.afMode controls; the HAL must ignore those
   1019      * settings while USE_SCENE_MODE is active (except for FACE_PRIORITY scene mode).
   1020      * Other control entries are still active. This setting can only be used if
   1021      * availableSceneModes != UNSUPPORTED. TODO: Should we remove this and handle this
   1022      * in HAL ?*/
   1023     CAM_CONTROL_USE_SCENE_MODE,
   1024     CAM_CONTROL_MAX
   1025 } cam_control_mode_t;
   1026 
   1027 typedef enum {
   1028     /* Use the android.colorCorrection.transform matrix to do color conversion */
   1029     CAM_COLOR_CORRECTION_TRANSFORM_MATRIX,
   1030     /* Must not slow down frame rate relative to raw bayer output */
   1031     CAM_COLOR_CORRECTION_FAST,
   1032     /* Frame rate may be reduced by high quality */
   1033     CAM_COLOR_CORRECTION_HIGH_QUALITY,
   1034 } cam_color_correct_mode_t;
   1035 
   1036 typedef struct {
   1037     /* 3x3 float matrix in row-major order. each element is in range of (0, 1) */
   1038     cam_rational_type_t transform_matrix[3][3];
   1039 } cam_color_correct_matrix_t;
   1040 
   1041 #define CAM_FOCAL_LENGTHS_MAX     1
   1042 #define CAM_APERTURES_MAX         1
   1043 #define CAM_FILTER_DENSITIES_MAX  1
   1044 #define CAM_MAX_MAP_HEIGHT        6
   1045 #define CAM_MAX_MAP_WIDTH         6
   1046 #define CAM_MAX_SHADING_MAP_WIDTH 17
   1047 #define CAM_MAX_SHADING_MAP_HEIGHT 13
   1048 #define CAM_MAX_TONEMAP_CURVE_SIZE    128
   1049 
   1050 typedef struct {
   1051     int tonemap_points_cnt;
   1052 
   1053     /* A 1D array of pairs of floats.
   1054      * Mapping a 0-1 input range to a 0-1 output range.
   1055      * The input range must be monotonically increasing with N,
   1056      * and values between entries should be linearly interpolated.
   1057      * For example, if the array is: [0.0, 0.0, 0.3, 0.5, 1.0, 1.0],
   1058      * then the input->output mapping for a few sample points would be:
   1059      * 0 -> 0, 0.15 -> 0.25, 0.3 -> 0.5, 0.5 -> 0.64 */
   1060     float tonemap_points[CAM_MAX_TONEMAP_CURVE_SIZE][2];
   1061 } cam_tonemap_curve_t;
   1062 
   1063 typedef enum {
   1064     OFF,
   1065     FAST,
   1066     QUALITY,
   1067 } cam_quality_preference_t;
   1068 
   1069 typedef enum {
   1070     CAM_FLASH_CTRL_OFF,
   1071     CAM_FLASH_CTRL_SINGLE,
   1072     CAM_FLASH_CTRL_TORCH
   1073 } cam_flash_ctrl_t;
   1074 
   1075 typedef struct {
   1076     uint8_t ae_mode;
   1077     uint8_t awb_mode;
   1078     uint8_t af_mode;
   1079 } cam_scene_mode_overrides_t;
   1080 
   1081 typedef struct {
   1082     int32_t left;
   1083     int32_t top;
   1084     int32_t width;
   1085     int32_t height;
   1086 } cam_crop_region_t;
   1087 
   1088 typedef struct {
   1089     /* Estimated sharpness for each region of the input image.
   1090      * Normalized to be between 0 and maxSharpnessMapValue.
   1091      * Higher values mean sharper (better focused) */
   1092     int32_t sharpness[CAM_MAX_MAP_WIDTH][CAM_MAX_MAP_HEIGHT];
   1093 } cam_sharpness_map_t;
   1094 
   1095 typedef struct {
   1096    float lens_shading[4*CAM_MAX_SHADING_MAP_HEIGHT*CAM_MAX_SHADING_MAP_WIDTH];
   1097 } cam_lens_shading_map_t;
   1098 
   1099 typedef struct {
   1100     int32_t min_value;
   1101     int32_t max_value;
   1102     int32_t def_value;
   1103     int32_t step;
   1104 } cam_control_range_t;
   1105 
   1106 #define CAM_QCOM_FEATURE_FACE_DETECTION (1<<0)
   1107 #define CAM_QCOM_FEATURE_DENOISE2D      (1<<1)
   1108 #define CAM_QCOM_FEATURE_CROP           (1<<2)
   1109 #define CAM_QCOM_FEATURE_ROTATION       (1<<3)
   1110 #define CAM_QCOM_FEATURE_FLIP           (1<<4)
   1111 #define CAM_QCOM_FEATURE_HDR            (1<<5)
   1112 #define CAM_QCOM_FEATURE_REGISTER_FACE  (1<<6)
   1113 #define CAM_QCOM_FEATURE_SHARPNESS      (1<<7)
   1114 #define CAM_QCOM_FEATURE_VIDEO_HDR      (1<<8)
   1115 #define CAM_QCOM_FEATURE_CAC            (1<<9)
   1116 
   1117 // Counter clock wise
   1118 typedef enum {
   1119     ROTATE_0 = 1<<0,
   1120     ROTATE_90 = 1<<1,
   1121     ROTATE_180 = 1<<2,
   1122     ROTATE_270 = 1<<3,
   1123 } cam_rotation_t;
   1124 
   1125 typedef enum {
   1126     FLIP_H = 1<<0,
   1127     FLIP_V = 1<<1,
   1128 } cam_flip_t;
   1129 
   1130 typedef struct {
   1131     uint32_t bundle_id;                            /* bundle id */
   1132     uint8_t num_of_streams;                        /* number of streams in the bundle */
   1133     uint32_t stream_ids[MAX_STREAM_NUM_IN_BUNDLE]; /* array of stream ids to be bundled */
   1134 } cam_bundle_config_t;
   1135 
   1136 typedef enum {
   1137     CAM_ONLINE_REPROCESS_TYPE,    /* online reprocess, frames from running streams */
   1138     CAM_OFFLINE_REPROCESS_TYPE,   /* offline reprocess, frames from external source */
   1139 } cam_reprocess_type_enum_t;
   1140 
   1141 typedef struct {
   1142     /* reprocess feature mask */
   1143     uint32_t feature_mask;
   1144 
   1145     /* individual setting for features to be reprocessed */
   1146     cam_denoise_param_t denoise2d;
   1147     cam_rect_t input_crop;
   1148     cam_rotation_t rotation;
   1149     uint32_t flip;
   1150     int32_t sharpness;
   1151     int32_t hdr_need_1x; /* when CAM_QCOM_FEATURE_HDR enabled, indicate if 1x is needed for output */
   1152 } cam_pp_feature_config_t;
   1153 
   1154 typedef struct {
   1155     uint32_t input_stream_id;
   1156     /* input source stream type */
   1157     cam_stream_type_t input_stream_type;
   1158 } cam_pp_online_src_config_t;
   1159 
   1160 typedef struct {
   1161     /* image format */
   1162     cam_format_t input_fmt;
   1163 
   1164     /* image dimension */
   1165     cam_dimension_t input_dim;
   1166 
   1167     /* buffer plane information, will be calc based on stream_type, fmt,
   1168        dim, and padding_info(from stream config). Info including:
   1169        offset_x, offset_y, stride, scanline, plane offset */
   1170     cam_stream_buf_plane_info_t input_buf_planes;
   1171 
   1172     /* number of input reprocess buffers */
   1173     uint8_t num_of_bufs;
   1174 } cam_pp_offline_src_config_t;
   1175 
   1176 /* reprocess stream input configuration */
   1177 typedef struct {
   1178     /* input source config */
   1179     cam_reprocess_type_enum_t pp_type;
   1180     union {
   1181         cam_pp_online_src_config_t online;
   1182         cam_pp_offline_src_config_t offline;
   1183     };
   1184 
   1185     /* pp feature config */
   1186     cam_pp_feature_config_t pp_feature_config;
   1187 } cam_stream_reproc_config_t;
   1188 
   1189 typedef struct {
   1190     uint8_t crop_enabled;
   1191     cam_rect_t input_crop;
   1192 } cam_crop_param_t;
   1193 
   1194 typedef struct {
   1195     uint8_t trigger;
   1196     int32_t trigger_id;
   1197 } cam_trigger_t;
   1198 
   1199 typedef struct {
   1200     cam_denoise_param_t denoise;
   1201     cam_crop_param_t crop;
   1202     uint32_t flip;     /* 0 means no flip */
   1203     int32_t sharpness; /* 0 means no sharpness */
   1204 } cam_per_frame_pp_config_t;
   1205 
   1206 typedef enum {
   1207     CAM_OPT_STAB_OFF,
   1208     CAM_OPT_STAB_ON,
   1209     CAM_OPT_STAB_MAX
   1210 } cam_optical_stab_modes_t;
   1211 
   1212 typedef enum {
   1213     CAM_FILTER_ARRANGEMENT_RGGB,
   1214     CAM_FILTER_ARRANGEMENT_GRBG,
   1215     CAM_FILTER_ARRANGEMENT_GBRG,
   1216     CAM_FILTER_ARRANGEMENT_BGGR,
   1217 
   1218     /* Sensor is not Bayer; output has 3 16-bit values for each pixel,
   1219      * instead of just 1 16-bit value per pixel.*/
   1220     CAM_FILTER_ARRANGEMENT_RGB
   1221 } cam_color_filter_arrangement_t;
   1222 
   1223 typedef enum {
   1224     CAM_AF_STATE_INACTIVE,
   1225     CAM_AF_STATE_PASSIVE_SCAN,
   1226     CAM_AF_STATE_PASSIVE_FOCUSED,
   1227     CAM_AF_STATE_ACTIVE_SCAN,
   1228     CAM_AF_STATE_FOCUSED_LOCKED,
   1229     CAM_AF_STATE_NOT_FOCUSED_LOCKED
   1230 } cam_af_state_t;
   1231 
   1232 typedef enum {
   1233     CAM_AWB_STATE_INACTIVE,
   1234     CAM_AWB_STATE_SEARCHING,
   1235     CAM_AWB_STATE_CONVERGED,
   1236     CAM_AWB_STATE_LOCKED
   1237 } cam_awb_state_t;
   1238 
   1239 #endif /* __QCAMERA_TYPES_H__ */
   1240