2 * Multimedia device API
4 * Copyright (C) 2010 Nokia Corporation
6 * Contacts: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
7 * Sakari Ailus <sakari.ailus@iki.fi>
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License version 2 as
11 * published by the Free Software Foundation.
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.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23 #ifndef __LINUX_MEDIA_H
24 #define __LINUX_MEDIA_H
26 #include <linux/ioctl.h>
27 #include <linux/types.h>
28 #include <linux/version.h>
30 #define MEDIA_API_VERSION KERNEL_VERSION(0, 1, 0)
32 struct media_device_info {
43 #define MEDIA_ENT_ID_FLAG_NEXT (1 << 31)
45 #define MEDIA_ENT_TYPE_SHIFT 16
46 #define MEDIA_ENT_TYPE_MASK 0x00ff0000
47 #define MEDIA_ENT_SUBTYPE_MASK 0x0000ffff
49 #define MEDIA_ENT_T_DEVNODE (1 << MEDIA_ENT_TYPE_SHIFT)
50 #define MEDIA_ENT_T_DEVNODE_V4L (MEDIA_ENT_T_DEVNODE + 1)
51 #define MEDIA_ENT_T_DEVNODE_FB (MEDIA_ENT_T_DEVNODE + 2)
52 #define MEDIA_ENT_T_DEVNODE_ALSA (MEDIA_ENT_T_DEVNODE + 3)
53 #define MEDIA_ENT_T_DEVNODE_DVB_FE (MEDIA_ENT_T_DEVNODE + 4)
54 #define MEDIA_ENT_T_DEVNODE_DVB_DEMUX (MEDIA_ENT_T_DEVNODE + 5)
55 #define MEDIA_ENT_T_DEVNODE_DVB_DVR (MEDIA_ENT_T_DEVNODE + 6)
56 #define MEDIA_ENT_T_DEVNODE_DVB_CA (MEDIA_ENT_T_DEVNODE + 7)
57 #define MEDIA_ENT_T_DEVNODE_DVB_NET (MEDIA_ENT_T_DEVNODE + 8)
59 /* Legacy symbol. Use it to avoid userspace compilation breakages */
60 #define MEDIA_ENT_T_DEVNODE_DVB MEDIA_ENT_T_DEVNODE_DVB_FE
62 #define MEDIA_ENT_T_V4L2_SUBDEV (2 << MEDIA_ENT_TYPE_SHIFT)
63 #define MEDIA_ENT_T_V4L2_SUBDEV_SENSOR (MEDIA_ENT_T_V4L2_SUBDEV + 1)
64 #define MEDIA_ENT_T_V4L2_SUBDEV_FLASH (MEDIA_ENT_T_V4L2_SUBDEV + 2)
65 #define MEDIA_ENT_T_V4L2_SUBDEV_LENS (MEDIA_ENT_T_V4L2_SUBDEV + 3)
66 /* A converter of analogue video to its digital representation. */
67 #define MEDIA_ENT_T_V4L2_SUBDEV_DECODER (MEDIA_ENT_T_V4L2_SUBDEV + 4)
69 #define MEDIA_ENT_T_V4L2_SUBDEV_TUNER (MEDIA_ENT_T_V4L2_SUBDEV + 5)
71 #define MEDIA_ENT_FL_DEFAULT (1 << 0)
73 struct media_entity_desc {
86 /* Node specifications */
94 * DEPRECATED: previous node specifications. Kept just to
95 * avoid breaking compilation, but media_entity_desc.dev
96 * should be used instead. In particular, alsa and dvb
97 * fields below are wrong: for all devnodes, there should
98 * be just major/minor inside the struct, as this is enough
99 * to represent any devnode, no matter what type.
117 /* Sub-device specifications */
118 /* Nothing needed yet */
123 #define MEDIA_PAD_FL_SINK (1 << 0)
124 #define MEDIA_PAD_FL_SOURCE (1 << 1)
125 #define MEDIA_PAD_FL_MUST_CONNECT (1 << 2)
127 struct media_pad_desc {
128 __u32 entity; /* entity ID */
129 __u16 index; /* pad index */
130 __u32 flags; /* pad flags */
134 #define MEDIA_LNK_FL_ENABLED (1 << 0)
135 #define MEDIA_LNK_FL_IMMUTABLE (1 << 1)
136 #define MEDIA_LNK_FL_DYNAMIC (1 << 2)
138 struct media_link_desc {
139 struct media_pad_desc source;
140 struct media_pad_desc sink;
145 struct media_links_enum {
147 /* Should have enough room for pads elements */
148 struct media_pad_desc __user *pads;
149 /* Should have enough room for links elements */
150 struct media_link_desc __user *links;
154 #define MEDIA_IOC_DEVICE_INFO _IOWR('|', 0x00, struct media_device_info)
155 #define MEDIA_IOC_ENUM_ENTITIES _IOWR('|', 0x01, struct media_entity_desc)
156 #define MEDIA_IOC_ENUM_LINKS _IOWR('|', 0x02, struct media_links_enum)
157 #define MEDIA_IOC_SETUP_LINK _IOWR('|', 0x03, struct media_link_desc)
159 #endif /* __LINUX_MEDIA_H */