src/vendorcode/amd/agesa/f15/Proc/Recovery/Mem/NB/mrn.c

   1 /* $NoKeywords:$ */
   2 /**
   3  * @file
   4  *
   5  * mrn.c
   6  *
   7  * Common Northbridge  functions for Recovery
   8  *
   9  * @xrefitem bom "File Content Label" "Release Content"
  10  * @e project: AGESA
  11  * @e sub-project: (Proc/Recovery/Mem/NB)
  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 "cpuFamRegisters.h"
  59 #include "cpuRegisters.h"
  60 #include "cpuFamilyTranslation.h"
  61 #include "mm.h"
  62 #include "mn.h"
  63 #include "Filecode.h"
  64 #define FILECODE PROC_RECOVERY_MEM_NB_MRN_FILECODE
  65 /*----------------------------------------------------------------------------
  66  *                          DEFINITIONS AND MACROS
  67  *
  68  *----------------------------------------------------------------------------
  69  */
  70
  71 #define MAX_DCTS_PER_DIE 2
  72 #define SPLIT_CHANNEL   0x20000000
  73 #define CHANNEL_SELECT  0x10000000
  74 #define MAX_DELAYS    9   /* 8 data bytes + 1 ECC byte */
  75 #define MAX_DIMMS     4   /* 4 DIMMs per channel */
  76
  77 /*----------------------------------------------------------------------------
  78  *                           TYPEDEFS AND STRUCTURES
  79  *
  80  *----------------------------------------------------------------------------
  81  */
  82
  83 /*----------------------------------------------------------------------------
  84  *                        PROTOTYPES OF LOCAL FUNCTIONS
  85  *
  86  *----------------------------------------------------------------------------
  87  */
  88
  89 /*----------------------------------------------------------------------------
  90  *                            EXPORTED FUNCTIONS
  91  *
  92  *----------------------------------------------------------------------------
  93  */
  94
  95 /* -----------------------------------------------------------------------------*/
  96 /**
  97  *
  98  *   This function gets a bit field from PCI register
  99  *
 100  *     @param[in,out]   *NBPtr   - Pointer to the MEM_NB_BLOCK
 101  *     @param[in]   FieldName - Field name
 102  *
 103  *     @return      Bit field value
 104  */
 105
 106 UINT32
 107 MemRecNGetBitFieldNb (
 108   IN OUT   MEM_NB_BLOCK *NBPtr,
 109   IN       BIT_FIELD_NAME FieldName
 110   )
 111 {
 112   return NBPtr->MemRecNCmnGetSetFieldNb (NBPtr, 0, FieldName, 0);
 113 }
 114
 115
 116
 117 /* -----------------------------------------------------------------------------*/
 118 /**
 119  *
 120  *   This function sets a bit field from PCI register
 121  *
 122  *     @param[in,out]   *NBPtr   - Pointer to the MEM_NB_BLOCK
 123  *     @param[in]   FieldName - Field name
 124  *     @param[in]   Field - Value to be stored in PCT register
 125  *
 126  */
 127
 128 VOID
 129 MemRecNSetBitFieldNb (
 130   IN OUT   MEM_NB_BLOCK *NBPtr,
 131   IN       BIT_FIELD_NAME FieldName,
 132   IN       UINT32 Field
 133   )
 134 {
 135   NBPtr->MemRecNCmnGetSetFieldNb (NBPtr, 1, FieldName, Field);
 136 }
 137
 138 /* -----------------------------------------------------------------------------*/
 139 /**
 140  *
 141  *   This function gets a delay value a PCI register during training
 142  *
 143  *     @param[in,out]   *NBPtr   - Pointer to the MEM_NB_BLOCK
 144  *     @param[in]   TrnDly - type of delay to be set
 145  *     @param[in]   DrbnVar - encoding of Dimm-Rank-Byte-Nibble to be accessed
 146  *                  (use either DIMM_BYTE_ACCESS(dimm,byte) or CS_NBBL_ACCESS(cs,nibble) to use this encoding
 147  *
 148  *     @return      Value read
 149  */
 150
 151 UINT32
 152 MemRecNGetTrainDlyNb (
 153   IN OUT   MEM_NB_BLOCK *NBPtr,
 154   IN       TRN_DLY_TYPE TrnDly,
 155   IN       DRBN DrbnVar
 156   )
 157 {
 158   return NBPtr->MemRecNcmnGetSetTrainDlyNb (NBPtr, 0, TrnDly, DrbnVar, 0);
 159 }
 160
 161 /* -----------------------------------------------------------------------------*/
 162 /**
 163  *
 164  *   This function gets a delay value a PCI register during training
 165  *
 166  *     @param[in,out]   *NBPtr   - Pointer to the MEM_NB_BLOCK
 167  *     @param[in]   TrnDly - type of delay to be set
 168  *     @param[in]   DrbnVar - encoding of Dimm-Rank-Byte-Nibble to be accessed
 169  *                  (use either DIMM_BYTE_ACCESS(dimm,byte) or CS_NBBL_ACCESS(cs,nibble) to use this encoding
 170  *     @param[in]   Field - Value to be programmed
 171  *
 172  */
 173
 174 VOID
 175 MemRecNSetTrainDlyNb (
 176   IN OUT   MEM_NB_BLOCK *NBPtr,
 177   IN       TRN_DLY_TYPE TrnDly,
 178   IN       DRBN DrbnVar,
 179   IN       UINT16 Field
 180   )
 181 {
 182   NBPtr->MemRecNcmnGetSetTrainDlyNb (NBPtr, 1, TrnDly, DrbnVar, Field);
 183 }
 184 /*----------------------------------------------------------------------------
 185  *                              LOCAL FUNCTIONS
 186  *
 187  *----------------------------------------------------------------------------
 188  */
 189