drivers/media/platform/qcom/camss/camss-vfe.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /*
   3  * camss-vfe.h
   4  *
   5  * Qualcomm MSM Camera Subsystem - VFE (Video Front End) Module
   6  *
   7  * Copyright (c) 2013-2015, The Linux Foundation. All rights reserved.
   8  * Copyright (C) 2015-2018 Linaro Ltd.
   9  */
  10 #ifndef QC_MSM_CAMSS_VFE_H
  11 #define QC_MSM_CAMSS_VFE_H
  12
  13 #include <linux/clk.h>
  14 #include <linux/spinlock_types.h>
  15 #include <media/media-entity.h>
  16 #include <media/v4l2-device.h>
  17 #include <media/v4l2-subdev.h>
  18
  19 #include "camss-video.h"
  20 #include "camss-vfe-gen1.h"
  21
  22 #define MSM_VFE_PAD_SINK 0
  23 #define MSM_VFE_PAD_SRC 1
  24 #define MSM_VFE_PADS_NUM 2
  25
  26 #define MSM_VFE_IMAGE_MASTERS_NUM 7
  27 #define MSM_VFE_COMPOSITE_IRQ_NUM 4
  28
  29 /* VFE halt timeout */
  30 #define VFE_HALT_TIMEOUT_MS 100
  31 /* Frame drop value. VAL + UPDATES - 1 should not exceed 31 */
  32 #define VFE_FRAME_DROP_VAL 30
  33
  34 #define vfe_line_array(ptr_line)        \
  35         ((const struct vfe_line (*)[]) &(ptr_line)[-(ptr_line)->id])
  36
  37 #define to_vfe(ptr_line)        \
  38         container_of(vfe_line_array(ptr_line), struct vfe_device, line)
  39
  40 enum vfe_output_state {
  41         VFE_OUTPUT_OFF,
  42         VFE_OUTPUT_RESERVED,
  43         VFE_OUTPUT_SINGLE,
  44         VFE_OUTPUT_CONTINUOUS,
  45         VFE_OUTPUT_IDLE,
  46         VFE_OUTPUT_STOPPING,
  47         VFE_OUTPUT_ON,
  48 };
  49
  50 enum vfe_line_id {
  51         VFE_LINE_NONE = -1,
  52         VFE_LINE_RDI0 = 0,
  53         VFE_LINE_RDI1 = 1,
  54         VFE_LINE_RDI2 = 2,
  55         VFE_LINE_NUM_GEN2 = 3,
  56         VFE_LINE_PIX = 3,
  57         VFE_LINE_NUM_GEN1 = 4,
  58         VFE_LINE_NUM_MAX = 4
  59 };
  60
  61 struct vfe_output {
  62         u8 wm_num;
  63         u8 wm_idx[3];
  64
  65         struct camss_buffer *buf[2];
  66         struct camss_buffer *last_buffer;
  67         struct list_head pending_bufs;
  68
  69         unsigned int drop_update_idx;
  70
  71         union {
  72                 struct {
  73                         int active_buf;
  74                         int wait_sof;
  75                 } gen1;
  76                 struct {
  77                         int active_num;
  78                 } gen2;
  79         };
  80         enum vfe_output_state state;
  81         unsigned int sequence;
  82
  83         int wait_reg_update;
  84         struct completion sof;
  85         struct completion reg_update;
  86 };
  87
  88 struct vfe_line {
  89         enum vfe_line_id id;
  90         struct v4l2_subdev subdev;
  91         struct media_pad pads[MSM_VFE_PADS_NUM];
  92         struct v4l2_mbus_framefmt fmt[MSM_VFE_PADS_NUM];
  93         struct v4l2_rect compose;
  94         struct v4l2_rect crop;
  95         struct camss_video video_out;
  96         struct vfe_output output;
  97         const struct vfe_format *formats;
  98         unsigned int nformats;
  99 };
 100
 101 struct vfe_device;
 102
 103 struct vfe_hw_ops {
 104         void (*enable_irq_common)(struct vfe_device *vfe);
 105         void (*global_reset)(struct vfe_device *vfe);
 106         void (*hw_version_read)(struct vfe_device *vfe, struct device *dev);
 107         irqreturn_t (*isr)(int irq, void *dev);
 108         void (*isr_read)(struct vfe_device *vfe, u32 *value0, u32 *value1);
 109         void (*pm_domain_off)(struct vfe_device *vfe);
 110         int (*pm_domain_on)(struct vfe_device *vfe);
 111         void (*reg_update)(struct vfe_device *vfe, enum vfe_line_id line_id);
 112         void (*reg_update_clear)(struct vfe_device *vfe,
 113                                  enum vfe_line_id line_id);
 114         void (*subdev_init)(struct device *dev, struct vfe_device *vfe);
 115         int (*vfe_disable)(struct vfe_line *line);
 116         int (*vfe_enable)(struct vfe_line *line);
 117         int (*vfe_halt)(struct vfe_device *vfe);
 118         void (*violation_read)(struct vfe_device *vfe);
 119 };
 120
 121 struct vfe_isr_ops {
 122         void (*reset_ack)(struct vfe_device *vfe);
 123         void (*halt_ack)(struct vfe_device *vfe);
 124         void (*reg_update)(struct vfe_device *vfe, enum vfe_line_id line_id);
 125         void (*sof)(struct vfe_device *vfe, enum vfe_line_id line_id);
 126         void (*comp_done)(struct vfe_device *vfe, u8 comp);
 127         void (*wm_done)(struct vfe_device *vfe, u8 wm);
 128 };
 129
 130 struct vfe_device {
 131         struct camss *camss;
 132         u8 id;
 133         void __iomem *base;
 134         u32 irq;
 135         char irq_name[30];
 136         struct camss_clock *clock;
 137         int nclocks;
 138         struct completion reset_complete;
 139         struct completion halt_complete;
 140         struct mutex power_lock;
 141         int power_count;
 142         struct mutex stream_lock;
 143         int stream_count;
 144         spinlock_t output_lock;
 145         enum vfe_line_id wm_output_map[MSM_VFE_IMAGE_MASTERS_NUM];
 146         struct vfe_line line[VFE_LINE_NUM_MAX];
 147         u8 line_num;
 148         u32 reg_update;
 149         u8 was_streaming;
 150         const struct vfe_hw_ops *ops;
 151         const struct vfe_hw_ops_gen1 *ops_gen1;
 152         struct vfe_isr_ops isr_ops;
 153         struct camss_video_ops video_ops;
 154 };
 155
 156 struct resources;
 157
 158 int msm_vfe_subdev_init(struct camss *camss, struct vfe_device *vfe,
 159                         const struct resources *res, u8 id);
 160
 161 int msm_vfe_register_entities(struct vfe_device *vfe,
 162                               struct v4l2_device *v4l2_dev);
 163
 164 void msm_vfe_unregister_entities(struct vfe_device *vfe);
 165
 166 void msm_vfe_get_vfe_id(struct media_entity *entity, u8 *id);
 167 void msm_vfe_get_vfe_line_id(struct media_entity *entity, enum vfe_line_id *id);
 168
 169 /*
 170  * vfe_buf_add_pending - Add output buffer to list of pending
 171  * @output: VFE output
 172  * @buffer: Video buffer
 173  */
 174 void vfe_buf_add_pending(struct vfe_output *output, struct camss_buffer *buffer);
 175
 176 struct camss_buffer *vfe_buf_get_pending(struct vfe_output *output);
 177
 178 int vfe_flush_buffers(struct camss_video *vid, enum vb2_buffer_state state);
 179
 180 /*
 181  * vfe_isr_comp_done - Process composite image done interrupt
 182  * @vfe: VFE Device
 183  * @comp: Composite image id
 184  */
 185 void vfe_isr_comp_done(struct vfe_device *vfe, u8 comp);
 186
 187 void vfe_isr_reset_ack(struct vfe_device *vfe);
 188 int vfe_put_output(struct vfe_line *line);
 189 int vfe_release_wm(struct vfe_device *vfe, u8 wm);
 190 int vfe_reserve_wm(struct vfe_device *vfe, enum vfe_line_id line_id);
 191
 192 /*
 193  * vfe_reset - Trigger reset on VFE module and wait to complete
 194  * @vfe: VFE device
 195  *
 196  * Return 0 on success or a negative error code otherwise
 197  */
 198 int vfe_reset(struct vfe_device *vfe);
 199
 200 extern const struct vfe_hw_ops vfe_ops_4_1;
 201 extern const struct vfe_hw_ops vfe_ops_4_7;
 202 extern const struct vfe_hw_ops vfe_ops_4_8;
 203 extern const struct vfe_hw_ops vfe_ops_170;
 204
 205 #endif /* QC_MSM_CAMSS_VFE_H */