Linux kernel & device driver programming

Cross-Referenced Linux and Device Driver Code

[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ]
Version: [ 2.6.11.8 ] [ 2.6.25 ] [ 2.6.25.8 ] [ 2.6.31.13 ] Architecture: [ i386 ]
  1 #ifndef B43legacy_DMA_H_
  2 #define B43legacy_DMA_H_
  3 
  4 #include <linux/list.h>
  5 #include <linux/spinlock.h>
  6 #include <linux/workqueue.h>
  7 #include <linux/linkage.h>
  8 #include <asm/atomic.h>
  9 
 10 #include "b43legacy.h"
 11 
 12 
 13 /* DMA-Interrupt reasons. */
 14 #define B43legacy_DMAIRQ_FATALMASK      ((1 << 10) | (1 << 11) | (1 << 12) \
 15                                          | (1 << 14) | (1 << 15))
 16 #define B43legacy_DMAIRQ_NONFATALMASK   (1 << 13)
 17 #define B43legacy_DMAIRQ_RX_DONE                (1 << 16)
 18 
 19 
 20 /*** 32-bit DMA Engine. ***/
 21 
 22 /* 32-bit DMA controller registers. */
 23 #define B43legacy_DMA32_TXCTL                           0x00
 24 #define         B43legacy_DMA32_TXENABLE                0x00000001
 25 #define         B43legacy_DMA32_TXSUSPEND               0x00000002
 26 #define         B43legacy_DMA32_TXLOOPBACK              0x00000004
 27 #define         B43legacy_DMA32_TXFLUSH                 0x00000010
 28 #define         B43legacy_DMA32_TXADDREXT_MASK          0x00030000
 29 #define         B43legacy_DMA32_TXADDREXT_SHIFT         16
 30 #define B43legacy_DMA32_TXRING                          0x04
 31 #define B43legacy_DMA32_TXINDEX                         0x08
 32 #define B43legacy_DMA32_TXSTATUS                        0x0C
 33 #define         B43legacy_DMA32_TXDPTR                  0x00000FFF
 34 #define         B43legacy_DMA32_TXSTATE                 0x0000F000
 35 #define                 B43legacy_DMA32_TXSTAT_DISABLED 0x00000000
 36 #define                 B43legacy_DMA32_TXSTAT_ACTIVE   0x00001000
 37 #define                 B43legacy_DMA32_TXSTAT_IDLEWAIT 0x00002000
 38 #define                 B43legacy_DMA32_TXSTAT_STOPPED  0x00003000
 39 #define                 B43legacy_DMA32_TXSTAT_SUSP     0x00004000
 40 #define         B43legacy_DMA32_TXERROR                 0x000F0000
 41 #define                 B43legacy_DMA32_TXERR_NOERR     0x00000000
 42 #define                 B43legacy_DMA32_TXERR_PROT      0x00010000
 43 #define                 B43legacy_DMA32_TXERR_UNDERRUN  0x00020000
 44 #define                 B43legacy_DMA32_TXERR_BUFREAD   0x00030000
 45 #define                 B43legacy_DMA32_TXERR_DESCREAD  0x00040000
 46 #define         B43legacy_DMA32_TXACTIVE                0xFFF00000
 47 #define B43legacy_DMA32_RXCTL                           0x10
 48 #define         B43legacy_DMA32_RXENABLE                0x00000001
 49 #define         B43legacy_DMA32_RXFROFF_MASK            0x000000FE
 50 #define         B43legacy_DMA32_RXFROFF_SHIFT           1
 51 #define         B43legacy_DMA32_RXDIRECTFIFO            0x00000100
 52 #define         B43legacy_DMA32_RXADDREXT_MASK          0x00030000
 53 #define         B43legacy_DMA32_RXADDREXT_SHIFT         16
 54 #define B43legacy_DMA32_RXRING                          0x14
 55 #define B43legacy_DMA32_RXINDEX                         0x18
 56 #define B43legacy_DMA32_RXSTATUS                        0x1C
 57 #define         B43legacy_DMA32_RXDPTR                  0x00000FFF
 58 #define         B43legacy_DMA32_RXSTATE                 0x0000F000
 59 #define                 B43legacy_DMA32_RXSTAT_DISABLED 0x00000000
 60 #define                 B43legacy_DMA32_RXSTAT_ACTIVE   0x00001000
 61 #define                 B43legacy_DMA32_RXSTAT_IDLEWAIT 0x00002000
 62 #define                 B43legacy_DMA32_RXSTAT_STOPPED  0x00003000
 63 #define         B43legacy_DMA32_RXERROR                 0x000F0000
 64 #define                 B43legacy_DMA32_RXERR_NOERR     0x00000000
 65 #define                 B43legacy_DMA32_RXERR_PROT      0x00010000
 66 #define                 B43legacy_DMA32_RXERR_OVERFLOW  0x00020000
 67 #define                 B43legacy_DMA32_RXERR_BUFWRITE  0x00030000
 68 #define                 B43legacy_DMA32_RXERR_DESCREAD  0x00040000
 69 #define         B43legacy_DMA32_RXACTIVE                0xFFF00000
 70 
 71 /* 32-bit DMA descriptor. */
 72 struct b43legacy_dmadesc32 {
 73         __le32 control;
 74         __le32 address;
 75 } __attribute__((__packed__));
 76 #define B43legacy_DMA32_DCTL_BYTECNT            0x00001FFF
 77 #define B43legacy_DMA32_DCTL_ADDREXT_MASK       0x00030000
 78 #define B43legacy_DMA32_DCTL_ADDREXT_SHIFT      16
 79 #define B43legacy_DMA32_DCTL_DTABLEEND          0x10000000
 80 #define B43legacy_DMA32_DCTL_IRQ                0x20000000
 81 #define B43legacy_DMA32_DCTL_FRAMEEND           0x40000000
 82 #define B43legacy_DMA32_DCTL_FRAMESTART         0x80000000
 83 
 84 
 85 
 86 /*** 64-bit DMA Engine. ***/
 87 
 88 /* 64-bit DMA controller registers. */
 89 #define B43legacy_DMA64_TXCTL                           0x00
 90 #define         B43legacy_DMA64_TXENABLE                0x00000001
 91 #define         B43legacy_DMA64_TXSUSPEND               0x00000002
 92 #define         B43legacy_DMA64_TXLOOPBACK              0x00000004
 93 #define         B43legacy_DMA64_TXFLUSH                 0x00000010
 94 #define         B43legacy_DMA64_TXADDREXT_MASK          0x00030000
 95 #define         B43legacy_DMA64_TXADDREXT_SHIFT         16
 96 #define B43legacy_DMA64_TXINDEX                         0x04
 97 #define B43legacy_DMA64_TXRINGLO                        0x08
 98 #define B43legacy_DMA64_TXRINGHI                        0x0C
 99 #define B43legacy_DMA64_TXSTATUS                        0x10
