diff --git a/.wordlist.txt b/.wordlist.txt index 06b2809..071d3b7 100644 --- a/.wordlist.txt +++ b/.wordlist.txt @@ -114,6 +114,7 @@ EPYC ESXi EoS FBGEMM +FCLK FFT FFTs FFmpeg @@ -144,6 +145,7 @@ GIM GL GLXT Gloo +GMC GMI GPG GPR @@ -221,6 +223,7 @@ LLVM LM LSAN LSan +LSDMA LTS LoRA MCP @@ -235,6 +238,7 @@ MIOpen's MIVisionX MLM MMA +MMHUB MMIO MMIOH MMU @@ -306,6 +310,7 @@ OpenXLA Oversubscription PagedAttention Pallas +PASID PCC PCI PCIe @@ -317,6 +322,7 @@ PLDM POR PRNG PRs +PSP PaLM Pageable PeerDirect @@ -389,6 +395,7 @@ SLES SMEM SMI SMT +SMU SPI SQs SRAM @@ -571,6 +578,7 @@ detections dev devicelibs devsel +dGPU dimensionality disambiguates distro @@ -816,6 +824,7 @@ symlink symlinks sys td +teardown tensorfloat th tokenization @@ -918,4 +927,5 @@ addressability datacenter programmability uptime +userq TPX diff --git a/docs/compatibility/compatibility-matrix.rst b/docs/compatibility/compatibility-matrix.rst index f3a3dbc..75e55c2 100644 --- a/docs/compatibility/compatibility-matrix.rst +++ b/docs/compatibility/compatibility-matrix.rst @@ -6,17 +6,17 @@ Compatibility matrix ************************************************************************************** -The AMD GPU Driver (amdgpu) 30.30.3 is compatible with ROCm 7.2.x, 7.1.x, 7.0.x, 6.4.x, and 6.3.x. For more information, see `AMD GPU Driver (amdgpu) support matrix -`__. +The AMD GPU Driver (amdgpu) 31.30.0 is compatible with ROCm 7.13.0. For more information, see `ROCm 7.13.0 compatibility matrix +`__. -====================================== +==================================== Operating system and kernel version -====================================== +==================================== -See `Supported operating systems `_ for ROCm supported operating systems and their kernel versions. +See `Operating system support `_ for ROCm supported operating systems and their kernel versions. -============= +============ GPU support -============= +============ -See `Supported GPUs `_ for the list of supported AMD Instinct™, Radeon™ PRO, and Radeon GPUs. +See `Hardware support `_ for the list of supported AMD Instinct™, Radeon™ PRO, Radeon, and Ryzen™ AI GPUs. diff --git a/docs/conf.py b/docs/conf.py index b063e50..fffcffd 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -7,22 +7,22 @@ html_context["READTHEDOCS"] = True project = "AMD GPU Driver (amdgpu)" -version = "30.30.3" -rocm_version = '7.2.3' -rocm_directory_version = '7.2.3' # in 6.0 rocm was located in /opt/rocm-6.0.0 -amdgpu_version = '30.30.3' # directory in https://repo.radeon.com/rocm/apt/ and https://repo.radeon.com/amdgpu-install/ -amdgpu_url_version = '30.30.3' +version = "31.30.0" +rocm_version = '7.13' +rocm_directory_version = '7.13.0' # in 6.0 rocm was located in /opt/rocm-6.0.0 +amdgpu_version = '31.30' # directory in https://repo.radeon.com/rocm/apt/ and https://repo.radeon.com/amdgpu-install/ +amdgpu_url_version = '31.30' release = version -html_title = f"AMD GPU Driver (amdgpu) {version}" +html_title = f"AMD GPU Driver (amdgpu) {version} preview" author = "Advanced Micro Devices, Inc." copyright = "Copyright (c) 2026 Advanced Micro Devices, Inc. All rights reserved." # Supported linux version numbers -ubuntu_version_numbers = [('24.04', 'noble'), ('22.04', 'jammy')] +ubuntu_version_numbers = [('26.04', 'resolute'), ('24.04', 'noble'), ('22.04', 'jammy')] debian_version_numbers = [('13', 'noble'), ('12', 'jammy')] rhel_release_version_numbers = ['10', '9', '8'] rhel_version_numbers = ['10.1', '10.0', '9.7', '9.6', '9.4', '8.10'] -sles_version_numbers = ['15.7'] +sles_version_numbers = ['16.0', '15.7'] ol_release_version_numbers = ['10', '9', '8'] ol_version_numbers = ['10.1', '9.7', '8.10'] rl_version_numbers = ['9.7'] @@ -42,11 +42,24 @@ # Required settings html_theme = "rocm_docs_theme" html_theme_options = { - "flavor": "amdgpu", - "announcement": f"AMD GPU Driver 31.20.0 is a technology preview intended for use only with AMD ROCm 7.12.0 technology preview. For production use, continue to use AMD GPU Driver {version} documentation.", - "link_main_doc": True, - # Add any additional theme options here + "announcement": f"AMD GPU Driver {version} is a technology preview intended for use only with AMD ROCm 7.13.0 technology preview.", + "flavor": "generic", + "header_title": f"AMD GPU Driver (amdgpu) {version}-preview", + "header_link": f"https://instinct.docs.amd.com/projects/amdgpu-docs/en/latest/", + "version_list_link": f"https://instinct.docs.amd.com/projects/amdgpu-docs/en/{version}-preview/release/versions.html", + "nav_secondary_items": { + "GitHub": "https://github.com/ROCm/amdgpu", + "Community": "https://github.com/ROCm/ROCm/discussions", + "Blogs": "https://rocm.blogs.amd.com/", + "ROCm™ Docs": "https://rocm.docs.amd.com", + "ROCm Developer Hub": "https://www.amd.com/en/developer/resources/rocm-hub.html", + "System and Infra Docs": "https://instinct.docs.amd.com/", + "Infinity Hub": "https://www.amd.com/en/developer/resources/infinity-hub.html", + "Support": "https://github.com/ROCm/amdgpu/issues/new/choose", + }, + "link_main_doc": False, } + extensions = [ "rocm_docs", "sphinxcontrib.datatemplates", @@ -60,7 +73,6 @@ # Add the following replacements to every RST file. rst_prolog = f""" -.. |version| replace:: {version} .. |rocm_version| replace:: {rocm_version} .. |amdgpu_version| replace:: {amdgpu_version} .. |amdgpu_url_version| replace:: {amdgpu_url_version} diff --git a/docs/documentation/release-notes.md b/docs/documentation/release-notes.md index 64bc1ea..767c593 100644 --- a/docs/documentation/release-notes.md +++ b/docs/documentation/release-notes.md @@ -1,13 +1,43 @@ -# AMD GPU Driver (amdgpu) 30.30.3 release notes +# AMD GPU Driver (amdgpu) 31.30.0 release notes -The release notes provide release highlights since the previous AMD GPU Driver release (30.30.2). +The release notes provide release highlights and resolved issues since the previous AMD GPU Driver release (31.20.0, a preview release). ## Release highlights -Added support for ROCm 7.2.3. +The following are notable new features and improvements in AMD GPU Driver 31.30.0. -## Operating system and hardware support changes +For compatibility between AMD GPU Driver, ROCm, GPUs, and operating systems, see the [Compatibility matrix](../compatibility/compatibility-matrix.rst). -This release doesn’t introduce operating system or hardware support changes. +### Broader hardware enablement -For compatibility between AMD GPU Driver, ROCm, GPUs, and operating systems, see the [Compatibility matrix](../compatibility/compatibility-matrix.rst). +- New SMU power-management generation v15.0.8 with full clock, thermal, power-limit, and metrics reporting on next-generation AMD platforms. + +- New system-DMA (LSDMA v7.1) and PSP 13.0.15 support for upcoming products. + +- APU + dGPU (A+A) platform enablement on GMC 12.x with correct VRAM sizing, aperture layout, and page tables for unified-memory systems. + +### Compute and AI workload improvements + +Hardened user-mode queues (userq) with stronger validation, safer doorbell handling, and cleaner create/teardown to reduce hang and resource-leak risk under heavy AI/ML submission. + +### Power, thermal, and telemetry + +- Per-component temperature reporting (AID, XCD, HBM) plus baseboard and GPU-board metrics for data-center monitoring. + +- User-tunable GFX clock ranges, custom FCLK (`OD_FCLK`), and zero-fan OD on SMU v13/v14 for finer control over performance and acoustics. + +- NPM (Node Power Management) on SMU v15.0.8 for platform-level power budgeting. + +### Stability and security + +- Broad NULL-pointer, use-after-free, and race-condition hardening in device init/teardown, VM acquisition, PASID reuse, and RAS paths. + +- Bounds checking on MMHUB/GMC client-ID decoders to prevent out-of-range reads when decoding page-fault sources. + +## Resolved issues + +The following previously known issues have been resolved in this release: + +- Resolved KFD/ROCm workload startup failures on hosts with non-4K page sizes. + +- Resolved a GPU idle power consumption regression on the latest GFX v12 discrete GPUs. diff --git a/docs/install/detailed-install/package-manager/package-manager-ol.rst b/docs/install/detailed-install/package-manager/package-manager-ol.rst index 7980b7d..836cb09 100644 --- a/docs/install/detailed-install/package-manager/package-manager-ol.rst +++ b/docs/install/detailed-install/package-manager/package-manager-ol.rst @@ -33,11 +33,7 @@ Register kernel-mode driver sudo tee /etc/yum.repos.d/amdgpu.repo <`_ -- `ROCm installation guide (Linux) `_ +- `ROCm components `_ +- `ROCm installation guide (Linux) `_ - `HIP documentation `_ diff --git a/docs/install/detailed-install/prerequisites.rst b/docs/install/detailed-install/prerequisites.rst index cf84c09..424ecd1 100644 --- a/docs/install/detailed-install/prerequisites.rst +++ b/docs/install/detailed-install/prerequisites.rst @@ -16,7 +16,7 @@ Before installing the driver, complete the following prerequisites. uname -m && cat /etc/*release - * Confirm that your Linux distribution matches a :ref:`supported distribution `. + * Confirm that your Linux distribution matches a `supported distribution `_. **Example:** Running the preceding command on an Ubuntu system produces the following output: @@ -24,9 +24,22 @@ Before installing the driver, complete the following prerequisites. x86_64 DISTRIB_ID=Ubuntu - DISTRIB_RELEASE=24.04 - DISTRIB_CODENAME=noble - DISTRIB_DESCRIPTION="Ubuntu 24.04.3 LTS" + DISTRIB_RELEASE=26.04 + DISTRIB_CODENAME=resolute + DISTRIB_DESCRIPTION="Ubuntu 26.04 LTS" + PRETTY_NAME="Ubuntu 26.04 LTS" + NAME="Ubuntu" + VERSION_ID="26.04" + VERSION="26.04 (Resolute Raccoon)" + VERSION_CODENAME=resolute + ID=ubuntu + ID_LIKE=debian + HOME_URL="https://www.ubuntu.com/" + SUPPORT_URL="https://help.ubuntu.com/" + BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/" + PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy" + UBUNTU_CODENAME=resolute + LOGO=ubuntu-logo .. _verify_kernel_version: @@ -42,9 +55,9 @@ Before installing the driver, complete the following prerequisites. .. code-block:: shell - Linux 6.8.0-50-generic #51-Ubuntu SMP PREEMPT_DYNAMIC Sat Nov 9 17:58:29 UTC 2024 x86_64 + Linux 7.0.0-15-generic #15-Ubuntu SMP PREEMPT_DYNAMIC Wed Apr 22 16:06:43 UTC 2026 x86_64 - * Confirm that your kernel version matches the system requirements, as listed in :ref:`supported_distributions`. + * Confirm that your kernel version matches the system requirements, as listed in `Operating system support `_ .. _register-enterprise-linux: @@ -216,9 +229,23 @@ To install for the currently active kernel run the command corresponding to your .. tab-item:: Ubuntu :sync: ubuntu-tab - .. code-block:: shell + .. datatemplate:nodata:: + + .. tab-set:: + + {% for (os_version, os_release) in config.html_context['ubuntu_version_numbers'] %} + .. tab-item:: {{ os_version }} + :sync: {{ os_version }} - sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)" + .. code-block:: shell + + {% if os_version == '26.04' -%} + sudo apt install "linux-headers-$(uname -r)" + {%- else -%} + sudo apt install "linux-headers-$(uname -r)" "linux-modules-extra-$(uname -r)" + {%- endif %} + + {% endfor %} .. tab-item:: Debian :sync: debian-tab diff --git a/docs/install/package-manager-index.rst b/docs/install/package-manager-index.rst index 363d1a9..4779b60 100644 --- a/docs/install/package-manager-index.rst +++ b/docs/install/package-manager-index.rst @@ -39,4 +39,4 @@ Select the install instructions for your operating system * :ref:`Rocky Linux ` * :ref:`SUSE Linux Enterprise Server ` -See `System requirements `_ for a full list of supported operating systems. +See `System requirements `_ for a full list of supported operating systems. diff --git a/docs/release/versions.rst b/docs/release/versions.rst index cd3fde7..84e8e8d 100644 --- a/docs/release/versions.rst +++ b/docs/release/versions.rst @@ -4,20 +4,15 @@ :description: Release versions for AMD GPU Driver (amdgpu) :keywords: AMD, GPU, Driver, amdgpu, versions -**************************************** -AMD GPU Driver (amdgpu) release history -**************************************** +*********************************************** +AMD GPU Driver (amdgpu) preview release history +*********************************************** .. csv-table:: :header: "Version","Release date" :widths: 10, 30 - "`30.30.3 `_", "May 4, 2026" - "`30.30.2 `_", "April 17, 2026" - "`30.30.1 `_", "March 25, 2026" - "`30.30.0 `_", "January 21, 2026" - "`30.20.1 `_", "November 26, 2025" - "`30.20.0 `_", "October 30, 2025" - "`30.10.2 `_", "October 10, 2025" - "`30.10.1 `_", "September 17, 2025" - "`30.10.0 `_", "September 16, 2025" + "`31.30.0 `_", "May 15, 2026" + "`31.20.0 `_", "March 26, 2026" + "`31.10.0 `_", "February 11, 2026" +