include/drm/drm_mode_config.h

42  * struct drm_mode_config_funcs - basic driver provided mode setting functions
44  * Some global (i.e. not per-CRTC, connector, etc) mode setting functions that
59 	 * ie. when (@mode_cmd->flags & DRM_MODE_FB_MODIFIERS) == 0.
64 	 * driver-specific information (like the internal native buffer object
106 	 * Except that there's no vtable for device-level helper callbacks
130 	 *  - Checking that the modes, framebuffers, scaling and placement
133 	 *  - Checking that any hidden shared resources are not oversubscribed.
138 	 *  - Checking that virtualized resources exported to userspace are not
141 	 *    example is dual-pipe operations (which generally should be hidden
148 	 *  - Check that any transitional state is possible and that if
152 	 *  - Check any other constraints the driver or hardware might have.
154 	 *  - This callback also needs to correctly fill out the &drm_crtc_state
163 	 *  - The driver also does not need to repeat basic input validation
175 	 * drm_atomic_helper_check(), or one of the exported sub-functions of
182 	 *  - -EINVAL, if any of the above constraints are violated.
184 	 *  - -EDEADLK, when returned from an attempt to acquire an additional
187 	 *  - -ENOMEM, if allocating additional state sub-structures failed due
190 	 *  - -EINTR, -EAGAIN or -ERESTARTSYS, if the IOCTL should be restarted.
196 	int (*atomic_check)(struct drm_device *dev,
211 	 * drm_atomic_helper_commit(), or one of the exported sub-functions of
217 	 * errors resulting in -EIO. But even in that case the driver must
227 	 * buffer is a shared dma-buf. Nonblocking commits must not wait for
231 	 * completed. These events are per-CRTC and can be distinguished by the
250 	 *  - -EBUSY, if a nonblocking updated is requested and there is
257 	 *  - -ENOMEM, if the driver failed to allocate memory. Specifically
261 	 *  - -ENOSPC, as a refinement of the more generic -ENOMEM to indicate
265 	 *  - -EIO, if the hardware completely died.
267 	 *  - -EINTR, -EAGAIN or -ERESTARTSYS, if the IOCTL should be restarted.
274 	 * return -EINVAL (any invalid requests should be caught in
275 	 * @atomic_check) or -EDEADLK (this function must not acquire
278 	int (*atomic_commit)(struct drm_device *dev,
286 	 * &drm_atomic_state to be able to track their own driver-private global
303 	 * passed-in &drm_atomic_state. This hook is called when the caller
337  * struct drm_mode_config - Mode configuration control structure
349  * @prefer_shadow: hint to userspace to prefer shadow-fb rendering
352  * @helper_private: mid-layer private data
364 	 * anything from under its protection and move it into more well-scoped
386 	 * impossible to use driver-private &struct drm_modeset_lock. Users of
403 	 * connector, modes - just makes life easier to have only one.
411 	 * high-res DP MST screens.
418 	int num_fb;
431 	int num_connector;
465 	int num_encoder;
482 	int num_total_plane;
497 	int num_crtc;
509 	 * List of property type objects linked with &drm_property.head. This is
524 	int min_width, min_height;
525 	int max_width, max_height;
538 	 * Mutex for blob property allocation and management, protects
546 	 * List of all the blob property objects linked with
554 	 * @edid_property: Default connector property to hold the EDID of the
559 	 * @dpms_property: Default connector property to control the
564 	 * @path_property: Default connector property to hold the DP MST path
569 	 * @tile_property: Default connector property to store the tile
575 	 * @link_status_property: Default connector property for link status
580 	 * @plane_type_property: Default plane property to differentiate
585 	 * @prop_src_x: Default atomic plane property for the plane source
590 	 * @prop_src_y: Default atomic plane property for the plane source
595 	 * @prop_src_w: Default atomic plane property for the plane source
600 	 * @prop_src_h: Default atomic plane property for the plane source
605 	 * @prop_crtc_x: Default atomic plane property for the plane destination
610 	 * @prop_crtc_y: Default atomic plane property for the plane destination
615 	 * @prop_crtc_w: Default atomic plane property for the plane destination
620 	 * @prop_crtc_h: Default atomic plane property for the plane destination
625 	 * @prop_fb_id: Default atomic plane property to specify the
641 	 * @prop_crtc_id: Default atomic plane property to specify the
646 	 * @prop_fb_damage_clips: Optional plane property to mark damaged
655 	 * @prop_active: Default atomic CRTC property to control the active
661 	 * @prop_mode_id: Default atomic CRTC property to set the mode for a
662 	 * CRTC. A 0 mode implies that the CRTC is entirely disabled - all
667 	 * @prop_vrr_enabled: Default atomic CRTC property to indicate
673 	 * @dvi_i_subconnector_property: Optional DVI-I property to
678 	 * @dvi_i_select_subconnector_property: Optional DVI-I property to
684 	 * @dp_subconnector_property: Optional DP property to differentiate
690 	 * @tv_subconnector_property: Optional TV property to differentiate
695 	 * @tv_select_subconnector_property: Optional TV property to select
700 	 * @tv_mode_property: Optional TV property to select
705 	 * @tv_left_margin_property: Optional TV property to set the left
710 	 * @tv_right_margin_property: Optional TV property to set the right
715 	 * @tv_top_margin_property: Optional TV property to set the right
720 	 * @tv_bottom_margin_property: Optional TV property to set the right
725 	 * @tv_brightness_property: Optional TV property to set the
730 	 * @tv_contrast_property: Optional TV property to set the
735 	 * @tv_flicker_reduction_property: Optional TV property to control the
740 	 * @tv_overscan_property: Optional TV property to control the overscan
745 	 * @tv_saturation_property: Optional TV property to set the
750 	 * @tv_hue_property: Optional TV property to set the hue.
755 	 * @scaling_mode_property: Optional connector property to control the
756 	 * upscaling, mostly used for built-in panels.
760 	 * @aspect_ratio_property: Optional connector property to control the
765 	 * @content_type_property: Optional connector property to control the
770 	 * @degamma_lut_property: Optional CRTC property to set the LUT used to
775 	 * @degamma_lut_size_property: Optional CRTC property for the size of
776 	 * the degamma LUT as supported by the driver (read-only).
780 	 * @ctm_property: Optional CRTC property to set the
786 	 * @gamma_lut_property: Optional CRTC property to set the LUT used to
792 	 * @gamma_lut_size_property: Optional CRTC property for the size of the
793 	 * gamma LUT as supported by the driver (read-only).
798 	 * @suggested_x_property: Optional connector property with a hint for
803 	 * @suggested_y_property: Optional connector property with a hint for
809 	 * @non_desktop_property: Optional connector property with a hint
816 	 * @panel_orientation_property: Optional connector property indicating
817 	 * how the lcd-panel is mounted inside the casing (e.g. normal or
818 	 * upside-down).
823 	 * @writeback_fb_id_property: Property for writeback connectors, storing
830 	 * @writeback_pixel_formats_property: Property for writeback connectors,
832 	 * engine (read-only).
837 	 * @writeback_out_fence_ptr_property: Property for writeback connectors,
846 	 * @hdr_output_metadata_property: Connector property containing hdr
853 	 * @content_protection_property: DRM ENUM property for content
859 	 * @hdcp_content_type_property: DRM ENUM property for type of
870 	 * Hint to framebuffer emulation to prefer shadow-fb rendering.
881 	 * FIXME: This should be replaced with a per-mapping is_iomem
904 	 * opt-in.
930 	 * @modifiers_property: Plane property to list support modifier/format
950 int __must_check drmm_mode_config_init(struct drm_device *dev);
953  * drm_mode_config_init - DRM mode_configuration structure initialization
962 static inline int drm_mode_config_init(struct drm_device *dev)  in drm_mode_config_init()