1 /*
2 * Copyright (c) 2000,2001 Fabrice Bellard
3 * Copyright (c) 2006 Luca Abeni
4 *
5 * This file is part of FFmpeg.
6 *
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
11 *
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
16 *
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20 */
21
22 /**
23 * @file
24 * Video4Linux2 grab interface
25 *
26 * Part of this file is based on the V4L2 video capture example
27 * (http://linuxtv.org/downloads/v4l-dvb-apis/capture-example.html)
28 *
29 * Thanks to Michael Niedermayer for providing the mapping between
30 * V4L2_PIX_FMT_* and AV_PIX_FMT_*
31 */
32
34 #include <dirent.h>
35
36 #if CONFIG_LIBV4L2
37 #include <libv4l2.h>
38 #endif
39
41
42 #define V4L_ALLFORMATS 3
43 #define V4L_RAWFORMATS 1
44 #define V4L_COMPFORMATS 2
45
46 /**
47 * Return timestamps to the user exactly as returned by the kernel
48 */
49 #define V4L_TS_DEFAULT 0
50 /**
51 * Autodetect the kind of timestamps returned by the kernel and convert to
52 * absolute (wall clock) timestamps.
53 */
55 /**
56 * Assume kernel timestamps are from the monotonic clock and convert to
57 * absolute timestamps.
58 */
59 #define V4L_TS_MONO2ABS 2
60
61 /**
62 * Once the kind of timestamps returned by the kernel have been detected,
63 * the value of the timefilter (NULL or not) determines whether a conversion
64 * takes place.
65 */
66 #define V4L_TS_CONVERT_READY V4L_TS_DEFAULT
67
79
91
93 int (*
open_f)(
const char *file,
int oflag, ...);
96 int (*
ioctl_f)(
int fd,
unsigned long int request, ...);
100 };
101
105 };
106
108 {
110 struct v4l2_capability cap;
111 int fd;
112 int err;
114
115 #define SET_WRAPPERS(prefix) do { \
116 s->open_f = prefix ## open; \
117 s->close_f = prefix ## close; \
118 s->dup_f = prefix ## dup; \
119 s->ioctl_f = prefix ## ioctl; \
120 s->read_f = prefix ## read; \
121 s->mmap_f = prefix ## mmap; \
122 s->munmap_f = prefix ## munmap; \
123 } while (0)
124
126 #if CONFIG_LIBV4L2
128 #else
131 #endif
132 } else {
134 }
135
136 #define v4l2_open s->open_f
137 #define v4l2_close s->close_f
138 #define v4l2_dup s->dup_f
139 #define v4l2_ioctl s->ioctl_f
140 #define v4l2_read s->read_f
141 #define v4l2_mmap s->mmap_f
142 #define v4l2_munmap s->munmap_f
143
145 flags |= O_NONBLOCK;
146 }
147
149 if (fd < 0) {
153 return err;
154 }
155
156 if (
v4l2_ioctl(fd, VIDIOC_QUERYCAP, &cap) < 0) {
160 goto fail;
161 }
162
164 fd, cap.capabilities);
165
166 if (!(cap.capabilities & V4L2_CAP_VIDEO_CAPTURE)) {
169 goto fail;
170 }
171
172 if (!(cap.capabilities & V4L2_CAP_STREAMING)) {
174 "The device does not support the streaming I/O method.\n");
176 goto fail;
177 }
178
179 return fd;
180
181 fail:
183 return err;
184 }
185
187 uint32_t pixelformat)
188 {
190 struct v4l2_format fmt = { .type = V4L2_BUF_TYPE_VIDEO_CAPTURE };
191 int res = 0;
192
193 fmt.fmt.pix.width = *
width;
194 fmt.fmt.pix.height = *
height;
195 fmt.fmt.pix.pixelformat = pixelformat;
196 fmt.fmt.pix.field = V4L2_FIELD_ANY;
197
198 /* Some drivers will fail and return EINVAL when the pixelformat
199 is not supported (even if type field is valid and supported) */
202
203 if ((*width != fmt.fmt.pix.width) || (*height != fmt.fmt.pix.height)) {
205 "The V4L2 driver changed the video from %dx%d to %dx%d\n",
206 *width, *height, fmt.fmt.pix.width, fmt.fmt.pix.height);
207 *width = fmt.fmt.pix.width;
208 *height = fmt.fmt.pix.height;
209 }
210
211 if (pixelformat != fmt.fmt.pix.pixelformat) {
213 "The V4L2 driver changed the pixel format "
214 "from 0x%08X to 0x%08X\n",
215 pixelformat, fmt.fmt.pix.pixelformat);
217 }
218
219 if (fmt.fmt.pix.field == V4L2_FIELD_INTERLACED) {
221 "The V4L2 driver is using the interlaced mode\n");
223 }
224
225 return res;
226 }
227
229 {
230 int res;
231 v4l2_std_id std;
232
234 if (res < 0)
235 return 0;
236 if (std & V4L2_STD_NTSC)
237 return 0;
238
239 return 1;
240 }
241
242 #if HAVE_STRUCT_V4L2_FRMIVALENUM_DISCRETE
243 static void list_framesizes(
AVFormatContext *ctx, uint32_t pixelformat)
244 {
246 struct v4l2_frmsizeenum vfse = { .pixel_format = pixelformat };
247
248 while(!
v4l2_ioctl(s->
fd, VIDIOC_ENUM_FRAMESIZES, &vfse)) {
249 switch (vfse.type) {
250 case V4L2_FRMSIZE_TYPE_DISCRETE:
252 vfse.discrete.width, vfse.discrete.height);
253 break;
254 case V4L2_FRMSIZE_TYPE_CONTINUOUS:
255 case V4L2_FRMSIZE_TYPE_STEPWISE:
257 vfse.stepwise.min_width,
258 vfse.stepwise.max_width,
259 vfse.stepwise.step_width,
260 vfse.stepwise.min_height,
261 vfse.stepwise.max_height,
262 vfse.stepwise.step_height);
263 }
264 vfse.index++;
265 }
266 }
267 #endif
268
270 {
272 struct v4l2_fmtdesc vfd = { .type = V4L2_BUF_TYPE_VIDEO_CAPTURE };
273
277
278 vfd.index++;
279
280 if (!(vfd.flags & V4L2_FMT_FLAG_COMPRESSED) &&
284 fmt_name ? fmt_name : "Unsupported",
285 vfd.description);
286 } else if (vfd.flags & V4L2_FMT_FLAG_COMPRESSED &&
290 desc ? desc->
name :
"Unsupported",
291 vfd.description);
292 } else {
293 continue;
294 }
295
296 #ifdef V4L2_FMT_FLAG_EMULATED
297 if (vfd.flags & V4L2_FMT_FLAG_EMULATED)
299 #endif
300 #if HAVE_STRUCT_V4L2_FRMIVALENUM_DISCRETE
301 list_framesizes(ctx, vfd.pixelformat);
302 #endif
304 }
305 }
306
308 {
311 struct v4l2_standard standard;
312
314 return;
315
316 for (standard.index = 0; ; standard.index++) {
320 break;
321 } else {
323 return;
324 }
325 }
327 standard.index, (uint64_t)standard.id, standard.name);
328 }
329 }
330
332 {
333 int i, res;
335 struct v4l2_requestbuffers req = {
336 .type = V4L2_BUF_TYPE_VIDEO_CAPTURE,
338 .memory = V4L2_MEMORY_MMAP
339 };
340
344 return res;
345 }
346
347 if (req.count < 2) {
350 }
356 }
362 }
363
364 for (i = 0; i < req.count; i++) {
365 struct v4l2_buffer buf = {
366 .type = V4L2_BUF_TYPE_VIDEO_CAPTURE,
367 .index = i,
368 .memory = V4L2_MEMORY_MMAP
369 };
373 return res;
374 }
375
379 "buf_len[%d] = %d < expected frame size %d\n",
382 }
384 PROT_READ | PROT_WRITE, MAP_SHARED,
385 s->
fd, buf.m.offset);
386
390 return res;
391 }
392 }
393
394 return 0;
395 }
396
397 #if FF_API_DESTRUCT_PACKET
399 {
401 }
402 #endif
403
405 {
406 int res = 0;
407
411 } else {
413 }
414
415 return res;
416 }
417
419 {
420 struct v4l2_buffer buf = { 0 };
421 struct buff_data *buf_descriptor = opaque;
423
424 buf.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
425 buf.memory = V4L2_MEMORY_MMAP;
426 buf.index = buf_descriptor->
index;
428
430 }
431
432 #if HAVE_CLOCK_GETTIME && defined(CLOCK_MONOTONIC)
433 static int64_t av_gettime_monotonic(void)
434 {
436 }
437 #endif
438
440 {
442 int64_t now;
443
446 ts <= now + 1 * AV_TIME_BASE && ts >= now - 10 *
AV_TIME_BASE) {
449 return 0;
450 }
451 #if HAVE_CLOCK_GETTIME && defined(CLOCK_MONOTONIC)
453 now = av_gettime_monotonic();
455 (ts <= now + 1 * AV_TIME_BASE && ts >= now - 10 *
AV_TIME_BASE)) {
459 /* microseconds instead of seconds, MHz instead of Hz */
464 return 0;
465 }
466 }
467 #endif
470 }
471
473 {
475
478 if (r < 0)
480 }
481 #if HAVE_CLOCK_GETTIME && defined(CLOCK_MONOTONIC)
484 int64_t nowm = av_gettime_monotonic();
488 }
489 #endif
490 return 0;
491 }
492
494 {
496 struct v4l2_buffer buf = {
497 .type = V4L2_BUF_TYPE_VIDEO_CAPTURE,
498 .memory = V4L2_MEMORY_MMAP
499 };
500 int res;
501
502 /* FIXME: Some special treatment might be needed in case of loss of signal... */
503 while ((res =
v4l2_ioctl(s->
fd, VIDIOC_DQBUF, &buf)) < 0 && (errno == EINTR));
504 if (res < 0) {
505 if (errno == EAGAIN) {
508 }
512 return res;
513 }
514
518 }
520 // always keep at least one buffer queued
522
523 /* CPIA is a compressed format and we don't know the exact number of bytes
524 * used by a frame, so set it here as the driver announces it.
525 */
528
531 "The v4l2 frame is %d bytes, but %d bytes are expected\n",
535 }
536
537 /* Image is at s->buff_start[buf.index] */
539 /* when we start getting low on queued buffers, fall back on copying data */
541 if (res < 0) {
544 return res;
545 }
547
549 if (res) {
551 return res;
552 }
553 } else {
555
557 pkt->
size = buf.bytesused;
558 #if FF_API_DESTRUCT_PACKET
560 pkt->
destruct = dummy_release_buffer;
562 #endif
563
565 if (!buf_descriptor) {
566 /* Something went wrong... Since av_malloc() failed, we cannot even
567 * allocate a buffer for memcpying into it
568 */
571
573 }
574 buf_descriptor->index = buf.index;
575 buf_descriptor->s =
s;
576
578 buf_descriptor, 0);
584 }
585 }
586 pkt->
pts = buf.timestamp.tv_sec * INT64_C(1000000) + buf.timestamp.tv_usec;
588
590 }
591
593 {
595 enum v4l2_buf_type
type;
596 int i, res;
597
598 for (i = 0; i < s->
buffers; i++) {
599 struct v4l2_buffer buf = {
600 .type = V4L2_BUF_TYPE_VIDEO_CAPTURE,
601 .index = i,
602 .memory = V4L2_MEMORY_MMAP
603 };
604
609 return res;
610 }
611 }
613
614 type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
619 return res;
620 }
621
622 return 0;
623 }
624
626 {
627 enum v4l2_buf_type
type;
628 int i;
629
630 type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
631 /* We do not check for the result, because we could
632 * not do anything about it anyway...
633 */
635 for (i = 0; i < s->
buffers; i++) {
637 }
640 }
641
643 {
645 struct v4l2_standard standard = { 0 };
646 struct v4l2_streamparm streamparm = { 0 };
647 struct v4l2_fract *tpf;
650
656 }
657
660 ret = 0;
662 /* set tv standard */
663 for (i = 0; ; i++) {
664 standard.index = i;
667 break;
668 }
670 break;
671 }
672 if (ret < 0) {
675 }
676
677 if (
v4l2_ioctl(s->
fd, VIDIOC_S_STD, &standard.id) < 0) {
681 }
682 } else {
684 "This device does not support any standard\n");
685 }
686 }
687
688 /* get standard */
690 tpf = &standard.frameperiod;
691 for (i = 0; ; i++) {
692 standard.index = i;
696 #ifdef ENODATA
698 #endif
699 ) {
700 tpf = &streamparm.parm.capture.timeperframe;
701 break;
702 }
705 }
706 if (standard.id == s->
std_id) {
708 "Current standard: %s, id: %"PRIx64", frameperiod: %d/%d\n",
709 standard.name, (uint64_t)standard.id, tpf->numerator, tpf->denominator);
710 break;
711 }
712 }
713 } else {
714 tpf = &streamparm.parm.capture.timeperframe;
715 }
716
717 streamparm.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
718 if (
v4l2_ioctl(s->
fd, VIDIOC_G_PARM, &streamparm) < 0) {
722 }
723
724 if (framerate_q.
num && framerate_q.
den) {
725 if (streamparm.parm.capture.capability & V4L2_CAP_TIMEPERFRAME) {
726 tpf = &streamparm.parm.capture.timeperframe;
727
729 framerate_q.
den, framerate_q.
num);
730 tpf->numerator = framerate_q.
den;
731 tpf->denominator = framerate_q.
num;
732
733 if (
v4l2_ioctl(s->
fd, VIDIOC_S_PARM, &streamparm) < 0) {
738 }
739
740 if (framerate_q.
num != tpf->denominator ||
741 framerate_q.
den != tpf->numerator) {
743 "The driver changed the time per frame from "
744 "%d/%d to %d/%d\n",
745 framerate_q.
den, framerate_q.
num,
746 tpf->numerator, tpf->denominator);
747 }
748 } else {
750 "The driver does not permit changing the time per frame\n");
751 }
752 }
753 if (tpf->denominator > 0 && tpf->numerator > 0) {
757 } else
759
760 return 0;
761 }
762
767 uint32_t *desired_format,
769 {
771
773
774 if (*desired_format) {
775 ret =
device_init(ctx, width, height, *desired_format);
776 if (ret < 0) {
777 *desired_format = 0;
780 }
781 }
782
783 if (!*desired_format) {
790
792 ret =
device_init(ctx, width, height, *desired_format);
793 if (ret >= 0)
794 break;
795 else if (ret !=
AVERROR(EINVAL))
797 *desired_format = 0;
798 }
799 }
800
801 if (*desired_format == 0) {
803 "codec '%s' (id %d), pixel format '%s' (id %d)\n",
807 }
808 }
809
813 }
814
816 {
819 return 0;
820 }
821
823 {
826 int res = 0;
827 uint32_t desired_format;
830 struct v4l2_input input = { 0 };
831
833 if (!st)
835
836 #if CONFIG_LIBV4L2
837 /* silence libv4l2 logging. if fopen() fails v4l2_log_file will be NULL
838 and errors will get sent to stderr */
840 v4l2_log_file = fopen("/dev/null", "w");
841 #endif
842
846
848 /* set video input */
853 goto fail;
854 }
855 } else {
856 /* get current video input */
860 goto fail;
861 }
862 }
863
864 /* enum input */
869 goto fail;
870 }
872 av_log(ctx,
AV_LOG_DEBUG,
"Current input_channel: %d, input_name: %s, input_std: %"PRIx64
"\n",
873 s->
channel, input.name, (uint64_t)input.std);
874
878 goto fail;
879 }
880
884 goto fail;
885 }
886
888
891
892 if (codec)
894
896
900
902 goto fail;
903 }
904 }
905
907 struct v4l2_format fmt = { .type = V4L2_BUF_TYPE_VIDEO_CAPTURE };
908
910 "Querying the device for the current frame size\n");
915 goto fail;
916 }
917
918 s->
width = fmt.fmt.pix.width;
919 s->
height = fmt.fmt.pix.height;
921 "Setting frame size to %dx%d\n", s->
width, s->
height);
922 }
923
925 if (res < 0)
926 goto fail;
927
928 /* If no pixel_format was specified, the codec_id was not known up
929 * until now. Set video_codec_id in the context, as codec_id will
930 * not be available outside this function
931 */
934
936 goto fail;
937
939
941 goto fail;
942
946
949 goto fail;
950
952
960 }
961 if (desired_format == V4L2_PIX_FMT_YVU420)
963 else if (desired_format == V4L2_PIX_FMT_YVU410)
969
970 return 0;
971
972 fail:
974 return res;
975 }
976
978 {
981 int res;
982
985 return res;
986 }
987
991 }
992
994 }
995
997 {
999
1002 "close.\n");
1003
1005
1007 return 0;
1008 }
1009
1011 {
1012 return !strncmp(name, "video", 5) ||
1013 !strncmp(name, "radio", 5) ||
1014 !strncmp(name, "vbi", 3) ||
1015 !strncmp(name, "v4l-subdev", 10);
1016 }
1017
1019 {
1021 DIR *dir;
1022 struct dirent *entry;
1024 struct v4l2_capability cap;
1026
1027 if (!device_list)
1029
1030 dir = opendir("/dev");
1031 if (!dir) {
1035 }
1036 while ((entry = readdir(dir))) {
1038 continue;
1039
1042 continue;
1043
1047 goto fail;
1048 }
1049
1051 if (!device) {
1053 goto fail;
1054 }
1059 goto fail;
1060 }
1061
1064 goto fail;
1065
1068 continue;
1069
1070 fail:
1071 if (device) {
1075 }
1079 break;
1080 }
1081 closedir(dir);
1083 }
1084
1085 #define OFFSET(x) offsetof(struct video_data, x)
1086 #define DEC AV_OPT_FLAG_DECODING_PARAM
1087
1090 {
"channel",
"set TV channel, used only by frame grabber",
OFFSET(channel),
AV_OPT_TYPE_INT, {.i64 = -1 }, -1, INT_MAX,
DEC },
1095
1096 {
"list_formats",
"list available formats and exit",
OFFSET(list_format),
AV_OPT_TYPE_INT, {.i64 = 0 }, 0, INT_MAX,
DEC,
"list_formats" },
1100
1101 {
"list_standards",
"list supported standards and exit",
OFFSET(list_standard),
AV_OPT_TYPE_INT, {.i64 = 0 }, 0, 1,
DEC,
"list_standards" },
1102 {
"all",
"show all supported standards",
OFFSET(list_standard),
AV_OPT_TYPE_CONST, {.i64 = 1 }, 0, 0,
DEC,
"list_standards" },
1103
1104 {
"timestamps",
"set type of timestamps for grabbed frames",
OFFSET(ts_mode),
AV_OPT_TYPE_INT, {.i64 = 0 }, 0, 2,
DEC,
"timestamps" },
1105 {
"ts",
"set type of timestamps for grabbed frames",
OFFSET(ts_mode),
AV_OPT_TYPE_INT, {.i64 = 0 }, 0, 2,
DEC,
"timestamps" },
1109 {
"use_libv4l2",
"use libv4l2 (v4l-utils) conversion functions",
OFFSET(use_libv4l2),
AV_OPT_TYPE_INT, {.i64 = 0}, 0, 1,
DEC },
1111 };
1112
1119 };
1120
1122 .
name =
"video4linux2,v4l2",
1132 };