3 * Copyright (C) 2001-2002 Ronald Bultje <rbultje@ronald.bitfreak.net>
4 * 2006 Edgard Lima <edgard.lima@indt.org.br>
6 * gstv4l2.c: plugin for v4l2 elements
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Library General Public
10 * License as published by the Free Software Foundation; either
11 * version 2 of the License, or (at your option) any later version.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Library General Public License for more details.
18 * You should have received a copy of the GNU Library General Public
19 * License along with this library; if not, write to the
20 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
21 * Boston, MA 02110-1301, USA.
29 # define _GNU_SOURCE /* O_CLOEXEC */
32 #include "gst/gst-i18n-plugin.h"
39 #include <sys/types.h>
42 #include "ext/videodev2.h"
43 #include "v4l2-utils.h"
45 #include "gstv4l2object.h"
46 #include "gstv4l2src.h"
47 #include "gstv4l2sink.h"
48 #include "gstv4l2radio.h"
49 #include "gstv4l2videodec.h"
50 #include "gstv4l2deviceprovider.h"
51 #include "gstv4l2transform.h"
53 /* used in v4l2_calls.c and v4l2src_calls.c */
54 GST_DEBUG_CATEGORY (v4l2_debug);
55 #define GST_CAT_DEFAULT v4l2_debug
57 #ifdef GST_V4L2_ENABLE_PROBE
58 /* This is a minimalist probe, for speed, we only enumerate formats */
60 gst_v4l2_probe_template_caps (const gchar * device, gint video_fd,
61 enum v4l2_buf_type type)
64 struct v4l2_fmtdesc format;
67 GST_DEBUG ("Getting %s format enumerations", device);
68 caps = gst_caps_new_empty ();
71 GstStructure *template;
73 memset (&format, 0, sizeof (format));
78 if (ioctl (video_fd, VIDIOC_ENUM_FMT, &format) < 0)
79 break; /* end of enumeration */
81 GST_LOG ("index: %u", format.index);
82 GST_LOG ("type: %d", format.type);
83 GST_LOG ("flags: %08x", format.flags);
84 GST_LOG ("description: '%s'", format.description);
85 GST_LOG ("pixelformat: %" GST_FOURCC_FORMAT,
86 GST_FOURCC_ARGS (format.pixelformat));
88 template = gst_v4l2_object_v4l2fourcc_to_structure (format.pixelformat);
91 GstStructure *alt_t = NULL;
93 switch (format.pixelformat) {
94 case V4L2_PIX_FMT_RGB32:
95 alt_t = gst_structure_copy (template);
96 gst_structure_set (alt_t, "format", G_TYPE_STRING, "ARGB", NULL);
98 case V4L2_PIX_FMT_BGR32:
99 alt_t = gst_structure_copy (template);
100 gst_structure_set (alt_t, "format", G_TYPE_STRING, "BGRA", NULL);
105 gst_caps_append_structure (caps, template);
108 gst_caps_append_structure (caps, alt_t);
112 return gst_caps_simplify (caps);
116 gst_v4l2_probe_and_register (GstPlugin * plugin)
120 struct v4l2_capability vcap;
123 it = gst_v4l2_iterator_new ();
125 while (gst_v4l2_iterator_next (it)) {
126 GstCaps *src_caps, *sink_caps;
132 video_fd = open (it->device_path, O_RDWR | O_CLOEXEC);
134 if (video_fd == -1) {
135 GST_DEBUG ("Failed to open %s: %s", it->device_path, g_strerror (errno));
139 memset (&vcap, 0, sizeof (vcap));
141 if (ioctl (video_fd, VIDIOC_QUERYCAP, &vcap) < 0) {
142 GST_DEBUG ("Failed to get device capabilities: %s", g_strerror (errno));
146 if (!((vcap.capabilities & (V4L2_CAP_VIDEO_M2M |
147 V4L2_CAP_VIDEO_M2M_MPLANE)) ||
148 /* But legacy driver may expose both CAPTURE and OUTPUT */
149 ((vcap.capabilities &
150 (V4L2_CAP_VIDEO_CAPTURE | V4L2_CAP_VIDEO_CAPTURE_MPLANE)) &&
152 (V4L2_CAP_VIDEO_OUTPUT | V4L2_CAP_VIDEO_OUTPUT_MPLANE)))))
155 GST_DEBUG ("Probing '%s' located at '%s'",
156 it->device_name ? it->device_name : (const gchar *) vcap.driver,
159 /* get sink supported format (no MPLANE for codec) */
160 sink_caps = gst_caps_merge (gst_v4l2_probe_template_caps (it->device_path,
161 video_fd, V4L2_BUF_TYPE_VIDEO_OUTPUT),
162 gst_v4l2_probe_template_caps (it->device_path, video_fd,
163 V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE));
165 /* get src supported format */
166 src_caps = gst_caps_merge (gst_v4l2_probe_template_caps (it->device_path,
167 video_fd, V4L2_BUF_TYPE_VIDEO_CAPTURE),
168 gst_v4l2_probe_template_caps (it->device_path, video_fd,
169 V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE));
171 /* Skip devices without any supported formats */
172 if (gst_caps_is_empty (sink_caps) || gst_caps_is_empty (src_caps)) {
173 gst_caps_unref (sink_caps);
174 gst_caps_unref (src_caps);
178 basename = g_path_get_basename (it->device_path);
180 if (gst_v4l2_is_video_dec (sink_caps, src_caps))
181 ret = gst_v4l2_video_dec_register (plugin, basename, it->device_path,
182 sink_caps, src_caps);
183 else if (gst_v4l2_is_transform (sink_caps, src_caps))
184 ret = gst_v4l2_transform_register (plugin, basename, it->device_path,
185 sink_caps, src_caps);
186 /* else if ( ... etc. */
188 gst_caps_unref (sink_caps);
189 gst_caps_unref (src_caps);
199 gst_v4l2_iterator_free (it);
206 plugin_init (GstPlugin * plugin)
208 const gchar *paths[] = { "/dev", "/dev/v4l2", NULL };
209 const gchar *names[] = { "video", NULL };
211 GST_DEBUG_CATEGORY_INIT (v4l2_debug, "v4l2", 0, "V4L2 API calls");
213 /* Add some depedency, so the dynamic features get updated upon changes in
215 gst_plugin_add_dependency (plugin,
216 NULL, paths, names, GST_PLUGIN_DEPENDENCY_FLAG_FILE_NAME_IS_PREFIX);
218 if (!gst_element_register (plugin, "v4l2src", GST_RANK_PRIMARY,
220 !gst_element_register (plugin, "v4l2sink", GST_RANK_NONE,
221 GST_TYPE_V4L2SINK) ||
222 !gst_element_register (plugin, "v4l2radio", GST_RANK_NONE,
223 GST_TYPE_V4L2RADIO) ||
224 !gst_device_provider_register (plugin, "v4l2deviceprovider",
225 GST_RANK_PRIMARY, GST_TYPE_V4L2_DEVICE_PROVIDER)
227 #ifdef GST_V4L2_ENABLE_PROBE
228 || !gst_v4l2_probe_and_register (plugin)
234 bindtextdomain (GETTEXT_PACKAGE, LOCALEDIR);
235 bind_textdomain_codeset (GETTEXT_PACKAGE, "UTF-8");
236 #endif /* ENABLE_NLS */
241 GST_PLUGIN_DEFINE (GST_VERSION_MAJOR,
244 "elements for Video 4 Linux",
245 plugin_init, VERSION, GST_LICENSE, GST_PACKAGE_NAME, GST_PACKAGE_ORIGIN)