1 /* 2 * Copyright 2015 Advanced Micro Devices, Inc. 3 * 4 * Permission is hereby granted, free of charge, to any person obtaining a 5 * copy of this software and associated documentation files (the "Software"), 6 * to deal in the Software without restriction, including without limitation 7 * the rights to use, copy, modify, merge, publish, distribute, sublicense, 8 * and/or sell copies of the Software, and to permit persons to whom the 9 * Software is furnished to do so, subject to the following conditions: 10 * 11 * The above copyright notice and this permission notice shall be included in 12 * all copies or substantial portions of the Software. 13 * 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 17 * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR 18 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, 19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR 20 * OTHER DEALINGS IN THE SOFTWARE. 21 * 22 * Authors: AMD 23 * 24 */ 25 26 #ifndef __DC_HW_SEQUENCER_H__ 27 #define __DC_HW_SEQUENCER_H__ 28 #include "dc_types.h" 29 #include "clock_source.h" 30 #include "inc/hw/timing_generator.h" 31 #include "inc/hw/opp.h" 32 #include "inc/hw/link_encoder.h" 33 #include "core_status.h" 34 35 enum vline_select { 36 VLINE0, 37 VLINE1 38 }; 39 40 struct pipe_ctx; 41 struct dc_state; 42 struct dc_stream_status; 43 struct dc_writeback_info; 44 struct dchub_init_data; 45 struct dc_static_screen_params; 46 struct resource_pool; 47 struct dc_phy_addr_space_config; 48 struct dc_virtual_addr_space_config; 49 struct dpp; 50 struct dce_hwseq; 51 52 struct hw_sequencer_funcs { 53 void (*hardware_release)(struct dc *dc); 54 /* Embedded Display Related */ 55 void (*edp_power_control)(struct dc_link *link, bool enable); 56 void (*edp_wait_for_hpd_ready)(struct dc_link *link, bool power_up); 57 void (*edp_wait_for_T12)(struct dc_link *link); 58 59 /* Pipe Programming Related */ 60 void (*init_hw)(struct dc *dc); 61 void (*power_down_on_boot)(struct dc *dc); 62 void (*enable_accelerated_mode)(struct dc *dc, 63 struct dc_state *context); 64 enum dc_status (*apply_ctx_to_hw)(struct dc *dc, 65 struct dc_state *context); 66 void (*disable_plane)(struct dc *dc, struct pipe_ctx *pipe_ctx); 67 void (*apply_ctx_for_surface)(struct dc *dc, 68 const struct dc_stream_state *stream, 69 int num_planes, struct dc_state *context); 70 void (*program_front_end_for_ctx)(struct dc *dc, 71 struct dc_state *context); 72 void (*wait_for_pending_cleared)(struct dc *dc, 73 struct dc_state *context); 74 void (*post_unlock_program_front_end)(struct dc *dc, 75 struct dc_state *context); 76 void (*update_plane_addr)(const struct dc *dc, 77 struct pipe_ctx *pipe_ctx); 78 void (*update_dchub)(struct dce_hwseq *hws, 79 struct dchub_init_data *dh_data); 80 void (*wait_for_mpcc_disconnect)(struct dc *dc, 81 struct resource_pool *res_pool, 82 struct pipe_ctx *pipe_ctx); 83 void (*edp_backlight_control)( 84 struct dc_link *link, 85 bool enable); 86 void (*program_triplebuffer)(const struct dc *dc, 87 struct pipe_ctx *pipe_ctx, bool enableTripleBuffer); 88 void (*update_pending_status)(struct pipe_ctx *pipe_ctx); 89 void (*power_down)(struct dc *dc); 90 91 /* Pipe Lock Related */ 92 void (*pipe_control_lock)(struct dc *dc, 93 struct pipe_ctx *pipe, bool lock); 94 void (*interdependent_update_lock)(struct dc *dc, 95 struct dc_state *context, bool lock); 96 void (*set_flip_control_gsl)(struct pipe_ctx *pipe_ctx, 97 bool flip_immediate); 98 void (*cursor_lock)(struct dc *dc, struct pipe_ctx *pipe, bool lock); 99 100 /* Timing Related */ 101 void (*get_position)(struct pipe_ctx **pipe_ctx, int num_pipes, 102 struct crtc_position *position); 103 int (*get_vupdate_offset_from_vsync)(struct pipe_ctx *pipe_ctx); 104 void (*calc_vupdate_position)( 105 struct dc *dc, 106 struct pipe_ctx *pipe_ctx, 107 uint32_t *start_line, 108 uint32_t *end_line); 109 void (*enable_per_frame_crtc_position_reset)(struct dc *dc, 110 int group_size, struct pipe_ctx *grouped_pipes[]); 111 void (*enable_timing_synchronization)(struct dc *dc, 112 int group_index, int group_size, 113 struct pipe_ctx *grouped_pipes[]); 114 void (*enable_vblanks_synchronization)(struct dc *dc, 115 int group_index, int group_size, 116 struct pipe_ctx *grouped_pipes[]); 117 void (*setup_periodic_interrupt)(struct dc *dc, 118 struct pipe_ctx *pipe_ctx, 119 enum vline_select vline); 120 void (*set_drr)(struct pipe_ctx **pipe_ctx, int num_pipes, 121 unsigned int vmin, unsigned int vmax, 122 unsigned int vmid, unsigned int vmid_frame_number); 123 void (*set_static_screen_control)(struct pipe_ctx **pipe_ctx, 124 int num_pipes, 125 const struct dc_static_screen_params *events); 126 #ifndef TRIM_FSFT 127 bool (*optimize_timing_for_fsft)(struct dc *dc, 128 struct dc_crtc_timing *timing, 129 unsigned int max_input_rate_in_khz); 130 #endif 131 132 /* Stream Related */ 133 void (*enable_stream)(struct pipe_ctx *pipe_ctx); 134 void (*disable_stream)(struct pipe_ctx *pipe_ctx); 135 void (*blank_stream)(struct pipe_ctx *pipe_ctx); 136 void (*unblank_stream)(struct pipe_ctx *pipe_ctx, 137 struct dc_link_settings *link_settings); 138 139 /* Bandwidth Related */ 140 void (*prepare_bandwidth)(struct dc *dc, struct dc_state *context); 141 bool (*update_bandwidth)(struct dc *dc, struct dc_state *context); 142 void (*optimize_bandwidth)(struct dc *dc, struct dc_state *context); 143 144 /* Infopacket Related */ 145 void (*set_avmute)(struct pipe_ctx *pipe_ctx, bool enable); 146 void (*send_immediate_sdp_message)( 147 struct pipe_ctx *pipe_ctx, 148 const uint8_t *custom_sdp_message, 149 unsigned int sdp_message_size); 150 void (*update_info_frame)(struct pipe_ctx *pipe_ctx); 151 void (*set_dmdata_attributes)(struct pipe_ctx *pipe); 152 void (*program_dmdata_engine)(struct pipe_ctx *pipe_ctx); 153 bool (*dmdata_status_done)(struct pipe_ctx *pipe_ctx); 154 155 /* Cursor Related */ 156 void (*set_cursor_position)(struct pipe_ctx *pipe); 157 void (*set_cursor_attribute)(struct pipe_ctx *pipe); 158 void (*set_cursor_sdr_white_level)(struct pipe_ctx *pipe); 159 160 /* Colour Related */ 161 void (*program_gamut_remap)(struct pipe_ctx *pipe_ctx); 162 void (*program_output_csc)(struct dc *dc, struct pipe_ctx *pipe_ctx, 163 enum dc_color_space colorspace, 164 uint16_t *matrix, int opp_id); 165 166 /* VM Related */ 167 int (*init_sys_ctx)(struct dce_hwseq *hws, 168 struct dc *dc, 169 struct dc_phy_addr_space_config *pa_config); 170 void (*init_vm_ctx)(struct dce_hwseq *hws, 171 struct dc *dc, 172 struct dc_virtual_addr_space_config *va_config, 173 int vmid); 174 175 /* Writeback Related */ 176 void (*update_writeback)(struct dc *dc, 177 struct dc_writeback_info *wb_info, 178 struct dc_state *context); 179 void (*enable_writeback)(struct dc *dc, 180 struct dc_writeback_info *wb_info, 181 struct dc_state *context); 182 void (*disable_writeback)(struct dc *dc, 183 unsigned int dwb_pipe_inst); 184 185 bool (*mmhubbub_warmup)(struct dc *dc, 186 unsigned int num_dwb, 187 struct dc_writeback_info *wb_info); 188 189 /* Clock Related */ 190 enum dc_status (*set_clock)(struct dc *dc, 191 enum dc_clock_type clock_type, 192 uint32_t clk_khz, uint32_t stepping); 193 void (*get_clock)(struct dc *dc, enum dc_clock_type clock_type, 194 struct dc_clock_config *clock_cfg); 195 void (*optimize_pwr_state)(const struct dc *dc, 196 struct dc_state *context); 197 void (*exit_optimized_pwr_state)(const struct dc *dc, 198 struct dc_state *context); 199 200 /* Audio Related */ 201 void (*enable_audio_stream)(struct pipe_ctx *pipe_ctx); 202 void (*disable_audio_stream)(struct pipe_ctx *pipe_ctx); 203 204 /* Stereo 3D Related */ 205 void (*setup_stereo)(struct pipe_ctx *pipe_ctx, struct dc *dc); 206 207 /* HW State Logging Related */ 208 void (*log_hw_state)(struct dc *dc, struct dc_log_buffer_ctx *log_ctx); 209 void (*get_hw_state)(struct dc *dc, char *pBuf, 210 unsigned int bufSize, unsigned int mask); 211 void (*clear_status_bits)(struct dc *dc, unsigned int mask); 212 213 bool (*set_backlight_level)(struct pipe_ctx *pipe_ctx, 214 uint32_t backlight_pwm_u16_16, 215 uint32_t frame_ramp); 216 217 void (*set_abm_immediate_disable)(struct pipe_ctx *pipe_ctx); 218 219 void (*set_pipe)(struct pipe_ctx *pipe_ctx); 220 221 /* Idle Optimization Related */ 222 bool (*apply_idle_power_optimizations)(struct dc *dc, bool enable); 223 224 bool (*does_plane_fit_in_mall)(struct dc *dc, struct dc_plane_state *plane, 225 struct dc_cursor_attributes *cursor_attr); 226 227 bool (*is_abm_supported)(struct dc *dc, 228 struct dc_state *context, struct dc_stream_state *stream); 229 230 void (*set_disp_pattern_generator)(const struct dc *dc, 231 struct pipe_ctx *pipe_ctx, 232 enum controller_dp_test_pattern test_pattern, 233 enum controller_dp_color_space color_space, 234 enum dc_color_depth color_depth, 235 const struct tg_color *solid_color, 236 int width, int height, int offset); 237 }; 238 239 void color_space_to_black_color( 240 const struct dc *dc, 241 enum dc_color_space colorspace, 242 struct tg_color *black_color); 243 244 bool hwss_wait_for_blank_complete( 245 struct timing_generator *tg); 246 247 const uint16_t *find_color_matrix( 248 enum dc_color_space color_space, 249 uint32_t *array_size); 250 251 #endif /* __DC_HW_SEQUENCER_H__ */ 252