ov7670.c 38 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472
  1. /*
  2. * A V4L2 driver for OmniVision OV7670 cameras.
  3. *
  4. * Copyright 2006 One Laptop Per Child Association, Inc. Written
  5. * by Jonathan Corbet with substantial inspiration from Mark
  6. * McClelland's ovcamchip code.
  7. *
  8. * Copyright 2006-7 Jonathan Corbet <corbet@lwn.net>
  9. *
  10. * This file may be distributed under the terms of the GNU General
  11. * Public License, version 2.
  12. */
  13. #include <linux/init.h>
  14. #include <linux/module.h>
  15. #include <linux/slab.h>
  16. #include <linux/i2c.h>
  17. #include <linux/delay.h>
  18. #include <linux/videodev2.h>
  19. #include <media/v4l2-device.h>
  20. #include <media/v4l2-chip-ident.h>
  21. #include <media/v4l2-i2c-drv.h>
  22. MODULE_AUTHOR("Jonathan Corbet <corbet@lwn.net>");
  23. MODULE_DESCRIPTION("A low-level driver for OmniVision ov7670 sensors");
  24. MODULE_LICENSE("GPL");
  25. static int debug;
  26. module_param(debug, bool, 0644);
  27. MODULE_PARM_DESC(debug, "Debug level (0-1)");
  28. /*
  29. * Basic window sizes. These probably belong somewhere more globally
  30. * useful.
  31. */
  32. #define VGA_WIDTH 640
  33. #define VGA_HEIGHT 480
  34. #define QVGA_WIDTH 320
  35. #define QVGA_HEIGHT 240
  36. #define CIF_WIDTH 352
  37. #define CIF_HEIGHT 288
  38. #define QCIF_WIDTH 176
  39. #define QCIF_HEIGHT 144
  40. /*
  41. * Our nominal (default) frame rate.
  42. */
  43. #define OV7670_FRAME_RATE 30
  44. /*
  45. * The 7670 sits on i2c with ID 0x42
  46. */
  47. #define OV7670_I2C_ADDR 0x42
  48. /* Registers */
  49. #define REG_GAIN 0x00 /* Gain lower 8 bits (rest in vref) */
  50. #define REG_BLUE 0x01 /* blue gain */
  51. #define REG_RED 0x02 /* red gain */
  52. #define REG_VREF 0x03 /* Pieces of GAIN, VSTART, VSTOP */
  53. #define REG_COM1 0x04 /* Control 1 */
  54. #define COM1_CCIR656 0x40 /* CCIR656 enable */
  55. #define REG_BAVE 0x05 /* U/B Average level */
  56. #define REG_GbAVE 0x06 /* Y/Gb Average level */
  57. #define REG_AECHH 0x07 /* AEC MS 5 bits */
  58. #define REG_RAVE 0x08 /* V/R Average level */
  59. #define REG_COM2 0x09 /* Control 2 */
  60. #define COM2_SSLEEP 0x10 /* Soft sleep mode */
  61. #define REG_PID 0x0a /* Product ID MSB */
  62. #define REG_VER 0x0b /* Product ID LSB */
  63. #define REG_COM3 0x0c /* Control 3 */
  64. #define COM3_SWAP 0x40 /* Byte swap */
  65. #define COM3_SCALEEN 0x08 /* Enable scaling */
  66. #define COM3_DCWEN 0x04 /* Enable downsamp/crop/window */
  67. #define REG_COM4 0x0d /* Control 4 */
  68. #define REG_COM5 0x0e /* All "reserved" */
  69. #define REG_COM6 0x0f /* Control 6 */
  70. #define REG_AECH 0x10 /* More bits of AEC value */
  71. #define REG_CLKRC 0x11 /* Clocl control */
  72. #define CLK_EXT 0x40 /* Use external clock directly */
  73. #define CLK_SCALE 0x3f /* Mask for internal clock scale */
  74. #define REG_COM7 0x12 /* Control 7 */
  75. #define COM7_RESET 0x80 /* Register reset */
  76. #define COM7_FMT_MASK 0x38
  77. #define COM7_FMT_VGA 0x00
  78. #define COM7_FMT_CIF 0x20 /* CIF format */
  79. #define COM7_FMT_QVGA 0x10 /* QVGA format */
  80. #define COM7_FMT_QCIF 0x08 /* QCIF format */
  81. #define COM7_RGB 0x04 /* bits 0 and 2 - RGB format */
  82. #define COM7_YUV 0x00 /* YUV */
  83. #define COM7_BAYER 0x01 /* Bayer format */
  84. #define COM7_PBAYER 0x05 /* "Processed bayer" */
  85. #define REG_COM8 0x13 /* Control 8 */
  86. #define COM8_FASTAEC 0x80 /* Enable fast AGC/AEC */
  87. #define COM8_AECSTEP 0x40 /* Unlimited AEC step size */
  88. #define COM8_BFILT 0x20 /* Band filter enable */
  89. #define COM8_AGC 0x04 /* Auto gain enable */
  90. #define COM8_AWB 0x02 /* White balance enable */
  91. #define COM8_AEC 0x01 /* Auto exposure enable */
  92. #define REG_COM9 0x14 /* Control 9 - gain ceiling */
  93. #define REG_COM10 0x15 /* Control 10 */
  94. #define COM10_HSYNC 0x40 /* HSYNC instead of HREF */
  95. #define COM10_PCLK_HB 0x20 /* Suppress PCLK on horiz blank */
  96. #define COM10_HREF_REV 0x08 /* Reverse HREF */
  97. #define COM10_VS_LEAD 0x04 /* VSYNC on clock leading edge */
  98. #define COM10_VS_NEG 0x02 /* VSYNC negative */
  99. #define COM10_HS_NEG 0x01 /* HSYNC negative */
  100. #define REG_HSTART 0x17 /* Horiz start high bits */
  101. #define REG_HSTOP 0x18 /* Horiz stop high bits */
  102. #define REG_VSTART 0x19 /* Vert start high bits */
  103. #define REG_VSTOP 0x1a /* Vert stop high bits */
  104. #define REG_PSHFT 0x1b /* Pixel delay after HREF */
  105. #define REG_MIDH 0x1c /* Manuf. ID high */
  106. #define REG_MIDL 0x1d /* Manuf. ID low */
  107. #define REG_MVFP 0x1e /* Mirror / vflip */
  108. #define MVFP_MIRROR 0x20 /* Mirror image */
  109. #define MVFP_FLIP 0x10 /* Vertical flip */
  110. #define REG_AEW 0x24 /* AGC upper limit */
  111. #define REG_AEB 0x25 /* AGC lower limit */
  112. #define REG_VPT 0x26 /* AGC/AEC fast mode op region */
  113. #define REG_HSYST 0x30 /* HSYNC rising edge delay */
  114. #define REG_HSYEN 0x31 /* HSYNC falling edge delay */
  115. #define REG_HREF 0x32 /* HREF pieces */
  116. #define REG_TSLB 0x3a /* lots of stuff */
  117. #define TSLB_YLAST 0x04 /* UYVY or VYUY - see com13 */
  118. #define REG_COM11 0x3b /* Control 11 */
  119. #define COM11_NIGHT 0x80 /* NIght mode enable */
  120. #define COM11_NMFR 0x60 /* Two bit NM frame rate */
  121. #define COM11_HZAUTO 0x10 /* Auto detect 50/60 Hz */
  122. #define COM11_50HZ 0x08 /* Manual 50Hz select */
  123. #define COM11_EXP 0x02
  124. #define REG_COM12 0x3c /* Control 12 */
  125. #define COM12_HREF 0x80 /* HREF always */
  126. #define REG_COM13 0x3d /* Control 13 */
  127. #define COM13_GAMMA 0x80 /* Gamma enable */
  128. #define COM13_UVSAT 0x40 /* UV saturation auto adjustment */
  129. #define COM13_UVSWAP 0x01 /* V before U - w/TSLB */
  130. #define REG_COM14 0x3e /* Control 14 */
  131. #define COM14_DCWEN 0x10 /* DCW/PCLK-scale enable */
  132. #define REG_EDGE 0x3f /* Edge enhancement factor */
  133. #define REG_COM15 0x40 /* Control 15 */
  134. #define COM15_R10F0 0x00 /* Data range 10 to F0 */
  135. #define COM15_R01FE 0x80 /* 01 to FE */
  136. #define COM15_R00FF 0xc0 /* 00 to FF */
  137. #define COM15_RGB565 0x10 /* RGB565 output */
  138. #define COM15_RGB555 0x30 /* RGB555 output */
  139. #define REG_COM16 0x41 /* Control 16 */
  140. #define COM16_AWBGAIN 0x08 /* AWB gain enable */
  141. #define REG_COM17 0x42 /* Control 17 */
  142. #define COM17_AECWIN 0xc0 /* AEC window - must match COM4 */
  143. #define COM17_CBAR 0x08 /* DSP Color bar */
  144. /*
  145. * This matrix defines how the colors are generated, must be
  146. * tweaked to adjust hue and saturation.
  147. *
  148. * Order: v-red, v-green, v-blue, u-red, u-green, u-blue
  149. *
  150. * They are nine-bit signed quantities, with the sign bit
  151. * stored in 0x58. Sign for v-red is bit 0, and up from there.
  152. */
  153. #define REG_CMATRIX_BASE 0x4f
  154. #define CMATRIX_LEN 6
  155. #define REG_CMATRIX_SIGN 0x58
  156. #define REG_BRIGHT 0x55 /* Brightness */
  157. #define REG_CONTRAS 0x56 /* Contrast control */
  158. #define REG_GFIX 0x69 /* Fix gain control */
  159. #define REG_REG76 0x76 /* OV's name */
  160. #define R76_BLKPCOR 0x80 /* Black pixel correction enable */
  161. #define R76_WHTPCOR 0x40 /* White pixel correction enable */
  162. #define REG_RGB444 0x8c /* RGB 444 control */
  163. #define R444_ENABLE 0x02 /* Turn on RGB444, overrides 5x5 */
  164. #define R444_RGBX 0x01 /* Empty nibble at end */
  165. #define REG_HAECC1 0x9f /* Hist AEC/AGC control 1 */
  166. #define REG_HAECC2 0xa0 /* Hist AEC/AGC control 2 */
  167. #define REG_BD50MAX 0xa5 /* 50hz banding step limit */
  168. #define REG_HAECC3 0xa6 /* Hist AEC/AGC control 3 */
  169. #define REG_HAECC4 0xa7 /* Hist AEC/AGC control 4 */
  170. #define REG_HAECC5 0xa8 /* Hist AEC/AGC control 5 */
  171. #define REG_HAECC6 0xa9 /* Hist AEC/AGC control 6 */
  172. #define REG_HAECC7 0xaa /* Hist AEC/AGC control 7 */
  173. #define REG_BD60MAX 0xab /* 60hz banding step limit */
  174. /*
  175. * Information we maintain about a known sensor.
  176. */
  177. struct ov7670_format_struct; /* coming later */
  178. struct ov7670_info {
  179. struct v4l2_subdev sd;
  180. struct ov7670_format_struct *fmt; /* Current format */
  181. unsigned char sat; /* Saturation value */
  182. int hue; /* Hue value */
  183. u8 clkrc; /* Clock divider value */
  184. };
  185. static inline struct ov7670_info *to_state(struct v4l2_subdev *sd)
  186. {
  187. return container_of(sd, struct ov7670_info, sd);
  188. }
  189. /*
  190. * The default register settings, as obtained from OmniVision. There
  191. * is really no making sense of most of these - lots of "reserved" values
  192. * and such.
  193. *
  194. * These settings give VGA YUYV.
  195. */
  196. struct regval_list {
  197. unsigned char reg_num;
  198. unsigned char value;
  199. };
  200. static struct regval_list ov7670_default_regs[] = {
  201. { REG_COM7, COM7_RESET },
  202. /*
  203. * Clock scale: 3 = 15fps
  204. * 2 = 20fps
  205. * 1 = 30fps
  206. */
  207. { REG_CLKRC, 0x1 }, /* OV: clock scale (30 fps) */
  208. { REG_TSLB, 0x04 }, /* OV */
  209. { REG_COM7, 0 }, /* VGA */
  210. /*
  211. * Set the hardware window. These values from OV don't entirely
  212. * make sense - hstop is less than hstart. But they work...
  213. */
  214. { REG_HSTART, 0x13 }, { REG_HSTOP, 0x01 },
  215. { REG_HREF, 0xb6 }, { REG_VSTART, 0x02 },
  216. { REG_VSTOP, 0x7a }, { REG_VREF, 0x0a },
  217. { REG_COM3, 0 }, { REG_COM14, 0 },
  218. /* Mystery scaling numbers */
  219. { 0x70, 0x3a }, { 0x71, 0x35 },
  220. { 0x72, 0x11 }, { 0x73, 0xf0 },
  221. { 0xa2, 0x02 }, { REG_COM10, 0x0 },
  222. /* Gamma curve values */
  223. { 0x7a, 0x20 }, { 0x7b, 0x10 },
  224. { 0x7c, 0x1e }, { 0x7d, 0x35 },
  225. { 0x7e, 0x5a }, { 0x7f, 0x69 },
  226. { 0x80, 0x76 }, { 0x81, 0x80 },
  227. { 0x82, 0x88 }, { 0x83, 0x8f },
  228. { 0x84, 0x96 }, { 0x85, 0xa3 },
  229. { 0x86, 0xaf }, { 0x87, 0xc4 },
  230. { 0x88, 0xd7 }, { 0x89, 0xe8 },
  231. /* AGC and AEC parameters. Note we start by disabling those features,
  232. then turn them only after tweaking the values. */
  233. { REG_COM8, COM8_FASTAEC | COM8_AECSTEP | COM8_BFILT },
  234. { REG_GAIN, 0 }, { REG_AECH, 0 },
  235. { REG_COM4, 0x40 }, /* magic reserved bit */
  236. { REG_COM9, 0x18 }, /* 4x gain + magic rsvd bit */
  237. { REG_BD50MAX, 0x05 }, { REG_BD60MAX, 0x07 },
  238. { REG_AEW, 0x95 }, { REG_AEB, 0x33 },
  239. { REG_VPT, 0xe3 }, { REG_HAECC1, 0x78 },
  240. { REG_HAECC2, 0x68 }, { 0xa1, 0x03 }, /* magic */
  241. { REG_HAECC3, 0xd8 }, { REG_HAECC4, 0xd8 },
  242. { REG_HAECC5, 0xf0 }, { REG_HAECC6, 0x90 },
  243. { REG_HAECC7, 0x94 },
  244. { REG_COM8, COM8_FASTAEC|COM8_AECSTEP|COM8_BFILT|COM8_AGC|COM8_AEC },
  245. /* Almost all of these are magic "reserved" values. */
  246. { REG_COM5, 0x61 }, { REG_COM6, 0x4b },
  247. { 0x16, 0x02 }, { REG_MVFP, 0x07 },
  248. { 0x21, 0x02 }, { 0x22, 0x91 },
  249. { 0x29, 0x07 }, { 0x33, 0x0b },
  250. { 0x35, 0x0b }, { 0x37, 0x1d },
  251. { 0x38, 0x71 }, { 0x39, 0x2a },
  252. { REG_COM12, 0x78 }, { 0x4d, 0x40 },
  253. { 0x4e, 0x20 }, { REG_GFIX, 0 },
  254. { 0x6b, 0x4a }, { 0x74, 0x10 },
  255. { 0x8d, 0x4f }, { 0x8e, 0 },
  256. { 0x8f, 0 }, { 0x90, 0 },
  257. { 0x91, 0 }, { 0x96, 0 },
  258. { 0x9a, 0 }, { 0xb0, 0x84 },
  259. { 0xb1, 0x0c }, { 0xb2, 0x0e },
  260. { 0xb3, 0x82 }, { 0xb8, 0x0a },
  261. /* More reserved magic, some of which tweaks white balance */
  262. { 0x43, 0x0a }, { 0x44, 0xf0 },
  263. { 0x45, 0x34 }, { 0x46, 0x58 },
  264. { 0x47, 0x28 }, { 0x48, 0x3a },
  265. { 0x59, 0x88 }, { 0x5a, 0x88 },
  266. { 0x5b, 0x44 }, { 0x5c, 0x67 },
  267. { 0x5d, 0x49 }, { 0x5e, 0x0e },
  268. { 0x6c, 0x0a }, { 0x6d, 0x55 },
  269. { 0x6e, 0x11 }, { 0x6f, 0x9f }, /* "9e for advance AWB" */
  270. { 0x6a, 0x40 }, { REG_BLUE, 0x40 },
  271. { REG_RED, 0x60 },
  272. { REG_COM8, COM8_FASTAEC|COM8_AECSTEP|COM8_BFILT|COM8_AGC|COM8_AEC|COM8_AWB },
  273. /* Matrix coefficients */
  274. { 0x4f, 0x80 }, { 0x50, 0x80 },
  275. { 0x51, 0 }, { 0x52, 0x22 },
  276. { 0x53, 0x5e }, { 0x54, 0x80 },
  277. { 0x58, 0x9e },
  278. { REG_COM16, COM16_AWBGAIN }, { REG_EDGE, 0 },
  279. { 0x75, 0x05 }, { 0x76, 0xe1 },
  280. { 0x4c, 0 }, { 0x77, 0x01 },
  281. { REG_COM13, 0xc3 }, { 0x4b, 0x09 },
  282. { 0xc9, 0x60 }, { REG_COM16, 0x38 },
  283. { 0x56, 0x40 },
  284. { 0x34, 0x11 }, { REG_COM11, COM11_EXP|COM11_HZAUTO },
  285. { 0xa4, 0x88 }, { 0x96, 0 },
  286. { 0x97, 0x30 }, { 0x98, 0x20 },
  287. { 0x99, 0x30 }, { 0x9a, 0x84 },
  288. { 0x9b, 0x29 }, { 0x9c, 0x03 },
  289. { 0x9d, 0x4c }, { 0x9e, 0x3f },
  290. { 0x78, 0x04 },
  291. /* Extra-weird stuff. Some sort of multiplexor register */
  292. { 0x79, 0x01 }, { 0xc8, 0xf0 },
  293. { 0x79, 0x0f }, { 0xc8, 0x00 },
  294. { 0x79, 0x10 }, { 0xc8, 0x7e },
  295. { 0x79, 0x0a }, { 0xc8, 0x80 },
  296. { 0x79, 0x0b }, { 0xc8, 0x01 },
  297. { 0x79, 0x0c }, { 0xc8, 0x0f },
  298. { 0x79, 0x0d }, { 0xc8, 0x20 },
  299. { 0x79, 0x09 }, { 0xc8, 0x80 },
  300. { 0x79, 0x02 }, { 0xc8, 0xc0 },
  301. { 0x79, 0x03 }, { 0xc8, 0x40 },
  302. { 0x79, 0x05 }, { 0xc8, 0x30 },
  303. { 0x79, 0x26 },
  304. { 0xff, 0xff }, /* END MARKER */
  305. };
  306. /*
  307. * Here we'll try to encapsulate the changes for just the output
  308. * video format.
  309. *
  310. * RGB656 and YUV422 come from OV; RGB444 is homebrewed.
  311. *
  312. * IMPORTANT RULE: the first entry must be for COM7, see ov7670_s_fmt for why.
  313. */
  314. static struct regval_list ov7670_fmt_yuv422[] = {
  315. { REG_COM7, 0x0 }, /* Selects YUV mode */
  316. { REG_RGB444, 0 }, /* No RGB444 please */
  317. { REG_COM1, 0 }, /* CCIR601 */
  318. { REG_COM15, COM15_R00FF },
  319. { REG_COM9, 0x18 }, /* 4x gain ceiling; 0x8 is reserved bit */
  320. { 0x4f, 0x80 }, /* "matrix coefficient 1" */
  321. { 0x50, 0x80 }, /* "matrix coefficient 2" */
  322. { 0x51, 0 }, /* vb */
  323. { 0x52, 0x22 }, /* "matrix coefficient 4" */
  324. { 0x53, 0x5e }, /* "matrix coefficient 5" */
  325. { 0x54, 0x80 }, /* "matrix coefficient 6" */
  326. { REG_COM13, COM13_GAMMA|COM13_UVSAT },
  327. { 0xff, 0xff },
  328. };
  329. static struct regval_list ov7670_fmt_rgb565[] = {
  330. { REG_COM7, COM7_RGB }, /* Selects RGB mode */
  331. { REG_RGB444, 0 }, /* No RGB444 please */
  332. { REG_COM1, 0x0 }, /* CCIR601 */
  333. { REG_COM15, COM15_RGB565 },
  334. { REG_COM9, 0x38 }, /* 16x gain ceiling; 0x8 is reserved bit */
  335. { 0x4f, 0xb3 }, /* "matrix coefficient 1" */
  336. { 0x50, 0xb3 }, /* "matrix coefficient 2" */
  337. { 0x51, 0 }, /* vb */
  338. { 0x52, 0x3d }, /* "matrix coefficient 4" */
  339. { 0x53, 0xa7 }, /* "matrix coefficient 5" */
  340. { 0x54, 0xe4 }, /* "matrix coefficient 6" */
  341. { REG_COM13, COM13_GAMMA|COM13_UVSAT },
  342. { 0xff, 0xff },
  343. };
  344. static struct regval_list ov7670_fmt_rgb444[] = {
  345. { REG_COM7, COM7_RGB }, /* Selects RGB mode */
  346. { REG_RGB444, R444_ENABLE }, /* Enable xxxxrrrr ggggbbbb */
  347. { REG_COM1, 0x0 }, /* CCIR601 */
  348. { REG_COM15, COM15_R01FE|COM15_RGB565 }, /* Data range needed? */
  349. { REG_COM9, 0x38 }, /* 16x gain ceiling; 0x8 is reserved bit */
  350. { 0x4f, 0xb3 }, /* "matrix coefficient 1" */
  351. { 0x50, 0xb3 }, /* "matrix coefficient 2" */
  352. { 0x51, 0 }, /* vb */
  353. { 0x52, 0x3d }, /* "matrix coefficient 4" */
  354. { 0x53, 0xa7 }, /* "matrix coefficient 5" */
  355. { 0x54, 0xe4 }, /* "matrix coefficient 6" */
  356. { REG_COM13, COM13_GAMMA|COM13_UVSAT|0x2 }, /* Magic rsvd bit */
  357. { 0xff, 0xff },
  358. };
  359. static struct regval_list ov7670_fmt_raw[] = {
  360. { REG_COM7, COM7_BAYER },
  361. { REG_COM13, 0x08 }, /* No gamma, magic rsvd bit */
  362. { REG_COM16, 0x3d }, /* Edge enhancement, denoise */
  363. { REG_REG76, 0xe1 }, /* Pix correction, magic rsvd */
  364. { 0xff, 0xff },
  365. };
  366. /*
  367. * Low-level register I/O.
  368. */
  369. static int ov7670_read(struct v4l2_subdev *sd, unsigned char reg,
  370. unsigned char *value)
  371. {
  372. struct i2c_client *client = v4l2_get_subdevdata(sd);
  373. u8 data = reg;
  374. struct i2c_msg msg;
  375. int ret;
  376. /*
  377. * Send out the register address...
  378. */
  379. msg.addr = client->addr;
  380. msg.flags = 0;
  381. msg.len = 1;
  382. msg.buf = &data;
  383. ret = i2c_transfer(client->adapter, &msg, 1);
  384. if (ret < 0) {
  385. printk(KERN_ERR "Error %d on register write\n", ret);
  386. return ret;
  387. }
  388. /*
  389. * ...then read back the result.
  390. */
  391. msg.flags = I2C_M_RD;
  392. ret = i2c_transfer(client->adapter, &msg, 1);
  393. if (ret >= 0) {
  394. *value = data;
  395. ret = 0;
  396. }
  397. return ret;
  398. }
  399. static int ov7670_write(struct v4l2_subdev *sd, unsigned char reg,
  400. unsigned char value)
  401. {
  402. struct i2c_client *client = v4l2_get_subdevdata(sd);
  403. struct i2c_msg msg;
  404. unsigned char data[2] = { reg, value };
  405. int ret;
  406. msg.addr = client->addr;
  407. msg.flags = 0;
  408. msg.len = 2;
  409. msg.buf = data;
  410. ret = i2c_transfer(client->adapter, &msg, 1);
  411. if (ret > 0)
  412. ret = 0;
  413. if (reg == REG_COM7 && (value & COM7_RESET))
  414. msleep(5); /* Wait for reset to run */
  415. return ret;
  416. }
  417. /*
  418. * Write a list of register settings; ff/ff stops the process.
  419. */
  420. static int ov7670_write_array(struct v4l2_subdev *sd, struct regval_list *vals)
  421. {
  422. while (vals->reg_num != 0xff || vals->value != 0xff) {
  423. int ret = ov7670_write(sd, vals->reg_num, vals->value);
  424. if (ret < 0)
  425. return ret;
  426. vals++;
  427. }
  428. return 0;
  429. }
  430. /*
  431. * Stuff that knows about the sensor.
  432. */
  433. static int ov7670_reset(struct v4l2_subdev *sd, u32 val)
  434. {
  435. ov7670_write(sd, REG_COM7, COM7_RESET);
  436. msleep(1);
  437. return 0;
  438. }
  439. static int ov7670_init(struct v4l2_subdev *sd, u32 val)
  440. {
  441. return ov7670_write_array(sd, ov7670_default_regs);
  442. }
  443. static int ov7670_detect(struct v4l2_subdev *sd)
  444. {
  445. unsigned char v;
  446. int ret;
  447. ret = ov7670_init(sd, 0);
  448. if (ret < 0)
  449. return ret;
  450. ret = ov7670_read(sd, REG_MIDH, &v);
  451. if (ret < 0)
  452. return ret;
  453. if (v != 0x7f) /* OV manuf. id. */
  454. return -ENODEV;
  455. ret = ov7670_read(sd, REG_MIDL, &v);
  456. if (ret < 0)
  457. return ret;
  458. if (v != 0xa2)
  459. return -ENODEV;
  460. /*
  461. * OK, we know we have an OmniVision chip...but which one?
  462. */
  463. ret = ov7670_read(sd, REG_PID, &v);
  464. if (ret < 0)
  465. return ret;
  466. if (v != 0x76) /* PID + VER = 0x76 / 0x73 */
  467. return -ENODEV;
  468. ret = ov7670_read(sd, REG_VER, &v);
  469. if (ret < 0)
  470. return ret;
  471. if (v != 0x73) /* PID + VER = 0x76 / 0x73 */
  472. return -ENODEV;
  473. return 0;
  474. }
  475. /*
  476. * Store information about the video data format. The color matrix
  477. * is deeply tied into the format, so keep the relevant values here.
  478. * The magic matrix nubmers come from OmniVision.
  479. */
  480. static struct ov7670_format_struct {
  481. __u8 *desc;
  482. __u32 pixelformat;
  483. struct regval_list *regs;
  484. int cmatrix[CMATRIX_LEN];
  485. int bpp; /* Bytes per pixel */
  486. } ov7670_formats[] = {
  487. {
  488. .desc = "YUYV 4:2:2",
  489. .pixelformat = V4L2_PIX_FMT_YUYV,
  490. .regs = ov7670_fmt_yuv422,
  491. .cmatrix = { 128, -128, 0, -34, -94, 128 },
  492. .bpp = 2,
  493. },
  494. {
  495. .desc = "RGB 444",
  496. .pixelformat = V4L2_PIX_FMT_RGB444,
  497. .regs = ov7670_fmt_rgb444,
  498. .cmatrix = { 179, -179, 0, -61, -176, 228 },
  499. .bpp = 2,
  500. },
  501. {
  502. .desc = "RGB 565",
  503. .pixelformat = V4L2_PIX_FMT_RGB565,
  504. .regs = ov7670_fmt_rgb565,
  505. .cmatrix = { 179, -179, 0, -61, -176, 228 },
  506. .bpp = 2,
  507. },
  508. {
  509. .desc = "Raw RGB Bayer",
  510. .pixelformat = V4L2_PIX_FMT_SBGGR8,
  511. .regs = ov7670_fmt_raw,
  512. .cmatrix = { 0, 0, 0, 0, 0, 0 },
  513. .bpp = 1
  514. },
  515. };
  516. #define N_OV7670_FMTS ARRAY_SIZE(ov7670_formats)
  517. /*
  518. * Then there is the issue of window sizes. Try to capture the info here.
  519. */
  520. /*
  521. * QCIF mode is done (by OV) in a very strange way - it actually looks like
  522. * VGA with weird scaling options - they do *not* use the canned QCIF mode
  523. * which is allegedly provided by the sensor. So here's the weird register
  524. * settings.
  525. */
  526. static struct regval_list ov7670_qcif_regs[] = {
  527. { REG_COM3, COM3_SCALEEN|COM3_DCWEN },
  528. { REG_COM3, COM3_DCWEN },
  529. { REG_COM14, COM14_DCWEN | 0x01},
  530. { 0x73, 0xf1 },
  531. { 0xa2, 0x52 },
  532. { 0x7b, 0x1c },
  533. { 0x7c, 0x28 },
  534. { 0x7d, 0x3c },
  535. { 0x7f, 0x69 },
  536. { REG_COM9, 0x38 },
  537. { 0xa1, 0x0b },
  538. { 0x74, 0x19 },
  539. { 0x9a, 0x80 },
  540. { 0x43, 0x14 },
  541. { REG_COM13, 0xc0 },
  542. { 0xff, 0xff },
  543. };
  544. static struct ov7670_win_size {
  545. int width;
  546. int height;
  547. unsigned char com7_bit;
  548. int hstart; /* Start/stop values for the camera. Note */
  549. int hstop; /* that they do not always make complete */
  550. int vstart; /* sense to humans, but evidently the sensor */
  551. int vstop; /* will do the right thing... */
  552. struct regval_list *regs; /* Regs to tweak */
  553. /* h/vref stuff */
  554. } ov7670_win_sizes[] = {
  555. /* VGA */
  556. {
  557. .width = VGA_WIDTH,
  558. .height = VGA_HEIGHT,
  559. .com7_bit = COM7_FMT_VGA,
  560. .hstart = 158, /* These values from */
  561. .hstop = 14, /* Omnivision */
  562. .vstart = 10,
  563. .vstop = 490,
  564. .regs = NULL,
  565. },
  566. /* CIF */
  567. {
  568. .width = CIF_WIDTH,
  569. .height = CIF_HEIGHT,
  570. .com7_bit = COM7_FMT_CIF,
  571. .hstart = 170, /* Empirically determined */
  572. .hstop = 90,
  573. .vstart = 14,
  574. .vstop = 494,
  575. .regs = NULL,
  576. },
  577. /* QVGA */
  578. {
  579. .width = QVGA_WIDTH,
  580. .height = QVGA_HEIGHT,
  581. .com7_bit = COM7_FMT_QVGA,
  582. .hstart = 164, /* Empirically determined */
  583. .hstop = 20,
  584. .vstart = 14,
  585. .vstop = 494,
  586. .regs = NULL,
  587. },
  588. /* QCIF */
  589. {
  590. .width = QCIF_WIDTH,
  591. .height = QCIF_HEIGHT,
  592. .com7_bit = COM7_FMT_VGA, /* see comment above */
  593. .hstart = 456, /* Empirically determined */
  594. .hstop = 24,
  595. .vstart = 14,
  596. .vstop = 494,
  597. .regs = ov7670_qcif_regs,
  598. },
  599. };
  600. #define N_WIN_SIZES (ARRAY_SIZE(ov7670_win_sizes))
  601. /*
  602. * Store a set of start/stop values into the camera.
  603. */
  604. static int ov7670_set_hw(struct v4l2_subdev *sd, int hstart, int hstop,
  605. int vstart, int vstop)
  606. {
  607. int ret;
  608. unsigned char v;
  609. /*
  610. * Horizontal: 11 bits, top 8 live in hstart and hstop. Bottom 3 of
  611. * hstart are in href[2:0], bottom 3 of hstop in href[5:3]. There is
  612. * a mystery "edge offset" value in the top two bits of href.
  613. */
  614. ret = ov7670_write(sd, REG_HSTART, (hstart >> 3) & 0xff);
  615. ret += ov7670_write(sd, REG_HSTOP, (hstop >> 3) & 0xff);
  616. ret += ov7670_read(sd, REG_HREF, &v);
  617. v = (v & 0xc0) | ((hstop & 0x7) << 3) | (hstart & 0x7);
  618. msleep(10);
  619. ret += ov7670_write(sd, REG_HREF, v);
  620. /*
  621. * Vertical: similar arrangement, but only 10 bits.
  622. */
  623. ret += ov7670_write(sd, REG_VSTART, (vstart >> 2) & 0xff);
  624. ret += ov7670_write(sd, REG_VSTOP, (vstop >> 2) & 0xff);
  625. ret += ov7670_read(sd, REG_VREF, &v);
  626. v = (v & 0xf0) | ((vstop & 0x3) << 2) | (vstart & 0x3);
  627. msleep(10);
  628. ret += ov7670_write(sd, REG_VREF, v);
  629. return ret;
  630. }
  631. static int ov7670_enum_fmt(struct v4l2_subdev *sd, struct v4l2_fmtdesc *fmt)
  632. {
  633. struct ov7670_format_struct *ofmt;
  634. if (fmt->index >= N_OV7670_FMTS)
  635. return -EINVAL;
  636. ofmt = ov7670_formats + fmt->index;
  637. fmt->flags = 0;
  638. strcpy(fmt->description, ofmt->desc);
  639. fmt->pixelformat = ofmt->pixelformat;
  640. return 0;
  641. }
  642. static int ov7670_try_fmt_internal(struct v4l2_subdev *sd,
  643. struct v4l2_format *fmt,
  644. struct ov7670_format_struct **ret_fmt,
  645. struct ov7670_win_size **ret_wsize)
  646. {
  647. int index;
  648. struct ov7670_win_size *wsize;
  649. struct v4l2_pix_format *pix = &fmt->fmt.pix;
  650. for (index = 0; index < N_OV7670_FMTS; index++)
  651. if (ov7670_formats[index].pixelformat == pix->pixelformat)
  652. break;
  653. if (index >= N_OV7670_FMTS) {
  654. /* default to first format */
  655. index = 0;
  656. pix->pixelformat = ov7670_formats[0].pixelformat;
  657. }
  658. if (ret_fmt != NULL)
  659. *ret_fmt = ov7670_formats + index;
  660. /*
  661. * Fields: the OV devices claim to be progressive.
  662. */
  663. pix->field = V4L2_FIELD_NONE;
  664. /*
  665. * Round requested image size down to the nearest
  666. * we support, but not below the smallest.
  667. */
  668. for (wsize = ov7670_win_sizes; wsize < ov7670_win_sizes + N_WIN_SIZES;
  669. wsize++)
  670. if (pix->width >= wsize->width && pix->height >= wsize->height)
  671. break;
  672. if (wsize >= ov7670_win_sizes + N_WIN_SIZES)
  673. wsize--; /* Take the smallest one */
  674. if (ret_wsize != NULL)
  675. *ret_wsize = wsize;
  676. /*
  677. * Note the size we'll actually handle.
  678. */
  679. pix->width = wsize->width;
  680. pix->height = wsize->height;
  681. pix->bytesperline = pix->width*ov7670_formats[index].bpp;
  682. pix->sizeimage = pix->height*pix->bytesperline;
  683. return 0;
  684. }
  685. static int ov7670_try_fmt(struct v4l2_subdev *sd, struct v4l2_format *fmt)
  686. {
  687. return ov7670_try_fmt_internal(sd, fmt, NULL, NULL);
  688. }
  689. /*
  690. * Set a format.
  691. */
  692. static int ov7670_s_fmt(struct v4l2_subdev *sd, struct v4l2_format *fmt)
  693. {
  694. int ret;
  695. struct ov7670_format_struct *ovfmt;
  696. struct ov7670_win_size *wsize;
  697. struct ov7670_info *info = to_state(sd);
  698. unsigned char com7;
  699. ret = ov7670_try_fmt_internal(sd, fmt, &ovfmt, &wsize);
  700. if (ret)
  701. return ret;
  702. /*
  703. * COM7 is a pain in the ass, it doesn't like to be read then
  704. * quickly written afterward. But we have everything we need
  705. * to set it absolutely here, as long as the format-specific
  706. * register sets list it first.
  707. */
  708. com7 = ovfmt->regs[0].value;
  709. com7 |= wsize->com7_bit;
  710. ov7670_write(sd, REG_COM7, com7);
  711. /*
  712. * Now write the rest of the array. Also store start/stops
  713. */
  714. ov7670_write_array(sd, ovfmt->regs + 1);
  715. ov7670_set_hw(sd, wsize->hstart, wsize->hstop, wsize->vstart,
  716. wsize->vstop);
  717. ret = 0;
  718. if (wsize->regs)
  719. ret = ov7670_write_array(sd, wsize->regs);
  720. info->fmt = ovfmt;
  721. /*
  722. * If we're running RGB565, we must rewrite clkrc after setting
  723. * the other parameters or the image looks poor. If we're *not*
  724. * doing RGB565, we must not rewrite clkrc or the image looks
  725. * *really* poor.
  726. */
  727. if (fmt->fmt.pix.pixelformat == V4L2_PIX_FMT_RGB565 && ret == 0)
  728. ret = ov7670_write(sd, REG_CLKRC, info->clkrc);
  729. return ret;
  730. }
  731. /*
  732. * Implement G/S_PARM. There is a "high quality" mode we could try
  733. * to do someday; for now, we just do the frame rate tweak.
  734. */
  735. static int ov7670_g_parm(struct v4l2_subdev *sd, struct v4l2_streamparm *parms)
  736. {
  737. struct v4l2_captureparm *cp = &parms->parm.capture;
  738. struct ov7670_info *info = to_state(sd);
  739. if (parms->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
  740. return -EINVAL;
  741. memset(cp, 0, sizeof(struct v4l2_captureparm));
  742. cp->capability = V4L2_CAP_TIMEPERFRAME;
  743. cp->timeperframe.numerator = 1;
  744. cp->timeperframe.denominator = OV7670_FRAME_RATE;
  745. if ((info->clkrc & CLK_EXT) == 0 && (info->clkrc & CLK_SCALE) > 1)
  746. cp->timeperframe.denominator /= (info->clkrc & CLK_SCALE);
  747. return 0;
  748. }
  749. static int ov7670_s_parm(struct v4l2_subdev *sd, struct v4l2_streamparm *parms)
  750. {
  751. struct v4l2_captureparm *cp = &parms->parm.capture;
  752. struct v4l2_fract *tpf = &cp->timeperframe;
  753. struct ov7670_info *info = to_state(sd);
  754. unsigned char clkrc;
  755. int ret, div;
  756. if (parms->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
  757. return -EINVAL;
  758. if (cp->extendedmode != 0)
  759. return -EINVAL;
  760. if (tpf->numerator == 0 || tpf->denominator == 0)
  761. div = 1; /* Reset to full rate */
  762. else
  763. div = (tpf->numerator*OV7670_FRAME_RATE)/tpf->denominator;
  764. if (div == 0)
  765. div = 1;
  766. else if (div > CLK_SCALE)
  767. div = CLK_SCALE;
  768. info->clkrc = (info->clkrc & 0x80) | div;
  769. tpf->numerator = 1;
  770. tpf->denominator = OV7670_FRAME_RATE/div;
  771. return ov7670_write(sd, REG_CLKRC, info->clkrc);
  772. }
  773. /*
  774. * Code for dealing with controls.
  775. */
  776. static int ov7670_store_cmatrix(struct v4l2_subdev *sd,
  777. int matrix[CMATRIX_LEN])
  778. {
  779. int i, ret;
  780. unsigned char signbits = 0;
  781. /*
  782. * Weird crap seems to exist in the upper part of
  783. * the sign bits register, so let's preserve it.
  784. */
  785. ret = ov7670_read(sd, REG_CMATRIX_SIGN, &signbits);
  786. signbits &= 0xc0;
  787. for (i = 0; i < CMATRIX_LEN; i++) {
  788. unsigned char raw;
  789. if (matrix[i] < 0) {
  790. signbits |= (1 << i);
  791. if (matrix[i] < -255)
  792. raw = 0xff;
  793. else
  794. raw = (-1 * matrix[i]) & 0xff;
  795. }
  796. else {
  797. if (matrix[i] > 255)
  798. raw = 0xff;
  799. else
  800. raw = matrix[i] & 0xff;
  801. }
  802. ret += ov7670_write(sd, REG_CMATRIX_BASE + i, raw);
  803. }
  804. ret += ov7670_write(sd, REG_CMATRIX_SIGN, signbits);
  805. return ret;
  806. }
  807. /*
  808. * Hue also requires messing with the color matrix. It also requires
  809. * trig functions, which tend not to be well supported in the kernel.
  810. * So here is a simple table of sine values, 0-90 degrees, in steps
  811. * of five degrees. Values are multiplied by 1000.
  812. *
  813. * The following naive approximate trig functions require an argument
  814. * carefully limited to -180 <= theta <= 180.
  815. */
  816. #define SIN_STEP 5
  817. static const int ov7670_sin_table[] = {
  818. 0, 87, 173, 258, 342, 422,
  819. 499, 573, 642, 707, 766, 819,
  820. 866, 906, 939, 965, 984, 996,
  821. 1000
  822. };
  823. static int ov7670_sine(int theta)
  824. {
  825. int chs = 1;
  826. int sine;
  827. if (theta < 0) {
  828. theta = -theta;
  829. chs = -1;
  830. }
  831. if (theta <= 90)
  832. sine = ov7670_sin_table[theta/SIN_STEP];
  833. else {
  834. theta -= 90;
  835. sine = 1000 - ov7670_sin_table[theta/SIN_STEP];
  836. }
  837. return sine*chs;
  838. }
  839. static int ov7670_cosine(int theta)
  840. {
  841. theta = 90 - theta;
  842. if (theta > 180)
  843. theta -= 360;
  844. else if (theta < -180)
  845. theta += 360;
  846. return ov7670_sine(theta);
  847. }
  848. static void ov7670_calc_cmatrix(struct ov7670_info *info,
  849. int matrix[CMATRIX_LEN])
  850. {
  851. int i;
  852. /*
  853. * Apply the current saturation setting first.
  854. */
  855. for (i = 0; i < CMATRIX_LEN; i++)
  856. matrix[i] = (info->fmt->cmatrix[i]*info->sat) >> 7;
  857. /*
  858. * Then, if need be, rotate the hue value.
  859. */
  860. if (info->hue != 0) {
  861. int sinth, costh, tmpmatrix[CMATRIX_LEN];
  862. memcpy(tmpmatrix, matrix, CMATRIX_LEN*sizeof(int));
  863. sinth = ov7670_sine(info->hue);
  864. costh = ov7670_cosine(info->hue);
  865. matrix[0] = (matrix[3]*sinth + matrix[0]*costh)/1000;
  866. matrix[1] = (matrix[4]*sinth + matrix[1]*costh)/1000;
  867. matrix[2] = (matrix[5]*sinth + matrix[2]*costh)/1000;
  868. matrix[3] = (matrix[3]*costh - matrix[0]*sinth)/1000;
  869. matrix[4] = (matrix[4]*costh - matrix[1]*sinth)/1000;
  870. matrix[5] = (matrix[5]*costh - matrix[2]*sinth)/1000;
  871. }
  872. }
  873. static int ov7670_s_sat(struct v4l2_subdev *sd, int value)
  874. {
  875. struct ov7670_info *info = to_state(sd);
  876. int matrix[CMATRIX_LEN];
  877. int ret;
  878. info->sat = value;
  879. ov7670_calc_cmatrix(info, matrix);
  880. ret = ov7670_store_cmatrix(sd, matrix);
  881. return ret;
  882. }
  883. static int ov7670_g_sat(struct v4l2_subdev *sd, __s32 *value)
  884. {
  885. struct ov7670_info *info = to_state(sd);
  886. *value = info->sat;
  887. return 0;
  888. }
  889. static int ov7670_s_hue(struct v4l2_subdev *sd, int value)
  890. {
  891. struct ov7670_info *info = to_state(sd);
  892. int matrix[CMATRIX_LEN];
  893. int ret;
  894. if (value < -180 || value > 180)
  895. return -EINVAL;
  896. info->hue = value;
  897. ov7670_calc_cmatrix(info, matrix);
  898. ret = ov7670_store_cmatrix(sd, matrix);
  899. return ret;
  900. }
  901. static int ov7670_g_hue(struct v4l2_subdev *sd, __s32 *value)
  902. {
  903. struct ov7670_info *info = to_state(sd);
  904. *value = info->hue;
  905. return 0;
  906. }
  907. /*
  908. * Some weird registers seem to store values in a sign/magnitude format!
  909. */
  910. static unsigned char ov7670_sm_to_abs(unsigned char v)
  911. {
  912. if ((v & 0x80) == 0)
  913. return v + 128;
  914. return 128 - (v & 0x7f);
  915. }
  916. static unsigned char ov7670_abs_to_sm(unsigned char v)
  917. {
  918. if (v > 127)
  919. return v & 0x7f;
  920. return (128 - v) | 0x80;
  921. }
  922. static int ov7670_s_brightness(struct v4l2_subdev *sd, int value)
  923. {
  924. unsigned char com8 = 0, v;
  925. int ret;
  926. ov7670_read(sd, REG_COM8, &com8);
  927. com8 &= ~COM8_AEC;
  928. ov7670_write(sd, REG_COM8, com8);
  929. v = ov7670_abs_to_sm(value);
  930. ret = ov7670_write(sd, REG_BRIGHT, v);
  931. return ret;
  932. }
  933. static int ov7670_g_brightness(struct v4l2_subdev *sd, __s32 *value)
  934. {
  935. unsigned char v = 0;
  936. int ret = ov7670_read(sd, REG_BRIGHT, &v);
  937. *value = ov7670_sm_to_abs(v);
  938. return ret;
  939. }
  940. static int ov7670_s_contrast(struct v4l2_subdev *sd, int value)
  941. {
  942. return ov7670_write(sd, REG_CONTRAS, (unsigned char) value);
  943. }
  944. static int ov7670_g_contrast(struct v4l2_subdev *sd, __s32 *value)
  945. {
  946. unsigned char v = 0;
  947. int ret = ov7670_read(sd, REG_CONTRAS, &v);
  948. *value = v;
  949. return ret;
  950. }
  951. static int ov7670_g_hflip(struct v4l2_subdev *sd, __s32 *value)
  952. {
  953. int ret;
  954. unsigned char v = 0;
  955. ret = ov7670_read(sd, REG_MVFP, &v);
  956. *value = (v & MVFP_MIRROR) == MVFP_MIRROR;
  957. return ret;
  958. }
  959. static int ov7670_s_hflip(struct v4l2_subdev *sd, int value)
  960. {
  961. unsigned char v = 0;
  962. int ret;
  963. ret = ov7670_read(sd, REG_MVFP, &v);
  964. if (value)
  965. v |= MVFP_MIRROR;
  966. else
  967. v &= ~MVFP_MIRROR;
  968. msleep(10); /* FIXME */
  969. ret += ov7670_write(sd, REG_MVFP, v);
  970. return ret;
  971. }
  972. static int ov7670_g_vflip(struct v4l2_subdev *sd, __s32 *value)
  973. {
  974. int ret;
  975. unsigned char v = 0;
  976. ret = ov7670_read(sd, REG_MVFP, &v);
  977. *value = (v & MVFP_FLIP) == MVFP_FLIP;
  978. return ret;
  979. }
  980. static int ov7670_s_vflip(struct v4l2_subdev *sd, int value)
  981. {
  982. unsigned char v = 0;
  983. int ret;
  984. ret = ov7670_read(sd, REG_MVFP, &v);
  985. if (value)
  986. v |= MVFP_FLIP;
  987. else
  988. v &= ~MVFP_FLIP;
  989. msleep(10); /* FIXME */
  990. ret += ov7670_write(sd, REG_MVFP, v);
  991. return ret;
  992. }
  993. /*
  994. * GAIN is split between REG_GAIN and REG_VREF[7:6]. If one believes
  995. * the data sheet, the VREF parts should be the most significant, but
  996. * experience shows otherwise. There seems to be little value in
  997. * messing with the VREF bits, so we leave them alone.
  998. */
  999. static int ov7670_g_gain(struct v4l2_subdev *sd, __s32 *value)
  1000. {
  1001. int ret;
  1002. unsigned char gain;
  1003. ret = ov7670_read(sd, REG_GAIN, &gain);
  1004. *value = gain;
  1005. return ret;
  1006. }
  1007. static int ov7670_s_gain(struct v4l2_subdev *sd, int value)
  1008. {
  1009. int ret;
  1010. unsigned char com8;
  1011. ret = ov7670_write(sd, REG_GAIN, value & 0xff);
  1012. /* Have to turn off AGC as well */
  1013. if (ret == 0) {
  1014. ret = ov7670_read(sd, REG_COM8, &com8);
  1015. ret = ov7670_write(sd, REG_COM8, com8 & ~COM8_AGC);
  1016. }
  1017. return ret;
  1018. }
  1019. /*
  1020. * Tweak autogain.
  1021. */
  1022. static int ov7670_g_autogain(struct v4l2_subdev *sd, __s32 *value)
  1023. {
  1024. int ret;
  1025. unsigned char com8;
  1026. ret = ov7670_read(sd, REG_COM8, &com8);
  1027. *value = (com8 & COM8_AGC) != 0;
  1028. return ret;
  1029. }
  1030. static int ov7670_s_autogain(struct v4l2_subdev *sd, int value)
  1031. {
  1032. int ret;
  1033. unsigned char com8;
  1034. ret = ov7670_read(sd, REG_COM8, &com8);
  1035. if (ret == 0) {
  1036. if (value)
  1037. com8 |= COM8_AGC;
  1038. else
  1039. com8 &= ~COM8_AGC;
  1040. ret = ov7670_write(sd, REG_COM8, com8);
  1041. }
  1042. return ret;
  1043. }
  1044. /*
  1045. * Exposure is spread all over the place: top 6 bits in AECHH, middle
  1046. * 8 in AECH, and two stashed in COM1 just for the hell of it.
  1047. */
  1048. static int ov7670_g_exp(struct v4l2_subdev *sd, __s32 *value)
  1049. {
  1050. int ret;
  1051. unsigned char com1, aech, aechh;
  1052. ret = ov7670_read(sd, REG_COM1, &com1) +
  1053. ov7670_read(sd, REG_AECH, &aech) +
  1054. ov7670_read(sd, REG_AECHH, &aechh);
  1055. *value = ((aechh & 0x3f) << 10) | (aech << 2) | (com1 & 0x03);
  1056. return ret;
  1057. }
  1058. static int ov7670_s_exp(struct v4l2_subdev *sd, int value)
  1059. {
  1060. int ret;
  1061. unsigned char com1, com8, aech, aechh;
  1062. ret = ov7670_read(sd, REG_COM1, &com1) +
  1063. ov7670_read(sd, REG_COM8, &com8);
  1064. ov7670_read(sd, REG_AECHH, &aechh);
  1065. if (ret)
  1066. return ret;
  1067. com1 = (com1 & 0xfc) | (value & 0x03);
  1068. aech = (value >> 2) & 0xff;
  1069. aechh = (aechh & 0xc0) | ((value >> 10) & 0x3f);
  1070. ret = ov7670_write(sd, REG_COM1, com1) +
  1071. ov7670_write(sd, REG_AECH, aech) +
  1072. ov7670_write(sd, REG_AECHH, aechh);
  1073. /* Have to turn off AEC as well */
  1074. if (ret == 0)
  1075. ret = ov7670_write(sd, REG_COM8, com8 & ~COM8_AEC);
  1076. return ret;
  1077. }
  1078. /*
  1079. * Tweak autoexposure.
  1080. */
  1081. static int ov7670_g_autoexp(struct v4l2_subdev *sd, __s32 *value)
  1082. {
  1083. int ret;
  1084. unsigned char com8;
  1085. enum v4l2_exposure_auto_type *atype = (enum v4l2_exposure_auto_type *) value;
  1086. ret = ov7670_read(sd, REG_COM8, &com8);
  1087. if (com8 & COM8_AEC)
  1088. *value = V4L2_EXPOSURE_AUTO;
  1089. else
  1090. *value = V4L2_EXPOSURE_MANUAL;
  1091. return ret;
  1092. }
  1093. static int ov7670_s_autoexp(struct v4l2_subdev *sd,
  1094. enum v4l2_exposure_auto_type value)
  1095. {
  1096. int ret;
  1097. unsigned char com8;
  1098. ret = ov7670_read(sd, REG_COM8, &com8);
  1099. if (ret == 0) {
  1100. if (value == V4L2_EXPOSURE_AUTO)
  1101. com8 |= COM8_AEC;
  1102. else
  1103. com8 &= ~COM8_AEC;
  1104. ret = ov7670_write(sd, REG_COM8, com8);
  1105. }
  1106. return ret;
  1107. }
  1108. static int ov7670_queryctrl(struct v4l2_subdev *sd,
  1109. struct v4l2_queryctrl *qc)
  1110. {
  1111. /* Fill in min, max, step and default value for these controls. */
  1112. switch (qc->id) {
  1113. case V4L2_CID_BRIGHTNESS:
  1114. return v4l2_ctrl_query_fill(qc, 0, 255, 1, 128);
  1115. case V4L2_CID_CONTRAST:
  1116. return v4l2_ctrl_query_fill(qc, 0, 127, 1, 64);
  1117. case V4L2_CID_VFLIP:
  1118. case V4L2_CID_HFLIP:
  1119. return v4l2_ctrl_query_fill(qc, 0, 1, 1, 0);
  1120. case V4L2_CID_SATURATION:
  1121. return v4l2_ctrl_query_fill(qc, 0, 256, 1, 128);
  1122. case V4L2_CID_HUE:
  1123. return v4l2_ctrl_query_fill(qc, -180, 180, 5, 0);
  1124. case V4L2_CID_GAIN:
  1125. return v4l2_ctrl_query_fill(qc, 0, 255, 1, 128);
  1126. case V4L2_CID_AUTOGAIN:
  1127. return v4l2_ctrl_query_fill(qc, 0, 1, 1, 1);
  1128. case V4L2_CID_EXPOSURE:
  1129. return v4l2_ctrl_query_fill(qc, 0, 65535, 1, 500);
  1130. case V4L2_CID_EXPOSURE_AUTO:
  1131. return v4l2_ctrl_query_fill(qc, 0, 1, 1, 0);
  1132. }
  1133. return -EINVAL;
  1134. }
  1135. static int ov7670_g_ctrl(struct v4l2_subdev *sd, struct v4l2_control *ctrl)
  1136. {
  1137. switch (ctrl->id) {
  1138. case V4L2_CID_BRIGHTNESS:
  1139. return ov7670_g_brightness(sd, &ctrl->value);
  1140. case V4L2_CID_CONTRAST:
  1141. return ov7670_g_contrast(sd, &ctrl->value);
  1142. case V4L2_CID_SATURATION:
  1143. return ov7670_g_sat(sd, &ctrl->value);
  1144. case V4L2_CID_HUE:
  1145. return ov7670_g_hue(sd, &ctrl->value);
  1146. case V4L2_CID_VFLIP:
  1147. return ov7670_g_vflip(sd, &ctrl->value);
  1148. case V4L2_CID_HFLIP:
  1149. return ov7670_g_hflip(sd, &ctrl->value);
  1150. case V4L2_CID_GAIN:
  1151. return ov7670_g_gain(sd, &ctrl->value);
  1152. case V4L2_CID_AUTOGAIN:
  1153. return ov7670_g_autogain(sd, &ctrl->value);
  1154. case V4L2_CID_EXPOSURE:
  1155. return ov7670_g_exp(sd, &ctrl->value);
  1156. case V4L2_CID_EXPOSURE_AUTO:
  1157. return ov7670_g_autoexp(sd, &ctrl->value);
  1158. }
  1159. return -EINVAL;
  1160. }
  1161. static int ov7670_s_ctrl(struct v4l2_subdev *sd, struct v4l2_control *ctrl)
  1162. {
  1163. switch (ctrl->id) {
  1164. case V4L2_CID_BRIGHTNESS:
  1165. return ov7670_s_brightness(sd, ctrl->value);
  1166. case V4L2_CID_CONTRAST:
  1167. return ov7670_s_contrast(sd, ctrl->value);
  1168. case V4L2_CID_SATURATION:
  1169. return ov7670_s_sat(sd, ctrl->value);
  1170. case V4L2_CID_HUE:
  1171. return ov7670_s_hue(sd, ctrl->value);
  1172. case V4L2_CID_VFLIP:
  1173. return ov7670_s_vflip(sd, ctrl->value);
  1174. case V4L2_CID_HFLIP:
  1175. return ov7670_s_hflip(sd, ctrl->value);
  1176. case V4L2_CID_GAIN:
  1177. return ov7670_s_gain(sd, ctrl->value);
  1178. case V4L2_CID_AUTOGAIN:
  1179. return ov7670_s_autogain(sd, ctrl->value);
  1180. case V4L2_CID_EXPOSURE:
  1181. return ov7670_s_exp(sd, ctrl->value);
  1182. case V4L2_CID_EXPOSURE_AUTO:
  1183. return ov7670_s_autoexp(sd,
  1184. (enum v4l2_exposure_auto_type) ctrl->value);
  1185. }
  1186. return -EINVAL;
  1187. }
  1188. static int ov7670_g_chip_ident(struct v4l2_subdev *sd,
  1189. struct v4l2_dbg_chip_ident *chip)
  1190. {
  1191. struct i2c_client *client = v4l2_get_subdevdata(sd);
  1192. return v4l2_chip_ident_i2c_client(client, chip, V4L2_IDENT_OV7670, 0);
  1193. }
  1194. #ifdef CONFIG_VIDEO_ADV_DEBUG
  1195. static int ov7670_g_register(struct v4l2_subdev *sd, struct v4l2_dbg_register *reg)
  1196. {
  1197. struct i2c_client *client = v4l2_get_subdevdata(sd);
  1198. unsigned char val = 0;
  1199. int ret;
  1200. if (!v4l2_chip_match_i2c_client(client, &reg->match))
  1201. return -EINVAL;
  1202. if (!capable(CAP_SYS_ADMIN))
  1203. return -EPERM;
  1204. ret = ov7670_read(sd, reg->reg & 0xff, &val);
  1205. reg->val = val;
  1206. reg->size = 1;
  1207. return ret;
  1208. }
  1209. static int ov7670_s_register(struct v4l2_subdev *sd, struct v4l2_dbg_register *reg)
  1210. {
  1211. struct i2c_client *client = v4l2_get_subdevdata(sd);
  1212. if (!v4l2_chip_match_i2c_client(client, &reg->match))
  1213. return -EINVAL;
  1214. if (!capable(CAP_SYS_ADMIN))
  1215. return -EPERM;
  1216. ov7670_write(sd, reg->reg & 0xff, reg->val & 0xff);
  1217. return 0;
  1218. }
  1219. #endif
  1220. /* ----------------------------------------------------------------------- */
  1221. static const struct v4l2_subdev_core_ops ov7670_core_ops = {
  1222. .g_chip_ident = ov7670_g_chip_ident,
  1223. .g_ctrl = ov7670_g_ctrl,
  1224. .s_ctrl = ov7670_s_ctrl,
  1225. .queryctrl = ov7670_queryctrl,
  1226. .reset = ov7670_reset,
  1227. .init = ov7670_init,
  1228. #ifdef CONFIG_VIDEO_ADV_DEBUG
  1229. .g_register = ov7670_g_register,
  1230. .s_register = ov7670_s_register,
  1231. #endif
  1232. };
  1233. static const struct v4l2_subdev_video_ops ov7670_video_ops = {
  1234. .enum_fmt = ov7670_enum_fmt,
  1235. .try_fmt = ov7670_try_fmt,
  1236. .s_fmt = ov7670_s_fmt,
  1237. .s_parm = ov7670_s_parm,
  1238. .g_parm = ov7670_g_parm,
  1239. };
  1240. static const struct v4l2_subdev_ops ov7670_ops = {
  1241. .core = &ov7670_core_ops,
  1242. .video = &ov7670_video_ops,
  1243. };
  1244. /* ----------------------------------------------------------------------- */
  1245. static int ov7670_probe(struct i2c_client *client,
  1246. const struct i2c_device_id *id)
  1247. {
  1248. struct v4l2_subdev *sd;
  1249. struct ov7670_info *info;
  1250. int ret;
  1251. info = kzalloc(sizeof(struct ov7670_info), GFP_KERNEL);
  1252. if (info == NULL)
  1253. return -ENOMEM;
  1254. sd = &info->sd;
  1255. v4l2_i2c_subdev_init(sd, client, &ov7670_ops);
  1256. /* Make sure it's an ov7670 */
  1257. ret = ov7670_detect(sd);
  1258. if (ret) {
  1259. v4l_dbg(1, debug, client,
  1260. "chip found @ 0x%x (%s) is not an ov7670 chip.\n",
  1261. client->addr << 1, client->adapter->name);
  1262. kfree(info);
  1263. return ret;
  1264. }
  1265. v4l_info(client, "chip found @ 0x%02x (%s)\n",
  1266. client->addr << 1, client->adapter->name);
  1267. info->fmt = &ov7670_formats[0];
  1268. info->sat = 128; /* Review this */
  1269. info->clkrc = 1; /* 30fps */
  1270. return 0;
  1271. }
  1272. static int ov7670_remove(struct i2c_client *client)
  1273. {
  1274. struct v4l2_subdev *sd = i2c_get_clientdata(client);
  1275. v4l2_device_unregister_subdev(sd);
  1276. kfree(to_state(sd));
  1277. return 0;
  1278. }
  1279. static const struct i2c_device_id ov7670_id[] = {
  1280. { "ov7670", 0 },
  1281. { }
  1282. };
  1283. MODULE_DEVICE_TABLE(i2c, ov7670_id);
  1284. static struct v4l2_i2c_driver_data v4l2_i2c_data = {
  1285. .name = "ov7670",
  1286. .probe = ov7670_probe,
  1287. .remove = ov7670_remove,
  1288. .id_table = ov7670_id,
  1289. };