/* SPDX-License-Identifier: ((GPL-2.0+ WITH Linux-syscall-note) OR MIT) */
|
/*
|
* Rockchip module information
|
* Copyright (C) 2018-2019 Rockchip Electronics Co., Ltd.
|
*/
|
|
#ifndef _RKMODULE_CAMERA_H
|
#define _RKMODULE_CAMERA_H
|
|
#include <linux/types.h>
|
|
#define RKMODULE_API_VERSION KERNEL_VERSION(0, 1, 0x2)
|
|
/* using for rv1109 and rv1126 */
|
#define RKMODULE_EXTEND_LINE 24
|
|
#define RKMODULE_NAME_LEN 32
|
#define RKMODULE_LSCDATA_LEN 289
|
|
#define RKMODULE_MAX_VC_CH 4
|
|
#define RKMODULE_PADF_GAINMAP_LEN 1024
|
#define RKMODULE_PDAF_DCCMAP_LEN 256
|
#define RKMODULE_AF_OTP_MAX_LEN 3
|
|
#define RKMODULE_CAMERA_MODULE_INDEX "rockchip,camera-module-index"
|
#define RKMODULE_CAMERA_MODULE_FACING "rockchip,camera-module-facing"
|
#define RKMODULE_CAMERA_MODULE_NAME "rockchip,camera-module-name"
|
#define RKMODULE_CAMERA_LENS_NAME "rockchip,camera-module-lens-name"
|
|
/* BT.656 & BT.1120 multi channel
|
* On which channels it can send video data
|
* related with struct rkmodule_bt656_mbus_info
|
*/
|
#define RKMODULE_CAMERA_BT656_ID_EN_BITS_1 (0x1)
|
#define RKMODULE_CAMERA_BT656_ID_EN_BITS_2 (0x3)
|
#define RKMODULE_CAMERA_BT656_ID_EN_BITS_3 (0x7)
|
#define RKMODULE_CAMERA_BT656_ID_EN_BITS_4 (0xf)
|
#define RKMODULE_CAMERA_BT656_PARSE_ID_LSB BIT(0)
|
#define RKMODULE_CAMERA_BT656_PARSE_ID_MSB BIT(1)
|
#define RKMODULE_CAMERA_BT656_CHANNEL_0 BIT(2)
|
#define RKMODULE_CAMERA_BT656_CHANNEL_1 BIT(3)
|
#define RKMODULE_CAMERA_BT656_CHANNEL_2 BIT(4)
|
#define RKMODULE_CAMERA_BT656_CHANNEL_3 BIT(5)
|
#define RKMODULE_CAMERA_BT656_CHANNELS (RKMODULE_CAMERA_BT656_CHANNEL_0 | \
|
RKMODULE_CAMERA_BT656_CHANNEL_1 | \
|
RKMODULE_CAMERA_BT656_CHANNEL_2 | \
|
RKMODULE_CAMERA_BT656_CHANNEL_3)
|
|
#define RKMODULE_GET_MODULE_INFO \
|
_IOR('V', BASE_VIDIOC_PRIVATE + 0, struct rkmodule_inf)
|
|
#define RKMODULE_AWB_CFG \
|
_IOW('V', BASE_VIDIOC_PRIVATE + 1, struct rkmodule_awb_cfg)
|
|
#define RKMODULE_AF_CFG \
|
_IOW('V', BASE_VIDIOC_PRIVATE + 2, struct rkmodule_af_cfg)
|
|
#define RKMODULE_LSC_CFG \
|
_IOW('V', BASE_VIDIOC_PRIVATE + 3, struct rkmodule_lsc_cfg)
|
|
#define RKMODULE_GET_HDR_CFG \
|
_IOR('V', BASE_VIDIOC_PRIVATE + 4, struct rkmodule_hdr_cfg)
|
|
#define RKMODULE_SET_HDR_CFG \
|
_IOW('V', BASE_VIDIOC_PRIVATE + 5, struct rkmodule_hdr_cfg)
|
|
#define RKMODULE_SET_CONVERSION_GAIN \
|
_IOW('V', BASE_VIDIOC_PRIVATE + 6, __u32)
|
|
#define RKMODULE_GET_LVDS_CFG \
|
_IOR('V', BASE_VIDIOC_PRIVATE + 7, struct rkmodule_lvds_cfg)
|
|
#define RKMODULE_SET_DPCC_CFG \
|
_IOW('V', BASE_VIDIOC_PRIVATE + 8, struct rkmodule_dpcc_cfg)
|
|
#define RKMODULE_GET_NR_SWITCH_THRESHOLD \
|
_IOR('V', BASE_VIDIOC_PRIVATE + 9, struct rkmodule_nr_switch_threshold)
|
|
#define RKMODULE_SET_QUICK_STREAM \
|
_IOW('V', BASE_VIDIOC_PRIVATE + 10, __u32)
|
|
#define RKMODULE_GET_BT656_INTF_TYPE \
|
_IOR('V', BASE_VIDIOC_PRIVATE + 11, __u32)
|
|
#define RKMODULE_GET_VC_FMT_INFO \
|
_IOR('V', BASE_VIDIOC_PRIVATE + 12, struct rkmodule_vc_fmt_info)
|
|
#define RKMODULE_GET_VC_HOTPLUG_INFO \
|
_IOR('V', BASE_VIDIOC_PRIVATE + 13, struct rkmodule_vc_hotplug_info)
|
|
#define RKMODULE_GET_START_STREAM_SEQ \
|
_IOR('V', BASE_VIDIOC_PRIVATE + 14, __u32)
|
|
#define RKMODULE_GET_VICAP_RST_INFO \
|
_IOR('V', BASE_VIDIOC_PRIVATE + 15, struct rkmodule_vicap_reset_info)
|
|
#define RKMODULE_SET_VICAP_RST_INFO \
|
_IOW('V', BASE_VIDIOC_PRIVATE + 16, struct rkmodule_vicap_reset_info)
|
|
#define RKMODULE_GET_BT656_MBUS_INFO \
|
_IOR('V', BASE_VIDIOC_PRIVATE + 17, struct rkmodule_bt656_mbus_info)
|
|
#define RKMODULE_GET_DCG_RATIO \
|
_IOR('V', BASE_VIDIOC_PRIVATE + 18, struct rkmodule_dcg_ratio)
|
|
#define RKMODULE_GET_SONY_BRL \
|
_IOR('V', BASE_VIDIOC_PRIVATE + 19, __u32)
|
|
/**
|
* struct rkmodule_base_inf - module base information
|
*
|
*/
|
struct rkmodule_base_inf {
|
char sensor[RKMODULE_NAME_LEN];
|
char module[RKMODULE_NAME_LEN];
|
char lens[RKMODULE_NAME_LEN];
|
} __attribute__ ((packed));
|
|
/**
|
* struct rkmodule_fac_inf - module factory information
|
*
|
*/
|
struct rkmodule_fac_inf {
|
__u32 flag;
|
|
char module[RKMODULE_NAME_LEN];
|
char lens[RKMODULE_NAME_LEN];
|
__u32 year;
|
__u32 month;
|
__u32 day;
|
} __attribute__ ((packed));
|
|
/**
|
* struct rkmodule_awb_inf - module awb information
|
*
|
*/
|
struct rkmodule_awb_inf {
|
__u32 flag;
|
|
__u32 r_value;
|
__u32 b_value;
|
__u32 gr_value;
|
__u32 gb_value;
|
|
__u32 golden_r_value;
|
__u32 golden_b_value;
|
__u32 golden_gr_value;
|
__u32 golden_gb_value;
|
} __attribute__ ((packed));
|
|
/**
|
* struct rkmodule_lsc_inf - module lsc information
|
*
|
*/
|
struct rkmodule_lsc_inf {
|
__u32 flag;
|
|
__u16 lsc_w;
|
__u16 lsc_h;
|
__u16 decimal_bits;
|
|
__u16 lsc_r[RKMODULE_LSCDATA_LEN];
|
__u16 lsc_b[RKMODULE_LSCDATA_LEN];
|
__u16 lsc_gr[RKMODULE_LSCDATA_LEN];
|
__u16 lsc_gb[RKMODULE_LSCDATA_LEN];
|
|
__u16 width;
|
__u16 height;
|
__u16 table_size;
|
} __attribute__ ((packed));
|
|
/**
|
* enum rkmodule_af_dir - enum of module af otp direction
|
*/
|
enum rkmodele_af_otp_dir {
|
AF_OTP_DIR_HORIZONTAL = 0,
|
AF_OTP_DIR_UP = 1,
|
AF_OTP_DIR_DOWN = 2,
|
};
|
|
/**
|
* struct rkmodule_af_otp - module af otp in one direction
|
*/
|
struct rkmodule_af_otp {
|
__u32 vcm_start;
|
__u32 vcm_end;
|
__u32 vcm_dir;
|
};
|
|
/**
|
* struct rkmodule_af_inf - module af information
|
*
|
*/
|
struct rkmodule_af_inf {
|
__u32 flag;
|
__u32 dir_cnt;
|
struct rkmodule_af_otp af_otp[RKMODULE_AF_OTP_MAX_LEN];
|
} __attribute__ ((packed));
|
|
/**
|
* struct rkmodule_pdaf_inf - module pdaf information
|
*
|
*/
|
struct rkmodule_pdaf_inf {
|
__u32 flag;
|
|
__u32 gainmap_width;
|
__u32 gainmap_height;
|
__u32 dccmap_width;
|
__u32 dccmap_height;
|
__u32 dcc_mode;
|
__u32 dcc_dir;
|
__u16 gainmap[RKMODULE_PADF_GAINMAP_LEN];
|
__u16 dccmap[RKMODULE_PDAF_DCCMAP_LEN];
|
} __attribute__ ((packed));
|
|
/**
|
* struct rkmodule_otp_module_inf - otp module info
|
*
|
*/
|
struct rkmodule_otp_module_inf {
|
__u32 flag;
|
__u8 vendor[8];
|
__u32 module_id;
|
__u16 version;
|
__u16 full_width;
|
__u16 full_height;
|
__u8 supplier_id;
|
__u8 year;
|
__u8 mouth;
|
__u8 day;
|
__u8 sensor_id;
|
__u8 lens_id;
|
__u8 vcm_id;
|
__u8 drv_id;
|
__u8 flip;
|
} __attribute__ ((packed));
|
|
/**
|
* struct rkmodule_inf - module information
|
*
|
*/
|
struct rkmodule_inf {
|
struct rkmodule_base_inf base;
|
struct rkmodule_fac_inf fac;
|
struct rkmodule_awb_inf awb;
|
struct rkmodule_lsc_inf lsc;
|
struct rkmodule_af_inf af;
|
struct rkmodule_pdaf_inf pdaf;
|
struct rkmodule_otp_module_inf module_inf;
|
} __attribute__ ((packed));
|
|
/**
|
* struct rkmodule_awb_inf - module awb information
|
*
|
*/
|
struct rkmodule_awb_cfg {
|
__u32 enable;
|
__u32 golden_r_value;
|
__u32 golden_b_value;
|
__u32 golden_gr_value;
|
__u32 golden_gb_value;
|
} __attribute__ ((packed));
|
|
/**
|
* struct rkmodule_af_cfg
|
*
|
*/
|
struct rkmodule_af_cfg {
|
__u32 enable;
|
__u32 vcm_start;
|
__u32 vcm_end;
|
__u32 vcm_dir;
|
} __attribute__ ((packed));
|
|
/**
|
* struct rkmodule_lsc_cfg
|
*
|
*/
|
struct rkmodule_lsc_cfg {
|
__u32 enable;
|
} __attribute__ ((packed));
|
|
/**
|
* NO_HDR: linear mode
|
* HDR_X2: hdr two frame or line mode
|
* HDR_X3: hdr three or line mode
|
*/
|
enum rkmodule_hdr_mode {
|
NO_HDR = 0,
|
HDR_X2 = 5,
|
HDR_X3 = 6,
|
};
|
|
/**
|
* HDR_NORMAL_VC: hdr frame with diff virtual channels
|
* HDR_LINE_CNT: hdr frame with line counter
|
* HDR_ID_CODE: hdr frame with identification code
|
*/
|
enum hdr_esp_mode {
|
HDR_NORMAL_VC = 0,
|
HDR_LINE_CNT,
|
HDR_ID_CODE,
|
};
|
|
/**
|
* lcnt: line counter
|
* padnum: the pixels of padding row
|
* padpix: the payload of padding
|
* idcd: identification code
|
* efpix: identification code of Effective line
|
* obpix: identification code of OB line
|
*/
|
struct rkmodule_hdr_esp {
|
enum hdr_esp_mode mode;
|
union {
|
struct {
|
__u32 padnum;
|
__u32 padpix;
|
} lcnt;
|
struct {
|
__u32 efpix;
|
__u32 obpix;
|
} idcd;
|
} val;
|
};
|
|
struct rkmodule_hdr_cfg {
|
__u32 hdr_mode;
|
struct rkmodule_hdr_esp esp;
|
} __attribute__ ((packed));
|
|
/* sensor lvds sync code
|
* sav: start of active video codes
|
* eav: end of active video codes
|
*/
|
struct rkmodule_sync_code {
|
__u16 sav;
|
__u16 eav;
|
};
|
|
/* sensor lvds difference sync code mode
|
* LS_FIRST: valid line ls-le or sav-eav
|
* invalid line fs-fe or sav-eav
|
* FS_FIRST: valid line fs-le
|
* invalid line ls-fe
|
* ls: line start
|
* le: line end
|
* fs: frame start
|
* fe: frame end
|
* SONY_DOL_HDR_1: sony dol hdr pattern 1
|
* SONY_DOL_HDR_2: sony dol hdr pattern 2
|
*/
|
enum rkmodule_lvds_mode {
|
LS_FIRST = 0,
|
FS_FIRST,
|
SONY_DOL_HDR_1,
|
SONY_DOL_HDR_2
|
};
|
|
/* sync code of different frame type (hdr or linear) for lvds
|
* act: valid line sync code
|
* blk: invalid line sync code
|
*/
|
struct rkmodule_lvds_frm_sync_code {
|
struct rkmodule_sync_code act;
|
struct rkmodule_sync_code blk;
|
};
|
|
/* sync code for lvds of sensor
|
* odd_sync_code: sync code of odd frame id for lvds of sony sensor
|
* even_sync_code: sync code of even frame id for lvds of sony sensor
|
*/
|
struct rkmodule_lvds_frame_sync_code {
|
struct rkmodule_lvds_frm_sync_code odd_sync_code;
|
struct rkmodule_lvds_frm_sync_code even_sync_code;
|
};
|
|
/* lvds sync code category of sensor for different operation */
|
enum rkmodule_lvds_sync_code_group {
|
LVDS_CODE_GRP_LINEAR = 0x0,
|
LVDS_CODE_GRP_LONG,
|
LVDS_CODE_GRP_MEDIUM,
|
LVDS_CODE_GRP_SHORT,
|
LVDS_CODE_GRP_MAX
|
};
|
|
/* struct rkmodule_lvds_cfg
|
* frm_sync_code[index]:
|
* index == LVDS_CODE_GRP_LONG:
|
* sync code for frame of linear mode or for long frame of hdr mode
|
* index == LVDS_CODE_GRP_MEDIUM:
|
* sync code for medium long frame of hdr mode
|
* index == LVDS_CODE_GRP_SHOR:
|
* sync code for short long frame of hdr mode
|
*/
|
struct rkmodule_lvds_cfg {
|
enum rkmodule_lvds_mode mode;
|
struct rkmodule_lvds_frame_sync_code frm_sync_code[LVDS_CODE_GRP_MAX];
|
} __attribute__ ((packed));
|
|
/**
|
* struct rkmodule_dpcc_cfg
|
* enable: 0 -> disable dpcc, 1 -> enable multiple,
|
* 2 -> enable single, 3 -> enable all;
|
* cur_single_dpcc: the strength of single dpcc;
|
* cur_multiple_dpcc: the strength of multiple dpcc;
|
* total_dpcc: the max strength;
|
*/
|
struct rkmodule_dpcc_cfg {
|
__u32 enable;
|
__u32 cur_single_dpcc;
|
__u32 cur_multiple_dpcc;
|
__u32 total_dpcc;
|
} __attribute__ ((packed));
|
|
/**
|
* nr switch by gain
|
* direct: 0 -> up_thres LSNR to HSNR, 1 -> up_thres HSNR to LSNR
|
* up_thres: threshold of nr change from low gain to high gain
|
* down_thres: threshold of nr change from high gain to low gain;
|
* div_coeff: Coefficients converted from float to int
|
*/
|
struct rkmodule_nr_switch_threshold {
|
__u32 direct;
|
__u32 up_thres;
|
__u32 down_thres;
|
__u32 div_coeff;
|
} __attribute__ ((packed));
|
|
/**
|
* enum rkmodule_bt656_intf_type
|
* to support sony bt656 raw
|
*/
|
enum rkmodule_bt656_intf_type {
|
BT656_STD_RAW = 0,
|
BT656_SONY_RAW,
|
};
|
|
/**
|
* struct rkmodule_vc_fmt_info - virtual channels fmt info
|
*
|
*/
|
struct rkmodule_vc_fmt_info {
|
__u32 width[RKMODULE_MAX_VC_CH];
|
__u32 height[RKMODULE_MAX_VC_CH];
|
__u32 fps[RKMODULE_MAX_VC_CH];
|
} __attribute__ ((packed));
|
|
/**
|
* struct rkmodule_vc_hotplug_info - virtual channels hotplug status info
|
* detect_status: hotplug status
|
* bit 0~3 means channels id, value : 0 -> plug out, 1 -> plug in.
|
*/
|
struct rkmodule_vc_hotplug_info {
|
__u8 detect_status;
|
} __attribute__ ((packed));
|
|
|
/* sensor start stream sequence
|
* RKMODULE_START_STREAM_DEFAULT: by default
|
* RKMODULE_START_STREAM_BEHIND : sensor start stream should be behind the controller
|
* RKMODULE_START_STREAM_FRONT : sensor start stream should be in front of the controller
|
*/
|
enum rkmodule_start_stream_seq {
|
RKMODULE_START_STREAM_DEFAULT = 0,
|
RKMODULE_START_STREAM_BEHIND,
|
RKMODULE_START_STREAM_FRONT,
|
};
|
|
/*
|
* the causation to do cif reset work
|
*/
|
enum rkmodule_reset_src {
|
RKCIF_RESET_SRC_NON = 0x0,
|
RKCIF_RESET_SRC_ERR_CSI2,
|
RKCIF_RESET_SRC_ERR_LVDS,
|
RKICF_RESET_SRC_ERR_CUTOFF,
|
RKCIF_RESET_SRC_ERR_HOTPLUG,
|
RKCIF_RESET_SRC_ERR_APP,
|
};
|
|
struct rkmodule_vicap_reset_info {
|
__u32 is_reset;
|
enum rkmodule_reset_src src;
|
} __attribute__ ((packed));
|
|
struct rkmodule_bt656_mbus_info {
|
__u32 flags;
|
__u32 id_en_bits;
|
} __attribute__ ((packed));
|
|
/* DCG ratio (float) = integer + decimal / div_coeff */
|
struct rkmodule_dcg_ratio {
|
__u32 integer;
|
__u32 decimal;
|
__u32 div_coeff;
|
};
|
|
#endif /* _RKMODULE_CAMERA_H */
|
