// SPDX-License-Identifier: GPL-2.0-or-later
/*
 * Mars MR97310A library
 *
 * The original mr97310a driver, which supported the Aiptek Pencam VGA+, is
 * Copyright (C) 2009 Kyle Guinn <elyk03@gmail.com>
 *
 * Support for the MR97310A cameras in addition to the Aiptek Pencam VGA+
 * and for the routines for detecting and classifying these various cameras,
 * is Copyright (C) 2009 Theodore Kilgore <kilgota@auburn.edu>
 *
 * Support for the control settings for the CIF cameras is
 * Copyright (C) 2009 Hans de Goede <hdegoede@redhat.com> and
 * Thomas Kaiser <thomas@kaiser-linux.li>
 *
 * Support for the control settings for the VGA cameras is
 * Copyright (C) 2009 Theodore Kilgore <kilgota@auburn.edu>
 *
 * Several previously unsupported cameras are owned and have been tested by
 * Hans de Goede <hdegoede@redhat.com> and
 * Thomas Kaiser <thomas@kaiser-linux.li> and
 * Theodore Kilgore <kilgota@auburn.edu> and
 * Edmond Rodriguez <erodrig_97@yahoo.com> and
 * Aurelien Jacobs <aurel@gnuage.org>
 *
 * The MR97311A support in gspca/mars.c has been helpful in understanding some
 * of the registers in these cameras.
 */

#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt

#define MODULE_NAME "mr97310a"

#include "gspca.h"

#define CAM_TYPE_CIF                    0
#define CAM_TYPE_VGA                    1

#define MR97310A_BRIGHTNESS_DEFAULT     0

#define MR97310A_EXPOSURE_MIN           0
#define MR97310A_EXPOSURE_MAX           4095
#define MR97310A_EXPOSURE_DEFAULT       1000

#define MR97310A_GAIN_MIN               0
#define MR97310A_GAIN_MAX               31
#define MR97310A_GAIN_DEFAULT           25

#define MR97310A_CONTRAST_MIN           0
#define MR97310A_CONTRAST_MAX           31
#define MR97310A_CONTRAST_DEFAULT       23

#define MR97310A_CS_GAIN_MIN            0
#define MR97310A_CS_GAIN_MAX            0x7ff
#define MR97310A_CS_GAIN_DEFAULT        0x110

#define MR97310A_CID_CLOCKDIV (V4L2_CTRL_CLASS_USER + 0x1000)
#define MR97310A_MIN_CLOCKDIV_MIN       3
#define MR97310A_MIN_CLOCKDIV_MAX       8
#define MR97310A_MIN_CLOCKDIV_DEFAULT   3

MODULE_AUTHOR("Kyle Guinn <elyk03@gmail.com>,Theodore Kilgore <kilgota@auburn.edu>");
MODULE_DESCRIPTION("GSPCA/Mars-Semi MR97310A USB Camera Driver");
MODULE_LICENSE("GPL");

/* global parameters */
static int force_sensor_type = -1;
module_param(force_sensor_type, int, 0644);
MODULE_PARM_DESC(force_sensor_type, "Force sensor type (-1 (auto), 0 or 1)");

/* specific webcam descriptor */
struct sd {
        struct gspca_dev gspca_dev;  /* !! must be the first item */
        struct { /* exposure/min_clockdiv control cluster */
                struct v4l2_ctrl *exposure;
                struct v4l2_ctrl *min_clockdiv;
        };
        u8 sof_read;
        u8 cam_type;    /* 0 is CIF and 1 is VGA */
        u8 sensor_type; /* We use 0 and 1 here, too. */
        u8 do_lcd_stop;
        u8 adj_colors;
};

struct sensor_w_data {
        u8 reg;
        u8 flags;
        u8 data[16];
        int len;
};

static void sd_stopN(struct gspca_dev *gspca_dev);

static const struct v4l2_pix_format vga_mode[] = {
        {160, 120, V4L2_PIX_FMT_MR97310A, V4L2_FIELD_NONE,
                .bytesperline = 160,
                .sizeimage = 160 * 120,
                .colorspace = V4L2_COLORSPACE_SRGB,
                .priv = 4},
        {176, 144, V4L2_PIX_FMT_MR97310A, V4L2_FIELD_NONE,
                .bytesperline = 176,
                .sizeimage = 176 * 144,
                .colorspace = V4L2_COLORSPACE_SRGB,
                .priv = 3},
        {320, 240, V4L2_PIX_FMT_MR97310A, V4L2_FIELD_NONE,
                .bytesperline = 320,
                .sizeimage = 320 * 240,
                .colorspace = V4L2_COLORSPACE_SRGB,
                .priv = 2},
        {352, 288, V4L2_PIX_FMT_MR97310A, V4L2_FIELD_NONE,
                .bytesperline = 352,
                .sizeimage = 352 * 288,
                .colorspace = V4L2_COLORSPACE_SRGB,
                .priv = 1},
        {640, 480, V4L2_PIX_FMT_MR97310A, V4L2_FIELD_NONE,
                .bytesperline = 640,
                .sizeimage = 640 * 480,
                .colorspace = V4L2_COLORSPACE_SRGB,
                .priv = 0},
};

