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
15struct dp_link_info {
16	unsigned char revision;
17	unsigned int rate;
18	unsigned int num_lanes;
19	unsigned long capabilities;
20};
21
22enum 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
29enum 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
36struct 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
54struct 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
68struct dp_link_phy_params {
69	u32 phy_test_pattern_sel;
70	u8 v_level;
71	u8 p_level;
72};
73
74struct 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 */
94static 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
115void dp_link_reset_phy_params_vx_px(struct dp_link *dp_link);
116u32 dp_link_get_test_bits_depth(struct dp_link *dp_link, u32 bpp);
117int dp_link_process_request(struct dp_link *dp_link);
118int dp_link_get_colorimetry_config(struct dp_link *dp_link);
119int dp_link_adjust_levels(struct dp_link *dp_link, u8 *link_status);
120bool dp_link_send_test_response(struct dp_link *dp_link);
121int dp_link_psm_config(struct dp_link *dp_link,
122		struct dp_link_info *link_info, bool enable);
123bool dp_link_send_edid_checksum(struct dp_link *dp_link, u8 checksum);
124
125/**
126 * dp_link_get() - get the functionalities of dp test module
127 *
128 *
129 * return: a pointer to dp_link struct
130 */
131struct dp_link *dp_link_get(struct device *dev, struct drm_dp_aux *aux);
132
133#endif /* _DP_LINK_H_ */
134