2 * Support for Medifield PNW Camera Imaging ISP subsystem.
4 * Copyright (c) 2010 Intel Corporation. All Rights Reserved.
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License version
8 * 2 as published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
17 #ifndef __ATOMISP_SUBDEV_H__
18 #define __ATOMISP_SUBDEV_H__
20 #include <media/v4l2-ctrls.h>
21 #include <media/v4l2-device.h>
22 #include <media/v4l2-subdev.h>
23 #include <media/videobuf-core.h>
25 #include "atomisp_common.h"
26 #include "atomisp_compat.h"
27 #include "atomisp_v4l2.h"
31 /* EXP_ID's ranger is 1 ~ 250 */
32 #define ATOMISP_MAX_EXP_ID (250)
33 enum atomisp_subdev_input_entity {
34 ATOMISP_SUBDEV_INPUT_NONE,
35 ATOMISP_SUBDEV_INPUT_MEMORY,
36 ATOMISP_SUBDEV_INPUT_CSI2,
38 * The following enum for CSI2 port must go together in one row.
39 * Otherwise it breaks the code logic.
41 ATOMISP_SUBDEV_INPUT_CSI2_PORT1,
42 ATOMISP_SUBDEV_INPUT_CSI2_PORT2,
43 ATOMISP_SUBDEV_INPUT_CSI2_PORT3,
46 #define ATOMISP_SUBDEV_PAD_SINK 0
47 /* capture output for still frames */
48 #define ATOMISP_SUBDEV_PAD_SOURCE_CAPTURE 1
49 /* viewfinder output for downscaled capture output */
50 #define ATOMISP_SUBDEV_PAD_SOURCE_VF 2
51 /* preview output for display */
52 #define ATOMISP_SUBDEV_PAD_SOURCE_PREVIEW 3
53 /* main output for video pipeline */
54 #define ATOMISP_SUBDEV_PAD_SOURCE_VIDEO 4
55 #define ATOMISP_SUBDEV_PADS_NUM 5
57 struct atomisp_in_fmt_conv {
59 uint8_t bpp; /* bits per pixel */
60 uint8_t depth; /* uncompressed */
61 enum atomisp_css_stream_format atomisp_in_fmt;
62 enum atomisp_css_bayer_order bayer_order;
63 enum ia_css_stream_format css_stream_fmt;
66 struct atomisp_sub_device;
68 struct atomisp_video_pipe {
69 struct video_device vdev;
70 enum v4l2_buf_type type;
72 struct videobuf_queue capq;
73 struct videobuf_queue outq;
74 struct list_head activeq;
75 struct list_head activeq_out;
77 * the buffers waiting for per-frame parameters, this is only valid
78 * in per-frame setting mode.
80 struct list_head buffers_waiting_for_param;
81 /* the link list to store per_frame parameters */
82 struct list_head per_frame_params;
84 unsigned int buffers_in_css;
86 /* irq_lock is used to protect video buffer state change operations and
87 * also to make activeq, activeq_out, capq and outq list
88 * operations atomic. */
92 struct atomisp_device *isp;
93 struct v4l2_pix_format pix;
96 struct atomisp_sub_device *asd;
99 * This frame_config_id is got from CSS when dequueues buffers from CSS,
100 * it is used to indicate which parameter it has applied.
102 unsigned int frame_config_id[VIDEO_MAX_FRAME];
104 * This config id is set when camera HAL enqueues buffer, it has a
105 * non-zero value to indicate which parameter it needs to applu
107 unsigned int frame_request_config_id[VIDEO_MAX_FRAME];
108 struct atomisp_css_params_with_list *frame_params[VIDEO_MAX_FRAME];
112 * move wdt from asd struct to create wdt for each pipe
114 struct timer_list wdt;
115 unsigned int wdt_duration; /* in jiffies */
116 unsigned long wdt_expires;
121 struct atomisp_acc_pipe {
122 struct video_device vdev;
125 struct atomisp_sub_device *asd;
126 struct atomisp_device *isp;
129 struct atomisp_pad_format {
130 struct v4l2_mbus_framefmt fmt;
131 struct v4l2_rect crop;
132 struct v4l2_rect compose;
135 /* Internal states for flash process */
136 enum atomisp_flash_state {
138 ATOMISP_FLASH_REQUESTED,
139 ATOMISP_FLASH_ONGOING,
144 * This structure is used to cache the CSS parameters, it aligns to
145 * struct ia_css_isp_config but without un-supported and deprecated parts.
147 struct atomisp_css_params {
148 struct ia_css_wb_config wb_config;
149 struct ia_css_cc_config cc_config;
150 struct ia_css_tnr_config tnr_config;
151 struct ia_css_ecd_config ecd_config;
152 struct ia_css_ynr_config ynr_config;
153 struct ia_css_fc_config fc_config;
154 struct ia_css_formats_config formats_config;
155 struct ia_css_cnr_config cnr_config;
156 struct ia_css_macc_config macc_config;
157 struct ia_css_ctc_config ctc_config;
158 struct ia_css_aa_config aa_config;
159 struct ia_css_aa_config baa_config;
160 struct ia_css_ce_config ce_config;
161 struct ia_css_ob_config ob_config;
162 struct ia_css_dp_config dp_config;
163 struct ia_css_de_config de_config;
164 struct ia_css_gc_config gc_config;
165 struct ia_css_nr_config nr_config;
166 struct ia_css_ee_config ee_config;
167 struct ia_css_anr_config anr_config;
168 struct ia_css_3a_config s3a_config;
169 struct ia_css_xnr_config xnr_config;
170 struct ia_css_dz_config dz_config;
171 struct ia_css_cc_config yuv2rgb_cc_config;
172 struct ia_css_cc_config rgb2yuv_cc_config;
173 struct ia_css_macc_table macc_table;
174 struct ia_css_gamma_table gamma_table;
175 struct ia_css_ctc_table ctc_table;
177 struct ia_css_xnr_table xnr_table;
178 struct ia_css_rgb_gamma_table r_gamma_table;
179 struct ia_css_rgb_gamma_table g_gamma_table;
180 struct ia_css_rgb_gamma_table b_gamma_table;
182 struct ia_css_vector motion_vector;
183 struct ia_css_anr_thres anr_thres;
185 struct ia_css_dvs_6axis_config *dvs_6axis;
186 struct ia_css_dvs2_coefficients *dvs2_coeff;
187 struct ia_css_shading_table *shading_table;
188 struct ia_css_morph_table *morph_table;
191 * Used to store the user pointer address of the frame. driver needs to
192 * translate to ia_css_frame * and then set to CSS.
195 uint32_t isp_config_id;
197 /* Indicates which parameters need to be updated. */
198 struct atomisp_parameters update_flag;
201 struct atomisp_subdev_params {
202 /* FIXME: Determines whether raw capture buffer are being passed to
203 * user space. Unimplemented for now. */
206 unsigned int color_effect;
216 unsigned int histogram_elenum;
218 /* Current grid info */
219 struct atomisp_css_grid_info curr_grid_info;
220 enum atomisp_css_pipe_id s3a_enabled_pipe;
222 int s3a_output_bytes;
224 bool dis_proj_data_valid;
226 struct ia_css_dz_config dz_config; /** Digital Zoom */
227 struct ia_css_capture_config capture_config;
229 struct atomisp_css_isp_config config;
231 /* current configurations */
232 struct atomisp_css_params css_param;
235 * Intermediate buffers used to communicate data between
236 * CSS and user space.
238 struct ia_css_3a_statistics *s3a_user_stat;
240 void *metadata_user[ATOMISP_METADATA_TYPE_NUM];
241 uint32_t metadata_width_size;
243 struct ia_css_dvs2_statistics *dvs_stat;
244 struct atomisp_css_dvs_6axis *dvs_6axis;
246 int dvs_hor_coef_bytes;
247 int dvs_ver_coef_bytes;
248 int dvs_ver_proj_bytes;
249 int dvs_hor_proj_bytes;
252 int num_flash_frames;
253 enum atomisp_flash_state flash_state;
254 enum atomisp_frame_status last_frame_status;
256 /* continuous capture */
257 struct atomisp_cont_capture_conf offline_parm;
258 /* Flag to check if driver needs to update params to css */
259 bool css_update_params_needed;
262 struct atomisp_css_params_with_list {
263 /* parameters for CSS */
264 struct atomisp_css_params params;
265 struct list_head list;
268 struct atomisp_acc_fw {
269 struct atomisp_css_fw_info *fw;
275 unsigned long css_ptr;
276 } args[ATOMISP_ACC_NR_MEMORY];
277 struct list_head list;
283 struct list_head list;
284 /* FIXME: should keep book which maps are currently used
285 * by binaries and not allow releasing those
286 * which are in use. Implement by reference counting.
290 struct atomisp_sub_device {
291 struct v4l2_subdev subdev;
292 struct media_pad pads[ATOMISP_SUBDEV_PADS_NUM];
293 struct atomisp_pad_format fmt[ATOMISP_SUBDEV_PADS_NUM];
294 uint16_t capture_pad; /* main capture pad; defines much of isp config */
296 enum atomisp_subdev_input_entity input;
298 struct atomisp_video_pipe video_in;
299 struct atomisp_video_pipe video_out_capture; /* capture output */
300 struct atomisp_video_pipe video_out_vf; /* viewfinder output */
301 struct atomisp_video_pipe video_out_preview; /* preview output */
302 struct atomisp_acc_pipe video_acc;
303 /* video pipe main output */
304 struct atomisp_video_pipe video_out_video_capture;
305 /* struct isp_subdev_params params; */
307 struct atomisp_device *isp;
308 struct v4l2_ctrl_handler ctrl_handler;
309 struct v4l2_ctrl *fmt_auto;
310 struct v4l2_ctrl *run_mode;
311 struct v4l2_ctrl *depth_mode;
312 struct v4l2_ctrl *vfpp;
313 struct v4l2_ctrl *continuous_mode;
314 struct v4l2_ctrl *continuous_raw_buffer_size;
315 struct v4l2_ctrl *continuous_viewfinder;
316 struct v4l2_ctrl *enable_raw_buffer_lock;
318 struct v4l2_ctrl *ion_dev_fd;
320 struct v4l2_ctrl *disable_dz;
322 struct v4l2_ctrl *select_isp_version;
327 struct list_head memory_maps;
328 struct atomisp_css_pipeline *pipeline;
331 struct completion acc_done;
335 struct atomisp_subdev_params params;
337 struct atomisp_stream_env stream_env[ATOMISP_INPUT_STREAM_NUM];
339 struct v4l2_pix_format dvs_envelop;
340 unsigned int s3a_bufs_in_css[CSS_PIPE_ID_NUM];
341 unsigned int dis_bufs_in_css;
343 unsigned int metadata_bufs_in_css
344 [ATOMISP_INPUT_STREAM_NUM][CSS_PIPE_ID_NUM];
345 /* The list of free and available metadata buffers for CSS */
346 struct list_head metadata[ATOMISP_METADATA_TYPE_NUM];
347 /* The list of metadata buffers which have been en-queued to CSS */
348 struct list_head metadata_in_css[ATOMISP_METADATA_TYPE_NUM];
349 /* The list of metadata buffers which are ready for userspace to get */
350 struct list_head metadata_ready[ATOMISP_METADATA_TYPE_NUM];
352 /* The list of free and available s3a stat buffers for CSS */
353 struct list_head s3a_stats;
354 /* The list of s3a stat buffers which have been en-queued to CSS */
355 struct list_head s3a_stats_in_css;
356 /* The list of s3a stat buffers which are ready for userspace to get */
357 struct list_head s3a_stats_ready;
359 struct list_head dis_stats;
360 struct list_head dis_stats_in_css;
361 spinlock_t dis_stats_lock;
363 struct atomisp_css_frame *vf_frame; /* TODO: needed? */
364 struct atomisp_css_frame *raw_output_frame;
365 enum atomisp_frame_status frame_status[VIDEO_MAX_FRAME];
367 /* This field specifies which camera (v4l2 input) is selected. */
369 /* This field specifies which sensor is being selected when there
370 are multiple sensors connected to the same MIPI port. */
374 atomic_t sequence; /* Sequence value that is assigned to buffer. */
375 atomic_t sequence_temp;
377 unsigned int streaming; /* Hold both mutex and lock to change this */
378 bool stream_prepared; /* whether css stream is created */
380 /* subdev index: will be used to show which subdev is holding the
381 * resource, like which camera is used by which subdev
385 /* delayed memory allocation for css */
386 struct completion init_done;
387 struct workqueue_struct *delayed_init_workq;
388 unsigned int delayed_init;
389 struct work_struct delayed_init_work;
391 unsigned int latest_preview_exp_id; /* CSS ZSL/SDV raw buffer id */
393 unsigned int mipi_frame_size;
395 bool copy_mode; /* CSI2+ use copy mode */
396 bool yuvpp_mode; /* CSI2+ yuvpp pipe */
398 int raw_buffer_bitmap[ATOMISP_MAX_EXP_ID/32 + 1]; /* Record each Raw Buffer lock status */
399 int raw_buffer_locked_count;
400 spinlock_t raw_buffer_bitmap_lock;
403 struct timer_list wdt;
404 unsigned int wdt_duration; /* in jiffies */
405 unsigned long wdt_expires;
408 struct atomisp_resolution sensor_array_res;
409 bool high_speed_mode; /* Indicate whether now is a high speed mode */
410 int pending_capture_request; /* Indicates the number of pending capture requests. */
414 bool re_trigger_capture;
416 unsigned int preview_exp_id;
417 unsigned int postview_exp_id;
420 extern const struct atomisp_in_fmt_conv atomisp_in_fmt_conv[];
422 u32 atomisp_subdev_uncompressed_code(u32 code);
423 bool atomisp_subdev_is_compressed(u32 code);
424 const struct atomisp_in_fmt_conv *atomisp_find_in_fmt_conv(u32 code);
426 const struct atomisp_in_fmt_conv *atomisp_find_in_fmt_conv_by_atomisp_in_fmt(
427 enum atomisp_css_stream_format atomisp_in_fmt);
429 const struct atomisp_in_fmt_conv
430 *atomisp_find_in_fmt_conv_by_atomisp_in_fmt(enum atomisp_css_stream_format
433 const struct atomisp_in_fmt_conv *atomisp_find_in_fmt_conv_compressed(u32 code);
434 bool atomisp_subdev_format_conversion(struct atomisp_sub_device *asd,
435 unsigned int source_pad);
436 uint16_t atomisp_subdev_source_pad(struct video_device *vdev);
438 /* Get pointer to appropriate format */
439 struct v4l2_mbus_framefmt
440 *atomisp_subdev_get_ffmt(struct v4l2_subdev *sd,
441 struct v4l2_subdev_pad_config *cfg, uint32_t which,
443 struct v4l2_rect *atomisp_subdev_get_rect(struct v4l2_subdev *sd,
444 struct v4l2_subdev_pad_config *cfg,
445 uint32_t which, uint32_t pad,
447 int atomisp_subdev_set_selection(struct v4l2_subdev *sd,
448 struct v4l2_subdev_pad_config *cfg,
449 uint32_t which, uint32_t pad, uint32_t target,
450 uint32_t flags, struct v4l2_rect *r);
451 /* Actually set the format */
452 void atomisp_subdev_set_ffmt(struct v4l2_subdev *sd,
453 struct v4l2_subdev_pad_config *cfg, uint32_t which,
454 uint32_t pad, struct v4l2_mbus_framefmt *ffmt);
456 int atomisp_update_run_mode(struct atomisp_sub_device *asd);
458 void atomisp_subdev_cleanup_pending_events(struct atomisp_sub_device *asd);
460 void atomisp_subdev_unregister_entities(struct atomisp_sub_device *asd);
461 int atomisp_subdev_register_entities(struct atomisp_sub_device *asd,
462 struct v4l2_device *vdev);
463 int atomisp_subdev_init(struct atomisp_device *isp);
464 void atomisp_subdev_cleanup(struct atomisp_device *isp);
465 int atomisp_create_pads_links(struct atomisp_device *isp);
467 #endif /* __ATOMISP_SUBDEV_H__ */