sound/core/memalloc.c

   1 /*
   2  *  Copyright (c) by Jaroslav Kysela <perex@perex.cz>
   3  *                   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
  24 #include <linux/slab.h>
  25 #include <linux/mm.h>
  26 #include <linux/dma-mapping.h>
  27 #include <linux/genalloc.h>
  28 #include <sound/memalloc.h>
  29
  30 /*
  31  *
  32  *  Generic memory allocators
  33  *
  34  */
  35
  36 /**
  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  *
  43  * Return: The pointer of the buffer, or %NULL if no enough memory.
  44  */
  45 void *snd_malloc_pages(size_t size, gfp_t gfp_flags)
  46 {
  47         int pg;
  48
  49         if (WARN_ON(!size))
  50                 return NULL;
  51         if (WARN_ON(!gfp_flags))
  52                 return NULL;
  53         gfp_flags |= __GFP_COMP;        /* compound page lets parts be mapped */
  54         pg = get_order(size);
  55         return (void *) __get_free_pages(gfp_flags, pg);
  56 }
  57 EXPORT_SYMBOL(snd_malloc_pages);
  58
  59 /**
  60  * snd_free_pages - release the pages
  61  * @ptr: the buffer pointer to release
  62  * @size: the allocated buffer size
  63  *
  64  * Releases the buffer allocated via snd_malloc_pages().
  65  */
  66 void snd_free_pages(void *ptr, size_t size)
  67 {
  68         int pg;
  69
  70         if (ptr == NULL)
  71                 return;
  72         pg = get_order(size);
  73         free_pages((unsigned long) ptr, pg);
  74 }
  75 EXPORT_SYMBOL(snd_free_pages);
  76
  77 /*
  78  *
  79  *  Bus-specific memory allocators
  80  *
  81  */
  82
  83 #ifdef CONFIG_HAS_DMA
  84 /* allocate the coherent DMA pages */
  85 static void *snd_malloc_dev_pages(struct device *dev, size_t size, dma_addr_t *dma)
  86 {
  87         int pg;
  88         gfp_t gfp_flags;
  89
  90         if (WARN_ON(!dma))
  91                 return NULL;
  92         pg = get_order(size);
  93         gfp_flags = GFP_KERNEL
  94                 | __GFP_COMP    /* compound page lets parts be mapped */
  95                 | __GFP_NORETRY /* don't trigger OOM-killer */
  96                 | __GFP_NOWARN; /* no stack trace print - this call is non-critical */
  97         return dma_alloc_coherent(dev, PAGE_SIZE << pg, dma, gfp_flags);
  98 }
  99
 100 /* free the coherent DMA pages */
 101 static void snd_free_dev_pages(struct device *dev, size_t size, void *ptr,
 102                                dma_addr_t dma)
 103 {
 104         int pg;
 105
 106         if (ptr == NULL)
 107                 return;
 108         pg = get_order(size);
 109         dma_free_coherent(dev, PAGE_SIZE << pg, ptr, dma);
 110 }
 111
 112 #ifdef CONFIG_GENERIC_ALLOCATOR
 113 /**
 114  * snd_malloc_dev_iram - allocate memory from on-chip internal ram
 115  * @dmab: buffer allocation record to store the allocated data
 116  * @size: number of bytes to allocate from the iram
 117  *
 118  * This function requires iram phandle provided via of_node
 119  */
 120 static void snd_malloc_dev_iram(struct snd_dma_buffer *dmab, size_t size)
 121 {
 122         struct device *dev = dmab->dev.dev;
 123         struct gen_pool *pool = NULL;
 124
 125         dmab->area = NULL;
 126         dmab->addr = 0;
 127
 128         if (dev->of_node)
 129                 pool = of_gen_pool_get(dev->of_node, "iram", 0);
 130
 131         if (!pool)
 132                 return;
 133
 134         /* Assign the pool into private_data field */
 135         dmab->private_data = pool;
 136
 137         dmab->area = gen_pool_dma_alloc(pool, size, &dmab->addr);
 138 }
 139
 140 /**
 141  * snd_free_dev_iram - free allocated specific memory from on-chip internal ram
 142  * @dmab: buffer allocation record to store the allocated data
 143  */
 144 static void snd_free_dev_iram(struct snd_dma_buffer *dmab)
 145 {
 146         struct gen_pool *pool = dmab->private_data;
 147
 148         if (pool && dmab->area)
 149                 gen_pool_free(pool, (unsigned long)dmab->area, dmab->bytes);
 150 }
 151 #endif /* CONFIG_GENERIC_ALLOCATOR */
 152 #endif /* CONFIG_HAS_DMA */
 153
 154 /*
 155  *
 156  *  ALSA generic memory management
 157  *
 158  */
 159
 160
 161 /**
 162  * snd_dma_alloc_pages - allocate the buffer area according to the given type
 163  * @type: the DMA buffer type
 164  * @device: the device pointer
 165  * @size: the buffer size to allocate
 166  * @dmab: buffer allocation record to store the allocated data
 167  *
 168  * Calls the memory-allocator function for the corresponding
 169  * buffer type.
 170  *
 171  * Return: Zero if the buffer with the given size is allocated successfully,
 172  * otherwise a negative value on error.
 173  */
 174 int snd_dma_alloc_pages(int type, struct device *device, size_t size,
 175                         struct snd_dma_buffer *dmab)
 176 {
 177         if (WARN_ON(!size))
 178                 return -ENXIO;
 179         if (WARN_ON(!dmab))
 180                 return -ENXIO;
 181
 182         dmab->dev.type = type;
 183         dmab->dev.dev = device;
 184         dmab->bytes = 0;
 185         switch (type) {
 186         case SNDRV_DMA_TYPE_CONTINUOUS:
 187                 dmab->area = snd_malloc_pages(size,
 188                                         (__force gfp_t)(unsigned long)device);
 189                 dmab->addr = 0;
 190                 break;
 191 #ifdef CONFIG_HAS_DMA
 192 #ifdef CONFIG_GENERIC_ALLOCATOR
 193         case SNDRV_DMA_TYPE_DEV_IRAM:
 194                 snd_malloc_dev_iram(dmab, size);
 195                 if (dmab->area)
 196                         break;
 197                 /* Internal memory might have limited size and no enough space,
 198                  * so if we fail to malloc, try to fetch memory traditionally.
 199                  */
 200                 dmab->dev.type = SNDRV_DMA_TYPE_DEV;
 201 #endif /* CONFIG_GENERIC_ALLOCATOR */
 202         case SNDRV_DMA_TYPE_DEV:
 203                 dmab->area = snd_malloc_dev_pages(device, size, &dmab->addr);
 204                 break;
 205 #endif
 206 #ifdef CONFIG_SND_DMA_SGBUF
 207         case SNDRV_DMA_TYPE_DEV_SG:
 208                 snd_malloc_sgbuf_pages(device, size, dmab, NULL);
 209                 break;
 210 #endif
 211         default:
 212                 pr_err("snd-malloc: invalid device type %d\n", type);
 213                 dmab->area = NULL;
 214                 dmab->addr = 0;
 215                 return -ENXIO;
 216         }
 217         if (! dmab->area)
 218                 return -ENOMEM;
 219         dmab->bytes = size;
 220         return 0;
 221 }
 222 EXPORT_SYMBOL(snd_dma_alloc_pages);
 223
 224 /**
 225  * snd_dma_alloc_pages_fallback - allocate the buffer area according to the given type with fallback
 226  * @type: the DMA buffer type
 227  * @device: the device pointer
 228  * @size: the buffer size to allocate
 229  * @dmab: buffer allocation record to store the allocated data
 230  *
 231  * Calls the memory-allocator function for the corresponding
 232  * buffer type.  When no space is left, this function reduces the size and
 233  * tries to allocate again.  The size actually allocated is stored in
 234  * res_size argument.
 235  *
 236  * Return: Zero if the buffer with the given size is allocated successfully,
 237  * otherwise a negative value on error.
 238  */
 239 int snd_dma_alloc_pages_fallback(int type, struct device *device, size_t size,
 240                                  struct snd_dma_buffer *dmab)
 241 {
 242         int err;
 243
 244         while ((err = snd_dma_alloc_pages(type, device, size, dmab)) < 0) {
 245                 size_t aligned_size;
 246                 if (err != -ENOMEM)
 247                         return err;
 248                 if (size <= PAGE_SIZE)
 249                         return -ENOMEM;
 250                 aligned_size = PAGE_SIZE << get_order(size);
 251                 if (size != aligned_size)
 252                         size = aligned_size;
 253                 else
 254                         size >>= 1;
 255         }
 256         if (! dmab->area)
 257                 return -ENOMEM;
 258         return 0;
 259 }
 260 EXPORT_SYMBOL(snd_dma_alloc_pages_fallback);
 261
 262
 263 /**
 264  * snd_dma_free_pages - release the allocated buffer
 265  * @dmab: the buffer allocation record to release
 266  *
 267  * Releases the allocated buffer via snd_dma_alloc_pages().
 268  */
 269 void snd_dma_free_pages(struct snd_dma_buffer *dmab)
 270 {
 271         switch (dmab->dev.type) {
 272         case SNDRV_DMA_TYPE_CONTINUOUS:
 273                 snd_free_pages(dmab->area, dmab->bytes);
 274                 break;
 275 #ifdef CONFIG_HAS_DMA
 276 #ifdef CONFIG_GENERIC_ALLOCATOR
 277         case SNDRV_DMA_TYPE_DEV_IRAM:
 278                 snd_free_dev_iram(dmab);
 279                 break;
 280 #endif /* CONFIG_GENERIC_ALLOCATOR */
 281         case SNDRV_DMA_TYPE_DEV:
 282                 snd_free_dev_pages(dmab->dev.dev, dmab->bytes, dmab->area, dmab->addr);
 283                 break;
 284 #endif
 285 #ifdef CONFIG_SND_DMA_SGBUF
 286         case SNDRV_DMA_TYPE_DEV_SG:
 287                 snd_free_sgbuf_pages(dmab);
 288                 break;
 289 #endif
 290         default:
 291                 pr_err("snd-malloc: invalid device type %d\n", dmab->dev.type);
 292         }
 293 }
 294 EXPORT_SYMBOL(snd_dma_free_pages);