1 /*
2  * drivers/gpu/drm/omapdrm/omap_plane.c
3  *
4  * Copyright (C) 2011 Texas Instruments
5  * Author: Rob Clark <rob.clark@linaro.org>
6  *
7  * This program is free software; you can redistribute it and/or modify it
8  * under the terms of the GNU General Public License version 2 as published by
9  * the Free Software Foundation.
10  *
11  * This program is distributed in the hope that it will be useful, but WITHOUT
12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
14  * more details.
15  *
16  * You should have received a copy of the GNU General Public License along with
17  * this program.  If not, see <http://www.gnu.org/licenses/>.
18  */
19 
20 #include <linux/kfifo.h>
21 
22 #include "omap_drv.h"
23 #include "omap_dmm_tiler.h"
24 
25 /* some hackery because omapdss has an 'enum omap_plane' (which would be
26  * better named omap_plane_id).. and compiler seems unhappy about having
27  * both a 'struct omap_plane' and 'enum omap_plane'
28  */
29 #define omap_plane _omap_plane
30 
31 /*
32  * plane funcs
33  */
34 
35 struct callback {
36 	void (*fxn)(void *);
37 	void *arg;
38 };
39 
40 #define to_omap_plane(x) container_of(x, struct omap_plane, base)
41 
42 struct omap_plane {
43 	struct drm_plane base;
44 	int id;  /* TODO rename omap_plane -> omap_plane_id in omapdss so I can use the enum */
45 	const char *name;
46 	struct omap_overlay_info info;
47 	struct omap_drm_apply apply;
48 
49 	/* position/orientation of scanout within the fb: */
50 	struct omap_drm_window win;
51 	bool enabled;
52 
53 	/* last fb that we pinned: */
54 	struct drm_framebuffer *pinned_fb;
55 
56 	uint32_t nformats;
57 	uint32_t formats[32];
58 
59 	struct omap_drm_irq error_irq;
60 
61 	/* set of bo's pending unpin until next post_apply() */
62 	DECLARE_KFIFO_PTR(unpin_fifo, struct drm_gem_object *);
63 
64 	// XXX maybe get rid of this and handle vblank in crtc too?
65 	struct callback apply_done_cb;
66 };
67 
68 static void unpin(void *arg, struct drm_gem_object *bo)
69 {
70 	struct drm_plane *plane = arg;
71 	struct omap_plane *omap_plane = to_omap_plane(plane);
72 
73 	if (kfifo_put(&omap_plane->unpin_fifo,
74 			(const struct drm_gem_object **)&bo)) {
75 		/* also hold a ref so it isn't free'd while pinned */
76 		drm_gem_object_reference(bo);
77 	} else {
78 		dev_err(plane->dev->dev, "unpin fifo full!\n");
79 		omap_gem_put_paddr(bo);
80 	}
81 }
82 
83 /* update which fb (if any) is pinned for scanout */
84 static int update_pin(struct drm_plane *plane, struct drm_framebuffer *fb)
85 {
86 	struct omap_plane *omap_plane = to_omap_plane(plane);
87 	struct drm_framebuffer *pinned_fb = omap_plane->pinned_fb;
88 
89 	if (pinned_fb != fb) {
90 		int ret;
91 
92 		DBG("%p -> %p", pinned_fb, fb);
93 
94 		if (fb)
95 			drm_framebuffer_reference(fb);
96 
97 		ret = omap_framebuffer_replace(pinned_fb, fb, plane, unpin);
98 
99 		if (pinned_fb)
100 			drm_framebuffer_unreference(pinned_fb);
101 
102 		if (ret) {
103 			dev_err(plane->dev->dev, "could not swap %p -> %p\n",
104 					omap_plane->pinned_fb, fb);
105 			if (fb)
106 				drm_framebuffer_unreference(fb);
107 			omap_plane->pinned_fb = NULL;
108 			return ret;
109 		}
110 
111 		omap_plane->pinned_fb = fb;
112 	}
113 
114 	return 0;
115 }
116 
117 static void omap_plane_pre_apply(struct omap_drm_apply *apply)
118 {
119 	struct omap_plane *omap_plane =
120 			container_of(apply, struct omap_plane, apply);
121 	struct omap_drm_window *win = &omap_plane->win;
122 	struct drm_plane *plane = &omap_plane->base;
123 	struct drm_device *dev = plane->dev;
124 	struct omap_overlay_info *info = &omap_plane->info;
125 	struct drm_crtc *crtc = plane->crtc;
126 	enum omap_channel channel;
127 	bool enabled = omap_plane->enabled && crtc;
128 	bool ilace, replication;
129 	int ret;
130 
131 	DBG("%s, enabled=%d", omap_plane->name, enabled);
132 
133 	/* if fb has changed, pin new fb: */
134 	update_pin(plane, enabled ? plane->fb : NULL);
135 
136 	if (!enabled) {
137 		dispc_ovl_enable(omap_plane->id, false);
138 		return;
139 	}
140 
141 	channel = omap_crtc_channel(crtc);
142 
143 	/* update scanout: */
144 	omap_framebuffer_update_scanout(plane->fb, win, info);
145 
146 	DBG("%dx%d -> %dx%d (%d)", info->width, info->height,
147 			info->out_width, info->out_height,
148 			info->screen_width);
149 	DBG("%d,%d %08x %08x", info->pos_x, info->pos_y,
150 			info->paddr, info->p_uv_addr);
151 
152 	/* TODO: */
153 	ilace = false;
154 	replication = false;
155 
156 	/* and finally, update omapdss: */
157 	ret = dispc_ovl_setup(omap_plane->id, info,
158 			replication, omap_crtc_timings(crtc), false);
159 	if (ret) {
160 		dev_err(dev->dev, "dispc_ovl_setup failed: %d\n", ret);
161 		return;
162 	}
163 
164 	dispc_ovl_enable(omap_plane->id, true);
165 	dispc_ovl_set_channel_out(omap_plane->id, channel);
166 }
167 
168 static void omap_plane_post_apply(struct omap_drm_apply *apply)
169 {
170 	struct omap_plane *omap_plane =
171 			container_of(apply, struct omap_plane, apply);
172 	struct drm_plane *plane = &omap_plane->base;
173 	struct omap_overlay_info *info = &omap_plane->info;
174 	struct drm_gem_object *bo = NULL;
175 	struct callback cb;
176 
177 	cb = omap_plane->apply_done_cb;
178 	omap_plane->apply_done_cb.fxn = NULL;
179 
180 	while (kfifo_get(&omap_plane->unpin_fifo, &bo)) {
181 		omap_gem_put_paddr(bo);
182 		drm_gem_object_unreference_unlocked(bo);
183 	}
184 
185 	if (cb.fxn)
186 		cb.fxn(cb.arg);
187 
188 	if (omap_plane->enabled) {
189 		omap_framebuffer_flush(plane->fb, info->pos_x, info->pos_y,
190 				info->out_width, info->out_height);
191 	}
192 }
193 
194 static int apply(struct drm_plane *plane)
195 {
196 	if (plane->crtc) {
197 		struct omap_plane *omap_plane = to_omap_plane(plane);
198 		return omap_crtc_apply(plane->crtc, &omap_plane->apply);
199 	}
200 	return 0;
201 }
202 
203 int omap_plane_mode_set(struct drm_plane *plane,
204 		struct drm_crtc *crtc, struct drm_framebuffer *fb,
205 		int crtc_x, int crtc_y,
206 		unsigned int crtc_w, unsigned int crtc_h,
207 		uint32_t src_x, uint32_t src_y,
208 		uint32_t src_w, uint32_t src_h,
209 		void (*fxn)(void *), void *arg)
210 {
211 	struct omap_plane *omap_plane = to_omap_plane(plane);
212 	struct omap_drm_window *win = &omap_plane->win;
213 
214 	win->crtc_x = crtc_x;
215 	win->crtc_y = crtc_y;
216 	win->crtc_w = crtc_w;
217 	win->crtc_h = crtc_h;
218 
219 	/* src values are in Q16 fixed point, convert to integer: */
220 	win->src_x = src_x >> 16;
221 	win->src_y = src_y >> 16;
222 	win->src_w = src_w >> 16;
223 	win->src_h = src_h >> 16;
224 
225 	if (fxn) {
226 		/* omap_crtc should ensure that a new page flip
227 		 * isn't permitted while there is one pending:
228 		 */
229 		BUG_ON(omap_plane->apply_done_cb.fxn);
230 
231 		omap_plane->apply_done_cb.fxn = fxn;
232 		omap_plane->apply_done_cb.arg = arg;
233 	}
234 
235 	plane->fb = fb;
236 	plane->crtc = crtc;
237 
238 	return apply(plane);
239 }
240 
241 static int omap_plane_update(struct drm_plane *plane,
242 		struct drm_crtc *crtc, struct drm_framebuffer *fb,
243 		int crtc_x, int crtc_y,
244 		unsigned int crtc_w, unsigned int crtc_h,
245 		uint32_t src_x, uint32_t src_y,
246 		uint32_t src_w, uint32_t src_h)
247 {
248 	struct omap_plane *omap_plane = to_omap_plane(plane);
249 	omap_plane->enabled = true;
250 
251 	if (plane->fb)
252 		drm_framebuffer_unreference(plane->fb);
253 
254 	drm_framebuffer_reference(fb);
255 
256 	return omap_plane_mode_set(plane, crtc, fb,
257 			crtc_x, crtc_y, crtc_w, crtc_h,
258 			src_x, src_y, src_w, src_h,
259 			NULL, NULL);
260 }
261 
262 static int omap_plane_disable(struct drm_plane *plane)
263 {
264 	struct omap_plane *omap_plane = to_omap_plane(plane);
265 	omap_plane->win.rotation = BIT(DRM_ROTATE_0);
266 	return omap_plane_dpms(plane, DRM_MODE_DPMS_OFF);
267 }
268 
269 static void omap_plane_destroy(struct drm_plane *plane)
270 {
271 	struct omap_plane *omap_plane = to_omap_plane(plane);
272 
273 	DBG("%s", omap_plane->name);
274 
275 	omap_irq_unregister(plane->dev, &omap_plane->error_irq);
276 
277 	omap_plane_disable(plane);
278 	drm_plane_cleanup(plane);
279 
280 	WARN_ON(!kfifo_is_empty(&omap_plane->unpin_fifo));
281 	kfifo_free(&omap_plane->unpin_fifo);
282 
283 	kfree(omap_plane);
284 }
285 
286 int omap_plane_dpms(struct drm_plane *plane, int mode)
287 {
288 	struct omap_plane *omap_plane = to_omap_plane(plane);
289 	bool enabled = (mode == DRM_MODE_DPMS_ON);
290 	int ret = 0;
291 
292 	if (enabled != omap_plane->enabled) {
293 		omap_plane->enabled = enabled;
294 		ret = apply(plane);
295 	}
296 
297 	return ret;
298 }
299 
300 /* helper to install properties which are common to planes and crtcs */
301 void omap_plane_install_properties(struct drm_plane *plane,
302 		struct drm_mode_object *obj)
303 {
304 	struct drm_device *dev = plane->dev;
305 	struct omap_drm_private *priv = dev->dev_private;
306 	struct drm_property *prop;
307 
308 	if (priv->has_dmm) {
309 		prop = priv->rotation_prop;
310 		if (!prop) {
311 			const struct drm_prop_enum_list props[] = {
312 					{ DRM_ROTATE_0,   "rotate-0" },
313 					{ DRM_ROTATE_90,  "rotate-90" },
314 					{ DRM_ROTATE_180, "rotate-180" },
315 					{ DRM_ROTATE_270, "rotate-270" },
316 					{ DRM_REFLECT_X,  "reflect-x" },
317 					{ DRM_REFLECT_Y,  "reflect-y" },
318 			};
319 			prop = drm_property_create_bitmask(dev, 0, "rotation",
320 					props, ARRAY_SIZE(props));
321 			if (prop == NULL)
322 				return;
323 			priv->rotation_prop = prop;
324 		}
325 		drm_object_attach_property(obj, prop, 0);
326 	}
327 
328 	prop = priv->zorder_prop;
329 	if (!prop) {
330 		prop = drm_property_create_range(dev, 0, "zorder", 0, 3);
331 		if (prop == NULL)
332 			return;
333 		priv->zorder_prop = prop;
334 	}
335 	drm_object_attach_property(obj, prop, 0);
336 }
337 
338 int omap_plane_set_property(struct drm_plane *plane,
339 		struct drm_property *property, uint64_t val)
340 {
341 	struct omap_plane *omap_plane = to_omap_plane(plane);
342 	struct omap_drm_private *priv = plane->dev->dev_private;
343 	int ret = -EINVAL;
344 
345 	if (property == priv->rotation_prop) {
346 		DBG("%s: rotation: %02x", omap_plane->name, (uint32_t)val);
347 		omap_plane->win.rotation = val;
348 		ret = apply(plane);
349 	} else if (property == priv->zorder_prop) {
350 		DBG("%s: zorder: %02x", omap_plane->name, (uint32_t)val);
351 		omap_plane->info.zorder = val;
352 		ret = apply(plane);
353 	}
354 
355 	return ret;
356 }
357 
358 static const struct drm_plane_funcs omap_plane_funcs = {
359 		.update_plane = omap_plane_update,
360 		.disable_plane = omap_plane_disable,
361 		.destroy = omap_plane_destroy,
362 		.set_property = omap_plane_set_property,
363 };
364 
365 static void omap_plane_error_irq(struct omap_drm_irq *irq, uint32_t irqstatus)
366 {
367 	struct omap_plane *omap_plane =
368 			container_of(irq, struct omap_plane, error_irq);
369 	DRM_ERROR("%s: errors: %08x\n", omap_plane->name, irqstatus);
370 }
371 
372 static const char *plane_names[] = {
373 		[OMAP_DSS_GFX] = "gfx",
374 		[OMAP_DSS_VIDEO1] = "vid1",
375 		[OMAP_DSS_VIDEO2] = "vid2",
376 		[OMAP_DSS_VIDEO3] = "vid3",
377 };
378 
379 static const uint32_t error_irqs[] = {
380 		[OMAP_DSS_GFX] = DISPC_IRQ_GFX_FIFO_UNDERFLOW,
381 		[OMAP_DSS_VIDEO1] = DISPC_IRQ_VID1_FIFO_UNDERFLOW,
382 		[OMAP_DSS_VIDEO2] = DISPC_IRQ_VID2_FIFO_UNDERFLOW,
383 		[OMAP_DSS_VIDEO3] = DISPC_IRQ_VID3_FIFO_UNDERFLOW,
384 };
385 
386 /* initialize plane */
387 struct drm_plane *omap_plane_init(struct drm_device *dev,
388 		int id, bool private_plane)
389 {
390 	struct omap_drm_private *priv = dev->dev_private;
391 	struct drm_plane *plane = NULL;
392 	struct omap_plane *omap_plane;
393 	struct omap_overlay_info *info;
394 	int ret;
395 
396 	DBG("%s: priv=%d", plane_names[id], private_plane);
397 
398 	omap_plane = kzalloc(sizeof(*omap_plane), GFP_KERNEL);
399 	if (!omap_plane)
400 		goto fail;
401 
402 	ret = kfifo_alloc(&omap_plane->unpin_fifo, 16, GFP_KERNEL);
403 	if (ret) {
404 		dev_err(dev->dev, "could not allocate unpin FIFO\n");
405 		goto fail;
406 	}
407 
408 	omap_plane->nformats = omap_framebuffer_get_formats(
409 			omap_plane->formats, ARRAY_SIZE(omap_plane->formats),
410 			dss_feat_get_supported_color_modes(id));
411 	omap_plane->id = id;
412 	omap_plane->name = plane_names[id];
413 
414 	plane = &omap_plane->base;
415 
416 	omap_plane->apply.pre_apply  = omap_plane_pre_apply;
417 	omap_plane->apply.post_apply = omap_plane_post_apply;
418 
419 	omap_plane->error_irq.irqmask = error_irqs[id];
420 	omap_plane->error_irq.irq = omap_plane_error_irq;
421 	omap_irq_register(dev, &omap_plane->error_irq);
422 
423 	drm_plane_init(dev, plane, (1 << priv->num_crtcs) - 1, &omap_plane_funcs,
424 			omap_plane->formats, omap_plane->nformats, private_plane);
425 
426 	omap_plane_install_properties(plane, &plane->base);
427 
428 	/* get our starting configuration, set defaults for parameters
429 	 * we don't currently use, etc:
430 	 */
431 	info = &omap_plane->info;
432 	info->rotation_type = OMAP_DSS_ROT_DMA;
433 	info->rotation = OMAP_DSS_ROT_0;
434 	info->global_alpha = 0xff;
435 	info->mirror = 0;
436 
437 	/* Set defaults depending on whether we are a CRTC or overlay
438 	 * layer.
439 	 * TODO add ioctl to give userspace an API to change this.. this
440 	 * will come in a subsequent patch.
441 	 */
442 	if (private_plane)
443 		omap_plane->info.zorder = 0;
444 	else
445 		omap_plane->info.zorder = id;
446 
447 	return plane;
448 
449 fail:
450 	if (plane)
451 		omap_plane_destroy(plane);
452 
453 	return NULL;
454 }
455