]>
Commit | Line | Data |
---|---|---|
bc125106 HK |
1 | /* |
2 | * Header for M-5MOLS 8M Pixel camera sensor with ISP | |
3 | * | |
4 | * Copyright (C) 2011 Samsung Electronics Co., Ltd. | |
c3070113 | 5 | * Author: HeungJun Kim <riverful.kim@samsung.com> |
bc125106 HK |
6 | * |
7 | * Copyright (C) 2009 Samsung Electronics Co., Ltd. | |
c3070113 | 8 | * Author: Dongsoo Nathaniel Kim <dongsoo45.kim@samsung.com> |
bc125106 HK |
9 | * |
10 | * This program is free software; you can redistribute it and/or modify | |
11 | * it under the terms of the GNU General Public License as published by | |
12 | * the Free Software Foundation; either version 2 of the License, or | |
13 | * (at your option) any later version. | |
14 | */ | |
15 | ||
16 | #ifndef M5MOLS_H | |
17 | #define M5MOLS_H | |
18 | ||
19 | #include <media/v4l2-subdev.h> | |
20 | #include "m5mols_reg.h" | |
21 | ||
22 | extern int m5mols_debug; | |
23 | ||
bc125106 HK |
24 | enum m5mols_restype { |
25 | M5MOLS_RESTYPE_MONITOR, | |
26 | M5MOLS_RESTYPE_CAPTURE, | |
27 | M5MOLS_RESTYPE_MAX, | |
28 | }; | |
29 | ||
30 | /** | |
31 | * struct m5mols_resolution - structure for the resolution | |
32 | * @type: resolution type according to the pixel code | |
33 | * @width: width of the resolution | |
34 | * @height: height of the resolution | |
35 | * @reg: resolution preset register value | |
36 | */ | |
37 | struct m5mols_resolution { | |
38 | u8 reg; | |
39 | enum m5mols_restype type; | |
40 | u16 width; | |
41 | u16 height; | |
42 | }; | |
43 | ||
44 | /** | |
45 | * struct m5mols_exif - structure for the EXIF information of M-5MOLS | |
46 | * @exposure_time: exposure time register value | |
47 | * @shutter_speed: speed of the shutter register value | |
48 | * @aperture: aperture register value | |
49 | * @exposure_bias: it calls also EV bias | |
50 | * @iso_speed: ISO register value | |
51 | * @flash: status register value of the flash | |
52 | * @sdr: status register value of the Subject Distance Range | |
53 | * @qval: not written exact meaning in document | |
54 | */ | |
55 | struct m5mols_exif { | |
56 | u32 exposure_time; | |
57 | u32 shutter_speed; | |
58 | u32 aperture; | |
59 | u32 brightness; | |
60 | u32 exposure_bias; | |
61 | u16 iso_speed; | |
62 | u16 flash; | |
63 | u16 sdr; | |
64 | u16 qval; | |
65 | }; | |
66 | ||
67 | /** | |
68 | * struct m5mols_capture - Structure for the capture capability | |
69 | * @exif: EXIF information | |
70 | * @main: size in bytes of the main image | |
71 | * @thumb: size in bytes of the thumb image, if it was accompanied | |
72 | * @total: total size in bytes of the produced image | |
73 | */ | |
74 | struct m5mols_capture { | |
75 | struct m5mols_exif exif; | |
76 | u32 main; | |
77 | u32 thumb; | |
78 | u32 total; | |
79 | }; | |
80 | ||
81 | /** | |
82 | * struct m5mols_scenemode - structure for the scenemode capability | |
83 | * @metering: metering light register value | |
84 | * @ev_bias: EV bias register value | |
85 | * @wb_mode: mode which means the WhiteBalance is Auto or Manual | |
86 | * @wb_preset: whitebalance preset register value in the Manual mode | |
87 | * @chroma_en: register value whether the Chroma capability is enabled or not | |
88 | * @chroma_lvl: chroma's level register value | |
89 | * @edge_en: register value Whether the Edge capability is enabled or not | |
90 | * @edge_lvl: edge's level register value | |
91 | * @af_range: Auto Focus's range | |
92 | * @fd_mode: Face Detection mode | |
93 | * @mcc: Multi-axis Color Conversion which means emotion color | |
94 | * @light: status of the Light | |
95 | * @flash: status of the Flash | |
96 | * @tone: Tone color which means Contrast | |
97 | * @iso: ISO register value | |
98 | * @capt_mode: Mode of the Image Stabilization while the camera capturing | |
99 | * @wdr: Wide Dynamic Range register value | |
100 | * | |
101 | * The each value according to each scenemode is recommended in the documents. | |
102 | */ | |
103 | struct m5mols_scenemode { | |
57644f56 HK |
104 | u8 metering; |
105 | u8 ev_bias; | |
106 | u8 wb_mode; | |
107 | u8 wb_preset; | |
108 | u8 chroma_en; | |
109 | u8 chroma_lvl; | |
110 | u8 edge_en; | |
111 | u8 edge_lvl; | |
112 | u8 af_range; | |
113 | u8 fd_mode; | |
114 | u8 mcc; | |
115 | u8 light; | |
116 | u8 flash; | |
117 | u8 tone; | |
118 | u8 iso; | |
119 | u8 capt_mode; | |
120 | u8 wdr; | |
bc125106 HK |
121 | }; |
122 | ||
123 | /** | |
124 | * struct m5mols_version - firmware version information | |
125 | * @customer: customer information | |
126 | * @project: version of project information according to customer | |
127 | * @fw: firmware revision | |
128 | * @hw: hardware revision | |
129 | * @param: version of the parameter | |
130 | * @awb: Auto WhiteBalance algorithm version | |
131 | * @str: information about manufacturer and packaging vendor | |
132 | * @af: Auto Focus version | |
133 | * | |
134 | * The register offset starts the customer version at 0x0, and it ends | |
135 | * the awb version at 0x09. The customer, project information occupies 1 bytes | |
136 | * each. And also the fw, hw, param, awb each requires 2 bytes. The str is | |
137 | * unique string associated with firmware's version. It includes information | |
138 | * about manufacturer and the vendor of the sensor's packaging. The least | |
139 | * significant 2 bytes of the string indicate packaging manufacturer. | |
140 | */ | |
141 | #define VERSION_STRING_SIZE 22 | |
142 | struct m5mols_version { | |
143 | u8 customer; | |
144 | u8 project; | |
145 | u16 fw; | |
146 | u16 hw; | |
147 | u16 param; | |
148 | u16 awb; | |
149 | u8 str[VERSION_STRING_SIZE]; | |
150 | u8 af; | |
151 | }; | |
bc125106 HK |
152 | |
153 | /** | |
154 | * struct m5mols_info - M-5MOLS driver data structure | |
155 | * @pdata: platform data | |
156 | * @sd: v4l-subdev instance | |
157 | * @pad: media pad | |
158 | * @ffmt: current fmt according to resolution type | |
159 | * @res_type: current resolution type | |
bc125106 | 160 | * @irq_waitq: waitqueue for the capture |
bc125106 HK |
161 | * @flags: state variable for the interrupt handler |
162 | * @handle: control handler | |
3c5da0ba SN |
163 | * @auto_exposure: auto/manual exposure control |
164 | * @exposure: manual exposure control | |
bc125106 | 165 | * @autowb: Auto White Balance control |
3c5da0ba SN |
166 | * @colorfx: color effect control |
167 | * @saturation: saturation control | |
168 | * @zoom: zoom control | |
bc125106 HK |
169 | * @ver: information of the version |
170 | * @cap: the capture mode attributes | |
171 | * @power: current sensor's power status | |
0f2ee1dd HK |
172 | * @isp_ready: 1 when the ISP controller has completed booting |
173 | * @ctrl_sync: 1 when the control handler state is restored in H/W | |
bc125106 HK |
174 | * @lock_ae: true means the Auto Exposure is locked |
175 | * @lock_awb: true means the Aut WhiteBalance is locked | |
176 | * @resolution: register value for current resolution | |
bc125106 | 177 | * @mode: register value for current operation mode |
bc125106 HK |
178 | * @set_power: optional power callback to the board code |
179 | */ | |
180 | struct m5mols_info { | |
181 | const struct m5mols_platform_data *pdata; | |
182 | struct v4l2_subdev sd; | |
183 | struct media_pad pad; | |
184 | struct v4l2_mbus_framefmt ffmt[M5MOLS_RESTYPE_MAX]; | |
185 | int res_type; | |
5d4294b8 | 186 | |
bc125106 | 187 | wait_queue_head_t irq_waitq; |
ce808a47 | 188 | atomic_t irq_done; |
bc125106 HK |
189 | |
190 | struct v4l2_ctrl_handler handle; | |
3c5da0ba SN |
191 | struct { |
192 | /* exposure/auto-exposure cluster */ | |
193 | struct v4l2_ctrl *auto_exposure; | |
194 | struct v4l2_ctrl *exposure; | |
195 | }; | |
5d4294b8 | 196 | |
3c5da0ba | 197 | struct v4l2_ctrl *auto_wb; |
bc125106 HK |
198 | struct v4l2_ctrl *colorfx; |
199 | struct v4l2_ctrl *saturation; | |
200 | struct v4l2_ctrl *zoom; | |
201 | ||
202 | struct m5mols_version ver; | |
203 | struct m5mols_capture cap; | |
0f2ee1dd HK |
204 | |
205 | unsigned int isp_ready:1; | |
206 | unsigned int power:1; | |
207 | unsigned int ctrl_sync:1; | |
208 | ||
bc125106 HK |
209 | bool lock_ae; |
210 | bool lock_awb; | |
211 | u8 resolution; | |
57644f56 | 212 | u8 mode; |
5d4294b8 | 213 | |
bc125106 HK |
214 | int (*set_power)(struct device *dev, int on); |
215 | }; | |
216 | ||
bc125106 HK |
217 | #define is_available_af(__info) (__info->ver.af) |
218 | #define is_code(__code, __type) (__code == m5mols_default_ffmt[__type].code) | |
219 | #define is_manufacturer(__info, __manufacturer) \ | |
220 | (__info->ver.str[0] == __manufacturer[0] && \ | |
221 | __info->ver.str[1] == __manufacturer[1]) | |
222 | /* | |
223 | * I2C operation of the M-5MOLS | |
224 | * | |
225 | * The I2C read operation of the M-5MOLS requires 2 messages. The first | |
226 | * message sends the information about the command, command category, and total | |
227 | * message size. The second message is used to retrieve the data specifed in | |
228 | * the first message | |
229 | * | |
230 | * 1st message 2nd message | |
231 | * +-------+---+----------+-----+-------+ +------+------+------+------+ | |
232 | * | size1 | R | category | cmd | size2 | | d[0] | d[1] | d[2] | d[3] | | |
233 | * +-------+---+----------+-----+-------+ +------+------+------+------+ | |
234 | * - size1: message data size(5 in this case) | |
235 | * - size2: desired buffer size of the 2nd message | |
236 | * - d[0..3]: according to size2 | |
237 | * | |
238 | * The I2C write operation needs just one message. The message includes | |
239 | * category, command, total size, and desired data. | |
240 | * | |
241 | * 1st message | |
242 | * +-------+---+----------+-----+------+------+------+------+ | |
243 | * | size1 | W | category | cmd | d[0] | d[1] | d[2] | d[3] | | |
244 | * +-------+---+----------+-----+------+------+------+------+ | |
245 | * - d[0..3]: according to size1 | |
246 | */ | |
57644f56 HK |
247 | int m5mols_read_u8(struct v4l2_subdev *sd, u32 reg_comb, u8 *val); |
248 | int m5mols_read_u16(struct v4l2_subdev *sd, u32 reg_comb, u16 *val); | |
249 | int m5mols_read_u32(struct v4l2_subdev *sd, u32 reg_comb, u32 *val); | |
bc125106 | 250 | int m5mols_write(struct v4l2_subdev *sd, u32 reg_comb, u32 val); |
575d6252 HK |
251 | |
252 | int m5mols_busy_wait(struct v4l2_subdev *sd, u32 reg, u32 value, u32 mask, | |
253 | int timeout); | |
254 | ||
255 | /* Mask value for busy waiting until M-5MOLS I2C interface is initialized */ | |
256 | #define M5MOLS_I2C_RDY_WAIT_FL (1 << 16) | |
257 | /* ISP state transition timeout, in ms */ | |
258 | #define M5MOLS_MODE_CHANGE_TIMEOUT 200 | |
259 | #define M5MOLS_BUSY_WAIT_DEF_TIMEOUT 250 | |
bc125106 HK |
260 | |
261 | /* | |
262 | * Mode operation of the M-5MOLS | |
263 | * | |
264 | * Changing the mode of the M-5MOLS is needed right executing order. | |
265 | * There are three modes(PARAMETER, MONITOR, CAPTURE) which can be changed | |
266 | * by user. There are various categories associated with each mode. | |
267 | * | |
268 | * +============================================================+ | |
269 | * | mode | category | | |
270 | * +============================================================+ | |
271 | * | FLASH | FLASH(only after Stand-by or Power-on) | | |
272 | * | SYSTEM | SYSTEM(only after sensor arm-booting) | | |
273 | * | PARAMETER | PARAMETER | | |
274 | * | MONITOR | MONITOR(preview), Auto Focus, Face Detection | | |
275 | * | CAPTURE | Single CAPTURE, Preview(recording) | | |
276 | * +============================================================+ | |
277 | * | |
278 | * The available executing order between each modes are as follows: | |
279 | * PARAMETER <---> MONITOR <---> CAPTURE | |
280 | */ | |
3c5da0ba | 281 | int m5mols_set_mode(struct m5mols_info *info, u8 mode); |
bc125106 | 282 | |
57644f56 | 283 | int m5mols_enable_interrupt(struct v4l2_subdev *sd, u8 reg); |
ce808a47 | 284 | int m5mols_wait_interrupt(struct v4l2_subdev *sd, u8 condition, u32 timeout); |
5d4294b8 | 285 | int m5mols_restore_controls(struct m5mols_info *info); |
bc125106 | 286 | int m5mols_start_capture(struct m5mols_info *info); |
57644f56 | 287 | int m5mols_do_scenemode(struct m5mols_info *info, u8 mode); |
bc125106 HK |
288 | int m5mols_lock_3a(struct m5mols_info *info, bool lock); |
289 | int m5mols_set_ctrl(struct v4l2_ctrl *ctrl); | |
3c5da0ba | 290 | int m5mols_init_controls(struct v4l2_subdev *sd); |
bc125106 HK |
291 | |
292 | /* The firmware function */ | |
293 | int m5mols_update_fw(struct v4l2_subdev *sd, | |
294 | int (*set_power)(struct m5mols_info *, bool)); | |
295 | ||
91f4eb0a SN |
296 | static inline struct m5mols_info *to_m5mols(struct v4l2_subdev *subdev) |
297 | { | |
298 | return container_of(subdev, struct m5mols_info, sd); | |
299 | } | |
300 | ||
301 | static inline struct v4l2_subdev *to_sd(struct v4l2_ctrl *ctrl) | |
302 | { | |
303 | struct m5mols_info *info = container_of(ctrl->handler, | |
304 | struct m5mols_info, handle); | |
305 | return &info->sd; | |
306 | } | |
307 | ||
bc125106 | 308 | #endif /* M5MOLS_H */ |