2 * Copyright 2012-15 Advanced Micro Devices, Inc.
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:
11 * The above copyright notice and this permission notice shall be included in
12 * all copies or substantial portions of the Software.
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.
26 #ifndef __DAL_TIMING_GENERATOR_TYPES_H__
27 #define __DAL_TIMING_GENERATOR_TYPES_H__
29 #include "hw_shared.h"
33 /* Contains CRTC vertical/horizontal pixel counters */
34 struct crtc_position {
35 int32_t vertical_count;
36 int32_t horizontal_count;
37 int32_t nominal_vcount;
40 struct dcp_gsl_params {
51 int master_update_lock_gsl_en;
52 int gsl_window_start_x;
54 int gsl_window_start_y;
58 /* define the structure of Dynamic Refresh Mode */
60 uint32_t vertical_total_min;
61 uint32_t vertical_total_max;
62 uint32_t vertical_total_mid;
63 uint32_t vertical_total_mid_frame_num;
67 #define LEFT_EYE_3D_PRIMARY_SURFACE 1
68 #define RIGHT_EYE_3D_PRIMARY_SURFACE 0
71 CRTC_STATE_VBLANK = 0,
75 struct vupdate_keepout_params {
81 struct crtc_stereo_flags {
82 uint8_t PROGRAM_STEREO : 1;
83 uint8_t PROGRAM_POLARITY : 1;
84 uint8_t RIGHT_EYE_POLARITY : 1;
85 uint8_t FRAME_PACKED : 1;
86 uint8_t DISABLE_STEREO_DP_SYNC : 1;
90 /* Order must match values expected by hardware */
94 UNION_WINDOW_NOT_A_NOT_B,
96 INTERSECT_WINDOW_A_NOT_B,
97 INTERSECT_WINDOW_NOT_A_B,
98 INTERSECT_WINDOW_NOT_A_NOT_B,
101 enum otg_out_mux_dest {
106 enum h_timing_div_mode {
113 enum timing_synchronization_type {
115 TIMING_SYNCHRONIZABLE,
116 VBLANK_SYNCHRONIZABLE
120 /* Regions used to calculate CRC*/
121 uint16_t windowa_x_start;
122 uint16_t windowa_x_end;
123 uint16_t windowa_y_start;
124 uint16_t windowa_y_end;
126 uint16_t windowb_x_start;
127 uint16_t windowb_x_end;
128 uint16_t windowb_y_start;
129 uint16_t windowb_y_end;
131 enum crc_selection selection;
136 bool continuous_mode;
140 struct timing_generator {
141 const struct timing_generator_funcs *funcs;
143 struct dc_context *ctx;
147 struct dc_crtc_timing;
152 struct timing_generator_funcs {
153 bool (*validate_timing)(struct timing_generator *tg,
154 const struct dc_crtc_timing *timing);
155 void (*program_timing)(struct timing_generator *tg,
156 const struct dc_crtc_timing *timing,
161 const enum signal_type signal,
164 void (*setup_vertical_interrupt0)(
165 struct timing_generator *optc,
168 void (*setup_vertical_interrupt1)(
169 struct timing_generator *optc,
170 uint32_t start_line);
171 void (*setup_vertical_interrupt2)(
172 struct timing_generator *optc,
173 uint32_t start_line);
175 bool (*enable_crtc)(struct timing_generator *tg);
176 bool (*disable_crtc)(struct timing_generator *tg);
177 #ifdef CONFIG_DRM_AMD_DC_DCN
178 void (*phantom_crtc_post_enable)(struct timing_generator *tg);
180 bool (*immediate_disable_crtc)(struct timing_generator *tg);
181 bool (*is_counter_moving)(struct timing_generator *tg);
182 void (*get_position)(struct timing_generator *tg,
183 struct crtc_position *position);
185 uint32_t (*get_frame_count)(struct timing_generator *tg);
186 void (*get_scanoutpos)(
187 struct timing_generator *tg,
188 uint32_t *v_blank_start,
189 uint32_t *v_blank_end,
190 uint32_t *h_position,
191 uint32_t *v_position);
192 bool (*get_otg_active_size)(struct timing_generator *optc,
193 uint32_t *otg_active_width,
194 uint32_t *otg_active_height);
195 bool (*is_matching_timing)(struct timing_generator *tg,
196 const struct dc_crtc_timing *otg_timing);
197 void (*set_early_control)(struct timing_generator *tg,
198 uint32_t early_cntl);
199 void (*wait_for_state)(struct timing_generator *tg,
200 enum crtc_state state);
201 void (*set_blank)(struct timing_generator *tg,
202 bool enable_blanking);
203 bool (*is_blanked)(struct timing_generator *tg);
204 bool (*is_locked)(struct timing_generator *tg);
205 void (*set_overscan_blank_color) (struct timing_generator *tg, const struct tg_color *color);
206 void (*set_blank_color)(struct timing_generator *tg, const struct tg_color *color);
207 void (*set_colors)(struct timing_generator *tg,
208 const struct tg_color *blank_color,
209 const struct tg_color *overscan_color);
211 void (*disable_vga)(struct timing_generator *tg);
212 bool (*did_triggered_reset_occur)(struct timing_generator *tg);
213 void (*setup_global_swap_lock)(struct timing_generator *tg,
214 const struct dcp_gsl_params *gsl_params);
215 void (*unlock)(struct timing_generator *tg);
216 void (*lock)(struct timing_generator *tg);
217 void (*lock_doublebuffer_disable)(struct timing_generator *tg);
218 void (*lock_doublebuffer_enable)(struct timing_generator *tg);
219 void(*triplebuffer_unlock)(struct timing_generator *tg);
220 void(*triplebuffer_lock)(struct timing_generator *tg);
221 void (*enable_reset_trigger)(struct timing_generator *tg,
223 void (*enable_crtc_reset)(struct timing_generator *tg,
225 struct crtc_trigger_info *crtc_tp);
226 void (*disable_reset_trigger)(struct timing_generator *tg);
227 void (*tear_down_global_swap_lock)(struct timing_generator *tg);
228 void (*enable_advanced_request)(struct timing_generator *tg,
229 bool enable, const struct dc_crtc_timing *timing);
230 void (*set_drr)(struct timing_generator *tg, const struct drr_params *params);
231 void (*set_vtotal_min_max)(struct timing_generator *optc, int vtotal_min, int vtotal_max);
232 void (*get_last_used_drr_vtotal)(struct timing_generator *optc, uint32_t *refresh_rate);
233 void (*set_static_screen_control)(struct timing_generator *tg,
234 uint32_t event_triggers,
235 uint32_t num_frames);
236 void (*set_test_pattern)(
237 struct timing_generator *tg,
238 enum controller_dp_test_pattern test_pattern,
239 enum dc_color_depth color_depth);
241 bool (*arm_vert_intr)(struct timing_generator *tg, uint8_t width);
243 void (*program_global_sync)(struct timing_generator *tg,
248 void (*enable_optc_clock)(struct timing_generator *tg, bool enable);
249 void (*program_stereo)(struct timing_generator *tg,
250 const struct dc_crtc_timing *timing, struct crtc_stereo_flags *flags);
251 bool (*is_stereo_left_eye)(struct timing_generator *tg);
253 void (*set_blank_data_double_buffer)(struct timing_generator *tg, bool enable);
255 void (*tg_init)(struct timing_generator *tg);
256 bool (*is_tg_enabled)(struct timing_generator *tg);
257 bool (*is_optc_underflow_occurred)(struct timing_generator *tg);
258 void (*clear_optc_underflow)(struct timing_generator *tg);
260 void (*set_dwb_source)(struct timing_generator *optc,
261 uint32_t dwb_pipe_inst);
263 void (*get_optc_source)(struct timing_generator *optc,
264 uint32_t *num_of_input_segments,
265 uint32_t *seg0_src_sel,
266 uint32_t *seg1_src_sel);
269 * Configure CRCs for the given timing generator. Return false if TG is
272 bool (*configure_crc)(struct timing_generator *tg,
273 const struct crc_params *params);
276 * Get CRCs for the given timing generator. Return false if CRCs are
277 * not enabled (via configure_crc).
279 bool (*get_crc)(struct timing_generator *tg,
280 uint32_t *r_cr, uint32_t *g_y, uint32_t *b_cb);
282 void (*program_manual_trigger)(struct timing_generator *optc);
283 void (*setup_manual_trigger)(struct timing_generator *optc);
284 bool (*get_hw_timing)(struct timing_generator *optc,
285 struct dc_crtc_timing *hw_crtc_timing);
287 void (*set_vtg_params)(struct timing_generator *optc,
288 const struct dc_crtc_timing *dc_crtc_timing, bool program_fp2);
290 void (*set_dsc_config)(struct timing_generator *optc,
291 enum optc_dsc_mode dsc_mode,
292 uint32_t dsc_bytes_per_pixel,
293 uint32_t dsc_slice_width);
294 void (*get_dsc_status)(struct timing_generator *optc,
296 void (*set_odm_bypass)(struct timing_generator *optc, const struct dc_crtc_timing *dc_crtc_timing);
297 void (*set_odm_combine)(struct timing_generator *optc, int *opp_id, int opp_cnt,
298 struct dc_crtc_timing *timing);
299 void (*set_h_timing_div_manual_mode)(struct timing_generator *optc, bool manual_mode);
300 void (*set_gsl)(struct timing_generator *optc, const struct gsl_params *params);
301 void (*set_gsl_source_select)(struct timing_generator *optc,
303 uint32_t gsl_ready_signal);
304 void (*set_out_mux)(struct timing_generator *tg, enum otg_out_mux_dest dest);
305 void (*set_vrr_m_const)(struct timing_generator *optc,
307 void (*set_drr_trigger_window)(struct timing_generator *optc,
308 uint32_t window_start, uint32_t window_end);
309 void (*set_vtotal_change_limit)(struct timing_generator *optc,
311 void (*align_vblanks)(struct timing_generator *master_optc,
312 struct timing_generator *slave_optc,
313 uint32_t master_pixel_clock_100Hz,
314 uint32_t slave_pixel_clock_100Hz,
315 uint8_t master_clock_divider,
316 uint8_t slave_clock_divider);
317 bool (*validate_vmin_vmax)(struct timing_generator *optc,
319 bool (*validate_vtotal_change_limit)(struct timing_generator *optc,
320 uint32_t vtotal_change_limit);
322 void (*init_odm)(struct timing_generator *tg);