GPA 4.3 Updates

Author: PLohrmannAMD

BUILD.md

@@ -7,7 +7,6 @@
 
 #### Prerequisites
   * Python 3.6 or newer which can be installed from https://www.python.org/.
-  * Vulkan SDK (optional)
   * CMake 3.25 and newer which can be installed from https://cmake.org/download/ or your package manager.
     * On Windows, this can also be installed using:
       * `winget install cmake`
@@ -65,6 +64,7 @@ Additional switches that can be used with the pre_build.py script:
 --skipdocs: Does not generate build files for documentation
 --skipexamples: Does not generate build files for GPA examples
 --cmakecmd="CMD": Override the "cmake" command with "CMD"
+--runtests="all": Run all tests
 
 By default the project will not build the generated CMake project (Although you can with `--build`).
 

CMakeLists.txt

@@ -1,10 +1,10 @@
-## Copyright (C) 2018-2025 Advanced Micro Devices, Inc. All rights reserved. ##
+## Copyright (C) 2018-2026 Advanced Micro Devices, Inc. All rights reserved. ##
 
 cmake_minimum_required(VERSION 3.25)
 set(GPA_CMAKE_MODULES_DIR ${CMAKE_CURRENT_SOURCE_DIR}/build/cmake_modules)
 
 set(GPA_MAJOR_VERSION 4)
-set(GPA_MINOR_VERSION 2)
+set(GPA_MINOR_VERSION 3)
 set(GPA_UPDATE_VERSION 0)
 
 if(NOT DEFINED build)
@@ -21,9 +21,11 @@ include(${GPA_CMAKE_MODULES_DIR}/utils.cmake)
 include(${GPA_CMAKE_MODULES_DIR}/common.cmake)
 include(${GPA_CMAKE_MODULES_DIR}/fetch_dependencies.cmake)
 
-set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
 set(CMAKE_CXX_EXTENSIONS OFF)
+set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
+set(CMAKE_MSVC_DEBUG_INFORMATION_FORMAT "Embedded")
 
 if(NOT ${skiptests} AND NOT TARGET gtest)
     enable_testing()
@@ -32,33 +34,42 @@ if(NOT ${skiptests} AND NOT TARGET gtest)
         set(BUILD_GMOCK OFF)
         set(INSTALL_GTEST OFF)
         add_subdirectory(external/googletest EXCLUDE_FROM_ALL SYSTEM)
-        if (MSVC)
-            target_compile_options(gtest PRIVATE
-                "$<$<CONFIG:RELEASE>:/MT>"
-                "$<$<CONFIG:DEBUG>:/MTd>"
-            )
-        endif()
     endblock()
 endif()
 
 add_subdirectory(external/device_info)
 add_subdirectory(external/tsingleton)
-if (WIN32)
-    add_subdirectory(external/adl)
-    add_subdirectory(external/adl_util)
-endif()
 
 if(NOT ${skipdocs})
     add_subdirectory(documentation/sphinx)
 endif()
 
+if (NOT skipvulkan)
+    block()
+        add_subdirectory(external/Vulkan-Headers EXCLUDE_FROM_ALL SYSTEM)
+        add_subdirectory(source/third_party/AmdVkExt SYSTEM)
+    endblock()
+endif()
+
+if (WIN32)
+    add_subdirectory(source/third_party/AmdDxExt SYSTEM)
+endif()
+
+# Only apply warnings to code we own
+if (MSVC)
+    add_compile_options(/W4 /WX)
+else()
+    add_compile_options(-Wall -Werror)
+endif()
+
 add_subdirectory(source)
 
 set(CPACK_ARCHIVE_COMPONENT_INSTALL ON)
 set(CPACK_COMPONENTS_GROUPING IGNORE)
 
 install(DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/include/gpu_performance_api" DESTINATION ${GPA_INSTALL_INCLUDEDIR} COMPONENT GPUPerfAPI)
-install(FILES LICENSE.txt NOTICES.txt DESTINATION ${GPA_INSTALL_PREFIX} COMPONENT GPUPerfAPI)
+install(FILES LICENSE.txt DESTINATION ${GPA_INSTALL_PREFIX} COMPONENT GPUPerfAPI)
+install(FILES NOTICES.txt DESTINATION ${GPA_INSTALL_PREFIX} COMPONENT GPUPerfAPI)
 
 # Create the archive's suffix (ie: <GPUPerfAPI>[-Android|-Linux]-<version>.[zip|tgz])
 set(ARCHIVE_SUFFIX "")
@@ -83,7 +94,9 @@ set(CPACK_PACKAGE_DIRECTORY ${GPA_OUTPUT_DIR})
 set(CPACK_INCLUDE_TOPLEVEL_DIRECTORY OFF)
 
 set(CPACK_ARCHIVE_GPUPERFAPI_FILE_NAME "GPUPerfAPI${ARCHIVE_SUFFIX}")
+set(CPACK_ARCHIVE_GPATESTKIT_FILE_NAME "GPATestKit${ARCHIVE_SUFFIX}")
 
 include(CPack)
 
 cpack_add_component(GPUPerfAPI)
+cpack_add_component(GPATestKit)

README.md

@@ -174,8 +174,14 @@ It was discovered that the improvements introduced in Vega, RDNA, and RDNA2 arch
 | CS             |         |         |          |          |       |   CS    |
 
 ## Known Issues
-### GpaGetDeviceMaxWaveSlots may report an incorrect number with DX11 APIs.
-DX11 may report incorrect values on drivers older than Adrenalin `25.8.1`.
+
+### Unable to set clock mode on Windows after Nth time (N ~= 50)
+After a large number of consecutive profiling sessions (typically around 50), the GPU Performance API (GPA) may become unable to configure the GPU clock mode on Windows systems.
+
+This behavior has been traced to an issue in the AMD Windows kernel‑mode driver. The only known workaround is to restart the system when this condition occurs.
+
+### Intermittent TDR Events on RDNA4 GPUs
+During profiling on AMD RDNA4‑based graphics hardware, users may encounter sporadic Timeout Detection and Recovery (TDR) events. AMD is actively investigating the root cause and working on a fix.
 
 ### GPA doesn't support MESA on Linux
 GPA is only compatible with AMD's Pro and Open Source drivers.