]>
git.proxmox.com Git - mirror_ubuntu-eoan-kernel.git/blob - include/media/dvb_vb2.h
2 * SPDX-License-Identifier: GPL-2.0
4 * dvb-vb2.h - DVB driver helper framework for streaming I/O
6 * Copyright (C) 2015 Samsung Electronics
8 * Author: jh1009.sung@samsung.com
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation.
18 #include <linux/mutex.h>
19 #include <linux/poll.h>
20 #include <linux/dvb/dmx.h>
21 #include <media/videobuf2-core.h>
22 #include <media/videobuf2-dma-contig.h>
23 #include <media/videobuf2-vmalloc.h>
26 * enum dvb_buf_type - types of Digital TV memory-mapped buffers
28 * @DVB_BUF_TYPE_CAPTURE: buffer is filled by the Kernel,
29 * with a received Digital TV stream
32 DVB_BUF_TYPE_CAPTURE
= 1,
36 * enum dvb_vb2_states - states to control VB2 state machine
37 * @DVB_VB2_STATE_NONE:
38 * VB2 engine not initialized yet, init failed or VB2 was released.
39 * @DVB_VB2_STATE_INIT:
40 * VB2 engine initialized.
41 * @DVB_VB2_STATE_REQBUFS:
42 * Buffers were requested
43 * @DVB_VB2_STATE_STREAMON:
44 * VB2 is streaming. Callers should not check it directly. Instead,
45 * they should use dvb_vb2_is_streaming().
49 * Callers should not touch at the state machine directly. This
50 * is handled inside dvb_vb2.c.
53 DVB_VB2_STATE_NONE
= 0x0,
54 DVB_VB2_STATE_INIT
= 0x1,
55 DVB_VB2_STATE_REQBUFS
= 0x2,
56 DVB_VB2_STATE_STREAMON
= 0x4,
59 #define DVB_VB2_NAME_MAX (20)
62 * struct dvb_buffer - video buffer information for v4l2.
64 * @vb: embedded struct &vb2_buffer.
65 * @list: list of &struct dvb_buffer.
69 struct list_head list
;
73 * struct dvb_vb2_ctx - control struct for VB2 handler
74 * @vb_q: pointer to &struct vb2_queue with videobuf2 queue.
75 * @mutex: mutex to serialize vb2 operations. Used by
76 * vb2 core %wait_prepare and %wait_finish operations.
77 * @slock: spin lock used to protect buffer filling at dvb_vb2.c.
78 * @dvb_q: List of buffers that are not filled yet.
79 * @buf: Pointer to the buffer that are currently being filled.
80 * @offset: index to the next position at the @buf to be filled.
81 * @remain: How many bytes are left to be filled at @buf.
82 * @state: bitmask of buffer states as defined by &enum dvb_vb2_states.
83 * @buf_siz: size of each VB2 buffer.
84 * @buf_cnt: number of VB2 buffers.
86 * If different than zero, device is operating on non-blocking
88 * @flags: buffer flags as defined by &enum dmx_buffer_flags.
89 * Filled only at &DMX_DQBUF. &DMX_QBUF should zero this field.
90 * @count: monotonic counter for filled buffers. Helps to identify
91 * data stream loses. Filled only at &DMX_DQBUF. &DMX_QBUF should
94 * @name: name of the device type. Currently, it can either be
95 * "dvr" or "demux_filter".
98 struct vb2_queue vb_q
;
101 struct list_head dvb_q
;
102 struct dvb_buffer
*buf
;
110 enum dmx_buffer_flags flags
;
113 char name
[DVB_VB2_NAME_MAX
+ 1];
116 #ifndef CONFIG_DVB_MMAP
117 static inline int dvb_vb2_init(struct dvb_vb2_ctx
*ctx
,
118 const char *name
, int non_blocking
)
122 static inline int dvb_vb2_release(struct dvb_vb2_ctx
*ctx
)
126 #define dvb_vb2_is_streaming(ctx) (0)
127 #define dvb_vb2_fill_buffer(ctx, file, wait, flags) (0)
129 static inline __poll_t
dvb_vb2_poll(struct dvb_vb2_ctx
*ctx
,
137 * dvb_vb2_init - initializes VB2 handler
139 * @ctx: control struct for VB2 handler
140 * @name: name for the VB2 handler
142 * if not zero, it means that the device is at non-blocking mode
144 int dvb_vb2_init(struct dvb_vb2_ctx
*ctx
, const char *name
, int non_blocking
);
147 * dvb_vb2_release - Releases the VB2 handler allocated resources and
148 * put @ctx at DVB_VB2_STATE_NONE state.
149 * @ctx: control struct for VB2 handler
151 int dvb_vb2_release(struct dvb_vb2_ctx
*ctx
);
154 * dvb_vb2_is_streaming - checks if the VB2 handler is streaming
155 * @ctx: control struct for VB2 handler
157 * Return: 0 if not streaming, 1 otherwise.
159 int dvb_vb2_is_streaming(struct dvb_vb2_ctx
*ctx
);
162 * dvb_vb2_fill_buffer - fills a VB2 buffer
163 * @ctx: control struct for VB2 handler
164 * @src: place where the data is stored
165 * @len: number of bytes to be copied from @src
167 * pointer to buffer flags as defined by &enum dmx_buffer_flags.
170 int dvb_vb2_fill_buffer(struct dvb_vb2_ctx
*ctx
,
171 const unsigned char *src
, int len
,
172 enum dmx_buffer_flags
*buffer_flags
);
175 * dvb_vb2_poll - Wrapper to vb2_core_streamon() for Digital TV
178 * @ctx: control struct for VB2 handler
179 * @file: &struct file argument passed to the poll
180 * file operation handler.
181 * @wait: &poll_table wait argument passed to the poll
182 * file operation handler.
184 * Implements poll syscall() logic.
186 __poll_t
dvb_vb2_poll(struct dvb_vb2_ctx
*ctx
, struct file
*file
,
191 * dvb_vb2_stream_on() - Wrapper to vb2_core_streamon() for Digital TV
194 * @ctx: control struct for VB2 handler
196 * Starts dvb streaming
198 int dvb_vb2_stream_on(struct dvb_vb2_ctx
*ctx
);
200 * dvb_vb2_stream_off() - Wrapper to vb2_core_streamoff() for Digital TV
203 * @ctx: control struct for VB2 handler
205 * Stops dvb streaming
207 int dvb_vb2_stream_off(struct dvb_vb2_ctx
*ctx
);
210 * dvb_vb2_reqbufs() - Wrapper to vb2_core_reqbufs() for Digital TV
213 * @ctx: control struct for VB2 handler
214 * @req: &struct dmx_requestbuffers passed from userspace in
215 * order to handle &DMX_REQBUFS.
217 * Initiate streaming by requesting a number of buffers. Also used to
218 * free previously requested buffers, is ``req->count`` is zero.
220 int dvb_vb2_reqbufs(struct dvb_vb2_ctx
*ctx
, struct dmx_requestbuffers
*req
);
223 * dvb_vb2_querybuf() - Wrapper to vb2_core_querybuf() for Digital TV
226 * @ctx: control struct for VB2 handler
227 * @b: &struct dmx_buffer passed from userspace in
228 * order to handle &DMX_QUERYBUF.
232 int dvb_vb2_querybuf(struct dvb_vb2_ctx
*ctx
, struct dmx_buffer
*b
);
235 * dvb_vb2_expbuf() - Wrapper to vb2_core_expbuf() for Digital TV
238 * @ctx: control struct for VB2 handler
239 * @exp: &struct dmx_exportbuffer passed from userspace in
240 * order to handle &DMX_EXPBUF.
242 * Export a buffer as a file descriptor.
244 int dvb_vb2_expbuf(struct dvb_vb2_ctx
*ctx
, struct dmx_exportbuffer
*exp
);
247 * dvb_vb2_qbuf() - Wrapper to vb2_core_qbuf() for Digital TV buffer handling.
249 * @ctx: control struct for VB2 handler
250 * @b: &struct dmx_buffer passed from userspace in
251 * order to handle &DMX_QBUF.
253 * Queue a Digital TV buffer as requested by userspace
255 int dvb_vb2_qbuf(struct dvb_vb2_ctx
*ctx
, struct dmx_buffer
*b
);
258 * dvb_vb2_dqbuf() - Wrapper to vb2_core_dqbuf() for Digital TV
261 * @ctx: control struct for VB2 handler
262 * @b: &struct dmx_buffer passed from userspace in
263 * order to handle &DMX_DQBUF.
265 * Dequeue a Digital TV buffer to the userspace
267 int dvb_vb2_dqbuf(struct dvb_vb2_ctx
*ctx
, struct dmx_buffer
*b
);
270 * dvb_vb2_mmap() - Wrapper to vb2_mmap() for Digital TV buffer handling.
272 * @ctx: control struct for VB2 handler
273 * @vma: pointer to &struct vm_area_struct with the vma passed
274 * to the mmap file operation handler in the driver.
276 * map Digital TV video buffers into application address space.
278 int dvb_vb2_mmap(struct dvb_vb2_ctx
*ctx
, struct vm_area_struct
*vma
);
280 #endif /* _DVB_VB2_H */