3 * Copyright (C) 2001-2002 Ronald Bultje <rbultje@ronald.bitfreak.net>
4 * 2006 Edgard Lima <edgard.lima@gmail.com>
5 * 2009 Texas Instruments, Inc - http://www.ti.com/
7 * gstv4l2bufferpool.c V4L2 buffer pool class
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Library General Public
11 * License as published by the Free Software Foundation; either
12 * version 2 of the License, or (at your option) any later version.
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Library General Public License for more details.
19 * You should have received a copy of the GNU Library General Public
20 * License along with this library; if not, write to the
21 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
22 * Boston, MA 02110-1301, USA.
30 # define _GNU_SOURCE /* O_CLOEXEC */
38 #include "gst/video/video.h"
39 #include "gst/video/gstvideometa.h"
40 #include "gst/video/gstvideopool.h"
41 #include "gst/allocators/gstdmabuf.h"
43 #include <gstv4l2bufferpool.h>
45 #include "v4l2_calls.h"
46 #include "gst/gst-i18n-plugin.h"
47 #include <gst/glib-compat-private.h>
49 GST_DEBUG_CATEGORY_STATIC (v4l2bufferpool_debug);
50 GST_DEBUG_CATEGORY_STATIC (CAT_PERFORMANCE);
51 #define GST_CAT_DEFAULT v4l2bufferpool_debug
53 #define GST_V4L2_IMPORT_QUARK gst_v4l2_buffer_pool_import_quark ()
59 #define gst_v4l2_buffer_pool_parent_class parent_class
60 G_DEFINE_TYPE (GstV4l2BufferPool, gst_v4l2_buffer_pool, GST_TYPE_BUFFER_POOL);
62 enum _GstV4l2BufferPoolAcquireFlags
64 GST_V4L2_BUFFER_POOL_ACQUIRE_FLAG_RESURRECT =
65 GST_BUFFER_POOL_ACQUIRE_FLAG_LAST,
66 GST_V4L2_BUFFER_POOL_ACQUIRE_FLAG_LAST
69 static void gst_v4l2_buffer_pool_release_buffer (GstBufferPool * bpool,
73 gst_v4l2_is_buffer_valid (GstBuffer * buffer, GstV4l2MemoryGroup ** out_group)
75 GstMemory *mem = gst_buffer_peek_memory (buffer, 0);
76 gboolean valid = FALSE;
78 if (GST_BUFFER_FLAG_IS_SET (buffer, GST_BUFFER_FLAG_TAG_MEMORY))
81 if (gst_is_dmabuf_memory (mem))
82 mem = gst_mini_object_get_qdata (GST_MINI_OBJECT (mem),
83 GST_V4L2_MEMORY_QUARK);
85 if (mem && gst_is_v4l2_memory (mem)) {
86 GstV4l2Memory *vmem = (GstV4l2Memory *) mem;
87 GstV4l2MemoryGroup *group = vmem->group;
90 if (group->n_mem != gst_buffer_n_memory (buffer))
93 for (i = 0; i < group->n_mem; i++) {
94 if (group->mem[i] != gst_buffer_peek_memory (buffer, i))
97 if (!gst_memory_is_writable (group->mem[i]))
111 gst_v4l2_buffer_pool_copy_buffer (GstV4l2BufferPool * pool, GstBuffer * dest,
114 const GstVideoFormatInfo *finfo = pool->caps_info.finfo;
116 GST_LOG_OBJECT (pool, "copying buffer");
118 if (finfo && (finfo->format != GST_VIDEO_FORMAT_UNKNOWN &&
119 finfo->format != GST_VIDEO_FORMAT_ENCODED)) {
120 GstVideoFrame src_frame, dest_frame;
122 GST_DEBUG_OBJECT (pool, "copy video frame");
124 /* we have raw video, use videoframe copy to get strides right */
125 if (!gst_video_frame_map (&src_frame, &pool->caps_info, src, GST_MAP_READ))
128 if (!gst_video_frame_map (&dest_frame, &pool->caps_info, dest,
130 gst_video_frame_unmap (&src_frame);
134 gst_video_frame_copy (&dest_frame, &src_frame);
136 gst_video_frame_unmap (&src_frame);
137 gst_video_frame_unmap (&dest_frame);
141 GST_DEBUG_OBJECT (pool, "copy raw bytes");
143 if (!gst_buffer_map (src, &map, GST_MAP_READ))
146 gst_buffer_fill (dest, 0, map.data, gst_buffer_get_size (src));
148 gst_buffer_unmap (src, &map);
149 gst_buffer_resize (dest, 0, gst_buffer_get_size (src));
152 gst_buffer_copy_into (dest, src,
153 GST_BUFFER_COPY_FLAGS | GST_BUFFER_COPY_TIMESTAMPS, 0, -1);
155 GST_CAT_LOG_OBJECT (CAT_PERFORMANCE, pool, "slow copy into buffer %p", dest);
161 GST_ERROR_OBJECT (pool, "could not map buffer");
162 return GST_FLOW_ERROR;
175 gst_v4l2_buffer_pool_import_quark (void)
177 static GQuark quark = 0;
180 quark = g_quark_from_string ("GstV4l2BufferPoolUsePtrData");
186 _unmap_userptr_frame (struct UserPtrData *data)
189 gst_video_frame_unmap (&data->frame);
191 gst_buffer_unmap (data->buffer, &data->map);
194 gst_buffer_unref (data->buffer);
196 g_slice_free (struct UserPtrData, data);
200 gst_v4l2_buffer_pool_import_userptr (GstV4l2BufferPool * pool,
201 GstBuffer * dest, GstBuffer * src)
203 GstFlowReturn ret = GST_FLOW_OK;
204 GstV4l2MemoryGroup *group = NULL;
206 const GstVideoFormatInfo *finfo = pool->caps_info.finfo;
207 struct UserPtrData *data = NULL;
209 GST_LOG_OBJECT (pool, "importing userptr");
212 if (!gst_v4l2_is_buffer_valid (dest, &group))
215 if (V4L2_TYPE_IS_OUTPUT (pool->obj->type))
216 flags = GST_MAP_READ;
218 flags = GST_MAP_WRITE;
220 data = g_slice_new0 (struct UserPtrData);
222 if (finfo && (finfo->format != GST_VIDEO_FORMAT_UNKNOWN &&
223 finfo->format != GST_VIDEO_FORMAT_ENCODED)) {
224 gsize size[GST_VIDEO_MAX_PLANES] = { 0, };
227 data->is_frame = TRUE;
229 if (!gst_video_frame_map (&data->frame, &pool->caps_info, src, flags))
232 for (i = 0; i < GST_VIDEO_FORMAT_INFO_N_PLANES (finfo); i++) {
233 if (GST_VIDEO_FORMAT_INFO_IS_TILED (finfo)) {
234 gint tinfo = GST_VIDEO_FRAME_PLANE_STRIDE (&data->frame, i);
238 pstride = GST_VIDEO_TILE_X_TILES (tinfo) <<
239 GST_VIDEO_FORMAT_INFO_TILE_WS (finfo);
241 pheight = GST_VIDEO_TILE_Y_TILES (tinfo) <<
242 GST_VIDEO_FORMAT_INFO_TILE_HS (finfo);
244 size[i] = pstride * pheight;
246 size[i] = GST_VIDEO_FRAME_PLANE_STRIDE (&data->frame, i) *
247 GST_VIDEO_FRAME_COMP_HEIGHT (&data->frame, i);
251 /* In the single planar API, planes must be contiguous in memory and
252 * therefore they must have expected size. ie: no padding.
253 * To check these conditions, we check that plane 'i' start address
254 * + plane 'i' size equals to plane 'i+1' start address */
255 if (!V4L2_TYPE_IS_MULTIPLANAR (pool->obj->type)) {
256 for (i = 0; i < (GST_VIDEO_FORMAT_INFO_N_PLANES (finfo) - 1); i++) {
257 const struct v4l2_pix_format *pix_fmt = &pool->obj->format.fmt.pix;
259 gint estride = gst_v4l2_object_extrapolate_stride (finfo, i,
260 pix_fmt->bytesperline);
261 guint eheight = GST_VIDEO_FORMAT_INFO_SCALE_HEIGHT (finfo, i,
264 tmp = ((guint8 *) data->frame.data[i]) + estride * eheight;
265 if (tmp != data->frame.data[i + 1])
266 goto non_contiguous_mem;
270 if (!gst_v4l2_allocator_import_userptr (pool->vallocator, group,
271 data->frame.info.size, finfo->n_planes, data->frame.data, size))
277 data->is_frame = FALSE;
279 if (!gst_buffer_map (src, &data->map, flags))
282 ptr[0] = data->map.data;
283 size[0] = data->map.size;
285 if (!gst_v4l2_allocator_import_userptr (pool->vallocator, group,
286 data->map.size, 1, ptr, size))
290 data->buffer = gst_buffer_ref (src);
292 gst_mini_object_set_qdata (GST_MINI_OBJECT (dest), GST_V4L2_IMPORT_QUARK,
293 data, (GDestroyNotify) _unmap_userptr_frame);
299 GST_ERROR_OBJECT (pool, "destination buffer invalid or not from our pool");
300 return GST_FLOW_ERROR;
304 GST_ERROR_OBJECT (pool, "could not map buffer");
305 g_slice_free (struct UserPtrData, data);
306 return GST_FLOW_ERROR;
310 GST_ERROR_OBJECT (pool, "memory is not contiguous or plane size mismatch");
311 _unmap_userptr_frame (data);
312 return GST_FLOW_ERROR;
316 GST_ERROR_OBJECT (pool, "failed to import data");
317 _unmap_userptr_frame (data);
318 return GST_FLOW_ERROR;
323 gst_v4l2_buffer_pool_import_dmabuf (GstV4l2BufferPool * pool,
324 GstBuffer * dest, GstBuffer * src)
326 GstV4l2MemoryGroup *group = NULL;
327 GstMemory *dma_mem[GST_VIDEO_MAX_PLANES] = { 0 };
328 guint n_mem = gst_buffer_n_memory (src);
331 GST_LOG_OBJECT (pool, "importing dmabuf");
333 if (!gst_v4l2_is_buffer_valid (dest, &group))
336 if (n_mem > GST_VIDEO_MAX_PLANES)
339 for (i = 0; i < n_mem; i++)
340 dma_mem[i] = gst_buffer_peek_memory (src, i);
342 if (!gst_v4l2_allocator_import_dmabuf (pool->vallocator, group, n_mem,
346 gst_mini_object_set_qdata (GST_MINI_OBJECT (dest), GST_V4L2_IMPORT_QUARK,
347 gst_buffer_ref (src), (GDestroyNotify) gst_buffer_unref);
353 GST_ERROR_OBJECT (pool, "destination buffer invalid or not from our pool");
354 return GST_FLOW_ERROR;
358 GST_ERROR_OBJECT (pool, "could not map buffer");
359 return GST_FLOW_ERROR;
363 GST_ERROR_OBJECT (pool, "failed to import dmabuf");
364 return GST_FLOW_ERROR;
369 gst_v4l2_buffer_pool_prepare_buffer (GstV4l2BufferPool * pool,
370 GstBuffer * dest, GstBuffer * src)
372 GstFlowReturn ret = GST_FLOW_OK;
373 gboolean own_src = FALSE;
376 if (pool->other_pool == NULL) {
377 GST_ERROR_OBJECT (pool, "can't prepare buffer, source buffer missing");
378 return GST_FLOW_ERROR;
381 ret = gst_buffer_pool_acquire_buffer (pool->other_pool, &src, NULL);
382 if (ret != GST_FLOW_OK) {
383 GST_ERROR_OBJECT (pool, "failed to acquire buffer from downstream pool");
390 switch (pool->obj->mode) {
391 case GST_V4L2_IO_MMAP:
392 case GST_V4L2_IO_DMABUF:
393 ret = gst_v4l2_buffer_pool_copy_buffer (pool, dest, src);
395 case GST_V4L2_IO_USERPTR:
396 ret = gst_v4l2_buffer_pool_import_userptr (pool, dest, src);
398 case GST_V4L2_IO_DMABUF_IMPORT:
399 ret = gst_v4l2_buffer_pool_import_dmabuf (pool, dest, src);
406 gst_buffer_unref (src);
413 gst_v4l2_buffer_pool_alloc_buffer (GstBufferPool * bpool, GstBuffer ** buffer,
414 GstBufferPoolAcquireParams * params)
416 GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
417 GstV4l2MemoryGroup *group = NULL;
418 GstBuffer *newbuf = NULL;
428 gst_buffer_new_allocate (pool->allocator, pool->size, &pool->params);
430 case GST_V4L2_IO_MMAP:
431 group = gst_v4l2_allocator_alloc_mmap (pool->vallocator);
433 case GST_V4L2_IO_DMABUF:
434 group = gst_v4l2_allocator_alloc_dmabuf (pool->vallocator,
437 case GST_V4L2_IO_USERPTR:
438 group = gst_v4l2_allocator_alloc_userptr (pool->vallocator);
440 case GST_V4L2_IO_DMABUF_IMPORT:
441 group = gst_v4l2_allocator_alloc_dmabufin (pool->vallocator);
445 g_assert_not_reached ();
451 newbuf = gst_buffer_new ();
453 for (i = 0; i < group->n_mem; i++)
454 gst_buffer_append_memory (newbuf, group->mem[i]);
455 } else if (newbuf == NULL) {
456 goto allocation_failed;
459 /* add metadata to raw video buffers */
460 if (pool->add_videometa)
461 gst_buffer_add_video_meta_full (newbuf, GST_VIDEO_FRAME_FLAG_NONE,
462 GST_VIDEO_INFO_FORMAT (info), GST_VIDEO_INFO_WIDTH (info),
463 GST_VIDEO_INFO_HEIGHT (info), GST_VIDEO_INFO_N_PLANES (info),
464 info->offset, info->stride);
473 GST_ERROR_OBJECT (pool, "failed to allocate buffer");
474 return GST_FLOW_ERROR;
479 gst_v4l2_buffer_pool_set_config (GstBufferPool * bpool, GstStructure * config)
481 GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
482 GstV4l2Object *obj = pool->obj;
484 guint size, min_buffers, max_buffers;
485 GstAllocator *allocator;
486 GstAllocationParams params;
487 gboolean can_allocate = FALSE;
488 gboolean updated = FALSE;
491 pool->add_videometa =
492 gst_buffer_pool_config_has_option (config,
493 GST_BUFFER_POOL_OPTION_VIDEO_META);
495 /* parse the config and keep around */
496 if (!gst_buffer_pool_config_get_params (config, &caps, &size, &min_buffers,
500 if (!gst_buffer_pool_config_get_allocator (config, &allocator, ¶ms))
503 GST_DEBUG_OBJECT (pool, "config %" GST_PTR_FORMAT, config);
506 gst_object_unref (pool->allocator);
507 pool->allocator = NULL;
510 case GST_V4L2_IO_DMABUF:
511 pool->allocator = gst_dmabuf_allocator_new ();
512 can_allocate = GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, MMAP);
514 case GST_V4L2_IO_MMAP:
515 can_allocate = GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, MMAP);
517 case GST_V4L2_IO_USERPTR:
519 GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, USERPTR);
521 case GST_V4L2_IO_DMABUF_IMPORT:
522 can_allocate = GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, DMABUF);
526 pool->allocator = g_object_ref (allocator);
527 pool->params = params;
528 /* No need to change the configuration */
532 g_assert_not_reached ();
536 /* libv4l2 conversion code does not handle CREATE_BUFS, and may lead to
537 * instability and crash, disable it for now */
538 if (can_allocate && obj->fmtdesc->flags & V4L2_FMT_FLAG_EMULATED) {
539 GST_WARNING_OBJECT (pool,
540 "libv4l2 converter detected, disabling CREATE_BUFS");
541 can_allocate = FALSE;
542 GST_OBJECT_FLAG_UNSET (pool->vallocator,
543 GST_V4L2_ALLOCATOR_FLAG_MMAP_CREATE_BUFS
544 | GST_V4L2_ALLOCATOR_FLAG_USERPTR_CREATE_BUFS
545 | GST_V4L2_ALLOCATOR_FLAG_DMABUF_CREATE_BUFS);
548 if (min_buffers < GST_V4L2_MIN_BUFFERS) {
550 min_buffers = GST_V4L2_MIN_BUFFERS;
551 GST_INFO_OBJECT (pool, "increasing minimum buffers to %u", min_buffers);
554 /* respect driver requirements */
555 if (min_buffers < obj->min_buffers) {
557 min_buffers = obj->min_buffers;
558 GST_INFO_OBJECT (pool, "increasing minimum buffers to %u", min_buffers);
561 if (max_buffers > VIDEO_MAX_FRAME || max_buffers == 0) {
563 max_buffers = VIDEO_MAX_FRAME;
564 GST_INFO_OBJECT (pool, "reducing maximum buffers to %u", max_buffers);
567 if (min_buffers > max_buffers) {
569 min_buffers = max_buffers;
570 GST_INFO_OBJECT (pool, "reducing minimum buffers to %u", min_buffers);
571 } else if (min_buffers != max_buffers) {
574 max_buffers = min_buffers;
575 GST_INFO_OBJECT (pool, "can't allocate, setting maximum to minimum");
579 if (!pool->add_videometa && obj->need_video_meta) {
580 GST_INFO_OBJECT (pool, "adding needed video meta");
582 gst_buffer_pool_config_add_option (config,
583 GST_BUFFER_POOL_OPTION_VIDEO_META);
586 /* Always update the config to ensure the configured size matches */
587 gst_buffer_pool_config_set_params (config, caps, obj->info.size, min_buffers,
590 /* keep a GstVideoInfo with defaults for the when we need to copy */
591 gst_video_info_from_caps (&pool->caps_info, caps);
594 ret = GST_BUFFER_POOL_CLASS (parent_class)->set_config (bpool, config);
596 /* If anything was changed documentation recommand to return FALSE */
597 return !updated && ret;
602 GST_ERROR_OBJECT (pool, "invalid config %" GST_PTR_FORMAT, config);
608 gst_v4l2_buffer_pool_streamon (GstV4l2BufferPool * pool)
610 GstV4l2Object *obj = pool->obj;
613 case GST_V4L2_IO_MMAP:
614 case GST_V4L2_IO_USERPTR:
615 case GST_V4L2_IO_DMABUF:
616 case GST_V4L2_IO_DMABUF_IMPORT:
617 if (!pool->streaming) {
618 if (v4l2_ioctl (pool->video_fd, VIDIOC_STREAMON, &obj->type) < 0)
619 goto streamon_failed;
621 pool->streaming = TRUE;
623 GST_DEBUG_OBJECT (pool, "Started streaming");
634 GST_ERROR_OBJECT (pool, "error with STREAMON %d (%s)", errno,
641 gst_v4l2_buffer_pool_streamoff (GstV4l2BufferPool * pool)
643 GstV4l2Object *obj = pool->obj;
646 case GST_V4L2_IO_MMAP:
647 case GST_V4L2_IO_USERPTR:
648 case GST_V4L2_IO_DMABUF:
649 case GST_V4L2_IO_DMABUF_IMPORT:
650 if (pool->streaming) {
651 if (v4l2_ioctl (pool->video_fd, VIDIOC_STREAMOFF, &obj->type) < 0)
652 GST_WARNING_OBJECT (pool, "STREAMOFF failed with errno %d (%s)",
653 errno, g_strerror (errno));
655 pool->streaming = FALSE;
657 GST_DEBUG_OBJECT (pool, "Stopped streaming");
659 if (pool->vallocator)
660 gst_v4l2_allocator_flush (pool->vallocator);
669 gst_v4l2_buffer_pool_resurect_buffer (GstV4l2BufferPool * pool)
671 GstBufferPoolAcquireParams params = { 0 };
672 GstBuffer *buffer = NULL;
675 GST_DEBUG_OBJECT (pool, "A buffer was lost, reallocating it");
678 (GstBufferPoolAcquireFlags) GST_V4L2_BUFFER_POOL_ACQUIRE_FLAG_RESURRECT |
679 GST_BUFFER_POOL_ACQUIRE_FLAG_DONTWAIT;
681 gst_buffer_pool_acquire_buffer (GST_BUFFER_POOL (pool), &buffer, ¶ms);
683 if (ret == GST_FLOW_OK)
684 gst_buffer_unref (buffer);
690 gst_v4l2_buffer_pool_start (GstBufferPool * bpool)
692 GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
693 GstBufferPoolClass *pclass = GST_BUFFER_POOL_CLASS (parent_class);
694 GstV4l2Object *obj = pool->obj;
695 GstStructure *config;
697 guint size, min_buffers, max_buffers;
698 guint max_latency, min_latency, copy_threshold = 0;
699 gboolean can_allocate = FALSE;
701 GST_DEBUG_OBJECT (pool, "activating pool");
703 config = gst_buffer_pool_get_config (bpool);
704 if (!gst_buffer_pool_config_get_params (config, &caps, &size, &min_buffers,
708 min_latency = MAX (GST_V4L2_MIN_BUFFERS, obj->min_buffers);
714 /* This workaround a unfixable bug in libv4l2 when RW is emulated on top
715 * of MMAP. In this case, the first read initialize the queues, but the
716 * poll before that will always fail. Doing an empty read, forces the
717 * queue to be initialized now. We only do this if we have a streaming
719 if (obj->device_caps & V4L2_CAP_STREAMING)
720 v4l2_read (obj->video_fd, NULL, 0);
723 case GST_V4L2_IO_DMABUF:
724 case GST_V4L2_IO_MMAP:
728 can_allocate = GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, MMAP);
730 /* first, lets request buffers, and see how many we can get: */
731 GST_DEBUG_OBJECT (pool, "requesting %d MMAP buffers", min_buffers);
733 count = gst_v4l2_allocator_start (pool->vallocator, min_buffers,
736 if (count < GST_V4L2_MIN_BUFFERS) {
741 /* V4L2 buffer pool are often very limited in the amount of buffers it
742 * can offer. The copy_threshold will workaround this limitation by
743 * falling back to copy if the pipeline needed more buffers. This also
744 * prevent having to do REQBUFS(N)/REQBUFS(0) everytime configure is
746 if (count != min_buffers || pool->enable_copy_threshold) {
747 GST_WARNING_OBJECT (pool,
748 "Uncertain or not enough buffers, enabling copy threshold");
750 copy_threshold = min_latency;
755 case GST_V4L2_IO_USERPTR:
760 GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, USERPTR);
762 GST_DEBUG_OBJECT (pool, "requesting %d USERPTR buffers", min_buffers);
764 count = gst_v4l2_allocator_start (pool->vallocator, min_buffers,
765 V4L2_MEMORY_USERPTR);
767 /* There is no rational to not get what we asked */
768 if (count < min_buffers) {
776 case GST_V4L2_IO_DMABUF_IMPORT:
780 can_allocate = GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, DMABUF);
782 GST_DEBUG_OBJECT (pool, "requesting %d DMABUF buffers", min_buffers);
784 count = gst_v4l2_allocator_start (pool->vallocator, min_buffers,
787 /* There is no rational to not get what we asked */
788 if (count < min_buffers) {
799 g_assert_not_reached ();
804 max_latency = max_buffers;
806 max_latency = min_buffers;
809 pool->copy_threshold = copy_threshold;
810 pool->max_latency = max_latency;
811 pool->min_latency = min_latency;
812 pool->num_queued = 0;
814 if (max_buffers != 0 && max_buffers < min_buffers)
815 max_buffers = min_buffers;
817 gst_buffer_pool_config_set_params (config, caps, size, min_buffers,
819 pclass->set_config (bpool, config);
820 gst_structure_free (config);
822 if (pool->other_pool)
823 if (!gst_buffer_pool_set_active (pool->other_pool, TRUE))
824 goto other_pool_failed;
826 /* now, allocate the buffers: */
827 if (!pclass->start (bpool))
830 if (!V4L2_TYPE_IS_OUTPUT (obj->type))
831 pool->group_released_handler =
832 g_signal_connect_swapped (pool->vallocator, "group-released",
833 G_CALLBACK (gst_v4l2_buffer_pool_resurect_buffer), pool);
840 GST_ERROR_OBJECT (pool, "invalid config %" GST_PTR_FORMAT, config);
841 gst_structure_free (config);
846 GST_ERROR_OBJECT (pool,
847 "we received %d buffer from device '%s', we want at least %d",
848 min_buffers, obj->videodev, GST_V4L2_MIN_BUFFERS);
849 gst_structure_free (config);
854 GST_ERROR_OBJECT (pool, "failed to start streaming");
859 GST_ERROR_OBJECT (pool, "failed to active the other pool %"
860 GST_PTR_FORMAT, pool->other_pool);
866 gst_v4l2_buffer_pool_stop (GstBufferPool * bpool)
868 GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
869 GstBufferPoolClass *pclass = GST_BUFFER_POOL_CLASS (parent_class);
873 GST_DEBUG_OBJECT (pool, "stopping pool");
875 if (pool->group_released_handler > 0) {
876 g_signal_handler_disconnect (pool->vallocator,
877 pool->group_released_handler);
878 pool->group_released_handler = 0;
881 if (pool->other_pool) {
882 gst_buffer_pool_set_active (pool->other_pool, FALSE);
883 gst_object_unref (pool->other_pool);
884 pool->other_pool = NULL;
887 gst_v4l2_buffer_pool_streamoff (pool);
889 for (i = 0; i < VIDEO_MAX_FRAME; i++) {
890 if (pool->buffers[i]) {
891 GstBuffer *buffer = pool->buffers[i];
893 pool->buffers[i] = NULL;
895 if (V4L2_TYPE_IS_OUTPUT (pool->obj->type))
896 gst_v4l2_buffer_pool_release_buffer (bpool, buffer);
897 else /* Don't re-enqueue capture buffer on stop */
898 pclass->release_buffer (bpool, buffer);
900 g_atomic_int_add (&pool->num_queued, -1);
904 ret = GST_BUFFER_POOL_CLASS (parent_class)->stop (bpool);
906 if (ret && pool->vallocator) {
909 vret = gst_v4l2_allocator_stop (pool->vallocator);
911 if (vret == GST_V4L2_BUSY)
912 GST_WARNING_OBJECT (pool, "some buffers are still outstanding");
914 ret = (vret == GST_V4L2_OK);
921 gst_v4l2_buffer_pool_flush_start (GstBufferPool * bpool)
923 GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
925 GST_DEBUG_OBJECT (pool, "start flushing");
927 gst_poll_set_flushing (pool->poll, TRUE);
929 GST_OBJECT_LOCK (pool);
931 g_cond_broadcast (&pool->empty_cond);
932 GST_OBJECT_UNLOCK (pool);
934 if (pool->other_pool)
935 gst_buffer_pool_set_flushing (pool->other_pool, TRUE);
939 gst_v4l2_buffer_pool_flush_stop (GstBufferPool * bpool)
941 GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
942 GstV4l2Object *obj = pool->obj;
943 GstBuffer *buffers[VIDEO_MAX_FRAME];
946 GST_DEBUG_OBJECT (pool, "stop flushing");
948 /* If we haven't started streaming yet, simply call streamon */
949 if (!pool->streaming)
952 if (pool->other_pool)
953 gst_buffer_pool_set_flushing (pool->other_pool, FALSE);
955 GST_OBJECT_LOCK (pool);
956 gst_v4l2_buffer_pool_streamoff (pool);
957 /* Remember buffers to re-enqueue */
958 memcpy (buffers, pool->buffers, sizeof (buffers));
959 memset (pool->buffers, 0, sizeof (pool->buffers));
960 GST_OBJECT_UNLOCK (pool);
962 /* Reset our state */
966 case GST_V4L2_IO_MMAP:
967 case GST_V4L2_IO_USERPTR:
968 case GST_V4L2_IO_DMABUF:
969 case GST_V4L2_IO_DMABUF_IMPORT:
971 for (i = 0; i < VIDEO_MAX_FRAME; i++) {
972 /* Re-enqueue buffers */
974 GstBufferPool *bpool = (GstBufferPool *) pool;
975 GstBuffer *buffer = buffers[i];
977 /* Remove qdata, this will unmap any map data in
978 * userptr/dmabuf-import */
979 gst_mini_object_set_qdata (GST_MINI_OBJECT (buffer),
980 GST_V4L2_IMPORT_QUARK, NULL, NULL);
982 if (buffer->pool == NULL)
983 gst_v4l2_buffer_pool_release_buffer (bpool, buffer);
985 g_atomic_int_add (&pool->num_queued, -1);
992 g_assert_not_reached ();
997 /* Start streaming on capture device only */
998 if (!V4L2_TYPE_IS_OUTPUT (obj->type))
999 gst_v4l2_buffer_pool_streamon (pool);
1001 gst_poll_set_flushing (pool->poll, FALSE);
1004 static GstFlowReturn
1005 gst_v4l2_buffer_pool_poll (GstV4l2BufferPool * pool)
1009 /* In RW mode there is no queue, hence no need to wait while the queue is
1011 if (pool->obj->mode != GST_V4L2_IO_RW) {
1012 GST_OBJECT_LOCK (pool);
1014 g_cond_wait (&pool->empty_cond, GST_OBJECT_GET_LOCK (pool));
1015 GST_OBJECT_UNLOCK (pool);
1018 if (!pool->can_poll_device)
1021 GST_LOG_OBJECT (pool, "polling device");
1024 ret = gst_poll_wait (pool->poll, GST_CLOCK_TIME_NONE);
1025 if (G_UNLIKELY (ret < 0)) {
1033 GST_WARNING_OBJECT (pool,
1034 "v4l2 device doesn't support polling. Disabling"
1035 " using libv4l2 in this case may cause deadlocks");
1036 pool->can_poll_device = FALSE;
1043 if (gst_poll_fd_has_error (pool->poll, &pool->pollfd))
1052 GST_DEBUG_OBJECT (pool, "stop called");
1053 return GST_FLOW_FLUSHING;
1057 GST_ELEMENT_ERROR (pool->obj->element, RESOURCE, READ, (NULL),
1058 ("poll error %d: %s (%d)", ret, g_strerror (errno), errno));
1059 return GST_FLOW_ERROR;
1063 static GstFlowReturn
1064 gst_v4l2_buffer_pool_qbuf (GstV4l2BufferPool * pool, GstBuffer * buf)
1066 GstV4l2MemoryGroup *group = NULL;
1067 const GstV4l2Object *obj = pool->obj;
1068 GstClockTime timestamp;
1071 if (!gst_v4l2_is_buffer_valid (buf, &group)) {
1072 GST_LOG_OBJECT (pool, "unref copied/invalid buffer %p", buf);
1073 gst_buffer_unref (buf);
1077 index = group->buffer.index;
1079 if (pool->buffers[index] != NULL)
1080 goto already_queued;
1082 GST_LOG_OBJECT (pool, "queuing buffer %i", index);
1084 if (V4L2_TYPE_IS_OUTPUT (obj->type)) {
1085 enum v4l2_field field;
1087 /* Except when field is set to alternate, buffer field is the same as
1088 * the one defined in format */
1089 if (V4L2_TYPE_IS_MULTIPLANAR (obj->type))
1090 field = obj->format.fmt.pix_mp.field;
1092 field = obj->format.fmt.pix.field;
1094 /* NB: At this moment, we can't have alternate mode because it not handled
1096 if (field == V4L2_FIELD_ALTERNATE) {
1097 if (GST_BUFFER_FLAG_IS_SET (buf, GST_VIDEO_FRAME_FLAG_TFF))
1098 field = V4L2_FIELD_TOP;
1100 field = V4L2_FIELD_BOTTOM;
1103 group->buffer.field = field;
1106 if (GST_BUFFER_TIMESTAMP_IS_VALID (buf)) {
1107 timestamp = GST_BUFFER_TIMESTAMP (buf);
1108 GST_TIME_TO_TIMEVAL (timestamp, group->buffer.timestamp);
1111 GST_OBJECT_LOCK (pool);
1112 g_atomic_int_inc (&pool->num_queued);
1113 pool->buffers[index] = buf;
1115 if (!gst_v4l2_allocator_qbuf (pool->vallocator, group))
1118 pool->empty = FALSE;
1119 g_cond_signal (&pool->empty_cond);
1120 GST_OBJECT_UNLOCK (pool);
1126 GST_ERROR_OBJECT (pool, "the buffer %i was already queued", index);
1127 return GST_FLOW_ERROR;
1131 GST_ERROR_OBJECT (pool, "could not queue a buffer %i", index);
1132 /* Mark broken buffer to the allocator */
1133 GST_BUFFER_FLAG_SET (buf, GST_BUFFER_FLAG_TAG_MEMORY);
1134 g_atomic_int_add (&pool->num_queued, -1);
1135 pool->buffers[index] = NULL;
1136 GST_OBJECT_UNLOCK (pool);
1137 return GST_FLOW_ERROR;
1141 static GstFlowReturn
1142 gst_v4l2_buffer_pool_dqbuf (GstV4l2BufferPool * pool, GstBuffer ** buffer)
1146 GstV4l2Object *obj = pool->obj;
1147 GstClockTime timestamp;
1148 GstV4l2MemoryGroup *group;
1151 if ((res = gst_v4l2_buffer_pool_poll (pool)) != GST_FLOW_OK)
1154 GST_LOG_OBJECT (pool, "dequeueing a buffer");
1156 res = gst_v4l2_allocator_dqbuf (pool->vallocator, &group);
1157 if (res == GST_FLOW_EOS)
1159 if (res != GST_FLOW_OK)
1162 /* get our GstBuffer with that index from the pool, if the buffer was
1163 * outstanding we have a serious problem.
1165 outbuf = pool->buffers[group->buffer.index];
1169 /* mark the buffer outstanding */
1170 pool->buffers[group->buffer.index] = NULL;
1171 if (g_atomic_int_dec_and_test (&pool->num_queued)) {
1172 GST_OBJECT_LOCK (pool);
1174 GST_OBJECT_UNLOCK (pool);
1177 timestamp = GST_TIMEVAL_TO_TIME (group->buffer.timestamp);
1179 #ifndef GST_DISABLE_GST_DEBUG
1180 for (i = 0; i < group->n_mem; i++) {
1181 GST_LOG_OBJECT (pool,
1182 "dequeued buffer %p seq:%d (ix=%d), mem %p used %d, plane=%d, flags %08x, ts %"
1183 GST_TIME_FORMAT ", pool-queued=%d, buffer=%p", outbuf,
1184 group->buffer.sequence, group->buffer.index, group->mem[i],
1185 group->planes[i].bytesused, i, group->buffer.flags,
1186 GST_TIME_ARGS (timestamp), pool->num_queued, outbuf);
1190 /* Ignore timestamp and field for OUTPUT device */
1191 if (V4L2_TYPE_IS_OUTPUT (obj->type))
1194 /* Check for driver bug in reporting feild */
1195 if (group->buffer.field == V4L2_FIELD_ANY) {
1196 /* Only warn once to avoid the spamming */
1197 #ifndef GST_DISABLE_GST_DEBUG
1198 if (!pool->has_warned_on_buggy_field) {
1199 pool->has_warned_on_buggy_field = TRUE;
1200 GST_WARNING_OBJECT (pool,
1201 "Driver should never set v4l2_buffer.field to ANY");
1205 /* Use the value from the format (works for UVC bug) */
1206 group->buffer.field = obj->format.fmt.pix.field;
1208 /* If driver also has buggy S_FMT, assume progressive */
1209 if (group->buffer.field == V4L2_FIELD_ANY) {
1210 #ifndef GST_DISABLE_GST_DEBUG
1211 if (!pool->has_warned_on_buggy_field) {
1212 pool->has_warned_on_buggy_field = TRUE;
1213 GST_WARNING_OBJECT (pool,
1214 "Driver should never set v4l2_format.pix.field to ANY");
1218 group->buffer.field = V4L2_FIELD_NONE;
1222 /* set top/bottom field first if v4l2_buffer has the information */
1223 switch (group->buffer.field) {
1224 case V4L2_FIELD_NONE:
1225 GST_BUFFER_FLAG_UNSET (outbuf, GST_VIDEO_BUFFER_FLAG_INTERLACED);
1226 GST_BUFFER_FLAG_UNSET (outbuf, GST_VIDEO_BUFFER_FLAG_TFF);
1228 case V4L2_FIELD_INTERLACED_TB:
1229 GST_BUFFER_FLAG_SET (outbuf, GST_VIDEO_BUFFER_FLAG_INTERLACED);
1230 GST_BUFFER_FLAG_SET (outbuf, GST_VIDEO_BUFFER_FLAG_TFF);
1232 case V4L2_FIELD_INTERLACED_BT:
1233 GST_BUFFER_FLAG_SET (outbuf, GST_VIDEO_BUFFER_FLAG_INTERLACED);
1234 GST_BUFFER_FLAG_UNSET (outbuf, GST_VIDEO_BUFFER_FLAG_TFF);
1236 case V4L2_FIELD_INTERLACED:
1237 GST_BUFFER_FLAG_SET (outbuf, GST_VIDEO_BUFFER_FLAG_INTERLACED);
1238 if (obj->tv_norm == V4L2_STD_NTSC_M ||
1239 obj->tv_norm == V4L2_STD_NTSC_M_JP ||
1240 obj->tv_norm == V4L2_STD_NTSC_M_KR) {
1241 GST_BUFFER_FLAG_UNSET (outbuf, GST_VIDEO_BUFFER_FLAG_TFF);
1243 GST_BUFFER_FLAG_SET (outbuf, GST_VIDEO_BUFFER_FLAG_TFF);
1247 GST_BUFFER_FLAG_UNSET (outbuf, GST_VIDEO_BUFFER_FLAG_INTERLACED);
1248 GST_BUFFER_FLAG_UNSET (outbuf, GST_VIDEO_BUFFER_FLAG_TFF);
1249 GST_FIXME_OBJECT (pool,
1250 "Unhandled enum v4l2_field %d - treating as progressive",
1251 group->buffer.field);
1255 if (GST_VIDEO_INFO_FORMAT (&obj->info) == GST_VIDEO_FORMAT_ENCODED) {
1256 if (group->buffer.flags & V4L2_BUF_FLAG_KEYFRAME)
1257 GST_BUFFER_FLAG_UNSET (outbuf, GST_BUFFER_FLAG_DELTA_UNIT);
1259 GST_BUFFER_FLAG_SET (outbuf, GST_BUFFER_FLAG_DELTA_UNIT);
1262 if (group->buffer.flags & V4L2_BUF_FLAG_ERROR)
1263 GST_BUFFER_FLAG_SET (outbuf, GST_BUFFER_FLAG_CORRUPTED);
1265 GST_BUFFER_TIMESTAMP (outbuf) = timestamp;
1266 GST_BUFFER_OFFSET (outbuf) = group->buffer.sequence;
1267 GST_BUFFER_OFFSET_END (outbuf) = group->buffer.sequence + 1;
1277 GST_DEBUG_OBJECT (pool, "poll error %s", gst_flow_get_name (res));
1282 return GST_FLOW_EOS;
1286 return GST_FLOW_ERROR;
1290 GST_ERROR_OBJECT (pool, "No free buffer found in the pool at index %d.",
1291 group->buffer.index);
1292 return GST_FLOW_ERROR;
1296 static GstFlowReturn
1297 gst_v4l2_buffer_pool_acquire_buffer (GstBufferPool * bpool, GstBuffer ** buffer,
1298 GstBufferPoolAcquireParams * params)
1301 GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
1302 GstBufferPoolClass *pclass = GST_BUFFER_POOL_CLASS (parent_class);
1303 GstV4l2Object *obj = pool->obj;
1305 GST_DEBUG_OBJECT (pool, "acquire");
1307 /* If this is being called to resurect a lost buffer */
1308 if (params && params->flags & GST_V4L2_BUFFER_POOL_ACQUIRE_FLAG_RESURRECT) {
1309 ret = pclass->acquire_buffer (bpool, buffer, params);
1313 switch (obj->type) {
1314 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1315 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1316 /* capture, This function should return a buffer with new captured data */
1317 switch (obj->mode) {
1318 case GST_V4L2_IO_RW:
1320 /* take empty buffer from the pool */
1321 ret = pclass->acquire_buffer (bpool, buffer, params);
1324 case GST_V4L2_IO_DMABUF:
1325 case GST_V4L2_IO_MMAP:
1326 case GST_V4L2_IO_USERPTR:
1327 case GST_V4L2_IO_DMABUF_IMPORT:
1329 /* just dequeue a buffer, we basically use the queue of v4l2 as the
1330 * storage for our buffers. This function does poll first so we can
1331 * interrupt it fine. */
1332 ret = gst_v4l2_buffer_pool_dqbuf (pool, buffer);
1336 ret = GST_FLOW_ERROR;
1337 g_assert_not_reached ();
1343 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1344 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1345 /* playback, This function should return an empty buffer */
1346 switch (obj->mode) {
1347 case GST_V4L2_IO_RW:
1348 /* get an empty buffer */
1349 ret = pclass->acquire_buffer (bpool, buffer, params);
1352 case GST_V4L2_IO_MMAP:
1353 case GST_V4L2_IO_DMABUF:
1354 case GST_V4L2_IO_USERPTR:
1355 case GST_V4L2_IO_DMABUF_IMPORT:
1356 /* get a free unqueued buffer */
1357 ret = pclass->acquire_buffer (bpool, buffer, params);
1361 ret = GST_FLOW_ERROR;
1362 g_assert_not_reached ();
1368 ret = GST_FLOW_ERROR;
1369 g_assert_not_reached ();
1377 gst_v4l2_buffer_pool_release_buffer (GstBufferPool * bpool, GstBuffer * buffer)
1379 GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
1380 GstBufferPoolClass *pclass = GST_BUFFER_POOL_CLASS (parent_class);
1381 GstV4l2Object *obj = pool->obj;
1383 GST_DEBUG_OBJECT (pool, "release buffer %p", buffer);
1385 switch (obj->type) {
1386 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1387 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1388 /* capture, put the buffer back in the queue so that we can refill it
1390 switch (obj->mode) {
1391 case GST_V4L2_IO_RW:
1392 /* release back in the pool */
1393 pclass->release_buffer (bpool, buffer);
1396 case GST_V4L2_IO_DMABUF:
1397 case GST_V4L2_IO_MMAP:
1398 case GST_V4L2_IO_USERPTR:
1399 case GST_V4L2_IO_DMABUF_IMPORT:
1401 GstV4l2MemoryGroup *group;
1402 if (gst_v4l2_is_buffer_valid (buffer, &group)) {
1403 gst_v4l2_allocator_reset_group (pool->vallocator, group);
1404 /* queue back in the device */
1405 if (pool->other_pool)
1406 gst_v4l2_buffer_pool_prepare_buffer (pool, buffer, NULL);
1407 if (gst_v4l2_buffer_pool_qbuf (pool, buffer) != GST_FLOW_OK)
1408 pclass->release_buffer (bpool, buffer);
1410 /* Simply release invalide/modified buffer, the allocator will
1411 * give it back later */
1412 GST_BUFFER_FLAG_SET (buffer, GST_BUFFER_FLAG_TAG_MEMORY);
1413 pclass->release_buffer (bpool, buffer);
1418 g_assert_not_reached ();
1423 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1424 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1425 switch (obj->mode) {
1426 case GST_V4L2_IO_RW:
1427 /* release back in the pool */
1428 pclass->release_buffer (bpool, buffer);
1431 case GST_V4L2_IO_MMAP:
1432 case GST_V4L2_IO_DMABUF:
1433 case GST_V4L2_IO_USERPTR:
1434 case GST_V4L2_IO_DMABUF_IMPORT:
1436 GstV4l2MemoryGroup *group;
1439 if (!gst_v4l2_is_buffer_valid (buffer, &group)) {
1440 /* Simply release invalide/modified buffer, the allocator will
1441 * give it back later */
1442 GST_BUFFER_FLAG_SET (buffer, GST_BUFFER_FLAG_TAG_MEMORY);
1443 pclass->release_buffer (bpool, buffer);
1447 index = group->buffer.index;
1449 if (pool->buffers[index] == NULL) {
1450 GST_LOG_OBJECT (pool, "buffer %u not queued, putting on free list",
1453 /* Remove qdata, this will unmap any map data in userptr */
1454 gst_mini_object_set_qdata (GST_MINI_OBJECT (buffer),
1455 GST_V4L2_IMPORT_QUARK, NULL, NULL);
1457 /* reset to default size */
1458 gst_v4l2_allocator_reset_group (pool->vallocator, group);
1460 /* playback, put the buffer back in the queue to refill later. */
1461 pclass->release_buffer (bpool, buffer);
1463 /* the buffer is queued in the device but maybe not played yet. We just
1464 * leave it there and not make it available for future calls to acquire
1465 * for now. The buffer will be dequeued and reused later. */
1466 GST_LOG_OBJECT (pool, "buffer %u is queued", index);
1472 g_assert_not_reached ();
1478 g_assert_not_reached ();
1484 gst_v4l2_buffer_pool_dispose (GObject * object)
1486 GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (object);
1488 if (pool->vallocator)
1489 gst_object_unref (pool->vallocator);
1490 pool->vallocator = NULL;
1492 if (pool->allocator)
1493 gst_object_unref (pool->allocator);
1494 pool->allocator = NULL;
1496 if (pool->other_pool)
1497 gst_object_unref (pool->other_pool);
1498 pool->other_pool = NULL;
1500 G_OBJECT_CLASS (parent_class)->dispose (object);
1504 gst_v4l2_buffer_pool_finalize (GObject * object)
1506 GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (object);
1508 if (pool->video_fd >= 0)
1509 v4l2_close (pool->video_fd);
1511 gst_poll_free (pool->poll);
1513 /* FIXME Is this required to keep around ?
1514 * This can't be done in dispose method because we must not set pointer
1515 * to NULL as it is part of the v4l2object and dispose could be called
1517 gst_object_unref (pool->obj->element);
1519 g_cond_clear (&pool->empty_cond);
1521 /* FIXME have we done enough here ? */
1523 G_OBJECT_CLASS (parent_class)->finalize (object);
1527 gst_v4l2_buffer_pool_init (GstV4l2BufferPool * pool)
1529 pool->poll = gst_poll_new (TRUE);
1530 pool->can_poll_device = TRUE;
1531 g_cond_init (&pool->empty_cond);
1536 gst_v4l2_buffer_pool_class_init (GstV4l2BufferPoolClass * klass)
1538 GObjectClass *object_class = G_OBJECT_CLASS (klass);
1539 GstBufferPoolClass *bufferpool_class = GST_BUFFER_POOL_CLASS (klass);
1541 object_class->dispose = gst_v4l2_buffer_pool_dispose;
1542 object_class->finalize = gst_v4l2_buffer_pool_finalize;
1544 bufferpool_class->start = gst_v4l2_buffer_pool_start;
1545 bufferpool_class->stop = gst_v4l2_buffer_pool_stop;
1546 bufferpool_class->set_config = gst_v4l2_buffer_pool_set_config;
1547 bufferpool_class->alloc_buffer = gst_v4l2_buffer_pool_alloc_buffer;
1548 bufferpool_class->acquire_buffer = gst_v4l2_buffer_pool_acquire_buffer;
1549 bufferpool_class->release_buffer = gst_v4l2_buffer_pool_release_buffer;
1550 bufferpool_class->flush_start = gst_v4l2_buffer_pool_flush_start;
1551 bufferpool_class->flush_stop = gst_v4l2_buffer_pool_flush_stop;
1553 GST_DEBUG_CATEGORY_INIT (v4l2bufferpool_debug, "v4l2bufferpool", 0,
1554 "V4L2 Buffer Pool");
1555 GST_DEBUG_CATEGORY_GET (CAT_PERFORMANCE, "GST_PERFORMANCE");
1559 * gst_v4l2_buffer_pool_new:
1560 * @obj: the v4l2 object owning the pool
1562 * Construct a new buffer pool.
1564 * Returns: the new pool, use gst_object_unref() to free resources
1567 gst_v4l2_buffer_pool_new (GstV4l2Object * obj, GstCaps * caps)
1569 GstV4l2BufferPool *pool;
1570 GstStructure *config;
1571 gchar *name, *parent_name;
1574 fd = v4l2_dup (obj->video_fd);
1578 /* setting a significant unique name */
1579 parent_name = gst_object_get_name (GST_OBJECT (obj->element));
1580 name = g_strconcat (parent_name, ":", "pool:",
1581 V4L2_TYPE_IS_OUTPUT (obj->type) ? "sink" : "src", NULL);
1582 g_free (parent_name);
1584 pool = (GstV4l2BufferPool *) g_object_new (GST_TYPE_V4L2_BUFFER_POOL,
1585 "name", name, NULL);
1588 gst_poll_fd_init (&pool->pollfd);
1589 pool->pollfd.fd = fd;
1590 gst_poll_add_fd (pool->poll, &pool->pollfd);
1591 if (V4L2_TYPE_IS_OUTPUT (obj->type))
1592 gst_poll_fd_ctl_write (pool->poll, &pool->pollfd, TRUE);
1594 gst_poll_fd_ctl_read (pool->poll, &pool->pollfd, TRUE);
1596 pool->video_fd = fd;
1598 pool->can_poll_device = TRUE;
1601 gst_v4l2_allocator_new (GST_OBJECT (pool), obj->video_fd, &obj->format);
1602 if (pool->vallocator == NULL)
1603 goto allocator_failed;
1605 gst_object_ref (obj->element);
1607 config = gst_buffer_pool_get_config (GST_BUFFER_POOL_CAST (pool));
1608 gst_buffer_pool_config_set_params (config, caps, obj->info.size, 0, 0);
1609 /* This will simply set a default config, but will not configure the pool
1610 * because min and max are not valid */
1611 gst_buffer_pool_set_config (GST_BUFFER_POOL_CAST (pool), config);
1613 return GST_BUFFER_POOL (pool);
1618 GST_ERROR ("failed to dup fd %d (%s)", errno, g_strerror (errno));
1623 GST_ERROR_OBJECT (pool, "Failed to create V4L2 allocator");
1624 gst_object_unref (pool);
1629 static GstFlowReturn
1630 gst_v4l2_do_read (GstV4l2BufferPool * pool, GstBuffer * buf)
1633 GstV4l2Object *obj = pool->obj;
1638 toread = obj->info.size;
1640 GST_LOG_OBJECT (pool, "reading %d bytes into buffer %p", toread, buf);
1642 gst_buffer_map (buf, &map, GST_MAP_WRITE);
1645 if ((res = gst_v4l2_buffer_pool_poll (pool)) != GST_FLOW_OK)
1648 amount = v4l2_read (obj->video_fd, map.data, toread);
1650 if (amount == toread) {
1652 } else if (amount == -1) {
1653 if (errno == EAGAIN || errno == EINTR) {
1658 /* short reads can happen if a signal interrupts the read */
1663 GST_LOG_OBJECT (pool, "read %d bytes", amount);
1664 gst_buffer_unmap (buf, &map);
1665 gst_buffer_resize (buf, 0, amount);
1672 GST_DEBUG ("poll error %s", gst_flow_get_name (res));
1677 GST_ELEMENT_ERROR (obj->element, RESOURCE, READ,
1678 (_("Error reading %d bytes from device '%s'."),
1679 toread, obj->videodev), GST_ERROR_SYSTEM);
1680 res = GST_FLOW_ERROR;
1685 gst_buffer_unmap (buf, &map);
1686 gst_buffer_resize (buf, 0, 0);
1692 * gst_v4l2_buffer_pool_process:
1693 * @bpool: a #GstBufferPool
1694 * @buf: a #GstBuffer, maybe be replaced
1696 * Process @buf in @bpool. For capture devices, this functions fills @buf with
1697 * data from the device. For output devices, this functions send the contents of
1698 * @buf to the device for playback.
1700 * Returns: %GST_FLOW_OK on success.
1703 gst_v4l2_buffer_pool_process (GstV4l2BufferPool * pool, GstBuffer ** buf)
1705 GstFlowReturn ret = GST_FLOW_OK;
1706 GstBufferPool *bpool = GST_BUFFER_POOL_CAST (pool);
1707 GstV4l2Object *obj = pool->obj;
1709 GST_DEBUG_OBJECT (pool, "process buffer %p", buf);
1711 if (GST_BUFFER_POOL_IS_FLUSHING (pool))
1712 return GST_FLOW_FLUSHING;
1714 switch (obj->type) {
1715 case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1716 case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1718 switch (obj->mode) {
1719 case GST_V4L2_IO_RW:
1720 /* capture into the buffer */
1721 ret = gst_v4l2_do_read (pool, *buf);
1724 case GST_V4L2_IO_MMAP:
1725 case GST_V4L2_IO_DMABUF:
1729 if ((*buf)->pool == bpool) {
1731 gsize size = gst_buffer_get_size (*buf);
1734 if (GST_BUFFER_FLAG_IS_SET (*buf, GST_BUFFER_FLAG_CORRUPTED))
1735 goto buffer_corrupted;
1740 /* verify that buffer contains a full frame for raw video */
1741 if (GST_VIDEO_INFO_FORMAT (&obj->info) != GST_VIDEO_FORMAT_ENCODED
1742 && size < GST_VIDEO_INFO_SIZE (&obj->info)) {
1743 GST_WARNING_OBJECT (pool, "Invalid buffer size, this is likely "
1744 "due to a bug in your driver, dropping");
1745 goto buffer_corrupted;
1748 num_queued = g_atomic_int_get (&pool->num_queued);
1749 GST_TRACE_OBJECT (pool, "Only %i buffer left in the capture queue.",
1752 /* If we have no more buffer, and can allocate it time to do so */
1753 if (num_queued == 0) {
1754 if (GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, MMAP)) {
1755 ret = gst_v4l2_buffer_pool_resurect_buffer (pool);
1756 if (ret == GST_FLOW_OK)
1761 /* start copying buffers when we are running low on buffers */
1762 if (num_queued < pool->copy_threshold) {
1765 if (GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, MMAP)) {
1766 ret = gst_v4l2_buffer_pool_resurect_buffer (pool);
1767 if (ret == GST_FLOW_OK)
1771 /* copy the buffer */
1772 copy = gst_buffer_copy_region (*buf,
1773 GST_BUFFER_COPY_ALL | GST_BUFFER_COPY_DEEP, 0, -1);
1774 GST_LOG_OBJECT (pool, "copy buffer %p->%p", *buf, copy);
1776 /* and requeue so that we can continue capturing */
1777 gst_buffer_unref (*buf);
1782 /* nothing, data was inside the buffer when we did _acquire() */
1786 /* buffer not from our pool, grab a frame and copy it into the target */
1787 if ((ret = gst_v4l2_buffer_pool_dqbuf (pool, &tmp)) != GST_FLOW_OK)
1790 /* An empty buffer on capture indicates the end of stream */
1791 if (gst_buffer_get_size (tmp) == 0) {
1792 gboolean corrupted = GST_BUFFER_FLAG_IS_SET (tmp,
1793 GST_BUFFER_FLAG_CORRUPTED);
1795 gst_v4l2_buffer_pool_release_buffer (bpool, tmp);
1798 goto buffer_corrupted;
1803 ret = gst_v4l2_buffer_pool_copy_buffer (pool, *buf, tmp);
1805 /* an queue the buffer again after the copy */
1806 gst_v4l2_buffer_pool_release_buffer (bpool, tmp);
1808 if (ret != GST_FLOW_OK)
1813 case GST_V4L2_IO_USERPTR:
1815 struct UserPtrData *data;
1817 /* Replace our buffer with downstream allocated buffer */
1818 data = gst_mini_object_steal_qdata (GST_MINI_OBJECT (*buf),
1819 GST_V4L2_IMPORT_QUARK);
1820 gst_buffer_replace (buf, data->buffer);
1821 _unmap_userptr_frame (data);
1825 case GST_V4L2_IO_DMABUF_IMPORT:
1829 /* Replace our buffer with downstream allocated buffer */
1830 tmp = gst_mini_object_steal_qdata (GST_MINI_OBJECT (*buf),
1831 GST_V4L2_IMPORT_QUARK);
1832 gst_buffer_replace (buf, tmp);
1833 gst_buffer_unref (tmp);
1838 g_assert_not_reached ();
1843 case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1844 case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1846 switch (obj->mode) {
1847 case GST_V4L2_IO_RW:
1848 /* FIXME, do write() */
1849 GST_WARNING_OBJECT (pool, "implement write()");
1852 case GST_V4L2_IO_USERPTR:
1853 case GST_V4L2_IO_DMABUF_IMPORT:
1854 case GST_V4L2_IO_DMABUF:
1855 case GST_V4L2_IO_MMAP:
1857 GstBuffer *to_queue = NULL;
1858 GstV4l2MemoryGroup *group;
1861 if ((*buf)->pool != bpool)
1864 if (!gst_v4l2_is_buffer_valid (*buf, &group))
1867 index = group->buffer.index;
1869 GST_LOG_OBJECT (pool, "processing buffer %i from our pool", index);
1871 if (pool->buffers[index] != NULL) {
1872 GST_LOG_OBJECT (pool, "buffer %i already queued, copying", index);
1876 /* we can queue directly */
1877 to_queue = gst_buffer_ref (*buf);
1880 if (to_queue == NULL) {
1881 GstBufferPoolAcquireParams params = { 0 };
1883 GST_LOG_OBJECT (pool, "alloc buffer from our pool");
1885 /* this can return EOS if all buffers are outstanding which would
1886 * be strange because we would expect the upstream element to have
1887 * allocated them and returned to us.. */
1888 params.flags = GST_BUFFER_POOL_ACQUIRE_FLAG_DONTWAIT;
1889 ret = gst_buffer_pool_acquire_buffer (bpool, &to_queue, ¶ms);
1890 if (ret != GST_FLOW_OK)
1891 goto acquire_failed;
1893 ret = gst_v4l2_buffer_pool_prepare_buffer (pool, to_queue, *buf);
1894 if (ret != GST_FLOW_OK) {
1895 gst_buffer_unref (to_queue);
1896 goto prepare_failed;
1900 if ((ret = gst_v4l2_buffer_pool_qbuf (pool, to_queue)) != GST_FLOW_OK)
1903 /* if we are not streaming yet (this is the first buffer, start
1905 if (!gst_v4l2_buffer_pool_streamon (pool)) {
1906 /* don't check return value because qbuf would have failed */
1907 gst_v4l2_is_buffer_valid (to_queue, &group);
1909 /* qbuf has stored to_queue buffer but we are not in
1910 * streaming state, so the flush logic won't be performed.
1911 * To avoid leaks, flush the allocator and restore the queued
1912 * buffer as non-queued */
1913 gst_v4l2_allocator_flush (pool->vallocator);
1915 pool->buffers[group->buffer.index] = NULL;
1917 gst_mini_object_set_qdata (GST_MINI_OBJECT (to_queue),
1918 GST_V4L2_IMPORT_QUARK, NULL, NULL);
1919 gst_buffer_unref (to_queue);
1920 g_atomic_int_add (&pool->num_queued, -1);
1924 /* Remove our ref, we will still hold this buffer in acquire as needed,
1925 * otherwise the pool will think it is outstanding and will refuse to stop. */
1926 gst_buffer_unref (to_queue);
1928 if (g_atomic_int_get (&pool->num_queued) >= pool->min_latency) {
1930 /* all buffers are queued, try to dequeue one and release it back
1931 * into the pool so that _acquire can get to it again. */
1932 ret = gst_v4l2_buffer_pool_dqbuf (pool, &out);
1933 if (ret == GST_FLOW_OK && out->pool == NULL)
1934 /* release the rendered buffer back into the pool. This wakes up any
1935 * thread waiting for a buffer in _acquire(). */
1936 gst_v4l2_buffer_pool_release_buffer (bpool, out);
1941 g_assert_not_reached ();
1946 g_assert_not_reached ();
1955 GST_ERROR_OBJECT (pool, "failed to copy buffer");
1960 GST_WARNING_OBJECT (pool, "Dropping corrupted buffer without payload");
1961 gst_buffer_unref (*buf);
1963 return GST_V4L2_FLOW_CORRUPTED_BUFFER;
1967 GST_DEBUG_OBJECT (pool, "end of stream reached");
1968 gst_buffer_unref (*buf);
1970 return GST_V4L2_FLOW_LAST_BUFFER;
1974 if (ret == GST_FLOW_FLUSHING)
1975 GST_DEBUG_OBJECT (pool, "flushing");
1977 GST_WARNING_OBJECT (pool, "failed to acquire a buffer: %s",
1978 gst_flow_get_name (ret));
1983 GST_ERROR_OBJECT (pool, "failed to prepare data");
1988 GST_ERROR_OBJECT (pool, "failed to queue buffer");
1993 GST_ERROR_OBJECT (pool, "failed to start streaming");
1994 return GST_FLOW_ERROR;
1999 gst_v4l2_buffer_pool_set_other_pool (GstV4l2BufferPool * pool,
2000 GstBufferPool * other_pool)
2002 g_return_if_fail (!gst_buffer_pool_is_active (GST_BUFFER_POOL (pool)));
2004 if (pool->other_pool)
2005 gst_object_unref (pool->other_pool);
2006 pool->other_pool = gst_object_ref (other_pool);
2010 gst_v4l2_buffer_pool_copy_at_threshold (GstV4l2BufferPool * pool, gboolean copy)
2012 GST_OBJECT_LOCK (pool);
2013 pool->enable_copy_threshold = copy;
2014 GST_OBJECT_UNLOCK (pool);