xref: /kernel/linux/linux-5.10/sound/pci/ctxfi/ctvmem.h (revision 8c2ecf20)
18c2ecf20Sopenharmony_ci/* SPDX-License-Identifier: GPL-2.0-only */
28c2ecf20Sopenharmony_ci/**
38c2ecf20Sopenharmony_ci * Copyright (C) 2008, Creative Technology Ltd. All Rights Reserved.
48c2ecf20Sopenharmony_ci *
58c2ecf20Sopenharmony_ci * @File    ctvmem.h
68c2ecf20Sopenharmony_ci *
78c2ecf20Sopenharmony_ci * @Brief
88c2ecf20Sopenharmony_ci * This file contains the definition of virtual memory management object
98c2ecf20Sopenharmony_ci * for card device.
108c2ecf20Sopenharmony_ci *
118c2ecf20Sopenharmony_ci * @Author Liu Chun
128c2ecf20Sopenharmony_ci * @Date Mar 28 2008
138c2ecf20Sopenharmony_ci */
148c2ecf20Sopenharmony_ci
158c2ecf20Sopenharmony_ci#ifndef CTVMEM_H
168c2ecf20Sopenharmony_ci#define CTVMEM_H
178c2ecf20Sopenharmony_ci
188c2ecf20Sopenharmony_ci#define CT_PTP_NUM	4	/* num of device page table pages */
198c2ecf20Sopenharmony_ci
208c2ecf20Sopenharmony_ci#include <linux/mutex.h>
218c2ecf20Sopenharmony_ci#include <linux/list.h>
228c2ecf20Sopenharmony_ci#include <linux/pci.h>
238c2ecf20Sopenharmony_ci#include <sound/memalloc.h>
248c2ecf20Sopenharmony_ci
258c2ecf20Sopenharmony_ci/* The chip can handle the page table of 4k pages
268c2ecf20Sopenharmony_ci * (emu20k1 can handle even 8k pages, but we don't use it right now)
278c2ecf20Sopenharmony_ci */
288c2ecf20Sopenharmony_ci#define CT_PAGE_SIZE	4096
298c2ecf20Sopenharmony_ci#define CT_PAGE_SHIFT	12
308c2ecf20Sopenharmony_ci#define CT_PAGE_MASK	(~(PAGE_SIZE - 1))
318c2ecf20Sopenharmony_ci#define CT_PAGE_ALIGN(addr)	ALIGN(addr, CT_PAGE_SIZE)
328c2ecf20Sopenharmony_ci
338c2ecf20Sopenharmony_cistruct ct_vm_block {
348c2ecf20Sopenharmony_ci	unsigned int addr;	/* starting logical addr of this block */
358c2ecf20Sopenharmony_ci	unsigned int size;	/* size of this device virtual mem block */
368c2ecf20Sopenharmony_ci	struct list_head list;
378c2ecf20Sopenharmony_ci};
388c2ecf20Sopenharmony_ci
398c2ecf20Sopenharmony_cistruct snd_pcm_substream;
408c2ecf20Sopenharmony_ci
418c2ecf20Sopenharmony_ci/* Virtual memory management object for card device */
428c2ecf20Sopenharmony_cistruct ct_vm {
438c2ecf20Sopenharmony_ci	struct snd_dma_buffer ptp[CT_PTP_NUM];	/* Device page table pages */
448c2ecf20Sopenharmony_ci	unsigned int size;		/* Available addr space in bytes */
458c2ecf20Sopenharmony_ci	struct list_head unused;	/* List of unused blocks */
468c2ecf20Sopenharmony_ci	struct list_head used;		/* List of used blocks */
478c2ecf20Sopenharmony_ci	struct mutex lock;
488c2ecf20Sopenharmony_ci
498c2ecf20Sopenharmony_ci	/* Map host addr (kmalloced/vmalloced) to device logical addr. */
508c2ecf20Sopenharmony_ci	struct ct_vm_block *(*map)(struct ct_vm *, struct snd_pcm_substream *,
518c2ecf20Sopenharmony_ci				   int size);
528c2ecf20Sopenharmony_ci	/* Unmap device logical addr area. */
538c2ecf20Sopenharmony_ci	void (*unmap)(struct ct_vm *, struct ct_vm_block *block);
548c2ecf20Sopenharmony_ci	dma_addr_t (*get_ptp_phys)(struct ct_vm *vm, int index);
558c2ecf20Sopenharmony_ci};
568c2ecf20Sopenharmony_ci
578c2ecf20Sopenharmony_ciint ct_vm_create(struct ct_vm **rvm, struct pci_dev *pci);
588c2ecf20Sopenharmony_civoid ct_vm_destroy(struct ct_vm *vm);
598c2ecf20Sopenharmony_ci
608c2ecf20Sopenharmony_ci#endif /* CTVMEM_H */
61