Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /* |
2 | * DMA memory management for framework level HCD code (hc_driver) | |
3 | * | |
4 | * This implementation plugs in through generic "usb_bus" level methods, | |
5 | * and should work with all USB controllers, regardles of bus type. | |
6 | */ | |
7 | ||
1da177e4 LT |
8 | #include <linux/module.h> |
9 | #include <linux/kernel.h> | |
10 | #include <linux/slab.h> | |
11 | #include <linux/device.h> | |
12 | #include <linux/mm.h> | |
0828376d | 13 | #include <linux/io.h> |
1da177e4 LT |
14 | #include <linux/dma-mapping.h> |
15 | #include <linux/dmapool.h> | |
1da177e4 | 16 | #include <linux/usb.h> |
27729aad | 17 | #include <linux/usb/hcd.h> |
1da177e4 LT |
18 | |
19 | ||
20 | /* | |
21 | * DMA-Coherent Buffers | |
22 | */ | |
23 | ||
24 | /* FIXME tune these based on pool statistics ... */ | |
0828376d | 25 | static const size_t pool_max[HCD_BUFFER_POOLS] = { |
1da177e4 LT |
26 | /* platforms without dma-friendly caches might need to |
27 | * prevent cacheline sharing... | |
28 | */ | |
29 | 32, | |
30 | 128, | |
31 | 512, | |
32 | PAGE_SIZE / 2 | |
33 | /* bigger --> allocate pages */ | |
34 | }; | |
35 | ||
36 | ||
37 | /* SETUP primitives */ | |
38 | ||
39 | /** | |
40 | * hcd_buffer_create - initialize buffer pools | |
41 | * @hcd: the bus whose buffer pools are to be initialized | |
42 | * Context: !in_interrupt() | |
43 | * | |
44 | * Call this as part of initializing a host controller that uses the dma | |
45 | * memory allocators. It initializes some pools of dma-coherent memory that | |
626f090c | 46 | * will be shared by all drivers using that controller. |
1da177e4 LT |
47 | * |
48 | * Call hcd_buffer_destroy() to clean up after using those pools. | |
626f090c YB |
49 | * |
50 | * Return: 0 if successful. A negative errno value otherwise. | |
1da177e4 | 51 | */ |
1a68f71d | 52 | int hcd_buffer_create(struct usb_hcd *hcd) |
1da177e4 | 53 | { |
1a68f71d | 54 | char name[16]; |
0828376d | 55 | int i, size; |
1da177e4 | 56 | |
b3476675 MD |
57 | if (!hcd->self.controller->dma_mask && |
58 | !(hcd->driver->flags & HCD_LOCAL_MEM)) | |
bd39b7f1 CH |
59 | return 0; |
60 | ||
2c044a48 GKH |
61 | for (i = 0; i < HCD_BUFFER_POOLS; i++) { |
62 | size = pool_max[i]; | |
63 | if (!size) | |
1da177e4 | 64 | continue; |
1a68f71d ON |
65 | snprintf(name, sizeof name, "buffer-%d", size); |
66 | hcd->pool[i] = dma_pool_create(name, hcd->self.controller, | |
1da177e4 | 67 | size, size, 0); |
0828376d | 68 | if (!hcd->pool[i]) { |
1a68f71d | 69 | hcd_buffer_destroy(hcd); |
1da177e4 LT |
70 | return -ENOMEM; |
71 | } | |
72 | } | |
73 | return 0; | |
74 | } | |
75 | ||
76 | ||
77 | /** | |
78 | * hcd_buffer_destroy - deallocate buffer pools | |
79 | * @hcd: the bus whose buffer pools are to be destroyed | |
80 | * Context: !in_interrupt() | |
81 | * | |
82 | * This frees the buffer pools created by hcd_buffer_create(). | |
83 | */ | |
1a68f71d | 84 | void hcd_buffer_destroy(struct usb_hcd *hcd) |
1da177e4 | 85 | { |
2c044a48 | 86 | int i; |
1da177e4 | 87 | |
2c044a48 GKH |
88 | for (i = 0; i < HCD_BUFFER_POOLS; i++) { |
89 | struct dma_pool *pool = hcd->pool[i]; | |
1da177e4 | 90 | if (pool) { |
1a68f71d | 91 | dma_pool_destroy(pool); |
1da177e4 LT |
92 | hcd->pool[i] = NULL; |
93 | } | |
94 | } | |
95 | } | |
96 | ||
97 | ||
441e143e | 98 | /* sometimes alloc/free could use kmalloc with GFP_DMA, for |
1da177e4 LT |
99 | * better sharing and to leverage mm/slab.c intelligence. |
100 | */ | |
101 | ||
1a68f71d | 102 | void *hcd_buffer_alloc( |
0828376d | 103 | struct usb_bus *bus, |
1da177e4 | 104 | size_t size, |
55016f10 | 105 | gfp_t mem_flags, |
1da177e4 LT |
106 | dma_addr_t *dma |
107 | ) | |
108 | { | |
17200583 | 109 | struct usb_hcd *hcd = bus_to_hcd(bus); |
0828376d | 110 | int i; |
1da177e4 LT |
111 | |
112 | /* some USB hosts just use PIO */ | |
b3476675 MD |
113 | if (!bus->controller->dma_mask && |
114 | !(hcd->driver->flags & HCD_LOCAL_MEM)) { | |
1da177e4 | 115 | *dma = ~(dma_addr_t) 0; |
1a68f71d | 116 | return kmalloc(size, mem_flags); |
1da177e4 LT |
117 | } |
118 | ||
119 | for (i = 0; i < HCD_BUFFER_POOLS; i++) { | |
0828376d TO |
120 | if (size <= pool_max[i]) |
121 | return dma_pool_alloc(hcd->pool[i], mem_flags, dma); | |
1da177e4 | 122 | } |
a8aa401f | 123 | return dma_alloc_coherent(hcd->self.controller, size, dma, mem_flags); |
1da177e4 LT |
124 | } |
125 | ||
1a68f71d | 126 | void hcd_buffer_free( |
0828376d | 127 | struct usb_bus *bus, |
1da177e4 | 128 | size_t size, |
0828376d | 129 | void *addr, |
1da177e4 LT |
130 | dma_addr_t dma |
131 | ) | |
132 | { | |
17200583 | 133 | struct usb_hcd *hcd = bus_to_hcd(bus); |
0828376d | 134 | int i; |
1da177e4 LT |
135 | |
136 | if (!addr) | |
137 | return; | |
138 | ||
b3476675 MD |
139 | if (!bus->controller->dma_mask && |
140 | !(hcd->driver->flags & HCD_LOCAL_MEM)) { | |
1a68f71d | 141 | kfree(addr); |
1da177e4 LT |
142 | return; |
143 | } | |
144 | ||
145 | for (i = 0; i < HCD_BUFFER_POOLS; i++) { | |
0828376d TO |
146 | if (size <= pool_max[i]) { |
147 | dma_pool_free(hcd->pool[i], addr, dma); | |
1da177e4 LT |
148 | return; |
149 | } | |
150 | } | |
1a68f71d | 151 | dma_free_coherent(hcd->self.controller, size, addr, dma); |
1da177e4 | 152 | } |