1 /* SPDX-License-Identifier: GPL-2.0-or-later */ 2 /* 3 * Copyright (c) by Jaroslav Kysela <perex@perex.cz> 4 * Takashi Iwai <tiwai@suse.de> 5 * 6 * Generic memory allocators 7 */ 8 9 #ifndef __SOUND_MEMALLOC_H 10 #define __SOUND_MEMALLOC_H 11 12 struct device; 13 struct page; 14 15 /* 16 * buffer device info 17 */ 18 struct snd_dma_device { 19 int type; /* SNDRV_DMA_TYPE_XXX */ 20 struct device *dev; /* generic device */ 21 }; 22 23 #define snd_dma_continuous_data(x) ((struct device *)(__force unsigned long)(x)) 24 25 26 /* 27 * buffer types 28 */ 29 #define SNDRV_DMA_TYPE_UNKNOWN 0 /* not defined */ 30 #define SNDRV_DMA_TYPE_CONTINUOUS 1 /* continuous no-DMA memory */ 31 #define SNDRV_DMA_TYPE_DEV 2 /* generic device continuous */ 32 #define SNDRV_DMA_TYPE_DEV_UC 5 /* continuous non-cahced */ 33 #ifdef CONFIG_SND_DMA_SGBUF 34 #define SNDRV_DMA_TYPE_DEV_SG 3 /* generic device SG-buffer */ 35 #define SNDRV_DMA_TYPE_DEV_UC_SG 6 /* SG non-cached */ 36 #else 37 #define SNDRV_DMA_TYPE_DEV_SG SNDRV_DMA_TYPE_DEV /* no SG-buf support */ 38 #define SNDRV_DMA_TYPE_DEV_UC_SG SNDRV_DMA_TYPE_DEV_UC 39 #endif 40 #ifdef CONFIG_GENERIC_ALLOCATOR 41 #define SNDRV_DMA_TYPE_DEV_IRAM 4 /* generic device iram-buffer */ 42 #else 43 #define SNDRV_DMA_TYPE_DEV_IRAM SNDRV_DMA_TYPE_DEV 44 #endif 45 #define SNDRV_DMA_TYPE_VMALLOC 7 /* vmalloc'ed buffer */ 46 47 /* 48 * info for buffer allocation 49 */ 50 struct snd_dma_buffer { 51 struct snd_dma_device dev; /* device type */ 52 unsigned char *area; /* virtual pointer */ 53 dma_addr_t addr; /* physical address */ 54 size_t bytes; /* buffer size in bytes */ 55 void *private_data; /* private for allocator; don't touch */ 56 }; 57 58 /* 59 * return the pages matching with the given byte size 60 */ 61 static inline unsigned int snd_sgbuf_aligned_pages(size_t size) 62 { 63 return (size + PAGE_SIZE - 1) >> PAGE_SHIFT; 64 } 65 66 /* allocate/release a buffer */ 67 int snd_dma_alloc_pages(int type, struct device *dev, size_t size, 68 struct snd_dma_buffer *dmab); 69 int snd_dma_alloc_pages_fallback(int type, struct device *dev, size_t size, 70 struct snd_dma_buffer *dmab); 71 void snd_dma_free_pages(struct snd_dma_buffer *dmab); 72 73 dma_addr_t snd_sgbuf_get_addr(struct snd_dma_buffer *dmab, size_t offset); 74 struct page *snd_sgbuf_get_page(struct snd_dma_buffer *dmab, size_t offset); 75 unsigned int snd_sgbuf_get_chunk_size(struct snd_dma_buffer *dmab, 76 unsigned int ofs, unsigned int size); 77 78 #endif /* __SOUND_MEMALLOC_H */ 79 80