xref: /openbmc/linux/drivers/gpu/drm/msm/msm_kms.h (revision 3ac14b39)
1 /*
2  * Copyright (C) 2013 Red Hat
3  * Author: Rob Clark <robdclark@gmail.com>
4  *
5  * This program is free software; you can redistribute it and/or modify it
6  * under the terms of the GNU General Public License version 2 as published by
7  * the Free Software Foundation.
8  *
9  * This program is distributed in the hope that it will be useful, but WITHOUT
10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
12  * more details.
13  *
14  * You should have received a copy of the GNU General Public License along with
15  * this program.  If not, see <http://www.gnu.org/licenses/>.
16  */
17 
18 #ifndef __MSM_KMS_H__
19 #define __MSM_KMS_H__
20 
21 #include <linux/clk.h>
22 #include <linux/regulator/consumer.h>
23 
24 #include "msm_drv.h"
25 
26 #define MAX_PLANE	4
27 
28 /* As there are different display controller blocks depending on the
29  * snapdragon version, the kms support is split out and the appropriate
30  * implementation is loaded at runtime.  The kms module is responsible
31  * for constructing the appropriate planes/crtcs/encoders/connectors.
32  */
33 struct msm_kms_funcs {
34 	/* hw initialization: */
35 	int (*hw_init)(struct msm_kms *kms);
36 	/* irq handling: */
37 	void (*irq_preinstall)(struct msm_kms *kms);
38 	int (*irq_postinstall)(struct msm_kms *kms);
39 	void (*irq_uninstall)(struct msm_kms *kms);
40 	irqreturn_t (*irq)(struct msm_kms *kms);
41 	int (*enable_vblank)(struct msm_kms *kms, struct drm_crtc *crtc);
42 	void (*disable_vblank)(struct msm_kms *kms, struct drm_crtc *crtc);
43 	/* modeset, bracketing atomic_commit(): */
44 	void (*prepare_commit)(struct msm_kms *kms, struct drm_atomic_state *state);
45 	void (*complete_commit)(struct msm_kms *kms, struct drm_atomic_state *state);
46 	/* functions to wait for atomic commit completed on each CRTC */
47 	void (*wait_for_crtc_commit_done)(struct msm_kms *kms,
48 					struct drm_crtc *crtc);
49 	/* get msm_format w/ optional format modifiers from drm_mode_fb_cmd2 */
50 	const struct msm_format *(*get_format)(struct msm_kms *kms,
51 					const uint32_t format,
52 					const uint64_t modifiers);
53 	/* misc: */
54 	long (*round_pixclk)(struct msm_kms *kms, unsigned long rate,
55 			struct drm_encoder *encoder);
56 	int (*set_split_display)(struct msm_kms *kms,
57 			struct drm_encoder *encoder,
58 			struct drm_encoder *slave_encoder,
59 			bool is_cmd_mode);
60 	void (*set_encoder_mode)(struct msm_kms *kms,
61 				 struct drm_encoder *encoder,
62 				 bool cmd_mode);
63 	/* cleanup: */
64 	void (*destroy)(struct msm_kms *kms);
65 #ifdef CONFIG_DEBUG_FS
66 	/* debugfs: */
67 	int (*debugfs_init)(struct msm_kms *kms, struct drm_minor *minor);
68 #endif
69 };
70 
71 struct msm_kms {
72 	const struct msm_kms_funcs *funcs;
73 
74 	/* irq number to be passed on to drm_irq_install */
75 	int irq;
76 
77 	/* mapper-id used to request GEM buffer mapped for scanout: */
78 	struct msm_gem_address_space *aspace;
79 };
80 
81 static inline void msm_kms_init(struct msm_kms *kms,
82 		const struct msm_kms_funcs *funcs)
83 {
84 	kms->funcs = funcs;
85 }
86 
87 struct msm_kms *mdp4_kms_init(struct drm_device *dev);
88 struct msm_kms *mdp5_kms_init(struct drm_device *dev);
89 int msm_mdss_init(struct drm_device *dev);
90 void msm_mdss_destroy(struct drm_device *dev);
91 int msm_mdss_enable(struct msm_mdss *mdss);
92 int msm_mdss_disable(struct msm_mdss *mdss);
93 
94 #endif /* __MSM_KMS_H__ */
95