3 * (C) COPYRIGHT ARM Limited. All rights reserved.
5 * This program is free software and is provided to you under the terms of the
6 * GNU General Public License version 2 as published by the Free Software
7 * Foundation, and any use by you of this program is subject to the terms
10 * A copy of the licence is included with the program, and can also be obtained
11 * from Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
12 * Boston, MA 02110-1301, USA.
21 * @file mali_kbase_mem_linux.h
22 * Base kernel memory APIs, Linux implementation.
25 #ifndef _KBASE_MEM_LINUX_H_
26 #define _KBASE_MEM_LINUX_H_
28 /* This define is used by the gator kernel module compile to select which DDK
29 * API calling convention to use. If not defined (legacy DDK) gator assumes
30 * version 1. The version to DDK release mapping is:
31 * Version 1 API: DDK versions r1px, r2px
32 * Version 2 API: DDK versions r3px and newer
34 #define MALI_DDK_GATOR_API_VERSION 2
36 /** A HWC dump mapping */
37 typedef struct kbase_hwc_dma_mapping {
41 } kbase_hwc_dma_mapping;
43 struct kbase_va_region * kbase_mem_alloc(kbase_context * kctx, u64 va_pages, u64 commit_pages, u64 extent, u64 * flags, u64 * gpu_va, u16 * va_alignment);
44 mali_error kbase_mem_query(kbase_context *kctx, mali_addr64 gpu_addr, int query, u64 * const pages);
45 int kbase_mem_import(kbase_context *kctx, base_mem_import_type type, int handle, mali_addr64 * gpu_va, u64 * va_pages, u64 * flags);
46 u64 kbase_mem_alias(kbase_context *kctx, u64* flags, u64 stride, u64 nents, struct base_mem_aliasing_info* ai, u64 * num_pages);
47 mali_error kbase_mem_flags_change(kbase_context *kctx, mali_addr64 gpu_addr, unsigned int flags, unsigned int mask);
48 int kbase_mem_commit(kbase_context * kctx, mali_addr64 gpu_addr, u64 new_pages, base_backing_threshold_status * failure_reason);
49 int kbase_mmap(struct file *file, struct vm_area_struct *vma);
51 /** @brief Allocate memory from kernel space and map it onto the GPU
53 * @param kctx The context used for the allocation/mapping
54 * @param size The size of the allocation in bytes
55 * @param handle An opaque structure used to contain the state needed to free the memory
56 * @return the VA for kernel space and GPU MMU
58 void *kbase_va_alloc(kbase_context *kctx, u32 size, kbase_hwc_dma_mapping *handle);
60 /** @brief Free/unmap memory allocated by kbase_va_alloc
62 * @param kctx The context used for the allocation/mapping
63 * @param handle An opaque structure returned by the kbase_va_alloc function.
65 void kbase_va_free(kbase_context *kctx, kbase_hwc_dma_mapping *handle);
67 #endif /* _KBASE_MEM_LINUX_H_ */