Update documentation and source code for RMV v1.12

Author: ahosier

BUILD.md

@@ -19,7 +19,7 @@ As a preliminary step, make sure that you have the following installed on your s
 * CMake 3.11 or above.
 * Python 3.7 or above.
 * Qt® 6 or above (6.7.0 is the default and recommended).
-* Visual Studio® 2015 or above (2019 is the default).
+* Visual Studio® 2019 or above (2022 is the default).
 
 Qt should be installed to the default location (C:\Qt\Qt6.xx.x).
 Be sure to select msvc2017/msvc2019 64-bit during Qt installation, depending on the compiler you decide to use.
@@ -49,13 +49,14 @@ If Qt is installed from a Qt installer, it should be installed to ~/Qt/Qt6.7.0 (
 Required dependencies can be installed as follows:
 ```bash
 sudo apt-get update
-sudo apt-get install build-essential python3 chrpath
-sudo apt-get install python3-pip
-pip install sphinx_rtd_theme
 sudo snap install cmake --classic
 sudo apt-get install git
 sudo apt-get install git-lfs
+sudo apt-get install build-essential python3
+sudo apt-get install chrpath patchelf
+sudo apt-get install python3-pip
 sudo apt-get install python3-sphinx
+sudo apt-get install python3-sphinx-rtd-theme
 sudo apt-get install libxcb-xinerama0
 sudo apt-get install mesa-common-dev libglu1-mesa-dev
 ```

CMakeLists.txt

@@ -1,5 +1,5 @@
 #######################################################################################################################
-### Copyright (c) 2019-2024 Advanced Micro Devices, Inc. All rights reserved.
+### Copyright (c) 2019-2025 Advanced Micro Devices, Inc. All rights reserved.
 ### \author AMD Developer Tools Team
 #######################################################################################################################
 
@@ -12,7 +12,7 @@ project(RMV)
 
 # Define version information
 set(RMV_MAJOR_VERSION 1)
-set(RMV_MINOR_VERSION 11)
+set(RMV_MINOR_VERSION 12)
 if (NOT RMV_BUGFIX_NUMBER)
     set(RMV_BUGFIX_NUMBER 0)
 endif ()
@@ -37,7 +37,7 @@ option(RDF_STATIC              "Build RDF as a static library" ON)
 ## For RMV we only care about the Debug and Release configuration types
 set(CMAKE_CONFIGURATION_TYPES Debug Release)
 
-## Determine build suffixes based on configuration and bitness
+## Determine build suffixes based on configuration and bitness status
 ## These values will be inherited by all child projects
 set(ADT_PLATFORM_POSTFIX "-x86")
 IF(CMAKE_SIZEOF_VOID_P EQUAL 8)
@@ -48,17 +48,6 @@ ENDIF()
 set (CMAKE_DEBUG_POSTFIX -d)
 set (CMAKE_RELEASE_POSTFIX)
 
-# Add cmake utilities
-list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake")
-
-IF(WIN32)
-    set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_RELEASE ${CMAKE_BINARY_DIR}/../release)
-    set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_DEBUG ${CMAKE_BINARY_DIR}/../debug)
-ELSE(WIN32)
-    set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_RELEASE ${CMAKE_BINARY_DIR}/../../release)
-    set(CMAKE_RUNTIME_OUTPUT_DIRECTORY_DEBUG ${CMAKE_BINARY_DIR}/../../debug)
-ENDIF(WIN32)
-
 # Add for CentOS compiler warning
 add_definitions(-DJSON_SKIP_UNSUPPORTED_COMPILER_CHECK)
 
@@ -130,11 +119,7 @@ ENDIF(WIN32)
 ## Copy Documentation and Samples to output directory. Note - this target is intentionally not included in
 ## the default project build. It needs to be explicitly built as a separate project
 
