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