temperature

type Temperature struct {
	// Represents the GPU UUID.
	UUID string `json:"uuid"`

	// BusID is the GPU bus ID from the nvml API.
	//  e.g., "0000:0f:00.0"
	BusID string `json:"bus_id"`

	CurrentCelsiusGPUCore uint32 `json:"current_celsius_gpu_core"`
	CurrentCelsiusHBM     uint32 `json:"current_celsius_hbm"`

	// HBMTemperatureSupported indicates whether NVML provided a memory temperature reading.
	HBMTemperatureSupported bool `json:"hbm_temperature_supported"`

	// ThresholdCelsiusSlowdownMargin is the thermal headroom (in °C) to the nearest
	// slowdown threshold as defined by NVML. NVML does not specify whether the threshold
	// is for GPU core or HBM; it is whichever slowdown threshold is nearest (driver-defined).
	ThresholdCelsiusSlowdownMargin int32 `json:"threshold_celsius_slowdown_margin"`

	// MarginTemperatureSupported indicates whether NVML provided a margin temperature reading.
	MarginTemperatureSupported bool `json:"margin_temperature_supported"`

	// Threshold at which the GPU starts to shut down to prevent hardware damage.
	ThresholdCelsiusShutdown uint32 `json:"threshold_celsius_shutdown"`
	// Threshold at which the GPU starts to throttle its performance.
	ThresholdCelsiusSlowdown uint32 `json:"threshold_celsius_slowdown"`
	// Maximum safe operating temperature for the GPU's memory.
	ThresholdCelsiusMemMax uint32 `json:"threshold_celsius_mem_max"`
	// Maximum safe operating temperature for the GPU core.
	ThresholdCelsiusGPUMax uint32 `json:"threshold_celsius_gpu_max"`

	UsedPercentShutdown string `json:"used_percent_shutdown"`
	UsedPercentSlowdown string `json:"used_percent_slowdown"`
	UsedPercentMemMax   string `json:"used_percent_mem_max"`
	UsedPercentGPUMax   string `json:"used_percent_gpu_max"`
}

type Thresholds struct {
	// CelsiusSlowdownMargin is the minimum thermal margin (°C) before marking the GPU as degraded.
	CelsiusSlowdownMargin int32 `json:"celsius_slowdown_margin"`
}