include/drm/drm_modeset_helper_vtables.h

3  * Copyright © 2007-2008 Dave Airlie
4  * Copyright © 2007-2008 Intel Corporation
6  * Copyright © 2011-2013 Intel Corporation
60  * struct drm_crtc_helper_funcs - helper operations for CRTCs
134 	 * Since this function is both called from the check phase of an atomic
136 	 * to look at anything else but the passed-in mode, and validate it
137 	 * against configuration-invariant hardware constraints. Any further
164 	 * This function is called in the check phase of atomic modesets, which
208 	 * 0 on success or a negative error code on failure.
240 	 * optimized fast-path instead of a full mode set operation with all the
250 	 * 0 on success or a negative error code on failure.
267 	 * 0 on success or a negative error code on failure.
309 	 * Drivers should check plane-update related CRTC constraints in this
339 	 * This function is called in the check phase of an atomic update. The
340 	 * driver is not allowed to change anything outside of the free-standing
341 	 * state object passed-in.
351 	 * 0 on success, -EINVAL if the state or the transition can't be
352 	 * supported, -ENOMEM on memory allocation failure and -EDEADLK if an
463 	 *     need to apply some workarounds for gpu-specific vblank irq
479 	 * Returns vpos as a negative number inside vblank, counting the number
480 	 * of scanlines to go until end of vblank, e.g., -1 means "one scanline
495  * drm_crtc_helper_add - sets the helper vtable for a crtc
502 	crtc->helper_private = funcs;  in drm_crtc_helper_add()
506  * struct drm_encoder_helper_funcs - helper operations for encoders
550 	 * Since this function is both called from the check phase of an atomic
552 	 * to look at anything else but the passed-in mode, and validate it
553 	 * against configuration-invariant hardware constraints. Any further
579 	 * This function is called in the check phase of atomic modesets, which
693 	 * It is not used by any helper and therefore has purely driver-specific
820 	 * This function is called in the check phase of an atomic update. The
821 	 * driver is not allowed to change anything outside of the free-standing
822 	 * state objects passed-in or assembled in the overall &drm_atomic_state
833 	 * 0 on success, -EINVAL if the state or the transition can't be
834 	 * supported, -ENOMEM on memory allocation failure and -EDEADLK if an
844  * drm_encoder_helper_add - sets the helper vtable for an encoder
851 	encoder->helper_private = funcs;  in drm_encoder_helper_add()
855  * struct drm_connector_helper_funcs - helper operations for connectors
869 	 * probe callback somewhere in the driver-private connector structure.
897 	 * held. Because of this it's safe to inspect &drm_connector->state.
927 	 * or the error code returned by drm_modeset_lock(), -EDEADLK.
960 	 * held. Because of this it's safe to inspect &drm_connector->state.
991 	 * be influenced by the currently set display state - such constraints
1002 	 * the &enum drm_mode_status value to @status, or a negative error
1022 	 * In atomic drivers this function is called in the check phase of an
1024 	 * anything outside of arguments passed-in. Atomic drivers which need to
1054 	 * This function is called in the check phase of an atomic update. The
1087 	 * This function is called in the check phase of an atomic update. The
1088 	 * driver is not allowed to change anything outside of the free-standing
1089 	 * state objects passed-in or assembled in the overall &drm_atomic_state
1094 	 * 0 on success, -EINVAL if the state or the transition can't be
1095 	 * supported, -ENOMEM on memory allocation failure and -EDEADLK if an
1152 	 * Enable hot-plug detection for the connector.
1168 	 * Disable hot-plug detection for the connector.
1183  * drm_connector_helper_add - sets the helper vtable for a connector
1190 	connector->helper_private = funcs;  in drm_connector_helper_add()
1194  * struct drm_plane_helper_funcs - helper operations for planes
1209 	 * way is to fill out the &drm_plane_state.fence of the passed-in
1225 	 * shadow-plane helpers belongs into @begin_fb_access, so that atomic
1232 	 * optional. See @begin_fb_access for preparing per-commit resources.
1236 	 * 0 on success or one of the following negative error codes allowed by
1262 	 * For example, with shadow-plane helpers, the GEM buffer's vmap
1273 	 * 0 on success, or a negative errno code otherwise.
1309 	 * This function is called in the check phase of an atomic update. The
1315 	 * 0 on success, -EINVAL if the state or the transition can't be
1316 	 * supported, -ENOMEM on memory allocation failure and -EDEADLK if an
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
1436 	 *  - It only works for single plane updates
1437 	 *  - Async Pageflips are not supported yet
1438 	 *  - Some hw might still scan out the old buffer until the next
1448  * drm_plane_helper_add - sets the helper vtable for a plane
1455 	plane->helper_private = funcs;  in drm_plane_helper_add()
1459  * struct drm_mode_config_helper_funcs - global modeset helper operations
1479 	 * to wait for driver-internal request for implicit syncing, before