// SPDX-License-Identifier: GPL-2.0-or-later /* * GSPCA Endpoints (formerly known as AOX) se401 USB Camera sub Driver * * Copyright (C) 2011 Hans de Goede <hdegoede@redhat.com> * * Based on the v4l1 se401 driver which is: * * Copyright (c) 2000 Jeroen B. Vreeken (pe1rxq@amsat.org)
*/
#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
#define MODULE_NAME "se401"
#define BULK_SIZE 4096 #define PACKET_SIZE 1024 #define READ_REQ_SIZE 64 #define MAX_MODES ((READ_REQ_SIZE - 6) / 4) /* The se401 compression algorithm uses a fixed quant factor, which can be configured by setting the high nibble of the SE401_OPERATINGMODE
feature. This needs to exactly match what is in libv4l! */ #define SE401_QUANT_FACT 8
staticvoid setbrightness(struct gspca_dev *gspca_dev, s32 val)
{ /* HDG: this does not seem to do anything on my cam */
se401_write_req(gspca_dev, SE401_REQ_SET_BRT, val, 0);
}
/* red color gain */
se401_set_feature(gspca_dev, HV7131_REG_ARCG, gain); /* green color gain */
se401_set_feature(gspca_dev, HV7131_REG_AGCG, gain); /* blue color gain */
se401_set_feature(gspca_dev, HV7131_REG_ABCG, gain);
}
/* Do this before the set_feature calls, for proper timing wrt the interrupt driven pkt_scan. Note we may still race but that is not a big issue, the expo change state machine is merely for avoiding underexposed frames getting send out, if one sneaks
through so be it */
sd->expo_change_state = EXPO_CHANGED;
/* Read the camera descriptor */
se401_read_req(gspca_dev, SE401_REQ_GET_CAMERA_DESCRIPTOR, 1); if (gspca_dev->usb_err) { /* Sometimes after being idle for a while the se401 won't
respond and needs a good kicking */
usb_reset_device(gspca_dev->dev);
gspca_dev->usb_err = 0;
se401_read_req(gspca_dev, SE401_REQ_GET_CAMERA_DESCRIPTOR, 0);
}
/* Some cameras start with their LED on */
se401_write_req(gspca_dev, SE401_REQ_LED_CONTROL, 0, 0); if (gspca_dev->usb_err) return gspca_dev->usb_err;
if (!(cd[2] & SE401_FORMAT_BAYER)) {
pr_err("Bayer format not supported!\n"); return -ENODEV;
}
if (cd[3])
pr_info("ExtraFeatures: %d\n", cd[3]);
n = cd[4] | (cd[5] << 8); if (n > MAX_MODES) {
pr_err("Too many frame sizes\n"); return -ENODEV;
}
for (i = 0; i < n ; i++) {
widths[i] = cd[6 + i * 4 + 0] | (cd[6 + i * 4 + 1] << 8);
heights[i] = cd[6 + i * 4 + 2] | (cd[6 + i * 4 + 3] << 8);
}
for (i = 0; i < n ; i++) {
sd->fmts[i].width = widths[i];
sd->fmts[i].height = heights[i];
sd->fmts[i].field = V4L2_FIELD_NONE;
sd->fmts[i].colorspace = V4L2_COLORSPACE_SRGB;
sd->fmts[i].priv = 1;
/* janggu compression only works for 1/4th or 1/16th res */ for (j = 0; j < n; j++) { if (widths[j] / 2 == widths[i] &&
heights[j] / 2 == heights[i]) {
sd->fmts[i].priv = 2; break;
}
} /* 1/16th if available too is better then 1/4th, because
we then use a larger area of the sensor */ for (j = 0; j < n; j++) { if (widths[j] / 4 == widths[i] &&
heights[j] / 4 == heights[i]) {
sd->fmts[i].priv = 4; break;
}
}
if (sd->fmts[i].priv == 1) { /* Not a 1/4th or 1/16th res, use bayer */
sd->fmts[i].pixelformat = V4L2_PIX_FMT_SBGGR8;
sd->fmts[i].bytesperline = widths[i];
sd->fmts[i].sizeimage = widths[i] * heights[i];
pr_info("Frame size: %dx%d bayer\n",
widths[i], heights[i]);
} else { /* Found a match use janggu compression */
sd->fmts[i].pixelformat = V4L2_PIX_FMT_SE401;
sd->fmts[i].bytesperline = 0;
sd->fmts[i].sizeimage = widths[i] * heights[i] * 3;
pr_info("Frame size: %dx%d 1/%dth janggu\n",
widths[i], heights[i],
sd->fmts[i].priv * sd->fmts[i].priv);
}
}
/* See if the camera supports brightness */
se401_read_req(gspca_dev, SE401_REQ_GET_BRT, 1);
sd->has_brightness = !!gspca_dev->usb_err;
gspca_dev->usb_err = 0;
return 0;
}
/* this function is called at probe and resume time */ staticint sd_init(struct gspca_dev *gspca_dev)
{ return 0;
}
/* function called at start time before URB creation */ staticint sd_isoc_init(struct gspca_dev *gspca_dev)
{
gspca_dev->alt = 1; /* Ignore the bogus isoc alt settings */
return gspca_dev->usb_err;
}
/* -- start the camera -- */ staticint sd_start(struct gspca_dev *gspca_dev)
{ struct sd *sd = (struct sd *)gspca_dev; int mult = gspca_dev->cam.cam_mode[gspca_dev->curr_mode].priv; int mode = 0;
se401_write_req(gspca_dev, SE401_REQ_CAMERA_POWER, 1, 1); if (gspca_dev->usb_err) { /* Sometimes after being idle for a while the se401 won't
respond and needs a good kicking */
usb_reset_device(gspca_dev->dev);
gspca_dev->usb_err = 0;
se401_write_req(gspca_dev, SE401_REQ_CAMERA_POWER, 1, 0);
}
se401_write_req(gspca_dev, SE401_REQ_LED_CONTROL, 1, 0);
/* set size + mode */
se401_write_req(gspca_dev, SE401_REQ_SET_WIDTH,
gspca_dev->pixfmt.width * mult, 0);
se401_write_req(gspca_dev, SE401_REQ_SET_HEIGHT,
gspca_dev->pixfmt.height * mult, 0); /* * HDG: disabled this as it does not seem to do anything * se401_write_req(gspca_dev, SE401_REQ_SET_OUTPUT_MODE, * SE401_FORMAT_BAYER, 0);
*/
/* Restart the stream if requested do so by pkt_scan */ if (sd->restart_stream) {
sd_stopN(gspca_dev);
sd_start(gspca_dev);
sd->restart_stream = 0;
}
/* Automatically adjust sensor reset level Hyundai have some really nice docs about this and other sensor
related stuff on their homepage: www.hei.co.kr */
sd->resetlevel_frame_count++; if (sd->resetlevel_frame_count < 20) return;
/* For some reason this normally read-only register doesn't get reset
to zero after reading them just once... */
se401_get_feature(gspca_dev, HV7131_REG_HIREFNOH);
se401_get_feature(gspca_dev, HV7131_REG_HIREFNOL);
se401_get_feature(gspca_dev, HV7131_REG_LOREFNOH);
se401_get_feature(gspca_dev, HV7131_REG_LOREFNOL);
ahrc = 256*se401_get_feature(gspca_dev, HV7131_REG_HIREFNOH) +
se401_get_feature(gspca_dev, HV7131_REG_HIREFNOL);
alrc = 256*se401_get_feature(gspca_dev, HV7131_REG_LOREFNOH) +
se401_get_feature(gspca_dev, HV7131_REG_LOREFNOL);
/* Not an exact science, but it seems to work pretty well... */
oldreset = sd->resetlevel; if (alrc > 10) { while (alrc >= 10 && sd->resetlevel < 63) {
sd->resetlevel++;
alrc /= 2;
}
} elseif (ahrc > 20) { while (ahrc >= 20 && sd->resetlevel > 0) {
sd->resetlevel--;
ahrc /= 2;
}
} /* Detect ping-pong-ing and halve adjustment to avoid overshoot */ if (sd->resetlevel > oldreset)
adjust_dir = 1; else
adjust_dir = -1; if (sd->resetlevel_adjust_dir &&
sd->resetlevel_adjust_dir != adjust_dir)
sd->resetlevel = oldreset + (sd->resetlevel - oldreset) / 2;
switch (sd->expo_change_state) { case EXPO_CHANGED: /* The exposure was changed while this frame
was being send, so this frame is ok */
sd->expo_change_state = EXPO_DROP_FRAME; break; case EXPO_DROP_FRAME: /* The exposure was changed while this frame
was being captured, drop it! */
gspca_dev->last_packet_type = DISCARD_PACKET;
sd->expo_change_state = EXPO_NO_CHANGE; break; case EXPO_NO_CHANGE: break;
}
gspca_frame_add(gspca_dev, LAST_PACKET, data, len);
}
staticvoid sd_pkt_scan_janggu(struct gspca_dev *gspca_dev, u8 *data, int len)
{ struct sd *sd = (struct sd *)gspca_dev; int imagesize = gspca_dev->pixfmt.width * gspca_dev->pixfmt.height; int i, plen, bits, pixels, info, count;
if (sd->restart_stream) return;
/* Sometimes a 1024 bytes garbage bulk packet is send between frames */ if (gspca_dev->last_packet_type == LAST_PACKET && len == 1024) {
gspca_dev->last_packet_type = DISCARD_PACKET; return;
}
i = 0; while (i < len) { /* Read header if not already be present from prev bulk pkt */ if (sd->packet_read < 4) {
count = 4 - sd->packet_read; if (count > len - i)
count = len - i;
memcpy(&sd->packet[sd->packet_read], &data[i], count);
sd->packet_read += count;
i += count; if (sd->packet_read < 4) break;
}
bits = sd->packet[3] + (sd->packet[2] << 8);
pixels = sd->packet[1] + ((sd->packet[0] & 0x3f) << 8);
info = (sd->packet[0] & 0xc0) >> 6;
plen = ((bits + 47) >> 4) << 1; /* Sanity checks */ if (plen > 1024) {
pr_err("invalid packet len %d restarting stream\n",
plen); goto error;
} if (info == 3) {
pr_err("unknown frame info value restarting stream\n"); goto error;
}
/* Read (remainder of) packet contents */
count = plen - sd->packet_read; if (count > len - i)
count = len - i;
memcpy(&sd->packet[sd->packet_read], &data[i], count);
sd->packet_read += count;
i += count; if (sd->packet_read < plen) break;
sd->pixels_read += pixels;
sd->packet_read = 0;
switch (info) { case 0: /* Frame data */
gspca_frame_add(gspca_dev, INTER_PACKET, sd->packet,
plen); break; case 1: /* EOF */ if (sd->pixels_read != imagesize) {
pr_err("frame size %d expected %d\n",
sd->pixels_read, imagesize); goto error;
}
sd_complete_frame(gspca_dev, sd->packet, plen); return; /* Discard the rest of the bulk packet !! */ case 2: /* SOF */
gspca_frame_add(gspca_dev, FIRST_PACKET, sd->packet,
plen);
sd->pixels_read = pixels; break;
}
} return;
error:
sd->restart_stream = 1; /* Give userspace a 0 bytes frame, so our dq callback gets
called and it can restart the stream */
gspca_frame_add(gspca_dev, FIRST_PACKET, NULL, 0);
gspca_frame_add(gspca_dev, LAST_PACKET, NULL, 0);
}
staticvoid sd_pkt_scan_bayer(struct gspca_dev *gspca_dev, u8 *data, int len)
{ struct cam *cam = &gspca_dev->cam; int imagesize = cam->cam_mode[gspca_dev->curr_mode].sizeimage;
Die Informationen auf dieser Webseite wurden
nach bestem Wissen sorgfältig zusammengestellt. Es wird jedoch weder Vollständigkeit, noch Richtigkeit,
noch Qualität der bereit gestellten Informationen zugesichert.
Bemerkung:
Die farbliche Syntaxdarstellung und die Messung sind noch experimentell.