1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Copyright (C) 2008, Creative Technology Ltd. All Rights Reserved.
4  *
5  * @File    ctvmem.h
6  *
7  * @Brief
8  * This file contains the definition of virtual memory management object
9  * for card device.
10  *
11  * @Author Liu Chun
12  * @Date Mar 28 2008
13  */
14 
15 #ifndef CTVMEM_H
16 #define CTVMEM_H
17 
18 #define CT_PTP_NUM	4	/* num of device page table pages */
19 
20 #include <linux/mutex.h>
21 #include <linux/list.h>
22 #include <linux/pci.h>
23 #include <sound/memalloc.h>
24 
25 /* The chip can handle the page table of 4k pages
26  * (emu20k1 can handle even 8k pages, but we don't use it right now)
27  */
28 #define CT_PAGE_SIZE	4096
29 #define CT_PAGE_SHIFT	12
30 #define CT_PAGE_MASK	(~(PAGE_SIZE - 1))
31 #define CT_PAGE_ALIGN(addr)	ALIGN(addr, CT_PAGE_SIZE)
32 
33 struct ct_vm_block {
34 	unsigned int addr;	/* starting logical addr of this block */
35 	unsigned int size;	/* size of this device virtual mem block */
36 	struct list_head list;
37 };
38 
39 struct snd_pcm_substream;
40 
41 /* Virtual memory management object for card device */
42 struct ct_vm {
43 	struct snd_dma_buffer ptp[CT_PTP_NUM];	/* Device page table pages */
44 	unsigned int size;		/* Available addr space in bytes */
45 	struct list_head unused;	/* List of unused blocks */
46 	struct list_head used;		/* List of used blocks */
47 	struct mutex lock;
48 
49 	/* Map host addr (kmalloced/vmalloced) to device logical addr. */
50 	struct ct_vm_block *(*map)(struct ct_vm *, struct snd_pcm_substream *,
51 				   int size);
52 	/* Unmap device logical addr area. */
53 	void (*unmap)(struct ct_vm *, struct ct_vm_block *block);
54 	dma_addr_t (*get_ptp_phys)(struct ct_vm *vm, int index);
55 };
56 
57 int ct_vm_create(struct ct_vm **rvm, struct pci_dev *pci);
58 void ct_vm_destroy(struct ct_vm *vm);
59 
60 #endif /* CTVMEM_H */
61