UMR: User Mode Register Debugger

Contents:

• Introduction
  • The User Mode Register Debugger
  • Repository Location
  • Development Team
• Build and Installation
  • Fetching Sources
  • Dependencies
  • Compiling and Installation
  • Optional Packages
• Basic Commands
  • Device Selection
    • Selecting by Instance
    • Selecting by Name
    • Selecting by PCI bus ID
    • Selecting by name and instance/pci
    • Selecting a virtual device
  • Exporting a model
  • Options
  • Device Information
• Scriptware Commands
  • instances
  • pci-instances
  • pci-did
  • pci-bus
  • pci-bus-to-instance
  • pci-bus-to-instxcc
  • xcds
  • gfxname
• User Queues
  • Quick reference
  • Kernel Support
  • Queue Bindings
  • Listing User Queues
  • Listing User Queue Information
  • Reading Waves from a User Queue
  • Reading the Command Submission from a User Queue
  • VMID specification
• Register Access
  • Reading a set of registers
  • GRBM Bank Selection
  • SRBM Bank Selection
  • Direct Access
  • Lookup Register Decoding
• GPU Memory Access
  • Virtual Address Decoding
  • Virtual Memory Reads
  • Virtual Memory Writes
  • System Memory Access
• Wave Status
  • Basic Decoding
  • Detailed output
  • Kernel configurations
  • Full Kernel Text
• Ring and IB Decoding
  • IB Decoding
  • Bitfield Decoding
  • User Queue Packet Disassembly
• Profiling
• Real-time GPU Status
  • Data Logger
• Power and Clock
  • Check and set clock
  • Powerplay table information
• Graphical User Interface
  • Register Access
  • Wave Status
  • Reading Rings
  • Power Status
  • ASIC Top
  • KMS Monitoring
  • Memory Usage
  • Reading GPU VM memory
• libumrcore.a: API Documentation
  • Creating an ASIC Instance
    • Creating a Virtual Device
    • Creating a device based on PCI mapping
    • Creating a device based on Instance mapping
    • Creating a device based on a PCI Device ID
    • Further reading
  • ASIC callbacks (MMIO, memory, waves)
    • Split backends (guest UMR, RumR, custom RPC)
    • API shape (src/umr.h)
    • ASIC file descriptors and NULL pointers
    • umr_register_access_funcs
    • umr_memory_access_funcs
    • umr_wave_access_funcs
    • umr_read_gpr_funcs (GPRs)
    • Related ASIC fields
    • XGMI / multi-GPU
    • Source files (quick reference)
    • Checklist for a new backend
  • Closing an ASIC Device
  • Reading and Writing Registers
    • Searching
    • Reading and Writing Methods
    • Bitslicing Register Values
    • Bank Selection
  • Bank Selection
    • GRBM Bank Selection
    • SRBM Bank Selection
  • GPU VM Access
    • Read and Write Macros
    • XGMI Support
  • Halting Waves
    • Portability
  • Wave Status
    • SQ Information
    • Reading Wave Status Data
    • Scanning Halted Waves
    • Reading GPRs
  • Shader Disassembly
  • Packet API Documentation
    • Decoding a process mapped buffer
    • Decoding a GPU mapped buffer
    • Decoding a ring file buffer
    • Disassemble a packet stream
  • PM4 Stream Decoding
    • PM4 Decode a Buffer
    • Freeing a PM4 Stream
    • Finding Shaders in PM4 Streams
    • Packet Dissasembly
  • SDMA Stream Decoding
    • SDMA Decode a Buffer
    • Freeing an SDMA Stream
    • Packet Decoding
    • Packet Decoding Callbacks
  • Interrupt Vector Decode

Library integrations that replace the default Linux accessors should read ASIC callbacks (MMIO, memory, waves) for the struct umr_asic callback tables.

Indices and tables

• Index

• Search Page