]>
Commit | Line | Data |
---|---|---|
4562236b HW |
1 | /* |
2 | * Copyright 2012-14 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_INTERFACE_H_ | |
27 | #define DC_INTERFACE_H_ | |
28 | ||
29 | #include "dc_types.h" | |
4562236b HW |
30 | #include "grph_object_defs.h" |
31 | #include "logger_types.h" | |
32 | #include "gpio_types.h" | |
33 | #include "link_service_types.h" | |
34 | ||
091a97e5 | 35 | #define MAX_SURFACES 3 |
ab2541b6 | 36 | #define MAX_STREAMS 6 |
4562236b HW |
37 | #define MAX_SINKS_PER_LINK 4 |
38 | ||
39 | /******************************************************************************* | |
40 | * Display Core Interfaces | |
41 | ******************************************************************************/ | |
42 | ||
43 | struct dc_caps { | |
ab2541b6 | 44 | uint32_t max_streams; |
4562236b HW |
45 | uint32_t max_links; |
46 | uint32_t max_audios; | |
47 | uint32_t max_slave_planes; | |
d4e13b0d | 48 | uint32_t max_surfaces; |
4562236b HW |
49 | uint32_t max_downscale_ratio; |
50 | uint32_t i2c_speed_in_khz; | |
a37656b9 TC |
51 | |
52 | unsigned int max_cursor_size; | |
4562236b HW |
53 | }; |
54 | ||
55 | ||
56 | struct dc_dcc_surface_param { | |
57 | enum surface_pixel_format format; | |
58 | struct dc_size surface_size; | |
2c8ad2d5 | 59 | enum swizzle_mode_values swizzle_mode; |
4562236b HW |
60 | enum dc_scan_direction scan; |
61 | }; | |
62 | ||
63 | struct dc_dcc_setting { | |
64 | unsigned int max_compressed_blk_size; | |
65 | unsigned int max_uncompressed_blk_size; | |
66 | bool independent_64b_blks; | |
67 | }; | |
68 | ||
69 | struct dc_surface_dcc_cap { | |
70 | bool capable; | |
71 | bool const_color_support; | |
72 | ||
73 | union { | |
74 | struct { | |
75 | struct dc_dcc_setting rgb; | |
76 | } grph; | |
77 | ||
78 | struct { | |
79 | struct dc_dcc_setting luma; | |
80 | struct dc_dcc_setting chroma; | |
81 | } video; | |
82 | }; | |
83 | }; | |
84 | ||
94267b3d ST |
85 | struct dc_static_screen_events { |
86 | bool cursor_update; | |
87 | bool surface_update; | |
88 | bool overlay_update; | |
89 | }; | |
90 | ||
4562236b HW |
91 | /* Forward declaration*/ |
92 | struct dc; | |
93 | struct dc_surface; | |
94 | struct validate_context; | |
95 | ||
96 | struct dc_cap_funcs { | |
ff5ef992 AD |
97 | #if defined(CONFIG_DRM_AMD_DC_DCN1_0) |
98 | bool (*get_dcc_compression_cap)(const struct dc *dc, | |
99 | const struct dc_dcc_surface_param *input, | |
100 | struct dc_surface_dcc_cap *output); | |
101 | #else | |
4562236b | 102 | int i; |
ff5ef992 | 103 | #endif |
4562236b HW |
104 | }; |
105 | ||
106 | struct dc_stream_funcs { | |
107 | bool (*adjust_vmin_vmax)(struct dc *dc, | |
108 | const struct dc_stream **stream, | |
109 | int num_streams, | |
110 | int vmin, | |
111 | int vmax); | |
72ada5f7 EC |
112 | bool (*get_crtc_position)(struct dc *dc, |
113 | const struct dc_stream **stream, | |
114 | int num_streams, | |
115 | unsigned int *v_pos, | |
116 | unsigned int *nom_v_pos); | |
117 | ||
4562236b HW |
118 | |
119 | void (*stream_update_scaling)(const struct dc *dc, | |
120 | const struct dc_stream *dc_stream, | |
121 | const struct rect *src, | |
122 | const struct rect *dst); | |
94267b3d | 123 | |
4562236b | 124 | bool (*set_gamut_remap)(struct dc *dc, |
f46661dd | 125 | const struct dc_stream *stream); |
94267b3d ST |
126 | |
127 | void (*set_static_screen_events)(struct dc *dc, | |
128 | const struct dc_stream **stream, | |
129 | int num_streams, | |
130 | const struct dc_static_screen_events *events); | |
529cad0f DW |
131 | |
132 | void (*set_dither_option)(const struct dc_stream *stream, | |
133 | enum dc_dither_option option); | |
4562236b HW |
134 | }; |
135 | ||
136 | struct link_training_settings; | |
137 | ||
138 | struct dc_link_funcs { | |
139 | void (*set_drive_settings)(struct dc *dc, | |
bf5cda33 HW |
140 | struct link_training_settings *lt_settings, |
141 | const struct dc_link *link); | |
4562236b HW |
142 | void (*perform_link_training)(struct dc *dc, |
143 | struct dc_link_settings *link_setting, | |
144 | bool skip_video_pattern); | |
145 | void (*set_preferred_link_settings)(struct dc *dc, | |
88639168 ZF |
146 | struct dc_link_settings *link_setting, |
147 | const struct dc_link *link); | |
4562236b HW |
148 | void (*enable_hpd)(const struct dc_link *link); |
149 | void (*disable_hpd)(const struct dc_link *link); | |
150 | void (*set_test_pattern)( | |
151 | const struct dc_link *link, | |
152 | enum dp_test_pattern test_pattern, | |
153 | const struct link_training_settings *p_link_settings, | |
154 | const unsigned char *p_custom_pattern, | |
155 | unsigned int cust_pattern_size); | |
156 | }; | |
157 | ||
158 | /* Structure to hold configuration flags set by dm at dc creation. */ | |
159 | struct dc_config { | |
160 | bool gpu_vm_support; | |
161 | bool disable_disp_pll_sharing; | |
162 | }; | |
163 | ||
164 | struct dc_debug { | |
165 | bool surface_visual_confirm; | |
166 | bool max_disp_clk; | |
4562236b | 167 | bool surface_trace; |
9474980a | 168 | bool timing_trace; |
4562236b HW |
169 | bool validation_trace; |
170 | bool disable_stutter; | |
171 | bool disable_dcc; | |
172 | bool disable_dfs_bypass; | |
ff5ef992 AD |
173 | #if defined(CONFIG_DRM_AMD_DC_DCN1_0) |
174 | bool disable_dpp_power_gate; | |
175 | bool disable_hubp_power_gate; | |
176 | bool disable_pplib_wm_range; | |
177 | bool use_dml_wm; | |
178 | bool use_max_voltage; | |
179 | int sr_exit_time_ns; | |
180 | int sr_enter_plus_exit_time_ns; | |
181 | int urgent_latency_ns; | |
182 | int percent_of_ideal_drambw; | |
183 | int dram_clock_change_latency_ns; | |
184 | #endif | |
2c8ad2d5 | 185 | bool disable_pplib_clock_request; |
4562236b | 186 | bool disable_clock_gate; |
aa66df58 | 187 | bool disable_dmcu; |
70814f6f | 188 | bool force_abm_enable; |
4562236b HW |
189 | }; |
190 | ||
191 | struct dc { | |
192 | struct dc_caps caps; | |
193 | struct dc_cap_funcs cap_funcs; | |
194 | struct dc_stream_funcs stream_funcs; | |
195 | struct dc_link_funcs link_funcs; | |
196 | struct dc_config config; | |
197 | struct dc_debug debug; | |
198 | }; | |
199 | ||
2c8ad2d5 AD |
200 | enum frame_buffer_mode { |
201 | FRAME_BUFFER_MODE_LOCAL_ONLY = 0, | |
202 | FRAME_BUFFER_MODE_ZFB_ONLY, | |
203 | FRAME_BUFFER_MODE_MIXED_ZFB_AND_LOCAL, | |
204 | } ; | |
205 | ||
206 | struct dchub_init_data { | |
207 | bool dchub_initialzied; | |
208 | bool dchub_info_valid; | |
209 | int64_t zfb_phys_addr_base; | |
210 | int64_t zfb_mc_base_addr; | |
211 | uint64_t zfb_size_in_byte; | |
212 | enum frame_buffer_mode fb_mode; | |
213 | }; | |
2c8ad2d5 | 214 | |
4562236b HW |
215 | struct dc_init_data { |
216 | struct hw_asic_id asic_id; | |
217 | void *driver; /* ctx */ | |
218 | struct cgs_device *cgs_device; | |
219 | ||
220 | int num_virtual_links; | |
221 | /* | |
222 | * If 'vbios_override' not NULL, it will be called instead | |
223 | * of the real VBIOS. Intended use is Diagnostics on FPGA. | |
224 | */ | |
225 | struct dc_bios *vbios_override; | |
226 | enum dce_environment dce_environment; | |
227 | ||
228 | struct dc_config flags; | |
229 | }; | |
230 | ||
231 | struct dc *dc_create(const struct dc_init_data *init_params); | |
232 | ||
233 | void dc_destroy(struct dc **dc); | |
234 | ||
2c8ad2d5 | 235 | bool dc_init_dchub(struct dc *dc, struct dchub_init_data *dh_data); |
2c8ad2d5 | 236 | |
4562236b HW |
237 | /******************************************************************************* |
238 | * Surface Interfaces | |
239 | ******************************************************************************/ | |
240 | ||
241 | enum { | |
fb735a9f | 242 | TRANSFER_FUNC_POINTS = 1025 |
4562236b HW |
243 | }; |
244 | ||
1646a6fe | 245 | struct dc_hdr_static_metadata { |
70063a59 | 246 | bool hdr_supported; |
1646a6fe AW |
247 | bool is_hdr; |
248 | ||
249 | /* display chromaticities and white point in units of 0.00001 */ | |
250 | unsigned int chromaticity_green_x; | |
251 | unsigned int chromaticity_green_y; | |
252 | unsigned int chromaticity_blue_x; | |
253 | unsigned int chromaticity_blue_y; | |
254 | unsigned int chromaticity_red_x; | |
255 | unsigned int chromaticity_red_y; | |
256 | unsigned int chromaticity_white_point_x; | |
257 | unsigned int chromaticity_white_point_y; | |
258 | ||
259 | uint32_t min_luminance; | |
260 | uint32_t max_luminance; | |
261 | uint32_t maximum_content_light_level; | |
262 | uint32_t maximum_frame_average_light_level; | |
263 | }; | |
264 | ||
fb735a9f AK |
265 | enum dc_transfer_func_type { |
266 | TF_TYPE_PREDEFINED, | |
267 | TF_TYPE_DISTRIBUTED_POINTS, | |
f46661dd AZ |
268 | TF_TYPE_BYPASS, |
269 | TF_TYPE_UNKNOWN | |
fb735a9f AK |
270 | }; |
271 | ||
272 | struct dc_transfer_func_distributed_points { | |
fcd2f4bf AZ |
273 | struct fixed31_32 red[TRANSFER_FUNC_POINTS]; |
274 | struct fixed31_32 green[TRANSFER_FUNC_POINTS]; | |
275 | struct fixed31_32 blue[TRANSFER_FUNC_POINTS]; | |
276 | ||
fb735a9f | 277 | uint16_t end_exponent; |
fcd2f4bf AZ |
278 | uint16_t x_point_at_y1_red; |
279 | uint16_t x_point_at_y1_green; | |
280 | uint16_t x_point_at_y1_blue; | |
fb735a9f AK |
281 | }; |
282 | ||
283 | enum dc_transfer_func_predefined { | |
284 | TRANSFER_FUNCTION_SRGB, | |
285 | TRANSFER_FUNCTION_BT709, | |
90e508ba | 286 | TRANSFER_FUNCTION_PQ, |
fb735a9f AK |
287 | TRANSFER_FUNCTION_LINEAR, |
288 | }; | |
289 | ||
290 | struct dc_transfer_func { | |
291 | enum dc_transfer_func_type type; | |
292 | enum dc_transfer_func_predefined tf; | |
293 | struct dc_transfer_func_distributed_points tf_pts; | |
294 | }; | |
295 | ||
4562236b HW |
296 | struct dc_surface { |
297 | bool visible; | |
298 | bool flip_immediate; | |
299 | struct dc_plane_address address; | |
300 | ||
301 | struct scaling_taps scaling_quality; | |
302 | struct rect src_rect; | |
303 | struct rect dst_rect; | |
304 | struct rect clip_rect; | |
305 | ||
306 | union plane_size plane_size; | |
307 | union dc_tiling_info tiling_info; | |
308 | struct dc_plane_dcc_param dcc; | |
309 | enum dc_color_space color_space; | |
310 | ||
311 | enum surface_pixel_format format; | |
312 | enum dc_rotation_angle rotation; | |
313 | bool horizontal_mirror; | |
314 | enum plane_stereo_format stereo_format; | |
315 | ||
1646a6fe AW |
316 | struct dc_hdr_static_metadata hdr_static_ctx; |
317 | ||
4562236b | 318 | const struct dc_gamma *gamma_correction; |
fb735a9f | 319 | const struct dc_transfer_func *in_transfer_func; |
4562236b HW |
320 | }; |
321 | ||
322 | struct dc_plane_info { | |
323 | union plane_size plane_size; | |
324 | union dc_tiling_info tiling_info; | |
9cd09bfe | 325 | struct dc_plane_dcc_param dcc; |
4562236b HW |
326 | enum surface_pixel_format format; |
327 | enum dc_rotation_angle rotation; | |
328 | bool horizontal_mirror; | |
329 | enum plane_stereo_format stereo_format; | |
330 | enum dc_color_space color_space; /*todo: wrong place, fits in scaling info*/ | |
331 | bool visible; | |
332 | }; | |
333 | ||
334 | struct dc_scaling_info { | |
335 | struct rect src_rect; | |
336 | struct rect dst_rect; | |
337 | struct rect clip_rect; | |
338 | struct scaling_taps scaling_quality; | |
339 | }; | |
340 | ||
341 | struct dc_surface_update { | |
342 | const struct dc_surface *surface; | |
343 | ||
344 | /* isr safe update parameters. null means no updates */ | |
345 | struct dc_flip_addrs *flip_addr; | |
346 | struct dc_plane_info *plane_info; | |
347 | struct dc_scaling_info *scaling_info; | |
348 | /* following updates require alloc/sleep/spin that is not isr safe, | |
349 | * null means no updates | |
350 | */ | |
fb735a9f | 351 | /* gamma TO BE REMOVED */ |
4562236b | 352 | struct dc_gamma *gamma; |
fb735a9f | 353 | struct dc_transfer_func *in_transfer_func; |
f46661dd | 354 | struct dc_hdr_static_metadata *hdr_static_metadata; |
4562236b HW |
355 | }; |
356 | /* | |
357 | * This structure is filled in by dc_surface_get_status and contains | |
358 | * the last requested address and the currently active address so the called | |
359 | * can determine if there are any outstanding flips | |
360 | */ | |
361 | struct dc_surface_status { | |
362 | struct dc_plane_address requested_address; | |
363 | struct dc_plane_address current_address; | |
364 | bool is_flip_pending; | |
365 | }; | |
366 | ||
367 | /* | |
368 | * Create a new surface with default parameters; | |
369 | */ | |
370 | struct dc_surface *dc_create_surface(const struct dc *dc); | |
371 | const struct dc_surface_status *dc_surface_get_status( | |
372 | const struct dc_surface *dc_surface); | |
373 | ||
374 | void dc_surface_retain(const struct dc_surface *dc_surface); | |
375 | void dc_surface_release(const struct dc_surface *dc_surface); | |
376 | ||
89e89630 | 377 | void dc_gamma_retain(const struct dc_gamma *dc_gamma); |
aff20230 | 378 | void dc_gamma_release(const struct dc_gamma **dc_gamma); |
4562236b HW |
379 | struct dc_gamma *dc_create_gamma(void); |
380 | ||
fb735a9f AK |
381 | void dc_transfer_func_retain(const struct dc_transfer_func *dc_tf); |
382 | void dc_transfer_func_release(const struct dc_transfer_func *dc_tf); | |
90e508ba | 383 | struct dc_transfer_func *dc_create_transfer_func(void); |
fb735a9f | 384 | |
4562236b HW |
385 | /* |
386 | * This structure holds a surface address. There could be multiple addresses | |
387 | * in cases such as Stereo 3D, Planar YUV, etc. Other per-flip attributes such | |
388 | * as frame durations and DCC format can also be set. | |
389 | */ | |
390 | struct dc_flip_addrs { | |
391 | struct dc_plane_address address; | |
392 | bool flip_immediate; | |
4562236b HW |
393 | /* TODO: add flip duration for FreeSync */ |
394 | }; | |
395 | ||
396 | /* | |
397 | * Optimized flip address update function. | |
398 | * | |
399 | * After this call: | |
400 | * Surface addresses and flip attributes are programmed. | |
401 | * Surface flip occur at next configured time (h_sync or v_sync flip) | |
402 | */ | |
403 | void dc_flip_surface_addrs(struct dc *dc, | |
404 | const struct dc_surface *const surfaces[], | |
405 | struct dc_flip_addrs flip_addrs[], | |
406 | uint32_t count); | |
407 | ||
408 | /* | |
ab2541b6 AC |
409 | * Set up surface attributes and associate to a stream |
410 | * The surfaces parameter is an absolute set of all surface active for the stream. | |
411 | * If no surfaces are provided, the stream will be blanked; no memory read. | |
4562236b HW |
412 | * Any flip related attribute changes must be done through this interface. |
413 | * | |
414 | * After this call: | |
ab2541b6 | 415 | * Surfaces attributes are programmed and configured to be composed into stream. |
4562236b HW |
416 | * This does not trigger a flip. No surface address is programmed. |
417 | */ | |
418 | ||
ab2541b6 | 419 | bool dc_commit_surfaces_to_stream( |
4562236b HW |
420 | struct dc *dc, |
421 | const struct dc_surface **dc_surfaces, | |
422 | uint8_t surface_count, | |
ab2541b6 | 423 | const struct dc_stream *stream); |
4562236b | 424 | |
ab2541b6 | 425 | bool dc_pre_update_surfaces_to_stream( |
4562236b HW |
426 | struct dc *dc, |
427 | const struct dc_surface *const *new_surfaces, | |
428 | uint8_t new_surface_count, | |
ab2541b6 | 429 | const struct dc_stream *stream); |
4562236b | 430 | |
ab2541b6 | 431 | bool dc_post_update_surfaces_to_stream( |
4562236b HW |
432 | struct dc *dc); |
433 | ||
ab2541b6 AC |
434 | void dc_update_surfaces_for_stream(struct dc *dc, struct dc_surface_update *updates, |
435 | int surface_count, const struct dc_stream *stream); | |
4562236b | 436 | |
5869b0f6 LE |
437 | enum surface_update_type { |
438 | UPDATE_TYPE_FAST, /* super fast, safe to execute in isr */ | |
439 | UPDATE_TYPE_MED, /* a lot of programming needed. may need to alloc */ | |
440 | UPDATE_TYPE_FULL, /* may need to shuffle resources */ | |
441 | }; | |
442 | ||
4562236b | 443 | /******************************************************************************* |
ab2541b6 | 444 | * Stream Interfaces |
4562236b | 445 | ******************************************************************************/ |
ab2541b6 AC |
446 | struct dc_stream { |
447 | const struct dc_sink *sink; | |
448 | struct dc_crtc_timing timing; | |
8b32076c | 449 | enum signal_type output_signal; |
4562236b | 450 | |
ab2541b6 | 451 | enum dc_color_space output_color_space; |
b92033b6 | 452 | enum dc_dither_option dither_option; |
4562236b | 453 | |
ab2541b6 AC |
454 | struct rect src; /* composition area */ |
455 | struct rect dst; /* stream addressable area */ | |
4562236b | 456 | |
ab2541b6 AC |
457 | struct audio_info audio_info; |
458 | ||
459 | bool ignore_msa_timing_param; | |
460 | ||
461 | struct freesync_context freesync_ctx; | |
462 | ||
463 | const struct dc_transfer_func *out_transfer_func; | |
464 | struct colorspace_transform gamut_remap_matrix; | |
465 | struct csc_transform csc_color_matrix; | |
466 | ||
ab2541b6 AC |
467 | /* TODO: custom INFO packets */ |
468 | /* TODO: ABM info (DMCU) */ | |
469 | /* TODO: PSR info */ | |
470 | /* TODO: CEA VIC */ | |
471 | }; | |
4562236b | 472 | |
a783e7b5 | 473 | struct dc_stream_update { |
a783e7b5 | 474 | struct rect src; |
a783e7b5 | 475 | struct rect dst; |
f46661dd | 476 | struct dc_transfer_func *out_transfer_func; |
a783e7b5 LE |
477 | }; |
478 | ||
479 | ||
480 | /* | |
481 | * Setup stream attributes if no stream updates are provided | |
482 | * there will be no impact on the stream parameters | |
483 | * | |
484 | * Set up surface attributes and associate to a stream | |
485 | * The surfaces parameter is an absolute set of all surface active for the stream. | |
486 | * If no surfaces are provided, the stream will be blanked; no memory read. | |
487 | * Any flip related attribute changes must be done through this interface. | |
488 | * | |
489 | * After this call: | |
490 | * Surfaces attributes are programmed and configured to be composed into stream. | |
491 | * This does not trigger a flip. No surface address is programmed. | |
492 | * | |
493 | */ | |
494 | ||
495 | void dc_update_surfaces_and_stream(struct dc *dc, | |
496 | struct dc_surface_update *surface_updates, int surface_count, | |
497 | const struct dc_stream *dc_stream, | |
498 | struct dc_stream_update *stream_update); | |
499 | ||
4562236b | 500 | /* |
ab2541b6 | 501 | * Log the current stream state. |
4562236b | 502 | */ |
ab2541b6 AC |
503 | void dc_stream_log( |
504 | const struct dc_stream *stream, | |
4562236b HW |
505 | struct dal_logger *dc_logger, |
506 | enum dc_log_type log_type); | |
507 | ||
ab2541b6 AC |
508 | uint8_t dc_get_current_stream_count(const struct dc *dc); |
509 | struct dc_stream *dc_get_stream_at_index(const struct dc *dc, uint8_t i); | |
4562236b | 510 | |
ab2541b6 AC |
511 | /* |
512 | * Return the current frame counter. | |
513 | */ | |
514 | uint32_t dc_stream_get_vblank_counter(const struct dc_stream *stream); | |
4562236b HW |
515 | |
516 | /* TODO: Return parsed values rather than direct register read | |
517 | * This has a dependency on the caller (amdgpu_get_crtc_scanoutpos) | |
518 | * being refactored properly to be dce-specific | |
519 | */ | |
81c50963 ST |
520 | bool dc_stream_get_scanoutpos(const struct dc_stream *stream, |
521 | uint32_t *v_blank_start, | |
522 | uint32_t *v_blank_end, | |
523 | uint32_t *h_position, | |
524 | uint32_t *v_position); | |
4562236b HW |
525 | |
526 | /* | |
ab2541b6 | 527 | * Structure to store surface/stream associations for validation |
4562236b HW |
528 | */ |
529 | struct dc_validation_set { | |
ab2541b6 | 530 | const struct dc_stream *stream; |
4562236b HW |
531 | const struct dc_surface *surfaces[MAX_SURFACES]; |
532 | uint8_t surface_count; | |
533 | }; | |
534 | ||
535 | /* | |
536 | * This function takes a set of resources and checks that they are cofunctional. | |
537 | * | |
538 | * After this call: | |
539 | * No hardware is programmed for call. Only validation is done. | |
540 | */ | |
07d72b39 HW |
541 | struct validate_context *dc_get_validate_context( |
542 | const struct dc *dc, | |
543 | const struct dc_validation_set set[], | |
544 | uint8_t set_count); | |
545 | ||
4562236b HW |
546 | bool dc_validate_resources( |
547 | const struct dc *dc, | |
548 | const struct dc_validation_set set[], | |
549 | uint8_t set_count); | |
550 | ||
551 | /* | |
ab2541b6 AC |
552 | * This function takes a stream and checks if it is guaranteed to be supported. |
553 | * Guaranteed means that MAX_COFUNC similar streams are supported. | |
4562236b HW |
554 | * |
555 | * After this call: | |
556 | * No hardware is programmed for call. Only validation is done. | |
557 | */ | |
558 | ||
559 | bool dc_validate_guaranteed( | |
560 | const struct dc *dc, | |
ab2541b6 | 561 | const struct dc_stream *stream); |
4562236b | 562 | |
8122a253 HW |
563 | void dc_resource_validate_ctx_copy_construct( |
564 | const struct validate_context *src_ctx, | |
565 | struct validate_context *dst_ctx); | |
566 | ||
567 | void dc_resource_validate_ctx_destruct(struct validate_context *context); | |
568 | ||
4562236b | 569 | /* |
ab2541b6 AC |
570 | * Set up streams and links associated to drive sinks |
571 | * The streams parameter is an absolute set of all active streams. | |
4562236b HW |
572 | * |
573 | * After this call: | |
574 | * Phy, Encoder, Timing Generator are programmed and enabled. | |
ab2541b6 | 575 | * New streams are enabled with blank stream; no memory read. |
4562236b | 576 | */ |
ab2541b6 | 577 | bool dc_commit_streams( |
4562236b | 578 | struct dc *dc, |
ab2541b6 AC |
579 | const struct dc_stream *streams[], |
580 | uint8_t stream_count); | |
4562236b HW |
581 | |
582 | /** | |
583 | * Create a new default stream for the requested sink | |
584 | */ | |
585 | struct dc_stream *dc_create_stream_for_sink(const struct dc_sink *dc_sink); | |
586 | ||
587 | void dc_stream_retain(const struct dc_stream *dc_stream); | |
588 | void dc_stream_release(const struct dc_stream *dc_stream); | |
589 | ||
590 | struct dc_stream_status { | |
ab2541b6 AC |
591 | int primary_otg_inst; |
592 | int surface_count; | |
593 | const struct dc_surface *surfaces[MAX_SURFACE_NUM]; | |
594 | ||
4562236b HW |
595 | /* |
596 | * link this stream passes through | |
597 | */ | |
598 | const struct dc_link *link; | |
599 | }; | |
600 | ||
601 | const struct dc_stream_status *dc_stream_get_status( | |
602 | const struct dc_stream *dc_stream); | |
603 | ||
5869b0f6 LE |
604 | enum surface_update_type dc_check_update_surfaces_for_stream( |
605 | struct dc *dc, | |
606 | struct dc_surface_update *updates, | |
607 | int surface_count, | |
ee8f63e1 | 608 | struct dc_stream_update *stream_update, |
5869b0f6 LE |
609 | const struct dc_stream_status *stream_status); |
610 | ||
4562236b HW |
611 | /******************************************************************************* |
612 | * Link Interfaces | |
613 | ******************************************************************************/ | |
614 | ||
615 | /* | |
616 | * A link contains one or more sinks and their connected status. | |
617 | * The currently active signal type (HDMI, DP-SST, DP-MST) is also reported. | |
618 | */ | |
619 | struct dc_link { | |
620 | const struct dc_sink *remote_sinks[MAX_SINKS_PER_LINK]; | |
621 | unsigned int sink_count; | |
622 | const struct dc_sink *local_sink; | |
623 | unsigned int link_index; | |
624 | enum dc_connection_type type; | |
625 | enum signal_type connector_signal; | |
626 | enum dc_irq_source irq_source_hpd; | |
627 | enum dc_irq_source irq_source_hpd_rx;/* aka DP Short Pulse */ | |
628 | /* caps is the same as reported_link_cap. link_traing use | |
629 | * reported_link_cap. Will clean up. TODO | |
630 | */ | |
631 | struct dc_link_settings reported_link_cap; | |
632 | struct dc_link_settings verified_link_cap; | |
633 | struct dc_link_settings max_link_setting; | |
634 | struct dc_link_settings cur_link_settings; | |
635 | struct dc_lane_settings cur_lane_setting; | |
636 | ||
637 | uint8_t ddc_hw_inst; | |
638 | uint8_t link_enc_hw_inst; | |
639 | ||
4562236b HW |
640 | bool test_pattern_enabled; |
641 | union compliance_test_state compliance_test_state; | |
9fb8de78 AG |
642 | |
643 | void *priv; | |
7c7f5b15 | 644 | bool aux_mode; |
46df790c AG |
645 | |
646 | struct ddc_service *ddc; | |
4562236b HW |
647 | }; |
648 | ||
649 | struct dpcd_caps { | |
650 | union dpcd_rev dpcd_rev; | |
651 | union max_lane_count max_ln_count; | |
652 | union max_down_spread max_down_spread; | |
653 | ||
654 | /* dongle type (DP converter, CV smart dongle) */ | |
655 | enum display_dongle_type dongle_type; | |
656 | /* Dongle's downstream count. */ | |
657 | union sink_count sink_count; | |
658 | /* If dongle_type == DISPLAY_DONGLE_DP_HDMI_CONVERTER, | |
659 | indicates 'Frame Sequential-to-lllFrame Pack' conversion capability.*/ | |
03f5c686 | 660 | struct dc_dongle_caps dongle_caps; |
4562236b HW |
661 | |
662 | bool allow_invalid_MSA_timing_param; | |
663 | bool panel_mode_edp; | |
664 | uint32_t sink_dev_id; | |
665 | uint32_t branch_dev_id; | |
666 | int8_t branch_dev_name[6]; | |
667 | int8_t branch_hw_revision; | |
668 | }; | |
669 | ||
670 | struct dc_link_status { | |
671 | struct dpcd_caps *dpcd_caps; | |
672 | }; | |
673 | ||
674 | const struct dc_link_status *dc_link_get_status(const struct dc_link *dc_link); | |
675 | ||
676 | /* | |
677 | * Return an enumerated dc_link. dc_link order is constant and determined at | |
678 | * boot time. They cannot be created or destroyed. | |
679 | * Use dc_get_caps() to get number of links. | |
680 | */ | |
681 | const struct dc_link *dc_get_link_at_index(const struct dc *dc, uint32_t link_index); | |
682 | ||
683 | /* Return id of physical connector represented by a dc_link at link_index.*/ | |
684 | const struct graphics_object_id dc_get_link_id_at_index( | |
685 | struct dc *dc, uint32_t link_index); | |
686 | ||
687 | /* Set backlight level of an embedded panel (eDP, LVDS). */ | |
688 | bool dc_link_set_backlight_level(const struct dc_link *dc_link, uint32_t level, | |
689 | uint32_t frame_ramp, const struct dc_stream *stream); | |
690 | ||
4562236b HW |
691 | bool dc_link_set_psr_enable(const struct dc_link *dc_link, bool enable); |
692 | ||
693 | bool dc_link_setup_psr(const struct dc_link *dc_link, | |
94267b3d | 694 | const struct dc_stream *stream, struct psr_config *psr_config); |
4562236b HW |
695 | |
696 | /* Request DC to detect if there is a Panel connected. | |
697 | * boot - If this call is during initial boot. | |
698 | * Return false for any type of detection failure or MST detection | |
699 | * true otherwise. True meaning further action is required (status update | |
700 | * and OS notification). | |
701 | */ | |
702 | bool dc_link_detect(const struct dc_link *dc_link, bool boot); | |
703 | ||
704 | /* Notify DC about DP RX Interrupt (aka Short Pulse Interrupt). | |
705 | * Return: | |
706 | * true - Downstream port status changed. DM should call DC to do the | |
707 | * detection. | |
708 | * false - no change in Downstream port status. No further action required | |
709 | * from DM. */ | |
710 | bool dc_link_handle_hpd_rx_irq(const struct dc_link *dc_link); | |
711 | ||
712 | struct dc_sink_init_data; | |
713 | ||
714 | struct dc_sink *dc_link_add_remote_sink( | |
715 | const struct dc_link *dc_link, | |
716 | const uint8_t *edid, | |
717 | int len, | |
718 | struct dc_sink_init_data *init_data); | |
719 | ||
720 | void dc_link_remove_remote_sink( | |
721 | const struct dc_link *link, | |
722 | const struct dc_sink *sink); | |
723 | ||
724 | /* Used by diagnostics for virtual link at the moment */ | |
725 | void dc_link_set_sink(const struct dc_link *link, struct dc_sink *sink); | |
726 | ||
727 | void dc_link_dp_set_drive_settings( | |
d27383a2 | 728 | const struct dc_link *link, |
4562236b HW |
729 | struct link_training_settings *lt_settings); |
730 | ||
731 | bool dc_link_dp_perform_link_training( | |
732 | struct dc_link *link, | |
733 | const struct dc_link_settings *link_setting, | |
734 | bool skip_video_pattern); | |
735 | ||
736 | void dc_link_dp_enable_hpd(const struct dc_link *link); | |
737 | ||
738 | void dc_link_dp_disable_hpd(const struct dc_link *link); | |
739 | ||
740 | bool dc_link_dp_set_test_pattern( | |
741 | const struct dc_link *link, | |
742 | enum dp_test_pattern test_pattern, | |
743 | const struct link_training_settings *p_link_settings, | |
744 | const unsigned char *p_custom_pattern, | |
745 | unsigned int cust_pattern_size); | |
746 | ||
747 | /******************************************************************************* | |
748 | * Sink Interfaces - A sink corresponds to a display output device | |
749 | ******************************************************************************/ | |
750 | ||
8c895313 | 751 | struct dc_container_id { |
752 | // 128bit GUID in binary form | |
753 | unsigned char guid[16]; | |
754 | // 8 byte port ID -> ELD.PortID | |
755 | unsigned int portId[2]; | |
756 | // 128bit GUID in binary formufacturer name -> ELD.ManufacturerName | |
757 | unsigned short manufacturerName; | |
758 | // 2 byte product code -> ELD.ProductCode | |
759 | unsigned short productCode; | |
760 | }; | |
761 | ||
4562236b HW |
762 | /* |
763 | * The sink structure contains EDID and other display device properties | |
764 | */ | |
765 | struct dc_sink { | |
766 | enum signal_type sink_signal; | |
767 | struct dc_edid dc_edid; /* raw edid */ | |
768 | struct dc_edid_caps edid_caps; /* parse display caps */ | |
8c895313 | 769 | struct dc_container_id *dc_container_id; |
4a9a5d62 ZF |
770 | uint32_t dongle_max_pix_clk; |
771 | bool converter_disable_audio; | |
5c4e9806 | 772 | void *priv; |
4562236b HW |
773 | }; |
774 | ||
775 | void dc_sink_retain(const struct dc_sink *sink); | |
776 | void dc_sink_release(const struct dc_sink *sink); | |
777 | ||
778 | const struct audio **dc_get_audios(struct dc *dc); | |
779 | ||
780 | struct dc_sink_init_data { | |
781 | enum signal_type sink_signal; | |
782 | const struct dc_link *link; | |
783 | uint32_t dongle_max_pix_clk; | |
784 | bool converter_disable_audio; | |
785 | }; | |
786 | ||
787 | struct dc_sink *dc_sink_create(const struct dc_sink_init_data *init_params); | |
8c895313 | 788 | bool dc_sink_get_container_id(struct dc_sink *dc_sink, struct dc_container_id *container_id); |
789 | bool dc_sink_set_container_id(struct dc_sink *dc_sink, const struct dc_container_id *container_id); | |
4562236b HW |
790 | |
791 | /******************************************************************************* | |
ab2541b6 | 792 | * Cursor interfaces - To manages the cursor within a stream |
4562236b HW |
793 | ******************************************************************************/ |
794 | /* TODO: Deprecated once we switch to dc_set_cursor_position */ | |
ab2541b6 AC |
795 | bool dc_stream_set_cursor_attributes( |
796 | const struct dc_stream *stream, | |
4562236b HW |
797 | const struct dc_cursor_attributes *attributes); |
798 | ||
ab2541b6 AC |
799 | bool dc_stream_set_cursor_position( |
800 | const struct dc_stream *stream, | |
beb16b6a | 801 | const struct dc_cursor_position *position); |
4562236b HW |
802 | |
803 | /* Newer interfaces */ | |
804 | struct dc_cursor { | |
805 | struct dc_plane_address address; | |
806 | struct dc_cursor_attributes attributes; | |
807 | }; | |
808 | ||
4562236b HW |
809 | /******************************************************************************* |
810 | * Interrupt interfaces | |
811 | ******************************************************************************/ | |
812 | enum dc_irq_source dc_interrupt_to_irq_source( | |
813 | struct dc *dc, | |
814 | uint32_t src_id, | |
815 | uint32_t ext_id); | |
816 | void dc_interrupt_set(const struct dc *dc, enum dc_irq_source src, bool enable); | |
817 | void dc_interrupt_ack(struct dc *dc, enum dc_irq_source src); | |
818 | enum dc_irq_source dc_get_hpd_irq_source_at_index( | |
819 | struct dc *dc, uint32_t link_index); | |
820 | ||
821 | /******************************************************************************* | |
822 | * Power Interfaces | |
823 | ******************************************************************************/ | |
824 | ||
825 | void dc_set_power_state( | |
826 | struct dc *dc, | |
a3621485 | 827 | enum dc_acpi_cm_power_state power_state); |
4562236b HW |
828 | void dc_resume(const struct dc *dc); |
829 | ||
4562236b HW |
830 | /* |
831 | * DPCD access interfaces | |
832 | */ | |
833 | ||
7c7f5b15 | 834 | bool dc_read_aux_dpcd( |
4562236b HW |
835 | struct dc *dc, |
836 | uint32_t link_index, | |
837 | uint32_t address, | |
838 | uint8_t *data, | |
839 | uint32_t size); | |
840 | ||
7c7f5b15 | 841 | bool dc_write_aux_dpcd( |
4562236b HW |
842 | struct dc *dc, |
843 | uint32_t link_index, | |
844 | uint32_t address, | |
845 | const uint8_t *data, | |
2b230ea3 ZF |
846 | uint32_t size); |
847 | ||
7c7f5b15 AG |
848 | bool dc_read_aux_i2c( |
849 | struct dc *dc, | |
850 | uint32_t link_index, | |
851 | enum i2c_mot_mode mot, | |
852 | uint32_t address, | |
853 | uint8_t *data, | |
854 | uint32_t size); | |
855 | ||
856 | bool dc_write_aux_i2c( | |
857 | struct dc *dc, | |
858 | uint32_t link_index, | |
859 | enum i2c_mot_mode mot, | |
860 | uint32_t address, | |
861 | const uint8_t *data, | |
862 | uint32_t size); | |
863 | ||
2b230ea3 ZF |
864 | bool dc_query_ddc_data( |
865 | struct dc *dc, | |
866 | uint32_t link_index, | |
867 | uint32_t address, | |
868 | uint8_t *write_buf, | |
869 | uint32_t write_size, | |
870 | uint8_t *read_buf, | |
871 | uint32_t read_size); | |
4562236b HW |
872 | |
873 | bool dc_submit_i2c( | |
874 | struct dc *dc, | |
875 | uint32_t link_index, | |
876 | struct i2c_command *cmd); | |
877 | ||
5e7773a2 | 878 | |
4562236b | 879 | #endif /* DC_INTERFACE_H_ */ |