GNUBoot
/
coreboot-kgpe-d16
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

northbridge/amd: Doxygen fixes 

- Add missing parameter names in several files
- remove parameter types in several files
- remove lines from doxygen documentation.  These should be outside the
doxygen comments.
- Some of the comments shouldn't have been doxygen style.  Turn these
into regular non-doxygen comments.

Change-Id: Ieccfe237385efee007b48308d58eb0a6a12f5bfa
Signed-off-by: Martin Roth <gaumless@gmail.com>
Reviewed-on: http://review.coreboot.org/8153
Tested-by: build bot (Jenkins)
Reviewed-by: Edward O'Callaghan <eocallaghan@alterapraxis.com>
This commit is contained in:
Martin Roth 2015-01-06 10:27:39 -07:00
parent aa3dd5d5db
commit f4cb4128ad
9 changed files with 245 additions and 260 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
src/northbridge/amd/amdfam10/misc_control.c
View File

@ -39,7 +39,7 @@
/** /**
* @brief Read resources for AGP aperture * @brief Read resources for AGP aperture
* *
* @param * @param dev
* *
* There is only one AGP aperture resource needed. The resoruce is added to * There is only one AGP aperture resource needed. The resoruce is added to
* the northbridge of BSP. * the northbridge of BSP.

42
src/northbridge/amd/amdht/h3finit.c
View File

@ -119,8 +119,8 @@
* Returns the number of nodes in the compressed graph * Returns the number of nodes in the compressed graph
* *
* Parameters: * Parameters:
* @param[in] u8 graph = a compressed graph * @param[in] graph = a compressed graph
* @param[out] u8 results = the number of nodes in the graph * @param[out] results = the number of nodes in the graph
* --------------------------------------------------------------------------------------- * ---------------------------------------------------------------------------------------
*/ */
static u8 graphHowManyNodes(u8 *graph) static u8 graphHowManyNodes(u8 *graph)
@ -138,10 +138,10 @@ static u8 graphHowManyNodes(u8 *graph)
* Relies on rule that directly connected nodes always route requests directly. * Relies on rule that directly connected nodes always route requests directly.
* *
* Parameters: * Parameters:
* @param[in] u8 graph = the graph to examine * @param[in] graph = the graph to examine
* @param[in] u8 nodeA = the node number of the first node * @param[in] nodeA = the node number of the first node
* @param[in] u8 nodeB = the node number of the second node * @param[in] nodeB = the node number of the second node
* @param[out] BOOL results = true if nodeA connects to nodeB false if not * @param[out] results = true if nodeA connects to nodeB false if not
* --------------------------------------------------------------------------------------- * ---------------------------------------------------------------------------------------
*/ */
static BOOL graphIsAdjacent(u8 *graph, u8 nodeA, u8 nodeB) static BOOL graphIsAdjacent(u8 *graph, u8 nodeA, u8 nodeB)
@ -190,10 +190,10 @@ static u8 graphGetRsp(u8 *graph, u8 nodeA, u8 nodeB)
* it is the responsibility of the caller to apply any permutation needed. * it is the responsibility of the caller to apply any permutation needed.
* *
* Parameters: * Parameters:
* @param[in] u8 graph = the graph to examine * @param[in] graph = the graph to examine
* @param[in] u8 nodeA = the node number of the first node * @param[in] nodeA = the node number of the first node
* @param[in] u8 nodeB = the node number of the second node * @param[in] nodeB = the node number of the second node
* @param[out] u8 results = The request route node * @param[out] results = The request route node
* --------------------------------------------------------------------------------------- * ---------------------------------------------------------------------------------------
*/ */
static u8 graphGetReq(u8 *graph, u8 nodeA, u8 nodeB) static u8 graphGetReq(u8 *graph, u8 nodeA, u8 nodeB)
@ -213,10 +213,10 @@ static u8 graphGetReq(u8 *graph, u8 nodeA, u8 nodeB)
* nodeB towards * nodeB towards
* *
* Parameters: * Parameters:
* @param[in] u8 graph = the graph to examine * @param[in] graph = the graph to examine
* @param[in] u8 nodeA = the node number of the first node * @param[in] nodeA = the node number of the first node
* @param[in] u8 nodeB = the node number of the second node * @param[in] nodeB = the node number of the second node
* OU u8 results = the broadcast routes for nodeA from nodeB * OU results = the broadcast routes for nodeA from nodeB
* --------------------------------------------------------------------------------------- * ---------------------------------------------------------------------------------------
*/ */
static u8 graphGetBc(u8 *graph, u8 nodeA, u8 nodeB) static u8 graphGetBc(u8 *graph, u8 nodeA, u8 nodeB)
@ -273,7 +273,9 @@ static void routeFromBSP(u8 targetNode, u8 actualTarget, sMainData *pDat)
pDat->nb->writeRoutingTable(predecessorNode, actualTarget, predecessorLink, pDat->nb); pDat->nb->writeRoutingTable(predecessorNode, actualTarget, predecessorLink, pDat->nb);
} }
/*---------------------------------------------------------------------------------------- /*---------------------------------------------------------------------------*/
/**
* u8 * u8
* convertNodeToLink(u8 srcNode, u8 targetNode, sMainData *pDat) * convertNodeToLink(u8 srcNode, u8 targetNode, sMainData *pDat)
* *
@ -281,11 +283,11 @@ static void routeFromBSP(u8 targetNode, u8 actualTarget, sMainData *pDat)
* Return the link on source node which connects to target node * Return the link on source node which connects to target node
* *
* Parameters: * Parameters:
* @param[in] u8 srcNode = the source node * @param[in] srcNode = the source node
* @param[in] u8 targetNode = the target node to find the link to * @param[in] targetNode = the target node to find the link to
* @param[in] sMainData* pDat = our global state * @param[in] pDat = our global state
* @param[out] u8 results = the link on source which connects to target * @return the link on source which connects to target
* --------------------------------------------------------------------------------------- *
*/ */
static u8 convertNodeToLink(u8 srcNode, u8 targetNode, sMainData *pDat) static u8 convertNodeToLink(u8 srcNode, u8 targetNode, sMainData *pDat)
{ {

414
src/northbridge/amd/amdht/h3ncmn.c
View File

@ -89,7 +89,7 @@
*** FAMILY/NORTHBRIDGE SPECIFIC FUNCTIONS *** *** FAMILY/NORTHBRIDGE SPECIFIC FUNCTIONS ***
***************************************************************************/ ***************************************************************************/
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* SBDFO * SBDFO
* makeLinkBase(u8 currentNode, u8 currentLink) * makeLinkBase(u8 currentNode, u8 currentLink)
@ -99,12 +99,10 @@
* PCI config address for a link. * PCI config address for a link.
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node this link is on * @param[in] node = the node this link is on
* @param[in] u8 link = the link * @param[in] link = the link
* @param[out] SBDFO result = the pci config address
* *
* --------------------------------------------------------------------------------------- *****************************************************************************/
*/
static SBDFO makeLinkBase(u8 node, u8 link) static SBDFO makeLinkBase(u8 node, u8 link)
{ {
SBDFO linkBase; SBDFO linkBase;
@ -125,7 +123,7 @@ static SBDFO makeLinkBase(u8 node, u8 link)
return linkBase; return linkBase;
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* void * void
* setHtControlRegisterBits(SBDFO reg, u8 hiBit, u8 loBit, u32 *pValue) * setHtControlRegisterBits(SBDFO reg, u8 hiBit, u8 loBit, u32 *pValue)
@ -137,13 +135,12 @@ static SBDFO makeLinkBase(u8 node, u8 link)
* NOTE: This routine is called for IO Devices as well as CPUs! * NOTE: This routine is called for IO Devices as well as CPUs!
* *
* Parameters: * Parameters:
* @param[in] SBDFO reg = the PCI config address the control register * @param[in] reg = the PCI config address the control register
* @param[in] u8 hiBit = the high bit number * @param[in] hiBit = the high bit number
* @param[in] u8 loBit = the low bit number * @param[in] loBit = the low bit number
* @param[in] u8 pValue = the value to write to that bit range. Bit 0 => loBit. * @param[in] pValue = the value to write to that bit range. Bit 0 => loBit.
* *
* --------------------------------------------------------------------------------------- *****************************************************************************/
*/
static void setHtControlRegisterBits(SBDFO reg, u8 hiBit, u8 loBit, u32 *pValue) static void setHtControlRegisterBits(SBDFO reg, u8 hiBit, u8 loBit, u32 *pValue)
{ {
u32 temp, mask; u32 temp, mask;
@ -164,7 +161,7 @@ static void setHtControlRegisterBits(SBDFO reg, u8 hiBit, u8 loBit, u32 *pValue)
AmdPCIWrite(reg, &temp); AmdPCIWrite(reg, &temp);
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* writeRoutingTable(u8 node, u8 target, u8 Link, cNorthBridge *nb) * writeRoutingTable(u8 node, u8 target, u8 Link, cNorthBridge *nb)
@ -180,13 +177,12 @@ static void setHtControlRegisterBits(SBDFO reg, u8 hiBit, u8 loBit, u32 *pValue)
* response paths. * response paths.
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node that will have it's routing tables modified. * @param[in] node = the node that will have it's routing tables modified.
* @param[in] u8 target = For routing to node target * @param[in] target = For routing to node target
* @param[in] u8 Link = Link from node to target * @param[in] link = Link from node to target
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* *
* --------------------------------------------------------------------------------------- *****************************************************************************/
*/
static void writeRoutingTable(u8 node, u8 target, u8 link, cNorthBridge *nb) static void writeRoutingTable(u8 node, u8 target, u8 link, cNorthBridge *nb)
{ {
@ -204,7 +200,7 @@ static void writeRoutingTable(u8 node, u8 target, u8 link, cNorthBridge *nb)
#endif #endif
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* writeNodeID(u8 node, u8 nodeID, cNorthBridge *nb) * writeNodeID(u8 node, u8 nodeID, cNorthBridge *nb)
@ -213,12 +209,11 @@ static void writeRoutingTable(u8 node, u8 target, u8 link, cNorthBridge *nb)
* Modifies the NodeID register on the target node * Modifies the NodeID register on the target node
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node that will have its NodeID altered. * @param[in] node = the node that will have its NodeID altered.
* @param[in] u8 nodeID = the new value for NodeID * @param[in] nodeID = the new value for NodeID
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* *
* --------------------------------------------------------------------------------------- *****************************************************************************/
*/
static void writeNodeID(u8 node, u8 nodeID, cNorthBridge *nb) static void writeNodeID(u8 node, u8 nodeID, cNorthBridge *nb)
{ {
@ -232,7 +227,7 @@ static void writeNodeID(u8 node, u8 nodeID, cNorthBridge *nb)
2, 0, &temp); 2, 0, &temp);
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* readDefLnk(u8 node, cNorthBridge *nb) * readDefLnk(u8 node, cNorthBridge *nb)
@ -242,15 +237,14 @@ static void writeNodeID(u8 node, u8 nodeID, cNorthBridge *nb)
* from node * from node
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node that will have its NodeID altered. * @param[in] node = the node that will have its NodeID altered.
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* @param[out] u8 result = The HyperTransport link where the request to * @return The HyperTransport link where the request to
* read the default link came from. Since this * read the default link came from. Since this
* code is running on the BSP, this should be the link * code is running on the BSP, this should be the link
* pointing back towards the BSP. * pointing back towards the BSP.
* *
* --------------------------------------------------------------------------------------- *****************************************************************************/
*/
static u8 readDefLnk(u8 node, cNorthBridge *nb) static u8 readDefLnk(u8 node, cNorthBridge *nb)
{ {
@ -271,7 +265,7 @@ static u8 readDefLnk(u8 node, cNorthBridge *nb)
return (u8)deflink; return (u8)deflink;
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* enableRoutingTables(u8 node, cNorthBridge *nb) * enableRoutingTables(u8 node, cNorthBridge *nb)
@ -280,11 +274,10 @@ static u8 readDefLnk(u8 node, cNorthBridge *nb)
* Turns routing tables on for a given node * Turns routing tables on for a given node
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node that will have it's routing tables enabled * @param[in] node = the node that will have it's routing tables enabled
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* *
* --------------------------------------------------------------------------------------- *****************************************************************************/
*/
static void enableRoutingTables(u8 node, cNorthBridge *nb) static void enableRoutingTables(u8 node, cNorthBridge *nb)
{ {
@ -299,7 +292,7 @@ static void enableRoutingTables(u8 node, cNorthBridge *nb)
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static BOOL * static BOOL
* verifyLinkIsCoherent(u8 node, u8 Link, cNorthBridge *nbk) * verifyLinkIsCoherent(u8 node, u8 Link, cNorthBridge *nbk)
@ -308,10 +301,10 @@ static void enableRoutingTables(u8 node, cNorthBridge *nb)
* Verify that the link is coherent, connected, and ready * Verify that the link is coherent, connected, and ready
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node that will be examined * @param[in] node = the node that will be examined
* @param[in] u8 link = the link on that Node to examine * @param[in] link = the link on that Node to examine
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* @param[out] u8 result = true - The link has the following status * @return true - The link has the following status
* linkCon=1, Link is connected * linkCon=1, Link is connected
* InitComplete=1, Link initialization is complete * InitComplete=1, Link initialization is complete
* NC=0, Link is coherent * NC=0, Link is coherent
@ -319,8 +312,7 @@ static void enableRoutingTables(u8 node, cNorthBridge *nb)
* LinkConPend=0 Link connection is not pending * LinkConPend=0 Link connection is not pending
* false- The link has some other status * false- The link has some other status
* *
* --------------------------------------------------------------------------------------- *****************************************************************************/
*/
static BOOL verifyLinkIsCoherent(u8 node, u8 link, cNorthBridge *nb) static BOOL verifyLinkIsCoherent(u8 node, u8 link, cNorthBridge *nb)
{ {
@ -343,7 +335,7 @@ static BOOL verifyLinkIsCoherent(u8 node, u8 link, cNorthBridge *nb)
#endif /* HT_BUILD_NC_ONLY */ #endif /* HT_BUILD_NC_ONLY */
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static bool * static bool
* readTrueLinkFailStatus(u8 node, u8 link, sMainData *pDat, cNorthBridge *nb) * readTrueLinkFailStatus(u8 node, u8 link, sMainData *pDat, cNorthBridge *nb)
@ -362,15 +354,15 @@ static BOOL verifyLinkIsCoherent(u8 node, u8 link, cNorthBridge *nb)
* 10 1 0 3 No 1 * 10 1 0 3 No 1
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node that will be examined * @param[in] node = the node that will be examined
* @param[in] u8 link = the link on that node to examine * @param[in] link = the link on that node to examine
* @param[in] u8 sMainData = access to call back routine * @param[in] *pDat = access to call back routine
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* @param[out] u8 result = true - the link is not connected or has hard error * @return true - the link is not connected or has hard error
* false- if the link is connected * false- if the link is connected
* *
* --------------------------------------------------------------------------------------- *****************************************************************************/
*/
static BOOL readTrueLinkFailStatus(u8 node, u8 link, sMainData *pDat, cNorthBridge *nb) static BOOL readTrueLinkFailStatus(u8 node, u8 link, sMainData *pDat, cNorthBridge *nb)
{ {
u32 before, after, unconnected, crc; u32 before, after, unconnected, crc;
@ -434,7 +426,7 @@ static BOOL readTrueLinkFailStatus(u8 node, u8 link, sMainData *pDat, cNorthBrid
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static u8 * static u8
* readToken(u8 node, cNorthBridge *nb) * readToken(u8 node, cNorthBridge *nb)
@ -446,12 +438,11 @@ static BOOL readTrueLinkFailStatus(u8 node, u8 link, sMainData *pDat, cNorthBrid
* using it will have no ill-effects during HyperTransport initialization. * using it will have no ill-effects during HyperTransport initialization.
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node that will be examined * @param[in] node = the node that will be examined
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* @param[out] u8 result = the Token read from the node * @return the Token read from the node
* *
* --------------------------------------------------------------------------------------- *****************************************************************************/
*/
static u8 readToken(u8 node, cNorthBridge *nb) static u8 readToken(u8 node, cNorthBridge *nb)
{ {
u32 temp; u32 temp;
@ -470,7 +461,7 @@ static u8 readToken(u8 node, cNorthBridge *nb)
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* writeToken(u8 node, u8 Value, cNorthBridge *nb) * writeToken(u8 node, u8 Value, cNorthBridge *nb)
@ -483,11 +474,11 @@ static u8 readToken(u8 node, cNorthBridge *nb)
* Limiting use to 4 bits makes code GH to rev F compatible. * Limiting use to 4 bits makes code GH to rev F compatible.
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node that will be examined * @param[in] node = the node that will be examined
* @param[in] cNorthBridge *nb = this northbridge * @param value
* @param[in] *nb = this northbridge
* *
* --------------------------------------------------------------------------------------- *****************************************************************************/
*/
static void writeToken(u8 node, u8 value, cNorthBridge *nb) static void writeToken(u8 node, u8 value, cNorthBridge *nb)
{ {
u32 temp = value; u32 temp = value;
@ -502,7 +493,7 @@ static void writeToken(u8 node, u8 value, cNorthBridge *nb)
19, 16, &temp); 19, 16, &temp);
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static u8 * static u8
* fam0FGetNumCoresOnNode(u8 node, cNorthBridge *nb) * fam0FGetNumCoresOnNode(u8 node, cNorthBridge *nb)
@ -511,9 +502,9 @@ static void writeToken(u8 node, u8 value, cNorthBridge *nb)
* Return the number of cores (1 based count) on node. * Return the number of cores (1 based count) on node.
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node that will be examined * @param[in] node = the node that will be examined
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* @param[out] u8 result = the number of cores * @return = the number of cores
* *
* --------------------------------------------------------------------------------------- * ---------------------------------------------------------------------------------------
*/ */
@ -534,7 +525,7 @@ static u8 fam0FGetNumCoresOnNode(u8 node, cNorthBridge *nb)
return (u8)(temp+1); return (u8)(temp+1);
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static u8 * static u8
* fam10GetNumCoresOnNode(u8 node, cNorthBridge *nb) * fam10GetNumCoresOnNode(u8 node, cNorthBridge *nb)
@ -543,11 +534,11 @@ static u8 fam0FGetNumCoresOnNode(u8 node, cNorthBridge *nb)
* Return the number of cores (1 based count) on node. * Return the number of cores (1 based count) on node.
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node that will be examined * @param[in] node = the node that will be examined
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* @param[out] u8 result = the number of cores * @return = the number of cores
*
* *
* ---------------------------------------------------------------------------------------
*/ */
static u8 fam10GetNumCoresOnNode(u8 node, cNorthBridge *nb) static u8 fam10GetNumCoresOnNode(u8 node, cNorthBridge *nb)
{ {
@ -583,7 +574,7 @@ static u8 fam10GetNumCoresOnNode(u8 node, cNorthBridge *nb)
return (u8)(temp+1); return (u8)(temp+1);
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* setTotalNodesAndCores(u8 node, u8 totalNodes, u8 totalCores, cNorthBridge *nb) * setTotalNodesAndCores(u8 node, u8 totalNodes, u8 totalCores, cNorthBridge *nb)
@ -592,10 +583,10 @@ static u8 fam10GetNumCoresOnNode(u8 node, cNorthBridge *nb)
* Write the total number of cores and nodes to the node * Write the total number of cores and nodes to the node
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node that will be examined * @param[in] node = the node that will be examined
* @param[in] u8 totalNodes = the total number of nodes * @param[in] totalNodes = the total number of nodes
* @param[in] u8 totalCores = the total number of cores * @param[in] totalCores = the total number of cores
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* *
* --------------------------------------------------------------------------------------- * ---------------------------------------------------------------------------------------
*/ */
@ -621,7 +612,7 @@ static void setTotalNodesAndCores(u8 node, u8 totalNodes, u8 totalCores, cNorthB
AmdPCIWriteBits(nodeIDReg, 6, 4, &temp); AmdPCIWriteBits(nodeIDReg, 6, 4, &temp);
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* limitNodes(u8 node, cNorthBridge *nb) * limitNodes(u8 node, cNorthBridge *nb)
@ -630,8 +621,8 @@ static void setTotalNodesAndCores(u8 node, u8 totalNodes, u8 totalCores, cNorthB
* Limit coherent config accesses to cpus as indicated by nodecnt. * Limit coherent config accesses to cpus as indicated by nodecnt.
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node that will be examined * @param[in] node = the node that will be examined
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* *
* --------------------------------------------------------------------------------------- * ---------------------------------------------------------------------------------------
*/ */
@ -647,7 +638,7 @@ static void limitNodes(u8 node, cNorthBridge *nb)
15, 15, &temp); 15, 15, &temp);
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* writeFullRoutingTable(u8 node, u8 target, u8 reqLink, u8 rspLink, u32 BClinks, cNorthBridge *nb) * writeFullRoutingTable(u8 node, u8 target, u8 reqLink, u8 rspLink, u32 BClinks, cNorthBridge *nb)
@ -657,12 +648,12 @@ static void limitNodes(u8 node, cNorthBridge *nb)
* link, and broadcast links provided. * link, and broadcast links provided.
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node that will be examined * @param[in] node = the node that will be examined
* @param[in] u8 target = the target node for these routes * @param[in] target = the target node for these routes
* @param[in] u8 reqLink = the link for requests to target * @param[in] reqLink = the link for requests to target
* @param[in] u8 rspLink = the link for responses to target * @param[in] rspLink = the link for responses to target
* @param[in] u32 bClinks = the broadcast links * @param[in] bClinks = the broadcast links
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* *
* --------------------------------------------------------------------------------------- * ---------------------------------------------------------------------------------------
*/ */
@ -696,7 +687,7 @@ static void writeFullRoutingTable(u8 node, u8 target, u8 reqLink, u8 rspLink, u3
#endif /* HT_BUILD_NC_ONLY */ #endif /* HT_BUILD_NC_ONLY */
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static u32 * static u32
* makeKey(u8 currentNode) * makeKey(u8 currentNode)
@ -708,8 +699,8 @@ static void writeFullRoutingTable(u8 node, u8 target, u8 reqLink, u8 rspLink, u3
* same as the BSP's. * same as the BSP's.
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node * @param[in] node = the node
* @param[out] u32 result = the key value * @return = the key value
* *
* --------------------------------------------------------------------------------------- * ---------------------------------------------------------------------------------------
*/ */
@ -732,7 +723,7 @@ static u32 makeKey(u8 node)
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static BOOL * static BOOL
* isCompatible(u8 currentNode, cNorthBridge *nb) * isCompatible(u8 currentNode, cNorthBridge *nb)
@ -743,9 +734,9 @@ static u32 makeKey(u8 node)
* same as the BSP's. * same as the BSP's.
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node * @param[in] node = the node
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* @param[out] BOOL result = true: the new is compatible, false: it is not * @return = true: the new is compatible, false: it is not
* *
* --------------------------------------------------------------------------------------- * ---------------------------------------------------------------------------------------
*/ */
@ -754,7 +745,7 @@ static BOOL isCompatible(u8 node, cNorthBridge *nb)
return (makeKey(node) == nb->compatibleKey); return (makeKey(node) == nb->compatibleKey);
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static BOOL * static BOOL
* fam0fIsCapable(u8 node, sMainData *pDat, cNorthBridge *nb) * fam0fIsCapable(u8 node, sMainData *pDat, cNorthBridge *nb)
@ -764,10 +755,10 @@ static BOOL isCompatible(u8 node, cNorthBridge *nb)
* Return whether the current configuration exceeds the capability. * Return whether the current configuration exceeds the capability.
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node * @param[in] node = the node
* @param[in,out] sMainData *pDat = sysMpCap (updated) and NodesDiscovered * @param[in,out] *pDat = sysMpCap (updated) and NodesDiscovered
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* @param[out] BOOL result = true: system is capable of current config. * @return true: system is capable of current config.
* false: system is not capable of current config. * false: system is not capable of current config.
* *
* --------------------------------------------------------------------------------------- * ---------------------------------------------------------------------------------------
@ -808,7 +799,7 @@ static BOOL fam0fIsCapable(u8 node, sMainData *pDat, cNorthBridge *nb)
#endif #endif
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static BOOL * static BOOL
* fam10IsCapable(u8 node, sMainData *pDat, cNorthBridge *nb) * fam10IsCapable(u8 node, sMainData *pDat, cNorthBridge *nb)
@ -818,10 +809,10 @@ static BOOL fam0fIsCapable(u8 node, sMainData *pDat, cNorthBridge *nb)
* Return whether the current configuration exceeds the capability. * Return whether the current configuration exceeds the capability.
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node * @param[in] node = the node
* @param[in,out] sMainData *pDat = sysMpCap (updated) and NodesDiscovered * @param[in,out] *pDat = sysMpCap (updated) and NodesDiscovered
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* @param[out] BOOL result = true: system is capable of current config. * @return true: system is capable of current config.
* false: system is not capable of current config. * false: system is not capable of current config.
* *
* --------------------------------------------------------------------------------------- * ---------------------------------------------------------------------------------------
@ -861,7 +852,7 @@ static BOOL fam10IsCapable(u8 node, sMainData *pDat, cNorthBridge *nb)
#endif #endif
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* fam0fStopLink(u8 currentNode, u8 currentLink, cNorthBridge *nb) * fam0fStopLink(u8 currentNode, u8 currentLink, cNorthBridge *nb)
@ -870,9 +861,9 @@ static BOOL fam10IsCapable(u8 node, sMainData *pDat, cNorthBridge *nb)
* Disable a cHT link on node by setting F0x[E4, C4, A4, 84][TransOff, EndOfChain]=1 * Disable a cHT link on node by setting F0x[E4, C4, A4, 84][TransOff, EndOfChain]=1
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node this link is on * @param[in] node = the node this link is on
* @param[in] u8 link = the link to stop * @param[in] link = the link to stop
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* *
* --------------------------------------------------------------------------------------- * ---------------------------------------------------------------------------------------
*/ */
@ -892,7 +883,7 @@ static void fam0fStopLink(u8 node, u8 link, cNorthBridge *nb)
#endif #endif
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* commonVoid() * commonVoid()
@ -909,7 +900,7 @@ static void commonVoid(void)
{ {
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static BOOL * static BOOL
* commonReturnFalse() * commonReturnFalse()
@ -918,8 +909,8 @@ static void commonVoid(void)
* Return False. * Return False.
* *
* Parameters: * Parameters:
* @param[out] BOOL result = false * @return = false
* --------------------------------------------------------------------------------------- *
*/ */
static BOOL commonReturnFalse(void) static BOOL commonReturnFalse(void)
{ {
@ -931,7 +922,7 @@ static BOOL commonReturnFalse(void)
*** Northbridge access routines *** *** Northbridge access routines ***
***************************************************************************/ ***************************************************************************/
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static u8 * static u8
* readSbLink(cNorthBridge *nb) * readSbLink(cNorthBridge *nb)
@ -940,8 +931,8 @@ static BOOL commonReturnFalse(void)
* Return the link to the Southbridge * Return the link to the Southbridge
* *
* Parameters: * Parameters:
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* @param[out] u8 results = the link to the southbridge * @return the link to the southbridge
* *
* --------------------------------------------------------------------------------------- * ---------------------------------------------------------------------------------------
*/ */
@ -957,7 +948,7 @@ static u8 readSbLink(cNorthBridge *nb)
return (u8)temp; return (u8)temp;
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static BOOL * static BOOL
* verifyLinkIsNonCoherent(u8 node, u8 link, cNorthBridge *nb) * verifyLinkIsNonCoherent(u8 node, u8 link, cNorthBridge *nb)
@ -966,10 +957,10 @@ static u8 readSbLink(cNorthBridge *nb)
* Verify that the link is non-coherent, connected, and ready * Verify that the link is non-coherent, connected, and ready
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node that will be examined * @param[in] node = the node that will be examined
* @param[in] u8 link = the Link on that node to examine * @param[in] link = the Link on that node to examine
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* @param[out] u8 results = true - The link has the following status * @return = true - The link has the following status
* LinkCon=1, Link is connected * LinkCon=1, Link is connected
* InitComplete=1,Link initilization is complete * InitComplete=1,Link initilization is complete
* NC=1, Link is coherent * NC=1, Link is coherent
@ -995,7 +986,7 @@ static BOOL verifyLinkIsNonCoherent(u8 node, u8 link, cNorthBridge *nb)
return (linkType & HTHOST_TYPE_MASK) == HTHOST_TYPE_NONCOHERENT; return (linkType & HTHOST_TYPE_MASK) == HTHOST_TYPE_NONCOHERENT;
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* ht3SetCFGAddrMap(u8 cfgMapIndex, u8 secBus, u8 subBus, u8 targetNode, u8 targetLink, sMainData *pDat, cNorthBridge *nb) * ht3SetCFGAddrMap(u8 cfgMapIndex, u8 secBus, u8 subBus, u8 targetNode, u8 targetLink, sMainData *pDat, cNorthBridge *nb)
@ -1004,13 +995,13 @@ static BOOL verifyLinkIsNonCoherent(u8 node, u8 link, cNorthBridge *nb)
* Configure and enable config access to a non-coherent chain for the given bus range. * Configure and enable config access to a non-coherent chain for the given bus range.
* *
* Parameters: * Parameters:
* @param[in] u8 cfgRouteIndex = the map entry to set * @param[in] cfgMapIndex = the map entry to set
* @param[in] u8 secBus = The secondary bus number to use * @param[in] secBus = The secondary bus number to use
* @param[in] u8 subBus = The subordinate bus number to use * @param[in] subBus = The subordinate bus number to use
* @param[in] u8 targetNode = The node that shall be the recipient of the traffic * @param[in] targetNode = The node that shall be the recipient of the traffic
* @param[in] u8 targetLink = The link that shall be the recipient of the traffic * @param[in] targetLink = The link that shall be the recipient of the traffic
* @param[in] sMainData* pDat = our global state * @param[in] pDat = our global state
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* *
* --------------------------------------------------------------------------------------- * ---------------------------------------------------------------------------------------
*/ */
@ -1041,7 +1032,7 @@ static void ht3SetCFGAddrMap(u8 cfgMapIndex, u8 secBus, u8 subBus, u8 targetNod
&temp); &temp);
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* ht1SetCFGAddrMap(u8 cfgMapIndex, u8 secBus, u8 subBus, u8 targetNode, u8 targetLink, sMainData *pDat, cNorthBridge *nb) * ht1SetCFGAddrMap(u8 cfgMapIndex, u8 secBus, u8 subBus, u8 targetNode, u8 targetLink, sMainData *pDat, cNorthBridge *nb)
@ -1050,16 +1041,15 @@ static void ht3SetCFGAddrMap(u8 cfgMapIndex, u8 secBus, u8 subBus, u8 targetNod
* Configure and enable config access to a non-coherent chain for the given bus range. * Configure and enable config access to a non-coherent chain for the given bus range.
* *
* Parameters: * Parameters:
* @param[in] u8 cfgMapIndex = the map entry to set * @param[in] cfgMapIndex = the map entry to set
* @param[in] u8 secBus = The secondary bus number to use * @param[in] secBus = The secondary bus number to use
* @param[in] u8 subBus = The subordinate bus number to use * @param[in] subBus = The subordinate bus number to use
* @param[in] u8 targetNode = The node that shall be the recipient of the traffic * @param[in] targetNode = The node that shall be the recipient of the traffic
* @param[in] u8 targetLink = The link that shall be the recipient of the traffic * @param[in] targetLink = The link that shall be the recipient of the traffic
* @param[in] sMainData* pDat = our global state * @param[in] pDat = our global state
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* *
* --------------------------------------------------------------------------------------- ******************************************************************************/
*/
static void ht1SetCFGAddrMap(u8 cfgMapIndex, u8 secBus, u8 subBus, u8 targetNode, u8 targetLink, sMainData *pDat, cNorthBridge *nb) static void ht1SetCFGAddrMap(u8 cfgMapIndex, u8 secBus, u8 subBus, u8 targetNode, u8 targetLink, sMainData *pDat, cNorthBridge *nb)
{ {
u8 curNode; u8 curNode;
@ -1094,8 +1084,7 @@ static void ht1SetCFGAddrMap(u8 cfgMapIndex, u8 secBus, u8 subBus, u8 targetNode
*** Link Optimization *** *** Link Optimization ***
***************************************************************************/ ***************************************************************************/
/**---------------------------------------------------------------------------------------- /**
*
* static u8 * static u8
* convertBitsToWidth(u8 value, cNorthBridge *nb) * convertBitsToWidth(u8 value, cNorthBridge *nb)
* *
@ -1103,12 +1092,11 @@ static void ht1SetCFGAddrMap(u8 cfgMapIndex, u8 secBus, u8 subBus, u8 targetNode
* Given the bits set in the register field, return the width it represents * Given the bits set in the register field, return the width it represents
* *
* Parameters: * Parameters:
* @param[in] u8 value = The bits for the register * @param[in] value = The bits for the register
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* @param[out] u8 results = The width * @return The width
* *
* --------------------------------------------------------------------------------------- ******************************************************************************/
*/
static u8 convertBitsToWidth(u8 value, cNorthBridge *nb) static u8 convertBitsToWidth(u8 value, cNorthBridge *nb)
{ {
switch(value) { switch(value) {
@ -1121,7 +1109,7 @@ static u8 convertBitsToWidth(u8 value, cNorthBridge *nb)
return 0; // shut up GCC. return 0; // shut up GCC.
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static u8 * static u8
* convertWidthToBits(u8 value, cNorthBridge *nb) * convertWidthToBits(u8 value, cNorthBridge *nb)
@ -1130,12 +1118,11 @@ static u8 convertBitsToWidth(u8 value, cNorthBridge *nb)
* Translate a desired width setting to the bits to set in the register field * Translate a desired width setting to the bits to set in the register field
* *
* Parameters: * Parameters:
* @param[in] u8 value = The width * @param[in] value = The width
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* @param[out] u8 results = The bits for the register * @return The bits for the register
* *
* --------------------------------------------------------------------------------------- ******************************************************************************/
*/
static u8 convertWidthToBits(u8 value, cNorthBridge *nb) static u8 convertWidthToBits(u8 value, cNorthBridge *nb)
{ {
switch (value) { switch (value) {
@ -1148,7 +1135,7 @@ static u8 convertWidthToBits(u8 value, cNorthBridge *nb)
return 0; // shut up GCC return 0; // shut up GCC
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static u16 * static u16
* ht1NorthBridgeFreqMask(u8 NodeID, cNorthBridge *nb) * ht1NorthBridgeFreqMask(u8 NodeID, cNorthBridge *nb)
@ -1158,19 +1145,18 @@ static u8 convertWidthToBits(u8 value, cNorthBridge *nb)
* northbridge frequency. * northbridge frequency.
* *
* Parameters: * Parameters:
* @param[in] u8 node = Result could (later) be for a specific node * @param[in] node = Result could (later) be for a specific node
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* @param[out] u16 results = Frequency mask * @return Frequency mask
* *
* --------------------------------------------------------------------------------------- ******************************************************************************/
*/
static u16 ht1NorthBridgeFreqMask(u8 node, cNorthBridge *nb) static u16 ht1NorthBridgeFreqMask(u8 node, cNorthBridge *nb)
{ {
/* only up to HT1 speeds */ /* only up to HT1 speeds */
return (HT_FREQUENCY_LIMIT_HT1_ONLY); return (HT_FREQUENCY_LIMIT_HT1_ONLY);
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static u16 * static u16
* fam10NorthBridgeFreqMask(u8 NodeID, cNorthBridge *nb) * fam10NorthBridgeFreqMask(u8 NodeID, cNorthBridge *nb)
@ -1180,12 +1166,11 @@ static u16 ht1NorthBridgeFreqMask(u8 node, cNorthBridge *nb)
* northbridge frequency. * northbridge frequency.
* *
* Parameters: * Parameters:
* @param[in] u8 node = Result could (later) be for a specific node * @param[in] node = Result could (later) be for a specific node
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* @param[out] u16 results = Frequency mask * @return = Frequency mask
* *
* --------------------------------------------------------------------------------------- ******************************************************************************/
*/
static u16 fam10NorthBridgeFreqMask(u8 node, cNorthBridge *nb) static u16 fam10NorthBridgeFreqMask(u8 node, cNorthBridge *nb)
{ {
u8 nbCOF; u8 nbCOF;
@ -1225,7 +1210,7 @@ static u16 fam10NorthBridgeFreqMask(u8 node, cNorthBridge *nb)
return (fixEarlySampleFreqCapability(supported)); return (fixEarlySampleFreqCapability(supported));
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* gatherLinkData(sMainData *pDat, cNorthBridge *nb) * gatherLinkData(sMainData *pDat, cNorthBridge *nb)
@ -1235,11 +1220,10 @@ static u16 fam10NorthBridgeFreqMask(u8 node, cNorthBridge *nb)
* capabilities. * capabilities.
* *
* Parameters: * Parameters:
* @param[in,out] sMainData* pDat = our global state, port list * @param[in,out] pDat = our global state, port list
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* *
* --------------------------------------------------------------------------------------- ******************************************************************************/
*/
static void gatherLinkData(sMainData *pDat, cNorthBridge *nb) static void gatherLinkData(sMainData *pDat, cNorthBridge *nb)
{ {
u8 i; u8 i;
@ -1301,7 +1285,7 @@ static void gatherLinkData(sMainData *pDat, cNorthBridge *nb)
} }
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* setLinkData(sMainData *pDat, cNorthBridge *nb) * setLinkData(sMainData *pDat, cNorthBridge *nb)
@ -1311,11 +1295,10 @@ static void gatherLinkData(sMainData *pDat, cNorthBridge *nb)
* port list data structure. * port list data structure.
* *
* Parameters: * Parameters:
* @param[in] sMainData* pDat = our global state, port list * @param[in] pDat = our global state, port list
* @param[in] cNorthBridge *nb = this northbridge * @param[in] *nb = this northbridge
* *
* --------------------------------------------------------------------------------------- ******************************************************************************/
*/
static void setLinkData(sMainData *pDat, cNorthBridge *nb) static void setLinkData(sMainData *pDat, cNorthBridge *nb)
{ {
u8 i; u8 i;
@ -1534,7 +1517,7 @@ static void setLinkData(sMainData *pDat, cNorthBridge *nb)
} }
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* void * void
* fam0fWriteHTLinkCmdBufferAlloc(u8 node, u8 link, u8 req, u8 preq, u8 rsp, u8 prb) * fam0fWriteHTLinkCmdBufferAlloc(u8 node, u8 link, u8 req, u8 preq, u8 rsp, u8 prb)
@ -1545,15 +1528,14 @@ static void setLinkData(sMainData *pDat, cNorthBridge *nb)
* family 10h and family 0fh northbridges. * family 10h and family 0fh northbridges.
* *
* Parameters: * Parameters:
* @param[in] u8 node = The node to set allocations on * @param[in] node = The node to set allocations on
* @param[in] u8 link = the link to set allocations on * @param[in] link = the link to set allocations on
* @param[in] u8 req = non-posted Request Command Buffers * @param[in] req = non-posted Request Command Buffers
* @param[in] u8 preq = Posted Request Command Buffers * @param[in] preq = Posted Request Command Buffers
* @param[in] u8 rsp = Response Command Buffers * @param[in] rsp = Response Command Buffers
* @param[in] u8 prb = Probe Command Buffers * @param[in] prb = Probe Command Buffers
* *
* --------------------------------------------------------------------------------------- ******************************************************************************/
*/
#ifndef HT_BUILD_NC_ONLY #ifndef HT_BUILD_NC_ONLY
static void fam0fWriteHTLinkCmdBufferAlloc(u8 node, u8 link, u8 req, u8 preq, u8 rsp, u8 prb) static void fam0fWriteHTLinkCmdBufferAlloc(u8 node, u8 link, u8 req, u8 preq, u8 rsp, u8 prb)
@ -1579,7 +1561,7 @@ static void fam0fWriteHTLinkCmdBufferAlloc(u8 node, u8 link, u8 req, u8 preq, u8
} }
#endif /* HT_BUILD_NC_ONLY */ #endif /* HT_BUILD_NC_ONLY */
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* void * void
* fam0fWriteHTLinkDatBufferAlloc(u8 node, u8 link, u8 reqD, u8 preqD, u8 rspD) * fam0fWriteHTLinkDatBufferAlloc(u8 node, u8 link, u8 reqD, u8 preqD, u8 rspD)
@ -1590,14 +1572,13 @@ static void fam0fWriteHTLinkCmdBufferAlloc(u8 node, u8 link, u8 req, u8 preq, u8
* family 10h and family 0fh northbridges. * family 10h and family 0fh northbridges.
* *
* Parameters: * Parameters:
* @param[in] u8 node = The node to set allocations on * @param[in] node = The node to set allocations on
* @param[in] u8 link = the link to set allocations on * @param[in] link = the link to set allocations on
* @param[in] u8 reqD = non-posted Request Data Buffers * @param[in] reqD = non-posted Request Data Buffers
* @param[in] u8 preqD = Posted Request Data Buffers * @param[in] preqD = Posted Request Data Buffers
* @param[in] u8 rspD = Response Data Buffers * @param[in] rspD = Response Data Buffers
* *
* --------------------------------------------------------------------------------------- ******************************************************************************/
*/
#ifndef HT_BUILD_NC_ONLY #ifndef HT_BUILD_NC_ONLY
static void fam0fWriteHTLinkDatBufferAlloc(u8 node, u8 link, u8 reqD, u8 preqD, u8 rspD) static void fam0fWriteHTLinkDatBufferAlloc(u8 node, u8 link, u8 reqD, u8 preqD, u8 rspD)
@ -1620,7 +1601,7 @@ static void fam0fWriteHTLinkDatBufferAlloc(u8 node, u8 link, u8 reqD, u8 preqD,
} }
#endif /* HT_BUILD_NC_ONLY */ #endif /* HT_BUILD_NC_ONLY */
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* ht3WriteTrafficDistribution(u32 links01, u32 links10, cNorthBridge *nb) * ht3WriteTrafficDistribution(u32 links01, u32 links10, cNorthBridge *nb)
@ -1629,12 +1610,11 @@ static void fam0fWriteHTLinkDatBufferAlloc(u8 node, u8 link, u8 reqD, u8 preqD,
* Set the traffic distribution register for the links provided. * Set the traffic distribution register for the links provided.
* *
* Parameters: * Parameters:
* @param[in] u32 links01 = coherent links from node 0 to 1 * @param[in] links01 = coherent links from node 0 to 1
* @param[in] u32 links10 = coherent links from node 1 to 0 * @param[in] links10 = coherent links from node 1 to 0
* @param[in] cNorthBridge* nb = this northbridge * @param[in] nb = this northbridge
* *
* --------------------------------------------------------------------------------------- ******************************************************************************/
*/
static void ht3WriteTrafficDistribution(u32 links01, u32 links10, cNorthBridge *nb) static void ht3WriteTrafficDistribution(u32 links01, u32 links10, cNorthBridge *nb)
{ {
#ifndef HT_BUILD_NC_ONLY #ifndef HT_BUILD_NC_ONLY
@ -1676,7 +1656,7 @@ static void ht3WriteTrafficDistribution(u32 links01, u32 links10, cNorthBridge *
#endif /* HT_BUILD_NC_ONLY */ #endif /* HT_BUILD_NC_ONLY */
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* ht1WriteTrafficDistribution(u32 links01, u32 links10, cNorthBridge *nb) * ht1WriteTrafficDistribution(u32 links01, u32 links10, cNorthBridge *nb)
@ -1687,12 +1667,11 @@ static void ht3WriteTrafficDistribution(u32 links01, u32 links10, cNorthBridge *
* perform the buffer tunings on the links required for this config. * perform the buffer tunings on the links required for this config.
* *
* Parameters: * Parameters:
* @param[in] u32 links01 = coherent links from node 0 to 1 * @param[in] links01 = coherent links from node 0 to 1
* @param[in] u32 links01 = coherent links from node 1 to 0 * @param[in] links10 = coherent links from node 1 to 0
* @param[in] cNorthBridge* nb = this northbridge * @param[in] nb = this northbridge
* *
* --------------------------------------------------------------------------------------- ******************************************************************************/
*/
static void ht1WriteTrafficDistribution(u32 links01, u32 links10, cNorthBridge *nb) static void ht1WriteTrafficDistribution(u32 links01, u32 links10, cNorthBridge *nb)
{ {
#ifndef HT_BUILD_NC_ONLY #ifndef HT_BUILD_NC_ONLY
@ -1785,7 +1764,7 @@ static void ht1WriteTrafficDistribution(u32 links01, u32 links10, cNorthBridge *
#endif /* HT_BUILD_NC_ONLY */ #endif /* HT_BUILD_NC_ONLY */
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* fam0fBufferOptimizations(u8 node, sMainData *pDat, cNorthBridge *nb) * fam0fBufferOptimizations(u8 node, sMainData *pDat, cNorthBridge *nb)
@ -1795,12 +1774,11 @@ static void ht1WriteTrafficDistribution(u32 links01, u32 links10, cNorthBridge *
* which require adjustments and apply any standard workarounds to this node. * which require adjustments and apply any standard workarounds to this node.
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node to * @param[in] node = the node to
* @param[in] sMainData *pDat = coherent links from node 0 to 1 * @param[in] *pDat = coherent links from node 0 to 1
* @param[in] cNorthBridge* nb = this northbridge * @param[in] nb = this northbridge
* *
* --------------------------------------------------------------------------------------- ******************************************************************************/
*/
static void fam0fBufferOptimizations(u8 node, sMainData *pDat, cNorthBridge *nb) static void fam0fBufferOptimizations(u8 node, sMainData *pDat, cNorthBridge *nb)
{ {
#ifndef HT_BUILD_NC_ONLY #ifndef HT_BUILD_NC_ONLY
@ -1982,7 +1960,7 @@ static void fam0fBufferOptimizations(u8 node, sMainData *pDat, cNorthBridge *nb)
#endif /* HT_BUILD_NC_ONLY */ #endif /* HT_BUILD_NC_ONLY */
} }
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* static void * static void
* fam10BufferOptimizations(u8 node, sMainData *pDat, cNorthBridge *nb) * fam10BufferOptimizations(u8 node, sMainData *pDat, cNorthBridge *nb)
@ -1992,12 +1970,11 @@ static void fam0fBufferOptimizations(u8 node, sMainData *pDat, cNorthBridge *nb)
* which require adjustments and apply any standard workarounds to this node. * which require adjustments and apply any standard workarounds to this node.
* *
* Parameters: * Parameters:
* @param[in] u8 node = the node to tune * @param[in] node = the node to tune
* @param[in] sMainData *pDat = global state * @param[in] *pDat = global state
* @param[in] cNorthBridge* nb = this northbridge * @param[in] nb = this northbridge
* *
* --------------------------------------------------------------------------------------- ******************************************************************************/
*/
static void fam10BufferOptimizations(u8 node, sMainData *pDat, cNorthBridge *nb) static void fam10BufferOptimizations(u8 node, sMainData *pDat, cNorthBridge *nb)
{ {
u32 temp; u32 temp;
@ -2070,7 +2047,7 @@ static void fam10BufferOptimizations(u8 node, sMainData *pDat, cNorthBridge *nb)
* *
*/ */
/**---------------------------------------------------------------------------------------- /***************************************************************************//**
* *
* void * void
* newNorthBridge(u8 node, cNorthBridge *nb) * newNorthBridge(u8 node, cNorthBridge *nb)
@ -2082,11 +2059,10 @@ static void fam10BufferOptimizations(u8 node, sMainData *pDat, cNorthBridge *nb)
* is provided by nb. * is provided by nb.
* *
* Parameters: * Parameters:
* @param[in] node u8 = create a northbridge interface for this node. * @param node
* @param[out] cNorthBridge* nb = the caller's northbridge structure to initialize. * @param[out] nb = the caller's northbridge structure to initialize.
* *
* --------------------------------------------------------------------------------------- ******************************************************************************/
*/
void newNorthBridge(u8 node, cNorthBridge *nb) void newNorthBridge(u8 node, cNorthBridge *nb)
{ {
u32 match; u32 match;

2
src/northbridge/amd/amdk8/get_sblk_pci1234.c
View File

@ -69,7 +69,7 @@ unsigned node_link_to_bus(unsigned node, unsigned link)
#endif #endif
/** /*
* Why we need the pci1234[] array * Why we need the pci1234[] array
* *
* It will keep the sequence of HT devices in the HT link registers even when a * It will keep the sequence of HT devices in the HT link registers even when a

2
src/northbridge/amd/amdk8/misc_control.c
View File

@ -24,7 +24,7 @@
/** /**
* @brief Read resources for AGP aperture * @brief Read resources for AGP aperture
* *
* @param * @param dev
* *
* There is only one AGP aperture resource needed. The resource is added to * There is only one AGP aperture resource needed. The resource is added to
* the northbridge of BSP. * the northbridge of BSP.

28
src/northbridge/amd/amdmct/mct_ddr3/modtrdim.c
View File

@ -43,10 +43,12 @@
* *
* This function set Rtt_Nom for registered DDR3 dimms on targeted dimm. * This function set Rtt_Nom for registered DDR3 dimms on targeted dimm.
* *
* @param *pMCTData
* @param[in] *pDCTData - Pointer to buffer with information about each DCT * @param[in] *pDCTData - Pointer to buffer with information about each DCT
* dimm - targeted dimm * @param dimm - targeted dimm
* wl - current mode, either write levelization mode or normal mode * @param wl - current mode, either write levelization mode or normal mode
* MemClkFreq - current frequency * @param MemClkFreq - current frequency
* @param rank
* *
* @return tempW1 - Rtt_Nom * @return tempW1 - Rtt_Nom
*/ */
@ -154,10 +156,12 @@ static u32 RttNomTargetRegDimm (sMCTStruct *pMCTData, sDCTStruct *pDCTData, u8 d
* *
* This function set Rtt_Nom for registered DDR3 dimms on non-targeted dimm. * This function set Rtt_Nom for registered DDR3 dimms on non-targeted dimm.
* *
* @param *pMCTData
* @param[in] *pDCTData - Pointer to buffer with information about each DCT * @param[in] *pDCTData - Pointer to buffer with information about each DCT
* dimm - non-targeted dimm * @param dimm - non-targeted dimm
* wl - current mode, either write levelization mode or normal mode * @param wl - current mode, either write levelization mode or normal mode
* MemClkFreq - current frequency * @param MemClkFreq - current frequency
* @param rank
* *
* @return tempW1 - Rtt_Nom * @return tempW1 - Rtt_Nom
*/ */
@ -176,13 +180,16 @@ static u32 RttNomNonTargetRegDimm (sMCTStruct *pMCTData, sDCTStruct *pDCTData, u
* *
* This function set Rtt_Wr for registered DDR3 dimms. * This function set Rtt_Wr for registered DDR3 dimms.
* *
* @param pMCTData
* @param[in] *pDCTData - Pointer to buffer with information about each DCT * @param[in] *pDCTData - Pointer to buffer with information about each DCT
* dimm - targeted dimm * @param dimm - targeted dimm
* wl - current mode, either write levelization mode or normal mode * @param wl - current mode, either write levelization mode or normal mode
* MemClkFreq - current frequency * @param MemClkFreq - current frequency
* @param rank
* *
* @return tempW1 - Rtt_Wr * @return tempW1 - Rtt_Wr
*/ */
static u32 RttWrRegDimm (sMCTStruct *pMCTData, sDCTStruct *pDCTData, u8 dimm, BOOL wl, u8 MemClkFreq, u8 rank) static u32 RttWrRegDimm (sMCTStruct *pMCTData, sDCTStruct *pDCTData, u8 dimm, BOOL wl, u8 MemClkFreq, u8 rank)
{ {
u32 tempW1; u32 tempW1;
@ -238,8 +245,9 @@ static u32 RttWrRegDimm (sMCTStruct *pMCTData, sDCTStruct *pDCTData, u8 dimm, BO
* *
* This function set WrLvOdt for registered DDR3 dimms. * This function set WrLvOdt for registered DDR3 dimms.
* *
* @param *pMCTData
* @param[in] *pDCTData - Pointer to buffer with information about each DCT * @param[in] *pDCTData - Pointer to buffer with information about each DCT
* dimm - targeted dimm * @param dimm - targeted dimm
* *
* @return WrLvOdt * @return WrLvOdt
*/ */

4
src/northbridge/amd/cimx/rd890/NbPlatform.h
View File

@ -80,10 +80,8 @@
// CIMX configuration parameters // CIMX configuration parameters
//#define CIMX_B2_IMAGE_BASE_ADDRESS 0xFFF40000 //#define CIMX_B2_IMAGE_BASE_ADDRESS 0xFFF40000
/** /*
* PCIEX_BASE_ADDRESS - Define PCIE base address * PCIEX_BASE_ADDRESS - Define PCIE base address
*
* @param[Option] MOVE_PCIEBAR_TO_F0000000 Set PCIe base address to 0xF7000000
*/ */
#ifdef MOVE_PCIEBAR_TO_F0000000 #ifdef MOVE_PCIEBAR_TO_F0000000
#define PCIEX_BASE_ADDRESS 0xF7000000 #define PCIEX_BASE_ADDRESS 0xF7000000

2
src/northbridge/intel/i82810/raminit.c
View File

@ -134,7 +134,7 @@ SDRAM configuration functions.
/** /**
* Send the specified RAM command to all DIMMs. * Send the specified RAM command to all DIMMs.
* *
* @param The RAM command to send to the DIMM(s). * @param command The RAM command to send to the DIMM(s).
*/ */
static void do_ram_command(u8 command) static void do_ram_command(u8 command)
{ {

1
src/northbridge/intel/i945/raminit.c
View File

@ -3049,6 +3049,7 @@ static void sdram_setup_processor_side(void)
/** /**
* @param boot_path: 0 = normal, 1 = reset, 2 = resume from s3 * @param boot_path: 0 = normal, 1 = reset, 2 = resume from s3
* @param spd_addresses pointer to a list of SPD addresses
*/ */
void sdram_initialize(int boot_path, const u8 *spd_addresses) void sdram_initialize(int boot_path, const u8 *spd_addresses)
{ {