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