stv0680.c 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359
  1. /*
  2. * STV0680 USB Camera Driver
  3. *
  4. * Copyright (C) 2009 Hans de Goede <hdegoede@redhat.com>
  5. *
  6. * This module is adapted from the in kernel v4l1 stv680 driver:
  7. *
  8. * STV0680 USB Camera Driver, by Kevin Sisson (kjsisson@bellsouth.net)
  9. *
  10. * Thanks to STMicroelectronics for information on the usb commands, and
  11. * to Steve Miller at STM for his help and encouragement while I was
  12. * writing this driver.
  13. *
  14. * This program is free software; you can redistribute it and/or modify
  15. * it under the terms of the GNU General Public License as published by
  16. * the Free Software Foundation; either version 2 of the License, or
  17. * (at your option) any later version.
  18. *
  19. * This program is distributed in the hope that it will be useful,
  20. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  21. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  22. * GNU General Public License for more details.
  23. *
  24. * You should have received a copy of the GNU General Public License
  25. * along with this program; if not, write to the Free Software
  26. * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  27. *
  28. */
  29. #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  30. #define MODULE_NAME "stv0680"
  31. #include "gspca.h"
  32. MODULE_AUTHOR("Hans de Goede <hdegoede@redhat.com>");
  33. MODULE_DESCRIPTION("STV0680 USB Camera Driver");
  34. MODULE_LICENSE("GPL");
  35. /* specific webcam descriptor */
  36. struct sd {
  37. struct gspca_dev gspca_dev; /* !! must be the first item */
  38. struct v4l2_pix_format mode;
  39. u8 orig_mode;
  40. u8 video_mode;
  41. u8 current_mode;
  42. };
  43. /* V4L2 controls supported by the driver */
  44. static const struct ctrl sd_ctrls[] = {
  45. };
  46. static int stv_sndctrl(struct gspca_dev *gspca_dev, int set, u8 req, u16 val,
  47. int size)
  48. {
  49. int ret = -1;
  50. u8 req_type = 0;
  51. unsigned int pipe = 0;
  52. switch (set) {
  53. case 0: /* 0xc1 */
  54. req_type = USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_ENDPOINT;
  55. pipe = usb_rcvctrlpipe(gspca_dev->dev, 0);
  56. break;
  57. case 1: /* 0x41 */
  58. req_type = USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_ENDPOINT;
  59. pipe = usb_sndctrlpipe(gspca_dev->dev, 0);
  60. break;
  61. case 2: /* 0x80 */
  62. req_type = USB_DIR_IN | USB_RECIP_DEVICE;
  63. pipe = usb_rcvctrlpipe(gspca_dev->dev, 0);
  64. break;
  65. case 3: /* 0x40 */
  66. req_type = USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE;
  67. pipe = usb_sndctrlpipe(gspca_dev->dev, 0);
  68. break;
  69. }
  70. ret = usb_control_msg(gspca_dev->dev, pipe,
  71. req, req_type,
  72. val, 0, gspca_dev->usb_buf, size, 500);
  73. if ((ret < 0) && (req != 0x0a))
  74. pr_err("usb_control_msg error %i, request = 0x%x, error = %i\n",
  75. set, req, ret);
  76. return ret;
  77. }
  78. static int stv0680_handle_error(struct gspca_dev *gspca_dev, int ret)
  79. {
  80. stv_sndctrl(gspca_dev, 0, 0x80, 0, 0x02); /* Get Last Error */
  81. PDEBUG(D_ERR, "last error: %i, command = 0x%x",
  82. gspca_dev->usb_buf[0], gspca_dev->usb_buf[1]);
  83. return ret;
  84. }
  85. static int stv0680_get_video_mode(struct gspca_dev *gspca_dev)
  86. {
  87. /* Note not sure if this init of usb_buf is really necessary */
  88. memset(gspca_dev->usb_buf, 0, 8);
  89. gspca_dev->usb_buf[0] = 0x0f;
  90. if (stv_sndctrl(gspca_dev, 0, 0x87, 0, 0x08) != 0x08) {
  91. PDEBUG(D_ERR, "Get_Camera_Mode failed");
  92. return stv0680_handle_error(gspca_dev, -EIO);
  93. }
  94. return gspca_dev->usb_buf[0]; /* 01 = VGA, 03 = QVGA, 00 = CIF */
  95. }
  96. static int stv0680_set_video_mode(struct gspca_dev *gspca_dev, u8 mode)
  97. {
  98. struct sd *sd = (struct sd *) gspca_dev;
  99. if (sd->current_mode == mode)
  100. return 0;
  101. memset(gspca_dev->usb_buf, 0, 8);
  102. gspca_dev->usb_buf[0] = mode;
  103. if (stv_sndctrl(gspca_dev, 3, 0x07, 0x0100, 0x08) != 0x08) {
  104. PDEBUG(D_ERR, "Set_Camera_Mode failed");
  105. return stv0680_handle_error(gspca_dev, -EIO);
  106. }
  107. /* Verify we got what we've asked for */
  108. if (stv0680_get_video_mode(gspca_dev) != mode) {
  109. PDEBUG(D_ERR, "Error setting camera video mode!");
  110. return -EIO;
  111. }
  112. sd->current_mode = mode;
  113. return 0;
  114. }
  115. /* this function is called at probe time */
  116. static int sd_config(struct gspca_dev *gspca_dev,
  117. const struct usb_device_id *id)
  118. {
  119. int ret;
  120. struct sd *sd = (struct sd *) gspca_dev;
  121. struct cam *cam = &gspca_dev->cam;
  122. /* Give the camera some time to settle, otherwise initalization will
  123. fail on hotplug, and yes it really needs a full second. */
  124. msleep(1000);
  125. /* ping camera to be sure STV0680 is present */
  126. if (stv_sndctrl(gspca_dev, 0, 0x88, 0x5678, 0x02) != 0x02 ||
  127. gspca_dev->usb_buf[0] != 0x56 || gspca_dev->usb_buf[1] != 0x78) {
  128. PDEBUG(D_ERR, "STV(e): camera ping failed!!");
  129. return stv0680_handle_error(gspca_dev, -ENODEV);
  130. }
  131. /* get camera descriptor */
  132. if (stv_sndctrl(gspca_dev, 2, 0x06, 0x0200, 0x09) != 0x09)
  133. return stv0680_handle_error(gspca_dev, -ENODEV);
  134. if (stv_sndctrl(gspca_dev, 2, 0x06, 0x0200, 0x22) != 0x22 ||
  135. gspca_dev->usb_buf[7] != 0xa0 || gspca_dev->usb_buf[8] != 0x23) {
  136. PDEBUG(D_ERR, "Could not get descriptor 0200.");
  137. return stv0680_handle_error(gspca_dev, -ENODEV);
  138. }
  139. if (stv_sndctrl(gspca_dev, 0, 0x8a, 0, 0x02) != 0x02)
  140. return stv0680_handle_error(gspca_dev, -ENODEV);
  141. if (stv_sndctrl(gspca_dev, 0, 0x8b, 0, 0x24) != 0x24)
  142. return stv0680_handle_error(gspca_dev, -ENODEV);
  143. if (stv_sndctrl(gspca_dev, 0, 0x85, 0, 0x10) != 0x10)
  144. return stv0680_handle_error(gspca_dev, -ENODEV);
  145. if (!(gspca_dev->usb_buf[7] & 0x09)) {
  146. PDEBUG(D_ERR, "Camera supports neither CIF nor QVGA mode");
  147. return -ENODEV;
  148. }
  149. if (gspca_dev->usb_buf[7] & 0x01)
  150. PDEBUG(D_PROBE, "Camera supports CIF mode");
  151. if (gspca_dev->usb_buf[7] & 0x02)
  152. PDEBUG(D_PROBE, "Camera supports VGA mode");
  153. if (gspca_dev->usb_buf[7] & 0x04)
  154. PDEBUG(D_PROBE, "Camera supports QCIF mode");
  155. if (gspca_dev->usb_buf[7] & 0x08)
  156. PDEBUG(D_PROBE, "Camera supports QVGA mode");
  157. if (gspca_dev->usb_buf[7] & 0x01)
  158. sd->video_mode = 0x00; /* CIF */
  159. else
  160. sd->video_mode = 0x03; /* QVGA */
  161. /* FW rev, ASIC rev, sensor ID */
  162. PDEBUG(D_PROBE, "Firmware rev is %i.%i",
  163. gspca_dev->usb_buf[0], gspca_dev->usb_buf[1]);
  164. PDEBUG(D_PROBE, "ASIC rev is %i.%i",
  165. gspca_dev->usb_buf[2], gspca_dev->usb_buf[3]);
  166. PDEBUG(D_PROBE, "Sensor ID is %i",
  167. (gspca_dev->usb_buf[4]*16) + (gspca_dev->usb_buf[5]>>4));
  168. ret = stv0680_get_video_mode(gspca_dev);
  169. if (ret < 0)
  170. return ret;
  171. sd->current_mode = sd->orig_mode = ret;
  172. ret = stv0680_set_video_mode(gspca_dev, sd->video_mode);
  173. if (ret < 0)
  174. return ret;
  175. /* Get mode details */
  176. if (stv_sndctrl(gspca_dev, 0, 0x8f, 0, 0x10) != 0x10)
  177. return stv0680_handle_error(gspca_dev, -EIO);
  178. cam->bulk = 1;
  179. cam->bulk_nurbs = 1; /* The cam cannot handle more */
  180. cam->bulk_size = (gspca_dev->usb_buf[0] << 24) |
  181. (gspca_dev->usb_buf[1] << 16) |
  182. (gspca_dev->usb_buf[2] << 8) |
  183. (gspca_dev->usb_buf[3]);
  184. sd->mode.width = (gspca_dev->usb_buf[4] << 8) |
  185. (gspca_dev->usb_buf[5]); /* 322, 356, 644 */
  186. sd->mode.height = (gspca_dev->usb_buf[6] << 8) |
  187. (gspca_dev->usb_buf[7]); /* 242, 292, 484 */
  188. sd->mode.pixelformat = V4L2_PIX_FMT_STV0680;
  189. sd->mode.field = V4L2_FIELD_NONE;
  190. sd->mode.bytesperline = sd->mode.width;
  191. sd->mode.sizeimage = cam->bulk_size;
  192. sd->mode.colorspace = V4L2_COLORSPACE_SRGB;
  193. /* origGain = gspca_dev->usb_buf[12]; */
  194. cam->cam_mode = &sd->mode;
  195. cam->nmodes = 1;
  196. ret = stv0680_set_video_mode(gspca_dev, sd->orig_mode);
  197. if (ret < 0)
  198. return ret;
  199. if (stv_sndctrl(gspca_dev, 2, 0x06, 0x0100, 0x12) != 0x12 ||
  200. gspca_dev->usb_buf[8] != 0x53 || gspca_dev->usb_buf[9] != 0x05) {
  201. pr_err("Could not get descriptor 0100\n");
  202. return stv0680_handle_error(gspca_dev, -EIO);
  203. }
  204. return 0;
  205. }
  206. /* this function is called at probe and resume time */
  207. static int sd_init(struct gspca_dev *gspca_dev)
  208. {
  209. return 0;
  210. }
  211. /* -- start the camera -- */
  212. static int sd_start(struct gspca_dev *gspca_dev)
  213. {
  214. int ret;
  215. struct sd *sd = (struct sd *) gspca_dev;
  216. ret = stv0680_set_video_mode(gspca_dev, sd->video_mode);
  217. if (ret < 0)
  218. return ret;
  219. if (stv_sndctrl(gspca_dev, 0, 0x85, 0, 0x10) != 0x10)
  220. return stv0680_handle_error(gspca_dev, -EIO);
  221. /* Start stream at:
  222. 0x0000 = CIF (352x288)
  223. 0x0100 = VGA (640x480)
  224. 0x0300 = QVGA (320x240) */
  225. if (stv_sndctrl(gspca_dev, 1, 0x09, sd->video_mode << 8, 0x0) != 0x0)
  226. return stv0680_handle_error(gspca_dev, -EIO);
  227. return 0;
  228. }
  229. static void sd_stopN(struct gspca_dev *gspca_dev)
  230. {
  231. /* This is a high priority command; it stops all lower order cmds */
  232. if (stv_sndctrl(gspca_dev, 1, 0x04, 0x0000, 0x0) != 0x0)
  233. stv0680_handle_error(gspca_dev, -EIO);
  234. }
  235. static void sd_stop0(struct gspca_dev *gspca_dev)
  236. {
  237. struct sd *sd = (struct sd *) gspca_dev;
  238. if (!sd->gspca_dev.present)
  239. return;
  240. stv0680_set_video_mode(gspca_dev, sd->orig_mode);
  241. }
  242. static void sd_pkt_scan(struct gspca_dev *gspca_dev,
  243. u8 *data,
  244. int len)
  245. {
  246. struct sd *sd = (struct sd *) gspca_dev;
  247. /* Every now and then the camera sends a 16 byte packet, no idea
  248. what it contains, but it is not image data, when this
  249. happens the frame received before this packet is corrupt,
  250. so discard it. */
  251. if (len != sd->mode.sizeimage) {
  252. gspca_dev->last_packet_type = DISCARD_PACKET;
  253. return;
  254. }
  255. /* Finish the previous frame, we do this upon reception of the next
  256. packet, even though it is already complete so that the strange 16
  257. byte packets send after a corrupt frame can discard it. */
  258. gspca_frame_add(gspca_dev, LAST_PACKET, NULL, 0);
  259. /* Store the just received frame */
  260. gspca_frame_add(gspca_dev, FIRST_PACKET, data, len);
  261. }
  262. /* sub-driver description */
  263. static const struct sd_desc sd_desc = {
  264. .name = MODULE_NAME,
  265. .ctrls = sd_ctrls,
  266. .nctrls = ARRAY_SIZE(sd_ctrls),
  267. .config = sd_config,
  268. .init = sd_init,
  269. .start = sd_start,
  270. .stopN = sd_stopN,
  271. .stop0 = sd_stop0,
  272. .pkt_scan = sd_pkt_scan,
  273. };
  274. /* -- module initialisation -- */
  275. static const struct usb_device_id device_table[] = {
  276. {USB_DEVICE(0x0553, 0x0202)},
  277. {USB_DEVICE(0x041e, 0x4007)},
  278. {}
  279. };
  280. MODULE_DEVICE_TABLE(usb, device_table);
  281. /* -- device connect -- */
  282. static int sd_probe(struct usb_interface *intf,
  283. const struct usb_device_id *id)
  284. {
  285. return gspca_dev_probe(intf, id, &sd_desc, sizeof(struct sd),
  286. THIS_MODULE);
  287. }
  288. static struct usb_driver sd_driver = {
  289. .name = MODULE_NAME,
  290. .id_table = device_table,
  291. .probe = sd_probe,
  292. .disconnect = gspca_disconnect,
  293. #ifdef CONFIG_PM
  294. .suspend = gspca_suspend,
  295. .resume = gspca_resume,
  296. #endif
  297. };
  298. module_usb_driver(sd_driver);