1 /*
2 * Driver for USB webcams based on Konica chipset. This
3 * chipset is used in Intel YC76 camera.
4 *
5 * Copyright (C) 2010 Hans de Goede <hdegoede@redhat.com>
6 *
7 * Based on the usbvideo v4l1 konicawc driver which is:
8 *
9 * Copyright (C) 2002 Simon Evans <spse@secret.org.uk>
10 *
11 * The code for making gspca work with a webcam with 2 isoc endpoints was
12 * taken from the benq gspca subdriver which is:
13 *
14 * Copyright (C) 2009 Jean-Francois Moine (http://moinejf.free.fr)
15 *
16 * This program is free software; you can redistribute it and/or modify
17 * it under the terms of the GNU General Public License as published by
18 * the Free Software Foundation; either version 2 of the License, or
19 * any later version.
20 *
21 * This program is distributed in the hope that it will be useful,
22 * but WITHOUT ANY WARRANTY; without even the implied warranty of
23 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
24 * GNU General Public License for more details.
25 */
26
27 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
28
29 #define MODULE_NAME "konica"
30
31 #include <linux/input.h>
32 #include "gspca.h"
33
34 MODULE_AUTHOR("Hans de Goede <hdegoede@redhat.com>");
35 MODULE_DESCRIPTION("Konica chipset USB Camera Driver");
36 MODULE_LICENSE("GPL");
37
38 #define WHITEBAL_REG 0x01
39 #define BRIGHTNESS_REG 0x02
40 #define SHARPNESS_REG 0x03
41 #define CONTRAST_REG 0x04
42 #define SATURATION_REG 0x05
43
44 /* specific webcam descriptor */
45 struct sd {
46 struct gspca_dev gspca_dev; /* !! must be the first item */
47 struct urb *last_data_urb;
48 u8 snapshot_pressed;
49 };
50
51
52 /* .priv is what goes to register 8 for this mode, known working values:
53 0x00 -> 176x144, cropped
54 0x01 -> 176x144, cropped
55 0x02 -> 176x144, cropped
56 0x03 -> 176x144, cropped
57 0x04 -> 176x144, binned
58 0x05 -> 320x240
59 0x06 -> 320x240
60 0x07 -> 160x120, cropped
61 0x08 -> 160x120, cropped
62 0x09 -> 160x120, binned (note has 136 lines)
63 0x0a -> 160x120, binned (note has 136 lines)
64 0x0b -> 160x120, cropped
65 */
66 static const struct v4l2_pix_format vga_mode[] = {
67 {160, 120, V4L2_PIX_FMT_KONICA420, V4L2_FIELD_NONE,
68 .bytesperline = 160,
69 .sizeimage = 160 * 136 * 3 / 2 + 960,
70 .colorspace = V4L2_COLORSPACE_SRGB,
71 .priv = 0x0a},
72 {176, 144, V4L2_PIX_FMT_KONICA420, V4L2_FIELD_NONE,
73 .bytesperline = 176,
74 .sizeimage = 176 * 144 * 3 / 2 + 960,
75 .colorspace = V4L2_COLORSPACE_SRGB,
76 .priv = 0x04},
77 {320, 240, V4L2_PIX_FMT_KONICA420, V4L2_FIELD_NONE,
78 .bytesperline = 320,
79 .sizeimage = 320 * 240 * 3 / 2 + 960,
80 .colorspace = V4L2_COLORSPACE_SRGB,
81 .priv = 0x05},
82 };
83
84 static void sd_isoc_irq(struct urb *urb);
85
reg_w(struct gspca_dev * gspca_dev,u16 value,u16 index)86 static void reg_w(struct gspca_dev *gspca_dev, u16 value, u16 index)
87 {
88 struct usb_device *dev = gspca_dev->dev;
89 int ret;
90
91 if (gspca_dev->usb_err < 0)
92 return;
93 ret = usb_control_msg(dev, usb_sndctrlpipe(dev, 0),
94 0x02,
95 USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
96 value,
97 index,
98 NULL,
99 0,
100 1000);
101 if (ret < 0) {
102 pr_err("reg_w err writing %02x to %02x: %d\n",
103 value, index, ret);
104 gspca_dev->usb_err = ret;
105 }
106 }
107
reg_r(struct gspca_dev * gspca_dev,u16 value,u16 index)108 static void reg_r(struct gspca_dev *gspca_dev, u16 value, u16 index)
109 {
110 struct usb_device *dev = gspca_dev->dev;
111 int ret;
112
113 if (gspca_dev->usb_err < 0)
114 return;
115 ret = usb_control_msg(dev, usb_rcvctrlpipe(dev, 0),
116 0x03,
117 USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
118 value,
119 index,
120 gspca_dev->usb_buf,
121 2,
122 1000);
123 if (ret < 0) {
124 pr_err("reg_r err %d\n", ret);
125 gspca_dev->usb_err = ret;
126 /*
127 * Make sure the buffer is zeroed to avoid uninitialized
128 * values.
129 */
130 memset(gspca_dev->usb_buf, 0, 2);
131 }
132 }
133
konica_stream_on(struct gspca_dev * gspca_dev)134 static void konica_stream_on(struct gspca_dev *gspca_dev)
135 {
136 reg_w(gspca_dev, 1, 0x0b);
137 }
138
konica_stream_off(struct gspca_dev * gspca_dev)139 static void konica_stream_off(struct gspca_dev *gspca_dev)
140 {
141 reg_w(gspca_dev, 0, 0x0b);
142 }
143
144 /* this function is called at probe time */
sd_config(struct gspca_dev * gspca_dev,const struct usb_device_id * id)145 static int sd_config(struct gspca_dev *gspca_dev,
146 const struct usb_device_id *id)
147 {
148 gspca_dev->cam.cam_mode = vga_mode;
149 gspca_dev->cam.nmodes = ARRAY_SIZE(vga_mode);
150 gspca_dev->cam.no_urb_create = 1;
151
152 return 0;
153 }
154
155 /* this function is called at probe and resume time */
sd_init(struct gspca_dev * gspca_dev)156 static int sd_init(struct gspca_dev *gspca_dev)
157 {
158 int i;
159
160 /*
161 * The konica needs a freaking large time to "boot" (approx 6.5 sec.),
162 * and does not want to be bothered while doing so :|
163 * Register 0x10 counts from 1 - 3, with 3 being "ready"
164 */
165 msleep(6000);
166 for (i = 0; i < 20; i++) {
167 reg_r(gspca_dev, 0, 0x10);
168 if (gspca_dev->usb_buf[0] == 3)
169 break;
170 msleep(100);
171 }
172 reg_w(gspca_dev, 0, 0x0d);
173
174 return gspca_dev->usb_err;
175 }
176
sd_start(struct gspca_dev * gspca_dev)177 static int sd_start(struct gspca_dev *gspca_dev)
178 {
179 struct sd *sd = (struct sd *) gspca_dev;
180 struct urb *urb;
181 int i, n, packet_size;
182 struct usb_host_interface *alt;
183 struct usb_interface *intf;
184
185 intf = usb_ifnum_to_if(sd->gspca_dev.dev, sd->gspca_dev.iface);
186 alt = usb_altnum_to_altsetting(intf, sd->gspca_dev.alt);
187 if (!alt) {
188 pr_err("Couldn't get altsetting\n");
189 return -EIO;
190 }
191
192 if (alt->desc.bNumEndpoints < 2)
193 return -ENODEV;
194
195 packet_size = le16_to_cpu(alt->endpoint[0].desc.wMaxPacketSize);
196
197 n = gspca_dev->cam.cam_mode[gspca_dev->curr_mode].priv;
198 reg_w(gspca_dev, n, 0x08);
199
200 konica_stream_on(gspca_dev);
201
202 if (gspca_dev->usb_err)
203 return gspca_dev->usb_err;
204
205 /* create 4 URBs - 2 on endpoint 0x83 and 2 on 0x082 */
206 #if MAX_NURBS < 4
207 #error "Not enough URBs in the gspca table"
208 #endif
209 #define SD_NPKT 32
210 for (n = 0; n < 4; n++) {
211 i = n & 1 ? 0 : 1;
212 packet_size =
213 le16_to_cpu(alt->endpoint[i].desc.wMaxPacketSize);
214 urb = usb_alloc_urb(SD_NPKT, GFP_KERNEL);
215 if (!urb)
216 return -ENOMEM;
217 gspca_dev->urb[n] = urb;
218 urb->transfer_buffer = usb_alloc_coherent(gspca_dev->dev,
219 packet_size * SD_NPKT,
220 GFP_KERNEL,
221 &urb->transfer_dma);
222 if (urb->transfer_buffer == NULL) {
223 pr_err("usb_buffer_alloc failed\n");
224 return -ENOMEM;
225 }
226
227 urb->dev = gspca_dev->dev;
228 urb->context = gspca_dev;
229 urb->transfer_buffer_length = packet_size * SD_NPKT;
230 urb->pipe = usb_rcvisocpipe(gspca_dev->dev,
231 n & 1 ? 0x81 : 0x82);
232 urb->transfer_flags = URB_ISO_ASAP
233 | URB_NO_TRANSFER_DMA_MAP;
234 urb->interval = 1;
235 urb->complete = sd_isoc_irq;
236 urb->number_of_packets = SD_NPKT;
237 for (i = 0; i < SD_NPKT; i++) {
238 urb->iso_frame_desc[i].length = packet_size;
239 urb->iso_frame_desc[i].offset = packet_size * i;
240 }
241 }
242
243 return 0;
244 }
245
sd_stopN(struct gspca_dev * gspca_dev)246 static void sd_stopN(struct gspca_dev *gspca_dev)
247 {
248 struct sd *sd __maybe_unused = (struct sd *) gspca_dev;
249
250 konica_stream_off(gspca_dev);
251 #if IS_ENABLED(CONFIG_INPUT)
252 /* Don't keep the button in the pressed state "forever" if it was
253 pressed when streaming is stopped */
254 if (sd->snapshot_pressed) {
255 input_report_key(gspca_dev->input_dev, KEY_CAMERA, 0);
256 input_sync(gspca_dev->input_dev);
257 sd->snapshot_pressed = 0;
258 }
259 #endif
260 }
261
262 /* reception of an URB */
sd_isoc_irq(struct urb * urb)263 static void sd_isoc_irq(struct urb *urb)
264 {
265 struct gspca_dev *gspca_dev = (struct gspca_dev *) urb->context;
266 struct sd *sd = (struct sd *) gspca_dev;
267 struct urb *data_urb, *status_urb;
268 u8 *data;
269 int i, st;
270
271 gspca_dbg(gspca_dev, D_PACK, "sd isoc irq\n");
272 if (!gspca_dev->streaming)
273 return;
274
275 if (urb->status != 0) {
276 if (urb->status == -ESHUTDOWN)
277 return; /* disconnection */
278 #ifdef CONFIG_PM
279 if (gspca_dev->frozen)
280 return;
281 #endif
282 gspca_err(gspca_dev, "urb status: %d\n", urb->status);
283 st = usb_submit_urb(urb, GFP_ATOMIC);
284 if (st < 0)
285 pr_err("resubmit urb error %d\n", st);
286 return;
287 }
288
289 /* if this is a data URB (ep 0x82), wait */
290 if (urb->transfer_buffer_length > 32) {
291 sd->last_data_urb = urb;
292 return;
293 }
294
295 status_urb = urb;
296 data_urb = sd->last_data_urb;
297 sd->last_data_urb = NULL;
298
299 if (!data_urb || data_urb->start_frame != status_urb->start_frame) {
300 gspca_err(gspca_dev, "lost sync on frames\n");
301 goto resubmit;
302 }
303
304 if (data_urb->number_of_packets != status_urb->number_of_packets) {
305 gspca_err(gspca_dev, "no packets does not match, data: %d, status: %d\n",
306 data_urb->number_of_packets,
307 status_urb->number_of_packets);
308 goto resubmit;
309 }
310
311 for (i = 0; i < status_urb->number_of_packets; i++) {
312 if (data_urb->iso_frame_desc[i].status ||
313 status_urb->iso_frame_desc[i].status) {
314 gspca_err(gspca_dev, "pkt %d data-status %d, status-status %d\n",
315 i,
316 data_urb->iso_frame_desc[i].status,
317 status_urb->iso_frame_desc[i].status);
318 gspca_dev->last_packet_type = DISCARD_PACKET;
319 continue;
320 }
321
322 if (status_urb->iso_frame_desc[i].actual_length != 1) {
323 gspca_err(gspca_dev, "bad status packet length %d\n",
324 status_urb->iso_frame_desc[i].actual_length);
325 gspca_dev->last_packet_type = DISCARD_PACKET;
326 continue;
327 }
328
329 st = *((u8 *)status_urb->transfer_buffer
330 + status_urb->iso_frame_desc[i].offset);
331
332 data = (u8 *)data_urb->transfer_buffer
333 + data_urb->iso_frame_desc[i].offset;
334
335 /* st: 0x80-0xff: frame start with frame number (ie 0-7f)
336 * otherwise:
337 * bit 0 0: keep packet
338 * 1: drop packet (padding data)
339 *
340 * bit 4 0 button not clicked
341 * 1 button clicked
342 * button is used to `take a picture' (in software)
343 */
344 if (st & 0x80) {
345 gspca_frame_add(gspca_dev, LAST_PACKET, NULL, 0);
346 gspca_frame_add(gspca_dev, FIRST_PACKET, NULL, 0);
347 } else {
348 #if IS_ENABLED(CONFIG_INPUT)
349 u8 button_state = st & 0x40 ? 1 : 0;
350 if (sd->snapshot_pressed != button_state) {
351 input_report_key(gspca_dev->input_dev,
352 KEY_CAMERA,
353 button_state);
354 input_sync(gspca_dev->input_dev);
355 sd->snapshot_pressed = button_state;
356 }
357 #endif
358 if (st & 0x01)
359 continue;
360 }
361 gspca_frame_add(gspca_dev, INTER_PACKET, data,
362 data_urb->iso_frame_desc[i].actual_length);
363 }
364
365 resubmit:
366 if (data_urb) {
367 st = usb_submit_urb(data_urb, GFP_ATOMIC);
368 if (st < 0)
369 gspca_err(gspca_dev, "usb_submit_urb(data_urb) ret %d\n",
370 st);
371 }
372 st = usb_submit_urb(status_urb, GFP_ATOMIC);
373 if (st < 0)
374 gspca_err(gspca_dev, "usb_submit_urb(status_urb) ret %d\n", st);
375 }
376
sd_s_ctrl(struct v4l2_ctrl * ctrl)377 static int sd_s_ctrl(struct v4l2_ctrl *ctrl)
378 {
379 struct gspca_dev *gspca_dev =
380 container_of(ctrl->handler, struct gspca_dev, ctrl_handler);
381
382 gspca_dev->usb_err = 0;
383
384 if (!gspca_dev->streaming)
385 return 0;
386
387 switch (ctrl->id) {
388 case V4L2_CID_BRIGHTNESS:
389 konica_stream_off(gspca_dev);
390 reg_w(gspca_dev, ctrl->val, BRIGHTNESS_REG);
391 konica_stream_on(gspca_dev);
392 break;
393 case V4L2_CID_CONTRAST:
394 konica_stream_off(gspca_dev);
395 reg_w(gspca_dev, ctrl->val, CONTRAST_REG);
396 konica_stream_on(gspca_dev);
397 break;
398 case V4L2_CID_SATURATION:
399 konica_stream_off(gspca_dev);
400 reg_w(gspca_dev, ctrl->val, SATURATION_REG);
401 konica_stream_on(gspca_dev);
402 break;
403 case V4L2_CID_WHITE_BALANCE_TEMPERATURE:
404 konica_stream_off(gspca_dev);
405 reg_w(gspca_dev, ctrl->val, WHITEBAL_REG);
406 konica_stream_on(gspca_dev);
407 break;
408 case V4L2_CID_SHARPNESS:
409 konica_stream_off(gspca_dev);
410 reg_w(gspca_dev, ctrl->val, SHARPNESS_REG);
411 konica_stream_on(gspca_dev);
412 break;
413 }
414 return gspca_dev->usb_err;
415 }
416
417 static const struct v4l2_ctrl_ops sd_ctrl_ops = {
418 .s_ctrl = sd_s_ctrl,
419 };
420
sd_init_controls(struct gspca_dev * gspca_dev)421 static int sd_init_controls(struct gspca_dev *gspca_dev)
422 {
423 struct v4l2_ctrl_handler *hdl = &gspca_dev->ctrl_handler;
424
425 gspca_dev->vdev.ctrl_handler = hdl;
426 v4l2_ctrl_handler_init(hdl, 5);
427 v4l2_ctrl_new_std(hdl, &sd_ctrl_ops,
428 V4L2_CID_BRIGHTNESS, 0, 9, 1, 4);
429 /* Needs to be verified */
430 v4l2_ctrl_new_std(hdl, &sd_ctrl_ops,
431 V4L2_CID_CONTRAST, 0, 9, 1, 4);
432 v4l2_ctrl_new_std(hdl, &sd_ctrl_ops,
433 V4L2_CID_SATURATION, 0, 9, 1, 4);
434 v4l2_ctrl_new_std(hdl, &sd_ctrl_ops,
435 V4L2_CID_WHITE_BALANCE_TEMPERATURE,
436 0, 33, 1, 25);
437 v4l2_ctrl_new_std(hdl, &sd_ctrl_ops,
438 V4L2_CID_SHARPNESS, 0, 9, 1, 4);
439
440 if (hdl->error) {
441 pr_err("Could not initialize controls\n");
442 return hdl->error;
443 }
444 return 0;
445 }
446
447 /* sub-driver description */
448 static const struct sd_desc sd_desc = {
449 .name = MODULE_NAME,
450 .config = sd_config,
451 .init = sd_init,
452 .init_controls = sd_init_controls,
453 .start = sd_start,
454 .stopN = sd_stopN,
455 #if IS_ENABLED(CONFIG_INPUT)
456 .other_input = 1,
457 #endif
458 };
459
460 /* -- module initialisation -- */
461 static const struct usb_device_id device_table[] = {
462 {USB_DEVICE(0x04c8, 0x0720)}, /* Intel YC 76 */
463 {}
464 };
465 MODULE_DEVICE_TABLE(usb, device_table);
466
467 /* -- device connect -- */
sd_probe(struct usb_interface * intf,const struct usb_device_id * id)468 static int sd_probe(struct usb_interface *intf,
469 const struct usb_device_id *id)
470 {
471 return gspca_dev_probe(intf, id, &sd_desc, sizeof(struct sd),
472 THIS_MODULE);
473 }
474
475 static struct usb_driver sd_driver = {
476 .name = MODULE_NAME,
477 .id_table = device_table,
478 .probe = sd_probe,
479 .disconnect = gspca_disconnect,
480 #ifdef CONFIG_PM
481 .suspend = gspca_suspend,
482 .resume = gspca_resume,
483 .reset_resume = gspca_resume,
484 #endif
485 };
486
487 module_usb_driver(sd_driver);
488