xref: /linux/drivers/gpu/drm/i915/display/intel_dp_link_training.h (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0)
1 /* SPDX-License-Identifier: MIT */
2 /*
3  * Copyright © 2019 Intel Corporation
4  */
5 
6 #ifndef __INTEL_DP_LINK_TRAINING_H__
7 #define __INTEL_DP_LINK_TRAINING_H__
8 
9 #include <drm/display/drm_dp_helper.h>
10 
11 struct intel_atomic_state;
12 struct intel_connector;
13 struct intel_crtc_state;
14 struct intel_dp;
15 
16 int intel_dp_read_dprx_caps(struct intel_dp *intel_dp, u8 dpcd[DP_RECEIVER_CAP_SIZE]);
17 int intel_dp_init_lttpr_and_dprx_caps(struct intel_dp *intel_dp);
18 
19 void intel_dp_link_training_set_mode(struct intel_dp *intel_dp,
20 				     int link_rate, bool is_vrr);
21 void intel_dp_link_training_set_bw(struct intel_dp *intel_dp,
22 				   int link_bw, int rate_select, int lane_count,
23 				   bool enhanced_framing);
24 
25 void intel_dp_get_adjust_train(struct intel_dp *intel_dp,
26 			       const struct intel_crtc_state *crtc_state,
27 			       enum drm_dp_phy dp_phy,
28 			       const u8 link_status[DP_LINK_STATUS_SIZE]);
29 void intel_dp_program_link_training_pattern(struct intel_dp *intel_dp,
30 					    const struct intel_crtc_state *crtc_state,
31 					    enum drm_dp_phy dp_phy,
32 					    u8 dp_train_pat);
33 void intel_dp_set_signal_levels(struct intel_dp *intel_dp,
34 				const struct intel_crtc_state *crtc_state,
35 				enum drm_dp_phy dp_phy);
36 void intel_dp_start_link_train(struct intel_atomic_state *state,
37 			       struct intel_dp *intel_dp,
38 			       const struct intel_crtc_state *crtc_state);
39 void intel_dp_stop_link_train(struct intel_dp *intel_dp,
40 			      const struct intel_crtc_state *crtc_state);
41 
42 void
43 intel_dp_dump_link_status(struct intel_dp *intel_dp, enum drm_dp_phy dp_phy,
44 			  const u8 link_status[DP_LINK_STATUS_SIZE]);
45 
46 /* Get the TPSx symbol type of the value programmed to DP_TRAINING_PATTERN_SET */
47 static inline u8 intel_dp_training_pattern_symbol(u8 pattern)
48 {
49 	return pattern & ~DP_LINK_SCRAMBLING_DISABLE;
50 }
51 
52 void intel_dp_128b132b_sdp_crc16(struct intel_dp *intel_dp,
53 				 const struct intel_crtc_state *crtc_state);
54 
55 void intel_dp_link_training_debugfs_add(struct intel_connector *connector);
56 
57 #endif /* __INTEL_DP_LINK_TRAINING_H__ */
58