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 /* swap global atomic state: */
44 void (*swap_state)(struct msm_kms *kms, struct drm_atomic_state *state);
45 /* modeset, bracketing atomic_commit(): */
46 void (*prepare_commit)(struct msm_kms *kms, struct drm_atomic_state *state);
47 void (*complete_commit)(struct msm_kms *kms, struct drm_atomic_state *state);
48 /* functions to wait for atomic commit completed on each CRTC */
49 void (*wait_for_crtc_commit_done)(struct msm_kms *kms,
50 struct drm_crtc *crtc);
51 /* misc: */
52 const struct msm_format *(*get_format)(struct msm_kms *kms, uint32_t format);
53 long (*round_pixclk)(struct msm_kms *kms, unsigned long rate,
54 struct drm_encoder *encoder);
55 int (*set_split_display)(struct msm_kms *kms,
56 struct drm_encoder *encoder,
57 struct drm_encoder *slave_encoder,
58 bool is_cmd_mode);
59 void (*set_encoder_mode)(struct msm_kms *kms,
60 struct drm_encoder *encoder,
61 bool cmd_mode);
62 /* cleanup: */
63 void (*destroy)(struct msm_kms *kms);
64 #ifdef CONFIG_DEBUG_FS
65 /* debugfs: */
66 int (*debugfs_init)(struct msm_kms *kms, struct drm_minor *minor);
67 #endif
68 };
69
70 struct msm_kms {
71 const struct msm_kms_funcs *funcs;
72
73 /* irq number to be passed on to drm_irq_install */
74 int irq;
75
76 /* mapper-id used to request GEM buffer mapped for scanout: */
77 struct msm_gem_address_space *aspace;
78 };
79
80 /**
81 * Subclass of drm_atomic_state, to allow kms backend to have driver
82 * private global state. The kms backend can do whatever it wants
83 * with the ->state ptr. On ->atomic_state_clear() the ->state ptr
84 * is kfree'd and set back to NULL.
85 */
86 struct msm_kms_state {
87 struct drm_atomic_state base;
88 void *state;
89 };
90 #define to_kms_state(x) container_of(x, struct msm_kms_state, base)
91
msm_kms_init(struct msm_kms * kms,const struct msm_kms_funcs * funcs)92 static inline void msm_kms_init(struct msm_kms *kms,
93 const struct msm_kms_funcs *funcs)
94 {
95 kms->funcs = funcs;
96 }
97
98 struct msm_kms *mdp4_kms_init(struct drm_device *dev);
99 struct msm_kms *mdp5_kms_init(struct drm_device *dev);
100 int msm_mdss_init(struct drm_device *dev);
101 void msm_mdss_destroy(struct drm_device *dev);
102 int msm_mdss_enable(struct msm_mdss *mdss);
103 int msm_mdss_disable(struct msm_mdss *mdss);
104
105 #endif /* __MSM_KMS_H__ */
106