Readme update for open-sourcing (#84)
* Initial commit
Change-Id: I24703941cda0d009f1eb4dac8846195fac9ebb24
* Updated "Supported Architectures and Counter Blocks"
Change-Id: Ia7cdc46d4623d7a6664550ee4e0ab9425a3ac52f
* Added HSA links
Change-Id: Id506362f6d913dc94943a6ee047e25c00cf85f53
* addressing review comments
Change-Id: Iec35efc55e49f5b9c57c2de455fbef2afed80a77
* Minor change
Change-Id: I0bfdc774dcc42aa01b2f3dfc24d97cf301e364d7
* minor update
Change-Id: I970d5fa416a1c3e4c3fc37dde5269a37f02a4c60
[ROCm/aqlprofile commit: d046917427]
This commit is contained in:
Verma, Saurabh
GitHub
@@ -0,0 +1,134 @@
|
||||
# AQLprofile: Architected Queuing Language Profiling Library
|
||||
|
||||
AQLprofile is an open source library that enables advanced GPU profiling and tracing on AMD platforms. It works in conjunction with [rocprofiler-sdk](https://github.com/ROCm/rocprofiler-sdk) to support profiling methods such as performance counters (PMC) and SQ thread trace (SQTT). AQLprofile provides the foundational mechanisms for constructing AQL packets and managing profiling operations across multiple AMD GPU architecture families.
|
||||
|
||||
### Background
|
||||
|
||||
AQLprofile builds on concepts from the Heterogeneous System Architecture (HSA) and Architected Queuing Language (AQL), which define the foundations for GPU command processing and profiling on AMD platforms. For further reading:
|
||||
|
||||
- [HSA Platform System Architecture Specification](http://hsafoundation.com/wp-content/uploads/2021/02/HSA-SysArch-1.2.pdf)
|
||||
- [HSA Runtime Programmer’s Reference Specification](http://hsafoundation.com/wp-content/uploads/2021/02/HSA-Runtime-1.2.pdf)
|
||||
|
||||
## Overview
|
||||
|
||||
AQLprofile is a companion library to [rocprofiler-sdk](https://github.com/ROCm/rocprofiler-sdk).
|
||||
It provides the low-level mechanisms required by rocprofiler-sdk to enable advanced GPU profiling and tracing capabilities on AMD platforms. The development and evolution of AQLprofile are closely aligned with the needs of rocprofiler-sdk, ensuring compatibility and feature support for new GPU architectures and profiling requirements.
|
||||
|
||||
AQLprofile abstracts the complexity of constructing and managing AQL (Architected Queuing Language) packets, command buffers, and register programming. These components are essential for orchestrating profiling operations such as performance counter collection and thread tracing. The library supports a range of AMD GPU architecture families such as GFX9, GFX10, GFX11, GFX12 and so on.
|
||||
It provides the necessary infrastructure for rocprofiler-sdk to interact with hardware-level profiling features.
|
||||
|
||||
## Features
|
||||
|
||||
- Profiling AQL packets for GPU workloads.
|
||||
- Performance counters (PMC) and SQ thread traces (SQTT).
|
||||
- Support for GFX9, GFX10, GFX11 and GFX12 architecture families.
|
||||
- Verbose tracing and error logging capabilities.
|
||||
- Thread trace binary data generated by AQLprofile can be decoded using [rocprof-trace-decoder](https://github.com/ROCm/rocprof-trace-decoder/releases).
|
||||
|
||||
### Supported Architectures and Counter Blocks
|
||||
|
||||
The AQLprofile library supports profiling and tracing GPU workloads across multiple architectures.<br>
|
||||
Below is a summary of the counter blocks supported for each architecture:
|
||||
|
||||
| Counter Block Name | GFX9 | GFX908 | GFX90A | GFX942 | GFX10 | GFX11 | GFX12 |
|
||||
|-------------------------|-------------|----------------|----------------|----------------|-------------|------------- |------------|
|
||||
| ATC | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
|
||||
| ATC_L2 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
|
||||
| CHA | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
|
||||
| CHC | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
|
||||
| CPC | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| CPF | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| CPG | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
|
||||
| GCEA | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| GCR | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ | ✅ |
|
||||
| GDS | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ |
|
||||
| GL1A | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ | ✅ |
|
||||
| GL1C | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ | ✅ |
|
||||
| GL2A | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ | ✅ |
|
||||
| GL2C | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ | ✅ |
|
||||
| GRBM | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| GRBMH | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
|
||||
| GRBM_SE | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
|
||||
| GUS | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ |
|
||||
| MC_VM_L2 | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
|
||||
| RPB | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
|
||||
| SDMA | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
|
||||
| SPI | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| SQ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| SQ_CS | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
|
||||
| SX | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ |
|
||||
| TA | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
||||
| TCA | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
|
||||
| TCC | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
|
||||
| TCP | ✅ | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ |
|
||||
| TD | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ✅ |
|
||||
|
||||
Legend:
|
||||
- ✅: Supported
|
||||
- ❌: Not Supported
|
||||
|
||||
## Build and Installation
|
||||
|
||||
### Prerequisites
|
||||
|
||||
Ensure the following tools and dependencies are installed:
|
||||
- ROCm stack
|
||||
- `rocm-llvm-dev` (required to build tests)
|
||||
|
||||
### Building AQLprofile
|
||||
|
||||
You can build AQLprofile using either the provided build script (recommended for most users) or by manually invoking CMake for custom builds.
|
||||
|
||||
#### Option 1: Using the Build Script (Recommended)
|
||||
|
||||
This will configure and build the project with default settings:
|
||||
|
||||
```bash
|
||||
./build.sh
|
||||
```
|
||||
|
||||
#### Option 2: Custom Build with CMake
|
||||
|
||||
For more control over the build process, you can set CMake options manually:
|
||||
|
||||
```bash
|
||||
# Set the CMAKE_PREFIX_PATH to point to hsa-runtime includes path and hsa-runtime library path
|
||||
export CMAKE_PREFIX_PATH=<path to hsa-runtime includes>:<path to hsa-runtime library>
|
||||
# For example, if ROCm is installed at /opt/rocm:
|
||||
# export CMAKE_PREFIX_PATH=/opt/rocm/lib:/opt/rocm/include/hsa
|
||||
|
||||
export CMAKE_BUILD_TYPE=<debug|release> # release by default
|
||||
|
||||
cd /path/to/aqlprofile
|
||||
mkdir build
|
||||
cd build
|
||||
cmake ..
|
||||
make -j
|
||||
```
|
||||
|
||||
### Debug Trace Mode (optional; for debugging only)
|
||||
|
||||
To enable debug tracing, set the following environment variable before running CMake:
|
||||
|
||||
```bash
|
||||
export CMAKE_DEBUG_TRACE=1
|
||||
```
|
||||
|
||||
This enables verbose debug output of the command packets while this library executes
|
||||
|
||||
### Installation
|
||||
|
||||
After building, install the AQLprofile libraries with:
|
||||
|
||||
```bash
|
||||
cd build
|
||||
sudo make install
|
||||
```
|
||||
|
||||
## Support
|
||||
|
||||
For issues or questions, please report them in the GitHub Issues section or contact AMD support at <dl.ROCm-Profiler.support@amd.com>.
|
||||
|
||||
## License
|
||||
|
||||
AQLprofile is open source and distributed under the MIT License. See the LICENSE file for more details.
|
||||
Fai riferimento in un nuovo problema
Block a user