88a6d34ad3bb8fbf38b35a8bbf1cfe09c13724de
[safe/jmp/linux-2.6] / drivers / media / video / cx18 / cx18-queue.h
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@radix.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);