1 /*****************************************************************************
2 * v4l2.c : Video4Linux2 input module for vlc
3 *****************************************************************************
4 * Copyright (C) 2002-2009 the VideoLAN team
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
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 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 General Public License for more details.
22 * You should have received a copy of the GNU General Public License
23 * along with this program; if not, write to the Free Software
24 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
25 *****************************************************************************/
28 * Sections based on the reference V4L2 capture example at
29 * http://v4l2spec.bytesex.org/spec/capture-example.html
32 /*****************************************************************************
34 *****************************************************************************/
40 #include <vlc_common.h>
41 #include <vlc_plugin.h>
42 #include <vlc_access.h>
43 #include <vlc_demux.h>
44 #include <vlc_input.h>
49 #include <sys/ioctl.h>
52 #include <linux/videodev2.h>
60 /*****************************************************************************
62 *****************************************************************************/
64 static int DemuxOpen ( vlc_object_t * );
65 static void DemuxClose( vlc_object_t * );
66 static int AccessOpen ( vlc_object_t * );
67 static void AccessClose( vlc_object_t * );
69 #define STANDARD_TEXT N_( "Standard" )
70 #define STANDARD_LONGTEXT N_( \
71 "Video standard (Default, SECAM, PAL, or NTSC)." )
72 #define CHROMA_TEXT N_("Video input chroma format")
73 #define CHROMA_LONGTEXT N_( \
74 "Force the Video4Linux2 video device to use a specific chroma format " \
75 "(eg. I420 or I422 for raw images, MJPG for M-JPEG compressed input) " \
76 "(Complete list: GREY, I240, RV16, RV15, RV24, RV32, YUY2, YUYV, UYVY, " \
77 "I41N, I422, I420, I411, I410, MJPG)")
78 #define INPUT_TEXT N_( "Input" )
79 #define INPUT_LONGTEXT N_( \
80 "Input of the card to use (see debug)." )
81 #define AUDIO_INPUT_TEXT N_( "Audio input" )
82 #define AUDIO_INPUT_LONGTEXT N_( \
83 "Audio input of the card to use (see debug)." )
84 #define IOMETHOD_TEXT N_( "IO Method" )
85 #define IOMETHOD_LONGTEXT N_( \
86 "IO Method (READ, MMAP, USERPTR)." )
87 #define WIDTH_TEXT N_( "Width" )
88 #define WIDTH_LONGTEXT N_( \
89 "Force width (-1 for autodetect, 0 for driver default)." )
90 #define HEIGHT_TEXT N_( "Height" )
91 #define HEIGHT_LONGTEXT N_( \
92 "Force height (-1 for autodetect, 0 for driver default)." )
93 #define FPS_TEXT N_( "Framerate" )
94 #define FPS_LONGTEXT N_( "Framerate to capture, if applicable " \
95 "(0 for autodetect)." )
98 #define LIBV4L2_TEXT N_( "Use libv4l2" )
99 #define LIBV4L2_LONGTEXT N_( \
100 "Force usage of the libv4l2 wrapper." )
103 #define CTRL_RESET_TEXT N_( "Reset v4l2 controls" )
104 #define CTRL_RESET_LONGTEXT N_( \
105 "Reset controls to defaults provided by the v4l2 driver." )
106 #define BRIGHTNESS_TEXT N_( "Brightness" )
107 #define BRIGHTNESS_LONGTEXT N_( \
108 "Brightness of the video input (if supported by the v4l2 driver)." )
109 #define CONTRAST_TEXT N_( "Contrast" )
110 #define CONTRAST_LONGTEXT N_( \
111 "Contrast of the video input (if supported by the v4l2 driver)." )
112 #define SATURATION_TEXT N_( "Saturation" )
113 #define SATURATION_LONGTEXT N_( \
114 "Saturation of the video input (if supported by the v4l2 driver)." )
115 #define HUE_TEXT N_( "Hue" )
116 #define HUE_LONGTEXT N_( \
117 "Hue of the video input (if supported by the v4l2 driver)." )
118 #define BLACKLEVEL_TEXT N_( "Black level" )
119 #define BLACKLEVEL_LONGTEXT N_( \
120 "Black level of the video input (if supported by the v4l2 driver)." )
121 #define AUTOWHITEBALANCE_TEXT N_( "Auto white balance" )
122 #define AUTOWHITEBALANCE_LONGTEXT N_( \
123 "Automatically set the white balance of the video input " \
124 "(if supported by the v4l2 driver)." )
125 #define DOWHITEBALANCE_TEXT N_( "Do white balance" )
126 #define DOWHITEBALANCE_LONGTEXT N_( \
127 "Trigger a white balancing action, useless if auto white balance is " \
128 "activated (if supported by the v4l2 driver)." )
129 #define REDBALANCE_TEXT N_( "Red balance" )
130 #define REDBALANCE_LONGTEXT N_( \
131 "Red balance of the video input (if supported by the v4l2 driver)." )
132 #define BLUEBALANCE_TEXT N_( "Blue balance" )
133 #define BLUEBALANCE_LONGTEXT N_( \
134 "Blue balance of the video input (if supported by the v4l2 driver)." )
135 #define GAMMA_TEXT N_( "Gamma" )
136 #define GAMMA_LONGTEXT N_( \
137 "Gamma of the video input (if supported by the v4l2 driver)." )
138 #define EXPOSURE_TEXT N_( "Exposure" )
139 #define EXPOSURE_LONGTEXT N_( \
140 "Exposure of the video input (if supported by the v4L2 driver)." )
141 #define AUTOGAIN_TEXT N_( "Auto gain" )
142 #define AUTOGAIN_LONGTEXT N_( \
143 "Automatically set the video input's gain (if supported by the " \
145 #define GAIN_TEXT N_( "Gain" )
146 #define GAIN_LONGTEXT N_( \
147 "Video input's gain (if supported by the v4l2 driver)." )
148 #define HFLIP_TEXT N_( "Horizontal flip" )
149 #define HFLIP_LONGTEXT N_( \
150 "Flip the video horizontally (if supported by the v4l2 driver)." )
151 #define VFLIP_TEXT N_( "Vertical flip" )
152 #define VFLIP_LONGTEXT N_( \
153 "Flip the video vertically (if supported by the v4l2 driver)." )
154 #define HCENTER_TEXT N_( "Horizontal centering" )
155 #define HCENTER_LONGTEXT N_( \
156 "Set the camera's horizontal centering (if supported by the v4l2 driver)." )
157 #define VCENTER_TEXT N_( "Vertical centering" )
158 #define VCENTER_LONGTEXT N_( \
159 "Set the camera's vertical centering (if supported by the v4l2 driver)." )
161 #define AUDIO_VOLUME_TEXT N_( "Volume" )
162 #define AUDIO_VOLUME_LONGTEXT N_( \
163 "Volume of the audio input (if supported by the v4l2 driver)." )
164 #define AUDIO_BALANCE_TEXT N_( "Balance" )
165 #define AUDIO_BALANCE_LONGTEXT N_( \
166 "Balance of the audio input (if supported by the v4l2 driver)." )
167 #define AUDIO_MUTE_TEXT N_( "Mute" )
168 #define AUDIO_MUTE_LONGTEXT N_( \
169 "Mute audio input (if supported by the v4l2 driver)." )
170 #define AUDIO_BASS_TEXT N_( "Bass" )
171 #define AUDIO_BASS_LONGTEXT N_( \
172 "Bass level of the audio input (if supported by the v4l2 driver)." )
173 #define AUDIO_TREBLE_TEXT N_( "Treble" )
174 #define AUDIO_TREBLE_LONGTEXT N_( \
175 "Treble level of the audio input (if supported by the v4l2 driver)." )
176 #define AUDIO_LOUDNESS_TEXT N_( "Loudness" )
177 #define AUDIO_LOUDNESS_LONGTEXT N_( \
178 "Loudness of the audio input (if supported by the v4l2 driver)." )
180 #define CACHING_TEXT N_("Caching value in ms")
181 #define CACHING_LONGTEXT N_( \
182 "Caching value for V4L2 captures. This " \
183 "value should be set in milliseconds." )
184 #define S_CTRLS_TEXT N_("v4l2 driver controls")
185 #define S_CTRLS_LONGTEXT N_( \
186 "Set the v4l2 driver controls to the values specified using a comma " \
187 "separated list optionally encapsulated by curly braces " \
188 "(e.g.: {video_bitrate=6000000,audio_crc=0,stream_type=3} ). " \
189 "To list available controls, increase verbosity (-vvv) " \
190 "or use the v4l2-ctl application." )
192 #define TUNER_TEXT N_("Tuner id")
193 #define TUNER_LONGTEXT N_( \
194 "Tuner id (see debug output)." )
195 #define FREQUENCY_TEXT N_("Frequency")
196 #define FREQUENCY_LONGTEXT N_( \
197 "Tuner frequency in Hz or kHz (see debug output)" )
198 #define TUNER_AUDIO_MODE_TEXT N_("Audio mode")
199 #define TUNER_AUDIO_MODE_LONGTEXT N_( \
200 "Tuner audio mono/stereo and track selection." )
202 #define AUDIO_DEPRECATED_ERROR N_( \
203 "Alsa or OSS audio capture in the v4l2 access is deprecated. " \
204 "please use 'v4l2:/""/ :input-slave=alsa:/""/' or " \
205 "'v4l2:/""/ :input-slave=oss:/""/' instead." )
207 #define ASPECT_TEXT N_("Picture aspect-ratio n:m")
208 #define ASPECT_LONGTEXT N_("Define input picture aspect-ratio to use. Default is 4:3" )
216 static const int i_standards_list[] =
217 { V4L2_STD_UNKNOWN, V4L2_STD_SECAM, V4L2_STD_PAL, V4L2_STD_NTSC };
218 static const char *const psz_standards_list_text[] =
219 { N_("Default"), N_("SECAM"), N_("PAL"), N_("NTSC") };
221 static const int i_iomethod_list[] =
222 { IO_METHOD_READ, IO_METHOD_MMAP, IO_METHOD_USERPTR };
223 static const char *const psz_iomethod_list_text[] =
224 { N_("READ"), N_("MMAP"), N_("USERPTR") };
226 static const int i_tuner_audio_modes_list[] =
227 { V4L2_TUNER_MODE_MONO, V4L2_TUNER_MODE_STEREO,
228 V4L2_TUNER_MODE_LANG1, V4L2_TUNER_MODE_LANG2,
229 V4L2_TUNER_MODE_SAP, V4L2_TUNER_MODE_LANG1_LANG2 };
230 static const char *const psz_tuner_audio_modes_list_text[] =
233 N_( "Primary language (Analog TV tuners only)" ),
234 N_( "Secondary language (Analog TV tuners only)" ),
235 N_( "Second audio program (Analog TV tuners only)" ),
236 N_( "Primary language left, Secondary language right" ) };
238 #define V4L2_DEFAULT "/dev/video0"
239 #define CFG_PREFIX "v4l2-"
242 set_shortname( N_("Video4Linux2") )
243 set_description( N_("Video4Linux2 input") )
244 set_category( CAT_INPUT )
245 set_subcategory( SUBCAT_INPUT_ACCESS )
247 set_section( N_( "Video input" ), NULL )
248 add_integer( CFG_PREFIX "standard", 0, NULL, STANDARD_TEXT,
249 STANDARD_LONGTEXT, false )
250 change_integer_list( i_standards_list, psz_standards_list_text, NULL )
251 add_string( CFG_PREFIX "chroma", NULL, NULL, CHROMA_TEXT, CHROMA_LONGTEXT,
253 add_integer( CFG_PREFIX "input", 0, NULL, INPUT_TEXT, INPUT_LONGTEXT,
255 add_integer( CFG_PREFIX "audio-input", 0, NULL, AUDIO_INPUT_TEXT,
256 AUDIO_INPUT_LONGTEXT, true )
257 add_integer( CFG_PREFIX "io", IO_METHOD_MMAP, NULL, IOMETHOD_TEXT,
258 IOMETHOD_LONGTEXT, true )
259 change_integer_list( i_iomethod_list, psz_iomethod_list_text, NULL )
260 add_integer( CFG_PREFIX "width", -1, NULL, WIDTH_TEXT,
261 WIDTH_LONGTEXT, true )
262 add_integer( CFG_PREFIX "height", -1, NULL, HEIGHT_TEXT,
263 HEIGHT_LONGTEXT, true )
264 add_string( CFG_PREFIX "aspect-ratio", "4:3", NULL, ASPECT_TEXT,
265 ASPECT_LONGTEXT, true )
266 add_float( CFG_PREFIX "fps", 0, NULL, FPS_TEXT, FPS_LONGTEXT, true )
267 add_integer( CFG_PREFIX "caching", DEFAULT_PTS_DELAY / 1000, NULL,
268 CACHING_TEXT, CACHING_LONGTEXT, true )
270 add_bool( CFG_PREFIX "use-libv4l2", false, NULL, LIBV4L2_TEXT, LIBV4L2_LONGTEXT, true );
273 set_section( N_( "Tuner" ), NULL )
274 add_integer( CFG_PREFIX "tuner", 0, NULL, TUNER_TEXT, TUNER_LONGTEXT,
276 add_integer( CFG_PREFIX "tuner-frequency", -1, NULL, FREQUENCY_TEXT,
277 FREQUENCY_LONGTEXT, true )
278 add_integer( CFG_PREFIX "tuner-audio-mode", -1, NULL, TUNER_AUDIO_MODE_TEXT,
279 TUNER_AUDIO_MODE_LONGTEXT, true )
280 change_integer_list( i_tuner_audio_modes_list,
281 psz_tuner_audio_modes_list_text, 0 )
283 set_section( N_( "Controls" ),
284 N_( "v4l2 driver controls, if supported by your v4l2 driver." ) )
285 add_bool( CFG_PREFIX "controls-reset", false, NULL, CTRL_RESET_TEXT,
286 CTRL_RESET_LONGTEXT, true )
287 add_integer( CFG_PREFIX "brightness", -1, NULL, BRIGHTNESS_TEXT,
288 BRIGHTNESS_LONGTEXT, true )
289 add_integer( CFG_PREFIX "contrast", -1, NULL, CONTRAST_TEXT,
290 CONTRAST_LONGTEXT, true )
291 add_integer( CFG_PREFIX "saturation", -1, NULL, SATURATION_TEXT,
292 SATURATION_LONGTEXT, true )
293 add_integer( CFG_PREFIX "hue", -1, NULL, HUE_TEXT,
295 add_integer( CFG_PREFIX "black-level", -1, NULL, BLACKLEVEL_TEXT,
296 BLACKLEVEL_LONGTEXT, true )
297 add_integer( CFG_PREFIX "auto-white-balance", -1, NULL,
298 AUTOWHITEBALANCE_TEXT, AUTOWHITEBALANCE_LONGTEXT, true )
299 add_integer( CFG_PREFIX "do-white-balance", -1, NULL, DOWHITEBALANCE_TEXT,
300 DOWHITEBALANCE_LONGTEXT, true )
301 add_integer( CFG_PREFIX "red-balance", -1, NULL, REDBALANCE_TEXT,
302 REDBALANCE_LONGTEXT, true )
303 add_integer( CFG_PREFIX "blue-balance", -1, NULL, BLUEBALANCE_TEXT,
304 BLUEBALANCE_LONGTEXT, true )
305 add_integer( CFG_PREFIX "gamma", -1, NULL, GAMMA_TEXT,
306 GAMMA_LONGTEXT, true )
307 add_integer( CFG_PREFIX "exposure", -1, NULL, EXPOSURE_TEXT,
308 EXPOSURE_LONGTEXT, true )
309 add_integer( CFG_PREFIX "autogain", -1, NULL, AUTOGAIN_TEXT,
310 AUTOGAIN_LONGTEXT, true )
311 add_integer( CFG_PREFIX "gain", -1, NULL, GAIN_TEXT,
312 GAIN_LONGTEXT, true )
313 add_integer( CFG_PREFIX "hflip", -1, NULL, HFLIP_TEXT,
314 HFLIP_LONGTEXT, true )
315 add_integer( CFG_PREFIX "vflip", -1, NULL, VFLIP_TEXT,
316 VFLIP_LONGTEXT, true )
317 add_integer( CFG_PREFIX "hcenter", -1, NULL, HCENTER_TEXT,
318 HCENTER_LONGTEXT, true )
319 add_integer( CFG_PREFIX "vcenter", -1, NULL, VCENTER_TEXT,
320 VCENTER_LONGTEXT, true )
321 add_integer( CFG_PREFIX "audio-volume", -1, NULL, AUDIO_VOLUME_TEXT,
322 AUDIO_VOLUME_LONGTEXT, true )
323 add_integer( CFG_PREFIX "audio-balance", -1, NULL, AUDIO_BALANCE_TEXT,
324 AUDIO_BALANCE_LONGTEXT, true )
325 add_bool( CFG_PREFIX "audio-mute", false, NULL, AUDIO_MUTE_TEXT,
326 AUDIO_MUTE_LONGTEXT, true )
327 add_integer( CFG_PREFIX "audio-bass", -1, NULL, AUDIO_BASS_TEXT,
328 AUDIO_BASS_LONGTEXT, true )
329 add_integer( CFG_PREFIX "audio-treble", -1, NULL, AUDIO_TREBLE_TEXT,
330 AUDIO_TREBLE_LONGTEXT, true )
331 add_integer( CFG_PREFIX "audio-loudness", -1, NULL, AUDIO_LOUDNESS_TEXT,
332 AUDIO_LOUDNESS_LONGTEXT, true )
333 add_string( CFG_PREFIX "set-ctrls", NULL, NULL, S_CTRLS_TEXT,
334 S_CTRLS_LONGTEXT, true )
336 add_obsolete_string( CFG_PREFIX "dev" )
338 add_obsolete_string( CFG_PREFIX "adev" )
339 add_obsolete_integer( CFG_PREFIX "audio-method" )
340 add_obsolete_bool( CFG_PREFIX "stereo" )
341 add_obsolete_integer( CFG_PREFIX "samplerate" )
343 add_shortcut( "v4l2" )
344 set_capability( "access_demux", 10 )
345 set_callbacks( DemuxOpen, DemuxClose )
348 add_shortcut( "v4l2" )
349 add_shortcut( "v4l2c" )
350 set_description( N_("Video4Linux2 Compressed A/V") )
351 set_capability( "access", 0 )
352 /* use these when open as access_demux fails; VLC will use another demux */
353 set_callbacks( AccessOpen, AccessClose )
357 /*****************************************************************************
358 * Access: local prototypes
359 *****************************************************************************/
361 static void CommonClose( vlc_object_t *, demux_sys_t * );
362 static void ParseMRL( demux_sys_t *, char *, vlc_object_t * );
363 static void GetV4L2Params( demux_sys_t *, vlc_object_t * );
364 static void SetAvailControlsByString( vlc_object_t *, demux_sys_t *, int );
366 static int DemuxControl( demux_t *, int, va_list );
367 static int AccessControl( access_t *, int, va_list );
369 static int Demux( demux_t * );
370 static block_t *AccessRead( access_t * );
372 static block_t* GrabVideo( vlc_object_t *p_demux, demux_sys_t *p_sys );
373 static block_t* ProcessVideoFrame( vlc_object_t *p_demux, uint8_t *p_frame, size_t );
375 static bool IsPixelFormatSupported( demux_t *p_demux,
376 unsigned int i_pixelformat );
378 static int OpenVideoDev( vlc_object_t *, demux_sys_t *, bool );
379 static bool ProbeVideoDev( vlc_object_t *, demux_sys_t *,
380 const char *psz_device );
382 static int ControlList( vlc_object_t *, demux_sys_t *, int , bool, bool );
383 static int Control( vlc_object_t *, demux_sys_t *, int i_fd,
384 const char *psz_name, int i_cid, int i_value );
386 static int DemuxControlCallback( vlc_object_t *p_this, const char *psz_var,
387 vlc_value_t oldval, vlc_value_t newval,
389 static int DemuxControlResetCallback( vlc_object_t *p_this, const char *psz_var,
390 vlc_value_t oldval, vlc_value_t newval,
392 static int AccessControlCallback( vlc_object_t *p_this, const char *psz_var,
393 vlc_value_t oldval, vlc_value_t newval,
395 static int AccessControlResetCallback( vlc_object_t *p_this,
396 const char *psz_var, vlc_value_t oldval,
397 vlc_value_t newval, void *p_data );
402 vlc_fourcc_t i_fourcc;
406 } v4l2chroma_to_fourcc[] =
409 { V4L2_PIX_FMT_GREY, VLC_CODEC_GREY, 0, 0, 0 },
410 { V4L2_PIX_FMT_HI240, VLC_FOURCC('I','2','4','0'), 0, 0, 0 },
411 { V4L2_PIX_FMT_RGB555, VLC_CODEC_RGB15, 0x001f,0x03e0,0x7c00 },
412 { V4L2_PIX_FMT_RGB565, VLC_CODEC_RGB16, 0x001f,0x07e0,0xf800 },
413 /* Won't work since we don't know how to handle such gmask values
415 { V4L2_PIX_FMT_RGB555X, VLC_CODEC_RGB15, 0x007c,0xe003,0x1f00 },
416 { V4L2_PIX_FMT_RGB565X, VLC_CODEC_RGB16, 0x00f8,0xe007,0x1f00 },
418 { V4L2_PIX_FMT_BGR24, VLC_CODEC_RGB24, 0xff0000,0xff00,0xff },
419 { V4L2_PIX_FMT_RGB24, VLC_CODEC_RGB24, 0xff,0xff00,0xff0000 },
420 { V4L2_PIX_FMT_BGR32, VLC_CODEC_RGB32, 0xff0000,0xff00,0xff },
421 { V4L2_PIX_FMT_RGB32, VLC_CODEC_RGB32, 0xff,0xff00,0xff0000 },
422 { V4L2_PIX_FMT_YUYV, VLC_CODEC_YUYV, 0, 0, 0 },
423 { V4L2_PIX_FMT_UYVY, VLC_CODEC_UYVY, 0, 0, 0 },
424 { V4L2_PIX_FMT_Y41P, VLC_FOURCC('I','4','1','N'), 0, 0, 0 },
425 { V4L2_PIX_FMT_YUV422P, VLC_CODEC_I422, 0, 0, 0 },
426 { V4L2_PIX_FMT_YVU420, VLC_CODEC_YV12, 0, 0, 0 },
427 { V4L2_PIX_FMT_YUV411P, VLC_CODEC_I411, 0, 0, 0 },
428 { V4L2_PIX_FMT_YUV410, VLC_CODEC_I410, 0, 0, 0 },
430 /* Raw data types, not in V4L2 spec but still in videodev2.h and supported
432 { V4L2_PIX_FMT_YUV420, VLC_CODEC_I420, 0, 0, 0 },
433 /* FIXME { V4L2_PIX_FMT_RGB444, VLC_CODEC_RGB32 }, */
435 /* Compressed data types */
436 { V4L2_PIX_FMT_MJPEG, VLC_CODEC_MJPG, 0, 0, 0 },
437 { V4L2_PIX_FMT_JPEG, VLC_CODEC_JPEG, 0, 0, 0 },
439 { V4L2_PIX_FMT_DV, VLC_FOURCC('?','?','?','?') },
440 { V4L2_PIX_FMT_MPEG, VLC_FOURCC('?','?','?','?') },
446 * List of V4L2 chromas were confident enough to use as fallbacks if the
447 * user hasn't provided a --v4l2-chroma value.
449 * Try YUV chromas first, then RGB little endian and MJPEG as last resort.
451 static const __u32 p_chroma_fallbacks[] =
452 { V4L2_PIX_FMT_YUV420, V4L2_PIX_FMT_YVU420, V4L2_PIX_FMT_YUV422P,
453 V4L2_PIX_FMT_YUYV, V4L2_PIX_FMT_UYVY, V4L2_PIX_FMT_BGR24,
454 V4L2_PIX_FMT_BGR32, V4L2_PIX_FMT_MJPEG, V4L2_PIX_FMT_JPEG };
458 const char *psz_name;
462 { "brightness", V4L2_CID_BRIGHTNESS },
463 { "contrast", V4L2_CID_CONTRAST },
464 { "saturation", V4L2_CID_SATURATION },
465 { "hue", V4L2_CID_HUE },
466 { "audio-volume", V4L2_CID_AUDIO_VOLUME },
467 { "audio-balance", V4L2_CID_AUDIO_BALANCE },
468 { "audio-bass", V4L2_CID_AUDIO_BASS },
469 { "audio-treble", V4L2_CID_AUDIO_TREBLE },
470 { "audio-mute", V4L2_CID_AUDIO_MUTE },
471 { "audio-loudness", V4L2_CID_AUDIO_LOUDNESS },
472 { "black-level", V4L2_CID_BLACK_LEVEL },
473 { "auto-white-balance", V4L2_CID_AUTO_WHITE_BALANCE },
474 { "do-white-balance", V4L2_CID_DO_WHITE_BALANCE },
475 { "red-balance", V4L2_CID_RED_BALANCE },
476 { "blue-balance", V4L2_CID_BLUE_BALANCE },
477 { "gamma", V4L2_CID_GAMMA },
478 { "exposure", V4L2_CID_EXPOSURE },
479 { "autogain", V4L2_CID_AUTOGAIN },
480 { "gain", V4L2_CID_GAIN },
481 { "hflip", V4L2_CID_HFLIP },
482 { "vflip", V4L2_CID_VFLIP },
483 { "hcenter", V4L2_CID_HCENTER },
484 { "vcenter", V4L2_CID_VCENTER },
496 char *psz_device; /* Main device from MRL */
499 char *psz_requested_chroma;
506 struct v4l2_capability dev_cap;
509 struct v4l2_input *p_inputs;
510 int i_selected_input;
513 struct v4l2_standard *p_standards;
514 v4l2_std_id i_selected_standard_id;
517 /* V4L2 devices cannot have more than 32 audio inputs */
518 struct v4l2_audio p_audios[32];
519 int i_selected_audio_input;
522 struct v4l2_tuner *p_tuners;
525 struct v4l2_fmtdesc *p_codecs;
527 struct buffer_t *p_buffers;
528 unsigned int i_nbuffers;
532 unsigned int i_aspect;
533 float f_fps; /* <= 0.0 mean to grab at full rate */
534 mtime_t i_video_pts; /* only used when f_fps > 0 */
550 int (*pf_close)( int );
551 int (*pf_dup)( int );
552 int (*pf_ioctl)( int, unsigned long int, ... );
553 ssize_t (*pf_read)( int, void *, size_t );
554 void *(*pf_mmap)( void *, size_t, int, int, int, off_t );
555 int (*pf_munmap)( void *, size_t );
561 static void use_kernel_v4l2( demux_sys_t *p_sys )
563 p_sys->pf_close = close;
565 p_sys->pf_ioctl = ioctl;
566 p_sys->pf_read = read;
567 p_sys->pf_mmap = mmap;
568 p_sys->pf_munmap = munmap;
569 p_sys->b_libv4l2 = false;
572 static void use_libv4l2( demux_sys_t *p_sys )
574 p_sys->pf_close = v4l2_close;
575 p_sys->pf_dup = v4l2_dup;
576 p_sys->pf_ioctl = v4l2_ioctl;
577 p_sys->pf_read = v4l2_read;
578 p_sys->pf_mmap = v4l2_mmap;
579 p_sys->pf_munmap = v4l2_munmap;
580 p_sys->b_libv4l2 = true;
583 # define v4l2_close (p_sys->pf_close)
584 # define v4l2_dup (p_sys->pf_dup)
585 # define v4l2_ioctl (p_sys->pf_ioctl)
586 # define v4l2_read (p_sys->pf_read)
587 # define v4l2_mmap (p_sys->pf_mmap)
588 # define v4l2_munmap (p_sys->pf_munmap)
590 # define v4l2_close close
591 # define v4l2_dup dup
592 # define v4l2_ioctl ioctl
593 # define v4l2_read read
594 # define v4l2_mmap mmap
595 # define v4l2_munmap munmap
598 static int FindMainDevice( vlc_object_t *p_this, demux_sys_t *p_sys,
601 /* TODO: if using default device, loop through all /dev/video* until
603 msg_Dbg( p_this, "opening device '%s'", p_sys->psz_device );
604 if( ProbeVideoDev( p_this, p_sys, p_sys->psz_device ) )
606 msg_Dbg( p_this, "'%s' is a video device", p_sys->psz_device );
607 p_sys->i_fd = OpenVideoDev( p_this, p_sys, b_demux );
610 if( p_sys->i_fd < 0 ) return VLC_EGENERIC;
614 /*****************************************************************************
615 * DemuxOpen: opens v4l2 device, access_demux callback
616 *****************************************************************************
618 * url: <video device>::::
620 *****************************************************************************/
621 static int DemuxOpen( vlc_object_t *p_this )
623 demux_t *p_demux = (demux_t*)p_this;
626 /* Only when selected */
627 if( strcmp( p_demux->psz_access, "v4l2" ) )
631 p_demux->pf_control = DemuxControl;
632 p_demux->pf_demux = Demux;
633 p_demux->info.i_update = 0;
634 p_demux->info.i_title = 0;
635 p_demux->info.i_seekpoint = 0;
637 p_demux->p_sys = p_sys = calloc( 1, sizeof( demux_sys_t ) );
638 if( p_sys == NULL ) return VLC_ENOMEM;
640 GetV4L2Params(p_sys, (vlc_object_t *) p_demux);
642 ParseMRL( p_sys, p_demux->psz_path, (vlc_object_t *) p_demux );
645 if( !config_GetInt( p_this, CFG_PREFIX "use-libv4l2" ) )
647 msg_Dbg( p_this, "Trying direct kernel v4l2" );
648 use_kernel_v4l2( p_sys );
649 if( FindMainDevice( p_this, p_sys, true ) == VLC_SUCCESS)
653 msg_Dbg( p_this, "Trying libv4l2 wrapper" );
654 use_libv4l2( p_sys );
656 if( FindMainDevice( p_this, p_sys, true ) == VLC_SUCCESS)
659 DemuxClose( p_this );
663 /*****************************************************************************
664 * GetV4L2Params: fill in p_sys parameters (shared by DemuxOpen and AccessOpen)
665 *****************************************************************************/
666 static void GetV4L2Params( demux_sys_t *p_sys, vlc_object_t *p_obj )
668 p_sys->i_video_pts = -1;
670 p_sys->i_selected_standard_id =
671 i_standards_list[var_CreateGetInteger( p_obj, "v4l2-standard" )];
673 p_sys->i_selected_input = var_CreateGetInteger( p_obj, "v4l2-input" );
674 p_sys->i_selected_audio_input =
675 var_CreateGetInteger( p_obj, "v4l2-audio-input" );
677 p_sys->io = var_CreateGetInteger( p_obj, "v4l2-io" );
679 p_sys->i_width = var_CreateGetInteger( p_obj, "v4l2-width" );
680 p_sys->i_height = var_CreateGetInteger( p_obj, "v4l2-height" );
682 var_Create( p_obj, "v4l2-controls-reset", VLC_VAR_BOOL | VLC_VAR_DOINHERIT );
684 p_sys->f_fps = var_CreateGetFloat( p_obj, "v4l2-fps" );
685 p_sys->psz_requested_chroma = var_CreateGetString( p_obj, "v4l2-chroma" );
687 p_sys->i_cache = var_CreateGetInteger( p_obj, "v4l2-caching" );
689 p_sys->i_cur_tuner = var_CreateGetInteger( p_obj, "v4l2-tuner" );
690 p_sys->i_frequency = var_CreateGetInteger( p_obj, "v4l2-tuner-frequency" );
691 p_sys->i_audio_mode = var_CreateGetInteger( p_obj, "v4l2-tuner-audio-mode" );
693 p_sys->psz_set_ctrls = var_CreateGetString( p_obj, "v4l2-set-ctrls" );
695 char *psz_aspect = var_CreateGetString( p_obj, "v4l2-aspect-ratio" );
696 if( psz_aspect && *psz_aspect && strchr( psz_aspect, ':' ) )
698 char *psz_delim = strchr( psz_aspect, ':' );
699 p_sys->i_aspect = atoi( psz_aspect ) * VOUT_ASPECT_FACTOR / atoi( psz_delim + 1 );
703 p_sys->i_aspect = 4 * VOUT_ASPECT_FACTOR / 3 ;
708 p_sys->psz_device = NULL;
714 /*****************************************************************************
715 * ParseMRL: parse the options contained in the MRL
716 *****************************************************************************/
717 static void ParseMRL( demux_sys_t *p_sys, char *psz_path, vlc_object_t *p_obj )
719 char *psz_dup = strdup( psz_path );
720 char *psz_parser = psz_dup;
722 while( *psz_parser && *psz_parser != ':' )
727 if( *psz_parser == ':' )
732 *psz_parser++ = '\0';
734 if( !strncmp( psz_parser, "standard=", strlen( "standard=" ) ) )
736 psz_parser += strlen( "standard=" );
737 if( !strncmp( psz_parser, "pal", strlen( "pal" ) ) )
739 p_sys->i_selected_standard_id = V4L2_STD_PAL;
740 psz_parser += strlen( "pal" );
742 else if( !strncmp( psz_parser, "ntsc", strlen( "ntsc" ) ) )
744 p_sys->i_selected_standard_id = V4L2_STD_NTSC;
745 psz_parser += strlen( "ntsc" );
747 else if( !strncmp( psz_parser, "secam", strlen( "secam" ) ) )
749 p_sys->i_selected_standard_id = V4L2_STD_SECAM;
750 psz_parser += strlen( "secam" );
752 else if( !strncmp( psz_parser, "default", strlen( "default" ) ) )
754 p_sys->i_selected_standard_id = V4L2_STD_UNKNOWN;
755 psz_parser += strlen( "default" );
759 p_sys->i_selected_standard_id = i_standards_list[strtol( psz_parser, &psz_parser, 0 )];
762 else if( !strncmp( psz_parser, "chroma=", strlen( "chroma=" ) ) )
766 psz_parser += strlen( "chroma=" );
767 if( strchr( psz_parser, ':' ) )
769 i_len = strchr( psz_parser, ':' ) - psz_parser;
773 i_len = strlen( psz_parser );
776 free( p_sys->psz_requested_chroma );
777 p_sys->psz_requested_chroma = strndup( psz_parser, i_len );
781 else if( !strncmp( psz_parser, "input=", strlen( "input=" ) ) )
783 p_sys->i_selected_input = strtol( psz_parser + strlen( "input=" ),
786 else if( !strncmp( psz_parser, "audio-input=", strlen( "audio-input=" ) ) )
788 p_sys->i_selected_audio_input = strtol( psz_parser + strlen( "audio-input=" ),
791 else if( !strncmp( psz_parser, "fps=", strlen( "fps=" ) ) )
793 p_sys->f_fps = strtof( psz_parser + strlen( "fps=" ),
796 else if( !strncmp( psz_parser, "io=", strlen( "io=" ) ) )
798 psz_parser += strlen( "io=" );
799 if( !strncmp( psz_parser, "read", strlen( "read" ) ) )
801 p_sys->io = IO_METHOD_READ;
802 psz_parser += strlen( "read" );
804 else if( !strncmp( psz_parser, "mmap", strlen( "mmap" ) ) )
806 p_sys->io = IO_METHOD_MMAP;
807 psz_parser += strlen( "mmap" );
809 else if( !strncmp( psz_parser, "userptr", strlen( "userptr" ) ) )
811 p_sys->io = IO_METHOD_USERPTR;
812 psz_parser += strlen( "userptr" );
816 p_sys->io = strtol( psz_parser, &psz_parser, 0 );
819 else if( !strncmp( psz_parser, "width=",
820 strlen( "width=" ) ) )
823 strtol( psz_parser + strlen( "width=" ),
826 else if( !strncmp( psz_parser, "height=",
827 strlen( "height=" ) ) )
830 strtol( psz_parser + strlen( "height=" ),
833 else if( !strncmp( psz_parser, "aspect-ratio=",
834 strlen( "aspect-ratio=" ) ) )
836 unsigned int num,den;
837 num = strtol( psz_parser + strlen( "aspect-ratio=" ),
839 den = strtol( psz_parser + strlen( ":" ),
842 p_sys->i_aspect = num * VOUT_ASPECT_FACTOR / den;
844 else if( !strncmp( psz_parser, "controls-reset",
845 strlen( "controls-reset" ) ) )
847 var_SetBool( p_obj, "v4l2-controls-reset", true );
848 psz_parser += strlen( "controls-reset" );
851 else if( !strncmp( psz_parser, "brightness=",
852 strlen( "brightness=" ) ) )
854 var_SetInteger( p_obj, "brightness",
855 strtol( psz_parser + strlen( "brightness=" ),
858 else if( !strncmp( psz_parser, "contrast=",
859 strlen( "contrast=" ) ) )
861 var_SetInteger( p_obj, "contrast",
862 strtol( psz_parser + strlen( "contrast=" ),
865 else if( !strncmp( psz_parser, "saturation=",
866 strlen( "saturation=" ) ) )
868 var_SetInteger( p_obj, "saturation",
869 strtol( psz_parser + strlen( "saturation=" ),
872 else if( !strncmp( psz_parser, "hue=",
875 var_SetInteger( p_obj, "hue",
876 strtol( psz_parser + strlen( "hue=" ),
879 else if( !strncmp( psz_parser, "gamma=",
880 strlen( "gamma=" ) ) )
882 var_SetInteger( p_obj, "gamma",
883 strtol( psz_parser + strlen( "gamma=" ),
887 else if( !strncmp( psz_parser, "caching=", strlen( "caching=" ) ) )
889 p_sys->i_cache = strtol( psz_parser + strlen( "caching=" ),
892 else if( !strncmp( psz_parser, "tuner=", strlen( "tuner=" ) ) )
894 p_sys->i_cur_tuner = strtol( psz_parser + strlen( "tuner=" ),
897 else if( !strncmp( psz_parser, "tuner-frequency=", strlen( "tuner-frequency=" ) ) )
899 p_sys->i_frequency = strtol( psz_parser
900 + strlen( "tuner-frequency=" ),
903 else if( !strncmp( psz_parser, "tuner-audio-mode=", strlen( "tuner-audio-mode=" ) ) )
905 p_sys->i_audio_mode = strtol( psz_parser
906 + strlen( "tuner-audio-mode=" ),
909 else if( !strncmp( psz_parser, "set-ctrls=", strlen( "set-ctrls=" )) )
913 psz_parser += strlen( "set-ctrls=" );
914 if( strchr( psz_parser, ':' ) )
916 i_len = strchr( psz_parser, ':' ) - psz_parser;
920 i_len = strlen( psz_parser );
923 p_sys->psz_set_ctrls = strndup( psz_parser, i_len );
927 else if( !strncmp( psz_parser, "adev=", strlen( "adev=" ) )
928 || !strncmp( psz_parser, "samplerate=", strlen( "samplerate=" ) )
929 || !strncmp( psz_parser, "audio-method", strlen( "audio-method" ) )
930 || !strncmp( psz_parser, "stereo", strlen( "stereo" ) )
931 || !strncmp( psz_parser, "mono", strlen( "mono" ) ) )
933 if( strchr( psz_parser, ':' ) )
935 psz_parser = strchr( psz_parser, ':' );
939 psz_parser += strlen( psz_parser );
942 msg_Err( p_obj, AUDIO_DEPRECATED_ERROR );
946 char *psz_unk = strchr( psz_parser, ':' );
948 psz_unk = strndup( psz_parser, psz_unk - psz_parser );
950 psz_unk = strdup( psz_parser);
951 msg_Warn( p_obj, "unknown option %s", psz_unk );
955 while( *psz_parser && *psz_parser != ':' )
960 if( *psz_parser == '\0' )
969 p_sys->psz_device = strdup( psz_dup );
971 p_sys->psz_device = strdup( V4L2_DEFAULT );
975 /*****************************************************************************
976 * Close: close device, free resources
977 *****************************************************************************/
978 static void AccessClose( vlc_object_t *p_this )
980 access_t *p_access = (access_t *)p_this;
981 demux_sys_t *p_sys = (demux_sys_t *) p_access->p_sys;
983 CommonClose( p_this, p_sys );
986 static void DemuxClose( vlc_object_t *p_this )
988 struct v4l2_buffer buf;
989 enum v4l2_buf_type buf_type;
992 demux_t *p_demux = (demux_t *)p_this;
993 demux_sys_t *p_sys = p_demux->p_sys;
995 /* Stop video capture */
996 if( p_sys->i_fd >= 0 )
1000 case IO_METHOD_READ:
1004 case IO_METHOD_MMAP:
1005 case IO_METHOD_USERPTR:
1006 /* Some drivers 'hang' internally if this is not done before streamoff */
1007 for( unsigned int i = 0; i < p_sys->i_nbuffers; i++ )
1009 memset( &buf, 0, sizeof(buf) );
1010 buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
1011 buf.memory = ( p_sys->io == IO_METHOD_USERPTR ) ?
1012 V4L2_MEMORY_USERPTR : V4L2_MEMORY_MMAP;
1013 v4l2_ioctl( p_sys->i_fd, VIDIOC_DQBUF, &buf ); /* ignore result */
1016 buf_type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
1017 if( v4l2_ioctl( p_sys->i_fd, VIDIOC_STREAMOFF, &buf_type ) < 0 ) {
1018 msg_Err( p_this, "VIDIOC_STREAMOFF failed" );
1025 /* Free Video Buffers */
1026 if( p_sys->p_buffers ) {
1029 case IO_METHOD_READ:
1030 free( p_sys->p_buffers[0].start );
1033 case IO_METHOD_MMAP:
1034 for( i = 0; i < p_sys->i_nbuffers; ++i )
1036 if( v4l2_munmap( p_sys->p_buffers[i].start, p_sys->p_buffers[i].length ) )
1038 msg_Err( p_this, "munmap failed" );
1043 case IO_METHOD_USERPTR:
1044 for( i = 0; i < p_sys->i_nbuffers; ++i )
1046 free( p_sys->p_buffers[i].start );
1050 free( p_sys->p_buffers );
1053 CommonClose( p_this, p_sys );
1056 static void CommonClose( vlc_object_t *p_this, demux_sys_t *p_sys )
1060 if( p_sys->i_fd >= 0 ) v4l2_close( p_sys->i_fd );
1061 free( p_sys->psz_device );
1062 free( p_sys->p_standards );
1063 free( p_sys->p_inputs );
1064 free( p_sys->p_tuners );
1065 free( p_sys->p_codecs );
1066 free( p_sys->psz_requested_chroma );
1067 free( p_sys->psz_set_ctrls );
1072 /*****************************************************************************
1073 * AccessOpen: opens v4l2 device, access callback
1074 *****************************************************************************
1076 * url: <video device>::::
1078 *****************************************************************************/
1079 static int AccessOpen( vlc_object_t * p_this )
1081 access_t *p_access = (access_t*) p_this;
1082 demux_sys_t * p_sys;
1084 /* Only when selected */
1085 if( *p_access->psz_access == '\0' ) return VLC_EGENERIC;
1087 access_InitFields( p_access );
1088 ACCESS_SET_CALLBACKS( NULL, AccessRead, AccessControl, NULL );
1089 p_sys = calloc( 1, sizeof( demux_sys_t ));
1090 if( !p_sys ) return VLC_ENOMEM;
1091 p_access->p_sys = (access_sys_t*)p_sys;
1093 GetV4L2Params( p_sys, (vlc_object_t *) p_access );
1095 ParseMRL( p_sys, p_access->psz_path, (vlc_object_t *) p_access );
1098 if( !config_GetInt( p_this, CFG_PREFIX "use-libv4l2" ) )
1100 msg_Dbg( p_this, "Trying direct kernel v4l2" );
1101 use_kernel_v4l2( p_sys );
1102 if( FindMainDevice( p_this, p_sys, false ) == VLC_SUCCESS)
1106 msg_Dbg( p_this, "Trying libv4l2 wrapper" );
1107 use_libv4l2( p_sys );
1109 if( FindMainDevice( p_this, p_sys, false ) == VLC_SUCCESS )
1112 AccessClose( p_this );
1113 return VLC_EGENERIC;
1116 /*****************************************************************************
1118 *****************************************************************************/
1119 static int DemuxControl( demux_t *p_demux, int i_query, va_list args )
1123 /* Special for access_demux */
1124 case DEMUX_CAN_PAUSE:
1125 case DEMUX_CAN_SEEK:
1126 case DEMUX_CAN_CONTROL_PACE:
1127 *va_arg( args, bool * ) = false;
1130 case DEMUX_GET_PTS_DELAY:
1131 *va_arg(args,int64_t *) = (int64_t)p_demux->p_sys->i_cache*1000;
1134 case DEMUX_GET_TIME:
1135 *va_arg( args, int64_t * ) = mdate();
1138 /* TODO implement others */
1140 return VLC_EGENERIC;
1143 return VLC_EGENERIC;
1146 /*****************************************************************************
1147 * AccessControl: access callback
1148 *****************************************************************************/
1149 static int AccessControl( access_t *p_access, int i_query, va_list args )
1151 demux_sys_t *p_sys = (demux_sys_t *) p_access->p_sys;
1156 case ACCESS_CAN_SEEK:
1157 case ACCESS_CAN_FASTSEEK:
1158 case ACCESS_CAN_PAUSE:
1159 case ACCESS_CAN_CONTROL_PACE:
1160 *va_arg( args, bool* ) = false;
1164 case ACCESS_GET_PTS_DELAY:
1165 *va_arg(args,int64_t *) = (int64_t)p_sys->i_cache*1000;
1169 case ACCESS_SET_PAUSE_STATE:
1173 case ACCESS_GET_TITLE_INFO:
1174 case ACCESS_SET_TITLE:
1175 case ACCESS_SET_SEEKPOINT:
1176 case ACCESS_SET_PRIVATE_ID_STATE:
1177 case ACCESS_GET_CONTENT_TYPE:
1178 case ACCESS_GET_META:
1179 return VLC_EGENERIC;
1182 msg_Warn( p_access, "Unimplemented query in control(%d).", i_query);
1183 return VLC_EGENERIC;
1189 /*****************************************************************************
1190 * AccessRead: access callback
1191 ******************************************************************************/
1192 static block_t *AccessRead( access_t * p_access )
1194 demux_sys_t *p_sys = (demux_sys_t *)p_access->p_sys;
1197 fd.fd = p_sys->i_fd;
1198 fd.events = POLLIN|POLLPRI;
1202 if( poll( &fd, 1, 500 ) ) /* Timeout after 0.5 seconds since I don't know if pf_demux can be blocking. */
1204 if( fd.revents & (POLLIN|POLLPRI) )
1206 return GrabVideo( VLC_OBJECT(p_access), p_sys );
1213 /*****************************************************************************
1214 * Demux: Processes the audio or video frame
1215 *****************************************************************************/
1216 static int Demux( demux_t *p_demux )
1218 demux_sys_t *p_sys = p_demux->p_sys;
1221 fd.fd = p_sys->i_fd;
1222 fd.events = POLLIN|POLLPRI;
1226 if( poll( &fd, 1, 500 ) ) /* Timeout after 0.5 seconds since I don't know if pf_demux can be blocking. */
1228 if( fd.revents & (POLLIN|POLLPRI) )
1230 block_t *p_block = GrabVideo( VLC_OBJECT(p_demux), p_sys );
1233 es_out_Control( p_demux->out, ES_OUT_SET_PCR, p_block->i_pts );
1234 es_out_Send( p_demux->out, p_sys->p_es, p_block );
1242 /*****************************************************************************
1243 * GrabVideo: Grab a video frame
1244 *****************************************************************************/
1245 static block_t* GrabVideo( vlc_object_t *p_demux, demux_sys_t *p_sys )
1247 block_t *p_block = NULL;
1248 struct v4l2_buffer buf;
1251 if( p_sys->f_fps >= 0.1 && p_sys->i_video_pts > 0 )
1253 mtime_t i_dur = (mtime_t)((double)1000000 / (double)p_sys->f_fps);
1255 /* Did we wait long enough ? (frame rate reduction) */
1256 if( p_sys->i_video_pts + i_dur > mdate() ) return 0;
1259 /* Grab Video Frame */
1262 case IO_METHOD_READ:
1263 i_ret = v4l2_read( p_sys->i_fd, p_sys->p_buffers[0].start, p_sys->p_buffers[0].length );
1271 /* Could ignore EIO, see spec. */
1274 msg_Err( p_demux, "Failed to read frame" );
1279 p_block = ProcessVideoFrame( p_demux, (uint8_t*)p_sys->p_buffers[0].start, i_ret );
1280 if( !p_block ) return 0;
1284 case IO_METHOD_MMAP:
1285 memset( &buf, 0, sizeof(buf) );
1286 buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
1287 buf.memory = V4L2_MEMORY_MMAP;
1289 /* Wait for next frame */
1290 if (v4l2_ioctl( p_sys->i_fd, VIDIOC_DQBUF, &buf ) < 0 )
1297 /* Could ignore EIO, see spec. */
1300 msg_Err( p_demux, "Failed to wait (VIDIOC_DQBUF)" );
1305 if( buf.index >= p_sys->i_nbuffers ) {
1306 msg_Err( p_demux, "Failed capturing new frame as i>=nbuffers" );
1310 p_block = ProcessVideoFrame( p_demux, p_sys->p_buffers[buf.index].start, buf.bytesused );
1311 if( !p_block ) return 0;
1314 if( v4l2_ioctl( p_sys->i_fd, VIDIOC_QBUF, &buf ) < 0 )
1316 msg_Err( p_demux, "Failed to unlock (VIDIOC_QBUF)" );
1317 block_Release( p_block );
1323 case IO_METHOD_USERPTR:
1324 memset( &buf, 0, sizeof(buf) );
1325 buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
1326 buf.memory = V4L2_MEMORY_USERPTR;
1328 /* Wait for next frame */
1329 if (v4l2_ioctl( p_sys->i_fd, VIDIOC_DQBUF, &buf ) < 0 )
1336 /* Could ignore EIO, see spec. */
1339 msg_Err( p_demux, "Failed to wait (VIDIOC_DQBUF)" );
1346 for( i = 0; i < p_sys->i_nbuffers; i++ )
1348 if( buf.m.userptr == (unsigned long)p_sys->p_buffers[i].start &&
1349 buf.length == p_sys->p_buffers[i].length ) break;
1352 if( i >= p_sys->i_nbuffers )
1354 msg_Err( p_demux, "Failed capturing new frame as i>=nbuffers" );
1358 p_block = ProcessVideoFrame( p_demux, (uint8_t*)buf.m.userptr, buf.bytesused );
1359 if( !p_block ) return 0;
1362 if( v4l2_ioctl( p_sys->i_fd, VIDIOC_QBUF, &buf ) < 0 )
1364 msg_Err( p_demux, "Failed to unlock (VIDIOC_QBUF)" );
1365 block_Release( p_block );
1374 p_sys->i_video_pts = p_block->i_pts = p_block->i_dts = mdate();
1379 /*****************************************************************************
1380 * ProcessVideoFrame: Helper function to take a buffer and copy it into
1382 *****************************************************************************/
1383 static block_t* ProcessVideoFrame( vlc_object_t *p_demux, uint8_t *p_frame, size_t i_size )
1387 if( !p_frame ) return 0;
1390 if( !( p_block = block_New( p_demux, i_size ) ) )
1392 msg_Warn( p_demux, "Cannot get new block" );
1397 memcpy( p_block->p_buffer, p_frame, i_size );
1402 /*****************************************************************************
1403 * Helper function to initalise video IO using the Read method
1404 *****************************************************************************/
1405 static int InitRead( vlc_object_t *p_demux, demux_sys_t *p_sys, unsigned int i_buffer_size )
1409 p_sys->p_buffers = calloc( 1, sizeof( *p_sys->p_buffers ) );
1410 if( !p_sys->p_buffers )
1411 return VLC_EGENERIC;
1413 p_sys->p_buffers[0].length = i_buffer_size;
1414 p_sys->p_buffers[0].start = malloc( i_buffer_size );
1415 if( !p_sys->p_buffers[0].start )
1421 /*****************************************************************************
1422 * Helper function to initalise video IO using the mmap method
1423 *****************************************************************************/
1424 static int InitMmap( vlc_object_t *p_demux, demux_sys_t *p_sys, int i_fd )
1426 struct v4l2_requestbuffers req;
1428 memset( &req, 0, sizeof(req) );
1430 req.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
1431 req.memory = V4L2_MEMORY_MMAP;
1433 if( v4l2_ioctl( i_fd, VIDIOC_REQBUFS, &req ) < 0 )
1435 msg_Err( p_demux, "device does not support mmap i/o" );
1441 msg_Err( p_demux, "Insufficient buffer memory" );
1445 p_sys->p_buffers = calloc( req.count, sizeof( *p_sys->p_buffers ) );
1446 if( !p_sys->p_buffers )
1449 for( p_sys->i_nbuffers = 0; p_sys->i_nbuffers < req.count; ++p_sys->i_nbuffers )
1451 struct v4l2_buffer buf;
1453 memset( &buf, 0, sizeof(buf) );
1454 buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
1455 buf.memory = V4L2_MEMORY_MMAP;
1456 buf.index = p_sys->i_nbuffers;
1458 if( v4l2_ioctl( i_fd, VIDIOC_QUERYBUF, &buf ) < 0 )
1460 msg_Err( p_demux, "VIDIOC_QUERYBUF" );
1464 p_sys->p_buffers[p_sys->i_nbuffers].length = buf.length;
1465 p_sys->p_buffers[p_sys->i_nbuffers].start =
1466 v4l2_mmap( NULL, buf.length, PROT_READ | PROT_WRITE, MAP_SHARED, i_fd, buf.m.offset );
1468 if( p_sys->p_buffers[p_sys->i_nbuffers].start == MAP_FAILED )
1470 msg_Err( p_demux, "mmap failed (%m)" );
1478 return VLC_EGENERIC;
1482 /*****************************************************************************
1483 * Helper function to initalise video IO using the userbuf method
1484 *****************************************************************************/
1485 static int InitUserP( vlc_object_t *p_demux, demux_sys_t *p_sys, int i_fd, unsigned int i_buffer_size )
1487 struct v4l2_requestbuffers req;
1488 unsigned int i_page_size;
1490 i_page_size = sysconf(_SC_PAGESIZE);
1491 i_buffer_size = ( i_buffer_size + i_page_size - 1 ) & ~( i_page_size - 1);
1493 memset( &req, 0, sizeof(req) );
1495 req.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
1496 req.memory = V4L2_MEMORY_USERPTR;
1498 if( v4l2_ioctl( i_fd, VIDIOC_REQBUFS, &req ) < 0 )
1500 msg_Err( p_demux, "device does not support user pointer i/o" );
1501 return VLC_EGENERIC;
1504 p_sys->p_buffers = calloc( 4, sizeof( *p_sys->p_buffers ) );
1505 if( !p_sys->p_buffers )
1508 for( p_sys->i_nbuffers = 0; p_sys->i_nbuffers < 4; ++p_sys->i_nbuffers )
1510 p_sys->p_buffers[p_sys->i_nbuffers].length = i_buffer_size;
1511 if( posix_memalign( &p_sys->p_buffers[p_sys->i_nbuffers].start,
1512 /* boundary */ i_page_size, i_buffer_size ) )
1519 free( p_sys->p_buffers );
1520 return VLC_EGENERIC;
1524 /*****************************************************************************
1525 * IsPixelFormatSupported: returns true if the specified V4L2 pixel format is
1526 * in the array of supported formats returned by the driver
1527 *****************************************************************************/
1528 static bool IsPixelFormatSupported( demux_t *p_demux, unsigned int i_pixelformat )
1530 demux_sys_t *p_sys = p_demux->p_sys;
1532 for( int i_index = 0; i_index < p_sys->i_codec; i_index++ )
1534 if( p_sys->p_codecs[i_index].pixelformat == i_pixelformat )
1541 static float GetMaxFrameRate( demux_t *p_demux, int i_fd,
1542 uint32_t i_pixel_format,
1543 uint32_t i_width, uint32_t i_height )
1546 #ifdef VIDIOC_ENUM_FRAMEINTERVALS
1548 demux_sys_t *p_sys = p_demux->p_sys;
1550 /* This is new in Linux 2.6.19 */
1551 struct v4l2_frmivalenum frmival;
1552 memset( &frmival, 0, sizeof(frmival) );
1553 frmival.pixel_format = i_pixel_format;
1554 frmival.width = i_width;
1555 frmival.height = i_height;
1556 if( v4l2_ioctl( i_fd, VIDIOC_ENUM_FRAMEINTERVALS, &frmival ) >= 0 )
1558 switch( frmival.type )
1560 case V4L2_FRMIVAL_TYPE_DISCRETE:
1562 float f_fps_max = -1;
1565 float f_fps = (float)frmival.discrete.denominator
1566 / (float)frmival.discrete.numerator;
1567 if( f_fps > f_fps_max ) f_fps_max = f_fps;
1569 } while( v4l2_ioctl( i_fd, VIDIOC_ENUM_FRAMEINTERVALS,
1573 case V4L2_FRMSIZE_TYPE_STEPWISE:
1574 case V4L2_FRMIVAL_TYPE_CONTINUOUS:
1575 return __MAX( (float)frmival.stepwise.max.denominator
1576 / (float)frmival.stepwise.max.numerator,
1577 (float)frmival.stepwise.min.denominator
1578 / (float)frmival.stepwise.min.numerator );
1585 static float GetAbsoluteMaxFrameRate( demux_t *p_demux, int i_fd,
1586 uint32_t i_pixel_format )
1588 float f_fps_max = -1.;
1589 #ifdef VIDIOC_ENUM_FRAMESIZES
1591 demux_sys_t *p_sys = p_demux->p_sys;
1593 /* This is new in Linux 2.6.19 */
1594 struct v4l2_frmsizeenum frmsize;
1595 memset( &frmsize, 0, sizeof(frmsize) );
1596 frmsize.pixel_format = i_pixel_format;
1597 if( v4l2_ioctl( i_fd, VIDIOC_ENUM_FRAMESIZES, &frmsize ) >= 0 )
1599 switch( frmsize.type )
1601 case V4L2_FRMSIZE_TYPE_DISCRETE:
1605 float f_fps = GetMaxFrameRate( p_demux, i_fd,
1607 frmsize.discrete.width,
1608 frmsize.discrete.height );
1609 if( f_fps > f_fps_max ) f_fps_max = f_fps;
1610 } while( v4l2_ioctl( i_fd, VIDIOC_ENUM_FRAMESIZES,
1613 case V4L2_FRMSIZE_TYPE_STEPWISE:
1615 uint32_t i_width = frmsize.stepwise.min_width;
1616 uint32_t i_height = frmsize.stepwise.min_height;
1618 i_width <= frmsize.stepwise.max_width &&
1619 i_height <= frmsize.stepwise.max_width;
1620 i_width += frmsize.stepwise.step_width,
1621 i_height += frmsize.stepwise.step_height )
1623 float f_fps = GetMaxFrameRate( p_demux, i_fd,
1625 i_width, i_height );
1626 if( f_fps > f_fps_max ) f_fps_max = f_fps;
1630 case V4L2_FRMSIZE_TYPE_CONTINUOUS:
1632 msg_Err( p_demux, "GetAbsoluteMaxFrameRate implementation for V4L2_FRMSIZE_TYPE_CONTINUOUS isn't correct" );
1633 f_fps_max = GetMaxFrameRate( p_demux, i_fd,
1635 frmsize.stepwise.max_width,
1636 frmsize.stepwise.max_height );
1644 static void GetMaxDimensions( demux_t *p_demux, int i_fd,
1645 uint32_t i_pixel_format, float f_fps_min,
1646 uint32_t *pi_width, uint32_t *pi_height )
1650 #ifdef VIDIOC_ENUM_FRAMESIZES
1652 demux_sys_t *p_sys = p_demux->p_sys;
1654 /* This is new in Linux 2.6.19 */
1655 struct v4l2_frmsizeenum frmsize;
1656 memset( &frmsize, 0, sizeof(frmsize) );
1657 frmsize.pixel_format = i_pixel_format;
1658 if( v4l2_ioctl( i_fd, VIDIOC_ENUM_FRAMESIZES, &frmsize ) >= 0 )
1660 switch( frmsize.type )
1662 case V4L2_FRMSIZE_TYPE_DISCRETE:
1666 float f_fps = GetMaxFrameRate( p_demux, i_fd,
1668 frmsize.discrete.width,
1669 frmsize.discrete.height );
1670 if( f_fps >= f_fps_min &&
1671 frmsize.discrete.width > *pi_width )
1673 *pi_width = frmsize.discrete.width;
1674 *pi_height = frmsize.discrete.height;
1676 } while( v4l2_ioctl( i_fd, VIDIOC_ENUM_FRAMESIZES,
1679 case V4L2_FRMSIZE_TYPE_STEPWISE:
1681 uint32_t i_width = frmsize.stepwise.min_width;
1682 uint32_t i_height = frmsize.stepwise.min_height;
1684 i_width <= frmsize.stepwise.max_width &&
1685 i_height <= frmsize.stepwise.max_width;
1686 i_width += frmsize.stepwise.step_width,
1687 i_height += frmsize.stepwise.step_height )
1689 float f_fps = GetMaxFrameRate( p_demux, i_fd,
1691 i_width, i_height );
1692 if( f_fps >= f_fps_min && i_width > *pi_width )
1694 *pi_width = i_width;
1695 *pi_height = i_height;
1700 case V4L2_FRMSIZE_TYPE_CONTINUOUS:
1702 msg_Err( p_demux, "GetMaxDimension implementation for V4L2_FRMSIZE_TYPE_CONTINUOUS isn't correct" );
1703 float f_fps = GetMaxFrameRate( p_demux, i_fd,
1705 frmsize.stepwise.max_width,
1706 frmsize.stepwise.max_height );
1707 if( f_fps >= f_fps_min &&
1708 frmsize.stepwise.max_width > *pi_width )
1710 *pi_width = frmsize.stepwise.max_width;
1711 *pi_height = frmsize.stepwise.max_height;
1719 /*****************************************************************************
1720 * OpenVideoDev: open and set up the video device and probe for capabilities
1721 *****************************************************************************/
1722 static int OpenVideoDev( vlc_object_t *p_obj, demux_sys_t *p_sys, bool b_demux )
1725 struct v4l2_cropcap cropcap;
1726 struct v4l2_crop crop;
1727 struct v4l2_format fmt;
1729 enum v4l2_buf_type buf_type;
1730 const char *psz_device = p_sys->psz_device;
1733 if( ( i_fd = open( psz_device, O_RDWR ) ) < 0 )
1735 msg_Err( p_obj, "cannot open device (%m)" );
1740 /* Note the v4l2_xxx functions are designed so that if they get passed an
1741 unknown fd, the will behave exactly as their regular xxx counterparts,
1742 so if v4l2_fd_open fails, we continue as normal (missing the libv4l2
1743 custom cam format to normal formats conversion). Chances are big we will
1744 still fail then though, as normally v4l2_fd_open only fails if the
1745 device is not a v4l2 device. */
1746 if( p_sys->b_libv4l2 )
1749 libv4l2_fd = v4l2_fd_open( i_fd, V4L2_ENABLE_ENUM_FMT_EMULATION );
1750 if( libv4l2_fd != -1 )
1755 /* Tune the tuner */
1756 if( p_sys->i_frequency >= 0 )
1758 if( p_sys->i_cur_tuner < 0 || p_sys->i_cur_tuner >= p_sys->i_tuner )
1760 msg_Err( p_obj, "invalid tuner %d.", p_sys->i_cur_tuner );
1763 struct v4l2_frequency frequency;
1764 memset( &frequency, 0, sizeof( frequency ) );
1765 frequency.tuner = p_sys->i_cur_tuner;
1766 frequency.type = p_sys->p_tuners[p_sys->i_cur_tuner].type;
1767 frequency.frequency = p_sys->i_frequency / 62.5;
1768 if( v4l2_ioctl( i_fd, VIDIOC_S_FREQUENCY, &frequency ) < 0 )
1770 msg_Err( p_obj, "cannot set tuner frequency (%m)" );
1773 msg_Dbg( p_obj, "Tuner frequency set" );
1776 /* Set the tuner's audio mode */
1777 if( p_sys->i_audio_mode >= 0 )
1779 if( p_sys->i_cur_tuner < 0 || p_sys->i_cur_tuner >= p_sys->i_tuner )
1781 msg_Err( p_obj, "invalid tuner %d.", p_sys->i_cur_tuner );
1784 struct v4l2_tuner tuner;
1785 memset( &tuner, 0, sizeof( tuner ) );
1786 tuner.index = p_sys->i_cur_tuner;
1787 tuner.audmode = p_sys->i_audio_mode;
1788 if( v4l2_ioctl( i_fd, VIDIOC_S_TUNER, &tuner ) < 0 )
1790 msg_Err( p_obj, "cannot set tuner audio mode (%m)" );
1793 msg_Dbg( p_obj, "Tuner audio mode set" );
1796 /* Select standard */
1798 if( p_sys->i_selected_standard_id != V4L2_STD_UNKNOWN )
1800 if( v4l2_ioctl( i_fd, VIDIOC_S_STD, &p_sys->i_selected_standard_id ) < 0 )
1802 msg_Err( p_obj, "cannot set standard (%m)" );
1805 msg_Dbg( p_obj, "Set standard" );
1810 if( p_sys->i_selected_input >= p_sys->i_input )
1812 msg_Warn( p_obj, "invalid input. Using the default one" );
1813 p_sys->i_selected_input = 0;
1816 if( v4l2_ioctl( i_fd, VIDIOC_S_INPUT, &p_sys->i_selected_input ) < 0 )
1818 msg_Err( p_obj, "cannot set input (%m)" );
1822 /* Set audio input */
1824 if( p_sys->i_audio > 0 )
1826 if( p_sys->i_selected_audio_input < 0
1827 || p_sys->i_selected_audio_input >= p_sys->i_audio )
1829 msg_Warn( p_obj, "invalid audio input. Using the default one" );
1830 p_sys->i_selected_audio_input = 0;
1833 if( v4l2_ioctl( i_fd, VIDIOC_S_AUDIO, &p_sys->p_audios[p_sys->i_selected_audio_input] ) < 0 )
1835 msg_Err( p_obj, "cannot set audio input (%m)" );
1838 msg_Dbg( p_obj, "Audio input set to %d", p_sys->i_selected_audio_input );
1842 /* TODO: Move the resolution stuff up here */
1843 /* if MPEG encoder card, no need to do anything else after this */
1844 ControlList( p_obj, p_sys, i_fd,
1845 var_GetBool( p_obj, "v4l2-controls-reset" ), b_demux );
1846 SetAvailControlsByString( p_obj, p_sys, i_fd );
1848 /* Verify device support for the various IO methods */
1851 case IO_METHOD_READ:
1852 if( !(p_sys->dev_cap.capabilities & V4L2_CAP_READWRITE) )
1854 msg_Err( p_obj, "device does not support read i/o" );
1859 case IO_METHOD_MMAP:
1860 case IO_METHOD_USERPTR:
1861 if( !(p_sys->dev_cap.capabilities & V4L2_CAP_STREAMING) )
1863 msg_Err( p_obj, "device does not support streaming i/o" );
1869 msg_Err( p_obj, "io method not supported" );
1873 /* Reset Cropping */
1874 memset( &cropcap, 0, sizeof(cropcap) );
1875 cropcap.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
1876 if( v4l2_ioctl( i_fd, VIDIOC_CROPCAP, &cropcap ) >= 0 )
1878 crop.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
1879 crop.c = cropcap.defrect; /* reset to default */
1880 if( v4l2_ioctl( i_fd, VIDIOC_S_CROP, &crop ) < 0 )
1885 /* Cropping not supported. */
1888 /* Errors ignored. */
1894 /* Try and find default resolution if not specified */
1895 memset( &fmt, 0, sizeof(fmt) );
1896 fmt.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
1898 if( p_sys->i_width == 0 || p_sys->i_height == 0 )
1900 /* Use current width and height settings */
1901 if( v4l2_ioctl( i_fd, VIDIOC_G_FMT, &fmt ) < 0 )
1903 msg_Err( p_obj, "Cannot get default width and height." );
1907 p_sys->i_width = fmt.fmt.pix.width;
1908 p_sys->i_height = fmt.fmt.pix.height;
1910 if( fmt.fmt.pix.field == V4L2_FIELD_ALTERNATE )
1912 p_sys->i_height = p_sys->i_height * 2;
1915 else if( p_sys->i_width < 0 || p_sys->i_height < 0 )
1917 msg_Dbg( p_obj, "will try to find optimal width and height." );
1921 /* Use user specified width and height */
1922 msg_Dbg( p_obj, "trying specified size %dx%d", p_sys->i_width, p_sys->i_height );
1925 fmt.fmt.pix.width = p_sys->i_width;
1926 fmt.fmt.pix.height = p_sys->i_height;
1927 fmt.fmt.pix.field = V4L2_FIELD_NONE;
1931 demux_t *p_demux = (demux_t *) p_obj;
1933 /* Test and set Chroma */
1934 fmt.fmt.pix.pixelformat = 0;
1935 if( p_sys->psz_requested_chroma && *p_sys->psz_requested_chroma )
1937 /* User specified chroma */
1938 const vlc_fourcc_t i_requested_fourcc =
1939 vlc_fourcc_GetCodecFromString( VIDEO_ES, p_sys->psz_requested_chroma );
1941 for( int i = 0; v4l2chroma_to_fourcc[i].i_v4l2 != 0; i++ )
1943 if( v4l2chroma_to_fourcc[i].i_fourcc == i_requested_fourcc )
1945 fmt.fmt.pix.pixelformat = v4l2chroma_to_fourcc[i].i_v4l2;
1949 /* Try and set user chroma */
1950 bool b_error = !IsPixelFormatSupported( p_demux, fmt.fmt.pix.pixelformat );
1951 if( !b_error && fmt.fmt.pix.pixelformat )
1953 if( v4l2_ioctl( i_fd, VIDIOC_S_FMT, &fmt ) < 0 )
1955 fmt.fmt.pix.field = V4L2_FIELD_ANY;
1956 if( v4l2_ioctl( i_fd, VIDIOC_S_FMT, &fmt ) < 0 )
1958 fmt.fmt.pix.field = V4L2_FIELD_NONE;
1965 msg_Warn( p_demux, "Driver is unable to use specified chroma %s. Trying defaults.", p_sys->psz_requested_chroma );
1966 fmt.fmt.pix.pixelformat = 0;
1970 /* If no user specified chroma, find best */
1971 /* This also decides if MPEG encoder card or not */
1972 if( !fmt.fmt.pix.pixelformat )
1975 for( i = 0; i < ARRAY_SIZE( p_chroma_fallbacks ); i++ )
1977 fmt.fmt.pix.pixelformat = p_chroma_fallbacks[i];
1978 if( IsPixelFormatSupported( p_demux, fmt.fmt.pix.pixelformat ) )
1980 if( v4l2_ioctl( i_fd, VIDIOC_S_FMT, &fmt ) >= 0 )
1982 fmt.fmt.pix.field = V4L2_FIELD_ANY;
1983 if( v4l2_ioctl( i_fd, VIDIOC_S_FMT, &fmt ) >= 0 )
1985 fmt.fmt.pix.field = V4L2_FIELD_NONE;
1988 if( i == ARRAY_SIZE( p_chroma_fallbacks ) )
1990 msg_Warn( p_demux, "Could not select any of the default chromas; attempting to open as MPEG encoder card (access)" );
1995 if( p_sys->i_width < 0 || p_sys->i_height < 0 )
1997 if( p_sys->f_fps <= 0 )
1999 p_sys->f_fps = GetAbsoluteMaxFrameRate( p_demux, i_fd,
2000 fmt.fmt.pix.pixelformat );
2001 msg_Dbg( p_demux, "Found maximum framerate of %f", p_sys->f_fps );
2003 GetMaxDimensions( p_demux, i_fd,
2004 fmt.fmt.pix.pixelformat, p_sys->f_fps,
2005 &fmt.fmt.pix.width, &fmt.fmt.pix.height );
2006 msg_Dbg( p_demux, "Found optimal dimensions for framerate %f of %dx%d",
2007 p_sys->f_fps, fmt.fmt.pix.width, fmt.fmt.pix.height );
2008 if( v4l2_ioctl( i_fd, VIDIOC_S_FMT, &fmt ) < 0 ) {;}
2011 /* Reassign width, height and chroma incase driver override */
2012 p_sys->i_width = fmt.fmt.pix.width;
2013 p_sys->i_height = fmt.fmt.pix.height;
2016 if( v4l2_ioctl( i_fd, VIDIOC_G_FMT, &fmt ) < 0 ) {;}
2017 /* Print extra info */
2018 msg_Dbg( p_obj, "Driver requires at most %d bytes to store a complete image", fmt.fmt.pix.sizeimage );
2019 /* Check interlacing */
2020 switch( fmt.fmt.pix.field )
2022 case V4L2_FIELD_NONE:
2023 msg_Dbg( p_obj, "Interlacing setting: progressive" );
2025 case V4L2_FIELD_TOP:
2026 msg_Dbg( p_obj, "Interlacing setting: top field only" );
2028 case V4L2_FIELD_BOTTOM:
2029 msg_Dbg( p_obj, "Interlacing setting: bottom field only" );
2031 case V4L2_FIELD_INTERLACED:
2032 msg_Dbg( p_obj, "Interlacing setting: interleaved (bottom top if M/NTSC, top bottom otherwise)" );
2034 case V4L2_FIELD_SEQ_TB:
2035 msg_Dbg( p_obj, "Interlacing setting: sequential top bottom" );
2037 case V4L2_FIELD_SEQ_BT:
2038 msg_Dbg( p_obj, "Interlacing setting: sequential bottom top" );
2040 case V4L2_FIELD_ALTERNATE:
2041 msg_Dbg( p_obj, "Interlacing setting: alternate fields" );
2043 case V4L2_FIELD_INTERLACED_TB:
2044 msg_Dbg( p_obj, "Interlacing setting: interleaved top bottom" );
2046 case V4L2_FIELD_INTERLACED_BT:
2047 msg_Dbg( p_obj, "Interlacing setting: interleaved bottom top" );
2050 msg_Warn( p_obj, "Interlacing setting: unknown type (%d)",
2051 fmt.fmt.pix.field );
2054 if( fmt.fmt.pix.field != V4L2_FIELD_NONE )
2055 msg_Warn( p_obj, "Interlaced inputs haven't been tested. Please report any issue." );
2057 /* Look up final fourcc */
2058 p_sys->i_fourcc = 0;
2059 for( int i = 0; v4l2chroma_to_fourcc[i].i_fourcc != 0; i++ )
2061 if( v4l2chroma_to_fourcc[i].i_v4l2 == fmt.fmt.pix.pixelformat )
2063 p_sys->i_fourcc = v4l2chroma_to_fourcc[i].i_fourcc;
2064 es_format_Init( &es_fmt, VIDEO_ES, p_sys->i_fourcc );
2065 es_fmt.video.i_rmask = v4l2chroma_to_fourcc[i].i_rmask;
2066 es_fmt.video.i_gmask = v4l2chroma_to_fourcc[i].i_gmask;
2067 es_fmt.video.i_bmask = v4l2chroma_to_fourcc[i].i_bmask;
2072 /* Buggy driver paranoia */
2073 i_min = fmt.fmt.pix.width * 2;
2074 if( fmt.fmt.pix.bytesperline < i_min )
2075 fmt.fmt.pix.bytesperline = i_min;
2076 i_min = fmt.fmt.pix.bytesperline * fmt.fmt.pix.height;
2077 if( fmt.fmt.pix.sizeimage < i_min )
2078 fmt.fmt.pix.sizeimage = i_min;
2080 #ifdef VIDIOC_ENUM_FRAMEINTERVALS
2081 /* This is new in Linux 2.6.19 */
2082 /* List supported frame rates */
2083 struct v4l2_frmivalenum frmival;
2084 memset( &frmival, 0, sizeof(frmival) );
2085 frmival.pixel_format = fmt.fmt.pix.pixelformat;
2086 frmival.width = p_sys->i_width;
2087 frmival.height = p_sys->i_height;
2088 if( v4l2_ioctl( i_fd, VIDIOC_ENUM_FRAMEINTERVALS, &frmival ) >= 0 )
2091 memset( &psz_fourcc, 0, sizeof( psz_fourcc ) );
2092 vlc_fourcc_to_char( p_sys->i_fourcc, &psz_fourcc );
2093 msg_Dbg( p_obj, "supported frame intervals for %4s, %dx%d:",
2094 psz_fourcc, frmival.width, frmival.height );
2095 switch( frmival.type )
2097 case V4L2_FRMIVAL_TYPE_DISCRETE:
2100 msg_Dbg( p_obj, " supported frame interval: %d/%d",
2101 frmival.discrete.numerator,
2102 frmival.discrete.denominator );
2104 } while( v4l2_ioctl( i_fd, VIDIOC_ENUM_FRAMEINTERVALS, &frmival ) >= 0 );
2106 case V4L2_FRMIVAL_TYPE_STEPWISE:
2107 msg_Dbg( p_obj, " supported frame intervals: %d/%d to "
2108 "%d/%d using %d/%d increments",
2109 frmival.stepwise.min.numerator,
2110 frmival.stepwise.min.denominator,
2111 frmival.stepwise.max.numerator,
2112 frmival.stepwise.max.denominator,
2113 frmival.stepwise.step.numerator,
2114 frmival.stepwise.step.denominator );
2116 case V4L2_FRMIVAL_TYPE_CONTINUOUS:
2117 msg_Dbg( p_obj, " supported frame intervals: %d/%d to %d/%d",
2118 frmival.stepwise.min.numerator,
2119 frmival.stepwise.min.denominator,
2120 frmival.stepwise.max.numerator,
2121 frmival.stepwise.max.denominator );
2128 /* Init IO method */
2131 case IO_METHOD_READ:
2132 if( InitRead( p_obj, p_sys, fmt.fmt.pix.sizeimage ) != VLC_SUCCESS ) goto open_failed;
2135 case IO_METHOD_MMAP:
2136 if( InitMmap( p_obj, p_sys, i_fd ) != VLC_SUCCESS ) goto open_failed;
2139 case IO_METHOD_USERPTR:
2140 if( InitUserP( p_obj, p_sys, i_fd, fmt.fmt.pix.sizeimage ) != VLC_SUCCESS ) goto open_failed;
2146 es_fmt.video.i_width = p_sys->i_width;
2147 es_fmt.video.i_height = p_sys->i_height;
2149 /* Get aspect-ratio */
2150 es_fmt.video.i_aspect = p_sys->i_aspect;
2154 demux_t *p_demux = (demux_t *) p_obj;
2155 msg_Dbg( p_demux, "added new video es %4.4s %dx%d",
2156 (char*)&es_fmt.i_codec, es_fmt.video.i_width, es_fmt.video.i_height );
2157 p_sys->p_es = es_out_Add( p_demux->out, &es_fmt );
2164 case IO_METHOD_READ:
2168 case IO_METHOD_MMAP:
2169 for (unsigned int i = 0; i < p_sys->i_nbuffers; ++i)
2171 struct v4l2_buffer buf;
2173 memset( &buf, 0, sizeof(buf) );
2174 buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
2175 buf.memory = V4L2_MEMORY_MMAP;
2178 if( v4l2_ioctl( i_fd, VIDIOC_QBUF, &buf ) < 0 )
2180 msg_Err( p_obj, "VIDIOC_QBUF failed" );
2185 buf_type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
2186 if( v4l2_ioctl( i_fd, VIDIOC_STREAMON, &buf_type ) < 0 )
2188 msg_Err( p_obj, "VIDIOC_STREAMON failed" );
2194 case IO_METHOD_USERPTR:
2195 for( unsigned int i = 0; i < p_sys->i_nbuffers; ++i )
2197 struct v4l2_buffer buf;
2199 memset( &buf, 0, sizeof(buf) );
2200 buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
2201 buf.memory = V4L2_MEMORY_USERPTR;
2203 buf.m.userptr = (unsigned long)p_sys->p_buffers[i].start;
2204 buf.length = p_sys->p_buffers[i].length;
2206 if( v4l2_ioctl( i_fd, VIDIOC_QBUF, &buf ) < 0 )
2208 msg_Err( p_obj, "VIDIOC_QBUF failed" );
2213 buf_type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
2214 if( v4l2_ioctl( i_fd, VIDIOC_STREAMON, &buf_type ) < 0 )
2216 msg_Err( p_obj, "VIDIOC_STREAMON failed" );
2224 if( p_sys->f_fps >= 0.1 )
2226 msg_Dbg( p_obj, "User set fps=%f", p_sys->f_fps );
2232 if( i_fd >= 0 ) v4l2_close( i_fd );
2237 /*****************************************************************************
2238 * ProbeVideoDev: probe video for capabilities
2239 *****************************************************************************/
2240 static bool ProbeVideoDev( vlc_object_t *p_obj, demux_sys_t *p_sys,
2241 const char *psz_device )
2248 if( ( i_fd = open( psz_device, O_RDWR ) ) < 0 )
2250 msg_Err( p_obj, "cannot open video device '%s' (%m)", psz_device );
2255 /* Note the v4l2_xxx functions are designed so that if they get passed an
2256 unknown fd, the will behave exactly as their regular xxx counterparts,
2257 so if v4l2_fd_open fails, we continue as normal (missing the libv4l2
2258 custom cam format to normal formats conversion). Chances are big we will
2259 still fail then though, as normally v4l2_fd_open only fails if the
2260 device is not a v4l2 device. */
2261 if( p_sys->b_libv4l2 )
2264 libv4l2_fd = v4l2_fd_open( i_fd, V4L2_ENABLE_ENUM_FMT_EMULATION );
2265 if( libv4l2_fd != -1 )
2270 /* Get device capabilites */
2272 if( v4l2_ioctl( i_fd, VIDIOC_QUERYCAP, &p_sys->dev_cap ) < 0 )
2274 msg_Err( p_obj, "cannot get video capabilities (%m)" );
2278 msg_Dbg( p_obj, "V4L2 device: %s using driver: %s (version: %u.%u.%u) on %s",
2279 p_sys->dev_cap.card,
2280 p_sys->dev_cap.driver,
2281 (p_sys->dev_cap.version >> 16) & 0xFF,
2282 (p_sys->dev_cap.version >> 8) & 0xFF,
2283 p_sys->dev_cap.version & 0xFF,
2284 p_sys->dev_cap.bus_info );
2286 msg_Dbg( p_obj, "the device has the capabilities: (%c) Video Capure, "
2289 ( p_sys->dev_cap.capabilities & V4L2_CAP_VIDEO_CAPTURE ? 'X':' '),
2290 ( p_sys->dev_cap.capabilities & V4L2_CAP_AUDIO ? 'X':' '),
2291 ( p_sys->dev_cap.capabilities & V4L2_CAP_TUNER ? 'X':' ') );
2293 msg_Dbg( p_obj, "supported I/O methods are: (%c) Read/Write, "
2295 "(%c) Asynchronous",
2296 ( p_sys->dev_cap.capabilities & V4L2_CAP_READWRITE ? 'X':' ' ),
2297 ( p_sys->dev_cap.capabilities & V4L2_CAP_STREAMING ? 'X':' ' ),
2298 ( p_sys->dev_cap.capabilities & V4L2_CAP_ASYNCIO ? 'X':' ' ) );
2300 /* Now, enumerate all the video inputs. This is useless at the moment
2301 since we have no way to present that info to the user except with
2304 if( p_sys->dev_cap.capabilities & V4L2_CAP_VIDEO_CAPTURE )
2306 struct v4l2_input t_input;
2307 memset( &t_input, 0, sizeof(t_input) );
2308 while( v4l2_ioctl( i_fd, VIDIOC_ENUMINPUT, &t_input ) >= 0 )
2311 t_input.index = p_sys->i_input;
2314 p_sys->p_inputs = calloc( 1, p_sys->i_input * sizeof( struct v4l2_input ) );
2315 if( !p_sys->p_inputs ) goto open_failed;
2317 for( i_index = 0; i_index < p_sys->i_input; i_index++ )
2319 p_sys->p_inputs[i_index].index = i_index;
2321 if( v4l2_ioctl( i_fd, VIDIOC_ENUMINPUT, &p_sys->p_inputs[i_index] ) )
2323 msg_Err( p_obj, "cannot get video input characteristics (%m)" );
2326 msg_Dbg( p_obj, "video input %i (%s) has type: %s %c",
2328 p_sys->p_inputs[i_index].name,
2329 p_sys->p_inputs[i_index].type
2330 == V4L2_INPUT_TYPE_TUNER ?
2332 "External analog input",
2333 i_index == p_sys->i_selected_input ? '*' : ' ' );
2337 /* Probe video standards */
2338 if( p_sys->dev_cap.capabilities & V4L2_CAP_VIDEO_CAPTURE )
2340 struct v4l2_standard t_standards;
2341 t_standards.index = 0;
2342 p_sys->i_standard = 0;
2343 while( v4l2_ioctl( i_fd, VIDIOC_ENUMSTD, &t_standards ) >=0 )
2345 p_sys->i_standard++;
2346 t_standards.index = p_sys->i_standard;
2349 p_sys->p_standards = calloc( 1, p_sys->i_standard * sizeof( struct v4l2_standard ) );
2350 if( !p_sys->p_standards ) goto open_failed;
2352 for( i_standard = 0; i_standard < p_sys->i_standard; i_standard++ )
2354 p_sys->p_standards[i_standard].index = i_standard;
2356 if( v4l2_ioctl( i_fd, VIDIOC_ENUMSTD, &p_sys->p_standards[i_standard] ) )
2358 msg_Err( p_obj, "cannot get video input standards (%m)" );
2361 msg_Dbg( p_obj, "video standard %i is: %s %c",
2363 p_sys->p_standards[i_standard].name,
2364 (unsigned)i_standard == p_sys->i_selected_standard_id ? '*' : ' ' );
2368 /* initialize the structures for the ioctls */
2369 for( i_index = 0; i_index < 32; i_index++ )
2371 p_sys->p_audios[i_index].index = i_index;
2374 /* Probe audio inputs */
2375 if( p_sys->dev_cap.capabilities & V4L2_CAP_AUDIO )
2377 while( p_sys->i_audio < 32 &&
2378 v4l2_ioctl( i_fd, VIDIOC_S_AUDIO, &p_sys->p_audios[p_sys->i_audio] ) >= 0 )
2380 if( v4l2_ioctl( i_fd, VIDIOC_G_AUDIO, &p_sys->p_audios[ p_sys->i_audio] ) < 0 )
2382 msg_Err( p_obj, "cannot get audio input characteristics (%m)" );
2386 msg_Dbg( p_obj, "audio input %i (%s) is %s %s %c",
2388 p_sys->p_audios[p_sys->i_audio].name,
2389 p_sys->p_audios[p_sys->i_audio].capability &
2390 V4L2_AUDCAP_STEREO ?
2392 p_sys->p_audios[p_sys->i_audio].capability &
2394 "(Automatic Volume Level supported)" : "",
2395 p_sys->i_audio == p_sys->i_selected_audio_input ? '*' : ' ' );
2401 /* List tuner caps */
2402 if( p_sys->dev_cap.capabilities & V4L2_CAP_TUNER )
2404 struct v4l2_tuner tuner;
2405 memset( &tuner, 0, sizeof(tuner) );
2407 while( v4l2_ioctl( i_fd, VIDIOC_G_TUNER, &tuner ) >= 0 )
2410 memset( &tuner, 0, sizeof(tuner) );
2411 tuner.index = p_sys->i_tuner;
2414 p_sys->p_tuners = calloc( 1, p_sys->i_tuner * sizeof( struct v4l2_tuner ) );
2415 if( !p_sys->p_tuners ) goto open_failed;
2417 for( i_index = 0; i_index < p_sys->i_tuner; i_index++ )
2419 p_sys->p_tuners[i_index].index = i_index;
2421 if( v4l2_ioctl( i_fd, VIDIOC_G_TUNER, &p_sys->p_tuners[i_index] ) )
2423 msg_Err( p_obj, "cannot get tuner characteristics (%m)" );
2426 msg_Dbg( p_obj, "tuner %i (%s) has type: %s, "
2427 "frequency range: %.1f %s -> %.1f %s",
2429 p_sys->p_tuners[i_index].name,
2430 p_sys->p_tuners[i_index].type
2431 == V4L2_TUNER_RADIO ?
2432 "Radio" : "Analog TV",
2433 p_sys->p_tuners[i_index].rangelow * 62.5,
2434 p_sys->p_tuners[i_index].capability &
2435 V4L2_TUNER_CAP_LOW ?
2437 p_sys->p_tuners[i_index].rangehigh * 62.5,
2438 p_sys->p_tuners[i_index].capability &
2439 V4L2_TUNER_CAP_LOW ?
2442 struct v4l2_frequency frequency;
2443 memset( &frequency, 0, sizeof( frequency ) );
2444 if( v4l2_ioctl( i_fd, VIDIOC_G_FREQUENCY, &frequency ) < 0 )
2446 msg_Err( p_obj, "cannot get tuner frequency (%m)" );
2449 msg_Dbg( p_obj, "tuner %i (%s) frequency: %.1f %s",
2451 p_sys->p_tuners[i_index].name,
2452 frequency.frequency * 62.5,
2453 p_sys->p_tuners[i_index].capability &
2454 V4L2_TUNER_CAP_LOW ?
2459 /* Probe for available chromas */
2460 if( p_sys->dev_cap.capabilities & V4L2_CAP_VIDEO_CAPTURE )
2462 struct v4l2_fmtdesc codec;
2465 memset( &codec, 0, sizeof(codec) );
2466 codec.index = i_index;
2467 codec.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
2469 while( v4l2_ioctl( i_fd, VIDIOC_ENUM_FMT, &codec ) >= 0 )
2472 codec.index = i_index;
2475 p_sys->i_codec = i_index;
2477 p_sys->p_codecs = calloc( 1, p_sys->i_codec * sizeof( struct v4l2_fmtdesc ) );
2479 for( i_index = 0; i_index < p_sys->i_codec; i_index++ )
2481 p_sys->p_codecs[i_index].index = i_index;
2482 p_sys->p_codecs[i_index].type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
2484 if( v4l2_ioctl( i_fd, VIDIOC_ENUM_FMT, &p_sys->p_codecs[i_index] ) < 0 )
2486 msg_Err( p_obj, "cannot get codec description (%m)" );
2490 /* only print if vlc supports the format */
2491 char psz_fourcc_v4l2[5];
2492 memset( &psz_fourcc_v4l2, 0, sizeof( psz_fourcc_v4l2 ) );
2493 vlc_fourcc_to_char( p_sys->p_codecs[i_index].pixelformat,
2495 bool b_codec_supported = false;
2496 for( int i = 0; v4l2chroma_to_fourcc[i].i_v4l2 != 0; i++ )
2498 if( v4l2chroma_to_fourcc[i].i_v4l2 == p_sys->p_codecs[i_index].pixelformat )
2500 b_codec_supported = true;
2503 memset( &psz_fourcc, 0, sizeof( psz_fourcc ) );
2504 vlc_fourcc_to_char( v4l2chroma_to_fourcc[i].i_fourcc,
2506 msg_Dbg( p_obj, "device supports chroma %4s [%s, %s]",
2508 p_sys->p_codecs[i_index].description,
2511 #ifdef VIDIOC_ENUM_FRAMESIZES
2512 /* This is new in Linux 2.6.19 */
2513 /* List valid frame sizes for this format */
2514 struct v4l2_frmsizeenum frmsize;
2515 memset( &frmsize, 0, sizeof(frmsize) );
2516 frmsize.pixel_format = p_sys->p_codecs[i_index].pixelformat;
2517 if( v4l2_ioctl( i_fd, VIDIOC_ENUM_FRAMESIZES, &frmsize ) < 0 )
2519 /* Not all devices support this ioctl */
2520 msg_Warn( p_obj, "Unable to query for frame sizes" );
2524 switch( frmsize.type )
2526 case V4L2_FRMSIZE_TYPE_DISCRETE:
2530 " device supports size %dx%d",
2531 frmsize.discrete.width, frmsize.discrete.height );
2533 } while( v4l2_ioctl( i_fd, VIDIOC_ENUM_FRAMESIZES, &frmsize ) >= 0 );
2535 case V4L2_FRMSIZE_TYPE_STEPWISE:
2537 " device supports sizes %dx%d to %dx%d using %dx%d increments",
2538 frmsize.stepwise.min_width, frmsize.stepwise.min_height,
2539 frmsize.stepwise.max_width, frmsize.stepwise.max_height,
2540 frmsize.stepwise.step_width, frmsize.stepwise.step_height );
2542 case V4L2_FRMSIZE_TYPE_CONTINUOUS:
2544 " device supports all sizes %dx%d to %dx%d",
2545 frmsize.stepwise.min_width, frmsize.stepwise.min_height,
2546 frmsize.stepwise.max_width, frmsize.stepwise.max_height );
2553 if( !b_codec_supported )
2556 "device codec %4s (%s) not supported",
2558 p_sys->p_codecs[i_index].description );
2564 if( i_fd >= 0 ) v4l2_close( i_fd );
2569 if( i_fd >= 0 ) v4l2_close( i_fd );
2574 static void name2var( unsigned char *name )
2576 for( ; *name; name++ )
2577 *name = (*name == ' ') ? '_' : tolower( *name );
2580 /*****************************************************************************
2581 * Print a user-class v4l2 control's details, create the relevant variable,
2582 * change the value if needed.
2583 *****************************************************************************/
2584 static void ControlListPrint( vlc_object_t *p_obj, demux_sys_t *p_sys, int i_fd,
2585 struct v4l2_queryctrl queryctrl,
2586 bool b_reset, bool b_demux )
2588 struct v4l2_querymenu querymenu;
2595 vlc_value_t val, val2;
2597 if( queryctrl.flags & V4L2_CTRL_FLAG_GRABBED )
2598 msg_Dbg( p_obj, " control is busy" );
2599 if( queryctrl.flags & V4L2_CTRL_FLAG_READ_ONLY )
2600 msg_Dbg( p_obj, " control is read-only" );
2602 for( i = 0; controls[i].psz_name != NULL; i++ )
2603 if( controls[i].i_cid == queryctrl.id ) break;
2605 if( controls[i].psz_name )
2607 psz_name = strdup( controls[i].psz_name );
2608 char psz_cfg_name[40];
2609 sprintf( psz_cfg_name, CFG_PREFIX "%s", psz_name );
2610 i_val = var_CreateGetInteger( p_obj, psz_cfg_name );
2611 var_Destroy( p_obj, psz_cfg_name );
2615 psz_name = strdup( (const char *)queryctrl.name );
2616 name2var( (unsigned char *)psz_name );
2620 switch( queryctrl.type )
2622 case V4L2_CTRL_TYPE_INTEGER:
2623 msg_Dbg( p_obj, " integer control" );
2625 " valid values: %d to %d by steps of %d",
2626 queryctrl.minimum, queryctrl.maximum,
2629 var_Create( p_obj, psz_name,
2630 VLC_VAR_INTEGER | VLC_VAR_HASMIN | VLC_VAR_HASMAX
2631 | VLC_VAR_HASSTEP | VLC_VAR_ISCOMMAND );
2632 val.i_int = queryctrl.minimum;
2633 var_Change( p_obj, psz_name, VLC_VAR_SETMIN, &val, NULL );
2634 val.i_int = queryctrl.maximum;
2635 var_Change( p_obj, psz_name, VLC_VAR_SETMAX, &val, NULL );
2636 val.i_int = queryctrl.step;
2637 var_Change( p_obj, psz_name, VLC_VAR_SETSTEP, &val, NULL );
2639 case V4L2_CTRL_TYPE_BOOLEAN:
2640 msg_Dbg( p_obj, " boolean control" );
2641 var_Create( p_obj, psz_name,
2642 VLC_VAR_BOOL | VLC_VAR_ISCOMMAND );
2644 case V4L2_CTRL_TYPE_MENU:
2645 msg_Dbg( p_obj, " menu control" );
2646 var_Create( p_obj, psz_name,
2647 VLC_VAR_INTEGER | VLC_VAR_HASCHOICE
2648 | VLC_VAR_ISCOMMAND );
2649 memset( &querymenu, 0, sizeof( querymenu ) );
2650 for( i_mid = queryctrl.minimum;
2651 i_mid <= (unsigned)queryctrl.maximum;
2654 querymenu.index = i_mid;
2655 querymenu.id = queryctrl.id;
2656 if( v4l2_ioctl( i_fd, VIDIOC_QUERYMENU, &querymenu ) >= 0 )
2658 msg_Dbg( p_obj, " %d: %s",
2659 querymenu.index, querymenu.name );
2660 val.i_int = querymenu.index;
2661 val2.psz_string = (char *)querymenu.name;
2662 var_Change( p_obj, psz_name,
2663 VLC_VAR_ADDCHOICE, &val, &val2 );
2667 case V4L2_CTRL_TYPE_BUTTON:
2668 msg_Dbg( p_obj, " button control" );
2669 var_Create( p_obj, psz_name,
2670 VLC_VAR_VOID | VLC_VAR_ISCOMMAND );
2672 case V4L2_CTRL_TYPE_CTRL_CLASS:
2673 msg_Dbg( p_obj, " control class" );
2674 var_Create( p_obj, psz_name, VLC_VAR_VOID );
2677 msg_Dbg( p_obj, " unknown control type (FIXME)" );
2682 switch( queryctrl.type )
2684 case V4L2_CTRL_TYPE_INTEGER:
2685 case V4L2_CTRL_TYPE_BOOLEAN:
2686 case V4L2_CTRL_TYPE_MENU:
2688 struct v4l2_control control;
2689 msg_Dbg( p_obj, " default value: %d",
2690 queryctrl.default_value );
2691 memset( &control, 0, sizeof( control ) );
2692 control.id = queryctrl.id;
2693 if( v4l2_ioctl( i_fd, VIDIOC_G_CTRL, &control ) >= 0 )
2695 msg_Dbg( p_obj, " current value: %d", control.value );
2699 i_val = control.value;
2700 if( b_reset && queryctrl.default_value != control.value )
2702 msg_Dbg( p_obj, " reset value to default" );
2703 Control( p_obj, p_sys, i_fd, psz_name,
2704 queryctrl.id, queryctrl.default_value );
2709 Control( p_obj, p_sys, i_fd, psz_name,
2710 queryctrl.id, i_val );
2718 val.psz_string = (char *)queryctrl.name;
2719 var_Change( p_obj, psz_name, VLC_VAR_SETTEXT, &val, NULL );
2720 val.i_int = queryctrl.id;
2721 val2.psz_string = (char *)psz_name;
2722 var_Change( p_obj, "allcontrols", VLC_VAR_ADDCHOICE, &val, &val2 );
2723 /* bad things happen changing MPEG mid-stream
2724 * so don't add to Ext Settings GUI */
2725 if( V4L2_CTRL_ID2CLASS( queryctrl.id ) != V4L2_CTRL_CLASS_MPEG )
2726 var_Change( p_obj, "controls", VLC_VAR_ADDCHOICE, &val, &val2 );
2728 switch( var_Type( p_obj, psz_name ) & VLC_VAR_TYPE )
2731 var_SetBool( p_obj, psz_name, i_val );
2733 case VLC_VAR_INTEGER:
2734 var_SetInteger( p_obj, psz_name, i_val );
2739 msg_Warn( p_obj, "FIXME: %s %s %d", __FILE__, __func__,
2745 var_AddCallback( p_obj, psz_name,
2746 DemuxControlCallback, (void*)(intptr_t)queryctrl.id );
2748 var_AddCallback( p_obj, psz_name,
2749 AccessControlCallback, (void*)(intptr_t)queryctrl.id );
2754 /*****************************************************************************
2755 * List all user-class v4l2 controls, set them to the user specified
2756 * value and create the relevant variables to enable runtime changes
2757 *****************************************************************************/
2758 static int ControlList( vlc_object_t *p_obj, demux_sys_t *p_sys, int i_fd,
2759 bool b_reset, bool b_demux )
2761 struct v4l2_queryctrl queryctrl;
2764 memset( &queryctrl, 0, sizeof( queryctrl ) );
2766 /* A list of available controls (aka the variable name) will be
2767 * stored as choices in the "allcontrols" variable. We'll thus be able
2768 * to use those to create an appropriate interface
2769 * A list of available controls that can be changed mid-stream will
2770 * be stored in the "controls" variable */
2771 var_Create( p_obj, "controls", VLC_VAR_INTEGER | VLC_VAR_HASCHOICE );
2772 var_Create( p_obj, "allcontrols", VLC_VAR_INTEGER | VLC_VAR_HASCHOICE );
2774 var_Create( p_obj, "controls-update", VLC_VAR_VOID | VLC_VAR_ISCOMMAND );
2776 /* Add a control to reset all controls to their default values */
2777 vlc_value_t val, val2;
2778 var_Create( p_obj, "controls-reset", VLC_VAR_VOID | VLC_VAR_ISCOMMAND );
2779 val.psz_string = _( "Reset controls to default" );
2780 var_Change( p_obj, "controls-reset", VLC_VAR_SETTEXT, &val, NULL );
2782 val2.psz_string = (char *)"controls-reset";
2783 var_Change( p_obj, "controls", VLC_VAR_ADDCHOICE, &val, &val2 );
2785 var_AddCallback( p_obj, "controls-reset", DemuxControlResetCallback, NULL );
2787 var_AddCallback( p_obj, "controls-reset", AccessControlResetCallback, NULL );
2789 queryctrl.id = V4L2_CTRL_FLAG_NEXT_CTRL;
2790 if( v4l2_ioctl( i_fd, VIDIOC_QUERYCTRL, &queryctrl ) >= 0 )
2792 msg_Dbg( p_obj, "Extended control API supported by v4l2 driver" );
2794 /* List extended controls */
2795 queryctrl.id = V4L2_CTRL_FLAG_NEXT_CTRL;
2796 while( v4l2_ioctl( i_fd, VIDIOC_QUERYCTRL, &queryctrl ) >= 0 )
2798 if( queryctrl.type == V4L2_CTRL_TYPE_CTRL_CLASS )
2800 msg_Dbg( p_obj, "%s", queryctrl.name );
2801 queryctrl.id |= V4L2_CTRL_FLAG_NEXT_CTRL;
2804 switch( V4L2_CTRL_ID2CLASS( queryctrl.id ) )
2806 case V4L2_CTRL_CLASS_USER:
2807 msg_Dbg( p_obj, "Available control: %s (%x)",
2808 queryctrl.name, queryctrl.id );
2810 case V4L2_CTRL_CLASS_MPEG:
2811 name2var( queryctrl.name );
2812 msg_Dbg( p_obj, "Available MPEG control: %s (%x)",
2813 queryctrl.name, queryctrl.id );
2816 msg_Dbg( p_obj, "Available private control: %s (%x)",
2817 queryctrl.name, queryctrl.id );
2820 ControlListPrint( p_obj, p_sys, i_fd, queryctrl, b_reset, b_demux );
2821 queryctrl.id |= V4L2_CTRL_FLAG_NEXT_CTRL;
2826 msg_Dbg( p_obj, "Extended control API not supported by v4l2 driver" );
2828 /* List public controls */
2829 for( i_cid = V4L2_CID_BASE;
2830 i_cid < V4L2_CID_LASTP1;
2833 queryctrl.id = i_cid;
2834 if( v4l2_ioctl( i_fd, VIDIOC_QUERYCTRL, &queryctrl ) >= 0 )
2836 if( queryctrl.flags & V4L2_CTRL_FLAG_DISABLED )
2838 msg_Dbg( p_obj, "Available control: %s (%x)",
2839 queryctrl.name, queryctrl.id );
2840 ControlListPrint( p_obj, p_sys, i_fd, queryctrl,
2845 /* List private controls */
2846 for( i_cid = V4L2_CID_PRIVATE_BASE;
2850 queryctrl.id = i_cid;
2851 if( v4l2_ioctl( i_fd, VIDIOC_QUERYCTRL, &queryctrl ) >= 0 )
2853 if( queryctrl.flags & V4L2_CTRL_FLAG_DISABLED )
2855 msg_Dbg( p_obj, "Available private control: %s (%x)",
2856 queryctrl.name, queryctrl.id );
2857 ControlListPrint( p_obj, p_sys, i_fd, queryctrl,
2868 static void SetAvailControlsByString( vlc_object_t *p_obj, demux_sys_t *p_sys,
2871 char *psz_parser = p_sys->psz_set_ctrls;
2872 vlc_value_t val, text, name;
2874 if( psz_parser == NULL )
2877 if( *psz_parser == '{' )
2880 int i_ret = var_Change( p_obj, "allcontrols", VLC_VAR_GETCHOICES,
2884 msg_Err( p_obj, "Oops, can't find 'allcontrols' variable." );
2888 while( *psz_parser && *psz_parser != '}' )
2890 char *psz_delim, *psz_assign;
2892 while( *psz_parser == ',' || *psz_parser == ' ' )
2895 psz_delim = strchr( psz_parser, ',' );
2896 if( psz_delim == NULL )
2897 psz_delim = strchr( psz_parser, '}' );
2898 if( psz_delim == NULL )
2899 psz_delim = psz_parser + strlen( psz_parser );
2901 psz_assign = memchr( psz_parser, '=', psz_delim - psz_parser );
2902 if( psz_assign == NULL )
2904 char *psz_name = strndup( psz_parser, psz_delim - psz_parser );
2905 msg_Err( p_obj, "%s missing '='", psz_name );
2907 psz_parser = psz_delim + 1;
2912 i < val.p_list->i_count ;//&& psz_parser < psz_assign;
2915 const char *psz_var = text.p_list->p_values[i].psz_string;
2916 int i_cid = val.p_list->p_values[i].i_int;
2917 var_Change( p_obj, psz_var, VLC_VAR_GETTEXT, &name, NULL );
2918 const char *psz_name = name.psz_string;
2920 int i_availstrlen = strlen( psz_name );
2921 int i_parsestrlen = psz_assign - psz_parser;
2922 int i_maxstrlen = __MAX( i_availstrlen, i_parsestrlen);
2924 if( !strncasecmp( psz_name, psz_parser, i_maxstrlen ) )
2926 Control( p_obj, p_sys, i_fd, psz_name, i_cid,
2927 strtol( ++psz_assign, &psz_parser, 0) );
2929 free( name.psz_string );
2932 if( psz_parser < psz_assign )
2934 char *psz_name = strndup( psz_parser, psz_assign - psz_parser );
2935 msg_Err( p_obj, "Control %s not available", psz_name );
2937 psz_parser = ( *psz_delim ) ? ( psz_delim + 1 ) : psz_delim;
2940 var_FreeList( &val, &text );
2943 /*****************************************************************************
2944 * Reset all user-class v4l2 controls to their default value
2945 *****************************************************************************/
2946 static int ControlReset( vlc_object_t *p_obj, demux_sys_t *p_sys, int i_fd )
2948 struct v4l2_queryctrl queryctrl;
2950 memset( &queryctrl, 0, sizeof( queryctrl ) );
2952 queryctrl.id = V4L2_CTRL_FLAG_NEXT_CTRL;
2953 if( v4l2_ioctl( i_fd, VIDIOC_QUERYCTRL, &queryctrl ) >= 0 )
2955 /* Extended control API supported */
2956 queryctrl.id = V4L2_CTRL_FLAG_NEXT_CTRL;
2957 while( v4l2_ioctl( i_fd, VIDIOC_QUERYCTRL, &queryctrl ) >= 0 )
2959 if( queryctrl.type == V4L2_CTRL_TYPE_CTRL_CLASS
2960 || V4L2_CTRL_ID2CLASS( queryctrl.id ) == V4L2_CTRL_CLASS_MPEG )
2962 queryctrl.id |= V4L2_CTRL_FLAG_NEXT_CTRL;
2965 struct v4l2_control control;
2966 memset( &control, 0, sizeof( control ) );
2967 control.id = queryctrl.id;
2968 if( v4l2_ioctl( i_fd, VIDIOC_G_CTRL, &control ) >= 0
2969 && queryctrl.default_value != control.value )
2972 for( i = 0; controls[i].psz_name != NULL; i++ )
2973 if( controls[i].i_cid == queryctrl.id ) break;
2974 name2var( queryctrl.name );
2975 Control( p_obj, p_sys, i_fd,
2976 controls[i].psz_name ? controls[i].psz_name
2977 : (const char *)queryctrl.name,
2978 queryctrl.id, queryctrl.default_value );
2980 queryctrl.id |= V4L2_CTRL_FLAG_NEXT_CTRL;
2986 /* public controls */
2987 for( i_cid = V4L2_CID_BASE;
2988 i_cid < V4L2_CID_LASTP1;
2991 queryctrl.id = i_cid;
2992 if( v4l2_ioctl( i_fd, VIDIOC_QUERYCTRL, &queryctrl ) >= 0 )
2994 struct v4l2_control control;
2995 if( queryctrl.flags & V4L2_CTRL_FLAG_DISABLED )
2997 memset( &control, 0, sizeof( control ) );
2998 control.id = queryctrl.id;
2999 if( v4l2_ioctl( i_fd, VIDIOC_G_CTRL, &control ) >= 0
3000 && queryctrl.default_value != control.value )
3003 for( i = 0; controls[i].psz_name != NULL; i++ )
3004 if( controls[i].i_cid == queryctrl.id ) break;
3005 name2var( queryctrl.name );
3006 Control( p_obj, p_sys, i_fd,
3007 controls[i].psz_name ? controls[i].psz_name
3008 : (const char *)queryctrl.name,
3009 queryctrl.id, queryctrl.default_value );
3014 /* private controls */
3015 for( i_cid = V4L2_CID_PRIVATE_BASE;
3019 queryctrl.id = i_cid;
3020 if( v4l2_ioctl( i_fd, VIDIOC_QUERYCTRL, &queryctrl ) >= 0 )
3022 struct v4l2_control control;
3023 if( queryctrl.flags & V4L2_CTRL_FLAG_DISABLED )
3025 memset( &control, 0, sizeof( control ) );
3026 control.id = queryctrl.id;
3027 if( v4l2_ioctl( i_fd, VIDIOC_G_CTRL, &control ) >= 0
3028 && queryctrl.default_value != control.value )
3030 name2var( queryctrl.name );
3031 Control( p_obj, p_sys, i_fd, (const char *)queryctrl.name,
3032 queryctrl.id, queryctrl.default_value );
3042 /*****************************************************************************
3043 * Issue user-class v4l2 controls
3044 *****************************************************************************/
3045 static int Control( vlc_object_t *p_obj, demux_sys_t *p_sys, int i_fd,
3046 const char *psz_name, int i_cid, int i_value )
3049 struct v4l2_queryctrl queryctrl;
3050 struct v4l2_control control;
3051 struct v4l2_ext_control ext_control;
3052 struct v4l2_ext_controls ext_controls;
3057 memset( &queryctrl, 0, sizeof( queryctrl ) );
3059 queryctrl.id = i_cid;
3061 if( v4l2_ioctl( i_fd, VIDIOC_QUERYCTRL, &queryctrl ) < 0
3062 || queryctrl.flags & V4L2_CTRL_FLAG_DISABLED )
3064 msg_Dbg( p_obj, "%s (%x) control is not supported.", psz_name, i_cid );
3065 return VLC_EGENERIC;
3068 memset( &control, 0, sizeof( control ) );
3069 memset( &ext_control, 0, sizeof( ext_control ) );
3070 memset( &ext_controls, 0, sizeof( ext_controls ) );
3072 ext_control.id = i_cid;
3073 ext_controls.ctrl_class = V4L2_CTRL_ID2CLASS( i_cid );
3074 ext_controls.count = 1;
3075 ext_controls.controls = &ext_control;
3079 if( i_value >= queryctrl.minimum && i_value <= queryctrl.maximum )
3081 ext_control.value = i_value;
3082 if( v4l2_ioctl( i_fd, VIDIOC_S_EXT_CTRLS, &ext_controls ) < 0 )
3084 control.value = i_value;
3085 if( v4l2_ioctl( i_fd, VIDIOC_S_CTRL, &control ) < 0 )
3087 msg_Err( p_obj, "unable to set %s (%x) to %d (%m)",
3088 psz_name, i_cid, i_value );
3089 return VLC_EGENERIC;
3091 i_ret = v4l2_ioctl( i_fd, VIDIOC_G_CTRL, &control );
3095 i_ret = v4l2_ioctl( i_fd, VIDIOC_G_EXT_CTRLS, &ext_controls );
3096 control.value = ext_control.value;
3103 msg_Dbg( p_obj, "video %s: %d", psz_name, control.value );
3104 switch( var_Type( p_obj, psz_name ) & VLC_VAR_TYPE )
3107 val.b_bool = control.value;
3108 var_Change( p_obj, psz_name, VLC_VAR_SETVALUE, &val, NULL );
3109 var_TriggerCallback( p_obj, "controls-update" );
3111 case VLC_VAR_INTEGER:
3112 val.i_int = control.value;
3113 var_Change( p_obj, psz_name, VLC_VAR_SETVALUE, &val, NULL );
3114 var_TriggerCallback( p_obj, "controls-update" );
3121 /*****************************************************************************
3122 * On the fly change settings callback
3123 *****************************************************************************/
3124 static int DemuxControlCallback( vlc_object_t *p_this,
3125 const char *psz_var, vlc_value_t oldval, vlc_value_t newval,
3129 demux_t *p_demux = (demux_t*)p_this;
3130 demux_sys_t *p_sys = p_demux->p_sys;
3131 int i_cid = (long int)p_data;
3133 int i_fd = p_sys->i_fd;
3136 return VLC_EGENERIC;
3138 Control( p_this, p_sys, i_fd, psz_var, i_cid, newval.i_int );
3140 return VLC_EGENERIC;
3143 static int DemuxControlResetCallback( vlc_object_t *p_this,
3144 const char *psz_var, vlc_value_t oldval, vlc_value_t newval, void *p_data )
3146 (void)psz_var; (void)oldval; (void)newval; (void)p_data;
3147 demux_t *p_demux = (demux_t*)p_this;
3148 demux_sys_t *p_sys = p_demux->p_sys;
3150 int i_fd = p_sys->i_fd;
3153 return VLC_EGENERIC;
3155 ControlReset( p_this, p_sys, i_fd );
3157 return VLC_EGENERIC;
3160 static int AccessControlCallback( vlc_object_t *p_this,
3161 const char *psz_var, vlc_value_t oldval, vlc_value_t newval,
3165 access_t *p_access = (access_t *)p_this;
3166 demux_sys_t *p_sys = (demux_sys_t *) p_access->p_sys;
3167 int i_cid = (long int)p_data;
3169 int i_fd = p_sys->i_fd;
3172 return VLC_EGENERIC;
3174 Control( p_this, p_sys, i_fd, psz_var, i_cid, newval.i_int );
3176 return VLC_EGENERIC;
3179 static int AccessControlResetCallback( vlc_object_t *p_this,
3180 const char *psz_var, vlc_value_t oldval, vlc_value_t newval, void *p_data )
3182 (void)psz_var; (void)oldval; (void)newval; (void)p_data;
3183 access_t *p_access = (access_t *)p_this;
3184 demux_sys_t *p_sys = (demux_sys_t *) p_access->p_sys;
3186 int i_fd = p_sys->i_fd;
3189 return VLC_EGENERIC;
3191 ControlReset( p_this, p_sys, i_fd );
3193 return VLC_EGENERIC;