include/drm/drm_modeset_helper_vtables.h

75 	 * DRM_MODE_DPMS_OFF if the @disable hook isn't used.
78 	 * also support using this hook for enabling and disabling a CRTC to
90 	 * @dpms hook with DRM_MODE_DPMS_OFF.
93 	 * also support using this hook for disabling a CRTC to facilitate
104 	 * drivers ended up implementing this by calling their @dpms hook with
108 	 * also support using this hook for enabling a CRTC to facilitate
125 	 * This hook is used by the probe helpers to filter the mode list in
224 	 * should not use this hook. This is because the helper library calls
225 	 * this hook only once per mode change and not every time the display
279 	 * &drm_encoder_helper_funcs.disable hook. If that sequence is too
284 	 * This hook is used both by legacy CRTC helpers and atomic helpers.
310 	 * hook. They can also check mode related limitations but need to be
311 	 * aware of the calling order, since this hook is used by
320 	 * When using drm_atomic_helper_check_planes() this hook is called
321 	 * after the &drm_plane_helper_funcs.atomic_check hook for planes, which
363 	 * a CRTC in this hook. Depending upon hardware this might be vblank
367 	 * This hook is called before any plane commit functions are called.
383 	 * a CRTC in this hook. Depending upon hardware this might include
388 	 * flush out all updates for all planes from this hook and forgo all the
391 	 * This hook is called after any plane commit functions are called.
410 	 * hook.  If that sequence is too simple drivers can just add their own
414 	 * This hook is used only by atomic helpers, for symmetry with
432 	 * &drm_encoder_helper_funcs.disable hook. If that sequence is too
437 	 * This hook is used only by atomic helpers. Atomic drivers don't
521 	 * DRM_MODE_DPMS_OFF if the @disable hook isn't used.
524 	 * also support using this hook for enabling and disabling an encoder to
541 	 * This hook is used by the probe helpers to filter the mode list in
575 	 * This hook is optional.
590 	 * this hook isn't called since @atomic_check allows a strict superset
614 	 * @dpms hook with DRM_MODE_DPMS_OFF.
617 	 * also support using this hook for disabling an encoder to facilitate
628 	 * drivers ended up implementing this by calling their @dpms hook with
632 	 * also support using this hook for enabling an encoder to facilitate
646 	 * use this hook, because the helper library calls it only once and not
672 	 * use this hook, because the helper library calls it only once and not
710 	 * using their own &drm_crtc_helper_funcs.atomic_disable hook. If that
719 	 * This hook is only used by atomic helpers. Atomic drivers don't need
733 	 * &drm_crtc_helper_funcs.atomic_enable hook. If that sequence is
742 	 * This hook is only used by atomic helpers, it is the opposite of
756 	 * using their own &drm_crtc_helper_funcs.disable hook.  If that
761 	 * This hook is used both by legacy CRTC helpers and atomic helpers.
789 	 * their own &drm_crtc_helper_funcs.enable hook.  If that sequence is
794 	 * This hook is only used by atomic helpers, it is the opposite of
888 	 * This function is only called after the @detect hook has indicated
1071 	 * This hook is used to validate connector state. This function is
1105 	 * This hook is to be used by drivers implementing writeback connectors
1110 	 * This hook is optional.
1202 	 * This hook is to prepare a framebuffer for scanout by e.g. pinning
1214 	 * For GEM drivers who neither have a @prepare_fb nor @cleanup_fb hook
1218 	 * hook.
1229 	 * successful call to this hook.
1246 	 * This hook is called to clean up any resources allocated for the given
1258 	 * This hook prepares the plane for access during an atomic commit.
1280 	 * This hook cleans up resources allocated by @begin_fb_access. It it called
1288 	 * Drivers should check plane specific constraints in this hook.
1327 	 * hook is called in-between the &drm_crtc_helper_funcs.atomic_begin and
1344 	 * This hook is called in-between the &drm_crtc_helper_funcs.atomic_begin
1369 	 * This hook is called in-between the
1373 	 * the @atomic_disable hook isn't implemented.
1375 	 * This hook is also useful to disable planes in preparation of a modeset,
1377 	 * &drm_crtc_helper_funcs.disable hook.
1397 	 * This hook is called by drm_atomic_async_check() to establish if a
1417 	 * This hook is called by drm_atomic_helper_async_commit().
1440 	 *    we run this hook. For now drivers must implement their own workers
1467 	 * This hook is used by the default atomic_commit() hook implemented in
1475 	 * therefore contains copies of the old/previous state. This hook should
1482 	 * After the atomic update is committed to the hardware this hook needs
1489 	 * When disabling a CRTC this hook _must_ stall for the commit to
1496 	 * This hook is optional, the default implementation is
1504 	 * This hook is used by the default atomic_commit() hook implemented in
1518 	 * This hook is optional.