12fa91d15SJani Nikula============================= 22fa91d15SJani NikulaMode Setting Helper Functions 32fa91d15SJani Nikula============================= 42fa91d15SJani Nikula 5bcb32b69SDaniel VetterThe DRM subsystem aims for a strong separation between core code and helper 6bcb32b69SDaniel Vetterlibraries. Core code takes care of general setup and teardown and decoding 7bcb32b69SDaniel Vetteruserspace requests to kernel internal objects. Everything else is handled by a 8bcb32b69SDaniel Vetterlarge set of helper libraries, which can be combined freely to pick and choose 9bcb32b69SDaniel Vetterfor each driver what fits, and avoid shared code where special behaviour is 10bcb32b69SDaniel Vetterneeded. 112fa91d15SJani Nikula 12bcb32b69SDaniel VetterThis distinction between core code and helpers is especially strong in the 13bcb32b69SDaniel Vettermodesetting code, where there's a shared userspace ABI for all drivers. This is 14bcb32b69SDaniel Vetterin contrast to the render side, where pretty much everything (with very few 15bcb32b69SDaniel Vetterexceptions) can be considered optional helper code. 162fa91d15SJani Nikula 17bcb32b69SDaniel VetterThere are a few areas these helpers can grouped into: 182fa91d15SJani Nikula 19bcb32b69SDaniel Vetter* Helpers to implement modesetting. The important ones here are the atomic 20bcb32b69SDaniel Vetter helpers. Old drivers still often use the legacy CRTC helpers. They both share 21bcb32b69SDaniel Vetter the same set of common helper vtables. For really simple drivers (anything 22bcb32b69SDaniel Vetter that would have been a great fit in the deprecated fbdev subsystem) there's 23bcb32b69SDaniel Vetter also the simple display pipe helpers. 24bcb32b69SDaniel Vetter 25bcb32b69SDaniel Vetter* There's a big pile of helpers for handling outputs. First the generic bridge 26bcb32b69SDaniel Vetter helpers for handling encoder and transcoder IP blocks. Second the panel helpers 27bcb32b69SDaniel Vetter for handling panel-related information and logic. Plus then a big set of 28bcb32b69SDaniel Vetter helpers for the various sink standards (DisplayPort, HDMI, MIPI DSI). Finally 29bcb32b69SDaniel Vetter there's also generic helpers for handling output probing, and for dealing with 30bcb32b69SDaniel Vetter EDIDs. 31bcb32b69SDaniel Vetter 32bcb32b69SDaniel Vetter* The last group of helpers concerns itself with the frontend side of a display 33bcb32b69SDaniel Vetter pipeline: Planes, handling rectangles for visibility checking and scissoring, 34bcb32b69SDaniel Vetter flip queues and assorted bits. 35bcb32b69SDaniel Vetter 36bcb32b69SDaniel VetterModeset Helper Reference for Common Vtables 37bcb32b69SDaniel Vetter=========================================== 38bcb32b69SDaniel Vetter 39bcb32b69SDaniel Vetter.. kernel-doc:: include/drm/drm_modeset_helper_vtables.h 401ea35768SDaniel Vetter :doc: overview 41bcb32b69SDaniel Vetter 42bcb32b69SDaniel Vetter.. kernel-doc:: include/drm/drm_modeset_helper_vtables.h 431ea35768SDaniel Vetter :internal: 442fa91d15SJani Nikula 454a8e2292SDaniel Vetter.. _drm_atomic_helper: 464a8e2292SDaniel Vetter 472fa91d15SJani NikulaAtomic Modeset Helper Functions Reference 482fa91d15SJani Nikula========================================= 492fa91d15SJani Nikula 502fa91d15SJani NikulaOverview 512fa91d15SJani Nikula-------- 522fa91d15SJani Nikula 532fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_atomic_helper.c 542fa91d15SJani Nikula :doc: overview 552fa91d15SJani Nikula 562fa91d15SJani NikulaImplementing Asynchronous Atomic Commit 572fa91d15SJani Nikula--------------------------------------- 582fa91d15SJani Nikula 592fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_atomic_helper.c 602fa91d15SJani Nikula :doc: implementing nonblocking commit 612fa91d15SJani Nikula 622fa91d15SJani NikulaAtomic State Reset and Initialization 632fa91d15SJani Nikula------------------------------------- 642fa91d15SJani Nikula 652fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_atomic_helper.c 662fa91d15SJani Nikula :doc: atomic state reset and initialization 672fa91d15SJani Nikula 681ea0c02eSDaniel VetterHelper Functions Reference 691ea0c02eSDaniel Vetter-------------------------- 701ea0c02eSDaniel Vetter 712fa91d15SJani Nikula.. kernel-doc:: include/drm/drm_atomic_helper.h 722fa91d15SJani Nikula :internal: 732fa91d15SJani Nikula 742fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_atomic_helper.c 752fa91d15SJani Nikula :export: 762fa91d15SJani Nikula 77bcb32b69SDaniel VetterSimple KMS Helper Reference 78bcb32b69SDaniel Vetter=========================== 79bcb32b69SDaniel Vetter 801ea35768SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_simple_kms_helper.c 811ea35768SDaniel Vetter :doc: overview 821ea35768SDaniel Vetter 83bcb32b69SDaniel Vetter.. kernel-doc:: include/drm/drm_simple_kms_helper.h 84bcb32b69SDaniel Vetter :internal: 85bcb32b69SDaniel Vetter 86bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_simple_kms_helper.c 87bcb32b69SDaniel Vetter :export: 88bcb32b69SDaniel Vetter 892fa91d15SJani Nikulafbdev Helper Functions Reference 902fa91d15SJani Nikula================================ 912fa91d15SJani Nikula 922fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_fb_helper.c 932fa91d15SJani Nikula :doc: fbdev helpers 942fa91d15SJani Nikula 952fa91d15SJani Nikula.. kernel-doc:: include/drm/drm_fb_helper.h 962fa91d15SJani Nikula :internal: 972fa91d15SJani Nikula 981ea35768SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_fb_helper.c 991ea35768SDaniel Vetter :export: 1001ea35768SDaniel Vetter 1012fa91d15SJani NikulaFramebuffer CMA Helper Functions Reference 1022fa91d15SJani Nikula========================================== 1032fa91d15SJani Nikula 1042fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_fb_cma_helper.c 1052fa91d15SJani Nikula :doc: framebuffer cma helper functions 1062fa91d15SJani Nikula 1072fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_fb_cma_helper.c 1082fa91d15SJani Nikula :export: 1092fa91d15SJani Nikula 1102564d0b0SDaniel Vetter.. _drm_bridges: 1112564d0b0SDaniel Vetter 112bcb32b69SDaniel VetterBridges 113bcb32b69SDaniel Vetter======= 114bcb32b69SDaniel Vetter 115bcb32b69SDaniel VetterOverview 116bcb32b69SDaniel Vetter-------- 117bcb32b69SDaniel Vetter 118bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_bridge.c 119bcb32b69SDaniel Vetter :doc: overview 120bcb32b69SDaniel Vetter 121bcb32b69SDaniel VetterDefault bridge callback sequence 122bcb32b69SDaniel Vetter-------------------------------- 123bcb32b69SDaniel Vetter 124bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_bridge.c 125bcb32b69SDaniel Vetter :doc: bridge callbacks 126bcb32b69SDaniel Vetter 127199e4e96SDaniel Vetter 128199e4e96SDaniel VetterBridge Helper Reference 129199e4e96SDaniel Vetter------------------------- 130199e4e96SDaniel Vetter 131199e4e96SDaniel Vetter.. kernel-doc:: include/drm/drm_bridge.h 132199e4e96SDaniel Vetter :internal: 133199e4e96SDaniel Vetter 134bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_bridge.c 135bcb32b69SDaniel Vetter :export: 136bcb32b69SDaniel Vetter 13713dfc054SEric AnholtPanel-Bridge Helper Reference 13813dfc054SEric Anholt----------------------------- 13913dfc054SEric Anholt 14013dfc054SEric Anholt.. kernel-doc:: drivers/gpu/drm/bridge/panel.c 14113dfc054SEric Anholt :export: 14213dfc054SEric Anholt 1432564d0b0SDaniel Vetter.. _drm_panel_helper: 1442564d0b0SDaniel Vetter 145bcb32b69SDaniel VetterPanel Helper Reference 146bcb32b69SDaniel Vetter====================== 147bcb32b69SDaniel Vetter 1481ea35768SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_panel.c 1491ea35768SDaniel Vetter :doc: drm panel 1501ea35768SDaniel Vetter 151bcb32b69SDaniel Vetter.. kernel-doc:: include/drm/drm_panel.h 152bcb32b69SDaniel Vetter :internal: 153bcb32b69SDaniel Vetter 154bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_panel.c 155bcb32b69SDaniel Vetter :export: 156bcb32b69SDaniel Vetter 157404d1a3eSHans de Goede.. kernel-doc:: drivers/gpu/drm/drm_panel_orientation_quirks.c 158404d1a3eSHans de Goede :export: 159404d1a3eSHans de Goede 1602fa91d15SJani NikulaDisplay Port Helper Functions Reference 1612fa91d15SJani Nikula======================================= 1622fa91d15SJani Nikula 1632fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_dp_helper.c 1642fa91d15SJani Nikula :doc: dp helpers 1652fa91d15SJani Nikula 1662fa91d15SJani Nikula.. kernel-doc:: include/drm/drm_dp_helper.h 1672fa91d15SJani Nikula :internal: 1682fa91d15SJani Nikula 1692fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_dp_helper.c 1702fa91d15SJani Nikula :export: 1712fa91d15SJani Nikula 1722fa91d15SJani NikulaDisplay Port Dual Mode Adaptor Helper Functions Reference 1732fa91d15SJani Nikula========================================================= 1742fa91d15SJani Nikula 1752fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_dp_dual_mode_helper.c 1762fa91d15SJani Nikula :doc: dp dual mode helpers 1772fa91d15SJani Nikula 1782fa91d15SJani Nikula.. kernel-doc:: include/drm/drm_dp_dual_mode_helper.h 1792fa91d15SJani Nikula :internal: 1802fa91d15SJani Nikula 1812fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_dp_dual_mode_helper.c 1822fa91d15SJani Nikula :export: 1832fa91d15SJani Nikula 1842fa91d15SJani NikulaDisplay Port MST Helper Functions Reference 1852fa91d15SJani Nikula=========================================== 1862fa91d15SJani Nikula 1872fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_dp_mst_topology.c 1882fa91d15SJani Nikula :doc: dp mst helper 1892fa91d15SJani Nikula 1902fa91d15SJani Nikula.. kernel-doc:: include/drm/drm_dp_mst_helper.h 1912fa91d15SJani Nikula :internal: 1922fa91d15SJani Nikula 1932fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_dp_mst_topology.c 1942fa91d15SJani Nikula :export: 1952fa91d15SJani Nikula 1962fa91d15SJani NikulaMIPI DSI Helper Functions Reference 1972fa91d15SJani Nikula=================================== 1982fa91d15SJani Nikula 1992fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_mipi_dsi.c 2002fa91d15SJani Nikula :doc: dsi helpers 2012fa91d15SJani Nikula 2022fa91d15SJani Nikula.. kernel-doc:: include/drm/drm_mipi_dsi.h 2032fa91d15SJani Nikula :internal: 2042fa91d15SJani Nikula 2052fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_mipi_dsi.c 2062fa91d15SJani Nikula :export: 2072fa91d15SJani Nikula 208bcb32b69SDaniel VetterOutput Probing Helper Functions Reference 209bcb32b69SDaniel Vetter========================================= 210bcb32b69SDaniel Vetter 211bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_probe_helper.c 212bcb32b69SDaniel Vetter :doc: output probing helper overview 213bcb32b69SDaniel Vetter 214bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_probe_helper.c 215bcb32b69SDaniel Vetter :export: 216bcb32b69SDaniel Vetter 2172fa91d15SJani NikulaEDID Helper Functions Reference 2182fa91d15SJani Nikula=============================== 2192fa91d15SJani Nikula 220cdc3d09fSDaniel Vetter.. kernel-doc:: include/drm/drm_edid.h 221cdc3d09fSDaniel Vetter :internal: 222cdc3d09fSDaniel Vetter 2232fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_edid.c 2242fa91d15SJani Nikula :export: 2252fa91d15SJani Nikula 2263ad33ae2SThierry RedingSCDC Helper Functions Reference 2273ad33ae2SThierry Reding=============================== 2283ad33ae2SThierry Reding 2293ad33ae2SThierry Reding.. kernel-doc:: drivers/gpu/drm/drm_scdc_helper.c 2303ad33ae2SThierry Reding :doc: scdc helpers 2313ad33ae2SThierry Reding 2323ad33ae2SThierry Reding.. kernel-doc:: include/drm/drm_scdc_helper.h 2333ad33ae2SThierry Reding :internal: 2343ad33ae2SThierry Reding 2353ad33ae2SThierry Reding.. kernel-doc:: drivers/gpu/drm/drm_scdc_helper.c 2363ad33ae2SThierry Reding :export: 2373ad33ae2SThierry Reding 2382fa91d15SJani NikulaRectangle Utilities Reference 2392fa91d15SJani Nikula============================= 2402fa91d15SJani Nikula 2412fa91d15SJani Nikula.. kernel-doc:: include/drm/drm_rect.h 2422fa91d15SJani Nikula :doc: rect utils 2432fa91d15SJani Nikula 2442fa91d15SJani Nikula.. kernel-doc:: include/drm/drm_rect.h 2452fa91d15SJani Nikula :internal: 2462fa91d15SJani Nikula 2472fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_rect.c 2482fa91d15SJani Nikula :export: 2492fa91d15SJani Nikula 2502fa91d15SJani NikulaHDMI Infoframes Helper Reference 2512fa91d15SJani Nikula================================ 2522fa91d15SJani Nikula 2532fa91d15SJani NikulaStrictly speaking this is not a DRM helper library but generally useable 2542fa91d15SJani Nikulaby any driver interfacing with HDMI outputs like v4l or alsa drivers. 2552fa91d15SJani NikulaBut it nicely fits into the overall topic of mode setting helper 2562fa91d15SJani Nikulalibraries and hence is also included here. 2572fa91d15SJani Nikula 2582fa91d15SJani Nikula.. kernel-doc:: include/linux/hdmi.h 2592fa91d15SJani Nikula :internal: 2602fa91d15SJani Nikula 2612fa91d15SJani Nikula.. kernel-doc:: drivers/video/hdmi.c 2622fa91d15SJani Nikula :export: 2632fa91d15SJani Nikula 264bcb32b69SDaniel VetterFlip-work Helper Reference 265bcb32b69SDaniel Vetter========================== 266bcb32b69SDaniel Vetter 267bcb32b69SDaniel Vetter.. kernel-doc:: include/drm/drm_flip_work.h 268bcb32b69SDaniel Vetter :doc: flip utils 269bcb32b69SDaniel Vetter 270bcb32b69SDaniel Vetter.. kernel-doc:: include/drm/drm_flip_work.h 271bcb32b69SDaniel Vetter :internal: 272bcb32b69SDaniel Vetter 273bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_flip_work.c 274bcb32b69SDaniel Vetter :export: 275bcb32b69SDaniel Vetter 2761de72fafSDaniel VetterAuxiliary Modeset Helpers 2771de72fafSDaniel Vetter========================= 2781de72fafSDaniel Vetter 2791de72fafSDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_modeset_helper.c 2801de72fafSDaniel Vetter :doc: aux kms helpers 2811de72fafSDaniel Vetter 2821de72fafSDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_modeset_helper.c 2831de72fafSDaniel Vetter :export: 2844c3dbb2cSNoralf Trønnes 2854c3dbb2cSNoralf TrønnesFramebuffer GEM Helper Reference 2864c3dbb2cSNoralf Trønnes================================ 2874c3dbb2cSNoralf Trønnes 2884c3dbb2cSNoralf Trønnes.. kernel-doc:: drivers/gpu/drm/drm_gem_framebuffer_helper.c 2894c3dbb2cSNoralf Trønnes :doc: overview 2904c3dbb2cSNoralf Trønnes 2914c3dbb2cSNoralf Trønnes.. kernel-doc:: drivers/gpu/drm/drm_gem_framebuffer_helper.c 2924c3dbb2cSNoralf Trønnes :export: 2935fca5eceSDaniel Vetter 2945fca5eceSDaniel VetterLegacy Plane Helper Reference 2955fca5eceSDaniel Vetter============================= 2965fca5eceSDaniel Vetter 2975fca5eceSDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_plane_helper.c 2985fca5eceSDaniel Vetter :doc: overview 2995fca5eceSDaniel Vetter 3005fca5eceSDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_plane_helper.c 3015fca5eceSDaniel Vetter :export: 3025fca5eceSDaniel Vetter 3035fca5eceSDaniel VetterLegacy CRTC/Modeset Helper Functions Reference 3045fca5eceSDaniel Vetter============================================== 3055fca5eceSDaniel Vetter 3065fca5eceSDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_crtc_helper.c 3075fca5eceSDaniel Vetter :doc: overview 3085fca5eceSDaniel Vetter 3095fca5eceSDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_crtc_helper.c 3105fca5eceSDaniel Vetter :export: 311