diff options
| author | Jonathan Herman <hermanjl@cs.unc.edu> | 2013-01-22 10:38:37 -0500 |
|---|---|---|
| committer | Jonathan Herman <hermanjl@cs.unc.edu> | 2013-01-22 10:38:37 -0500 |
| commit | fcc9d2e5a6c89d22b8b773a64fb4ad21ac318446 (patch) | |
| tree | a57612d1888735a2ec7972891b68c1ac5ec8faea /drivers/media/video/v4l2-dev.c | |
| parent | 8dea78da5cee153b8af9c07a2745f6c55057fe12 (diff) | |
Diffstat (limited to 'drivers/media/video/v4l2-dev.c')
| -rw-r--r-- | drivers/media/video/v4l2-dev.c | 806 |
1 files changed, 806 insertions, 0 deletions
diff --git a/drivers/media/video/v4l2-dev.c b/drivers/media/video/v4l2-dev.c new file mode 100644 index 00000000000..a5c9ed128b9 --- /dev/null +++ b/drivers/media/video/v4l2-dev.c | |||
| @@ -0,0 +1,806 @@ | |||
| 1 | /* | ||
| 2 | * Video capture interface for Linux version 2 | ||
| 3 | * | ||
| 4 | * A generic video device interface for the LINUX operating system | ||
| 5 | * using a set of device structures/vectors for low level operations. | ||
| 6 | * | ||
| 7 | * This program is free software; you can redistribute it and/or | ||
| 8 | * modify it under the terms of the GNU General Public License | ||
| 9 | * as published by the Free Software Foundation; either version | ||
| 10 | * 2 of the License, or (at your option) any later version. | ||
| 11 | * | ||
| 12 | * Authors: Alan Cox, <alan@lxorguk.ukuu.org.uk> (version 1) | ||
| 13 | * Mauro Carvalho Chehab <mchehab@infradead.org> (version 2) | ||
| 14 | * | ||
| 15 | * Fixes: 20000516 Claudio Matsuoka <claudio@conectiva.com> | ||
| 16 | * - Added procfs support | ||
| 17 | */ | ||
| 18 | |||
| 19 | #include <linux/module.h> | ||
| 20 | #include <linux/types.h> | ||
| 21 | #include <linux/kernel.h> | ||
| 22 | #include <linux/mm.h> | ||
| 23 | #include <linux/string.h> | ||
| 24 | #include <linux/errno.h> | ||
| 25 | #include <linux/init.h> | ||
| 26 | #include <linux/kmod.h> | ||
| 27 | #include <linux/slab.h> | ||
| 28 | #include <asm/uaccess.h> | ||
| 29 | #include <asm/system.h> | ||
| 30 | |||
| 31 | #include <media/v4l2-common.h> | ||
| 32 | #include <media/v4l2-device.h> | ||
| 33 | #include <media/v4l2-ioctl.h> | ||
| 34 | |||
| 35 | #define VIDEO_NUM_DEVICES 256 | ||
| 36 | #define VIDEO_NAME "video4linux" | ||
| 37 | |||
| 38 | /* | ||
| 39 | * sysfs stuff | ||
| 40 | */ | ||
| 41 | |||
| 42 | static ssize_t show_index(struct device *cd, | ||
| 43 | struct device_attribute *attr, char *buf) | ||
| 44 | { | ||
| 45 | struct video_device *vdev = to_video_device(cd); | ||
| 46 | |||
| 47 | return sprintf(buf, "%i\n", vdev->index); | ||
| 48 | } | ||
| 49 | |||
| 50 | static ssize_t show_name(struct device *cd, | ||
| 51 | struct device_attribute *attr, char *buf) | ||
| 52 | { | ||
| 53 | struct video_device *vdev = to_video_device(cd); | ||
| 54 | |||
| 55 | return sprintf(buf, "%.*s\n", (int)sizeof(vdev->name), vdev->name); | ||
| 56 | } | ||
| 57 | |||
| 58 | static struct device_attribute video_device_attrs[] = { | ||
| 59 | __ATTR(name, S_IRUGO, show_name, NULL), | ||
| 60 | __ATTR(index, S_IRUGO, show_index, NULL), | ||
| 61 | __ATTR_NULL | ||
| 62 | }; | ||
| 63 | |||
| 64 | /* | ||
| 65 | * Active devices | ||
| 66 | */ | ||
| 67 | static struct video_device *video_device[VIDEO_NUM_DEVICES]; | ||
| 68 | static DEFINE_MUTEX(videodev_lock); | ||
| 69 | static DECLARE_BITMAP(devnode_nums[VFL_TYPE_MAX], VIDEO_NUM_DEVICES); | ||
| 70 | |||
| 71 | /* Device node utility functions */ | ||
| 72 | |||
| 73 | /* Note: these utility functions all assume that vfl_type is in the range | ||
| 74 | [0, VFL_TYPE_MAX-1]. */ | ||
| 75 | |||
| 76 | #ifdef CONFIG_VIDEO_FIXED_MINOR_RANGES | ||
| 77 | /* Return the bitmap corresponding to vfl_type. */ | ||
| 78 | static inline unsigned long *devnode_bits(int vfl_type) | ||
| 79 | { | ||
| 80 | /* Any types not assigned to fixed minor ranges must be mapped to | ||
| 81 | one single bitmap for the purposes of finding a free node number | ||
| 82 | since all those unassigned types use the same minor range. */ | ||
| 83 | int idx = (vfl_type > VFL_TYPE_RADIO) ? VFL_TYPE_MAX - 1 : vfl_type; | ||
| 84 | |||
| 85 | return devnode_nums[idx]; | ||
| 86 | } | ||
| 87 | #else | ||
| 88 | /* Return the bitmap corresponding to vfl_type. */ | ||
| 89 | static inline unsigned long *devnode_bits(int vfl_type) | ||
| 90 | { | ||
| 91 | return devnode_nums[vfl_type]; | ||
| 92 | } | ||
| 93 | #endif | ||
| 94 | |||
| 95 | /* Mark device node number vdev->num as used */ | ||
| 96 | static inline void devnode_set(struct video_device *vdev) | ||
| 97 | { | ||
| 98 | set_bit(vdev->num, devnode_bits(vdev->vfl_type)); | ||
| 99 | } | ||
| 100 | |||
| 101 | /* Mark device node number vdev->num as unused */ | ||
| 102 | static inline void devnode_clear(struct video_device *vdev) | ||
| 103 | { | ||
| 104 | clear_bit(vdev->num, devnode_bits(vdev->vfl_type)); | ||
| 105 | } | ||
| 106 | |||
| 107 | /* Try to find a free device node number in the range [from, to> */ | ||
| 108 | static inline int devnode_find(struct video_device *vdev, int from, int to) | ||
| 109 | { | ||
| 110 | return find_next_zero_bit(devnode_bits(vdev->vfl_type), to, from); | ||
| 111 | } | ||
| 112 | |||
| 113 | struct video_device *video_device_alloc(void) | ||
| 114 | { | ||
| 115 | return kzalloc(sizeof(struct video_device), GFP_KERNEL); | ||
| 116 | } | ||
| 117 | EXPORT_SYMBOL(video_device_alloc); | ||
| 118 | |||
| 119 | void video_device_release(struct video_device *vdev) | ||
| 120 | { | ||
| 121 | kfree(vdev); | ||
| 122 | } | ||
| 123 | EXPORT_SYMBOL(video_device_release); | ||
| 124 | |||
| 125 | void video_device_release_empty(struct video_device *vdev) | ||
| 126 | { | ||
| 127 | /* Do nothing */ | ||
| 128 | /* Only valid when the video_device struct is a static. */ | ||
| 129 | } | ||
| 130 | EXPORT_SYMBOL(video_device_release_empty); | ||
| 131 | |||
| 132 | static inline void video_get(struct video_device *vdev) | ||
| 133 | { | ||
| 134 | get_device(&vdev->dev); | ||
| 135 | } | ||
| 136 | |||
| 137 | static inline void video_put(struct video_device *vdev) | ||
| 138 | { | ||
| 139 | put_device(&vdev->dev); | ||
| 140 | } | ||
| 141 | |||
| 142 | /* Called when the last user of the video device exits. */ | ||
| 143 | static void v4l2_device_release(struct device *cd) | ||
| 144 | { | ||
| 145 | struct video_device *vdev = to_video_device(cd); | ||
| 146 | struct v4l2_device *v4l2_dev = vdev->v4l2_dev; | ||
| 147 | |||
| 148 | mutex_lock(&videodev_lock); | ||
| 149 | if (video_device[vdev->minor] != vdev) { | ||
| 150 | mutex_unlock(&videodev_lock); | ||
| 151 | /* should not happen */ | ||
| 152 | WARN_ON(1); | ||
| 153 | return; | ||
| 154 | } | ||
| 155 | |||
| 156 | /* Free up this device for reuse */ | ||
| 157 | video_device[vdev->minor] = NULL; | ||
| 158 | |||
| 159 | /* Delete the cdev on this minor as well */ | ||
| 160 | cdev_del(vdev->cdev); | ||
| 161 | /* Just in case some driver tries to access this from | ||
| 162 | the release() callback. */ | ||
| 163 | vdev->cdev = NULL; | ||
| 164 | |||
| 165 | /* Mark device node number as free */ | ||
| 166 | devnode_clear(vdev); | ||
| 167 | |||
| 168 | mutex_unlock(&videodev_lock); | ||
| 169 | |||
| 170 | #if defined(CONFIG_MEDIA_CONTROLLER) | ||
| 171 | if (vdev->v4l2_dev && vdev->v4l2_dev->mdev && | ||
| 172 | vdev->vfl_type != VFL_TYPE_SUBDEV) | ||
| 173 | media_device_unregister_entity(&vdev->entity); | ||
| 174 | #endif | ||
| 175 | |||
| 176 | /* Do not call v4l2_device_put if there is no release callback set. | ||
| 177 | * Drivers that have no v4l2_device release callback might free the | ||
| 178 | * v4l2_dev instance in the video_device release callback below, so we | ||
| 179 | * must perform this check here. | ||
| 180 | * | ||
| 181 | * TODO: In the long run all drivers that use v4l2_device should use the | ||
| 182 | * v4l2_device release callback. This check will then be unnecessary. | ||
| 183 | */ | ||
| 184 | if (v4l2_dev && v4l2_dev->release == NULL) | ||
| 185 | v4l2_dev = NULL; | ||
| 186 | |||
| 187 | /* Release video_device and perform other | ||
| 188 | cleanups as needed. */ | ||
| 189 | vdev->release(vdev); | ||
| 190 | |||
| 191 | /* Decrease v4l2_device refcount */ | ||
| 192 | if (v4l2_dev) | ||
| 193 | v4l2_device_put(v4l2_dev); | ||
| 194 | } | ||
| 195 | |||
| 196 | static struct class video_class = { | ||
| 197 | .name = VIDEO_NAME, | ||
| 198 | .dev_attrs = video_device_attrs, | ||
| 199 | }; | ||
| 200 | |||
| 201 | struct video_device *video_devdata(struct file *file) | ||
| 202 | { | ||
| 203 | return video_device[iminor(file->f_path.dentry->d_inode)]; | ||
| 204 | } | ||
| 205 | EXPORT_SYMBOL(video_devdata); | ||
| 206 | |||
| 207 | |||
| 208 | /* Priority handling */ | ||
| 209 | |||
| 210 | static inline bool prio_is_valid(enum v4l2_priority prio) | ||
| 211 | { | ||
| 212 | return prio == V4L2_PRIORITY_BACKGROUND || | ||
| 213 | prio == V4L2_PRIORITY_INTERACTIVE || | ||
| 214 | prio == V4L2_PRIORITY_RECORD; | ||
| 215 | } | ||
| 216 | |||
| 217 | void v4l2_prio_init(struct v4l2_prio_state *global) | ||
| 218 | { | ||
| 219 | memset(global, 0, sizeof(*global)); | ||
| 220 | } | ||
| 221 | EXPORT_SYMBOL(v4l2_prio_init); | ||
| 222 | |||
| 223 | int v4l2_prio_change(struct v4l2_prio_state *global, enum v4l2_priority *local, | ||
| 224 | enum v4l2_priority new) | ||
| 225 | { | ||
| 226 | if (!prio_is_valid(new)) | ||
| 227 | return -EINVAL; | ||
| 228 | if (*local == new) | ||
| 229 | return 0; | ||
| 230 | |||
| 231 | atomic_inc(&global->prios[new]); | ||
| 232 | if (prio_is_valid(*local)) | ||
| 233 | atomic_dec(&global->prios[*local]); | ||
| 234 | *local = new; | ||
| 235 | return 0; | ||
| 236 | } | ||
| 237 | EXPORT_SYMBOL(v4l2_prio_change); | ||
| 238 | |||
| 239 | void v4l2_prio_open(struct v4l2_prio_state *global, enum v4l2_priority *local) | ||
| 240 | { | ||
| 241 | v4l2_prio_change(global, local, V4L2_PRIORITY_DEFAULT); | ||
| 242 | } | ||
| 243 | EXPORT_SYMBOL(v4l2_prio_open); | ||
| 244 | |||
| 245 | void v4l2_prio_close(struct v4l2_prio_state *global, enum v4l2_priority local) | ||
| 246 | { | ||
| 247 | if (prio_is_valid(local)) | ||
| 248 | atomic_dec(&global->prios[local]); | ||
| 249 | } | ||
| 250 | EXPORT_SYMBOL(v4l2_prio_close); | ||
| 251 | |||
| 252 | enum v4l2_priority v4l2_prio_max(struct v4l2_prio_state *global) | ||
| 253 | { | ||
| 254 | if (atomic_read(&global->prios[V4L2_PRIORITY_RECORD]) > 0) | ||
| 255 | return V4L2_PRIORITY_RECORD; | ||
| 256 | if (atomic_read(&global->prios[V4L2_PRIORITY_INTERACTIVE]) > 0) | ||
| 257 | return V4L2_PRIORITY_INTERACTIVE; | ||
| 258 | if (atomic_read(&global->prios[V4L2_PRIORITY_BACKGROUND]) > 0) | ||
| 259 | return V4L2_PRIORITY_BACKGROUND; | ||
| 260 | return V4L2_PRIORITY_UNSET; | ||
| 261 | } | ||
| 262 | EXPORT_SYMBOL(v4l2_prio_max); | ||
| 263 | |||
| 264 | int v4l2_prio_check(struct v4l2_prio_state *global, enum v4l2_priority local) | ||
| 265 | { | ||
| 266 | return (local < v4l2_prio_max(global)) ? -EBUSY : 0; | ||
| 267 | } | ||
| 268 | EXPORT_SYMBOL(v4l2_prio_check); | ||
| 269 | |||
| 270 | |||
| 271 | static ssize_t v4l2_read(struct file *filp, char __user *buf, | ||
| 272 | size_t sz, loff_t *off) | ||
| 273 | { | ||
| 274 | struct video_device *vdev = video_devdata(filp); | ||
| 275 | int ret = -ENODEV; | ||
| 276 | |||
| 277 | if (!vdev->fops->read) | ||
| 278 | return -EINVAL; | ||
| 279 | if (vdev->lock && mutex_lock_interruptible(vdev->lock)) | ||
| 280 | return -ERESTARTSYS; | ||
| 281 | if (video_is_registered(vdev)) | ||
| 282 | ret = vdev->fops->read(filp, buf, sz, off); | ||
| 283 | if (vdev->lock) | ||
| 284 | mutex_unlock(vdev->lock); | ||
| 285 | return ret; | ||
| 286 | } | ||
| 287 | |||
| 288 | static ssize_t v4l2_write(struct file *filp, const char __user *buf, | ||
| 289 | size_t sz, loff_t *off) | ||
| 290 | { | ||
| 291 | struct video_device *vdev = video_devdata(filp); | ||
| 292 | int ret = -ENODEV; | ||
| 293 | |||
| 294 | if (!vdev->fops->write) | ||
| 295 | return -EINVAL; | ||
| 296 | if (vdev->lock && mutex_lock_interruptible(vdev->lock)) | ||
| 297 | return -ERESTARTSYS; | ||
| 298 | if (video_is_registered(vdev)) | ||
| 299 | ret = vdev->fops->write(filp, buf, sz, off); | ||
| 300 | if (vdev->lock) | ||
| 301 | mutex_unlock(vdev->lock); | ||
| 302 | return ret; | ||
| 303 | } | ||
| 304 | |||
| 305 | static unsigned int v4l2_poll(struct file *filp, struct poll_table_struct *poll) | ||
| 306 | { | ||
| 307 | struct video_device *vdev = video_devdata(filp); | ||
| 308 | int ret = POLLERR | POLLHUP; | ||
| 309 | |||
| 310 | if (!vdev->fops->poll) | ||
| 311 | return DEFAULT_POLLMASK; | ||
| 312 | if (vdev->lock) | ||
| 313 | mutex_lock(vdev->lock); | ||
| 314 | if (video_is_registered(vdev)) | ||
| 315 | ret = vdev->fops->poll(filp, poll); | ||
| 316 | if (vdev->lock) | ||
| 317 | mutex_unlock(vdev->lock); | ||
| 318 | return ret; | ||
| 319 | } | ||
| 320 | |||
| 321 | static long v4l2_ioctl(struct file *filp, unsigned int cmd, unsigned long arg) | ||
| 322 | { | ||
| 323 | struct video_device *vdev = video_devdata(filp); | ||
| 324 | int ret = -ENODEV; | ||
| 325 | |||
| 326 | if (vdev->fops->unlocked_ioctl) { | ||
| 327 | if (vdev->lock && mutex_lock_interruptible(vdev->lock)) | ||
| 328 | return -ERESTARTSYS; | ||
| 329 | if (video_is_registered(vdev)) | ||
| 330 | ret = vdev->fops->unlocked_ioctl(filp, cmd, arg); | ||
| 331 | if (vdev->lock) | ||
| 332 | mutex_unlock(vdev->lock); | ||
| 333 | } else if (vdev->fops->ioctl) { | ||
| 334 | /* This code path is a replacement for the BKL. It is a major | ||
| 335 | * hack but it will have to do for those drivers that are not | ||
| 336 | * yet converted to use unlocked_ioctl. | ||
| 337 | * | ||
| 338 | * There are two options: if the driver implements struct | ||
| 339 | * v4l2_device, then the lock defined there is used to | ||
| 340 | * serialize the ioctls. Otherwise the v4l2 core lock defined | ||
| 341 | * below is used. This lock is really bad since it serializes | ||
| 342 | * completely independent devices. | ||
| 343 | * | ||
| 344 | * Both variants suffer from the same problem: if the driver | ||
| 345 | * sleeps, then it blocks all ioctls since the lock is still | ||
| 346 | * held. This is very common for VIDIOC_DQBUF since that | ||
| 347 | * normally waits for a frame to arrive. As a result any other | ||
| 348 | * ioctl calls will proceed very, very slowly since each call | ||
| 349 | * will have to wait for the VIDIOC_QBUF to finish. Things that | ||
| 350 | * should take 0.01s may now take 10-20 seconds. | ||
| 351 | * | ||
| 352 | * The workaround is to *not* take the lock for VIDIOC_DQBUF. | ||
| 353 | * This actually works OK for videobuf-based drivers, since | ||
| 354 | * videobuf will take its own internal lock. | ||
| 355 | */ | ||
| 356 | static DEFINE_MUTEX(v4l2_ioctl_mutex); | ||
| 357 | struct mutex *m = vdev->v4l2_dev ? | ||
| 358 | &vdev->v4l2_dev->ioctl_lock : &v4l2_ioctl_mutex; | ||
| 359 | |||
| 360 | if (cmd != VIDIOC_DQBUF && mutex_lock_interruptible(m)) | ||
| 361 | return -ERESTARTSYS; | ||
| 362 | if (video_is_registered(vdev)) | ||
| 363 | ret = vdev->fops->ioctl(filp, cmd, arg); | ||
| 364 | if (cmd != VIDIOC_DQBUF) | ||
| 365 | mutex_unlock(m); | ||
| 366 | } else | ||
| 367 | ret = -ENOTTY; | ||
| 368 | |||
| 369 | return ret; | ||
| 370 | } | ||
| 371 | |||
| 372 | #ifdef CONFIG_MMU | ||
| 373 | #define v4l2_get_unmapped_area NULL | ||
| 374 | #else | ||
| 375 | static unsigned long v4l2_get_unmapped_area(struct file *filp, | ||
| 376 | unsigned long addr, unsigned long len, unsigned long pgoff, | ||
| 377 | unsigned long flags) | ||
| 378 | { | ||
| 379 | struct video_device *vdev = video_devdata(filp); | ||
| 380 | |||
| 381 | if (!vdev->fops->get_unmapped_area) | ||
| 382 | return -ENOSYS; | ||
| 383 | if (!video_is_registered(vdev)) | ||
| 384 | return -ENODEV; | ||
| 385 | return vdev->fops->get_unmapped_area(filp, addr, len, pgoff, flags); | ||
| 386 | } | ||
| 387 | #endif | ||
| 388 | |||
| 389 | static int v4l2_mmap(struct file *filp, struct vm_area_struct *vm) | ||
| 390 | { | ||
| 391 | struct video_device *vdev = video_devdata(filp); | ||
| 392 | int ret = -ENODEV; | ||
| 393 | |||
| 394 | if (!vdev->fops->mmap) | ||
| 395 | return ret; | ||
| 396 | if (vdev->lock && mutex_lock_interruptible(vdev->lock)) | ||
| 397 | return -ERESTARTSYS; | ||
| 398 | if (video_is_registered(vdev)) | ||
| 399 | ret = vdev->fops->mmap(filp, vm); | ||
| 400 | if (vdev->lock) | ||
| 401 | mutex_unlock(vdev->lock); | ||
| 402 | return ret; | ||
| 403 | } | ||
| 404 | |||
| 405 | /* Override for the open function */ | ||
| 406 | static int v4l2_open(struct inode *inode, struct file *filp) | ||
| 407 | { | ||
| 408 | struct video_device *vdev; | ||
| 409 | int ret = 0; | ||
| 410 | |||
| 411 | /* Check if the video device is available */ | ||
| 412 | mutex_lock(&videodev_lock); | ||
| 413 | vdev = video_devdata(filp); | ||
| 414 | /* return ENODEV if the video device has already been removed. */ | ||
| 415 | if (vdev == NULL || !video_is_registered(vdev)) { | ||
| 416 | mutex_unlock(&videodev_lock); | ||
| 417 | return -ENODEV; | ||
| 418 | } | ||
| 419 | /* and increase the device refcount */ | ||
| 420 | video_get(vdev); | ||
| 421 | mutex_unlock(&videodev_lock); | ||
| 422 | if (vdev->fops->open) { | ||
| 423 | if (vdev->lock && mutex_lock_interruptible(vdev->lock)) { | ||
| 424 | ret = -ERESTARTSYS; | ||
| 425 | goto err; | ||
| 426 | } | ||
| 427 | if (video_is_registered(vdev)) | ||
| 428 | ret = vdev->fops->open(filp); | ||
| 429 | else | ||
| 430 | ret = -ENODEV; | ||
| 431 | if (vdev->lock) | ||
| 432 | mutex_unlock(vdev->lock); | ||
| 433 | } | ||
| 434 | |||
| 435 | err: | ||
| 436 | /* decrease the refcount in case of an error */ | ||
| 437 | if (ret) | ||
| 438 | video_put(vdev); | ||
| 439 | return ret; | ||
| 440 | } | ||
| 441 | |||
| 442 | /* Override for the release function */ | ||
| 443 | static int v4l2_release(struct inode *inode, struct file *filp) | ||
| 444 | { | ||
| 445 | struct video_device *vdev = video_devdata(filp); | ||
| 446 | int ret = 0; | ||
| 447 | |||
| 448 | if (vdev->fops->release) { | ||
| 449 | if (vdev->lock) | ||
| 450 | mutex_lock(vdev->lock); | ||
| 451 | vdev->fops->release(filp); | ||
| 452 | if (vdev->lock) | ||
| 453 | mutex_unlock(vdev->lock); | ||
| 454 | } | ||
| 455 | /* decrease the refcount unconditionally since the release() | ||
| 456 | return value is ignored. */ | ||
| 457 | video_put(vdev); | ||
| 458 | return ret; | ||
| 459 | } | ||
| 460 | |||
| 461 | static const struct file_operations v4l2_fops = { | ||
| 462 | .owner = THIS_MODULE, | ||
| 463 | .read = v4l2_read, | ||
| 464 | .write = v4l2_write, | ||
| 465 | .open = v4l2_open, | ||
| 466 | .get_unmapped_area = v4l2_get_unmapped_area, | ||
| 467 | .mmap = v4l2_mmap, | ||
| 468 | .unlocked_ioctl = v4l2_ioctl, | ||
| 469 | #ifdef CONFIG_COMPAT | ||
| 470 | .compat_ioctl = v4l2_compat_ioctl32, | ||
| 471 | #endif | ||
| 472 | .release = v4l2_release, | ||
| 473 | .poll = v4l2_poll, | ||
| 474 | .llseek = no_llseek, | ||
| 475 | }; | ||
| 476 | |||
| 477 | /** | ||
| 478 | * get_index - assign stream index number based on parent device | ||
| 479 | * @vdev: video_device to assign index number to, vdev->parent should be assigned | ||
| 480 | * | ||
| 481 | * Note that when this is called the new device has not yet been registered | ||
| 482 | * in the video_device array, but it was able to obtain a minor number. | ||
| 483 | * | ||
| 484 | * This means that we can always obtain a free stream index number since | ||
| 485 | * the worst case scenario is that there are VIDEO_NUM_DEVICES - 1 slots in | ||
| 486 | * use of the video_device array. | ||
| 487 | * | ||
| 488 | * Returns a free index number. | ||
| 489 | */ | ||
| 490 | static int get_index(struct video_device *vdev) | ||
| 491 | { | ||
| 492 | /* This can be static since this function is called with the global | ||
| 493 | videodev_lock held. */ | ||
| 494 | static DECLARE_BITMAP(used, VIDEO_NUM_DEVICES); | ||
| 495 | int i; | ||
| 496 | |||
| 497 | /* Some drivers do not set the parent. In that case always return 0. */ | ||
| 498 | if (vdev->parent == NULL) | ||
| 499 | return 0; | ||
| 500 | |||
| 501 | bitmap_zero(used, VIDEO_NUM_DEVICES); | ||
| 502 | |||
| 503 | for (i = 0; i < VIDEO_NUM_DEVICES; i++) { | ||
| 504 | if (video_device[i] != NULL && | ||
| 505 | video_device[i]->parent == vdev->parent) { | ||
| 506 | set_bit(video_device[i]->index, used); | ||
| 507 | } | ||
| 508 | } | ||
| 509 | |||
| 510 | return find_first_zero_bit(used, VIDEO_NUM_DEVICES); | ||
| 511 | } | ||
| 512 | |||
| 513 | /** | ||
| 514 | * __video_register_device - register video4linux devices | ||
| 515 | * @vdev: video device structure we want to register | ||
| 516 | * @type: type of device to register | ||
| 517 | * @nr: which device node number (0 == /dev/video0, 1 == /dev/video1, ... | ||
| 518 | * -1 == first free) | ||
| 519 | * @warn_if_nr_in_use: warn if the desired device node number | ||
| 520 | * was already in use and another number was chosen instead. | ||
| 521 | * @owner: module that owns the video device node | ||
| 522 | * | ||
| 523 | * The registration code assigns minor numbers and device node numbers | ||
| 524 | * based on the requested type and registers the new device node with | ||
| 525 | * the kernel. | ||
| 526 | * | ||
| 527 | * This function assumes that struct video_device was zeroed when it | ||
| 528 | * was allocated and does not contain any stale date. | ||
| 529 | * | ||
| 530 | * An error is returned if no free minor or device node number could be | ||
| 531 | * found, or if the registration of the device node failed. | ||
| 532 | * | ||
| 533 | * Zero is returned on success. | ||
| 534 | * | ||
| 535 | * Valid types are | ||
| 536 | * | ||
| 537 | * %VFL_TYPE_GRABBER - A frame grabber | ||
| 538 | * | ||
| 539 | * %VFL_TYPE_VBI - Vertical blank data (undecoded) | ||
| 540 | * | ||
| 541 | * %VFL_TYPE_RADIO - A radio card | ||
| 542 | * | ||
| 543 | * %VFL_TYPE_SUBDEV - A subdevice | ||
| 544 | */ | ||
| 545 | int __video_register_device(struct video_device *vdev, int type, int nr, | ||
| 546 | int warn_if_nr_in_use, struct module *owner) | ||
| 547 | { | ||
| 548 | int i = 0; | ||
| 549 | int ret; | ||
| 550 | int minor_offset = 0; | ||
| 551 | int minor_cnt = VIDEO_NUM_DEVICES; | ||
| 552 | const char *name_base; | ||
| 553 | |||
| 554 | /* A minor value of -1 marks this video device as never | ||
| 555 | having been registered */ | ||
| 556 | vdev->minor = -1; | ||
| 557 | |||
| 558 | /* the release callback MUST be present */ | ||
| 559 | WARN_ON(!vdev->release); | ||
| 560 | if (!vdev->release) | ||
| 561 | return -EINVAL; | ||
| 562 | |||
| 563 | /* v4l2_fh support */ | ||
| 564 | spin_lock_init(&vdev->fh_lock); | ||
| 565 | INIT_LIST_HEAD(&vdev->fh_list); | ||
| 566 | |||
| 567 | /* Part 1: check device type */ | ||
| 568 | switch (type) { | ||
| 569 | case VFL_TYPE_GRABBER: | ||
| 570 | name_base = "video"; | ||
| 571 | break; | ||
| 572 | case VFL_TYPE_VBI: | ||
| 573 | name_base = "vbi"; | ||
| 574 | break; | ||
| 575 | case VFL_TYPE_RADIO: | ||
| 576 | name_base = "radio"; | ||
| 577 | break; | ||
| 578 | case VFL_TYPE_SUBDEV: | ||
| 579 | name_base = "v4l-subdev"; | ||
| 580 | break; | ||
| 581 | default: | ||
| 582 | printk(KERN_ERR "%s called with unknown type: %d\n", | ||
| 583 | __func__, type); | ||
| 584 | return -EINVAL; | ||
| 585 | } | ||
| 586 | |||
| 587 | vdev->vfl_type = type; | ||
| 588 | vdev->cdev = NULL; | ||
| 589 | if (vdev->v4l2_dev) { | ||
| 590 | if (vdev->v4l2_dev->dev) | ||
| 591 | vdev->parent = vdev->v4l2_dev->dev; | ||
| 592 | if (vdev->ctrl_handler == NULL) | ||
| 593 | vdev->ctrl_handler = vdev->v4l2_dev->ctrl_handler; | ||
| 594 | /* If the prio state pointer is NULL, then use the v4l2_device | ||
| 595 | prio state. */ | ||
| 596 | if (vdev->prio == NULL) | ||
| 597 | vdev->prio = &vdev->v4l2_dev->prio; | ||
| 598 | } | ||
| 599 | |||
| 600 | /* Part 2: find a free minor, device node number and device index. */ | ||
| 601 | #ifdef CONFIG_VIDEO_FIXED_MINOR_RANGES | ||
| 602 | /* Keep the ranges for the first four types for historical | ||
| 603 | * reasons. | ||
| 604 | * Newer devices (not yet in place) should use the range | ||
| 605 | * of 128-191 and just pick the first free minor there | ||
| 606 | * (new style). */ | ||
| 607 | switch (type) { | ||
| 608 | case VFL_TYPE_GRABBER: | ||
| 609 | minor_offset = 0; | ||
| 610 | minor_cnt = 64; | ||
| 611 | break; | ||
| 612 | case VFL_TYPE_RADIO: | ||
| 613 | minor_offset = 64; | ||
| 614 | minor_cnt = 64; | ||
| 615 | break; | ||
| 616 | case VFL_TYPE_VBI: | ||
| 617 | minor_offset = 224; | ||
| 618 | minor_cnt = 32; | ||
| 619 | break; | ||
| 620 | default: | ||
| 621 | minor_offset = 128; | ||
| 622 | minor_cnt = 64; | ||
| 623 | break; | ||
| 624 | } | ||
| 625 | #endif | ||
| 626 | |||
| 627 | /* Pick a device node number */ | ||
| 628 | mutex_lock(&videodev_lock); | ||
| 629 | nr = devnode_find(vdev, nr == -1 ? 0 : nr, minor_cnt); | ||
| 630 | if (nr == minor_cnt) | ||
| 631 | nr = devnode_find(vdev, 0, minor_cnt); | ||
| 632 | if (nr == minor_cnt) { | ||
| 633 | printk(KERN_ERR "could not get a free device node number\n"); | ||
| 634 | mutex_unlock(&videodev_lock); | ||
| 635 | return -ENFILE; | ||
| 636 | } | ||
| 637 | #ifdef CONFIG_VIDEO_FIXED_MINOR_RANGES | ||
| 638 | /* 1-on-1 mapping of device node number to minor number */ | ||
| 639 | i = nr; | ||
| 640 | #else | ||
| 641 | /* The device node number and minor numbers are independent, so | ||
| 642 | we just find the first free minor number. */ | ||
| 643 | for (i = 0; i < VIDEO_NUM_DEVICES; i++) | ||
| 644 | if (video_device[i] == NULL) | ||
| 645 | break; | ||
| 646 | if (i == VIDEO_NUM_DEVICES) { | ||
| 647 | mutex_unlock(&videodev_lock); | ||
| 648 | printk(KERN_ERR "could not get a free minor\n"); | ||
| 649 | return -ENFILE; | ||
| 650 | } | ||
| 651 | #endif | ||
| 652 | vdev->minor = i + minor_offset; | ||
| 653 | vdev->num = nr; | ||
| 654 | devnode_set(vdev); | ||
| 655 | |||
| 656 | /* Should not happen since we thought this minor was free */ | ||
| 657 | WARN_ON(video_device[vdev->minor] != NULL); | ||
| 658 | vdev->index = get_index(vdev); | ||
| 659 | mutex_unlock(&videodev_lock); | ||
| 660 | |||
| 661 | /* Part 3: Initialize the character device */ | ||
| 662 | vdev->cdev = cdev_alloc(); | ||
| 663 | if (vdev->cdev == NULL) { | ||
| 664 | ret = -ENOMEM; | ||
| 665 | goto cleanup; | ||
| 666 | } | ||
| 667 | vdev->cdev->ops = &v4l2_fops; | ||
| 668 | vdev->cdev->owner = owner; | ||
| 669 | ret = cdev_add(vdev->cdev, MKDEV(VIDEO_MAJOR, vdev->minor), 1); | ||
| 670 | if (ret < 0) { | ||
| 671 | printk(KERN_ERR "%s: cdev_add failed\n", __func__); | ||
| 672 | kfree(vdev->cdev); | ||
| 673 | vdev->cdev = NULL; | ||
| 674 | goto cleanup; | ||
| 675 | } | ||
| 676 | |||
| 677 | /* Part 4: register the device with sysfs */ | ||
| 678 | vdev->dev.class = &video_class; | ||
| 679 | vdev->dev.devt = MKDEV(VIDEO_MAJOR, vdev->minor); | ||
| 680 | if (vdev->parent) | ||
| 681 | vdev->dev.parent = vdev->parent; | ||
| 682 | dev_set_name(&vdev->dev, "%s%d", name_base, vdev->num); | ||
| 683 | ret = device_register(&vdev->dev); | ||
| 684 | if (ret < 0) { | ||
| 685 | printk(KERN_ERR "%s: device_register failed\n", __func__); | ||
| 686 | goto cleanup; | ||
| 687 | } | ||
| 688 | /* Register the release callback that will be called when the last | ||
| 689 | reference to the device goes away. */ | ||
| 690 | vdev->dev.release = v4l2_device_release; | ||
| 691 | |||
| 692 | if (nr != -1 && nr != vdev->num && warn_if_nr_in_use) | ||
| 693 | printk(KERN_WARNING "%s: requested %s%d, got %s\n", __func__, | ||
| 694 | name_base, nr, video_device_node_name(vdev)); | ||
| 695 | |||
| 696 | /* Increase v4l2_device refcount */ | ||
| 697 | if (vdev->v4l2_dev) | ||
| 698 | v4l2_device_get(vdev->v4l2_dev); | ||
| 699 | |||
| 700 | #if defined(CONFIG_MEDIA_CONTROLLER) | ||
| 701 | /* Part 5: Register the entity. */ | ||
| 702 | if (vdev->v4l2_dev && vdev->v4l2_dev->mdev && | ||
| 703 | vdev->vfl_type != VFL_TYPE_SUBDEV) { | ||
| 704 | vdev->entity.type = MEDIA_ENT_T_DEVNODE_V4L; | ||
| 705 | vdev->entity.name = vdev->name; | ||
| 706 | vdev->entity.v4l.major = VIDEO_MAJOR; | ||
| 707 | vdev->entity.v4l.minor = vdev->minor; | ||
| 708 | ret = media_device_register_entity(vdev->v4l2_dev->mdev, | ||
| 709 | &vdev->entity); | ||
| 710 | if (ret < 0) | ||
| 711 | printk(KERN_WARNING | ||
| 712 | "%s: media_device_register_entity failed\n", | ||
| 713 | __func__); | ||
| 714 | } | ||
| 715 | #endif | ||
| 716 | /* Part 6: Activate this minor. The char device can now be used. */ | ||
| 717 | set_bit(V4L2_FL_REGISTERED, &vdev->flags); | ||
| 718 | mutex_lock(&videodev_lock); | ||
| 719 | video_device[vdev->minor] = vdev; | ||
| 720 | mutex_unlock(&videodev_lock); | ||
| 721 | |||
| 722 | return 0; | ||
| 723 | |||
| 724 | cleanup: | ||
| 725 | mutex_lock(&videodev_lock); | ||
| 726 | if (vdev->cdev) | ||
| 727 | cdev_del(vdev->cdev); | ||
| 728 | devnode_clear(vdev); | ||
| 729 | mutex_unlock(&videodev_lock); | ||
| 730 | /* Mark this video device as never having been registered. */ | ||
| 731 | vdev->minor = -1; | ||
| 732 | return ret; | ||
| 733 | } | ||
| 734 | EXPORT_SYMBOL(__video_register_device); | ||
| 735 | |||
| 736 | /** | ||
| 737 | * video_unregister_device - unregister a video4linux device | ||
| 738 | * @vdev: the device to unregister | ||
| 739 | * | ||
| 740 | * This unregisters the passed device. Future open calls will | ||
| 741 | * be met with errors. | ||
| 742 | */ | ||
| 743 | void video_unregister_device(struct video_device *vdev) | ||
| 744 | { | ||
| 745 | /* Check if vdev was ever registered at all */ | ||
| 746 | if (!vdev || !video_is_registered(vdev)) | ||
| 747 | return; | ||
| 748 | |||
| 749 | mutex_lock(&videodev_lock); | ||
| 750 | /* This must be in a critical section to prevent a race with v4l2_open. | ||
| 751 | * Once this bit has been cleared video_get may never be called again. | ||
| 752 | */ | ||
| 753 | clear_bit(V4L2_FL_REGISTERED, &vdev->flags); | ||
| 754 | mutex_unlock(&videodev_lock); | ||
| 755 | device_unregister(&vdev->dev); | ||
| 756 | } | ||
| 757 | EXPORT_SYMBOL(video_unregister_device); | ||
| 758 | |||
| 759 | /* | ||
| 760 | * Initialise video for linux | ||
| 761 | */ | ||
| 762 | static int __init videodev_init(void) | ||
| 763 | { | ||
| 764 | dev_t dev = MKDEV(VIDEO_MAJOR, 0); | ||
| 765 | int ret; | ||
| 766 | |||
| 767 | printk(KERN_INFO "Linux video capture interface: v2.00\n"); | ||
| 768 | ret = register_chrdev_region(dev, VIDEO_NUM_DEVICES, VIDEO_NAME); | ||
| 769 | if (ret < 0) { | ||
| 770 | printk(KERN_WARNING "videodev: unable to get major %d\n", | ||
| 771 | VIDEO_MAJOR); | ||
| 772 | return ret; | ||
| 773 | } | ||
| 774 | |||
| 775 | ret = class_register(&video_class); | ||
| 776 | if (ret < 0) { | ||
| 777 | unregister_chrdev_region(dev, VIDEO_NUM_DEVICES); | ||
| 778 | printk(KERN_WARNING "video_dev: class_register failed\n"); | ||
| 779 | return -EIO; | ||
| 780 | } | ||
| 781 | |||
| 782 | return 0; | ||
| 783 | } | ||
| 784 | |||
| 785 | static void __exit videodev_exit(void) | ||
| 786 | { | ||
| 787 | dev_t dev = MKDEV(VIDEO_MAJOR, 0); | ||
| 788 | |||
| 789 | class_unregister(&video_class); | ||
| 790 | unregister_chrdev_region(dev, VIDEO_NUM_DEVICES); | ||
| 791 | } | ||
| 792 | |||
| 793 | module_init(videodev_init) | ||
| 794 | module_exit(videodev_exit) | ||
| 795 | |||
| 796 | MODULE_AUTHOR("Alan Cox, Mauro Carvalho Chehab <mchehab@infradead.org>"); | ||
| 797 | MODULE_DESCRIPTION("Device registrar for Video4Linux drivers v2"); | ||
| 798 | MODULE_LICENSE("GPL"); | ||
| 799 | MODULE_ALIAS_CHARDEV_MAJOR(VIDEO_MAJOR); | ||
| 800 | |||
| 801 | |||
| 802 | /* | ||
| 803 | * Local variables: | ||
| 804 | * c-basic-offset: 8 | ||
| 805 | * End: | ||
| 806 | */ | ||
