1*4882a593Smuzhiyun=================================== 2*4882a593Smuzhiyundrm/amd/display - Display Core (DC) 3*4882a593Smuzhiyun=================================== 4*4882a593Smuzhiyun 5*4882a593Smuzhiyun*placeholder - general description of supported platforms, what dc is, etc.* 6*4882a593Smuzhiyun 7*4882a593SmuzhiyunBecause it is partially shared with other operating systems, the Display Core 8*4882a593SmuzhiyunDriver is divided in two pieces. 9*4882a593Smuzhiyun 10*4882a593Smuzhiyun1. **Display Core (DC)** contains the OS-agnostic components. Things like 11*4882a593Smuzhiyun hardware programming and resource management are handled here. 12*4882a593Smuzhiyun2. **Display Manager (DM)** contains the OS-dependent components. Hooks to the 13*4882a593Smuzhiyun amdgpu base driver and DRM are implemented here. 14*4882a593Smuzhiyun 15*4882a593SmuzhiyunIt doesn't help that the entire package is frequently referred to as DC. But 16*4882a593Smuzhiyunwith the context in mind, it should be clear. 17*4882a593Smuzhiyun 18*4882a593SmuzhiyunWhen CONFIG_DRM_AMD_DC is enabled, DC will be initialized by default for 19*4882a593Smuzhiyunsupported ASICs. To force disable, set `amdgpu.dc=0` on kernel command line. 20*4882a593SmuzhiyunLikewise, to force enable on unsupported ASICs, set `amdgpu.dc=1`. 21*4882a593Smuzhiyun 22*4882a593SmuzhiyunTo determine if DC is loaded, search dmesg for the following entry: 23*4882a593Smuzhiyun 24*4882a593Smuzhiyun``Display Core initialized with <version number here>`` 25*4882a593Smuzhiyun 26*4882a593SmuzhiyunAMDgpu Display Manager 27*4882a593Smuzhiyun====================== 28*4882a593Smuzhiyun 29*4882a593Smuzhiyun.. kernel-doc:: drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.c 30*4882a593Smuzhiyun :doc: overview 31*4882a593Smuzhiyun 32*4882a593Smuzhiyun.. kernel-doc:: drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.h 33*4882a593Smuzhiyun :internal: 34*4882a593Smuzhiyun 35*4882a593SmuzhiyunLifecycle 36*4882a593Smuzhiyun--------- 37*4882a593Smuzhiyun 38*4882a593Smuzhiyun.. kernel-doc:: drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.c 39*4882a593Smuzhiyun :doc: DM Lifecycle 40*4882a593Smuzhiyun 41*4882a593Smuzhiyun.. kernel-doc:: drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.c 42*4882a593Smuzhiyun :functions: dm_hw_init dm_hw_fini 43*4882a593Smuzhiyun 44*4882a593SmuzhiyunInterrupts 45*4882a593Smuzhiyun---------- 46*4882a593Smuzhiyun 47*4882a593Smuzhiyun.. kernel-doc:: drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm_irq.c 48*4882a593Smuzhiyun :doc: overview 49*4882a593Smuzhiyun 50*4882a593Smuzhiyun.. kernel-doc:: drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm_irq.c 51*4882a593Smuzhiyun :internal: 52*4882a593Smuzhiyun 53*4882a593Smuzhiyun.. kernel-doc:: drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.c 54*4882a593Smuzhiyun :functions: register_hpd_handlers dm_crtc_high_irq dm_pflip_high_irq 55*4882a593Smuzhiyun 56*4882a593SmuzhiyunAtomic Implementation 57*4882a593Smuzhiyun--------------------- 58*4882a593Smuzhiyun 59*4882a593Smuzhiyun.. kernel-doc:: drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.c 60*4882a593Smuzhiyun :doc: atomic 61*4882a593Smuzhiyun 62*4882a593Smuzhiyun.. kernel-doc:: drivers/gpu/drm/amd/display/amdgpu_dm/amdgpu_dm.c 63*4882a593Smuzhiyun :functions: amdgpu_dm_atomic_check amdgpu_dm_atomic_commit_tail 64*4882a593Smuzhiyun 65*4882a593SmuzhiyunDisplay Core 66*4882a593Smuzhiyun============ 67*4882a593Smuzhiyun 68*4882a593Smuzhiyun**WIP** 69