Lines Matching full:this
11 * copy of this software and associated documentation files (the "Software"),
17 * The above copyright notice and this permission notice shall be included in
39 * they wish. Drivers are not forced to use this code in their
48 * To make this clear all the helper vtables are pulled together in this location here.
67 * This is used by the legacy CRTC helpers to implement DPMS
70 * This callback is also used to disable a CRTC by calling it with
73 * This callback is used by the legacy CRTC helpers. Atomic helpers
74 * also support using this hook for enabling and disabling a CRTC to
83 * This callback should prepare the CRTC for a subsequent modeset, which
85 * running. Most drivers ended up implementing this by calling their
88 * This callback is used by the legacy CRTC helpers. Atomic helpers
89 * also support using this hook for disabling a CRTC to facilitate
98 * This callback should commit the new mode on the CRTC after a modeset,
100 * drivers ended up implementing this by calling their @dpms hook with
103 * This callback is used by the legacy CRTC helpers. Atomic helpers
104 * also support using this hook for enabling a CRTC to facilitate
113 * This callback is used to check if a specific mode is valid in this
114 * crtc. This should be implemented if the crtc has some sort of
117 * produce all the values for the available modes then this callback
121 * This hook is used by the probe helpers to filter the mode list in
126 * This function is optional.
130 * Since this function is both called from the check phase of an atomic
147 * This callback is used to validate a mode. The parameter mode is the
149 * encoders need to be fed with. Note that this is the inverse semantics
155 * This function is used by both legacy CRTC helpers and atomic helpers.
160 * This function is called in the check phase of atomic modesets, which
166 * This is in contrast to the legacy CRTC helpers where this was
194 * This callback is used by the legacy CRTC helpers to set a new mode,
200 * This callback is only used by CRTC helpers and deprecated.
213 * This callback is used to update the display mode of a CRTC without
214 * changing anything of the primary plane configuration. This fits the
219 * Note that the display pipe is completely off when this function is
222 * should not use this hook. This is because the helper library calls
223 * this hook only once per mode change and not every time the display
225 * Which means register values set in this callback might get reset when
229 * This callback is optional.
236 * This callback is used by the legacy CRTC helpers to set a new
244 * This callback is only used by the CRTC helpers and deprecated.
256 * This callback is used by the fbdev helpers to set a new framebuffer
260 * This callback is optional and only needed for kgdb support in the fbdev
274 * This callback should be used to disable the CRTC. With the atomic
275 * drivers it is called after all encoders connected to this CRTC have
278 * simple drivers can just add their own hooks and call it from this
282 * This hook is used both by legacy CRTC helpers and atomic helpers.
288 * this one.
307 * Drivers should check plane-update related CRTC constraints in this
309 * aware of the calling order, since this hook is used by
313 * check output routing and display mode constraints in this callback
315 * beforehand. This is calling order used by the default helper
318 * When using drm_atomic_helper_check_planes() this hook is called
320 * allows drivers to assign shared resources requested by planes in this
325 * This function is also allowed to inspect any other object's state and
332 * This callback is used by the atomic modeset helpers and by the
337 * This function is called in the check phase of an atomic update. The
362 * a CRTC in this hook. Depending upon hardware this might be vblank
366 * This hook is called before any plane commit functions are called.
368 * Note that the power state of the display pipe when this function is
373 * This callback is used by the atomic modeset helpers and by the
382 * a CRTC in this hook. Depending upon hardware this might include
387 * flush out all updates for all planes from this hook and forgo all the
390 * This hook is called after any plane commit functions are called.
392 * Note that the power state of the display pipe when this function is
397 * This callback is used by the atomic modeset helpers and by the
406 * This callback should be used to enable the CRTC. With the atomic
407 * drivers it is called before all encoders connected to this CRTC are
410 * hooks and call it from this CRTC callback here by looping over all
413 * This hook is used only by atomic helpers, for symmetry with
424 * This function is optional.
432 * This callback should be used to disable the CRTC. With the atomic
433 * drivers it is called after all encoders connected to this CRTC have
436 * simple drivers can just add their own hooks and call it from this
440 * This hook is used only by atomic helpers. Atomic drivers don't
444 * Comparing to @disable, this one provides the additional input
446 * state. Atomic drivers should consider to use this one instead
449 * This function is optional.
461 * measured. Note that this is a helper callback which is only used
525 * This is used by the legacy encoder helpers to implement DPMS
528 * This callback is also used to disable an encoder by calling it with
531 * This callback is used by the legacy CRTC helpers. Atomic helpers
532 * also support using this hook for enabling and disabling an encoder to
541 * This callback is used to check if a specific mode is valid in this
542 * encoder. This should be implemented if the encoder has some sort
545 * not produce all the values for the available modes then this callback
549 * This hook is used by the probe helpers to filter the mode list in
554 * This function is optional.
558 * Since this function is both called from the check phase of an atomic
575 * This callback is used to validate and adjust a mode. The parameter
579 * can be modified by this callback and does not need to match mode. See
582 * This function is used by both legacy CRTC helpers and atomic helpers.
583 * This hook is optional.
587 * This function is called in the check phase of atomic modesets, which
593 * This is in contrast to the legacy CRTC helpers where this was
598 * this hook isn't called since @atomic_check allows a strict superset
619 * This callback should prepare the encoder for a subsequent modeset,
621 * is running. Most drivers ended up implementing this by calling their
624 * This callback is used by the legacy CRTC helpers. Atomic helpers
625 * also support using this hook for disabling an encoder to facilitate
634 * This callback should commit the new mode on the encoder after a modeset,
636 * drivers ended up implementing this by calling their @dpms hook with
639 * This callback is used by the legacy CRTC helpers. Atomic helpers
640 * also support using this hook for enabling an encoder to facilitate
649 * This callback is used to update the display mode of an encoder.
651 * Note that the display pipe is completely off when this function is
654 * use this hook, because the helper library calls it only once and not
659 * This callback is used both by the legacy CRTC helpers and the atomic
675 * This callback is used to update the display mode of an encoder.
677 * Note that the display pipe is completely off when this function is
680 * use this hook, because the helper library calls it only once and not
685 * This callback is used by the atomic modeset helpers in place of the
698 * This callback can be used by drivers who want to do detection on the
702 * semantics. New drivers shouldn't use this and instead just implement
707 * This should just be converted into a pile of driver vfuncs.
716 * This callback should be used to disable the encoder. With the atomic
717 * drivers it is called before this encoder's CRTC has been shut off
723 * This callback is a variant of @disable that provides the atomic state
727 * This hook is only used by atomic helpers. Atomic drivers don't need
739 * This callback should be used to enable the encoder. It is called
740 * after this encoder's CRTC has been enabled using their own
746 * This callback is a variant of @enable that provides the atomic state
750 * This hook is only used by atomic helpers, it is the opposite of
762 * This callback should be used to disable the encoder. With the atomic
763 * drivers it is called before this encoder's CRTC has been shut off
769 * This hook is used both by legacy CRTC helpers and atomic helpers.
795 * This callback should be used to enable the encoder. With the atomic
796 * drivers it is called after this encoder's CRTC has been enabled using
802 * This hook is only used by atomic helpers, it is the opposite of
813 * This callback is used to validate encoder state for atomic drivers.
819 * Since this provides a strict superset of the functionality of
824 * This function is used by the atomic helpers, but it is optional.
828 * This function is called in the check phase of an atomic update. The
872 * This function should fill in all modes currently valid for the sink
876 * The usual way to implement this is to cache the EDID retrieved in the
878 * In this function drivers then parse the modes in the EDID and add
890 * This function is only called after the @detect hook has indicated
894 * This callback is used by the probe helpers in e.g.
898 * libraries always call this with the &drm_mode_config.connection_mutex
899 * held. Because of this it's safe to inspect &drm_connector->state.
915 * This callback is optional, if not implemented the connector will be
918 * This is the atomic version of &drm_connector_funcs.detect.
921 * helper libraries always call this with ctx set to a valid context,
923 * the ctx parameter set to this ctx. This allows taking additional
941 * This callback is used by the probe helpers to filter the mode list
945 * This function is optional.
949 * This only filters the mode list supplied to userspace in the
953 * drm_atomic_helper_check_modeset(). This allows userspace to force and
958 * and not this one here.
961 * libraries always call this with the &drm_mode_config.connection_mutex
962 * held. Because of this it's safe to inspect &drm_connector->state.
978 * This callback is used by the probe helpers to filter the mode list
982 * This function is optional, and is the atomic version of
986 * helper libraries always call this with ctx set to a valid context,
988 * the ctx parameter set to @ctx. This allows for taking additional
991 * Even though additional locks may be acquired, this callback is
999 * connectors into account, as this would change depending on the
1016 * This function should select the best encoder for the given connector.
1018 * This function is used by both the atomic helpers (in the
1024 * In atomic drivers this function is called in the check phase of an
1030 * You can leave this function to NULL if the connector is only
1031 * attached to a single encoder. In this case, the core will call
1039 * for this.
1046 * This is the atomic version of @best_encoder for atomic drivers which
1050 * This function is used by drm_atomic_helper_check_modeset().
1056 * This function is called in the check phase of an atomic update. The
1066 * for this.
1074 * This hook is used to validate connector state. This function is
1079 * this function should handle being called multiple times as well.
1081 * This function is also allowed to inspect any other object's state and
1090 * This function is called in the check phase of an atomic update. The
1108 * This hook is to be used by drivers implementing writeback connectors
1113 * This hook is optional.
1115 * This callback is used by the atomic modeset helpers.
1125 * clean up framebuffers for planes. This optional connector operation
1130 * This operation is optional.
1132 * This callback is used by the atomic modeset helpers.
1139 * This optional connector operation is used to support the
1145 * This operation is optional.
1147 * This callback is used by the atomic modeset helpers.
1174 * This hook is to prepare a framebuffer for scanout by e.g. pinning
1178 * This function must not block for outstanding rendering, since it is
1187 * drm_gem_fb_prepare_fb() for this hook.
1190 * successful call to this hook.
1192 * This callback is used by the atomic modeset helpers and by the
1199 * this callback is the only one which can fail an atomic commit,
1207 * This hook is called to clean up any resources allocated for the given
1210 * This callback is used by the atomic modeset helpers and by the
1219 * Drivers should check plane specific constraints in this hook.
1228 * This function is also allowed to inspect any other object's state and
1235 * This callback is used by the atomic modeset helpers and by the
1240 * This function is called in the check phase of an atomic update. The
1258 * Drivers should use this function to update the plane state. This
1262 * Note that the power state of the display pipe when this function is
1267 * This callback is used by the atomic modeset helpers and by the
1275 * Drivers should use this function to unconditionally disable a plane.
1276 * This hook is called in-between the
1282 * This hook is also useful to disable planes in preparation of a modeset,
1286 * Note that the power state of the display pipe when this function is
1291 * This callback is used by the atomic modeset helpers and by the
1300 * Drivers should set this function pointer to check if the plane state
1304 * This hook is called by drm_atomic_async_check() to establish if a
1319 * Drivers should set this function pointer to perform asynchronous
1324 * This hook is called by drm_atomic_helper_async_commit().
1330 * Note that unlike &drm_plane_helper_funcs.atomic_update this hook
1338 * This is required since cleanup for async commits is performed on
1349 * we run this hook. For now drivers must implement their own workers
1376 * This hook is used by the default atomic_commit() hook implemented in
1382 * This function is called when the new atomic state has already been
1384 * therefore contains copies of the old/previous state. This hook should
1391 * After the atomic update is committed to the hardware this hook needs
1398 * When disabling a CRTC this hook _must_ stall for the commit to
1400 * can't take care of this. And it also can't rely on the vblank event,
1405 * This hook is optional, the default implementation is