Gpumon Readme: Application Note
Gpumon Readme: Application Note
Application Note
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                           DA-08558-01_v04 | ii
                                                                                             Table of Contents
Chapter 1.          Overview .................................................................................................1
  1.1      Limitations ......................................................................................................................... 1
Chapter 2.          The GUI ..................................................................................................2
  2.1 Control Panel ..................................................................................................................... 3
    2.1.1 GPU Information ......................................................................................................... 3
    2.1.2 GPU Core ..................................................................................................................... 4
    2.1.3 PCIe.............................................................................................................................. 5
    2.1.4 NVIDIA GPU Boost ...................................................................................................... 5
    2.1.5 DisplayPort .................................................................................................................. 8
    2.1.6 Dynamic Boost ............................................................................................................ 8
    2.1.7 Fan ............................................................................................................................... 9
  2.2 Display Panel ..................................................................................................................... 9
    2.2.1 General ...................................................................................................................... 10
    2.2.2 EDID ........................................................................................................................... 12
    2.2.3 PCIe............................................................................................................................ 12
    2.2.4 GC OFF (Notebook Only) ........................................................................................... 13
    2.2.5 GC6 (Notebook only) ................................................................................................. 13
    2.2.6 CPU ............................................................................................................................ 14
    2.2.7 NVPCF........................................................................................................................ 15
    2.2.8 PPAB State ................................................................................................................ 16
    2.2.9 Battery ....................................................................................................................... 19
    2.2.10 DDS ............................................................................................................................ 19
    2.2.11 Max-Q Compliance.................................................................................................... 20
  2.3 Additional Functions ....................................................................................................... 20
    2.3.1 HELP .......................................................................................................................... 20
    2.3.2 Log Start .................................................................................................................... 20
    2.3.3 EXIT and RESET......................................................................................................... 21
  2.4 GPUMon Log Items ......................................................................................................... 21
    2.4.1 General ...................................................................................................................... 21
    2.4.2 GPC Clock .................................................................................................................. 23
    2.4.3 Mem Clock................................................................................................................. 23
    2.4.4 GPU Util ..................................................................................................................... 23
    2.4.5 FB Util ........................................................................................................................ 23
    2.4.6 Video Util.................................................................................................................... 23
    2.4.7 GPU Temp.................................................................................................................. 23
    2.4.8 TGP............................................................................................................................. 23
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                                                                       DA-08558-01_v04 | iii
     2.4.9    Core Voltage .............................................................................................................. 23
     2.4.10   Mem Temp................................................................................................................. 23
     2.4.11   D-Notifier Limit ......................................................................................................... 24
     2.4.12   P-state ....................................................................................................................... 24
     2.4.13   PCIe............................................................................................................................ 24
     2.4.14   GC6............................................................................................................................. 24
     2.4.15   Date Time .................................................................................................................. 25
     2.4.16   CPU ............................................................................................................................ 25
     2.4.17   PerfCap ...................................................................................................................... 25
     2.4.18   Slowdown................................................................................................................... 25
     2.4.19   GPU State .................................................................................................................. 25
     2.4.20   PPAB (Dynamic Boost) ............................................................................................. 25
     2.4.21   WhisperMode............................................................................................................. 26
     2.4.22   TPP Limit ................................................................................................................... 26
     2.4.23   Battery ....................................................................................................................... 26
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                                                                      DA-08558-01_v04 | iv
                                                                                              List of Figures
Figure 2-1.     GPUMon GUI for GeForce Desktop Products ......................................................... 2
Figure 2-2.     GPUMon GUI for GeForce Notebook Products ....................................................... 3
Figure 2-3.     NVIDIA GPU BOOST for Notebook ........................................................................... 6
Figure 2-4.     NVIDIA GPU Boost for Desktop ............................................................................... 7
                                                                                                 List of Tables
