include/drm/drm_simple_kms_helper.h

   1 /*
   2  * Copyright (C) 2016 Noralf Trønnes
   3  *
   4  * This program is free software; you can redistribute it and/or modify
   5  * it under the terms of the GNU General Public License as published by
   6  * the Free Software Foundation; either version 2 of the License, or
   7  * (at your option) any later version.
   8  */
   9
  10 #ifndef __LINUX_DRM_SIMPLE_KMS_HELPER_H
  11 #define __LINUX_DRM_SIMPLE_KMS_HELPER_H
  12
  13 struct drm_simple_display_pipe;
  14
  15 /**
  16  * struct drm_simple_display_pipe_funcs - helper operations for a simple
  17  *                                        display pipeline
  18  */
  19 struct drm_simple_display_pipe_funcs {
  20         /**
  21          * @enable:
  22          *
  23          * This function should be used to enable the pipeline.
  24          * It is called when the underlying crtc is enabled.
  25          * This hook is optional.
  26          */
  27         void (*enable)(struct drm_simple_display_pipe *pipe,
  28                        struct drm_crtc_state *crtc_state);
  29         /**
  30          * @disable:
  31          *
  32          * This function should be used to disable the pipeline.
  33          * It is called when the underlying crtc is disabled.
  34          * This hook is optional.
  35          */
  36         void (*disable)(struct drm_simple_display_pipe *pipe);
  37
  38         /**
  39          * @check:
  40          *
  41          * This function is called in the check phase of an atomic update,
  42          * specifically when the underlying plane is checked.
  43          * The simple display pipeline helpers already check that the plane is
  44          * not scaled, fills the entire visible area and is always enabled
  45          * when the crtc is also enabled.
  46          * This hook is optional.
  47          *
  48          * RETURNS:
  49          *
  50          * 0 on success, -EINVAL if the state or the transition can't be
  51          * supported, -ENOMEM on memory allocation failure and -EDEADLK if an
  52          * attempt to obtain another state object ran into a &drm_modeset_lock
  53          * deadlock.
  54          */
  55         int (*check)(struct drm_simple_display_pipe *pipe,
  56                      struct drm_plane_state *plane_state,
  57                      struct drm_crtc_state *crtc_state);
  58         /**
  59          * @update:
  60          *
  61          * This function is called when the underlying plane state is updated.
  62          * This hook is optional.
  63          *
  64          * This is the function drivers should submit the
  65          * &drm_pending_vblank_event from. Using either
  66          * drm_crtc_arm_vblank_event(), when the driver supports vblank
  67          * interrupt handling, or drm_crtc_send_vblank_event() directly in case
  68          * the hardware lacks vblank support entirely.
  69          */
  70         void (*update)(struct drm_simple_display_pipe *pipe,
  71                        struct drm_plane_state *plane_state);
  72 };
  73
  74 /**
  75  * struct drm_simple_display_pipe - simple display pipeline
  76  * @crtc: CRTC control structure
  77  * @plane: Plane control structure
  78  * @encoder: Encoder control structure
  79  * @connector: Connector control structure
  80  * @funcs: Pipeline control functions (optional)
  81  *
  82  * Simple display pipeline with plane, crtc and encoder collapsed into one
  83  * entity. It should be initialized by calling drm_simple_display_pipe_init().
  84  */
  85 struct drm_simple_display_pipe {
  86         struct drm_crtc crtc;
  87         struct drm_plane plane;
  88         struct drm_encoder encoder;
  89         struct drm_connector *connector;
  90
  91         const struct drm_simple_display_pipe_funcs *funcs;
  92 };
  93
  94 int drm_simple_display_pipe_attach_bridge(struct drm_simple_display_pipe *pipe,
  95                                           struct drm_bridge *bridge);
  96
  97 void drm_simple_display_pipe_detach_bridge(struct drm_simple_display_pipe *pipe);
  98
  99 int drm_simple_display_pipe_init(struct drm_device *dev,
 100                         struct drm_simple_display_pipe *pipe,
 101                         const struct drm_simple_display_pipe_funcs *funcs,
 102                         const uint32_t *formats, unsigned int format_count,
 103                         struct drm_connector *connector);
 104
 105 #endif /* __LINUX_DRM_SIMPLE_KMS_HELPER_H */