8000 GPUs checked against the I/O Devices guide (program=io) instead of the GPU guide (program=sptg) → false 'unsupported' · Issue #49 · dominikzorgnotti/esx-hcl-check · GitHub
[go: up one dir, main page]

Skip to content

GPUs checked against the I/O Devices guide (program=io) instead of the GPU guide (program=sptg) → false 'unsupported' #49

Closed

Description

@dominikzorgnotti

Symptom

A customer reports that all GPUs are flagged as unsupported (hw_certified: FALSE), even though the devices are listed as compatible in Broadcom's GPU (vSphere third-party GPU) Compatibility Guide for the exact ESXi release being checked.

Concrete example from a -details run (target ESXi 9.1):

  • Device: NVIDIA A40 (vid=10de did=2235 svid=10de ssid=145a), device_type=GPU
  • Reported: hw_certified=FALSE
  • Generated HCL link uses program=io:
    …/search?program=io&vid=[10de]&did=[2235]&svid=[10de]&ssid=[145a]&productReleaseVersion=[ESXi 9.1]
  • But the device is certified here, under program=sptg:
    https://compatibilityguide.broadcom.com/detail?program=sptg&productId=52565&persona=live&keyword=A40

Root cause

In performHCLChecks (hcl.go), every PCI device — including those classified device_type=GPU in extractHostHardware (vsphere.go) — is verified against the I/O Devices guide (program=io) by PCI ID. GPUs are not in the I/O guide, so the query returns count=0 → FALSE.

GPUs live in a separate guide, program=sptg. Verified against the live API:

Query Result
A40 PCI IDs vs program=io (current) count=0 → false "unsupported" (reproduces the bug)
program=sptg, keyword NVIDIA A40, productReleaseVersion=[ESXi 9.1] count=1, response lists ESXi 9.1 → certified
program=sptg with vid/did filters ignored — returns all 63 GPUs

Two important findings from probing the live endpoint:

  1. The sptg filter endpoint ignores vid/did filters, so GPUs must be matched by device-model keyword (like the cpu/server programs already are), not by PCI ID. Naively pointing the existing PCI-ID query at sptg would return all GPUs and falsely certify every one.
  2. sptg is API-only (no local database), so under -offline GPUs should be marked SKIPPED, consistent with CPU/system checks.

Fix

Route device_type=GPU to program=sptg with a model-keyword query + productReleaseVersion filter, and a matching sptg search link. Driver/firmware remain N/A for GPUs (the guide certifies the device, not a driver). No change to GPU detection, only to which guide is queried.

Target release: v0.5.3 (bugfix, non-breaking).

Activity

  1. added a commit that references this issue on Jul 14, 2026
    6c43d89
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      0