1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* 3 * Copyright (c) 2015-2018, The Linux Foundation. All rights reserved. 4 * Copyright (C) 2013 Red Hat 5 * Author: Rob Clark <robdclark@gmail.com> 6 */ 7 8 #ifndef __DPU_ENCODER_H__ 9 #define __DPU_ENCODER_H__ 10 11 #include <drm/drm_crtc.h> 12 #include "dpu_hw_mdss.h" 13 14 #define DPU_ENCODER_FRAME_EVENT_DONE BIT(0) 15 #define DPU_ENCODER_FRAME_EVENT_ERROR BIT(1) 16 #define DPU_ENCODER_FRAME_EVENT_PANEL_DEAD BIT(2) 17 #define DPU_ENCODER_FRAME_EVENT_IDLE BIT(3) 18 19 #define IDLE_TIMEOUT (66 - 16/2) 20 21 /** 22 * Encoder functions and data types 23 * @intfs: Interfaces this encoder is using, INTF_MODE_NONE if unused 24 */ 25 struct dpu_encoder_hw_resources { 26 enum dpu_intf_mode intfs[INTF_MAX]; 27 }; 28 29 /** 30 * dpu_encoder_get_hw_resources - Populate table of required hardware resources 31 * @encoder: encoder pointer 32 * @hw_res: resource table to populate with encoder required resources 33 */ 34 void dpu_encoder_get_hw_resources(struct drm_encoder *encoder, 35 struct dpu_encoder_hw_resources *hw_res); 36 37 /** 38 * dpu_encoder_assign_crtc - Link the encoder to the crtc it's assigned to 39 * @encoder: encoder pointer 40 * @crtc: crtc pointer 41 */ 42 void dpu_encoder_assign_crtc(struct drm_encoder *encoder, 43 struct drm_crtc *crtc); 44 45 /** 46 * dpu_encoder_toggle_vblank_for_crtc - Toggles vblank interrupts on or off if 47 * the encoder is assigned to the given crtc 48 * @encoder: encoder pointer 49 * @crtc: crtc pointer 50 * @enable: true if vblank should be enabled 51 */ 52 void dpu_encoder_toggle_vblank_for_crtc(struct drm_encoder *encoder, 53 struct drm_crtc *crtc, bool enable); 54 55 /** 56 * dpu_encoder_register_frame_event_callback - provide callback to encoder that 57 * will be called after the request is complete, or other events. 58 * @encoder: encoder pointer 59 * @cb: callback pointer, provide NULL to deregister 60 * @data: user data provided to callback 61 */ 62 void dpu_encoder_register_frame_event_callback(struct drm_encoder *encoder, 63 void (*cb)(void *, u32), void *data); 64 65 /** 66 * dpu_encoder_prepare_for_kickoff - schedule double buffer flip of the ctl 67 * path (i.e. ctl flush and start) at next appropriate time. 68 * Immediately: if no previous commit is outstanding. 69 * Delayed: Block until next trigger can be issued. 70 * @encoder: encoder pointer 71 * @async: true if this is an asynchronous commit 72 */ 73 void dpu_encoder_prepare_for_kickoff(struct drm_encoder *encoder, bool async); 74 75 /** 76 * dpu_encoder_trigger_kickoff_pending - Clear the flush bits from previous 77 * kickoff and trigger the ctl prepare progress for command mode display. 78 * @encoder: encoder pointer 79 */ 80 void dpu_encoder_trigger_kickoff_pending(struct drm_encoder *encoder); 81 82 /** 83 * dpu_encoder_kickoff - trigger a double buffer flip of the ctl path 84 * (i.e. ctl flush and start) immediately. 85 * @encoder: encoder pointer 86 * @async: true if this is an asynchronous commit 87 */ 88 void dpu_encoder_kickoff(struct drm_encoder *encoder, bool async); 89 90 /** 91 * dpu_encoder_wait_for_event - Waits for encoder events 92 * @encoder: encoder pointer 93 * @event: event to wait for 94 * MSM_ENC_COMMIT_DONE - Wait for hardware to have flushed the current pending 95 * frames to hardware at a vblank or ctl_start 96 * Encoders will map this differently depending on the 97 * panel type. 98 * vid mode -> vsync_irq 99 * cmd mode -> ctl_start 100 * MSM_ENC_TX_COMPLETE - Wait for the hardware to transfer all the pixels to 101 * the panel. Encoders will map this differently 102 * depending on the panel type. 103 * vid mode -> vsync_irq 104 * cmd mode -> pp_done 105 * Returns: 0 on success, -EWOULDBLOCK if already signaled, error otherwise 106 */ 107 int dpu_encoder_wait_for_event(struct drm_encoder *drm_encoder, 108 enum msm_event_wait event); 109 110 /* 111 * dpu_encoder_get_intf_mode - get interface mode of the given encoder 112 * @encoder: Pointer to drm encoder object 113 */ 114 enum dpu_intf_mode dpu_encoder_get_intf_mode(struct drm_encoder *encoder); 115 116 /** 117 * dpu_encoder_virt_runtime_resume - pm runtime resume the encoder configs 118 * @encoder: encoder pointer 119 */ 120 void dpu_encoder_virt_runtime_resume(struct drm_encoder *encoder); 121 122 /** 123 * dpu_encoder_init - initialize virtual encoder object 124 * @dev: Pointer to drm device structure 125 * @disp_info: Pointer to display information structure 126 * Returns: Pointer to newly created drm encoder 127 */ 128 struct drm_encoder *dpu_encoder_init( 129 struct drm_device *dev, 130 int drm_enc_mode); 131 132 /** 133 * dpu_encoder_setup - setup dpu_encoder for the display probed 134 * @dev: Pointer to drm device structure 135 * @enc: Pointer to the drm_encoder 136 * @disp_info: Pointer to the display info 137 */ 138 int dpu_encoder_setup(struct drm_device *dev, struct drm_encoder *enc, 139 struct msm_display_info *disp_info); 140 141 /** 142 * dpu_encoder_prepare_commit - prepare encoder at the very beginning of an 143 * atomic commit, before any registers are written 144 * @drm_enc: Pointer to previously created drm encoder structure 145 */ 146 void dpu_encoder_prepare_commit(struct drm_encoder *drm_enc); 147 148 /** 149 * dpu_encoder_set_idle_timeout - set the idle timeout for video 150 * and command mode encoders. 151 * @drm_enc: Pointer to previously created drm encoder structure 152 * @idle_timeout: idle timeout duration in milliseconds 153 */ 154 void dpu_encoder_set_idle_timeout(struct drm_encoder *drm_enc, 155 u32 idle_timeout); 156 157 #endif /* __DPU_ENCODER_H__ */ 158