1 /*****************************************************************************
2 * v4l2.c : Video4Linux2 input module for VLC
3 *****************************************************************************
4 * Copyright (C) 2002-2009 VLC authors and VideoLAN
5 * Copyright (C) 2011-2012 RĂ©mi Denis-Courmont
7 * Authors: Benjamin Pracht <bigben at videolan dot org>
8 * Richard Hosking <richard at hovis dot net>
9 * Antoine Cellerier <dionoea at videolan d.t org>
10 * Dennis Lou <dlou99 at yahoo dot com>
12 * This program is free software; you can redistribute it and/or modify it
13 * under the terms of the GNU Lesser General Public License as published by
14 * the Free Software Foundation; either version 2.1 of the License, or
15 * (at your option) any later version.
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU Lesser General Public License for more details.
22 * You should have received a copy of the GNU Lesser General Public License
23 * along with this program; if not, write to the Free Software Foundation,
24 * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
25 *****************************************************************************/
35 #include <sys/types.h>
38 #include <vlc_common.h>
39 #include <vlc_plugin.h>
44 #define VIDEO_DEVICE_TEXT N_( "Video capture device" )
45 #define VIDEO_DEVICE_LONGTEXT N_("Video capture device node." )
46 #define VBI_DEVICE_TEXT N_("VBI capture device")
47 #define VBI_DEVICE_LONGTEXT N_( \
48 "The device node where VBI data can be read " \
49 " (for closed captions) " )
50 #define STANDARD_TEXT N_( "Standard" )
51 #define STANDARD_LONGTEXT N_( \
52 "Video standard (Default, SECAM, PAL, or NTSC)." )
53 #define CHROMA_TEXT N_("Video input chroma format")
54 #define CHROMA_LONGTEXT N_( \
55 "Force the Video4Linux2 video device to use a specific chroma format " \
56 "(eg. I420 or I422 for raw images, MJPG for M-JPEG compressed input) " \
57 "(Complete list: GREY, I240, RV16, RV15, RV24, RV32, YUY2, YUYV, UYVY, " \
58 "I41N, I422, I420, I411, I410, MJPG)")
59 #define INPUT_TEXT N_( "Input" )
60 #define INPUT_LONGTEXT N_( \
61 "Input of the card to use (see debug)." )
62 #define AUDIO_INPUT_TEXT N_( "Audio input" )
63 #define AUDIO_INPUT_LONGTEXT N_( \
64 "Audio input of the card to use (see debug)." )
65 #define WIDTH_TEXT N_( "Width" )
66 #define HEIGHT_TEXT N_( "Height" )
67 #define SIZE_LONGTEXT N_( \
68 "The specified pixel resolution is forced " \
69 "(if both width and height are strictly positive)." )
70 #define FPS_TEXT N_( "Frame rate" )
71 #define FPS_LONGTEXT N_( "Maximum frame rate to use (0 = no limits)." )
73 #define RADIO_DEVICE_TEXT N_( "Radio device" )
74 #define RADIO_DEVICE_LONGTEXT N_("Radio tuner device node." )
75 #define FREQUENCY_TEXT N_("Frequency")
76 #define FREQUENCY_LONGTEXT N_( \
77 "Tuner frequency in Hz or kHz (see debug output)" )
78 #define TUNER_AUDIO_MODE_TEXT N_("Audio mode")
79 #define TUNER_AUDIO_MODE_LONGTEXT N_( \
80 "Tuner audio mono/stereo and track selection." )
82 #define CTRL_RESET_TEXT N_( "Reset controls" )
83 #define CTRL_RESET_LONGTEXT N_( "Reset controls to defaults." )
84 #define BRIGHTNESS_TEXT N_( "Brightness" )
85 #define BRIGHTNESS_LONGTEXT N_( "Picture brightness or black level." )
86 #define BRIGHTNESS_AUTO_TEXT N_( "Automatic brightness" )
87 #define BRIGHTNESS_AUTO_LONGTEXT N_( \
88 "Automatically adjust the picture brightness." )
89 #define CONTRAST_TEXT N_( "Contrast" )
90 #define CONTRAST_LONGTEXT N_( "Picture contrast or luma gain." )
91 #define SATURATION_TEXT N_( "Saturation" )
92 #define SATURATION_LONGTEXT N_( "Picture saturation or chroma gain." )
93 #define HUE_TEXT N_( "Hue" )
94 #define HUE_LONGTEXT N_( "Hue or color balance." )
95 #define HUE_AUTO_TEXT N_( "Automatic hue" )
96 #define HUE_AUTO_LONGTEXT N_( \
97 "Automatically adjust the picture hue." )
98 #define WHITE_BALANCE_TEMP_TEXT N_( "White balance temperature (K)" )
99 #define WHITE_BALANCE_TEMP_LONGTEXT N_( \
100 "White balance temperature as a color temperation in Kelvin " \
101 "(2800 is minimum incandescence, 6500 is maximum daylight)." )
102 #define AUTOWHITEBALANCE_TEXT N_( "Automatic white balance" )
103 #define AUTOWHITEBALANCE_LONGTEXT N_( \
104 "Automatically adjust the picture white balance." )
105 #define REDBALANCE_TEXT N_( "Red balance" )
106 #define REDBALANCE_LONGTEXT N_( \
107 "Red chroma balance." )
108 #define BLUEBALANCE_TEXT N_( "Blue balance" )
109 #define BLUEBALANCE_LONGTEXT N_( \
110 "Blue chroma balance." )
111 #define GAMMA_TEXT N_( "Gamma" )
112 #define GAMMA_LONGTEXT N_( \
114 #define AUTOGAIN_TEXT N_( "Automatic gain" )
115 #define AUTOGAIN_LONGTEXT N_( \
116 "Automatically set the video gain." )
117 #define GAIN_TEXT N_( "Gain" )
118 #define GAIN_LONGTEXT N_( \
120 #define SHARPNESS_TEXT N_( "Sharpness" )
121 #define SHARPNESS_LONGTEXT N_( "Sharpness filter adjust." )
122 #define CHROMA_GAIN_TEXT N_( "Chroma gain" )
123 #define CHROMA_GAIN_LONGTEXT N_( "Chroma gain control." )
124 #define CHROMA_GAIN_AUTO_TEXT N_( "Automatic chroma gain" )
125 #define CHROMA_GAIN_AUTO_LONGTEXT N_( \
126 "Automatically control the chroma gain." )
127 #define POWER_FREQ_TEXT N_( "Power line frequency" )
128 #define POWER_FREQ_LONGTEXT N_( \
129 "Power line frequency anti-flicker filter." )
130 static const int power_freq_vlc[] = { -1,
131 V4L2_CID_POWER_LINE_FREQUENCY_DISABLED,
132 V4L2_CID_POWER_LINE_FREQUENCY_50HZ,
133 V4L2_CID_POWER_LINE_FREQUENCY_60HZ,
134 V4L2_CID_POWER_LINE_FREQUENCY_AUTO,
136 static const char *const power_freq_user[] = { N_("Unspecified"),
137 N_("Off"), N_("50 Hz"), N_("60 Hz"), N_("Automatic"),
139 #define BKLT_COMPENSATE_TEXT N_( "Backlight compensation" )
140 #define BKLT_COMPENSATE_LONGTEXT BKLT_COMPENSATE_TEXT
141 #define BAND_STOP_FILTER_TEXT N_( "Band-stop filter" )
142 #define BAND_STOP_FILTER_LONGTEXT N_( \
143 "Cut a light band induced by fluorescent lighting (unit undocumented)." )
144 #define HFLIP_TEXT N_( "Horizontal flip" )
145 #define HFLIP_LONGTEXT N_( \
146 "Flip the picture horizontally." )
147 #define VFLIP_TEXT N_( "Vertical flip" )
148 #define VFLIP_LONGTEXT N_( \
149 "Flip the picture vertically." )
150 #define ROTATE_TEXT N_( "Rotate (degrees)" )
151 #define ROTATE_LONGTEXT N_( "Picture rotation angle (in degrees)." )
152 #define COLOR_KILLER_TEXT N_( "Color killer" )
153 #define COLOR_KILLER_LONGTEXT N_( \
154 "Enable the color killer, i.e. switch to black & white picture " \
155 "whenever the signal is weak." )
156 #define COLOR_EFFECT_TEXT N_( "Color effect" )
157 #define COLOR_EFFECT_LONGTEXT N_( "Select a color effect." )
158 static const int colorfx_vlc[] = { -1, V4L2_COLORFX_NONE,
159 V4L2_COLORFX_BW, V4L2_COLORFX_SEPIA, V4L2_COLORFX_NEGATIVE,
160 V4L2_COLORFX_EMBOSS, V4L2_COLORFX_SKETCH, V4L2_COLORFX_SKY_BLUE,
161 V4L2_COLORFX_GRASS_GREEN, V4L2_COLORFX_SKIN_WHITEN, V4L2_COLORFX_VIVID,
163 static const char *const colorfx_user[] = { N_("Unspecified"), N_("None"),
164 N_("Black & white"), N_("Sepia"), N_("Negative"),
165 N_("Emboss"), N_("Sketch"), N_("Sky blue"),
166 N_("Grass green"), N_("Skin whiten"), N_("Vivid"),
169 #define AUDIO_VOLUME_TEXT N_( "Audio volume" )
170 #define AUDIO_VOLUME_LONGTEXT N_( \
171 "Volume of the audio input." )
172 #define AUDIO_BALANCE_TEXT N_( "Audio balance" )
173 #define AUDIO_BALANCE_LONGTEXT N_( \
174 "Balance of the audio input." )
175 #define AUDIO_BASS_TEXT N_( "Bass level" )
176 #define AUDIO_BASS_LONGTEXT N_( \
177 "Bass adjustment of the audio input." )
178 #define AUDIO_TREBLE_TEXT N_( "Treble level" )
179 #define AUDIO_TREBLE_LONGTEXT N_( \
180 "Treble adjustment of the audio input." )
181 #define AUDIO_MUTE_TEXT N_( "Mute" )
182 #define AUDIO_MUTE_LONGTEXT N_( \
184 #define AUDIO_LOUDNESS_TEXT N_( "Loudness mode" )
185 #define AUDIO_LOUDNESS_LONGTEXT N_( \
186 "Loudness mode a.k.a. bass boost." )
188 #define S_CTRLS_TEXT N_("v4l2 driver controls")
189 #define S_CTRLS_LONGTEXT N_( \
190 "Set the v4l2 driver controls to the values specified using a comma " \
191 "separated list optionally encapsulated by curly braces " \
192 "(e.g.: {video_bitrate=6000000,audio_crc=0,stream_type=3} ). " \
193 "To list available controls, increase verbosity (-vvv) " \
194 "or use the v4l2-ctl application." )
196 #define ASPECT_TEXT N_("Picture aspect-ratio n:m")
197 #define ASPECT_LONGTEXT N_("Define input picture aspect-ratio to use. Default is 4:3" )
199 static const int tristate_vlc[] = { -1, 0, 1 };
200 static const char *const tristate_user[] = {
201 N_("Unspecified"), N_("Off"), N_("On") };
203 static const v4l2_std_id standards_v4l2[] = { V4L2_STD_UNKNOWN, V4L2_STD_ALL,
204 V4L2_STD_PAL, V4L2_STD_PAL_BG, V4L2_STD_PAL_DK,
206 V4L2_STD_SECAM, V4L2_STD_SECAM_DK,
207 V4L2_STD_MTS, V4L2_STD_525_60, V4L2_STD_625_50,
210 V4L2_STD_B, V4L2_STD_G, V4L2_STD_H, V4L2_STD_L,
211 V4L2_STD_GH, V4L2_STD_DK, V4L2_STD_BG, V4L2_STD_MN,
213 V4L2_STD_PAL_B, V4L2_STD_PAL_B1, V4L2_STD_PAL_G, V4L2_STD_PAL_H,
214 V4L2_STD_PAL_I, V4L2_STD_PAL_D, V4L2_STD_PAL_D1, V4L2_STD_PAL_K,
215 V4L2_STD_PAL_M, V4L2_STD_PAL_N, V4L2_STD_PAL_Nc, V4L2_STD_PAL_60,
216 V4L2_STD_NTSC_M, V4L2_STD_NTSC_M_JP,V4L2_STD_NTSC_443, V4L2_STD_NTSC_M_KR,
217 V4L2_STD_SECAM_B, V4L2_STD_SECAM_D, V4L2_STD_SECAM_G, V4L2_STD_SECAM_H,
218 V4L2_STD_SECAM_K, V4L2_STD_SECAM_K1, V4L2_STD_SECAM_L, V4L2_STD_SECAM_LC,
219 V4L2_STD_ATSC_8_VSB, V4L2_STD_ATSC_16_VSB,
221 static const char *const standards_vlc[] = { "", "ALL",
222 /* Pseudo standards */
223 "PAL", "PAL_BG", "PAL_DK",
226 "MTS", "525_60", "625_50",
229 /* Chroma-agnostic ITU standards (PAL/NTSC or PAL/SECAM) */
231 "GH", "DK", "BG", "MN",
233 /* Individual standards */
234 "PAL_B", "PAL_B1", "PAL_G", "PAL_H",
235 "PAL_I", "PAL_D", "PAL_D1", "PAL_K",
236 "PAL_M", "PAL_N", "PAL_Nc", "PAL_60",
237 "NTSC_M", "NTSC_M_JP", "NTSC_443", "NTSC_M_KR",
238 "SECAM_B", "SECAM_D", "SECAM_G", "SECAM_H",
239 "SECAM_K", "SECAM_K1", "SECAM_L", "SECAM_LC",
240 "ATSC_8_VSB", "ATSC_16_VSB",
242 static const char *const standards_user[] = { N_("Undefined"), N_("All"),
243 "PAL", "PAL B/G", "PAL D/K",
245 "SECAM", "SECAM D/K",
246 N_("Multichannel television sound (MTS)"),
247 N_("525 lines / 60 Hz"), N_("625 lines / 50 Hz"),
250 "PAL/SECAM B", "PAL/SECAM G", "PAL/SECAM H", "PAL/SECAM L",
251 "PAL/SECAM G/H", "PAL/SECAM D/K", "PAL/SECAM B/G", "PAL/NTSC M/N",
253 "PAL B", "PAL B1", "PAL G", "PAL H",
254 "PAL I", "PAL D", "PAL D1", "PAL K",
255 "PAL M", "PAL N", N_("PAL N Argentina"), "PAL 60",
256 "NTSC M", N_("NTSC M Japan"), "NTSC 443", N_("NTSC M South Korea"),
257 "SECAM B", "SECAM D", "SECAM G", "SECAM H",
258 "SECAM K", "SECAM K1", "SECAM L", "SECAM L/C",
259 "ATSC 8-VSB", "ATSC 16-VSB",
262 static const int i_tuner_audio_modes_list[] = {
263 V4L2_TUNER_MODE_MONO, V4L2_TUNER_MODE_STEREO,
264 V4L2_TUNER_MODE_LANG1, V4L2_TUNER_MODE_LANG2, V4L2_TUNER_MODE_LANG1_LANG2
266 static const char *const psz_tuner_audio_modes_list_text[] = {
269 N_("Primary language"),
270 N_("Secondary language or program"),
275 set_shortname( N_("V4L") )
276 set_description( N_("Video4Linux input") )
277 set_category( CAT_INPUT )
278 set_subcategory( SUBCAT_INPUT_ACCESS )
280 set_section( N_( "Video input" ), NULL )
281 add_loadfile( CFG_PREFIX "dev", "/dev/video0",
282 VIDEO_DEVICE_TEXT, VIDEO_DEVICE_LONGTEXT, false )
285 add_loadfile( CFG_PREFIX "vbidev", NULL,
286 VBI_DEVICE_TEXT, VBI_DEVICE_LONGTEXT, false )
288 add_string( CFG_PREFIX "standard", "",
289 STANDARD_TEXT, STANDARD_LONGTEXT, false )
290 change_string_list( standards_vlc, standards_user )
292 add_string( CFG_PREFIX "chroma", NULL, CHROMA_TEXT, CHROMA_LONGTEXT,
295 add_integer( CFG_PREFIX "input", 0, INPUT_TEXT, INPUT_LONGTEXT,
297 change_integer_range( 0, 0xFFFFFFFE )
299 add_integer( CFG_PREFIX "audio-input", -1, AUDIO_INPUT_TEXT,
300 AUDIO_INPUT_LONGTEXT, true )
301 change_integer_range( -1, 0xFFFFFFFE )
303 add_obsolete_integer( CFG_PREFIX "io" ) /* since 2.0.0 */
304 add_integer( CFG_PREFIX "width", 0, WIDTH_TEXT, SIZE_LONGTEXT, false )
305 change_integer_range( 0, VOUT_MAX_WIDTH )
307 add_integer( CFG_PREFIX "height", 0, HEIGHT_TEXT, SIZE_LONGTEXT, false )
308 change_integer_range( 0, VOUT_MAX_WIDTH )
310 add_string( CFG_PREFIX "aspect-ratio", "4:3", ASPECT_TEXT,
311 ASPECT_LONGTEXT, true )
313 add_string( CFG_PREFIX "fps", "60", FPS_TEXT, FPS_LONGTEXT, false )
315 add_obsolete_bool( CFG_PREFIX "use-libv4l2" ) /* since 2.1.0 */
317 set_section( N_( "Tuner" ), NULL )
318 add_loadfile( CFG_PREFIX "radio-dev", "/dev/radio0",
319 RADIO_DEVICE_TEXT, RADIO_DEVICE_LONGTEXT, false )
321 add_obsolete_integer( CFG_PREFIX "tuner" ) /* since 2.1.0 */
322 add_integer( CFG_PREFIX "tuner-frequency", -1, FREQUENCY_TEXT,
323 FREQUENCY_LONGTEXT, true )
324 change_integer_range( -1, 0xFFFFFFFE )
326 add_integer( CFG_PREFIX "tuner-audio-mode", V4L2_TUNER_MODE_LANG1,
327 TUNER_AUDIO_MODE_TEXT, TUNER_AUDIO_MODE_LONGTEXT, true )
328 change_integer_list( i_tuner_audio_modes_list,
329 psz_tuner_audio_modes_list_text )
332 set_section( N_( "Controls" ),
333 N_( "Video capture controls (if supported by the device)" ) )
334 add_bool( CFG_PREFIX "controls-reset", false, CTRL_RESET_TEXT,
335 CTRL_RESET_LONGTEXT, true )
337 add_integer( CFG_PREFIX "brightness", -1, BRIGHTNESS_TEXT,
338 BRIGHTNESS_LONGTEXT, true )
339 add_integer( CFG_PREFIX "brightness-auto", -1,
340 BRIGHTNESS_AUTO_TEXT, BRIGHTNESS_AUTO_LONGTEXT, true )
341 change_integer_list( tristate_vlc, tristate_user )
342 add_integer( CFG_PREFIX "contrast", -1, CONTRAST_TEXT,
343 CONTRAST_LONGTEXT, true )
344 add_integer( CFG_PREFIX "saturation", -1, SATURATION_TEXT,
345 SATURATION_LONGTEXT, true )
346 add_integer( CFG_PREFIX "hue", -1, HUE_TEXT,
348 add_integer( CFG_PREFIX "hue-auto", -1,
349 HUE_AUTO_TEXT, HUE_AUTO_LONGTEXT, true )
350 change_integer_list( tristate_vlc, tristate_user )
351 add_obsolete_integer( CFG_PREFIX "black-level" ) /* since Linux 2.6.26 */
352 add_integer( CFG_PREFIX "white-balance-temperature", -1,
353 WHITE_BALANCE_TEMP_TEXT, WHITE_BALANCE_TEMP_LONGTEXT, true )
354 /* Ideally, the range should be 2800-6500 */
355 change_integer_range( -1, 6500 )
356 add_integer( CFG_PREFIX "auto-white-balance", -1,
357 AUTOWHITEBALANCE_TEXT, AUTOWHITEBALANCE_LONGTEXT, true )
358 change_integer_list( tristate_vlc, tristate_user )
359 add_obsolete_integer( CFG_PREFIX"do-white-balance" ) /* since 2.0.0 */
360 add_integer( CFG_PREFIX "red-balance", -1, REDBALANCE_TEXT,
361 REDBALANCE_LONGTEXT, true )
362 add_integer( CFG_PREFIX "blue-balance", -1, BLUEBALANCE_TEXT,
363 BLUEBALANCE_LONGTEXT, true )
364 add_integer( CFG_PREFIX "gamma", -1, GAMMA_TEXT,
365 GAMMA_LONGTEXT, true )
366 add_integer( CFG_PREFIX "autogain", -1, AUTOGAIN_TEXT,
367 AUTOGAIN_LONGTEXT, true )
368 change_integer_list( tristate_vlc, tristate_user )
369 add_integer( CFG_PREFIX "gain", -1, GAIN_TEXT,
370 GAIN_LONGTEXT, true )
371 add_integer( CFG_PREFIX "sharpness", -1,
372 SHARPNESS_TEXT, SHARPNESS_LONGTEXT, true )
373 add_integer( CFG_PREFIX "chroma-gain", -1,
374 CHROMA_GAIN_TEXT, CHROMA_GAIN_LONGTEXT, true )
375 add_integer( CFG_PREFIX "chroma-gain-auto", -1,
376 CHROMA_GAIN_AUTO_TEXT, CHROMA_GAIN_AUTO_LONGTEXT, true )
377 add_integer( CFG_PREFIX"power-line-frequency", -1,
378 POWER_FREQ_TEXT, POWER_FREQ_LONGTEXT, true )
379 change_integer_list( power_freq_vlc, power_freq_user )
380 add_integer( CFG_PREFIX"backlight-compensation", -1,
381 BKLT_COMPENSATE_TEXT, BKLT_COMPENSATE_LONGTEXT, true )
382 add_integer( CFG_PREFIX "band-stop-filter", -1,
383 BAND_STOP_FILTER_TEXT, BAND_STOP_FILTER_LONGTEXT, true )
384 add_bool( CFG_PREFIX "hflip", false, HFLIP_TEXT, HFLIP_LONGTEXT, true )
385 add_bool( CFG_PREFIX "vflip", false, VFLIP_TEXT, VFLIP_LONGTEXT, true )
386 add_integer( CFG_PREFIX "rotate", -1, ROTATE_TEXT, ROTATE_LONGTEXT, true )
387 change_integer_range( -1, 359 )
388 add_obsolete_integer( CFG_PREFIX "hcenter" ) /* since Linux 2.6.26 */
389 add_obsolete_integer( CFG_PREFIX "vcenter" ) /* since Linux 2.6.26 */
390 add_integer( CFG_PREFIX"color-killer", -1,
391 COLOR_KILLER_TEXT, COLOR_KILLER_LONGTEXT, true )
392 change_integer_list( tristate_vlc, tristate_user )
393 add_integer( CFG_PREFIX"color-effect", -1,
394 COLOR_EFFECT_TEXT, COLOR_EFFECT_LONGTEXT, true )
395 change_integer_list( colorfx_vlc, colorfx_user )
397 add_integer( CFG_PREFIX "audio-volume", -1, AUDIO_VOLUME_TEXT,
398 AUDIO_VOLUME_LONGTEXT, true )
399 add_integer( CFG_PREFIX "audio-balance", -1, AUDIO_BALANCE_TEXT,
400 AUDIO_BALANCE_LONGTEXT, true )
401 add_bool( CFG_PREFIX "audio-mute", false, AUDIO_MUTE_TEXT,
402 AUDIO_MUTE_LONGTEXT, true )
403 add_integer( CFG_PREFIX "audio-bass", -1, AUDIO_BASS_TEXT,
404 AUDIO_BASS_LONGTEXT, true )
405 add_integer( CFG_PREFIX "audio-treble", -1, AUDIO_TREBLE_TEXT,
406 AUDIO_TREBLE_LONGTEXT, true )
407 add_bool( CFG_PREFIX "audio-loudness", false, AUDIO_LOUDNESS_TEXT,
408 AUDIO_LOUDNESS_LONGTEXT, true )
409 add_string( CFG_PREFIX "set-ctrls", NULL, S_CTRLS_TEXT,
410 S_CTRLS_LONGTEXT, true )
413 add_obsolete_string( CFG_PREFIX "adev" )
414 add_obsolete_integer( CFG_PREFIX "audio-method" )
415 add_obsolete_bool( CFG_PREFIX "stereo" )
416 add_obsolete_integer( CFG_PREFIX "samplerate" )
418 add_shortcut( "v4l", "v4l2" )
419 set_capability( "access_demux", 0 )
420 set_callbacks( DemuxOpen, DemuxClose )
423 add_shortcut( "v4l", "v4l2", "v4l2c" )
424 set_description( N_("Video4Linux compressed A/V input") )
425 set_capability( "access", 0 )
426 /* use these when open as access_demux fails; VLC will use another demux */
427 set_callbacks( AccessOpen, AccessClose )
430 add_shortcut ("radio" /*, "fm", "am" */)
431 set_description (N_("Video4Linux radio tuner"))
432 set_capability ("access_demux", 0)
433 set_callbacks (RadioOpen, RadioClose)
438 * Parses a V4L2 MRL into VLC object variables.
440 void ParseMRL( vlc_object_t *obj, const char *mrl )
442 const char *p = strchr( mrl, ':' );
447 var_LocationParse( obj, p + 1, CFG_PREFIX );
449 dev = strndup( mrl, p - mrl );
459 var_Create( obj, CFG_PREFIX"dev", VLC_VAR_STRING );
460 var_SetString( obj, CFG_PREFIX"dev", dev );
465 int OpenDevice (vlc_object_t *obj, const char *path, uint32_t *restrict caps)
467 msg_Dbg (obj, "opening device '%s'", path);
469 int rawfd = vlc_open (path, O_RDWR);
472 msg_Err (obj, "cannot open device '%s': %s", path,
473 vlc_strerror_c(errno));
477 int fd = v4l2_fd_open (rawfd, 0);
480 msg_Warn (obj, "cannot initialize user-space library: %s",
481 vlc_strerror_c(errno));
482 /* fallback to direct kernel mode anyway */
486 /* Get device capabilites */
487 struct v4l2_capability cap;
488 if (v4l2_ioctl (fd, VIDIOC_QUERYCAP, &cap) < 0)
490 msg_Err (obj, "cannot get device capabilities: %s",
491 vlc_strerror_c(errno));
496 msg_Dbg (obj, "device %s using driver %s (version %u.%u.%u) on %s",
497 cap.card, cap.driver, (cap.version >> 16) & 0xFF,
498 (cap.version >> 8) & 0xFF, cap.version & 0xFF, cap.bus_info);
500 if (cap.capabilities & V4L2_CAP_DEVICE_CAPS)
502 msg_Dbg (obj, " with capabilities 0x%08"PRIX32" "
503 "(overall 0x%08"PRIX32")", cap.device_caps, cap.capabilities);
504 *caps = cap.device_caps;
508 msg_Dbg (obj, " with unknown capabilities "
509 "(overall 0x%08"PRIX32")", cap.capabilities);
510 *caps = cap.capabilities;
515 v4l2_std_id var_InheritStandard (vlc_object_t *obj, const char *varname)
517 char *name = var_InheritString (obj, varname);
519 return V4L2_STD_UNKNOWN;
521 const size_t n = sizeof (standards_vlc) / sizeof (*standards_vlc);
523 static_assert (sizeof (standards_vlc) / sizeof (*standards_vlc)
524 == sizeof (standards_v4l2) / sizeof (*standards_v4l2),
525 "Inconsistent standards tables");
526 static_assert (sizeof (standards_vlc) / sizeof (*standards_vlc)
527 == sizeof (standards_user) / sizeof (*standards_user),
528 "Inconsistent standards tables");
530 for (size_t i = 0; i < n; i++)
531 if (strcasecmp (name, standards_vlc[i]) == 0)
534 return standards_v4l2[i];
537 /* Backward compatibility with old versions using V4L2 magic numbers */
539 v4l2_std_id std = strtoull (name, &end, 0);
542 msg_Err (obj, "unknown video standard \"%s\"", name);
543 std = V4L2_STD_UNKNOWN;