amdsmi_apu_metrics_t Struct Reference

Data Fields

amdsmi_apu_metrics_t Struct Reference

APU metrics auxiliary data. More...

#include <amdsmi.h>

Data Fields
uint16_t	temperature_gfx
	Temperature (instant)
uint16_t	temperature_soc
	v2_4, v3_0
uint16_t	temperature_core [AMDSMI_APU_MAX_CORES]
	v2_4[8], v3_0[16]
uint16_t	temperature_l3 [AMDSMI_APU_MAX_L3]
	v2_4
uint16_t	temperature_skin
	v3_0
uint16_t	average_gfx_activity
	Utilization.
uint16_t	average_mm_activity
	v2_4
uint16_t	average_vcn_activity
	v3_0
uint16_t	average_ipu_activity [AMDSMI_APU_MAX_IPU]
	v3_0
uint16_t	average_core_c0_activity [AMDSMI_APU_MAX_CORES]
	v3_0
uint16_t	average_dram_reads
	v3_0 [MB/s]
uint16_t	average_dram_writes
	v3_0
uint16_t	average_ipu_reads
	v3_0
uint16_t	average_ipu_writes
	v3_0
uint32_t	average_socket_power
	Power [mW].
uint16_t	average_cpu_power
	v2_4
uint16_t	average_soc_power
	v2_4
uint32_t	average_gfx_power
	v2_4[uint16_t], v3_0[uint32_t]
uint16_t	average_core_power [AMDSMI_APU_MAX_CORES]
	v2_4[8], v3_0[16]
uint16_t	average_ipu_power
	v3_0
uint32_t	average_apu_power
	v3_0
uint32_t	average_dgpu_power
	v3_0
uint32_t	average_all_core_power
	v3_0
uint16_t	average_sys_power
	v3_0
uint16_t	stapm_power_limit
	v3_0
uint16_t	current_stapm_power_limit
	v3_0
uint16_t	average_gfxclk_frequency
	Average clocks [MHz].
uint16_t	average_socclk_frequency
	v2_4, v3_0
uint16_t	average_uclk_frequency
	v2_4, v3_0
uint16_t	average_fclk_frequency
	v2_4, v3_0
uint16_t	average_vclk_frequency
	v2_4, v3_0
uint16_t	average_dclk_frequency
	v2_4
uint16_t	average_vpeclk_frequency
	v3_0
uint16_t	average_ipuclk_frequency
	v3_0
uint16_t	average_mpipu_frequency
	v3_0
uint16_t	current_gfxclk
	Current clocks [MHz].
uint16_t	current_socclk
	v2_4
uint16_t	current_uclk
	v2_4
uint16_t	current_fclk
	v2_4
uint16_t	current_vclk
	v2_4
uint16_t	current_dclk
	v2_4
uint16_t	current_coreclk [AMDSMI_APU_MAX_CORES]
	v2_4[8], v3_0[16]
uint16_t	current_l3clk [AMDSMI_APU_MAX_L3]
	v2_4
uint16_t	current_core_maxfreq
	v3_0
uint16_t	current_gfx_maxfreq
	v3_0
uint32_t	throttle_status
	Throttle.
uint64_t	indep_throttle_status
	v2_4
uint32_t	throttle_residency_prochot
	v3_0
uint32_t	throttle_residency_spl
	v3_0
uint32_t	throttle_residency_fppt
	v3_0
uint32_t	throttle_residency_sppt
	v3_0
uint32_t	throttle_residency_thm_core
	v3_0
uint32_t	throttle_residency_thm_gfx
	v3_0
uint32_t	throttle_residency_thm_soc
	v3_0
uint16_t	fan_pwm
	Fan.
uint16_t	average_temperature_gfx
	Average temperature.
uint16_t	average_temperature_soc
	v2_4
uint16_t	average_temperature_core [AMDSMI_APU_MAX_CORES]
	v2_4
uint16_t	average_temperature_l3 [AMDSMI_APU_MAX_L3]
	v2_4
uint16_t	average_cpu_voltage
	Voltage [mV] / Current [mA].
uint16_t	average_soc_voltage
	v2_4
uint16_t	average_gfx_voltage
	v2_4
uint16_t	average_cpu_current
	v2_4
uint16_t	average_soc_current
	v2_4
uint16_t	average_gfx_current
	v2_4
uint32_t	time_filter_alphavalue
	Other (v3_0)

Detailed Description

APU metrics auxiliary data.

