1 /*
2  * Copyright 2013 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 
23 #ifndef _PPTABLE_H
24 #define _PPTABLE_H
25 
26 #pragma pack(1)
27 
28 typedef struct _ATOM_PPLIB_THERMALCONTROLLER
29 
30 {
31     UCHAR ucType;           // one of ATOM_PP_THERMALCONTROLLER_*
32     UCHAR ucI2cLine;        // as interpreted by DAL I2C
33     UCHAR ucI2cAddress;
34     UCHAR ucFanParameters;  // Fan Control Parameters.
35     UCHAR ucFanMinRPM;      // Fan Minimum RPM (hundreds) -- for display purposes only.
36     UCHAR ucFanMaxRPM;      // Fan Maximum RPM (hundreds) -- for display purposes only.
37     UCHAR ucReserved;       // ----
38     UCHAR ucFlags;          // to be defined
39 } ATOM_PPLIB_THERMALCONTROLLER;
40 
41 #define ATOM_PP_FANPARAMETERS_TACHOMETER_PULSES_PER_REVOLUTION_MASK 0x0f
42 #define ATOM_PP_FANPARAMETERS_NOFAN                                 0x80    // No fan is connected to this controller.
43 
44 #define ATOM_PP_THERMALCONTROLLER_NONE      0
45 #define ATOM_PP_THERMALCONTROLLER_LM63      1  // Not used by PPLib
46 #define ATOM_PP_THERMALCONTROLLER_ADM1032   2  // Not used by PPLib
47 #define ATOM_PP_THERMALCONTROLLER_ADM1030   3  // Not used by PPLib
48 #define ATOM_PP_THERMALCONTROLLER_MUA6649   4  // Not used by PPLib
49 #define ATOM_PP_THERMALCONTROLLER_LM64      5
50 #define ATOM_PP_THERMALCONTROLLER_F75375    6  // Not used by PPLib
51 #define ATOM_PP_THERMALCONTROLLER_RV6xx     7
52 #define ATOM_PP_THERMALCONTROLLER_RV770     8
53 #define ATOM_PP_THERMALCONTROLLER_ADT7473   9
54 #define ATOM_PP_THERMALCONTROLLER_KONG      10
55 #define ATOM_PP_THERMALCONTROLLER_EXTERNAL_GPIO     11
56 #define ATOM_PP_THERMALCONTROLLER_EVERGREEN 12
57 #define ATOM_PP_THERMALCONTROLLER_EMC2103   13  /* 0x0D */ // Only fan control will be implemented, do NOT show this in PPGen.
58 #define ATOM_PP_THERMALCONTROLLER_SUMO      14  /* 0x0E */ // Sumo type, used internally
59 #define ATOM_PP_THERMALCONTROLLER_NISLANDS  15
60 #define ATOM_PP_THERMALCONTROLLER_SISLANDS  16
61 #define ATOM_PP_THERMALCONTROLLER_LM96163   17
62 #define ATOM_PP_THERMALCONTROLLER_CISLANDS  18
63 #define ATOM_PP_THERMALCONTROLLER_KAVERI    19
64 #define ATOM_PP_THERMALCONTROLLER_ICELAND   20
65 #define ATOM_PP_THERMALCONTROLLER_TONGA     21
66 #define ATOM_PP_THERMALCONTROLLER_FIJI      22
67 #define ATOM_PP_THERMALCONTROLLER_POLARIS10 23
68 #define ATOM_PP_THERMALCONTROLLER_VEGA10    24
69 
70 
71 // Thermal controller 'combo type' to use an external controller for Fan control and an internal controller for thermal.
72 // We probably should reserve the bit 0x80 for this use.
73 // To keep the number of these types low we should also use the same code for all ASICs (i.e. do not distinguish RV6xx and RV7xx Internal here).
74 // The driver can pick the correct internal controller based on the ASIC.
75 #define ATOM_PP_THERMALCONTROLLER_ADT7473_WITH_INTERNAL   0x89    // ADT7473 Fan Control + Internal Thermal Controller
76 #define ATOM_PP_THERMALCONTROLLER_EMC2103_WITH_INTERNAL   0x8D    // EMC2103 Fan Control + Internal Thermal Controller
77 
78 typedef struct _ATOM_PPLIB_STATE
79 {
80     UCHAR ucNonClockStateIndex;
81     UCHAR ucClockStateIndices[]; // variable-sized
82 } ATOM_PPLIB_STATE;
83 
84 
85 typedef struct _ATOM_PPLIB_FANTABLE
86 {
87     UCHAR   ucFanTableFormat;                // Change this if the table format changes or version changes so that the other fields are not the same.
88     UCHAR   ucTHyst;                         // Temperature hysteresis. Integer.
89     USHORT  usTMin;                          // The temperature, in 0.01 centigrades, below which we just run at a minimal PWM.
90     USHORT  usTMed;                          // The middle temperature where we change slopes.
91     USHORT  usTHigh;                         // The high point above TMed for adjusting the second slope.
92     USHORT  usPWMMin;                        // The minimum PWM value in percent (0.01% increments).
93     USHORT  usPWMMed;                        // The PWM value (in percent) at TMed.
94     USHORT  usPWMHigh;                       // The PWM value at THigh.
95 } ATOM_PPLIB_FANTABLE;
96 
97 typedef struct _ATOM_PPLIB_FANTABLE2
98 {
99     ATOM_PPLIB_FANTABLE basicTable;
100     USHORT  usTMax;                          // The max temperature
101 } ATOM_PPLIB_FANTABLE2;
102 
103 typedef struct _ATOM_PPLIB_FANTABLE3
104 {
105 	ATOM_PPLIB_FANTABLE2 basicTable2;
106 	UCHAR ucFanControlMode;
107 	USHORT usFanPWMMax;
108 	USHORT usFanOutputSensitivity;
109 } ATOM_PPLIB_FANTABLE3;
110 
111 typedef struct _ATOM_PPLIB_FANTABLE4
112 {
113     ATOM_PPLIB_FANTABLE3 basicTable3;
114     USHORT  usFanRPMMax;
115 } ATOM_PPLIB_FANTABLE4;
116 
117 typedef struct _ATOM_PPLIB_FANTABLE5
118 {
119     ATOM_PPLIB_FANTABLE4 basicTable4;
120     USHORT  usFanCurrentLow;
121     USHORT  usFanCurrentHigh;
122     USHORT  usFanRPMLow;
123     USHORT  usFanRPMHigh;
124 } ATOM_PPLIB_FANTABLE5;
125 
126 typedef struct _ATOM_PPLIB_EXTENDEDHEADER
127 {
128     USHORT  usSize;
129     ULONG   ulMaxEngineClock;   // For Overdrive.
130     ULONG   ulMaxMemoryClock;   // For Overdrive.
131     // Add extra system parameters here, always adjust size to include all fields.
132     USHORT  usVCETableOffset; //points to ATOM_PPLIB_VCE_Table
133     USHORT  usUVDTableOffset;   //points to ATOM_PPLIB_UVD_Table
134     USHORT  usSAMUTableOffset;  //points to ATOM_PPLIB_SAMU_Table
135     USHORT  usPPMTableOffset;   //points to ATOM_PPLIB_PPM_Table
136     USHORT  usACPTableOffset;  //points to ATOM_PPLIB_ACP_Table
137     /* points to ATOM_PPLIB_POWERTUNE_Table */
138     USHORT  usPowerTuneTableOffset;
139     /* points to ATOM_PPLIB_CLOCK_Voltage_Dependency_Table for sclkVddgfxTable */
140     USHORT  usSclkVddgfxTableOffset;
141     USHORT  usVQBudgetingTableOffset; /* points to the vqBudgetingTable; */
142 } ATOM_PPLIB_EXTENDEDHEADER;
143 
144 //// ATOM_PPLIB_POWERPLAYTABLE::ulPlatformCaps
145 #define ATOM_PP_PLATFORM_CAP_BACKBIAS 1
146 #define ATOM_PP_PLATFORM_CAP_POWERPLAY 2
147 #define ATOM_PP_PLATFORM_CAP_SBIOSPOWERSOURCE 4
148 #define ATOM_PP_PLATFORM_CAP_ASPM_L0s 8
149 #define ATOM_PP_PLATFORM_CAP_ASPM_L1 16
150 #define ATOM_PP_PLATFORM_CAP_HARDWAREDC 32
151 #define ATOM_PP_PLATFORM_CAP_GEMINIPRIMARY 64
152 #define ATOM_PP_PLATFORM_CAP_STEPVDDC 128
153 #define ATOM_PP_PLATFORM_CAP_VOLTAGECONTROL 256
154 #define ATOM_PP_PLATFORM_CAP_SIDEPORTCONTROL 512
155 #define ATOM_PP_PLATFORM_CAP_TURNOFFPLL_ASPML1 1024
156 #define ATOM_PP_PLATFORM_CAP_HTLINKCONTROL 2048
157 #define ATOM_PP_PLATFORM_CAP_MVDDCONTROL 4096
158 #define ATOM_PP_PLATFORM_CAP_GOTO_BOOT_ON_ALERT 0x2000              // Go to boot state on alerts, e.g. on an AC->DC transition.
159 #define ATOM_PP_PLATFORM_CAP_DONT_WAIT_FOR_VBLANK_ON_ALERT 0x4000   // Do NOT wait for VBLANK during an alert (e.g. AC->DC transition).
160 #define ATOM_PP_PLATFORM_CAP_VDDCI_CONTROL 0x8000                   // Does the driver control VDDCI independently from VDDC.
161 #define ATOM_PP_PLATFORM_CAP_REGULATOR_HOT 0x00010000               // Enable the 'regulator hot' feature.
162 #define ATOM_PP_PLATFORM_CAP_BACO          0x00020000               // Does the driver supports BACO state.
163 #define ATOM_PP_PLATFORM_CAP_NEW_CAC_VOLTAGE   0x00040000           // Does the driver supports new CAC voltage table.
164 #define ATOM_PP_PLATFORM_CAP_REVERT_GPIO5_POLARITY   0x00080000     // Does the driver supports revert GPIO5 polarity.
165 #define ATOM_PP_PLATFORM_CAP_OUTPUT_THERMAL2GPIO17   0x00100000     // Does the driver supports thermal2GPIO17.
166 #define ATOM_PP_PLATFORM_CAP_VRHOT_GPIO_CONFIGURABLE   0x00200000   // Does the driver supports VR HOT GPIO Configurable.
167 #define ATOM_PP_PLATFORM_CAP_TEMP_INVERSION   0x00400000            // Does the driver supports Temp Inversion feature.
168 #define ATOM_PP_PLATFORM_CAP_EVV    0x00800000
169 #define ATOM_PP_PLATFORM_COMBINE_PCC_WITH_THERMAL_SIGNAL    0x01000000
170 #define ATOM_PP_PLATFORM_LOAD_POST_PRODUCTION_FIRMWARE    0x02000000
171 #define ATOM_PP_PLATFORM_CAP_DISABLE_USING_ACTUAL_TEMPERATURE_FOR_POWER_CALC   0x04000000
172 #define ATOM_PP_PLATFORM_CAP_VRHOT_POLARITY_HIGH   0x08000000
173 
174 typedef struct _ATOM_PPLIB_POWERPLAYTABLE
175 {
176       ATOM_COMMON_TABLE_HEADER sHeader;
177 
178       UCHAR ucDataRevision;
179 
180       UCHAR ucNumStates;
181       UCHAR ucStateEntrySize;
182       UCHAR ucClockInfoSize;
183       UCHAR ucNonClockSize;
184 
185       // offset from start of this table to array of ucNumStates ATOM_PPLIB_STATE structures
186       USHORT usStateArrayOffset;
187 
188       // offset from start of this table to array of ASIC-specific structures,
189       // currently ATOM_PPLIB_CLOCK_INFO.
190       USHORT usClockInfoArrayOffset;
191 
192       // offset from start of this table to array of ATOM_PPLIB_NONCLOCK_INFO
193       USHORT usNonClockInfoArrayOffset;
194 
195       USHORT usBackbiasTime;    // in microseconds
196       USHORT usVoltageTime;     // in microseconds
197       USHORT usTableSize;       //the size of this structure, or the extended structure
198 
199       ULONG ulPlatformCaps;            // See ATOM_PPLIB_CAPS_*
200 
201       ATOM_PPLIB_THERMALCONTROLLER    sThermalController;
202 
203       USHORT usBootClockInfoOffset;
204       USHORT usBootNonClockInfoOffset;
205 
206 } ATOM_PPLIB_POWERPLAYTABLE;
207 
208 typedef struct _ATOM_PPLIB_POWERPLAYTABLE2
209 {
210     ATOM_PPLIB_POWERPLAYTABLE basicTable;
211     UCHAR   ucNumCustomThermalPolicy;
212     USHORT  usCustomThermalPolicyArrayOffset;
213 }ATOM_PPLIB_POWERPLAYTABLE2, *LPATOM_PPLIB_POWERPLAYTABLE2;
214 
215 typedef struct _ATOM_PPLIB_POWERPLAYTABLE3
216 {
217     ATOM_PPLIB_POWERPLAYTABLE2 basicTable2;
218     USHORT                     usFormatID;                      // To be used ONLY by PPGen.
219     USHORT                     usFanTableOffset;
220     USHORT                     usExtendendedHeaderOffset;
221 } ATOM_PPLIB_POWERPLAYTABLE3, *LPATOM_PPLIB_POWERPLAYTABLE3;
222 
223 typedef struct _ATOM_PPLIB_POWERPLAYTABLE4
224 {
225     ATOM_PPLIB_POWERPLAYTABLE3 basicTable3;
226     ULONG                      ulGoldenPPID;                    // PPGen use only
227     ULONG                      ulGoldenRevision;                // PPGen use only
228     USHORT                     usVddcDependencyOnSCLKOffset;
229     USHORT                     usVddciDependencyOnMCLKOffset;
230     USHORT                     usVddcDependencyOnMCLKOffset;
231     USHORT                     usMaxClockVoltageOnDCOffset;
232     USHORT                     usVddcPhaseShedLimitsTableOffset;    // Points to ATOM_PPLIB_PhaseSheddingLimits_Table
233     USHORT                     usMvddDependencyOnMCLKOffset;
234 } ATOM_PPLIB_POWERPLAYTABLE4, *LPATOM_PPLIB_POWERPLAYTABLE4;
235 
236 typedef struct _ATOM_PPLIB_POWERPLAYTABLE5
237 {
238     ATOM_PPLIB_POWERPLAYTABLE4 basicTable4;
239     ULONG                      ulTDPLimit;
240     ULONG                      ulNearTDPLimit;
241     ULONG                      ulSQRampingThreshold;
242     USHORT                     usCACLeakageTableOffset;         // Points to ATOM_PPLIB_CAC_Leakage_Table
243     ULONG                      ulCACLeakage;                    // The iLeakage for driver calculated CAC leakage table
244     USHORT                     usTDPODLimit;
245     USHORT                     usLoadLineSlope;                 // in milliOhms * 100
246 } ATOM_PPLIB_POWERPLAYTABLE5, *LPATOM_PPLIB_POWERPLAYTABLE5;
247 
248 //// ATOM_PPLIB_NONCLOCK_INFO::usClassification
249 #define ATOM_PPLIB_CLASSIFICATION_UI_MASK          0x0007
250 #define ATOM_PPLIB_CLASSIFICATION_UI_SHIFT         0
251 #define ATOM_PPLIB_CLASSIFICATION_UI_NONE          0
252 #define ATOM_PPLIB_CLASSIFICATION_UI_BATTERY       1
253 #define ATOM_PPLIB_CLASSIFICATION_UI_BALANCED      3
254 #define ATOM_PPLIB_CLASSIFICATION_UI_PERFORMANCE   5
255 // 2, 4, 6, 7 are reserved
256 
257 #define ATOM_PPLIB_CLASSIFICATION_BOOT                   0x0008
258 #define ATOM_PPLIB_CLASSIFICATION_THERMAL                0x0010
259 #define ATOM_PPLIB_CLASSIFICATION_LIMITEDPOWERSOURCE     0x0020
260 #define ATOM_PPLIB_CLASSIFICATION_REST                   0x0040
261 #define ATOM_PPLIB_CLASSIFICATION_FORCED                 0x0080
262 #define ATOM_PPLIB_CLASSIFICATION_3DPERFORMANCE          0x0100
263 #define ATOM_PPLIB_CLASSIFICATION_OVERDRIVETEMPLATE      0x0200
264 #define ATOM_PPLIB_CLASSIFICATION_UVDSTATE               0x0400
265 #define ATOM_PPLIB_CLASSIFICATION_3DLOW                  0x0800
266 #define ATOM_PPLIB_CLASSIFICATION_ACPI                   0x1000
267 #define ATOM_PPLIB_CLASSIFICATION_HD2STATE               0x2000
268 #define ATOM_PPLIB_CLASSIFICATION_HDSTATE                0x4000
269 #define ATOM_PPLIB_CLASSIFICATION_SDSTATE                0x8000
270 
271 //// ATOM_PPLIB_NONCLOCK_INFO::usClassification2
272 #define ATOM_PPLIB_CLASSIFICATION2_LIMITEDPOWERSOURCE_2     0x0001
273 #define ATOM_PPLIB_CLASSIFICATION2_ULV                      0x0002
274 #define ATOM_PPLIB_CLASSIFICATION2_MVC                      0x0004   //Multi-View Codec (BD-3D)
275 
276 //// ATOM_PPLIB_NONCLOCK_INFO::ulCapsAndSettings
277 #define ATOM_PPLIB_SINGLE_DISPLAY_ONLY           0x00000001
278 #define ATOM_PPLIB_SUPPORTS_VIDEO_PLAYBACK         0x00000002
279 
280 // 0 is 2.5Gb/s, 1 is 5Gb/s
281 #define ATOM_PPLIB_PCIE_LINK_SPEED_MASK            0x00000004
282 #define ATOM_PPLIB_PCIE_LINK_SPEED_SHIFT           2
283 
284 // lanes - 1: 1, 2, 4, 8, 12, 16 permitted by PCIE spec
285 #define ATOM_PPLIB_PCIE_LINK_WIDTH_MASK            0x000000F8
286 #define ATOM_PPLIB_PCIE_LINK_WIDTH_SHIFT           3
287 
288 // lookup into reduced refresh-rate table
289 #define ATOM_PPLIB_LIMITED_REFRESHRATE_VALUE_MASK  0x00000F00
290 #define ATOM_PPLIB_LIMITED_REFRESHRATE_VALUE_SHIFT 8
291 
292 #define ATOM_PPLIB_LIMITED_REFRESHRATE_UNLIMITED    0
293 #define ATOM_PPLIB_LIMITED_REFRESHRATE_50HZ         1
294 // 2-15 TBD as needed.
295 
296 #define ATOM_PPLIB_SOFTWARE_DISABLE_LOADBALANCING        0x00001000
297 #define ATOM_PPLIB_SOFTWARE_ENABLE_SLEEP_FOR_TIMESTAMPS  0x00002000
298 
299 #define ATOM_PPLIB_DISALLOW_ON_DC                       0x00004000
300 
301 #define ATOM_PPLIB_ENABLE_VARIBRIGHT                     0x00008000
302 
303 //memory related flags
304 #define ATOM_PPLIB_SWSTATE_MEMORY_DLL_OFF               0x000010000
305 
306 //M3 Arb    //2bits, current 3 sets of parameters in total
307 #define ATOM_PPLIB_M3ARB_MASK                       0x00060000
308 #define ATOM_PPLIB_M3ARB_SHIFT                      17
309 
310 #define ATOM_PPLIB_ENABLE_DRR                       0x00080000
311 
312 // remaining 16 bits are reserved
313 typedef struct _ATOM_PPLIB_THERMAL_STATE
314 {
315     UCHAR   ucMinTemperature;
316     UCHAR   ucMaxTemperature;
317     UCHAR   ucThermalAction;
318 }ATOM_PPLIB_THERMAL_STATE, *LPATOM_PPLIB_THERMAL_STATE;
319 
320 // Contained in an array starting at the offset
321 // in ATOM_PPLIB_POWERPLAYTABLE::usNonClockInfoArrayOffset.
322 // referenced from ATOM_PPLIB_STATE_INFO::ucNonClockStateIndex
323 #define ATOM_PPLIB_NONCLOCKINFO_VER1      12
324 #define ATOM_PPLIB_NONCLOCKINFO_VER2      24
325 typedef struct _ATOM_PPLIB_NONCLOCK_INFO
326 {
327       USHORT usClassification;
328       UCHAR  ucMinTemperature;
329       UCHAR  ucMaxTemperature;
330       ULONG  ulCapsAndSettings;
331       UCHAR  ucRequiredPower;
332       USHORT usClassification2;
333       ULONG  ulVCLK;
334       ULONG  ulDCLK;
335       UCHAR  ucUnused[5];
336 } ATOM_PPLIB_NONCLOCK_INFO;
337 
338 // Contained in an array starting at the offset
339 // in ATOM_PPLIB_POWERPLAYTABLE::usClockInfoArrayOffset.
340 // referenced from ATOM_PPLIB_STATE::ucClockStateIndices
341 typedef struct _ATOM_PPLIB_R600_CLOCK_INFO
342 {
343       USHORT usEngineClockLow;
344       UCHAR ucEngineClockHigh;
345 
346       USHORT usMemoryClockLow;
347       UCHAR ucMemoryClockHigh;
348 
349       USHORT usVDDC;
350       USHORT usUnused1;
351       USHORT usUnused2;
352 
353       ULONG ulFlags; // ATOM_PPLIB_R600_FLAGS_*
354 
355 } ATOM_PPLIB_R600_CLOCK_INFO;
356 
357 // ulFlags in ATOM_PPLIB_R600_CLOCK_INFO
358 #define ATOM_PPLIB_R600_FLAGS_PCIEGEN2          1
359 #define ATOM_PPLIB_R600_FLAGS_UVDSAFE           2
360 #define ATOM_PPLIB_R600_FLAGS_BACKBIASENABLE    4
361 #define ATOM_PPLIB_R600_FLAGS_MEMORY_ODT_OFF    8
362 #define ATOM_PPLIB_R600_FLAGS_MEMORY_DLL_OFF   16
363 #define ATOM_PPLIB_R600_FLAGS_LOWPOWER         32   // On the RV770 use 'low power' setting (sequencer S0).
364 
365 typedef struct _ATOM_PPLIB_RS780_CLOCK_INFO
366 
367 {
368       USHORT usLowEngineClockLow;         // Low Engine clock in MHz (the same way as on the R600).
369       UCHAR  ucLowEngineClockHigh;
370       USHORT usHighEngineClockLow;        // High Engine clock in MHz.
371       UCHAR  ucHighEngineClockHigh;
372       USHORT usMemoryClockLow;            // For now one of the ATOM_PPLIB_RS780_SPMCLK_XXXX constants.
373       UCHAR  ucMemoryClockHigh;           // Currentyl unused.
374       UCHAR  ucPadding;                   // For proper alignment and size.
375       USHORT usVDDC;                      // For the 780, use: None, Low, High, Variable
376       UCHAR  ucMaxHTLinkWidth;            // From SBIOS - {2, 4, 8, 16}
377       UCHAR  ucMinHTLinkWidth;            // From SBIOS - {2, 4, 8, 16}. Effective only if CDLW enabled. Minimum down stream width could
378       USHORT usHTLinkFreq;                // See definition ATOM_PPLIB_RS780_HTLINKFREQ_xxx or in MHz(>=200).
379       ULONG  ulFlags;
380 } ATOM_PPLIB_RS780_CLOCK_INFO;
381 
382 #define ATOM_PPLIB_RS780_VOLTAGE_NONE       0
383 #define ATOM_PPLIB_RS780_VOLTAGE_LOW        1
384 #define ATOM_PPLIB_RS780_VOLTAGE_HIGH       2
385 #define ATOM_PPLIB_RS780_VOLTAGE_VARIABLE   3
386 
387 #define ATOM_PPLIB_RS780_SPMCLK_NONE        0   // We cannot change the side port memory clock, leave it as it is.
388 #define ATOM_PPLIB_RS780_SPMCLK_LOW         1
389 #define ATOM_PPLIB_RS780_SPMCLK_HIGH        2
390 
391 #define ATOM_PPLIB_RS780_HTLINKFREQ_NONE       0
392 #define ATOM_PPLIB_RS780_HTLINKFREQ_LOW        1
393 #define ATOM_PPLIB_RS780_HTLINKFREQ_HIGH       2
394 
395 typedef struct _ATOM_PPLIB_EVERGREEN_CLOCK_INFO
396 {
397       USHORT usEngineClockLow;
398       UCHAR  ucEngineClockHigh;
399 
400       USHORT usMemoryClockLow;
401       UCHAR  ucMemoryClockHigh;
402 
403       USHORT usVDDC;
404       USHORT usVDDCI;
405       USHORT usUnused;
406 
407       ULONG ulFlags; // ATOM_PPLIB_R600_FLAGS_*
408 
409 } ATOM_PPLIB_EVERGREEN_CLOCK_INFO;
410 
411 typedef struct _ATOM_PPLIB_SI_CLOCK_INFO
412 {
413       USHORT usEngineClockLow;
414       UCHAR  ucEngineClockHigh;
415 
416       USHORT usMemoryClockLow;
417       UCHAR  ucMemoryClockHigh;
418 
419       USHORT usVDDC;
420       USHORT usVDDCI;
421       UCHAR  ucPCIEGen;
422       UCHAR  ucUnused1;
423 
424       ULONG ulFlags; // ATOM_PPLIB_SI_FLAGS_*, no flag is necessary for now
425 
426 } ATOM_PPLIB_SI_CLOCK_INFO;
427 
428 typedef struct _ATOM_PPLIB_CI_CLOCK_INFO
429 {
430       USHORT usEngineClockLow;
431       UCHAR  ucEngineClockHigh;
432 
433       USHORT usMemoryClockLow;
434       UCHAR  ucMemoryClockHigh;
435 
436       UCHAR  ucPCIEGen;
437       USHORT usPCIELane;
438 } ATOM_PPLIB_CI_CLOCK_INFO;
439 
440 typedef struct _ATOM_PPLIB_SUMO_CLOCK_INFO{
441       USHORT usEngineClockLow;  //clockfrequency & 0xFFFF. The unit is in 10khz
442       UCHAR  ucEngineClockHigh; //clockfrequency >> 16.
443       UCHAR  vddcIndex;         //2-bit vddc index;
444       USHORT tdpLimit;
445       //please initalize to 0
446       USHORT rsv1;
447       //please initialize to 0s
448       ULONG rsv2[2];
449 }ATOM_PPLIB_SUMO_CLOCK_INFO;
450 
451 typedef struct _ATOM_PPLIB_KV_CLOCK_INFO {
452       USHORT usEngineClockLow;
453       UCHAR  ucEngineClockHigh;
454       UCHAR  vddcIndex;
455       USHORT tdpLimit;
456       USHORT rsv1;
457       ULONG rsv2[2];
458 } ATOM_PPLIB_KV_CLOCK_INFO;
459 
460 typedef struct _ATOM_PPLIB_CZ_CLOCK_INFO {
461       UCHAR index;
462       UCHAR rsv[3];
463 } ATOM_PPLIB_CZ_CLOCK_INFO;
464 
465 typedef struct _ATOM_PPLIB_STATE_V2
466 {
467       //number of valid dpm levels in this state; Driver uses it to calculate the whole
468       //size of the state: sizeof(ATOM_PPLIB_STATE_V2) + (ucNumDPMLevels - 1) * sizeof(UCHAR)
469       UCHAR ucNumDPMLevels;
470 
471       //a index to the array of nonClockInfos
472       UCHAR nonClockInfoIndex;
473       /**
474       * Driver will read the first ucNumDPMLevels in this array
475       */
476       UCHAR clockInfoIndex[];
477 } ATOM_PPLIB_STATE_V2;
478 
479 typedef struct _StateArray{
480     //how many states we have
481     UCHAR ucNumEntries;
482 
483     ATOM_PPLIB_STATE_V2 states[1];
484 }StateArray;
485 
486 
487 typedef struct _ClockInfoArray{
488     //how many clock levels we have
489     UCHAR ucNumEntries;
490 
491     //sizeof(ATOM_PPLIB_CLOCK_INFO)
492     UCHAR ucEntrySize;
493 
494     UCHAR clockInfo[1];
495 }ClockInfoArray;
496 
497 typedef struct _NonClockInfoArray{
498 
499     //how many non-clock levels we have. normally should be same as number of states
500     UCHAR ucNumEntries;
501     //sizeof(ATOM_PPLIB_NONCLOCK_INFO)
502     UCHAR ucEntrySize;
503 
504     ATOM_PPLIB_NONCLOCK_INFO nonClockInfo[1];
505 }NonClockInfoArray;
506 
507 typedef struct _ATOM_PPLIB_Clock_Voltage_Dependency_Record
508 {
509     USHORT usClockLow;
510     UCHAR  ucClockHigh;
511     USHORT usVoltage;
512 }ATOM_PPLIB_Clock_Voltage_Dependency_Record;
513 
514 typedef struct _ATOM_PPLIB_Clock_Voltage_Dependency_Table
515 {
516     UCHAR ucNumEntries;                                                // Number of entries.
517     ATOM_PPLIB_Clock_Voltage_Dependency_Record entries[1];             // Dynamically allocate entries.
518 }ATOM_PPLIB_Clock_Voltage_Dependency_Table;
519 
520 typedef struct _ATOM_PPLIB_Clock_Voltage_Limit_Record
521 {
522     USHORT usSclkLow;
523     UCHAR  ucSclkHigh;
524     USHORT usMclkLow;
525     UCHAR  ucMclkHigh;
526     USHORT usVddc;
527     USHORT usVddci;
528 }ATOM_PPLIB_Clock_Voltage_Limit_Record;
529 
530 typedef struct _ATOM_PPLIB_Clock_Voltage_Limit_Table
531 {
532     UCHAR ucNumEntries;                                                // Number of entries.
533     ATOM_PPLIB_Clock_Voltage_Limit_Record entries[1];                  // Dynamically allocate entries.
534 }ATOM_PPLIB_Clock_Voltage_Limit_Table;
535 
536 union _ATOM_PPLIB_CAC_Leakage_Record
537 {
538     struct
539     {
540         USHORT usVddc;          // We use this field for the "fake" standardized VDDC for power calculations; For CI and newer, we use this as the real VDDC value. in CI we read it as StdVoltageHiSidd
541         ULONG  ulLeakageValue;  // For CI and newer we use this as the "fake" standar VDDC value. in CI we read it as StdVoltageLoSidd
542 
543     };
544     struct
545      {
546         USHORT usVddc1;
547         USHORT usVddc2;
548         USHORT usVddc3;
549      };
550 };
551 
552 typedef union _ATOM_PPLIB_CAC_Leakage_Record ATOM_PPLIB_CAC_Leakage_Record;
553 
554 typedef struct _ATOM_PPLIB_CAC_Leakage_Table
555 {
556     UCHAR ucNumEntries;                                                 // Number of entries.
557     ATOM_PPLIB_CAC_Leakage_Record entries[1];                           // Dynamically allocate entries.
558 }ATOM_PPLIB_CAC_Leakage_Table;
559 
560 typedef struct _ATOM_PPLIB_PhaseSheddingLimits_Record
561 {
562     USHORT usVoltage;
563     USHORT usSclkLow;
564     UCHAR  ucSclkHigh;
565     USHORT usMclkLow;
566     UCHAR  ucMclkHigh;
567 }ATOM_PPLIB_PhaseSheddingLimits_Record;
568 
569 typedef struct _ATOM_PPLIB_PhaseSheddingLimits_Table
570 {
571     UCHAR ucNumEntries;                                                 // Number of entries.
572     ATOM_PPLIB_PhaseSheddingLimits_Record entries[1];                   // Dynamically allocate entries.
573 }ATOM_PPLIB_PhaseSheddingLimits_Table;
574 
575 typedef struct _VCEClockInfo{
576     USHORT usEVClkLow;
577     UCHAR  ucEVClkHigh;
578     USHORT usECClkLow;
579     UCHAR  ucECClkHigh;
580 }VCEClockInfo;
581 
582 typedef struct _VCEClockInfoArray{
583     UCHAR ucNumEntries;
584     VCEClockInfo entries[1];
585 }VCEClockInfoArray;
586 
587 typedef struct _ATOM_PPLIB_VCE_Clock_Voltage_Limit_Record
588 {
589     USHORT usVoltage;
590     UCHAR  ucVCEClockInfoIndex;
591 }ATOM_PPLIB_VCE_Clock_Voltage_Limit_Record;
592 
593 typedef struct _ATOM_PPLIB_VCE_Clock_Voltage_Limit_Table
594 {
595     UCHAR numEntries;
596     ATOM_PPLIB_VCE_Clock_Voltage_Limit_Record entries[1];
597 }ATOM_PPLIB_VCE_Clock_Voltage_Limit_Table;
598 
599 typedef struct _ATOM_PPLIB_VCE_State_Record
600 {
601     UCHAR  ucVCEClockInfoIndex;
602     UCHAR  ucClockInfoIndex; //highest 2 bits indicates memory p-states, lower 6bits indicates index to ClockInfoArrary
603 }ATOM_PPLIB_VCE_State_Record;
604 
605 typedef struct _ATOM_PPLIB_VCE_State_Table
606 {
607     UCHAR numEntries;
608     ATOM_PPLIB_VCE_State_Record entries[1];
609 }ATOM_PPLIB_VCE_State_Table;
610 
611 
612 typedef struct _ATOM_PPLIB_VCE_Table
613 {
614       UCHAR revid;
615 //    VCEClockInfoArray array;
616 //    ATOM_PPLIB_VCE_Clock_Voltage_Limit_Table limits;
617 //    ATOM_PPLIB_VCE_State_Table states;
618 }ATOM_PPLIB_VCE_Table;
619 
620 
621 typedef struct _UVDClockInfo{
622     USHORT usVClkLow;
623     UCHAR  ucVClkHigh;
624     USHORT usDClkLow;
625     UCHAR  ucDClkHigh;
626 }UVDClockInfo;
627 
628 typedef struct _UVDClockInfoArray{
629     UCHAR ucNumEntries;
630     UVDClockInfo entries[1];
631 }UVDClockInfoArray;
632 
633 typedef struct _ATOM_PPLIB_UVD_Clock_Voltage_Limit_Record
634 {
635     USHORT usVoltage;
636     UCHAR  ucUVDClockInfoIndex;
637 }ATOM_PPLIB_UVD_Clock_Voltage_Limit_Record;
638 
639 typedef struct _ATOM_PPLIB_UVD_Clock_Voltage_Limit_Table
640 {
641     UCHAR numEntries;
642     ATOM_PPLIB_UVD_Clock_Voltage_Limit_Record entries[1];
643 }ATOM_PPLIB_UVD_Clock_Voltage_Limit_Table;
644 
645 typedef struct _ATOM_PPLIB_UVD_Table
646 {
647       UCHAR revid;
648 //    UVDClockInfoArray array;
649 //    ATOM_PPLIB_UVD_Clock_Voltage_Limit_Table limits;
650 }ATOM_PPLIB_UVD_Table;
651 
652 typedef struct _ATOM_PPLIB_SAMClk_Voltage_Limit_Record
653 {
654       USHORT usVoltage;
655       USHORT usSAMClockLow;
656       UCHAR  ucSAMClockHigh;
657 }ATOM_PPLIB_SAMClk_Voltage_Limit_Record;
658 
659 typedef struct _ATOM_PPLIB_SAMClk_Voltage_Limit_Table{
660     UCHAR numEntries;
661     ATOM_PPLIB_SAMClk_Voltage_Limit_Record entries[1];
662 }ATOM_PPLIB_SAMClk_Voltage_Limit_Table;
663 
664 typedef struct _ATOM_PPLIB_SAMU_Table
665 {
666       UCHAR revid;
667       ATOM_PPLIB_SAMClk_Voltage_Limit_Table limits;
668 }ATOM_PPLIB_SAMU_Table;
669 
670 typedef struct _ATOM_PPLIB_ACPClk_Voltage_Limit_Record
671 {
672       USHORT usVoltage;
673       USHORT usACPClockLow;
674       UCHAR  ucACPClockHigh;
675 }ATOM_PPLIB_ACPClk_Voltage_Limit_Record;
676 
677 typedef struct _ATOM_PPLIB_ACPClk_Voltage_Limit_Table{
678     UCHAR numEntries;
679     ATOM_PPLIB_ACPClk_Voltage_Limit_Record entries[1];
680 }ATOM_PPLIB_ACPClk_Voltage_Limit_Table;
681 
682 typedef struct _ATOM_PPLIB_ACP_Table
683 {
684       UCHAR revid;
685       ATOM_PPLIB_ACPClk_Voltage_Limit_Table limits;
686 }ATOM_PPLIB_ACP_Table;
687 
688 typedef struct _ATOM_PowerTune_Table{
689     USHORT usTDP;
690     USHORT usConfigurableTDP;
691     USHORT usTDC;
692     USHORT usBatteryPowerLimit;
693     USHORT usSmallPowerLimit;
694     USHORT usLowCACLeakage;
695     USHORT usHighCACLeakage;
696 }ATOM_PowerTune_Table;
697 
698 typedef struct _ATOM_PPLIB_POWERTUNE_Table
699 {
700       UCHAR revid;
701       ATOM_PowerTune_Table power_tune_table;
702 }ATOM_PPLIB_POWERTUNE_Table;
703 
704 typedef struct _ATOM_PPLIB_POWERTUNE_Table_V1
705 {
706       UCHAR revid;
707       ATOM_PowerTune_Table power_tune_table;
708       USHORT usMaximumPowerDeliveryLimit;
709       USHORT usTjMax;
710       USHORT usReserve[6];
711 } ATOM_PPLIB_POWERTUNE_Table_V1;
712 
713 #define ATOM_PPM_A_A    1
714 #define ATOM_PPM_A_I    2
715 typedef struct _ATOM_PPLIB_PPM_Table
716 {
717       UCHAR  ucRevId;
718       UCHAR  ucPpmDesign;          //A+I or A+A
719       USHORT usCpuCoreNumber;
720       ULONG  ulPlatformTDP;
721       ULONG  ulSmallACPlatformTDP;
722       ULONG  ulPlatformTDC;
723       ULONG  ulSmallACPlatformTDC;
724       ULONG  ulApuTDP;
725       ULONG  ulDGpuTDP;
726       ULONG  ulDGpuUlvPower;
727       ULONG  ulTjmax;
728 } ATOM_PPLIB_PPM_Table;
729 
730 #define    VQ_DisplayConfig_NoneAWD   1
731 #define    VQ_DisplayConfig_AWD       2
732 
733 typedef struct ATOM_PPLIB_VQ_Budgeting_Record{
734     ULONG ulDeviceID;
735     ULONG ulSustainableSOCPowerLimitLow; /* in mW */
736     ULONG ulSustainableSOCPowerLimitHigh; /* in mW */
737 
738     ULONG ulDClk;
739     ULONG ulEClk;
740     ULONG ulDispSclk;
741     UCHAR ucDispConfig;
742 
743 } ATOM_PPLIB_VQ_Budgeting_Record;
744 
745 typedef struct ATOM_PPLIB_VQ_Budgeting_Table {
746     UCHAR revid;
747     UCHAR numEntries;
748     ATOM_PPLIB_VQ_Budgeting_Record         entries[1];
749 } ATOM_PPLIB_VQ_Budgeting_Table;
750 
751 #pragma pack()
752 
753 #endif
754