1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3 * Copyright (c) 2012-2020, The Linux Foundation. All rights reserved.
4 */
5
6 #ifndef _DP_LINK_H_
7 #define _DP_LINK_H_
8
9 #include "dp_aux.h"
10
11 #define DS_PORT_STATUS_CHANGED 0x200
12 #define DP_TEST_BIT_DEPTH_UNKNOWN 0xFFFFFFFF
13 #define DP_LINK_CAP_ENHANCED_FRAMING (1 << 0)
14
15 struct dp_link_info {
16 unsigned char revision;
17 unsigned int rate;
18 unsigned int num_lanes;
19 unsigned long capabilities;
20 };
21
22 enum dp_link_voltage_level {
23 DP_TRAIN_VOLTAGE_SWING_LVL_0 = 0,
24 DP_TRAIN_VOLTAGE_SWING_LVL_1 = 1,
25 DP_TRAIN_VOLTAGE_SWING_LVL_2 = 2,
26 DP_TRAIN_VOLTAGE_SWING_MAX = DP_TRAIN_VOLTAGE_SWING_LVL_2,
27 };
28
29 enum dp_link_preemaphasis_level {
30 DP_TRAIN_PRE_EMPHASIS_LVL_0 = 0,
31 DP_TRAIN_PRE_EMPHASIS_LVL_1 = 1,
32 DP_TRAIN_PRE_EMPHASIS_LVL_2 = 2,
33 DP_TRAIN_PRE_EMPHASIS_MAX = DP_TRAIN_PRE_EMPHASIS_LVL_2,
34 };
35
36 struct dp_link_test_video {
37 u32 test_video_pattern;
38 u32 test_bit_depth;
39 u32 test_dyn_range;
40 u32 test_h_total;
41 u32 test_v_total;
42 u32 test_h_start;
43 u32 test_v_start;
44 u32 test_hsync_pol;
45 u32 test_hsync_width;
46 u32 test_vsync_pol;
47 u32 test_vsync_width;
48 u32 test_h_width;
49 u32 test_v_height;
50 u32 test_rr_d;
51 u32 test_rr_n;
52 };
53
54 struct dp_link_test_audio {
55 u32 test_audio_sampling_rate;
56 u32 test_audio_channel_count;
57 u32 test_audio_pattern_type;
58 u32 test_audio_period_ch_1;
59 u32 test_audio_period_ch_2;
60 u32 test_audio_period_ch_3;
61 u32 test_audio_period_ch_4;
62 u32 test_audio_period_ch_5;
63 u32 test_audio_period_ch_6;
64 u32 test_audio_period_ch_7;
65 u32 test_audio_period_ch_8;
66 };
67
68 struct dp_link_phy_params {
69 u32 phy_test_pattern_sel;
70 u8 v_level;
71 u8 p_level;
72 };
73
74 struct dp_link {
75 u32 sink_request;
76 u32 test_response;
77 bool psm_enabled;
78
79 u8 sink_count;
80 struct dp_link_test_video test_video;
81 struct dp_link_test_audio test_audio;
82 struct dp_link_phy_params phy_params;
83 struct dp_link_info link_params;
84 };
85
86 /**
87 * mdss_dp_test_bit_depth_to_bpp() - convert test bit depth to bpp
88 * @tbd: test bit depth
89 *
90 * Returns the bits per pixel (bpp) to be used corresponding to the
91 * git bit depth value. This function assumes that bit depth has
92 * already been validated.
93 */
dp_link_bit_depth_to_bpp(u32 tbd)94 static inline u32 dp_link_bit_depth_to_bpp(u32 tbd)
95 {
96 /*
97 * Few simplistic rules and assumptions made here:
98 * 1. Bit depth is per color component
99 * 2. If bit depth is unknown return 0
100 * 3. Assume 3 color components
101 */
102 switch (tbd) {
103 case DP_TEST_BIT_DEPTH_6:
104 return 18;
105 case DP_TEST_BIT_DEPTH_8:
106 return 24;
107 case DP_TEST_BIT_DEPTH_10:
108 return 30;
109 case DP_TEST_BIT_DEPTH_UNKNOWN:
110 default:
111 return 0;
112 }
113 }
114
115 /**
116 * dp_test_bit_depth_to_bpc() - convert test bit depth to bpc
117 * @tbd: test bit depth
118 *
119 * Returns the bits per comp (bpc) to be used corresponding to the
120 * bit depth value. This function assumes that bit depth has
121 * already been validated.
122 */
dp_link_bit_depth_to_bpc(u32 tbd)123 static inline u32 dp_link_bit_depth_to_bpc(u32 tbd)
124 {
125 switch (tbd) {
126 case DP_TEST_BIT_DEPTH_6:
127 return 6;
128 case DP_TEST_BIT_DEPTH_8:
129 return 8;
130 case DP_TEST_BIT_DEPTH_10:
131 return 10;
132 case DP_TEST_BIT_DEPTH_UNKNOWN:
133 default:
134 return 0;
135 }
136 }
137
138 u32 dp_link_get_test_bits_depth(struct dp_link *dp_link, u32 bpp);
139 int dp_link_process_request(struct dp_link *dp_link);
140 int dp_link_get_colorimetry_config(struct dp_link *dp_link);
141 int dp_link_adjust_levels(struct dp_link *dp_link, u8 *link_status);
142 bool dp_link_send_test_response(struct dp_link *dp_link);
143 int dp_link_psm_config(struct dp_link *dp_link,
144 struct dp_link_info *link_info, bool enable);
145 bool dp_link_send_edid_checksum(struct dp_link *dp_link, u8 checksum);
146
147 /**
148 * dp_link_get() - get the functionalities of dp test module
149 *
150 *
151 * return: a pointer to dp_link struct
152 */
153 struct dp_link *dp_link_get(struct device *dev, struct drm_dp_aux *aux);
154
155 #endif /* _DP_LINK_H_ */
156