/* the bytes to write are in gspca_dev->usb_buf */
static int mr_write(struct gspca_dev *gspca_dev, int len)
{
        int rc;

        rc = usb_bulk_msg(gspca_dev->dev,
                          usb_sndbulkpipe(gspca_dev->dev, 4),
                          gspca_dev->usb_buf, len, NULL, 500);
        if (rc < 0)
                pr_err("reg write [%02x] error %d\n",
                       gspca_dev->usb_buf[0], rc);
        return rc;
}

/* the bytes are read into gspca_dev->usb_buf */
static int mr_read(struct gspca_dev *gspca_dev, int len)
{
        int rc;

        rc = usb_bulk_msg(gspca_dev->dev,
                          usb_rcvbulkpipe(gspca_dev->dev, 3),
                          gspca_dev->usb_buf, len, NULL, 500);
        if (rc < 0)
                pr_err("reg read [%02x] error %d\n",
                       gspca_dev->usb_buf[0], rc);
        return rc;
}

static int sensor_write_reg(struct gspca_dev *gspca_dev, u8 reg, u8 flags,
        const u8 *data, int len)
{
        gspca_dev->usb_buf[0] = 0x1f;
        gspca_dev->usb_buf[1] = flags;
        gspca_dev->usb_buf[2] = reg;
        memcpy(gspca_dev->usb_buf + 3, data, len);

        return mr_write(gspca_dev, len + 3);
}

static int sensor_write_regs(struct gspca_dev *gspca_dev,
        const struct sensor_w_data *data, int len)
{
        int i, rc;

        for (i = 0; i < len; i++) {
                rc = sensor_write_reg(gspca_dev, data[i].reg, data[i].flags,
                                          data[i].data, data[i].len);
                if (rc < 0)
                        return rc;
        }

        return 0;
}

static int sensor_write1(struct gspca_dev *gspca_dev, u8 reg, u8 data)
{
        struct sd *sd = (struct sd *) gspca_dev;
        u8 buf, confirm_reg;
        int rc;

        buf = data;
        if (sd->cam_type == CAM_TYPE_CIF) {
                rc = sensor_write_reg(gspca_dev, reg, 0x01, &buf, 1);
                confirm_reg = sd->sensor_type ? 0x13 : 0x11;
        } else {
                rc = sensor_write_reg(gspca_dev, reg, 0x00, &buf, 1);
                confirm_reg = 0x11;
        }
        if (rc < 0)
                return rc;

        buf = 0x01;
        rc = sensor_write_reg(gspca_dev, confirm_reg, 0x00, &buf, 1);
        if (rc < 0)
                return rc;

        return 0;
}

static int cam_get_response16(struct gspca_dev *gspca_dev, u8 reg, int verbose)
{
        int err_code;

        gspca_dev->usb_buf[0] = reg;
        err_code = mr_write(gspca_dev, 1);
        if (err_code < 0)
                return err_code;

        err_code = mr_read(gspca_dev, 16);
        if (err_code < 0)
                return err_code;

        if (verbose)
                gspca_dbg(gspca_dev, D_PROBE, "Register: %02x reads %02x%02x%02x\n",
                          reg,
                          gspca_dev->usb_buf[0],
                          gspca_dev->usb_buf[1],
                          gspca_dev->usb_buf[2]);

        return 0;
}

static int zero_the_pointer(struct gspca_dev *gspca_dev)
{
        __u8 *data = gspca_dev->usb_buf;
        int err_code;
        u8 status = 0;
        int tries = 0;

        err_code = cam_get_response16(gspca_dev, 0x21, 0);
        if (err_code < 0)
                return err_code;

        data[0] = 0x19;
        data[1] = 0x51;
        err_code = mr_write(gspca_dev, 2);
        if (err_code < 0)
                return err_code;

        err_code = cam_get_response16(gspca_dev, 0x21, 0);
        if (err_code < 0)
                return err_code;

        data[0] = 0x19;
        data[1] = 0xba;
        err_code = mr_write(gspca_dev, 2);
        if (err_code < 0)
                return err_code;

        err_code = cam_get_response16(gspca_dev, 0x21, 0);
        if (err_code < 0)
                return err_code;

        data[0] = 0x19;
        data[1] = 0x00;
        err_code = mr_write(gspca_dev, 2);
        if (err_code < 0)
                return err_code;

        err_code = cam_get_response16(gspca_dev, 0x21, 0);
        if (err_code < 0)
                return err_code;

        data[0] = 0x19;
        data[1] = 0x00;
        err_code = mr_write(gspca_dev, 2);
        if (err_code < 0)
                return err_code;

        while (status != 0x0a && tries < 256) {
                err_code = cam_get_response16(gspca_dev, 0x21, 0);
                status = data[0];
                tries++;
                if (err_code < 0)
                        return err_code;
        }
        if (status != 0x0a)
                gspca_err(gspca_dev, "status is %02x\n", status);

        tries = 0;
        while (tries < 4) {
                data[0] = 0x19;
                data[1] = 0x00;
                err_code = mr_write(gspca_dev, 2);
                if (err_code < 0)
                        return err_code;

                err_code = cam_get_response16(gspca_dev, 0x21, 0);
                tries++;
                if (err_code < 0)
                        return err_code;
        }

        data[0] = 0x19;
        err_code = mr_write(gspca_dev, 1);
        if (err_code < 0)
                return err_code;

        err_code = mr_read(gspca_dev, 16);
        if (err_code < 0)
                return err_code;

        return 0;
}

