AGESA F15: AMD family15 AGESA code
[coreboot.git] / src / vendorcode / amd / agesa / f15 / Proc / CPU / Family / 0x15 / cpuCommonF15Utilities.c
1 /* $NoKeywords:$ */
2 /**
3  * @file
4  *
5  * AMD Family_15 specific utility functions.
6  *
7  * Provides numerous utility functions specific to family 15h.
8  *
9  * @xrefitem bom "File Content Label" "Release Content"
10  * @e project:      AGESA
11  * @e sub-project:  CPU/Family/0x15
12  * @e \$Revision: 44737 $   @e \$Date: 2011-01-05 00:59:55 -0700 (Wed, 05 Jan 2011) $
13  *
14  */
15 /*
16  *****************************************************************************
17  *
18  * Copyright (C) 2012 Advanced Micro Devices, Inc.
19  * All rights reserved.
20  *
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.
31  *
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.
42  *
43  ******************************************************************************
44  */
45
46 /*----------------------------------------------------------------------------------------
47  *                             M O D U L E S    U S E D
48  *----------------------------------------------------------------------------------------
49  */
50 #include "AGESA.h"
51 #include "amdlib.h"
52 #include "Ids.h"
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"
60 #include "Filecode.h"
61 CODE_GROUP (G2_PEI)
62 RDATA_GROUP (G2_PEI)
63
64 #define FILECODE PROC_CPU_FAMILY_0X15_CPUCOMMONF15UTILITIES_FILECODE
65
66
67 /*----------------------------------------------------------------------------------------
68  *                   D E F I N I T I O N S    A N D    M A C R O S
69  *----------------------------------------------------------------------------------------
70  */
71
72 /*----------------------------------------------------------------------------------------
73  *                  T Y P E D E F S     A N D     S T R U C T U R E S
74  *----------------------------------------------------------------------------------------
75  */
76
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  *----------------------------------------------------------------------------------------
80  */
81
82 /*----------------------------------------------------------------------------------------
83  *                          E X P O R T E D    F U N C T I O N S
84  *----------------------------------------------------------------------------------------
85  */
86
87 /*---------------------------------------------------------------------------------------*/
88 /**
89  *  Set warm reset status and count
90  *
91  *  @CpuServiceMethod{::F_CPU_SET_WARM_RESET_FLAG}.
92  *
93  *  This function will use bit9, and bit 10 of register F0x6C as a warm reset status and count.
94  *
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
98  *
99  */
100 VOID
101 F15SetAgesaWarmResetFlag (
102   IN       CPU_SPECIFIC_SERVICES *FamilySpecificServices,
103   IN       AMD_CONFIG_PARAMS *StdHeader,
104   IN       WARM_RESET_REQUEST *Request
105   )
106 {
107   PCI_ADDR  PciAddress;
108   UINT32    PciData;
109
110   PciAddress.AddressValue = MAKE_SBDFO (0, 0 , PCI_DEV_BASE, FUNC_0, HT_INIT_CTRL);
111   LibAmdPciRead (AccessWidth32, PciAddress, &PciData, StdHeader);
112
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);
116
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;
120
121   LibAmdPciWrite (AccessWidth32, PciAddress, &PciData, StdHeader);
122 }
123
124 /*---------------------------------------------------------------------------------------*/
125 /**
126  *  Get warm reset status and count
127  *
128  *  @CpuServiceMethod{::F_CPU_GET_WARM_RESET_FLAG}.
129  *
130  *  This function will bit9, and bit 10 of register F0x6C as a warm reset status and count.
131  *
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
135  *
136  */
137 VOID
138 F15GetAgesaWarmResetFlag (
139   IN       CPU_SPECIFIC_SERVICES *FamilySpecificServices,
140   IN       AMD_CONFIG_PARAMS *StdHeader,
141      OUT   WARM_RESET_REQUEST *Request
142   )
143 {
144   PCI_ADDR  PciAddress;
145   UINT32    PciData;
146
147   PciAddress.AddressValue = MAKE_SBDFO (0, 0 , PCI_DEV_BASE, FUNC_0, HT_INIT_CTRL);
148   LibAmdPciRead (AccessWidth32, PciAddress, &PciData, StdHeader);
149
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);
154 }
155
156 /*---------------------------------------------------------------------------------------*/
157 /**
158  * Return a number zero or one, based on the Core ID position in the initial APIC Id.
159  *
160  * @CpuServiceMethod{::F_CORE_ID_POSITION_IN_INITIAL_APIC_ID}.
161  *
162  * @param[in]     FamilySpecificServices  The current Family Specific Services.
163  * @param[in]     StdHeader               Handle of Header for calling lib functions and services.
164  *
165  * @retval        CoreIdPositionZero      Core Id is not low
166  * @retval        CoreIdPositionOne       Core Id is low
167  */
168 CORE_ID_POSITION
169 F15CpuAmdCoreIdPositionInInitialApicId (
170   IN       CPU_SPECIFIC_SERVICES  *FamilySpecificServices,
171   IN       AMD_CONFIG_PARAMS      *StdHeader
172   )
173 {
174   UINT64 InitApicIdCpuIdLo;
175
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);
180 }
181