Loading...
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
40enum 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
50enum 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
59struct 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
86struct 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 vfe_format *formats;
96 unsigned int nformats;
97};
98
99struct vfe_device;
100
101struct 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
120struct 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
129struct vfe_device {
130 struct camss *camss;
131 u8 id;
132 void __iomem *base;
133 u32 irq;
134 char irq_name[30];
135 struct camss_clock *clock;
136 int nclocks;
137 struct completion reset_complete;
138 struct completion halt_complete;
139 struct mutex power_lock;
140 int power_count;
141 struct mutex stream_lock;
142 int stream_count;
143 spinlock_t output_lock;
144 enum vfe_line_id wm_output_map[MSM_VFE_IMAGE_MASTERS_NUM];
145 struct vfe_line line[VFE_LINE_NUM_MAX];
146 u8 line_num;
147 u32 reg_update;
148 u8 was_streaming;
149 const struct vfe_hw_ops *ops;
150 const struct vfe_hw_ops_gen1 *ops_gen1;
151 struct vfe_isr_ops isr_ops;
152 struct camss_video_ops video_ops;
153 struct device *genpd;
154 struct device_link *genpd_link;
155};
156
157struct camss_subdev_resources;
158
159int msm_vfe_subdev_init(struct camss *camss, struct vfe_device *vfe,
160 const struct camss_subdev_resources *res, u8 id);
161
162void msm_vfe_genpd_cleanup(struct vfe_device *vfe);
163
164int msm_vfe_register_entities(struct vfe_device *vfe,
165 struct v4l2_device *v4l2_dev);
166
167void msm_vfe_unregister_entities(struct vfe_device *vfe);
168
169/*
170 * vfe_buf_add_pending - Add output buffer to list of pending
171 * @output: VFE output
172 * @buffer: Video buffer
173 */
174void vfe_buf_add_pending(struct vfe_output *output, struct camss_buffer *buffer);
175
176struct camss_buffer *vfe_buf_get_pending(struct vfe_output *output);
177
178int 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 */
185void vfe_isr_comp_done(struct vfe_device *vfe, u8 comp);
186
187void vfe_isr_reset_ack(struct vfe_device *vfe);
188int vfe_put_output(struct vfe_line *line);
189int vfe_release_wm(struct vfe_device *vfe, u8 wm);
190int 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 */
198int vfe_reset(struct vfe_device *vfe);
199
200/*
201 * vfe_disable - Disable streaming on VFE line
202 * @line: VFE line
203 *
204 * Return 0 on success or a negative error code otherwise
205 */
206int vfe_disable(struct vfe_line *line);
207
208/*
209 * vfe_pm_domain_off - Disable power domains specific to this VFE.
210 * @vfe: VFE Device
211 */
212void vfe_pm_domain_off(struct vfe_device *vfe);
213
214/*
215 * vfe_pm_domain_on - Enable power domains specific to this VFE.
216 * @vfe: VFE Device
217 */
218int vfe_pm_domain_on(struct vfe_device *vfe);
219
220extern const struct vfe_hw_ops vfe_ops_4_1;
221extern const struct vfe_hw_ops vfe_ops_4_7;
222extern const struct vfe_hw_ops vfe_ops_4_8;
223extern const struct vfe_hw_ops vfe_ops_170;
224extern const struct vfe_hw_ops vfe_ops_480;
225
226int vfe_get(struct vfe_device *vfe);
227void vfe_put(struct vfe_device *vfe);
228
229/*
230 * vfe_is_lite - Return if VFE is VFE lite.
231 * @vfe: VFE Device
232 *
233 * Some VFE lites have a different register layout.
234 *
235 * Return whether VFE is VFE lite
236 */
237bool vfe_is_lite(struct vfe_device *vfe);
238
239#endif /* QC_MSM_CAMSS_VFE_H */