This structure holds unified APU-specific metrics data derived from the underlying driver metrics table. It is attached via amdsmi_gpu_metrics_t.apu_metrics when APU-specific metrics are available.

Version Support:

• v2.4: format_revision == 2 && content_revision == 4
• v3.0: format_revision == 3 && content_revision == 0 Use amdsmi_gpu_metrics_t.common_header to identify which version populated the fields.

Sentinel Values: Fields not applicable to the current version are initialized to the maximum value of their respective type: 0xFFFF for uint16_t fields, 0xFFFFFFFF for uint32_t fields, and UINT64_MAX for uint64_t fields. For example, on v3.0 hardware, v2.4-only fields like average_mm_activity and temperature_l3 will contain 0xFFFF. Similarly, array elements beyond the version-specific count (e.g., elements 8-15 of temperature_core on v2.4) will contain 0xFFFF. However, uint32_t elements such as 'throttle_status' will contain 0xFFFFFFFF and UINT64_MAX for uint64_t elements such as 'indep_throttle_status'. Callers should check the version and treat maximum values as invalid/not applicable.

Definition at line 2101 of file amdsmi.h.

Field Documentation

◆ temperature_gfx

uint16_t amdsmi_apu_metrics_t::temperature_gfx

Temperature (instant)

v2_4, v3_0

Definition at line 2105 of file amdsmi.h.

◆ temperature_soc

uint16_t amdsmi_apu_metrics_t::temperature_soc

v2_4, v3_0

Definition at line 2106 of file amdsmi.h.

◆ temperature_core

uint16_t amdsmi_apu_metrics_t::temperature_core[AMDSMI_APU_MAX_CORES]

v2_4[8], v3_0[16]

Definition at line 2107 of file amdsmi.h.

◆ temperature_l3

uint16_t amdsmi_apu_metrics_t::temperature_l3[AMDSMI_APU_MAX_L3]

v2_4

Definition at line 2108 of file amdsmi.h.

◆ temperature_skin

uint16_t amdsmi_apu_metrics_t::temperature_skin

v3_0

Definition at line 2109 of file amdsmi.h.

◆ average_gfx_activity

uint16_t amdsmi_apu_metrics_t::average_gfx_activity

Utilization.

v2_4, v3_0

Definition at line 2114 of file amdsmi.h.

◆ average_mm_activity

uint16_t amdsmi_apu_metrics_t::average_mm_activity

v2_4

Definition at line 2115 of file amdsmi.h.

◆ average_vcn_activity

uint16_t amdsmi_apu_metrics_t::average_vcn_activity

v3_0

Definition at line 2116 of file amdsmi.h.

◆ average_ipu_activity

uint16_t amdsmi_apu_metrics_t::average_ipu_activity[AMDSMI_APU_MAX_IPU]

v3_0

Definition at line 2117 of file amdsmi.h.

◆ average_core_c0_activity

uint16_t amdsmi_apu_metrics_t::average_core_c0_activity[AMDSMI_APU_MAX_CORES]

v3_0

Definition at line 2118 of file amdsmi.h.

◆ average_dram_reads

uint16_t amdsmi_apu_metrics_t::average_dram_reads

v3_0 [MB/s]

Definition at line 2119 of file amdsmi.h.

◆ average_dram_writes

uint16_t amdsmi_apu_metrics_t::average_dram_writes

v3_0

Definition at line 2120 of file amdsmi.h.

◆ average_ipu_reads

uint16_t amdsmi_apu_metrics_t::average_ipu_reads

v3_0

Definition at line 2121 of file amdsmi.h.

◆ average_ipu_writes

uint16_t amdsmi_apu_metrics_t::average_ipu_writes

v3_0

Definition at line 2122 of file amdsmi.h.

◆ average_socket_power

uint32_t amdsmi_apu_metrics_t::average_socket_power

Power [mW].

All power fields in this struct are in milliwatts (mW) as reported by the APU firmware. Note: the top-level gpu_metrics_t.average_socket_power is converted to Watts; these APU sub-struct fields are NOT converted. v2_4[uint16_t], v3_0[uint32_t]

Definition at line 2131 of file amdsmi.h.

◆ average_cpu_power

uint16_t amdsmi_apu_metrics_t::average_cpu_power

v2_4

Definition at line 2132 of file amdsmi.h.

◆ average_soc_power

uint16_t amdsmi_apu_metrics_t::average_soc_power

v2_4

