<?xml version="1.0"?>
<!DOCTYPE flagsdescription SYSTEM "http://www.spec.org/dtd/cpuflags2.dtd">

<flagsdescription>

<filename>Maginfra-Platform-Settings-amd-V1.0</filename>

<title>SPEC CPU2017 Platform Settings for Maginfra systems</title>

<os_tuning>
<![CDATA[
<dl>

<dt>cpupower:</dt> 
 <dd>
  The OS 'cpupower' utility is used to change CPU power governors settings. Available settings are: 
  <ul>
      <li> Performance: Run the CPU at the maximum frequency.</li>      
      <li> powersave(default): Run the CPU at the minimum frequency.</li>
      <li> ondemand: Scales the frequency dynamically according to current load. Jumps to the highest frequency and then possibly back off as the idle time increases.</li>
  </ul>
</dd>

<dt>drop_caches:</dt> 
 <dd>
  sysctl is used to change kernel parameters at run-time
  -w vm.drop_caches=3 - clears filesystem caches
 </dd>

<dt>SCALING_GOVERNOR:</dt>
    <dd>
    <p>Setting this environment variable to "performance" to enable cores to run at performance mode. </p>
	<p>"scaling_governor" is a configuration file in Linux's "cpufreq" model. There are five mode in "scaling_governor" which are performance, powersave, userspace, ondemand, and conservative. </p>
	<ul>
	<li>  Performance: Lock the CPU's frequency at top speed without adjusting dynamically,which may require additional power; </li>
	<li>  Powersave: CPU will work at the minimum frequency; </li>
	<li>  Userspace: Provides the corresponding interface for the user-mode application program to adjust the frequency of CPU; </li>
	<li>  Ondemand: Quick dynamic adjustment of CPU frequency on demand, and will reach the maximum frequency; </li>
	<li>  Conservative: Frequency will be adjusted on demand. </li>
	</ul>
	<p>We use "cpupower frequency-set -g performance" to set this environment variable to "performance".</p>
    </dd>

<dt>tuned-adm:</dt>
     <dd>
     <p>A commandline interface for switching between different tuning profiles available in supported Linux distributions. The distribution provided profiles are located in /usr/lib/tuned and the user defined profiles in /etc/tuned. To set a profile, one can issue the command "tuned-adm profile (profile_name)". Below are details about some relevant profiles.</p>
	 <ul>
	 <li> tuned-adm command line utility allows user to switch between user definable tuning profiles.[active, profile (name), off]</li>
	 <li> throughput-performance: For typical throughput performance tuning. Disables power saving mechanisms and enables sysctl settings that improve the throughput performance of disk and network I/O. CPU governor is set to performance and CPU energy performance bias is set to performance. Disk readahead values are increased; </li>
	 <li> latency-performance: For low latency performance tuning. Disables power saving mechanisms. CPU governor is set to performance and locked to the low C states. CPU energy performance bias to performance;</li>
	 <li> balanced: Default profile provides balanced power saving and performance. It enables CPU and disk plugins of tuned and makes the conservative governor is active and also sets the CPU energy performance bias to normal. It also enables power saving on audio and graphics card; </li>
	 <li> powersave: Maximal power saving for whole system. It sets the CPU governor to ondemand governor and energy performance bias to powersave. It also enable power saving on USB, SATA, audio and graphics card; </li>
	 </ul>
	 <p>We use "tuned-adm profile throughput-performance" to set this environment variable to "throughput-performance".</p>
     </dd>

</dl>
]]>
</os_tuning>


