1 /* exynos_drm.h
2  *
3  * Copyright (c) 2011 Samsung Electronics Co., Ltd.
4  * Authors:
5  *	Inki Dae <inki.dae@samsung.com>
6  *	Joonyoung Shim <jy0922.shim@samsung.com>
7  *	Seung-Woo Kim <sw0312.kim@samsung.com>
8  *
9  * Permission is hereby granted, free of charge, to any person obtaining a
10  * copy of this software and associated documentation files (the "Software"),
11  * to deal in the Software without restriction, including without limitation
12  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
13  * and/or sell copies of the Software, and to permit persons to whom the
14  * Software is furnished to do so, subject to the following conditions:
15  *
16  * The above copyright notice and this permission notice (including the next
17  * paragraph) shall be included in all copies or substantial portions of the
18  * Software.
19  *
20  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
23  * VA LINUX SYSTEMS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
24  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
25  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
26  * OTHER DEALINGS IN THE SOFTWARE.
27  */
28 
29 #ifndef _EXYNOS_DRM_H_
30 #define _EXYNOS_DRM_H_
31 
32 /**
33  * User-desired buffer creation information structure.
34  *
35  * @size: user-desired memory allocation size.
36  *	- this size value would be page-aligned internally.
37  * @flags: user request for setting memory type or cache attributes.
38  * @handle: returned a handle to created gem object.
39  *	- this handle will be set by gem module of kernel side.
40  */
41 struct drm_exynos_gem_create {
42 	uint64_t size;
43 	unsigned int flags;
44 	unsigned int handle;
45 };
46 
47 /**
48  * A structure for getting buffer offset.
49  *
50  * @handle: a pointer to gem object created.
51  * @pad: just padding to be 64-bit aligned.
52  * @offset: relatived offset value of the memory region allocated.
53  *	- this value should be set by user.
54  */
55 struct drm_exynos_gem_map_off {
56 	unsigned int handle;
57 	unsigned int pad;
58 	uint64_t offset;
59 };
60 
61 /**
62  * A structure for mapping buffer.
63  *
64  * @handle: a handle to gem object created.
65  * @size: memory size to be mapped.
66  * @mapped: having user virtual address mmaped.
67  *	- this variable would be filled by exynos gem module
68  *	of kernel side with user virtual address which is allocated
69  *	by do_mmap().
70  */
71 struct drm_exynos_gem_mmap {
72 	unsigned int handle;
73 	unsigned int size;
74 	uint64_t mapped;
75 };
76 
77 /**
78  * A structure for user connection request of virtual display.
79  *
80  * @connection: indicate whether doing connetion or not by user.
81  * @extensions: if this value is 1 then the vidi driver would need additional
82  *	128bytes edid data.
83  * @edid: the edid data pointer from user side.
84  */
85 struct drm_exynos_vidi_connection {
86 	unsigned int connection;
87 	unsigned int extensions;
88 	uint64_t edid;
89 };
90 
91 struct drm_exynos_plane_set_zpos {
92 	__u32 plane_id;
93 	__s32 zpos;
94 };
95 
96 /* memory type definitions. */
97 enum e_drm_exynos_gem_mem_type {
98 	/* Physically Non-Continuous memory. */
99 	EXYNOS_BO_NONCONTIG	= 1 << 0,
100 	EXYNOS_BO_MASK		= EXYNOS_BO_NONCONTIG
101 };
102 
103 #define DRM_EXYNOS_GEM_CREATE		0x00
104 #define DRM_EXYNOS_GEM_MAP_OFFSET	0x01
105 #define DRM_EXYNOS_GEM_MMAP		0x02
106 /* Reserved 0x03 ~ 0x05 for exynos specific gem ioctl */
107 #define DRM_EXYNOS_PLANE_SET_ZPOS	0x06
108 #define DRM_EXYNOS_VIDI_CONNECTION	0x07
109 
110 #define DRM_IOCTL_EXYNOS_GEM_CREATE		DRM_IOWR(DRM_COMMAND_BASE + \
111 		DRM_EXYNOS_GEM_CREATE, struct drm_exynos_gem_create)
112 
113 #define DRM_IOCTL_EXYNOS_GEM_MAP_OFFSET	DRM_IOWR(DRM_COMMAND_BASE + \
114 		DRM_EXYNOS_GEM_MAP_OFFSET, struct drm_exynos_gem_map_off)
115 
116 #define DRM_IOCTL_EXYNOS_GEM_MMAP	DRM_IOWR(DRM_COMMAND_BASE + \
117 		DRM_EXYNOS_GEM_MMAP, struct drm_exynos_gem_mmap)
118 
119 #define DRM_IOCTL_EXYNOS_PLANE_SET_ZPOS	DRM_IOWR(DRM_COMMAND_BASE + \
120 		DRM_EXYNOS_PLANE_SET_ZPOS, struct drm_exynos_plane_set_zpos)
121 
122 #define DRM_IOCTL_EXYNOS_VIDI_CONNECTION	DRM_IOWR(DRM_COMMAND_BASE + \
123 		DRM_EXYNOS_VIDI_CONNECTION, struct drm_exynos_vidi_connection)
124 
125 #ifdef __KERNEL__
126 
127 /**
128  * A structure for lcd panel information.
129  *
130  * @timing: default video mode for initializing
131  * @width_mm: physical size of lcd width.
132  * @height_mm: physical size of lcd height.
133  */
134 struct exynos_drm_panel_info {
135 	struct fb_videomode timing;
136 	u32 width_mm;
137 	u32 height_mm;
138 };
139 
140 /**
141  * Platform Specific Structure for DRM based FIMD.
142  *
143  * @panel: default panel info for initializing
144  * @default_win: default window layer number to be used for UI.
145  * @bpp: default bit per pixel.
146  */
147 struct exynos_drm_fimd_pdata {
148 	struct exynos_drm_panel_info panel;
149 	u32				vidcon0;
150 	u32				vidcon1;
151 	unsigned int			default_win;
152 	unsigned int			bpp;
153 };
154 
155 /**
156  * Platform Specific Structure for DRM based HDMI.
157  *
158  * @hdmi_dev: device point to specific hdmi driver.
159  * @mixer_dev: device point to specific mixer driver.
160  *
161  * this structure is used for common hdmi driver and each device object
162  * would be used to access specific device driver(hdmi or mixer driver)
163  */
164 struct exynos_drm_common_hdmi_pd {
165 	struct device *hdmi_dev;
166 	struct device *mixer_dev;
167 };
168 
169 /**
170  * Platform Specific Structure for DRM based HDMI core.
171  *
172  * @timing: default video mode for initializing
173  * @default_win: default window layer number to be used for UI.
174  * @bpp: default bit per pixel.
175  * @is_v13: set if hdmi version 13 is.
176  */
177 struct exynos_drm_hdmi_pdata {
178 	struct fb_videomode		timing;
179 	unsigned int			default_win;
180 	unsigned int			bpp;
181 	unsigned int			is_v13:1;
182 };
183 
184 #endif	/* __KERNEL__ */
185 #endif	/* _EXYNOS_DRM_H_ */
186