4 * Copyright (C) 2000 Ralph Metzler <ralph@convergence.de>
5 * & Marcus Metzler <marcus@convergence.de>
6 * for convergence integrated media GmbH
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public License
10 * as published by the Free Software Foundation; either version 2.1
11 * of the License, or (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
20 #define pr_fmt(fmt) "dvbdev: " fmt
22 #include <linux/types.h>
23 #include <linux/errno.h>
24 #include <linux/string.h>
25 #include <linux/module.h>
26 #include <linux/kernel.h>
27 #include <linux/init.h>
28 #include <linux/slab.h>
29 #include <linux/device.h>
31 #include <linux/cdev.h>
32 #include <linux/mutex.h>
35 /* Due to enum tuner_pad_index */
36 #include <media/tuner.h>
38 static DEFINE_MUTEX(dvbdev_mutex);
39 static int dvbdev_debug;
41 module_param(dvbdev_debug, int, 0644);
42 MODULE_PARM_DESC(dvbdev_debug, "Turn on/off device debugging (default:off).");
44 #define dprintk(fmt, arg...) do { \
46 printk(KERN_DEBUG pr_fmt("%s: " fmt), \
50 static LIST_HEAD(dvb_adapter_list);
51 static DEFINE_MUTEX(dvbdev_register_lock);
53 static const char * const dnames[] = {
54 "video", "audio", "sec", "frontend", "demux", "dvr", "ca",
58 #ifdef CONFIG_DVB_DYNAMIC_MINORS
59 #define MAX_DVB_MINORS 256
60 #define DVB_MAX_IDS MAX_DVB_MINORS
63 #define nums2minor(num, type, id) ((num << 6) | (id << 4) | type)
64 #define MAX_DVB_MINORS (DVB_MAX_ADAPTERS*64)
67 static struct class *dvb_class;
69 static struct dvb_device *dvb_minors[MAX_DVB_MINORS];
70 static DECLARE_RWSEM(minor_rwsem);
72 static int dvb_device_open(struct inode *inode, struct file *file)
74 struct dvb_device *dvbdev;
76 mutex_lock(&dvbdev_mutex);
77 down_read(&minor_rwsem);
78 dvbdev = dvb_minors[iminor(inode)];
80 if (dvbdev && dvbdev->fops) {
82 const struct file_operations *new_fops;
84 new_fops = fops_get(dvbdev->fops);
87 file->private_data = dvbdev;
88 replace_fops(file, new_fops);
90 err = file->f_op->open(inode, file);
91 up_read(&minor_rwsem);
92 mutex_unlock(&dvbdev_mutex);
96 up_read(&minor_rwsem);
97 mutex_unlock(&dvbdev_mutex);
102 static const struct file_operations dvb_device_fops =
104 .owner = THIS_MODULE,
105 .open = dvb_device_open,
106 .llseek = noop_llseek,
109 static struct cdev dvb_device_cdev;
111 int dvb_generic_open(struct inode *inode, struct file *file)
113 struct dvb_device *dvbdev = file->private_data;
121 if ((file->f_flags & O_ACCMODE) == O_RDONLY) {
122 if (!dvbdev->readers)
126 if (!dvbdev->writers)
134 EXPORT_SYMBOL(dvb_generic_open);
137 int dvb_generic_release(struct inode *inode, struct file *file)
139 struct dvb_device *dvbdev = file->private_data;
144 if ((file->f_flags & O_ACCMODE) == O_RDONLY) {
153 EXPORT_SYMBOL(dvb_generic_release);
156 long dvb_generic_ioctl(struct file *file,
157 unsigned int cmd, unsigned long arg)
159 struct dvb_device *dvbdev = file->private_data;
164 if (!dvbdev->kernel_ioctl)
167 return dvb_usercopy(file, cmd, arg, dvbdev->kernel_ioctl);
169 EXPORT_SYMBOL(dvb_generic_ioctl);
172 static int dvbdev_get_free_id (struct dvb_adapter *adap, int type)
176 while (id < DVB_MAX_IDS) {
177 struct dvb_device *dev;
178 list_for_each_entry(dev, &adap->device_list, list_head)
179 if (dev->type == type && dev->id == id)
188 static void dvb_media_device_free(struct dvb_device *dvbdev)
190 #if defined(CONFIG_MEDIA_CONTROLLER_DVB)
191 if (dvbdev->entity) {
192 media_device_unregister_entity(dvbdev->entity);
193 kfree(dvbdev->entity);
195 dvbdev->entity = NULL;
199 if (dvbdev->tsout_entity) {
202 for (i = 0; i < dvbdev->tsout_num_entities; i++) {
203 media_device_unregister_entity(&dvbdev->tsout_entity[i]);
204 kfree(dvbdev->tsout_entity[i].name);
206 kfree(dvbdev->tsout_entity);
207 kfree(dvbdev->tsout_pads);
208 dvbdev->tsout_entity = NULL;
209 dvbdev->tsout_pads = NULL;
211 dvbdev->tsout_num_entities = 0;
214 if (dvbdev->intf_devnode) {
215 media_devnode_remove(dvbdev->intf_devnode);
216 dvbdev->intf_devnode = NULL;
219 if (dvbdev->adapter->conn) {
220 media_device_unregister_entity(dvbdev->adapter->conn);
221 kfree(dvbdev->adapter->conn);
222 dvbdev->adapter->conn = NULL;
223 kfree(dvbdev->adapter->conn_pads);
224 dvbdev->adapter->conn_pads = NULL;
229 #if defined(CONFIG_MEDIA_CONTROLLER_DVB)
230 static int dvb_create_tsout_entity(struct dvb_device *dvbdev,
231 const char *name, int npads)
235 dvbdev->tsout_pads = kcalloc(npads, sizeof(*dvbdev->tsout_pads),
237 if (!dvbdev->tsout_pads)
240 dvbdev->tsout_entity = kcalloc(npads, sizeof(*dvbdev->tsout_entity),
242 if (!dvbdev->tsout_entity)
245 dvbdev->tsout_num_entities = npads;
247 for (i = 0; i < npads; i++) {
248 struct media_pad *pads = &dvbdev->tsout_pads[i];
249 struct media_entity *entity = &dvbdev->tsout_entity[i];
251 entity->name = kasprintf(GFP_KERNEL, "%s #%d", name, i);
255 entity->function = MEDIA_ENT_F_IO_DTV;
256 pads->flags = MEDIA_PAD_FL_SINK;
258 ret = media_entity_pads_init(entity, 1, pads);
262 ret = media_device_register_entity(dvbdev->adapter->mdev,
270 #define DEMUX_TSOUT "demux-tsout"
271 #define DVR_TSOUT "dvr-tsout"
273 static int dvb_create_media_entity(struct dvb_device *dvbdev,
274 int type, int demux_sink_pads)
279 case DVB_DEVICE_FRONTEND:
283 ret = dvb_create_tsout_entity(dvbdev, DVR_TSOUT,
286 case DVB_DEVICE_DEMUX:
287 npads = 1 + demux_sink_pads;
288 ret = dvb_create_tsout_entity(dvbdev, DEMUX_TSOUT,
298 * We should be creating entities for the MPE/ULE
299 * decapsulation hardware (or software implementation).
301 * However, the number of for the MPE/ULE decaps may not be
302 * fixed. As we don't have yet dynamic support for PADs at
303 * the Media Controller, let's not create the decap
311 dvbdev->entity = kzalloc(sizeof(*dvbdev->entity), GFP_KERNEL);
315 dvbdev->entity->name = dvbdev->name;
318 dvbdev->pads = kcalloc(npads, sizeof(*dvbdev->pads),
321 kfree(dvbdev->entity);
327 case DVB_DEVICE_FRONTEND:
328 dvbdev->entity->function = MEDIA_ENT_F_DTV_DEMOD;
329 dvbdev->pads[0].flags = MEDIA_PAD_FL_SINK;
330 dvbdev->pads[1].flags = MEDIA_PAD_FL_SOURCE;
332 case DVB_DEVICE_DEMUX:
333 dvbdev->entity->function = MEDIA_ENT_F_TS_DEMUX;
334 dvbdev->pads[0].flags = MEDIA_PAD_FL_SINK;
335 for (i = 1; i < npads; i++)
336 dvbdev->pads[i].flags = MEDIA_PAD_FL_SOURCE;
339 dvbdev->entity->function = MEDIA_ENT_F_DTV_CA;
340 dvbdev->pads[0].flags = MEDIA_PAD_FL_SINK;
341 dvbdev->pads[1].flags = MEDIA_PAD_FL_SOURCE;
344 /* Should never happen, as the first switch prevents it */
345 kfree(dvbdev->entity);
347 dvbdev->entity = NULL;
353 ret = media_entity_pads_init(dvbdev->entity, npads, dvbdev->pads);
357 ret = media_device_register_entity(dvbdev->adapter->mdev,
362 pr_info("%s: media entity '%s' registered.\n",
363 __func__, dvbdev->entity->name);
369 static int dvb_register_media_device(struct dvb_device *dvbdev,
371 unsigned demux_sink_pads)
373 #if defined(CONFIG_MEDIA_CONTROLLER_DVB)
374 struct media_link *link;
378 if (!dvbdev->adapter->mdev)
381 ret = dvb_create_media_entity(dvbdev, type, demux_sink_pads);
386 case DVB_DEVICE_FRONTEND:
387 intf_type = MEDIA_INTF_T_DVB_FE;
389 case DVB_DEVICE_DEMUX:
390 intf_type = MEDIA_INTF_T_DVB_DEMUX;
393 intf_type = MEDIA_INTF_T_DVB_DVR;
396 intf_type = MEDIA_INTF_T_DVB_CA;
399 intf_type = MEDIA_INTF_T_DVB_NET;
405 dvbdev->intf_devnode = media_devnode_create(dvbdev->adapter->mdev,
409 if (!dvbdev->intf_devnode)
413 * Create the "obvious" link, e. g. the ones that represent
414 * a direct association between an interface and an entity.
415 * Other links should be created elsewhere, like:
416 * DVB FE intf -> tuner
417 * DVB demux intf -> dvr
423 link = media_create_intf_link(dvbdev->entity, &dvbdev->intf_devnode->intf,
424 MEDIA_LNK_FL_ENABLED);
431 int dvb_register_device(struct dvb_adapter *adap, struct dvb_device **pdvbdev,
432 const struct dvb_device *template, void *priv, int type,
435 struct dvb_device *dvbdev;
436 struct file_operations *dvbdevfops;
437 struct device *clsdev;
441 mutex_lock(&dvbdev_register_lock);
443 if ((id = dvbdev_get_free_id (adap, type)) < 0){
444 mutex_unlock(&dvbdev_register_lock);
446 pr_err("%s: couldn't find free device id\n", __func__);
450 *pdvbdev = dvbdev = kzalloc(sizeof(*dvbdev), GFP_KERNEL);
453 mutex_unlock(&dvbdev_register_lock);
457 dvbdevfops = kzalloc(sizeof(struct file_operations), GFP_KERNEL);
461 mutex_unlock(&dvbdev_register_lock);
465 memcpy(dvbdev, template, sizeof(struct dvb_device));
468 dvbdev->adapter = adap;
470 dvbdev->fops = dvbdevfops;
471 init_waitqueue_head (&dvbdev->wait_queue);
473 memcpy(dvbdevfops, template->fops, sizeof(struct file_operations));
474 dvbdevfops->owner = adap->module;
476 list_add_tail (&dvbdev->list_head, &adap->device_list);
478 down_write(&minor_rwsem);
479 #ifdef CONFIG_DVB_DYNAMIC_MINORS
480 for (minor = 0; minor < MAX_DVB_MINORS; minor++)
481 if (dvb_minors[minor] == NULL)
484 if (minor == MAX_DVB_MINORS) {
487 up_write(&minor_rwsem);
488 mutex_unlock(&dvbdev_register_lock);
492 minor = nums2minor(adap->num, type, id);
495 dvbdev->minor = minor;
496 dvb_minors[minor] = dvbdev;
497 up_write(&minor_rwsem);
499 ret = dvb_register_media_device(dvbdev, type, minor, demux_sink_pads);
501 pr_err("%s: dvb_register_media_device failed to create the mediagraph\n",
504 dvb_media_device_free(dvbdev);
507 up_write(&minor_rwsem);
508 mutex_unlock(&dvbdev_register_lock);
512 mutex_unlock(&dvbdev_register_lock);
514 clsdev = device_create(dvb_class, adap->device,
515 MKDEV(DVB_MAJOR, minor),
516 dvbdev, "dvb%d.%s%d", adap->num, dnames[type], id);
517 if (IS_ERR(clsdev)) {
518 pr_err("%s: failed to create device dvb%d.%s%d (%ld)\n",
519 __func__, adap->num, dnames[type], id, PTR_ERR(clsdev));
520 return PTR_ERR(clsdev);
522 dprintk("DVB: register adapter%d/%s%d @ minor: %i (0x%02x)\n",
523 adap->num, dnames[type], id, minor, minor);
527 EXPORT_SYMBOL(dvb_register_device);
530 void dvb_remove_device(struct dvb_device *dvbdev)
535 down_write(&minor_rwsem);
536 dvb_minors[dvbdev->minor] = NULL;
537 up_write(&minor_rwsem);
539 dvb_media_device_free(dvbdev);
541 device_destroy(dvb_class, MKDEV(DVB_MAJOR, dvbdev->minor));
543 list_del (&dvbdev->list_head);
545 EXPORT_SYMBOL(dvb_remove_device);
548 void dvb_free_device(struct dvb_device *dvbdev)
553 kfree (dvbdev->fops);
556 EXPORT_SYMBOL(dvb_free_device);
559 void dvb_unregister_device(struct dvb_device *dvbdev)
561 dvb_remove_device(dvbdev);
562 dvb_free_device(dvbdev);
564 EXPORT_SYMBOL(dvb_unregister_device);
567 #ifdef CONFIG_MEDIA_CONTROLLER_DVB
569 static int dvb_create_io_intf_links(struct dvb_adapter *adap,
570 struct media_interface *intf,
573 struct media_device *mdev = adap->mdev;
574 struct media_entity *entity;
575 struct media_link *link;
577 media_device_for_each_entity(entity, mdev) {
578 if (entity->function == MEDIA_ENT_F_IO_DTV) {
579 if (strncmp(entity->name, name, strlen(name)))
581 link = media_create_intf_link(entity, intf,
582 MEDIA_LNK_FL_ENABLED);
590 int dvb_create_media_graph(struct dvb_adapter *adap,
591 bool create_rf_connector)
593 struct media_device *mdev = adap->mdev;
594 struct media_entity *entity, *tuner = NULL, *demod = NULL, *conn;
595 struct media_entity *demux = NULL, *ca = NULL;
596 struct media_link *link;
597 struct media_interface *intf;
598 unsigned demux_pad = 0;
599 unsigned dvr_pad = 0;
600 unsigned ntuner = 0, ndemod = 0;
602 static const char *connector_name = "Television";
607 media_device_for_each_entity(entity, mdev) {
608 switch (entity->function) {
609 case MEDIA_ENT_F_TUNER:
613 case MEDIA_ENT_F_DTV_DEMOD:
617 case MEDIA_ENT_F_TS_DEMUX:
620 case MEDIA_ENT_F_DTV_CA:
627 * Prepare to signalize to media_create_pad_links() that multiple
628 * entities of the same type exists and a 1:n or n:1 links need to be
630 * NOTE: if both tuner and demod have multiple instances, it is up
631 * to the caller driver to create such links.
638 if (create_rf_connector) {
639 conn = kzalloc(sizeof(*conn), GFP_KERNEL);
644 adap->conn_pads = kzalloc(sizeof(*adap->conn_pads), GFP_KERNEL);
645 if (!adap->conn_pads)
648 conn->flags = MEDIA_ENT_FL_CONNECTOR;
649 conn->function = MEDIA_ENT_F_CONN_RF;
650 conn->name = connector_name;
651 adap->conn_pads->flags = MEDIA_PAD_FL_SOURCE;
653 ret = media_entity_pads_init(conn, 1, adap->conn_pads);
657 ret = media_device_register_entity(mdev, conn);
662 ret = media_create_pad_links(mdev,
665 MEDIA_ENT_F_DTV_DEMOD,
667 MEDIA_LNK_FL_ENABLED,
670 ret = media_create_pad_links(mdev,
674 tuner, TUNER_PAD_RF_INPUT,
675 MEDIA_LNK_FL_ENABLED,
681 if (ntuner && ndemod) {
682 ret = media_create_pad_links(mdev,
684 tuner, TUNER_PAD_OUTPUT,
685 MEDIA_ENT_F_DTV_DEMOD,
686 demod, 0, MEDIA_LNK_FL_ENABLED,
692 if (ndemod && demux) {
693 ret = media_create_pad_links(mdev,
694 MEDIA_ENT_F_DTV_DEMOD,
696 MEDIA_ENT_F_TS_DEMUX,
697 demux, 0, MEDIA_LNK_FL_ENABLED,
703 ret = media_create_pad_link(demux, 1, ca,
704 0, MEDIA_LNK_FL_ENABLED);
709 /* Create demux links for each ringbuffer/pad */
711 media_device_for_each_entity(entity, mdev) {
712 if (entity->function == MEDIA_ENT_F_IO_DTV) {
713 if (!strncmp(entity->name, DVR_TSOUT,
714 strlen(DVR_TSOUT))) {
715 ret = media_create_pad_link(demux,
721 if (!strncmp(entity->name, DEMUX_TSOUT,
722 strlen(DEMUX_TSOUT))) {
723 ret = media_create_pad_link(demux,
733 /* Create interface links for FE->tuner, DVR->demux and CA->ca */
734 media_device_for_each_intf(intf, mdev) {
735 if (intf->type == MEDIA_INTF_T_DVB_CA && ca) {
736 link = media_create_intf_link(ca, intf,
737 MEDIA_LNK_FL_ENABLED);
742 if (intf->type == MEDIA_INTF_T_DVB_FE && tuner) {
743 link = media_create_intf_link(tuner, intf,
744 MEDIA_LNK_FL_ENABLED);
750 * Indirect link - let's not create yet, as we don't know how
751 * to handle indirect links, nor if this will
752 * actually be needed.
754 if (intf->type == MEDIA_INTF_T_DVB_DVR && demux) {
755 link = media_create_intf_link(demux, intf,
756 MEDIA_LNK_FL_ENABLED);
761 if (intf->type == MEDIA_INTF_T_DVB_DVR) {
762 ret = dvb_create_io_intf_links(adap, intf, DVR_TSOUT);
766 if (intf->type == MEDIA_INTF_T_DVB_DEMUX) {
767 ret = dvb_create_io_intf_links(adap, intf, DEMUX_TSOUT);
774 EXPORT_SYMBOL_GPL(dvb_create_media_graph);
777 static int dvbdev_check_free_adapter_num(int num)
779 struct list_head *entry;
780 list_for_each(entry, &dvb_adapter_list) {
781 struct dvb_adapter *adap;
782 adap = list_entry(entry, struct dvb_adapter, list_head);
783 if (adap->num == num)
789 static int dvbdev_get_free_adapter_num (void)
793 while (num < DVB_MAX_ADAPTERS) {
794 if (dvbdev_check_free_adapter_num(num))
803 int dvb_register_adapter(struct dvb_adapter *adap, const char *name,
804 struct module *module, struct device *device,
809 mutex_lock(&dvbdev_register_lock);
811 for (i = 0; i < DVB_MAX_ADAPTERS; ++i) {
812 num = adapter_nums[i];
813 if (num >= 0 && num < DVB_MAX_ADAPTERS) {
814 /* use the one the driver asked for */
815 if (dvbdev_check_free_adapter_num(num))
818 num = dvbdev_get_free_adapter_num();
825 mutex_unlock(&dvbdev_register_lock);
829 memset (adap, 0, sizeof(struct dvb_adapter));
830 INIT_LIST_HEAD (&adap->device_list);
832 pr_info("DVB: registering new adapter (%s)\n", name);
836 adap->module = module;
837 adap->device = device;
838 adap->mfe_shared = 0;
839 adap->mfe_dvbdev = NULL;
840 mutex_init (&adap->mfe_lock);
842 list_add_tail (&adap->list_head, &dvb_adapter_list);
844 mutex_unlock(&dvbdev_register_lock);
848 EXPORT_SYMBOL(dvb_register_adapter);
851 int dvb_unregister_adapter(struct dvb_adapter *adap)
853 mutex_lock(&dvbdev_register_lock);
854 list_del (&adap->list_head);
855 mutex_unlock(&dvbdev_register_lock);
858 EXPORT_SYMBOL(dvb_unregister_adapter);
860 /* if the miracle happens and "generic_usercopy()" is included into
861 the kernel, then this can vanish. please don't make the mistake and
862 define this as video_usercopy(). this will introduce a dependecy
863 to the v4l "videodev.o" module, which is unnecessary for some
864 cards (ie. the budget dvb-cards don't need the v4l module...) */
865 int dvb_usercopy(struct file *file,
866 unsigned int cmd, unsigned long arg,
867 int (*func)(struct file *file,
868 unsigned int cmd, void *arg))
875 /* Copy arguments into temp kernel buffer */
876 switch (_IOC_DIR(cmd)) {
879 * For this command, the pointer is actually an integer
884 case _IOC_READ: /* some v4l ioctls are marked wrong ... */
886 case (_IOC_WRITE | _IOC_READ):
887 if (_IOC_SIZE(cmd) <= sizeof(sbuf)) {
890 /* too big to allocate from stack */
891 mbuf = kmalloc(_IOC_SIZE(cmd), GFP_KERNEL);
898 if (copy_from_user(parg, (void __user *)arg, _IOC_SIZE(cmd)))
904 if ((err = func(file, cmd, parg)) == -ENOIOCTLCMD)
910 /* Copy results into user buffer */
911 switch (_IOC_DIR(cmd))
914 case (_IOC_WRITE | _IOC_READ):
915 if (copy_to_user((void __user *)arg, parg, _IOC_SIZE(cmd)))
925 static int dvb_uevent(struct device *dev, struct kobj_uevent_env *env)
927 struct dvb_device *dvbdev = dev_get_drvdata(dev);
929 add_uevent_var(env, "DVB_ADAPTER_NUM=%d", dvbdev->adapter->num);
930 add_uevent_var(env, "DVB_DEVICE_TYPE=%s", dnames[dvbdev->type]);
931 add_uevent_var(env, "DVB_DEVICE_NUM=%d", dvbdev->id);
935 static char *dvb_devnode(struct device *dev, umode_t *mode)
937 struct dvb_device *dvbdev = dev_get_drvdata(dev);
939 return kasprintf(GFP_KERNEL, "dvb/adapter%d/%s%d",
940 dvbdev->adapter->num, dnames[dvbdev->type], dvbdev->id);
944 static int __init init_dvbdev(void)
947 dev_t dev = MKDEV(DVB_MAJOR, 0);
949 if ((retval = register_chrdev_region(dev, MAX_DVB_MINORS, "DVB")) != 0) {
950 pr_err("dvb-core: unable to get major %d\n", DVB_MAJOR);
954 cdev_init(&dvb_device_cdev, &dvb_device_fops);
955 if ((retval = cdev_add(&dvb_device_cdev, dev, MAX_DVB_MINORS)) != 0) {
956 pr_err("dvb-core: unable register character device\n");
960 dvb_class = class_create(THIS_MODULE, "dvb");
961 if (IS_ERR(dvb_class)) {
962 retval = PTR_ERR(dvb_class);
965 dvb_class->dev_uevent = dvb_uevent;
966 dvb_class->devnode = dvb_devnode;
970 cdev_del(&dvb_device_cdev);
971 unregister_chrdev_region(dev, MAX_DVB_MINORS);
976 static void __exit exit_dvbdev(void)
978 class_destroy(dvb_class);
979 cdev_del(&dvb_device_cdev);
980 unregister_chrdev_region(MKDEV(DVB_MAJOR, 0), MAX_DVB_MINORS);
983 subsys_initcall(init_dvbdev);
984 module_exit(exit_dvbdev);
986 MODULE_DESCRIPTION("DVB Core Driver");
987 MODULE_AUTHOR("Marcus Metzler, Ralph Metzler, Holger Waechtler");
988 MODULE_LICENSE("GPL");