2 * Copyright 2015 Advanced Micro Devices, Inc.
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:
11 * The above copyright notice and this permission notice shall be included in
12 * all copies or substantial portions of the Software.
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.
24 #ifndef PP_ATOMVOLTAGECTRL_H
25 #define PP_ATOMVOLTAGECTRL_H
29 #define MEM_TYPE_GDDR5 0x50
30 #define MEM_TYPE_GDDR4 0x40
31 #define MEM_TYPE_GDDR3 0x30
32 #define MEM_TYPE_DDR2 0x20
33 #define MEM_TYPE_GDDR1 0x10
34 #define MEM_TYPE_DDR3 0xb0
35 #define MEM_TYPE_MASK 0xF0
38 /* As returned from PowerConnectorDetectionTable. */
39 #define PP_ATOM_POWER_BUDGET_DISABLE_OVERDRIVE 0x80
40 #define PP_ATOM_POWER_BUDGET_SHOW_WARNING 0x40
41 #define PP_ATOM_POWER_BUDGET_SHOW_WAIVER 0x20
42 #define PP_ATOM_POWER_POWER_BUDGET_BEHAVIOUR 0x0F
44 /* New functions for Evergreen and beyond. */
45 #define PP_ATOMCTRL_MAX_VOLTAGE_ENTRIES 32
47 struct pp_atomctrl_clock_dividers {
48 uint32_t pll_post_divider;
49 uint32_t pll_feedback_divider;
50 uint32_t pll_ref_divider;
51 bool enable_post_divider;
54 typedef struct pp_atomctrl_clock_dividers pp_atomctrl_clock_dividers;
56 union pp_atomctrl_tcipll_fb_divider {
58 uint32_t ul_fb_div_frac : 14;
59 uint32_t ul_fb_div : 12;
62 uint32_t ul_fb_divider;
65 typedef union pp_atomctrl_tcipll_fb_divider pp_atomctrl_tcipll_fb_divider;
67 struct pp_atomctrl_clock_dividers_rv730 {
68 uint32_t pll_post_divider;
69 pp_atomctrl_tcipll_fb_divider mpll_feedback_divider;
70 uint32_t pll_ref_divider;
71 bool enable_post_divider;
75 typedef struct pp_atomctrl_clock_dividers_rv730 pp_atomctrl_clock_dividers_rv730;
78 struct pp_atomctrl_clock_dividers_kong {
79 uint32_t pll_post_divider;
82 typedef struct pp_atomctrl_clock_dividers_kong pp_atomctrl_clock_dividers_kong;
84 struct pp_atomctrl_clock_dividers_ci {
85 uint32_t pll_post_divider; /* post divider value */
87 pp_atomctrl_tcipll_fb_divider ul_fb_div; /* Output Parameter: PLL FB divider */
88 uint8_t uc_pll_ref_div; /* Output Parameter: PLL ref divider */
89 uint8_t uc_pll_post_div; /* Output Parameter: PLL post divider */
90 uint8_t uc_pll_cntl_flag; /*Output Flags: control flag */
92 typedef struct pp_atomctrl_clock_dividers_ci pp_atomctrl_clock_dividers_ci;
94 struct pp_atomctrl_clock_dividers_vi {
95 uint32_t pll_post_divider; /* post divider value */
97 pp_atomctrl_tcipll_fb_divider ul_fb_div; /*Output Parameter: PLL FB divider */
98 uint8_t uc_pll_ref_div; /*Output Parameter: PLL ref divider */
99 uint8_t uc_pll_post_div; /*Output Parameter: PLL post divider */
100 uint8_t uc_pll_cntl_flag; /*Output Flags: control flag */
102 typedef struct pp_atomctrl_clock_dividers_vi pp_atomctrl_clock_dividers_vi;
104 union pp_atomctrl_s_mpll_fb_divider {
107 uint32_t clk_frac : 12;
108 uint32_t un_used : 8;
110 uint32_t ul_fb_divider;
112 typedef union pp_atomctrl_s_mpll_fb_divider pp_atomctrl_s_mpll_fb_divider;
114 enum pp_atomctrl_spread_spectrum_mode {
115 pp_atomctrl_spread_spectrum_mode_down = 0,
116 pp_atomctrl_spread_spectrum_mode_center
118 typedef enum pp_atomctrl_spread_spectrum_mode pp_atomctrl_spread_spectrum_mode;
120 struct pp_atomctrl_memory_clock_param {
121 pp_atomctrl_s_mpll_fb_divider mpll_fb_divider;
122 uint32_t mpll_post_divider;
130 typedef struct pp_atomctrl_memory_clock_param pp_atomctrl_memory_clock_param;
132 struct pp_atomctrl_internal_ss_info {
133 uint32_t speed_spectrum_percentage; /* in 1/100 percentage */
134 uint32_t speed_spectrum_rate; /* in KHz */
135 pp_atomctrl_spread_spectrum_mode speed_spectrum_mode;
137 typedef struct pp_atomctrl_internal_ss_info pp_atomctrl_internal_ss_info;
139 #ifndef NUMBER_OF_M3ARB_PARAMS
140 #define NUMBER_OF_M3ARB_PARAMS 3
143 #ifndef NUMBER_OF_M3ARB_PARAM_SETS
144 #define NUMBER_OF_M3ARB_PARAM_SETS 10
147 struct pp_atomctrl_kong_system_info {
148 uint32_t ul_bootup_uma_clock; /* in 10kHz unit */
149 uint16_t us_max_nb_voltage; /* high NB voltage, calculated using current VDDNB (D24F2xDC) and VDDNB offset fuse; */
150 uint16_t us_min_nb_voltage; /* low NB voltage, calculated using current VDDNB (D24F2xDC) and VDDNB offset fuse; */
151 uint16_t us_bootup_nb_voltage; /* boot up NB voltage */
152 uint8_t uc_htc_tmp_lmt; /* bit [22:16] of D24F3x64 Hardware Thermal Control (HTC) Register, may not be needed, TBD */
153 uint8_t uc_tj_offset; /* bit [28:22] of D24F3xE4 Thermtrip Status Register,may not be needed, TBD */
154 /* 0: default 1: uvd 2: fs-3d */
155 uint32_t ul_csr_m3_srb_cntl[NUMBER_OF_M3ARB_PARAM_SETS][NUMBER_OF_M3ARB_PARAMS];/* arrays with values for CSR M3 arbiter for default */
157 typedef struct pp_atomctrl_kong_system_info pp_atomctrl_kong_system_info;
159 struct pp_atomctrl_memory_info {
160 uint8_t memory_vendor;
163 typedef struct pp_atomctrl_memory_info pp_atomctrl_memory_info;
165 #define MAX_AC_TIMING_ENTRIES 16
167 struct pp_atomctrl_memory_clock_range_table {
171 uint32_t mclk[MAX_AC_TIMING_ENTRIES];
173 typedef struct pp_atomctrl_memory_clock_range_table pp_atomctrl_memory_clock_range_table;
175 struct pp_atomctrl_voltage_table_entry {
180 typedef struct pp_atomctrl_voltage_table_entry pp_atomctrl_voltage_table_entry;
182 struct pp_atomctrl_voltage_table {
185 uint32_t phase_delay; /* Used for ATOM_GPIO_VOLTAGE_OBJECT_V3 and later */
186 pp_atomctrl_voltage_table_entry entries[PP_ATOMCTRL_MAX_VOLTAGE_ENTRIES];
189 typedef struct pp_atomctrl_voltage_table pp_atomctrl_voltage_table;
191 #define VBIOS_MC_REGISTER_ARRAY_SIZE 32
192 #define VBIOS_MAX_AC_TIMING_ENTRIES 20
194 struct pp_atomctrl_mc_reg_entry {
196 uint32_t mc_data[VBIOS_MC_REGISTER_ARRAY_SIZE];
198 typedef struct pp_atomctrl_mc_reg_entry pp_atomctrl_mc_reg_entry;
200 struct pp_atomctrl_mc_register_address {
202 uint8_t uc_pre_reg_data;
205 typedef struct pp_atomctrl_mc_register_address pp_atomctrl_mc_register_address;
207 struct pp_atomctrl_mc_reg_table {
208 uint8_t last; /* number of registers */
209 uint8_t num_entries; /* number of AC timing entries */
210 pp_atomctrl_mc_reg_entry mc_reg_table_entry[VBIOS_MAX_AC_TIMING_ENTRIES];
211 pp_atomctrl_mc_register_address mc_reg_address[VBIOS_MC_REGISTER_ARRAY_SIZE];
213 typedef struct pp_atomctrl_mc_reg_table pp_atomctrl_mc_reg_table;
215 struct pp_atomctrl_gpio_pin_assignment {
216 uint16_t us_gpio_pin_aindex;
217 uint8_t uc_gpio_pin_bit_shift;
219 typedef struct pp_atomctrl_gpio_pin_assignment pp_atomctrl_gpio_pin_assignment;
221 extern bool atomctrl_get_pp_assign_pin(struct pp_hwmgr *hwmgr, const uint32_t pinId, pp_atomctrl_gpio_pin_assignment *gpio_pin_assignment);
222 extern int atomctrl_get_voltage_evv_on_sclk(struct pp_hwmgr *hwmgr, uint8_t voltage_type, uint32_t sclk, uint16_t virtual_voltage_Id, uint16_t *voltage);
223 extern uint32_t atomctrl_get_mpll_reference_clock(struct pp_hwmgr *hwmgr);
224 extern int atomctrl_get_memory_clock_spread_spectrum(struct pp_hwmgr *hwmgr, const uint32_t memory_clock, pp_atomctrl_internal_ss_info *ssInfo);
225 extern int atomctrl_get_engine_clock_spread_spectrum(struct pp_hwmgr *hwmgr, const uint32_t engine_clock, pp_atomctrl_internal_ss_info *ssInfo);
226 extern int atomctrl_initialize_mc_reg_table(struct pp_hwmgr *hwmgr, uint8_t module_index, pp_atomctrl_mc_reg_table *table);
227 extern int atomctrl_set_engine_dram_timings_rv770(struct pp_hwmgr *hwmgr, uint32_t engine_clock, uint32_t memory_clock);
228 extern uint32_t atomctrl_get_reference_clock(struct pp_hwmgr *hwmgr);
229 extern int atomctrl_get_memory_pll_dividers_si(struct pp_hwmgr *hwmgr, uint32_t clock_value, pp_atomctrl_memory_clock_param *mpll_param, bool strobe_mode);
230 extern int atomctrl_get_engine_pll_dividers_vi(struct pp_hwmgr *hwmgr, uint32_t clock_value, pp_atomctrl_clock_dividers_vi *dividers);
231 extern int atomctrl_get_dfs_pll_dividers_vi(struct pp_hwmgr *hwmgr, uint32_t clock_value, pp_atomctrl_clock_dividers_vi *dividers);
232 extern bool atomctrl_is_voltage_controled_by_gpio_v3(struct pp_hwmgr *hwmgr, uint8_t voltage_type, uint8_t voltage_mode);
233 extern int atomctrl_get_voltage_table_v3(struct pp_hwmgr *hwmgr, uint8_t voltage_type, uint8_t voltage_mode, pp_atomctrl_voltage_table *voltage_table);
234 extern int atomctrl_get_memory_pll_dividers_vi(struct pp_hwmgr *hwmgr,
235 uint32_t clock_value, pp_atomctrl_memory_clock_param *mpll_param);
236 extern int atomctrl_get_engine_pll_dividers_kong(struct pp_hwmgr *hwmgr,
237 uint32_t clock_value,
238 pp_atomctrl_clock_dividers_kong *dividers);
239 extern int atomctrl_read_efuse(void *device, uint16_t start_index,
240 uint16_t end_index, uint32_t mask, uint32_t *efuse);
241 extern int atomctrl_calculate_voltage_evv_on_sclk(struct pp_hwmgr *hwmgr, uint8_t voltage_type,
242 uint32_t sclk, uint16_t virtual_voltage_Id, uint16_t *voltage, uint16_t dpm_level, bool debug);