Table 2-1.      PerfCap Reason........................................................................................................ 5
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                                                               DA-08558-01_v04 | v
Chapter 1. Overview
1.1             Limitations
GPUMon relies on NvApi interface, and its functionality may be limited if one (or more) of
following cases occur:
 If running on system with older drivers (depends on when particular feature was exposed
  over NvAPI).
 If NvAPI call/underlying RM support is not available for given GPU.
 Incomplete VBIOS settings.
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                                DA-08558-01_v04 | 1
Chapter 2. The GUI
GPUMon shows slightly different user interfaces depending on the NVIDIA product. As shown
in the following figures, GPUMon is composed of two parts: Control Panel (the left-hand side)
and Display Panel (the right-hand side). Both panels contain selectable tabs to switch between
various functions.
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                              DA-08558-01_v04 | 2
                                                                         The GUI
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                DA-08558-01_v04 | 3
                                                                                          The GUI
 GPU Name
   •   If running on a multi-GPU system, users can cycle through the GPUs by clicking on the
       Next GPU button.
   •   On a single GPU system, the Next GPU button is grayed.
 GPU State: GPU ON/OFF/IDLE (and GC6 for Notebook).
   •   For Win10 systems (wddm 2.0 or above), IDLE state will be shown as ON.
 Poll Period
   •   Poll Period cannot be less than 20 ms.
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                              DA-08558-01_v04 | 4
                                                                                                    The GUI
 P-state: Shows current GPU P-state, can also indicate P-state lock (in red).
      •    Use Set P-state to loop between two states or set any P-state including [Virtual P-
           state]
      •    PerfCap Reason (with monitor bar): Show current and past performance-capping
           reason as in the following table.
2.1.3             PCIe
This sections sets/monitors PCI Express Links, Gen, and ASPM feature on both GPU and
ROOT. This functionality may not override the PCIe settings if:
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                                         DA-08558-01_v04 | 5
                                                                                       The GUI
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                              DA-08558-01_v04 | 6
                                                                                      The GUI
 GPU Clock Offset: GPU clock frequency increase at every voltage on VF curve
 Memory Clock Offset: Increase to the high frequency memory clock.
 NVVDD Offset: Increase maximum voltage beyond stock limits.
 Power Target Operating: Power target (TGP), default 100 percent
 GPU Temperature Target: The NVIDIA GPU BOOST algorithm automatically raises or
  lowers the clock to prevent the GPU temperature from exceeding target temperature. If
  the target temperature cannot be maintained if the board is under the power cap limit, the
  NVIDIA GPU Boost feature will be disabled, and the clocks will lock to base.
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                             DA-08558-01_v04 | 7
                                                                                          The GUI
2.1.5           DisplayPort
This section allows user to set different configurable modes for testing DisplayPort interface.
 Link Training: User can set to any combination of link rates and number of lanes; the
  status LED indicates that the link training succeeds or not.
 Lane Configuration: Each lane can be set to an individual Pre-Emphasis and Drive Current
  value; the status is reported by the green/red indicator.
 Read/Write over AUX: Allows users to read and write DPCD over AUX channel.
 PPAB Enable: User can enable or disable PPAB (Dynamic Boost) through GPUMon for
  validation.
 WM Mode: User can enable or disable WhisperMode, select mode, and set Preferred Min
  FPS for validation.
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                                DA-08558-01_v04 | 8
                                                                                         The GUI
 GPU TGP(W): User can drag TGP slider to set GPU TGP limit for validation.
 CPU TDP (W): User can drag TDP slider to set CPU TDP limit for validation.
2.1.7           Fan
In this section shows fan-related data for Desktop and Enterprise. GPUMon supports both
RPM and PWM units:
 Fan: Shows Minimum fan speed, Current fan speed, and Max fan speed
 Fan Sim: Manually set fan speed.
   •   RPM unit may not be able to set the speed precisely, due to fan speed granularity.
 Fan Curve: Overrides the default GPU fan curve.
 Fan Stop: Enabling this feature allows the fan to stop under the condition of TJ or TGP (or
  both) less than minimum threshold.
   •   This feature is only available to certain SKUs.
   •   When disabled, fan will restart with a sequence of steps to avoid overshoot.
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                               DA-08558-01_v04 | 9
                                                                         The GUI
2.2.1           General
This Tab displays the current GPU status and information.
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                               DA-08558-01_v04 | 10
                                                                                    The GUI
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                          DA-08558-01_v04 | 11
                                                                                       The GUI
