src/vendorcode/amd/agesa/f14/Proc/CPU/Family/0x14/cpuF14BrandId.c

   1 /* $NoKeywords:$ */
   2 /**
   3  * @file
   4  *
   5  * AMD CPU BrandId related functions and structures.
   6  *
   7  * Contains code that provides CPU BrandId information
   8  *
   9  * @xrefitem bom "File Content Label" "Release Content"
  10  * @e project:      AGESA
  11  * @e sub-project:  CPU
  12  * @e \$Revision: 36556 $   @e \$Date: 2010-08-21 01:25:52 +0800 (Sat, 21 Aug 2010) $
  13  *
  14  */
  15 /*
  16  *****************************************************************************
  17  *
  18  * Copyright (c) 2011, Advanced Micro Devices, Inc.
  19  * All rights reserved.
  20  *
  21  * Redistribution and use in source and binary forms, with or without
  22  * modification, are permitted provided that the following conditions are met:
  23  *     * Redistributions of source code must retain the above copyright
  24  *       notice, this list of conditions and the following disclaimer.
  25  *     * Redistributions in binary form must reproduce the above copyright
  26  *       notice, this list of conditions and the following disclaimer in the
  27  *       documentation and/or other materials provided with the distribution.
  28  *     * Neither the name of Advanced Micro Devices, Inc. nor the names of
  29  *       its contributors may be used to endorse or promote products derived
  30  *       from this software without specific prior written permission.
  31  *
  32  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
  33  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  34  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  35  * DISCLAIMED. IN NO EVENT SHALL ADVANCED MICRO DEVICES, INC. BE LIABLE FOR ANY
  36  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  37  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  38  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  39  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  40  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  41  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  42  *
  43  * ***************************************************************************
  44  *
  45  */
  46
  47 /*----------------------------------------------------------------------------------------
  48  *                             M O D U L E S    U S E D
  49  *----------------------------------------------------------------------------------------
  50  */
  51 #include "AGESA.h"
  52 #include "cpuRegisters.h"
  53 #include "cpuEarlyInit.h"
  54 #include "cpuFamilyTranslation.h"
  55 #include "Filecode.h"
  56 #define FILECODE PROC_CPU_FAMILY_0X14_CPUF14BRANDID_FILECODE
  57
  58 /*----------------------------------------------------------------------------------------
  59  *                   D E F I N I T I O N S    A N D    M A C R O S
  60  *----------------------------------------------------------------------------------------
  61  */
  62
  63 /*----------------------------------------------------------------------------------------
  64  *                  T Y P E D E F S     A N D     S T R U C T U R E S
  65  *----------------------------------------------------------------------------------------
  66  */
  67
  68 /*----------------------------------------------------------------------------------------
  69  *           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
  70  *----------------------------------------------------------------------------------------
  71  */
  72
  73 /*----------------------------------------------------------------------------------------
  74  *                          E X P O R T E D    F U N C T I O N S
  75  *----------------------------------------------------------------------------------------
  76  */
  77 extern CPU_BRAND_TABLE *F14BrandIdString1Tables[];
  78 extern CPU_BRAND_TABLE *F14BrandIdString2Tables[];
  79 extern CONST UINT8 F14BrandIdString1TableCount;
  80 extern CONST UINT8 F14BrandIdString2TableCount;
  81
  82 /*---------------------------------------------------------------------------------------
  83  *               T Y P E D E F S,   S T R U C T U R E S,    E N U M S
  84  *---------------------------------------------------------------------------------------
  85  */
  86
  87 /*---------------------------------------------------------------------------------------*/
  88 /**
  89  *  Returns a table containing the appropriate beginnings of the CPU brandstring.
  90  *
  91  *  @CpuServiceMethod{::F_CPU_GET_FAMILY_SPECIFIC_ARRAY}.
  92  *
  93  *  @param[in]   FamilySpecificServices   The current Family Specific Services.
  94  *  @param[out]  BrandString1Ptr          Points to the first entry in the table.
  95  *  @param[out]  NumberOfElements         Number of valid entries in the table.
  96  *  @param[in]   StdHeader                Header for library and services.
  97  *
  98  */
  99 VOID
 100 GetF14BrandIdString1 (
 101   IN       CPU_SPECIFIC_SERVICES *FamilySpecificServices,
 102      OUT   CONST VOID **BrandString1Ptr,
 103      OUT   UINT8 *NumberOfElements,
 104   IN       AMD_CONFIG_PARAMS *StdHeader
 105   )
 106 {
 107   CPU_BRAND_TABLE **TableEntryPtr;
 108
 109   TableEntryPtr = &F14BrandIdString1Tables[0];
 110   *BrandString1Ptr = TableEntryPtr;
 111   *NumberOfElements = F14BrandIdString1TableCount;
 112 }
 113
 114 /*---------------------------------------------------------------------------------------*/
 115 /**
 116  *  Returns a table containing the appropriate endings of the CPU brandstring.
 117  *
 118  *  @CpuServiceMethod{::F_CPU_GET_FAMILY_SPECIFIC_ARRAY}.
 119  *
 120  *  @param[in]   FamilySpecificServices   The current Family Specific Services.
 121  *  @param[out]  BrandString2Ptr          Points to the first entry in the table.
 122  *  @param[out]  NumberOfElements         Number of valid entries in the table.
 123  *  @param[in]   StdHeader                Header for library and services.
 124  *
 125  */
 126 VOID
 127 GetF14BrandIdString2 (
 128   IN       CPU_SPECIFIC_SERVICES *FamilySpecificServices,
 129      OUT   CONST VOID **BrandString2Ptr,
 130      OUT   UINT8 *NumberOfElements,
 131   IN       AMD_CONFIG_PARAMS *StdHeader
 132   )
 133 {
 134   CPU_BRAND_TABLE **TableEntryPtr;
 135
 136   TableEntryPtr = &F14BrandIdString2Tables[0];
 137   *BrandString2Ptr = TableEntryPtr;
 138   *NumberOfElements = F14BrandIdString2TableCount;
 139 }