7 * Header file for the parallel training feature
9 * @xrefitem bom "File Content Label" "Release Content"
11 * @e sub-project: (Mem)
12 * @e \$Revision: 44324 $ @e \$Date: 2010-12-22 02:16:51 -0700 (Wed, 22 Dec 2010) $
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 * ***************************************************************************
47 #ifndef _MFPARALLELTRAINING_H_
48 #define _MFPARALLELTRAINING_H_
50 /*----------------------------------------------------------------------------
51 * Mixed (DEFINITIONS AND MACROS / TYPEDEFS, STRUCTURES, ENUMS)
53 *----------------------------------------------------------------------------
56 /*-----------------------------------------------------------------------------
57 * DEFINITIONS AND MACROS
59 *-----------------------------------------------------------------------------
62 /*----------------------------------------------------------------------------
63 * TYPEDEFS, STRUCTURES, ENUMS
65 *----------------------------------------------------------------------------
68 typedef BOOLEAN (*REMOTE_NBBLOCK_CONSTRUCTOR) (
69 IN OUT MEM_NB_BLOCK *NBPtr,
70 IN DIE_STRUCT *MCTPtr,
71 IN MEM_FEAT_BLOCK_NB *FeatPtr
74 ///< This structure defines the environment on the AP for parallel training
75 typedef struct _REMOTE_TRAINING_ENV {
76 IN OUT AMD_CONFIG_PARAMS StdHeader; ///< Config pointer of BSP
77 IN OUT AGESA_STATUS (*GetPlatformCfg[MAX_PLATFORM_TYPES]) (struct _MEM_DATA_STRUCT *MemData, UINT8 SocketID, CH_DEF_STRUCT *CurrentChannel); ///< look-up platform info
78 IN OUT BOOLEAN (*ErrorHandling)(struct _DIE_STRUCT *MCTPtr, UINT8 DCT, UINT16 ChipSelMask, AMD_CONFIG_PARAMS *StdHeader); ///< Error Handling
79 IN REMOTE_NBBLOCK_CONSTRUCTOR NBBlockCtor; ///< NB Block constructor
80 IN MEM_FEAT_BLOCK_NB *FeatPtr; ///< Feature block pointer
81 IN UINT8 *TableBasedAlterations; ///< Point to an array of data bytes describing desired modifications to register settings
82 IN PSO_TABLE *PlatformMemoryConfiguration; ///< Point to platform config table
83 IN UINT32 HoleBase; ///< Used for Memtyping
84 IN UINT32 UmaSize; ///< Used for Memtyping
85 IN UINT16 BottomIo; ///< Used for Memtyping
86 IN UINT32 SysLimit; ///< Used for Memtyping
87 IN UINT8 BspSocket; ///< Socket number of BSP
88 IN UINT8 BspCore; ///< Core number of BSP
89 IN DIE_STRUCT DieStruct; ///< Remote copy of Die Struct
90 } REMOTE_TRAINING_ENV;
92 ///< This structure defines Die information
93 typedef struct _DIE_INFO {
94 IN OUT UINT8 Socket; ///< Socket number
95 IN OUT UINT8 Core; ///< Core number
96 IN OUT BOOLEAN Training; ///< Training Flag, 1 = Training has been started on this core
100 /*----------------------------------------------------------------------------
101 * FUNCTIONS PROTOTYPE
103 *----------------------------------------------------------------------------
107 MemFParallelTraining (
108 IN OUT REMOTE_TRAINING_ENV *EnvPtr,
109 IN OUT AMD_CONFIG_PARAMS *StdHeader
112 #endif /* _MFPARALLELTRAINING_H_ */