i2c/m5mols/m5mols.h

1 /* SPDX-License-Identifier: GPL-2.0-or-later */
3  * Header for M-5MOLS 8M Pixel camera sensor with ISP
16 #include <media/v4l2-subdev.h>
35  * struct m5mols_resolution - structure for the resolution
49  * struct m5mols_exif - structure for the EXIF information of M-5MOLS
72  * struct m5mols_capture - Structure for the capture capability
88  * struct m5mols_scenemode - structure for the scenemode capability
91  * @wb_mode: mode which means the WhiteBalance is Auto or Manual
97  * @af_range: Auto Focus's range
98  * @fd_mode: Face Detection mode
99  * @mcc: Multi-axis Color Conversion which means emotion color
130  * struct m5mols_version - firmware version information
136  * @awb:	Auto WhiteBalance algorithm version
138  * @af:		Auto Focus version
160  * struct m5mols_info - M-5MOLS driver data structure
162  * @sd: v4l-subdev instance
167  * @auto_exposure: auto/manual exposure control
171  * @auto_iso: auto/manual ISO sensitivity control
173  * @auto_wb: auto white balance control
203 		/* exposure/exposure bias/auto exposure cluster */
210 		/* iso/auto iso cluster */
242 #define is_available_af(__info)	(__info->ver.af)
245 				(__info->ver.str[0] == __manufacturer[0] && \
246 				 __info->ver.str[1] == __manufacturer[1])
248  * I2C operation of the M-5MOLS
250  * The I2C read operation of the M-5MOLS requires 2 messages. The first
256  *   +-------+---+----------+-----+-------+     +------+------+------+------+
258  *   +-------+---+----------+-----+-------+     +------+------+------+------+
259  *   - size1: message data size(5 in this case)
260  *   - size2: desired buffer size of the 2nd message
261  *   - d[0..3]: according to size2
267  *   +-------+---+----------+-----+------+------+------+------+
269  *   +-------+---+----------+-----+------+------+------+------+
270  *   - d[0..3]: according to size1
280 /* Mask value for busy waiting until M-5MOLS I2C interface is initialized */
287  * Mode operation of the M-5MOLS
289  * Changing the mode of the M-5MOLS is needed right executing order.
296  * | FLASH	| FLASH(only after Stand-by or Power-on)	|
297  * | SYSTEM	| SYSTEM(only after sensor arm-booting)		|
299  * | MONITOR	| MONITOR(preview), Auto Focus, Face Detection	|
304  *   PARAMETER <---> MONITOR <---> CAPTURE
328 	struct m5mols_info *info = container_of(ctrl->handler,  in to_sd()
330 	return &info->sd;  in to_sd()
336 	ctrl->priv = (void *)(uintptr_t)mode;  in m5mols_set_ctrl_mode()
341 	return (unsigned int)(uintptr_t)ctrl->priv;  in m5mols_get_ctrl_mode()