diff options
Diffstat (limited to 'drivers/dma/virt-dma.h')
-rw-r--r-- | drivers/dma/virt-dma.h | 152 |
1 files changed, 152 insertions, 0 deletions
diff --git a/drivers/dma/virt-dma.h b/drivers/dma/virt-dma.h new file mode 100644 index 000000000000..85c19d63f9fb --- /dev/null +++ b/drivers/dma/virt-dma.h | |||
@@ -0,0 +1,152 @@ | |||
1 | /* | ||
2 | * Virtual DMA channel support for DMAengine | ||
3 | * | ||
4 | * Copyright (C) 2012 Russell King | ||
5 | * | ||
6 | * This program is free software; you can redistribute it and/or modify | ||
7 | * it under the terms of the GNU General Public License version 2 as | ||
8 | * published by the Free Software Foundation. | ||
9 | */ | ||
10 | #ifndef VIRT_DMA_H | ||
11 | #define VIRT_DMA_H | ||
12 | |||
13 | #include <linux/dmaengine.h> | ||
14 | #include <linux/interrupt.h> | ||
15 | |||
16 | #include "dmaengine.h" | ||
17 | |||
18 | struct virt_dma_desc { | ||
19 | struct dma_async_tx_descriptor tx; | ||
20 | /* protected by vc.lock */ | ||
21 | struct list_head node; | ||
22 | }; | ||
23 | |||
24 | struct virt_dma_chan { | ||
25 | struct dma_chan chan; | ||
26 | struct tasklet_struct task; | ||
27 | void (*desc_free)(struct virt_dma_desc *); | ||
28 | |||
29 | spinlock_t lock; | ||
30 | |||
31 | /* protected by vc.lock */ | ||
32 | struct list_head desc_submitted; | ||
33 | struct list_head desc_issued; | ||
34 | struct list_head desc_completed; | ||
35 | |||
36 | struct virt_dma_desc *cyclic; | ||
37 | }; | ||
38 | |||
39 | static inline struct virt_dma_chan *to_virt_chan(struct dma_chan *chan) | ||
40 | { | ||
41 | return container_of(chan, struct virt_dma_chan, chan); | ||
42 | } | ||
43 | |||
44 | void vchan_dma_desc_free_list(struct virt_dma_chan *vc, struct list_head *head); | ||
45 | void vchan_init(struct virt_dma_chan *vc, struct dma_device *dmadev); | ||
46 | struct virt_dma_desc *vchan_find_desc(struct virt_dma_chan *, dma_cookie_t); | ||
47 | |||
48 | /** | ||
49 | * vchan_tx_prep - prepare a descriptor | ||
50 | * vc: virtual channel allocating this descriptor | ||
51 | * vd: virtual descriptor to prepare | ||
52 | * tx_flags: flags argument passed in to prepare function | ||
53 | */ | ||
54 | static inline struct dma_async_tx_descriptor *vchan_tx_prep(struct virt_dma_chan *vc, | ||
55 | struct virt_dma_desc *vd, unsigned long tx_flags) | ||
56 | { | ||
57 | extern dma_cookie_t vchan_tx_submit(struct dma_async_tx_descriptor *); | ||
58 | |||
59 | dma_async_tx_descriptor_init(&vd->tx, &vc->chan); | ||
60 | vd->tx.flags = tx_flags; | ||
61 | vd->tx.tx_submit = vchan_tx_submit; | ||
62 | |||
63 | return &vd->tx; | ||
64 | } | ||
65 | |||
66 | /** | ||
67 | * vchan_issue_pending - move submitted descriptors to issued list | ||
68 | * vc: virtual channel to update | ||
69 | * | ||
70 | * vc.lock must be held by caller | ||
71 | */ | ||
72 | static inline bool vchan_issue_pending(struct virt_dma_chan *vc) | ||
73 | { | ||
74 | list_splice_tail_init(&vc->desc_submitted, &vc->desc_issued); | ||
75 | return !list_empty(&vc->desc_issued); | ||
76 | } | ||
77 | |||
78 | /** | ||
79 | * vchan_cookie_complete - report completion of a descriptor | ||
80 | * vd: virtual descriptor to update | ||
81 | * | ||
82 | * vc.lock must be held by caller | ||
83 | */ | ||
84 | static inline void vchan_cookie_complete(struct virt_dma_desc *vd) | ||
85 | { | ||
86 | struct virt_dma_chan *vc = to_virt_chan(vd->tx.chan); | ||
87 | |||
88 | dma_cookie_complete(&vd->tx); | ||
89 | dev_vdbg(vc->chan.device->dev, "txd %p[%x]: marked complete\n", | ||
90 | vd, vd->tx.cookie); | ||
91 | list_add_tail(&vd->node, &vc->desc_completed); | ||
92 | |||
93 | tasklet_schedule(&vc->task); | ||
94 | } | ||
95 | |||
96 | /** | ||
97 | * vchan_cyclic_callback - report the completion of a period | ||
98 | * vd: virtual descriptor | ||
99 | */ | ||
100 | static inline void vchan_cyclic_callback(struct virt_dma_desc *vd) | ||
101 | { | ||
102 | struct virt_dma_chan *vc = to_virt_chan(vd->tx.chan); | ||
103 | |||
104 | vc->cyclic = vd; | ||
105 | tasklet_schedule(&vc->task); | ||
106 | } | ||
107 | |||
108 | /** | ||
109 | * vchan_next_desc - peek at the next descriptor to be processed | ||
110 | * vc: virtual channel to obtain descriptor from | ||
111 | * | ||
112 | * vc.lock must be held by caller | ||
113 | */ | ||
114 | static inline struct virt_dma_desc *vchan_next_desc(struct virt_dma_chan *vc) | ||
115 | { | ||
116 | if (list_empty(&vc->desc_issued)) | ||
117 | return NULL; | ||
118 | |||
119 | return list_first_entry(&vc->desc_issued, struct virt_dma_desc, node); | ||
120 | } | ||
121 | |||
122 | /** | ||
123 | * vchan_get_all_descriptors - obtain all submitted and issued descriptors | ||
124 | * vc: virtual channel to get descriptors from | ||
125 | * head: list of descriptors found | ||
126 | * | ||
127 | * vc.lock must be held by caller | ||
128 | * | ||
129 | * Removes all submitted and issued descriptors from internal lists, and | ||
130 | * provides a list of all descriptors found | ||
131 | */ | ||
132 | static inline void vchan_get_all_descriptors(struct virt_dma_chan *vc, | ||
133 | struct list_head *head) | ||
134 | { | ||
135 | list_splice_tail_init(&vc->desc_submitted, head); | ||
136 | list_splice_tail_init(&vc->desc_issued, head); | ||
137 | list_splice_tail_init(&vc->desc_completed, head); | ||
138 | } | ||
139 | |||
140 | static inline void vchan_free_chan_resources(struct virt_dma_chan *vc) | ||
141 | { | ||
142 | unsigned long flags; | ||
143 | LIST_HEAD(head); | ||
144 | |||
145 | spin_lock_irqsave(&vc->lock, flags); | ||
146 | vchan_get_all_descriptors(vc, &head); | ||
147 | spin_unlock_irqrestore(&vc->lock, flags); | ||
148 | |||
149 | vchan_dma_desc_free_list(vc, &head); | ||
150 | } | ||
151 | |||
152 | #endif | ||