// 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);