m5602_s5k83a.c 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605
  1. /*
  2. * Driver for the s5k83a sensor
  3. *
  4. * Copyright (C) 2008 Erik Andrén
  5. * Copyright (C) 2007 Ilyes Gouta. Based on the m5603x Linux Driver Project.
  6. * Copyright (C) 2005 m5603x Linux Driver Project <m5602@x3ng.com.br>
  7. *
  8. * Portions of code to USB interface and ALi driver software,
  9. * Copyright (c) 2006 Willem Duinker
  10. * v4l2 interface modeled after the V4L2 driver
  11. * for SN9C10x PC Camera Controllers
  12. *
  13. * This program is free software; you can redistribute it and/or
  14. * modify it under the terms of the GNU General Public License as
  15. * published by the Free Software Foundation, version 2.
  16. *
  17. */
  18. #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  19. #include <linux/kthread.h>
  20. #include "m5602_s5k83a.h"
  21. static int s5k83a_set_gain(struct gspca_dev *gspca_dev, __s32 val);
  22. static int s5k83a_get_gain(struct gspca_dev *gspca_dev, __s32 *val);
  23. static int s5k83a_set_brightness(struct gspca_dev *gspca_dev, __s32 val);
  24. static int s5k83a_get_brightness(struct gspca_dev *gspca_dev, __s32 *val);
  25. static int s5k83a_set_exposure(struct gspca_dev *gspca_dev, __s32 val);
  26. static int s5k83a_get_exposure(struct gspca_dev *gspca_dev, __s32 *val);
  27. static int s5k83a_get_vflip(struct gspca_dev *gspca_dev, __s32 *val);
  28. static int s5k83a_set_vflip(struct gspca_dev *gspca_dev, __s32 val);
  29. static int s5k83a_get_hflip(struct gspca_dev *gspca_dev, __s32 *val);
  30. static int s5k83a_set_hflip(struct gspca_dev *gspca_dev, __s32 val);
  31. static struct v4l2_pix_format s5k83a_modes[] = {
  32. {
  33. 640,
  34. 480,
  35. V4L2_PIX_FMT_SBGGR8,
  36. V4L2_FIELD_NONE,
  37. .sizeimage =
  38. 640 * 480,
  39. .bytesperline = 640,
  40. .colorspace = V4L2_COLORSPACE_SRGB,
  41. .priv = 0
  42. }
  43. };
  44. static const struct ctrl s5k83a_ctrls[] = {
  45. #define GAIN_IDX 0
  46. {
  47. {
  48. .id = V4L2_CID_GAIN,
  49. .type = V4L2_CTRL_TYPE_INTEGER,
  50. .name = "gain",
  51. .minimum = 0x00,
  52. .maximum = 0xff,
  53. .step = 0x01,
  54. .default_value = S5K83A_DEFAULT_GAIN,
  55. .flags = V4L2_CTRL_FLAG_SLIDER
  56. },
  57. .set = s5k83a_set_gain,
  58. .get = s5k83a_get_gain
  59. },
  60. #define BRIGHTNESS_IDX 1
  61. {
  62. {
  63. .id = V4L2_CID_BRIGHTNESS,
  64. .type = V4L2_CTRL_TYPE_INTEGER,
  65. .name = "brightness",
  66. .minimum = 0x00,
  67. .maximum = 0xff,
  68. .step = 0x01,
  69. .default_value = S5K83A_DEFAULT_BRIGHTNESS,
  70. .flags = V4L2_CTRL_FLAG_SLIDER
  71. },
  72. .set = s5k83a_set_brightness,
  73. .get = s5k83a_get_brightness,
  74. },
  75. #define EXPOSURE_IDX 2
  76. {
  77. {
  78. .id = V4L2_CID_EXPOSURE,
  79. .type = V4L2_CTRL_TYPE_INTEGER,
  80. .name = "exposure",
  81. .minimum = 0x00,
  82. .maximum = S5K83A_MAXIMUM_EXPOSURE,
  83. .step = 0x01,
  84. .default_value = S5K83A_DEFAULT_EXPOSURE,
  85. .flags = V4L2_CTRL_FLAG_SLIDER
  86. },
  87. .set = s5k83a_set_exposure,
  88. .get = s5k83a_get_exposure
  89. },
  90. #define HFLIP_IDX 3
  91. {
  92. {
  93. .id = V4L2_CID_HFLIP,
  94. .type = V4L2_CTRL_TYPE_BOOLEAN,
  95. .name = "horizontal flip",
  96. .minimum = 0,
  97. .maximum = 1,
  98. .step = 1,
  99. .default_value = 0
  100. },
  101. .set = s5k83a_set_hflip,
  102. .get = s5k83a_get_hflip
  103. },
  104. #define VFLIP_IDX 4
  105. {
  106. {
  107. .id = V4L2_CID_VFLIP,
  108. .type = V4L2_CTRL_TYPE_BOOLEAN,
  109. .name = "vertical flip",
  110. .minimum = 0,
  111. .maximum = 1,
  112. .step = 1,
  113. .default_value = 0
  114. },
  115. .set = s5k83a_set_vflip,
  116. .get = s5k83a_get_vflip
  117. }
  118. };
  119. static void s5k83a_dump_registers(struct sd *sd);
  120. static int s5k83a_get_rotation(struct sd *sd, u8 *reg_data);
  121. static int s5k83a_set_led_indication(struct sd *sd, u8 val);
  122. static int s5k83a_set_flip_real(struct gspca_dev *gspca_dev,
  123. __s32 vflip, __s32 hflip);
  124. int s5k83a_probe(struct sd *sd)
  125. {
  126. struct s5k83a_priv *sens_priv;
  127. u8 prod_id = 0, ver_id = 0;
  128. int i, err = 0;
  129. if (force_sensor) {
  130. if (force_sensor == S5K83A_SENSOR) {
  131. pr_info("Forcing a %s sensor\n", s5k83a.name);
  132. goto sensor_found;
  133. }
  134. /* If we want to force another sensor, don't try to probe this
  135. * one */
  136. return -ENODEV;
  137. }
  138. PDEBUG(D_PROBE, "Probing for a s5k83a sensor");
  139. /* Preinit the sensor */
  140. for (i = 0; i < ARRAY_SIZE(preinit_s5k83a) && !err; i++) {
  141. u8 data[2] = {preinit_s5k83a[i][2], preinit_s5k83a[i][3]};
  142. if (preinit_s5k83a[i][0] == SENSOR)
  143. err = m5602_write_sensor(sd, preinit_s5k83a[i][1],
  144. data, 2);
  145. else
  146. err = m5602_write_bridge(sd, preinit_s5k83a[i][1],
  147. data[0]);
  148. }
  149. /* We don't know what register (if any) that contain the product id
  150. * Just pick the first addresses that seem to produce the same results
  151. * on multiple machines */
  152. if (m5602_read_sensor(sd, 0x00, &prod_id, 1))
  153. return -ENODEV;
  154. if (m5602_read_sensor(sd, 0x01, &ver_id, 1))
  155. return -ENODEV;
  156. if ((prod_id == 0xff) || (ver_id == 0xff))
  157. return -ENODEV;
  158. else
  159. pr_info("Detected a s5k83a sensor\n");
  160. sensor_found:
  161. sens_priv = kmalloc(
  162. sizeof(struct s5k83a_priv), GFP_KERNEL);
  163. if (!sens_priv)
  164. return -ENOMEM;
  165. sens_priv->settings =
  166. kmalloc(sizeof(s32)*ARRAY_SIZE(s5k83a_ctrls), GFP_KERNEL);
  167. if (!sens_priv->settings) {
  168. kfree(sens_priv);
  169. return -ENOMEM;
  170. }
  171. sd->gspca_dev.cam.cam_mode = s5k83a_modes;
  172. sd->gspca_dev.cam.nmodes = ARRAY_SIZE(s5k83a_modes);
  173. sd->desc->ctrls = s5k83a_ctrls;
  174. sd->desc->nctrls = ARRAY_SIZE(s5k83a_ctrls);
  175. /* null the pointer! thread is't running now */
  176. sens_priv->rotation_thread = NULL;
  177. for (i = 0; i < ARRAY_SIZE(s5k83a_ctrls); i++)
  178. sens_priv->settings[i] = s5k83a_ctrls[i].qctrl.default_value;
  179. sd->sensor_priv = sens_priv;
  180. return 0;
  181. }
  182. int s5k83a_init(struct sd *sd)
  183. {
  184. int i, err = 0;
  185. s32 *sensor_settings =
  186. ((struct s5k83a_priv *) sd->sensor_priv)->settings;
  187. for (i = 0; i < ARRAY_SIZE(init_s5k83a) && !err; i++) {
  188. u8 data[2] = {0x00, 0x00};
  189. switch (init_s5k83a[i][0]) {
  190. case BRIDGE:
  191. err = m5602_write_bridge(sd,
  192. init_s5k83a[i][1],
  193. init_s5k83a[i][2]);
  194. break;
  195. case SENSOR:
  196. data[0] = init_s5k83a[i][2];
  197. err = m5602_write_sensor(sd,
  198. init_s5k83a[i][1], data, 1);
  199. break;
  200. case SENSOR_LONG:
  201. data[0] = init_s5k83a[i][2];
  202. data[1] = init_s5k83a[i][3];
  203. err = m5602_write_sensor(sd,
  204. init_s5k83a[i][1], data, 2);
  205. break;
  206. default:
  207. pr_info("Invalid stream command, exiting init\n");
  208. return -EINVAL;
  209. }
  210. }
  211. if (dump_sensor)
  212. s5k83a_dump_registers(sd);
  213. err = s5k83a_set_gain(&sd->gspca_dev, sensor_settings[GAIN_IDX]);
  214. if (err < 0)
  215. return err;
  216. err = s5k83a_set_brightness(&sd->gspca_dev,
  217. sensor_settings[BRIGHTNESS_IDX]);
  218. if (err < 0)
  219. return err;
  220. err = s5k83a_set_exposure(&sd->gspca_dev,
  221. sensor_settings[EXPOSURE_IDX]);
  222. if (err < 0)
  223. return err;
  224. err = s5k83a_set_hflip(&sd->gspca_dev, sensor_settings[HFLIP_IDX]);
  225. if (err < 0)
  226. return err;
  227. err = s5k83a_set_vflip(&sd->gspca_dev, sensor_settings[VFLIP_IDX]);
  228. return err;
  229. }
  230. static int rotation_thread_function(void *data)
  231. {
  232. struct sd *sd = (struct sd *) data;
  233. struct s5k83a_priv *sens_priv = sd->sensor_priv;
  234. u8 reg, previous_rotation = 0;
  235. __s32 vflip, hflip;
  236. set_current_state(TASK_INTERRUPTIBLE);
  237. while (!schedule_timeout(100)) {
  238. if (mutex_lock_interruptible(&sd->gspca_dev.usb_lock))
  239. break;
  240. s5k83a_get_rotation(sd, &reg);
  241. if (previous_rotation != reg) {
  242. previous_rotation = reg;
  243. pr_info("Camera was flipped\n");
  244. s5k83a_get_vflip((struct gspca_dev *) sd, &vflip);
  245. s5k83a_get_hflip((struct gspca_dev *) sd, &hflip);
  246. if (reg) {
  247. vflip = !vflip;
  248. hflip = !hflip;
  249. }
  250. s5k83a_set_flip_real((struct gspca_dev *) sd,
  251. vflip, hflip);
  252. }
  253. mutex_unlock(&sd->gspca_dev.usb_lock);
  254. set_current_state(TASK_INTERRUPTIBLE);
  255. }
  256. /* return to "front" flip */
  257. if (previous_rotation) {
  258. s5k83a_get_vflip((struct gspca_dev *) sd, &vflip);
  259. s5k83a_get_hflip((struct gspca_dev *) sd, &hflip);
  260. s5k83a_set_flip_real((struct gspca_dev *) sd, vflip, hflip);
  261. }
  262. sens_priv->rotation_thread = NULL;
  263. return 0;
  264. }
  265. int s5k83a_start(struct sd *sd)
  266. {
  267. int i, err = 0;
  268. struct s5k83a_priv *sens_priv = sd->sensor_priv;
  269. /* Create another thread, polling the GPIO ports of the camera to check
  270. if it got rotated. This is how the windows driver does it so we have
  271. to assume that there is no better way of accomplishing this */
  272. sens_priv->rotation_thread = kthread_create(rotation_thread_function,
  273. sd, "rotation thread");
  274. wake_up_process(sens_priv->rotation_thread);
  275. /* Preinit the sensor */
  276. for (i = 0; i < ARRAY_SIZE(start_s5k83a) && !err; i++) {
  277. u8 data[2] = {start_s5k83a[i][2], start_s5k83a[i][3]};
  278. if (start_s5k83a[i][0] == SENSOR)
  279. err = m5602_write_sensor(sd, start_s5k83a[i][1],
  280. data, 2);
  281. else
  282. err = m5602_write_bridge(sd, start_s5k83a[i][1],
  283. data[0]);
  284. }
  285. if (err < 0)
  286. return err;
  287. return s5k83a_set_led_indication(sd, 1);
  288. }
  289. int s5k83a_stop(struct sd *sd)
  290. {
  291. struct s5k83a_priv *sens_priv = sd->sensor_priv;
  292. if (sens_priv->rotation_thread)
  293. kthread_stop(sens_priv->rotation_thread);
  294. return s5k83a_set_led_indication(sd, 0);
  295. }
  296. void s5k83a_disconnect(struct sd *sd)
  297. {
  298. struct s5k83a_priv *sens_priv = sd->sensor_priv;
  299. s5k83a_stop(sd);
  300. sd->sensor = NULL;
  301. kfree(sens_priv->settings);
  302. kfree(sens_priv);
  303. }
  304. static int s5k83a_get_gain(struct gspca_dev *gspca_dev, __s32 *val)
  305. {
  306. struct sd *sd = (struct sd *) gspca_dev;
  307. struct s5k83a_priv *sens_priv = sd->sensor_priv;
  308. *val = sens_priv->settings[GAIN_IDX];
  309. return 0;
  310. }
  311. static int s5k83a_set_gain(struct gspca_dev *gspca_dev, __s32 val)
  312. {
  313. int err;
  314. u8 data[2];
  315. struct sd *sd = (struct sd *) gspca_dev;
  316. struct s5k83a_priv *sens_priv = sd->sensor_priv;
  317. sens_priv->settings[GAIN_IDX] = val;
  318. data[0] = 0x00;
  319. data[1] = 0x20;
  320. err = m5602_write_sensor(sd, 0x14, data, 2);
  321. if (err < 0)
  322. return err;
  323. data[0] = 0x01;
  324. data[1] = 0x00;
  325. err = m5602_write_sensor(sd, 0x0d, data, 2);
  326. if (err < 0)
  327. return err;
  328. /* FIXME: This is not sane, we need to figure out the composition
  329. of these registers */
  330. data[0] = val >> 3; /* gain, high 5 bits */
  331. data[1] = val >> 1; /* gain, high 7 bits */
  332. err = m5602_write_sensor(sd, S5K83A_GAIN, data, 2);
  333. return err;
  334. }
  335. static int s5k83a_get_brightness(struct gspca_dev *gspca_dev, __s32 *val)
  336. {
  337. struct sd *sd = (struct sd *) gspca_dev;
  338. struct s5k83a_priv *sens_priv = sd->sensor_priv;
  339. *val = sens_priv->settings[BRIGHTNESS_IDX];
  340. return 0;
  341. }
  342. static int s5k83a_set_brightness(struct gspca_dev *gspca_dev, __s32 val)
  343. {
  344. int err;
  345. u8 data[1];
  346. struct sd *sd = (struct sd *) gspca_dev;
  347. struct s5k83a_priv *sens_priv = sd->sensor_priv;
  348. sens_priv->settings[BRIGHTNESS_IDX] = val;
  349. data[0] = val;
  350. err = m5602_write_sensor(sd, S5K83A_BRIGHTNESS, data, 1);
  351. return err;
  352. }
  353. static int s5k83a_get_exposure(struct gspca_dev *gspca_dev, __s32 *val)
  354. {
  355. struct sd *sd = (struct sd *) gspca_dev;
  356. struct s5k83a_priv *sens_priv = sd->sensor_priv;
  357. *val = sens_priv->settings[EXPOSURE_IDX];
  358. return 0;
  359. }
  360. static int s5k83a_set_exposure(struct gspca_dev *gspca_dev, __s32 val)
  361. {
  362. int err;
  363. u8 data[2];
  364. struct sd *sd = (struct sd *) gspca_dev;
  365. struct s5k83a_priv *sens_priv = sd->sensor_priv;
  366. sens_priv->settings[EXPOSURE_IDX] = val;
  367. data[0] = 0;
  368. data[1] = val;
  369. err = m5602_write_sensor(sd, S5K83A_EXPOSURE, data, 2);
  370. return err;
  371. }
  372. static int s5k83a_get_vflip(struct gspca_dev *gspca_dev, __s32 *val)
  373. {
  374. struct sd *sd = (struct sd *) gspca_dev;
  375. struct s5k83a_priv *sens_priv = sd->sensor_priv;
  376. *val = sens_priv->settings[VFLIP_IDX];
  377. return 0;
  378. }
  379. static int s5k83a_set_flip_real(struct gspca_dev *gspca_dev,
  380. __s32 vflip, __s32 hflip)
  381. {
  382. int err;
  383. u8 data[1];
  384. struct sd *sd = (struct sd *) gspca_dev;
  385. data[0] = 0x05;
  386. err = m5602_write_sensor(sd, S5K83A_PAGE_MAP, data, 1);
  387. if (err < 0)
  388. return err;
  389. /* six bit is vflip, seven is hflip */
  390. data[0] = S5K83A_FLIP_MASK;
  391. data[0] = (vflip) ? data[0] | 0x40 : data[0];
  392. data[0] = (hflip) ? data[0] | 0x80 : data[0];
  393. err = m5602_write_sensor(sd, S5K83A_FLIP, data, 1);
  394. if (err < 0)
  395. return err;
  396. data[0] = (vflip) ? 0x0b : 0x0a;
  397. err = m5602_write_sensor(sd, S5K83A_VFLIP_TUNE, data, 1);
  398. if (err < 0)
  399. return err;
  400. data[0] = (hflip) ? 0x0a : 0x0b;
  401. err = m5602_write_sensor(sd, S5K83A_HFLIP_TUNE, data, 1);
  402. return err;
  403. }
  404. static int s5k83a_set_vflip(struct gspca_dev *gspca_dev, __s32 val)
  405. {
  406. int err;
  407. u8 reg;
  408. __s32 hflip;
  409. struct sd *sd = (struct sd *) gspca_dev;
  410. struct s5k83a_priv *sens_priv = sd->sensor_priv;
  411. sens_priv->settings[VFLIP_IDX] = val;
  412. s5k83a_get_hflip(gspca_dev, &hflip);
  413. err = s5k83a_get_rotation(sd, &reg);
  414. if (err < 0)
  415. return err;
  416. if (reg) {
  417. val = !val;
  418. hflip = !hflip;
  419. }
  420. err = s5k83a_set_flip_real(gspca_dev, val, hflip);
  421. return err;
  422. }
  423. static int s5k83a_get_hflip(struct gspca_dev *gspca_dev, __s32 *val)
  424. {
  425. struct sd *sd = (struct sd *) gspca_dev;
  426. struct s5k83a_priv *sens_priv = sd->sensor_priv;
  427. *val = sens_priv->settings[HFLIP_IDX];
  428. return 0;
  429. }
  430. static int s5k83a_set_hflip(struct gspca_dev *gspca_dev, __s32 val)
  431. {
  432. int err;
  433. u8 reg;
  434. __s32 vflip;
  435. struct sd *sd = (struct sd *) gspca_dev;
  436. struct s5k83a_priv *sens_priv = sd->sensor_priv;
  437. sens_priv->settings[HFLIP_IDX] = val;
  438. s5k83a_get_vflip(gspca_dev, &vflip);
  439. err = s5k83a_get_rotation(sd, &reg);
  440. if (err < 0)
  441. return err;
  442. if (reg) {
  443. val = !val;
  444. vflip = !vflip;
  445. }
  446. err = s5k83a_set_flip_real(gspca_dev, vflip, val);
  447. return err;
  448. }
  449. static int s5k83a_set_led_indication(struct sd *sd, u8 val)
  450. {
  451. int err = 0;
  452. u8 data[1];
  453. err = m5602_read_bridge(sd, M5602_XB_GPIO_DAT, data);
  454. if (err < 0)
  455. return err;
  456. if (val)
  457. data[0] = data[0] | S5K83A_GPIO_LED_MASK;
  458. else
  459. data[0] = data[0] & ~S5K83A_GPIO_LED_MASK;
  460. err = m5602_write_bridge(sd, M5602_XB_GPIO_DAT, data[0]);
  461. return err;
  462. }
  463. /* Get camera rotation on Acer notebooks */
  464. static int s5k83a_get_rotation(struct sd *sd, u8 *reg_data)
  465. {
  466. int err = m5602_read_bridge(sd, M5602_XB_GPIO_DAT, reg_data);
  467. *reg_data = (*reg_data & S5K83A_GPIO_ROTATION_MASK) ? 0 : 1;
  468. return err;
  469. }
  470. static void s5k83a_dump_registers(struct sd *sd)
  471. {
  472. int address;
  473. u8 page, old_page;
  474. m5602_read_sensor(sd, S5K83A_PAGE_MAP, &old_page, 1);
  475. for (page = 0; page < 16; page++) {
  476. m5602_write_sensor(sd, S5K83A_PAGE_MAP, &page, 1);
  477. pr_info("Dumping the s5k83a register state for page 0x%x\n",
  478. page);
  479. for (address = 0; address <= 0xff; address++) {
  480. u8 val = 0;
  481. m5602_read_sensor(sd, address, &val, 1);
  482. pr_info("register 0x%x contains 0x%x\n", address, val);
  483. }
  484. }
  485. pr_info("s5k83a register state dump complete\n");
  486. for (page = 0; page < 16; page++) {
  487. m5602_write_sensor(sd, S5K83A_PAGE_MAP, &page, 1);
  488. pr_info("Probing for which registers that are read/write for page 0x%x\n",
  489. page);
  490. for (address = 0; address <= 0xff; address++) {
  491. u8 old_val, ctrl_val, test_val = 0xff;
  492. m5602_read_sensor(sd, address, &old_val, 1);
  493. m5602_write_sensor(sd, address, &test_val, 1);
  494. m5602_read_sensor(sd, address, &ctrl_val, 1);
  495. if (ctrl_val == test_val)
  496. pr_info("register 0x%x is writeable\n",
  497. address);
  498. else
  499. pr_info("register 0x%x is read only\n",
  500. address);
  501. /* Restore original val */
  502. m5602_write_sensor(sd, address, &old_val, 1);
  503. }
  504. }
  505. pr_info("Read/write register probing complete\n");
  506. m5602_write_sensor(sd, S5K83A_PAGE_MAP, &old_page, 1);
  507. }