static int stream_start(struct gspca_dev *gspca_dev)
{
        gspca_dev->usb_buf[0] = 0x01;
        gspca_dev->usb_buf[1] = 0x01;
        return mr_write(gspca_dev, 2);
}

static void stream_stop(struct gspca_dev *gspca_dev)
{
        gspca_dev->usb_buf[0] = 0x01;
        gspca_dev->usb_buf[1] = 0x00;
        if (mr_write(gspca_dev, 2) < 0)
                gspca_err(gspca_dev, "Stream Stop failed\n");
}

static void lcd_stop(struct gspca_dev *gspca_dev)
{
        gspca_dev->usb_buf[0] = 0x19;
        gspca_dev->usb_buf[1] = 0x54;
        if (mr_write(gspca_dev, 2) < 0)
                gspca_err(gspca_dev, "LCD Stop failed\n");
}

static int isoc_enable(struct gspca_dev *gspca_dev)
{
        gspca_dev->usb_buf[0] = 0x00;
        gspca_dev->usb_buf[1] = 0x4d;  /* ISOC transferring enable... */
        return mr_write(gspca_dev, 2);
}

/* This function is called at probe time */
static int sd_config(struct gspca_dev *gspca_dev,
                     const struct usb_device_id *id)
{
        struct sd *sd = (struct sd *) gspca_dev;
        struct cam *cam;
        int err_code;

        cam = &gspca_dev->cam;
        cam->cam_mode = vga_mode;
        cam->nmodes = ARRAY_SIZE(vga_mode);
        sd->do_lcd_stop = 0;

        /* Several of the supported CIF cameras share the same USB ID but
         * require different initializations and different control settings.
         * The same is true of the VGA cameras. Therefore, we are forced
         * to start the initialization process in order to determine which
         * camera is present. Some of the supported cameras require the
         * memory pointer to be set to 0 as the very first item of business
         * or else they will not stream. So we do that immediately.
         */
        err_code = zero_the_pointer(gspca_dev);
        if (err_code < 0)
                return err_code;

        err_code = stream_start(gspca_dev);
        if (err_code < 0)
                return err_code;

        /* Now, the query for sensor type. */
        err_code = cam_get_response16(gspca_dev, 0x07, 1);
        if (err_code < 0)
                return err_code;

        if (id->idProduct == 0x0110 || id->idProduct == 0x010e) {
                sd->cam_type = CAM_TYPE_CIF;
                cam->nmodes--;
                /*
                 * All but one of the known CIF cameras share the same USB ID,
                 * but two different init routines are in use, and the control
                 * settings are different, too. We need to detect which camera
                 * of the two known varieties is connected!
                 *
                 * A list of known CIF cameras follows. They all report either
                 * 0200 for type 0 or 0300 for type 1.
                 * If you have another to report, please do
                 *
                 * Name         sd->sensor_type         reported by
                 *
                 * Sakar 56379 Spy-shot 0               T. Kilgore
                 * Innovage             0               T. Kilgore
                 * Vivitar Mini         0               H. De Goede
                 * Vivitar Mini         0               E. Rodriguez
                 * Vivitar Mini         1               T. Kilgore
                 * Elta-Media 8212dc    1               T. Kaiser
                 * Philips dig. keych.  1               T. Kilgore
                 * Trust Spyc@m 100     1               A. Jacobs
                 */
                switch (gspca_dev->usb_buf[0]) {
                case 2:
                        sd->sensor_type = 0;
                        break;
                case 3:
                        sd->sensor_type = 1;
                        break;
                default:
                        pr_err("Unknown CIF Sensor id : %02x\n",
                               gspca_dev->usb_buf[1]);
                        return -ENODEV;
                }
                gspca_dbg(gspca_dev, D_PROBE, "MR97310A CIF camera detected, sensor: %d\n",
                          sd->sensor_type);
        } else {
                sd->cam_type = CAM_TYPE_VGA;

                /*
                 * Here is a table of the responses to the query for sensor
                 * type, from the known MR97310A VGA cameras. Six different
                 * cameras of which five share the same USB ID.
                 *
                 * Name                 gspca_dev->usb_buf[]    sd->sensor_type
                 *                              sd->do_lcd_stop
                 * Aiptek Pencam VGA+   0300            0               1
                 * ION digital          0300            0               1
                 * Argus DC-1620        0450            1               0
                 * Argus QuickClix      0420            1               1
                 * Sakar 77379 Digital  0350            0               1
                 * Sakar 1638x CyberPix 0120            0               2
                 *
                 * Based upon these results, we assume default settings
                 * and then correct as necessary, as follows.
                 *
                 */

                sd->sensor_type = 1;
                sd->do_lcd_stop = 0;
                sd->adj_colors = 0;
                if (gspca_dev->usb_buf[0] == 0x01) {
                        sd->sensor_type = 2;
                } else if ((gspca_dev->usb_buf[0] != 0x03) &&
                                        (gspca_dev->usb_buf[0] != 0x04)) {
                        pr_err("Unknown VGA Sensor id Byte 0: %02x\n",
                               gspca_dev->usb_buf[0]);
                        pr_err("Defaults assumed, may not work\n");
                        pr_err("Please report this\n");
                }
                /* Sakar Digital color needs to be adjusted. */
                if ((gspca_dev->usb_buf[0] == 0x03) &&
                                        (gspca_dev->usb_buf[1] == 0x50))
                        sd->adj_colors = 1;
                if (gspca_dev->usb_buf[0] == 0x04) {
                        sd->do_lcd_stop = 1;
                        switch (gspca_dev->usb_buf[1]) {
                        case 0x50:
                                sd->sensor_type = 0;
                                gspca_dbg(gspca_dev, D_PROBE, "sensor_type corrected to 0\n");
                                break;
                        case 0x20:
                                /* Nothing to do here. */
                                break;
                        default:
                                pr_err("Unknown VGA Sensor id Byte 1: %02x\n",
                                       gspca_dev->usb_buf[1]);
                                pr_err("Defaults assumed, may not work\n");
                                pr_err("Please report this\n");
                        }
                }
                gspca_dbg(gspca_dev, D_PROBE, "MR97310A VGA camera detected, sensor: %d\n",
                          sd->sensor_type);
        }
        /* Stop streaming as we've started it only to probe the sensor type. */
        sd_stopN(gspca_dev);

        if (force_sensor_type != -1) {
                sd->sensor_type = !!force_sensor_type;
                gspca_dbg(gspca_dev, D_PROBE, "Forcing sensor type to: %d\n",
                          sd->sensor_type);
        }

        return 0;
}

