include/drm/drm_connector.h

54 	DRM_FORCE_ON_DIGITAL, /* for DVI-I use digital connector */
58  * enum drm_connector_status - status for a &drm_connector
73 	 * nothing there. It is driver-dependent whether a connector with this
80 	 * flicker (like load-detection when the connector is in use), or when a
81 	 * hardware resource isn't available (like when load-detection needs a
91  * enum drm_connector_registration_state - userspace registration status for
124 	 * - An unregistered connector may only have its DPMS changed from
125 	 *   On->Off. Once DPMS is changed to Off, it may not be switched back
127 	 * - Modesets are not allowed on unregistered connectors, unless they
131 	 * - Removing a CRTC from an unregistered connector is OK, but new
148  * enum drm_connector_tv_mode - Analog TV output mode
154  * "TV mode" connector property.
158 	 * @DRM_MODE_TV_MODE_NTSC: CCIR System M (aka 525-lines)
184 	 * @DRM_MODE_TV_MODE_PAL_M: CCIR System M (aka 525-lines)
218 	bool supported;
222 	bool low_rates;
226  * struct drm_scdc - Information about scdc capabilities of a HDMI 2.0 sink
235 	bool supported;
239 	bool read_request;
247  * struct drm_hdmi_dsc_cap - DSC capabilities of HDMI sink
255 	bool v_1p2;
258 	bool native_420;
264 	bool all_bpp;
288  * struct drm_hdmi_info - runtime information about the connected HDMI sink
291  * This information is available in CEA-861-F extension blocks (like HF-VSDB).
300 	 * defined by the CEA-861-G spec is 219, so the size is 256 bits to map
308 	 * the CEA-861-G spec is 219, so the size is 256 bits to map up to 256
327  * enum drm_link_status - connector's link_status property value
329  * This enum is used as the connector's link status property value.
343  * enum drm_panel_orientation - panel_orientation info for &drm_display_info
357  *					the panel is mounted upside-down.
364 	DRM_MODE_PANEL_ORIENTATION_UNKNOWN = -1,
372  * struct drm_monitor_range_info - Panel's Monitor range in EDID for
389  * struct drm_luminance_range_info - Panel's luminance range for
405  * enum drm_privacy_screen_status - privacy screen status
408  * screen present on some display panels, via the "privacy-screen sw-state"
409  * and "privacy-screen hw-state" properties. Note the _LOCKED enum values
410  * are only valid for the "privacy-screen hw-state" property.
413  *  The privacy-screen on the panel is disabled
415  *  The privacy-screen on the panel is enabled
417  *  The privacy-screen on the panel is disabled and locked (cannot be changed)
419  *  The privacy-screen on the panel is enabled and locked (cannot be changed)
429  * enum drm_colorspace - color space
433  * a property with the subset of this list (supported by that
435  * a colorspace property which will be created and exposed to
439  * HDMI definitions come from the CTA-861-H spec
458  *   ITU-R BT.709 colorimetry format
476  *   ITU-R BT.2020 Y'c C'bc C'rc (constant luminance) colorimetry format
479  *   ITU-R BT.2020 R' G' B' colorimetry format
482  *   ITU-R BT.2020 Y' C'b C'r colorimetry format
495  *   (scRGB (IEC 61966-2-2)) colorimetry format
498  *   ITU-R BT.601 colorimetry format
530  * enum drm_bus_flags - bus_flags info for &drm_display_info
635 	 *  Set if the Sharp-specific signals (SPL, CLS, PS, REV) must be used
641  * struct drm_display_info - runtime data about the connected sink
644  * fixed display sinks like built-in panels there's not much difference between
678 	 * @panel_orientation: Read only connector property for built-in panels,
719 	 * @dvi_dual: Dual-link DVI sink?
721 	bool dvi_dual;
729 	bool is_hdmi;
737 	bool has_audio;
742 	bool has_hdmi_infoframe;
748 	bool rgb_quant_range_selectable;
775 	bool non_desktop;
788 	 * @mso_stream_count: eDP Multi-SST Operation (MSO) stream count from
789 	 * the DisplayID VESA vendor block. 0 for conventional Single-Stream
795 	 * @mso_pixel_overlap: eDP MSO segment pixel overlap, 0-8 pixels.
826  * struct drm_connector_tv_margins - TV connector related margins
854  * struct drm_tv_connector_state - TV connector related states
882  * struct drm_connector_state - mutable connector state
924 	 * @commit: Tracks the pending commit to prevent use-after-free conditions.
945 	bool self_refresh_aware;
948 	 * @picture_aspect_ratio: Connector property to control the
957 	 * @content_type: Connector property to control the
965 	 * @hdcp_content_type: Connector property to pass the type of
971 	 * @scaling_mode: Connector property to control the
972 	 * upscaling, mostly used for built-in panels.
977 	 * @content_protection: Connector property to request content
983 	 * @colorspace: State variable for Connector property to request
992 	 * Holds the framebuffer and out-fence for a writeback connector. As
1003 	 * @max_requested_bpc: Connector property to limit the maximum bit
1009 	 * @max_bpc: Connector max_bpc based on the requested max_bpc property
1022 	 * DRM blob property for HDR output metadata
1028  * struct drm_connector_funcs - control connectors on a given device
1038 	 * Legacy entry point to set the per-connector DPMS state. Legacy DPMS
1039 	 * is exposed as a standard property on the connector, but diverted to
1042 	 * instead only have an on/off "ACTIVE" property on the CRTC object.
1045 	 * property is entirely handled in the DRM core.
1097 					    bool force);
1128 	 * received for this output connector->edid must be NULL.
1143 	 * This is the legacy entry point to update a property attached to the
1147 	 * driver-private properties. For atomic drivers it is not used because
1148 	 * property handling is done entirely in the DRM core.
1154 	int (*set_property)(struct drm_connector *connector, struct drm_property *property,
1193 	 * when a connector is being hot-unplugged for drivers that support
1212 	 * state structure to extend it with driver-private state should use
1245 	 * Decode a driver-private property value and store the decoded value
1246 	 * into the passed-in state structure. Since the atomic core decodes all
1251 	 * Such driver-private properties should really only be implemented for
1260 	 * driver-private atomic properties.
1277 	 * 0 if the property has been found, -EINVAL if the property isn't
1280 	 * is allowed by the driver. The core already checks that the property
1282 	 * set when registering the property.
1286 				   struct drm_property *property,
1292 	 * Reads out the decoded driver-private property. This is used to
1299 	 * driver-private atomic properties.
1303 	 * 0 on success, -EINVAL if the property isn't implemented by the
1309 				   struct drm_property *property,
1327 	 * This will get called when a hotplug-event for a drm-connector
1335 	 * Allows connectors to create connector-specific debugfs files.
1341  * struct drm_cmdline_mode - DRM Mode passed through the kernel command-line
1345  * express those parameters and will be filled by the command-line
1359 	 * Has a mode been read from the command-line?
1361 	bool specified;
1368 	bool refresh_specified;
1375 	bool bpp_specified;
1417 	bool rb;
1424 	bool interlace;
1432 	bool cvt;
1440 	bool margins;
1463 	 * drm-connector "panel orientation" property override value,
1483 	bool tv_mode_specified;
1487  * struct drm_connector - central DRM connector control structure
1523 	 * Connector entry in the global connector-list, used by
1543 	 * the mode_config.list for drivers not supporting hot-add/removing. Can
1561 	bool interlace_allowed;
1567 	bool doublescan_allowed;
1573 	bool stereo_allowed;
1576 	 * @ycbcr_420_allowed : This bool indicates if this connector is
1581 	bool ycbcr_420_allowed;
1615 	 * when a display is detected. For non hot-pluggable displays such as
1628 	 * @edid_blob_ptr: DRM property containing EDID if present. Protected by
1634 	/** @properties: property tracking for this connector */
1638 	 * @scaling_mode_property: Optional atomic property to control the
1644 	 * @vrr_capable_property: Optional property to help userspace
1646 	 * connector. Drivers can add the property to a connector by
1655 	 * @colorspace_property: Connector property to set the suitable
1663 	 * DRM blob property data for the DP MST path property. This should only
1669 	 * @max_bpc_property: Default connector property for the max bpc to be
1677 	/** @privacy_screen_notifier: privacy-screen notifier_block */
1681 	 * @privacy_screen_sw_state_property: Optional atomic property for the
1687 	 * @privacy_screen_hw_state_property: Optional atomic property for the
1727 	/** @helper_private: mid-layer private data */
1760 	 * Only really meaningful for non-atomic drivers. Atomic drivers should
1767 	/** @eld: EDID-like data, if present */
1770 	bool latency_present[2];
1804 	 * in Displayport compliance testing - Displayport Link CTS Core 1.2
1807 	bool edid_corrupt;
1839 	 * DRM blob property data for the tile property (used mostly by DP MST).
1843 	 * dual-link LVDS or dual-link DSI, the driver should try to not expose
1852 	bool has_tile;
1856 	bool tile_is_single_monitor;
1907 	return connector->index;  in drm_connector_index()
1912 	return 1 << connector->index;  in drm_connector_mask()
1916  * drm_connector_lookup - lookup connector object
1934  * drm_connector_get - acquire a connector reference
1941 	drm_mode_object_get(&connector->base);  in drm_connector_get()
1945  * drm_connector_put - release a connector reference
1953 	drm_mode_object_put(&connector->base);  in drm_connector_put()
1957  * drm_connector_is_unregistered - has the connector been unregistered from
1967 static inline bool
1970 	return READ_ONCE(connector->registration_state) ==  in drm_connector_is_unregistered()
2008 bool drm_connector_atomic_hdr_metadata_equal(struct drm_connector_state *old_state,
2026 		struct drm_connector *connector, bool capable);
2046  * struct drm_tile_group - Tile group metadata
2050  * @group_data: Sink-private data identifying this group
2070  * struct drm_connector_list_iter - connector_list iterator
2095 bool drm_connector_has_possible_encoder(struct drm_connector *connector,
2100  * drm_for_each_connector_iter - connector_list iterator macro
2112  * drm_connector_for_each_possible_encoder - iterate connector's possible encoders
2117 	drm_for_each_encoder_mask(encoder, (connector)->dev, \
2118 				  (connector)->possible_encoders)