src/vendorcode/amd/agesa/f15/Proc/HT/NbCommon/htNbOptimization.h

   1 /* $NoKeywords:$ */
   2 /**
   3  * @file
   4  *
   5  * Link optimization generic support.
   6  *
   7  * @xrefitem bom "File Content Label" "Release Content"
   8  * @e project:      AGESA
   9  * @e sub-project:  HyperTransport
  10  * @e \$Revision: 44324 $   @e \$Date: 2010-12-22 02:16:51 -0700 (Wed, 22 Dec 2010) $
  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  * Get Link features into system data structure.
  47  *
  48  */
  49 VOID
  50 GatherLinkFeatures (
  51   IN OUT   PORT_DESCRIPTOR        *ThisPort,
  52   IN       HT_INTERFACE           *Interface,
  53   IN       PLATFORM_CONFIGURATION *PlatformConfig,
  54   IN       NORTHBRIDGE            *Nb
  55   );
  56
  57 /**
  58  * Change the hardware state for all Links according to the now optimized data in the
  59  * port list data structure.
  60  *
  61  */
  62 VOID
  63 SetLinkRegang (
  64   IN       UINT8       Node,
  65   IN       UINT8       Link,
  66   IN       NORTHBRIDGE *Nb
  67   );
  68
  69 /**
  70  * Set the link's Unit Id Clumping enable.
  71  *
  72  */
  73 VOID
  74 SetLinkUnitIdClumping (
  75   IN       UINT8       Node,
  76   IN       UINT8       Link,
  77   IN       UINT32      ClumpingEnables,
  78   IN       NORTHBRIDGE *Nb
  79   );
  80
  81 /**
  82  * Change the hardware state for all Links according to the now optimized data in the
  83  * port list data structure.
  84  */
  85 VOID
  86 SetLinkFrequency (
  87   IN       UINT8          Node,
  88   IN       UINT8          Link,
  89   IN       UINT8          Frequency,
  90   IN       NORTHBRIDGE    *Nb
  91   );