LXR linux/drivers/media/usb/gspca/tv8532.c

   1// SPDX-License-Identifier: GPL-2.0-or-later
   2/*
   3 * Quickcam cameras initialization data
   4 *
   5 * V4L2 by Jean-Francois Moine <http://moinejf.free.fr>
   6 */
   7#define MODULE_NAME "tv8532"
   8
   9#include "gspca.h"
  10
  11MODULE_AUTHOR("Michel Xhaard <mxhaard@users.sourceforge.net>");
  12MODULE_DESCRIPTION("TV8532 USB Camera Driver");
  13MODULE_LICENSE("GPL");
  14
  15/* specific webcam descriptor */
  16struct sd {
  17        struct gspca_dev gspca_dev;     /* !! must be the first item */
  18
  19        __u8 packet;
  20};
  21
  22static const struct v4l2_pix_format sif_mode[] = {
  23        {176, 144, V4L2_PIX_FMT_SBGGR8, V4L2_FIELD_NONE,
  24                .bytesperline = 176,
  25                .sizeimage = 176 * 144,
  26                .colorspace = V4L2_COLORSPACE_SRGB,
  27                .priv = 1},
  28        {352, 288, V4L2_PIX_FMT_SBGGR8, V4L2_FIELD_NONE,
  29                .bytesperline = 352,
  30                .sizeimage = 352 * 288,
  31                .colorspace = V4L2_COLORSPACE_SRGB,
  32                .priv = 0},
  33};
  34
  35/* TV-8532A (ICM532A) registers (LE) */
  36#define R00_PART_CONTROL 0x00
  37#define         LATENT_CHANGE   0x80
  38#define         EXPO_CHANGE     0x04
  39#define R01_TIMING_CONTROL_LOW 0x01
  40#define         CMD_EEprom_Open 0x30
  41#define         CMD_EEprom_Close 0x29
  42#define R03_TABLE_ADDR 0x03
  43#define R04_WTRAM_DATA_L 0x04
  44#define R05_WTRAM_DATA_M 0x05
  45#define R06_WTRAM_DATA_H 0x06
  46#define R07_TABLE_LEN   0x07
  47#define R08_RAM_WRITE_ACTION 0x08
  48#define R0C_AD_WIDTHL   0x0c
  49#define R0D_AD_WIDTHH   0x0d
  50#define R0E_AD_HEIGHTL  0x0e
  51#define R0F_AD_HEIGHTH  0x0f
  52#define R10_AD_COL_BEGINL 0x10
  53#define R11_AD_COL_BEGINH 0x11
  54#define         MIRROR          0x04    /* [10] */
  55#define R14_AD_ROW_BEGINL 0x14
  56#define R15_AD_ROWBEGINH  0x15
  57#define R1C_AD_EXPOSE_TIMEL 0x1c
  58#define R20_GAIN_G1L    0x20
  59#define R21_GAIN_G1H    0x21
  60#define R22_GAIN_RL     0x22
  61#define R23_GAIN_RH     0x23
  62#define R24_GAIN_BL     0x24
  63#define R25_GAIN_BH     0x25
  64#define R26_GAIN_G2L    0x26
  65#define R27_GAIN_G2H    0x27
  66#define R28_QUANT       0x28
  67#define R29_LINE        0x29
  68#define R2C_POLARITY    0x2c
  69#define R2D_POINT       0x2d
  70#define R2E_POINTH      0x2e
  71#define R2F_POINTB      0x2f
  72#define R30_POINTBH     0x30
  73#define R31_UPD         0x31
  74#define R2A_HIGH_BUDGET 0x2a
  75#define R2B_LOW_BUDGET  0x2b
  76#define R34_VID         0x34
  77#define R35_VIDH        0x35
  78#define R36_PID         0x36
  79#define R37_PIDH        0x37
  80#define R39_Test1       0x39            /* GPIO */
  81#define R3B_Test3       0x3b            /* GPIO */
  82#define R83_AD_IDH      0x83
  83#define R91_AD_SLOPEREG 0x91
  84#define R94_AD_BITCONTROL 0x94
  85
  86static const u8 eeprom_data[][3] = {
  87/*      dataH dataM dataL */
  88        {0x01, 0x00, 0x01},
  89        {0x01, 0x80, 0x11},
  90        {0x05, 0x00, 0x14},
  91        {0x05, 0x00, 0x1c},
  92        {0x0d, 0x00, 0x1e},
  93        {0x05, 0x00, 0x1f},
  94        {0x05, 0x05, 0x19},
  95        {0x05, 0x01, 0x1b},
  96        {0x05, 0x09, 0x1e},
  97        {0x0d, 0x89, 0x2e},
  98        {0x05, 0x89, 0x2f},
  99        {0x05, 0x0d, 0xd9},
 100        {0x05, 0x09, 0xf1},
 101};
 102
 103
 104/* write 1 byte */
 105static void reg_w1(struct gspca_dev *gspca_dev,
 106                  __u16 index, __u8 value)
 107{
 108        gspca_dev->usb_buf[0] = value;
 109        usb_control_msg(gspca_dev->dev,
 110                        usb_sndctrlpipe(gspca_dev->dev, 0),
 111                        0x02,
 112                        USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
 113                        0,      /* value */
 114                        index, gspca_dev->usb_buf, 1, 500);
 115}
 116
 117/* write 2 bytes */
 118static void reg_w2(struct gspca_dev *gspca_dev,
 119                  u16 index, u16 value)
 120{
 121        gspca_dev->usb_buf[0] = value;
 122        gspca_dev->usb_buf[1] = value >> 8;
 123        usb_control_msg(gspca_dev->dev,
 124                        usb_sndctrlpipe(gspca_dev->dev, 0),
 125                        0x02,
 126                        USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
 127                        0,      /* value */
 128                        index, gspca_dev->usb_buf, 2, 500);
 129}
 130
 131static void tv_8532WriteEEprom(struct gspca_dev *gspca_dev)
 132{
 133        int i;
 134
 135        reg_w1(gspca_dev, R01_TIMING_CONTROL_LOW, CMD_EEprom_Open);
 136        for (i = 0; i < ARRAY_SIZE(eeprom_data); i++) {
 137                reg_w1(gspca_dev, R03_TABLE_ADDR, i);
 138                reg_w1(gspca_dev, R04_WTRAM_DATA_L, eeprom_data[i][2]);
 139                reg_w1(gspca_dev, R05_WTRAM_DATA_M, eeprom_data[i][1]);
 140                reg_w1(gspca_dev, R06_WTRAM_DATA_H, eeprom_data[i][0]);
 141                reg_w1(gspca_dev, R08_RAM_WRITE_ACTION, 0);
 142        }
 143        reg_w1(gspca_dev, R07_TABLE_LEN, i);
 144        reg_w1(gspca_dev, R01_TIMING_CONTROL_LOW, CMD_EEprom_Close);
 145}
 146
 147/* this function is called at probe time */
 148static int sd_config(struct gspca_dev *gspca_dev,
 149                     const struct usb_device_id *id)
 150{
 151        struct cam *cam;
 152
 153        cam = &gspca_dev->cam;
 154        cam->cam_mode = sif_mode;
 155        cam->nmodes = ARRAY_SIZE(sif_mode);
 156
 157        return 0;
 158}
 159
 160static void tv_8532_setReg(struct gspca_dev *gspca_dev)
 161{
 162        reg_w1(gspca_dev, R3B_Test3, 0x0a);     /* Test0Sel = 10 */
 163        /******************************************************/
 164        reg_w1(gspca_dev, R0E_AD_HEIGHTL, 0x90);
 165        reg_w1(gspca_dev, R0F_AD_HEIGHTH, 0x01);
 166        reg_w2(gspca_dev, R1C_AD_EXPOSE_TIMEL, 0x018f);
 167        reg_w1(gspca_dev, R10_AD_COL_BEGINL, 0x44);
 168                                                /* begin active line */
 169        reg_w1(gspca_dev, R11_AD_COL_BEGINH, 0x00);
 170                                                /* mirror and digital gain */
 171        reg_w1(gspca_dev, R14_AD_ROW_BEGINL, 0x0a);
 172
 173        reg_w1(gspca_dev, R94_AD_BITCONTROL, 0x02);
 174        reg_w1(gspca_dev, R91_AD_SLOPEREG, 0x00);
 175        reg_w1(gspca_dev, R00_PART_CONTROL, LATENT_CHANGE | EXPO_CHANGE);
 176                                                /* = 0x84 */
 177}
 178
 179/* this function is called at probe and resume time */
 180static int sd_init(struct gspca_dev *gspca_dev)
 181{
 182        tv_8532WriteEEprom(gspca_dev);
 183
 184        return 0;
 185}
 186
 187static void setexposure(struct gspca_dev *gspca_dev, s32 val)
 188{
 189        reg_w2(gspca_dev, R1C_AD_EXPOSE_TIMEL, val);
 190        reg_w1(gspca_dev, R00_PART_CONTROL, LATENT_CHANGE | EXPO_CHANGE);
 191                                                /* 0x84 */
 192}
 193
 194static void setgain(struct gspca_dev *gspca_dev, s32 val)
 195{
 196        reg_w2(gspca_dev, R20_GAIN_G1L, val);
 197        reg_w2(gspca_dev, R22_GAIN_RL, val);
 198        reg_w2(gspca_dev, R24_GAIN_BL, val);
 199        reg_w2(gspca_dev, R26_GAIN_G2L, val);
 200}
 201
 202/* -- start the camera -- */
 203static int sd_start(struct gspca_dev *gspca_dev)
 204{
 205        struct sd *sd = (struct sd *) gspca_dev;
 206
 207        reg_w1(gspca_dev, R0C_AD_WIDTHL, 0xe8);         /* 0x20; 0x0c */
 208        reg_w1(gspca_dev, R0D_AD_WIDTHH, 0x03);
 209
 210        /************************************************/
 211        reg_w1(gspca_dev, R28_QUANT, 0x90);
 212                                        /* 0x72 compressed mode 0x28 */
 213        if (gspca_dev->cam.cam_mode[(int) gspca_dev->curr_mode].priv) {
 214                /* 176x144 */
 215                reg_w1(gspca_dev, R29_LINE, 0x41);
 216                                        /* CIF - 2 lines/packet */
 217        } else {
 218                /* 352x288 */
 219                reg_w1(gspca_dev, R29_LINE, 0x81);
 220                                        /* CIF - 2 lines/packet */
 221        }
 222        /************************************************/
 223        reg_w1(gspca_dev, R2C_POLARITY, 0x10);          /* slow clock */
 224        reg_w1(gspca_dev, R2D_POINT, 0x14);
 225        reg_w1(gspca_dev, R2E_POINTH, 0x01);
 226        reg_w1(gspca_dev, R2F_POINTB, 0x12);
 227        reg_w1(gspca_dev, R30_POINTBH, 0x01);
 228
 229        tv_8532_setReg(gspca_dev);
 230
 231        /************************************************/
 232        reg_w1(gspca_dev, R31_UPD, 0x01);       /* update registers */
 233        msleep(200);
 234        reg_w1(gspca_dev, R31_UPD, 0x00);       /* end update */
 235
 236        gspca_dev->empty_packet = 0;            /* check the empty packets */
 237        sd->packet = 0;                         /* ignore the first packets */
 238
 239        return 0;
 240}
 241
 242static void sd_stopN(struct gspca_dev *gspca_dev)
 243{
 244        reg_w1(gspca_dev, R3B_Test3, 0x0b);     /* Test0Sel = 11 = GPIO */
 245}
 246
 247static void sd_pkt_scan(struct gspca_dev *gspca_dev,
 248                        u8 *data,                       /* isoc packet */
 249                        int len)                        /* iso packet length */
 250{
 251        struct sd *sd = (struct sd *) gspca_dev;
 252        int packet_type0, packet_type1;
 253
 254        packet_type0 = packet_type1 = INTER_PACKET;
 255        if (gspca_dev->empty_packet) {
 256                gspca_dev->empty_packet = 0;
 257                sd->packet = gspca_dev->pixfmt.height / 2;
 258                packet_type0 = FIRST_PACKET;
 259        } else if (sd->packet == 0)
 260                return;                 /* 2 more lines in 352x288 ! */
 261        sd->packet--;
 262        if (sd->packet == 0)
 263                packet_type1 = LAST_PACKET;
 264
 265        /* each packet contains:
 266         * - header 2 bytes
 267         * - RGRG line
 268         * - 4 bytes
 269         * - GBGB line
 270         * - 4 bytes
 271         */
 272        gspca_frame_add(gspca_dev, packet_type0,
 273                        data + 2, gspca_dev->pixfmt.width);
 274        gspca_frame_add(gspca_dev, packet_type1,
 275                        data + gspca_dev->pixfmt.width + 5,
 276                        gspca_dev->pixfmt.width);
 277}
 278
 279static int sd_s_ctrl(struct v4l2_ctrl *ctrl)
 280{
 281        struct gspca_dev *gspca_dev =
 282                container_of(ctrl->handler, struct gspca_dev, ctrl_handler);
 283
 284        gspca_dev->usb_err = 0;
 285
 286        if (!gspca_dev->streaming)
 287                return 0;
 288
 289        switch (ctrl->id) {
 290        case V4L2_CID_EXPOSURE:
 291                setexposure(gspca_dev, ctrl->val);
 292                break;
 293        case V4L2_CID_GAIN:
 294                setgain(gspca_dev, ctrl->val);
 295                break;
 296        }
 297        return gspca_dev->usb_err;
 298}
 299
 300static const struct v4l2_ctrl_ops sd_ctrl_ops = {
 301        .s_ctrl = sd_s_ctrl,
 302};
 303
 304static int sd_init_controls(struct gspca_dev *gspca_dev)
 305{
 306        struct v4l2_ctrl_handler *hdl = &gspca_dev->ctrl_handler;
 307
 308        gspca_dev->vdev.ctrl_handler = hdl;
 309        v4l2_ctrl_handler_init(hdl, 2);
 310        v4l2_ctrl_new_std(hdl, &sd_ctrl_ops,
 311                        V4L2_CID_EXPOSURE, 0, 0x18f, 1, 0x18f);
 312        v4l2_ctrl_new_std(hdl, &sd_ctrl_ops,
 313                        V4L2_CID_GAIN, 0, 0x7ff, 1, 0x100);
 314
 315        if (hdl->error) {
 316                pr_err("Could not initialize controls\n");
 317                return hdl->error;
 318        }
 319        return 0;
 320}
 321
 322/* sub-driver description */
 323static const struct sd_desc sd_desc = {
 324        .name = MODULE_NAME,
 325        .config = sd_config,
 326        .init = sd_init,
 327        .init_controls = sd_init_controls,
 328        .start = sd_start,
 329        .stopN = sd_stopN,
 330        .pkt_scan = sd_pkt_scan,
 331};
 332
 333/* -- module initialisation -- */
 334static const struct usb_device_id device_table[] = {
 335        {USB_DEVICE(0x046d, 0x0920)},
 336        {USB_DEVICE(0x046d, 0x0921)},
 337        {USB_DEVICE(0x0545, 0x808b)},
 338        {USB_DEVICE(0x0545, 0x8333)},
 339        {USB_DEVICE(0x0923, 0x010f)},
 340        {}
 341};
 342
 343MODULE_DEVICE_TABLE(usb, device_table);
 344
 345/* -- device connect -- */
 346static int sd_probe(struct usb_interface *intf,
 347                    const struct usb_device_id *id)
 348{
 349        return gspca_dev_probe(intf, id, &sd_desc, sizeof(struct sd),
 350                               THIS_MODULE);
 351}
 352
 353static struct usb_driver sd_driver = {
 354        .name = MODULE_NAME,
 355        .id_table = device_table,
 356        .probe = sd_probe,
 357        .disconnect = gspca_disconnect,
 358#ifdef CONFIG_PM
 359        .suspend = gspca_suspend,
 360        .resume = gspca_resume,
 361        .reset_resume = gspca_resume,
 362#endif
 363};
 364
 365module_usb_driver(sd_driver);
 366