1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* 3 * Copyright (C) 2012 Texas Instruments 4 * Author: Rob Clark <robdclark@gmail.com> 5 */ 6 7 #ifndef __TILCDC_DRV_H__ 8 #define __TILCDC_DRV_H__ 9 10 #include <linux/cpufreq.h> 11 #include <linux/irqreturn.h> 12 13 #include <drm/drm_print.h> 14 15 struct clk; 16 struct workqueue_struct; 17 18 struct drm_connector; 19 struct drm_connector_helper_funcs; 20 struct drm_crtc; 21 struct drm_device; 22 struct drm_display_mode; 23 struct drm_encoder; 24 struct drm_framebuffer; 25 struct drm_minor; 26 struct drm_pending_vblank_event; 27 struct drm_plane; 28 29 /* Defaulting to pixel clock defined on AM335x */ 30 #define TILCDC_DEFAULT_MAX_PIXELCLOCK 126000 31 /* Maximum display width for LCDC V1 */ 32 #define TILCDC_DEFAULT_MAX_WIDTH_V1 1024 33 /* ... and for LCDC V2 found on AM335x: */ 34 #define TILCDC_DEFAULT_MAX_WIDTH_V2 2048 35 /* 36 * This may need some tweaking, but want to allow at least 1280x1024@60 37 * with optimized DDR & EMIF settings tweaked 1920x1080@24 appears to 38 * be supportable 39 */ 40 #define TILCDC_DEFAULT_MAX_BANDWIDTH (1280*1024*60) 41 42 43 struct tilcdc_drm_private { 44 void __iomem *mmio; 45 46 struct clk *clk; /* functional clock */ 47 int rev; /* IP revision */ 48 49 unsigned int irq; 50 51 /* don't attempt resolutions w/ higher W * H * Hz: */ 52 uint32_t max_bandwidth; 53 /* 54 * Pixel Clock will be restricted to some value as 55 * defined in the device datasheet measured in KHz 56 */ 57 uint32_t max_pixelclock; 58 /* 59 * Max allowable width is limited on a per device basis 60 * measured in pixels 61 */ 62 uint32_t max_width; 63 64 /* Supported pixel formats */ 65 const uint32_t *pixelformats; 66 uint32_t num_pixelformats; 67 68 #ifdef CONFIG_CPU_FREQ 69 struct notifier_block freq_transition; 70 #endif 71 72 struct workqueue_struct *wq; 73 74 struct drm_crtc *crtc; 75 76 unsigned int num_encoders; 77 struct drm_encoder *encoders[8]; 78 79 unsigned int num_connectors; 80 struct drm_connector *connectors[8]; 81 82 struct drm_encoder *external_encoder; 83 struct drm_connector *external_connector; 84 85 bool is_componentized; 86 bool irq_enabled; 87 }; 88 89 /* Sub-module for display. Since we don't know at compile time what panels 90 * or display adapter(s) might be present (for ex, off chip dvi/tfp410, 91 * hdmi encoder, various lcd panels), the connector/encoder(s) are split into 92 * separate drivers. If they are probed and found to be present, they 93 * register themselves with tilcdc_register_module(). 94 */ 95 struct tilcdc_module; 96 97 struct tilcdc_module_ops { 98 /* create appropriate encoders/connectors: */ 99 int (*modeset_init)(struct tilcdc_module *mod, struct drm_device *dev); 100 #ifdef CONFIG_DEBUG_FS 101 /* create debugfs nodes (can be NULL): */ 102 int (*debugfs_init)(struct tilcdc_module *mod, struct drm_minor *minor); 103 #endif 104 }; 105 106 struct tilcdc_module { 107 const char *name; 108 struct list_head list; 109 const struct tilcdc_module_ops *funcs; 110 }; 111 112 void tilcdc_module_init(struct tilcdc_module *mod, const char *name, 113 const struct tilcdc_module_ops *funcs); 114 void tilcdc_module_cleanup(struct tilcdc_module *mod); 115 116 /* Panel config that needs to be set in the crtc, but is not coming from 117 * the mode timings. The display module is expected to call 118 * tilcdc_crtc_set_panel_info() to set this during modeset. 119 */ 120 struct tilcdc_panel_info { 121 122 /* AC Bias Pin Frequency */ 123 uint32_t ac_bias; 124 125 /* AC Bias Pin Transitions per Interrupt */ 126 uint32_t ac_bias_intrpt; 127 128 /* DMA burst size */ 129 uint32_t dma_burst_sz; 130 131 /* Bits per pixel */ 132 uint32_t bpp; 133 134 /* FIFO DMA Request Delay */ 135 uint32_t fdd; 136 137 /* TFT Alternative Signal Mapping (Only for active) */ 138 bool tft_alt_mode; 139 140 /* Invert pixel clock */ 141 bool invert_pxl_clk; 142 143 /* Horizontal and Vertical Sync Edge: 0=rising 1=falling */ 144 uint32_t sync_edge; 145 146 /* Horizontal and Vertical Sync: Control: 0=ignore */ 147 uint32_t sync_ctrl; 148 149 /* Raster Data Order Select: 1=Most-to-least 0=Least-to-most */ 150 uint32_t raster_order; 151 152 /* DMA FIFO threshold */ 153 uint32_t fifo_th; 154 }; 155 156 #define DBG(fmt, ...) DRM_DEBUG(fmt"\n", ##__VA_ARGS__) 157 158 int tilcdc_crtc_create(struct drm_device *dev); 159 irqreturn_t tilcdc_crtc_irq(struct drm_crtc *crtc); 160 void tilcdc_crtc_update_clk(struct drm_crtc *crtc); 161 void tilcdc_crtc_set_panel_info(struct drm_crtc *crtc, 162 const struct tilcdc_panel_info *info); 163 void tilcdc_crtc_set_simulate_vesa_sync(struct drm_crtc *crtc, 164 bool simulate_vesa_sync); 165 void tilcdc_crtc_shutdown(struct drm_crtc *crtc); 166 void tilcdc_crtc_destroy(struct drm_crtc *crtc); 167 int tilcdc_crtc_update_fb(struct drm_crtc *crtc, 168 struct drm_framebuffer *fb, 169 struct drm_pending_vblank_event *event); 170 171 int tilcdc_plane_init(struct drm_device *dev, struct drm_plane *plane); 172 173 #endif /* __TILCDC_DRV_H__ */ 174