/* this function is called at probe and resume time */
static int sd_init(struct gspca_dev *gspca_dev)
{
        return 0;
}

static int start_cif_cam(struct gspca_dev *gspca_dev)
{
        struct sd *sd = (struct sd *) gspca_dev;
        __u8 *data = gspca_dev->usb_buf;
        int err_code;
        static const __u8 startup_string[] = {
                0x00,
                0x0d,
                0x01,
                0x00, /* Hsize/8 for 352 or 320 */
                0x00, /* Vsize/4 for 288 or 240 */
                0x13, /* or 0xbb, depends on sensor */
                0x00, /* Hstart, depends on res. */
                0x00, /* reserved ? */
                0x00, /* Vstart, depends on res. and sensor */
                0x50, /* 0x54 to get 176 or 160 */
                0xc0
        };

        /* Note: Some of the above descriptions guessed from MR97113A driver */

        memcpy(data, startup_string, 11);
        if (sd->sensor_type)
                data[5] = 0xbb;

        switch (gspca_dev->pixfmt.width) {
        case 160:
                data[9] |= 0x04;  /* reg 8, 2:1 scale down from 320 */
                fallthrough;
        case 320:
        default:
                data[3] = 0x28;                    /* reg 2, H size/8 */
                data[4] = 0x3c;                    /* reg 3, V size/4 */
                data[6] = 0x14;                    /* reg 5, H start  */
                data[8] = 0x1a + sd->sensor_type;  /* reg 7, V start  */
                break;
        case 176:
                data[9] |= 0x04;  /* reg 8, 2:1 scale down from 352 */
                fallthrough;
        case 352:
                data[3] = 0x2c;                    /* reg 2, H size/8 */
                data[4] = 0x48;                    /* reg 3, V size/4 */
                data[6] = 0x06;                    /* reg 5, H start  */
                data[8] = 0x06 - sd->sensor_type;  /* reg 7, V start  */
                break;
        }
        err_code = mr_write(gspca_dev, 11);
        if (err_code < 0)
                return err_code;

        if (!sd->sensor_type) {
                static const struct sensor_w_data cif_sensor0_init_data[] = {
                        {0x02, 0x00, {0x03, 0x5a, 0xb5, 0x01,
                                      0x0f, 0x14, 0x0f, 0x10}, 8},
                        {0x0c, 0x00, {0x04, 0x01, 0x01, 0x00, 0x1f}, 5},
                        {0x12, 0x00, {0x07}, 1},
                        {0x1f, 0x00, {0x06}, 1},
                        {0x27, 0x00, {0x04}, 1},
                        {0x29, 0x00, {0x0c}, 1},
                        {0x40, 0x00, {0x40, 0x00, 0x04}, 3},
                        {0x50, 0x00, {0x60}, 1},
                        {0x60, 0x00, {0x06}, 1},
                        {0x6b, 0x00, {0x85, 0x85, 0xc8, 0xc8, 0xc8, 0xc8}, 6},
                        {0x72, 0x00, {0x1e, 0x56}, 2},
                        {0x75, 0x00, {0x58, 0x40, 0xa2, 0x02, 0x31, 0x02,
                                      0x31, 0x80, 0x00}, 9},
                        {0x11, 0x00, {0x01}, 1},
                        {0, 0, {0}, 0}
                };
                err_code = sensor_write_regs(gspca_dev, cif_sensor0_init_data,
                                         ARRAY_SIZE(cif_sensor0_init_data));
        } else {        /* sd->sensor_type = 1 */
                static const struct sensor_w_data cif_sensor1_init_data[] = {
                        /* Reg 3,4, 7,8 get set by the controls */
                        {0x02, 0x00, {0x10}, 1},
                        {0x05, 0x01, {0x22}, 1}, /* 5/6 also seen as 65h/32h */
                        {0x06, 0x01, {0x00}, 1},
                        {0x09, 0x02, {0x0e}, 1},
                        {0x0a, 0x02, {0x05}, 1},
                        {0x0b, 0x02, {0x05}, 1},
                        {0x0c, 0x02, {0x0f}, 1},
                        {0x0d, 0x02, {0x07}, 1},
                        {0x0e, 0x02, {0x0c}, 1},
                        {0x0f, 0x00, {0x00}, 1},
                        {0x10, 0x00, {0x06}, 1},
                        {0x11, 0x00, {0x07}, 1},
                        {0x12, 0x00, {0x00}, 1},
                        {0x13, 0x00, {0x01}, 1},
                        {0, 0, {0}, 0}
                };
                /* Without this command the cam won't work with USB-UHCI */
                gspca_dev->usb_buf[0] = 0x0a;
                gspca_dev->usb_buf[1] = 0x00;
                err_code = mr_write(gspca_dev, 2);
                if (err_code < 0)
                        return err_code;
                err_code = sensor_write_regs(gspca_dev, cif_sensor1_init_data,
                                         ARRAY_SIZE(cif_sensor1_init_data));
        }
        return err_code;
}

