Loading...
1/* SPDX-License-Identifier: GPL-2.0 */
2/*
3 * camss-csid.h
4 *
5 * Qualcomm MSM Camera Subsystem - CSID (CSI Decoder) Module
6 *
7 * Copyright (c) 2011-2014, The Linux Foundation. All rights reserved.
8 * Copyright (C) 2015-2018 Linaro Ltd.
9 */
10#ifndef QC_MSM_CAMSS_CSID_H
11#define QC_MSM_CAMSS_CSID_H
12
13#include <linux/clk.h>
14#include <linux/interrupt.h>
15#include <media/media-entity.h>
16#include <media/v4l2-ctrls.h>
17#include <media/v4l2-device.h>
18#include <media/v4l2-mediabus.h>
19#include <media/v4l2-subdev.h>
20
21#define MSM_CSID_PAD_SINK 0
22#define MSM_CSID_PAD_FIRST_SRC 1
23#define MSM_CSID_PADS_NUM 5
24
25#define MSM_CSID_PAD_SRC (MSM_CSID_PAD_FIRST_SRC)
26
27/* CSID hardware can demultiplex up to 4 outputs */
28#define MSM_CSID_MAX_SRC_STREAMS 4
29
30#define DATA_TYPE_EMBEDDED_DATA_8BIT 0x12
31#define DATA_TYPE_YUV420_8BIT 0x18
32#define DATA_TYPE_YUV420_10BIT 0x19
33#define DATA_TYPE_YUV420_8BIT_LEGACY 0x1a
34#define DATA_TYPE_YUV420_8BIT_SHIFTED 0x1c /* Chroma Shifted Pixel Sampling */
35#define DATA_TYPE_YUV420_10BIT_SHIFTED 0x1d /* Chroma Shifted Pixel Sampling */
36#define DATA_TYPE_YUV422_8BIT 0x1e
37#define DATA_TYPE_YUV422_10BIT 0x1f
38#define DATA_TYPE_RGB444 0x20
39#define DATA_TYPE_RGB555 0x21
40#define DATA_TYPE_RGB565 0x22
41#define DATA_TYPE_RGB666 0x23
42#define DATA_TYPE_RGB888 0x24
43#define DATA_TYPE_RAW_24BIT 0x27
44#define DATA_TYPE_RAW_6BIT 0x28
45#define DATA_TYPE_RAW_7BIT 0x29
46#define DATA_TYPE_RAW_8BIT 0x2a
47#define DATA_TYPE_RAW_10BIT 0x2b
48#define DATA_TYPE_RAW_12BIT 0x2c
49#define DATA_TYPE_RAW_14BIT 0x2d
50#define DATA_TYPE_RAW_16BIT 0x2e
51#define DATA_TYPE_RAW_20BIT 0x2f
52
53#define CSID_RESET_TIMEOUT_MS 500
54
55enum csid_testgen_mode {
56 CSID_PAYLOAD_MODE_DISABLED = 0,
57 CSID_PAYLOAD_MODE_INCREMENTING = 1,
58 CSID_PAYLOAD_MODE_ALTERNATING_55_AA = 2,
59 CSID_PAYLOAD_MODE_ALL_ZEROES = 3,
60 CSID_PAYLOAD_MODE_ALL_ONES = 4,
61 CSID_PAYLOAD_MODE_RANDOM = 5,
62 CSID_PAYLOAD_MODE_USER_SPECIFIED = 6,
63 CSID_PAYLOAD_MODE_NUM_SUPPORTED_GEN1 = 6, /* excluding disabled */
64 CSID_PAYLOAD_MODE_COMPLEX_PATTERN = 7,
65 CSID_PAYLOAD_MODE_COLOR_BOX = 8,
66 CSID_PAYLOAD_MODE_COLOR_BARS = 9,
67 CSID_PAYLOAD_MODE_NUM_SUPPORTED_GEN2 = 9, /* excluding disabled */
68};
69
70struct csid_format {
71 u32 code;
72 u8 data_type;
73 u8 decode_format;
74 u8 bpp;
75 u8 spp; /* bus samples per pixel */
76};
77
78struct csid_testgen_config {
79 enum csid_testgen_mode mode;
80 const char * const*modes;
81 u8 nmodes;
82 u8 enabled;
83};
84
85struct csid_phy_config {
86 u8 csiphy_id;
87 u8 lane_cnt;
88 u32 lane_assign;
89 u32 en_vc;
90 u8 need_vc_update;
91};
92
93struct csid_device;
94
95struct csid_hw_ops {
96 /*
97 * configure_stream - Configures and starts CSID input stream
98 * @csid: CSID device
99 */
100 void (*configure_stream)(struct csid_device *csid, u8 enable);
101
102 /*
103 * configure_testgen_pattern - Validates and configures output pattern mode
104 * of test pattern generator
105 * @csid: CSID device
106 */
107 int (*configure_testgen_pattern)(struct csid_device *csid, s32 val);
108
109 /*
110 * hw_version - Read hardware version register from hardware
111 * @csid: CSID device
112 */
113 u32 (*hw_version)(struct csid_device *csid);
114
115 /*
116 * isr - CSID module interrupt service routine
117 * @irq: Interrupt line
118 * @dev: CSID device
119 *
120 * Return IRQ_HANDLED on success
121 */
122 irqreturn_t (*isr)(int irq, void *dev);
123
124 /*
125 * reset - Trigger reset on CSID module and wait to complete
126 * @csid: CSID device
127 *
128 * Return 0 on success or a negative error code otherwise
129 */
130 int (*reset)(struct csid_device *csid);
131
132 /*
133 * src_pad_code - Pick an output/src format based on the input/sink format
134 * @csid: CSID device
135 * @sink_code: The sink format of the input
136 * @match_format_idx: Request preferred index, as defined by subdevice csid_format.
137 * Set @match_code to 0 if used.
138 * @match_code: Request preferred code, set @match_format_idx to 0 if used
139 *
140 * Return 0 on failure or src format code otherwise
141 */
142 u32 (*src_pad_code)(struct csid_device *csid, u32 sink_code,
143 unsigned int match_format_idx, u32 match_code);
144
145 /*
146 * subdev_init - Initialize CSID device according for hardware revision
147 * @csid: CSID device
148 */
149 void (*subdev_init)(struct csid_device *csid);
150};
151
152struct csid_device {
153 struct camss *camss;
154 u8 id;
155 struct v4l2_subdev subdev;
156 struct media_pad pads[MSM_CSID_PADS_NUM];
157 void __iomem *base;
158 u32 irq;
159 char irq_name[30];
160 struct camss_clock *clock;
161 int nclocks;
162 struct regulator_bulk_data *supplies;
163 int num_supplies;
164 struct completion reset_complete;
165 struct csid_testgen_config testgen;
166 struct csid_phy_config phy;
167 struct v4l2_mbus_framefmt fmt[MSM_CSID_PADS_NUM];
168 struct v4l2_ctrl_handler ctrls;
169 struct v4l2_ctrl *testgen_mode;
170 const struct csid_format *formats;
171 unsigned int nformats;
172 const struct csid_hw_ops *ops;
173};
174
175struct camss_subdev_resources;
176
177/*
178 * csid_find_code - Find a format code in an array using array index or format code
179 * @codes: Array of format codes
180 * @ncodes: Length of @code array
181 * @req_format_idx: Request preferred index, as defined by subdevice csid_format.
182 * Set @match_code to 0 if used.
183 * @match_code: Request preferred code, set @req_format_idx to 0 if used
184 *
185 * Return 0 on failure or format code otherwise
186 */
187u32 csid_find_code(u32 *codes, unsigned int ncode,
188 unsigned int match_format_idx, u32 match_code);
189
190/*
191 * csid_get_fmt_entry - Find csid_format entry with matching format code
192 * @formats: Array of format csid_format entries
193 * @nformats: Length of @nformats array
194 * @code: Desired format code
195 *
196 * Return formats[0] on failure to find code
197 */
198const struct csid_format *csid_get_fmt_entry(const struct csid_format *formats,
199 unsigned int nformats,
200 u32 code);
201
202int msm_csid_subdev_init(struct camss *camss, struct csid_device *csid,
203 const struct camss_subdev_resources *res, u8 id);
204
205int msm_csid_register_entity(struct csid_device *csid,
206 struct v4l2_device *v4l2_dev);
207
208void msm_csid_unregister_entity(struct csid_device *csid);
209
210void msm_csid_get_csid_id(struct media_entity *entity, u8 *id);
211
212extern const char * const csid_testgen_modes[];
213
214extern const struct csid_hw_ops csid_ops_4_1;
215extern const struct csid_hw_ops csid_ops_4_7;
216extern const struct csid_hw_ops csid_ops_gen2;
217
218/*
219 * csid_is_lite - Check if CSID is CSID lite.
220 * @csid: CSID Device
221 *
222 * Return whether CSID is CSID lite
223 */
224bool csid_is_lite(struct csid_device *csid);
225
226#endif /* QC_MSM_CAMSS_CSID_H */