2.2.2           EDID
EDID stands for Extended Display Identification Data. This tab shows raw EDID in hex and
ASCII characters.
2.2.3           PCIe
This Tab shows the PCI Express error count log.
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                             DA-08558-01_v04 | 12
                                                                                          The GUI
Reason for not entering GC6 is for debug only. Contact your NVIDIA AE if you need help.
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                             DA-08558-01_v04 | 13
                                                                                  The GUI
2.2.6           CPU
This Tab shows CPU model name current P-state, P-state Cap, and Temperature.
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                        DA-08558-01_v04 | 14
                                                                                 The GUI
2.2.7           NVPCF
This Tab shows NVPCF System power limit table info from the BIOS.
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                       DA-08558-01_v04 | 15
                                                                                The GUI
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                      DA-08558-01_v04 | 16
                                                                                    The GUI
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                          DA-08558-01_v04 | 17
                                                                                              The GUI
 AC VBIOS Max TGP (mW): VBIOS Max. TGP setting (Rated TGP + Configurable TGP setting
  + Max. AC GPU offset) at AC mode
 Controller State: AutoFL controller State
 I/O Space Type: Using for Dynamic Boost support. See Note 1.
 I/O Address: Using for Dynamic Boost support. See Note 1.
 MaxPerfLevel: Using for Dynamic Boost support. See Note 1.
 HighestPerf: Using for Dynamic Boost support. See Note 1.
 bPlatformEnabled: WhisperMode enabled/disabled.
 updateEventCount: WhisperMode SBIOS table update event count.
 sysTspW (W): system total power
 SL Quieter mode value: Using for WhisperMode support. See Note 1.
 SL Quiet mode value: Using for WhisperMode support. See Note 1.
 SL Balanced mode value: Using for WhisperMode support. See Note 1.
 SL Value: Using for WhisperMode support. See Note 1.
 DB-DC TPP Target (mW): Dynamic Boost DC mode TPP target
 BB2 TPP Target (mW): NVIDIA Battery Boost 2.0 Target TGP setting.
 T-Band Table Index: Using for WhisperMode support. See Note 1.
 T-Band Current Index: Using for WhisperMode support. See Note 1.
 Current Temp (C, FXP24:8): Using for WhisperMode support. See Note 1.
 T-Band Table Index: Using for WhisperMode support. See Note 1.
   T-Band Current Index: Using for WhisperMode support. See Note 1.
Note 1: Refer to the “NVPCF” section of the Software Design Guide for more information.
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                                  DA-08558-01_v04 | 18
                                                                                     The GUI
2.2.9           Battery
This Tab shows Battery status, AC/DC mode, Charge Level, Full Capacity, Remaining Capacity,
Current Voltage and Drain Rate.
2.2.10          DDS
This Tab shows ACPI DOD method info and Display parameters.
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                           DA-08558-01_v04 | 19
                                                                                          The GUI
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                               DA-08558-01_v04 | 20
                                                                                   The GUI
2.4.1           General
 Product SKU: GPU Product SKU number
 Max-Q Technologies: Max-Q Technologies support
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                         DA-08558-01_v04 | 21
                                                                                              The GUI
Note 2: Refer to the “NVPCF” section of the Software Design Guide for more information.
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                                  DA-08558-01_v04 | 22
                                                                         The GUI
2.4.5           FB Util
 fb_util (%): Memory Utilization
2.4.8           TGP
 pwr_tgp (mW): GPU TGP power
 pwr_nvvdd (mW): GPU NVVDD power
 pwr_fbvdd (mW): FBVDD (memory devices + GPU FBIO) power
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                               DA-08558-01_v04 | 23
                                                                                 The GUI
2.4.12          P-state
 p_state: GPU P-state
