GPU Driver Documentation

• drm/amdgpu AMDgpu driver
  • Core Driver Infrastructure
    • GPU Hardware Structure
    • GFX, Compute, and SDMA Overall Behavior
    • Driver Structure
    • Memory Domains
    • Buffer Objects
    • PRIME Buffer Sharing
    • MMU Notifier
    • AMDGPU Virtual Memory
    • Interrupt Handling
    • IP Blocks
  • Ring Buffer
    • Enforce Isolation
    • Ring Operations
  • AMD Hardware Components Information per Product
    • Accelerated Processing Units (APU) Info
    • Discrete GPU Info
  • Module Parameters
  • drm/amdgpu - Graphics and Compute (GC)
    • Graphics (GFX) and Compute Microcontrollers
  • drm/amd/display - Display Core (DC)
    • DC Code validation
    • DC Information
  • User Mode Queues
    • Introduction
    • Theory of Operation
    • Memory Management
    • Interaction with Kernel Queues
    • Queue Resets
    • IOCTL Interfaces
    • Kernel and User Queues
  • dGPU firmware flashing
    • IFWI
    • USB-C PD F/W
    • sysfs files
  • AMDGPU XGMI Support
  • AMDGPU RAS Support
    • RAS debugfs/sysfs Control and Error Injection Interfaces
    • RAS Reboot Behavior for Unrecoverable Errors
    • RAS Error Count sysfs Interface
    • RAS EEPROM debugfs Interface
    • RAS VRAM Bad Pages sysfs Interface
    • Sample Code
  • GPU Power/Thermal Controls and Monitoring
    • HWMON Interfaces
    • GPU sysfs Power State Interfaces
    • GFXOFF
  • Misc AMDGPU driver information
    • GPU Product Information
    • GPU Memory Usage Information
    • PCIe Accounting Information
    • GPU SmartShift Information
    • UMA Carveout
  • GPU Debugging
    • General Debugging Options
    • GPUVM Debugging
    • Decoding a GPUVM Page Fault
    • UMR
    • Debugging backlight brightness
  • AMDGPU DebugFS
    • DebugFS Files
  • AMDGPU Process Isolation
    • Process Isolation
    • Cleaner Shader Execution
  • AMDGPU Glossary
  • Peak Tops Limiter (PTL) sysfs Interface
    • Overview
    • PTL sysfs files
    • PTL Enable/Disable
    • PTL Format (Preferred Data Formats)
    • Supported Formats
    • Behavioral Notes
    • Implementation
• drm/i915 Intel GFX Driver
  • Core Driver Infrastructure
    • Runtime Power Management
    • Interrupt Handling
    • Intel GVT-g Guest Support(vGPU)
    • Intel GVT-g Host Support(vGPU device model)
    • Workarounds
  • GT Programming
    • Multicast/Replicated (MCR) Registers
  • Memory Management and Command Submission
    • Intel GPU Basics
    • Locking Guidelines
    • GEM BO Management Implementation Details
    • Buffer Object Eviction
    • Buffer Object Memory Shrinking
    • Batchbuffer Parsing
    • User Batchbuffer Execution
    • Scheduling
    • Logical Rings, Logical Ring Contexts and Execlists
    • Global GTT views
    • GTT Fences and Swizzling
    • Object Tiling IOCTLs
    • Protected Objects
  • Microcontrollers
    • WOPCM
    • GuC
    • HuC
    • DMC
  • Tracing
    • i915_ppgtt_create and i915_ppgtt_release
    • i915_context_create and i915_context_free
  • Perf
    • Overview
    • Comparison with Core Perf
    • i915 Driver Entry Points
    • i915 Perf Stream
    • i915 Perf Observation Architecture Stream
    • Other i915 Perf Internals
  • Style
    • Register macro definition style
  • i915 DRM client usage stats implementation
• drm/imagination PowerVR Graphics Driver
  • Contents
    • UAPI
