1 // SPDX-License-Identifier: GPL-2.0-or-later 2 /* 3 * Video capture interface for Linux version 2 4 * 5 * A generic video device interface for the LINUX operating system 6 * using a set of device structures/vectors for low level operations. 7 * 8 * Authors: Alan Cox, <alan@lxorguk.ukuu.org.uk> (version 1) 9 * Mauro Carvalho Chehab <mchehab@kernel.org> (version 2) 10 * 11 * Fixes: 20000516 Claudio Matsuoka <claudio@conectiva.com> 12 * - Added procfs support 13 */ 14 15 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt 16 17 #include <linux/module.h> 18 #include <linux/types.h> 19 #include <linux/kernel.h> 20 #include <linux/mm.h> 21 #include <linux/string.h> 22 #include <linux/errno.h> 23 #include <linux/init.h> 24 #include <linux/kmod.h> 25 #include <linux/slab.h> 26 #include <linux/uaccess.h> 27 28 #include <media/v4l2-common.h> 29 #include <media/v4l2-device.h> 30 #include <media/v4l2-ioctl.h> 31 32 #define VIDEO_NUM_DEVICES 256 33 #define VIDEO_NAME "video4linux" 34 35 #define dprintk(fmt, arg...) do { \ 36 printk(KERN_DEBUG pr_fmt("%s: " fmt), \ 37 __func__, ##arg); \ 38 } while (0) 39 40 41 /* 42 * sysfs stuff 43 */ 44 45 static ssize_t index_show(struct device *cd, 46 struct device_attribute *attr, char *buf) 47 { 48 struct video_device *vdev = to_video_device(cd); 49 50 return sprintf(buf, "%i\n", vdev->index); 51 } 52 static DEVICE_ATTR_RO(index); 53 54 static ssize_t dev_debug_show(struct device *cd, 55 struct device_attribute *attr, char *buf) 56 { 57 struct video_device *vdev = to_video_device(cd); 58 59 return sprintf(buf, "%i\n", vdev->dev_debug); 60 } 61 62 static ssize_t dev_debug_store(struct device *cd, struct device_attribute *attr, 63 const char *buf, size_t len) 64 { 65 struct video_device *vdev = to_video_device(cd); 66 int res = 0; 67 u16 value; 68 69 res = kstrtou16(buf, 0, &value); 70 if (res) 71 return res; 72 73 vdev->dev_debug = value; 74 return len; 75 } 76 static DEVICE_ATTR_RW(dev_debug); 77 78 static ssize_t name_show(struct device *cd, 79 struct device_attribute *attr, char *buf) 80 { 81 struct video_device *vdev = to_video_device(cd); 82 83 return sprintf(buf, "%.*s\n", (int)sizeof(vdev->name), vdev->name); 84 } 85 static DEVICE_ATTR_RO(name); 86 87 static struct attribute *video_device_attrs[] = { 88 &dev_attr_name.attr, 89 &dev_attr_dev_debug.attr, 90 &dev_attr_index.attr, 91 NULL, 92 }; 93 ATTRIBUTE_GROUPS(video_device); 94 95 /* 96 * Active devices 97 */ 98 static struct video_device *video_devices[VIDEO_NUM_DEVICES]; 99 static DEFINE_MUTEX(videodev_lock); 100 static DECLARE_BITMAP(devnode_nums[VFL_TYPE_MAX], VIDEO_NUM_DEVICES); 101 102 /* Device node utility functions */ 103 104 /* Note: these utility functions all assume that vfl_type is in the range 105 [0, VFL_TYPE_MAX-1]. */ 106 107 #ifdef CONFIG_VIDEO_FIXED_MINOR_RANGES 108 /* Return the bitmap corresponding to vfl_type. */ 109 static inline unsigned long *devnode_bits(enum vfl_devnode_type vfl_type) 110 { 111 /* Any types not assigned to fixed minor ranges must be mapped to 112 one single bitmap for the purposes of finding a free node number 113 since all those unassigned types use the same minor range. */ 114 int idx = (vfl_type > VFL_TYPE_RADIO) ? VFL_TYPE_MAX - 1 : vfl_type; 115 116 return devnode_nums[idx]; 117 } 118 #else 119 /* Return the bitmap corresponding to vfl_type. */ 120 static inline unsigned long *devnode_bits(enum vfl_devnode_type vfl_type) 121 { 122 return devnode_nums[vfl_type]; 123 } 124 #endif 125 126 /* Mark device node number vdev->num as used */ 127 static inline void devnode_set(struct video_device *vdev) 128 { 129 set_bit(vdev->num, devnode_bits(vdev->vfl_type)); 130 } 131 132 /* Mark device node number vdev->num as unused */ 133 static inline void devnode_clear(struct video_device *vdev) 134 { 135 clear_bit(vdev->num, devnode_bits(vdev->vfl_type)); 136 } 137 138 /* Try to find a free device node number in the range [from, to> */ 139 static inline int devnode_find(struct video_device *vdev, int from, int to) 140 { 141 return find_next_zero_bit(devnode_bits(vdev->vfl_type), to, from); 142 } 143 144 struct video_device *video_device_alloc(void) 145 { 146 return kzalloc(sizeof(struct video_device), GFP_KERNEL); 147 } 148 EXPORT_SYMBOL(video_device_alloc); 149 150 void video_device_release(struct video_device *vdev) 151 { 152 kfree(vdev); 153 } 154 EXPORT_SYMBOL(video_device_release); 155 156 void video_device_release_empty(struct video_device *vdev) 157 { 158 /* Do nothing */ 159 /* Only valid when the video_device struct is a static. */ 160 } 161 EXPORT_SYMBOL(video_device_release_empty); 162 163 static inline void video_get(struct video_device *vdev) 164 { 165 get_device(&vdev->dev); 166 } 167 168 static inline void video_put(struct video_device *vdev) 169 { 170 put_device(&vdev->dev); 171 } 172 173 /* Called when the last user of the video device exits. */ 174 static void v4l2_device_release(struct device *cd) 175 { 176 struct video_device *vdev = to_video_device(cd); 177 struct v4l2_device *v4l2_dev = vdev->v4l2_dev; 178 179 mutex_lock(&videodev_lock); 180 if (WARN_ON(video_devices[vdev->minor] != vdev)) { 181 /* should not happen */ 182 mutex_unlock(&videodev_lock); 183 return; 184 } 185 186 /* Free up this device for reuse */ 187 video_devices[vdev->minor] = NULL; 188 189 /* Delete the cdev on this minor as well */ 190 cdev_del(vdev->cdev); 191 /* Just in case some driver tries to access this from 192 the release() callback. */ 193 vdev->cdev = NULL; 194 195 /* Mark device node number as free */ 196 devnode_clear(vdev); 197 198 mutex_unlock(&videodev_lock); 199 200 #if defined(CONFIG_MEDIA_CONTROLLER) 201 if (v4l2_dev->mdev && vdev->vfl_dir != VFL_DIR_M2M) { 202 /* Remove interfaces and interface links */ 203 media_devnode_remove(vdev->intf_devnode); 204 if (vdev->entity.function != MEDIA_ENT_F_UNKNOWN) 205 media_device_unregister_entity(&vdev->entity); 206 } 207 #endif 208 209 /* Do not call v4l2_device_put if there is no release callback set. 210 * Drivers that have no v4l2_device release callback might free the 211 * v4l2_dev instance in the video_device release callback below, so we 212 * must perform this check here. 213 * 214 * TODO: In the long run all drivers that use v4l2_device should use the 215 * v4l2_device release callback. This check will then be unnecessary. 216 */ 217 if (v4l2_dev->release == NULL) 218 v4l2_dev = NULL; 219 220 /* Release video_device and perform other 221 cleanups as needed. */ 222 vdev->release(vdev); 223 224 /* Decrease v4l2_device refcount */ 225 if (v4l2_dev) 226 v4l2_device_put(v4l2_dev); 227 } 228 229 static struct class video_class = { 230 .name = VIDEO_NAME, 231 .dev_groups = video_device_groups, 232 }; 233 234 struct video_device *video_devdata(struct file *file) 235 { 236 return video_devices[iminor(file_inode(file))]; 237 } 238 EXPORT_SYMBOL(video_devdata); 239 240 241 /* Priority handling */ 242 243 static inline bool prio_is_valid(enum v4l2_priority prio) 244 { 245 return prio == V4L2_PRIORITY_BACKGROUND || 246 prio == V4L2_PRIORITY_INTERACTIVE || 247 prio == V4L2_PRIORITY_RECORD; 248 } 249 250 void v4l2_prio_init(struct v4l2_prio_state *global) 251 { 252 memset(global, 0, sizeof(*global)); 253 } 254 EXPORT_SYMBOL(v4l2_prio_init); 255 256 int v4l2_prio_change(struct v4l2_prio_state *global, enum v4l2_priority *local, 257 enum v4l2_priority new) 258 { 259 if (!prio_is_valid(new)) 260 return -EINVAL; 261 if (*local == new) 262 return 0; 263 264 atomic_inc(&global->prios[new]); 265 if (prio_is_valid(*local)) 266 atomic_dec(&global->prios[*local]); 267 *local = new; 268 return 0; 269 } 270 EXPORT_SYMBOL(v4l2_prio_change); 271 272 void v4l2_prio_open(struct v4l2_prio_state *global, enum v4l2_priority *local) 273 { 274 v4l2_prio_change(global, local, V4L2_PRIORITY_DEFAULT); 275 } 276 EXPORT_SYMBOL(v4l2_prio_open); 277 278 void v4l2_prio_close(struct v4l2_prio_state *global, enum v4l2_priority local) 279 { 280 if (prio_is_valid(local)) 281 atomic_dec(&global->prios[local]); 282 } 283 EXPORT_SYMBOL(v4l2_prio_close); 284 285 enum v4l2_priority v4l2_prio_max(struct v4l2_prio_state *global) 286 { 287 if (atomic_read(&global->prios[V4L2_PRIORITY_RECORD]) > 0) 288 return V4L2_PRIORITY_RECORD; 289 if (atomic_read(&global->prios[V4L2_PRIORITY_INTERACTIVE]) > 0) 290 return V4L2_PRIORITY_INTERACTIVE; 291 if (atomic_read(&global->prios[V4L2_PRIORITY_BACKGROUND]) > 0) 292 return V4L2_PRIORITY_BACKGROUND; 293 return V4L2_PRIORITY_UNSET; 294 } 295 EXPORT_SYMBOL(v4l2_prio_max); 296 297 int v4l2_prio_check(struct v4l2_prio_state *global, enum v4l2_priority local) 298 { 299 return (local < v4l2_prio_max(global)) ? -EBUSY : 0; 300 } 301 EXPORT_SYMBOL(v4l2_prio_check); 302 303 304 static ssize_t v4l2_read(struct file *filp, char __user *buf, 305 size_t sz, loff_t *off) 306 { 307 struct video_device *vdev = video_devdata(filp); 308 int ret = -ENODEV; 309 310 if (!vdev->fops->read) 311 return -EINVAL; 312 if (video_is_registered(vdev)) 313 ret = vdev->fops->read(filp, buf, sz, off); 314 if ((vdev->dev_debug & V4L2_DEV_DEBUG_FOP) && 315 (vdev->dev_debug & V4L2_DEV_DEBUG_STREAMING)) 316 dprintk("%s: read: %zd (%d)\n", 317 video_device_node_name(vdev), sz, ret); 318 return ret; 319 } 320 321 static ssize_t v4l2_write(struct file *filp, const char __user *buf, 322 size_t sz, loff_t *off) 323 { 324 struct video_device *vdev = video_devdata(filp); 325 int ret = -ENODEV; 326 327 if (!vdev->fops->write) 328 return -EINVAL; 329 if (video_is_registered(vdev)) 330 ret = vdev->fops->write(filp, buf, sz, off); 331 if ((vdev->dev_debug & V4L2_DEV_DEBUG_FOP) && 332 (vdev->dev_debug & V4L2_DEV_DEBUG_STREAMING)) 333 dprintk("%s: write: %zd (%d)\n", 334 video_device_node_name(vdev), sz, ret); 335 return ret; 336 } 337 338 static __poll_t v4l2_poll(struct file *filp, struct poll_table_struct *poll) 339 { 340 struct video_device *vdev = video_devdata(filp); 341 __poll_t res = EPOLLERR | EPOLLHUP; 342 343 if (!vdev->fops->poll) 344 return DEFAULT_POLLMASK; 345 if (video_is_registered(vdev)) 346 res = vdev->fops->poll(filp, poll); 347 if (vdev->dev_debug & V4L2_DEV_DEBUG_POLL) 348 dprintk("%s: poll: %08x\n", 349 video_device_node_name(vdev), res); 350 return res; 351 } 352 353 static long v4l2_ioctl(struct file *filp, unsigned int cmd, unsigned long arg) 354 { 355 struct video_device *vdev = video_devdata(filp); 356 int ret = -ENODEV; 357 358 if (vdev->fops->unlocked_ioctl) { 359 if (video_is_registered(vdev)) 360 ret = vdev->fops->unlocked_ioctl(filp, cmd, arg); 361 } else 362 ret = -ENOTTY; 363 364 return ret; 365 } 366 367 #ifdef CONFIG_MMU 368 #define v4l2_get_unmapped_area NULL 369 #else 370 static unsigned long v4l2_get_unmapped_area(struct file *filp, 371 unsigned long addr, unsigned long len, unsigned long pgoff, 372 unsigned long flags) 373 { 374 struct video_device *vdev = video_devdata(filp); 375 int ret; 376 377 if (!vdev->fops->get_unmapped_area) 378 return -ENOSYS; 379 if (!video_is_registered(vdev)) 380 return -ENODEV; 381 ret = vdev->fops->get_unmapped_area(filp, addr, len, pgoff, flags); 382 if (vdev->dev_debug & V4L2_DEV_DEBUG_FOP) 383 dprintk("%s: get_unmapped_area (%d)\n", 384 video_device_node_name(vdev), ret); 385 return ret; 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 -ENODEV; 396 if (video_is_registered(vdev)) 397 ret = vdev->fops->mmap(filp, vm); 398 if (vdev->dev_debug & V4L2_DEV_DEBUG_FOP) 399 dprintk("%s: mmap (%d)\n", 400 video_device_node_name(vdev), ret); 401 return ret; 402 } 403 404 /* Override for the open function */ 405 static int v4l2_open(struct inode *inode, struct file *filp) 406 { 407 struct video_device *vdev; 408 int ret = 0; 409 410 /* Check if the video device is available */ 411 mutex_lock(&videodev_lock); 412 vdev = video_devdata(filp); 413 /* return ENODEV if the video device has already been removed. */ 414 if (vdev == NULL || !video_is_registered(vdev)) { 415 mutex_unlock(&videodev_lock); 416 return -ENODEV; 417 } 418 /* and increase the device refcount */ 419 video_get(vdev); 420 mutex_unlock(&videodev_lock); 421 if (vdev->fops->open) { 422 if (video_is_registered(vdev)) 423 ret = vdev->fops->open(filp); 424 else 425 ret = -ENODEV; 426 } 427 428 if (vdev->dev_debug & V4L2_DEV_DEBUG_FOP) 429 dprintk("%s: open (%d)\n", 430 video_device_node_name(vdev), ret); 431 /* decrease the refcount in case of an error */ 432 if (ret) 433 video_put(vdev); 434 return ret; 435 } 436 437 /* Override for the release function */ 438 static int v4l2_release(struct inode *inode, struct file *filp) 439 { 440 struct video_device *vdev = video_devdata(filp); 441 int ret = 0; 442 443 /* 444 * We need to serialize the release() with queueing new requests. 445 * The release() may trigger the cancellation of a streaming 446 * operation, and that should not be mixed with queueing a new 447 * request at the same time. 448 */ 449 if (vdev->fops->release) { 450 if (v4l2_device_supports_requests(vdev->v4l2_dev)) { 451 mutex_lock(&vdev->v4l2_dev->mdev->req_queue_mutex); 452 ret = vdev->fops->release(filp); 453 mutex_unlock(&vdev->v4l2_dev->mdev->req_queue_mutex); 454 } else { 455 ret = vdev->fops->release(filp); 456 } 457 } 458 459 if (vdev->dev_debug & V4L2_DEV_DEBUG_FOP) 460 dprintk("%s: release\n", 461 video_device_node_name(vdev)); 462 463 /* decrease the refcount unconditionally since the release() 464 return value is ignored. */ 465 video_put(vdev); 466 return ret; 467 } 468 469 static const struct file_operations v4l2_fops = { 470 .owner = THIS_MODULE, 471 .read = v4l2_read, 472 .write = v4l2_write, 473 .open = v4l2_open, 474 .get_unmapped_area = v4l2_get_unmapped_area, 475 .mmap = v4l2_mmap, 476 .unlocked_ioctl = v4l2_ioctl, 477 #ifdef CONFIG_COMPAT 478 .compat_ioctl = v4l2_compat_ioctl32, 479 #endif 480 .release = v4l2_release, 481 .poll = v4l2_poll, 482 .llseek = no_llseek, 483 }; 484 485 /** 486 * get_index - assign stream index number based on v4l2_dev 487 * @vdev: video_device to assign index number to, vdev->v4l2_dev should be assigned 488 * 489 * Note that when this is called the new device has not yet been registered 490 * in the video_device array, but it was able to obtain a minor number. 491 * 492 * This means that we can always obtain a free stream index number since 493 * the worst case scenario is that there are VIDEO_NUM_DEVICES - 1 slots in 494 * use of the video_device array. 495 * 496 * Returns a free index number. 497 */ 498 static int get_index(struct video_device *vdev) 499 { 500 /* This can be static since this function is called with the global 501 videodev_lock held. */ 502 static DECLARE_BITMAP(used, VIDEO_NUM_DEVICES); 503 int i; 504 505 bitmap_zero(used, VIDEO_NUM_DEVICES); 506 507 for (i = 0; i < VIDEO_NUM_DEVICES; i++) { 508 if (video_devices[i] != NULL && 509 video_devices[i]->v4l2_dev == vdev->v4l2_dev) { 510 set_bit(video_devices[i]->index, used); 511 } 512 } 513 514 return find_first_zero_bit(used, VIDEO_NUM_DEVICES); 515 } 516 517 #define SET_VALID_IOCTL(ops, cmd, op) \ 518 if (ops->op) \ 519 set_bit(_IOC_NR(cmd), valid_ioctls) 520 521 /* This determines which ioctls are actually implemented in the driver. 522 It's a one-time thing which simplifies video_ioctl2 as it can just do 523 a bit test. 524 525 Note that drivers can override this by setting bits to 1 in 526 vdev->valid_ioctls. If an ioctl is marked as 1 when this function is 527 called, then that ioctl will actually be marked as unimplemented. 528 529 It does that by first setting up the local valid_ioctls bitmap, and 530 at the end do a: 531 532 vdev->valid_ioctls = valid_ioctls & ~(vdev->valid_ioctls) 533 */ 534 static void determine_valid_ioctls(struct video_device *vdev) 535 { 536 DECLARE_BITMAP(valid_ioctls, BASE_VIDIOC_PRIVATE); 537 const struct v4l2_ioctl_ops *ops = vdev->ioctl_ops; 538 bool is_vid = vdev->vfl_type == VFL_TYPE_GRABBER; 539 bool is_vbi = vdev->vfl_type == VFL_TYPE_VBI; 540 bool is_radio = vdev->vfl_type == VFL_TYPE_RADIO; 541 bool is_sdr = vdev->vfl_type == VFL_TYPE_SDR; 542 bool is_tch = vdev->vfl_type == VFL_TYPE_TOUCH; 543 bool is_rx = vdev->vfl_dir != VFL_DIR_TX; 544 bool is_tx = vdev->vfl_dir != VFL_DIR_RX; 545 546 bitmap_zero(valid_ioctls, BASE_VIDIOC_PRIVATE); 547 548 /* vfl_type and vfl_dir independent ioctls */ 549 550 SET_VALID_IOCTL(ops, VIDIOC_QUERYCAP, vidioc_querycap); 551 set_bit(_IOC_NR(VIDIOC_G_PRIORITY), valid_ioctls); 552 set_bit(_IOC_NR(VIDIOC_S_PRIORITY), valid_ioctls); 553 554 /* Note: the control handler can also be passed through the filehandle, 555 and that can't be tested here. If the bit for these control ioctls 556 is set, then the ioctl is valid. But if it is 0, then it can still 557 be valid if the filehandle passed the control handler. */ 558 if (vdev->ctrl_handler || ops->vidioc_queryctrl) 559 set_bit(_IOC_NR(VIDIOC_QUERYCTRL), valid_ioctls); 560 if (vdev->ctrl_handler || ops->vidioc_query_ext_ctrl) 561 set_bit(_IOC_NR(VIDIOC_QUERY_EXT_CTRL), valid_ioctls); 562 if (vdev->ctrl_handler || ops->vidioc_g_ctrl || ops->vidioc_g_ext_ctrls) 563 set_bit(_IOC_NR(VIDIOC_G_CTRL), valid_ioctls); 564 if (vdev->ctrl_handler || ops->vidioc_s_ctrl || ops->vidioc_s_ext_ctrls) 565 set_bit(_IOC_NR(VIDIOC_S_CTRL), valid_ioctls); 566 if (vdev->ctrl_handler || ops->vidioc_g_ext_ctrls) 567 set_bit(_IOC_NR(VIDIOC_G_EXT_CTRLS), valid_ioctls); 568 if (vdev->ctrl_handler || ops->vidioc_s_ext_ctrls) 569 set_bit(_IOC_NR(VIDIOC_S_EXT_CTRLS), valid_ioctls); 570 if (vdev->ctrl_handler || ops->vidioc_try_ext_ctrls) 571 set_bit(_IOC_NR(VIDIOC_TRY_EXT_CTRLS), valid_ioctls); 572 if (vdev->ctrl_handler || ops->vidioc_querymenu) 573 set_bit(_IOC_NR(VIDIOC_QUERYMENU), valid_ioctls); 574 SET_VALID_IOCTL(ops, VIDIOC_G_FREQUENCY, vidioc_g_frequency); 575 SET_VALID_IOCTL(ops, VIDIOC_S_FREQUENCY, vidioc_s_frequency); 576 SET_VALID_IOCTL(ops, VIDIOC_LOG_STATUS, vidioc_log_status); 577 #ifdef CONFIG_VIDEO_ADV_DEBUG 578 set_bit(_IOC_NR(VIDIOC_DBG_G_CHIP_INFO), valid_ioctls); 579 set_bit(_IOC_NR(VIDIOC_DBG_G_REGISTER), valid_ioctls); 580 set_bit(_IOC_NR(VIDIOC_DBG_S_REGISTER), valid_ioctls); 581 #endif 582 /* yes, really vidioc_subscribe_event */ 583 SET_VALID_IOCTL(ops, VIDIOC_DQEVENT, vidioc_subscribe_event); 584 SET_VALID_IOCTL(ops, VIDIOC_SUBSCRIBE_EVENT, vidioc_subscribe_event); 585 SET_VALID_IOCTL(ops, VIDIOC_UNSUBSCRIBE_EVENT, vidioc_unsubscribe_event); 586 if (ops->vidioc_enum_freq_bands || ops->vidioc_g_tuner || ops->vidioc_g_modulator) 587 set_bit(_IOC_NR(VIDIOC_ENUM_FREQ_BANDS), valid_ioctls); 588 589 if (is_vid || is_tch) { 590 /* video and metadata specific ioctls */ 591 if ((is_rx && (ops->vidioc_enum_fmt_vid_cap || 592 ops->vidioc_enum_fmt_vid_cap_mplane || 593 ops->vidioc_enum_fmt_vid_overlay || 594 ops->vidioc_enum_fmt_meta_cap)) || 595 (is_tx && (ops->vidioc_enum_fmt_vid_out || 596 ops->vidioc_enum_fmt_vid_out_mplane || 597 ops->vidioc_enum_fmt_meta_out))) 598 set_bit(_IOC_NR(VIDIOC_ENUM_FMT), valid_ioctls); 599 if ((is_rx && (ops->vidioc_g_fmt_vid_cap || 600 ops->vidioc_g_fmt_vid_cap_mplane || 601 ops->vidioc_g_fmt_vid_overlay || 602 ops->vidioc_g_fmt_meta_cap)) || 603 (is_tx && (ops->vidioc_g_fmt_vid_out || 604 ops->vidioc_g_fmt_vid_out_mplane || 605 ops->vidioc_g_fmt_vid_out_overlay || 606 ops->vidioc_g_fmt_meta_out))) 607 set_bit(_IOC_NR(VIDIOC_G_FMT), valid_ioctls); 608 if ((is_rx && (ops->vidioc_s_fmt_vid_cap || 609 ops->vidioc_s_fmt_vid_cap_mplane || 610 ops->vidioc_s_fmt_vid_overlay || 611 ops->vidioc_s_fmt_meta_cap)) || 612 (is_tx && (ops->vidioc_s_fmt_vid_out || 613 ops->vidioc_s_fmt_vid_out_mplane || 614 ops->vidioc_s_fmt_vid_out_overlay || 615 ops->vidioc_s_fmt_meta_out))) 616 set_bit(_IOC_NR(VIDIOC_S_FMT), valid_ioctls); 617 if ((is_rx && (ops->vidioc_try_fmt_vid_cap || 618 ops->vidioc_try_fmt_vid_cap_mplane || 619 ops->vidioc_try_fmt_vid_overlay || 620 ops->vidioc_try_fmt_meta_cap)) || 621 (is_tx && (ops->vidioc_try_fmt_vid_out || 622 ops->vidioc_try_fmt_vid_out_mplane || 623 ops->vidioc_try_fmt_vid_out_overlay || 624 ops->vidioc_try_fmt_meta_out))) 625 set_bit(_IOC_NR(VIDIOC_TRY_FMT), valid_ioctls); 626 SET_VALID_IOCTL(ops, VIDIOC_OVERLAY, vidioc_overlay); 627 SET_VALID_IOCTL(ops, VIDIOC_G_FBUF, vidioc_g_fbuf); 628 SET_VALID_IOCTL(ops, VIDIOC_S_FBUF, vidioc_s_fbuf); 629 SET_VALID_IOCTL(ops, VIDIOC_G_JPEGCOMP, vidioc_g_jpegcomp); 630 SET_VALID_IOCTL(ops, VIDIOC_S_JPEGCOMP, vidioc_s_jpegcomp); 631 SET_VALID_IOCTL(ops, VIDIOC_G_ENC_INDEX, vidioc_g_enc_index); 632 SET_VALID_IOCTL(ops, VIDIOC_ENCODER_CMD, vidioc_encoder_cmd); 633 SET_VALID_IOCTL(ops, VIDIOC_TRY_ENCODER_CMD, vidioc_try_encoder_cmd); 634 SET_VALID_IOCTL(ops, VIDIOC_DECODER_CMD, vidioc_decoder_cmd); 635 SET_VALID_IOCTL(ops, VIDIOC_TRY_DECODER_CMD, vidioc_try_decoder_cmd); 636 SET_VALID_IOCTL(ops, VIDIOC_ENUM_FRAMESIZES, vidioc_enum_framesizes); 637 SET_VALID_IOCTL(ops, VIDIOC_ENUM_FRAMEINTERVALS, vidioc_enum_frameintervals); 638 if (ops->vidioc_g_selection) { 639 set_bit(_IOC_NR(VIDIOC_G_CROP), valid_ioctls); 640 set_bit(_IOC_NR(VIDIOC_CROPCAP), valid_ioctls); 641 } 642 if (ops->vidioc_s_selection) 643 set_bit(_IOC_NR(VIDIOC_S_CROP), valid_ioctls); 644 SET_VALID_IOCTL(ops, VIDIOC_G_SELECTION, vidioc_g_selection); 645 SET_VALID_IOCTL(ops, VIDIOC_S_SELECTION, vidioc_s_selection); 646 } else if (is_vbi) { 647 /* vbi specific ioctls */ 648 if ((is_rx && (ops->vidioc_g_fmt_vbi_cap || 649 ops->vidioc_g_fmt_sliced_vbi_cap)) || 650 (is_tx && (ops->vidioc_g_fmt_vbi_out || 651 ops->vidioc_g_fmt_sliced_vbi_out))) 652 set_bit(_IOC_NR(VIDIOC_G_FMT), valid_ioctls); 653 if ((is_rx && (ops->vidioc_s_fmt_vbi_cap || 654 ops->vidioc_s_fmt_sliced_vbi_cap)) || 655 (is_tx && (ops->vidioc_s_fmt_vbi_out || 656 ops->vidioc_s_fmt_sliced_vbi_out))) 657 set_bit(_IOC_NR(VIDIOC_S_FMT), valid_ioctls); 658 if ((is_rx && (ops->vidioc_try_fmt_vbi_cap || 659 ops->vidioc_try_fmt_sliced_vbi_cap)) || 660 (is_tx && (ops->vidioc_try_fmt_vbi_out || 661 ops->vidioc_try_fmt_sliced_vbi_out))) 662 set_bit(_IOC_NR(VIDIOC_TRY_FMT), valid_ioctls); 663 SET_VALID_IOCTL(ops, VIDIOC_G_SLICED_VBI_CAP, vidioc_g_sliced_vbi_cap); 664 } else if (is_sdr && is_rx) { 665 /* SDR receiver specific ioctls */ 666 if (ops->vidioc_enum_fmt_sdr_cap) 667 set_bit(_IOC_NR(VIDIOC_ENUM_FMT), valid_ioctls); 668 if (ops->vidioc_g_fmt_sdr_cap) 669 set_bit(_IOC_NR(VIDIOC_G_FMT), valid_ioctls); 670 if (ops->vidioc_s_fmt_sdr_cap) 671 set_bit(_IOC_NR(VIDIOC_S_FMT), valid_ioctls); 672 if (ops->vidioc_try_fmt_sdr_cap) 673 set_bit(_IOC_NR(VIDIOC_TRY_FMT), valid_ioctls); 674 } else if (is_sdr && is_tx) { 675 /* SDR transmitter specific ioctls */ 676 if (ops->vidioc_enum_fmt_sdr_out) 677 set_bit(_IOC_NR(VIDIOC_ENUM_FMT), valid_ioctls); 678 if (ops->vidioc_g_fmt_sdr_out) 679 set_bit(_IOC_NR(VIDIOC_G_FMT), valid_ioctls); 680 if (ops->vidioc_s_fmt_sdr_out) 681 set_bit(_IOC_NR(VIDIOC_S_FMT), valid_ioctls); 682 if (ops->vidioc_try_fmt_sdr_out) 683 set_bit(_IOC_NR(VIDIOC_TRY_FMT), valid_ioctls); 684 } 685 686 if (is_vid || is_vbi || is_sdr || is_tch) { 687 /* ioctls valid for video, metadata, vbi or sdr */ 688 SET_VALID_IOCTL(ops, VIDIOC_REQBUFS, vidioc_reqbufs); 689 SET_VALID_IOCTL(ops, VIDIOC_QUERYBUF, vidioc_querybuf); 690 SET_VALID_IOCTL(ops, VIDIOC_QBUF, vidioc_qbuf); 691 SET_VALID_IOCTL(ops, VIDIOC_EXPBUF, vidioc_expbuf); 692 SET_VALID_IOCTL(ops, VIDIOC_DQBUF, vidioc_dqbuf); 693 SET_VALID_IOCTL(ops, VIDIOC_CREATE_BUFS, vidioc_create_bufs); 694 SET_VALID_IOCTL(ops, VIDIOC_PREPARE_BUF, vidioc_prepare_buf); 695 SET_VALID_IOCTL(ops, VIDIOC_STREAMON, vidioc_streamon); 696 SET_VALID_IOCTL(ops, VIDIOC_STREAMOFF, vidioc_streamoff); 697 } 698 699 if (is_vid || is_vbi || is_tch) { 700 /* ioctls valid for video or vbi */ 701 if (ops->vidioc_s_std) 702 set_bit(_IOC_NR(VIDIOC_ENUMSTD), valid_ioctls); 703 SET_VALID_IOCTL(ops, VIDIOC_S_STD, vidioc_s_std); 704 SET_VALID_IOCTL(ops, VIDIOC_G_STD, vidioc_g_std); 705 if (is_rx) { 706 SET_VALID_IOCTL(ops, VIDIOC_QUERYSTD, vidioc_querystd); 707 SET_VALID_IOCTL(ops, VIDIOC_ENUMINPUT, vidioc_enum_input); 708 SET_VALID_IOCTL(ops, VIDIOC_G_INPUT, vidioc_g_input); 709 SET_VALID_IOCTL(ops, VIDIOC_S_INPUT, vidioc_s_input); 710 SET_VALID_IOCTL(ops, VIDIOC_ENUMAUDIO, vidioc_enumaudio); 711 SET_VALID_IOCTL(ops, VIDIOC_G_AUDIO, vidioc_g_audio); 712 SET_VALID_IOCTL(ops, VIDIOC_S_AUDIO, vidioc_s_audio); 713 SET_VALID_IOCTL(ops, VIDIOC_QUERY_DV_TIMINGS, vidioc_query_dv_timings); 714 SET_VALID_IOCTL(ops, VIDIOC_S_EDID, vidioc_s_edid); 715 } 716 if (is_tx) { 717 SET_VALID_IOCTL(ops, VIDIOC_ENUMOUTPUT, vidioc_enum_output); 718 SET_VALID_IOCTL(ops, VIDIOC_G_OUTPUT, vidioc_g_output); 719 SET_VALID_IOCTL(ops, VIDIOC_S_OUTPUT, vidioc_s_output); 720 SET_VALID_IOCTL(ops, VIDIOC_ENUMAUDOUT, vidioc_enumaudout); 721 SET_VALID_IOCTL(ops, VIDIOC_G_AUDOUT, vidioc_g_audout); 722 SET_VALID_IOCTL(ops, VIDIOC_S_AUDOUT, vidioc_s_audout); 723 } 724 if (ops->vidioc_g_parm || (vdev->vfl_type == VFL_TYPE_GRABBER && 725 ops->vidioc_g_std)) 726 set_bit(_IOC_NR(VIDIOC_G_PARM), valid_ioctls); 727 SET_VALID_IOCTL(ops, VIDIOC_S_PARM, vidioc_s_parm); 728 SET_VALID_IOCTL(ops, VIDIOC_S_DV_TIMINGS, vidioc_s_dv_timings); 729 SET_VALID_IOCTL(ops, VIDIOC_G_DV_TIMINGS, vidioc_g_dv_timings); 730 SET_VALID_IOCTL(ops, VIDIOC_ENUM_DV_TIMINGS, vidioc_enum_dv_timings); 731 SET_VALID_IOCTL(ops, VIDIOC_DV_TIMINGS_CAP, vidioc_dv_timings_cap); 732 SET_VALID_IOCTL(ops, VIDIOC_G_EDID, vidioc_g_edid); 733 } 734 if (is_tx && (is_radio || is_sdr)) { 735 /* radio transmitter only ioctls */ 736 SET_VALID_IOCTL(ops, VIDIOC_G_MODULATOR, vidioc_g_modulator); 737 SET_VALID_IOCTL(ops, VIDIOC_S_MODULATOR, vidioc_s_modulator); 738 } 739 if (is_rx) { 740 /* receiver only ioctls */ 741 SET_VALID_IOCTL(ops, VIDIOC_G_TUNER, vidioc_g_tuner); 742 SET_VALID_IOCTL(ops, VIDIOC_S_TUNER, vidioc_s_tuner); 743 SET_VALID_IOCTL(ops, VIDIOC_S_HW_FREQ_SEEK, vidioc_s_hw_freq_seek); 744 } 745 746 bitmap_andnot(vdev->valid_ioctls, valid_ioctls, vdev->valid_ioctls, 747 BASE_VIDIOC_PRIVATE); 748 } 749 750 static int video_register_media_controller(struct video_device *vdev) 751 { 752 #if defined(CONFIG_MEDIA_CONTROLLER) 753 u32 intf_type; 754 int ret; 755 756 /* Memory-to-memory devices are more complex and use 757 * their own function to register its mc entities. 758 */ 759 if (!vdev->v4l2_dev->mdev || vdev->vfl_dir == VFL_DIR_M2M) 760 return 0; 761 762 vdev->entity.obj_type = MEDIA_ENTITY_TYPE_VIDEO_DEVICE; 763 vdev->entity.function = MEDIA_ENT_F_UNKNOWN; 764 765 switch (vdev->vfl_type) { 766 case VFL_TYPE_GRABBER: 767 intf_type = MEDIA_INTF_T_V4L_VIDEO; 768 vdev->entity.function = MEDIA_ENT_F_IO_V4L; 769 break; 770 case VFL_TYPE_VBI: 771 intf_type = MEDIA_INTF_T_V4L_VBI; 772 vdev->entity.function = MEDIA_ENT_F_IO_VBI; 773 break; 774 case VFL_TYPE_SDR: 775 intf_type = MEDIA_INTF_T_V4L_SWRADIO; 776 vdev->entity.function = MEDIA_ENT_F_IO_SWRADIO; 777 break; 778 case VFL_TYPE_TOUCH: 779 intf_type = MEDIA_INTF_T_V4L_TOUCH; 780 vdev->entity.function = MEDIA_ENT_F_IO_V4L; 781 break; 782 case VFL_TYPE_RADIO: 783 intf_type = MEDIA_INTF_T_V4L_RADIO; 784 /* 785 * Radio doesn't have an entity at the V4L2 side to represent 786 * radio input or output. Instead, the audio input/output goes 787 * via either physical wires or ALSA. 788 */ 789 break; 790 case VFL_TYPE_SUBDEV: 791 intf_type = MEDIA_INTF_T_V4L_SUBDEV; 792 /* Entity will be created via v4l2_device_register_subdev() */ 793 break; 794 default: 795 return 0; 796 } 797 798 if (vdev->entity.function != MEDIA_ENT_F_UNKNOWN) { 799 vdev->entity.name = vdev->name; 800 801 /* Needed just for backward compatibility with legacy MC API */ 802 vdev->entity.info.dev.major = VIDEO_MAJOR; 803 vdev->entity.info.dev.minor = vdev->minor; 804 805 ret = media_device_register_entity(vdev->v4l2_dev->mdev, 806 &vdev->entity); 807 if (ret < 0) { 808 pr_warn("%s: media_device_register_entity failed\n", 809 __func__); 810 return ret; 811 } 812 } 813 814 vdev->intf_devnode = media_devnode_create(vdev->v4l2_dev->mdev, 815 intf_type, 816 0, VIDEO_MAJOR, 817 vdev->minor); 818 if (!vdev->intf_devnode) { 819 media_device_unregister_entity(&vdev->entity); 820 return -ENOMEM; 821 } 822 823 if (vdev->entity.function != MEDIA_ENT_F_UNKNOWN) { 824 struct media_link *link; 825 826 link = media_create_intf_link(&vdev->entity, 827 &vdev->intf_devnode->intf, 828 MEDIA_LNK_FL_ENABLED | 829 MEDIA_LNK_FL_IMMUTABLE); 830 if (!link) { 831 media_devnode_remove(vdev->intf_devnode); 832 media_device_unregister_entity(&vdev->entity); 833 return -ENOMEM; 834 } 835 } 836 837 /* FIXME: how to create the other interface links? */ 838 839 #endif 840 return 0; 841 } 842 843 int __video_register_device(struct video_device *vdev, 844 enum vfl_devnode_type type, 845 int nr, int warn_if_nr_in_use, 846 struct module *owner) 847 { 848 int i = 0; 849 int ret; 850 int minor_offset = 0; 851 int minor_cnt = VIDEO_NUM_DEVICES; 852 const char *name_base; 853 854 /* A minor value of -1 marks this video device as never 855 having been registered */ 856 vdev->minor = -1; 857 858 /* the release callback MUST be present */ 859 if (WARN_ON(!vdev->release)) 860 return -EINVAL; 861 /* the v4l2_dev pointer MUST be present */ 862 if (WARN_ON(!vdev->v4l2_dev)) 863 return -EINVAL; 864 865 /* v4l2_fh support */ 866 spin_lock_init(&vdev->fh_lock); 867 INIT_LIST_HEAD(&vdev->fh_list); 868 869 /* Part 1: check device type */ 870 switch (type) { 871 case VFL_TYPE_GRABBER: 872 name_base = "video"; 873 break; 874 case VFL_TYPE_VBI: 875 name_base = "vbi"; 876 break; 877 case VFL_TYPE_RADIO: 878 name_base = "radio"; 879 break; 880 case VFL_TYPE_SUBDEV: 881 name_base = "v4l-subdev"; 882 break; 883 case VFL_TYPE_SDR: 884 /* Use device name 'swradio' because 'sdr' was already taken. */ 885 name_base = "swradio"; 886 break; 887 case VFL_TYPE_TOUCH: 888 name_base = "v4l-touch"; 889 break; 890 default: 891 pr_err("%s called with unknown type: %d\n", 892 __func__, type); 893 return -EINVAL; 894 } 895 896 vdev->vfl_type = type; 897 vdev->cdev = NULL; 898 if (vdev->dev_parent == NULL) 899 vdev->dev_parent = vdev->v4l2_dev->dev; 900 if (vdev->ctrl_handler == NULL) 901 vdev->ctrl_handler = vdev->v4l2_dev->ctrl_handler; 902 /* If the prio state pointer is NULL, then use the v4l2_device 903 prio state. */ 904 if (vdev->prio == NULL) 905 vdev->prio = &vdev->v4l2_dev->prio; 906 907 /* Part 2: find a free minor, device node number and device index. */ 908 #ifdef CONFIG_VIDEO_FIXED_MINOR_RANGES 909 /* Keep the ranges for the first four types for historical 910 * reasons. 911 * Newer devices (not yet in place) should use the range 912 * of 128-191 and just pick the first free minor there 913 * (new style). */ 914 switch (type) { 915 case VFL_TYPE_GRABBER: 916 minor_offset = 0; 917 minor_cnt = 64; 918 break; 919 case VFL_TYPE_RADIO: 920 minor_offset = 64; 921 minor_cnt = 64; 922 break; 923 case VFL_TYPE_VBI: 924 minor_offset = 224; 925 minor_cnt = 32; 926 break; 927 default: 928 minor_offset = 128; 929 minor_cnt = 64; 930 break; 931 } 932 #endif 933 934 /* Pick a device node number */ 935 mutex_lock(&videodev_lock); 936 nr = devnode_find(vdev, nr == -1 ? 0 : nr, minor_cnt); 937 if (nr == minor_cnt) 938 nr = devnode_find(vdev, 0, minor_cnt); 939 if (nr == minor_cnt) { 940 pr_err("could not get a free device node number\n"); 941 mutex_unlock(&videodev_lock); 942 return -ENFILE; 943 } 944 #ifdef CONFIG_VIDEO_FIXED_MINOR_RANGES 945 /* 1-on-1 mapping of device node number to minor number */ 946 i = nr; 947 #else 948 /* The device node number and minor numbers are independent, so 949 we just find the first free minor number. */ 950 for (i = 0; i < VIDEO_NUM_DEVICES; i++) 951 if (video_devices[i] == NULL) 952 break; 953 if (i == VIDEO_NUM_DEVICES) { 954 mutex_unlock(&videodev_lock); 955 pr_err("could not get a free minor\n"); 956 return -ENFILE; 957 } 958 #endif 959 vdev->minor = i + minor_offset; 960 vdev->num = nr; 961 962 /* Should not happen since we thought this minor was free */ 963 if (WARN_ON(video_devices[vdev->minor])) { 964 mutex_unlock(&videodev_lock); 965 pr_err("video_device not empty!\n"); 966 return -ENFILE; 967 } 968 devnode_set(vdev); 969 vdev->index = get_index(vdev); 970 video_devices[vdev->minor] = vdev; 971 mutex_unlock(&videodev_lock); 972 973 if (vdev->ioctl_ops) 974 determine_valid_ioctls(vdev); 975 976 /* Part 3: Initialize the character device */ 977 vdev->cdev = cdev_alloc(); 978 if (vdev->cdev == NULL) { 979 ret = -ENOMEM; 980 goto cleanup; 981 } 982 vdev->cdev->ops = &v4l2_fops; 983 vdev->cdev->owner = owner; 984 ret = cdev_add(vdev->cdev, MKDEV(VIDEO_MAJOR, vdev->minor), 1); 985 if (ret < 0) { 986 pr_err("%s: cdev_add failed\n", __func__); 987 kfree(vdev->cdev); 988 vdev->cdev = NULL; 989 goto cleanup; 990 } 991 992 /* Part 4: register the device with sysfs */ 993 vdev->dev.class = &video_class; 994 vdev->dev.devt = MKDEV(VIDEO_MAJOR, vdev->minor); 995 vdev->dev.parent = vdev->dev_parent; 996 dev_set_name(&vdev->dev, "%s%d", name_base, vdev->num); 997 ret = device_register(&vdev->dev); 998 if (ret < 0) { 999 pr_err("%s: device_register failed\n", __func__); 1000 goto cleanup; 1001 } 1002 /* Register the release callback that will be called when the last 1003 reference to the device goes away. */ 1004 vdev->dev.release = v4l2_device_release; 1005 1006 if (nr != -1 && nr != vdev->num && warn_if_nr_in_use) 1007 pr_warn("%s: requested %s%d, got %s\n", __func__, 1008 name_base, nr, video_device_node_name(vdev)); 1009 1010 /* Increase v4l2_device refcount */ 1011 v4l2_device_get(vdev->v4l2_dev); 1012 1013 /* Part 5: Register the entity. */ 1014 ret = video_register_media_controller(vdev); 1015 1016 /* Part 6: Activate this minor. The char device can now be used. */ 1017 set_bit(V4L2_FL_REGISTERED, &vdev->flags); 1018 1019 return 0; 1020 1021 cleanup: 1022 mutex_lock(&videodev_lock); 1023 if (vdev->cdev) 1024 cdev_del(vdev->cdev); 1025 video_devices[vdev->minor] = NULL; 1026 devnode_clear(vdev); 1027 mutex_unlock(&videodev_lock); 1028 /* Mark this video device as never having been registered. */ 1029 vdev->minor = -1; 1030 return ret; 1031 } 1032 EXPORT_SYMBOL(__video_register_device); 1033 1034 /** 1035 * video_unregister_device - unregister a video4linux device 1036 * @vdev: the device to unregister 1037 * 1038 * This unregisters the passed device. Future open calls will 1039 * be met with errors. 1040 */ 1041 void video_unregister_device(struct video_device *vdev) 1042 { 1043 /* Check if vdev was ever registered at all */ 1044 if (!vdev || !video_is_registered(vdev)) 1045 return; 1046 1047 mutex_lock(&videodev_lock); 1048 /* This must be in a critical section to prevent a race with v4l2_open. 1049 * Once this bit has been cleared video_get may never be called again. 1050 */ 1051 clear_bit(V4L2_FL_REGISTERED, &vdev->flags); 1052 mutex_unlock(&videodev_lock); 1053 device_unregister(&vdev->dev); 1054 } 1055 EXPORT_SYMBOL(video_unregister_device); 1056 1057 /* 1058 * Initialise video for linux 1059 */ 1060 static int __init videodev_init(void) 1061 { 1062 dev_t dev = MKDEV(VIDEO_MAJOR, 0); 1063 int ret; 1064 1065 pr_info("Linux video capture interface: v2.00\n"); 1066 ret = register_chrdev_region(dev, VIDEO_NUM_DEVICES, VIDEO_NAME); 1067 if (ret < 0) { 1068 pr_warn("videodev: unable to get major %d\n", 1069 VIDEO_MAJOR); 1070 return ret; 1071 } 1072 1073 ret = class_register(&video_class); 1074 if (ret < 0) { 1075 unregister_chrdev_region(dev, VIDEO_NUM_DEVICES); 1076 pr_warn("video_dev: class_register failed\n"); 1077 return -EIO; 1078 } 1079 1080 return 0; 1081 } 1082 1083 static void __exit videodev_exit(void) 1084 { 1085 dev_t dev = MKDEV(VIDEO_MAJOR, 0); 1086 1087 class_unregister(&video_class); 1088 unregister_chrdev_region(dev, VIDEO_NUM_DEVICES); 1089 } 1090 1091 subsys_initcall(videodev_init); 1092 module_exit(videodev_exit) 1093 1094 MODULE_AUTHOR("Alan Cox, Mauro Carvalho Chehab <mchehab@kernel.org>"); 1095 MODULE_DESCRIPTION("Device registrar for Video4Linux drivers v2"); 1096 MODULE_LICENSE("GPL"); 1097 MODULE_ALIAS_CHARDEV_MAJOR(VIDEO_MAJOR); 1098