power_helpers.h

 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
32struct resource_pool;
33
34
35enum abm_defines {
36	abm_defines_max_level = 4,
37	abm_defines_max_config = 4,
38};
39
40struct dmcu_iram_parameters {
41	unsigned int *backlight_lut_array;
42	unsigned int backlight_lut_array_size;
43	bool backlight_ramping_override;
44	unsigned int backlight_ramping_reduction;
45	unsigned int backlight_ramping_start;
46	unsigned int min_abm_backlight;
47	unsigned int set;
48};
49
50bool dmcu_load_iram(struct dmcu *dmcu,
51		struct dmcu_iram_parameters params);
52bool dmub_init_abm_config(struct resource_pool *res_pool,
53		struct dmcu_iram_parameters params,
54		unsigned int inst);
55
56void init_replay_config(struct dc_link *link, struct replay_config *pr_config);
57void set_replay_coasting_vtotal(struct dc_link *link,
58	enum replay_coasting_vtotal_type type,
59	uint32_t vtotal);
60void set_replay_defer_update_coasting_vtotal(struct dc_link *link,
61	enum replay_coasting_vtotal_type type,
62	uint32_t vtotal);
63void set_replay_frame_skip_number(struct dc_link *link,
64	enum replay_coasting_vtotal_type type,
65	uint32_t coasting_vtotal_refresh_rate_Mhz,
66	uint32_t flicker_free_refresh_rate_Mhz,
67	bool is_defer);
68void update_replay_coasting_vtotal_from_defer(struct dc_link *link,
69	enum replay_coasting_vtotal_type type);
70void set_replay_low_rr_full_screen_video_src_vtotal(struct dc_link *link, uint16_t vtotal);
71void calculate_replay_link_off_frame_count(struct dc_link *link,
72	uint16_t vtotal, uint16_t htotal);
73
74bool is_psr_su_specific_panel(struct dc_link *link);
75void mod_power_calc_psr_configs(struct psr_config *psr_config,
76		struct dc_link *link,
77		const struct dc_stream_state *stream);
78bool mod_power_only_edp(const struct dc_state *context,
79		const struct dc_stream_state *stream);
80bool psr_su_set_dsc_slice_height(struct dc *dc, struct dc_link *link,
81			      struct dc_stream_state *stream,
82			      struct psr_config *config);
83
84bool fill_custom_backlight_caps(unsigned int config_no,
85		struct dm_acpi_atif_backlight_caps *caps);
86void reset_replay_dsync_error_count(struct dc_link *link);
87void change_replay_to_psr(struct dc_link *link);
88void change_psr_to_replay(struct dc_link *link);
89#endif /* MODULES_POWER_POWER_HELPERS_H_ */