• Intel Display Driver
  • Asynchronous Page Flip
  • Atomic Modeset Support
    • intel_digital_connector_atomic_get_property()
    • intel_digital_connector_atomic_set_property()
    • intel_digital_connector_duplicate_state()
    • intel_connector_needs_modeset()
    • intel_any_crtc_needs_modeset()
    • intel_crtc_duplicate_state()
    • intel_crtc_destroy_state()
  • High Definition Audio
    • intel_audio_codec_enable()
    • intel_audio_codec_disable()
    • intel_audio_hooks_init()
    • intel_audio_component_init()
    • intel_audio_component_cleanup()
    • intel_audio_init()
    • intel_audio_deinit()
    • i915_audio_component
  • Intel HDMI LPE Audio Support
    • intel_lpe_audio_irq_handler()
    • intel_lpe_audio_init()
    • intel_lpe_audio_teardown()
    • intel_lpe_audio_notify()
  • Content Adaptive Sharpness Filter (CASF)
  • Display clocks
    • intel_cdclk_init_hw()
    • intel_cdclk_uninit_hw()
    • intel_cdclk_clock_changed()
    • intel_cdclk_can_cd2x_update()
    • intel_cdclk_changed()
    • intel_set_cdclk_pre_plane_update()
    • intel_set_cdclk_post_plane_update()
    • intel_update_max_cdclk()
    • intel_update_cdclk()
    • intel_read_rawclk()
    • intel_init_cdclk_hooks()
  • Common Primary Timing Generator (CMTG)
  • DMC Firmware Support
    • intel_dmc_block_pkgc()
    • intel_dmc_start_pkgc_exit_at_start_of_undelayed_vblank()
    • intel_dmc_load_program()
    • intel_dmc_disable_program()
    • intel_dmc_init()
    • intel_dmc_suspend()
    • intel_dmc_resume()
    • intel_dmc_fini()
  • DMC Flip Queue
  • DMC wakelock support
  • DPIO
  • Display PLLs
    • intel_get_dpll_by_id()
    • intel_dpll_enable()
    • intel_dpll_disable()
    • intel_dpll_crtc_get()
    • intel_dpll_crtc_put()
    • intel_dpll_swap_state()
    • icl_set_active_port_dpll()
    • intel_dpll_init()
    • intel_dpll_compute()
    • intel_dpll_reserve()
    • intel_dpll_release()
    • intel_dpll_update_active()
    • intel_dpll_get_freq()
    • intel_dpll_get_hw_state()
    • intel_dpll_dump_hw_state()
    • intel_dpll_compare_hw_state()
    • intel_dpll_id
    • intel_dpll_state
    • dpll_info
    • intel_dpll
  • Display Refresh Rate Switching (DRRS)
    • intel_drrs_activate()
    • intel_drrs_deactivate()
    • intel_drrs_invalidate()
    • intel_drrs_flush()
    • intel_drrs_crtc_init()
  • Display State Buffer
    • intel_dsb_reg_write_indexed()
    • intel_dsb_commit()
    • intel_dsb_prepare()
    • intel_dsb_cleanup()
  • Frame Buffer Compression (FBC)
    • intel_fbc_disable()
    • intel_fbc_handle_fifo_underrun_irq()
    • intel_fbc_read_underrun_dbg_info()
    • intel_fbc_init()
    • intel_fbc_sanitize()
  • Display FIFO Underrun Reporting
    • intel_set_cpu_fifo_underrun_reporting()
    • intel_set_pch_fifo_underrun_reporting()
    • intel_cpu_fifo_underrun_irq_handler()
    • intel_pch_fifo_underrun_irq_handler()
    • intel_check_cpu_fifo_underruns()
    • intel_check_pch_fifo_underruns()
  • Frontbuffer Tracking
    • intel_frontbuffer_invalidate()
    • intel_frontbuffer_flush()
    • frontbuffer_flush()
    • intel_frontbuffer_flip()
    • intel_frontbuffer_queue_flush()
    • intel_frontbuffer_track()
  • Hotplug
    • intel_hpd_pin_default()
    • intel_hpd_irq_storm_detect()
    • intel_hpd_trigger_irq()
    • intel_hpd_irq_handler()
    • intel_hpd_init()
    • intel_hpd_poll_enable()
    • intel_hpd_poll_disable()
    • intel_hpd_block()
    • intel_hpd_unblock()
    • intel_hpd_clear_and_unblock()
  • Atomic Plane Helpers
    • intel_plane_destroy()
    • intel_plane_duplicate_state()
    • intel_plane_destroy_state()
    • intel_prepare_plane_fb()
    • intel_cleanup_plane_fb()
  • Panel Self Refresh PSR (PSR/SRD)
    • intel_psr_disable()
    • intel_psr_pause()
    • intel_psr_resume()
    • intel_psr_needs_vblank_notification()
    • intel_psr_trigger_frame_change_event()
    • intel_psr_min_set_context_latency()
    • intel_psr_wait_for_idle_locked()
    • intel_psr_invalidate()
    • intel_psr_flush()
    • intel_psr_init()
    • intel_psr_link_ok()
    • intel_psr_lock()
    • intel_psr_unlock()
    • intel_psr_notify_dc5_dc6()
    • intel_psr_dc5_dc6_wa_init()
    • intel_psr_notify_pipe_change()
    • intel_psr_notify_vblank_enable_disable()
  • Synopsis PHY support
  • Video BIOS Table (VBT)
    • intel_bios_is_valid_vbt()
    • intel_bios_init()
    • intel_bios_driver_remove()
    • intel_bios_is_tv_present()
    • intel_bios_is_lvds_present()
    • intel_bios_is_port_present()
    • intel_bios_is_dsi_present()
    • vbt_header
    • bdb_header