static int start_vga_cam(struct gspca_dev *gspca_dev)
{
        struct sd *sd = (struct sd *) gspca_dev;
        __u8 *data = gspca_dev->usb_buf;
        int err_code;
        static const __u8 startup_string[] =
                {0x00, 0x0d, 0x01, 0x00, 0x00, 0x2b, 0x00, 0x00,
                 0x00, 0x50, 0xc0};
        /* What some of these mean is explained in start_cif_cam(), above */

        memcpy(data, startup_string, 11);
        if (!sd->sensor_type) {
                data[5]  = 0x00;
                data[10] = 0x91;
        }
        if (sd->sensor_type == 2) {
                data[5]  = 0x00;
                data[10] = 0x18;
        }

        switch (gspca_dev->pixfmt.width) {
        case 160:
                data[9] |= 0x0c;  /* reg 8, 4:1 scale down */
                fallthrough;
        case 320:
                data[9] |= 0x04;  /* reg 8, 2:1 scale down */
                fallthrough;
        case 640:
        default:
                data[3] = 0x50;  /* reg 2, H size/8 */
                data[4] = 0x78;  /* reg 3, V size/4 */
                data[6] = 0x04;  /* reg 5, H start */
                data[8] = 0x03;  /* reg 7, V start */
                if (sd->sensor_type == 2) {
                        data[6] = 2;
                        data[8] = 1;
                }
                if (sd->do_lcd_stop)
                        data[8] = 0x04;  /* Bayer tile shifted */
                break;

        case 176:
                data[9] |= 0x04;  /* reg 8, 2:1 scale down */
                fallthrough;
        case 352:
                data[3] = 0x2c;  /* reg 2, H size */
                data[4] = 0x48;  /* reg 3, V size */
                data[6] = 0x94;  /* reg 5, H start */
                data[8] = 0x63;  /* reg 7, V start */
                if (sd->do_lcd_stop)
                        data[8] = 0x64;  /* Bayer tile shifted */
                break;
        }

        err_code = mr_write(gspca_dev, 11);
        if (err_code < 0)
                return err_code;

        if (!sd->sensor_type) {
                static const struct sensor_w_data vga_sensor0_init_data[] = {
                        {0x01, 0x00, {0x0c, 0x00, 0x04}, 3},
                        {0x14, 0x00, {0x01, 0xe4, 0x02, 0x84}, 4},
                        {0x20, 0x00, {0x00, 0x80, 0x00, 0x08}, 4},
                        {0x25, 0x00, {0x03, 0xa9, 0x80}, 3},
                        {0x30, 0x00, {0x30, 0x18, 0x10, 0x18}, 4},
                        {0, 0, {0}, 0}
                };
                err_code = sensor_write_regs(gspca_dev, vga_sensor0_init_data,
                                         ARRAY_SIZE(vga_sensor0_init_data));
        } else if (sd->sensor_type == 1) {
                static const struct sensor_w_data color_adj[] = {
                        {0x02, 0x00, {0x06, 0x59, 0x0c, 0x16, 0x00,
                                /* adjusted blue, green, red gain correct
                                   too much blue from the Sakar Digital */
                                0x05, 0x01, 0x04}, 8}
                };

                static const struct sensor_w_data color_no_adj[] = {
                        {0x02, 0x00, {0x06, 0x59, 0x0c, 0x16, 0x00,
                                /* default blue, green, red gain settings */
                                0x07, 0x00, 0x01}, 8}
                };

                static const struct sensor_w_data vga_sensor1_init_data[] = {
                        {0x11, 0x04, {0x01}, 1},
                        {0x0a, 0x00, {0x00, 0x01, 0x00, 0x00, 0x01,
                        /* These settings may be better for some cameras */
                        /* {0x0a, 0x00, {0x01, 0x06, 0x00, 0x00, 0x01, */
                                0x00, 0x0a}, 7},
                        {0x11, 0x04, {0x01}, 1},
                        {0x12, 0x00, {0x00, 0x63, 0x00, 0x70, 0x00, 0x00}, 6},
                        {0x11, 0x04, {0x01}, 1},
                        {0, 0, {0}, 0}
                };

                if (sd->adj_colors)
                        err_code = sensor_write_regs(gspca_dev, color_adj,
                                         ARRAY_SIZE(color_adj));
                else
                        err_code = sensor_write_regs(gspca_dev, color_no_adj,
                                         ARRAY_SIZE(color_no_adj));

                if (err_code < 0)
                        return err_code;

                err_code = sensor_write_regs(gspca_dev, vga_sensor1_init_data,
                                         ARRAY_SIZE(vga_sensor1_init_data));
        } else {        /* sensor type == 2 */
                static const struct sensor_w_data vga_sensor2_init_data[] = {

                        {0x01, 0x00, {0x48}, 1},
                        {0x02, 0x00, {0x22}, 1},
                        /* Reg 3 msb and 4 is lsb of the exposure setting*/
                        {0x05, 0x00, {0x10}, 1},
                        {0x06, 0x00, {0x00}, 1},
                        {0x07, 0x00, {0x00}, 1},
                        {0x08, 0x00, {0x00}, 1},
                        {0x09, 0x00, {0x00}, 1},
                        /* The following are used in the gain control
                         * which is BTW completely borked in the OEM driver
                         * The values for each color go from 0 to 0x7ff
                         *{0x0a, 0x00, {0x01}, 1},  green1 gain msb
                         *{0x0b, 0x00, {0x10}, 1},  green1 gain lsb
                         *{0x0c, 0x00, {0x01}, 1},  red gain msb
                         *{0x0d, 0x00, {0x10}, 1},  red gain lsb
                         *{0x0e, 0x00, {0x01}, 1},  blue gain msb
                         *{0x0f, 0x00, {0x10}, 1},  blue gain lsb
                         *{0x10, 0x00, {0x01}, 1}, green2 gain msb
                         *{0x11, 0x00, {0x10}, 1}, green2 gain lsb
                         */
                        {0x12, 0x00, {0x00}, 1},
                        {0x13, 0x00, {0x04}, 1}, /* weird effect on colors */
                        {0x14, 0x00, {0x00}, 1},
                        {0x15, 0x00, {0x06}, 1},
                        {0x16, 0x00, {0x01}, 1},
                        {0x17, 0x00, {0xe2}, 1}, /* vertical alignment */
                        {0x18, 0x00, {0x02}, 1},
                        {0x19, 0x00, {0x82}, 1}, /* don't mess with */
                        {0x1a, 0x00, {0x00}, 1},
                        {0x1b, 0x00, {0x20}, 1},
                        /* {0x1c, 0x00, {0x17}, 1}, contrast control */
                        {0x1d, 0x00, {0x80}, 1}, /* moving causes a mess */
                        {0x1e, 0x00, {0x08}, 1}, /* moving jams the camera */
                        {0x1f, 0x00, {0x0c}, 1},
                        {0x20, 0x00, {0x00}, 1},
                        {0, 0, {0}, 0}
                };
                err_code = sensor_write_regs(gspca_dev, vga_sensor2_init_data,
                                         ARRAY_SIZE(vga_sensor2_init_data));
        }
        return err_code;
}

