58 	DRM_FORCE_ON_DIGITAL, /* for DVI-I use digital connector */
64  * This enum is used to track the connector status. There are no separate
69 	 * @connector_status_connected: The connector is definitely connected to
74 	 * @connector_status_disconnected: The connector isn't connected to a
77 	 * nothing there. It is driver-dependent whether a connector with this
82 	 * @connector_status_unknown: The connector's status could not be
84 	 * flicker (like load-detection when the connector is in use), or when a
86 	 * free CRTC). It should be possible to light up the connector with one
89 	 * there's not connector with @connector_status_connected.
98  * This enum is used to track the status of initializing a connector and
104 	 * @DRM_CONNECTOR_INITIALIZING: The connector has just been created,
106 	 * additional restrictions to how the state of this connector may be
112 	 * @DRM_CONNECTOR_REGISTERED: The connector has been fully initialized
115 	 * state of this connector may be modified.
120 	 * @DRM_CONNECTOR_UNREGISTERED: The connector has either been exposed
122 	 * userspace, or the connector was unregistered before it had a chance
124 	 * @DRM_CONNECTOR_INITIALIZING state). When a connector is
128 	 * - An unregistered connector may only have its DPMS changed from
133 	 *   disabling a CRTC on an unregistered connector is OK, but enabling
135 	 * - Removing a CRTC from an unregistered connector is OK, but new
136 	 *   CRTCs may never be assigned to an unregistered connector.
155  * connector.
158  * "TV mode" connector property.
338  * enum drm_link_status - connector's link_status property value
340  * This enum is used as the connector's link status property value.
362  *					orientation" connector prop will not be
708 	 * @panel_orientation: Read only connector property for built-in panels,
864  * struct drm_connector_tv_margins - TV connector related margins
892  * struct drm_tv_connector_state - TV connector related states
939 	 * @broadcast_rgb: Connector property to pass the
996  * struct drm_connector_state - mutable connector state
999 	/** @connector: backpointer to the connector */
1000 	struct drm_connector *connector;  member
1003 	 * @crtc: CRTC to connect connector to, NULL if disabled.
1029 	 * @link_status: Connector link_status to keep track of whether link is
1044 	/** @tv: TV connector state */
1050 	 * This tracks whether a connector is aware of the self refresh state.
1051 	 * It should be set to true for those connector implementations which
1062 	 * @picture_aspect_ratio: Connector property to control the
1071 	 * @content_type: Connector property to control the
1079 	 * @hdcp_content_type: Connector property to pass the type of
1085 	 * @scaling_mode: Connector property to control the
1091 	 * @content_protection: Connector property to request content
1097 	 * @colorspace: State variable for Connector property to request
1106 	 * Holds the framebuffer and out-fence for a writeback connector. As
1117 	 * @max_requested_bpc: Connector property to limit the maximum bit
1123 	 * @max_bpc: Connector max_bpc based on the requested max_bpc property
1124 	 * and the connector bpc limitations obtained from edid.
1129 	 * @privacy_screen_sw_state: See :ref:`Standard Connector
1157 	int (*startup)(struct drm_connector *connector);
1167 	int (*prepare)(struct drm_connector *connector,
1179 	void (*shutdown)(struct drm_connector *connector);
1190 	int (*mute_stream)(struct drm_connector *connector,
1213 	(*tmds_char_rate_valid)(const struct drm_connector *connector,
1231 	int (*clear_infoframe)(struct drm_connector *connector,
1248 	int (*write_infoframe)(struct drm_connector *connector,
1256 	 * the EDID from connector->ddc. It is still recommended to provide
1257 	 * connector->ddc instead of implementing this callback. Returned EDID
1265 	const struct drm_edid *(*read_edid)(struct drm_connector *connector);
1279 	 * Legacy entry point to set the per-connector DPMS state. Legacy DPMS
1280 	 * is exposed as a standard property on the connector, but diverted to
1282 	 * implement the 4 level DPMS support on the connector any more, but
1292 	int (*dpms)(struct drm_connector *connector, int mode);
1297 	 * Reset connector hardware and software state to off. This function isn't
1304 	void (*reset)(struct drm_connector *connector);
1309 	 * Check to see if anything is attached to the connector. The parameter
1311 	 * connector due to a user request. force can be used by the driver to
1314 	 * This callback is optional, if not implemented the connector will be
1321 	 * core	entry point to probe connector state is @fill_modes.
1329 	 * state the connector is in. Drivers that need the underlying
1335 	 * drm_connector_status indicating the connector's status.
1337 	enum drm_connector_status (*detect)(struct drm_connector *connector,
1344 	 * connector is forced to a certain state by userspace, either through
1352 	 * core	entry point to probe connector state is @fill_modes.
1354 	void (*force)(struct drm_connector *connector);
1369 	 * received for this output connector->edid must be NULL.
1379 	int (*fill_modes)(struct drm_connector *connector, uint32_t max_width, uint32_t max_height);
1385 	 * connector.
1395 	int (*set_property)(struct drm_connector *connector, struct drm_property *property,
1402 	 * interfaces attached to the connector, light backlight control, i2c,
1405 	 * core drm connector interfaces. Everything added from this callback
1414 	int (*late_register)(struct drm_connector *connector);
1420 	 * userspace interfaces attached to the connector from
1427 	void (*early_unregister)(struct drm_connector *connector);
1432 	 * Clean up connector resources. This is called at driver unload time
1434 	 * when a connector is being hot-unplugged for drivers that support
1435 	 * connector hotplugging (e.g. DisplayPort MST).
1437 	void (*destroy)(struct drm_connector *connector);
1442 	 * Duplicate the current atomic state for this connector and return it.
1470 	struct drm_connector_state *(*atomic_duplicate_state)(struct drm_connector *connector);
1480 	void (*atomic_destroy_state)(struct drm_connector *connector,
1520 	 * asks for properties attached to this connector). No other validation
1525 	int (*atomic_set_property)(struct drm_connector *connector,
1546 	 * properties attached to this connector).
1548 	int (*atomic_get_property)(struct drm_connector *connector,
1568 	 * This will get called when a hotplug-event for a drm-connector
1571 	void (*oob_hotplug_event)(struct drm_connector *connector,
1577 	 * Allows connectors to create connector-specific debugfs files.
1579 	void (*debugfs_init)(struct drm_connector *connector, struct dentry *root);
1585  * Each connector can have an initial mode with additional options
1687 	 * Ignore the hotplug state of the connector, and force its
1705 	 * drm-connector "panel orientation" property override value,
1762 	 * from this connector. This is assigned by the framework when
1791  * struct drm_connector_hdmi - DRM Connector HDMI-related structure
1813 	 * @funcs: HDMI connector Control Functions
1818 	 * @infoframes: Current Infoframes output by the connector
1836  * struct drm_connector - central DRM connector control structure
1838  * Each connector may be connected to one or more CRTCs, or may be clonable by
1839  * another connector if they can share a CRTC.  Each connector also has a specific
1853 	 * Drivers can set this to associate a fwnode with a connector, drivers
1872 	 * Connector entry in the global connector-list, used by
1884 	 * @mutex: Lock for general connector state, but currently only protects
1885 	 * @registered. Most of the connector state is still protected by
1891 	 * @index: Compacted connector index, which matches the position inside
1894 	 * connector.
1903 	/** @connector_type_id: index into connector type enum */
1907 	 * Can this connector handle interlaced modes? Only used by
1913 	 * Can this connector handle doublescan? Only used by
1919 	 * Can this connector handle stereo modes? Only used by
1925 	 * @ycbcr_420_allowed : This bool indicates if this connector is
1933 	 * @registration_state: Is this connector initializing, exposed
1942 	 * Modes available on this connector (from fill_modes() + user).
1973 	/** @funcs: connector control functions */
1987 	/** @properties: property tracking for this connector */
1998 	 * query hardware support for variable refresh rate on a connector.
1999 	 * connector. Drivers can add the property to a connector by
2008 	 * @colorspace_property: Connector property to set the suitable
2022 	 * @max_bpc: Maximum bits per color channel the connector supports.
2027 	 * @max_bpc_property: Default connector property for the max bpc to be
2028 	 * driven out of the connector.
2032 	/** @privacy_screen: drm_privacy_screen for this connector, or NULL. */
2040 	 * connector to control the integrated privacy screen.
2046 	 * connector to report the actual integrated privacy screen state.
2051 	 * @broadcast_rgb_property: Connector property to set the
2063 	 * Connector polling mode, a combination of
2066 	 *     The connector generates hotplug events and doesn't need to be
2071 	 *     Periodically poll the connector for connection.
2074 	 *     Periodically poll the connector for disconnection, without
2075 	 *     causing flickering even when the connector is in use. DACs should
2094 	/** @cmdline_mode: mode line parsed from the kernel cmdline for this connector */
2112 	/** @epoch_counter: used to detect any other changes in connector, besides status */
2117 	 * connector, drm_encoder_index() determines the index into the bitfield
2123 	 * @encoder: Currently bound encoder driving this connector, if any.
2151 	 * A connector usually has its associated ddc adapter. If a driver uses
2152 	 * this field, then an appropriate symbolic link is created in connector
2182 	/** @debugfs_entry: debugfs directory for this connector */
2188 	 * Current atomic state for this connector.
2191 	 * nonblocking atomic commits access the current connector state without
2218 	/** @has_tile: is this connector connected to a tiled monitor */
2239 	 * connector from any context, in conjunction with
2261 		       struct drm_connector *connector,
2265 			       struct drm_connector *connector,
2270 				struct drm_connector *connector,
2275 			struct drm_connector *connector,
2280 			     struct drm_connector *connector,
2288 void drm_connector_attach_edid_property(struct drm_connector *connector);
2289 int drm_connector_register(struct drm_connector *connector);
2290 int drm_connector_dynamic_register(struct drm_connector *connector);
2291 void drm_connector_unregister(struct drm_connector *connector);
2292 int drm_connector_attach_encoder(struct drm_connector *connector,
2295 void drm_connector_cleanup(struct drm_connector *connector);
2297 static inline unsigned int drm_connector_index(const struct drm_connector *connector)  in drm_connector_index()  argument
2299 	return connector->index;  in drm_connector_index()
2302 static inline u32 drm_connector_mask(const struct drm_connector *connector)  in drm_connector_mask()  argument
2304 	return 1 << connector->index;  in drm_connector_mask()
2308  * drm_connector_lookup - lookup connector object
2311  * @id: connector object id
2313  * This function looks up the connector object specified by id
2326  * drm_connector_get - acquire a connector reference
2327  * @connector: DRM connector
2329  * This function increments the connector's refcount.
2331 static inline void drm_connector_get(struct drm_connector *connector)  in drm_connector_get()  argument
2333 	drm_mode_object_get(&connector->base);  in drm_connector_get()
2337  * drm_connector_put - release a connector reference
2338  * @connector: DRM connector
2340  * This function decrements the connector's reference count and frees the
2343 static inline void drm_connector_put(struct drm_connector *connector)  in drm_connector_put()  argument
2345 	drm_mode_object_put(&connector->base);  in drm_connector_put()
2349  * drm_connector_is_unregistered - has the connector been unregistered from
2351  * @connector: DRM connector
2353  * Checks whether or not @connector has been unregistered from userspace.
2356  * True if the connector was unregistered, false if the connector is
2360 drm_connector_is_unregistered(struct drm_connector *connector)  in drm_connector_is_unregistered()  argument
2362 	return READ_ONCE(connector->registration_state) ==  in drm_connector_is_unregistered()
2384 void drm_connector_attach_dp_subconnector_property(struct drm_connector *connector);
2395 int drm_connector_attach_scaling_mode_property(struct drm_connector *connector,
2398 		struct drm_connector *connector);
2399 int drm_connector_attach_broadcast_rgb_property(struct drm_connector *connector);
2400 int drm_connector_attach_colorspace_property(struct drm_connector *connector);
2401 int drm_connector_attach_hdr_output_metadata_property(struct drm_connector *connector);
2405 int drm_mode_create_hdmi_colorspace_property(struct drm_connector *connector,
2407 int drm_mode_create_dp_colorspace_property(struct drm_connector *connector,
2412 int drm_connector_set_path_property(struct drm_connector *connector,
2414 int drm_connector_set_tile_property(struct drm_connector *connector);
2415 int drm_connector_update_edid_property(struct drm_connector *connector,
2417 void drm_connector_set_link_status_property(struct drm_connector *connector,
2420 		struct drm_connector *connector, bool capable);
2422 	struct drm_connector *connector,
2425 	struct drm_connector *connector,
2429 	struct drm_connector *connector,
2431 int drm_connector_attach_max_bpc_property(struct drm_connector *connector,
2436 	struct drm_connector *connector, struct drm_privacy_screen *priv);
2474  * drm_connector_list_iter_end() call. If you want to use the connector later,
2489 bool drm_connector_has_possible_encoder(struct drm_connector *connector,
2495  * @connector: &struct drm_connector pointer used as cursor
2498  * Note that @connector is only valid within the list body, if you want to use
2499  * @connector after calling drm_connector_list_iter_end() then you need to grab
2502 #define drm_for_each_connector_iter(connector, iter) \  argument
2503 	while ((connector = drm_connector_list_iter_next(iter)))
2506  * drm_connector_for_each_possible_encoder - iterate connector's possible encoders
2507  * @connector: &struct drm_connector pointer
2510 #define drm_connector_for_each_possible_encoder(connector, encoder) \  argument
2511 	drm_for_each_encoder_mask(encoder, (connector)->dev, \
2512 				  (connector)->possible_encoders)