AGESA F15: AMD family15 AGESA code
[coreboot.git] / src / vendorcode / amd / agesa / f15 / Proc / CPU / Family / 0x15 / OR / F15OrMicrocodePatchTables.c
1 /* $NoKeywords:$ */
2 /**
3  * @file
4  *
5  * AMD Family_15 Orochi PCI tables with values as defined in BKDG
6  *
7  * @xrefitem bom "File Content Label" "Release Content"
8  * @e project:      AGESA
9  * @e sub-project:  CPU/Family/0x15/OR
10  * @e \$Revision: 55600 $   @e \$Date: 2011-06-23 12:39:18 -0600 (Thu, 23 Jun 2011) $
11  *
12  */
13 /*
14  ******************************************************************************
15  *
16  * Copyright (C) 2012 Advanced Micro Devices, Inc.
17  * All rights reserved.
18  *
19  * Redistribution and use in source and binary forms, with or without
20  * modification, are permitted provided that the following conditions are met:
21  *     * Redistributions of source code must retain the above copyright
22  *       notice, this list of conditions and the following disclaimer.
23  *     * Redistributions in binary form must reproduce the above copyright
24  *       notice, this list of conditions and the following disclaimer in the
25  *       documentation and/or other materials provided with the distribution.
26  *     * Neither the name of Advanced Micro Devices, Inc. nor the names of
27  *       its contributors may be used to endorse or promote products derived
28  *       from this software without specific prior written permission.
29  *
30  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
31  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
32  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
33  * DISCLAIMED. IN NO EVENT SHALL ADVANCED MICRO DEVICES, INC. BE LIABLE FOR ANY
34  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
35  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
36  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
37  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
38  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
39  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
40  *
41  ******************************************************************************
42  */
43
44 /*----------------------------------------------------------------------------------------
45  *                             M O D U L E S    U S E D
46  *----------------------------------------------------------------------------------------
47  */
48 #include "AGESA.h"
49 #include "cpuRegisters.h"
50 #include "cpuEarlyInit.h"
51 #include "cpuFamilyTranslation.h"
52 #include "Filecode.h"
53 CODE_GROUP (G3_DXE)
54 RDATA_GROUP (G3_DXE)
55
56
57 #define FILECODE PROC_CPU_FAMILY_0X15_OR_F15ORMICROCODEPATCHTABLES_FILECODE
58
59
60 /*----------------------------------------------------------------------------------------
61  *                   D E F I N I T I O N S    A N D    M A C R O S
62  *----------------------------------------------------------------------------------------
63  */
64
65 /*----------------------------------------------------------------------------------------
66  *                  T Y P E D E F S     A N D     S T R U C T U R E S
67  *----------------------------------------------------------------------------------------
68  */
69 extern CONST MICROCODE_PATCHES_4K ROMDATA *CpuF15OrMicroCodePatchArray[];
70 extern CONST UINT8 ROMDATA CpuF15OrNumberOfMicrocodePatches;
71
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  *----------------------------------------------------------------------------------------
75  */
76 VOID
77 GetF15OrMicroCodePatchesStruct (
78   IN       CPU_SPECIFIC_SERVICES *FamilySpecificServices,
79      OUT   CONST VOID **OrUcodePtr,
80      OUT   UINT8 *NumberOfElements,
81   IN       AMD_CONFIG_PARAMS *StdHeader
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  *  Returns a table containing the appropriate microcode patches.
92  *
93  *  @CpuServiceMethod{::F_CPU_GET_FAMILY_SPECIFIC_ARRAY}.
94  *
95  *  @param[in]   FamilySpecificServices   The current Family Specific Services.
96  *  @param[out]  OrUcodePtr               Points to the first entry in the table.
97  *  @param[out]  NumberOfElements         Number of valid entries in the table.
98  *  @param[in]   StdHeader                Header for library and services.
99  *
100  */
101 VOID
102 GetF15OrMicroCodePatchesStruct (
103   IN       CPU_SPECIFIC_SERVICES *FamilySpecificServices,
104      OUT   CONST VOID **OrUcodePtr,
105      OUT   UINT8 *NumberOfElements,
106   IN       AMD_CONFIG_PARAMS *StdHeader
107   )
108 {
109   *NumberOfElements = CpuF15OrNumberOfMicrocodePatches;
110   *OrUcodePtr = &CpuF15OrMicroCodePatchArray[0];
111 }
112