drivers/gpu/drm/msm/msm_kms.h

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