1 /*
2  * Copyright 2015 Advanced Micro Devices, Inc.
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice shall be included in
12  * all copies or substantial portions of the Software.
13  *
14  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
17  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
18  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20  * OTHER DEALINGS IN THE SOFTWARE.
21  *
22  * Authors: AMD
23  *
24  */
25 
26 #ifndef __DC_LINK_HWSS_H__
27 #define __DC_LINK_HWSS_H__
28 
29 struct gpio *get_hpd_gpio(struct dc_bios *dcb,
30 		struct graphics_object_id link_id,
31 		struct gpio_service *gpio_service);
32 
33 void dp_enable_link_phy(
34 	struct dc_link *link,
35 	const struct link_resource *link_res,
36 	enum signal_type signal,
37 	enum clock_source_id clock_source,
38 	const struct dc_link_settings *link_settings);
39 
40 void dp_receiver_power_ctrl(struct dc_link *link, bool on);
41 void dp_source_sequence_trace(struct dc_link *link, uint8_t dp_test_mode);
42 void edp_add_delay_for_T9(struct dc_link *link);
43 bool edp_receiver_ready_T9(struct dc_link *link);
44 bool edp_receiver_ready_T7(struct dc_link *link);
45 
46 void dp_disable_link_phy(struct dc_link *link, const struct link_resource *link_res,
47 		enum signal_type signal);
48 
49 void dp_disable_link_phy_mst(struct dc_link *link, const struct link_resource *link_res,
50 		enum signal_type signal);
51 
52 bool dp_set_hw_training_pattern(
53 	struct dc_link *link,
54 	const struct link_resource *link_res,
55 	enum dc_dp_training_pattern pattern,
56 	uint32_t offset);
57 
58 void dp_set_hw_lane_settings(
59 	struct dc_link *link,
60 	const struct link_resource *link_res,
61 	const struct link_training_settings *link_settings,
62 	uint32_t offset);
63 
64 void dp_set_hw_test_pattern(
65 	struct dc_link *link,
66 	const struct link_resource *link_res,
67 	enum dp_test_pattern test_pattern,
68 	uint8_t *custom_pattern,
69 	uint32_t custom_pattern_size);
70 
71 void dp_retrain_link_dp_test(struct dc_link *link,
72 		struct dc_link_settings *link_setting,
73 		bool skip_video_pattern);
74 
75 struct dc_link;
76 struct link_resource;
77 struct fixed31_32;
78 struct pipe_ctx;
79 
80 struct link_hwss {
81 	/* you must define a dummy implementation and assign the function to
82 	 * dummy_link_hwss if you don't want to check for NULL pointer
83 	 */
84 	void (*set_throttled_vcp_size)(struct pipe_ctx *pipe_ctx,
85 			struct fixed31_32 throttled_vcp_size);
86 
87 	/* function pointers below this point require check for NULL
88 	 * *********************************************************************
89 	 */
90 	void (*set_hblank_min_symbol_width)(struct pipe_ctx *pipe_ctx,
91 			const struct dc_link_settings *link_settings,
92 			struct fixed31_32 throttled_vcp_size);
93 };
94 
95 const struct link_hwss *dc_link_hwss_get(const struct dc_link *link, const struct link_resource *link_res);
96 
97 #endif /* __DC_LINK_HWSS_H__ */
98