Module gpu 

GPU classification — the SINGLE source of truth for distinguishing AMD discrete GPUs (dGPUs) from integrated GPUs (iGPUs).

Tenet (v0.3.0 remediation)

“The iGPU is CONSISTENTLY filtered from env vars and is NEVER included — EVER. iGPUs are NOT supported and will ONLY cause issues. Intelligent filtering must avoid including the iGPU from env vars or ANY component, while ensuring dGPUs are never missed.”

This module exists because the crate previously had three divergent iGPU classifiers (installer.rs::is_igpu_name, bootstrap/env_setup.rs:: is_integrated_gpu_name, and inline checks in hardware.rs / platform/linux.rs / benchmarks). They disagreed, and three consumers bypassed filtering entirely (textgen/comfyui hardcoded "0,1"; migraphx_python trusted inherited HIP_VISIBLE_DEVICES). The leaking iGPU broke the MIGraphX/ONNX worker. Everything now routes through here.

Classification rule

A device is integrated if ANY of:

1. Its PCI device id is in INTEGRATED_PCI_DEVICE_IDS (structural, definitive — e.g. Raphael 0x164e).
2. Its marketing/lspci name matches is_integrated_gpu_name (rich curated heuristic: APU codenames, “Ryzen && !RX”, APU model suffixes).

device_is_integrated additionally treats a low-VRAM device (< 4 GiB) as integrated when the name is ambiguous — but only as a confirmation, never as the sole reason to drop a device whose VRAM is unreadable (that would risk missing a real dGPU on kernels without mem_info_vram_total). dGPUs (Navi 31/32, 24/16 GB) are never caught.

Structs

AmdGpu

AMD discrete GPU discovered via sysfs.

Constants

DISCRETE_MIN_VRAM_BYTES

VRAM threshold below which a device is treated as integrated (4 GiB).

DISCRETE_PCI_ID_TO_GFX

Authoritative PCI device ID → gfx arch mapping for AMD discrete GPUs.

INTEGRATED_GFX_ARCHS

AMD gfx architectures that are unambiguously integrated (iGPU-only).

INTEGRATED_NAME_PATTERNS

Curated marketing/lspci name fragments indicating an AMD integrated GPU.

INTEGRATED_PCI_DEVICE_IDS

PCI device IDs of known AMD integrated GPUs (APU/iGPU).

Functions

detect_amd_gpus

Detect ALL AMD GPUs via lspci + sysfs (includes iGPU; use detect_discrete_amd_gpus to filter).

detect_discrete_amd_gpus

Detect ONLY discrete AMD GPUs (iGPU filtered out).

device_is_integrated

Combined, fail-safe classification of a single device.

gfx_from_marketing_name

Resolve gfx arch from marketing name (canonical fallback).

is_integrated_by_gfx_arch

Is this gfx architecture string an iGPU-only architecture?

is_integrated_by_pci_id

Is this PCI device id a known integrated GPU?

is_integrated_gpu_name

Does a marketing/lspci/rocminfo name indicate an AMD integrated GPU?

pci_id_to_gfx

Look up gfx arch by PCI device ID (normalized, case-insensitive).

read_vram_bytes

Read a PCI device’s mem_info_vram_total (bytes) from sysfs, if available.