release/src-rt-6.x.4708/linux/linux-2.6.36/drivers/media/video/gspca/spca1528.c

   1 /*
   2  * spca1528 subdriver
   3  *
   4  * Copyright (C) 2010 Jean-Francois Moine (http://moinejf.free.fr)
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program; if not, write to the Free Software
  18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  19  */
  20
  21 #define MODULE_NAME "spca1528"
  22
  23 #include "gspca.h"
  24 #include "jpeg.h"
  25
  26 MODULE_AUTHOR("Jean-Francois Moine <http://moinejf.free.fr>");
  27 MODULE_DESCRIPTION("SPCA1528 USB Camera Driver");
  28 MODULE_LICENSE("GPL");
  29
  30 /* specific webcam descriptor */
  31 struct sd {
  32         struct gspca_dev gspca_dev;     /* !! must be the first item */
  33
  34         u8 brightness;
  35         u8 contrast;
  36         u8 hue;
  37         u8 color;
  38         u8 sharpness;
  39
  40         u8 pkt_seq;
  41
  42         u8 jpeg_hdr[JPEG_HDR_SZ];
  43 };
  44
  45 /* V4L2 controls supported by the driver */
  46 static int sd_setbrightness(struct gspca_dev *gspca_dev, __s32 val);
  47 static int sd_getbrightness(struct gspca_dev *gspca_dev, __s32 *val);
  48 static int sd_setcontrast(struct gspca_dev *gspca_dev, __s32 val);
  49 static int sd_getcontrast(struct gspca_dev *gspca_dev, __s32 *val);
  50 static int sd_sethue(struct gspca_dev *gspca_dev, __s32 val);
  51 static int sd_gethue(struct gspca_dev *gspca_dev, __s32 *val);
  52 static int sd_setcolor(struct gspca_dev *gspca_dev, __s32 val);
  53 static int sd_getcolor(struct gspca_dev *gspca_dev, __s32 *val);
  54 static int sd_setsharpness(struct gspca_dev *gspca_dev, __s32 val);
  55 static int sd_getsharpness(struct gspca_dev *gspca_dev, __s32 *val);
  56
  57 static const struct ctrl sd_ctrls[] = {
  58         {
  59             {
  60                 .id      = V4L2_CID_BRIGHTNESS,
  61                 .type    = V4L2_CTRL_TYPE_INTEGER,
  62                 .name    = "Brightness",
  63                 .minimum = 0,
  64                 .maximum = 255,
  65                 .step    = 1,
  66 #define BRIGHTNESS_DEF 128
  67                 .default_value = BRIGHTNESS_DEF,
  68             },
  69             .set = sd_setbrightness,
  70             .get = sd_getbrightness,
  71         },
  72         {
  73             {
  74                 .id      = V4L2_CID_CONTRAST,
  75                 .type    = V4L2_CTRL_TYPE_INTEGER,
  76                 .name    = "Contrast",
  77                 .minimum = 0,
  78                 .maximum = 8,
  79                 .step    = 1,
  80 #define CONTRAST_DEF 1
  81                 .default_value = CONTRAST_DEF,
  82             },
  83             .set = sd_setcontrast,
  84             .get = sd_getcontrast,
  85         },
  86         {
  87             {
  88                 .id      = V4L2_CID_HUE,
  89                 .type    = V4L2_CTRL_TYPE_INTEGER,
  90                 .name    = "Hue",
  91                 .minimum = 0,
  92                 .maximum = 255,
  93                 .step    = 1,
  94 #define HUE_DEF 0
  95                 .default_value = HUE_DEF,
  96             },
  97             .set = sd_sethue,
  98             .get = sd_gethue,
  99         },
 100         {
 101             {
 102                 .id      = V4L2_CID_SATURATION,
 103                 .type    = V4L2_CTRL_TYPE_INTEGER,
 104                 .name    = "Saturation",
 105                 .minimum = 0,
 106                 .maximum = 8,
 107                 .step    = 1,
 108 #define COLOR_DEF 1
 109                 .default_value = COLOR_DEF,
 110             },
 111             .set = sd_setcolor,
 112             .get = sd_getcolor,
 113         },
 114         {
 115             {
 116                 .id      = V4L2_CID_SHARPNESS,
 117                 .type    = V4L2_CTRL_TYPE_INTEGER,
 118                 .name    = "Sharpness",
 119                 .minimum = 0,
 120                 .maximum = 255,
 121                 .step    = 1,
 122 #define SHARPNESS_DEF 0
 123                 .default_value = SHARPNESS_DEF,
 124             },
 125             .set = sd_setsharpness,
 126             .get = sd_getsharpness,
 127         },
 128 };
 129
 130 static const struct v4l2_pix_format vga_mode[] = {
 131 /*              (does not work correctly)
 132         {176, 144, V4L2_PIX_FMT_JPEG, V4L2_FIELD_NONE,
 133                 .bytesperline = 176,
 134                 .sizeimage = 176 * 144 * 5 / 8 + 590,
 135                 .colorspace = V4L2_COLORSPACE_JPEG,
 136                 .priv = 3},
 137 */
 138         {320, 240, V4L2_PIX_FMT_JPEG, V4L2_FIELD_NONE,
 139                 .bytesperline = 320,
 140                 .sizeimage = 320 * 240 * 4 / 8 + 590,
 141                 .colorspace = V4L2_COLORSPACE_JPEG,
 142                 .priv = 2},
 143         {640, 480, V4L2_PIX_FMT_JPEG, V4L2_FIELD_NONE,
 144                 .bytesperline = 640,
 145                 .sizeimage = 640 * 480 * 3 / 8 + 590,
 146                 .colorspace = V4L2_COLORSPACE_JPEG,
 147                 .priv = 1},
 148 };
 149
 150 /* read <len> bytes to gspca usb_buf */
 151 static void reg_r(struct gspca_dev *gspca_dev,
 152                         u8 req,
 153                         u16 index,
 154                         int len)
 155 {
 156 #if USB_BUF_SZ < 64
 157 #error "USB buffer too small"
 158 #endif
 159         struct usb_device *dev = gspca_dev->dev;
 160         int ret;
 161
 162         if (gspca_dev->usb_err < 0)
 163                 return;
 164         ret = usb_control_msg(dev, usb_rcvctrlpipe(dev, 0),
 165                         req,
 166                         USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
 167                         0x0000,                 /* value */
 168                         index,
 169                         gspca_dev->usb_buf, len,
 170                         500);
 171         PDEBUG(D_USBI, "GET %02x 0000 %04x %02x", req, index,
 172                          gspca_dev->usb_buf[0]);
 173         if (ret < 0) {
 174                 PDEBUG(D_ERR, "reg_r err %d", ret);
 175                 gspca_dev->usb_err = ret;
 176         }
 177 }
 178
 179 static void reg_w(struct gspca_dev *gspca_dev,
 180                         u8 req,
 181                         u16 value,
 182                         u16 index)
 183 {
 184         struct usb_device *dev = gspca_dev->dev;
 185         int ret;
 186
 187         if (gspca_dev->usb_err < 0)
 188                 return;
 189         PDEBUG(D_USBO, "SET %02x %04x %04x", req, value, index);
 190         ret = usb_control_msg(dev, usb_sndctrlpipe(dev, 0),
 191                         req,
 192                         USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
 193                         value, index,
 194                         NULL, 0, 500);
 195         if (ret < 0) {
 196                 PDEBUG(D_ERR, "reg_w err %d", ret);
 197                 gspca_dev->usb_err = ret;
 198         }
 199 }
 200
 201 static void reg_wb(struct gspca_dev *gspca_dev,
 202                         u8 req,
 203                         u16 value,
 204                         u16 index,
 205                         u8 byte)
 206 {
 207         struct usb_device *dev = gspca_dev->dev;
 208         int ret;
 209
 210         if (gspca_dev->usb_err < 0)
 211                 return;
 212         PDEBUG(D_USBO, "SET %02x %04x %04x %02x", req, value, index, byte);
 213         gspca_dev->usb_buf[0] = byte;
 214         ret = usb_control_msg(dev, usb_sndctrlpipe(dev, 0),
 215                         req,
 216                         USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
 217                         value, index,
 218                         gspca_dev->usb_buf, 1, 500);
 219         if (ret < 0) {
 220                 PDEBUG(D_ERR, "reg_w err %d", ret);
 221                 gspca_dev->usb_err = ret;
 222         }
 223 }
 224
 225 static void wait_status_0(struct gspca_dev *gspca_dev)
 226 {
 227         int i;
 228
 229         i = 20;
 230         do {
 231                 reg_r(gspca_dev, 0x21, 0x0000, 1);
 232                 if (gspca_dev->usb_buf[0] == 0)
 233                         return;
 234                 msleep(30);
 235         } while (--i > 0);
 236         PDEBUG(D_ERR, "wait_status_0 timeout");
 237         gspca_dev->usb_err = -ETIME;
 238 }
 239
 240 static void wait_status_1(struct gspca_dev *gspca_dev)
 241 {
 242         int i;
 243
 244         i = 10;
 245         do {
 246                 reg_r(gspca_dev, 0x21, 0x0001, 1);
 247                 msleep(10);
 248                 if (gspca_dev->usb_buf[0] == 1) {
 249                         reg_wb(gspca_dev, 0x21, 0x0000, 0x0001, 0x00);
 250                         reg_r(gspca_dev, 0x21, 0x0001, 1);
 251                         return;
 252                 }
 253         } while (--i > 0);
 254         PDEBUG(D_ERR, "wait_status_1 timeout");
 255         gspca_dev->usb_err = -ETIME;
 256 }
 257
 258 static void setbrightness(struct gspca_dev *gspca_dev)
 259 {
 260         struct sd *sd = (struct sd *) gspca_dev;
 261
 262         reg_wb(gspca_dev, 0xc0, 0x0000, 0x00c0, sd->brightness);
 263 }
 264
 265 static void setcontrast(struct gspca_dev *gspca_dev)
 266 {
 267         struct sd *sd = (struct sd *) gspca_dev;
 268
 269         reg_wb(gspca_dev, 0xc1, 0x0000, 0x00c1, sd->contrast);
 270 }
 271
 272 static void sethue(struct gspca_dev *gspca_dev)
 273 {
 274         struct sd *sd = (struct sd *) gspca_dev;
 275
 276         reg_wb(gspca_dev, 0xc2, 0x0000, 0x0000, sd->hue);
 277 }
 278
 279 static void setcolor(struct gspca_dev *gspca_dev)
 280 {
 281         struct sd *sd = (struct sd *) gspca_dev;
 282
 283         reg_wb(gspca_dev, 0xc3, 0x0000, 0x00c3, sd->color);
 284 }
 285
 286 static void setsharpness(struct gspca_dev *gspca_dev)
 287 {
 288         struct sd *sd = (struct sd *) gspca_dev;
 289
 290         reg_wb(gspca_dev, 0xc4, 0x0000, 0x00c4, sd->sharpness);
 291 }
 292
 293 /* this function is called at probe time */
 294 static int sd_config(struct gspca_dev *gspca_dev,
 295                         const struct usb_device_id *id)
 296 {
 297         struct sd *sd = (struct sd *) gspca_dev;
 298
 299         gspca_dev->cam.cam_mode = vga_mode;
 300         gspca_dev->cam.nmodes = ARRAY_SIZE(vga_mode);
 301         gspca_dev->cam.npkt = 128; /* number of packets per ISOC message */
 302
 303         sd->brightness = BRIGHTNESS_DEF;
 304         sd->contrast = CONTRAST_DEF;
 305         sd->hue = HUE_DEF;
 306         sd->color = COLOR_DEF;
 307         sd->sharpness = SHARPNESS_DEF;
 308
 309         gspca_dev->nbalt = 4;           /* use alternate setting 3 */
 310
 311         return 0;
 312 }
 313
 314 /* this function is called at probe and resume time */
 315 static int sd_init(struct gspca_dev *gspca_dev)
 316 {
 317         reg_w(gspca_dev, 0x00, 0x0001, 0x2067);
 318         reg_w(gspca_dev, 0x00, 0x00d0, 0x206b);
 319         reg_w(gspca_dev, 0x00, 0x0000, 0x206c);
 320         reg_w(gspca_dev, 0x00, 0x0001, 0x2069);
 321         msleep(8);
 322         reg_w(gspca_dev, 0x00, 0x00c0, 0x206b);
 323         reg_w(gspca_dev, 0x00, 0x0000, 0x206c);
 324         reg_w(gspca_dev, 0x00, 0x0001, 0x2069);
 325
 326         reg_r(gspca_dev, 0x20, 0x0000, 1);
 327         reg_r(gspca_dev, 0x20, 0x0000, 5);
 328         reg_r(gspca_dev, 0x23, 0x0000, 64);
 329         PDEBUG(D_PROBE, "%s%s", &gspca_dev->usb_buf[0x1c],
 330                                 &gspca_dev->usb_buf[0x30]);
 331         reg_r(gspca_dev, 0x23, 0x0001, 64);
 332         return gspca_dev->usb_err;
 333 }
 334
 335 /* function called at start time before URB creation */
 336 static int sd_isoc_init(struct gspca_dev *gspca_dev)
 337 {
 338         u8 mode;
 339
 340         reg_r(gspca_dev, 0x00, 0x2520, 1);
 341         wait_status_0(gspca_dev);
 342         reg_w(gspca_dev, 0xc5, 0x0003, 0x0000);
 343         wait_status_1(gspca_dev);
 344
 345         wait_status_0(gspca_dev);
 346         mode = gspca_dev->cam.cam_mode[gspca_dev->curr_mode].priv;
 347         reg_wb(gspca_dev, 0x25, 0x0000, 0x0004, mode);
 348         reg_r(gspca_dev, 0x25, 0x0004, 1);
 349         reg_wb(gspca_dev, 0x27, 0x0000, 0x0000, 0x06);
 350         reg_r(gspca_dev, 0x27, 0x0000, 1);
 351         return gspca_dev->usb_err;
 352 }
 353
 354 /* -- start the camera -- */
 355 static int sd_start(struct gspca_dev *gspca_dev)
 356 {
 357         struct sd *sd = (struct sd *) gspca_dev;
 358
 359         /* initialize the JPEG header */
 360         jpeg_define(sd->jpeg_hdr, gspca_dev->height, gspca_dev->width,
 361                         0x22);          /* JPEG 411 */
 362
 363         /* the JPEG quality seems to be 82% */
 364         jpeg_set_qual(sd->jpeg_hdr, 82);
 365
 366         /* set the controls */
 367         setbrightness(gspca_dev);
 368         setcontrast(gspca_dev);
 369         sethue(gspca_dev);
 370         setcolor(gspca_dev);
 371         setsharpness(gspca_dev);
 372
 373         msleep(5);
 374         reg_r(gspca_dev, 0x00, 0x2520, 1);
 375         msleep(8);
 376
 377         /* start the capture */
 378         wait_status_0(gspca_dev);
 379         reg_w(gspca_dev, 0x31, 0x0000, 0x0004);
 380         wait_status_1(gspca_dev);
 381         wait_status_0(gspca_dev);
 382         msleep(200);
 383
 384         sd->pkt_seq = 0;
 385         return gspca_dev->usb_err;
 386 }
 387
 388 static void sd_stopN(struct gspca_dev *gspca_dev)
 389 {
 390         /* stop the capture */
 391         wait_status_0(gspca_dev);
 392         reg_w(gspca_dev, 0x31, 0x0000, 0x0000);
 393         wait_status_1(gspca_dev);
 394         wait_status_0(gspca_dev);
 395 }
 396
 397 /* move a packet adding 0x00 after 0xff */
 398 static void add_packet(struct gspca_dev *gspca_dev,
 399                         u8 *data,
 400                         int len)
 401 {
 402         int i;
 403
 404         i = 0;
 405         do {
 406                 if (data[i] == 0xff) {
 407                         gspca_frame_add(gspca_dev, INTER_PACKET,
 408                                         data, i + 1);
 409                         len -= i;
 410                         data += i;
 411                         *data = 0x00;
 412                         i = 0;
 413                 }
 414         } while (++i < len);
 415         gspca_frame_add(gspca_dev, INTER_PACKET, data, len);
 416 }
 417
 418 static void sd_pkt_scan(struct gspca_dev *gspca_dev,
 419                         u8 *data,                       /* isoc packet */
 420                         int len)                        /* iso packet length */
 421 {
 422         struct sd *sd = (struct sd *) gspca_dev;
 423         static const u8 ffd9[] = {0xff, 0xd9};
 424
 425         /* image packets start with:
 426          *      02 8n
 427          * with <n> bit:
 428          *      0x01: even (0) / odd (1) image
 429          *      0x02: end of image when set
 430          */
 431         if (len < 3)
 432                 return;                         /* empty packet */
 433         if (*data == 0x02) {
 434                 if (data[1] & 0x02) {
 435                         sd->pkt_seq = !(data[1] & 1);
 436                         add_packet(gspca_dev, data + 2, len - 2);
 437                         gspca_frame_add(gspca_dev, LAST_PACKET,
 438                                         ffd9, 2);
 439                         return;
 440                 }
 441                 if ((data[1] & 1) != sd->pkt_seq)
 442                         goto err;
 443                 if (gspca_dev->last_packet_type == LAST_PACKET)
 444                         gspca_frame_add(gspca_dev, FIRST_PACKET,
 445                                         sd->jpeg_hdr, JPEG_HDR_SZ);
 446                 add_packet(gspca_dev, data + 2, len - 2);
 447                 return;
 448         }
 449 err:
 450         gspca_dev->last_packet_type = DISCARD_PACKET;
 451 }
 452
 453 static int sd_setbrightness(struct gspca_dev *gspca_dev, __s32 val)
 454 {
 455         struct sd *sd = (struct sd *) gspca_dev;
 456
 457         sd->brightness = val;
 458         if (gspca_dev->streaming)
 459                 setbrightness(gspca_dev);
 460         return gspca_dev->usb_err;
 461 }
 462
 463 static int sd_getbrightness(struct gspca_dev *gspca_dev, __s32 *val)
 464 {
 465         struct sd *sd = (struct sd *) gspca_dev;
 466
 467         *val = sd->brightness;
 468         return 0;
 469 }
 470
 471 static int sd_setcontrast(struct gspca_dev *gspca_dev, __s32 val)
 472 {
 473         struct sd *sd = (struct sd *) gspca_dev;
 474
 475         sd->contrast = val;
 476         if (gspca_dev->streaming)
 477                 setcontrast(gspca_dev);
 478         return gspca_dev->usb_err;
 479 }
 480
 481 static int sd_getcontrast(struct gspca_dev *gspca_dev, __s32 *val)
 482 {
 483         struct sd *sd = (struct sd *) gspca_dev;
 484
 485         *val = sd->contrast;
 486         return 0;
 487 }
 488
 489 static int sd_sethue(struct gspca_dev *gspca_dev, __s32 val)
 490 {
 491         struct sd *sd = (struct sd *) gspca_dev;
 492
 493         sd->hue = val;
 494         if (gspca_dev->streaming)
 495                 sethue(gspca_dev);
 496         return gspca_dev->usb_err;
 497 }
 498
 499 static int sd_gethue(struct gspca_dev *gspca_dev, __s32 *val)
 500 {
 501         struct sd *sd = (struct sd *) gspca_dev;
 502
 503         *val = sd->hue;
 504         return 0;
 505 }
 506
 507 static int sd_setcolor(struct gspca_dev *gspca_dev, __s32 val)
 508 {
 509         struct sd *sd = (struct sd *) gspca_dev;
 510
 511         sd->color = val;
 512         if (gspca_dev->streaming)
 513                 setcolor(gspca_dev);
 514         return gspca_dev->usb_err;
 515 }
 516
 517 static int sd_getcolor(struct gspca_dev *gspca_dev, __s32 *val)
 518 {
 519         struct sd *sd = (struct sd *) gspca_dev;
 520
 521         *val = sd->color;
 522         return 0;
 523 }
 524
 525 static int sd_setsharpness(struct gspca_dev *gspca_dev, __s32 val)
 526 {
 527         struct sd *sd = (struct sd *) gspca_dev;
 528
 529         sd->sharpness = val;
 530         if (gspca_dev->streaming)
 531                 setsharpness(gspca_dev);
 532         return gspca_dev->usb_err;
 533 }
 534
 535 static int sd_getsharpness(struct gspca_dev *gspca_dev, __s32 *val)
 536 {
 537         struct sd *sd = (struct sd *) gspca_dev;
 538
 539         *val = sd->sharpness;
 540         return 0;
 541 }
 542
 543 /* sub-driver description */
 544 static const struct sd_desc sd_desc = {
 545         .name = MODULE_NAME,
 546         .ctrls = sd_ctrls,
 547         .nctrls = ARRAY_SIZE(sd_ctrls),
 548         .config = sd_config,
 549         .init = sd_init,
 550         .isoc_init = sd_isoc_init,
 551         .start = sd_start,
 552         .stopN = sd_stopN,
 553         .pkt_scan = sd_pkt_scan,
 554 };
 555
 556 /* -- module initialisation -- */
 557 static const __devinitdata struct usb_device_id device_table[] = {
 558         {USB_DEVICE(0x04fc, 0x1528)},
 559         {}
 560 };
 561 MODULE_DEVICE_TABLE(usb, device_table);
 562
 563 /* -- device connect -- */
 564 static int sd_probe(struct usb_interface *intf,
 565                         const struct usb_device_id *id)
 566 {
 567         /* the video interface for isochronous transfer is 1 */
 568         if (intf->cur_altsetting->desc.bInterfaceNumber != 1)
 569                 return -ENODEV;
 570
 571         return gspca_dev_probe2(intf, id, &sd_desc, sizeof(struct sd),
 572                                 THIS_MODULE);
 573 }
 574
 575 static struct usb_driver sd_driver = {
 576         .name = MODULE_NAME,
 577         .id_table = device_table,
 578         .probe = sd_probe,
 579         .disconnect = gspca_disconnect,
 580 #ifdef CONFIG_PM
 581         .suspend = gspca_suspend,
 582         .resume = gspca_resume,
 583 #endif
 584 };
 585
 586 /* -- module insert / remove -- */
 587 static int __init sd_mod_init(void)
 588 {
 589         int ret;
 590
 591         ret = usb_register(&sd_driver);
 592         if (ret < 0)
 593                 return ret;
 594         info("registered");
 595         return 0;
 596 }
 597 static void __exit sd_mod_exit(void)
 598 {
 599         usb_deregister(&sd_driver);
 600         info("deregistered");
 601 }
 602
 603 module_init(sd_mod_init);
 604 module_exit(sd_mod_exit);