AGESA F15: AMD family15 AGESA code
[coreboot.git] / src / vendorcode / amd / agesa / f15 / Proc / Mem / Feat / LVDDR3 / mflvddr3.c
1 /* $NoKeywords:$ */
2 /**
3  * @file
4  *
5  * lvddr3.c
6  *
7  * Voltage change for DDR3 DIMMs.
8  *
9  * @xrefitem bom "File Content Label" "Release Content"
10  * @e project: AGESA
11  * @e sub-project: (Mem/Feat/LVDDR3)
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  *----------------------------------------------------------------------------
48  *                                MODULES USED
49  *
50  *----------------------------------------------------------------------------
51  */
52
53
54
55 #include "AGESA.h"
56 #include "amdlib.h"
57 #include "Ids.h"
58 #include "mm.h"
59 #include "mn.h"
60 #include "mt.h"
61 #include "Filecode.h"
62 CODE_GROUP (G2_PEI)
63 RDATA_GROUP (G2_PEI)
64
65 #define FILECODE PROC_MEM_FEAT_LVDDR3_MFLVDDR3_FILECODE
66 /* features */
67 #include "mflvddr3.h"
68
69
70 /*----------------------------------------------------------------------------
71  *                          DEFINITIONS AND MACROS
72  *
73  *----------------------------------------------------------------------------
74  */
75
76 /*----------------------------------------------------------------------------
77  *                           TYPEDEFS AND STRUCTURES
78  *
79  *----------------------------------------------------------------------------
80  */
81
82 /*----------------------------------------------------------------------------
83  *                        PROTOTYPES OF LOCAL FUNCTIONS
84  *
85  *----------------------------------------------------------------------------
86  */
87
88 /*----------------------------------------------------------------------------
89  *                            EXPORTED FUNCTIONS
90  *
91  *----------------------------------------------------------------------------
92  */
93
94 /*-----------------------------------------------------------------------------*/
95 /**
96  *
97  *   This function calculate the common lowest voltage supported by all DDR3
98  *   DIMMs in the system. This function only needs to be called on BSP.
99  *
100  *   @param[in, out]    *NBPtr - Pointer to NB block
101  *
102  *     @return          TRUE -  This feature is enabled.
103  *     @return          FALSE - This feature is not enabled.
104  */
105
106 BOOLEAN
107 MemFLvDdr3 (
108   IN OUT   MEM_NB_BLOCK *NBPtr
109   )
110 {
111   CH_DEF_STRUCT *ChannelPtr;
112   MEM_TECH_BLOCK  *TechPtr;
113   MEM_SHARED_DATA *mmSharedPtr;
114   UINT8 Dct;
115   UINT8 Channel;
116   UINT8 Dimm;
117   UINT8 *SpdBufferPtr;
118   UINT8 VDDByte;
119   UINT8 VoltageMap;
120
121   mmSharedPtr = NBPtr->SharedPtr;
122   TechPtr = NBPtr->TechPtr;
123   VoltageMap = 0xFF;
124
125   for (Dct = 0; Dct < NBPtr->DctCount; Dct++) {
126     NBPtr->SwitchDCT (NBPtr, Dct);
127     for (Channel = 0; Channel < NBPtr->ChannelCount; Channel++) {
128       NBPtr->SwitchChannel (NBPtr, Channel);
129       ChannelPtr = NBPtr->ChannelPtr;
130       for (Dimm = 0; Dimm < MAX_DIMMS_PER_CHANNEL; Dimm++) {
131         if (TechPtr->GetDimmSpdBuffer (TechPtr, &SpdBufferPtr, Dimm)) {
132           // SPD byte 6: Module Nominal Voltage, VDD
133           // 1.5v - bit 0
134           // 1.35v - bit 1
135           // 1.2v - bit 2
136           VDDByte = SpdBufferPtr[MNVVDD];
137           IDS_HDT_CONSOLE (MEM_FLOW, "Node%d DCT%d Channel%d Dimm%d VDD Byte: 0x%02x\n", NBPtr->Node, Dct, Channel, Dimm, VDDByte);
138
139           // Reverse the 1.5V operable bit. So its encoding can be consistent
140           // with that of 1.35V and 1.25V operable bit.
141           VDDByte ^= 1;
142           ASSERT (VDDByte != 0);
143
144           if (mmSharedPtr->VoltageMap != 0) {
145             // Get the common supported voltage map
146             VoltageMap &= VDDByte;
147           } else {
148             // This is the second execution of all the loop as no common voltage is found
149             if (VDDByte == (1 << VOLT1_5_ENCODED_VAL)) {
150               // Always exclude 1.5V dimm if no common voltage is found
151               ChannelPtr->DimmExclude |= (UINT16) 1 << Dimm;
152             }
153           }
154         }
155       }
156       if (mmSharedPtr->VoltageMap == 0) {
157         NBPtr->DCTPtr->Timings.DimmExclude |= ChannelPtr->DimmExclude;
158       }
159     }
160   }
161
162   if (mmSharedPtr->VoltageMap != 0) {
163     mmSharedPtr->VoltageMap &= VoltageMap;
164   }
165
166   return TRUE;
167 }
168
169 /*----------------------------------------------------------------------------
170  *                              LOCAL FUNCTIONS
171  *
172  *----------------------------------------------------------------------------
173  */