drivers/gpu/drm/msm/disp/dpu1/dpu_hw_intf.h

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /* Copyright (c) 2015-2018, The Linux Foundation. All rights reserved.
   3  */
   4
   5 #ifndef _DPU_HW_INTF_H
   6 #define _DPU_HW_INTF_H
   7
   8 #include "dpu_hw_catalog.h"
   9 #include "dpu_hw_mdss.h"
  10 #include "dpu_hw_util.h"
  11 #include "dpu_hw_blk.h"
  12
  13 struct dpu_hw_intf;
  14
  15 /* intf timing settings */
  16 struct intf_timing_params {
  17         u32 width;              /* active width */
  18         u32 height;             /* active height */
  19         u32 xres;               /* Display panel width */
  20         u32 yres;               /* Display panel height */
  21
  22         u32 h_back_porch;
  23         u32 h_front_porch;
  24         u32 v_back_porch;
  25         u32 v_front_porch;
  26         u32 hsync_pulse_width;
  27         u32 vsync_pulse_width;
  28         u32 hsync_polarity;
  29         u32 vsync_polarity;
  30         u32 border_clr;
  31         u32 underflow_clr;
  32         u32 hsync_skew;
  33 };
  34
  35 struct intf_prog_fetch {
  36         u8 enable;
  37         /* vsync counter for the front porch pixel line */
  38         u32 fetch_start;
  39 };
  40
  41 struct intf_status {
  42         u8 is_en;               /* interface timing engine is enabled or not */
  43         u32 frame_count;        /* frame count since timing engine enabled */
  44         u32 line_count;         /* current line count including blanking */
  45 };
  46
  47 /**
  48  * struct dpu_hw_intf_ops : Interface to the interface Hw driver functions
  49  *  Assumption is these functions will be called after clocks are enabled
  50  * @ setup_timing_gen : programs the timing engine
  51  * @ setup_prog_fetch : enables/disables the programmable fetch logic
  52  * @ enable_timing: enable/disable timing engine
  53  * @ get_status: returns if timing engine is enabled or not
  54  * @ get_line_count: reads current vertical line counter
  55  */
  56 struct dpu_hw_intf_ops {
  57         void (*setup_timing_gen)(struct dpu_hw_intf *intf,
  58                         const struct intf_timing_params *p,
  59                         const struct dpu_format *fmt);
  60
  61         void (*setup_prg_fetch)(struct dpu_hw_intf *intf,
  62                         const struct intf_prog_fetch *fetch);
  63
  64         void (*enable_timing)(struct dpu_hw_intf *intf,
  65                         u8 enable);
  66
  67         void (*get_status)(struct dpu_hw_intf *intf,
  68                         struct intf_status *status);
  69
  70         u32 (*get_line_count)(struct dpu_hw_intf *intf);
  71 };
  72
  73 struct dpu_hw_intf {
  74         struct dpu_hw_blk base;
  75         struct dpu_hw_blk_reg_map hw;
  76
  77         /* intf */
  78         enum dpu_intf idx;
  79         const struct dpu_intf_cfg *cap;
  80         const struct dpu_mdss_cfg *mdss;
  81
  82         /* ops */
  83         struct dpu_hw_intf_ops ops;
  84 };
  85
  86 /**
  87  * dpu_hw_intf_init(): Initializes the intf driver for the passed
  88  * interface idx.
  89  * @idx:  interface index for which driver object is required
  90  * @addr: mapped register io address of MDP
  91  * @m :   pointer to mdss catalog data
  92  */
  93 struct dpu_hw_intf *dpu_hw_intf_init(enum dpu_intf idx,
  94                 void __iomem *addr,
  95                 struct dpu_mdss_cfg *m);
  96
  97 /**
  98  * dpu_hw_intf_destroy(): Destroys INTF driver context
  99  * @intf:   Pointer to INTF driver context
 100  */
 101 void dpu_hw_intf_destroy(struct dpu_hw_intf *intf);
 102
 103 #endif /*_DPU_HW_INTF_H */