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