xref: /linux/drivers/media/pci/cx18/cx18-queue.h (revision a2cce7a9f1b8cc3d4edce106fb971529f1d4d9ce)
1 /*
2  *  cx18 buffer queues
3  *
4  *  Derived from ivtv-queue.h
5  *
6  *  Copyright (C) 2007  Hans Verkuil <hverkuil@xs4all.nl>
7  *  Copyright (C) 2008  Andy Walls <awalls@md.metrocast.net>
8  *
9  *  This program is free software; you can redistribute it and/or modify
10  *  it under the terms of the GNU General Public License as published by
11  *  the Free Software Foundation; either version 2 of the License, or
12  *  (at your option) any later version.
13  *
14  *  This program 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
17  *  GNU General Public License for more details.
18  *
19  *  You should have received a copy of the GNU General Public License
20  *  along with this program; if not, write to the Free Software
21  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
22  *  02111-1307  USA
23  */
24 
25 #define CX18_DMA_UNMAPPED	((u32) -1)
26 
27 /* cx18_buffer utility functions */
28 
29 static inline void cx18_buf_sync_for_cpu(struct cx18_stream *s,
30 	struct cx18_buffer *buf)
31 {
32 	pci_dma_sync_single_for_cpu(s->cx->pci_dev, buf->dma_handle,
33 				s->buf_size, s->dma);
34 }
35 
36 static inline void cx18_buf_sync_for_device(struct cx18_stream *s,
37 	struct cx18_buffer *buf)
38 {
39 	pci_dma_sync_single_for_device(s->cx->pci_dev, buf->dma_handle,
40 				s->buf_size, s->dma);
41 }
42 
43 void _cx18_mdl_sync_for_device(struct cx18_stream *s, struct cx18_mdl *mdl);
44 
45 static inline void cx18_mdl_sync_for_device(struct cx18_stream *s,
46 					    struct cx18_mdl *mdl)
47 {
48 	if (list_is_singular(&mdl->buf_list))
49 		cx18_buf_sync_for_device(s, list_first_entry(&mdl->buf_list,
50 							     struct cx18_buffer,
51 							     list));
52 	else
53 		_cx18_mdl_sync_for_device(s, mdl);
54 }
55 
56 void cx18_buf_swap(struct cx18_buffer *buf);
57 void _cx18_mdl_swap(struct cx18_mdl *mdl);
58 
59 static inline void cx18_mdl_swap(struct cx18_mdl *mdl)
60 {
61 	if (list_is_singular(&mdl->buf_list))
62 		cx18_buf_swap(list_first_entry(&mdl->buf_list,
63 					       struct cx18_buffer, list));
64 	else
65 		_cx18_mdl_swap(mdl);
66 }
67 
68 /* cx18_queue utility functions */
69 struct cx18_queue *_cx18_enqueue(struct cx18_stream *s, struct cx18_mdl *mdl,
70 				 struct cx18_queue *q, int to_front);
71 
72 static inline
73 struct cx18_queue *cx18_enqueue(struct cx18_stream *s, struct cx18_mdl *mdl,
74 				struct cx18_queue *q)
75 {
76 	return _cx18_enqueue(s, mdl, q, 0); /* FIFO */
77 }
78 
79 static inline
80 struct cx18_queue *cx18_push(struct cx18_stream *s, struct cx18_mdl *mdl,
81 			     struct cx18_queue *q)
82 {
83 	return _cx18_enqueue(s, mdl, q, 1); /* LIFO */
84 }
85 
86 void cx18_queue_init(struct cx18_queue *q);
87 struct cx18_mdl *cx18_dequeue(struct cx18_stream *s, struct cx18_queue *q);
88 struct cx18_mdl *cx18_queue_get_mdl(struct cx18_stream *s, u32 id,
89 	u32 bytesused);
90 void cx18_flush_queues(struct cx18_stream *s);
91 
92 /* queue MDL reconfiguration helpers */
93 void cx18_unload_queues(struct cx18_stream *s);
94 void cx18_load_queues(struct cx18_stream *s);
95 
96 /* cx18_stream utility functions */
97 int cx18_stream_alloc(struct cx18_stream *s);
98 void cx18_stream_free(struct cx18_stream *s);
99