stv0680.c 9.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353
  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. static int stv_sndctrl(struct gspca_dev *gspca_dev, int set, u8 req, u16 val,
  44. int size)
  45. {
  46. int ret = -1;
  47. u8 req_type = 0;
  48. unsigned int pipe = 0;
  49. switch (set) {
  50. case 0: /* 0xc1 */
  51. req_type = USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_ENDPOINT;
  52. pipe = usb_rcvctrlpipe(gspca_dev->dev, 0);
  53. break;
  54. case 1: /* 0x41 */
  55. req_type = USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_ENDPOINT;
  56. pipe = usb_sndctrlpipe(gspca_dev->dev, 0);
  57. break;
  58. case 2: /* 0x80 */
  59. req_type = USB_DIR_IN | USB_RECIP_DEVICE;
  60. pipe = usb_rcvctrlpipe(gspca_dev->dev, 0);
  61. break;
  62. case 3: /* 0x40 */
  63. req_type = USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE;
  64. pipe = usb_sndctrlpipe(gspca_dev->dev, 0);
  65. break;
  66. }
  67. ret = usb_control_msg(gspca_dev->dev, pipe,
  68. req, req_type,
  69. val, 0, gspca_dev->usb_buf, size, 500);
  70. if ((ret < 0) && (req != 0x0a))
  71. pr_err("usb_control_msg error %i, request = 0x%x, error = %i\n",
  72. set, req, ret);
  73. return ret;
  74. }
  75. static int stv0680_handle_error(struct gspca_dev *gspca_dev, int ret)
  76. {
  77. stv_sndctrl(gspca_dev, 0, 0x80, 0, 0x02); /* Get Last Error */
  78. PERR("last error: %i, command = 0x%x",
  79. gspca_dev->usb_buf[0], gspca_dev->usb_buf[1]);
  80. return ret;
  81. }
  82. static int stv0680_get_video_mode(struct gspca_dev *gspca_dev)
  83. {
  84. /* Note not sure if this init of usb_buf is really necessary */
  85. memset(gspca_dev->usb_buf, 0, 8);
  86. gspca_dev->usb_buf[0] = 0x0f;
  87. if (stv_sndctrl(gspca_dev, 0, 0x87, 0, 0x08) != 0x08) {
  88. PERR("Get_Camera_Mode failed");
  89. return stv0680_handle_error(gspca_dev, -EIO);
  90. }
  91. return gspca_dev->usb_buf[0]; /* 01 = VGA, 03 = QVGA, 00 = CIF */
  92. }
  93. static int stv0680_set_video_mode(struct gspca_dev *gspca_dev, u8 mode)
  94. {
  95. struct sd *sd = (struct sd *) gspca_dev;
  96. if (sd->current_mode == mode)
  97. return 0;
  98. memset(gspca_dev->usb_buf, 0, 8);
  99. gspca_dev->usb_buf[0] = mode;
  100. if (stv_sndctrl(gspca_dev, 3, 0x07, 0x0100, 0x08) != 0x08) {
  101. PERR("Set_Camera_Mode failed");
  102. return stv0680_handle_error(gspca_dev, -EIO);
  103. }
  104. /* Verify we got what we've asked for */
  105. if (stv0680_get_video_mode(gspca_dev) != mode) {
  106. PERR("Error setting camera video mode!");
  107. return -EIO;
  108. }
  109. sd->current_mode = mode;
  110. return 0;
  111. }
  112. /* this function is called at probe time */
  113. static int sd_config(struct gspca_dev *gspca_dev,
  114. const struct usb_device_id *id)
  115. {
  116. int ret;
  117. struct sd *sd = (struct sd *) gspca_dev;
  118. struct cam *cam = &gspca_dev->cam;
  119. /* Give the camera some time to settle, otherwise initialization will
  120. fail on hotplug, and yes it really needs a full second. */
  121. msleep(1000);
  122. /* ping camera to be sure STV0680 is present */
  123. if (stv_sndctrl(gspca_dev, 0, 0x88, 0x5678, 0x02) != 0x02 ||
  124. gspca_dev->usb_buf[0] != 0x56 || gspca_dev->usb_buf[1] != 0x78) {
  125. PERR("STV(e): camera ping failed!!");
  126. return stv0680_handle_error(gspca_dev, -ENODEV);
  127. }
  128. /* get camera descriptor */
  129. if (stv_sndctrl(gspca_dev, 2, 0x06, 0x0200, 0x09) != 0x09)
  130. return stv0680_handle_error(gspca_dev, -ENODEV);
  131. if (stv_sndctrl(gspca_dev, 2, 0x06, 0x0200, 0x22) != 0x22 ||
  132. gspca_dev->usb_buf[7] != 0xa0 || gspca_dev->usb_buf[8] != 0x23) {
  133. PERR("Could not get descriptor 0200.");
  134. return stv0680_handle_error(gspca_dev, -ENODEV);
  135. }
  136. if (stv_sndctrl(gspca_dev, 0, 0x8a, 0, 0x02) != 0x02)
  137. return stv0680_handle_error(gspca_dev, -ENODEV);
  138. if (stv_sndctrl(gspca_dev, 0, 0x8b, 0, 0x24) != 0x24)
  139. return stv0680_handle_error(gspca_dev, -ENODEV);
  140. if (stv_sndctrl(gspca_dev, 0, 0x85, 0, 0x10) != 0x10)
  141. return stv0680_handle_error(gspca_dev, -ENODEV);
  142. if (!(gspca_dev->usb_buf[7] & 0x09)) {
  143. PERR("Camera supports neither CIF nor QVGA mode");
  144. return -ENODEV;
  145. }
  146. if (gspca_dev->usb_buf[7] & 0x01)
  147. PDEBUG(D_PROBE, "Camera supports CIF mode");
  148. if (gspca_dev->usb_buf[7] & 0x02)
  149. PDEBUG(D_PROBE, "Camera supports VGA mode");
  150. if (gspca_dev->usb_buf[7] & 0x04)
  151. PDEBUG(D_PROBE, "Camera supports QCIF mode");
  152. if (gspca_dev->usb_buf[7] & 0x08)
  153. PDEBUG(D_PROBE, "Camera supports QVGA mode");
  154. if (gspca_dev->usb_buf[7] & 0x01)
  155. sd->video_mode = 0x00; /* CIF */
  156. else
  157. sd->video_mode = 0x03; /* QVGA */
  158. /* FW rev, ASIC rev, sensor ID */
  159. PDEBUG(D_PROBE, "Firmware rev is %i.%i",
  160. gspca_dev->usb_buf[0], gspca_dev->usb_buf[1]);
  161. PDEBUG(D_PROBE, "ASIC rev is %i.%i",
  162. gspca_dev->usb_buf[2], gspca_dev->usb_buf[3]);
  163. PDEBUG(D_PROBE, "Sensor ID is %i",
  164. (gspca_dev->usb_buf[4]*16) + (gspca_dev->usb_buf[5]>>4));
  165. ret = stv0680_get_video_mode(gspca_dev);
  166. if (ret < 0)
  167. return ret;
  168. sd->current_mode = sd->orig_mode = ret;
  169. ret = stv0680_set_video_mode(gspca_dev, sd->video_mode);
  170. if (ret < 0)
  171. return ret;
  172. /* Get mode details */
  173. if (stv_sndctrl(gspca_dev, 0, 0x8f, 0, 0x10) != 0x10)
  174. return stv0680_handle_error(gspca_dev, -EIO);
  175. cam->bulk = 1;
  176. cam->bulk_nurbs = 1; /* The cam cannot handle more */
  177. cam->bulk_size = (gspca_dev->usb_buf[0] << 24) |
  178. (gspca_dev->usb_buf[1] << 16) |
  179. (gspca_dev->usb_buf[2] << 8) |
  180. (gspca_dev->usb_buf[3]);
  181. sd->mode.width = (gspca_dev->usb_buf[4] << 8) |
  182. (gspca_dev->usb_buf[5]); /* 322, 356, 644 */
  183. sd->mode.height = (gspca_dev->usb_buf[6] << 8) |
  184. (gspca_dev->usb_buf[7]); /* 242, 292, 484 */
  185. sd->mode.pixelformat = V4L2_PIX_FMT_STV0680;
  186. sd->mode.field = V4L2_FIELD_NONE;
  187. sd->mode.bytesperline = sd->mode.width;
  188. sd->mode.sizeimage = cam->bulk_size;
  189. sd->mode.colorspace = V4L2_COLORSPACE_SRGB;
  190. /* origGain = gspca_dev->usb_buf[12]; */
  191. cam->cam_mode = &sd->mode;
  192. cam->nmodes = 1;
  193. ret = stv0680_set_video_mode(gspca_dev, sd->orig_mode);
  194. if (ret < 0)
  195. return ret;
  196. if (stv_sndctrl(gspca_dev, 2, 0x06, 0x0100, 0x12) != 0x12 ||
  197. gspca_dev->usb_buf[8] != 0x53 || gspca_dev->usb_buf[9] != 0x05) {
  198. pr_err("Could not get descriptor 0100\n");
  199. return stv0680_handle_error(gspca_dev, -EIO);
  200. }
  201. return 0;
  202. }
  203. /* this function is called at probe and resume time */
  204. static int sd_init(struct gspca_dev *gspca_dev)
  205. {
  206. return 0;
  207. }
  208. /* -- start the camera -- */
  209. static int sd_start(struct gspca_dev *gspca_dev)
  210. {
  211. int ret;
  212. struct sd *sd = (struct sd *) gspca_dev;
  213. ret = stv0680_set_video_mode(gspca_dev, sd->video_mode);
  214. if (ret < 0)
  215. return ret;
  216. if (stv_sndctrl(gspca_dev, 0, 0x85, 0, 0x10) != 0x10)
  217. return stv0680_handle_error(gspca_dev, -EIO);
  218. /* Start stream at:
  219. 0x0000 = CIF (352x288)
  220. 0x0100 = VGA (640x480)
  221. 0x0300 = QVGA (320x240) */
  222. if (stv_sndctrl(gspca_dev, 1, 0x09, sd->video_mode << 8, 0x0) != 0x0)
  223. return stv0680_handle_error(gspca_dev, -EIO);
  224. return 0;
  225. }
  226. static void sd_stopN(struct gspca_dev *gspca_dev)
  227. {
  228. /* This is a high priority command; it stops all lower order cmds */
  229. if (stv_sndctrl(gspca_dev, 1, 0x04, 0x0000, 0x0) != 0x0)
  230. stv0680_handle_error(gspca_dev, -EIO);
  231. }
  232. static void sd_stop0(struct gspca_dev *gspca_dev)
  233. {
  234. struct sd *sd = (struct sd *) gspca_dev;
  235. if (!sd->gspca_dev.present)
  236. return;
  237. stv0680_set_video_mode(gspca_dev, sd->orig_mode);
  238. }
  239. static void sd_pkt_scan(struct gspca_dev *gspca_dev,
  240. u8 *data,
  241. int len)
  242. {
  243. struct sd *sd = (struct sd *) gspca_dev;
  244. /* Every now and then the camera sends a 16 byte packet, no idea
  245. what it contains, but it is not image data, when this
  246. happens the frame received before this packet is corrupt,
  247. so discard it. */
  248. if (len != sd->mode.sizeimage) {
  249. gspca_dev->last_packet_type = DISCARD_PACKET;
  250. return;
  251. }
  252. /* Finish the previous frame, we do this upon reception of the next
  253. packet, even though it is already complete so that the strange 16
  254. byte packets send after a corrupt frame can discard it. */
  255. gspca_frame_add(gspca_dev, LAST_PACKET, NULL, 0);
  256. /* Store the just received frame */
  257. gspca_frame_add(gspca_dev, FIRST_PACKET, data, len);
  258. }
  259. /* sub-driver description */
  260. static const struct sd_desc sd_desc = {
  261. .name = MODULE_NAME,
  262. .config = sd_config,
  263. .init = sd_init,
  264. .start = sd_start,
  265. .stopN = sd_stopN,
  266. .stop0 = sd_stop0,
  267. .pkt_scan = sd_pkt_scan,
  268. };
  269. /* -- module initialisation -- */
  270. static const struct usb_device_id device_table[] = {
  271. {USB_DEVICE(0x0553, 0x0202)},
  272. {USB_DEVICE(0x041e, 0x4007)},
  273. {}
  274. };
  275. MODULE_DEVICE_TABLE(usb, device_table);
  276. /* -- device connect -- */
  277. static int sd_probe(struct usb_interface *intf,
  278. const struct usb_device_id *id)
  279. {
  280. return gspca_dev_probe(intf, id, &sd_desc, sizeof(struct sd),
  281. THIS_MODULE);
  282. }
  283. static struct usb_driver sd_driver = {
  284. .name = MODULE_NAME,
  285. .id_table = device_table,
  286. .probe = sd_probe,
  287. .disconnect = gspca_disconnect,
  288. #ifdef CONFIG_PM
  289. .suspend = gspca_suspend,
  290. .resume = gspca_resume,
  291. .reset_resume = gspca_resume,
  292. #endif
  293. };
  294. module_usb_driver(sd_driver);