drivers/gpu/drm/arm/display/komeda/komeda_kms.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /*
   3  * (C) COPYRIGHT 2018 ARM Limited. All rights reserved.
   4  * Author: James.Qian.Wang <james.qian.wang@arm.com>
   5  *
   6  */
   7 #ifndef _KOMEDA_KMS_H_
   8 #define _KOMEDA_KMS_H_
   9
  10 #include <linux/list.h>
  11 #include <drm/drm_atomic.h>
  12 #include <drm/drm_atomic_helper.h>
  13 #include <drm/drm_crtc_helper.h>
  14 #include <drm/drm_device.h>
  15 #include <drm/drm_writeback.h>
  16 #include <drm/drm_print.h>
  17
  18 /**
  19  * struct komeda_plane - komeda instance of drm_plane
  20  */
  21 struct komeda_plane {
  22         /** @base: &drm_plane */
  23         struct drm_plane base;
  24         /**
  25          * @layer:
  26          *
  27          * represents available layer input pipelines for this plane.
  28          *
  29          * NOTE:
  30          * the layer is not for a specific Layer, but indicate a group of
  31          * Layers with same capabilities.
  32          */
  33         struct komeda_layer *layer;
  34 };
  35
  36 /**
  37  * struct komeda_plane_state
  38  *
  39  * The plane_state can be split into two data flow (left/right) and handled
  40  * by two layers &komeda_plane.layer and &komeda_plane.layer.right
  41  */
  42 struct komeda_plane_state {
  43         /** @base: &drm_plane_state */
  44         struct drm_plane_state base;
  45         /** @zlist_node: zorder list node */
  46         struct list_head zlist_node;
  47
  48         /** @layer_split: on/off layer_split */
  49         u8 layer_split : 1;
  50 };
  51
  52 /**
  53  * struct komeda_wb_connector
  54  */
  55 struct komeda_wb_connector {
  56         /** @base: &drm_writeback_connector */
  57         struct drm_writeback_connector base;
  58
  59         /** @wb_layer: represents associated writeback pipeline of komeda */
  60         struct komeda_layer *wb_layer;
  61 };
  62
  63 /**
  64  * struct komeda_crtc
  65  */
  66 struct komeda_crtc {
  67         /** @base: &drm_crtc */
  68         struct drm_crtc base;
  69         /** @master: only master has display output */
  70         struct komeda_pipeline *master;
  71         /**
  72          * @slave: optional
  73          *
  74          * Doesn't have its own display output, the handled data flow will
  75          * merge into the master.
  76          */
  77         struct komeda_pipeline *slave;
  78
  79         /** @slave_planes: komeda slave planes mask */
  80         u32 slave_planes;
  81
  82         /** @wb_conn: komeda write back connector */
  83         struct komeda_wb_connector *wb_conn;
  84
  85         /** @disable_done: this flip_done is for tracing the disable */
  86         struct completion *disable_done;
  87 };
  88
  89 /**
  90  * struct komeda_crtc_state
  91  */
  92 struct komeda_crtc_state {
  93         /** @base: &drm_crtc_state */
  94         struct drm_crtc_state base;
  95
  96         /* private properties */
  97
  98         /* computed state which are used by validate/check */
  99         /**
 100          * @affected_pipes:
 101          * the affected pipelines in once display instance
 102          */
 103         u32 affected_pipes;
 104         /**
 105          * @active_pipes:
 106          * the active pipelines in once display instance
 107          */
 108         u32 active_pipes;
 109
 110         /** @clock_ratio: ratio of (aclk << 32)/pxlclk */
 111         u64 clock_ratio;
 112
 113         /** @max_slave_zorder: the maximum of slave zorder */
 114         u32 max_slave_zorder;
 115 };
 116
 117 /** struct komeda_kms_dev - for gather KMS related things */
 118 struct komeda_kms_dev {
 119         /** @base: &drm_device */
 120         struct drm_device base;
 121
 122         /** @n_crtcs: valid numbers of crtcs in &komeda_kms_dev.crtcs */
 123         int n_crtcs;
 124         /** @crtcs: crtcs list */
 125         struct komeda_crtc crtcs[KOMEDA_MAX_PIPELINES];
 126 };
 127
 128 #define to_kplane(p)    container_of(p, struct komeda_plane, base)
 129 #define to_kplane_st(p) container_of(p, struct komeda_plane_state, base)
 130 #define to_kconn(p)     container_of(p, struct komeda_wb_connector, base)
 131 #define to_kcrtc(p)     container_of(p, struct komeda_crtc, base)
 132 #define to_kcrtc_st(p)  container_of(p, struct komeda_crtc_state, base)
 133 #define to_kdev(p)      container_of(p, struct komeda_kms_dev, base)
 134 #define to_wb_conn(x)   container_of(x, struct drm_writeback_connector, base)
 135
 136 static inline bool is_writeback_only(struct drm_crtc_state *st)
 137 {
 138         struct komeda_wb_connector *wb_conn = to_kcrtc(st->crtc)->wb_conn;
 139         struct drm_connector *conn = wb_conn ? &wb_conn->base.base : NULL;
 140
 141         return conn && (st->connector_mask == BIT(drm_connector_index(conn)));
 142 }
 143
 144 static inline bool
 145 is_only_changed_connector(struct drm_crtc_state *st, struct drm_connector *conn)
 146 {
 147         struct drm_crtc_state *old_st;
 148         u32 changed_connectors;
 149
 150         old_st = drm_atomic_get_old_crtc_state(st->state, st->crtc);
 151         changed_connectors = st->connector_mask ^ old_st->connector_mask;
 152
 153         return BIT(drm_connector_index(conn)) == changed_connectors;
 154 }
 155
 156 static inline bool has_flip_h(u32 rot)
 157 {
 158         u32 rotation = drm_rotation_simplify(rot,
 159                                              DRM_MODE_ROTATE_0 |
 160                                              DRM_MODE_ROTATE_90 |
 161                                              DRM_MODE_REFLECT_MASK);
 162
 163         if (rotation & DRM_MODE_ROTATE_90)
 164                 return !!(rotation & DRM_MODE_REFLECT_Y);
 165         else
 166                 return !!(rotation & DRM_MODE_REFLECT_X);
 167 }
 168
 169 void komeda_crtc_get_color_config(struct drm_crtc_state *crtc_st,
 170                                   u32 *color_depths, u32 *color_formats);
 171 unsigned long komeda_crtc_get_aclk(struct komeda_crtc_state *kcrtc_st);
 172
 173 int komeda_kms_setup_crtcs(struct komeda_kms_dev *kms, struct komeda_dev *mdev);
 174
 175 int komeda_kms_add_crtcs(struct komeda_kms_dev *kms, struct komeda_dev *mdev);
 176 int komeda_kms_add_planes(struct komeda_kms_dev *kms, struct komeda_dev *mdev);
 177 int komeda_kms_add_private_objs(struct komeda_kms_dev *kms,
 178                                 struct komeda_dev *mdev);
 179 int komeda_kms_add_wb_connectors(struct komeda_kms_dev *kms,
 180                                  struct komeda_dev *mdev);
 181 void komeda_kms_cleanup_private_objs(struct komeda_kms_dev *kms);
 182
 183 void komeda_crtc_handle_event(struct komeda_crtc   *kcrtc,
 184                               struct komeda_events *evts);
 185
 186 struct komeda_kms_dev *komeda_kms_attach(struct komeda_dev *mdev);
 187 void komeda_kms_detach(struct komeda_kms_dev *kms);
 188
 189 #endif /*_KOMEDA_KMS_H_*/