xref: /linux/drivers/gpu/drm/amd/display/modules/power/power_helpers.h (revision c06b6cde2a1c3bcbb561bd57bb6f34eae9030921)
1 /* Copyright 2018 Advanced Micro Devices, Inc.
2  *
3  * Permission is hereby granted, free of charge, to any person obtaining a
4  * copy of this software and associated documentation files (the "Software"),
5  * to deal in the Software without restriction, including without limitation
6  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
7  * and/or sell copies of the Software, and to permit persons to whom the
8  * Software is furnished to do so, subject to the following conditions:
9  *
10  * The above copyright notice and this permission notice shall be included in
11  * all copies or substantial portions of the Software.
12  *
13  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
14  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
15  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
16  * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
17  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
18  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
19  * OTHER DEALINGS IN THE SOFTWARE.
20  *
21  * Authors: AMD
22  *
23  */
24 
25 #ifndef MODULES_POWER_POWER_HELPERS_H_
26 #define MODULES_POWER_POWER_HELPERS_H_
27 
28 #include "dc/inc/hw/dmcu.h"
29 #include "dc/inc/hw/abm.h"
30 #include "dc/inc/core_types.h"
31 #include "mod_power.h"
32 
33 struct resource_pool;
34 
35 
36 enum abm_defines {
37 	abm_defines_max_level = 4,
38 	abm_defines_max_config = 4,
39 };
40 
41 struct dmcu_iram_parameters {
42 	unsigned int *backlight_lut_array;
43 	unsigned int backlight_lut_array_size;
44 	bool backlight_ramping_override;
45 	unsigned int backlight_ramping_reduction;
46 	unsigned int backlight_ramping_start;
47 	unsigned int min_abm_backlight;
48 	unsigned int set;
49 };
50 
51 bool dmcu_load_iram(struct dmcu *dmcu,
52 		struct dmcu_iram_parameters params);
53 bool dmub_init_abm_config(struct resource_pool *res_pool,
54 		struct dmcu_iram_parameters params,
55 		unsigned int inst);
56 
57 void init_replay_config(struct dc_link *link, struct replay_config *pr_config);
58 void set_replay_coasting_vtotal(struct dc_link *link,
59 	enum replay_coasting_vtotal_type type,
60 	uint32_t vtotal);
61 void set_replay_defer_update_coasting_vtotal(struct dc_link *link,
62 	enum replay_coasting_vtotal_type type,
63 	uint32_t vtotal);
64 void set_replay_frame_skip_number(struct dc_link *link,
65 	enum replay_coasting_vtotal_type type,
66 	uint32_t coasting_vtotal_refresh_rate_Mhz,
67 	uint32_t flicker_free_refresh_rate_Mhz,
68 	bool is_defer);
69 void update_replay_coasting_vtotal_from_defer(struct dc_link *link,
70 	enum replay_coasting_vtotal_type type);
71 void set_replay_low_rr_full_screen_video_src_vtotal(struct dc_link *link, uint16_t vtotal);
72 void calculate_replay_link_off_frame_count(struct dc_link *link,
73 	uint16_t vtotal, uint16_t htotal);
74 
75 bool is_psr_su_specific_panel(struct dc_link *link);
76 void mod_power_calc_psr_configs(struct psr_config *psr_config,
77 		struct dc_link *link,
78 		const struct dc_stream_state *stream);
79 bool mod_power_only_edp(const struct dc_state *context,
80 		const struct dc_stream_state *stream);
81 bool psr_su_set_dsc_slice_height(struct dc *dc, struct dc_link *link,
82 			      struct dc_stream_state *stream,
83 			      struct psr_config *config);
84 
85 bool fill_custom_backlight_caps(unsigned int config_no,
86 		struct dm_acpi_atif_backlight_caps *caps);
87 void reset_replay_dsync_error_count(struct dc_link *link);
88 void change_replay_to_psr(struct dc_link *link);
89 void change_psr_to_replay(struct dc_link *link);
90 #endif /* MODULES_POWER_POWER_HELPERS_H_ */
91