src/vendorcode/amd/agesa/f15/Proc/Common/AmdInitMid.c

   1 /* $NoKeywords:$ */
   2 /**
   3  * @file
   4  *
   5  * AMD AGESA Basic Level Public APIs
   6  *
   7  * Contains basic Level Initialization routines.
   8  *
   9  * @xrefitem bom "File Content Label" "Release Content"
  10  * @e project:      AGESA
  11  * @e sub-project:  Interface
  12  * @e \$Revision: 56279 $   @e \$Date: 2011-07-11 13:11:28 -0600 (Mon, 11 Jul 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  *                             M O D U L E S    U S E D
  48  *----------------------------------------------------------------------------------------
  49  */
  50 #include "AGESA.h"
  51 #include "Ids.h"
  52 #include "cpuFeatures.h"
  53 #include "CommonInits.h"
  54 #include "GnbInterface.h"
  55 #include "AmdFch.h"
  56 #include "Filecode.h"
  57 #include "heapManager.h"
  58 #include "CreateStruct.h"
  59 CODE_GROUP (G3_DXE)
  60 RDATA_GROUP (G3_DXE)
  61
  62 #define FILECODE PROC_COMMON_AMDINITMID_FILECODE
  63
  64 extern BLDOPT_FCH_FUNCTION  BldoptFchFunction;
  65
  66 /*----------------------------------------------------------------------------------------
  67  *                   D E F I N I T I O N S    A N D    M A C R O S
  68  *----------------------------------------------------------------------------------------
  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 /*----------------------------------------------------------------------------------------
  79  *           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
  80  *----------------------------------------------------------------------------------------
  81  */
  82
  83
  84 /*----------------------------------------------------------------------------------------
  85  *                          E X P O R T E D    F U N C T I O N S
  86  *----------------------------------------------------------------------------------------
  87  */
  88 /*
  89  *---------------------------------------------------------------------------------------
  90  *
  91  *  Initializer routine that will be invoked by the wrapper
  92  *  to initialize the input structure for the AmdInitMid
  93  *
  94  *  @param[in,out]  MidParamsPtr   Newly created interface parameters for AmdInitMid
  95  *
  96  *  @retval         AGESA_SUCCESS  Always succeeds
  97  *
  98  *---------------------------------------------------------------------------------------
  99  */
 100 AGESA_STATUS
 101 AmdInitMidInitializer (
 102   IN       AMD_CONFIG_PARAMS *StdHeader,
 103   IN OUT   AMD_MID_PARAMS    *MidParamsPtr
 104   )
 105 {
 106   ASSERT (StdHeader != NULL);
 107   ASSERT (MidParamsPtr != NULL);
 108
 109   MidParamsPtr->StdHeader = *StdHeader;
 110   CommonPlatformConfigInit (&MidParamsPtr->PlatformConfig, &MidParamsPtr->StdHeader);
 111   BldoptFchFunction.InitMidConstructor (MidParamsPtr);
 112
 113   return AGESA_SUCCESS;
 114 }
 115
 116
 117 /*---------------------------------------------------------------------------------------*/
 118 /**
 119  * Main entry point for the AMD_INIT_MID function.
 120  *
 121  * This entry point is responsible for performing any necessary functions needed
 122  * after PCI bus enumeration and just before control is passed to the video option ROM.
 123  *
 124  * @param[in,out] MidParams      Required input parameters for the AMD_INIT_MID
 125  *                                  entry point.
 126  *
 127  * @return        Aggregated status across all internal AMD mid calls invoked.
 128  *
 129  */
 130 AGESA_STATUS
 131 AmdInitMid (
 132   IN OUT   AMD_MID_PARAMS *MidParams
 133   )
 134 {
 135   AGESA_STATUS  AgesaStatus;
 136   AGESA_STATUS  CalledStatus;
 137   IDS_HDT_CONSOLE (MAIN_FLOW, "AmdInitMid: Start\n\n");
 138   AGESA_TESTPOINT (TpIfAmdInitMidEntry, &MidParams->StdHeader);
 139   IDS_PERF_TIME_MEASURE (&MidParams->StdHeader);
 140
 141   AgesaStatus = AGESA_SUCCESS;
 142
 143   ASSERT (MidParams != NULL);
 144   IDS_OPTION_HOOK (IDS_INIT_MID_BEFORE, MidParams, &MidParams->StdHeader);
 145
 146   IDS_HDT_CONSOLE (MAIN_FLOW, "DispatchCpuFeatures: MidStart\n");
 147   CalledStatus = DispatchCpuFeatures (CPU_FEAT_INIT_MID_END, &MidParams->PlatformConfig, &MidParams->StdHeader);
 148   IDS_HDT_CONSOLE (MAIN_FLOW, "DispatchCpuFeatures: MidEnd\n");
 149   if (CalledStatus > AgesaStatus) {
 150     AgesaStatus = CalledStatus;
 151   }
 152
 153   CalledStatus = BldoptFchFunction.InitMid (MidParams);
 154   AgesaStatus = (CalledStatus > AgesaStatus) ? CalledStatus : AgesaStatus;
 155
 156   CalledStatus = GnbInitAtMid (MidParams);
 157   if (CalledStatus > AgesaStatus) {
 158     AgesaStatus = CalledStatus;
 159   }
 160
 161   IDS_OPTION_HOOK (IDS_INIT_MID_AFTER, MidParams, &MidParams->StdHeader);
 162
 163   IDS_PERF_TIME_MEASURE (&MidParams->StdHeader);
 164   AGESA_TESTPOINT (TpIfAmdInitMidExit, &MidParams->StdHeader);
 165   IDS_HDT_CONSOLE (MAIN_FLOW, "\nAmdInitMid: End\n\n");
 166   IDS_HDT_CONSOLE_FLUSH_BUFFER (&MidParams->StdHeader);
 167   return AgesaStatus;
 168 }
 169
 170