xref: /linux/include/uapi/drm/omap_drm.h (revision ca55b2fef3a9373fcfc30f82fd26bc7fccbda732)
1 /*
2  * include/uapi/drm/omap_drm.h
3  *
4  * Copyright (C) 2011 Texas Instruments
5  * Author: Rob Clark <rob@ti.com>
6  *
7  * This program is free software; you can redistribute it and/or modify it
8  * under the terms of the GNU General Public License version 2 as published by
9  * the Free Software Foundation.
10  *
11  * This program is distributed in the hope that it will be useful, but WITHOUT
12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
14  * more details.
15  *
16  * You should have received a copy of the GNU General Public License along with
17  * this program.  If not, see <http://www.gnu.org/licenses/>.
18  */
19 
20 #ifndef __OMAP_DRM_H__
21 #define __OMAP_DRM_H__
22 
23 #include <drm/drm.h>
24 
25 /* Please note that modifications to all structs defined here are
26  * subject to backwards-compatibility constraints.
27  */
28 
29 #define OMAP_PARAM_CHIPSET_ID	1	/* ie. 0x3430, 0x4430, etc */
30 
31 struct drm_omap_param {
32 	uint64_t param;			/* in */
33 	uint64_t value;			/* in (set_param), out (get_param) */
34 };
35 
36 #define OMAP_BO_SCANOUT		0x00000001	/* scanout capable (phys contiguous) */
37 #define OMAP_BO_CACHE_MASK	0x00000006	/* cache type mask, see cache modes */
38 #define OMAP_BO_TILED_MASK	0x00000f00	/* tiled mapping mask, see tiled modes */
39 
40 /* cache modes */
41 #define OMAP_BO_CACHED		0x00000000	/* default */
42 #define OMAP_BO_WC		0x00000002	/* write-combine */
43 #define OMAP_BO_UNCACHED	0x00000004	/* strongly-ordered (uncached) */
44 
45 /* tiled modes */
46 #define OMAP_BO_TILED_8		0x00000100
47 #define OMAP_BO_TILED_16	0x00000200
48 #define OMAP_BO_TILED_32	0x00000300
49 #define OMAP_BO_TILED		(OMAP_BO_TILED_8 | OMAP_BO_TILED_16 | OMAP_BO_TILED_32)
50 
51 union omap_gem_size {
52 	uint32_t bytes;		/* (for non-tiled formats) */
53 	struct {
54 		uint16_t width;
55 		uint16_t height;
56 	} tiled;		/* (for tiled formats) */
57 };
58 
59 struct drm_omap_gem_new {
60 	union omap_gem_size size;	/* in */
61 	uint32_t flags;			/* in */
62 	uint32_t handle;		/* out */
63 	uint32_t __pad;
64 };
65 
66 /* mask of operations: */
67 enum omap_gem_op {
68 	OMAP_GEM_READ = 0x01,
69 	OMAP_GEM_WRITE = 0x02,
70 };
71 
72 struct drm_omap_gem_cpu_prep {
73 	uint32_t handle;		/* buffer handle (in) */
74 	uint32_t op;			/* mask of omap_gem_op (in) */
75 };
76 
77 struct drm_omap_gem_cpu_fini {
78 	uint32_t handle;		/* buffer handle (in) */
79 	uint32_t op;			/* mask of omap_gem_op (in) */
80 	/* TODO maybe here we pass down info about what regions are touched
81 	 * by sw so we can be clever about cache ops?  For now a placeholder,
82 	 * set to zero and we just do full buffer flush..
83 	 */
84 	uint32_t nregions;
85 	uint32_t __pad;
86 };
87 
88 struct drm_omap_gem_info {
89 	uint32_t handle;		/* buffer handle (in) */
90 	uint32_t pad;
91 	uint64_t offset;		/* mmap offset (out) */
92 	/* note: in case of tiled buffers, the user virtual size can be
93 	 * different from the physical size (ie. how many pages are needed
94 	 * to back the object) which is returned in DRM_IOCTL_GEM_OPEN..
95 	 * This size here is the one that should be used if you want to
96 	 * mmap() the buffer:
97 	 */
98 	uint32_t size;			/* virtual size for mmap'ing (out) */
99 	uint32_t __pad;
100 };
101 
102 #define DRM_OMAP_GET_PARAM		0x00
103 #define DRM_OMAP_SET_PARAM		0x01
104 /* placeholder for plugin-api
105 #define DRM_OMAP_GET_BASE		0x02
106 */
107 #define DRM_OMAP_GEM_NEW		0x03
108 #define DRM_OMAP_GEM_CPU_PREP		0x04
109 #define DRM_OMAP_GEM_CPU_FINI		0x05
110 #define DRM_OMAP_GEM_INFO		0x06
111 #define DRM_OMAP_NUM_IOCTLS		0x07
112 
113 #define DRM_IOCTL_OMAP_GET_PARAM	DRM_IOWR(DRM_COMMAND_BASE + DRM_OMAP_GET_PARAM, struct drm_omap_param)
114 #define DRM_IOCTL_OMAP_SET_PARAM	DRM_IOW (DRM_COMMAND_BASE + DRM_OMAP_SET_PARAM, struct drm_omap_param)
115 /* placeholder for plugin-api
116 #define DRM_IOCTL_OMAP_GET_BASE		DRM_IOWR(DRM_COMMAND_BASE + DRM_OMAP_GET_BASE, struct drm_omap_get_base)
117 */
118 #define DRM_IOCTL_OMAP_GEM_NEW		DRM_IOWR(DRM_COMMAND_BASE + DRM_OMAP_GEM_NEW, struct drm_omap_gem_new)
119 #define DRM_IOCTL_OMAP_GEM_CPU_PREP	DRM_IOW (DRM_COMMAND_BASE + DRM_OMAP_GEM_CPU_PREP, struct drm_omap_gem_cpu_prep)
120 #define DRM_IOCTL_OMAP_GEM_CPU_FINI	DRM_IOW (DRM_COMMAND_BASE + DRM_OMAP_GEM_CPU_FINI, struct drm_omap_gem_cpu_fini)
121 #define DRM_IOCTL_OMAP_GEM_INFO		DRM_IOWR(DRM_COMMAND_BASE + DRM_OMAP_GEM_INFO, struct drm_omap_gem_info)
122 
123 #endif /* __OMAP_DRM_H__ */
124