5 * AMD AGESA Basic Level Public APIs
7 * Contains basic Level Initialization routines.
9 * @xrefitem bom "File Content Label" "Release Content"
11 * @e sub-project: Interface
12 * @e \$Revision: 55552 $ @e \$Date: 2011-06-22 09:31:58 -0600 (Wed, 22 Jun 2011) $
15 /*****************************************************************************
17 * Copyright (C) 2012 Advanced Micro Devices, Inc.
18 * All rights reserved.
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.
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.
42 ******************************************************************************
46 /*----------------------------------------------------------------------------------------
47 * M O D U L E S U S E D
48 *----------------------------------------------------------------------------------------
54 #include "heapManager.h"
55 #include "CreateStruct.h"
59 #define FILECODE PROC_COMMON_AMDLATERUNAPTASK_FILECODE
60 /*----------------------------------------------------------------------------------------
61 * D E F I N I T I O N S A N D M A C R O S
62 *----------------------------------------------------------------------------------------
66 /*----------------------------------------------------------------------------------------
67 * T Y P E D E F S A N D S T R U C T U R E S
68 *----------------------------------------------------------------------------------------
72 /*----------------------------------------------------------------------------------------
73 * 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
74 *----------------------------------------------------------------------------------------
78 /*----------------------------------------------------------------------------------------
79 * E X P O R T E D F U N C T I O N S
80 *----------------------------------------------------------------------------------------
82 extern CONST DISPATCH_TABLE ApDispatchTable[];
84 /*---------------------------------------------------------------------------------------*/
86 * Application Processor perform a function as directed by the BSC.
88 * This is needed for an AP task that must run after AGESA has relinquished control
89 * of the APs to the IBV.
91 * @param[in] AmdApExeParams The interface struct for any required routine.
93 * @return The most severe AGESA_STATUS returned by any called service. Note
94 * that this will be the return value passed back to the BSC as the
95 * return value for the call out.
100 IN AP_EXE_PARAMS *AmdApExeParams
103 AGESA_STATUS CalledAgesaStatus;
104 AGESA_STATUS ApLateTaskStatus;
105 DISPATCH_TABLE *Entry;
107 AGESA_TESTPOINT (TpIfAmdLateRunApTaskEntry, &AmdApExeParams->StdHeader);
109 ASSERT (AmdApExeParams != NULL);
110 ApLateTaskStatus = AGESA_SUCCESS;
111 CalledAgesaStatus = AGESA_UNSUPPORTED;
113 // Dispatch, if valid
114 Entry = (DISPATCH_TABLE *) ApDispatchTable;
115 while (Entry->FunctionId != 0) {
116 if (AmdApExeParams->FunctionNumber == Entry->FunctionId) {
117 CalledAgesaStatus = Entry->EntryPoint (AmdApExeParams);
123 if (CalledAgesaStatus > ApLateTaskStatus) {
124 ApLateTaskStatus = CalledAgesaStatus;
127 AGESA_TESTPOINT (TpIfAmdLateRunApTaskExit, &AmdApExeParams->StdHeader);
128 return ApLateTaskStatus;
131 /*---------------------------------------------------------------------------------------*/
133 * Constructor for the AMD_LATE_RUN_AP_TASK function.
135 * This routine is responsible for setting default values for the
136 * input parameters needed by the AMD_S3_SAVE entry point.
138 * @param[in] StdHeader The standard header.
139 * @param[in,out] AmdApExeParams Required input parameters for the AMD_LATE_RUN_AP_TASK
142 * @retval AGESA_SUCCESS Always Succeeds.
146 AmdLateRunApTaskInitializer (
147 IN AMD_CONFIG_PARAMS *StdHeader,
148 IN OUT AP_EXE_PARAMS *AmdApExeParams
151 ASSERT (StdHeader != NULL);
152 ASSERT (AmdApExeParams != NULL);
154 AmdApExeParams->StdHeader = *StdHeader;
155 AmdApExeParams->FunctionNumber = 0;
156 AmdApExeParams->RelatedDataBlock = NULL;
157 AmdApExeParams->RelatedBlockLength = 0;
158 return AGESA_SUCCESS;