<firmware>
<![CDATA[
<dl>

<dt><b>SMT Mode:</b></dt> 
 <dd>
  Can be used to disable symmetric multithreading. To re-enable SMT, a POWER CYCLE is needed after selecting Enable.. 
  <ul>
      <li>Enable: Enables simultaneous multithreading.</li>      
      <li>Disable: Disables simultaneous multithreading so that only one thread or CPU instruction stream is run on a physical CPU core.</li>
  </ul>
 </dd>

<dt><b>Determinism Slider:</b></dt> 
 <dd>
  This BIOS option allows for AGESA determinism to control performance. 
  <ul>
      <li>Performance: Provides predictable performance across all processors of the same type.</li>      
      <li>Power: Maximizes performance within the power limits defined by cTDP and PPT.</li>
      <li>Auto (Default setting): Use AGESA default value for deterministic performance control.</li>
  </ul>
 </dd>

<dt><b>cTDP Control:</b></dt> 
 <dd>
  This BIOS option is for "Configurable TDP (cTDP)", it allows user can set customized value for TDP. Available settings are:
  <ul>
	  <li>Auto: Use the fused TDP value.</li>
	  <li>Manual(Default setting): Let user specifies customized TDP value.</li>
  </ul>
 </dd>
 
 <dt><b>cTDP:</b></dt> 
 <dd>
  TDP is an acronym for "Thermal Design Power." TDP is the recommended target for power used when designing the cooling capacity for a server. 
  EPYC processors are able to control this target power consumption within certain limits. This capability is referred to as "configurable TDP" or "cTDP."
  cTDP can be used to reduce power consumption for greater efficiency, or in some cases, increase power consumption above the default value to provide additional performance.
  cTDP is controlled using a BIOS option.<br/>
<br/>
  The default EPYC cTDP value corresponds with the microprocessor's nominal TDP. 
  The default cTDP value is set at a good balance between performance and energy efficiency. 
<br/>
 </dd>
 
<dt><b>SVM Mode:</b></dt> 
 <dd>
This is CPU virtualization function. With SVM enabled you'll be able to install a virtual machine on your system.
Values for this BIOS option can be: Enabled/Disabled. Current default is Enabled.
 </dd>

<dt><b>SR-IOV support:</b></dt> 
 <dd>
  In virtualization, single root input/output virtualization or SR-IOV is a specification that allows the isolation of the PCI Express resources for manageability and performance reasons.
  A single physical PCI Express can be shared on a virtual environment using the SR-IOV specification.
  If system has SR-IOV capable PCIe Devices, this option Enables or Disables Single Root IO Virtualization Support. Values for this BIOS option can be: Enabled/Disabled. Current default is Disabled.
 </dd>

<dt><b>NUMA nodes per socket:</b></dt> 
 <dd>
      Specifies the number of desired NUMA nodes per populated socket in the system:
    <ul>
      <li>NPS1: Each physical processor is a NUMA node, and memory accesses are interleaved across all memory channels directly connected to the physical processor.</li>
      <li>NPS2: Each physical processor is two NUMA nodes, and memory accesses are interleaved across 4 memory channels.</li>
      <li>NPS4: Each physical processor is four NUMA nodes, and memory accesses are interleaved across 2 memory channels.</li>
      <li>Auto: Use AGESA default value. Current default is NPS1</li>
    </ul>
Current default is Auto.
  </dd>
  
<dt><b>APBDIS:</b></dt> 
 <dd>
Application Power Management (APM) allows the processor to provide maximum performance while remaining within
the specified power delivery and removal envelope. APM dynamically monitors processor activity and generates an
approximation of power consumption. If power consumption exceeds a defined power limit, a P-state limit is applied by
APM hardware to reduce power consumption. APM ensures that average power consumption over a thermally significant
time period remains at or below the defined power limit. Set APBDIS=1 will disable Data Fabric APM and the SOC P-state will be fixed.
  Available settings are:
  <ul>
      <li>0: Disable APBDIS.</li>      

      <li>1: Enable APBDIS.</li>

      <li>Auto (Default setting): Use default value for APBDIS. The current value is 0.</li>
  </ul>
 </dd>

<dt><b>Fix SOC P-state:</b></dt> 
 <dd>
To minimize variance or trade-off memory latency versus bandwidth, algorithm performance boost
(APBDIS) can be set and specific hard-fused Data Fabric (SoC) P-states forced for optimized
workloads sensitive to latency or throughput.
  Available settings are:
  <ul>
      <li>P0: The highest SOC P-state.</li>      

      <li>P1</li>

      <li>P2</li>      

      <li>P3: The lowest SOC P-state.</li>

      <li>Auto (Default setting): Use AGESA default value.</li>
  </ul>
 </dd>
 
<dt><b>ACPI SRAT L3 Cache as NUMA Domain:</b></dt> 
 <dd>
Each L3 Cache will be exposed as a NUMA node when enabling ACPI SRAT L3 Cache as a NUMA node. 
On a dual processor system, with up to 8 L3 Caches per processor, this setting will expose 16 NUMA domains.
  Available settings are:
  <ul>
      <li>Auto (Default setting): Disable this function. </li>
      <li>Enabled: Enable this function.</li>
  </ul>
</dd>

<dt><b>Package Power Limit Control:</b></dt> 
 <dd>
  This BIOS option allows user can set customized value for processor package power limit(PPT). Available settings are:
  <ul>
          <li>Auto: Use the fused PPT.</li>
          
          <li>Manual(Default setting): User can set customized PPT.</li>
  </ul>
</dd>

<dt><b>DLWM Support:</b></dt> 
 <dd>
Dynamic Link Width Management(DLWM) reduces xGMI lane width from x16 to x8 or x2 if xGMI links have limited traffic. DLWM feature is optimized to
trade power between CPU core intensive workloads and I/O bandwidth intensiveworkloads. When link activity is above a threshold, DLWM will
increase lane width from x8 to x16 at the cost of some delay, because the I/O die must disconnect the links, retrain them at the new speed 
and release the system back to functionality.
Values for this BIOS option can be: Auto/Enabled/Disabled. Current default is Auto.(Use AGESA default value. Current is Enabled.)
</dd>


<dt><b>Package Power Limit:</b></dt> 
 <dd>
  Set customize processor Package Power Limit (PPT) value to be used on all populated processors in the system. Current default value is 240 = Use the 240W PPT value.
***PPT will be used as the ASIC power limit***
</dd>

<dt><b>IOMMU:</b></dt> 
 <dd>
  The Input-Output Memory Management Unit(IOMMU) provides several benefits and is required when using x2APIC. Enabling the IOMMU allows devices 
(such as the EPYC integrated SATA controller) to present separate IRQs for each attached device instead of one IRQ for the subsystem. 
The IOMMU also allows operating systems to provide additional protection for DMA capable I/O devices.
Values for this BIOS option can be: Auto/Enabled/Disabled. Current default is Auto.(Use AGESA default value. Current is Enabled.)
</dd>

</dl>

]]>
</firmware>
</flagsdescription>