static int sd_start(struct gspca_dev *gspca_dev)
{
        struct sd *sd = (struct sd *) gspca_dev;
        int err_code;

        sd->sof_read = 0;

        /* Some of the VGA cameras require the memory pointer
         * to be set to 0 again. We have been forced to start the
         * stream in sd_config() to detect the hardware, and closed it.
         * Thus, we need here to do a completely fresh and clean start. */
        err_code = zero_the_pointer(gspca_dev);
        if (err_code < 0)
                return err_code;

        err_code = stream_start(gspca_dev);
        if (err_code < 0)
                return err_code;

        if (sd->cam_type == CAM_TYPE_CIF) {
                err_code = start_cif_cam(gspca_dev);
        } else {
                err_code = start_vga_cam(gspca_dev);
        }
        if (err_code < 0)
                return err_code;

        return isoc_enable(gspca_dev);
}

static void sd_stopN(struct gspca_dev *gspca_dev)
{
        struct sd *sd = (struct sd *) gspca_dev;

        stream_stop(gspca_dev);
        /* Not all the cams need this, but even if not, probably a good idea */
        zero_the_pointer(gspca_dev);
        if (sd->do_lcd_stop)
                lcd_stop(gspca_dev);
}

static void setbrightness(struct gspca_dev *gspca_dev, s32 val)
{
        struct sd *sd = (struct sd *) gspca_dev;
        u8 sign_reg = 7;  /* This reg and the next one used on CIF cams. */
        u8 value_reg = 8; /* VGA cams seem to use regs 0x0b and 0x0c */
        static const u8 quick_clix_table[] =
        /*        0  1  2   3  4  5  6  7  8  9  10  11  12  13  14  15 */
                { 0, 4, 8, 12, 1, 2, 3, 5, 6, 9,  7, 10, 13, 11, 14, 15};
        if (sd->cam_type == CAM_TYPE_VGA) {
                sign_reg += 4;
                value_reg += 4;
        }

        /* Note register 7 is also seen as 0x8x or 0xCx in some dumps */
        if (val > 0) {
                sensor_write1(gspca_dev, sign_reg, 0x00);
        } else {
                sensor_write1(gspca_dev, sign_reg, 0x01);
                val = 257 - val;
        }
        /* Use lookup table for funky Argus QuickClix brightness */
        if (sd->do_lcd_stop)
                val = quick_clix_table[val];

        sensor_write1(gspca_dev, value_reg, val);
}