Definition at line 2133 of file amdsmi.h.

◆ average_gfx_power

uint32_t amdsmi_apu_metrics_t::average_gfx_power

v2_4[uint16_t], v3_0[uint32_t]

Definition at line 2134 of file amdsmi.h.

◆ average_core_power

uint16_t amdsmi_apu_metrics_t::average_core_power[AMDSMI_APU_MAX_CORES]

v2_4[8], v3_0[16]

Definition at line 2135 of file amdsmi.h.

◆ average_ipu_power

uint16_t amdsmi_apu_metrics_t::average_ipu_power

v3_0

Definition at line 2136 of file amdsmi.h.

◆ average_apu_power

uint32_t amdsmi_apu_metrics_t::average_apu_power

v3_0

Definition at line 2137 of file amdsmi.h.

◆ average_dgpu_power

uint32_t amdsmi_apu_metrics_t::average_dgpu_power

v3_0

Definition at line 2138 of file amdsmi.h.

◆ average_all_core_power

uint32_t amdsmi_apu_metrics_t::average_all_core_power

v3_0

Definition at line 2139 of file amdsmi.h.

◆ average_sys_power

uint16_t amdsmi_apu_metrics_t::average_sys_power

v3_0

Definition at line 2140 of file amdsmi.h.

◆ stapm_power_limit

uint16_t amdsmi_apu_metrics_t::stapm_power_limit

v3_0

Definition at line 2141 of file amdsmi.h.

◆ current_stapm_power_limit

uint16_t amdsmi_apu_metrics_t::current_stapm_power_limit

v3_0

Definition at line 2142 of file amdsmi.h.

◆ average_gfxclk_frequency

uint16_t amdsmi_apu_metrics_t::average_gfxclk_frequency

Average clocks [MHz].

v2_4, v3_0

Definition at line 2147 of file amdsmi.h.

◆ average_socclk_frequency

uint16_t amdsmi_apu_metrics_t::average_socclk_frequency

v2_4, v3_0

Definition at line 2148 of file amdsmi.h.

◆ average_uclk_frequency

uint16_t amdsmi_apu_metrics_t::average_uclk_frequency

v2_4, v3_0

Definition at line 2149 of file amdsmi.h.

◆ average_fclk_frequency

uint16_t amdsmi_apu_metrics_t::average_fclk_frequency

v2_4, v3_0

Definition at line 2150 of file amdsmi.h.

◆ average_vclk_frequency

uint16_t amdsmi_apu_metrics_t::average_vclk_frequency

v2_4, v3_0

Definition at line 2151 of file amdsmi.h.

◆ average_dclk_frequency

uint16_t amdsmi_apu_metrics_t::average_dclk_frequency

v2_4

Definition at line 2152 of file amdsmi.h.

◆ average_vpeclk_frequency

uint16_t amdsmi_apu_metrics_t::average_vpeclk_frequency

v3_0

Definition at line 2153 of file amdsmi.h.

◆ average_ipuclk_frequency

uint16_t amdsmi_apu_metrics_t::average_ipuclk_frequency

v3_0

Definition at line 2154 of file amdsmi.h.

◆ average_mpipu_frequency

uint16_t amdsmi_apu_metrics_t::average_mpipu_frequency

v3_0

Definition at line 2155 of file amdsmi.h.

◆ current_gfxclk

uint16_t amdsmi_apu_metrics_t::current_gfxclk

Current clocks [MHz].

v2_4

Definition at line 2160 of file amdsmi.h.

◆ current_socclk

uint16_t amdsmi_apu_metrics_t::current_socclk

v2_4

Definition at line 2161 of file amdsmi.h.

◆ current_uclk

uint16_t amdsmi_apu_metrics_t::current_uclk

v2_4

Definition at line 2162 of file amdsmi.h.

◆ current_fclk

uint16_t amdsmi_apu_metrics_t::current_fclk

v2_4

Definition at line 2163 of file amdsmi.h.

◆ current_vclk

uint16_t amdsmi_apu_metrics_t::current_vclk

v2_4

Definition at line 2164 of file amdsmi.h.

◆ current_dclk

uint16_t amdsmi_apu_metrics_t::current_dclk

v2_4

Definition at line 2165 of file amdsmi.h.

◆ current_coreclk

uint16_t amdsmi_apu_metrics_t::current_coreclk[AMDSMI_APU_MAX_CORES]

v2_4[8], v3_0[16]

Definition at line 2166 of file amdsmi.h.

