m5602_s5k4aa.h 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337
  1. /*
  2. * Driver for the s5k4aa sensor
  3. *
  4. * Copyright (C) 2008 Erik Andrén
  5. * Copyright (C) 2007 Ilyes Gouta. Based on the m5603x Linux Driver Project.
  6. * Copyright (C) 2005 m5603x Linux Driver Project <m5602@x3ng.com.br>
  7. *
  8. * Portions of code to USB interface and ALi driver software,
  9. * Copyright (c) 2006 Willem Duinker
  10. * v4l2 interface modeled after the V4L2 driver
  11. * for SN9C10x PC Camera Controllers
  12. *
  13. * This program is free software; you can redistribute it and/or
  14. * modify it under the terms of the GNU General Public License as
  15. * published by the Free Software Foundation, version 2.
  16. *
  17. */
  18. #ifndef M5602_S5K4AA_H_
  19. #define M5602_S5K4AA_H_
  20. #include <linux/dmi.h>
  21. #include "m5602_sensor.h"
  22. /*****************************************************************************/
  23. #define S5K4AA_PAGE_MAP 0xec
  24. #define S5K4AA_PAGE_MAP_0 0x00
  25. #define S5K4AA_PAGE_MAP_1 0x01
  26. #define S5K4AA_PAGE_MAP_2 0x02
  27. /* Sensor register definitions for page 0x02 */
  28. #define S5K4AA_READ_MODE 0x03
  29. #define S5K4AA_ROWSTART_HI 0x04
  30. #define S5K4AA_ROWSTART_LO 0x05
  31. #define S5K4AA_COLSTART_HI 0x06
  32. #define S5K4AA_COLSTART_LO 0x07
  33. #define S5K4AA_WINDOW_HEIGHT_HI 0x08
  34. #define S5K4AA_WINDOW_HEIGHT_LO 0x09
  35. #define S5K4AA_WINDOW_WIDTH_HI 0x0a
  36. #define S5K4AA_WINDOW_WIDTH_LO 0x0b
  37. #define S5K4AA_GLOBAL_GAIN__ 0x0f
  38. /* sync lost, if too low, reduces frame rate if too high */
  39. #define S5K4AA_H_BLANK_HI__ 0x1d
  40. #define S5K4AA_H_BLANK_LO__ 0x1e
  41. #define S5K4AA_EXPOSURE_HI 0x17
  42. #define S5K4AA_EXPOSURE_LO 0x18
  43. #define S5K4AA_GAIN_1 0x1f /* (digital?) gain : 5 bits */
  44. #define S5K4AA_GAIN_2 0x20 /* (analogue?) gain : 7 bits */
  45. #define S5K4AA_RM_ROW_SKIP_4X 0x08
  46. #define S5K4AA_RM_ROW_SKIP_2X 0x04
  47. #define S5K4AA_RM_COL_SKIP_4X 0x02
  48. #define S5K4AA_RM_COL_SKIP_2X 0x01
  49. #define S5K4AA_RM_H_FLIP 0x40
  50. #define S5K4AA_RM_V_FLIP 0x80
  51. /*****************************************************************************/
  52. /* Kernel module parameters */
  53. extern int force_sensor;
  54. extern int dump_sensor;
  55. int s5k4aa_probe(struct sd *sd);
  56. int s5k4aa_init(struct sd *sd);
  57. int s5k4aa_power_down(struct sd *sd);
  58. int s5k4aa_read_sensor(struct sd *sd, const u8 address,
  59. u8 *i2c_data, const u8 len);
  60. int s5k4aa_write_sensor(struct sd *sd, const u8 address,
  61. u8 *i2c_data, const u8 len);
  62. int s5k4aa_get_exposure(struct gspca_dev *gspca_dev, __s32 *val);
  63. int s5k4aa_set_exposure(struct gspca_dev *gspca_dev, __s32 val);
  64. int s5k4aa_get_vflip(struct gspca_dev *gspca_dev, __s32 *val);
  65. int s5k4aa_set_vflip(struct gspca_dev *gspca_dev, __s32 val);
  66. int s5k4aa_get_hflip(struct gspca_dev *gspca_dev, __s32 *val);
  67. int s5k4aa_set_hflip(struct gspca_dev *gspca_dev, __s32 val);
  68. int s5k4aa_get_gain(struct gspca_dev *gspca_dev, __s32 *val);
  69. int s5k4aa_set_gain(struct gspca_dev *gspca_dev, __s32 val);
  70. static struct m5602_sensor s5k4aa = {
  71. .name = "S5K4AA",
  72. .probe = s5k4aa_probe,
  73. .init = s5k4aa_init,
  74. .power_down = s5k4aa_power_down,
  75. .i2c_slave_id = 0x5a,
  76. .i2c_regW = 2,
  77. .nctrls = 4,
  78. .ctrls = {
  79. {
  80. {
  81. .id = V4L2_CID_VFLIP,
  82. .type = V4L2_CTRL_TYPE_BOOLEAN,
  83. .name = "vertical flip",
  84. .minimum = 0,
  85. .maximum = 1,
  86. .step = 1,
  87. .default_value = 0
  88. },
  89. .set = s5k4aa_set_vflip,
  90. .get = s5k4aa_get_vflip
  91. }, {
  92. {
  93. .id = V4L2_CID_HFLIP,
  94. .type = V4L2_CTRL_TYPE_BOOLEAN,
  95. .name = "horizontal flip",
  96. .minimum = 0,
  97. .maximum = 1,
  98. .step = 1,
  99. .default_value = 0
  100. },
  101. .set = s5k4aa_set_hflip,
  102. .get = s5k4aa_get_hflip
  103. }, {
  104. {
  105. .id = V4L2_CID_GAIN,
  106. .type = V4L2_CTRL_TYPE_INTEGER,
  107. .name = "Gain",
  108. .minimum = 0,
  109. .maximum = 127,
  110. .step = 1,
  111. .default_value = 0xa0,
  112. .flags = V4L2_CTRL_FLAG_SLIDER
  113. },
  114. .set = s5k4aa_set_gain,
  115. .get = s5k4aa_get_gain
  116. }, {
  117. {
  118. .id = V4L2_CID_EXPOSURE,
  119. .type = V4L2_CTRL_TYPE_INTEGER,
  120. .name = "Exposure",
  121. .minimum = 13,
  122. .maximum = 0xfff,
  123. .step = 1,
  124. .default_value = 0x100,
  125. .flags = V4L2_CTRL_FLAG_SLIDER
  126. },
  127. .set = s5k4aa_set_exposure,
  128. .get = s5k4aa_get_exposure
  129. }
  130. },
  131. .nmodes = 1,
  132. .modes = {
  133. {
  134. M5602_DEFAULT_FRAME_WIDTH,
  135. M5602_DEFAULT_FRAME_HEIGHT,
  136. V4L2_PIX_FMT_SBGGR8,
  137. V4L2_FIELD_NONE,
  138. .sizeimage =
  139. M5602_DEFAULT_FRAME_WIDTH * M5602_DEFAULT_FRAME_HEIGHT,
  140. .bytesperline = M5602_DEFAULT_FRAME_WIDTH,
  141. .colorspace = V4L2_COLORSPACE_SRGB,
  142. .priv = 1
  143. }
  144. }
  145. };
  146. static const unsigned char preinit_s5k4aa[][4] =
  147. {
  148. {BRIDGE, M5602_XB_MCU_CLK_DIV, 0x02, 0x00},
  149. {BRIDGE, M5602_XB_MCU_CLK_CTRL, 0xb0, 0x00},
  150. {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x00, 0x00},
  151. {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0, 0x00},
  152. {BRIDGE, M5602_XB_ADC_CTRL, 0xc0, 0x00},
  153. {BRIDGE, M5602_XB_SENSOR_TYPE, 0x0d, 0x00},
  154. {BRIDGE, M5602_XB_SENSOR_CTRL, 0x00, 0x00},
  155. {BRIDGE, M5602_XB_GPIO_DIR, 0x1d, 0x00},
  156. {BRIDGE, M5602_XB_GPIO_DAT, 0x08, 0x00},
  157. {BRIDGE, M5602_XB_SEN_CLK_DIV, 0xb0, 0x00},
  158. {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0x80, 0x00},
  159. {BRIDGE, M5602_XB_GPIO_EN_H, 0x3f, 0x00},
  160. {BRIDGE, M5602_XB_GPIO_DIR_H, 0x3f, 0x00},
  161. {BRIDGE, M5602_XB_GPIO_DAT_H, 0x00, 0x00},
  162. {BRIDGE, M5602_XB_GPIO_DIR, 0x1d, 0x00},
  163. {BRIDGE, M5602_XB_GPIO_DAT, 0x00, 0x00},
  164. {BRIDGE, M5602_XB_GPIO_EN_L, 0xff, 0x00},
  165. {BRIDGE, M5602_XB_GPIO_DIR_L, 0xff, 0x00},
  166. {BRIDGE, M5602_XB_GPIO_DAT_L, 0x00, 0x00},
  167. {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x00, 0x00},
  168. {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0, 0x00},
  169. {BRIDGE, M5602_XB_ADC_CTRL, 0xc0, 0x00},
  170. {BRIDGE, M5602_XB_SENSOR_TYPE, 0x08, 0x00},
  171. {BRIDGE, M5602_XB_MCU_CLK_DIV, 0x02, 0x00},
  172. {BRIDGE, M5602_XB_MCU_CLK_CTRL, 0xb0, 0x00},
  173. {BRIDGE, M5602_XB_GPIO_DIR, 0x1d, 0x00},
  174. {BRIDGE, M5602_XB_GPIO_DAT, 0x14, 0x00},
  175. {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x00, 0x00},
  176. {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xf0, 0x00},
  177. {BRIDGE, M5602_XB_GPIO_DIR, 0x1d, 0x00},
  178. {BRIDGE, M5602_XB_GPIO_DAT, 0x1c, 0x00},
  179. {BRIDGE, M5602_XB_GPIO_EN_H, 0x06, 0x00},
  180. {BRIDGE, M5602_XB_GPIO_DIR_H, 0x06, 0x00},
  181. {BRIDGE, M5602_XB_GPIO_DAT_H, 0x00, 0x00},
  182. {BRIDGE, M5602_XB_GPIO_EN_L, 0x00, 0x00},
  183. {BRIDGE, M5602_XB_I2C_CLK_DIV, 0x20, 0x00},
  184. {SENSOR, S5K4AA_PAGE_MAP, 0x00, 0x00}
  185. };
  186. static const unsigned char init_s5k4aa[][4] =
  187. {
  188. {BRIDGE, M5602_XB_MCU_CLK_DIV, 0x02, 0x00},
  189. {BRIDGE, M5602_XB_MCU_CLK_CTRL, 0xb0, 0x00},
  190. {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x00, 0x00},
  191. {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0, 0x00},
  192. {BRIDGE, M5602_XB_ADC_CTRL, 0xc0, 0x00},
  193. {BRIDGE, M5602_XB_SENSOR_TYPE, 0x0d, 0x00},
  194. {BRIDGE, M5602_XB_SENSOR_CTRL, 0x00, 0x00},
  195. {BRIDGE, M5602_XB_GPIO_DIR, 0x1d, 0x00},
  196. {BRIDGE, M5602_XB_GPIO_DAT, 0x08, 0x00},
  197. {BRIDGE, M5602_XB_SEN_CLK_DIV, 0xb0, 0x00},
  198. {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0x80, 0x00},
  199. {BRIDGE, M5602_XB_GPIO_EN_H, 0x3f, 0x00},
  200. {BRIDGE, M5602_XB_GPIO_DIR_H, 0x3f, 0x00},
  201. {BRIDGE, M5602_XB_GPIO_DAT_H, 0x00, 0x00},
  202. {BRIDGE, M5602_XB_GPIO_DIR, 0x1d, 0x00},
  203. {BRIDGE, M5602_XB_GPIO_DAT, 0x00, 0x00},
  204. {BRIDGE, M5602_XB_GPIO_EN_L, 0xff, 0x00},
  205. {BRIDGE, M5602_XB_GPIO_DIR_L, 0xff, 0x00},
  206. {BRIDGE, M5602_XB_GPIO_DAT_L, 0x00, 0x00},
  207. {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x00, 0x00},
  208. {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0, 0x00},
  209. {BRIDGE, M5602_XB_ADC_CTRL, 0xc0, 0x00},
  210. {BRIDGE, M5602_XB_SENSOR_TYPE, 0x08, 0x00},
  211. {BRIDGE, M5602_XB_MCU_CLK_DIV, 0x02, 0x00},
  212. {BRIDGE, M5602_XB_MCU_CLK_CTRL, 0xb0, 0x00},
  213. {BRIDGE, M5602_XB_GPIO_DIR, 0x1d, 0x00},
  214. {BRIDGE, M5602_XB_GPIO_DAT, 0x14, 0x00},
  215. {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x00, 0x00},
  216. {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xf0, 0x00},
  217. {BRIDGE, M5602_XB_GPIO_DIR, 0x1d, 0x00},
  218. {BRIDGE, M5602_XB_GPIO_DAT, 0x1c, 0x00},
  219. {BRIDGE, M5602_XB_GPIO_EN_H, 0x06, 0x00},
  220. {BRIDGE, M5602_XB_GPIO_DIR_H, 0x06, 0x00},
  221. {BRIDGE, M5602_XB_GPIO_DAT_H, 0x00, 0x00},
  222. {BRIDGE, M5602_XB_GPIO_EN_L, 0x00, 0x00},
  223. {BRIDGE, M5602_XB_I2C_CLK_DIV, 0x20, 0x00},
  224. {SENSOR, S5K4AA_PAGE_MAP, 0x07, 0x00},
  225. {SENSOR, 0x36, 0x01, 0x00},
  226. {SENSOR, S5K4AA_PAGE_MAP, 0x00, 0x00},
  227. {SENSOR, 0x7b, 0xff, 0x00},
  228. {SENSOR, S5K4AA_PAGE_MAP, 0x02, 0x00},
  229. {SENSOR, 0x0c, 0x05, 0x00},
  230. {SENSOR, 0x02, 0x0e, 0x00},
  231. {SENSOR, S5K4AA_GAIN_1, 0x0f, 0x00},
  232. {SENSOR, S5K4AA_GAIN_2, 0x00, 0x00},
  233. {SENSOR, S5K4AA_GLOBAL_GAIN__, 0x01, 0x00},
  234. {SENSOR, 0x11, 0x00, 0x00},
  235. {SENSOR, 0x12, 0x00, 0x00},
  236. {SENSOR, S5K4AA_PAGE_MAP, 0x02, 0x00},
  237. {SENSOR, S5K4AA_READ_MODE, 0xa0, 0x00},
  238. {SENSOR, 0x37, 0x00, 0x00},
  239. {SENSOR, S5K4AA_ROWSTART_HI, 0x00, 0x00},
  240. {SENSOR, S5K4AA_ROWSTART_LO, 0x2a, 0x00},
  241. {SENSOR, S5K4AA_COLSTART_HI, 0x00, 0x00},
  242. {SENSOR, S5K4AA_COLSTART_LO, 0x0b, 0x00},
  243. {SENSOR, S5K4AA_WINDOW_HEIGHT_HI, 0x03, 0x00},
  244. {SENSOR, S5K4AA_WINDOW_HEIGHT_LO, 0xc4, 0x00},
  245. {SENSOR, S5K4AA_WINDOW_WIDTH_HI, 0x05, 0x00},
  246. {SENSOR, S5K4AA_WINDOW_WIDTH_LO, 0x08, 0x00},
  247. {SENSOR, S5K4AA_H_BLANK_HI__, 0x00, 0x00},
  248. {SENSOR, S5K4AA_H_BLANK_LO__, 0x48, 0x00},
  249. {SENSOR, S5K4AA_EXPOSURE_HI, 0x00, 0x00},
  250. {SENSOR, S5K4AA_EXPOSURE_LO, 0x43, 0x00},
  251. {SENSOR, 0x11, 0x04, 0x00},
  252. {SENSOR, 0x12, 0xc3, 0x00},
  253. {SENSOR, S5K4AA_PAGE_MAP, 0x02, 0x00},
  254. {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x06, 0x00},
  255. {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xb0, 0x00},
  256. {BRIDGE, M5602_XB_ADC_CTRL, 0xc0, 0x00},
  257. {BRIDGE, M5602_XB_SENSOR_TYPE, 0x08, 0x00},
  258. {BRIDGE, M5602_XB_LINE_OF_FRAME_H, 0x81, 0x00},
  259. {BRIDGE, M5602_XB_PIX_OF_LINE_H, 0x82, 0x00},
  260. {BRIDGE, M5602_XB_SIG_INI, 0x01, 0x00},
  261. {BRIDGE, M5602_XB_VSYNC_PARA, 0x00, 0x00},
  262. {BRIDGE, M5602_XB_VSYNC_PARA, 0x00, 0x00},
  263. {BRIDGE, M5602_XB_VSYNC_PARA, 0x00, 0x00},
  264. {BRIDGE, M5602_XB_VSYNC_PARA, 0x00, 0x00},
  265. /* VSYNC_PARA, VSYNC_PARA : img height 480 = 0x01e0 */
  266. {BRIDGE, M5602_XB_VSYNC_PARA, 0x01, 0x00},
  267. {BRIDGE, M5602_XB_VSYNC_PARA, 0xe0, 0x00},
  268. {BRIDGE, M5602_XB_VSYNC_PARA, 0x00, 0x00},
  269. {BRIDGE, M5602_XB_VSYNC_PARA, 0x00, 0x00},
  270. {BRIDGE, M5602_XB_SIG_INI, 0x00, 0x00},
  271. {BRIDGE, M5602_XB_SIG_INI, 0x02, 0x00},
  272. {BRIDGE, M5602_XB_HSYNC_PARA, 0x00, 0x00},
  273. {BRIDGE, M5602_XB_HSYNC_PARA, 0x00, 0x00},
  274. /* HSYNC_PARA, HSYNC_PARA : img width 640 = 0x0280 */
  275. {BRIDGE, M5602_XB_HSYNC_PARA, 0x02, 0x00},
  276. {BRIDGE, M5602_XB_HSYNC_PARA, 0x80, 0x00},
  277. {BRIDGE, M5602_XB_SIG_INI, 0x00, 0x00},
  278. {BRIDGE, M5602_XB_SEN_CLK_DIV, 0x00, 0x00},
  279. {BRIDGE, M5602_XB_SEN_CLK_CTRL, 0xa0, 0x00}, /* 48 MHz */
  280. {SENSOR, S5K4AA_PAGE_MAP, 0x02, 0x00},
  281. {SENSOR, S5K4AA_READ_MODE, S5K4AA_RM_H_FLIP | S5K4AA_RM_ROW_SKIP_2X
  282. | S5K4AA_RM_COL_SKIP_2X, 0x00},
  283. /* 0x37 : Fix image stability when light is too bright and improves
  284. * image quality in 640x480, but worsens it in 1280x1024 */
  285. {SENSOR, 0x37, 0x01, 0x00},
  286. /* ROWSTART_HI, ROWSTART_LO : 10 + (1024-960)/2 = 42 = 0x002a */
  287. {SENSOR, S5K4AA_ROWSTART_HI, 0x00, 0x00},
  288. {SENSOR, S5K4AA_ROWSTART_LO, 0x2a, 0x00},
  289. {SENSOR, S5K4AA_COLSTART_HI, 0x00, 0x00},
  290. {SENSOR, S5K4AA_COLSTART_LO, 0x0c, 0x00},
  291. /* window_height_hi, window_height_lo : 960 = 0x03c0 */
  292. {SENSOR, S5K4AA_WINDOW_HEIGHT_HI, 0x03, 0x00},
  293. {SENSOR, S5K4AA_WINDOW_HEIGHT_LO, 0xc0, 0x00},
  294. /* window_width_hi, window_width_lo : 1280 = 0x0500 */
  295. {SENSOR, S5K4AA_WINDOW_WIDTH_HI, 0x05, 0x00},
  296. {SENSOR, S5K4AA_WINDOW_WIDTH_LO, 0x00, 0x00},
  297. {SENSOR, S5K4AA_H_BLANK_HI__, 0x00, 0x00},
  298. {SENSOR, S5K4AA_H_BLANK_LO__, 0xa8, 0x00}, /* helps to sync... */
  299. {SENSOR, S5K4AA_EXPOSURE_HI, 0x01, 0x00},
  300. {SENSOR, S5K4AA_EXPOSURE_LO, 0x00, 0x00},
  301. {SENSOR, 0x11, 0x04, 0x00},
  302. {SENSOR, 0x12, 0xc3, 0x00},
  303. {SENSOR, S5K4AA_PAGE_MAP, 0x02, 0x00},
  304. {SENSOR, 0x02, 0x0e, 0x00},
  305. {SENSOR_LONG, S5K4AA_GLOBAL_GAIN__, 0x0f, 0x00},
  306. {SENSOR, S5K4AA_GAIN_1, 0x0b, 0x00},
  307. {SENSOR, S5K4AA_GAIN_2, 0xa0, 0x00}
  308. };
  309. #endif