m5mols_core.c 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041
  1. /*
  2. * Driver for M-5MOLS 8M Pixel camera sensor with ISP
  3. *
  4. * Copyright (C) 2011 Samsung Electronics Co., Ltd.
  5. * Author: HeungJun Kim <riverful.kim@samsung.com>
  6. *
  7. * Copyright (C) 2009 Samsung Electronics Co., Ltd.
  8. * Author: Dongsoo Nathaniel Kim <dongsoo45.kim@samsung.com>
  9. *
  10. * This program is free software; you can redistribute it and/or modify
  11. * it under the terms of the GNU General Public License as published by
  12. * the Free Software Foundation; either version 2 of the License, or
  13. * (at your option) any later version.
  14. */
  15. #include <linux/i2c.h>
  16. #include <linux/slab.h>
  17. #include <linux/irq.h>
  18. #include <linux/interrupt.h>
  19. #include <linux/delay.h>
  20. #include <linux/gpio.h>
  21. #include <linux/regulator/consumer.h>
  22. #include <linux/videodev2.h>
  23. #include <media/v4l2-ctrls.h>
  24. #include <media/v4l2-device.h>
  25. #include <media/v4l2-subdev.h>
  26. #include <media/m5mols.h>
  27. #include "m5mols.h"
  28. #include "m5mols_reg.h"
  29. int m5mols_debug;
  30. module_param(m5mols_debug, int, 0644);
  31. #define MODULE_NAME "M5MOLS"
  32. #define M5MOLS_I2C_CHECK_RETRY 500
  33. /* The regulator consumer names for external voltage regulators */
  34. static struct regulator_bulk_data supplies[] = {
  35. {
  36. .supply = "core", /* ARM core power, 1.2V */
  37. }, {
  38. .supply = "dig_18", /* digital power 1, 1.8V */
  39. }, {
  40. .supply = "d_sensor", /* sensor power 1, 1.8V */
  41. }, {
  42. .supply = "dig_28", /* digital power 2, 2.8V */
  43. }, {
  44. .supply = "a_sensor", /* analog power */
  45. }, {
  46. .supply = "dig_12", /* digital power 3, 1.2V */
  47. },
  48. };
  49. static struct v4l2_mbus_framefmt m5mols_default_ffmt[M5MOLS_RESTYPE_MAX] = {
  50. [M5MOLS_RESTYPE_MONITOR] = {
  51. .width = 1920,
  52. .height = 1080,
  53. .code = V4L2_MBUS_FMT_VYUY8_2X8,
  54. .field = V4L2_FIELD_NONE,
  55. .colorspace = V4L2_COLORSPACE_JPEG,
  56. },
  57. [M5MOLS_RESTYPE_CAPTURE] = {
  58. .width = 1920,
  59. .height = 1080,
  60. .code = V4L2_MBUS_FMT_JPEG_1X8,
  61. .field = V4L2_FIELD_NONE,
  62. .colorspace = V4L2_COLORSPACE_JPEG,
  63. },
  64. };
  65. #define SIZE_DEFAULT_FFMT ARRAY_SIZE(m5mols_default_ffmt)
  66. static const struct m5mols_resolution m5mols_reg_res[] = {
  67. { 0x01, M5MOLS_RESTYPE_MONITOR, 128, 96 }, /* SUB-QCIF */
  68. { 0x03, M5MOLS_RESTYPE_MONITOR, 160, 120 }, /* QQVGA */
  69. { 0x05, M5MOLS_RESTYPE_MONITOR, 176, 144 }, /* QCIF */
  70. { 0x06, M5MOLS_RESTYPE_MONITOR, 176, 176 },
  71. { 0x08, M5MOLS_RESTYPE_MONITOR, 240, 320 }, /* QVGA */
  72. { 0x09, M5MOLS_RESTYPE_MONITOR, 320, 240 }, /* QVGA */
  73. { 0x0c, M5MOLS_RESTYPE_MONITOR, 240, 400 }, /* WQVGA */
  74. { 0x0d, M5MOLS_RESTYPE_MONITOR, 400, 240 }, /* WQVGA */
  75. { 0x0e, M5MOLS_RESTYPE_MONITOR, 352, 288 }, /* CIF */
  76. { 0x13, M5MOLS_RESTYPE_MONITOR, 480, 360 },
  77. { 0x15, M5MOLS_RESTYPE_MONITOR, 640, 360 }, /* qHD */
  78. { 0x17, M5MOLS_RESTYPE_MONITOR, 640, 480 }, /* VGA */
  79. { 0x18, M5MOLS_RESTYPE_MONITOR, 720, 480 },
  80. { 0x1a, M5MOLS_RESTYPE_MONITOR, 800, 480 }, /* WVGA */
  81. { 0x1f, M5MOLS_RESTYPE_MONITOR, 800, 600 }, /* SVGA */
  82. { 0x21, M5MOLS_RESTYPE_MONITOR, 1280, 720 }, /* HD */
  83. { 0x25, M5MOLS_RESTYPE_MONITOR, 1920, 1080 }, /* 1080p */
  84. { 0x29, M5MOLS_RESTYPE_MONITOR, 3264, 2448 }, /* 2.63fps 8M */
  85. { 0x39, M5MOLS_RESTYPE_MONITOR, 800, 602 }, /* AHS_MON debug */
  86. { 0x02, M5MOLS_RESTYPE_CAPTURE, 320, 240 }, /* QVGA */
  87. { 0x04, M5MOLS_RESTYPE_CAPTURE, 400, 240 }, /* WQVGA */
  88. { 0x07, M5MOLS_RESTYPE_CAPTURE, 480, 360 },
  89. { 0x08, M5MOLS_RESTYPE_CAPTURE, 640, 360 }, /* qHD */
  90. { 0x09, M5MOLS_RESTYPE_CAPTURE, 640, 480 }, /* VGA */
  91. { 0x0a, M5MOLS_RESTYPE_CAPTURE, 800, 480 }, /* WVGA */
  92. { 0x10, M5MOLS_RESTYPE_CAPTURE, 1280, 720 }, /* HD */
  93. { 0x14, M5MOLS_RESTYPE_CAPTURE, 1280, 960 }, /* 1M */
  94. { 0x17, M5MOLS_RESTYPE_CAPTURE, 1600, 1200 }, /* 2M */
  95. { 0x19, M5MOLS_RESTYPE_CAPTURE, 1920, 1080 }, /* Full-HD */
  96. { 0x1a, M5MOLS_RESTYPE_CAPTURE, 2048, 1152 }, /* 3Mega */
  97. { 0x1b, M5MOLS_RESTYPE_CAPTURE, 2048, 1536 },
  98. { 0x1c, M5MOLS_RESTYPE_CAPTURE, 2560, 1440 }, /* 4Mega */
  99. { 0x1d, M5MOLS_RESTYPE_CAPTURE, 2560, 1536 },
  100. { 0x1f, M5MOLS_RESTYPE_CAPTURE, 2560, 1920 }, /* 5Mega */
  101. { 0x21, M5MOLS_RESTYPE_CAPTURE, 3264, 1836 }, /* 6Mega */
  102. { 0x22, M5MOLS_RESTYPE_CAPTURE, 3264, 1960 },
  103. { 0x25, M5MOLS_RESTYPE_CAPTURE, 3264, 2448 }, /* 8Mega */
  104. };
  105. /**
  106. * m5mols_swap_byte - an byte array to integer conversion function
  107. * @size: size in bytes of I2C packet defined in the M-5MOLS datasheet
  108. *
  109. * Convert I2C data byte array with performing any required byte
  110. * reordering to assure proper values for each data type, regardless
  111. * of the architecture endianness.
  112. */
  113. static u32 m5mols_swap_byte(u8 *data, u8 length)
  114. {
  115. if (length == 1)
  116. return *data;
  117. else if (length == 2)
  118. return be16_to_cpu(*((u16 *)data));
  119. else
  120. return be32_to_cpu(*((u32 *)data));
  121. }
  122. /**
  123. * m5mols_read - I2C read function
  124. * @reg: combination of size, category and command for the I2C packet
  125. * @size: desired size of I2C packet
  126. * @val: read value
  127. */
  128. static int m5mols_read(struct v4l2_subdev *sd, u32 size, u32 reg, u32 *val)
  129. {
  130. struct i2c_client *client = v4l2_get_subdevdata(sd);
  131. u8 rbuf[M5MOLS_I2C_MAX_SIZE + 1];
  132. u8 category = I2C_CATEGORY(reg);
  133. u8 cmd = I2C_COMMAND(reg);
  134. struct i2c_msg msg[2];
  135. u8 wbuf[5];
  136. int ret;
  137. if (!client->adapter)
  138. return -ENODEV;
  139. msg[0].addr = client->addr;
  140. msg[0].flags = 0;
  141. msg[0].len = 5;
  142. msg[0].buf = wbuf;
  143. wbuf[0] = 5;
  144. wbuf[1] = M5MOLS_BYTE_READ;
  145. wbuf[2] = category;
  146. wbuf[3] = cmd;
  147. wbuf[4] = size;
  148. msg[1].addr = client->addr;
  149. msg[1].flags = I2C_M_RD;
  150. msg[1].len = size + 1;
  151. msg[1].buf = rbuf;
  152. /* minimum stabilization time */
  153. usleep_range(200, 200);
  154. ret = i2c_transfer(client->adapter, msg, 2);
  155. if (ret < 0) {
  156. v4l2_err(sd, "read failed: size:%d cat:%02x cmd:%02x. %d\n",
  157. size, category, cmd, ret);
  158. return ret;
  159. }
  160. *val = m5mols_swap_byte(&rbuf[1], size);
  161. return 0;
  162. }
  163. int m5mols_read_u8(struct v4l2_subdev *sd, u32 reg, u8 *val)
  164. {
  165. u32 val_32;
  166. int ret;
  167. if (I2C_SIZE(reg) != 1) {
  168. v4l2_err(sd, "Wrong data size\n");
  169. return -EINVAL;
  170. }
  171. ret = m5mols_read(sd, I2C_SIZE(reg), reg, &val_32);
  172. if (ret)
  173. return ret;
  174. *val = (u8)val_32;
  175. return ret;
  176. }
  177. int m5mols_read_u16(struct v4l2_subdev *sd, u32 reg, u16 *val)
  178. {
  179. u32 val_32;
  180. int ret;
  181. if (I2C_SIZE(reg) != 2) {
  182. v4l2_err(sd, "Wrong data size\n");
  183. return -EINVAL;
  184. }
  185. ret = m5mols_read(sd, I2C_SIZE(reg), reg, &val_32);
  186. if (ret)
  187. return ret;
  188. *val = (u16)val_32;
  189. return ret;
  190. }
  191. int m5mols_read_u32(struct v4l2_subdev *sd, u32 reg, u32 *val)
  192. {
  193. if (I2C_SIZE(reg) != 4) {
  194. v4l2_err(sd, "Wrong data size\n");
  195. return -EINVAL;
  196. }
  197. return m5mols_read(sd, I2C_SIZE(reg), reg, val);
  198. }
  199. /**
  200. * m5mols_write - I2C command write function
  201. * @reg: combination of size, category and command for the I2C packet
  202. * @val: value to write
  203. */
  204. int m5mols_write(struct v4l2_subdev *sd, u32 reg, u32 val)
  205. {
  206. struct i2c_client *client = v4l2_get_subdevdata(sd);
  207. u8 wbuf[M5MOLS_I2C_MAX_SIZE + 4];
  208. u8 category = I2C_CATEGORY(reg);
  209. u8 cmd = I2C_COMMAND(reg);
  210. u8 size = I2C_SIZE(reg);
  211. u32 *buf = (u32 *)&wbuf[4];
  212. struct i2c_msg msg[1];
  213. int ret;
  214. if (!client->adapter)
  215. return -ENODEV;
  216. if (size != 1 && size != 2 && size != 4) {
  217. v4l2_err(sd, "Wrong data size\n");
  218. return -EINVAL;
  219. }
  220. msg->addr = client->addr;
  221. msg->flags = 0;
  222. msg->len = (u16)size + 4;
  223. msg->buf = wbuf;
  224. wbuf[0] = size + 4;
  225. wbuf[1] = M5MOLS_BYTE_WRITE;
  226. wbuf[2] = category;
  227. wbuf[3] = cmd;
  228. *buf = m5mols_swap_byte((u8 *)&val, size);
  229. usleep_range(200, 200);
  230. ret = i2c_transfer(client->adapter, msg, 1);
  231. if (ret < 0) {
  232. v4l2_err(sd, "write failed: size:%d cat:%02x cmd:%02x. %d\n",
  233. size, category, cmd, ret);
  234. return ret;
  235. }
  236. return 0;
  237. }
  238. int m5mols_busy(struct v4l2_subdev *sd, u8 category, u8 cmd, u8 mask)
  239. {
  240. u8 busy;
  241. int i;
  242. int ret;
  243. for (i = 0; i < M5MOLS_I2C_CHECK_RETRY; i++) {
  244. ret = m5mols_read_u8(sd, I2C_REG(category, cmd, 1), &busy);
  245. if (ret < 0)
  246. return ret;
  247. if ((busy & mask) == mask)
  248. return 0;
  249. }
  250. return -EBUSY;
  251. }
  252. /**
  253. * m5mols_enable_interrupt - Clear interrupt pending bits and unmask interrupts
  254. *
  255. * Before writing desired interrupt value the INT_FACTOR register should
  256. * be read to clear pending interrupts.
  257. */
  258. int m5mols_enable_interrupt(struct v4l2_subdev *sd, u8 reg)
  259. {
  260. struct m5mols_info *info = to_m5mols(sd);
  261. u8 mask = is_available_af(info) ? REG_INT_AF : 0;
  262. u8 dummy;
  263. int ret;
  264. ret = m5mols_read_u8(sd, SYSTEM_INT_FACTOR, &dummy);
  265. if (!ret)
  266. ret = m5mols_write(sd, SYSTEM_INT_ENABLE, reg & ~mask);
  267. return ret;
  268. }
  269. /**
  270. * m5mols_reg_mode - Write the mode and check busy status
  271. *
  272. * It always accompanies a little delay changing the M-5MOLS mode, so it is
  273. * needed checking current busy status to guarantee right mode.
  274. */
  275. static int m5mols_reg_mode(struct v4l2_subdev *sd, u8 mode)
  276. {
  277. int ret = m5mols_write(sd, SYSTEM_SYSMODE, mode);
  278. return ret ? ret : m5mols_busy(sd, CAT_SYSTEM, CAT0_SYSMODE, mode);
  279. }
  280. /**
  281. * m5mols_mode - manage the M-5MOLS's mode
  282. * @mode: the required operation mode
  283. *
  284. * The commands of M-5MOLS are grouped into specific modes. Each functionality
  285. * can be guaranteed only when the sensor is operating in mode which which
  286. * a command belongs to.
  287. */
  288. int m5mols_mode(struct m5mols_info *info, u8 mode)
  289. {
  290. struct v4l2_subdev *sd = &info->sd;
  291. int ret = -EINVAL;
  292. u8 reg;
  293. if (mode < REG_PARAMETER && mode > REG_CAPTURE)
  294. return ret;
  295. ret = m5mols_read_u8(sd, SYSTEM_SYSMODE, &reg);
  296. if ((!ret && reg == mode) || ret)
  297. return ret;
  298. switch (reg) {
  299. case REG_PARAMETER:
  300. ret = m5mols_reg_mode(sd, REG_MONITOR);
  301. if (!ret && mode == REG_MONITOR)
  302. break;
  303. if (!ret)
  304. ret = m5mols_reg_mode(sd, REG_CAPTURE);
  305. break;
  306. case REG_MONITOR:
  307. if (mode == REG_PARAMETER) {
  308. ret = m5mols_reg_mode(sd, REG_PARAMETER);
  309. break;
  310. }
  311. ret = m5mols_reg_mode(sd, REG_CAPTURE);
  312. break;
  313. case REG_CAPTURE:
  314. ret = m5mols_reg_mode(sd, REG_MONITOR);
  315. if (!ret && mode == REG_MONITOR)
  316. break;
  317. if (!ret)
  318. ret = m5mols_reg_mode(sd, REG_PARAMETER);
  319. break;
  320. default:
  321. v4l2_warn(sd, "Wrong mode: %d\n", mode);
  322. }
  323. if (!ret)
  324. info->mode = mode;
  325. return ret;
  326. }
  327. /**
  328. * m5mols_get_version - retrieve full revisions information of M-5MOLS
  329. *
  330. * The version information includes revisions of hardware and firmware,
  331. * AutoFocus alghorithm version and the version string.
  332. */
  333. static int m5mols_get_version(struct v4l2_subdev *sd)
  334. {
  335. struct m5mols_info *info = to_m5mols(sd);
  336. struct m5mols_version *ver = &info->ver;
  337. u8 *str = ver->str;
  338. int i;
  339. int ret;
  340. ret = m5mols_read_u8(sd, SYSTEM_VER_CUSTOMER, &ver->customer);
  341. if (!ret)
  342. ret = m5mols_read_u8(sd, SYSTEM_VER_PROJECT, &ver->project);
  343. if (!ret)
  344. ret = m5mols_read_u16(sd, SYSTEM_VER_FIRMWARE, &ver->fw);
  345. if (!ret)
  346. ret = m5mols_read_u16(sd, SYSTEM_VER_HARDWARE, &ver->hw);
  347. if (!ret)
  348. ret = m5mols_read_u16(sd, SYSTEM_VER_PARAMETER, &ver->param);
  349. if (!ret)
  350. ret = m5mols_read_u16(sd, SYSTEM_VER_AWB, &ver->awb);
  351. if (!ret)
  352. ret = m5mols_read_u8(sd, AF_VERSION, &ver->af);
  353. if (ret)
  354. return ret;
  355. for (i = 0; i < VERSION_STRING_SIZE; i++) {
  356. ret = m5mols_read_u8(sd, SYSTEM_VER_STRING, &str[i]);
  357. if (ret)
  358. return ret;
  359. }
  360. ver->fw = be16_to_cpu(ver->fw);
  361. ver->hw = be16_to_cpu(ver->hw);
  362. ver->param = be16_to_cpu(ver->param);
  363. ver->awb = be16_to_cpu(ver->awb);
  364. v4l2_info(sd, "Manufacturer\t[%s]\n",
  365. is_manufacturer(info, REG_SAMSUNG_ELECTRO) ?
  366. "Samsung Electro-Machanics" :
  367. is_manufacturer(info, REG_SAMSUNG_OPTICS) ?
  368. "Samsung Fiber-Optics" :
  369. is_manufacturer(info, REG_SAMSUNG_TECHWIN) ?
  370. "Samsung Techwin" : "None");
  371. v4l2_info(sd, "Customer/Project\t[0x%02x/0x%02x]\n",
  372. info->ver.customer, info->ver.project);
  373. if (!is_available_af(info))
  374. v4l2_info(sd, "No support Auto Focus on this firmware\n");
  375. return ret;
  376. }
  377. /**
  378. * __find_restype - Lookup M-5MOLS resolution type according to pixel code
  379. * @code: pixel code
  380. */
  381. static enum m5mols_restype __find_restype(enum v4l2_mbus_pixelcode code)
  382. {
  383. enum m5mols_restype type = M5MOLS_RESTYPE_MONITOR;
  384. do {
  385. if (code == m5mols_default_ffmt[type].code)
  386. return type;
  387. } while (type++ != SIZE_DEFAULT_FFMT);
  388. return 0;
  389. }
  390. /**
  391. * __find_resolution - Lookup preset and type of M-5MOLS's resolution
  392. * @mf: pixel format to find/negotiate the resolution preset for
  393. * @type: M-5MOLS resolution type
  394. * @resolution: M-5MOLS resolution preset register value
  395. *
  396. * Find nearest resolution matching resolution preset and adjust mf
  397. * to supported values.
  398. */
  399. static int __find_resolution(struct v4l2_subdev *sd,
  400. struct v4l2_mbus_framefmt *mf,
  401. enum m5mols_restype *type,
  402. u32 *resolution)
  403. {
  404. const struct m5mols_resolution *fsize = &m5mols_reg_res[0];
  405. const struct m5mols_resolution *match = NULL;
  406. enum m5mols_restype stype = __find_restype(mf->code);
  407. int i = ARRAY_SIZE(m5mols_reg_res);
  408. unsigned int min_err = ~0;
  409. while (i--) {
  410. int err;
  411. if (stype == fsize->type) {
  412. err = abs(fsize->width - mf->width)
  413. + abs(fsize->height - mf->height);
  414. if (err < min_err) {
  415. min_err = err;
  416. match = fsize;
  417. }
  418. }
  419. fsize++;
  420. }
  421. if (match) {
  422. mf->width = match->width;
  423. mf->height = match->height;
  424. *resolution = match->reg;
  425. *type = stype;
  426. return 0;
  427. }
  428. return -EINVAL;
  429. }
  430. static struct v4l2_mbus_framefmt *__find_format(struct m5mols_info *info,
  431. struct v4l2_subdev_fh *fh,
  432. enum v4l2_subdev_format_whence which,
  433. enum m5mols_restype type)
  434. {
  435. if (which == V4L2_SUBDEV_FORMAT_TRY)
  436. return fh ? v4l2_subdev_get_try_format(fh, 0) : NULL;
  437. return &info->ffmt[type];
  438. }
  439. static int m5mols_get_fmt(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh,
  440. struct v4l2_subdev_format *fmt)
  441. {
  442. struct m5mols_info *info = to_m5mols(sd);
  443. struct v4l2_mbus_framefmt *format;
  444. if (fmt->pad != 0)
  445. return -EINVAL;
  446. format = __find_format(info, fh, fmt->which, info->res_type);
  447. if (!format)
  448. return -EINVAL;
  449. fmt->format = *format;
  450. return 0;
  451. }
  452. static int m5mols_set_fmt(struct v4l2_subdev *sd, struct v4l2_subdev_fh *fh,
  453. struct v4l2_subdev_format *fmt)
  454. {
  455. struct m5mols_info *info = to_m5mols(sd);
  456. struct v4l2_mbus_framefmt *format = &fmt->format;
  457. struct v4l2_mbus_framefmt *sfmt;
  458. enum m5mols_restype type;
  459. u32 resolution = 0;
  460. int ret;
  461. if (fmt->pad != 0)
  462. return -EINVAL;
  463. ret = __find_resolution(sd, format, &type, &resolution);
  464. if (ret < 0)
  465. return ret;
  466. sfmt = __find_format(info, fh, fmt->which, type);
  467. if (!sfmt)
  468. return 0;
  469. *sfmt = m5mols_default_ffmt[type];
  470. sfmt->width = format->width;
  471. sfmt->height = format->height;
  472. if (fmt->which == V4L2_SUBDEV_FORMAT_ACTIVE) {
  473. info->resolution = resolution;
  474. info->code = format->code;
  475. info->res_type = type;
  476. }
  477. return 0;
  478. }
  479. static int m5mols_enum_mbus_code(struct v4l2_subdev *sd,
  480. struct v4l2_subdev_fh *fh,
  481. struct v4l2_subdev_mbus_code_enum *code)
  482. {
  483. if (!code || code->index >= SIZE_DEFAULT_FFMT)
  484. return -EINVAL;
  485. code->code = m5mols_default_ffmt[code->index].code;
  486. return 0;
  487. }
  488. static struct v4l2_subdev_pad_ops m5mols_pad_ops = {
  489. .enum_mbus_code = m5mols_enum_mbus_code,
  490. .get_fmt = m5mols_get_fmt,
  491. .set_fmt = m5mols_set_fmt,
  492. };
  493. /**
  494. * m5mols_sync_controls - Apply default scene mode and the current controls
  495. *
  496. * This is used only streaming for syncing between v4l2_ctrl framework and
  497. * m5mols's controls. First, do the scenemode to the sensor, then call
  498. * v4l2_ctrl_handler_setup. It can be same between some commands and
  499. * the scenemode's in the default v4l2_ctrls. But, such commands of control
  500. * should be prior to the scenemode's one.
  501. */
  502. int m5mols_sync_controls(struct m5mols_info *info)
  503. {
  504. int ret = -EINVAL;
  505. if (!is_ctrl_synced(info)) {
  506. ret = m5mols_do_scenemode(info, REG_SCENE_NORMAL);
  507. if (ret)
  508. return ret;
  509. v4l2_ctrl_handler_setup(&info->handle);
  510. info->ctrl_sync = true;
  511. }
  512. return ret;
  513. }
  514. /**
  515. * m5mols_start_monitor - Start the monitor mode
  516. *
  517. * Before applying the controls setup the resolution and frame rate
  518. * in PARAMETER mode, and then switch over to MONITOR mode.
  519. */
  520. static int m5mols_start_monitor(struct m5mols_info *info)
  521. {
  522. struct v4l2_subdev *sd = &info->sd;
  523. int ret;
  524. ret = m5mols_mode(info, REG_PARAMETER);
  525. if (!ret)
  526. ret = m5mols_write(sd, PARM_MON_SIZE, info->resolution);
  527. if (!ret)
  528. ret = m5mols_write(sd, PARM_MON_FPS, REG_FPS_30);
  529. if (!ret)
  530. ret = m5mols_mode(info, REG_MONITOR);
  531. if (!ret)
  532. ret = m5mols_sync_controls(info);
  533. return ret;
  534. }
  535. static int m5mols_s_stream(struct v4l2_subdev *sd, int enable)
  536. {
  537. struct m5mols_info *info = to_m5mols(sd);
  538. if (enable) {
  539. int ret = -EINVAL;
  540. if (is_code(info->code, M5MOLS_RESTYPE_MONITOR))
  541. ret = m5mols_start_monitor(info);
  542. if (is_code(info->code, M5MOLS_RESTYPE_CAPTURE))
  543. ret = m5mols_start_capture(info);
  544. return ret;
  545. }
  546. return m5mols_mode(info, REG_PARAMETER);
  547. }
  548. static const struct v4l2_subdev_video_ops m5mols_video_ops = {
  549. .s_stream = m5mols_s_stream,
  550. };
  551. static int m5mols_s_ctrl(struct v4l2_ctrl *ctrl)
  552. {
  553. struct v4l2_subdev *sd = to_sd(ctrl);
  554. struct m5mols_info *info = to_m5mols(sd);
  555. int ret;
  556. info->mode_save = info->mode;
  557. ret = m5mols_mode(info, REG_PARAMETER);
  558. if (!ret)
  559. ret = m5mols_set_ctrl(ctrl);
  560. if (!ret)
  561. ret = m5mols_mode(info, info->mode_save);
  562. return ret;
  563. }
  564. static const struct v4l2_ctrl_ops m5mols_ctrl_ops = {
  565. .s_ctrl = m5mols_s_ctrl,
  566. };
  567. static int m5mols_sensor_power(struct m5mols_info *info, bool enable)
  568. {
  569. struct v4l2_subdev *sd = &info->sd;
  570. struct i2c_client *client = v4l2_get_subdevdata(sd);
  571. const struct m5mols_platform_data *pdata = info->pdata;
  572. int ret;
  573. if (enable) {
  574. if (is_powered(info))
  575. return 0;
  576. if (info->set_power) {
  577. ret = info->set_power(&client->dev, 1);
  578. if (ret)
  579. return ret;
  580. }
  581. ret = regulator_bulk_enable(ARRAY_SIZE(supplies), supplies);
  582. if (ret) {
  583. info->set_power(&client->dev, 0);
  584. return ret;
  585. }
  586. gpio_set_value(pdata->gpio_reset, !pdata->reset_polarity);
  587. usleep_range(1000, 1000);
  588. info->power = true;
  589. return ret;
  590. }
  591. if (!is_powered(info))
  592. return 0;
  593. ret = regulator_bulk_disable(ARRAY_SIZE(supplies), supplies);
  594. if (ret)
  595. return ret;
  596. if (info->set_power)
  597. info->set_power(&client->dev, 0);
  598. gpio_set_value(pdata->gpio_reset, pdata->reset_polarity);
  599. usleep_range(1000, 1000);
  600. info->power = false;
  601. return ret;
  602. }
  603. /* m5mols_update_fw - optional firmware update routine */
  604. int __attribute__ ((weak)) m5mols_update_fw(struct v4l2_subdev *sd,
  605. int (*set_power)(struct m5mols_info *, bool))
  606. {
  607. return 0;
  608. }
  609. /**
  610. * m5mols_sensor_armboot - Booting M-5MOLS internal ARM core.
  611. *
  612. * Booting internal ARM core makes the M-5MOLS is ready for getting commands
  613. * with I2C. It's the first thing to be done after it powered up. It must wait
  614. * at least 520ms recommended by M-5MOLS datasheet, after executing arm booting.
  615. */
  616. static int m5mols_sensor_armboot(struct v4l2_subdev *sd)
  617. {
  618. int ret;
  619. ret = m5mols_write(sd, FLASH_CAM_START, REG_START_ARM_BOOT);
  620. if (ret < 0)
  621. return ret;
  622. msleep(520);
  623. ret = m5mols_get_version(sd);
  624. if (!ret)
  625. ret = m5mols_update_fw(sd, m5mols_sensor_power);
  626. if (ret)
  627. return ret;
  628. v4l2_dbg(1, m5mols_debug, sd, "Success ARM Booting\n");
  629. ret = m5mols_write(sd, PARM_INTERFACE, REG_INTERFACE_MIPI);
  630. if (!ret)
  631. ret = m5mols_enable_interrupt(sd, REG_INT_AF);
  632. return ret;
  633. }
  634. static int m5mols_init_controls(struct m5mols_info *info)
  635. {
  636. struct v4l2_subdev *sd = &info->sd;
  637. u16 max_exposure;
  638. u16 step_zoom;
  639. int ret;
  640. /* Determine value's range & step of controls for various FW version */
  641. ret = m5mols_read_u16(sd, AE_MAX_GAIN_MON, &max_exposure);
  642. if (!ret)
  643. step_zoom = is_manufacturer(info, REG_SAMSUNG_OPTICS) ? 31 : 1;
  644. if (ret)
  645. return ret;
  646. v4l2_ctrl_handler_init(&info->handle, 6);
  647. info->autowb = v4l2_ctrl_new_std(&info->handle,
  648. &m5mols_ctrl_ops, V4L2_CID_AUTO_WHITE_BALANCE,
  649. 0, 1, 1, 0);
  650. info->saturation = v4l2_ctrl_new_std(&info->handle,
  651. &m5mols_ctrl_ops, V4L2_CID_SATURATION,
  652. 1, 5, 1, 3);
  653. info->zoom = v4l2_ctrl_new_std(&info->handle,
  654. &m5mols_ctrl_ops, V4L2_CID_ZOOM_ABSOLUTE,
  655. 1, 70, step_zoom, 1);
  656. info->exposure = v4l2_ctrl_new_std(&info->handle,
  657. &m5mols_ctrl_ops, V4L2_CID_EXPOSURE,
  658. 0, max_exposure, 1, (int)max_exposure/2);
  659. info->colorfx = v4l2_ctrl_new_std_menu(&info->handle,
  660. &m5mols_ctrl_ops, V4L2_CID_COLORFX,
  661. 4, (1 << V4L2_COLORFX_BW), V4L2_COLORFX_NONE);
  662. info->autoexposure = v4l2_ctrl_new_std_menu(&info->handle,
  663. &m5mols_ctrl_ops, V4L2_CID_EXPOSURE_AUTO,
  664. 1, 0, V4L2_EXPOSURE_MANUAL);
  665. sd->ctrl_handler = &info->handle;
  666. if (info->handle.error) {
  667. v4l2_err(sd, "Failed to initialize controls: %d\n", ret);
  668. v4l2_ctrl_handler_free(&info->handle);
  669. return info->handle.error;
  670. }
  671. v4l2_ctrl_cluster(2, &info->autoexposure);
  672. return 0;
  673. }
  674. /**
  675. * m5mols_s_power - Main sensor power control function
  676. *
  677. * To prevent breaking the lens when the sensor is powered off the Soft-Landing
  678. * algorithm is called where available. The Soft-Landing algorithm availability
  679. * dependends on the firmware provider.
  680. */
  681. static int m5mols_s_power(struct v4l2_subdev *sd, int on)
  682. {
  683. struct m5mols_info *info = to_m5mols(sd);
  684. int ret;
  685. if (on) {
  686. ret = m5mols_sensor_power(info, true);
  687. if (!ret)
  688. ret = m5mols_sensor_armboot(sd);
  689. if (!ret)
  690. ret = m5mols_init_controls(info);
  691. if (ret)
  692. return ret;
  693. info->ffmt[M5MOLS_RESTYPE_MONITOR] =
  694. m5mols_default_ffmt[M5MOLS_RESTYPE_MONITOR];
  695. info->ffmt[M5MOLS_RESTYPE_CAPTURE] =
  696. m5mols_default_ffmt[M5MOLS_RESTYPE_CAPTURE];
  697. return ret;
  698. }
  699. if (is_manufacturer(info, REG_SAMSUNG_TECHWIN)) {
  700. ret = m5mols_mode(info, REG_MONITOR);
  701. if (!ret)
  702. ret = m5mols_write(sd, AF_EXECUTE, REG_AF_STOP);
  703. if (!ret)
  704. ret = m5mols_write(sd, AF_MODE, REG_AF_POWEROFF);
  705. if (!ret)
  706. ret = m5mols_busy(sd, CAT_SYSTEM, CAT0_STATUS,
  707. REG_AF_IDLE);
  708. if (!ret)
  709. v4l2_info(sd, "Success soft-landing lens\n");
  710. }
  711. ret = m5mols_sensor_power(info, false);
  712. if (!ret) {
  713. v4l2_ctrl_handler_free(&info->handle);
  714. info->ctrl_sync = false;
  715. }
  716. return ret;
  717. }
  718. static int m5mols_log_status(struct v4l2_subdev *sd)
  719. {
  720. struct m5mols_info *info = to_m5mols(sd);
  721. v4l2_ctrl_handler_log_status(&info->handle, sd->name);
  722. return 0;
  723. }
  724. static const struct v4l2_subdev_core_ops m5mols_core_ops = {
  725. .s_power = m5mols_s_power,
  726. .g_ctrl = v4l2_subdev_g_ctrl,
  727. .s_ctrl = v4l2_subdev_s_ctrl,
  728. .queryctrl = v4l2_subdev_queryctrl,
  729. .querymenu = v4l2_subdev_querymenu,
  730. .g_ext_ctrls = v4l2_subdev_g_ext_ctrls,
  731. .try_ext_ctrls = v4l2_subdev_try_ext_ctrls,
  732. .s_ext_ctrls = v4l2_subdev_s_ext_ctrls,
  733. .log_status = m5mols_log_status,
  734. };
  735. static const struct v4l2_subdev_ops m5mols_ops = {
  736. .core = &m5mols_core_ops,
  737. .pad = &m5mols_pad_ops,
  738. .video = &m5mols_video_ops,
  739. };
  740. static void m5mols_irq_work(struct work_struct *work)
  741. {
  742. struct m5mols_info *info =
  743. container_of(work, struct m5mols_info, work_irq);
  744. struct v4l2_subdev *sd = &info->sd;
  745. u8 reg;
  746. int ret;
  747. if (!is_powered(info) ||
  748. m5mols_read_u8(sd, SYSTEM_INT_FACTOR, &info->interrupt))
  749. return;
  750. switch (info->interrupt & REG_INT_MASK) {
  751. case REG_INT_AF:
  752. if (!is_available_af(info))
  753. break;
  754. ret = m5mols_read_u8(sd, AF_STATUS, &reg);
  755. v4l2_dbg(2, m5mols_debug, sd, "AF %s\n",
  756. reg == REG_AF_FAIL ? "Failed" :
  757. reg == REG_AF_SUCCESS ? "Success" :
  758. reg == REG_AF_IDLE ? "Idle" : "Busy");
  759. break;
  760. case REG_INT_CAPTURE:
  761. if (!test_and_set_bit(ST_CAPT_IRQ, &info->flags))
  762. wake_up_interruptible(&info->irq_waitq);
  763. v4l2_dbg(2, m5mols_debug, sd, "CAPTURE\n");
  764. break;
  765. default:
  766. v4l2_dbg(2, m5mols_debug, sd, "Undefined: %02x\n", reg);
  767. break;
  768. };
  769. }
  770. static irqreturn_t m5mols_irq_handler(int irq, void *data)
  771. {
  772. struct v4l2_subdev *sd = data;
  773. struct m5mols_info *info = to_m5mols(sd);
  774. schedule_work(&info->work_irq);
  775. return IRQ_HANDLED;
  776. }
  777. static int __devinit m5mols_probe(struct i2c_client *client,
  778. const struct i2c_device_id *id)
  779. {
  780. const struct m5mols_platform_data *pdata = client->dev.platform_data;
  781. struct m5mols_info *info;
  782. struct v4l2_subdev *sd;
  783. int ret;
  784. if (pdata == NULL) {
  785. dev_err(&client->dev, "No platform data\n");
  786. return -EINVAL;
  787. }
  788. if (!gpio_is_valid(pdata->gpio_reset)) {
  789. dev_err(&client->dev, "No valid RESET GPIO specified\n");
  790. return -EINVAL;
  791. }
  792. if (!pdata->irq) {
  793. dev_err(&client->dev, "Interrupt not assigned\n");
  794. return -EINVAL;
  795. }
  796. info = kzalloc(sizeof(struct m5mols_info), GFP_KERNEL);
  797. if (!info)
  798. return -ENOMEM;
  799. info->pdata = pdata;
  800. info->set_power = pdata->set_power;
  801. ret = gpio_request(pdata->gpio_reset, "M5MOLS_NRST");
  802. if (ret) {
  803. dev_err(&client->dev, "Failed to request gpio: %d\n", ret);
  804. goto out_free;
  805. }
  806. gpio_direction_output(pdata->gpio_reset, pdata->reset_polarity);
  807. ret = regulator_bulk_get(&client->dev, ARRAY_SIZE(supplies), supplies);
  808. if (ret) {
  809. dev_err(&client->dev, "Failed to get regulators: %d\n", ret);
  810. goto out_gpio;
  811. }
  812. sd = &info->sd;
  813. strlcpy(sd->name, MODULE_NAME, sizeof(sd->name));
  814. v4l2_i2c_subdev_init(sd, client, &m5mols_ops);
  815. info->pad.flags = MEDIA_PAD_FL_SOURCE;
  816. ret = media_entity_init(&sd->entity, 1, &info->pad, 0);
  817. if (ret < 0)
  818. goto out_reg;
  819. sd->entity.type = MEDIA_ENT_T_V4L2_SUBDEV_SENSOR;
  820. init_waitqueue_head(&info->irq_waitq);
  821. INIT_WORK(&info->work_irq, m5mols_irq_work);
  822. ret = request_irq(pdata->irq, m5mols_irq_handler,
  823. IRQF_TRIGGER_RISING, MODULE_NAME, sd);
  824. if (ret) {
  825. dev_err(&client->dev, "Interrupt request failed: %d\n", ret);
  826. goto out_me;
  827. }
  828. info->res_type = M5MOLS_RESTYPE_MONITOR;
  829. return 0;
  830. out_me:
  831. media_entity_cleanup(&sd->entity);
  832. out_reg:
  833. regulator_bulk_free(ARRAY_SIZE(supplies), supplies);
  834. out_gpio:
  835. gpio_free(pdata->gpio_reset);
  836. out_free:
  837. kfree(info);
  838. return ret;
  839. }
  840. static int __devexit m5mols_remove(struct i2c_client *client)
  841. {
  842. struct v4l2_subdev *sd = i2c_get_clientdata(client);
  843. struct m5mols_info *info = to_m5mols(sd);
  844. v4l2_device_unregister_subdev(sd);
  845. free_irq(info->pdata->irq, sd);
  846. regulator_bulk_free(ARRAY_SIZE(supplies), supplies);
  847. gpio_free(info->pdata->gpio_reset);
  848. media_entity_cleanup(&sd->entity);
  849. kfree(info);
  850. return 0;
  851. }
  852. static const struct i2c_device_id m5mols_id[] = {
  853. { MODULE_NAME, 0 },
  854. { },
  855. };
  856. MODULE_DEVICE_TABLE(i2c, m5mols_id);
  857. static struct i2c_driver m5mols_i2c_driver = {
  858. .driver = {
  859. .name = MODULE_NAME,
  860. },
  861. .probe = m5mols_probe,
  862. .remove = __devexit_p(m5mols_remove),
  863. .id_table = m5mols_id,
  864. };
  865. static int __init m5mols_mod_init(void)
  866. {
  867. return i2c_add_driver(&m5mols_i2c_driver);
  868. }
  869. static void __exit m5mols_mod_exit(void)
  870. {
  871. i2c_del_driver(&m5mols_i2c_driver);
  872. }
  873. module_init(m5mols_mod_init);
  874. module_exit(m5mols_mod_exit);
  875. MODULE_AUTHOR("HeungJun Kim <riverful.kim@samsung.com>");
  876. MODULE_AUTHOR("Dongsoo Kim <dongsoo45.kim@samsung.com>");
  877. MODULE_DESCRIPTION("Fujitsu M-5MOLS 8M Pixel camera driver");
  878. MODULE_LICENSE("GPL");