AGESA F15: AMD family15 AGESA code
[coreboot.git] / src / vendorcode / amd / agesa / f15 / Proc / HT / NbCommon / htNbNonCoherent.c
1 /* $NoKeywords:$ */
2 /**
3  * @file
4  *
5  *  Northbridge generic non-coherent support routines.
6  *
7  * @xrefitem bom "File Content Label" "Release Content"
8  * @e project:      AGESA
9  * @e sub-project:  HyperTransport
10  * @e \$Revision: 56279 $   @e \$Date: 2011-07-11 13:11:28 -0600 (Mon, 11 Jul 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 /*
46  *----------------------------------------------------------------------------
47  *                                MODULES USED
48  *
49  *----------------------------------------------------------------------------
50  */
51
52
53
54 #include "AGESA.h"
55 #include "amdlib.h"
56 #include "Ids.h"
57 #include "Topology.h"
58 #include "htFeat.h"
59 #include "htNb.h"
60 #include "htNbCommonHardware.h"
61 #include "htNbNonCoherent.h"
62 #include "Filecode.h"
63 CODE_GROUP (G1_PEICC)
64 RDATA_GROUP (G2_PEI)
65
66 #define FILECODE PROC_HT_NBCOMMON_HTNBNONCOHERENT_FILECODE
67 /*----------------------------------------------------------------------------
68  *                          DEFINITIONS AND MACROS
69  *
70  *----------------------------------------------------------------------------
71  */
72
73 /***************************************************************************
74  ***                       Non-coherent init code                        ***
75  ***                    Northbridge access routines                      ***
76  ***************************************************************************/
77
78 /*----------------------------------------------------------------------------------------*/
79 /**
80  * Return the Link to the Southbridge
81  *
82  * @HtNbMethod{::F_READ_SB_LINK}
83  *
84  * @param[in] Nb this northbridge
85  *
86  * @return the Link to the southbridge
87  */
88 UINT8
89 ReadSouthbridgeLink (
90   IN       NORTHBRIDGE *Nb
91   )
92 {
93   UINT32 Temp;
94   PCI_ADDR Reg;
95   Reg.AddressValue = MAKE_SBDFO (MakePciSegmentFromNode (0),
96                                  MakePciBusFromNode (0),
97                                  MakePciDeviceFromNode (0),
98                                  CPU_HTNB_FUNC_00,
99                                  REG_UNIT_ID_0X64);
100   LibAmdPciReadBits (Reg, 10, 8, &Temp, Nb->ConfigHandle);
101   return (UINT8)Temp;
102 }
103
104 /*----------------------------------------------------------------------------------------*/
105 /**
106  * Verify that the Link is non-coherent, connected, and ready
107  *
108  * @HtNbMethod{::F_VERIFY_LINK_IS_NON_COHERENT}
109  *
110  * @param[in]     Node    the Node that will be examined
111  * @param[in]     Link    the Link on that Node to examine
112  * @param[in]     Nb      this northbridge
113  *
114  * @retval        TRUE    The Link has the following status
115  *                            - LinkCon=1,        Link is connected
116  *                            - InitComplete=1,   Link initialization is complete
117  *                            - NC=1,             Link is noncoherent
118  *                            - UniP-cLDT=0,      Link is not Uniprocessor cLDT
119  *                            - LinkConPend=0     Link connection is not pending
120  *  @retval       FALSE   The Link has some other status
121  */
122 BOOLEAN
123 VerifyLinkIsNonCoherent (
124   IN       UINT8       Node,
125   IN       UINT8       Link,
126   IN       NORTHBRIDGE *Nb
127   )
128 {
129   UINT32 LinkType;
130   PCI_ADDR LinkBase;
131
132   ASSERT ((Node < MAX_NODES) && (Link < MAX_NODES));
133
134   LinkBase = Nb->MakeLinkBase (Node, Link, Nb);
135   LinkBase.Address.Register += HTHOST_LINK_TYPE_REG;
136
137   // FN0_98/A4/C4 = LDT Type Register
138   LibAmdPciRead (AccessWidth32, LinkBase, &LinkType, Nb->ConfigHandle);
139
140   // Verify LinkCon = 1, InitComplete = 1, NC = 1, UniP-cLDT = 0, LinkConPend = 0
141   return (BOOLEAN) ((LinkType & HTHOST_TYPE_MASK) ==  HTHOST_TYPE_NONCOHERENT);
142 }