Commit | Line | Data |
---|---|---|
483dfdb6 | 1 | /* |
7ca659e3 | 2 | * USB USBVISION Video device driver 0.9.9 |
483dfdb6 TM |
3 | * |
4 | * | |
5 | * | |
6 | * Copyright (c) 1999-2005 Joerg Heckenbach <joerg@heckenbach-aw.de> | |
7 | * | |
8 | * This module is part of usbvision driver project. | |
9 | * | |
10 | * This program is free software; you can redistribute it and/or modify | |
11 | * it under the terms of the GNU General Public License as published by | |
12 | * the Free Software Foundation; either version 2 of the License, or | |
13 | * (at your option) any later version. | |
14 | * | |
15 | * This program is distributed in the hope that it will be useful, | |
16 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
17 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
18 | * GNU General Public License for more details. | |
19 | * | |
20 | * You should have received a copy of the GNU General Public License | |
21 | * along with this program; if not, write to the Free Software | |
22 | * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. | |
23 | * | |
24 | * Let's call the version 0.... until compression decoding is completely | |
25 | * implemented. | |
26 | * | |
27 | * This driver is written by Jose Ignacio Gijon and Joerg Heckenbach. | |
28 | * It was based on USB CPiA driver written by Peter Pregler, | |
29 | * Scott J. Bertin and Johannes Erdfelt | |
30 | * Ideas are taken from bttv driver by Ralph Metzler, Marcus Metzler & | |
31 | * Gerd Knorr and zoran 36120/36125 driver by Pauline Middelink | |
32 | * Updates to driver completed by Dwaine P. Garden | |
33 | * | |
34 | * | |
35 | * TODO: | |
36 | * - use submit_urb for all setup packets | |
37 | * - Fix memory settings for nt1004. It is 4 times as big as the | |
38 | * nt1003 memory. | |
c5f48367 TM |
39 | * - Add audio on endpoint 3 for nt1004 chip. |
40 | * Seems impossible, needs a codec interface. Which one? | |
483dfdb6 TM |
41 | * - Clean up the driver. |
42 | * - optimization for performance. | |
43 | * - Add Videotext capability (VBI). Working on it..... | |
44 | * - Check audio for other devices | |
45 | * | |
46 | */ | |
47 | ||
f30ebd43 | 48 | #include <linux/version.h> |
483dfdb6 | 49 | #include <linux/kernel.h> |
483dfdb6 TM |
50 | #include <linux/list.h> |
51 | #include <linux/timer.h> | |
52 | #include <linux/slab.h> | |
53 | #include <linux/mm.h> | |
54 | #include <linux/utsname.h> | |
55 | #include <linux/highmem.h> | |
483dfdb6 TM |
56 | #include <linux/vmalloc.h> |
57 | #include <linux/module.h> | |
58 | #include <linux/init.h> | |
59 | #include <linux/spinlock.h> | |
60 | #include <asm/io.h> | |
61 | #include <linux/videodev2.h> | |
483dfdb6 TM |
62 | #include <linux/i2c.h> |
63 | ||
64 | #include <media/saa7115.h> | |
65 | #include <media/v4l2-common.h> | |
35ea11ff | 66 | #include <media/v4l2-ioctl.h> |
483dfdb6 | 67 | #include <media/tuner.h> |
483dfdb6 | 68 | |
a1ed551c | 69 | #include <linux/workqueue.h> |
483dfdb6 | 70 | |
483dfdb6 | 71 | #include "usbvision.h" |
659ae56d | 72 | #include "usbvision-cards.h" |
483dfdb6 | 73 | |
c5f48367 TM |
74 | #define DRIVER_AUTHOR "Joerg Heckenbach <joerg@heckenbach-aw.de>,\ |
75 | Dwaine Garden <DwaineGarden@rogers.com>" | |
483dfdb6 TM |
76 | #define DRIVER_NAME "usbvision" |
77 | #define DRIVER_ALIAS "USBVision" | |
78 | #define DRIVER_DESC "USBVision USB Video Device Driver for Linux" | |
79 | #define DRIVER_LICENSE "GPL" | |
80 | #define USBVISION_DRIVER_VERSION_MAJOR 0 | |
81 | #define USBVISION_DRIVER_VERSION_MINOR 9 | |
82 | #define USBVISION_DRIVER_VERSION_PATCHLEVEL 9 | |
c5f48367 TM |
83 | #define USBVISION_DRIVER_VERSION KERNEL_VERSION(USBVISION_DRIVER_VERSION_MAJOR,\ |
84 | USBVISION_DRIVER_VERSION_MINOR,\ | |
85 | USBVISION_DRIVER_VERSION_PATCHLEVEL) | |
86 | #define USBVISION_VERSION_STRING __stringify(USBVISION_DRIVER_VERSION_MAJOR)\ | |
87 | "." __stringify(USBVISION_DRIVER_VERSION_MINOR)\ | |
88 | "." __stringify(USBVISION_DRIVER_VERSION_PATCHLEVEL) | |
483dfdb6 TM |
89 | |
90 | #define ENABLE_HEXDUMP 0 /* Enable if you need it */ | |
91 | ||
92 | ||
483dfdb6 | 93 | #ifdef USBVISION_DEBUG |
df18c319 | 94 | #define PDEBUG(level, fmt, args...) { \ |
c5f48367 | 95 | if (video_debug & (level)) \ |
a482f327 GKH |
96 | printk(KERN_INFO KBUILD_MODNAME ":[%s:%d] " fmt, \ |
97 | __func__, __LINE__ , ## args); \ | |
df18c319 | 98 | } |
483dfdb6 TM |
99 | #else |
100 | #define PDEBUG(level, fmt, args...) do {} while(0) | |
101 | #endif | |
102 | ||
483dfdb6 TM |
103 | #define DBG_IO 1<<1 |
104 | #define DBG_PROBE 1<<2 | |
c876a346 | 105 | #define DBG_MMAP 1<<3 |
483dfdb6 TM |
106 | |
107 | //String operations | |
108 | #define rmspace(str) while(*str==' ') str++; | |
109 | #define goto2next(str) while(*str!=' ') str++; while(*str==' ') str++; | |
110 | ||
111 | ||
c5f48367 | 112 | /* sequential number of usbvision device */ |
ff699e6b | 113 | static int usbvision_nr; |
483dfdb6 TM |
114 | |
115 | static struct usbvision_v4l2_format_st usbvision_v4l2_format[] = { | |
116 | { 1, 1, 8, V4L2_PIX_FMT_GREY , "GREY" }, | |
117 | { 1, 2, 16, V4L2_PIX_FMT_RGB565 , "RGB565" }, | |
118 | { 1, 3, 24, V4L2_PIX_FMT_RGB24 , "RGB24" }, | |
119 | { 1, 4, 32, V4L2_PIX_FMT_RGB32 , "RGB32" }, | |
120 | { 1, 2, 16, V4L2_PIX_FMT_RGB555 , "RGB555" }, | |
121 | { 1, 2, 16, V4L2_PIX_FMT_YUYV , "YUV422" }, | |
122 | { 1, 2, 12, V4L2_PIX_FMT_YVU420 , "YUV420P" }, // 1.5 ! | |
123 | { 1, 2, 16, V4L2_PIX_FMT_YUV422P , "YUV422P" } | |
124 | }; | |
125 | ||
c5f48367 | 126 | /* Function prototypes */ |
483dfdb6 TM |
127 | static void usbvision_release(struct usb_usbvision *usbvision); |
128 | ||
c84e6036 | 129 | /* Default initialization of device driver parameters */ |
c5f48367 TM |
130 | /* Set the default format for ISOC endpoint */ |
131 | static int isocMode = ISOC_MODE_COMPRESS; | |
132 | /* Set the default Debug Mode of the device driver */ | |
ff699e6b | 133 | static int video_debug; |
c5f48367 TM |
134 | /* Set the default device to power on at startup */ |
135 | static int PowerOnAtOpen = 1; | |
136 | /* Sequential Number of Video Device */ | |
137 | static int video_nr = -1; | |
138 | /* Sequential Number of Radio Device */ | |
139 | static int radio_nr = -1; | |
140 | /* Sequential Number of VBI Device */ | |
141 | static int vbi_nr = -1; | |
142 | ||
143 | /* Grab parameters for the device driver */ | |
144 | ||
145 | /* Showing parameters under SYSFS */ | |
483dfdb6 TM |
146 | module_param(isocMode, int, 0444); |
147 | module_param(video_debug, int, 0444); | |
148 | module_param(PowerOnAtOpen, int, 0444); | |
149 | module_param(video_nr, int, 0444); | |
150 | module_param(radio_nr, int, 0444); | |
151 | module_param(vbi_nr, int, 0444); | |
483dfdb6 TM |
152 | |
153 | MODULE_PARM_DESC(isocMode, " Set the default format for ISOC endpoint. Default: 0x60 (Compression On)"); | |
154 | MODULE_PARM_DESC(video_debug, " Set the default Debug Mode of the device driver. Default: 0 (Off)"); | |
155 | MODULE_PARM_DESC(PowerOnAtOpen, " Set the default device to power on when device is opened. Default: 1 (On)"); | |
156 | MODULE_PARM_DESC(video_nr, "Set video device number (/dev/videoX). Default: -1 (autodetect)"); | |
157 | MODULE_PARM_DESC(radio_nr, "Set radio device number (/dev/radioX). Default: -1 (autodetect)"); | |
158 | MODULE_PARM_DESC(vbi_nr, "Set vbi device number (/dev/vbiX). Default: -1 (autodetect)"); | |
483dfdb6 TM |
159 | |
160 | ||
161 | // Misc stuff | |
162 | MODULE_AUTHOR(DRIVER_AUTHOR); | |
163 | MODULE_DESCRIPTION(DRIVER_DESC); | |
164 | MODULE_LICENSE(DRIVER_LICENSE); | |
a1ed551c MCC |
165 | MODULE_VERSION(USBVISION_VERSION_STRING); |
166 | MODULE_ALIAS(DRIVER_ALIAS); | |
483dfdb6 TM |
167 | |
168 | ||
c5f48367 TM |
169 | /*****************************************************************************/ |
170 | /* SYSFS Code - Copied from the stv680.c usb module. */ | |
171 | /* Device information is located at /sys/class/video4linux/video0 */ | |
172 | /* Device parameters information is located at /sys/module/usbvision */ | |
173 | /* Device USB Information is located at */ | |
174 | /* /sys/bus/usb/drivers/USBVision Video Grabber */ | |
175 | /*****************************************************************************/ | |
483dfdb6 | 176 | |
483dfdb6 TM |
177 | #define YES_NO(x) ((x) ? "Yes" : "No") |
178 | ||
54bd5b66 | 179 | static inline struct usb_usbvision *cd_to_usbvision(struct device *cd) |
483dfdb6 | 180 | { |
c5f48367 | 181 | struct video_device *vdev = |
22a04f10 | 182 | container_of(cd, struct video_device, dev); |
483dfdb6 TM |
183 | return video_get_drvdata(vdev); |
184 | } | |
185 | ||
54bd5b66 KS |
186 | static ssize_t show_version(struct device *cd, |
187 | struct device_attribute *attr, char *buf) | |
483dfdb6 TM |
188 | { |
189 | return sprintf(buf, "%s\n", USBVISION_VERSION_STRING); | |
190 | } | |
54bd5b66 | 191 | static DEVICE_ATTR(version, S_IRUGO, show_version, NULL); |
483dfdb6 | 192 | |
54bd5b66 KS |
193 | static ssize_t show_model(struct device *cd, |
194 | struct device_attribute *attr, char *buf) | |
483dfdb6 | 195 | { |
c5f48367 | 196 | struct video_device *vdev = |
22a04f10 | 197 | container_of(cd, struct video_device, dev); |
483dfdb6 | 198 | struct usb_usbvision *usbvision = video_get_drvdata(vdev); |
c5f48367 TM |
199 | return sprintf(buf, "%s\n", |
200 | usbvision_device_data[usbvision->DevModel].ModelString); | |
483dfdb6 | 201 | } |
54bd5b66 | 202 | static DEVICE_ATTR(model, S_IRUGO, show_model, NULL); |
483dfdb6 | 203 | |
54bd5b66 KS |
204 | static ssize_t show_hue(struct device *cd, |
205 | struct device_attribute *attr, char *buf) | |
483dfdb6 | 206 | { |
c5f48367 | 207 | struct video_device *vdev = |
22a04f10 | 208 | container_of(cd, struct video_device, dev); |
483dfdb6 TM |
209 | struct usb_usbvision *usbvision = video_get_drvdata(vdev); |
210 | struct v4l2_control ctrl; | |
211 | ctrl.id = V4L2_CID_HUE; | |
212 | ctrl.value = 0; | |
ed00b41d | 213 | if(usbvision->user) |
1df79537 | 214 | call_all(usbvision, core, g_ctrl, &ctrl); |
2a9f8b5d | 215 | return sprintf(buf, "%d\n", ctrl.value); |
483dfdb6 | 216 | } |
54bd5b66 | 217 | static DEVICE_ATTR(hue, S_IRUGO, show_hue, NULL); |
483dfdb6 | 218 | |
54bd5b66 KS |
219 | static ssize_t show_contrast(struct device *cd, |
220 | struct device_attribute *attr, char *buf) | |
483dfdb6 | 221 | { |
c5f48367 | 222 | struct video_device *vdev = |
22a04f10 | 223 | container_of(cd, struct video_device, dev); |
483dfdb6 TM |
224 | struct usb_usbvision *usbvision = video_get_drvdata(vdev); |
225 | struct v4l2_control ctrl; | |
226 | ctrl.id = V4L2_CID_CONTRAST; | |
227 | ctrl.value = 0; | |
ed00b41d | 228 | if(usbvision->user) |
1df79537 | 229 | call_all(usbvision, core, g_ctrl, &ctrl); |
2a9f8b5d | 230 | return sprintf(buf, "%d\n", ctrl.value); |
483dfdb6 | 231 | } |
54bd5b66 | 232 | static DEVICE_ATTR(contrast, S_IRUGO, show_contrast, NULL); |
483dfdb6 | 233 | |
54bd5b66 KS |
234 | static ssize_t show_brightness(struct device *cd, |
235 | struct device_attribute *attr, char *buf) | |
483dfdb6 | 236 | { |
c5f48367 | 237 | struct video_device *vdev = |
22a04f10 | 238 | container_of(cd, struct video_device, dev); |
483dfdb6 TM |
239 | struct usb_usbvision *usbvision = video_get_drvdata(vdev); |
240 | struct v4l2_control ctrl; | |
241 | ctrl.id = V4L2_CID_BRIGHTNESS; | |
242 | ctrl.value = 0; | |
ed00b41d | 243 | if(usbvision->user) |
1df79537 | 244 | call_all(usbvision, core, g_ctrl, &ctrl); |
2a9f8b5d | 245 | return sprintf(buf, "%d\n", ctrl.value); |
483dfdb6 | 246 | } |
54bd5b66 | 247 | static DEVICE_ATTR(brightness, S_IRUGO, show_brightness, NULL); |
483dfdb6 | 248 | |
54bd5b66 KS |
249 | static ssize_t show_saturation(struct device *cd, |
250 | struct device_attribute *attr, char *buf) | |
483dfdb6 | 251 | { |
c5f48367 | 252 | struct video_device *vdev = |
22a04f10 | 253 | container_of(cd, struct video_device, dev); |
483dfdb6 TM |
254 | struct usb_usbvision *usbvision = video_get_drvdata(vdev); |
255 | struct v4l2_control ctrl; | |
256 | ctrl.id = V4L2_CID_SATURATION; | |
257 | ctrl.value = 0; | |
ed00b41d | 258 | if(usbvision->user) |
1df79537 | 259 | call_all(usbvision, core, g_ctrl, &ctrl); |
2a9f8b5d | 260 | return sprintf(buf, "%d\n", ctrl.value); |
483dfdb6 | 261 | } |
54bd5b66 | 262 | static DEVICE_ATTR(saturation, S_IRUGO, show_saturation, NULL); |
483dfdb6 | 263 | |
54bd5b66 KS |
264 | static ssize_t show_streaming(struct device *cd, |
265 | struct device_attribute *attr, char *buf) | |
483dfdb6 | 266 | { |
c5f48367 | 267 | struct video_device *vdev = |
22a04f10 | 268 | container_of(cd, struct video_device, dev); |
483dfdb6 | 269 | struct usb_usbvision *usbvision = video_get_drvdata(vdev); |
c5f48367 TM |
270 | return sprintf(buf, "%s\n", |
271 | YES_NO(usbvision->streaming==Stream_On?1:0)); | |
483dfdb6 | 272 | } |
54bd5b66 | 273 | static DEVICE_ATTR(streaming, S_IRUGO, show_streaming, NULL); |
483dfdb6 | 274 | |
54bd5b66 KS |
275 | static ssize_t show_compression(struct device *cd, |
276 | struct device_attribute *attr, char *buf) | |
483dfdb6 | 277 | { |
c5f48367 | 278 | struct video_device *vdev = |
22a04f10 | 279 | container_of(cd, struct video_device, dev); |
483dfdb6 | 280 | struct usb_usbvision *usbvision = video_get_drvdata(vdev); |
c5f48367 TM |
281 | return sprintf(buf, "%s\n", |
282 | YES_NO(usbvision->isocMode==ISOC_MODE_COMPRESS)); | |
483dfdb6 | 283 | } |
54bd5b66 | 284 | static DEVICE_ATTR(compression, S_IRUGO, show_compression, NULL); |
483dfdb6 | 285 | |
54bd5b66 KS |
286 | static ssize_t show_device_bridge(struct device *cd, |
287 | struct device_attribute *attr, char *buf) | |
483dfdb6 | 288 | { |
c5f48367 | 289 | struct video_device *vdev = |
22a04f10 | 290 | container_of(cd, struct video_device, dev); |
483dfdb6 TM |
291 | struct usb_usbvision *usbvision = video_get_drvdata(vdev); |
292 | return sprintf(buf, "%d\n", usbvision->bridgeType); | |
293 | } | |
54bd5b66 | 294 | static DEVICE_ATTR(bridge, S_IRUGO, show_device_bridge, NULL); |
483dfdb6 TM |
295 | |
296 | static void usbvision_create_sysfs(struct video_device *vdev) | |
297 | { | |
298 | int res; | |
ed00b41d DG |
299 | if (!vdev) |
300 | return; | |
301 | do { | |
22a04f10 | 302 | res = device_create_file(&vdev->dev, &dev_attr_version); |
ed00b41d DG |
303 | if (res<0) |
304 | break; | |
22a04f10 | 305 | res = device_create_file(&vdev->dev, &dev_attr_model); |
ed00b41d DG |
306 | if (res<0) |
307 | break; | |
22a04f10 | 308 | res = device_create_file(&vdev->dev, &dev_attr_hue); |
ed00b41d DG |
309 | if (res<0) |
310 | break; | |
22a04f10 | 311 | res = device_create_file(&vdev->dev, &dev_attr_contrast); |
ed00b41d DG |
312 | if (res<0) |
313 | break; | |
22a04f10 | 314 | res = device_create_file(&vdev->dev, &dev_attr_brightness); |
ed00b41d DG |
315 | if (res<0) |
316 | break; | |
22a04f10 | 317 | res = device_create_file(&vdev->dev, &dev_attr_saturation); |
ed00b41d DG |
318 | if (res<0) |
319 | break; | |
22a04f10 | 320 | res = device_create_file(&vdev->dev, &dev_attr_streaming); |
ed00b41d DG |
321 | if (res<0) |
322 | break; | |
22a04f10 | 323 | res = device_create_file(&vdev->dev, &dev_attr_compression); |
ed00b41d DG |
324 | if (res<0) |
325 | break; | |
22a04f10 | 326 | res = device_create_file(&vdev->dev, &dev_attr_bridge); |
ed00b41d DG |
327 | if (res>=0) |
328 | return; | |
329 | } while (0); | |
330 | ||
be9ed511 | 331 | dev_err(&vdev->dev, "%s error: %d\n", __func__, res); |
483dfdb6 TM |
332 | } |
333 | ||
334 | static void usbvision_remove_sysfs(struct video_device *vdev) | |
335 | { | |
336 | if (vdev) { | |
22a04f10 HV |
337 | device_remove_file(&vdev->dev, &dev_attr_version); |
338 | device_remove_file(&vdev->dev, &dev_attr_model); | |
339 | device_remove_file(&vdev->dev, &dev_attr_hue); | |
340 | device_remove_file(&vdev->dev, &dev_attr_contrast); | |
341 | device_remove_file(&vdev->dev, &dev_attr_brightness); | |
342 | device_remove_file(&vdev->dev, &dev_attr_saturation); | |
343 | device_remove_file(&vdev->dev, &dev_attr_streaming); | |
344 | device_remove_file(&vdev->dev, &dev_attr_compression); | |
345 | device_remove_file(&vdev->dev, &dev_attr_bridge); | |
483dfdb6 TM |
346 | } |
347 | } | |
348 | ||
483dfdb6 TM |
349 | /* |
350 | * usbvision_open() | |
351 | * | |
352 | * This is part of Video 4 Linux API. The driver can be opened by one | |
353 | * client only (checks internal counter 'usbvision->user'). The procedure | |
354 | * then allocates buffers needed for video processing. | |
355 | * | |
356 | */ | |
bec43661 | 357 | static int usbvision_v4l2_open(struct file *file) |
483dfdb6 | 358 | { |
c170ecf4 | 359 | struct usb_usbvision *usbvision = video_drvdata(file); |
483dfdb6 TM |
360 | int errCode = 0; |
361 | ||
362 | PDEBUG(DBG_IO, "open"); | |
363 | ||
d56dc612 | 364 | lock_kernel(); |
483dfdb6 TM |
365 | usbvision_reset_powerOffTimer(usbvision); |
366 | ||
367 | if (usbvision->user) | |
368 | errCode = -EBUSY; | |
369 | else { | |
6f78e186 TM |
370 | /* Allocate memory for the scratch ring buffer */ |
371 | errCode = usbvision_scratch_alloc(usbvision); | |
372 | if (isocMode==ISOC_MODE_COMPRESS) { | |
c5f48367 TM |
373 | /* Allocate intermediate decompression buffers |
374 | only if needed */ | |
6f78e186 | 375 | errCode = usbvision_decompress_alloc(usbvision); |
483dfdb6 TM |
376 | } |
377 | if (errCode) { | |
378 | /* Deallocate all buffers if trouble */ | |
483dfdb6 | 379 | usbvision_scratch_free(usbvision); |
483dfdb6 TM |
380 | usbvision_decompress_free(usbvision); |
381 | } | |
382 | } | |
383 | ||
384 | /* If so far no errors then we shall start the camera */ | |
385 | if (!errCode) { | |
289d4d2f | 386 | mutex_lock(&usbvision->lock); |
483dfdb6 TM |
387 | if (usbvision->power == 0) { |
388 | usbvision_power_on(usbvision); | |
1ff16c20 | 389 | usbvision_i2c_register(usbvision); |
483dfdb6 TM |
390 | } |
391 | ||
392 | /* Send init sequence only once, it's large! */ | |
393 | if (!usbvision->initialized) { | |
394 | int setup_ok = 0; | |
395 | setup_ok = usbvision_setup(usbvision,isocMode); | |
396 | if (setup_ok) | |
397 | usbvision->initialized = 1; | |
398 | else | |
399 | errCode = -EBUSY; | |
400 | } | |
401 | ||
402 | if (!errCode) { | |
403 | usbvision_begin_streaming(usbvision); | |
404 | errCode = usbvision_init_isoc(usbvision); | |
c5f48367 | 405 | /* device must be initialized before isoc transfer */ |
483dfdb6 TM |
406 | usbvision_muxsel(usbvision,0); |
407 | usbvision->user++; | |
c5f48367 | 408 | } else { |
483dfdb6 | 409 | if (PowerOnAtOpen) { |
1ff16c20 | 410 | usbvision_i2c_unregister(usbvision); |
483dfdb6 TM |
411 | usbvision_power_off(usbvision); |
412 | usbvision->initialized = 0; | |
413 | } | |
414 | } | |
289d4d2f | 415 | mutex_unlock(&usbvision->lock); |
483dfdb6 TM |
416 | } |
417 | ||
483dfdb6 TM |
418 | /* prepare queues */ |
419 | usbvision_empty_framequeues(usbvision); | |
420 | ||
421 | PDEBUG(DBG_IO, "success"); | |
d56dc612 | 422 | unlock_kernel(); |
483dfdb6 TM |
423 | return errCode; |
424 | } | |
425 | ||
426 | /* | |
427 | * usbvision_v4l2_close() | |
428 | * | |
429 | * This is part of Video 4 Linux API. The procedure | |
430 | * stops streaming and deallocates all buffers that were earlier | |
431 | * allocated in usbvision_v4l2_open(). | |
432 | * | |
433 | */ | |
bec43661 | 434 | static int usbvision_v4l2_close(struct file *file) |
483dfdb6 | 435 | { |
c170ecf4 | 436 | struct usb_usbvision *usbvision = video_drvdata(file); |
483dfdb6 TM |
437 | |
438 | PDEBUG(DBG_IO, "close"); | |
289d4d2f | 439 | mutex_lock(&usbvision->lock); |
483dfdb6 TM |
440 | |
441 | usbvision_audio_off(usbvision); | |
442 | usbvision_restart_isoc(usbvision); | |
443 | usbvision_stop_isoc(usbvision); | |
444 | ||
445 | usbvision_decompress_free(usbvision); | |
38284ba3 | 446 | usbvision_frames_free(usbvision); |
6f78e186 | 447 | usbvision_empty_framequeues(usbvision); |
483dfdb6 | 448 | usbvision_scratch_free(usbvision); |
483dfdb6 TM |
449 | |
450 | usbvision->user--; | |
451 | ||
452 | if (PowerOnAtOpen) { | |
c5f48367 TM |
453 | /* power off in a little while |
454 | to avoid off/on every close/open short sequences */ | |
483dfdb6 TM |
455 | usbvision_set_powerOffTimer(usbvision); |
456 | usbvision->initialized = 0; | |
457 | } | |
458 | ||
289d4d2f | 459 | mutex_unlock(&usbvision->lock); |
483dfdb6 TM |
460 | |
461 | if (usbvision->remove_pending) { | |
d2db42dd | 462 | printk(KERN_INFO "%s: Final disconnect\n", __func__); |
483dfdb6 TM |
463 | usbvision_release(usbvision); |
464 | } | |
465 | ||
466 | PDEBUG(DBG_IO, "success"); | |
483dfdb6 TM |
467 | return 0; |
468 | } | |
469 | ||
470 | ||
471 | /* | |
472 | * usbvision_ioctl() | |
473 | * | |
474 | * This is part of Video 4 Linux API. The procedure handles ioctl() calls. | |
475 | * | |
476 | */ | |
c5f48367 TM |
477 | #ifdef CONFIG_VIDEO_ADV_DEBUG |
478 | static int vidioc_g_register (struct file *file, void *priv, | |
aecde8b5 | 479 | struct v4l2_dbg_register *reg) |
483dfdb6 | 480 | { |
c170ecf4 | 481 | struct usb_usbvision *usbvision = video_drvdata(file); |
c5f48367 | 482 | int errCode; |
483dfdb6 | 483 | |
aecde8b5 | 484 | if (!v4l2_chip_match_host(®->match)) |
c5f48367 TM |
485 | return -EINVAL; |
486 | /* NT100x has a 8-bit register space */ | |
487 | errCode = usbvision_read_reg(usbvision, reg->reg&0xff); | |
488 | if (errCode < 0) { | |
be9ed511 MCC |
489 | dev_err(&usbvision->vdev->dev, |
490 | "%s: VIDIOC_DBG_G_REGISTER failed: error %d\n", | |
491 | __func__, errCode); | |
c5f48367 TM |
492 | return errCode; |
493 | } | |
bc147135 | 494 | reg->val = errCode; |
aecde8b5 | 495 | reg->size = 1; |
c5f48367 TM |
496 | return 0; |
497 | } | |
483dfdb6 | 498 | |
c5f48367 | 499 | static int vidioc_s_register (struct file *file, void *priv, |
aecde8b5 | 500 | struct v4l2_dbg_register *reg) |
c5f48367 | 501 | { |
c170ecf4 | 502 | struct usb_usbvision *usbvision = video_drvdata(file); |
c5f48367 | 503 | int errCode; |
62d50add | 504 | |
aecde8b5 | 505 | if (!v4l2_chip_match_host(®->match)) |
c5f48367 TM |
506 | return -EINVAL; |
507 | /* NT100x has a 8-bit register space */ | |
bc147135 TP |
508 | errCode = usbvision_write_reg(usbvision, reg->reg&0xff, reg->val); |
509 | if (errCode < 0) { | |
be9ed511 MCC |
510 | dev_err(&usbvision->vdev->dev, |
511 | "%s: VIDIOC_DBG_S_REGISTER failed: error %d\n", | |
512 | __func__, errCode); | |
c5f48367 TM |
513 | return errCode; |
514 | } | |
515 | return 0; | |
516 | } | |
483dfdb6 | 517 | #endif |
c5f48367 TM |
518 | |
519 | static int vidioc_querycap (struct file *file, void *priv, | |
520 | struct v4l2_capability *vc) | |
521 | { | |
c170ecf4 | 522 | struct usb_usbvision *usbvision = video_drvdata(file); |
c5f48367 TM |
523 | |
524 | strlcpy(vc->driver, "USBVision", sizeof(vc->driver)); | |
525 | strlcpy(vc->card, | |
526 | usbvision_device_data[usbvision->DevModel].ModelString, | |
527 | sizeof(vc->card)); | |
6f2a2781 | 528 | usb_make_path(usbvision->dev, vc->bus_info, sizeof(vc->bus_info)); |
c5f48367 TM |
529 | vc->version = USBVISION_DRIVER_VERSION; |
530 | vc->capabilities = V4L2_CAP_VIDEO_CAPTURE | | |
531 | V4L2_CAP_AUDIO | | |
532 | V4L2_CAP_READWRITE | | |
533 | V4L2_CAP_STREAMING | | |
534 | (usbvision->have_tuner ? V4L2_CAP_TUNER : 0); | |
535 | return 0; | |
536 | } | |
537 | ||
538 | static int vidioc_enum_input (struct file *file, void *priv, | |
539 | struct v4l2_input *vi) | |
540 | { | |
c170ecf4 | 541 | struct usb_usbvision *usbvision = video_drvdata(file); |
c5f48367 TM |
542 | int chan; |
543 | ||
544 | if ((vi->index >= usbvision->video_inputs) || (vi->index < 0) ) | |
545 | return -EINVAL; | |
546 | if (usbvision->have_tuner) { | |
547 | chan = vi->index; | |
548 | } else { | |
549 | chan = vi->index + 1; /*skip Television string*/ | |
550 | } | |
551 | /* Determine the requested input characteristics | |
552 | specific for each usbvision card model */ | |
553 | switch(chan) { | |
554 | case 0: | |
555 | if (usbvision_device_data[usbvision->DevModel].VideoChannels == 4) { | |
556 | strcpy(vi->name, "White Video Input"); | |
557 | } else { | |
558 | strcpy(vi->name, "Television"); | |
559 | vi->type = V4L2_INPUT_TYPE_TUNER; | |
560 | vi->audioset = 1; | |
561 | vi->tuner = chan; | |
562 | vi->std = USBVISION_NORMS; | |
483dfdb6 | 563 | } |
c5f48367 TM |
564 | break; |
565 | case 1: | |
566 | vi->type = V4L2_INPUT_TYPE_CAMERA; | |
567 | if (usbvision_device_data[usbvision->DevModel].VideoChannels == 4) { | |
568 | strcpy(vi->name, "Green Video Input"); | |
569 | } else { | |
570 | strcpy(vi->name, "Composite Video Input"); | |
483dfdb6 | 571 | } |
c5f48367 TM |
572 | vi->std = V4L2_STD_PAL; |
573 | break; | |
574 | case 2: | |
575 | vi->type = V4L2_INPUT_TYPE_CAMERA; | |
576 | if (usbvision_device_data[usbvision->DevModel].VideoChannels == 4) { | |
577 | strcpy(vi->name, "Yellow Video Input"); | |
578 | } else { | |
579 | strcpy(vi->name, "S-Video Input"); | |
483dfdb6 | 580 | } |
c5f48367 TM |
581 | vi->std = V4L2_STD_PAL; |
582 | break; | |
583 | case 3: | |
584 | vi->type = V4L2_INPUT_TYPE_CAMERA; | |
585 | strcpy(vi->name, "Red Video Input"); | |
586 | vi->std = V4L2_STD_PAL; | |
587 | break; | |
588 | } | |
589 | return 0; | |
590 | } | |
483dfdb6 | 591 | |
c5f48367 TM |
592 | static int vidioc_g_input (struct file *file, void *priv, unsigned int *input) |
593 | { | |
c170ecf4 | 594 | struct usb_usbvision *usbvision = video_drvdata(file); |
483dfdb6 | 595 | |
c5f48367 TM |
596 | *input = usbvision->ctl_input; |
597 | return 0; | |
598 | } | |
483dfdb6 | 599 | |
c5f48367 TM |
600 | static int vidioc_s_input (struct file *file, void *priv, unsigned int input) |
601 | { | |
c170ecf4 | 602 | struct usb_usbvision *usbvision = video_drvdata(file); |
483dfdb6 | 603 | |
c5f48367 TM |
604 | if ((input >= usbvision->video_inputs) || (input < 0) ) |
605 | return -EINVAL; | |
483dfdb6 | 606 | |
289d4d2f | 607 | mutex_lock(&usbvision->lock); |
66a17879 | 608 | usbvision_muxsel(usbvision, input); |
c5f48367 TM |
609 | usbvision_set_input(usbvision); |
610 | usbvision_set_output(usbvision, | |
611 | usbvision->curwidth, | |
612 | usbvision->curheight); | |
289d4d2f | 613 | mutex_unlock(&usbvision->lock); |
c5f48367 TM |
614 | return 0; |
615 | } | |
483dfdb6 | 616 | |
c5f48367 TM |
617 | static int vidioc_s_std (struct file *file, void *priv, v4l2_std_id *id) |
618 | { | |
c170ecf4 HV |
619 | struct usb_usbvision *usbvision = video_drvdata(file); |
620 | ||
c5f48367 | 621 | usbvision->tvnormId=*id; |
483dfdb6 | 622 | |
289d4d2f | 623 | mutex_lock(&usbvision->lock); |
1df79537 | 624 | call_all(usbvision, tuner, s_std, usbvision->tvnormId); |
289d4d2f | 625 | mutex_unlock(&usbvision->lock); |
66a17879 TM |
626 | /* propagate the change to the decoder */ |
627 | usbvision_muxsel(usbvision, usbvision->ctl_input); | |
483dfdb6 | 628 | |
c5f48367 TM |
629 | return 0; |
630 | } | |
483dfdb6 | 631 | |
c5f48367 TM |
632 | static int vidioc_g_tuner (struct file *file, void *priv, |
633 | struct v4l2_tuner *vt) | |
634 | { | |
c170ecf4 | 635 | struct usb_usbvision *usbvision = video_drvdata(file); |
483dfdb6 | 636 | |
c5f48367 TM |
637 | if (!usbvision->have_tuner || vt->index) // Only tuner 0 |
638 | return -EINVAL; | |
639 | if(usbvision->radio) { | |
640 | strcpy(vt->name, "Radio"); | |
641 | vt->type = V4L2_TUNER_RADIO; | |
642 | } else { | |
643 | strcpy(vt->name, "Television"); | |
644 | } | |
645 | /* Let clients fill in the remainder of this struct */ | |
1df79537 | 646 | call_all(usbvision, tuner, g_tuner, vt); |
483dfdb6 | 647 | |
c5f48367 TM |
648 | return 0; |
649 | } | |
483dfdb6 | 650 | |
c5f48367 TM |
651 | static int vidioc_s_tuner (struct file *file, void *priv, |
652 | struct v4l2_tuner *vt) | |
653 | { | |
c170ecf4 | 654 | struct usb_usbvision *usbvision = video_drvdata(file); |
483dfdb6 | 655 | |
c5f48367 TM |
656 | // Only no or one tuner for now |
657 | if (!usbvision->have_tuner || vt->index) | |
658 | return -EINVAL; | |
659 | /* let clients handle this */ | |
1df79537 | 660 | call_all(usbvision, tuner, s_tuner, vt); |
483dfdb6 | 661 | |
c5f48367 TM |
662 | return 0; |
663 | } | |
483dfdb6 | 664 | |
c5f48367 TM |
665 | static int vidioc_g_frequency (struct file *file, void *priv, |
666 | struct v4l2_frequency *freq) | |
667 | { | |
c170ecf4 | 668 | struct usb_usbvision *usbvision = video_drvdata(file); |
483dfdb6 | 669 | |
c5f48367 TM |
670 | freq->tuner = 0; // Only one tuner |
671 | if(usbvision->radio) { | |
672 | freq->type = V4L2_TUNER_RADIO; | |
673 | } else { | |
674 | freq->type = V4L2_TUNER_ANALOG_TV; | |
675 | } | |
676 | freq->frequency = usbvision->freq; | |
483dfdb6 | 677 | |
c5f48367 TM |
678 | return 0; |
679 | } | |
483dfdb6 | 680 | |
c5f48367 TM |
681 | static int vidioc_s_frequency (struct file *file, void *priv, |
682 | struct v4l2_frequency *freq) | |
683 | { | |
c170ecf4 | 684 | struct usb_usbvision *usbvision = video_drvdata(file); |
483dfdb6 | 685 | |
c5f48367 TM |
686 | // Only no or one tuner for now |
687 | if (!usbvision->have_tuner || freq->tuner) | |
688 | return -EINVAL; | |
483dfdb6 | 689 | |
c5f48367 | 690 | usbvision->freq = freq->frequency; |
1df79537 | 691 | call_all(usbvision, tuner, s_frequency, freq); |
483dfdb6 | 692 | |
c5f48367 TM |
693 | return 0; |
694 | } | |
483dfdb6 | 695 | |
c5f48367 TM |
696 | static int vidioc_g_audio (struct file *file, void *priv, struct v4l2_audio *a) |
697 | { | |
c170ecf4 | 698 | struct usb_usbvision *usbvision = video_drvdata(file); |
483dfdb6 | 699 | |
c5f48367 TM |
700 | memset(a,0,sizeof(*a)); |
701 | if(usbvision->radio) { | |
702 | strcpy(a->name,"Radio"); | |
703 | } else { | |
704 | strcpy(a->name, "TV"); | |
705 | } | |
483dfdb6 | 706 | |
c5f48367 TM |
707 | return 0; |
708 | } | |
483dfdb6 | 709 | |
c5f48367 TM |
710 | static int vidioc_s_audio (struct file *file, void *fh, |
711 | struct v4l2_audio *a) | |
712 | { | |
713 | if(a->index) { | |
714 | return -EINVAL; | |
715 | } | |
483dfdb6 | 716 | |
c5f48367 TM |
717 | return 0; |
718 | } | |
483dfdb6 | 719 | |
c5f48367 TM |
720 | static int vidioc_queryctrl (struct file *file, void *priv, |
721 | struct v4l2_queryctrl *ctrl) | |
722 | { | |
c170ecf4 | 723 | struct usb_usbvision *usbvision = video_drvdata(file); |
c5f48367 | 724 | int id=ctrl->id; |
483dfdb6 | 725 | |
c5f48367 TM |
726 | memset(ctrl,0,sizeof(*ctrl)); |
727 | ctrl->id=id; | |
483dfdb6 | 728 | |
1df79537 | 729 | call_all(usbvision, core, queryctrl, ctrl); |
483dfdb6 | 730 | |
c5f48367 TM |
731 | if (!ctrl->type) |
732 | return -EINVAL; | |
483dfdb6 | 733 | |
c5f48367 TM |
734 | return 0; |
735 | } | |
483dfdb6 | 736 | |
c5f48367 TM |
737 | static int vidioc_g_ctrl (struct file *file, void *priv, |
738 | struct v4l2_control *ctrl) | |
739 | { | |
c170ecf4 | 740 | struct usb_usbvision *usbvision = video_drvdata(file); |
1df79537 | 741 | call_all(usbvision, core, g_ctrl, ctrl); |
483dfdb6 | 742 | |
c5f48367 TM |
743 | return 0; |
744 | } | |
745 | ||
746 | static int vidioc_s_ctrl (struct file *file, void *priv, | |
747 | struct v4l2_control *ctrl) | |
748 | { | |
c170ecf4 | 749 | struct usb_usbvision *usbvision = video_drvdata(file); |
1df79537 | 750 | call_all(usbvision, core, s_ctrl, ctrl); |
c5f48367 TM |
751 | |
752 | return 0; | |
753 | } | |
754 | ||
755 | static int vidioc_reqbufs (struct file *file, | |
756 | void *priv, struct v4l2_requestbuffers *vr) | |
757 | { | |
c170ecf4 | 758 | struct usb_usbvision *usbvision = video_drvdata(file); |
c5f48367 TM |
759 | int ret; |
760 | ||
761 | RESTRICT_TO_RANGE(vr->count,1,USBVISION_NUMFRAMES); | |
762 | ||
763 | /* Check input validity: | |
764 | the user must do a VIDEO CAPTURE and MMAP method. */ | |
765 | if((vr->type != V4L2_BUF_TYPE_VIDEO_CAPTURE) || | |
766 | (vr->memory != V4L2_MEMORY_MMAP)) | |
767 | return -EINVAL; | |
768 | ||
769 | if(usbvision->streaming == Stream_On) { | |
770 | if ((ret = usbvision_stream_interrupt(usbvision))) | |
771 | return ret; | |
483dfdb6 | 772 | } |
c5f48367 TM |
773 | |
774 | usbvision_frames_free(usbvision); | |
775 | usbvision_empty_framequeues(usbvision); | |
776 | vr->count = usbvision_frames_alloc(usbvision,vr->count); | |
777 | ||
778 | usbvision->curFrame = NULL; | |
779 | ||
483dfdb6 TM |
780 | return 0; |
781 | } | |
782 | ||
c5f48367 TM |
783 | static int vidioc_querybuf (struct file *file, |
784 | void *priv, struct v4l2_buffer *vb) | |
483dfdb6 | 785 | { |
c170ecf4 | 786 | struct usb_usbvision *usbvision = video_drvdata(file); |
c5f48367 TM |
787 | struct usbvision_frame *frame; |
788 | ||
789 | /* FIXME : must control | |
790 | that buffers are mapped (VIDIOC_REQBUFS has been called) */ | |
791 | if(vb->type != V4L2_CAP_VIDEO_CAPTURE) { | |
792 | return -EINVAL; | |
793 | } | |
794 | if(vb->index>=usbvision->num_frames) { | |
795 | return -EINVAL; | |
796 | } | |
797 | /* Updating the corresponding frame state */ | |
798 | vb->flags = 0; | |
799 | frame = &usbvision->frame[vb->index]; | |
800 | if(frame->grabstate >= FrameState_Ready) | |
801 | vb->flags |= V4L2_BUF_FLAG_QUEUED; | |
802 | if(frame->grabstate >= FrameState_Done) | |
803 | vb->flags |= V4L2_BUF_FLAG_DONE; | |
804 | if(frame->grabstate == FrameState_Unused) | |
805 | vb->flags |= V4L2_BUF_FLAG_MAPPED; | |
806 | vb->memory = V4L2_MEMORY_MMAP; | |
807 | ||
808 | vb->m.offset = vb->index*PAGE_ALIGN(usbvision->max_frame_size); | |
809 | ||
810 | vb->memory = V4L2_MEMORY_MMAP; | |
811 | vb->field = V4L2_FIELD_NONE; | |
812 | vb->length = usbvision->curwidth* | |
813 | usbvision->curheight* | |
814 | usbvision->palette.bytes_per_pixel; | |
815 | vb->timestamp = usbvision->frame[vb->index].timestamp; | |
816 | vb->sequence = usbvision->frame[vb->index].sequence; | |
817 | return 0; | |
483dfdb6 TM |
818 | } |
819 | ||
c5f48367 TM |
820 | static int vidioc_qbuf (struct file *file, void *priv, struct v4l2_buffer *vb) |
821 | { | |
c170ecf4 | 822 | struct usb_usbvision *usbvision = video_drvdata(file); |
c5f48367 TM |
823 | struct usbvision_frame *frame; |
824 | unsigned long lock_flags; | |
825 | ||
826 | /* FIXME : works only on VIDEO_CAPTURE MODE, MMAP. */ | |
827 | if(vb->type != V4L2_CAP_VIDEO_CAPTURE) { | |
828 | return -EINVAL; | |
829 | } | |
830 | if(vb->index>=usbvision->num_frames) { | |
831 | return -EINVAL; | |
832 | } | |
833 | ||
834 | frame = &usbvision->frame[vb->index]; | |
835 | ||
836 | if (frame->grabstate != FrameState_Unused) { | |
837 | return -EAGAIN; | |
838 | } | |
839 | ||
840 | /* Mark it as ready and enqueue frame */ | |
841 | frame->grabstate = FrameState_Ready; | |
842 | frame->scanstate = ScanState_Scanning; | |
843 | frame->scanlength = 0; /* Accumulated in usbvision_parse_data() */ | |
844 | ||
845 | vb->flags &= ~V4L2_BUF_FLAG_DONE; | |
846 | ||
847 | /* set v4l2_format index */ | |
848 | frame->v4l2_format = usbvision->palette; | |
849 | ||
850 | spin_lock_irqsave(&usbvision->queue_lock, lock_flags); | |
851 | list_add_tail(&usbvision->frame[vb->index].frame, &usbvision->inqueue); | |
852 | spin_unlock_irqrestore(&usbvision->queue_lock, lock_flags); | |
853 | ||
854 | return 0; | |
855 | } | |
856 | ||
857 | static int vidioc_dqbuf (struct file *file, void *priv, struct v4l2_buffer *vb) | |
858 | { | |
c170ecf4 | 859 | struct usb_usbvision *usbvision = video_drvdata(file); |
c5f48367 TM |
860 | int ret; |
861 | struct usbvision_frame *f; | |
862 | unsigned long lock_flags; | |
863 | ||
864 | if (vb->type != V4L2_BUF_TYPE_VIDEO_CAPTURE) | |
865 | return -EINVAL; | |
866 | ||
867 | if (list_empty(&(usbvision->outqueue))) { | |
868 | if (usbvision->streaming == Stream_Idle) | |
869 | return -EINVAL; | |
870 | ret = wait_event_interruptible | |
871 | (usbvision->wait_frame, | |
872 | !list_empty(&(usbvision->outqueue))); | |
873 | if (ret) | |
874 | return ret; | |
875 | } | |
876 | ||
877 | spin_lock_irqsave(&usbvision->queue_lock, lock_flags); | |
878 | f = list_entry(usbvision->outqueue.next, | |
879 | struct usbvision_frame, frame); | |
880 | list_del(usbvision->outqueue.next); | |
881 | spin_unlock_irqrestore(&usbvision->queue_lock, lock_flags); | |
882 | ||
883 | f->grabstate = FrameState_Unused; | |
884 | ||
885 | vb->memory = V4L2_MEMORY_MMAP; | |
886 | vb->flags = V4L2_BUF_FLAG_MAPPED | | |
887 | V4L2_BUF_FLAG_QUEUED | | |
888 | V4L2_BUF_FLAG_DONE; | |
889 | vb->index = f->index; | |
890 | vb->sequence = f->sequence; | |
891 | vb->timestamp = f->timestamp; | |
892 | vb->field = V4L2_FIELD_NONE; | |
893 | vb->bytesused = f->scanlength; | |
894 | ||
895 | return 0; | |
896 | } | |
897 | ||
898 | static int vidioc_streamon(struct file *file, void *priv, enum v4l2_buf_type i) | |
899 | { | |
c170ecf4 | 900 | struct usb_usbvision *usbvision = video_drvdata(file); |
c5f48367 TM |
901 | |
902 | usbvision->streaming = Stream_On; | |
1df79537 | 903 | call_all(usbvision, video, s_stream, 1); |
c5f48367 TM |
904 | |
905 | return 0; | |
906 | } | |
907 | ||
908 | static int vidioc_streamoff(struct file *file, | |
909 | void *priv, enum v4l2_buf_type type) | |
910 | { | |
c170ecf4 | 911 | struct usb_usbvision *usbvision = video_drvdata(file); |
c5f48367 TM |
912 | |
913 | if (type != V4L2_BUF_TYPE_VIDEO_CAPTURE) | |
914 | return -EINVAL; | |
915 | ||
916 | if(usbvision->streaming == Stream_On) { | |
917 | usbvision_stream_interrupt(usbvision); | |
918 | /* Stop all video streamings */ | |
1df79537 | 919 | call_all(usbvision, video, s_stream, 0); |
c5f48367 TM |
920 | } |
921 | usbvision_empty_framequeues(usbvision); | |
922 | ||
923 | return 0; | |
924 | } | |
925 | ||
78b526a4 | 926 | static int vidioc_enum_fmt_vid_cap (struct file *file, void *priv, |
c5f48367 TM |
927 | struct v4l2_fmtdesc *vfd) |
928 | { | |
929 | if(vfd->index>=USBVISION_SUPPORTED_PALETTES-1) { | |
930 | return -EINVAL; | |
931 | } | |
932 | vfd->flags = 0; | |
933 | vfd->type = V4L2_BUF_TYPE_VIDEO_CAPTURE; | |
934 | strcpy(vfd->description,usbvision_v4l2_format[vfd->index].desc); | |
935 | vfd->pixelformat = usbvision_v4l2_format[vfd->index].format; | |
936 | memset(vfd->reserved, 0, sizeof(vfd->reserved)); | |
937 | return 0; | |
938 | } | |
939 | ||
78b526a4 | 940 | static int vidioc_g_fmt_vid_cap (struct file *file, void *priv, |
c5f48367 TM |
941 | struct v4l2_format *vf) |
942 | { | |
c170ecf4 | 943 | struct usb_usbvision *usbvision = video_drvdata(file); |
c5f48367 TM |
944 | vf->fmt.pix.width = usbvision->curwidth; |
945 | vf->fmt.pix.height = usbvision->curheight; | |
946 | vf->fmt.pix.pixelformat = usbvision->palette.format; | |
947 | vf->fmt.pix.bytesperline = | |
948 | usbvision->curwidth*usbvision->palette.bytes_per_pixel; | |
949 | vf->fmt.pix.sizeimage = vf->fmt.pix.bytesperline*usbvision->curheight; | |
950 | vf->fmt.pix.colorspace = V4L2_COLORSPACE_SMPTE170M; | |
951 | vf->fmt.pix.field = V4L2_FIELD_NONE; /* Always progressive image */ | |
952 | ||
953 | return 0; | |
954 | } | |
955 | ||
78b526a4 | 956 | static int vidioc_try_fmt_vid_cap (struct file *file, void *priv, |
c5f48367 TM |
957 | struct v4l2_format *vf) |
958 | { | |
c170ecf4 | 959 | struct usb_usbvision *usbvision = video_drvdata(file); |
c5f48367 TM |
960 | int formatIdx; |
961 | ||
962 | /* Find requested format in available ones */ | |
963 | for(formatIdx=0;formatIdx<USBVISION_SUPPORTED_PALETTES;formatIdx++) { | |
964 | if(vf->fmt.pix.pixelformat == | |
965 | usbvision_v4l2_format[formatIdx].format) { | |
966 | usbvision->palette = usbvision_v4l2_format[formatIdx]; | |
967 | break; | |
968 | } | |
969 | } | |
970 | /* robustness */ | |
971 | if(formatIdx == USBVISION_SUPPORTED_PALETTES) { | |
972 | return -EINVAL; | |
973 | } | |
974 | RESTRICT_TO_RANGE(vf->fmt.pix.width, MIN_FRAME_WIDTH, MAX_FRAME_WIDTH); | |
975 | RESTRICT_TO_RANGE(vf->fmt.pix.height, MIN_FRAME_HEIGHT, MAX_FRAME_HEIGHT); | |
976 | ||
977 | vf->fmt.pix.bytesperline = vf->fmt.pix.width* | |
978 | usbvision->palette.bytes_per_pixel; | |
979 | vf->fmt.pix.sizeimage = vf->fmt.pix.bytesperline*vf->fmt.pix.height; | |
980 | ||
981 | return 0; | |
982 | } | |
983 | ||
78b526a4 | 984 | static int vidioc_s_fmt_vid_cap(struct file *file, void *priv, |
c5f48367 TM |
985 | struct v4l2_format *vf) |
986 | { | |
c170ecf4 | 987 | struct usb_usbvision *usbvision = video_drvdata(file); |
c5f48367 TM |
988 | int ret; |
989 | ||
78b526a4 | 990 | if( 0 != (ret=vidioc_try_fmt_vid_cap (file, priv, vf)) ) { |
c5f48367 TM |
991 | return ret; |
992 | } | |
993 | ||
994 | /* stop io in case it is already in progress */ | |
995 | if(usbvision->streaming == Stream_On) { | |
996 | if ((ret = usbvision_stream_interrupt(usbvision))) | |
997 | return ret; | |
998 | } | |
999 | usbvision_frames_free(usbvision); | |
1000 | usbvision_empty_framequeues(usbvision); | |
1001 | ||
1002 | usbvision->curFrame = NULL; | |
1003 | ||
1004 | /* by now we are committed to the new data... */ | |
289d4d2f | 1005 | mutex_lock(&usbvision->lock); |
c5f48367 | 1006 | usbvision_set_output(usbvision, vf->fmt.pix.width, vf->fmt.pix.height); |
289d4d2f | 1007 | mutex_unlock(&usbvision->lock); |
c5f48367 TM |
1008 | |
1009 | return 0; | |
1010 | } | |
483dfdb6 | 1011 | |
8a5ab415 | 1012 | static ssize_t usbvision_v4l2_read(struct file *file, char __user *buf, |
483dfdb6 TM |
1013 | size_t count, loff_t *ppos) |
1014 | { | |
c170ecf4 | 1015 | struct usb_usbvision *usbvision = video_drvdata(file); |
483dfdb6 TM |
1016 | int noblock = file->f_flags & O_NONBLOCK; |
1017 | unsigned long lock_flags; | |
1018 | ||
483dfdb6 TM |
1019 | int ret,i; |
1020 | struct usbvision_frame *frame; | |
1021 | ||
d2db42dd | 1022 | PDEBUG(DBG_IO, "%s: %ld bytes, noblock=%d", __func__, |
c5f48367 | 1023 | (unsigned long)count, noblock); |
483dfdb6 TM |
1024 | |
1025 | if (!USBVISION_IS_OPERATIONAL(usbvision) || (buf == NULL)) | |
1026 | return -EFAULT; | |
1027 | ||
c5f48367 TM |
1028 | /* This entry point is compatible with the mmap routines |
1029 | so that a user can do either VIDIOC_QBUF/VIDIOC_DQBUF | |
1030 | to get frames or call read on the device. */ | |
6f78e186 | 1031 | if(!usbvision->num_frames) { |
c5f48367 TM |
1032 | /* First, allocate some frames to work with |
1033 | if this has not been done with VIDIOC_REQBUF */ | |
6f78e186 TM |
1034 | usbvision_frames_free(usbvision); |
1035 | usbvision_empty_framequeues(usbvision); | |
1036 | usbvision_frames_alloc(usbvision,USBVISION_NUMFRAMES); | |
1037 | } | |
1038 | ||
1039 | if(usbvision->streaming != Stream_On) { | |
1040 | /* no stream is running, make it running ! */ | |
1041 | usbvision->streaming = Stream_On; | |
1df79537 | 1042 | call_all(usbvision, video, s_stream, 1); |
6f78e186 | 1043 | } |
483dfdb6 | 1044 | |
c5f48367 TM |
1045 | /* Then, enqueue as many frames as possible |
1046 | (like a user of VIDIOC_QBUF would do) */ | |
6f78e186 | 1047 | for(i=0;i<usbvision->num_frames;i++) { |
483dfdb6 TM |
1048 | frame = &usbvision->frame[i]; |
1049 | if(frame->grabstate == FrameState_Unused) { | |
1050 | /* Mark it as ready and enqueue frame */ | |
1051 | frame->grabstate = FrameState_Ready; | |
1052 | frame->scanstate = ScanState_Scanning; | |
c5f48367 TM |
1053 | /* Accumulated in usbvision_parse_data() */ |
1054 | frame->scanlength = 0; | |
483dfdb6 TM |
1055 | |
1056 | /* set v4l2_format index */ | |
1057 | frame->v4l2_format = usbvision->palette; | |
1058 | ||
1059 | spin_lock_irqsave(&usbvision->queue_lock, lock_flags); | |
1060 | list_add_tail(&frame->frame, &usbvision->inqueue); | |
c5f48367 TM |
1061 | spin_unlock_irqrestore(&usbvision->queue_lock, |
1062 | lock_flags); | |
483dfdb6 TM |
1063 | } |
1064 | } | |
1065 | ||
1066 | /* Then try to steal a frame (like a VIDIOC_DQBUF would do) */ | |
1067 | if (list_empty(&(usbvision->outqueue))) { | |
1068 | if(noblock) | |
1069 | return -EAGAIN; | |
1070 | ||
1071 | ret = wait_event_interruptible | |
1072 | (usbvision->wait_frame, | |
1073 | !list_empty(&(usbvision->outqueue))); | |
1074 | if (ret) | |
1075 | return ret; | |
1076 | } | |
1077 | ||
1078 | spin_lock_irqsave(&usbvision->queue_lock, lock_flags); | |
1079 | frame = list_entry(usbvision->outqueue.next, | |
1080 | struct usbvision_frame, frame); | |
1081 | list_del(usbvision->outqueue.next); | |
1082 | spin_unlock_irqrestore(&usbvision->queue_lock, lock_flags); | |
1083 | ||
1084 | /* An error returns an empty frame */ | |
1085 | if (frame->grabstate == FrameState_Error) { | |
1086 | frame->bytes_read = 0; | |
1087 | return 0; | |
1088 | } | |
1089 | ||
c5f48367 | 1090 | PDEBUG(DBG_IO, "%s: frmx=%d, bytes_read=%ld, scanlength=%ld", |
d2db42dd | 1091 | __func__, |
c5f48367 | 1092 | frame->index, frame->bytes_read, frame->scanlength); |
483dfdb6 TM |
1093 | |
1094 | /* copy bytes to user space; we allow for partials reads */ | |
1095 | if ((count + frame->bytes_read) > (unsigned long)frame->scanlength) | |
1096 | count = frame->scanlength - frame->bytes_read; | |
1097 | ||
1098 | if (copy_to_user(buf, frame->data + frame->bytes_read, count)) { | |
1099 | return -EFAULT; | |
1100 | } | |
1101 | ||
1102 | frame->bytes_read += count; | |
c5f48367 | 1103 | PDEBUG(DBG_IO, "%s: {copy} count used=%ld, new bytes_read=%ld", |
d2db42dd | 1104 | __func__, |
c5f48367 | 1105 | (unsigned long)count, frame->bytes_read); |
483dfdb6 | 1106 | |
c5f48367 | 1107 | /* For now, forget the frame if it has not been read in one shot. */ |
483dfdb6 TM |
1108 | /* if (frame->bytes_read >= frame->scanlength) {// All data has been read */ |
1109 | frame->bytes_read = 0; | |
1110 | ||
1111 | /* Mark it as available to be used again. */ | |
c430ca1e | 1112 | frame->grabstate = FrameState_Unused; |
483dfdb6 TM |
1113 | /* } */ |
1114 | ||
1115 | return count; | |
1116 | } | |
1117 | ||
1118 | static int usbvision_v4l2_mmap(struct file *file, struct vm_area_struct *vma) | |
1119 | { | |
1120 | unsigned long size = vma->vm_end - vma->vm_start, | |
1121 | start = vma->vm_start; | |
1122 | void *pos; | |
1123 | u32 i; | |
c170ecf4 | 1124 | struct usb_usbvision *usbvision = video_drvdata(file); |
483dfdb6 | 1125 | |
6f78e186 TM |
1126 | PDEBUG(DBG_MMAP, "mmap"); |
1127 | ||
289d4d2f | 1128 | mutex_lock(&usbvision->lock); |
483dfdb6 TM |
1129 | |
1130 | if (!USBVISION_IS_OPERATIONAL(usbvision)) { | |
289d4d2f | 1131 | mutex_unlock(&usbvision->lock); |
483dfdb6 TM |
1132 | return -EFAULT; |
1133 | } | |
1134 | ||
1135 | if (!(vma->vm_flags & VM_WRITE) || | |
6f78e186 | 1136 | size != PAGE_ALIGN(usbvision->max_frame_size)) { |
289d4d2f | 1137 | mutex_unlock(&usbvision->lock); |
483dfdb6 TM |
1138 | return -EINVAL; |
1139 | } | |
1140 | ||
6f78e186 | 1141 | for (i = 0; i < usbvision->num_frames; i++) { |
c5f48367 TM |
1142 | if (((PAGE_ALIGN(usbvision->max_frame_size)*i) >> PAGE_SHIFT) == |
1143 | vma->vm_pgoff) | |
483dfdb6 TM |
1144 | break; |
1145 | } | |
6f78e186 | 1146 | if (i == usbvision->num_frames) { |
c5f48367 TM |
1147 | PDEBUG(DBG_MMAP, |
1148 | "mmap: user supplied mapping address is out of range"); | |
289d4d2f | 1149 | mutex_unlock(&usbvision->lock); |
483dfdb6 TM |
1150 | return -EINVAL; |
1151 | } | |
1152 | ||
1153 | /* VM_IO is eventually going to replace PageReserved altogether */ | |
1154 | vma->vm_flags |= VM_IO; | |
1155 | vma->vm_flags |= VM_RESERVED; /* avoid to swap out this VMA */ | |
1156 | ||
1157 | pos = usbvision->frame[i].data; | |
1158 | while (size > 0) { | |
1159 | ||
1160 | if (vm_insert_page(vma, start, vmalloc_to_page(pos))) { | |
c876a346 | 1161 | PDEBUG(DBG_MMAP, "mmap: vm_insert_page failed"); |
289d4d2f | 1162 | mutex_unlock(&usbvision->lock); |
483dfdb6 TM |
1163 | return -EAGAIN; |
1164 | } | |
1165 | start += PAGE_SIZE; | |
1166 | pos += PAGE_SIZE; | |
1167 | size -= PAGE_SIZE; | |
1168 | } | |
1169 | ||
289d4d2f | 1170 | mutex_unlock(&usbvision->lock); |
483dfdb6 TM |
1171 | return 0; |
1172 | } | |
1173 | ||
1174 | ||
1175 | /* | |
1176 | * Here comes the stuff for radio on usbvision based devices | |
1177 | * | |
1178 | */ | |
bec43661 | 1179 | static int usbvision_radio_open(struct file *file) |
483dfdb6 | 1180 | { |
c170ecf4 | 1181 | struct usb_usbvision *usbvision = video_drvdata(file); |
483dfdb6 TM |
1182 | int errCode = 0; |
1183 | ||
d2db42dd | 1184 | PDEBUG(DBG_IO, "%s:", __func__); |
483dfdb6 | 1185 | |
289d4d2f | 1186 | mutex_lock(&usbvision->lock); |
483dfdb6 TM |
1187 | |
1188 | if (usbvision->user) { | |
be9ed511 MCC |
1189 | dev_err(&usbvision->rdev->dev, |
1190 | "%s: Someone tried to open an already opened USBVision Radio!\n", | |
1191 | __func__); | |
483dfdb6 TM |
1192 | errCode = -EBUSY; |
1193 | } | |
1194 | else { | |
1195 | if(PowerOnAtOpen) { | |
1196 | usbvision_reset_powerOffTimer(usbvision); | |
1197 | if (usbvision->power == 0) { | |
1198 | usbvision_power_on(usbvision); | |
1ff16c20 | 1199 | usbvision_i2c_register(usbvision); |
483dfdb6 TM |
1200 | } |
1201 | } | |
1202 | ||
2a9f8b5d TM |
1203 | /* Alternate interface 1 is is the biggest frame size */ |
1204 | errCode = usbvision_set_alternate(usbvision); | |
1205 | if (errCode < 0) { | |
1206 | usbvision->last_error = errCode; | |
544e6175 AM |
1207 | errCode = -EBUSY; |
1208 | goto out; | |
2a9f8b5d TM |
1209 | } |
1210 | ||
483dfdb6 TM |
1211 | // If so far no errors then we shall start the radio |
1212 | usbvision->radio = 1; | |
1df79537 | 1213 | call_all(usbvision, tuner, s_radio); |
483dfdb6 TM |
1214 | usbvision_set_audio(usbvision, USBVISION_AUDIO_RADIO); |
1215 | usbvision->user++; | |
1216 | } | |
1217 | ||
1218 | if (errCode) { | |
1219 | if (PowerOnAtOpen) { | |
1ff16c20 | 1220 | usbvision_i2c_unregister(usbvision); |
483dfdb6 TM |
1221 | usbvision_power_off(usbvision); |
1222 | usbvision->initialized = 0; | |
1223 | } | |
1224 | } | |
544e6175 | 1225 | out: |
289d4d2f | 1226 | mutex_unlock(&usbvision->lock); |
483dfdb6 TM |
1227 | return errCode; |
1228 | } | |
1229 | ||
1230 | ||
bec43661 | 1231 | static int usbvision_radio_close(struct file *file) |
483dfdb6 | 1232 | { |
c170ecf4 | 1233 | struct usb_usbvision *usbvision = video_drvdata(file); |
483dfdb6 TM |
1234 | int errCode = 0; |
1235 | ||
1236 | PDEBUG(DBG_IO, ""); | |
1237 | ||
289d4d2f | 1238 | mutex_lock(&usbvision->lock); |
483dfdb6 | 1239 | |
2a9f8b5d TM |
1240 | /* Set packet size to 0 */ |
1241 | usbvision->ifaceAlt=0; | |
1242 | errCode = usb_set_interface(usbvision->dev, usbvision->iface, | |
1243 | usbvision->ifaceAlt); | |
1244 | ||
483dfdb6 TM |
1245 | usbvision_audio_off(usbvision); |
1246 | usbvision->radio=0; | |
1247 | usbvision->user--; | |
1248 | ||
1249 | if (PowerOnAtOpen) { | |
1250 | usbvision_set_powerOffTimer(usbvision); | |
1251 | usbvision->initialized = 0; | |
1252 | } | |
1253 | ||
289d4d2f | 1254 | mutex_unlock(&usbvision->lock); |
483dfdb6 TM |
1255 | |
1256 | if (usbvision->remove_pending) { | |
d2db42dd | 1257 | printk(KERN_INFO "%s: Final disconnect\n", __func__); |
483dfdb6 TM |
1258 | usbvision_release(usbvision); |
1259 | } | |
1260 | ||
483dfdb6 | 1261 | PDEBUG(DBG_IO, "success"); |
483dfdb6 TM |
1262 | return errCode; |
1263 | } | |
1264 | ||
483dfdb6 TM |
1265 | /* |
1266 | * Here comes the stuff for vbi on usbvision based devices | |
1267 | * | |
1268 | */ | |
bec43661 | 1269 | static int usbvision_vbi_open(struct file *file) |
483dfdb6 TM |
1270 | { |
1271 | /* TODO */ | |
c5f48367 | 1272 | return -ENODEV; |
483dfdb6 TM |
1273 | } |
1274 | ||
bec43661 | 1275 | static int usbvision_vbi_close(struct file *file) |
483dfdb6 TM |
1276 | { |
1277 | /* TODO */ | |
c5f48367 | 1278 | return -ENODEV; |
483dfdb6 TM |
1279 | } |
1280 | ||
069b7479 | 1281 | static long usbvision_do_vbi_ioctl(struct file *file, |
483dfdb6 TM |
1282 | unsigned int cmd, void *arg) |
1283 | { | |
1284 | /* TODO */ | |
c5f48367 | 1285 | return -ENOIOCTLCMD; |
483dfdb6 TM |
1286 | } |
1287 | ||
069b7479 | 1288 | static long usbvision_vbi_ioctl(struct file *file, |
483dfdb6 TM |
1289 | unsigned int cmd, unsigned long arg) |
1290 | { | |
f473bf76 | 1291 | return video_usercopy(file, cmd, arg, usbvision_do_vbi_ioctl); |
483dfdb6 TM |
1292 | } |
1293 | ||
1294 | ||
1295 | // | |
1296 | // Video registration stuff | |
1297 | // | |
1298 | ||
1299 | // Video template | |
bec43661 | 1300 | static const struct v4l2_file_operations usbvision_fops = { |
483dfdb6 | 1301 | .owner = THIS_MODULE, |
483dfdb6 TM |
1302 | .open = usbvision_v4l2_open, |
1303 | .release = usbvision_v4l2_close, | |
1304 | .read = usbvision_v4l2_read, | |
1305 | .mmap = usbvision_v4l2_mmap, | |
c5f48367 | 1306 | .ioctl = video_ioctl2, |
c5f48367 | 1307 | /* .poll = video_poll, */ |
483dfdb6 | 1308 | }; |
a399810c HV |
1309 | |
1310 | static const struct v4l2_ioctl_ops usbvision_ioctl_ops = { | |
c5f48367 | 1311 | .vidioc_querycap = vidioc_querycap, |
78b526a4 HV |
1312 | .vidioc_enum_fmt_vid_cap = vidioc_enum_fmt_vid_cap, |
1313 | .vidioc_g_fmt_vid_cap = vidioc_g_fmt_vid_cap, | |
1314 | .vidioc_try_fmt_vid_cap = vidioc_try_fmt_vid_cap, | |
1315 | .vidioc_s_fmt_vid_cap = vidioc_s_fmt_vid_cap, | |
c5f48367 TM |
1316 | .vidioc_reqbufs = vidioc_reqbufs, |
1317 | .vidioc_querybuf = vidioc_querybuf, | |
1318 | .vidioc_qbuf = vidioc_qbuf, | |
1319 | .vidioc_dqbuf = vidioc_dqbuf, | |
1320 | .vidioc_s_std = vidioc_s_std, | |
1321 | .vidioc_enum_input = vidioc_enum_input, | |
1322 | .vidioc_g_input = vidioc_g_input, | |
1323 | .vidioc_s_input = vidioc_s_input, | |
1324 | .vidioc_queryctrl = vidioc_queryctrl, | |
1325 | .vidioc_g_audio = vidioc_g_audio, | |
ed4d6375 | 1326 | .vidioc_s_audio = vidioc_s_audio, |
c5f48367 TM |
1327 | .vidioc_g_ctrl = vidioc_g_ctrl, |
1328 | .vidioc_s_ctrl = vidioc_s_ctrl, | |
1329 | .vidioc_streamon = vidioc_streamon, | |
1330 | .vidioc_streamoff = vidioc_streamoff, | |
1331 | #ifdef CONFIG_VIDEO_V4L1_COMPAT | |
1332 | /* .vidiocgmbuf = vidiocgmbuf, */ | |
1333 | #endif | |
1334 | .vidioc_g_tuner = vidioc_g_tuner, | |
1335 | .vidioc_s_tuner = vidioc_s_tuner, | |
1336 | .vidioc_g_frequency = vidioc_g_frequency, | |
1337 | .vidioc_s_frequency = vidioc_s_frequency, | |
1338 | #ifdef CONFIG_VIDEO_ADV_DEBUG | |
1339 | .vidioc_g_register = vidioc_g_register, | |
1340 | .vidioc_s_register = vidioc_s_register, | |
1341 | #endif | |
a399810c HV |
1342 | }; |
1343 | ||
1344 | static struct video_device usbvision_video_template = { | |
a399810c HV |
1345 | .fops = &usbvision_fops, |
1346 | .ioctl_ops = &usbvision_ioctl_ops, | |
1347 | .name = "usbvision-video", | |
1348 | .release = video_device_release, | |
1349 | .minor = -1, | |
c5f48367 TM |
1350 | .tvnorms = USBVISION_NORMS, |
1351 | .current_norm = V4L2_STD_PAL | |
483dfdb6 TM |
1352 | }; |
1353 | ||
1354 | ||
1355 | // Radio template | |
bec43661 | 1356 | static const struct v4l2_file_operations usbvision_radio_fops = { |
483dfdb6 | 1357 | .owner = THIS_MODULE, |
483dfdb6 TM |
1358 | .open = usbvision_radio_open, |
1359 | .release = usbvision_radio_close, | |
c5f48367 | 1360 | .ioctl = video_ioctl2, |
483dfdb6 TM |
1361 | }; |
1362 | ||
a399810c | 1363 | static const struct v4l2_ioctl_ops usbvision_radio_ioctl_ops = { |
c5f48367 TM |
1364 | .vidioc_querycap = vidioc_querycap, |
1365 | .vidioc_enum_input = vidioc_enum_input, | |
1366 | .vidioc_g_input = vidioc_g_input, | |
1367 | .vidioc_s_input = vidioc_s_input, | |
1368 | .vidioc_queryctrl = vidioc_queryctrl, | |
1369 | .vidioc_g_audio = vidioc_g_audio, | |
ed4d6375 | 1370 | .vidioc_s_audio = vidioc_s_audio, |
c5f48367 TM |
1371 | .vidioc_g_ctrl = vidioc_g_ctrl, |
1372 | .vidioc_s_ctrl = vidioc_s_ctrl, | |
1373 | .vidioc_g_tuner = vidioc_g_tuner, | |
1374 | .vidioc_s_tuner = vidioc_s_tuner, | |
1375 | .vidioc_g_frequency = vidioc_g_frequency, | |
1376 | .vidioc_s_frequency = vidioc_s_frequency, | |
a399810c HV |
1377 | }; |
1378 | ||
1379 | static struct video_device usbvision_radio_template = { | |
a399810c HV |
1380 | .fops = &usbvision_radio_fops, |
1381 | .name = "usbvision-radio", | |
1382 | .release = video_device_release, | |
1383 | .minor = -1, | |
1384 | .ioctl_ops = &usbvision_radio_ioctl_ops, | |
c5f48367 TM |
1385 | |
1386 | .tvnorms = USBVISION_NORMS, | |
1387 | .current_norm = V4L2_STD_PAL | |
483dfdb6 TM |
1388 | }; |
1389 | ||
483dfdb6 | 1390 | // vbi template |
bec43661 | 1391 | static const struct v4l2_file_operations usbvision_vbi_fops = { |
483dfdb6 | 1392 | .owner = THIS_MODULE, |
483dfdb6 TM |
1393 | .open = usbvision_vbi_open, |
1394 | .release = usbvision_vbi_close, | |
1395 | .ioctl = usbvision_vbi_ioctl, | |
483dfdb6 TM |
1396 | }; |
1397 | ||
1398 | static struct video_device usbvision_vbi_template= | |
1399 | { | |
483dfdb6 | 1400 | .fops = &usbvision_vbi_fops, |
483dfdb6 TM |
1401 | .release = video_device_release, |
1402 | .name = "usbvision-vbi", | |
483dfdb6 TM |
1403 | .minor = -1, |
1404 | }; | |
1405 | ||
1406 | ||
1407 | static struct video_device *usbvision_vdev_init(struct usb_usbvision *usbvision, | |
1408 | struct video_device *vdev_template, | |
1409 | char *name) | |
1410 | { | |
1411 | struct usb_device *usb_dev = usbvision->dev; | |
1412 | struct video_device *vdev; | |
1413 | ||
1414 | if (usb_dev == NULL) { | |
be9ed511 MCC |
1415 | dev_err(&usbvision->dev->dev, |
1416 | "%s: usbvision->dev is not set\n", __func__); | |
483dfdb6 TM |
1417 | return NULL; |
1418 | } | |
1419 | ||
1420 | vdev = video_device_alloc(); | |
1421 | if (NULL == vdev) { | |
1422 | return NULL; | |
1423 | } | |
1424 | *vdev = *vdev_template; | |
1425 | // vdev->minor = -1; | |
1df79537 | 1426 | vdev->v4l2_dev = &usbvision->v4l2_dev; |
483dfdb6 TM |
1427 | snprintf(vdev->name, sizeof(vdev->name), "%s", name); |
1428 | video_set_drvdata(vdev, usbvision); | |
1429 | return vdev; | |
1430 | } | |
1431 | ||
1432 | // unregister video4linux devices | |
1433 | static void usbvision_unregister_video(struct usb_usbvision *usbvision) | |
1434 | { | |
1435 | // vbi Device: | |
1436 | if (usbvision->vbi) { | |
c5f48367 | 1437 | PDEBUG(DBG_PROBE, "unregister /dev/vbi%d [v4l2]", |
c6330fb8 | 1438 | usbvision->vbi->num); |
483dfdb6 TM |
1439 | if (usbvision->vbi->minor != -1) { |
1440 | video_unregister_device(usbvision->vbi); | |
c5f48367 | 1441 | } else { |
483dfdb6 TM |
1442 | video_device_release(usbvision->vbi); |
1443 | } | |
1444 | usbvision->vbi = NULL; | |
1445 | } | |
1446 | ||
1447 | // Radio Device: | |
1448 | if (usbvision->rdev) { | |
c5f48367 | 1449 | PDEBUG(DBG_PROBE, "unregister /dev/radio%d [v4l2]", |
c6330fb8 | 1450 | usbvision->rdev->num); |
483dfdb6 TM |
1451 | if (usbvision->rdev->minor != -1) { |
1452 | video_unregister_device(usbvision->rdev); | |
c5f48367 | 1453 | } else { |
483dfdb6 TM |
1454 | video_device_release(usbvision->rdev); |
1455 | } | |
1456 | usbvision->rdev = NULL; | |
1457 | } | |
1458 | ||
1459 | // Video Device: | |
1460 | if (usbvision->vdev) { | |
c5f48367 | 1461 | PDEBUG(DBG_PROBE, "unregister /dev/video%d [v4l2]", |
c6330fb8 | 1462 | usbvision->vdev->num); |
483dfdb6 TM |
1463 | if (usbvision->vdev->minor != -1) { |
1464 | video_unregister_device(usbvision->vdev); | |
c5f48367 | 1465 | } else { |
483dfdb6 TM |
1466 | video_device_release(usbvision->vdev); |
1467 | } | |
1468 | usbvision->vdev = NULL; | |
1469 | } | |
1470 | } | |
1471 | ||
1472 | // register video4linux devices | |
1473 | static int __devinit usbvision_register_video(struct usb_usbvision *usbvision) | |
1474 | { | |
1475 | // Video Device: | |
c5f48367 TM |
1476 | usbvision->vdev = usbvision_vdev_init(usbvision, |
1477 | &usbvision_video_template, | |
1478 | "USBVision Video"); | |
483dfdb6 TM |
1479 | if (usbvision->vdev == NULL) { |
1480 | goto err_exit; | |
1481 | } | |
c5f48367 TM |
1482 | if (video_register_device(usbvision->vdev, |
1483 | VFL_TYPE_GRABBER, | |
1484 | video_nr)<0) { | |
483dfdb6 TM |
1485 | goto err_exit; |
1486 | } | |
c5f48367 | 1487 | printk(KERN_INFO "USBVision[%d]: registered USBVision Video device /dev/video%d [v4l2]\n", |
c6330fb8 | 1488 | usbvision->nr, usbvision->vdev->num); |
483dfdb6 TM |
1489 | |
1490 | // Radio Device: | |
1491 | if (usbvision_device_data[usbvision->DevModel].Radio) { | |
1492 | // usbvision has radio | |
c5f48367 TM |
1493 | usbvision->rdev = usbvision_vdev_init(usbvision, |
1494 | &usbvision_radio_template, | |
1495 | "USBVision Radio"); | |
483dfdb6 TM |
1496 | if (usbvision->rdev == NULL) { |
1497 | goto err_exit; | |
1498 | } | |
c5f48367 TM |
1499 | if (video_register_device(usbvision->rdev, |
1500 | VFL_TYPE_RADIO, | |
1501 | radio_nr)<0) { | |
483dfdb6 TM |
1502 | goto err_exit; |
1503 | } | |
c5f48367 | 1504 | printk(KERN_INFO "USBVision[%d]: registered USBVision Radio device /dev/radio%d [v4l2]\n", |
c6330fb8 | 1505 | usbvision->nr, usbvision->rdev->num); |
483dfdb6 TM |
1506 | } |
1507 | // vbi Device: | |
1508 | if (usbvision_device_data[usbvision->DevModel].vbi) { | |
c5f48367 TM |
1509 | usbvision->vbi = usbvision_vdev_init(usbvision, |
1510 | &usbvision_vbi_template, | |
1511 | "USBVision VBI"); | |
483dfdb6 TM |
1512 | if (usbvision->vdev == NULL) { |
1513 | goto err_exit; | |
1514 | } | |
c5f48367 TM |
1515 | if (video_register_device(usbvision->vbi, |
1516 | VFL_TYPE_VBI, | |
1517 | vbi_nr)<0) { | |
483dfdb6 TM |
1518 | goto err_exit; |
1519 | } | |
c5f48367 | 1520 | printk(KERN_INFO "USBVision[%d]: registered USBVision VBI device /dev/vbi%d [v4l2] (Not Working Yet!)\n", |
c6330fb8 | 1521 | usbvision->nr, usbvision->vbi->num); |
483dfdb6 TM |
1522 | } |
1523 | // all done | |
1524 | return 0; | |
1525 | ||
1526 | err_exit: | |
be9ed511 MCC |
1527 | dev_err(&usbvision->dev->dev, |
1528 | "USBVision[%d]: video_register_device() failed\n", | |
1529 | usbvision->nr); | |
483dfdb6 TM |
1530 | usbvision_unregister_video(usbvision); |
1531 | return -1; | |
1532 | } | |
1533 | ||
1534 | /* | |
1535 | * usbvision_alloc() | |
1536 | * | |
c5f48367 TM |
1537 | * This code allocates the struct usb_usbvision. |
1538 | * It is filled with default values. | |
483dfdb6 TM |
1539 | * |
1540 | * Returns NULL on error, a pointer to usb_usbvision else. | |
1541 | * | |
1542 | */ | |
1543 | static struct usb_usbvision *usbvision_alloc(struct usb_device *dev) | |
1544 | { | |
1545 | struct usb_usbvision *usbvision; | |
1546 | ||
1df79537 HV |
1547 | usbvision = kzalloc(sizeof(struct usb_usbvision), GFP_KERNEL); |
1548 | if (usbvision == NULL) | |
1549 | return NULL; | |
483dfdb6 TM |
1550 | |
1551 | usbvision->dev = dev; | |
1df79537 HV |
1552 | if (v4l2_device_register(&dev->dev, &usbvision->v4l2_dev)) |
1553 | goto err_free; | |
483dfdb6 | 1554 | |
289d4d2f | 1555 | mutex_init(&usbvision->lock); /* available */ |
483dfdb6 TM |
1556 | |
1557 | // prepare control urb for control messages during interrupts | |
1558 | usbvision->ctrlUrb = usb_alloc_urb(USBVISION_URB_FRAMES, GFP_KERNEL); | |
1df79537 HV |
1559 | if (usbvision->ctrlUrb == NULL) |
1560 | goto err_unreg; | |
483dfdb6 | 1561 | init_waitqueue_head(&usbvision->ctrlUrb_wq); |
483dfdb6 TM |
1562 | |
1563 | usbvision_init_powerOffTimer(usbvision); | |
1564 | ||
1565 | return usbvision; | |
1566 | ||
1df79537 HV |
1567 | err_unreg: |
1568 | v4l2_device_unregister(&usbvision->v4l2_dev); | |
1569 | err_free: | |
1570 | kfree(usbvision); | |
483dfdb6 TM |
1571 | return NULL; |
1572 | } | |
1573 | ||
1574 | /* | |
1575 | * usbvision_release() | |
1576 | * | |
1577 | * This code does final release of struct usb_usbvision. This happens | |
1578 | * after the device is disconnected -and- all clients closed their files. | |
1579 | * | |
1580 | */ | |
1581 | static void usbvision_release(struct usb_usbvision *usbvision) | |
1582 | { | |
1583 | PDEBUG(DBG_PROBE, ""); | |
1584 | ||
289d4d2f | 1585 | mutex_lock(&usbvision->lock); |
483dfdb6 TM |
1586 | |
1587 | usbvision_reset_powerOffTimer(usbvision); | |
1588 | ||
1589 | usbvision->initialized = 0; | |
1590 | ||
289d4d2f | 1591 | mutex_unlock(&usbvision->lock); |
483dfdb6 TM |
1592 | |
1593 | usbvision_remove_sysfs(usbvision->vdev); | |
1594 | usbvision_unregister_video(usbvision); | |
1595 | ||
1596 | if (usbvision->ctrlUrb) { | |
1597 | usb_free_urb(usbvision->ctrlUrb); | |
1598 | } | |
1599 | ||
1df79537 | 1600 | v4l2_device_unregister(&usbvision->v4l2_dev); |
483dfdb6 TM |
1601 | kfree(usbvision); |
1602 | ||
1603 | PDEBUG(DBG_PROBE, "success"); | |
1604 | } | |
1605 | ||
1606 | ||
c5f48367 | 1607 | /*********************** usb interface **********************************/ |
483dfdb6 TM |
1608 | |
1609 | static void usbvision_configure_video(struct usb_usbvision *usbvision) | |
1610 | { | |
c5f48367 | 1611 | int model; |
483dfdb6 TM |
1612 | |
1613 | if (usbvision == NULL) | |
1614 | return; | |
1615 | ||
1616 | model = usbvision->DevModel; | |
1617 | usbvision->palette = usbvision_v4l2_format[2]; // V4L2_PIX_FMT_RGB24; | |
1618 | ||
c682b3a7 | 1619 | if (usbvision_device_data[usbvision->DevModel].Vin_Reg2_override) { |
c5f48367 TM |
1620 | usbvision->Vin_Reg2_Preset = |
1621 | usbvision_device_data[usbvision->DevModel].Vin_Reg2; | |
483dfdb6 TM |
1622 | } else { |
1623 | usbvision->Vin_Reg2_Preset = 0; | |
1624 | } | |
1625 | ||
c5f48367 | 1626 | usbvision->tvnormId = usbvision_device_data[model].VideoNorm; |
483dfdb6 TM |
1627 | |
1628 | usbvision->video_inputs = usbvision_device_data[model].VideoChannels; | |
1629 | usbvision->ctl_input = 0; | |
1630 | ||
1631 | /* This should be here to make i2c clients to be able to register */ | |
c5f48367 TM |
1632 | /* first switch off audio */ |
1633 | usbvision_audio_off(usbvision); | |
483dfdb6 | 1634 | if (!PowerOnAtOpen) { |
c5f48367 TM |
1635 | /* and then power up the noisy tuner */ |
1636 | usbvision_power_on(usbvision); | |
1ff16c20 | 1637 | usbvision_i2c_register(usbvision); |
483dfdb6 TM |
1638 | } |
1639 | } | |
1640 | ||
1641 | /* | |
1642 | * usbvision_probe() | |
1643 | * | |
1644 | * This procedure queries device descriptor and accepts the interface | |
1645 | * if it looks like USBVISION video device | |
1646 | * | |
1647 | */ | |
659ae56d MCC |
1648 | static int __devinit usbvision_probe(struct usb_interface *intf, |
1649 | const struct usb_device_id *devid) | |
483dfdb6 | 1650 | { |
2a9f8b5d TM |
1651 | struct usb_device *dev = usb_get_dev(interface_to_usbdev(intf)); |
1652 | struct usb_interface *uif; | |
483dfdb6 TM |
1653 | __u8 ifnum = intf->altsetting->desc.bInterfaceNumber; |
1654 | const struct usb_host_interface *interface; | |
1655 | struct usb_usbvision *usbvision = NULL; | |
1656 | const struct usb_endpoint_descriptor *endpoint; | |
2a9f8b5d | 1657 | int model,i; |
483dfdb6 TM |
1658 | |
1659 | PDEBUG(DBG_PROBE, "VID=%#04x, PID=%#04x, ifnum=%u", | |
659ae56d MCC |
1660 | dev->descriptor.idVendor, |
1661 | dev->descriptor.idProduct, ifnum); | |
2a9f8b5d | 1662 | |
659ae56d | 1663 | model = devid->driver_info; |
f8a389db | 1664 | if ( (model<0) || (model>=usbvision_device_data_size) ) { |
672d013b | 1665 | PDEBUG(DBG_PROBE, "model out of bounds %d",model); |
f8a389db MCC |
1666 | return -ENODEV; |
1667 | } | |
d2db42dd | 1668 | printk(KERN_INFO "%s: %s found\n", __func__, |
659ae56d | 1669 | usbvision_device_data[model].ModelString); |
483dfdb6 | 1670 | |
483dfdb6 TM |
1671 | if (usbvision_device_data[model].Interface >= 0) { |
1672 | interface = &dev->actconfig->interface[usbvision_device_data[model].Interface]->altsetting[0]; | |
c5f48367 | 1673 | } else { |
483dfdb6 TM |
1674 | interface = &dev->actconfig->interface[ifnum]->altsetting[0]; |
1675 | } | |
1676 | endpoint = &interface->endpoint[1].desc; | |
2230c3c8 | 1677 | if (!usb_endpoint_xfer_isoc(endpoint)) { |
be9ed511 | 1678 | dev_err(&intf->dev, "%s: interface %d. has non-ISO endpoint!\n", |
d2db42dd | 1679 | __func__, ifnum); |
be9ed511 | 1680 | dev_err(&intf->dev, "%s: Endpoint attributes %d", |
d2db42dd | 1681 | __func__, endpoint->bmAttributes); |
483dfdb6 TM |
1682 | return -ENODEV; |
1683 | } | |
13417982 | 1684 | if (usb_endpoint_dir_out(endpoint)) { |
be9ed511 | 1685 | dev_err(&intf->dev, "%s: interface %d. has ISO OUT endpoint!\n", |
d2db42dd | 1686 | __func__, ifnum); |
483dfdb6 TM |
1687 | return -ENODEV; |
1688 | } | |
1689 | ||
483dfdb6 | 1690 | if ((usbvision = usbvision_alloc(dev)) == NULL) { |
be9ed511 | 1691 | dev_err(&intf->dev, "%s: couldn't allocate USBVision struct\n", __func__); |
483dfdb6 TM |
1692 | return -ENOMEM; |
1693 | } | |
659ae56d | 1694 | |
483dfdb6 TM |
1695 | if (dev->descriptor.bNumConfigurations > 1) { |
1696 | usbvision->bridgeType = BRIDGE_NT1004; | |
c5f48367 | 1697 | } else if (model == DAZZLE_DVC_90_REV_1_SECAM) { |
483dfdb6 | 1698 | usbvision->bridgeType = BRIDGE_NT1005; |
c5f48367 | 1699 | } else { |
483dfdb6 TM |
1700 | usbvision->bridgeType = BRIDGE_NT1003; |
1701 | } | |
1702 | PDEBUG(DBG_PROBE, "bridgeType %d", usbvision->bridgeType); | |
1703 | ||
289d4d2f | 1704 | mutex_lock(&usbvision->lock); |
483dfdb6 | 1705 | |
2a9f8b5d TM |
1706 | /* compute alternate max packet sizes */ |
1707 | uif = dev->actconfig->interface[0]; | |
1708 | ||
1709 | usbvision->num_alt=uif->num_altsetting; | |
1710 | PDEBUG(DBG_PROBE, "Alternate settings: %i",usbvision->num_alt); | |
1711 | usbvision->alt_max_pkt_size = kmalloc(32* | |
1712 | usbvision->num_alt,GFP_KERNEL); | |
1713 | if (usbvision->alt_max_pkt_size == NULL) { | |
be9ed511 | 1714 | dev_err(&intf->dev, "usbvision: out of memory!\n"); |
0991112c | 1715 | mutex_unlock(&usbvision->lock); |
2a9f8b5d TM |
1716 | return -ENOMEM; |
1717 | } | |
1718 | ||
1719 | for (i = 0; i < usbvision->num_alt ; i++) { | |
1720 | u16 tmp = le16_to_cpu(uif->altsetting[i].endpoint[1].desc. | |
1721 | wMaxPacketSize); | |
1722 | usbvision->alt_max_pkt_size[i] = | |
1723 | (tmp & 0x07ff) * (((tmp & 0x1800) >> 11) + 1); | |
1724 | PDEBUG(DBG_PROBE, "Alternate setting %i, max size= %i",i, | |
1725 | usbvision->alt_max_pkt_size[i]); | |
1726 | } | |
1727 | ||
1728 | ||
483dfdb6 TM |
1729 | usbvision->nr = usbvision_nr++; |
1730 | ||
1731 | usbvision->have_tuner = usbvision_device_data[model].Tuner; | |
1732 | if (usbvision->have_tuner) { | |
1733 | usbvision->tuner_type = usbvision_device_data[model].TunerType; | |
1734 | } | |
1735 | ||
483dfdb6 TM |
1736 | usbvision->DevModel = model; |
1737 | usbvision->remove_pending = 0; | |
1738 | usbvision->iface = ifnum; | |
2a9f8b5d | 1739 | usbvision->ifaceAlt = 0; |
483dfdb6 TM |
1740 | usbvision->video_endp = endpoint->bEndpointAddress; |
1741 | usbvision->isocPacketSize = 0; | |
1742 | usbvision->usb_bandwidth = 0; | |
1743 | usbvision->user = 0; | |
1744 | usbvision->streaming = Stream_Off; | |
1745 | usbvision_register_video(usbvision); | |
1746 | usbvision_configure_video(usbvision); | |
289d4d2f | 1747 | mutex_unlock(&usbvision->lock); |
483dfdb6 TM |
1748 | |
1749 | ||
1750 | usb_set_intfdata (intf, usbvision); | |
1751 | usbvision_create_sysfs(usbvision->vdev); | |
1752 | ||
1753 | PDEBUG(DBG_PROBE, "success"); | |
1754 | return 0; | |
1755 | } | |
1756 | ||
1757 | ||
1758 | /* | |
1759 | * usbvision_disconnect() | |
1760 | * | |
1761 | * This procedure stops all driver activity, deallocates interface-private | |
1762 | * structure (pointed by 'ptr') and after that driver should be removable | |
1763 | * with no ill consequences. | |
1764 | * | |
1765 | */ | |
1766 | static void __devexit usbvision_disconnect(struct usb_interface *intf) | |
1767 | { | |
1768 | struct usb_usbvision *usbvision = usb_get_intfdata(intf); | |
1769 | ||
1770 | PDEBUG(DBG_PROBE, ""); | |
1771 | ||
1772 | if (usbvision == NULL) { | |
be9ed511 MCC |
1773 | dev_err(&usbvision->dev->dev, |
1774 | "%s: usb_get_intfdata() failed\n", __func__); | |
483dfdb6 TM |
1775 | return; |
1776 | } | |
1777 | usb_set_intfdata (intf, NULL); | |
1778 | ||
289d4d2f | 1779 | mutex_lock(&usbvision->lock); |
483dfdb6 TM |
1780 | |
1781 | // At this time we ask to cancel outstanding URBs | |
1782 | usbvision_stop_isoc(usbvision); | |
1783 | ||
1784 | if (usbvision->power) { | |
1ff16c20 | 1785 | usbvision_i2c_unregister(usbvision); |
483dfdb6 TM |
1786 | usbvision_power_off(usbvision); |
1787 | } | |
1788 | usbvision->remove_pending = 1; // Now all ISO data will be ignored | |
1789 | ||
1790 | usb_put_dev(usbvision->dev); | |
1791 | usbvision->dev = NULL; // USB device is no more | |
1792 | ||
289d4d2f | 1793 | mutex_unlock(&usbvision->lock); |
483dfdb6 TM |
1794 | |
1795 | if (usbvision->user) { | |
c5f48367 | 1796 | printk(KERN_INFO "%s: In use, disconnect pending\n", |
d2db42dd | 1797 | __func__); |
483dfdb6 TM |
1798 | wake_up_interruptible(&usbvision->wait_frame); |
1799 | wake_up_interruptible(&usbvision->wait_stream); | |
c5f48367 | 1800 | } else { |
483dfdb6 TM |
1801 | usbvision_release(usbvision); |
1802 | } | |
1803 | ||
1804 | PDEBUG(DBG_PROBE, "success"); | |
483dfdb6 TM |
1805 | } |
1806 | ||
1807 | static struct usb_driver usbvision_driver = { | |
1808 | .name = "usbvision", | |
1809 | .id_table = usbvision_table, | |
1810 | .probe = usbvision_probe, | |
1811 | .disconnect = usbvision_disconnect | |
1812 | }; | |
1813 | ||
483dfdb6 TM |
1814 | /* |
1815 | * usbvision_init() | |
1816 | * | |
1817 | * This code is run to initialize the driver. | |
1818 | * | |
1819 | */ | |
1820 | static int __init usbvision_init(void) | |
1821 | { | |
1822 | int errCode; | |
1823 | ||
1824 | PDEBUG(DBG_PROBE, ""); | |
1825 | ||
483dfdb6 TM |
1826 | PDEBUG(DBG_IO, "IO debugging is enabled [video]"); |
1827 | PDEBUG(DBG_PROBE, "PROBE debugging is enabled [video]"); | |
c876a346 | 1828 | PDEBUG(DBG_MMAP, "MMAP debugging is enabled [video]"); |
483dfdb6 TM |
1829 | |
1830 | /* disable planar mode support unless compression enabled */ | |
1831 | if (isocMode != ISOC_MODE_COMPRESS ) { | |
1832 | // FIXME : not the right way to set supported flag | |
1833 | usbvision_v4l2_format[6].supported = 0; // V4L2_PIX_FMT_YVU420 | |
1834 | usbvision_v4l2_format[7].supported = 0; // V4L2_PIX_FMT_YUV422P | |
1835 | } | |
1836 | ||
483dfdb6 TM |
1837 | errCode = usb_register(&usbvision_driver); |
1838 | ||
1839 | if (errCode == 0) { | |
de6a1b8e | 1840 | printk(KERN_INFO DRIVER_DESC " : " USBVISION_VERSION_STRING "\n"); |
483dfdb6 TM |
1841 | PDEBUG(DBG_PROBE, "success"); |
1842 | } | |
1843 | return errCode; | |
1844 | } | |
1845 | ||
1846 | static void __exit usbvision_exit(void) | |
1847 | { | |
1848 | PDEBUG(DBG_PROBE, ""); | |
1849 | ||
1850 | usb_deregister(&usbvision_driver); | |
1851 | PDEBUG(DBG_PROBE, "success"); | |
1852 | } | |
1853 | ||
1854 | module_init(usbvision_init); | |
1855 | module_exit(usbvision_exit); | |
1856 | ||
1857 | /* | |
1858 | * Overrides for Emacs so that we follow Linus's tabbing style. | |
1859 | * --------------------------------------------------------------------------- | |
1860 | * Local variables: | |
1861 | * c-basic-offset: 8 | |
1862 | * End: | |
1863 | */ |