Decoding instructions with the machine-readable AMD GPU ISA specifications
A simple C++ program demonstrating how easy it is to decode instructions using the IsaDecoder API.
AMD’s machine-readable GPU ISA specifications are a set of XML files that describe AMD’s latest GPU Instruction Set Architectures (ISAs): instructions, encodings, operands, data formats and even human-readable description strings. Explore the XML files directly or use the IsaDecoder API for easy access and quick decoding of single instructions and whole kernels.
Supported architectures:
- AMD CDNA™ 3 (AMD MI300 Instinct)
- AMD CDNA™ 2 (AMD MI200 Instinct)
- AMD CDNA™ 1 (AMD MI100 Instinct)
- AMD RDNA™ 4
- AMD RDNA™ 3.5
- AMD RDNA™ 3
- AMD RDNA™ 2
- AMD RDNA™ 1
XML specification files
AMD GPU IsaDecoder API and more
We’ve made available a set of C++ tools for parsing and using AMD’s machine-readable GPU ISA specifications:
- The AMD GPU IsaDecoder API makes it easy to parse the specification XML files, decode instructions, and even decode whole shaders.
- The
explorer::Specexperimental API lets you iterate over the elements of a given specification file.
You can find a simple C++ program in our blog if you want to get started quickly!
Looking for more?
If you’re looking for the PDF versions, you can find them on our AMD GPU architecture programming documentation page.
If you have questions, requests, or feedback, feel free to get in touch via Issues on the GitHub repo.
Issues on GitHubNot finding what you need here, or looking for something a bit more niche or historical?
You may find what you’re after with AMD’s Technical Documentation.
Tech Docs @ AMD.comRelated content
AMD RDNA™ Performance Guide
Our one-stop resource for getting great AMD RDNA™ performance on Vulkan® and DirectX®12 APIs!
Developer Guides
Browse our technical blogs, and find valuable advice on developing with AMD hardware, ray tracing, Vulkan®, DirectX®, Unreal Engine, and lots more.
Documentation
Explore our huge collection of detailed tutorials, sample code, presentations, and documentation to find answers to your graphics development questions.
Presentations and manuals
Don’t miss our manual documentation! And if slide decks are what you’re after, you’ll find 100+ of our finest presentations here.
Related software
AMD FidelityFX™ Brixelizer/GI
AMD FidelityFX™ Brixelizer GI is compute-based real-time dynamic global illumination solution built upon sparse distance fields.
AMD FidelityFX™ Breadcrumbs library
AMD FidelityFX Breadcrumbs library uses the breadcrumbs marker technique to track down where your submitted commands cause a GPU crash.
AMD FidelityFX™ Lens
AMD FidelityFX Lens is an AMD RDNA™ architecture optimized implementation of some of gaming's most used post-processing effects.
AMD FidelityFX™ Depth of Field (DoF)
AMD FidelityFX Depth of Field is an AMD RDNA™-architecture optimized implementation of physically correct camera-based depth of field.
Related news and technical articles
Enhancing AMD Radeon GPU Detective Output with DirectX Debug Information
With version 1.5 of AMD Radeon™ GPU Detective (RGD) you can now use the debug information that is produced by the Microsoft DirectX® Shader Compiler.
Introducing the Latest AMD Radeon Developer Tool Suite with Support for AMD Radeon...
We've released an updated AMD Radeon™ Developer Tool Suite, including enhanced versions of tools such as the Radeon GPU Detective, Profiler, Raytracing Analyzer, Memory Visualizer,...
CPU performance optimization guide - part 3
We look at optimizing CPU performance by reducing the number of instructions, and highlights methods to enhance instruction efficiency and algorithm throughput.
CPU performance optimization guide - part 4
Optimize CPU performance by manually writing x64 assembly code, offering a detailed comparison with compiler-generated instructions and achieving improved performance through streamlined...
Major AMD Radeon Developer Tool Suite updates for AMD RDNA 4 architecture
Read the highlights of our updates to the AMD Radeon Developer Tool Suite to support the launch of AMD RDNA 4 architecture!
Reading AMD RDNA™ and CDNA™ Architecture Disassembly is a Breeze with AMD Radeon™...
Explore Radeon GPU Analyzer v2.12's enhanced ISA disassembly view, making shader and kernel analysis easier with new tooltips and automatic highlighting. Optimize your GPU workflows...
AMD Radeon™ GPU Profiler 2.4 adds support for AMD Radeon™ RX 9000 Series, pure-compute...
Discover the latest Radeon GPU Profiler v2.4, now supporting Radeon RX 9000 Series GPUs and profiling for pure compute and DirectML applications. Enhance your optimization with improved...
Hardware Crash Analysis with AMD Radeon™ GPU Detective
Unlock deeper insights into GPU crashes with Radeon GPU Detective v1.4's new Hardware Crash Analysis feature. Identify in-flight shaders and pinpoint crash culprits faster, streamlining...
Related videos
Real-time Sparse Distance Fields for Games (GDC 2023 - YouTube link)
This presentation introduces a novel algorithm for PC and console developers to efficiently generate sparse distance fields in real-time.
Compute Shaders - Game Industry Conference 2021
This talk introduces compute shaders, explaining ideas from a software and hardware perspective, as well as considerations when writing compute shaders.
Microsoft® Game Stack Live: Denoising Raytraced Soft Shadows on Xbox Series X|S and...
We explain how FidelityFX Denoiser allows for high-quality raytracing results without increasing rays per pixel, and deep dive into specific AMD RDNA™ 2-based optimizations that benefit...
AMD RDNA™ 2 – Radeon™ GPU Profiler 1.10 - YouTube link
RGP 1.9 and 1.10 introduce support for AMD Radeon™ RX6000 series GPUs, a new memory cache counter feature, and support for DirectX® and Vulkan® ray tracing.
All the Pipelines - Journey through the GPU
This presentation by one of our engineers at GIC 2020 provides an introduction to the graphics pipeline.
AMD RDNA™ 2 – DirectX® Raytracing 1.1 - YouTube link
Graphics feature architect Rys Sommefeldt provides a short presentation on the major advantages of the new API, and how to best utilize it on AMD RDNA™ 2-based hardware.
AMD RDNA™ 2 - DirectX® 12 Ultimate: Variable Rate Shading - YouTube link
Engineer Stephan Hodes provides a short description how VRS works, and how AMD’s FidelityFX Variable Shading technique can assist with integrating VRS into your engine.
AMD RDNA™ 2 - DirectX® 12 Ultimate: Sampler Feedback and Mesh Shaders - YouTube link
Engineer Colin Riley provides a short description of Sampler Feedback and Mesh Shaders, as well as important performance guidelines that graphics developers should consider when using...