static void setexposure(struct gspca_dev *gspca_dev, s32 expo, s32 min_clockdiv)
{
        struct sd *sd = (struct sd *) gspca_dev;
        int exposure = MR97310A_EXPOSURE_DEFAULT;
        u8 buf[2];

        if (sd->cam_type == CAM_TYPE_CIF && sd->sensor_type == 1) {
                /* This cam does not like exposure settings < 300,
                   so scale 0 - 4095 to 300 - 4095 */
                exposure = (expo * 9267) / 10000 + 300;
                sensor_write1(gspca_dev, 3, exposure >> 4);
                sensor_write1(gspca_dev, 4, exposure & 0x0f);
        } else if (sd->sensor_type == 2) {
                exposure = expo;
                exposure >>= 3;
                sensor_write1(gspca_dev, 3, exposure >> 8);
                sensor_write1(gspca_dev, 4, exposure & 0xff);
        } else {
                /* We have both a clock divider and an exposure register.
                   We first calculate the clock divider, as that determines
                   the maximum exposure and then we calculate the exposure
                   register setting (which goes from 0 - 511).

                   Note our 0 - 4095 exposure is mapped to 0 - 511
                   milliseconds exposure time */
                u8 clockdiv = (60 * expo + 7999) / 8000;

                /* Limit framerate to not exceed usb bandwidth */
                if (clockdiv < min_clockdiv && gspca_dev->pixfmt.width >= 320)
                        clockdiv = min_clockdiv;
                else if (clockdiv < 2)
                        clockdiv = 2;

                if (sd->cam_type == CAM_TYPE_VGA && clockdiv < 4)
                        clockdiv = 4;

                /* Frame exposure time in ms = 1000 * clockdiv / 60 ->
                exposure = (sd->exposure / 8) * 511 / (1000 * clockdiv / 60) */
                exposure = (60 * 511 * expo) / (8000 * clockdiv);
                if (exposure > 511)
                        exposure = 511;

                /* exposure register value is reversed! */
                exposure = 511 - exposure;

                buf[0] = exposure & 0xff;
                buf[1] = exposure >> 8;
                sensor_write_reg(gspca_dev, 0x0e, 0, buf, 2);
                sensor_write1(gspca_dev, 0x02, clockdiv);
        }
}

static void setgain(struct gspca_dev *gspca_dev, s32 val)
{
        struct sd *sd = (struct sd *) gspca_dev;
        u8 gainreg;

        if (sd->cam_type == CAM_TYPE_CIF && sd->sensor_type == 1)
                sensor_write1(gspca_dev, 0x0e, val);
        else if (sd->cam_type == CAM_TYPE_VGA && sd->sensor_type == 2)
                for (gainreg = 0x0a; gainreg < 0x11; gainreg += 2) {
                        sensor_write1(gspca_dev, gainreg, val >> 8);
                        sensor_write1(gspca_dev, gainreg + 1, val & 0xff);
                }
        else
                sensor_write1(gspca_dev, 0x10, val);
}

static void setcontrast(struct gspca_dev *gspca_dev, s32 val)
{
        sensor_write1(gspca_dev, 0x1c, val);
}

static int sd_s_ctrl(struct v4l2_ctrl *ctrl)
{
        struct gspca_dev *gspca_dev =
                container_of(ctrl->handler, struct gspca_dev, ctrl_handler);
        struct sd *sd = (struct sd *)gspca_dev;

        gspca_dev->usb_err = 0;

        if (!gspca_dev->streaming)
                return 0;

        switch (ctrl->id) {
        case V4L2_CID_BRIGHTNESS:
                setbrightness(gspca_dev, ctrl->val);
                break;
        case V4L2_CID_CONTRAST:
                setcontrast(gspca_dev, ctrl->val);
                break;
        case V4L2_CID_EXPOSURE:
                setexposure(gspca_dev, sd->exposure->val,
                            sd->min_clockdiv ? sd->min_clockdiv->val : 0);
                break;
        case V4L2_CID_GAIN:
                setgain(gspca_dev, ctrl->val);
                break;
        }
        return gspca_dev->usb_err;
}

static const struct v4l2_ctrl_ops sd_ctrl_ops = {
        .s_ctrl = sd_s_ctrl,
};