100 #define         B43legacy_DMA64_TXSTATDPTR              0x00001FFF
101 #define         B43legacy_DMA64_TXSTAT                  0xF0000000
102 #define                 B43legacy_DMA64_TXSTAT_DISABLED 0x00000000
103 #define                 B43legacy_DMA64_TXSTAT_ACTIVE   0x10000000
104 #define                 B43legacy_DMA64_TXSTAT_IDLEWAIT 0x20000000
105 #define                 B43legacy_DMA64_TXSTAT_STOPPED  0x30000000
106 #define                 B43legacy_DMA64_TXSTAT_SUSP     0x40000000
107 #define B43legacy_DMA64_TXERROR                         0x14
108 #define         B43legacy_DMA64_TXERRDPTR               0x0001FFFF
109 #define         B43legacy_DMA64_TXERR                   0xF0000000
110 #define                 B43legacy_DMA64_TXERR_NOERR     0x00000000
111 #define                 B43legacy_DMA64_TXERR_PROT      0x10000000
112 #define                 B43legacy_DMA64_TXERR_UNDERRUN  0x20000000
113 #define                 B43legacy_DMA64_TXERR_TRANSFER  0x30000000
114 #define                 B43legacy_DMA64_TXERR_DESCREAD  0x40000000
115 #define                 B43legacy_DMA64_TXERR_CORE      0x50000000
116 #define B43legacy_DMA64_RXCTL                           0x20
117 #define         B43legacy_DMA64_RXENABLE                0x00000001
118 #define         B43legacy_DMA64_RXFROFF_MASK            0x000000FE
119 #define         B43legacy_DMA64_RXFROFF_SHIFT           1
120 #define         B43legacy_DMA64_RXDIRECTFIFO            0x00000100
121 #define         B43legacy_DMA64_RXADDREXT_MASK          0x00030000
122 #define         B43legacy_DMA64_RXADDREXT_SHIFT         16
123 #define B43legacy_DMA64_RXINDEX                         0x24
124 #define B43legacy_DMA64_RXRINGLO                        0x28
125 #define B43legacy_DMA64_RXRINGHI                        0x2C
126 #define B43legacy_DMA64_RXSTATUS                        0x30
127 #define         B43legacy_DMA64_RXSTATDPTR              0x00001FFF
128 #define         B43legacy_DMA64_RXSTAT                  0xF0000000
129 #define                 B43legacy_DMA64_RXSTAT_DISABLED 0x00000000
130 #define                 B43legacy_DMA64_RXSTAT_ACTIVE   0x10000000
131 #define                 B43legacy_DMA64_RXSTAT_IDLEWAIT 0x20000000
132 #define                 B43legacy_DMA64_RXSTAT_STOPPED  0x30000000
133 #define                 B43legacy_DMA64_RXSTAT_SUSP     0x40000000
134 #define B43legacy_DMA64_RXERROR                         0x34
135 #define         B43legacy_DMA64_RXERRDPTR               0x0001FFFF
136 #define         B43legacy_DMA64_RXERR                   0xF0000000
137 #define                 B43legacy_DMA64_RXERR_NOERR     0x00000000
138 #define                 B43legacy_DMA64_RXERR_PROT      0x10000000
139 #define                 B43legacy_DMA64_RXERR_UNDERRUN  0x20000000
140 #define                 B43legacy_DMA64_RXERR_TRANSFER  0x30000000
141 #define                 B43legacy_DMA64_RXERR_DESCREAD  0x40000000
142 #define                 B43legacy_DMA64_RXERR_CORE      0x50000000
143 
144 /* 64-bit DMA descriptor. */
145 struct b43legacy_dmadesc64 {
146         __le32 control0;
147         __le32 control1;
148         __le32 address_low;
149         __le32 address_high;
150 } __attribute__((__packed__));
151 #define B43legacy_DMA64_DCTL0_DTABLEEND         0x10000000
152 #define B43legacy_DMA64_DCTL0_IRQ               0x20000000
153 #define B43legacy_DMA64_DCTL0_FRAMEEND          0x40000000
154 #define B43legacy_DMA64_DCTL0_FRAMESTART        0x80000000
155 #define B43legacy_DMA64_DCTL1_BYTECNT           0x00001FFF
156 #define B43legacy_DMA64_DCTL1_ADDREXT_MASK      0x00030000
157 #define B43legacy_DMA64_DCTL1_ADDREXT_SHIFT     16
158 
159 
160 
161 struct b43legacy_dmadesc_generic {
162         union {
163                 struct b43legacy_dmadesc32 dma32;
164                 struct b43legacy_dmadesc64 dma64;
165         } __attribute__((__packed__));
166 } __attribute__((__packed__));
167 
168 
169 /* Misc DMA constants */
170 #define B43legacy_DMA_RINGMEMSIZE       PAGE_SIZE
171 #define B43legacy_DMA0_RX_FRAMEOFFSET   30
172 #define B43legacy_DMA3_RX_FRAMEOFFSET   0
173 
174 
175 /* DMA engine tuning knobs */
176 #define B43legacy_TXRING_SLOTS          128
177 #define B43legacy_RXRING_SLOTS          64
178 #define B43legacy_DMA0_RX_BUFFERSIZE    (2304 + 100)
179 #define B43legacy_DMA3_RX_BUFFERSIZE    16
180 
181 
182 
183 #ifdef CONFIG_B43LEGACY_DMA
184 
185 
186 struct sk_buff;
187 struct b43legacy_private;
188 struct b43legacy_txstatus;
189 
190 
191 struct b43legacy_dmadesc_meta {
192         /* The kernel DMA-able buffer. */
193         struct sk_buff *skb;
194         /* DMA base bus-address of the descriptor buffer. */
195         dma_addr_t dmaaddr;
196         /* ieee80211 TX status. Only used once per 802.11 frag. */
197         bool is_last_fragment;
198         struct ieee80211_tx_status txstat;
199 };
200 
201 struct b43legacy_dmaring;
202 
203 /* Lowlevel DMA operations that differ between 32bit and 64bit DMA. */
204 struct b43legacy_dma_ops {
205         struct b43legacy_dmadesc_generic * (*idx2desc)
206                                            (struct b43legacy_dmaring *ring,
207                                            int slot,
208                                            struct b43legacy_dmadesc_meta
209                                            **meta);
210         void (*fill_descriptor)(struct b43legacy_dmaring *ring,
211                                 struct b43legacy_dmadesc_generic *desc,
212                                 dma_addr_t dmaaddr, u16 bufsize,
213                                 int start, int end, int irq);
214         void (*poke_tx)(struct b43legacy_dmaring *ring, int slot);
215         void (*tx_suspend)(struct b43legacy_dmaring *ring);
216         void (*tx_resume)(struct b43legacy_dmaring *ring);
217         int (*get_current_rxslot)(struct b43legacy_dmaring *ring);
218         void (*set_current_rxslot)(struct b43legacy_dmaring *ring, int slot);
219 };
220 
221 enum b43legacy_dmatype {
222         B43legacy_DMA_30BIT = 30,
223         B43legacy_DMA_32BIT = 32,
224         B43legacy_DMA_64BIT = 64,
225 };
226 
227 struct b43legacy_dmaring {
228         /* Lowlevel DMA ops. */
229         const struct b43legacy_dma_ops *ops;
230         /* Kernel virtual base address of the ring memory. */
231         void *descbase;
232         /* Meta data about all descriptors. */
233         struct b43legacy_dmadesc_meta *meta;
234         /* Cache of TX headers for each slot.
235          * This is to avoid an allocation on each TX.
236          * This is NULL for an RX ring.
237          */
238         u8 *txhdr_cache;
239         /* (Unadjusted) DMA base bus-address of the ring memory. */
240         dma_addr_t dmabase;
241         /* Number of descriptor slots in the ring. */
242         int nr_slots;
243         /* Number of used descriptor slots. */
244         int used_slots;
245         /* Currently used slot in the ring. */
246         int current_slot;
247         /* Total number of packets sent. Statistics only. */
248         unsigned int nr_tx_packets;
249         /* Frameoffset in octets. */
250         u32 frameoffset;
251         /* Descriptor buffer size. */
252         u16 rx_buffersize;
253         /* The MMIO base register of the DMA controller. */
254         u16 mmio_base;
255         /* DMA controller index number (0-5). */
256         int index;
257         /* Boolean. Is this a TX ring? */
258         bool tx;
259         /* The type of DMA engine used. */
260         enum b43legacy_dmatype type;
261         /* Boolean. Is this ring stopped at ieee80211 level? */
262         bool stopped;
263         /* Lock, only used for TX. */
264         spinlock_t lock;
265         struct b43legacy_wldev *dev;
266 #ifdef CONFIG_B43LEGACY_DEBUG
267         /* Maximum number of used slots. */
268         int max_used_slots;
269         /* Last time we injected a ring overflow. */
270         unsigned long last_injected_overflow;
271 #endif /* CONFIG_B43LEGACY_DEBUG*/
272 };
273 
274 
275 static inline
276 u32 b43legacy_dma_read(struct b43legacy_dmaring *ring,
277                        u16 offset)
278 {
279         return b43legacy_read32(ring->dev, ring->mmio_base + offset);
280 }
281 
282 static inline
283 void b43legacy_dma_write(struct b43legacy_dmaring *ring,
284                          u16 offset, u32 value)
285 {
286         b43legacy_write32(ring->dev, ring->mmio_base + offset, value);
287 }
288 
289 
290 int b43legacy_dma_init(struct b43legacy_wldev *dev);
291 void b43legacy_dma_free(struct b43legacy_wldev *dev);
292 
293 void b43legacy_dma_tx_suspend(struct b43legacy_wldev *dev);
294 void b43legacy_dma_tx_resume(struct b43legacy_wldev *dev);
295 
296 void b43legacy_dma_get_tx_stats(struct b43legacy_wldev *dev,
297                                 struct ieee80211_tx_queue_stats *stats);
298 
299 int b43legacy_dma_tx(struct b43legacy_wldev *dev,
300                      struct sk_buff *skb,
301                      struct ieee80211_tx_control *ctl);
302 void b43legacy_dma_handle_txstatus(struct b43legacy_wldev *dev,
303                                    const struct b43legacy_txstatus *status);
304 
305 void b43legacy_dma_rx(struct b43legacy_dmaring *ring);
306 
307 #else /* CONFIG_B43LEGACY_DMA */
308 
309 
310 static inline
311 int b43legacy_dma_init(struct b43legacy_wldev *dev)
312 {
313         return 0;
314 }
315 static inline
316 void b43legacy_dma_free(struct b43legacy_wldev *dev)
317 {
318 }
319 static inline
320 void b43legacy_dma_get_tx_stats(struct b43legacy_wldev *dev,
321                                 struct ieee80211_tx_queue_stats *stats)
322 {
323 }
324 static inline
325 int b43legacy_dma_tx(struct b43legacy_wldev *dev,
326                      struct sk_buff *skb,
327                      struct ieee80211_tx_control *ctl)
328 {
329         return 0;
330 }
331 static inline
332 void b43legacy_dma_handle_txstatus(struct b43legacy_wldev *dev,
333                                    const struct b43legacy_txstatus *status)
334 {
335 }
336 static inline
337 void b43legacy_dma_rx(struct b43legacy_dmaring *ring)
338 {
339 }
340 static inline
341 void b43legacy_dma_tx_suspend(struct b43legacy_wldev *dev)
342 {
343 }
344 static inline
345 void b43legacy_dma_tx_resume(struct b43legacy_wldev *dev)
346 {
347 }
348 
349 #endif /* CONFIG_B43LEGACY_DMA */
350 #endif /* B43legacy_DMA_H_ */
351 
  This page was automatically generated by the LXR engine.