2.4.13          PCIe
 pcie_gpu_width: GPU PCIE width
 pcie_gpu_L0s: GPU PCIE L0s status(1=Enable/0=Disable)
 pcie_gpu_L1: GPU PCIE L1 status(1=Enable/0=Disable)
 pcie_gpu_speed: GPU PCIE Gen Speed
 pcie_root_width: Root Port PCIE width
 pcie_root_L0s: Root Port PCIE L0s status(1=Enable/0=Disable)
 pcie_root_L1: Root Port PCIE L1 status(1=Enable/0=Disable)
 pcie_root_speed: Root Port PCIE Gen Speed
 GPU_CE: GPU PCIE CE (Correctable Error) count
 GPU_NF: GPU PCIE NF (Non-fatal Error) count
 GPU_FE: GPU PCIE UR (Unsupported Request) count
 GPU_UR: GPU PCIE UR (Unsupported Request) count
 ROOT_CE: Root Port PCIE CE (Correctable Error) count
 ROOT_NF: Root Port PCIE NF (Non-fatal Error) count
 ROOT_FE: Root Port PCIE FE (Fatal Error) count
 ROOT_UR: Root Port PCIE UR (Unsupported Request) count
 pcie_bw_TX: PCIE Bandwidth TX throughput
 pcie_bw_RX: PCIE Bandwidth RX throughput
2.4.14          GC6
 Total_Time_GC6: Total time of GPU in the GC6 State
 Total_Time_Enter_GC6: Total time of GPU enter GC6 state
 Total_Time_Exit_GC6: Total time of GPU exit GC6 state
 GC6_Transition_Count: GPU GC6 transition Count
 Not_Enter_GC6_Reason: The reason why GPU cannot enter GC6 state
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                       DA-08558-01_v04 | 24
                                                                                    The GUI
2.4.16          CPU
 cpu_clk: CPU clock
 cpu_pstate: CPU P-state state
 cpu_cap: CPU clock cap reason (thermal, power)
 cpu_ts_ms: Timestamp for CPU power reading
 cpu_temp: CPU temperature
 cpu_tdp (W): CPU TDP power
 cpu_prochot: CPU Prochot# state (1=triggered)
 cpu_pl1 (W): CPU MSR PL1 setting
 cpu_pl2 (W): CPU MSR PL2 setting
 cpu_tcc: CPU Tcc setting
 cpu_thermal_throttling: CPU thermal throttling state (1=triggered)
2.4.17          PerfCap
 capping_reason: GPU performance-capping reason (Refer to Table 2.1)
2.4.18          Slowdown
 Slowdown: GPU clock slowdown factor (100% = normal; lower percentage means GPU clock is
   divided)
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                          DA-08558-01_v04 | 25
                                                                                 The GUI
 AC_TPP_Target: Dynamic Boost Total Processor Power Target (CPU TDP base line) at AC
  mode
 DC_TPP_Target: Dynamic Boost Total Processor Power Target (CPU TDP base line) at DC
  mode (removed after NVPCF 2.0)
 DC_Baseline TGP: Dynamic Boost Baseline (configurable) TGP on DC for the intended TPP
  limit (removed after NVPCF 2.0)
 DC_Target_TPP_Limit: Dynamic Boost Total Processor Power Target (CPU TDP base line)
  at DC mode (removed after NVPCF 2.0)
2.4.21          WhisperMode
 bPlatformEnabled: WhisperMode status (Enable/Disable)
 updateEventCount: WhisperMode Platform configuration update event counter
 sysTspW: total system power
 SL_Value: WhisperMode SL value
 TbandIndex0_CurrIndex: WhisperMode TbandIndex current index
 TbandIndex0_CurrTemp: WhisperMode TbandIndex current temperature
2.4.23          Battery
 AC_DC: System is under AC mode or DC mode.
 charge_level (%): Battery charge level
 full_capacity (mW): Battery-full capacity
 remaining_capacity(mW): Battery remaining capacity
