AGESA F15: AMD family15 AGESA code
[coreboot.git] / src / vendorcode / amd / agesa / f15 / Proc / Recovery / Mem / Ps / mrpsao.c
1 /* $NoKeywords:$ */
2 /**
3  * @file
4  *
5  * mrpsao.c
6  *
7  * A sub-engine which extracts Slow access mode, Address timing and Output driver compensation value.
8  *
9  * @xrefitem bom "File Content Label" "Release Content"
10  * @e project: AGESA
11  * @e sub-project: (Proc/Recovery/Mem/Ps)
12  * @e \$Revision: 44324 $ @e \$Date: 2010-12-22 02:16:51 -0700 (Wed, 22 Dec 2010) $
13  *
14  **/
15 /*****************************************************************************
16 *
17 * Copyright (C) 2012 Advanced Micro Devices, Inc.
18 * All rights reserved.
19 *
20 * Redistribution and use in source and binary forms, with or without
21 * modification, are permitted provided that the following conditions are met:
22 *     * Redistributions of source code must retain the above copyright
23 *       notice, this list of conditions and the following disclaimer.
24 *     * Redistributions in binary form must reproduce the above copyright
25 *       notice, this list of conditions and the following disclaimer in the
26 *       documentation and/or other materials provided with the distribution.
27 *     * Neither the name of Advanced Micro Devices, Inc. nor the names of
28 *       its contributors may be used to endorse or promote products derived
29 *       from this software without specific prior written permission.
30 *
31 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
32 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
33 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
34 * DISCLAIMED. IN NO EVENT SHALL ADVANCED MICRO DEVICES, INC. BE LIABLE FOR ANY
35 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
36 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
37 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
38 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
39 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
40 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
41 *
42 * ***************************************************************************
43 *
44 */
45 /*
46  *----------------------------------------------------------------------------
47  *                                MODULES USED
48  *
49  *----------------------------------------------------------------------------
50  */
51
52
53
54 #include "AGESA.h"
55 #include "AdvancedApi.h"
56 #include "amdlib.h"
57 #include "Ids.h"
58 #include "cpuFamRegisters.h"
59 #include "cpuRegisters.h"
60 #include "OptionMemory.h"
61 #include "PlatformMemoryConfiguration.h"
62 #include "mru.h"
63 #include "ma.h"
64 #include "mp.h"
65 #include "Filecode.h"
66 CODE_GROUP (G2_PEI)
67 RDATA_GROUP (G2_PEI)
68 #define FILECODE PROC_RECOVERY_MEM_PS_MRPSAO_FILECODE
69
70
71 /*----------------------------------------------------------------------------
72  *                          DEFINITIONS AND MACROS
73  *
74  *----------------------------------------------------------------------------
75  */
76
77 /*----------------------------------------------------------------------------
78  *                           TYPEDEFS AND STRUCTURES
79  *
80  *----------------------------------------------------------------------------
81  */
82 /*----------------------------------------------------------------------------
83  *                        PROTOTYPES OF LOCAL FUNCTIONS
84  *
85  *----------------------------------------------------------------------------
86  */
87 /*----------------------------------------------------------------------------
88  *                            EXPORTED FUNCTIONS
89  *
90  *----------------------------------------------------------------------------
91  */
92 /* -----------------------------------------------------------------------------*/
93 /**
94  *
95  *    A sub-function which extracts Slow mode, Address timing and Output driver compensation value
96  *    from a input table and store those value to a specific address.
97  *
98  *     @param[in,out]   *NBPtr   - Pointer to the MEM_NB_BLOCK
99  *     @param[in]       *EntryOfTables     - Pointer to MEM_PSC_TABLE_BLOCK
100  *
101  *     @return          TRUE - Table values can be extracted per dimm population and ranks type.
102  *     @return          FALSE - Table values cannot be extracted per dimm population and ranks type.
103  *
104  */
105 BOOLEAN
106 MemPRecGetSAO (
107   IN OUT   MEM_NB_BLOCK *NBPtr,
108   IN       MEM_PSC_TABLE_BLOCK *EntryOfTables
109   )
110 {
111   UINT8 i;
112   UINT8 MaxDimmPerCh;
113   UINT8 NOD;
114   UINT8 TableSize;
115   UINT8 DDR3Voltage;
116   UINT16 RankTypeOfPopulatedDimm;
117   UINT16 RankTypeInTable;
118   DIMM_TYPE DimmType;
119   CPU_LOGICAL_ID LogicalCpuid;
120   UINT8 PackageType;
121   PSCFG_SAO_ENTRY *TblPtr;
122   CH_DEF_STRUCT *CurrentChannel;
123
124   CurrentChannel = NBPtr->ChannelPtr;
125
126   TblPtr = NULL;
127   TableSize = 0;
128   PackageType = 0;
129   LogicalCpuid.Family = AMD_FAMILY_UNKNOWN;
130   MaxDimmPerCh = RecGetMaxDimmsPerChannel (NBPtr->RefPtr->PlatformMemoryConfiguration, NBPtr->MCTPtr->SocketId, CurrentChannel->ChannelID);
131   NOD = (UINT8) 1 << (MaxDimmPerCh - 1);
132
133   if (CurrentChannel->RegDimmPresent != 0) {
134     DimmType = RDIMM_TYPE;
135   } else if (CurrentChannel->SODimmPresent != 0) {
136     DimmType = SODIMM_TYPE;
137   //@todo LRDIMM
138   //} else if (CurrentChannel->LrDimmPresent) {
139   //  DimmType = LRDIMM_TYPE;
140   } else {
141     DimmType = UDIMM_TYPE;
142   }
143
144   i = 0;
145   // Obtain table pointer, table size, Logical Cpuid and PSC type according to Dimm, NB and package type.
146   while (EntryOfTables->TblEntryOfSAO[i] != NULL) {
147     if (((EntryOfTables->TblEntryOfSAO[i])->Header.DimmType & DimmType) != 0) {
148       if (((EntryOfTables->TblEntryOfSAO[i])->Header.NumOfDimm & NOD) != 0) {
149         //
150         // Determine if this is the expected NB Type
151         //
152         LogicalCpuid = (EntryOfTables->TblEntryOfSAO[i])->Header.LogicalCpuid;
153         PackageType = (EntryOfTables->TblEntryOfSAO[i])->Header.PackageType;
154         if (MemPRecIsIdSupported (NBPtr, LogicalCpuid, PackageType)) {
155           TblPtr = (PSCFG_SAO_ENTRY *) ((EntryOfTables->TblEntryOfSAO[i])->TBLPtr);
156           TableSize = (EntryOfTables->TblEntryOfSAO[i])->TableSize;
157           break;
158         }
159       }
160     }
161     i++;
162   }
163
164   // Check whether no table entry is found.
165   if (EntryOfTables->TblEntryOfSAO[i] == NULL) {
166     return FALSE;
167   }
168
169   DDR3Voltage = (UINT8) (1 << CONVERT_VDDIO_TO_ENCODED (NBPtr->RefPtr->DDR3Voltage));
170   RankTypeOfPopulatedDimm = MemPRecGetPsRankType (CurrentChannel);  //@todo - LRDIMM ?
171
172   for (i = 0; i < TableSize; i++) {
173     MemPRecConstructRankTypeMap ((UINT16) TblPtr->Dimm0, (UINT16) TblPtr->Dimm1, (UINT16) TblPtr->Dimm2, &RankTypeInTable);
174     if (TblPtr->DimmPerCh == MaxDimmPerCh) {
175       if ((TblPtr->VDDIO & DDR3Voltage) != 0) {
176         if ((RankTypeInTable & RankTypeOfPopulatedDimm) == RankTypeOfPopulatedDimm) {
177           CurrentChannel->DctAddrTmg = TblPtr->AddTmgCtl;
178           CurrentChannel->DctOdcCtl = TblPtr->ODC;
179           CurrentChannel->SlowMode = (TblPtr->SlowMode == 1) ? TRUE : FALSE;
180           return TRUE;
181         }
182       }
183     }
184     TblPtr++;
185   }
186   return FALSE;
187 }