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 bool intel_dp_lttpr_transparent_mode_enabled(struct intel_dp *intel_dp);
19
20 void intel_dp_link_training_set_mode(struct intel_dp *intel_dp,
21 int link_rate, bool is_vrr);
22 void intel_dp_link_training_set_bw(struct intel_dp *intel_dp,
23 int link_bw, int rate_select, int lane_count,
24 bool enhanced_framing);
25
26 void intel_dp_get_adjust_train(struct intel_dp *intel_dp,
27 const struct intel_crtc_state *crtc_state,
28 enum drm_dp_phy dp_phy,
29 const u8 link_status[DP_LINK_STATUS_SIZE]);
30 void intel_dp_program_link_training_pattern(struct intel_dp *intel_dp,
31 const struct intel_crtc_state *crtc_state,
32 enum drm_dp_phy dp_phy,
33 u8 dp_train_pat);
34 void intel_dp_set_signal_levels(struct intel_dp *intel_dp,
35 const struct intel_crtc_state *crtc_state,
36 enum drm_dp_phy dp_phy);
37 void intel_dp_start_link_train(struct intel_atomic_state *state,
38 struct intel_dp *intel_dp,
39 const struct intel_crtc_state *crtc_state);
40 void intel_dp_stop_link_train(struct intel_dp *intel_dp,
41 const struct intel_crtc_state *crtc_state);
42
43 void
44 intel_dp_dump_link_status(struct intel_dp *intel_dp, enum drm_dp_phy dp_phy,
45 const u8 link_status[DP_LINK_STATUS_SIZE]);
46
47 /* Get the TPSx symbol type of the value programmed to DP_TRAINING_PATTERN_SET */
intel_dp_training_pattern_symbol(u8 pattern)48 static inline u8 intel_dp_training_pattern_symbol(u8 pattern)
49 {
50 return pattern & ~DP_LINK_SCRAMBLING_DISABLE;
51 }
52
53 void intel_dp_128b132b_sdp_crc16(struct intel_dp *intel_dp,
54 const struct intel_crtc_state *crtc_state);
55
56 void intel_dp_link_training_debugfs_add(struct intel_connector *connector);
57
58 #endif /* __INTEL_DP_LINK_TRAINING_H__ */
59