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[] /* __counted_by(ucNumEntries) */; 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[]; 495 }ClockInfoArray; 496 497 typedef struct _NonClockInfoArray{ 498 //how many non-clock levels we have. normally should be same as number of states 499 UCHAR ucNumEntries; 500 //sizeof(ATOM_PPLIB_NONCLOCK_INFO) 501 UCHAR ucEntrySize; 502 503 ATOM_PPLIB_NONCLOCK_INFO nonClockInfo[] __counted_by(ucNumEntries); 504 }NonClockInfoArray; 505 506 typedef struct _ATOM_PPLIB_Clock_Voltage_Dependency_Record 507 { 508 USHORT usClockLow; 509 UCHAR ucClockHigh; 510 USHORT usVoltage; 511 }ATOM_PPLIB_Clock_Voltage_Dependency_Record; 512 513 typedef struct _ATOM_PPLIB_Clock_Voltage_Dependency_Table 514 { 515 // Number of entries. 516 UCHAR ucNumEntries; 517 // Dynamically allocate entries. 518 ATOM_PPLIB_Clock_Voltage_Dependency_Record entries[] __counted_by(ucNumEntries); 519 }ATOM_PPLIB_Clock_Voltage_Dependency_Table; 520 521 typedef struct _ATOM_PPLIB_Clock_Voltage_Limit_Record 522 { 523 USHORT usSclkLow; 524 UCHAR ucSclkHigh; 525 USHORT usMclkLow; 526 UCHAR ucMclkHigh; 527 USHORT usVddc; 528 USHORT usVddci; 529 }ATOM_PPLIB_Clock_Voltage_Limit_Record; 530 531 typedef struct _ATOM_PPLIB_Clock_Voltage_Limit_Table 532 { 533 // Number of entries. 534 UCHAR ucNumEntries; 535 // Dynamically allocate entries. 536 ATOM_PPLIB_Clock_Voltage_Limit_Record entries[] __counted_by(ucNumEntries); 537 }ATOM_PPLIB_Clock_Voltage_Limit_Table; 538 539 union _ATOM_PPLIB_CAC_Leakage_Record 540 { 541 struct 542 { 543 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 544 ULONG ulLeakageValue; // For CI and newer we use this as the "fake" standar VDDC value. in CI we read it as StdVoltageLoSidd 545 546 }; 547 struct 548 { 549 USHORT usVddc1; 550 USHORT usVddc2; 551 USHORT usVddc3; 552 }; 553 }; 554 555 typedef union _ATOM_PPLIB_CAC_Leakage_Record ATOM_PPLIB_CAC_Leakage_Record; 556 557 typedef struct _ATOM_PPLIB_CAC_Leakage_Table 558 { 559 // Number of entries. 560 UCHAR ucNumEntries; 561 // Dynamically allocate entries. 562 ATOM_PPLIB_CAC_Leakage_Record entries[] __counted_by(ucNumEntries); 563 }ATOM_PPLIB_CAC_Leakage_Table; 564 565 typedef struct _ATOM_PPLIB_PhaseSheddingLimits_Record 566 { 567 USHORT usVoltage; 568 USHORT usSclkLow; 569 UCHAR ucSclkHigh; 570 USHORT usMclkLow; 571 UCHAR ucMclkHigh; 572 }ATOM_PPLIB_PhaseSheddingLimits_Record; 573 574 typedef struct _ATOM_PPLIB_PhaseSheddingLimits_Table 575 { 576 // Number of entries. 577 UCHAR ucNumEntries; 578 // Dynamically allocate entries. 579 ATOM_PPLIB_PhaseSheddingLimits_Record entries[] __counted_by(ucNumEntries); 580 }ATOM_PPLIB_PhaseSheddingLimits_Table; 581 582 typedef struct _VCEClockInfo{ 583 USHORT usEVClkLow; 584 UCHAR ucEVClkHigh; 585 USHORT usECClkLow; 586 UCHAR ucECClkHigh; 587 }VCEClockInfo; 588 589 typedef struct _VCEClockInfoArray{ 590 UCHAR ucNumEntries; 591 VCEClockInfo entries[] __counted_by(ucNumEntries); 592 }VCEClockInfoArray; 593 594 typedef struct _ATOM_PPLIB_VCE_Clock_Voltage_Limit_Record 595 { 596 USHORT usVoltage; 597 UCHAR ucVCEClockInfoIndex; 598 }ATOM_PPLIB_VCE_Clock_Voltage_Limit_Record; 599 600 typedef struct _ATOM_PPLIB_VCE_Clock_Voltage_Limit_Table 601 { 602 UCHAR numEntries; 603 ATOM_PPLIB_VCE_Clock_Voltage_Limit_Record entries[] __counted_by(numEntries); 604 }ATOM_PPLIB_VCE_Clock_Voltage_Limit_Table; 605 606 typedef struct _ATOM_PPLIB_VCE_State_Record 607 { 608 UCHAR ucVCEClockInfoIndex; 609 UCHAR ucClockInfoIndex; //highest 2 bits indicates memory p-states, lower 6bits indicates index to ClockInfoArrary 610 }ATOM_PPLIB_VCE_State_Record; 611 612 typedef struct _ATOM_PPLIB_VCE_State_Table 613 { 614 UCHAR numEntries; 615 ATOM_PPLIB_VCE_State_Record entries[] __counted_by(numEntries); 616 }ATOM_PPLIB_VCE_State_Table; 617 618 619 typedef struct _ATOM_PPLIB_VCE_Table 620 { 621 UCHAR revid; 622 // VCEClockInfoArray array; 623 // ATOM_PPLIB_VCE_Clock_Voltage_Limit_Table limits; 624 // ATOM_PPLIB_VCE_State_Table states; 625 }ATOM_PPLIB_VCE_Table; 626 627 628 typedef struct _UVDClockInfo{ 629 USHORT usVClkLow; 630 UCHAR ucVClkHigh; 631 USHORT usDClkLow; 632 UCHAR ucDClkHigh; 633 }UVDClockInfo; 634 635 typedef struct _UVDClockInfoArray{ 636 UCHAR ucNumEntries; 637 UVDClockInfo entries[] __counted_by(ucNumEntries); 638 }UVDClockInfoArray; 639 640 typedef struct _ATOM_PPLIB_UVD_Clock_Voltage_Limit_Record 641 { 642 USHORT usVoltage; 643 UCHAR ucUVDClockInfoIndex; 644 }ATOM_PPLIB_UVD_Clock_Voltage_Limit_Record; 645 646 typedef struct _ATOM_PPLIB_UVD_Clock_Voltage_Limit_Table 647 { 648 UCHAR numEntries; 649 ATOM_PPLIB_UVD_Clock_Voltage_Limit_Record entries[] __counted_by(numEntries); 650 }ATOM_PPLIB_UVD_Clock_Voltage_Limit_Table; 651 652 typedef struct _ATOM_PPLIB_UVD_Table 653 { 654 UCHAR revid; 655 // UVDClockInfoArray array; 656 // ATOM_PPLIB_UVD_Clock_Voltage_Limit_Table limits; 657 }ATOM_PPLIB_UVD_Table; 658 659 typedef struct _ATOM_PPLIB_SAMClk_Voltage_Limit_Record 660 { 661 USHORT usVoltage; 662 USHORT usSAMClockLow; 663 UCHAR ucSAMClockHigh; 664 }ATOM_PPLIB_SAMClk_Voltage_Limit_Record; 665 666 typedef struct _ATOM_PPLIB_SAMClk_Voltage_Limit_Table{ 667 UCHAR numEntries; 668 ATOM_PPLIB_SAMClk_Voltage_Limit_Record entries[] __counted_by(numEntries); 669 }ATOM_PPLIB_SAMClk_Voltage_Limit_Table; 670 671 typedef struct _ATOM_PPLIB_SAMU_Table 672 { 673 UCHAR revid; 674 ATOM_PPLIB_SAMClk_Voltage_Limit_Table limits; 675 }ATOM_PPLIB_SAMU_Table; 676 677 typedef struct _ATOM_PPLIB_ACPClk_Voltage_Limit_Record 678 { 679 USHORT usVoltage; 680 USHORT usACPClockLow; 681 UCHAR ucACPClockHigh; 682 }ATOM_PPLIB_ACPClk_Voltage_Limit_Record; 683 684 typedef struct _ATOM_PPLIB_ACPClk_Voltage_Limit_Table{ 685 UCHAR numEntries; 686 ATOM_PPLIB_ACPClk_Voltage_Limit_Record entries[] __counted_by(numEntries); 687 }ATOM_PPLIB_ACPClk_Voltage_Limit_Table; 688 689 typedef struct _ATOM_PPLIB_ACP_Table 690 { 691 UCHAR revid; 692 ATOM_PPLIB_ACPClk_Voltage_Limit_Table limits; 693 }ATOM_PPLIB_ACP_Table; 694 695 typedef struct _ATOM_PowerTune_Table{ 696 USHORT usTDP; 697 USHORT usConfigurableTDP; 698 USHORT usTDC; 699 USHORT usBatteryPowerLimit; 700 USHORT usSmallPowerLimit; 701 USHORT usLowCACLeakage; 702 USHORT usHighCACLeakage; 703 }ATOM_PowerTune_Table; 704 705 typedef struct _ATOM_PPLIB_POWERTUNE_Table 706 { 707 UCHAR revid; 708 ATOM_PowerTune_Table power_tune_table; 709 }ATOM_PPLIB_POWERTUNE_Table; 710 711 typedef struct _ATOM_PPLIB_POWERTUNE_Table_V1 712 { 713 UCHAR revid; 714 ATOM_PowerTune_Table power_tune_table; 715 USHORT usMaximumPowerDeliveryLimit; 716 USHORT usTjMax; 717 USHORT usReserve[6]; 718 } ATOM_PPLIB_POWERTUNE_Table_V1; 719 720 #define ATOM_PPM_A_A 1 721 #define ATOM_PPM_A_I 2 722 typedef struct _ATOM_PPLIB_PPM_Table 723 { 724 UCHAR ucRevId; 725 UCHAR ucPpmDesign; //A+I or A+A 726 USHORT usCpuCoreNumber; 727 ULONG ulPlatformTDP; 728 ULONG ulSmallACPlatformTDP; 729 ULONG ulPlatformTDC; 730 ULONG ulSmallACPlatformTDC; 731 ULONG ulApuTDP; 732 ULONG ulDGpuTDP; 733 ULONG ulDGpuUlvPower; 734 ULONG ulTjmax; 735 } ATOM_PPLIB_PPM_Table; 736 737 #define VQ_DisplayConfig_NoneAWD 1 738 #define VQ_DisplayConfig_AWD 2 739 740 typedef struct ATOM_PPLIB_VQ_Budgeting_Record{ 741 ULONG ulDeviceID; 742 ULONG ulSustainableSOCPowerLimitLow; /* in mW */ 743 ULONG ulSustainableSOCPowerLimitHigh; /* in mW */ 744 745 ULONG ulDClk; 746 ULONG ulEClk; 747 ULONG ulDispSclk; 748 UCHAR ucDispConfig; 749 750 } ATOM_PPLIB_VQ_Budgeting_Record; 751 752 typedef struct ATOM_PPLIB_VQ_Budgeting_Table { 753 UCHAR revid; 754 UCHAR numEntries; 755 ATOM_PPLIB_VQ_Budgeting_Record entries[] __counted_by(numEntries); 756 } ATOM_PPLIB_VQ_Budgeting_Table; 757 758 #pragma pack() 759 760 #endif 761