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