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