]>
Commit | Line | Data |
---|---|---|
1c248b7d ID |
1 | /* exynos_drm_drv.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_DRV_H_ | |
30 | #define _EXYNOS_DRM_DRV_H_ | |
31 | ||
4f9eb94f | 32 | #include <linux/module.h> |
1c248b7d ID |
33 | #include "drm.h" |
34 | ||
35 | #define MAX_CRTC 2 | |
864ee9e6 | 36 | #define MAX_PLANE 5 |
229d3534 | 37 | #define MAX_FB_BUFFER 3 |
864ee9e6 | 38 | #define DEFAULT_ZPOS -1 |
1c248b7d ID |
39 | |
40 | struct drm_device; | |
41 | struct exynos_drm_overlay; | |
42 | struct drm_connector; | |
43 | ||
52c68814 ID |
44 | extern unsigned int drm_vblank_offdelay; |
45 | ||
1c248b7d ID |
46 | /* this enumerates display type. */ |
47 | enum exynos_drm_output_type { | |
48 | EXYNOS_DISPLAY_TYPE_NONE, | |
49 | /* RGB or CPU Interface. */ | |
50 | EXYNOS_DISPLAY_TYPE_LCD, | |
51 | /* HDMI Interface. */ | |
52 | EXYNOS_DISPLAY_TYPE_HDMI, | |
53 | }; | |
54 | ||
55 | /* | |
56 | * Exynos drm overlay ops structure. | |
57 | * | |
58 | * @mode_set: copy drm overlay info to hw specific overlay info. | |
59 | * @commit: apply hardware specific overlay data to registers. | |
60 | * @disable: disable hardware specific overlay. | |
61 | */ | |
62 | struct exynos_drm_overlay_ops { | |
63 | void (*mode_set)(struct device *subdrv_dev, | |
64 | struct exynos_drm_overlay *overlay); | |
864ee9e6 JS |
65 | void (*commit)(struct device *subdrv_dev, int zpos); |
66 | void (*disable)(struct device *subdrv_dev, int zpos); | |
1c248b7d ID |
67 | }; |
68 | ||
69 | /* | |
70 | * Exynos drm common overlay structure. | |
71 | * | |
19c8b834 ID |
72 | * @fb_x: offset x on a framebuffer to be displayed. |
73 | * - the unit is screen coordinates. | |
74 | * @fb_y: offset y on a framebuffer to be displayed. | |
75 | * - the unit is screen coordinates. | |
76 | * @fb_width: width of a framebuffer. | |
77 | * @fb_height: height of a framebuffer. | |
78 | * @crtc_x: offset x on hardware screen. | |
79 | * @crtc_y: offset y on hardware screen. | |
80 | * @crtc_width: window width to be displayed (hardware screen). | |
81 | * @crtc_height: window height to be displayed (hardware screen). | |
82 | * @mode_width: width of screen mode. | |
83 | * @mode_height: height of screen mode. | |
84 | * @refresh: refresh rate. | |
85 | * @scan_flag: interlace or progressive way. | |
86 | * (it could be DRM_MODE_FLAG_*) | |
1c248b7d | 87 | * @bpp: pixel size.(in bit) |
229d3534 SWK |
88 | * @pixel_format: fourcc pixel format of this overlay |
89 | * @dma_addr: array of bus(accessed by dma) address to the memory region | |
90 | * allocated for a overlay. | |
91 | * @vaddr: array of virtual memory addresss to this overlay. | |
864ee9e6 | 92 | * @zpos: order of overlay layer(z position). |
1c248b7d ID |
93 | * @default_win: a window to be enabled. |
94 | * @color_key: color key on or off. | |
95 | * @index_color: if using color key feature then this value would be used | |
96 | * as index color. | |
97 | * @local_path: in case of lcd type, local path mode on or off. | |
98 | * @transparency: transparency on or off. | |
99 | * @activated: activated or not. | |
100 | * | |
101 | * this structure is common to exynos SoC and its contents would be copied | |
102 | * to hardware specific overlay info. | |
103 | */ | |
104 | struct exynos_drm_overlay { | |
19c8b834 ID |
105 | unsigned int fb_x; |
106 | unsigned int fb_y; | |
107 | unsigned int fb_width; | |
108 | unsigned int fb_height; | |
109 | unsigned int crtc_x; | |
110 | unsigned int crtc_y; | |
111 | unsigned int crtc_width; | |
112 | unsigned int crtc_height; | |
113 | unsigned int mode_width; | |
114 | unsigned int mode_height; | |
115 | unsigned int refresh; | |
116 | unsigned int scan_flag; | |
1c248b7d | 117 | unsigned int bpp; |
19c8b834 | 118 | unsigned int pitch; |
229d3534 SWK |
119 | uint32_t pixel_format; |
120 | dma_addr_t dma_addr[MAX_FB_BUFFER]; | |
121 | void __iomem *vaddr[MAX_FB_BUFFER]; | |
864ee9e6 | 122 | int zpos; |
1c248b7d ID |
123 | |
124 | bool default_win; | |
125 | bool color_key; | |
126 | unsigned int index_color; | |
127 | bool local_path; | |
128 | bool transparency; | |
129 | bool activated; | |
130 | }; | |
131 | ||
132 | /* | |
133 | * Exynos DRM Display Structure. | |
134 | * - this structure is common to analog tv, digital tv and lcd panel. | |
135 | * | |
a88cab2b | 136 | * @type: one of EXYNOS_DISPLAY_TYPE_LCD and HDMI. |
1c248b7d ID |
137 | * @is_connected: check for that display is connected or not. |
138 | * @get_edid: get edid modes from display driver. | |
607c50d4 | 139 | * @get_panel: get panel object from display driver. |
1c248b7d ID |
140 | * @check_timing: check if timing is valid or not. |
141 | * @power_on: display device on or off. | |
142 | */ | |
74ccc539 | 143 | struct exynos_drm_display_ops { |
1c248b7d ID |
144 | enum exynos_drm_output_type type; |
145 | bool (*is_connected)(struct device *dev); | |
146 | int (*get_edid)(struct device *dev, struct drm_connector *connector, | |
147 | u8 *edid, int len); | |
607c50d4 | 148 | void *(*get_panel)(struct device *dev); |
1c248b7d ID |
149 | int (*check_timing)(struct device *dev, void *timing); |
150 | int (*power_on)(struct device *dev, int mode); | |
151 | }; | |
152 | ||
153 | /* | |
154 | * Exynos drm manager ops | |
155 | * | |
ec05da95 ID |
156 | * @dpms: control device power. |
157 | * @apply: set timing, vblank and overlay data to registers. | |
1de425b0 | 158 | * @mode_fixup: fix mode data comparing to hw specific display mode. |
1c248b7d ID |
159 | * @mode_set: convert drm_display_mode to hw specific display mode and |
160 | * would be called by encoder->mode_set(). | |
1de425b0 | 161 | * @get_max_resol: get maximum resolution to specific hardware. |
1c248b7d ID |
162 | * @commit: set current hw specific display mode to hw. |
163 | * @enable_vblank: specific driver callback for enabling vblank interrupt. | |
164 | * @disable_vblank: specific driver callback for disabling vblank interrupt. | |
165 | */ | |
166 | struct exynos_drm_manager_ops { | |
ec05da95 ID |
167 | void (*dpms)(struct device *subdrv_dev, int mode); |
168 | void (*apply)(struct device *subdrv_dev); | |
1de425b0 ID |
169 | void (*mode_fixup)(struct device *subdrv_dev, |
170 | struct drm_connector *connector, | |
171 | struct drm_display_mode *mode, | |
172 | struct drm_display_mode *adjusted_mode); | |
1c248b7d | 173 | void (*mode_set)(struct device *subdrv_dev, void *mode); |
1de425b0 ID |
174 | void (*get_max_resol)(struct device *subdrv_dev, unsigned int *width, |
175 | unsigned int *height); | |
1c248b7d ID |
176 | void (*commit)(struct device *subdrv_dev); |
177 | int (*enable_vblank)(struct device *subdrv_dev); | |
178 | void (*disable_vblank)(struct device *subdrv_dev); | |
179 | }; | |
180 | ||
181 | /* | |
182 | * Exynos drm common manager structure. | |
183 | * | |
184 | * @dev: pointer to device object for subdrv device driver. | |
185 | * sub drivers such as display controller or hdmi driver, | |
186 | * have their own device object. | |
187 | * @ops: pointer to callbacks for exynos drm specific framebuffer. | |
188 | * these callbacks should be set by specific drivers such fimd | |
189 | * or hdmi driver and are used to control hardware global registers. | |
190 | * @overlay_ops: pointer to callbacks for exynos drm specific framebuffer. | |
191 | * these callbacks should be set by specific drivers such fimd | |
192 | * or hdmi driver and are used to control hardware overlay reigsters. | |
193 | * @display: pointer to callbacks for exynos drm specific framebuffer. | |
194 | * these callbacks should be set by specific drivers such fimd | |
195 | * or hdmi driver and are used to control display devices such as | |
196 | * analog tv, digital tv and lcd panel and also get timing data for them. | |
197 | */ | |
198 | struct exynos_drm_manager { | |
199 | struct device *dev; | |
200 | int pipe; | |
201 | struct exynos_drm_manager_ops *ops; | |
202 | struct exynos_drm_overlay_ops *overlay_ops; | |
74ccc539 | 203 | struct exynos_drm_display_ops *display_ops; |
1c248b7d ID |
204 | }; |
205 | ||
206 | /* | |
207 | * Exynos drm private structure. | |
208 | */ | |
209 | struct exynos_drm_private { | |
210 | struct drm_fb_helper *fb_helper; | |
211 | ||
ccf4d883 | 212 | /* list head for new event to be added. */ |
1c248b7d | 213 | struct list_head pageflip_event_list; |
1c248b7d ID |
214 | |
215 | /* | |
216 | * created crtc object would be contained at this array and | |
217 | * this array is used to be aware of which crtc did it request vblank. | |
218 | */ | |
219 | struct drm_crtc *crtc[MAX_CRTC]; | |
220 | }; | |
221 | ||
222 | /* | |
223 | * Exynos drm sub driver structure. | |
224 | * | |
225 | * @list: sub driver has its own list object to register to exynos drm driver. | |
226 | * @drm_dev: pointer to drm_device and this pointer would be set | |
227 | * when sub driver calls exynos_drm_subdrv_register(). | |
228 | * @probe: this callback would be called by exynos drm driver after | |
229 | * subdrv is registered to it. | |
230 | * @remove: this callback is used to release resources created | |
231 | * by probe callback. | |
9084f7b8 JS |
232 | * @open: this would be called with drm device file open. |
233 | * @close: this would be called with drm device file close. | |
1c248b7d ID |
234 | * @manager: subdrv has its own manager to control a hardware appropriately |
235 | * and we can access a hardware drawing on this manager. | |
236 | * @encoder: encoder object owned by this sub driver. | |
237 | * @connector: connector object owned by this sub driver. | |
238 | */ | |
239 | struct exynos_drm_subdrv { | |
240 | struct list_head list; | |
241 | struct drm_device *drm_dev; | |
242 | ||
41c24346 | 243 | int (*probe)(struct drm_device *drm_dev, struct device *dev); |
1c248b7d | 244 | void (*remove)(struct drm_device *dev); |
9084f7b8 JS |
245 | int (*open)(struct drm_device *drm_dev, struct device *dev, |
246 | struct drm_file *file); | |
247 | void (*close)(struct drm_device *drm_dev, struct device *dev, | |
248 | struct drm_file *file); | |
1c248b7d ID |
249 | |
250 | struct exynos_drm_manager manager; | |
251 | struct drm_encoder *encoder; | |
252 | struct drm_connector *connector; | |
253 | }; | |
254 | ||
255 | /* | |
256 | * this function calls a probe callback registered to sub driver list and | |
257 | * create its own encoder and connector and then set drm_device object | |
258 | * to global one. | |
259 | */ | |
260 | int exynos_drm_device_register(struct drm_device *dev); | |
261 | /* | |
262 | * this function calls a remove callback registered to sub driver list and | |
263 | * destroy its own encoder and connetor. | |
264 | */ | |
265 | int exynos_drm_device_unregister(struct drm_device *dev); | |
266 | ||
267 | /* | |
268 | * this function would be called by sub drivers such as display controller | |
269 | * or hdmi driver to register this sub driver object to exynos drm driver | |
270 | * and when a sub driver is registered to exynos drm driver a probe callback | |
132a5b91 | 271 | * of the sub driver is called and creates its own encoder and connector. |
1c248b7d ID |
272 | */ |
273 | int exynos_drm_subdrv_register(struct exynos_drm_subdrv *drm_subdrv); | |
274 | ||
132a5b91 | 275 | /* this function removes subdrv list from exynos drm driver */ |
1c248b7d ID |
276 | int exynos_drm_subdrv_unregister(struct exynos_drm_subdrv *drm_subdrv); |
277 | ||
9084f7b8 JS |
278 | int exynos_drm_subdrv_open(struct drm_device *dev, struct drm_file *file); |
279 | void exynos_drm_subdrv_close(struct drm_device *dev, struct drm_file *file); | |
280 | ||
132a5b91 JS |
281 | extern struct platform_driver fimd_driver; |
282 | extern struct platform_driver hdmi_driver; | |
283 | extern struct platform_driver mixer_driver; | |
284 | extern struct platform_driver exynos_drm_common_hdmi_driver; | |
1c248b7d | 285 | #endif |