xref: /OK3568_Linux_fs/kernel/drivers/media/usb/gspca/m5602/m5602_s5k4aa.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0-only */
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun  * Driver for the s5k4aa sensor
4*4882a593Smuzhiyun  *
5*4882a593Smuzhiyun  * Copyright (C) 2008 Erik Andrén
6*4882a593Smuzhiyun  * Copyright (C) 2007 Ilyes Gouta. Based on the m5603x Linux Driver Project.
7*4882a593Smuzhiyun  * Copyright (C) 2005 m5603x Linux Driver Project <m5602@x3ng.com.br>
8*4882a593Smuzhiyun  *
9*4882a593Smuzhiyun  * Portions of code to USB interface and ALi driver software,
10*4882a593Smuzhiyun  * Copyright (c) 2006 Willem Duinker
11*4882a593Smuzhiyun  * v4l2 interface modeled after the V4L2 driver
12*4882a593Smuzhiyun  * for SN9C10x PC Camera Controllers
13*4882a593Smuzhiyun  */
14*4882a593Smuzhiyun 
15*4882a593Smuzhiyun #ifndef M5602_S5K4AA_H_
16*4882a593Smuzhiyun #define M5602_S5K4AA_H_
17*4882a593Smuzhiyun 
18*4882a593Smuzhiyun #include <linux/dmi.h>
19*4882a593Smuzhiyun 
20*4882a593Smuzhiyun #include "m5602_sensor.h"
21*4882a593Smuzhiyun 
22*4882a593Smuzhiyun /*****************************************************************************/
23*4882a593Smuzhiyun 
24*4882a593Smuzhiyun #define S5K4AA_PAGE_MAP			0xec
25*4882a593Smuzhiyun 
26*4882a593Smuzhiyun #define S5K4AA_PAGE_MAP_0		0x00
27*4882a593Smuzhiyun #define S5K4AA_PAGE_MAP_1		0x01
28*4882a593Smuzhiyun #define S5K4AA_PAGE_MAP_2		0x02
29*4882a593Smuzhiyun 
30*4882a593Smuzhiyun /* Sensor register definitions for page 0x02 */
31*4882a593Smuzhiyun #define S5K4AA_READ_MODE		0x03
32*4882a593Smuzhiyun #define S5K4AA_ROWSTART_HI		0x04
33*4882a593Smuzhiyun #define S5K4AA_ROWSTART_LO		0x05
34*4882a593Smuzhiyun #define S5K4AA_COLSTART_HI		0x06
35*4882a593Smuzhiyun #define S5K4AA_COLSTART_LO		0x07
36*4882a593Smuzhiyun #define S5K4AA_WINDOW_HEIGHT_HI		0x08
37*4882a593Smuzhiyun #define S5K4AA_WINDOW_HEIGHT_LO		0x09
38*4882a593Smuzhiyun #define S5K4AA_WINDOW_WIDTH_HI		0x0a
39*4882a593Smuzhiyun #define S5K4AA_WINDOW_WIDTH_LO		0x0b
40*4882a593Smuzhiyun #define S5K4AA_GLOBAL_GAIN__		0x0f
41*4882a593Smuzhiyun /* sync lost, if too low, reduces frame rate if too high */
42*4882a593Smuzhiyun #define S5K4AA_H_BLANK_HI__		0x1d
43*4882a593Smuzhiyun #define S5K4AA_H_BLANK_LO__		0x1e
44*4882a593Smuzhiyun #define S5K4AA_EXPOSURE_HI		0x17
45*4882a593Smuzhiyun #define S5K4AA_EXPOSURE_LO		0x18
46*4882a593Smuzhiyun #define S5K4AA_BRIGHTNESS		0x1f /* (digital?) gain : 5 bits */
47*4882a593Smuzhiyun #define S5K4AA_GAIN			0x20 /* (analogue?) gain : 7 bits */
48*4882a593Smuzhiyun #define S5K4AA_NOISE_SUPP		0x37
49*4882a593Smuzhiyun 
50*4882a593Smuzhiyun #define S5K4AA_RM_ROW_SKIP_4X		0x08
51*4882a593Smuzhiyun #define S5K4AA_RM_ROW_SKIP_2X		0x04
52*4882a593Smuzhiyun #define S5K4AA_RM_COL_SKIP_4X		0x02
53*4882a593Smuzhiyun #define S5K4AA_RM_COL_SKIP_2X		0x01
54*4882a593Smuzhiyun #define S5K4AA_RM_H_FLIP		0x40
55*4882a593Smuzhiyun #define S5K4AA_RM_V_FLIP		0x80
56*4882a593Smuzhiyun 
57*4882a593Smuzhiyun #define S5K4AA_DEFAULT_GAIN		0x5f
58*4882a593Smuzhiyun #define S5K4AA_DEFAULT_BRIGHTNESS	0x10
59*4882a593Smuzhiyun 
60*4882a593Smuzhiyun /*****************************************************************************/
61*4882a593Smuzhiyun 
62*4882a593Smuzhiyun /* Kernel module parameters */
63*4882a593Smuzhiyun extern int force_sensor;
64*4882a593Smuzhiyun extern bool dump_sensor;
65*4882a593Smuzhiyun 
66*4882a593Smuzhiyun int s5k4aa_probe(struct sd *sd);
67*4882a593Smuzhiyun int s5k4aa_init(struct sd *sd);
68*4882a593Smuzhiyun int s5k4aa_init_controls(struct sd *sd);
69*4882a593Smuzhiyun int s5k4aa_start(struct sd *sd);
70*4882a593Smuzhiyun void s5k4aa_disconnect(struct sd *sd);
71*4882a593Smuzhiyun 
72*4882a593Smuzhiyun static const struct m5602_sensor s5k4aa = {
73*4882a593Smuzhiyun 	.name = "S5K4AA",
74*4882a593Smuzhiyun 	.i2c_slave_id = 0x5a,
75*4882a593Smuzhiyun 	.i2c_regW = 2,
76*4882a593Smuzhiyun 
77*4882a593Smuzhiyun 	.probe = s5k4aa_probe,
78*4882a593Smuzhiyun 	.init = s5k4aa_init,
79*4882a593Smuzhiyun 	.init_controls = s5k4aa_init_controls,
80*4882a593Smuzhiyun 	.start = s5k4aa_start,
81*4882a593Smuzhiyun 	.disconnect = s5k4aa_disconnect,
82*4882a593Smuzhiyun };
83*4882a593Smuzhiyun 
84*4882a593Smuzhiyun #endif
85