aboutsummaryrefslogtreecommitdiffstats
path: root/drivers/media/video/v4l2-common.c
diff options
context:
space:
mode:
Diffstat (limited to 'drivers/media/video/v4l2-common.c')
-rw-r--r--drivers/media/video/v4l2-common.c282
1 files changed, 282 insertions, 0 deletions
diff --git a/drivers/media/video/v4l2-common.c b/drivers/media/video/v4l2-common.c
new file mode 100644
index 000000000000..b5e0cf3448f4
--- /dev/null
+++ b/drivers/media/video/v4l2-common.c
@@ -0,0 +1,282 @@
1/*
2 * Video for Linux Two
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 file replaces the videodev.c file that comes with the
8 * regular kernel distribution.
9 *
10 * This program is free software; you can redistribute it and/or
11 * modify it under the terms of the GNU General Public License
12 * as published by the Free Software Foundation; either version
13 * 2 of the License, or (at your option) any later version.
14 *
15 * Author: Bill Dirks <bdirks@pacbell.net>
16 * based on code by Alan Cox, <alan@cymru.net>
17 *
18 */
19
20/*
21 * Video capture interface for Linux
22 *
23 * A generic video device interface for the LINUX operating system
24 * using a set of device structures/vectors for low level operations.
25 *
26 * This program is free software; you can redistribute it and/or
27 * modify it under the terms of the GNU General Public License
28 * as published by the Free Software Foundation; either version
29 * 2 of the License, or (at your option) any later version.
30 *
31 * Author: Alan Cox, <alan@redhat.com>
32 *
33 * Fixes:
34 */
35
36/*
37 * Video4linux 1/2 integration by Justin Schoeman
38 * <justin@suntiger.ee.up.ac.za>
39 * 2.4 PROCFS support ported from 2.4 kernels by
40 * Iñaki García Etxebarria <garetxe@euskalnet.net>
41 * Makefile fix by "W. Michael Petullo" <mike@flyn.org>
42 * 2.4 devfs support ported from 2.4 kernels by
43 * Dan Merillat <dan@merillat.org>
44 * Added Gerd Knorrs v4l1 enhancements (Justin Schoeman)
45 */
46
47#include <linux/config.h>
48#include <linux/module.h>
49#include <linux/types.h>
50#include <linux/kernel.h>
51#include <linux/sched.h>
52#include <linux/smp_lock.h>
53#include <linux/mm.h>
54#include <linux/string.h>
55#include <linux/errno.h>
56#include <asm/uaccess.h>
57#include <asm/system.h>
58#include <asm/pgtable.h>
59#include <asm/io.h>
60#include <asm/div64.h>
61
62#ifdef CONFIG_KMOD
63#include <linux/kmod.h>
64#endif
65
66#if defined(CONFIG_UST) || defined(CONFIG_UST_MODULE)
67#include <linux/ust.h>
68#endif
69
70
71#include <linux/videodev.h>
72
73MODULE_AUTHOR("Bill Dirks, Justin Schoeman, Gerd Knorr");
74MODULE_DESCRIPTION("misc helper functions for v4l2 device drivers");
75MODULE_LICENSE("GPL");
76
77/*
78 *
79 * V 4 L 2 D R I V E R H E L P E R A P I
80 *
81 */
82
83/*
84 * Video Standard Operations (contributed by Michael Schimek)
85 */
86
87#if 0 /* seems to have no users */
88/* This is the recommended method to deal with the framerate fields. More
89 sophisticated drivers will access the fields directly. */
90unsigned int
91v4l2_video_std_fps(struct v4l2_standard *vs)
92{
93 if (vs->frameperiod.numerator > 0)
94 return (((vs->frameperiod.denominator << 8) /
95 vs->frameperiod.numerator) +
96 (1 << 7)) / (1 << 8);
97 return 0;
98}
99EXPORT_SYMBOL(v4l2_video_std_fps);
100#endif
101
102/* Fill in the fields of a v4l2_standard structure according to the
103 'id' and 'transmission' parameters. Returns negative on error. */
104int v4l2_video_std_construct(struct v4l2_standard *vs,
105 int id, char *name)
106{
107 u32 index = vs->index;
108
109 memset(vs, 0, sizeof(struct v4l2_standard));
110 vs->index = index;
111 vs->id = id;
112 if (id & (V4L2_STD_NTSC | V4L2_STD_PAL_M)) {
113 vs->frameperiod.numerator = 1001;
114 vs->frameperiod.denominator = 30000;
115 vs->framelines = 525;
116 } else {
117 vs->frameperiod.numerator = 1;
118 vs->frameperiod.denominator = 25;
119 vs->framelines = 625;
120 }
121 strlcpy(vs->name,name,sizeof(vs->name));
122 return 0;
123}
124
125
126/* ----------------------------------------------------------------- */
127/* priority handling */
128
129#define V4L2_PRIO_VALID(val) (val == V4L2_PRIORITY_BACKGROUND || \
130 val == V4L2_PRIORITY_INTERACTIVE || \
131 val == V4L2_PRIORITY_RECORD)
132
133int v4l2_prio_init(struct v4l2_prio_state *global)
134{
135 memset(global,0,sizeof(*global));
136 return 0;
137}
138
139int v4l2_prio_change(struct v4l2_prio_state *global, enum v4l2_priority *local,
140 enum v4l2_priority new)
141{
142 if (!V4L2_PRIO_VALID(new))
143 return -EINVAL;
144 if (*local == new)
145 return 0;
146
147 atomic_inc(&global->prios[new]);
148 if (V4L2_PRIO_VALID(*local))
149 atomic_dec(&global->prios[*local]);
150 *local = new;
151 return 0;
152}
153
154int v4l2_prio_open(struct v4l2_prio_state *global, enum v4l2_priority *local)
155{
156 return v4l2_prio_change(global,local,V4L2_PRIORITY_DEFAULT);
157}
158
159int v4l2_prio_close(struct v4l2_prio_state *global, enum v4l2_priority *local)
160{
161 if (V4L2_PRIO_VALID(*local))
162 atomic_dec(&global->prios[*local]);
163 return 0;
164}
165
166enum v4l2_priority v4l2_prio_max(struct v4l2_prio_state *global)
167{
168 if (atomic_read(&global->prios[V4L2_PRIORITY_RECORD]) > 0)
169 return V4L2_PRIORITY_RECORD;
170 if (atomic_read(&global->prios[V4L2_PRIORITY_INTERACTIVE]) > 0)
171 return V4L2_PRIORITY_INTERACTIVE;
172 if (atomic_read(&global->prios[V4L2_PRIORITY_BACKGROUND]) > 0)
173 return V4L2_PRIORITY_BACKGROUND;
174 return V4L2_PRIORITY_UNSET;
175}
176
177int v4l2_prio_check(struct v4l2_prio_state *global, enum v4l2_priority *local)
178{
179 if (*local < v4l2_prio_max(global))
180 return -EBUSY;
181 return 0;
182}
183
184
185/* ----------------------------------------------------------------- */
186/* some arrays for pretty-printing debug messages */
187
188char *v4l2_field_names[] = {
189 [V4L2_FIELD_ANY] = "any",
190 [V4L2_FIELD_NONE] = "none",
191 [V4L2_FIELD_TOP] = "top",
192 [V4L2_FIELD_BOTTOM] = "bottom",
193 [V4L2_FIELD_INTERLACED] = "interlaced",
194 [V4L2_FIELD_SEQ_TB] = "seq-tb",
195 [V4L2_FIELD_SEQ_BT] = "seq-bt",
196 [V4L2_FIELD_ALTERNATE] = "alternate",
197};
198
199char *v4l2_type_names[] = {
200 [V4L2_BUF_TYPE_VIDEO_CAPTURE] = "video-cap",
201 [V4L2_BUF_TYPE_VIDEO_OVERLAY] = "video-over",
202 [V4L2_BUF_TYPE_VIDEO_OUTPUT] = "video-out",
203 [V4L2_BUF_TYPE_VBI_CAPTURE] = "vbi-cap",
204 [V4L2_BUF_TYPE_VBI_OUTPUT] = "vbi-out",
205};
206
207char *v4l2_ioctl_names[256] = {
208#if __GNUC__ >= 3
209 [0 ... 255] = "UNKNOWN",
210#endif
211 [_IOC_NR(VIDIOC_QUERYCAP)] = "VIDIOC_QUERYCAP",
212 [_IOC_NR(VIDIOC_RESERVED)] = "VIDIOC_RESERVED",
213 [_IOC_NR(VIDIOC_ENUM_FMT)] = "VIDIOC_ENUM_FMT",
214 [_IOC_NR(VIDIOC_G_FMT)] = "VIDIOC_G_FMT",
215 [_IOC_NR(VIDIOC_S_FMT)] = "VIDIOC_S_FMT",
216#if 0
217 [_IOC_NR(VIDIOC_G_COMP)] = "VIDIOC_G_COMP",
218 [_IOC_NR(VIDIOC_S_COMP)] = "VIDIOC_S_COMP",
219#endif
220 [_IOC_NR(VIDIOC_REQBUFS)] = "VIDIOC_REQBUFS",
221 [_IOC_NR(VIDIOC_QUERYBUF)] = "VIDIOC_QUERYBUF",
222 [_IOC_NR(VIDIOC_G_FBUF)] = "VIDIOC_G_FBUF",
223 [_IOC_NR(VIDIOC_S_FBUF)] = "VIDIOC_S_FBUF",
224 [_IOC_NR(VIDIOC_OVERLAY)] = "VIDIOC_OVERLAY",
225 [_IOC_NR(VIDIOC_QBUF)] = "VIDIOC_QBUF",
226 [_IOC_NR(VIDIOC_DQBUF)] = "VIDIOC_DQBUF",
227 [_IOC_NR(VIDIOC_STREAMON)] = "VIDIOC_STREAMON",
228 [_IOC_NR(VIDIOC_STREAMOFF)] = "VIDIOC_STREAMOFF",
229 [_IOC_NR(VIDIOC_G_PARM)] = "VIDIOC_G_PARM",
230 [_IOC_NR(VIDIOC_S_PARM)] = "VIDIOC_S_PARM",
231 [_IOC_NR(VIDIOC_G_STD)] = "VIDIOC_G_STD",
232 [_IOC_NR(VIDIOC_S_STD)] = "VIDIOC_S_STD",
233 [_IOC_NR(VIDIOC_ENUMSTD)] = "VIDIOC_ENUMSTD",
234 [_IOC_NR(VIDIOC_ENUMINPUT)] = "VIDIOC_ENUMINPUT",
235 [_IOC_NR(VIDIOC_G_CTRL)] = "VIDIOC_G_CTRL",
236 [_IOC_NR(VIDIOC_S_CTRL)] = "VIDIOC_S_CTRL",
237 [_IOC_NR(VIDIOC_G_TUNER)] = "VIDIOC_G_TUNER",
238 [_IOC_NR(VIDIOC_S_TUNER)] = "VIDIOC_S_TUNER",
239 [_IOC_NR(VIDIOC_G_AUDIO)] = "VIDIOC_G_AUDIO",
240 [_IOC_NR(VIDIOC_S_AUDIO)] = "VIDIOC_S_AUDIO",
241 [_IOC_NR(VIDIOC_QUERYCTRL)] = "VIDIOC_QUERYCTRL",
242 [_IOC_NR(VIDIOC_QUERYMENU)] = "VIDIOC_QUERYMENU",
243 [_IOC_NR(VIDIOC_G_INPUT)] = "VIDIOC_G_INPUT",
244 [_IOC_NR(VIDIOC_S_INPUT)] = "VIDIOC_S_INPUT",
245 [_IOC_NR(VIDIOC_G_OUTPUT)] = "VIDIOC_G_OUTPUT",
246 [_IOC_NR(VIDIOC_S_OUTPUT)] = "VIDIOC_S_OUTPUT",
247 [_IOC_NR(VIDIOC_ENUMOUTPUT)] = "VIDIOC_ENUMOUTPUT",
248 [_IOC_NR(VIDIOC_G_AUDOUT)] = "VIDIOC_G_AUDOUT",
249 [_IOC_NR(VIDIOC_S_AUDOUT)] = "VIDIOC_S_AUDOUT",
250 [_IOC_NR(VIDIOC_G_MODULATOR)] = "VIDIOC_G_MODULATOR",
251 [_IOC_NR(VIDIOC_S_MODULATOR)] = "VIDIOC_S_MODULATOR",
252 [_IOC_NR(VIDIOC_G_FREQUENCY)] = "VIDIOC_G_FREQUENCY",
253 [_IOC_NR(VIDIOC_S_FREQUENCY)] = "VIDIOC_S_FREQUENCY",
254 [_IOC_NR(VIDIOC_CROPCAP)] = "VIDIOC_CROPCAP",
255 [_IOC_NR(VIDIOC_G_CROP)] = "VIDIOC_G_CROP",
256 [_IOC_NR(VIDIOC_S_CROP)] = "VIDIOC_S_CROP",
257 [_IOC_NR(VIDIOC_G_JPEGCOMP)] = "VIDIOC_G_JPEGCOMP",
258 [_IOC_NR(VIDIOC_S_JPEGCOMP)] = "VIDIOC_S_JPEGCOMP",
259 [_IOC_NR(VIDIOC_QUERYSTD)] = "VIDIOC_QUERYSTD",
260 [_IOC_NR(VIDIOC_TRY_FMT)] = "VIDIOC_TRY_FMT",
261};
262
263/* ----------------------------------------------------------------- */
264
265EXPORT_SYMBOL(v4l2_video_std_construct);
266
267EXPORT_SYMBOL(v4l2_prio_init);
268EXPORT_SYMBOL(v4l2_prio_change);
269EXPORT_SYMBOL(v4l2_prio_open);
270EXPORT_SYMBOL(v4l2_prio_close);
271EXPORT_SYMBOL(v4l2_prio_max);
272EXPORT_SYMBOL(v4l2_prio_check);
273
274EXPORT_SYMBOL(v4l2_field_names);
275EXPORT_SYMBOL(v4l2_type_names);
276EXPORT_SYMBOL(v4l2_ioctl_names);
277
278/*
279 * Local variables:
280 * c-basic-offset: 8
281 * End:
282 */