static int sd_init_controls(struct gspca_dev *gspca_dev)
{
        struct sd *sd = (struct sd *)gspca_dev;
        struct v4l2_ctrl_handler *hdl = &gspca_dev->ctrl_handler;
        static const struct v4l2_ctrl_config clockdiv = {
                .ops = &sd_ctrl_ops,
                .id = MR97310A_CID_CLOCKDIV,
                .type = V4L2_CTRL_TYPE_INTEGER,
                .name = "Minimum Clock Divider",
                .min = MR97310A_MIN_CLOCKDIV_MIN,
                .max = MR97310A_MIN_CLOCKDIV_MAX,
                .step = 1,
                .def = MR97310A_MIN_CLOCKDIV_DEFAULT,
        };
        bool has_brightness = false;
        bool has_argus_brightness = false;
        bool has_contrast = false;
        bool has_gain = false;
        bool has_cs_gain = false;
        bool has_exposure = false;
        bool has_clockdiv = false;

        gspca_dev->vdev.ctrl_handler = hdl;
        v4l2_ctrl_handler_init(hdl, 4);

        /* Setup controls depending on camera type */
        if (sd->cam_type == CAM_TYPE_CIF) {
                /* No brightness for sensor_type 0 */
                if (sd->sensor_type == 0)
                        has_exposure = has_gain = has_clockdiv = true;
                else
                        has_exposure = has_gain = has_brightness = true;
        } else {
                /* All controls need to be disabled if VGA sensor_type is 0 */
                if (sd->sensor_type == 0)
                        ; /* no controls! */
                else if (sd->sensor_type == 2)
                        has_exposure = has_cs_gain = has_contrast = true;
                else if (sd->do_lcd_stop)
                        has_exposure = has_gain = has_argus_brightness =
                                has_clockdiv = true;
                else
                        has_exposure = has_gain = has_brightness =
                                has_clockdiv = true;
        }

        /* Separate brightness control description for Argus QuickClix as it has
         * different limits from the other mr97310a cameras, and separate gain
         * control for Sakar CyberPix camera. */
        /*
         * This control is disabled for CIF type 1 and VGA type 0 cameras.
         * It does not quite act linearly for the Argus QuickClix camera,
         * but it does control brightness. The values are 0 - 15 only, and
         * the table above makes them act consecutively.
         */
        if (has_brightness)
                v4l2_ctrl_new_std(hdl, &sd_ctrl_ops,
                        V4L2_CID_BRIGHTNESS, -254, 255, 1,
                        MR97310A_BRIGHTNESS_DEFAULT);
        else if (has_argus_brightness)
                v4l2_ctrl_new_std(hdl, &sd_ctrl_ops,
                        V4L2_CID_BRIGHTNESS, 0, 15, 1,
                        MR97310A_BRIGHTNESS_DEFAULT);
        if (has_contrast)
                v4l2_ctrl_new_std(hdl, &sd_ctrl_ops,
                        V4L2_CID_CONTRAST, MR97310A_CONTRAST_MIN,
                        MR97310A_CONTRAST_MAX, 1, MR97310A_CONTRAST_DEFAULT);
        if (has_gain)
                v4l2_ctrl_new_std(hdl, &sd_ctrl_ops,
                        V4L2_CID_GAIN, MR97310A_GAIN_MIN, MR97310A_GAIN_MAX,
                        1, MR97310A_GAIN_DEFAULT);
        else if (has_cs_gain)
                v4l2_ctrl_new_std(hdl, &sd_ctrl_ops, V4L2_CID_GAIN,
                        MR97310A_CS_GAIN_MIN, MR97310A_CS_GAIN_MAX,
                        1, MR97310A_CS_GAIN_DEFAULT);
        if (has_exposure)
                sd->exposure = v4l2_ctrl_new_std(hdl, &sd_ctrl_ops,
                        V4L2_CID_EXPOSURE, MR97310A_EXPOSURE_MIN,
                        MR97310A_EXPOSURE_MAX, 1, MR97310A_EXPOSURE_DEFAULT);
        if (has_clockdiv)
                sd->min_clockdiv = v4l2_ctrl_new_custom(hdl, &clockdiv, NULL);

        if (hdl->error) {
                pr_err("Could not initialize controls\n");
                return hdl->error;
        }
        if (has_exposure && has_clockdiv)

                v4l2_ctrl_cluster(2, &sd->exposure);
        return 0;
}

/* Include pac common sof detection functions */
#include "pac_common.h"

static void sd_pkt_scan(struct gspca_dev *gspca_dev,
                        u8 *data,               /* isoc packet */
                        int len)                /* iso packet length */
{
        struct sd *sd = (struct sd *) gspca_dev;
        unsigned char *sof;

        sof = pac_find_sof(gspca_dev, &sd->sof_read, data, len);
        if (sof) {
                int n;

                /* finish decoding current frame */
                n = sof - data;
                if (n > sizeof pac_sof_marker)
                        n -= sizeof pac_sof_marker;
                else
                        n = 0;
                gspca_frame_add(gspca_dev, LAST_PACKET,
                                        data, n);
                /* Start next frame. */
                gspca_frame_add(gspca_dev, FIRST_PACKET,
                        pac_sof_marker, sizeof pac_sof_marker);
                len -= sof - data;
                data = sof;
        }
        gspca_frame_add(gspca_dev, INTER_PACKET, data, len);
}

/* sub-driver description */
static const struct sd_desc sd_desc = {
        .name = MODULE_NAME,
        .config = sd_config,
        .init = sd_init,
        .init_controls = sd_init_controls,
        .start = sd_start,
        .stopN = sd_stopN,
        .pkt_scan = sd_pkt_scan,
};

/* -- module initialisation -- */
static const struct usb_device_id device_table[] = {
        {USB_DEVICE(0x08ca, 0x0110)},   /* Trust Spyc@m 100 */
        {USB_DEVICE(0x08ca, 0x0111)},   /* Aiptek Pencam VGA+ */
        {USB_DEVICE(0x093a, 0x010f)},   /* All other known MR97310A VGA cams */
        {USB_DEVICE(0x093a, 0x010e)},   /* All known MR97310A CIF cams */
        {}
};
MODULE_DEVICE_TABLE(usb, device_table);

/* -- device connect -- */
static int sd_probe(struct usb_interface *intf,
                    const struct usb_device_id *id)
{
        return gspca_dev_probe(intf, id, &sd_desc, sizeof(struct sd),
                               THIS_MODULE);
}

static struct usb_driver sd_driver = {
        .name = MODULE_NAME,
        .id_table = device_table,
        .probe = sd_probe,
        .disconnect = gspca_disconnect,
#ifdef CONFIG_PM
        .suspend = gspca_suspend,
        .resume = gspca_resume,
        .reset_resume = gspca_resume,
#endif
};

module_usb_driver(sd_driver);