1/* SPDX-License-Identifier: GPL-2.0+ */
 2/*
 3 * rcar_du_plane.h  --  R-Car Display Unit Planes
 4 *
 5 * Copyright (C) 2013-2014 Renesas Electronics Corporation
 6 *
 7 * Contact: Laurent Pinchart (laurent.pinchart@ideasonboard.com)
 
 
 
 
 
 8 */
 9
10#ifndef __RCAR_DU_PLANE_H__
11#define __RCAR_DU_PLANE_H__
12
13#include <drm/drm_plane.h>
 
 
 
14
15struct rcar_du_format_info;
16struct rcar_du_group;
17
18/*
19 * The RCAR DU has 8 hardware planes, shared between primary and overlay planes.
20 * As using overlay planes requires at least one of the CRTCs being enabled, no
21 * more than 7 overlay planes can be available. We thus create 1 primary plane
22 * per CRTC and 7 overlay planes, for a total of up to 9 KMS planes.
23 */
24#define RCAR_DU_NUM_KMS_PLANES		9
25#define RCAR_DU_NUM_HW_PLANES		8
26
27enum rcar_du_plane_source {
28	RCAR_DU_PLANE_MEMORY,
29	RCAR_DU_PLANE_VSPD0,
30	RCAR_DU_PLANE_VSPD1,
31};
32
33struct rcar_du_plane {
34	struct drm_plane plane;
35	struct rcar_du_group *group;
36};
37
38static inline struct rcar_du_plane *to_rcar_plane(struct drm_plane *plane)
39{
40	return container_of(plane, struct rcar_du_plane, plane);
41}
42
43/**
44 * struct rcar_du_plane_state - Driver-specific plane state
45 * @state: base DRM plane state
46 * @format: information about the pixel format used by the plane
47 * @hwindex: 0-based hardware plane index, -1 means unused
48 * @colorkey: value of the plane colorkey property
49 */
50struct rcar_du_plane_state {
51	struct drm_plane_state state;
52
53	const struct rcar_du_format_info *format;
54	int hwindex;
55	enum rcar_du_plane_source source;
56
57	unsigned int colorkey;
58};
59
60static inline struct rcar_du_plane_state *
61to_rcar_plane_state(struct drm_plane_state *state)
62{
63	return container_of(state, struct rcar_du_plane_state, state);
64}
65
66int rcar_du_atomic_check_planes(struct drm_device *dev,
67				struct drm_atomic_state *state);
68
69int __rcar_du_plane_atomic_check(struct drm_plane *plane,
70				 struct drm_plane_state *state,
71				 const struct rcar_du_format_info **format);
72
73int rcar_du_planes_init(struct rcar_du_group *rgrp);
 
 
 
 
74
75void __rcar_du_plane_setup(struct rcar_du_group *rgrp,
76			   const struct rcar_du_plane_state *state);
 
 
 
 
 
 
 
77
78static inline void rcar_du_plane_setup(struct rcar_du_plane *plane)
79{
80	struct rcar_du_plane_state *state =
81		to_rcar_plane_state(plane->plane.state);
82
83	return __rcar_du_plane_setup(plane->group, state);
84}
 
 
 
 
 
85
86#endif /* __RCAR_DU_PLANE_H__ */

 
 1/*
 2 * rcar_du_plane.h  --  R-Car Display Unit Planes
 3 *
 4 * Copyright (C) 2013 Renesas Corporation
 5 *
 6 * Contact: Laurent Pinchart (laurent.pinchart@ideasonboard.com)
 7 *
 8 * This program is free software; you can redistribute it and/or modify
 9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
12 */
13
14#ifndef __RCAR_DU_PLANE_H__
15#define __RCAR_DU_PLANE_H__
16
17#include <linux/mutex.h>
18
19#include <drm/drmP.h>
20#include <drm/drm_crtc.h>
21
22struct rcar_du_format_info;
23struct rcar_du_group;
24
25/* The RCAR DU has 8 hardware planes, shared between KMS planes and CRTCs. As
26 * using KMS planes requires at least one of the CRTCs being enabled, no more
27 * than 7 KMS planes can be available. We thus create 7 KMS planes and
28 * 9 software planes (one for each KMS planes and one for each CRTC).
 
29 */
 
 
30
31#define RCAR_DU_NUM_KMS_PLANES		7
32#define RCAR_DU_NUM_HW_PLANES		8
33#define RCAR_DU_NUM_SW_PLANES		9
 
 
34
35struct rcar_du_plane {
 
36	struct rcar_du_group *group;
37	struct drm_crtc *crtc;
38
39	bool enabled;
40
41	int hwindex;		/* 0-based, -1 means unused */
42	unsigned int alpha;
43	unsigned int colorkey;
44	unsigned int zpos;
 
 
 
 
 
 
 
 
45
46	const struct rcar_du_format_info *format;
 
 
47
48	unsigned long dma[2];
49	unsigned int pitch;
50
51	unsigned int width;
52	unsigned int height;
 
 
 
 
 
 
 
 
 
 
53
54	unsigned int src_x;
55	unsigned int src_y;
56	unsigned int dst_x;
57	unsigned int dst_y;
58};
59
60struct rcar_du_planes {
61	struct rcar_du_plane planes[RCAR_DU_NUM_SW_PLANES];
62	unsigned int free;
63	struct mutex lock;
64
65	struct drm_property *alpha;
66	struct drm_property *colorkey;
67	struct drm_property *zpos;
68};
69
70int rcar_du_planes_init(struct rcar_du_group *rgrp);
71int rcar_du_planes_register(struct rcar_du_group *rgrp);
 
 
72
73void rcar_du_plane_setup(struct rcar_du_plane *plane);
74void rcar_du_plane_update_base(struct rcar_du_plane *plane);
75void rcar_du_plane_compute_base(struct rcar_du_plane *plane,
76				struct drm_framebuffer *fb);
77int rcar_du_plane_reserve(struct rcar_du_plane *plane,
78			  const struct rcar_du_format_info *format);
79void rcar_du_plane_release(struct rcar_du_plane *plane);
80
81#endif /* __RCAR_DU_PLANE_H__ */