• drm/mcde ST-Ericsson MCDE Multi-channel display engine
• drm/meson AmLogic Meson Video Processing Unit
  • Video Processing Unit
  • Video Input Unit
  • Video Post Processing
  • Video Encoder
  • Video Clocks
  • HDMI Video Output
• drm/nouveau NVIDIA GPU Driver
  • NVKM: NVIDIA Kernel Manager
    • GSP Support
• drm/pl111 ARM PrimeCell PL110 and PL111 CLCD Driver
• drm/tegra NVIDIA Tegra GPU and display driver
  • Driver Infrastructure
    • Host1x Infrastructure Reference
    • Host1x Syncpoint Reference
  • KMS driver
    • Display Controllers
    • Outputs
  • Userspace Interface
    • GEM Buffers
    • Syncpoints
    • Command Stream Submission
• drm/tve200 Faraday TV Encoder 200
• drm/v3d Broadcom V3D Graphics Driver
  • GPU buffer object (BO) management
    • Address space management
    • GPU Scheduling
  • Interrupts
• drm/vc4 Broadcom VC4 Graphics Driver
  • Display Hardware Handling
    • Pixel Valve (DRM CRTC)
    • HVS
    • HVS planes
    • HDMI encoder
    • DSI encoder
    • DPI encoder
    • VEC (Composite TV out) encoder
  • KUnit Tests
  • Memory Management and 3D Command Submission
    • GPU buffer object (BO) management
    • V3D binner command list (BCL) validation
    • V3D render command list (RCL) generation
    • Shader validator for VC4
    • V3D Interrupts
• drm/vkms Virtual Kernel Modesetting
  • Setup
  • Configuring With Configfs
  • Testing With IGT
  • Testing With KUnit
  • TODO
    • IGT better support
    • Add Plane Features
    • Runtime Configuration
    • Writeback support
    • Output Features
    • CRC API Improvements
    • Atomic Check using eBPF
• drm/bridge/dw-hdmi Synopsys DesignWare HDMI Controller
  • Synopsys DesignWare HDMI Controller
    • Supported Input Formats and Encodings
• drm/xen-front Xen para-virtualized frontend driver
  • Driver modes of operation in terms of display buffers used
    • Buffers allocated by the frontend driver
    • Buffers allocated by the backend
  • Driver limitations
• drm/xe Intel GFX Driver
  • Memory Management
    • BO management
    • BO creation
    • BO validation
    • BO eviction / moving
    • Future work
    • GGTT
    • Pagetable building
  • Map Layer
  • Migrate Layer
    • Special VM details
    • Bind jobs
    • Copy / clear jobs
    • Future work
  • Execution Queue
    • Multi Queue Group
    • Multi Queue Group GuC interface
    • Internal API
  • Command submission
    • Flow
  • Runtime Power Management
    • Internal API
  • Xe GT Frequency Management
    • Internal API
  • Pcode
    • Internal API
  • Survivability Mode
    • Boot Survivability
    • Runtime Survivability
  • GT Multicast/Replicated (MCR) Register Support
    • Internal API
  • Hardware workarounds
    • Internal API
  • Register Table Processing
    • Internal API
  • Firmware
    • Firmware Layout
    • Write Once Protected Content Memory (WOPCM) Layout
    • GuC CTB Blob
    • GuC Power Conservation (PC)
    • PCIe Gen5 Limitations
    • Internal API
  • Multi-tile Devices
    • Internal API
  • Debugging
    • xe_assert
    • xe_tile_assert
    • xe_gt_assert
  • Xe Device Coredump
    • Internal API
  • Xe Device Wedging
    • Case: Firmware Flash
  • Xe DRM client usage stats implementation
  • Xe Configfs
    • Overview
    • Create devices
    • Configure Attributes
    • Remove devices
    • Internal API
  • Xe GT Statistics
    • Overview
    • Reading statistics
    • Resetting statistics
    • xe_gt_stats_id
    • xe_gt_stats
• Arm Framebuffer Compression (AFBC)
  • Components and Ordering
  • Number of Planes
  • Cross-device interoperability
