AGESA F15: AMD family15 AGESA code
[coreboot.git] / src / vendorcode / amd / agesa / f15 / Proc / Recovery / Mem / NB / mrntrain3.c
1 /* $NoKeywords:$ */
2 /**
3  * @file
4  *
5  * mrntrain3.c
6  *
7  * Common Recovery Northbridge function for training flow for DDR3
8  *
9  * @xrefitem bom "File Content Label" "Release Content"
10  * @e project: AGESA
11  * @e sub-project: (Mem/NB)
12  * @e \$Revision: 49896 $ @e \$Date: 2011-03-30 02:18:18 -0600 (Wed, 30 Mar 2011) $
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 "OptionMemory.h"
59 #include "mm.h"
60 #include "mn.h"
61 #include "mt.h"
62 #include "mrt3.h"
63 #include "Filecode.h"
64 #define FILECODE PROC_RECOVERY_MEM_NB_MRNTRAIN3_FILECODE
65 /* features */
66
67 /*----------------------------------------------------------------------------
68  *                          DEFINITIONS AND MACROS
69  *
70  *----------------------------------------------------------------------------
71  */
72
73 /*----------------------------------------------------------------------------
74  *                           TYPEDEFS AND STRUCTURES
75  *
76  *----------------------------------------------------------------------------
77  */
78
79 /*----------------------------------------------------------------------------
80  *                        PROTOTYPES OF LOCAL FUNCTIONS
81  *
82  *----------------------------------------------------------------------------
83  */
84 /* -----------------------------------------------------------------------------*/
85 /**
86  *
87  *      This function sets the training control flow
88  *      The DDR3 mode bit must be set prior to calling this function
89  *
90  *      @param[in,out]   *NBPtr   - Pointer to the MEM_NB_BLOCK
91  */
92 VOID
93 MemNRecTrainingFlowNb (
94   IN OUT   MEM_NB_BLOCK *NBPtr
95   )
96 {
97   MemRecTTrainDQSWriteHw3 (NBPtr->TechPtr);
98
99   MemRecTTrainRcvrEnSw (NBPtr->TechPtr);
100
101   MemRecTTrainDQSPosSw (NBPtr->TechPtr);
102 }
103
104 /* -----------------------------------------------------------------------------*/
105 /**
106  *
107  *      This function sets the client training control flow
108  *
109  *      @param[in,out]   *NBPtr   - Pointer to the MEM_NB_BLOCK
110  */
111 VOID
112 MemNRecTrainingFlowClientNb (
113   IN OUT   MEM_NB_BLOCK *NBPtr
114   )
115 {
116   IDS_HDT_CONSOLE (MEM_STATUS, "\nStart serial training\n");
117   IDS_HDT_CONSOLE (MEM_STATUS, "Node %d\n", NBPtr->MCTPtr->DieId);
118
119   MemRecTTrainDQSWriteHw3 (NBPtr->TechPtr);
120
121   MemRecTTrainRcvrEnHw (NBPtr->TechPtr);
122
123   // Clear DisableCal and set DisablePredriverCal
124   NBPtr->FamilySpecificHook[ReEnablePhyComp] (NBPtr, NBPtr);
125   NBPtr->SetBitField (NBPtr, BFRxPtrInitReq, 1);
126   while (NBPtr->GetBitField (NBPtr, BFRxPtrInitReq) != 0) {}
127   NBPtr->SetBitField (NBPtr, BFDisDllShutdownSR, 1);
128   NBPtr->SetBitField (NBPtr, BFEnterSelfRef, 1);
129   while (NBPtr->GetBitField (NBPtr, BFEnterSelfRef) != 0) {}
130   IDS_HDT_CONSOLE (MEM_FLOW, "\tMemClkAlign = 2\n");
131   NBPtr->SetBitField (NBPtr, BFDbeGskMemClkAlignMode, 2);
132   NBPtr->SetBitField (NBPtr, BFExitSelfRef, 1);
133   while (NBPtr->GetBitField (NBPtr, BFExitSelfRef) != 0) {}
134   NBPtr->SetBitField (NBPtr, BFDisDllShutdownSR, 0);
135
136   MemRecTTrainDQSPosSw (NBPtr->TechPtr);
137 }
138
139 /* -----------------------------------------------------------------------------*/
140 /**
141  *
142  *
143  *      This function sets the Unb training control flow
144  *
145  *      @param[in,out]   *NBPtr   - Pointer to the MEM_NB_BLOCK
146  */
147 VOID
148 MemNRecTrainingFlowUnb (
149   IN OUT   MEM_NB_BLOCK *NBPtr
150   )
151 {
152   MemRecTTrainDQSWriteHw3 (NBPtr->TechPtr);
153
154   MemRecTTrainDQSPosSw (NBPtr->TechPtr);
155
156   MemRecTTrainRcvrEnHwSeedless (NBPtr->TechPtr);
157 }
158