Linux GPU Driver Developer's Guide

Linux GPU Driver Developer's Guide

Jesse Barnes

Initial version 
Intel Corporation

    

<jesse.barnes@intel.com>

  

Laurent Pinchart

Driver internals 
Ideas on board SPRL

    

<laurent.pinchart@ideasonboard.com>

  

Daniel Vetter

Contributions all over the place 
Intel Corporation

    

<daniel.vetter@ffwll.ch>

  

Lukas Wunner

vga_switcheroo documentation 

    

<lukas@wunner.de>

  

Copyright © 2008-2009, 2013-2014 Intel Corporation
Copyright © 2012 Laurent Pinchart
Copyright © 2015 Lukas Wunner

The contents of this file may be used under the terms of the GNU General Public License version 2 (the "GPL") as distributed in the kernel source COPYING file.

Revision History
Revision 1.0	2012-07-13	LP
Added extensive documentation about driver internals.
Revision 1.1	2015-10-11	LW
Added vga_switcheroo documentation.

Table of Contents
I. DRM Core
1. IntroductionStyle Guidelines2. DRM Internals
Driver InitializationDriver InformationDevice Instance and Driver HandlingDriver LoadBus-specific Device Registration and PCI SupportMemory managementThe Translation Table Manager (TTM)The Graphics Execution Manager (GEM)GEM Function ReferenceVMA Offset ManagerPRIME Buffer SharingPRIME Function ReferencesDRM MM Range AllocatorDRM MM Range Allocator Function ReferencesCMA Helper Functions ReferenceMode SettingDisplay Modes Function ReferenceAtomic Mode Setting Function ReferenceFrame Buffer AbstractionDumb Buffer ObjectsOutput PollingLockingKMS Initialization and CleanupCRTCs (struct drm_crtc)Planes (struct drm_plane)Encoders (struct drm_encoder)Connectors (struct drm_connector)CleanupOutput discovery and initialization exampleKMS API FunctionsKMS Data StructuresKMS LockingMode Setting Helper FunctionsAtomic Modeset Helper Functions ReferenceModeset Helper Reference for Common VtablesLegacy CRTC/Modeset Helper Functions ReferenceOutput Probing Helper Functions Referencefbdev Helper Functions ReferenceDisplay Port Helper Functions ReferenceDisplay Port MST Helper Functions ReferenceMIPI DSI Helper Functions ReferenceEDID Helper Functions ReferenceRectangle Utilities ReferenceFlip-work Helper ReferenceHDMI Infoframes Helper ReferencePlane Helper ReferenceTile groupBridgesKMS PropertiesExisting KMS PropertiesVertical BlankingVertical Blanking and Interrupt Handling Functions ReferenceOpen/Close, File Operations and IOCTLsOpen and CloseFile OperationsIOCTLsLegacy Support CodeLegacy Suspend/ResumeLegacy DMA Services3. Userland interfacesRender nodesVBlank event handlingII. DRM Drivers
4. drm/i915 Intel GFX Driver
Core Driver InfrastructureRuntime Power ManagementInterrupt HandlingIntel GVT-g Guest Support(vGPU)Display Hardware HandlingMode Setting InfrastructureFrontbuffer TrackingDisplay FIFO Underrun ReportingPlane ConfigurationAtomic Plane HelpersOutput ProbingHotplugHigh Definition AudioPanel Self Refresh PSR (PSR/SRD)Frame Buffer Compression (FBC)Display Refresh Rate Switching (DRRS)DPIOCSR firmware support for DMCMemory Management and Command SubmissionBatchbuffer ParsingBatchbuffer PoolsLogical Rings, Logical Ring Contexts and ExeclistsGlobal GTT viewsGTT Fences and SwizzlingObject Tiling IOCTLsBuffer Object EvictionBuffer Object Memory ShrinkingGuCGuC-specific firmware loaderGuC-based command submissionGuC Firmware LayoutTracingi915_ppgtt_create and i915_ppgtt_releasei915_context_create and i915_context_freeswitch_mmIII. vga_switcheroo
5. Modes of UseManual switching and manual power controlDriver power control6. APIPublic functionsPublic structuresPublic constantsPrivate structures7. Handlers
apple-gmux HandlerGraphics muxPower controlBacklight control