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 452fa91d15SJani NikulaAtomic Modeset Helper Functions Reference 462fa91d15SJani Nikula========================================= 472fa91d15SJani Nikula 482fa91d15SJani NikulaOverview 492fa91d15SJani Nikula-------- 502fa91d15SJani Nikula 512fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_atomic_helper.c 522fa91d15SJani Nikula :doc: overview 532fa91d15SJani Nikula 542fa91d15SJani NikulaImplementing Asynchronous Atomic Commit 552fa91d15SJani Nikula--------------------------------------- 562fa91d15SJani Nikula 572fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_atomic_helper.c 582fa91d15SJani Nikula :doc: implementing nonblocking commit 592fa91d15SJani Nikula 602fa91d15SJani NikulaAtomic State Reset and Initialization 612fa91d15SJani Nikula------------------------------------- 622fa91d15SJani Nikula 632fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_atomic_helper.c 642fa91d15SJani Nikula :doc: atomic state reset and initialization 652fa91d15SJani Nikula 661ea0c02eSDaniel VetterHelper Functions Reference 671ea0c02eSDaniel Vetter-------------------------- 681ea0c02eSDaniel Vetter 692fa91d15SJani Nikula.. kernel-doc:: include/drm/drm_atomic_helper.h 702fa91d15SJani Nikula :internal: 712fa91d15SJani Nikula 722fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_atomic_helper.c 732fa91d15SJani Nikula :export: 742fa91d15SJani Nikula 752fa91d15SJani NikulaLegacy CRTC/Modeset Helper Functions Reference 762fa91d15SJani Nikula============================================== 772fa91d15SJani Nikula 782fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_crtc_helper.c 792fa91d15SJani Nikula :doc: overview 802fa91d15SJani Nikula 81bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_crtc_helper.c 822fa91d15SJani Nikula :export: 832fa91d15SJani Nikula 84bcb32b69SDaniel VetterSimple KMS Helper Reference 85bcb32b69SDaniel Vetter=========================== 86bcb32b69SDaniel Vetter 871ea35768SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_simple_kms_helper.c 881ea35768SDaniel Vetter :doc: overview 891ea35768SDaniel Vetter 90bcb32b69SDaniel Vetter.. kernel-doc:: include/drm/drm_simple_kms_helper.h 91bcb32b69SDaniel Vetter :internal: 92bcb32b69SDaniel Vetter 93bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_simple_kms_helper.c 94bcb32b69SDaniel Vetter :export: 95bcb32b69SDaniel Vetter 962fa91d15SJani Nikulafbdev Helper Functions Reference 972fa91d15SJani Nikula================================ 982fa91d15SJani Nikula 992fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_fb_helper.c 1002fa91d15SJani Nikula :doc: fbdev helpers 1012fa91d15SJani Nikula 1022fa91d15SJani Nikula.. kernel-doc:: include/drm/drm_fb_helper.h 1032fa91d15SJani Nikula :internal: 1042fa91d15SJani Nikula 1051ea35768SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_fb_helper.c 1061ea35768SDaniel Vetter :export: 1071ea35768SDaniel Vetter 1082fa91d15SJani NikulaFramebuffer CMA Helper Functions Reference 1092fa91d15SJani Nikula========================================== 1102fa91d15SJani Nikula 1112fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_fb_cma_helper.c 1122fa91d15SJani Nikula :doc: framebuffer cma helper functions 1132fa91d15SJani Nikula 1142fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_fb_cma_helper.c 1152fa91d15SJani Nikula :export: 1162fa91d15SJani Nikula 1172564d0b0SDaniel Vetter.. _drm_bridges: 1182564d0b0SDaniel Vetter 119bcb32b69SDaniel VetterBridges 120bcb32b69SDaniel Vetter======= 121bcb32b69SDaniel Vetter 122bcb32b69SDaniel VetterOverview 123bcb32b69SDaniel Vetter-------- 124bcb32b69SDaniel Vetter 125bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_bridge.c 126bcb32b69SDaniel Vetter :doc: overview 127bcb32b69SDaniel Vetter 128bcb32b69SDaniel VetterDefault bridge callback sequence 129bcb32b69SDaniel Vetter-------------------------------- 130bcb32b69SDaniel Vetter 131bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_bridge.c 132bcb32b69SDaniel Vetter :doc: bridge callbacks 133bcb32b69SDaniel Vetter 134199e4e96SDaniel Vetter 135199e4e96SDaniel VetterBridge Helper Reference 136199e4e96SDaniel Vetter------------------------- 137199e4e96SDaniel Vetter 138199e4e96SDaniel Vetter.. kernel-doc:: include/drm/drm_bridge.h 139199e4e96SDaniel Vetter :internal: 140199e4e96SDaniel Vetter 141bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_bridge.c 142bcb32b69SDaniel Vetter :export: 143bcb32b69SDaniel Vetter 1442564d0b0SDaniel Vetter.. _drm_panel_helper: 1452564d0b0SDaniel Vetter 146bcb32b69SDaniel VetterPanel Helper Reference 147bcb32b69SDaniel Vetter====================== 148bcb32b69SDaniel Vetter 1491ea35768SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_panel.c 1501ea35768SDaniel Vetter :doc: drm panel 1511ea35768SDaniel Vetter 152bcb32b69SDaniel Vetter.. kernel-doc:: include/drm/drm_panel.h 153bcb32b69SDaniel Vetter :internal: 154bcb32b69SDaniel Vetter 155bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_panel.c 156bcb32b69SDaniel Vetter :export: 157bcb32b69SDaniel Vetter 1582fa91d15SJani NikulaDisplay Port Helper Functions Reference 1592fa91d15SJani Nikula======================================= 1602fa91d15SJani Nikula 1612fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_dp_helper.c 1622fa91d15SJani Nikula :doc: dp helpers 1632fa91d15SJani Nikula 1642fa91d15SJani Nikula.. kernel-doc:: include/drm/drm_dp_helper.h 1652fa91d15SJani Nikula :internal: 1662fa91d15SJani Nikula 1672fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_dp_helper.c 1682fa91d15SJani Nikula :export: 1692fa91d15SJani Nikula 1702fa91d15SJani NikulaDisplay Port Dual Mode Adaptor Helper Functions Reference 1712fa91d15SJani Nikula========================================================= 1722fa91d15SJani Nikula 1732fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_dp_dual_mode_helper.c 1742fa91d15SJani Nikula :doc: dp dual mode helpers 1752fa91d15SJani Nikula 1762fa91d15SJani Nikula.. kernel-doc:: include/drm/drm_dp_dual_mode_helper.h 1772fa91d15SJani Nikula :internal: 1782fa91d15SJani Nikula 1792fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_dp_dual_mode_helper.c 1802fa91d15SJani Nikula :export: 1812fa91d15SJani Nikula 1822fa91d15SJani NikulaDisplay Port MST Helper Functions Reference 1832fa91d15SJani Nikula=========================================== 1842fa91d15SJani Nikula 1852fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_dp_mst_topology.c 1862fa91d15SJani Nikula :doc: dp mst helper 1872fa91d15SJani Nikula 1882fa91d15SJani Nikula.. kernel-doc:: include/drm/drm_dp_mst_helper.h 1892fa91d15SJani Nikula :internal: 1902fa91d15SJani Nikula 1912fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_dp_mst_topology.c 1922fa91d15SJani Nikula :export: 1932fa91d15SJani Nikula 1942fa91d15SJani NikulaMIPI DSI Helper Functions Reference 1952fa91d15SJani Nikula=================================== 1962fa91d15SJani Nikula 1972fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_mipi_dsi.c 1982fa91d15SJani Nikula :doc: dsi helpers 1992fa91d15SJani Nikula 2002fa91d15SJani Nikula.. kernel-doc:: include/drm/drm_mipi_dsi.h 2012fa91d15SJani Nikula :internal: 2022fa91d15SJani Nikula 2032fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_mipi_dsi.c 2042fa91d15SJani Nikula :export: 2052fa91d15SJani Nikula 206bcb32b69SDaniel VetterOutput Probing Helper Functions Reference 207bcb32b69SDaniel Vetter========================================= 208bcb32b69SDaniel Vetter 209bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_probe_helper.c 210bcb32b69SDaniel Vetter :doc: output probing helper overview 211bcb32b69SDaniel Vetter 212bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_probe_helper.c 213bcb32b69SDaniel Vetter :export: 214bcb32b69SDaniel Vetter 2152fa91d15SJani NikulaEDID Helper Functions Reference 2162fa91d15SJani Nikula=============================== 2172fa91d15SJani Nikula 218cdc3d09fSDaniel Vetter.. kernel-doc:: include/drm/drm_edid.h 219cdc3d09fSDaniel Vetter :internal: 220cdc3d09fSDaniel Vetter 2212fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_edid.c 2222fa91d15SJani Nikula :export: 2232fa91d15SJani Nikula 2242fa91d15SJani NikulaRectangle Utilities Reference 2252fa91d15SJani Nikula============================= 2262fa91d15SJani Nikula 2272fa91d15SJani Nikula.. kernel-doc:: include/drm/drm_rect.h 2282fa91d15SJani Nikula :doc: rect utils 2292fa91d15SJani Nikula 2302fa91d15SJani Nikula.. kernel-doc:: include/drm/drm_rect.h 2312fa91d15SJani Nikula :internal: 2322fa91d15SJani Nikula 2332fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_rect.c 2342fa91d15SJani Nikula :export: 2352fa91d15SJani Nikula 2362fa91d15SJani NikulaHDMI Infoframes Helper Reference 2372fa91d15SJani Nikula================================ 2382fa91d15SJani Nikula 2392fa91d15SJani NikulaStrictly speaking this is not a DRM helper library but generally useable 2402fa91d15SJani Nikulaby any driver interfacing with HDMI outputs like v4l or alsa drivers. 2412fa91d15SJani NikulaBut it nicely fits into the overall topic of mode setting helper 2422fa91d15SJani Nikulalibraries and hence is also included here. 2432fa91d15SJani Nikula 2442fa91d15SJani Nikula.. kernel-doc:: include/linux/hdmi.h 2452fa91d15SJani Nikula :internal: 2462fa91d15SJani Nikula 2472fa91d15SJani Nikula.. kernel-doc:: drivers/video/hdmi.c 2482fa91d15SJani Nikula :export: 2492fa91d15SJani Nikula 250bcb32b69SDaniel VetterFlip-work Helper Reference 251bcb32b69SDaniel Vetter========================== 252bcb32b69SDaniel Vetter 253bcb32b69SDaniel Vetter.. kernel-doc:: include/drm/drm_flip_work.h 254bcb32b69SDaniel Vetter :doc: flip utils 255bcb32b69SDaniel Vetter 256bcb32b69SDaniel Vetter.. kernel-doc:: include/drm/drm_flip_work.h 257bcb32b69SDaniel Vetter :internal: 258bcb32b69SDaniel Vetter 259bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_flip_work.c 260bcb32b69SDaniel Vetter :export: 261bcb32b69SDaniel Vetter 2622fa91d15SJani NikulaPlane Helper Reference 2632fa91d15SJani Nikula====================== 2642fa91d15SJani Nikula 2652fa91d15SJani Nikula.. kernel-doc:: drivers/gpu/drm/drm_plane_helper.c 2662fa91d15SJani Nikula :doc: overview 2672fa91d15SJani Nikula 268bcb32b69SDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_plane_helper.c 269bcb32b69SDaniel Vetter :export: 270bcb32b69SDaniel Vetter 2711de72fafSDaniel VetterAuxiliary Modeset Helpers 2721de72fafSDaniel Vetter========================= 2731de72fafSDaniel Vetter 2741de72fafSDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_modeset_helper.c 2751de72fafSDaniel Vetter :doc: aux kms helpers 2761de72fafSDaniel Vetter 2771de72fafSDaniel Vetter.. kernel-doc:: drivers/gpu/drm/drm_modeset_helper.c 2781de72fafSDaniel Vetter :export: 279