blob: 082509eb805d5395ed356ef0e9378432f891b96e [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
Jaroslav Kyselac1017a42007-10-15 09:50:19 +02002 * Copyright (c) by Jaroslav Kysela <perex@perex.cz>
Linus Torvalds1da177e2005-04-16 15:20:36 -07003 * Takashi Iwai <tiwai@suse.de>
4 *
5 * Generic memory allocators
6 *
7 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21 *
22 */
23
Linus Torvalds1da177e2005-04-16 15:20:36 -070024#include <linux/slab.h>
25#include <linux/mm.h>
26#include <linux/dma-mapping.h>
Nicolin Chen05503212013-10-23 11:47:43 +080027#include <linux/genalloc.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070028#include <sound/memalloc.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070029
Linus Torvalds1da177e2005-04-16 15:20:36 -070030/*
Linus Torvalds1da177e2005-04-16 15:20:36 -070031 *
32 * Generic memory allocators
33 *
34 */
35
Linus Torvalds1da177e2005-04-16 15:20:36 -070036/**
37 * snd_malloc_pages - allocate pages with the given size
38 * @size: the size to allocate in bytes
39 * @gfp_flags: the allocation conditions, GFP_XXX
40 *
41 * Allocates the physically contiguous pages with the given size.
42 *
Yacine Belkadieb7c06e2013-03-11 22:05:14 +010043 * Return: The pointer of the buffer, or %NULL if no enough memory.
Linus Torvalds1da177e2005-04-16 15:20:36 -070044 */
Al Viro1ef64e62005-10-21 03:22:18 -040045void *snd_malloc_pages(size_t size, gfp_t gfp_flags)
Linus Torvalds1da177e2005-04-16 15:20:36 -070046{
47 int pg;
Linus Torvalds1da177e2005-04-16 15:20:36 -070048
Takashi Iwai7eaa9432008-08-08 17:09:09 +020049 if (WARN_ON(!size))
50 return NULL;
51 if (WARN_ON(!gfp_flags))
52 return NULL;
Hugh Dickinsf3d48f02005-11-21 21:32:22 -080053 gfp_flags |= __GFP_COMP; /* compound page lets parts be mapped */
Linus Torvalds1da177e2005-04-16 15:20:36 -070054 pg = get_order(size);
Takashi Iwaid7b13542014-01-08 16:09:31 +010055 return (void *) __get_free_pages(gfp_flags, pg);
Linus Torvalds1da177e2005-04-16 15:20:36 -070056}
57
58/**
59 * snd_free_pages - release the pages
60 * @ptr: the buffer pointer to release
61 * @size: the allocated buffer size
62 *
63 * Releases the buffer allocated via snd_malloc_pages().
64 */
65void snd_free_pages(void *ptr, size_t size)
66{
67 int pg;
68
69 if (ptr == NULL)
70 return;
71 pg = get_order(size);
Linus Torvalds1da177e2005-04-16 15:20:36 -070072 free_pages((unsigned long) ptr, pg);
73}
74
75/*
76 *
77 * Bus-specific memory allocators
78 *
79 */
80
Takashi Iwai8f115512007-07-26 18:59:36 +020081#ifdef CONFIG_HAS_DMA
Linus Torvalds1da177e2005-04-16 15:20:36 -070082/* allocate the coherent DMA pages */
83static void *snd_malloc_dev_pages(struct device *dev, size_t size, dma_addr_t *dma)
84{
85 int pg;
Al Viro1ef64e62005-10-21 03:22:18 -040086 gfp_t gfp_flags;
Linus Torvalds1da177e2005-04-16 15:20:36 -070087
Takashi Iwai7eaa9432008-08-08 17:09:09 +020088 if (WARN_ON(!dma))
89 return NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -070090 pg = get_order(size);
91 gfp_flags = GFP_KERNEL
Hugh Dickinsf3d48f02005-11-21 21:32:22 -080092 | __GFP_COMP /* compound page lets parts be mapped */
Linus Torvalds1da177e2005-04-16 15:20:36 -070093 | __GFP_NORETRY /* don't trigger OOM-killer */
94 | __GFP_NOWARN; /* no stack trace print - this call is non-critical */
Takashi Iwaid7b13542014-01-08 16:09:31 +010095 return dma_alloc_coherent(dev, PAGE_SIZE << pg, dma, gfp_flags);
Linus Torvalds1da177e2005-04-16 15:20:36 -070096}
97
98/* free the coherent DMA pages */
99static void snd_free_dev_pages(struct device *dev, size_t size, void *ptr,
100 dma_addr_t dma)
101{
102 int pg;
103
104 if (ptr == NULL)
105 return;
106 pg = get_order(size);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700107 dma_free_coherent(dev, PAGE_SIZE << pg, ptr, dma);
108}
Nicolin Chen05503212013-10-23 11:47:43 +0800109
Takashi Iwai63437312013-10-28 16:08:27 +0100110#ifdef CONFIG_GENERIC_ALLOCATOR
Nicolin Chen05503212013-10-23 11:47:43 +0800111/**
112 * snd_malloc_dev_iram - allocate memory from on-chip internal ram
113 * @dmab: buffer allocation record to store the allocated data
114 * @size: number of bytes to allocate from the iram
115 *
116 * This function requires iram phandle provided via of_node
117 */
Takashi Iwai9f694bc2013-10-29 11:56:21 +0100118static void snd_malloc_dev_iram(struct snd_dma_buffer *dmab, size_t size)
Nicolin Chen05503212013-10-23 11:47:43 +0800119{
120 struct device *dev = dmab->dev.dev;
121 struct gen_pool *pool = NULL;
122
Takashi Iwaia40a3932013-10-29 11:59:31 +0100123 dmab->area = NULL;
124 dmab->addr = 0;
125
Nicolin Chen05503212013-10-23 11:47:43 +0800126 if (dev->of_node)
127 pool = of_get_named_gen_pool(dev->of_node, "iram", 0);
128
129 if (!pool)
130 return;
131
132 /* Assign the pool into private_data field */
133 dmab->private_data = pool;
134
Nicolin Chen07968fe2013-11-14 14:32:15 -0800135 dmab->area = gen_pool_dma_alloc(pool, size, &dmab->addr);
Nicolin Chen05503212013-10-23 11:47:43 +0800136}
137
138/**
139 * snd_free_dev_iram - free allocated specific memory from on-chip internal ram
140 * @dmab: buffer allocation record to store the allocated data
141 */
Takashi Iwai9f694bc2013-10-29 11:56:21 +0100142static void snd_free_dev_iram(struct snd_dma_buffer *dmab)
Nicolin Chen05503212013-10-23 11:47:43 +0800143{
144 struct gen_pool *pool = dmab->private_data;
145
146 if (pool && dmab->area)
147 gen_pool_free(pool, (unsigned long)dmab->area, dmab->bytes);
148}
Takashi Iwai63437312013-10-28 16:08:27 +0100149#endif /* CONFIG_GENERIC_ALLOCATOR */
Takashi Iwai8f115512007-07-26 18:59:36 +0200150#endif /* CONFIG_HAS_DMA */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700151
Linus Torvalds1da177e2005-04-16 15:20:36 -0700152/*
153 *
154 * ALSA generic memory management
155 *
156 */
157
158
159/**
160 * snd_dma_alloc_pages - allocate the buffer area according to the given type
161 * @type: the DMA buffer type
162 * @device: the device pointer
163 * @size: the buffer size to allocate
164 * @dmab: buffer allocation record to store the allocated data
165 *
166 * Calls the memory-allocator function for the corresponding
167 * buffer type.
Yacine Belkadieb7c06e2013-03-11 22:05:14 +0100168 *
169 * Return: Zero if the buffer with the given size is allocated successfully,
170 * otherwise a negative value on error.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700171 */
172int snd_dma_alloc_pages(int type, struct device *device, size_t size,
173 struct snd_dma_buffer *dmab)
174{
Takashi Iwai7eaa9432008-08-08 17:09:09 +0200175 if (WARN_ON(!size))
176 return -ENXIO;
177 if (WARN_ON(!dmab))
178 return -ENXIO;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700179
180 dmab->dev.type = type;
181 dmab->dev.dev = device;
182 dmab->bytes = 0;
183 switch (type) {
184 case SNDRV_DMA_TYPE_CONTINUOUS:
Clemens Ladischfea952e2011-02-14 11:00:47 +0100185 dmab->area = snd_malloc_pages(size,
186 (__force gfp_t)(unsigned long)device);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700187 dmab->addr = 0;
188 break;
Takashi Iwai8f115512007-07-26 18:59:36 +0200189#ifdef CONFIG_HAS_DMA
Takashi Iwaia5606f82013-10-24 14:25:32 +0200190#ifdef CONFIG_GENERIC_ALLOCATOR
Nicolin Chen05503212013-10-23 11:47:43 +0800191 case SNDRV_DMA_TYPE_DEV_IRAM:
192 snd_malloc_dev_iram(dmab, size);
193 if (dmab->area)
194 break;
195 /* Internal memory might have limited size and no enough space,
196 * so if we fail to malloc, try to fetch memory traditionally.
197 */
198 dmab->dev.type = SNDRV_DMA_TYPE_DEV;
Takashi Iwaia5606f82013-10-24 14:25:32 +0200199#endif /* CONFIG_GENERIC_ALLOCATOR */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700200 case SNDRV_DMA_TYPE_DEV:
201 dmab->area = snd_malloc_dev_pages(device, size, &dmab->addr);
202 break;
Takashi Iwaicc6a8ac2008-06-17 16:39:06 +0200203#endif
204#ifdef CONFIG_SND_DMA_SGBUF
Linus Torvalds1da177e2005-04-16 15:20:36 -0700205 case SNDRV_DMA_TYPE_DEV_SG:
206 snd_malloc_sgbuf_pages(device, size, dmab, NULL);
207 break;
Takashi Iwai8f115512007-07-26 18:59:36 +0200208#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700209 default:
Takashi Iwaif2f93072014-02-04 18:21:03 +0100210 pr_err("snd-malloc: invalid device type %d\n", type);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700211 dmab->area = NULL;
212 dmab->addr = 0;
213 return -ENXIO;
214 }
215 if (! dmab->area)
216 return -ENOMEM;
217 dmab->bytes = size;
218 return 0;
219}
220
221/**
222 * snd_dma_alloc_pages_fallback - allocate the buffer area according to the given type with fallback
223 * @type: the DMA buffer type
224 * @device: the device pointer
225 * @size: the buffer size to allocate
226 * @dmab: buffer allocation record to store the allocated data
227 *
228 * Calls the memory-allocator function for the corresponding
229 * buffer type. When no space is left, this function reduces the size and
230 * tries to allocate again. The size actually allocated is stored in
231 * res_size argument.
Yacine Belkadieb7c06e2013-03-11 22:05:14 +0100232 *
233 * Return: Zero if the buffer with the given size is allocated successfully,
234 * otherwise a negative value on error.
Linus Torvalds1da177e2005-04-16 15:20:36 -0700235 */
236int snd_dma_alloc_pages_fallback(int type, struct device *device, size_t size,
237 struct snd_dma_buffer *dmab)
238{
239 int err;
240
Linus Torvalds1da177e2005-04-16 15:20:36 -0700241 while ((err = snd_dma_alloc_pages(type, device, size, dmab)) < 0) {
Takashi Iwai4e184f82008-07-30 15:13:33 +0200242 size_t aligned_size;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700243 if (err != -ENOMEM)
244 return err;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700245 if (size <= PAGE_SIZE)
246 return -ENOMEM;
Takashi Iwai4e184f82008-07-30 15:13:33 +0200247 aligned_size = PAGE_SIZE << get_order(size);
248 if (size != aligned_size)
249 size = aligned_size;
250 else
251 size >>= 1;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700252 }
253 if (! dmab->area)
254 return -ENOMEM;
255 return 0;
256}
257
258
259/**
260 * snd_dma_free_pages - release the allocated buffer
261 * @dmab: the buffer allocation record to release
262 *
263 * Releases the allocated buffer via snd_dma_alloc_pages().
264 */
265void snd_dma_free_pages(struct snd_dma_buffer *dmab)
266{
267 switch (dmab->dev.type) {
268 case SNDRV_DMA_TYPE_CONTINUOUS:
269 snd_free_pages(dmab->area, dmab->bytes);
270 break;
Takashi Iwai8f115512007-07-26 18:59:36 +0200271#ifdef CONFIG_HAS_DMA
Takashi Iwaia5606f82013-10-24 14:25:32 +0200272#ifdef CONFIG_GENERIC_ALLOCATOR
Nicolin Chen05503212013-10-23 11:47:43 +0800273 case SNDRV_DMA_TYPE_DEV_IRAM:
274 snd_free_dev_iram(dmab);
275 break;
Takashi Iwaia5606f82013-10-24 14:25:32 +0200276#endif /* CONFIG_GENERIC_ALLOCATOR */
Linus Torvalds1da177e2005-04-16 15:20:36 -0700277 case SNDRV_DMA_TYPE_DEV:
278 snd_free_dev_pages(dmab->dev.dev, dmab->bytes, dmab->area, dmab->addr);
279 break;
Takashi Iwaicc6a8ac2008-06-17 16:39:06 +0200280#endif
281#ifdef CONFIG_SND_DMA_SGBUF
Linus Torvalds1da177e2005-04-16 15:20:36 -0700282 case SNDRV_DMA_TYPE_DEV_SG:
283 snd_free_sgbuf_pages(dmab);
284 break;
Takashi Iwai8f115512007-07-26 18:59:36 +0200285#endif
Linus Torvalds1da177e2005-04-16 15:20:36 -0700286 default:
Takashi Iwaif2f93072014-02-04 18:21:03 +0100287 pr_err("snd-malloc: invalid device type %d\n", dmab->dev.type);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700288 }
289}
290
Linus Torvalds1da177e2005-04-16 15:20:36 -0700291/*
292 * exports
293 */
294EXPORT_SYMBOL(snd_dma_alloc_pages);
295EXPORT_SYMBOL(snd_dma_alloc_pages_fallback);
296EXPORT_SYMBOL(snd_dma_free_pages);
297
Linus Torvalds1da177e2005-04-16 15:20:36 -0700298EXPORT_SYMBOL(snd_malloc_pages);
299EXPORT_SYMBOL(snd_free_pages);