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 #include "intel_dp_link_caps.h" 12 13 struct intel_atomic_state; 14 struct intel_connector; 15 struct intel_crtc_state; 16 struct intel_dp; 17 struct intel_dp_link_training; 18 struct intel_encoder; 19 20 int intel_dp_read_dprx_caps(struct intel_dp *intel_dp, u8 dpcd[DP_RECEIVER_CAP_SIZE]); 21 int intel_dp_init_lttpr_and_dprx_caps(struct intel_dp *intel_dp); 22 bool intel_dp_lttpr_transparent_mode_enabled(struct intel_dp *intel_dp); 23 24 void intel_dp_link_training_set_mode(struct intel_dp *intel_dp, 25 int link_rate, bool is_vrr, 26 bool pr_with_as_sdp_enable); 27 void intel_dp_link_training_set_bw(struct intel_dp *intel_dp, 28 int link_bw, int rate_select, int lane_count, 29 bool enhanced_framing, bool post_lt_adj_req); 30 31 bool intel_dp_get_adjust_train(struct intel_dp *intel_dp, 32 const struct intel_crtc_state *crtc_state, 33 enum drm_dp_phy dp_phy, 34 const u8 link_status[DP_LINK_STATUS_SIZE]); 35 void intel_dp_program_link_training_pattern(struct intel_dp *intel_dp, 36 const struct intel_crtc_state *crtc_state, 37 enum drm_dp_phy dp_phy, 38 u8 dp_train_pat); 39 void intel_dp_set_signal_levels(struct intel_dp *intel_dp, 40 const struct intel_crtc_state *crtc_state, 41 enum drm_dp_phy dp_phy); 42 void intel_dp_start_link_train(struct intel_atomic_state *state, 43 struct intel_dp *intel_dp, 44 const struct intel_crtc_state *crtc_state); 45 void intel_dp_stop_link_train(struct intel_dp *intel_dp, 46 const struct intel_crtc_state *crtc_state); 47 48 void 49 intel_dp_dump_link_status(struct intel_dp *intel_dp, enum drm_dp_phy dp_phy, 50 const u8 link_status[DP_LINK_STATUS_SIZE]); 51 52 /* Get the TPSx symbol type of the value programmed to DP_TRAINING_PATTERN_SET */ 53 static inline u8 intel_dp_training_pattern_symbol(u8 pattern) 54 { 55 return pattern & ~DP_LINK_SCRAMBLING_DISABLE; 56 } 57 58 void intel_dp_128b132b_sdp_crc16(struct intel_dp *intel_dp, 59 const struct intel_crtc_state *crtc_state); 60 61 bool intel_dp_link_params_valid(struct intel_dp *intel_dp, int link_rate, 62 u8 lane_count); 63 64 bool intel_dp_link_training_get_force_retrain(struct intel_dp_link_training *link_training); 65 66 void intel_dp_link_check(struct intel_encoder *encoder); 67 void intel_dp_check_link_state(struct intel_dp *intel_dp); 68 69 void intel_dp_link_training_debugfs_add(struct intel_connector *connector); 70 71 void intel_dp_link_training_reset(struct intel_dp_link_training *link_training); 72 73 struct intel_dp_link_training *intel_dp_link_training_init(struct intel_dp *intel_dp); 74 void intel_dp_link_training_cleanup(struct intel_dp_link_training *link_training); 75 76 #if IS_ENABLED(CONFIG_KUNIT) 77 78 int intel_dp_get_link_train_fallback_values(struct intel_dp *intel_dp, 79 const struct intel_crtc_state *crtc_state); 80 81 #define INTEL_DP_LINK_TRAINING_TEST_OPS_MEMBERS(__X) \ 82 __X(get_fallback_values, intel_dp_get_link_train_fallback_values) 83 84 #define __DECLARE_MEMBER(__name, __fn) \ 85 typeof(__fn) *__name; 86 87 #define INTEL_DP_LINK_TRAINING_TEST_OPS_DECLARE \ 88 INTEL_DP_LINK_TRAINING_TEST_OPS_MEMBERS(__DECLARE_MEMBER) 89 90 struct intel_dp_link_training_test_ops { 91 INTEL_DP_LINK_TRAINING_TEST_OPS_DECLARE 92 }; 93 94 #undef INTEL_DP_LINK_TRAINING_TEST_OPS_DECLARE 95 #undef __DECLARE_MEMBER 96 97 #ifdef I915 98 extern const struct intel_dp_link_training_test_ops i915_display_dp_link_training_test_ops; 99 #else 100 extern const struct intel_dp_link_training_test_ops intel_display_dp_link_training_test_ops; 101 #endif /* I915 */ 102 103 #endif /* CONFIG_KUNIT */ 104 105 #endif /* __INTEL_DP_LINK_TRAINING_H__ */ 106