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 struct drm_exynos_plane_set_zpos {
78 	__u32 plane_id;
79 	__s32 zpos;
80 };
81 
82 #define DRM_EXYNOS_GEM_CREATE		0x00
83 #define DRM_EXYNOS_GEM_MAP_OFFSET	0x01
84 #define DRM_EXYNOS_GEM_MMAP		0x02
85 /* Reserved 0x03 ~ 0x05 for exynos specific gem ioctl */
86 #define DRM_EXYNOS_PLANE_SET_ZPOS	0x06
87 
88 #define DRM_IOCTL_EXYNOS_GEM_CREATE		DRM_IOWR(DRM_COMMAND_BASE + \
89 		DRM_EXYNOS_GEM_CREATE, struct drm_exynos_gem_create)
90 
91 #define DRM_IOCTL_EXYNOS_GEM_MAP_OFFSET	DRM_IOWR(DRM_COMMAND_BASE + \
92 		DRM_EXYNOS_GEM_MAP_OFFSET, struct drm_exynos_gem_map_off)
93 
94 #define DRM_IOCTL_EXYNOS_GEM_MMAP	DRM_IOWR(DRM_COMMAND_BASE + \
95 		DRM_EXYNOS_GEM_MMAP, struct drm_exynos_gem_mmap)
96 
97 #define DRM_IOCTL_EXYNOS_PLANE_SET_ZPOS	DRM_IOWR(DRM_COMMAND_BASE + \
98 		DRM_EXYNOS_PLANE_SET_ZPOS, struct drm_exynos_plane_set_zpos)
99 
100 #ifdef __KERNEL__
101 
102 /**
103  * A structure for lcd panel information.
104  *
105  * @timing: default video mode for initializing
106  * @width_mm: physical size of lcd width.
107  * @height_mm: physical size of lcd height.
108  */
109 struct exynos_drm_panel_info {
110 	struct fb_videomode timing;
111 	u32 width_mm;
112 	u32 height_mm;
113 };
114 
115 /**
116  * Platform Specific Structure for DRM based FIMD.
117  *
118  * @panel: default panel info for initializing
119  * @default_win: default window layer number to be used for UI.
120  * @bpp: default bit per pixel.
121  */
122 struct exynos_drm_fimd_pdata {
123 	struct exynos_drm_panel_info panel;
124 	u32				vidcon0;
125 	u32				vidcon1;
126 	unsigned int			default_win;
127 	unsigned int			bpp;
128 };
129 
130 /**
131  * Platform Specific Structure for DRM based HDMI.
132  *
133  * @hdmi_dev: device point to specific hdmi driver.
134  * @mixer_dev: device point to specific mixer driver.
135  *
136  * this structure is used for common hdmi driver and each device object
137  * would be used to access specific device driver(hdmi or mixer driver)
138  */
139 struct exynos_drm_common_hdmi_pd {
140 	struct device *hdmi_dev;
141 	struct device *mixer_dev;
142 };
143 
144 /**
145  * Platform Specific Structure for DRM based HDMI core.
146  *
147  * @timing: default video mode for initializing
148  * @default_win: default window layer number to be used for UI.
149  * @bpp: default bit per pixel.
150  */
151 struct exynos_drm_hdmi_pdata {
152 	struct fb_videomode		timing;
153 	unsigned int			default_win;
154 	unsigned int			bpp;
155 };
156 
157 #endif	/* __KERNEL__ */
158 #endif	/* _EXYNOS_DRM_H_ */
159