5 * AMD Family_15 specific utility functions.
7 * Provides numerous utility functions specific to family 15h.
9 * @xrefitem bom "File Content Label" "Release Content"
11 * @e sub-project: CPU/Family/0x15
12 * @e \$Revision: 44737 $ @e \$Date: 2011-01-05 00:59:55 -0700 (Wed, 05 Jan 2011) $
16 *****************************************************************************
18 * Copyright (C) 2012 Advanced Micro Devices, Inc.
19 * All rights reserved.
21 * Redistribution and use in source and binary forms, with or without
22 * modification, are permitted provided that the following conditions are met:
23 * * Redistributions of source code must retain the above copyright
24 * notice, this list of conditions and the following disclaimer.
25 * * Redistributions in binary form must reproduce the above copyright
26 * notice, this list of conditions and the following disclaimer in the
27 * documentation and/or other materials provided with the distribution.
28 * * Neither the name of Advanced Micro Devices, Inc. nor the names of
29 * its contributors may be used to endorse or promote products derived
30 * from this software without specific prior written permission.
32 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
33 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
34 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
35 * DISCLAIMED. IN NO EVENT SHALL ADVANCED MICRO DEVICES, INC. BE LIABLE FOR ANY
36 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
37 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
38 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
39 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
40 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
41 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
43 ******************************************************************************
46 /*----------------------------------------------------------------------------------------
47 * M O D U L E S U S E D
48 *----------------------------------------------------------------------------------------
53 #include "cpuRegisters.h"
54 #include "cpuServices.h"
55 #include "GeneralServices.h"
56 #include "cpuApicUtilities.h"
57 #include "cpuFamilyTranslation.h"
58 #include "cpuCommonF15Utilities.h"
59 #include "cpuF15PowerMgmt.h"
64 #define FILECODE PROC_CPU_FAMILY_0X15_CPUCOMMONF15UTILITIES_FILECODE
67 /*----------------------------------------------------------------------------------------
68 * D E F I N I T I O N S A N D M A C R O S
69 *----------------------------------------------------------------------------------------
72 /*----------------------------------------------------------------------------------------
73 * T Y P E D E F S A N D S T R U C T U R E S
74 *----------------------------------------------------------------------------------------
77 /*----------------------------------------------------------------------------------------
78 * P R O T O T Y P E S O F L O C A L F U N C T I O N S
79 *----------------------------------------------------------------------------------------
82 /*----------------------------------------------------------------------------------------
83 * E X P O R T E D F U N C T I O N S
84 *----------------------------------------------------------------------------------------
87 /*---------------------------------------------------------------------------------------*/
89 * Set warm reset status and count
91 * @CpuServiceMethod{::F_CPU_SET_WARM_RESET_FLAG}.
93 * This function will use bit9, and bit 10 of register F0x6C as a warm reset status and count.
95 * @param[in] FamilySpecificServices The current Family Specific Services.
96 * @param[in] StdHeader Handle of Header for calling lib functions and services.
97 * @param[in] Request Indicate warm reset status
101 F15SetAgesaWarmResetFlag (
102 IN CPU_SPECIFIC_SERVICES *FamilySpecificServices,
103 IN AMD_CONFIG_PARAMS *StdHeader,
104 IN WARM_RESET_REQUEST *Request
110 PciAddress.AddressValue = MAKE_SBDFO (0, 0 , PCI_DEV_BASE, FUNC_0, HT_INIT_CTRL);
111 LibAmdPciRead (AccessWidth32, PciAddress, &PciData, StdHeader);
113 // bit[5] - indicate a warm reset is or is not required
114 PciData &= ~(HT_INIT_BIOS_RST_DET_0);
115 PciData = PciData | (Request->RequestBit << 5);
117 // bit[10,9] - indicate warm reset status and count
118 PciData &= ~(HT_INIT_BIOS_RST_DET_1 | HT_INIT_BIOS_RST_DET_2);
119 PciData |= Request->StateBits << 9;
121 LibAmdPciWrite (AccessWidth32, PciAddress, &PciData, StdHeader);
124 /*---------------------------------------------------------------------------------------*/
126 * Get warm reset status and count
128 * @CpuServiceMethod{::F_CPU_GET_WARM_RESET_FLAG}.
130 * This function will bit9, and bit 10 of register F0x6C as a warm reset status and count.
132 * @param[in] FamilySpecificServices The current Family Specific Services.
133 * @param[in] StdHeader Config handle for library and services
134 * @param[out] Request Indicate warm reset status
138 F15GetAgesaWarmResetFlag (
139 IN CPU_SPECIFIC_SERVICES *FamilySpecificServices,
140 IN AMD_CONFIG_PARAMS *StdHeader,
141 OUT WARM_RESET_REQUEST *Request
147 PciAddress.AddressValue = MAKE_SBDFO (0, 0 , PCI_DEV_BASE, FUNC_0, HT_INIT_CTRL);
148 LibAmdPciRead (AccessWidth32, PciAddress, &PciData, StdHeader);
150 // bit[5] - indicate a warm reset is or is not required
151 Request->RequestBit = (UINT8) ((PciData & HT_INIT_BIOS_RST_DET_0) >> 5);
152 // bit[10,9] - indicate warm reset status and count
153 Request->StateBits = (UINT8) ((PciData & (HT_INIT_BIOS_RST_DET_1 | HT_INIT_BIOS_RST_DET_2)) >> 9);
156 /*---------------------------------------------------------------------------------------*/
158 * Return a number zero or one, based on the Core ID position in the initial APIC Id.
160 * @CpuServiceMethod{::F_CORE_ID_POSITION_IN_INITIAL_APIC_ID}.
162 * @param[in] FamilySpecificServices The current Family Specific Services.
163 * @param[in] StdHeader Handle of Header for calling lib functions and services.
165 * @retval CoreIdPositionZero Core Id is not low
166 * @retval CoreIdPositionOne Core Id is low
169 F15CpuAmdCoreIdPositionInInitialApicId (
170 IN CPU_SPECIFIC_SERVICES *FamilySpecificServices,
171 IN AMD_CONFIG_PARAMS *StdHeader
174 UINT64 InitApicIdCpuIdLo;
176 // Check bit_54 [InitApicIdCpuIdLo] to find core id position.
177 LibAmdMsrRead (MSR_NB_CFG, &InitApicIdCpuIdLo, StdHeader);
178 InitApicIdCpuIdLo = ((InitApicIdCpuIdLo & BIT54) >> 54);
179 return ((InitApicIdCpuIdLo == 0) ? CoreIdPositionZero : CoreIdPositionOne);