• drm/komeda Arm display driver
  • Overview of D71 like display IPs
    • Layer
    • Scaler
    • Compositor (compiz)
    • Writeback Layer (wb_layer)
    • Post image processor (improc)
    • Timing controller (timing_ctrlr)
    • Merger
    • Splitter
  • Possible D71 Pipeline usage
    • Single pipeline data flow
    • Dual pipeline with Slave enabled
    • Sub-pipelines for input and output
  • Komeda Resource abstraction
    • struct komeda_pipeline/component
  • Resource discovery and initialization
    • komeda_dev_funcs
    • komeda_dev
  • Format handling
    • komeda_format_caps
    • komeda_format_caps_table
    • komeda_fb
  • Attach komeda_dev to DRM-KMS
    • How to map plane to Layer(input) pipeline
    • Make component/pipeline to be drm_private_obj
    • Tracking component_state/pipeline_state by drm_atomic_commit
    • komeda component validation
    • komeda_kms Abstraction
    • komde_kms Functions
  • Build komeda to be a Linux module driver
• drm/Panfrost Mali Driver
  • Panfrost DRM client usage stats implementation
• drm/Panthor CSF driver
  • Panthor DRM client usage stats implementation
• Xilinx ZynqMP Ultrascale+ DisplayPort Subsystem
  • debugfs
  • Internals
    • zynqmp_dpsub_layer_id
    • zynqmp_dpsub
    • zynqmp_dpsub_drm
    • zynqmp_dpsub_layer_mode
    • zynqmp_disp_format
    • zynqmp_disp_layer_dma
    • zynqmp_disp_layer_info
    • zynqmp_disp_layer
    • zynqmp_disp
    • zynqmp_disp_avbuf_set_format()
    • zynqmp_disp_avbuf_set_clocks_sources()
    • zynqmp_disp_avbuf_enable_channels()
    • zynqmp_disp_avbuf_disable_channels()
    • zynqmp_disp_avbuf_enable_audio()
    • zynqmp_disp_avbuf_disable_audio()
    • zynqmp_disp_avbuf_enable_video()
    • zynqmp_disp_avbuf_disable_video()
    • zynqmp_disp_avbuf_enable()
    • zynqmp_disp_avbuf_disable()
    • zynqmp_disp_blend_set_output_format()
    • zynqmp_disp_blend_set_bg_color()
    • zynqmp_disp_blend_set_global_alpha()
    • zynqmp_disp_blend_layer_set_csc()
    • zynqmp_disp_blend_layer_enable()
    • zynqmp_disp_blend_layer_disable()
    • zynqmp_disp_layer_find_format()
    • zynqmp_disp_layer_find_live_format()
    • zynqmp_disp_layer_drm_formats()
    • zynqmp_disp_live_layer_formats()
    • zynqmp_disp_layer_enable()
    • zynqmp_disp_layer_disable()
    • zynqmp_disp_layer_set_format()
    • zynqmp_disp_layer_set_live_format()
    • zynqmp_disp_layer_update()
    • zynqmp_disp_layer_release_dma()
    • zynqmp_disp_destroy_layers()
    • zynqmp_disp_layer_request_dma()
    • zynqmp_disp_create_layers()
    • zynqmp_disp_enable()
    • zynqmp_disp_disable()
    • zynqmp_disp_setup_clock()
    • zynqmp_dp_link_config
    • zynqmp_dp_mode
    • zynqmp_dp_config
    • test_pattern
    • zynqmp_dp_test
    • zynqmp_dp_train_set_priv
    • zynqmp_dp
    • zynqmp_dp_phy_init()
    • zynqmp_dp_phy_exit()
    • zynqmp_dp_phy_probe()
    • zynqmp_dp_phy_ready()
    • zynqmp_dp_max_rate()
    • zynqmp_dp_mode_configure()
    • zynqmp_dp_adjust_train()
    • zynqmp_dp_update_vs_emph()
    • zynqmp_dp_link_train_cr()
    • zynqmp_dp_link_train_ce()
    • zynqmp_dp_setup()
    • zynqmp_dp_train()
    • zynqmp_dp_train_loop()
    • zynqmp_dp_aux_cmd_submit()
    • zynqmp_dp_aux_init()
    • zynqmp_dp_aux_cleanup()
    • zynqmp_dp_update_misc()
    • zynqmp_dp_set_format()
    • zynqmp_dp_encoder_mode_set_transfer_unit()
    • zynqmp_dp_encoder_mode_set_stream()
    • zynqmp_dp_disp_connected_live_layer()
    • zynqmp_dp_set_test_pattern()
    • zynqmp_dp_enable_vblank()
    • zynqmp_dp_disable_vblank()
    • zynqmp_dpsub_drm_handle_vblank()
• nova NVIDIA GPU drivers
  • Guidelines
    • Language
    • Documentation
    • Acceptance Criteria
  • nova-core
    • Guidelines
    • Task List
    • VBIOS
    • Device Initialization (devinit)
    • FWSEC (Firmware Security)
    • Falcon (FAst Logic Controller)