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