2 * ov534-ov7xxx gspca driver
4 * Copyright (C) 2008 Antonio Ospite <ospite@studenti.unina.it>
5 * Copyright (C) 2008 Jim Paris <jim@jtan.com>
6 * Copyright (C) 2009 Jean-Francois Moine http://moinejf.free.fr
8 * Based on a prototype written by Mark Ferrell <majortrips@gmail.com>
9 * USB protocol reverse engineered by Jim Paris <jim@jtan.com>
10 * https://jim.sh/svn/jim/devl/playstation/ps3/eye/test/
12 * PS3 Eye camera enhanced by Richard Kaswy http://kaswy.free.fr
13 * PS3 Eye camera - brightness, contrast, awb, agc, aec controls
14 * added by Max Thrun <bear24rw@gmail.com>
15 * PS3 Eye camera - FPS range extended by Joseph Howse
16 * <josephhowse@nummist.com> http://nummist.com
18 * This program is free software; you can redistribute it and/or modify
19 * it under the terms of the GNU General Public License as published by
20 * the Free Software Foundation; either version 2 of the License, or
23 * This program is distributed in the hope that it will be useful,
24 * but WITHOUT ANY WARRANTY; without even the implied warranty of
25 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
26 * GNU General Public License for more details.
28 * You should have received a copy of the GNU General Public License
29 * along with this program; if not, write to the Free Software
30 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
33 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
35 #define MODULE_NAME "ov534"
39 #include <linux/fixp-arith.h>
40 #include <media/v4l2-ctrls.h>
42 #define OV534_REG_ADDRESS 0xf1 /* sensor address */
43 #define OV534_REG_SUBADDR 0xf2
44 #define OV534_REG_WRITE 0xf3
45 #define OV534_REG_READ 0xf4
46 #define OV534_REG_OPERATION 0xf5
47 #define OV534_REG_STATUS 0xf6
49 #define OV534_OP_WRITE_3 0x37
50 #define OV534_OP_WRITE_2 0x33
51 #define OV534_OP_READ_2 0xf9
53 #define CTRL_TIMEOUT 500
54 #define DEFAULT_FRAME_RATE 30
56 MODULE_AUTHOR("Antonio Ospite <ospite@studenti.unina.it>");
57 MODULE_DESCRIPTION("GSPCA/OV534 USB Camera Driver");
58 MODULE_LICENSE("GPL");
60 /* specific webcam descriptor */
62 struct gspca_dev gspca_dev; /* !! must be the first item */
64 struct v4l2_ctrl_handler ctrl_handler;
65 struct v4l2_ctrl *hue;
66 struct v4l2_ctrl *saturation;
67 struct v4l2_ctrl *brightness;
68 struct v4l2_ctrl *contrast;
69 struct { /* gain control cluster */
70 struct v4l2_ctrl *autogain;
71 struct v4l2_ctrl *gain;
73 struct v4l2_ctrl *autowhitebalance;
74 struct { /* exposure control cluster */
75 struct v4l2_ctrl *autoexposure;
76 struct v4l2_ctrl *exposure;
78 struct v4l2_ctrl *sharpness;
79 struct v4l2_ctrl *hflip;
80 struct v4l2_ctrl *vflip;
81 struct v4l2_ctrl *plfreq;
95 static int sd_start(struct gspca_dev *gspca_dev);
96 static void sd_stopN(struct gspca_dev *gspca_dev);
99 static const struct v4l2_pix_format ov772x_mode[] = {
100 {320, 240, V4L2_PIX_FMT_YUYV, V4L2_FIELD_NONE,
101 .bytesperline = 320 * 2,
102 .sizeimage = 320 * 240 * 2,
103 .colorspace = V4L2_COLORSPACE_SRGB,
105 {640, 480, V4L2_PIX_FMT_YUYV, V4L2_FIELD_NONE,
106 .bytesperline = 640 * 2,
107 .sizeimage = 640 * 480 * 2,
108 .colorspace = V4L2_COLORSPACE_SRGB,
111 static const struct v4l2_pix_format ov767x_mode[] = {
112 {320, 240, V4L2_PIX_FMT_JPEG, V4L2_FIELD_NONE,
114 .sizeimage = 320 * 240 * 3 / 8 + 590,
115 .colorspace = V4L2_COLORSPACE_JPEG},
116 {640, 480, V4L2_PIX_FMT_JPEG, V4L2_FIELD_NONE,
118 .sizeimage = 640 * 480 * 3 / 8 + 590,
119 .colorspace = V4L2_COLORSPACE_JPEG},
122 static const u8 qvga_rates[] = {187, 150, 137, 125, 100, 75, 60, 50, 37, 30};
123 static const u8 vga_rates[] = {60, 50, 40, 30, 15};
125 static const struct framerates ov772x_framerates[] = {
128 .nrates = ARRAY_SIZE(qvga_rates),
132 .nrates = ARRAY_SIZE(vga_rates),
141 static const u8 bridge_init_767x[][2] = {
142 /* comments from the ms-win file apollo7670.set */
172 {0xc0, 0x50}, /* HSize 640 */
173 {0xc1, 0x3c}, /* VSize 480 */
174 {0x34, 0x05}, /* enable Audio Suspend mode */
175 {0xc2, 0x0c}, /* Input YUV */
176 {0xc3, 0xf9}, /* enable PRE */
177 {0x34, 0x05}, /* enable Audio Suspend mode */
178 {0xe7, 0x2e}, /* this solves failure of "SuspendResumeTest" */
179 {0x31, 0xf9}, /* enable 1.8V Suspend */
180 {0x35, 0x02}, /* turn on JPEG */
182 {0x25, 0x42}, /* GPIO[8]:Input */
183 {0x94, 0x11}, /* If the default setting is loaded when
184 * system boots up, this flag is closed here */
186 static const u8 sensor_init_767x[][2] = {
204 {0x7a, 0x2a}, /* set Gamma=1.6 below */
224 {0x14, 0x38}, /* gain max 16x */
304 {0x41, 0x38}, /* jfm: auto sharpness + auto de-noise */
308 {0xa4, 0x8a}, /* Night mode trigger point */
341 static const u8 bridge_start_vga_767x[][2] = {
349 {0x35, 0x02}, /* turn on JPEG */
351 {0xda, 0x00}, /* for higher clock rate(30fps) */
352 {0x34, 0x05}, /* enable Audio Suspend mode */
353 {0xc3, 0xf9}, /* enable PRE */
354 {0x8c, 0x00}, /* CIF VSize LSB[2:0] */
355 {0x8d, 0x1c}, /* output YUV */
356 /* {0x34, 0x05}, * enable Audio Suspend mode (?) */
357 {0x50, 0x00}, /* H/V divider=0 */
358 {0x51, 0xa0}, /* input H=640/4 */
359 {0x52, 0x3c}, /* input V=480/4 */
360 {0x53, 0x00}, /* offset X=0 */
361 {0x54, 0x00}, /* offset Y=0 */
362 {0x55, 0x00}, /* H/V size[8]=0 */
363 {0x57, 0x00}, /* H-size[9]=0 */
364 {0x5c, 0x00}, /* output size[9:8]=0 */
365 {0x5a, 0xa0}, /* output H=640/4 */
366 {0x5b, 0x78}, /* output V=480/4 */
371 static const u8 sensor_start_vga_767x[][2] = {
377 static const u8 bridge_start_qvga_767x[][2] = {
385 {0x35, 0x02}, /* turn on JPEG */
387 {0xc0, 0x50}, /* CIF HSize 640 */
388 {0xc1, 0x3c}, /* CIF VSize 480 */
389 {0x8c, 0x00}, /* CIF VSize LSB[2:0] */
390 {0x8d, 0x1c}, /* output YUV */
391 {0x34, 0x05}, /* enable Audio Suspend mode */
392 {0xc2, 0x4c}, /* output YUV and Enable DCW */
393 {0xc3, 0xf9}, /* enable PRE */
394 {0x1c, 0x00}, /* indirect addressing */
395 {0x1d, 0x48}, /* output YUV422 */
396 {0x50, 0x89}, /* H/V divider=/2; plus DCW AVG */
397 {0x51, 0xa0}, /* DCW input H=640/4 */
398 {0x52, 0x78}, /* DCW input V=480/4 */
399 {0x53, 0x00}, /* offset X=0 */
400 {0x54, 0x00}, /* offset Y=0 */
401 {0x55, 0x00}, /* H/V size[8]=0 */
402 {0x57, 0x00}, /* H-size[9]=0 */
403 {0x5c, 0x00}, /* DCW output size[9:8]=0 */
404 {0x5a, 0x50}, /* DCW output H=320/4 */
405 {0x5b, 0x3c}, /* DCW output V=240/4 */
410 static const u8 sensor_start_qvga_767x[][2] = {
417 static const u8 bridge_init_772x[][2] = {
456 { 0x1d, 0x02 }, /* payload size 0x0200 * 4 = 2048 bytes */
457 { 0x1d, 0x00 }, /* payload size */
459 { 0x1d, 0x02 }, /* frame size 0x025800 * 4 = 614400 */
460 { 0x1d, 0x58 }, /* frame size */
461 { 0x1d, 0x00 }, /* frame size */
464 { 0x1d, 0x08 }, /* turn on UVC header */
465 { 0x1d, 0x0e }, /* .. */
475 static const u8 sensor_init_772x[][2] = {
478 /*fixme: better have a delay?*/
501 { 0x63, 0xaa }, /* AWB - was e0 */
504 { 0x13, 0xf0 }, /* com8 */
517 { 0x13, 0xff }, /* AWB */
565 { 0x8e, 0x00 }, /* De-noise threshold */
568 static const u8 bridge_start_vga_772x[][2] = {
579 static const u8 sensor_start_vga_772x[][2] = {
589 static const u8 bridge_start_qvga_772x[][2] = {
600 static const u8 sensor_start_qvga_772x[][2] = {
611 static void ov534_reg_write(struct gspca_dev *gspca_dev, u16 reg, u8 val)
613 struct usb_device *udev = gspca_dev->dev;
616 if (gspca_dev->usb_err < 0)
619 PDEBUG(D_USBO, "SET 01 0000 %04x %02x", reg, val);
620 gspca_dev->usb_buf[0] = val;
621 ret = usb_control_msg(udev,
622 usb_sndctrlpipe(udev, 0),
624 USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
625 0x00, reg, gspca_dev->usb_buf, 1, CTRL_TIMEOUT);
627 pr_err("write failed %d\n", ret);
628 gspca_dev->usb_err = ret;
632 static u8 ov534_reg_read(struct gspca_dev *gspca_dev, u16 reg)
634 struct usb_device *udev = gspca_dev->dev;
637 if (gspca_dev->usb_err < 0)
639 ret = usb_control_msg(udev,
640 usb_rcvctrlpipe(udev, 0),
642 USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
643 0x00, reg, gspca_dev->usb_buf, 1, CTRL_TIMEOUT);
644 PDEBUG(D_USBI, "GET 01 0000 %04x %02x", reg, gspca_dev->usb_buf[0]);
646 pr_err("read failed %d\n", ret);
647 gspca_dev->usb_err = ret;
649 * Make sure the result is zeroed to avoid uninitialized
652 gspca_dev->usb_buf[0] = 0;
654 return gspca_dev->usb_buf[0];
657 /* Two bits control LED: 0x21 bit 7 and 0x23 bit 7.
658 * (direction and output)? */
659 static void ov534_set_led(struct gspca_dev *gspca_dev, int status)
663 PDEBUG(D_CONF, "led status: %d", status);
665 data = ov534_reg_read(gspca_dev, 0x21);
667 ov534_reg_write(gspca_dev, 0x21, data);
669 data = ov534_reg_read(gspca_dev, 0x23);
675 ov534_reg_write(gspca_dev, 0x23, data);
678 data = ov534_reg_read(gspca_dev, 0x21);
680 ov534_reg_write(gspca_dev, 0x21, data);
684 static int sccb_check_status(struct gspca_dev *gspca_dev)
689 for (i = 0; i < 5; i++) {
691 data = ov534_reg_read(gspca_dev, OV534_REG_STATUS);
701 PERR("sccb status 0x%02x, attempt %d/5",
708 static void sccb_reg_write(struct gspca_dev *gspca_dev, u8 reg, u8 val)
710 PDEBUG(D_USBO, "sccb write: %02x %02x", reg, val);
711 ov534_reg_write(gspca_dev, OV534_REG_SUBADDR, reg);
712 ov534_reg_write(gspca_dev, OV534_REG_WRITE, val);
713 ov534_reg_write(gspca_dev, OV534_REG_OPERATION, OV534_OP_WRITE_3);
715 if (!sccb_check_status(gspca_dev)) {
716 pr_err("sccb_reg_write failed\n");
717 gspca_dev->usb_err = -EIO;
721 static u8 sccb_reg_read(struct gspca_dev *gspca_dev, u16 reg)
723 ov534_reg_write(gspca_dev, OV534_REG_SUBADDR, reg);
724 ov534_reg_write(gspca_dev, OV534_REG_OPERATION, OV534_OP_WRITE_2);
725 if (!sccb_check_status(gspca_dev))
726 pr_err("sccb_reg_read failed 1\n");
728 ov534_reg_write(gspca_dev, OV534_REG_OPERATION, OV534_OP_READ_2);
729 if (!sccb_check_status(gspca_dev))
730 pr_err("sccb_reg_read failed 2\n");
732 return ov534_reg_read(gspca_dev, OV534_REG_READ);
735 /* output a bridge sequence (reg - val) */
736 static void reg_w_array(struct gspca_dev *gspca_dev,
737 const u8 (*data)[2], int len)
740 ov534_reg_write(gspca_dev, (*data)[0], (*data)[1]);
745 /* output a sensor sequence (reg - val) */
746 static void sccb_w_array(struct gspca_dev *gspca_dev,
747 const u8 (*data)[2], int len)
750 if ((*data)[0] != 0xff) {
751 sccb_reg_write(gspca_dev, (*data)[0], (*data)[1]);
753 sccb_reg_read(gspca_dev, (*data)[1]);
754 sccb_reg_write(gspca_dev, 0xff, 0x00);
760 /* ov772x specific controls */
761 static void set_frame_rate(struct gspca_dev *gspca_dev)
763 struct sd *sd = (struct sd *) gspca_dev;
771 const struct rate_s *r;
772 static const struct rate_s rate_0[] = { /* 640x480 */
773 {60, 0x01, 0xc1, 0x04},
774 {50, 0x01, 0x41, 0x02},
775 {40, 0x02, 0xc1, 0x04},
776 {30, 0x04, 0x81, 0x02},
777 {15, 0x03, 0x41, 0x04},
779 static const struct rate_s rate_1[] = { /* 320x240 */
780 /* {205, 0x01, 0xc1, 0x02}, * 205 FPS: video is partly corrupt */
781 {187, 0x01, 0x81, 0x02}, /* 187 FPS or below: video is valid */
782 {150, 0x01, 0xc1, 0x04},
783 {137, 0x02, 0xc1, 0x02},
784 {125, 0x02, 0x81, 0x02},
785 {100, 0x02, 0xc1, 0x04},
786 {75, 0x03, 0xc1, 0x04},
787 {60, 0x04, 0xc1, 0x04},
788 {50, 0x02, 0x41, 0x04},
789 {37, 0x03, 0x41, 0x04},
790 {30, 0x04, 0x41, 0x04},
793 if (sd->sensor != SENSOR_OV772x)
795 if (gspca_dev->cam.cam_mode[gspca_dev->curr_mode].priv == 0) {
797 i = ARRAY_SIZE(rate_0);
800 i = ARRAY_SIZE(rate_1);
803 if (sd->frame_rate >= r->fps)
808 sccb_reg_write(gspca_dev, 0x11, r->r11);
809 sccb_reg_write(gspca_dev, 0x0d, r->r0d);
810 ov534_reg_write(gspca_dev, 0xe5, r->re5);
812 PDEBUG(D_PROBE, "frame_rate: %d", r->fps);
815 static void sethue(struct gspca_dev *gspca_dev, s32 val)
817 struct sd *sd = (struct sd *) gspca_dev;
819 if (sd->sensor == SENSOR_OV767x) {
825 /* According to the datasheet the registers expect HUESIN and
826 * HUECOS to be the result of the trigonometric functions,
829 * The 0x7fff here represents the maximum absolute value
830 * returned byt fixp_sin and fixp_cos, so the scaling will
831 * consider the result like in the interval [-1.0, 1.0].
833 huesin = fixp_sin16(val) * 0x80 / 0x7fff;
834 huecos = fixp_cos16(val) * 0x80 / 0x7fff;
837 sccb_reg_write(gspca_dev, 0xab,
838 sccb_reg_read(gspca_dev, 0xab) | 0x2);
841 sccb_reg_write(gspca_dev, 0xab,
842 sccb_reg_read(gspca_dev, 0xab) & ~0x2);
845 sccb_reg_write(gspca_dev, 0xa9, (u8)huecos);
846 sccb_reg_write(gspca_dev, 0xaa, (u8)huesin);
850 static void setsaturation(struct gspca_dev *gspca_dev, s32 val)
852 struct sd *sd = (struct sd *) gspca_dev;
854 if (sd->sensor == SENSOR_OV767x) {
856 static u8 color_tb[][6] = {
857 {0x42, 0x42, 0x00, 0x11, 0x30, 0x41},
858 {0x52, 0x52, 0x00, 0x16, 0x3c, 0x52},
859 {0x66, 0x66, 0x00, 0x1b, 0x4b, 0x66},
860 {0x80, 0x80, 0x00, 0x22, 0x5e, 0x80},
861 {0x9a, 0x9a, 0x00, 0x29, 0x71, 0x9a},
862 {0xb8, 0xb8, 0x00, 0x31, 0x87, 0xb8},
863 {0xdd, 0xdd, 0x00, 0x3b, 0xa2, 0xdd},
866 for (i = 0; i < ARRAY_SIZE(color_tb[0]); i++)
867 sccb_reg_write(gspca_dev, 0x4f + i, color_tb[val][i]);
869 sccb_reg_write(gspca_dev, 0xa7, val); /* U saturation */
870 sccb_reg_write(gspca_dev, 0xa8, val); /* V saturation */
874 static void setbrightness(struct gspca_dev *gspca_dev, s32 val)
876 struct sd *sd = (struct sd *) gspca_dev;
878 if (sd->sensor == SENSOR_OV767x) {
881 sccb_reg_write(gspca_dev, 0x55, val); /* bright */
883 sccb_reg_write(gspca_dev, 0x9b, val);
887 static void setcontrast(struct gspca_dev *gspca_dev, s32 val)
889 struct sd *sd = (struct sd *) gspca_dev;
891 if (sd->sensor == SENSOR_OV767x)
892 sccb_reg_write(gspca_dev, 0x56, val); /* contras */
894 sccb_reg_write(gspca_dev, 0x9c, val);
897 static void setgain(struct gspca_dev *gspca_dev, s32 val)
899 switch (val & 0x30) {
917 sccb_reg_write(gspca_dev, 0x00, val);
920 static s32 getgain(struct gspca_dev *gspca_dev)
922 return sccb_reg_read(gspca_dev, 0x00);
925 static void setexposure(struct gspca_dev *gspca_dev, s32 val)
927 struct sd *sd = (struct sd *) gspca_dev;
929 if (sd->sensor == SENSOR_OV767x) {
931 /* set only aec[9:2] */
932 sccb_reg_write(gspca_dev, 0x10, val); /* aech */
935 /* 'val' is one byte and represents half of the exposure value
936 * we are going to set into registers, a two bytes value:
938 * MSB: ((u16) val << 1) >> 8 == val >> 7
939 * LSB: ((u16) val << 1) & 0xff == val << 1
941 sccb_reg_write(gspca_dev, 0x08, val >> 7);
942 sccb_reg_write(gspca_dev, 0x10, val << 1);
946 static s32 getexposure(struct gspca_dev *gspca_dev)
948 struct sd *sd = (struct sd *) gspca_dev;
950 if (sd->sensor == SENSOR_OV767x) {
951 /* get only aec[9:2] */
952 return sccb_reg_read(gspca_dev, 0x10); /* aech */
954 u8 hi = sccb_reg_read(gspca_dev, 0x08);
955 u8 lo = sccb_reg_read(gspca_dev, 0x10);
956 return (hi << 8 | lo) >> 1;
960 static void setagc(struct gspca_dev *gspca_dev, s32 val)
963 sccb_reg_write(gspca_dev, 0x13,
964 sccb_reg_read(gspca_dev, 0x13) | 0x04);
965 sccb_reg_write(gspca_dev, 0x64,
966 sccb_reg_read(gspca_dev, 0x64) | 0x03);
968 sccb_reg_write(gspca_dev, 0x13,
969 sccb_reg_read(gspca_dev, 0x13) & ~0x04);
970 sccb_reg_write(gspca_dev, 0x64,
971 sccb_reg_read(gspca_dev, 0x64) & ~0x03);
975 static void setawb(struct gspca_dev *gspca_dev, s32 val)
977 struct sd *sd = (struct sd *) gspca_dev;
980 sccb_reg_write(gspca_dev, 0x13,
981 sccb_reg_read(gspca_dev, 0x13) | 0x02);
982 if (sd->sensor == SENSOR_OV772x)
983 sccb_reg_write(gspca_dev, 0x63,
984 sccb_reg_read(gspca_dev, 0x63) | 0xc0);
986 sccb_reg_write(gspca_dev, 0x13,
987 sccb_reg_read(gspca_dev, 0x13) & ~0x02);
988 if (sd->sensor == SENSOR_OV772x)
989 sccb_reg_write(gspca_dev, 0x63,
990 sccb_reg_read(gspca_dev, 0x63) & ~0xc0);
994 static void setaec(struct gspca_dev *gspca_dev, s32 val)
996 struct sd *sd = (struct sd *) gspca_dev;
999 data = sd->sensor == SENSOR_OV767x ?
1000 0x05 : /* agc + aec */
1003 case V4L2_EXPOSURE_AUTO:
1004 sccb_reg_write(gspca_dev, 0x13,
1005 sccb_reg_read(gspca_dev, 0x13) | data);
1007 case V4L2_EXPOSURE_MANUAL:
1008 sccb_reg_write(gspca_dev, 0x13,
1009 sccb_reg_read(gspca_dev, 0x13) & ~data);
1014 static void setsharpness(struct gspca_dev *gspca_dev, s32 val)
1016 sccb_reg_write(gspca_dev, 0x91, val); /* Auto de-noise threshold */
1017 sccb_reg_write(gspca_dev, 0x8e, val); /* De-noise threshold */
1020 static void sethvflip(struct gspca_dev *gspca_dev, s32 hflip, s32 vflip)
1022 struct sd *sd = (struct sd *) gspca_dev;
1025 if (sd->sensor == SENSOR_OV767x) {
1026 val = sccb_reg_read(gspca_dev, 0x1e); /* mvfp */
1032 sccb_reg_write(gspca_dev, 0x1e, val);
1034 val = sccb_reg_read(gspca_dev, 0x0c);
1040 sccb_reg_write(gspca_dev, 0x0c, val);
1044 static void setlightfreq(struct gspca_dev *gspca_dev, s32 val)
1046 struct sd *sd = (struct sd *) gspca_dev;
1048 val = val ? 0x9e : 0x00;
1049 if (sd->sensor == SENSOR_OV767x) {
1050 sccb_reg_write(gspca_dev, 0x2a, 0x00);
1052 val = 0x9d; /* insert dummy to 25fps for 50Hz */
1054 sccb_reg_write(gspca_dev, 0x2b, val);
1058 /* this function is called at probe time */
1059 static int sd_config(struct gspca_dev *gspca_dev,
1060 const struct usb_device_id *id)
1062 struct sd *sd = (struct sd *) gspca_dev;
1065 cam = &gspca_dev->cam;
1067 cam->cam_mode = ov772x_mode;
1068 cam->nmodes = ARRAY_SIZE(ov772x_mode);
1070 sd->frame_rate = DEFAULT_FRAME_RATE;
1075 static int ov534_g_volatile_ctrl(struct v4l2_ctrl *ctrl)
1077 struct sd *sd = container_of(ctrl->handler, struct sd, ctrl_handler);
1078 struct gspca_dev *gspca_dev = &sd->gspca_dev;
1081 case V4L2_CID_AUTOGAIN:
1082 gspca_dev->usb_err = 0;
1083 if (ctrl->val && sd->gain && gspca_dev->streaming)
1084 sd->gain->val = getgain(gspca_dev);
1085 return gspca_dev->usb_err;
1087 case V4L2_CID_EXPOSURE_AUTO:
1088 gspca_dev->usb_err = 0;
1089 if (ctrl->val == V4L2_EXPOSURE_AUTO && sd->exposure &&
1090 gspca_dev->streaming)
1091 sd->exposure->val = getexposure(gspca_dev);
1092 return gspca_dev->usb_err;
1097 static int ov534_s_ctrl(struct v4l2_ctrl *ctrl)
1099 struct sd *sd = container_of(ctrl->handler, struct sd, ctrl_handler);
1100 struct gspca_dev *gspca_dev = &sd->gspca_dev;
1102 gspca_dev->usb_err = 0;
1103 if (!gspca_dev->streaming)
1108 sethue(gspca_dev, ctrl->val);
1110 case V4L2_CID_SATURATION:
1111 setsaturation(gspca_dev, ctrl->val);
1113 case V4L2_CID_BRIGHTNESS:
1114 setbrightness(gspca_dev, ctrl->val);
1116 case V4L2_CID_CONTRAST:
1117 setcontrast(gspca_dev, ctrl->val);
1119 case V4L2_CID_AUTOGAIN:
1120 /* case V4L2_CID_GAIN: */
1121 setagc(gspca_dev, ctrl->val);
1122 if (!gspca_dev->usb_err && !ctrl->val && sd->gain)
1123 setgain(gspca_dev, sd->gain->val);
1125 case V4L2_CID_AUTO_WHITE_BALANCE:
1126 setawb(gspca_dev, ctrl->val);
1128 case V4L2_CID_EXPOSURE_AUTO:
1129 /* case V4L2_CID_EXPOSURE: */
1130 setaec(gspca_dev, ctrl->val);
1131 if (!gspca_dev->usb_err && ctrl->val == V4L2_EXPOSURE_MANUAL &&
1133 setexposure(gspca_dev, sd->exposure->val);
1135 case V4L2_CID_SHARPNESS:
1136 setsharpness(gspca_dev, ctrl->val);
1138 case V4L2_CID_HFLIP:
1139 sethvflip(gspca_dev, ctrl->val, sd->vflip->val);
1141 case V4L2_CID_VFLIP:
1142 sethvflip(gspca_dev, sd->hflip->val, ctrl->val);
1144 case V4L2_CID_POWER_LINE_FREQUENCY:
1145 setlightfreq(gspca_dev, ctrl->val);
1148 return gspca_dev->usb_err;
1151 static const struct v4l2_ctrl_ops ov534_ctrl_ops = {
1152 .g_volatile_ctrl = ov534_g_volatile_ctrl,
1153 .s_ctrl = ov534_s_ctrl,
1156 static int sd_init_controls(struct gspca_dev *gspca_dev)
1158 struct sd *sd = (struct sd *) gspca_dev;
1159 struct v4l2_ctrl_handler *hdl = &sd->ctrl_handler;
1160 /* parameters with different values between the supported sensors */
1174 if (sd->sensor == SENSOR_OV767x) {
1178 brightness_min = -127;
1179 brightness_max = 127;
1181 contrast_max = 0x80;
1182 contrast_def = 0x40;
1183 exposure_min = 0x08;
1184 exposure_max = 0x60;
1185 exposure_def = 0x13;
1189 saturation_max = 255,
1190 saturation_def = 64,
1192 brightness_max = 255;
1202 gspca_dev->vdev.ctrl_handler = hdl;
1204 v4l2_ctrl_handler_init(hdl, 13);
1206 if (sd->sensor == SENSOR_OV772x)
1207 sd->hue = v4l2_ctrl_new_std(hdl, &ov534_ctrl_ops,
1208 V4L2_CID_HUE, -90, 90, 1, 0);
1210 sd->saturation = v4l2_ctrl_new_std(hdl, &ov534_ctrl_ops,
1211 V4L2_CID_SATURATION, saturation_min, saturation_max, 1,
1213 sd->brightness = v4l2_ctrl_new_std(hdl, &ov534_ctrl_ops,
1214 V4L2_CID_BRIGHTNESS, brightness_min, brightness_max, 1,
1216 sd->contrast = v4l2_ctrl_new_std(hdl, &ov534_ctrl_ops,
1217 V4L2_CID_CONTRAST, 0, contrast_max, 1, contrast_def);
1219 if (sd->sensor == SENSOR_OV772x) {
1220 sd->autogain = v4l2_ctrl_new_std(hdl, &ov534_ctrl_ops,
1221 V4L2_CID_AUTOGAIN, 0, 1, 1, 1);
1222 sd->gain = v4l2_ctrl_new_std(hdl, &ov534_ctrl_ops,
1223 V4L2_CID_GAIN, 0, 63, 1, 20);
1226 sd->autoexposure = v4l2_ctrl_new_std_menu(hdl, &ov534_ctrl_ops,
1227 V4L2_CID_EXPOSURE_AUTO,
1228 V4L2_EXPOSURE_MANUAL, 0,
1229 V4L2_EXPOSURE_AUTO);
1230 sd->exposure = v4l2_ctrl_new_std(hdl, &ov534_ctrl_ops,
1231 V4L2_CID_EXPOSURE, exposure_min, exposure_max, 1,
1234 sd->autowhitebalance = v4l2_ctrl_new_std(hdl, &ov534_ctrl_ops,
1235 V4L2_CID_AUTO_WHITE_BALANCE, 0, 1, 1, 1);
1237 if (sd->sensor == SENSOR_OV772x)
1238 sd->sharpness = v4l2_ctrl_new_std(hdl, &ov534_ctrl_ops,
1239 V4L2_CID_SHARPNESS, 0, 63, 1, 0);
1241 sd->hflip = v4l2_ctrl_new_std(hdl, &ov534_ctrl_ops,
1242 V4L2_CID_HFLIP, 0, 1, 1, hflip_def);
1243 sd->vflip = v4l2_ctrl_new_std(hdl, &ov534_ctrl_ops,
1244 V4L2_CID_VFLIP, 0, 1, 1, 0);
1245 sd->plfreq = v4l2_ctrl_new_std_menu(hdl, &ov534_ctrl_ops,
1246 V4L2_CID_POWER_LINE_FREQUENCY,
1247 V4L2_CID_POWER_LINE_FREQUENCY_50HZ, 0,
1248 V4L2_CID_POWER_LINE_FREQUENCY_DISABLED);
1251 pr_err("Could not initialize controls\n");
1255 if (sd->sensor == SENSOR_OV772x)
1256 v4l2_ctrl_auto_cluster(2, &sd->autogain, 0, true);
1258 v4l2_ctrl_auto_cluster(2, &sd->autoexposure, V4L2_EXPOSURE_MANUAL,
1264 /* this function is called at probe and resume time */
1265 static int sd_init(struct gspca_dev *gspca_dev)
1267 struct sd *sd = (struct sd *) gspca_dev;
1269 static const struct reg_array bridge_init[NSENSORS] = {
1270 [SENSOR_OV767x] = {bridge_init_767x, ARRAY_SIZE(bridge_init_767x)},
1271 [SENSOR_OV772x] = {bridge_init_772x, ARRAY_SIZE(bridge_init_772x)},
1273 static const struct reg_array sensor_init[NSENSORS] = {
1274 [SENSOR_OV767x] = {sensor_init_767x, ARRAY_SIZE(sensor_init_767x)},
1275 [SENSOR_OV772x] = {sensor_init_772x, ARRAY_SIZE(sensor_init_772x)},
1279 ov534_reg_write(gspca_dev, 0xe7, 0x3a);
1280 ov534_reg_write(gspca_dev, 0xe0, 0x08);
1283 /* initialize the sensor address */
1284 ov534_reg_write(gspca_dev, OV534_REG_ADDRESS, 0x42);
1287 sccb_reg_write(gspca_dev, 0x12, 0x80);
1290 /* probe the sensor */
1291 sccb_reg_read(gspca_dev, 0x0a);
1292 sensor_id = sccb_reg_read(gspca_dev, 0x0a) << 8;
1293 sccb_reg_read(gspca_dev, 0x0b);
1294 sensor_id |= sccb_reg_read(gspca_dev, 0x0b);
1295 PDEBUG(D_PROBE, "Sensor ID: %04x", sensor_id);
1297 if ((sensor_id & 0xfff0) == 0x7670) {
1298 sd->sensor = SENSOR_OV767x;
1299 gspca_dev->cam.cam_mode = ov767x_mode;
1300 gspca_dev->cam.nmodes = ARRAY_SIZE(ov767x_mode);
1302 sd->sensor = SENSOR_OV772x;
1303 gspca_dev->cam.bulk = 1;
1304 gspca_dev->cam.bulk_size = 16384;
1305 gspca_dev->cam.bulk_nurbs = 2;
1306 gspca_dev->cam.mode_framerates = ov772x_framerates;
1310 reg_w_array(gspca_dev, bridge_init[sd->sensor].val,
1311 bridge_init[sd->sensor].len);
1312 ov534_set_led(gspca_dev, 1);
1313 sccb_w_array(gspca_dev, sensor_init[sd->sensor].val,
1314 sensor_init[sd->sensor].len);
1316 sd_stopN(gspca_dev);
1317 /* set_frame_rate(gspca_dev); */
1319 return gspca_dev->usb_err;
1322 static int sd_start(struct gspca_dev *gspca_dev)
1324 struct sd *sd = (struct sd *) gspca_dev;
1326 static const struct reg_array bridge_start[NSENSORS][2] = {
1327 [SENSOR_OV767x] = {{bridge_start_qvga_767x,
1328 ARRAY_SIZE(bridge_start_qvga_767x)},
1329 {bridge_start_vga_767x,
1330 ARRAY_SIZE(bridge_start_vga_767x)}},
1331 [SENSOR_OV772x] = {{bridge_start_qvga_772x,
1332 ARRAY_SIZE(bridge_start_qvga_772x)},
1333 {bridge_start_vga_772x,
1334 ARRAY_SIZE(bridge_start_vga_772x)}},
1336 static const struct reg_array sensor_start[NSENSORS][2] = {
1337 [SENSOR_OV767x] = {{sensor_start_qvga_767x,
1338 ARRAY_SIZE(sensor_start_qvga_767x)},
1339 {sensor_start_vga_767x,
1340 ARRAY_SIZE(sensor_start_vga_767x)}},
1341 [SENSOR_OV772x] = {{sensor_start_qvga_772x,
1342 ARRAY_SIZE(sensor_start_qvga_772x)},
1343 {sensor_start_vga_772x,
1344 ARRAY_SIZE(sensor_start_vga_772x)}},
1347 /* (from ms-win trace) */
1348 if (sd->sensor == SENSOR_OV767x)
1349 sccb_reg_write(gspca_dev, 0x1e, 0x04);
1350 /* black sun enable ? */
1352 mode = gspca_dev->curr_mode; /* 0: 320x240, 1: 640x480 */
1353 reg_w_array(gspca_dev, bridge_start[sd->sensor][mode].val,
1354 bridge_start[sd->sensor][mode].len);
1355 sccb_w_array(gspca_dev, sensor_start[sd->sensor][mode].val,
1356 sensor_start[sd->sensor][mode].len);
1358 set_frame_rate(gspca_dev);
1361 sethue(gspca_dev, v4l2_ctrl_g_ctrl(sd->hue));
1362 setsaturation(gspca_dev, v4l2_ctrl_g_ctrl(sd->saturation));
1364 setagc(gspca_dev, v4l2_ctrl_g_ctrl(sd->autogain));
1365 setawb(gspca_dev, v4l2_ctrl_g_ctrl(sd->autowhitebalance));
1366 setaec(gspca_dev, v4l2_ctrl_g_ctrl(sd->autoexposure));
1368 setgain(gspca_dev, v4l2_ctrl_g_ctrl(sd->gain));
1369 setexposure(gspca_dev, v4l2_ctrl_g_ctrl(sd->exposure));
1370 setbrightness(gspca_dev, v4l2_ctrl_g_ctrl(sd->brightness));
1371 setcontrast(gspca_dev, v4l2_ctrl_g_ctrl(sd->contrast));
1373 setsharpness(gspca_dev, v4l2_ctrl_g_ctrl(sd->sharpness));
1374 sethvflip(gspca_dev, v4l2_ctrl_g_ctrl(sd->hflip),
1375 v4l2_ctrl_g_ctrl(sd->vflip));
1376 setlightfreq(gspca_dev, v4l2_ctrl_g_ctrl(sd->plfreq));
1378 ov534_set_led(gspca_dev, 1);
1379 ov534_reg_write(gspca_dev, 0xe0, 0x00);
1380 return gspca_dev->usb_err;
1383 static void sd_stopN(struct gspca_dev *gspca_dev)
1385 ov534_reg_write(gspca_dev, 0xe0, 0x09);
1386 ov534_set_led(gspca_dev, 0);
1389 /* Values for bmHeaderInfo (Video and Still Image Payload Headers, 2.4.3.3) */
1390 #define UVC_STREAM_EOH (1 << 7)
1391 #define UVC_STREAM_ERR (1 << 6)
1392 #define UVC_STREAM_STI (1 << 5)
1393 #define UVC_STREAM_RES (1 << 4)
1394 #define UVC_STREAM_SCR (1 << 3)
1395 #define UVC_STREAM_PTS (1 << 2)
1396 #define UVC_STREAM_EOF (1 << 1)
1397 #define UVC_STREAM_FID (1 << 0)
1399 static void sd_pkt_scan(struct gspca_dev *gspca_dev,
1402 struct sd *sd = (struct sd *) gspca_dev;
1405 int remaining_len = len;
1408 payload_len = gspca_dev->cam.bulk ? 2048 : 2040;
1410 len = min(remaining_len, payload_len);
1412 /* Payloads are prefixed with a UVC-style header. We
1413 consider a frame to start when the FID toggles, or the PTS
1414 changes. A frame ends when EOF is set, and we've received
1415 the correct number of bytes. */
1417 /* Verify UVC header. Header length is always 12 */
1418 if (data[0] != 12 || len < 12) {
1419 PDEBUG(D_PACK, "bad header");
1424 if (data[1] & UVC_STREAM_ERR) {
1425 PDEBUG(D_PACK, "payload error");
1429 /* Extract PTS and FID */
1430 if (!(data[1] & UVC_STREAM_PTS)) {
1431 PDEBUG(D_PACK, "PTS not present");
1434 this_pts = (data[5] << 24) | (data[4] << 16)
1435 | (data[3] << 8) | data[2];
1436 this_fid = (data[1] & UVC_STREAM_FID) ? 1 : 0;
1438 /* If PTS or FID has changed, start a new frame. */
1439 if (this_pts != sd->last_pts || this_fid != sd->last_fid) {
1440 if (gspca_dev->last_packet_type == INTER_PACKET)
1441 gspca_frame_add(gspca_dev, LAST_PACKET,
1443 sd->last_pts = this_pts;
1444 sd->last_fid = this_fid;
1445 gspca_frame_add(gspca_dev, FIRST_PACKET,
1446 data + 12, len - 12);
1447 /* If this packet is marked as EOF, end the frame */
1448 } else if (data[1] & UVC_STREAM_EOF) {
1450 if (gspca_dev->pixfmt.pixelformat == V4L2_PIX_FMT_YUYV
1451 && gspca_dev->image_len + len - 12 !=
1452 gspca_dev->pixfmt.width *
1453 gspca_dev->pixfmt.height * 2) {
1454 PDEBUG(D_PACK, "wrong sized frame");
1457 gspca_frame_add(gspca_dev, LAST_PACKET,
1458 data + 12, len - 12);
1461 /* Add the data from this payload */
1462 gspca_frame_add(gspca_dev, INTER_PACKET,
1463 data + 12, len - 12);
1466 /* Done this payload */
1470 /* Discard data until a new frame starts. */
1471 gspca_dev->last_packet_type = DISCARD_PACKET;
1474 remaining_len -= len;
1476 } while (remaining_len > 0);
1479 /* get stream parameters (framerate) */
1480 static void sd_get_streamparm(struct gspca_dev *gspca_dev,
1481 struct v4l2_streamparm *parm)
1483 struct v4l2_captureparm *cp = &parm->parm.capture;
1484 struct v4l2_fract *tpf = &cp->timeperframe;
1485 struct sd *sd = (struct sd *) gspca_dev;
1487 cp->capability |= V4L2_CAP_TIMEPERFRAME;
1489 tpf->denominator = sd->frame_rate;
1492 /* set stream parameters (framerate) */
1493 static void sd_set_streamparm(struct gspca_dev *gspca_dev,
1494 struct v4l2_streamparm *parm)
1496 struct v4l2_captureparm *cp = &parm->parm.capture;
1497 struct v4l2_fract *tpf = &cp->timeperframe;
1498 struct sd *sd = (struct sd *) gspca_dev;
1500 if (tpf->numerator == 0 || tpf->denominator == 0)
1501 sd->frame_rate = DEFAULT_FRAME_RATE;
1503 sd->frame_rate = tpf->denominator / tpf->numerator;
1505 if (gspca_dev->streaming)
1506 set_frame_rate(gspca_dev);
1508 /* Return the actual framerate */
1510 tpf->denominator = sd->frame_rate;
1513 /* sub-driver description */
1514 static const struct sd_desc sd_desc = {
1515 .name = MODULE_NAME,
1516 .config = sd_config,
1518 .init_controls = sd_init_controls,
1521 .pkt_scan = sd_pkt_scan,
1522 .get_streamparm = sd_get_streamparm,
1523 .set_streamparm = sd_set_streamparm,
1526 /* -- module initialisation -- */
1527 static const struct usb_device_id device_table[] = {
1528 {USB_DEVICE(0x1415, 0x2000)},
1529 {USB_DEVICE(0x06f8, 0x3002)},
1533 MODULE_DEVICE_TABLE(usb, device_table);
1535 /* -- device connect -- */
1536 static int sd_probe(struct usb_interface *intf, const struct usb_device_id *id)
1538 return gspca_dev_probe(intf, id, &sd_desc, sizeof(struct sd),
1542 static struct usb_driver sd_driver = {
1543 .name = MODULE_NAME,
1544 .id_table = device_table,
1546 .disconnect = gspca_disconnect,
1548 .suspend = gspca_suspend,
1549 .resume = gspca_resume,
1550 .reset_resume = gspca_resume,
1554 module_usb_driver(sd_driver);