◆ current_l3clk

uint16_t amdsmi_apu_metrics_t::current_l3clk[AMDSMI_APU_MAX_L3]

v2_4

Definition at line 2167 of file amdsmi.h.

◆ current_core_maxfreq

uint16_t amdsmi_apu_metrics_t::current_core_maxfreq

v3_0

Definition at line 2168 of file amdsmi.h.

◆ current_gfx_maxfreq

uint16_t amdsmi_apu_metrics_t::current_gfx_maxfreq

v3_0

Definition at line 2169 of file amdsmi.h.

◆ throttle_status

uint32_t amdsmi_apu_metrics_t::throttle_status

Throttle.

v2_4

Definition at line 2174 of file amdsmi.h.

◆ indep_throttle_status

uint64_t amdsmi_apu_metrics_t::indep_throttle_status

v2_4

Definition at line 2175 of file amdsmi.h.

◆ throttle_residency_prochot

uint32_t amdsmi_apu_metrics_t::throttle_residency_prochot

v3_0

Definition at line 2176 of file amdsmi.h.

◆ throttle_residency_spl

uint32_t amdsmi_apu_metrics_t::throttle_residency_spl

v3_0

Definition at line 2177 of file amdsmi.h.

◆ throttle_residency_fppt

uint32_t amdsmi_apu_metrics_t::throttle_residency_fppt

v3_0

Definition at line 2178 of file amdsmi.h.

◆ throttle_residency_sppt

uint32_t amdsmi_apu_metrics_t::throttle_residency_sppt

v3_0

Definition at line 2179 of file amdsmi.h.

◆ throttle_residency_thm_core

uint32_t amdsmi_apu_metrics_t::throttle_residency_thm_core

v3_0

Definition at line 2180 of file amdsmi.h.

◆ throttle_residency_thm_gfx

uint32_t amdsmi_apu_metrics_t::throttle_residency_thm_gfx

v3_0

Definition at line 2181 of file amdsmi.h.

◆ throttle_residency_thm_soc

uint32_t amdsmi_apu_metrics_t::throttle_residency_thm_soc

v3_0

Definition at line 2182 of file amdsmi.h.

◆ fan_pwm

uint16_t amdsmi_apu_metrics_t::fan_pwm

Fan.

v2_4

Definition at line 2187 of file amdsmi.h.

◆ average_temperature_gfx

uint16_t amdsmi_apu_metrics_t::average_temperature_gfx

Average temperature.

v2_4

Definition at line 2192 of file amdsmi.h.

◆ average_temperature_soc

uint16_t amdsmi_apu_metrics_t::average_temperature_soc

v2_4

Definition at line 2193 of file amdsmi.h.

◆ average_temperature_core

uint16_t amdsmi_apu_metrics_t::average_temperature_core[AMDSMI_APU_MAX_CORES]

v2_4

Definition at line 2194 of file amdsmi.h.

◆ average_temperature_l3

uint16_t amdsmi_apu_metrics_t::average_temperature_l3[AMDSMI_APU_MAX_L3]

v2_4

Definition at line 2195 of file amdsmi.h.

◆ average_cpu_voltage

uint16_t amdsmi_apu_metrics_t::average_cpu_voltage

Voltage [mV] / Current [mA].

v2_4

Definition at line 2200 of file amdsmi.h.

◆ average_soc_voltage

uint16_t amdsmi_apu_metrics_t::average_soc_voltage

v2_4

Definition at line 2201 of file amdsmi.h.

◆ average_gfx_voltage

uint16_t amdsmi_apu_metrics_t::average_gfx_voltage

v2_4

Definition at line 2202 of file amdsmi.h.

◆ average_cpu_current

uint16_t amdsmi_apu_metrics_t::average_cpu_current

v2_4

Definition at line 2203 of file amdsmi.h.

◆ average_soc_current

uint16_t amdsmi_apu_metrics_t::average_soc_current

v2_4

Definition at line 2204 of file amdsmi.h.

◆ average_gfx_current

uint16_t amdsmi_apu_metrics_t::average_gfx_current

v2_4

Definition at line 2205 of file amdsmi.h.

◆ time_filter_alphavalue

uint32_t amdsmi_apu_metrics_t::time_filter_alphavalue

Other (v3_0)

v3_0; alpha filter time constant [us]

Definition at line 2210 of file amdsmi.h.

---

The documentation for this struct was generated from the following file:

• amdsmi.h