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
531  * enum drm_bus_flags - bus_flags info for &drm_display_info
636 	 *  Set if the Sharp-specific signals (SPL, CLS, PS, REV) must be used
642  * struct drm_display_info - runtime data about the connected sink
645  * fixed display sinks like built-in panels there's not much difference between
679 	 * @panel_orientation: Read only connector property for built-in panels,
720 	 * @dvi_dual: Dual-link DVI sink?
722 	bool dvi_dual;
730 	bool is_hdmi;
738 	bool has_audio;
743 	bool has_hdmi_infoframe;
749 	bool rgb_quant_range_selectable;
776 	bool non_desktop;
789 	 * @mso_stream_count: eDP Multi-SST Operation (MSO) stream count from
790 	 * the DisplayID VESA vendor block. 0 for conventional Single-Stream
796 	 * @mso_pixel_overlap: eDP MSO segment pixel overlap, 0-8 pixels.
823 	 * Vendor-Specific Data Block, for CEC usage.
835  * struct drm_connector_tv_margins - TV connector related margins
863  * struct drm_tv_connector_state - TV connector related states
891  * struct drm_connector_state - mutable connector state
933 	 * @commit: Tracks the pending commit to prevent use-after-free conditions.
954 	bool self_refresh_aware;
957 	 * @picture_aspect_ratio: Connector property to control the
966 	 * @content_type: Connector property to control the
974 	 * @hdcp_content_type: Connector property to pass the type of
980 	 * @scaling_mode: Connector property to control the
981 	 * upscaling, mostly used for built-in panels.
986 	 * @content_protection: Connector property to request content
992 	 * @colorspace: State variable for Connector property to request
1001 	 * Holds the framebuffer and out-fence for a writeback connector. As
1012 	 * @max_requested_bpc: Connector property to limit the maximum bit
1018 	 * @max_bpc: Connector max_bpc based on the requested max_bpc property
1031 	 * DRM blob property for HDR output metadata
1037  * struct drm_connector_funcs - control connectors on a given device
1047 	 * Legacy entry point to set the per-connector DPMS state. Legacy DPMS
1048 	 * is exposed as a standard property on the connector, but diverted to
1051 	 * instead only have an on/off "ACTIVE" property on the CRTC object.
1054 	 * property is entirely handled in the DRM core.
1106 					    bool force);
1137 	 * received for this output connector->edid must be NULL.
1152 	 * This is the legacy entry point to update a property attached to the
1156 	 * driver-private properties. For atomic drivers it is not used because
1157 	 * property handling is done entirely in the DRM core.
1163 	int (*set_property)(struct drm_connector *connector, struct drm_property *property,
1202 	 * when a connector is being hot-unplugged for drivers that support
1221 	 * state structure to extend it with driver-private state should use
1254 	 * Decode a driver-private property value and store the decoded value
1255 	 * into the passed-in state structure. Since the atomic core decodes all
1260 	 * Such driver-private properties should really only be implemented for
1269 	 * driver-private atomic properties.
1286 	 * 0 if the property has been found, -EINVAL if the property isn't
1289 	 * is allowed by the driver. The core already checks that the property
1291 	 * set when registering the property.
1295 				   struct drm_property *property,
1301 	 * Reads out the decoded driver-private property. This is used to
1308 	 * driver-private atomic properties.
1312 	 * 0 on success, -EINVAL if the property isn't implemented by the
1318 				   struct drm_property *property,
1336 	 * This will get called when a hotplug-event for a drm-connector
1345 	 * Allows connectors to create connector-specific debugfs files.
1351  * struct drm_cmdline_mode - DRM Mode passed through the kernel command-line
1355  * express those parameters and will be filled by the command-line
1369 	 * Has a mode been read from the command-line?
1371 	bool specified;
1378 	bool refresh_specified;
1385 	bool bpp_specified;
1427 	bool rb;
1434 	bool interlace;
1442 	bool cvt;
1450 	bool margins;
1473 	 * drm-connector "panel orientation" property override value,
1493 	bool tv_mode_specified;
1497  * struct drm_connector - central DRM connector control structure
1533 	 * Connector entry in the global connector-list, used by
1553 	 * the mode_config.list for drivers not supporting hot-add/removing. Can
1571 	bool interlace_allowed;
1577 	bool doublescan_allowed;
1583 	bool stereo_allowed;
1586 	 * @ycbcr_420_allowed : This bool indicates if this connector is
1591 	bool ycbcr_420_allowed;
1625 	 * when a display is detected. For non hot-pluggable displays such as
1638 	 * @edid_blob_ptr: DRM property containing EDID if present. Protected by
1644 	/** @properties: property tracking for this connector */
1648 	 * @scaling_mode_property: Optional atomic property to control the
1654 	 * @vrr_capable_property: Optional property to help userspace
1656 	 * connector. Drivers can add the property to a connector by
1665 	 * @colorspace_property: Connector property to set the suitable
1673 	 * DRM blob property data for the DP MST path property. This should only
1679 	 * @max_bpc_property: Default connector property for the max bpc to be
1687 	/** @privacy_screen_notifier: privacy-screen notifier_block */
1691 	 * @privacy_screen_sw_state_property: Optional atomic property for the
1697 	 * @privacy_screen_hw_state_property: Optional atomic property for the
1737 	/** @helper_private: mid-layer private data */
1770 	 * Only really meaningful for non-atomic drivers. Atomic drivers should
1777 	/** @eld: EDID-like data, if present */
1780 	bool latency_present[2];
1814 	 * in Displayport compliance testing - Displayport Link CTS Core 1.2
1817 	bool edid_corrupt;
1849 	 * DRM blob property data for the tile property (used mostly by DP MST).
1853 	 * dual-link LVDS or dual-link DSI, the driver should try to not expose
1862 	bool has_tile;
1866 	bool tile_is_single_monitor;
1917 	return connector->index;  in drm_connector_index()
1922 	return 1 << connector->index;  in drm_connector_mask()
1926  * drm_connector_lookup - lookup connector object
1944  * drm_connector_get - acquire a connector reference
1951 	drm_mode_object_get(&connector->base);  in drm_connector_get()
1955  * drm_connector_put - release a connector reference
1963 	drm_mode_object_put(&connector->base);  in drm_connector_put()
1967  * drm_connector_is_unregistered - has the connector been unregistered from
1977 static inline bool
1980 	return READ_ONCE(connector->registration_state) ==  in drm_connector_is_unregistered()
2019 bool drm_connector_atomic_hdr_metadata_equal(struct drm_connector_state *old_state,
2037 		struct drm_connector *connector, bool capable);
2057  * struct drm_tile_group - Tile group metadata
2061  * @group_data: Sink-private data identifying this group
2081  * struct drm_connector_list_iter - connector_list iterator
2106 bool drm_connector_has_possible_encoder(struct drm_connector *connector,
2111  * drm_for_each_connector_iter - connector_list iterator macro
2123  * drm_connector_for_each_possible_encoder - iterate connector's possible encoders
2128 	drm_for_each_encoder_mask(encoder, (connector)->dev, \
2129 				  (connector)->possible_encoders)