NVIDIA CONFIDENTIAL
GPUMon ReadMe                                                       DA-08558-01_v04 | 26
Notice
This document is provided for information purposes only and shall not be regarded as a warranty of a certain functionality, condition, or quality of a product.
NVIDIA Corporation (“NVIDIA”) makes no representations or warranties, expressed or implied, as to the accuracy or completeness of the information contained
in this document and assumes no responsibility for any errors contained herein. NVIDIA shall have no liability for the consequences or use of such information
or for any infringement of patents or other rights of third parties that may result from its use. This document is not a commitment to develop, release, or
deliver any Material (defined below), code, or functionality.
NVIDIA reserves the right to make corrections, modifications, enhancements, improvements, and any other changes to this document, at any time without
notice.
Customer should obtain the latest relevant information before placing orders and should verify that such information is current and complete.
NVIDIA products are sold subject to the NVIDIA standard terms and conditions of sale supplied at the time of order acknowledgement, unless otherwise agreed
in an individual sales agreement signed by authorized representatives of NVIDIA and customer (“Terms of Sale”). NVIDIA hereby expressly objects to applying
any customer general terms and conditions with regards to the purchase of the NVIDIA product referenced in this document. No contractual obligations are
formed either directly or indirectly by this document.
NVIDIA products are not designed, authorized, or warranted to be suitable for use in medical, military, aircraft, space, or life support equipment, nor in
applications where failure or malfunction of the NVIDIA product can reasonably be expected to result in personal injury, death, or property or environmental
damage. NVIDIA accepts no liability for inclusion and/or use of NVIDIA products in such equipment or applications and therefore such inclusion and/or use is at
customer’s own risk.
NVIDIA makes no representation or warranty that products based on this document will be suitable for any specified use. Testing of all parameters of each
product is not necessarily performed by NVIDIA. It is customer’s sole responsibility to evaluate and determine the applicability of any information contained in
this document, ensure the product is suitable and fit for the application planned by customer, and perform the necessary testing for the application in order to
avoid a default of the application or the product. Weaknesses in customer’s product designs may affect the quality and reliability of the NVIDIA product and may
result in additional or different conditions and/or requirements beyond those contained in this document. NVIDIA accepts no liability related to any default,
damage, costs, or problem which may be based on or attributable to: (i) the use of the NVIDIA product in any manner that is contrary to this document or (ii)
customer product designs.
No license, either expressed or implied, is granted under any NVIDIA patent right, copyright, or other NVIDIA intellectual property right under this document.
Information published by NVIDIA regarding third-party products or services does not constitute a license from NVIDIA to use such products or services or a
warranty or endorsement thereof. Use of such information may require a license from a third party under the patents or other intellectual property rights of the
third party, or a license from NVIDIA under the patents or other intellectual property rights of NVIDIA.
Reproduction of information in this document is permissible only if approved in advance by NVIDIA in writing, reproduced without alteration and in full
compliance with all applicable export laws and regulations, and accompanied by all associated conditions, limitations, and notices.
THIS DOCUMENT AND ALL NVIDIA DESIGN SPECIFICATIONS, REFERENCE BOARDS, FILES, DRAWINGS, DIAGNOSTICS, LISTS, AND OTHER DOCUMENTS
(TOGETHER AND SEPARATELY, “MATERIALS”) ARE BEING PROVIDED “AS IS.” NVIDIA MAKES NO WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR
OTHERWISE WITH RESPECT TO THE MATERIALS, AND EXPRESSLY DISCLAIMS ALL IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTABILITY,
AND FITNESS FOR A PARTICULAR PURPOSE. TO THE EXTENT NOT PROHIBITED BY LAW, IN NO EVENT WILL NVIDIA BE LIABLE FOR ANY DAMAGES,
INCLUDING WITHOUT LIMITATION ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, PUNITIVE, OR CONSEQUENTIAL DAMAGES, HOWEVER CAUSED AND
REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF ANY USE OF THIS DOCUMENT, EVEN IF NVIDIA HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES. Notwithstanding any damages that customer might incur for any reason whatsoever, NVIDIA’s aggregate and cumulative liability towards
customer for the products described herein shall be limited in accordance with the Terms of Sale for the product.
Trademarks
NVIDIA, the NVIDIA logo, BATTERY BOOST, GeForce, GPU BOOST, Quadro, and Tesla are trademarks and/or registered trademarks of NVIDIA Corporation in
the U.S. and other countries. Other company and product names may be trademarks of the respective companies with which they are associated.
VESA DisplayPort
DisplayPort and DisplayPort Compliance Logo, DisplayPort Compliance Logo for Dual-mode Sources, and DisplayPort Compliance Logo for Active Cables are
trademarks owned by the Video Electronics Standards Association in the United States and other countries.
HDMI
HDMI, the HDMI logo, and High-Definition Multimedia Interface are trademarks or registered trademarks of HDMI Licensing LLC.
Copyright
© 2017 - 2022 NVIDIA Corporation. All rights reserved.