mt9m111.c 28 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125
  1. /*
  2. * Driver for MT9M111/MT9M112/MT9M131 CMOS Image Sensor from Micron/Aptina
  3. *
  4. * Copyright (C) 2008, Robert Jarzmik <robert.jarzmik@free.fr>
  5. *
  6. * This program is free software; you can redistribute it and/or modify
  7. * it under the terms of the GNU General Public License version 2 as
  8. * published by the Free Software Foundation.
  9. */
  10. #include <linux/videodev2.h>
  11. #include <linux/slab.h>
  12. #include <linux/i2c.h>
  13. #include <linux/log2.h>
  14. #include <linux/gpio.h>
  15. #include <linux/delay.h>
  16. #include <media/v4l2-common.h>
  17. #include <media/v4l2-chip-ident.h>
  18. #include <media/soc_camera.h>
  19. /*
  20. * MT9M111, MT9M112 and MT9M131:
  21. * i2c address is 0x48 or 0x5d (depending on SADDR pin)
  22. * The platform has to define i2c_board_info and call i2c_register_board_info()
  23. */
  24. /*
  25. * Sensor core register addresses (0x000..0x0ff)
  26. */
  27. #define MT9M111_CHIP_VERSION 0x000
  28. #define MT9M111_ROW_START 0x001
  29. #define MT9M111_COLUMN_START 0x002
  30. #define MT9M111_WINDOW_HEIGHT 0x003
  31. #define MT9M111_WINDOW_WIDTH 0x004
  32. #define MT9M111_HORIZONTAL_BLANKING_B 0x005
  33. #define MT9M111_VERTICAL_BLANKING_B 0x006
  34. #define MT9M111_HORIZONTAL_BLANKING_A 0x007
  35. #define MT9M111_VERTICAL_BLANKING_A 0x008
  36. #define MT9M111_SHUTTER_WIDTH 0x009
  37. #define MT9M111_ROW_SPEED 0x00a
  38. #define MT9M111_EXTRA_DELAY 0x00b
  39. #define MT9M111_SHUTTER_DELAY 0x00c
  40. #define MT9M111_RESET 0x00d
  41. #define MT9M111_READ_MODE_B 0x020
  42. #define MT9M111_READ_MODE_A 0x021
  43. #define MT9M111_FLASH_CONTROL 0x023
  44. #define MT9M111_GREEN1_GAIN 0x02b
  45. #define MT9M111_BLUE_GAIN 0x02c
  46. #define MT9M111_RED_GAIN 0x02d
  47. #define MT9M111_GREEN2_GAIN 0x02e
  48. #define MT9M111_GLOBAL_GAIN 0x02f
  49. #define MT9M111_CONTEXT_CONTROL 0x0c8
  50. #define MT9M111_PAGE_MAP 0x0f0
  51. #define MT9M111_BYTE_WISE_ADDR 0x0f1
  52. #define MT9M111_RESET_SYNC_CHANGES (1 << 15)
  53. #define MT9M111_RESET_RESTART_BAD_FRAME (1 << 9)
  54. #define MT9M111_RESET_SHOW_BAD_FRAMES (1 << 8)
  55. #define MT9M111_RESET_RESET_SOC (1 << 5)
  56. #define MT9M111_RESET_OUTPUT_DISABLE (1 << 4)
  57. #define MT9M111_RESET_CHIP_ENABLE (1 << 3)
  58. #define MT9M111_RESET_ANALOG_STANDBY (1 << 2)
  59. #define MT9M111_RESET_RESTART_FRAME (1 << 1)
  60. #define MT9M111_RESET_RESET_MODE (1 << 0)
  61. #define MT9M111_RMB_MIRROR_COLS (1 << 1)
  62. #define MT9M111_RMB_MIRROR_ROWS (1 << 0)
  63. #define MT9M111_CTXT_CTRL_RESTART (1 << 15)
  64. #define MT9M111_CTXT_CTRL_DEFECTCOR_B (1 << 12)
  65. #define MT9M111_CTXT_CTRL_RESIZE_B (1 << 10)
  66. #define MT9M111_CTXT_CTRL_CTRL2_B (1 << 9)
  67. #define MT9M111_CTXT_CTRL_GAMMA_B (1 << 8)
  68. #define MT9M111_CTXT_CTRL_XENON_EN (1 << 7)
  69. #define MT9M111_CTXT_CTRL_READ_MODE_B (1 << 3)
  70. #define MT9M111_CTXT_CTRL_LED_FLASH_EN (1 << 2)
  71. #define MT9M111_CTXT_CTRL_VBLANK_SEL_B (1 << 1)
  72. #define MT9M111_CTXT_CTRL_HBLANK_SEL_B (1 << 0)
  73. /*
  74. * Colorpipe register addresses (0x100..0x1ff)
  75. */
  76. #define MT9M111_OPER_MODE_CTRL 0x106
  77. #define MT9M111_OUTPUT_FORMAT_CTRL 0x108
  78. #define MT9M111_REDUCER_XZOOM_B 0x1a0
  79. #define MT9M111_REDUCER_XSIZE_B 0x1a1
  80. #define MT9M111_REDUCER_YZOOM_B 0x1a3
  81. #define MT9M111_REDUCER_YSIZE_B 0x1a4
  82. #define MT9M111_REDUCER_XZOOM_A 0x1a6
  83. #define MT9M111_REDUCER_XSIZE_A 0x1a7
  84. #define MT9M111_REDUCER_YZOOM_A 0x1a9
  85. #define MT9M111_REDUCER_YSIZE_A 0x1aa
  86. #define MT9M111_OUTPUT_FORMAT_CTRL2_A 0x13a
  87. #define MT9M111_OUTPUT_FORMAT_CTRL2_B 0x19b
  88. #define MT9M111_OPMODE_AUTOEXPO_EN (1 << 14)
  89. #define MT9M111_OPMODE_AUTOWHITEBAL_EN (1 << 1)
  90. #define MT9M111_OUTFMT_PROCESSED_BAYER (1 << 14)
  91. #define MT9M111_OUTFMT_BYPASS_IFP (1 << 10)
  92. #define MT9M111_OUTFMT_INV_PIX_CLOCK (1 << 9)
  93. #define MT9M111_OUTFMT_RGB (1 << 8)
  94. #define MT9M111_OUTFMT_RGB565 (0x0 << 6)
  95. #define MT9M111_OUTFMT_RGB555 (0x1 << 6)
  96. #define MT9M111_OUTFMT_RGB444x (0x2 << 6)
  97. #define MT9M111_OUTFMT_RGBx444 (0x3 << 6)
  98. #define MT9M111_OUTFMT_TST_RAMP_OFF (0x0 << 4)
  99. #define MT9M111_OUTFMT_TST_RAMP_COL (0x1 << 4)
  100. #define MT9M111_OUTFMT_TST_RAMP_ROW (0x2 << 4)
  101. #define MT9M111_OUTFMT_TST_RAMP_FRAME (0x3 << 4)
  102. #define MT9M111_OUTFMT_SHIFT_3_UP (1 << 3)
  103. #define MT9M111_OUTFMT_AVG_CHROMA (1 << 2)
  104. #define MT9M111_OUTFMT_SWAP_YCbCr_C_Y (1 << 1)
  105. #define MT9M111_OUTFMT_SWAP_RGB_EVEN (1 << 1)
  106. #define MT9M111_OUTFMT_SWAP_YCbCr_Cb_Cr (1 << 0)
  107. /*
  108. * Camera control register addresses (0x200..0x2ff not implemented)
  109. */
  110. #define reg_read(reg) mt9m111_reg_read(client, MT9M111_##reg)
  111. #define reg_write(reg, val) mt9m111_reg_write(client, MT9M111_##reg, (val))
  112. #define reg_set(reg, val) mt9m111_reg_set(client, MT9M111_##reg, (val))
  113. #define reg_clear(reg, val) mt9m111_reg_clear(client, MT9M111_##reg, (val))
  114. #define MT9M111_MIN_DARK_ROWS 8
  115. #define MT9M111_MIN_DARK_COLS 24
  116. #define MT9M111_MAX_HEIGHT 1024
  117. #define MT9M111_MAX_WIDTH 1280
  118. /* MT9M111 has only one fixed colorspace per pixelcode */
  119. struct mt9m111_datafmt {
  120. enum v4l2_mbus_pixelcode code;
  121. enum v4l2_colorspace colorspace;
  122. };
  123. /* Find a data format by a pixel code in an array */
  124. static const struct mt9m111_datafmt *mt9m111_find_datafmt(
  125. enum v4l2_mbus_pixelcode code, const struct mt9m111_datafmt *fmt,
  126. int n)
  127. {
  128. int i;
  129. for (i = 0; i < n; i++)
  130. if (fmt[i].code == code)
  131. return fmt + i;
  132. return NULL;
  133. }
  134. static const struct mt9m111_datafmt mt9m111_colour_fmts[] = {
  135. {V4L2_MBUS_FMT_YUYV8_2X8, V4L2_COLORSPACE_JPEG},
  136. {V4L2_MBUS_FMT_YVYU8_2X8, V4L2_COLORSPACE_JPEG},
  137. {V4L2_MBUS_FMT_UYVY8_2X8, V4L2_COLORSPACE_JPEG},
  138. {V4L2_MBUS_FMT_VYUY8_2X8, V4L2_COLORSPACE_JPEG},
  139. {V4L2_MBUS_FMT_RGB555_2X8_PADHI_LE, V4L2_COLORSPACE_SRGB},
  140. {V4L2_MBUS_FMT_RGB565_2X8_LE, V4L2_COLORSPACE_SRGB},
  141. {V4L2_MBUS_FMT_SBGGR8_1X8, V4L2_COLORSPACE_SRGB},
  142. {V4L2_MBUS_FMT_SBGGR10_2X8_PADHI_LE, V4L2_COLORSPACE_SRGB},
  143. };
  144. enum mt9m111_context {
  145. HIGHPOWER = 0,
  146. LOWPOWER,
  147. };
  148. struct mt9m111 {
  149. struct v4l2_subdev subdev;
  150. int model; /* V4L2_IDENT_MT9M111 or V4L2_IDENT_MT9M112 code
  151. * from v4l2-chip-ident.h */
  152. enum mt9m111_context context;
  153. struct v4l2_rect rect;
  154. const struct mt9m111_datafmt *fmt;
  155. unsigned int gain;
  156. unsigned char autoexposure;
  157. unsigned char datawidth;
  158. unsigned int powered:1;
  159. unsigned int hflip:1;
  160. unsigned int vflip:1;
  161. unsigned int swap_rgb_even_odd:1;
  162. unsigned int swap_rgb_red_blue:1;
  163. unsigned int swap_yuv_y_chromas:1;
  164. unsigned int swap_yuv_cb_cr:1;
  165. unsigned int autowhitebalance:1;
  166. };
  167. static struct mt9m111 *to_mt9m111(const struct i2c_client *client)
  168. {
  169. return container_of(i2c_get_clientdata(client), struct mt9m111, subdev);
  170. }
  171. static int reg_page_map_set(struct i2c_client *client, const u16 reg)
  172. {
  173. int ret;
  174. u16 page;
  175. static int lastpage = -1; /* PageMap cache value */
  176. page = (reg >> 8);
  177. if (page == lastpage)
  178. return 0;
  179. if (page > 2)
  180. return -EINVAL;
  181. ret = i2c_smbus_write_word_data(client, MT9M111_PAGE_MAP, swab16(page));
  182. if (!ret)
  183. lastpage = page;
  184. return ret;
  185. }
  186. static int mt9m111_reg_read(struct i2c_client *client, const u16 reg)
  187. {
  188. int ret;
  189. ret = reg_page_map_set(client, reg);
  190. if (!ret)
  191. ret = swab16(i2c_smbus_read_word_data(client, reg & 0xff));
  192. dev_dbg(&client->dev, "read reg.%03x -> %04x\n", reg, ret);
  193. return ret;
  194. }
  195. static int mt9m111_reg_write(struct i2c_client *client, const u16 reg,
  196. const u16 data)
  197. {
  198. int ret;
  199. ret = reg_page_map_set(client, reg);
  200. if (!ret)
  201. ret = i2c_smbus_write_word_data(client, reg & 0xff,
  202. swab16(data));
  203. dev_dbg(&client->dev, "write reg.%03x = %04x -> %d\n", reg, data, ret);
  204. return ret;
  205. }
  206. static int mt9m111_reg_set(struct i2c_client *client, const u16 reg,
  207. const u16 data)
  208. {
  209. int ret;
  210. ret = mt9m111_reg_read(client, reg);
  211. if (ret >= 0)
  212. ret = mt9m111_reg_write(client, reg, ret | data);
  213. return ret;
  214. }
  215. static int mt9m111_reg_clear(struct i2c_client *client, const u16 reg,
  216. const u16 data)
  217. {
  218. int ret;
  219. ret = mt9m111_reg_read(client, reg);
  220. return mt9m111_reg_write(client, reg, ret & ~data);
  221. }
  222. static int mt9m111_set_context(struct i2c_client *client,
  223. enum mt9m111_context ctxt)
  224. {
  225. int valB = MT9M111_CTXT_CTRL_RESTART | MT9M111_CTXT_CTRL_DEFECTCOR_B
  226. | MT9M111_CTXT_CTRL_RESIZE_B | MT9M111_CTXT_CTRL_CTRL2_B
  227. | MT9M111_CTXT_CTRL_GAMMA_B | MT9M111_CTXT_CTRL_READ_MODE_B
  228. | MT9M111_CTXT_CTRL_VBLANK_SEL_B
  229. | MT9M111_CTXT_CTRL_HBLANK_SEL_B;
  230. int valA = MT9M111_CTXT_CTRL_RESTART;
  231. if (ctxt == HIGHPOWER)
  232. return reg_write(CONTEXT_CONTROL, valB);
  233. else
  234. return reg_write(CONTEXT_CONTROL, valA);
  235. }
  236. static int mt9m111_setup_rect(struct i2c_client *client,
  237. struct v4l2_rect *rect)
  238. {
  239. struct mt9m111 *mt9m111 = to_mt9m111(client);
  240. int ret, is_raw_format;
  241. int width = rect->width;
  242. int height = rect->height;
  243. if (mt9m111->fmt->code == V4L2_MBUS_FMT_SBGGR8_1X8 ||
  244. mt9m111->fmt->code == V4L2_MBUS_FMT_SBGGR10_2X8_PADHI_LE)
  245. is_raw_format = 1;
  246. else
  247. is_raw_format = 0;
  248. ret = reg_write(COLUMN_START, rect->left);
  249. if (!ret)
  250. ret = reg_write(ROW_START, rect->top);
  251. if (is_raw_format) {
  252. if (!ret)
  253. ret = reg_write(WINDOW_WIDTH, width);
  254. if (!ret)
  255. ret = reg_write(WINDOW_HEIGHT, height);
  256. } else {
  257. if (!ret)
  258. ret = reg_write(REDUCER_XZOOM_B, MT9M111_MAX_WIDTH);
  259. if (!ret)
  260. ret = reg_write(REDUCER_YZOOM_B, MT9M111_MAX_HEIGHT);
  261. if (!ret)
  262. ret = reg_write(REDUCER_XSIZE_B, width);
  263. if (!ret)
  264. ret = reg_write(REDUCER_YSIZE_B, height);
  265. if (!ret)
  266. ret = reg_write(REDUCER_XZOOM_A, MT9M111_MAX_WIDTH);
  267. if (!ret)
  268. ret = reg_write(REDUCER_YZOOM_A, MT9M111_MAX_HEIGHT);
  269. if (!ret)
  270. ret = reg_write(REDUCER_XSIZE_A, width);
  271. if (!ret)
  272. ret = reg_write(REDUCER_YSIZE_A, height);
  273. }
  274. return ret;
  275. }
  276. static int mt9m111_setup_pixfmt(struct i2c_client *client, u16 outfmt)
  277. {
  278. int ret;
  279. ret = reg_write(OUTPUT_FORMAT_CTRL2_A, outfmt);
  280. if (!ret)
  281. ret = reg_write(OUTPUT_FORMAT_CTRL2_B, outfmt);
  282. return ret;
  283. }
  284. static int mt9m111_setfmt_bayer8(struct i2c_client *client)
  285. {
  286. return mt9m111_setup_pixfmt(client, MT9M111_OUTFMT_PROCESSED_BAYER |
  287. MT9M111_OUTFMT_RGB);
  288. }
  289. static int mt9m111_setfmt_bayer10(struct i2c_client *client)
  290. {
  291. return mt9m111_setup_pixfmt(client, MT9M111_OUTFMT_BYPASS_IFP);
  292. }
  293. static int mt9m111_setfmt_rgb565(struct i2c_client *client)
  294. {
  295. struct mt9m111 *mt9m111 = to_mt9m111(client);
  296. int val = 0;
  297. if (mt9m111->swap_rgb_red_blue)
  298. val |= MT9M111_OUTFMT_SWAP_YCbCr_Cb_Cr;
  299. if (mt9m111->swap_rgb_even_odd)
  300. val |= MT9M111_OUTFMT_SWAP_RGB_EVEN;
  301. val |= MT9M111_OUTFMT_RGB | MT9M111_OUTFMT_RGB565;
  302. return mt9m111_setup_pixfmt(client, val);
  303. }
  304. static int mt9m111_setfmt_rgb555(struct i2c_client *client)
  305. {
  306. struct mt9m111 *mt9m111 = to_mt9m111(client);
  307. int val = 0;
  308. if (mt9m111->swap_rgb_red_blue)
  309. val |= MT9M111_OUTFMT_SWAP_YCbCr_Cb_Cr;
  310. if (mt9m111->swap_rgb_even_odd)
  311. val |= MT9M111_OUTFMT_SWAP_RGB_EVEN;
  312. val |= MT9M111_OUTFMT_RGB | MT9M111_OUTFMT_RGB555;
  313. return mt9m111_setup_pixfmt(client, val);
  314. }
  315. static int mt9m111_setfmt_yuv(struct i2c_client *client)
  316. {
  317. struct mt9m111 *mt9m111 = to_mt9m111(client);
  318. int val = 0;
  319. if (mt9m111->swap_yuv_cb_cr)
  320. val |= MT9M111_OUTFMT_SWAP_YCbCr_Cb_Cr;
  321. if (mt9m111->swap_yuv_y_chromas)
  322. val |= MT9M111_OUTFMT_SWAP_YCbCr_C_Y;
  323. return mt9m111_setup_pixfmt(client, val);
  324. }
  325. static int mt9m111_enable(struct i2c_client *client)
  326. {
  327. struct mt9m111 *mt9m111 = to_mt9m111(client);
  328. int ret;
  329. ret = reg_set(RESET, MT9M111_RESET_CHIP_ENABLE);
  330. if (!ret)
  331. mt9m111->powered = 1;
  332. return ret;
  333. }
  334. static int mt9m111_reset(struct i2c_client *client)
  335. {
  336. int ret;
  337. ret = reg_set(RESET, MT9M111_RESET_RESET_MODE);
  338. if (!ret)
  339. ret = reg_set(RESET, MT9M111_RESET_RESET_SOC);
  340. if (!ret)
  341. ret = reg_clear(RESET, MT9M111_RESET_RESET_MODE
  342. | MT9M111_RESET_RESET_SOC);
  343. return ret;
  344. }
  345. static unsigned long mt9m111_query_bus_param(struct soc_camera_device *icd)
  346. {
  347. struct soc_camera_link *icl = to_soc_camera_link(icd);
  348. unsigned long flags = SOCAM_MASTER | SOCAM_PCLK_SAMPLE_RISING |
  349. SOCAM_HSYNC_ACTIVE_HIGH | SOCAM_VSYNC_ACTIVE_HIGH |
  350. SOCAM_DATA_ACTIVE_HIGH | SOCAM_DATAWIDTH_8;
  351. return soc_camera_apply_sensor_flags(icl, flags);
  352. }
  353. static int mt9m111_set_bus_param(struct soc_camera_device *icd, unsigned long f)
  354. {
  355. return 0;
  356. }
  357. static int mt9m111_make_rect(struct i2c_client *client,
  358. struct v4l2_rect *rect)
  359. {
  360. struct mt9m111 *mt9m111 = to_mt9m111(client);
  361. if (mt9m111->fmt->code == V4L2_MBUS_FMT_SBGGR8_1X8 ||
  362. mt9m111->fmt->code == V4L2_MBUS_FMT_SBGGR10_2X8_PADHI_LE) {
  363. /* Bayer format - even size lengths */
  364. rect->width = ALIGN(rect->width, 2);
  365. rect->height = ALIGN(rect->height, 2);
  366. /* Let the user play with the starting pixel */
  367. }
  368. /* FIXME: the datasheet doesn't specify minimum sizes */
  369. soc_camera_limit_side(&rect->left, &rect->width,
  370. MT9M111_MIN_DARK_COLS, 2, MT9M111_MAX_WIDTH);
  371. soc_camera_limit_side(&rect->top, &rect->height,
  372. MT9M111_MIN_DARK_ROWS, 2, MT9M111_MAX_HEIGHT);
  373. return mt9m111_setup_rect(client, rect);
  374. }
  375. static int mt9m111_s_crop(struct v4l2_subdev *sd, struct v4l2_crop *a)
  376. {
  377. struct v4l2_rect rect = a->c;
  378. struct i2c_client *client = sd->priv;
  379. struct mt9m111 *mt9m111 = to_mt9m111(client);
  380. int ret;
  381. dev_dbg(&client->dev, "%s left=%d, top=%d, width=%d, height=%d\n",
  382. __func__, rect.left, rect.top, rect.width, rect.height);
  383. ret = mt9m111_make_rect(client, &rect);
  384. if (!ret)
  385. mt9m111->rect = rect;
  386. return ret;
  387. }
  388. static int mt9m111_g_crop(struct v4l2_subdev *sd, struct v4l2_crop *a)
  389. {
  390. struct i2c_client *client = sd->priv;
  391. struct mt9m111 *mt9m111 = to_mt9m111(client);
  392. a->c = mt9m111->rect;
  393. a->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
  394. return 0;
  395. }
  396. static int mt9m111_cropcap(struct v4l2_subdev *sd, struct v4l2_cropcap *a)
  397. {
  398. a->bounds.left = MT9M111_MIN_DARK_COLS;
  399. a->bounds.top = MT9M111_MIN_DARK_ROWS;
  400. a->bounds.width = MT9M111_MAX_WIDTH;
  401. a->bounds.height = MT9M111_MAX_HEIGHT;
  402. a->defrect = a->bounds;
  403. a->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
  404. a->pixelaspect.numerator = 1;
  405. a->pixelaspect.denominator = 1;
  406. return 0;
  407. }
  408. static int mt9m111_g_fmt(struct v4l2_subdev *sd,
  409. struct v4l2_mbus_framefmt *mf)
  410. {
  411. struct i2c_client *client = sd->priv;
  412. struct mt9m111 *mt9m111 = to_mt9m111(client);
  413. mf->width = mt9m111->rect.width;
  414. mf->height = mt9m111->rect.height;
  415. mf->code = mt9m111->fmt->code;
  416. mf->field = V4L2_FIELD_NONE;
  417. return 0;
  418. }
  419. static int mt9m111_set_pixfmt(struct i2c_client *client,
  420. enum v4l2_mbus_pixelcode code)
  421. {
  422. struct mt9m111 *mt9m111 = to_mt9m111(client);
  423. int ret;
  424. switch (code) {
  425. case V4L2_MBUS_FMT_SBGGR8_1X8:
  426. ret = mt9m111_setfmt_bayer8(client);
  427. break;
  428. case V4L2_MBUS_FMT_SBGGR10_2X8_PADHI_LE:
  429. ret = mt9m111_setfmt_bayer10(client);
  430. break;
  431. case V4L2_MBUS_FMT_RGB555_2X8_PADHI_LE:
  432. ret = mt9m111_setfmt_rgb555(client);
  433. break;
  434. case V4L2_MBUS_FMT_RGB565_2X8_LE:
  435. ret = mt9m111_setfmt_rgb565(client);
  436. break;
  437. case V4L2_MBUS_FMT_UYVY8_2X8:
  438. mt9m111->swap_yuv_y_chromas = 0;
  439. mt9m111->swap_yuv_cb_cr = 0;
  440. ret = mt9m111_setfmt_yuv(client);
  441. break;
  442. case V4L2_MBUS_FMT_VYUY8_2X8:
  443. mt9m111->swap_yuv_y_chromas = 0;
  444. mt9m111->swap_yuv_cb_cr = 1;
  445. ret = mt9m111_setfmt_yuv(client);
  446. break;
  447. case V4L2_MBUS_FMT_YUYV8_2X8:
  448. mt9m111->swap_yuv_y_chromas = 1;
  449. mt9m111->swap_yuv_cb_cr = 0;
  450. ret = mt9m111_setfmt_yuv(client);
  451. break;
  452. case V4L2_MBUS_FMT_YVYU8_2X8:
  453. mt9m111->swap_yuv_y_chromas = 1;
  454. mt9m111->swap_yuv_cb_cr = 1;
  455. ret = mt9m111_setfmt_yuv(client);
  456. break;
  457. default:
  458. dev_err(&client->dev, "Pixel format not handled : %x\n",
  459. code);
  460. ret = -EINVAL;
  461. }
  462. return ret;
  463. }
  464. static int mt9m111_s_fmt(struct v4l2_subdev *sd,
  465. struct v4l2_mbus_framefmt *mf)
  466. {
  467. struct i2c_client *client = sd->priv;
  468. const struct mt9m111_datafmt *fmt;
  469. struct mt9m111 *mt9m111 = to_mt9m111(client);
  470. struct v4l2_rect rect = {
  471. .left = mt9m111->rect.left,
  472. .top = mt9m111->rect.top,
  473. .width = mf->width,
  474. .height = mf->height,
  475. };
  476. int ret;
  477. fmt = mt9m111_find_datafmt(mf->code, mt9m111_colour_fmts,
  478. ARRAY_SIZE(mt9m111_colour_fmts));
  479. if (!fmt)
  480. return -EINVAL;
  481. dev_dbg(&client->dev,
  482. "%s code=%x left=%d, top=%d, width=%d, height=%d\n", __func__,
  483. mf->code, rect.left, rect.top, rect.width, rect.height);
  484. ret = mt9m111_make_rect(client, &rect);
  485. if (!ret)
  486. ret = mt9m111_set_pixfmt(client, mf->code);
  487. if (!ret) {
  488. mt9m111->rect = rect;
  489. mt9m111->fmt = fmt;
  490. mf->colorspace = fmt->colorspace;
  491. }
  492. return ret;
  493. }
  494. static int mt9m111_try_fmt(struct v4l2_subdev *sd,
  495. struct v4l2_mbus_framefmt *mf)
  496. {
  497. struct i2c_client *client = sd->priv;
  498. struct mt9m111 *mt9m111 = to_mt9m111(client);
  499. const struct mt9m111_datafmt *fmt;
  500. bool bayer = mf->code == V4L2_MBUS_FMT_SBGGR8_1X8 ||
  501. mf->code == V4L2_MBUS_FMT_SBGGR10_2X8_PADHI_LE;
  502. fmt = mt9m111_find_datafmt(mf->code, mt9m111_colour_fmts,
  503. ARRAY_SIZE(mt9m111_colour_fmts));
  504. if (!fmt) {
  505. fmt = mt9m111->fmt;
  506. mf->code = fmt->code;
  507. }
  508. /*
  509. * With Bayer format enforce even side lengths, but let the user play
  510. * with the starting pixel
  511. */
  512. if (mf->height > MT9M111_MAX_HEIGHT)
  513. mf->height = MT9M111_MAX_HEIGHT;
  514. else if (mf->height < 2)
  515. mf->height = 2;
  516. else if (bayer)
  517. mf->height = ALIGN(mf->height, 2);
  518. if (mf->width > MT9M111_MAX_WIDTH)
  519. mf->width = MT9M111_MAX_WIDTH;
  520. else if (mf->width < 2)
  521. mf->width = 2;
  522. else if (bayer)
  523. mf->width = ALIGN(mf->width, 2);
  524. mf->colorspace = fmt->colorspace;
  525. return 0;
  526. }
  527. static int mt9m111_g_chip_ident(struct v4l2_subdev *sd,
  528. struct v4l2_dbg_chip_ident *id)
  529. {
  530. struct i2c_client *client = sd->priv;
  531. struct mt9m111 *mt9m111 = to_mt9m111(client);
  532. if (id->match.type != V4L2_CHIP_MATCH_I2C_ADDR)
  533. return -EINVAL;
  534. if (id->match.addr != client->addr)
  535. return -ENODEV;
  536. id->ident = mt9m111->model;
  537. id->revision = 0;
  538. return 0;
  539. }
  540. #ifdef CONFIG_VIDEO_ADV_DEBUG
  541. static int mt9m111_g_register(struct v4l2_subdev *sd,
  542. struct v4l2_dbg_register *reg)
  543. {
  544. struct i2c_client *client = sd->priv;
  545. int val;
  546. if (reg->match.type != V4L2_CHIP_MATCH_I2C_ADDR || reg->reg > 0x2ff)
  547. return -EINVAL;
  548. if (reg->match.addr != client->addr)
  549. return -ENODEV;
  550. val = mt9m111_reg_read(client, reg->reg);
  551. reg->size = 2;
  552. reg->val = (u64)val;
  553. if (reg->val > 0xffff)
  554. return -EIO;
  555. return 0;
  556. }
  557. static int mt9m111_s_register(struct v4l2_subdev *sd,
  558. struct v4l2_dbg_register *reg)
  559. {
  560. struct i2c_client *client = sd->priv;
  561. if (reg->match.type != V4L2_CHIP_MATCH_I2C_ADDR || reg->reg > 0x2ff)
  562. return -EINVAL;
  563. if (reg->match.addr != client->addr)
  564. return -ENODEV;
  565. if (mt9m111_reg_write(client, reg->reg, reg->val) < 0)
  566. return -EIO;
  567. return 0;
  568. }
  569. #endif
  570. static const struct v4l2_queryctrl mt9m111_controls[] = {
  571. {
  572. .id = V4L2_CID_VFLIP,
  573. .type = V4L2_CTRL_TYPE_BOOLEAN,
  574. .name = "Flip Verticaly",
  575. .minimum = 0,
  576. .maximum = 1,
  577. .step = 1,
  578. .default_value = 0,
  579. }, {
  580. .id = V4L2_CID_HFLIP,
  581. .type = V4L2_CTRL_TYPE_BOOLEAN,
  582. .name = "Flip Horizontaly",
  583. .minimum = 0,
  584. .maximum = 1,
  585. .step = 1,
  586. .default_value = 0,
  587. }, { /* gain = 1/32*val (=>gain=1 if val==32) */
  588. .id = V4L2_CID_GAIN,
  589. .type = V4L2_CTRL_TYPE_INTEGER,
  590. .name = "Gain",
  591. .minimum = 0,
  592. .maximum = 63 * 2 * 2,
  593. .step = 1,
  594. .default_value = 32,
  595. .flags = V4L2_CTRL_FLAG_SLIDER,
  596. }, {
  597. .id = V4L2_CID_EXPOSURE_AUTO,
  598. .type = V4L2_CTRL_TYPE_BOOLEAN,
  599. .name = "Auto Exposure",
  600. .minimum = 0,
  601. .maximum = 1,
  602. .step = 1,
  603. .default_value = 1,
  604. }
  605. };
  606. static int mt9m111_resume(struct soc_camera_device *icd);
  607. static int mt9m111_suspend(struct soc_camera_device *icd, pm_message_t state);
  608. static struct soc_camera_ops mt9m111_ops = {
  609. .suspend = mt9m111_suspend,
  610. .resume = mt9m111_resume,
  611. .query_bus_param = mt9m111_query_bus_param,
  612. .set_bus_param = mt9m111_set_bus_param,
  613. .controls = mt9m111_controls,
  614. .num_controls = ARRAY_SIZE(mt9m111_controls),
  615. };
  616. static int mt9m111_set_flip(struct i2c_client *client, int flip, int mask)
  617. {
  618. struct mt9m111 *mt9m111 = to_mt9m111(client);
  619. int ret;
  620. if (mt9m111->context == HIGHPOWER) {
  621. if (flip)
  622. ret = reg_set(READ_MODE_B, mask);
  623. else
  624. ret = reg_clear(READ_MODE_B, mask);
  625. } else {
  626. if (flip)
  627. ret = reg_set(READ_MODE_A, mask);
  628. else
  629. ret = reg_clear(READ_MODE_A, mask);
  630. }
  631. return ret;
  632. }
  633. static int mt9m111_get_global_gain(struct i2c_client *client)
  634. {
  635. int data;
  636. data = reg_read(GLOBAL_GAIN);
  637. if (data >= 0)
  638. return (data & 0x2f) * (1 << ((data >> 10) & 1)) *
  639. (1 << ((data >> 9) & 1));
  640. return data;
  641. }
  642. static int mt9m111_set_global_gain(struct i2c_client *client, int gain)
  643. {
  644. struct mt9m111 *mt9m111 = to_mt9m111(client);
  645. u16 val;
  646. if (gain > 63 * 2 * 2)
  647. return -EINVAL;
  648. mt9m111->gain = gain;
  649. if ((gain >= 64 * 2) && (gain < 63 * 2 * 2))
  650. val = (1 << 10) | (1 << 9) | (gain / 4);
  651. else if ((gain >= 64) && (gain < 64 * 2))
  652. val = (1 << 9) | (gain / 2);
  653. else
  654. val = gain;
  655. return reg_write(GLOBAL_GAIN, val);
  656. }
  657. static int mt9m111_set_autoexposure(struct i2c_client *client, int on)
  658. {
  659. struct mt9m111 *mt9m111 = to_mt9m111(client);
  660. int ret;
  661. if (on)
  662. ret = reg_set(OPER_MODE_CTRL, MT9M111_OPMODE_AUTOEXPO_EN);
  663. else
  664. ret = reg_clear(OPER_MODE_CTRL, MT9M111_OPMODE_AUTOEXPO_EN);
  665. if (!ret)
  666. mt9m111->autoexposure = on;
  667. return ret;
  668. }
  669. static int mt9m111_set_autowhitebalance(struct i2c_client *client, int on)
  670. {
  671. struct mt9m111 *mt9m111 = to_mt9m111(client);
  672. int ret;
  673. if (on)
  674. ret = reg_set(OPER_MODE_CTRL, MT9M111_OPMODE_AUTOWHITEBAL_EN);
  675. else
  676. ret = reg_clear(OPER_MODE_CTRL, MT9M111_OPMODE_AUTOWHITEBAL_EN);
  677. if (!ret)
  678. mt9m111->autowhitebalance = on;
  679. return ret;
  680. }
  681. static int mt9m111_g_ctrl(struct v4l2_subdev *sd, struct v4l2_control *ctrl)
  682. {
  683. struct i2c_client *client = sd->priv;
  684. struct mt9m111 *mt9m111 = to_mt9m111(client);
  685. int data;
  686. switch (ctrl->id) {
  687. case V4L2_CID_VFLIP:
  688. if (mt9m111->context == HIGHPOWER)
  689. data = reg_read(READ_MODE_B);
  690. else
  691. data = reg_read(READ_MODE_A);
  692. if (data < 0)
  693. return -EIO;
  694. ctrl->value = !!(data & MT9M111_RMB_MIRROR_ROWS);
  695. break;
  696. case V4L2_CID_HFLIP:
  697. if (mt9m111->context == HIGHPOWER)
  698. data = reg_read(READ_MODE_B);
  699. else
  700. data = reg_read(READ_MODE_A);
  701. if (data < 0)
  702. return -EIO;
  703. ctrl->value = !!(data & MT9M111_RMB_MIRROR_COLS);
  704. break;
  705. case V4L2_CID_GAIN:
  706. data = mt9m111_get_global_gain(client);
  707. if (data < 0)
  708. return data;
  709. ctrl->value = data;
  710. break;
  711. case V4L2_CID_EXPOSURE_AUTO:
  712. ctrl->value = mt9m111->autoexposure;
  713. break;
  714. case V4L2_CID_AUTO_WHITE_BALANCE:
  715. ctrl->value = mt9m111->autowhitebalance;
  716. break;
  717. }
  718. return 0;
  719. }
  720. static int mt9m111_s_ctrl(struct v4l2_subdev *sd, struct v4l2_control *ctrl)
  721. {
  722. struct i2c_client *client = sd->priv;
  723. struct mt9m111 *mt9m111 = to_mt9m111(client);
  724. const struct v4l2_queryctrl *qctrl;
  725. int ret;
  726. qctrl = soc_camera_find_qctrl(&mt9m111_ops, ctrl->id);
  727. if (!qctrl)
  728. return -EINVAL;
  729. switch (ctrl->id) {
  730. case V4L2_CID_VFLIP:
  731. mt9m111->vflip = ctrl->value;
  732. ret = mt9m111_set_flip(client, ctrl->value,
  733. MT9M111_RMB_MIRROR_ROWS);
  734. break;
  735. case V4L2_CID_HFLIP:
  736. mt9m111->hflip = ctrl->value;
  737. ret = mt9m111_set_flip(client, ctrl->value,
  738. MT9M111_RMB_MIRROR_COLS);
  739. break;
  740. case V4L2_CID_GAIN:
  741. ret = mt9m111_set_global_gain(client, ctrl->value);
  742. break;
  743. case V4L2_CID_EXPOSURE_AUTO:
  744. ret = mt9m111_set_autoexposure(client, ctrl->value);
  745. break;
  746. case V4L2_CID_AUTO_WHITE_BALANCE:
  747. ret = mt9m111_set_autowhitebalance(client, ctrl->value);
  748. break;
  749. default:
  750. ret = -EINVAL;
  751. }
  752. return ret;
  753. }
  754. static int mt9m111_suspend(struct soc_camera_device *icd, pm_message_t state)
  755. {
  756. struct i2c_client *client = to_i2c_client(to_soc_camera_control(icd));
  757. struct mt9m111 *mt9m111 = to_mt9m111(client);
  758. mt9m111->gain = mt9m111_get_global_gain(client);
  759. return 0;
  760. }
  761. static int mt9m111_restore_state(struct i2c_client *client)
  762. {
  763. struct mt9m111 *mt9m111 = to_mt9m111(client);
  764. mt9m111_set_context(client, mt9m111->context);
  765. mt9m111_set_pixfmt(client, mt9m111->fmt->code);
  766. mt9m111_setup_rect(client, &mt9m111->rect);
  767. mt9m111_set_flip(client, mt9m111->hflip, MT9M111_RMB_MIRROR_COLS);
  768. mt9m111_set_flip(client, mt9m111->vflip, MT9M111_RMB_MIRROR_ROWS);
  769. mt9m111_set_global_gain(client, mt9m111->gain);
  770. mt9m111_set_autoexposure(client, mt9m111->autoexposure);
  771. mt9m111_set_autowhitebalance(client, mt9m111->autowhitebalance);
  772. return 0;
  773. }
  774. static int mt9m111_resume(struct soc_camera_device *icd)
  775. {
  776. struct i2c_client *client = to_i2c_client(to_soc_camera_control(icd));
  777. struct mt9m111 *mt9m111 = to_mt9m111(client);
  778. int ret = 0;
  779. if (mt9m111->powered) {
  780. ret = mt9m111_enable(client);
  781. if (!ret)
  782. ret = mt9m111_reset(client);
  783. if (!ret)
  784. ret = mt9m111_restore_state(client);
  785. }
  786. return ret;
  787. }
  788. static int mt9m111_init(struct i2c_client *client)
  789. {
  790. struct mt9m111 *mt9m111 = to_mt9m111(client);
  791. int ret;
  792. mt9m111->context = HIGHPOWER;
  793. ret = mt9m111_enable(client);
  794. if (!ret)
  795. ret = mt9m111_reset(client);
  796. if (!ret)
  797. ret = mt9m111_set_context(client, mt9m111->context);
  798. if (!ret)
  799. ret = mt9m111_set_autoexposure(client, mt9m111->autoexposure);
  800. if (ret)
  801. dev_err(&client->dev, "mt9m111 init failed: %d\n", ret);
  802. return ret;
  803. }
  804. /*
  805. * Interface active, can use i2c. If it fails, it can indeed mean, that
  806. * this wasn't our capture interface, so, we wait for the right one
  807. */
  808. static int mt9m111_video_probe(struct soc_camera_device *icd,
  809. struct i2c_client *client)
  810. {
  811. struct mt9m111 *mt9m111 = to_mt9m111(client);
  812. s32 data;
  813. int ret;
  814. /*
  815. * We must have a parent by now. And it cannot be a wrong one.
  816. * So this entire test is completely redundant.
  817. */
  818. if (!icd->dev.parent ||
  819. to_soc_camera_host(icd->dev.parent)->nr != icd->iface)
  820. return -ENODEV;
  821. mt9m111->autoexposure = 1;
  822. mt9m111->autowhitebalance = 1;
  823. mt9m111->swap_rgb_even_odd = 1;
  824. mt9m111->swap_rgb_red_blue = 1;
  825. data = reg_read(CHIP_VERSION);
  826. switch (data) {
  827. case 0x143a: /* MT9M111 or MT9M131 */
  828. mt9m111->model = V4L2_IDENT_MT9M111;
  829. dev_info(&client->dev,
  830. "Detected a MT9M111/MT9M131 chip ID %x\n", data);
  831. break;
  832. case 0x148c: /* MT9M112 */
  833. mt9m111->model = V4L2_IDENT_MT9M112;
  834. dev_info(&client->dev, "Detected a MT9M112 chip ID %x\n", data);
  835. break;
  836. default:
  837. ret = -ENODEV;
  838. dev_err(&client->dev,
  839. "No MT9M111/MT9M112/MT9M131 chip detected register read %x\n",
  840. data);
  841. goto ei2c;
  842. }
  843. ret = mt9m111_init(client);
  844. ei2c:
  845. return ret;
  846. }
  847. static struct v4l2_subdev_core_ops mt9m111_subdev_core_ops = {
  848. .g_ctrl = mt9m111_g_ctrl,
  849. .s_ctrl = mt9m111_s_ctrl,
  850. .g_chip_ident = mt9m111_g_chip_ident,
  851. #ifdef CONFIG_VIDEO_ADV_DEBUG
  852. .g_register = mt9m111_g_register,
  853. .s_register = mt9m111_s_register,
  854. #endif
  855. };
  856. static int mt9m111_enum_fmt(struct v4l2_subdev *sd, unsigned int index,
  857. enum v4l2_mbus_pixelcode *code)
  858. {
  859. if (index >= ARRAY_SIZE(mt9m111_colour_fmts))
  860. return -EINVAL;
  861. *code = mt9m111_colour_fmts[index].code;
  862. return 0;
  863. }
  864. static struct v4l2_subdev_video_ops mt9m111_subdev_video_ops = {
  865. .s_mbus_fmt = mt9m111_s_fmt,
  866. .g_mbus_fmt = mt9m111_g_fmt,
  867. .try_mbus_fmt = mt9m111_try_fmt,
  868. .s_crop = mt9m111_s_crop,
  869. .g_crop = mt9m111_g_crop,
  870. .cropcap = mt9m111_cropcap,
  871. .enum_mbus_fmt = mt9m111_enum_fmt,
  872. };
  873. static struct v4l2_subdev_ops mt9m111_subdev_ops = {
  874. .core = &mt9m111_subdev_core_ops,
  875. .video = &mt9m111_subdev_video_ops,
  876. };
  877. static int mt9m111_probe(struct i2c_client *client,
  878. const struct i2c_device_id *did)
  879. {
  880. struct mt9m111 *mt9m111;
  881. struct soc_camera_device *icd = client->dev.platform_data;
  882. struct i2c_adapter *adapter = to_i2c_adapter(client->dev.parent);
  883. struct soc_camera_link *icl;
  884. int ret;
  885. if (!icd) {
  886. dev_err(&client->dev, "mt9m111: soc-camera data missing!\n");
  887. return -EINVAL;
  888. }
  889. icl = to_soc_camera_link(icd);
  890. if (!icl) {
  891. dev_err(&client->dev, "mt9m111: driver needs platform data\n");
  892. return -EINVAL;
  893. }
  894. if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_WORD_DATA)) {
  895. dev_warn(&adapter->dev,
  896. "I2C-Adapter doesn't support I2C_FUNC_SMBUS_WORD\n");
  897. return -EIO;
  898. }
  899. mt9m111 = kzalloc(sizeof(struct mt9m111), GFP_KERNEL);
  900. if (!mt9m111)
  901. return -ENOMEM;
  902. v4l2_i2c_subdev_init(&mt9m111->subdev, client, &mt9m111_subdev_ops);
  903. /* Second stage probe - when a capture adapter is there */
  904. icd->ops = &mt9m111_ops;
  905. mt9m111->rect.left = MT9M111_MIN_DARK_COLS;
  906. mt9m111->rect.top = MT9M111_MIN_DARK_ROWS;
  907. mt9m111->rect.width = MT9M111_MAX_WIDTH;
  908. mt9m111->rect.height = MT9M111_MAX_HEIGHT;
  909. mt9m111->fmt = &mt9m111_colour_fmts[0];
  910. ret = mt9m111_video_probe(icd, client);
  911. if (ret) {
  912. icd->ops = NULL;
  913. kfree(mt9m111);
  914. }
  915. return ret;
  916. }
  917. static int mt9m111_remove(struct i2c_client *client)
  918. {
  919. struct mt9m111 *mt9m111 = to_mt9m111(client);
  920. struct soc_camera_device *icd = client->dev.platform_data;
  921. icd->ops = NULL;
  922. client->driver = NULL;
  923. kfree(mt9m111);
  924. return 0;
  925. }
  926. static const struct i2c_device_id mt9m111_id[] = {
  927. { "mt9m111", 0 },
  928. { }
  929. };
  930. MODULE_DEVICE_TABLE(i2c, mt9m111_id);
  931. static struct i2c_driver mt9m111_i2c_driver = {
  932. .driver = {
  933. .name = "mt9m111",
  934. },
  935. .probe = mt9m111_probe,
  936. .remove = mt9m111_remove,
  937. .id_table = mt9m111_id,
  938. };
  939. static int __init mt9m111_mod_init(void)
  940. {
  941. return i2c_add_driver(&mt9m111_i2c_driver);
  942. }
  943. static void __exit mt9m111_mod_exit(void)
  944. {
  945. i2c_del_driver(&mt9m111_i2c_driver);
  946. }
  947. module_init(mt9m111_mod_init);
  948. module_exit(mt9m111_mod_exit);
  949. MODULE_DESCRIPTION("Micron/Aptina MT9M111/MT9M112/MT9M131 Camera driver");
  950. MODULE_AUTHOR("Robert Jarzmik");
  951. MODULE_LICENSE("GPL");