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_PIX = 3,
56 	VFE_LINE_NUM_MAX = 4
57 };
58 
59 struct vfe_output {
60 	u8 wm_num;
61 	u8 wm_idx[3];
62 
63 	struct camss_buffer *buf[2];
64 	struct camss_buffer *last_buffer;
65 	struct list_head pending_bufs;
66 
67 	unsigned int drop_update_idx;
68 
69 	union {
70 		struct {
71 			int active_buf;
72 			int wait_sof;
73 		} gen1;
74 		struct {
75 			int active_num;
76 		} gen2;
77 	};
78 	enum vfe_output_state state;
79 	unsigned int sequence;
80 
81 	int wait_reg_update;
82 	struct completion sof;
83 	struct completion reg_update;
84 };
85 
86 struct vfe_line {
87 	enum vfe_line_id id;
88 	struct v4l2_subdev subdev;
89 	struct media_pad pads[MSM_VFE_PADS_NUM];
90 	struct v4l2_mbus_framefmt fmt[MSM_VFE_PADS_NUM];
91 	struct v4l2_rect compose;
92 	struct v4l2_rect crop;
93 	struct camss_video video_out;
94 	struct vfe_output output;
95 	const struct camss_format_info *formats;
96 	unsigned int nformats;
97 };
98 
99 struct vfe_device;
100 
101 struct vfe_hw_ops {
102 	void (*enable_irq_common)(struct vfe_device *vfe);
103 	void (*global_reset)(struct vfe_device *vfe);
104 	u32 (*hw_version)(struct vfe_device *vfe);
105 	irqreturn_t (*isr)(int irq, void *dev);
106 	void (*isr_read)(struct vfe_device *vfe, u32 *value0, u32 *value1);
107 	void (*pm_domain_off)(struct vfe_device *vfe);
108 	int (*pm_domain_on)(struct vfe_device *vfe);
109 	void (*reg_update)(struct vfe_device *vfe, enum vfe_line_id line_id);
110 	void (*reg_update_clear)(struct vfe_device *vfe,
111 				 enum vfe_line_id line_id);
112 	void (*subdev_init)(struct device *dev, struct vfe_device *vfe);
113 	int (*vfe_disable)(struct vfe_line *line);
114 	int (*vfe_enable)(struct vfe_line *line);
115 	int (*vfe_halt)(struct vfe_device *vfe);
116 	void (*violation_read)(struct vfe_device *vfe);
117 	void (*vfe_wm_stop)(struct vfe_device *vfe, u8 wm);
118 };
119 
120 struct vfe_isr_ops {
121 	void (*reset_ack)(struct vfe_device *vfe);
122 	void (*halt_ack)(struct vfe_device *vfe);
123 	void (*reg_update)(struct vfe_device *vfe, enum vfe_line_id line_id);
124 	void (*sof)(struct vfe_device *vfe, enum vfe_line_id line_id);
125 	void (*comp_done)(struct vfe_device *vfe, u8 comp);
126 	void (*wm_done)(struct vfe_device *vfe, u8 wm);
127 };
128 
129 struct vfe_subdev_resources {
130 	bool is_lite;
131 	u8 line_num;
132 	bool has_pd;
133 	char *pd_name;
134 	const struct vfe_hw_ops *hw_ops;
135 	const struct camss_formats *formats_rdi;
136 	const struct camss_formats *formats_pix;
137 };
138 
139 struct vfe_device {
140 	struct camss *camss;
141 	u8 id;
142 	void __iomem *base;
143 	u32 irq;
144 	char irq_name[30];
145 	struct camss_clock *clock;
146 	int nclocks;
147 	struct completion reset_complete;
148 	struct completion halt_complete;
149 	struct mutex power_lock;
150 	int power_count;
151 	struct mutex stream_lock;
152 	int stream_count;
153 	spinlock_t output_lock;
154 	enum vfe_line_id wm_output_map[MSM_VFE_IMAGE_MASTERS_NUM];
155 	struct vfe_line line[VFE_LINE_NUM_MAX];
156 	u32 reg_update;
157 	u8 was_streaming;
158 	const struct vfe_subdev_resources *res;
159 	const struct vfe_hw_ops_gen1 *ops_gen1;
160 	struct vfe_isr_ops isr_ops;
161 	struct camss_video_ops video_ops;
162 	struct device *genpd;
163 	struct device_link *genpd_link;
164 };
165 
166 struct camss_subdev_resources;
167 
168 int msm_vfe_subdev_init(struct camss *camss, struct vfe_device *vfe,
169 			const struct camss_subdev_resources *res, u8 id);
170 
171 void msm_vfe_genpd_cleanup(struct vfe_device *vfe);
172 
173 int msm_vfe_register_entities(struct vfe_device *vfe,
174 			      struct v4l2_device *v4l2_dev);
175 
176 void msm_vfe_unregister_entities(struct vfe_device *vfe);
177 
178 /*
179  * vfe_buf_add_pending - Add output buffer to list of pending
180  * @output: VFE output
181  * @buffer: Video buffer
182  */
183 void vfe_buf_add_pending(struct vfe_output *output, struct camss_buffer *buffer);
184 
185 struct camss_buffer *vfe_buf_get_pending(struct vfe_output *output);
186 
187 int vfe_flush_buffers(struct camss_video *vid, enum vb2_buffer_state state);
188 
189 /*
190  * vfe_isr_comp_done - Process composite image done interrupt
191  * @vfe: VFE Device
192  * @comp: Composite image id
193  */
194 void vfe_isr_comp_done(struct vfe_device *vfe, u8 comp);
195 
196 void vfe_isr_reset_ack(struct vfe_device *vfe);
197 int vfe_put_output(struct vfe_line *line);
198 int vfe_release_wm(struct vfe_device *vfe, u8 wm);
199 int vfe_reserve_wm(struct vfe_device *vfe, enum vfe_line_id line_id);
200 
201 /*
202  * vfe_reset - Trigger reset on VFE module and wait to complete
203  * @vfe: VFE device
204  *
205  * Return 0 on success or a negative error code otherwise
206  */
207 int vfe_reset(struct vfe_device *vfe);
208 
209 /*
210  * vfe_disable - Disable streaming on VFE line
211  * @line: VFE line
212  *
213  * Return 0 on success or a negative error code otherwise
214  */
215 int vfe_disable(struct vfe_line *line);
216 
217 /*
218  * vfe_pm_domain_off - Disable power domains specific to this VFE.
219  * @vfe: VFE Device
220  */
221 void vfe_pm_domain_off(struct vfe_device *vfe);
222 
223 /*
224  * vfe_pm_domain_on - Enable power domains specific to this VFE.
225  * @vfe: VFE Device
226  */
227 int vfe_pm_domain_on(struct vfe_device *vfe);
228 
229 extern const struct camss_formats vfe_formats_rdi_8x16;
230 extern const struct camss_formats vfe_formats_pix_8x16;
231 extern const struct camss_formats vfe_formats_rdi_8x96;
232 extern const struct camss_formats vfe_formats_pix_8x96;
233 extern const struct camss_formats vfe_formats_rdi_845;
234 extern const struct camss_formats vfe_formats_pix_845;
235 
236 extern const struct vfe_hw_ops vfe_ops_4_1;
237 extern const struct vfe_hw_ops vfe_ops_4_7;
238 extern const struct vfe_hw_ops vfe_ops_4_8;
239 extern const struct vfe_hw_ops vfe_ops_170;
240 extern const struct vfe_hw_ops vfe_ops_480;
241 
242 int vfe_get(struct vfe_device *vfe);
243 void vfe_put(struct vfe_device *vfe);
244 
245 /*
246  * vfe_is_lite - Return if VFE is VFE lite.
247  * @vfe: VFE Device
248  *
249  * Some VFE lites have a different register layout.
250  *
251  * Return whether VFE is VFE lite
252  */
253 bool vfe_is_lite(struct vfe_device *vfe);
254 
255 #endif /* QC_MSM_CAMSS_VFE_H */
256