-# Determine where the build process will be placing the binary files
-# This is evaluated at project build time - not at CMake generation time
-set(BUILD_ROOT $<$<CONFIG:debug>:${CMAKE_RUNTIME_OUTPUT_DIRECTORY_DEBUG}>$<$<CONFIG:release>:${CMAKE_RUNTIME_OUTPUT_DIRECTORY_RELEASE}>)
-
-set(DOCS_OUTPUT_DIR ${BUILD_ROOT})
+set(DOCS_OUTPUT_DIR ${CMAKE_BINARY_DIR})
 
 # group sphinx source files into a sphinx folder
 file(GLOB SPHINX_DOC_FILES ${SPHINX_DOC_FILES} ${CMAKE_SOURCE_DIR}/documentation/source/*.rst)
@@ -152,6 +137,8 @@ set (RELEASE_DOCS_IN_ROOT
 set (RELEASE_DOCS ${RELEASE_DOCS_IN_ROOT})
 source_group("release_docs" FILES ${RELEASE_DOCS})
 
+install(FILES ${RELEASE_DOCS_IN_ROOT} DESTINATION . COMPONENT apps)
+
 find_program(SPHINX_EXECUTABLE sphinx-build)
 if(SPHINX_EXECUTABLE)
     # Define the option to pass to the sphinx documentation job
@@ -167,6 +154,7 @@ if(SPHINX_EXECUTABLE)
         COMMAND ${SPHINX_EXECUTABLE} ${CMAKE_SOURCE_DIR}/documentation/source ${DOCS_OUTPUT_DIR}/help/rmv/. -t ${SPHINX_OPTION}
         COMMAND ${CMAKE_COMMAND} -E remove_directory ${DOCS_OUTPUT_DIR}/help/rmv/.doctrees
     )
+    install(DIRECTORY ${CMAKE_BINARY_DIR}/help DESTINATION . COMPONENT apps)
 else()
     message(WARNING "SPHINX_EXECUTABLE (sphinx-build) is not found! Documentation will not be built!")
     # If the sphinx binary isn't found, then just create the Documentation project with only the release docs in it.
@@ -178,5 +166,39 @@ add_custom_command(TARGET Documentation POST_BUILD
     COMMAND ${CMAKE_COMMAND} -E copy_if_different ${RELEASE_DOCS_IN_ROOT}           ${DOCS_OUTPUT_DIR}/.
     COMMAND ${CMAKE_COMMAND} -E echo "copying Samples to output directory"
     COMMAND ${CMAKE_COMMAND} -E make_directory ${DOCS_OUTPUT_DIR}/samples
-    COMMAND ${CMAKE_COMMAND} -E copy_if_different ${CMAKE_SOURCE_DIR}/samples/sample_trace.rmv  ${DOCS_OUTPUT_DIR}/samples/.
+    COMMAND ${CMAKE_COMMAND} -E copy_if_different ${CMAKE_SOURCE_DIR}/samples/sample_trace.rmv  ${DOCS_OUTPUT_DIR}/samples/sample_trace.rmv
+)
+
+install(FILES
+       ${DOCS_OUTPUT_DIR}/samples/sample_trace.rmv
+        DESTINATION
+        samples
+        COMPONENT apps
 )
+
+if (WIN32)
+    set(CMAKE_INSTALL_SYSTEM_RUNTIME_DESTINATION .)
+    set(CMAKE_INSTALL_SYSTEM_RUNTIME_LIBS_SKIP TRUE)
+    include(InstallRequiredSystemLibraries)
+
+    install(PROGRAMS ${CMAKE_INSTALL_SYSTEM_RUNTIME_LIBS} DESTINATION . COMPONENT apps)
+endif (WIN32)
+
+# CPack packaging
+
+set(CPACK_ARCHIVE_COMPONENT_INSTALL ON)
+set(CPACK_COMPONENTS_GROUPING IGNORE)
+
+set(CPACK_ARCHIVE_APPS_FILE_NAME "RadeonMemoryVisualizer_${RMV_MAJOR_VERSION}.${RMV_MINOR_VERSION}.${RMV_BUGFIX_NUMBER}.${RMV_BUILD_NUMBER}")
+set(CPACK_ARCHIVE_DEBUG_FILE_NAME "RadeonMemoryVisualizer-PDB_${RMV_MAJOR_VERSION}.${RMV_MINOR_VERSION}.${RMV_BUGFIX_NUMBER}.${RMV_BUILD_NUMBER}")
+
+include(CPack)
+
+cpack_add_component(apps
+        DISPLAY_NAME "Applications"
+        DESCRIPTION "RMV application")
+cpack_add_component(debug
+        DISPLAY_NAME "Debug Symbols"
+        DESCRIPTION "Debug Symbols")
+
+

LICENSE.txt

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2017-2024 Advanced Micro Devices, Inc.
+Copyright (c) 2017-2025 Advanced Micro Devices, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -27,7 +27,7 @@ The Radeon Memory Visualizer (RMV) is a software tool that will allow users to a
  * Vulkan
 
 ## Supported ASICs
-
+* AMD Radeon RX 9000 series
 * AMD Radeon RX 7000 series
 * AMD Radeon RX 6000 series
 * AMD Radeon RX 5000 series
@@ -83,4 +83,4 @@ CMake is a registered trademark of Kitware, Inc.
 Qt and the Qt logo are registered trademarks of the Qt Company Ltd and/or its subsidiaries worldwide.
 
 
-© 2020-2024 Advanced Micro Devices, Inc. All rights reserved.
+© 2020-2025 Advanced Micro Devices, Inc. All rights reserved.

RELEASE_NOTES.txt

@@ -1,11 +1,11 @@
-Radeon™ Memory Visualizer V1.11 10/01/2024
+Radeon™ Memory Visualizer V1.12 03/11/2025
 ------------------------------------------
 
-V1.11 Changes
+V1.12 Changes
 ------------------------------------
-1) Dark mode user interface support, allowing the user to choose between a light and dark theme (or have RMV follow the OS theme setting).
-2) UI support for driver experiments.
-3) The "Device configuration" pane has been renamed to "System information."
+1) Support for AMD Radeon RX 9000 series GPUs
+2) New options to delete all snapshots or a selection of snapshots.
+3) Improved performance when loading snapshots for traces containing aliased resources.
 4) Bug/stability fixes.
 
 Known Issues
@@ -19,13 +19,20 @@ Known Issues
 (5) Sparse texture are not fully supported.
 (6) When tracing an application that uses a launcher, or an application that creates multiple devices, it is possible that more than one trace file will be written to disk. In the case of the launcher, adding the launcher's executable name to the Blocked applications list in the Radeon Developer Panel should prevent multiple trace files. Restarting the Radeon Developer Panel may be required before attempting to trace again.
 (7) If a memory dump is created by shutting down the application being traced and there are a large number of resource names, some names may not be included in the RMV file.  The work-around is to use the Dump trace button in the Radeon Developer Panel and wait for the button to be disabled before shutting down the application.  This gives the buffered names a chance to be processed.
-(8) The Shader core clock frequency and Video memory clock frequency for memory traces captured on Linux may be incorrectly displayed as 0.
+(8) The Shader core clock frequency and Video memory clock frequency for memory traces captured on Linux may be incorrectly displayed as 0 Mhz.
 (9) The Device name may be blank for memory traces captured on Linux with some APUs.
 (10) Installations of Ubuntu 20.04 or newer may have the RADV open source Vulkan® driver installed by default on the system. As a result, after an amdgpu-pro driver install, the default Vulkan ICD may be the RADV ICD. In order to capture a memory trace, Vulkan applications must be using the amdgpu-pro Vulkan ICD. The default Vulkan ICD can be overridden by setting the following environment variable before launching a Vulkan application: VK_ICD_FILENAMES=/etc/vulkan/icd.d/amd_icd64.json
 
 Release Notes History
 ------------------------------------
 
+V1.11 Changes
+------------------------------------
+1) Dark mode user interface support, allowing the user to choose between a light and dark theme (or have RMV follow the OS theme setting).
+2) UI support for driver experiments.
+3) The "Device configuration" pane has been renamed to "System information."
+4) Bug/stability fixes.
+
 V1.10 Changes
 ------------------------------------
 1) Updated to use Qt 6.7.0.

build/dependency_map.py

@@ -1,6 +1,6 @@
 #! python3
 ##=============================================================================
-## Copyright (c) 2020-2024 Advanced Micro Devices, Inc. All rights reserved.
+## Copyright (c) 2020-2025 Advanced Micro Devices, Inc. All rights reserved.
 ## \author AMD Developer Tools Team
 ## \file
 ## \brief List of all external dependencies.
@@ -21,9 +21,8 @@
 # Define a set of dependencies that exist as separate git projects.
 # each git dependency has a desired directory where it will be cloned - along with a commit to checkout
 git_mapping = {
-    github_tools + "qt_common"                 : ["../external/qt_common",         "v4.1.0", True],
+    github_tools + "qt_common"                 : ["../external/qt_common",         "v4.2.0", True],
+    github_tools + "system_info_utils"         : ["../external/system_info_utils", "v2.1",   True],
     github_tools + "update_check_api"          : ["../external/update_check_api",  "v2.1.1", True],
-    github_tools + "system_info_utils"         : ["../external/system_info_utils", "v2.0",   True],
     github_root  + "GPUOpen-Drivers/libamdrdf" : ["../external/rdf",               "v1.4.0", True],
 }
-

build/fetch_dependencies.py

@@ -1,6 +1,6 @@
 #! python3
 ##=============================================================================
-## Copyright (c) 2020-2024 Advanced Micro Devices, Inc. All rights reserved.
+## Copyright (c) 2020-2025 Advanced Micro Devices, Inc. All rights reserved.
 ## \author AMD Developer Tools Team
 ## \file
 ## \brief Script to fetch all external git and/or downloadable dependencies