56  * track of a per-connector hpd interrupt.
90 			   struct drm_connector *connector,  in drm_mode_validate_pipeline()  argument
94 	struct drm_device *dev = connector->dev;  in drm_mode_validate_pipeline()
98 	/* Step 1: Validate against connector */  in drm_mode_validate_pipeline()
99 	ret = drm_connector_mode_valid(connector, mode, ctx, status);  in drm_mode_validate_pipeline()
104 	drm_connector_for_each_possible_encoder(connector, encoder) {  in drm_mode_validate_pipeline()
119 						      &connector->display_info,  in drm_mode_validate_pipeline()
144 static int drm_helper_probe_add_cmdline_mode(struct drm_connector *connector)  in drm_helper_probe_add_cmdline_mode()  argument
149 	cmdline_mode = &connector->cmdline_mode;  in drm_helper_probe_add_cmdline_mode()
154 	list_for_each_entry(mode, &connector->probed_modes, head) {  in drm_helper_probe_add_cmdline_mode()
170 	mode = drm_mode_create_from_cmdline_mode(connector->dev,  in drm_helper_probe_add_cmdline_mode()
175 	drm_mode_probed_add(connector, mode);  in drm_helper_probe_add_cmdline_mode()
203 drm_connector_mode_valid(struct drm_connector *connector,  in drm_connector_mode_valid()  argument
209 		connector->helper_private;  in drm_connector_mode_valid()
215 		ret = connector_funcs->mode_valid_ctx(connector, mode, ctx,  in drm_connector_mode_valid()
218 		*status = connector_funcs->mode_valid(connector, mode);  in drm_connector_mode_valid()
227 	struct drm_connector *connector;  in drm_kms_helper_disable_hpd()  local
231 	drm_for_each_connector_iter(connector, &conn_iter) {  in drm_kms_helper_disable_hpd()
233 			connector->helper_private;  in drm_kms_helper_disable_hpd()
236 			funcs->disable_hpd(connector);  in drm_kms_helper_disable_hpd()
244 	struct drm_connector *connector;  in drm_kms_helper_enable_hpd()  local
248 	drm_for_each_connector_iter(connector, &conn_iter) {  in drm_kms_helper_enable_hpd()
250 			connector->helper_private;  in drm_kms_helper_enable_hpd()
253 			funcs->enable_hpd(connector);  in drm_kms_helper_enable_hpd()
255 		if (connector->polled & (DRM_CONNECTOR_POLL_CONNECT |  in drm_kms_helper_enable_hpd()
322  * connector has been enabled.
324  * Drivers must call this helper after enabling polling for a connector by
327  * flags for a connector will stop the output polling work automatically if
341 drm_helper_probe_detect_ctx(struct drm_connector *connector, bool force)  in drm_helper_probe_detect_ctx()  argument
343 	const struct drm_connector_helper_funcs *funcs = connector->helper_private;  in drm_helper_probe_detect_ctx()
350 	ret = drm_modeset_lock(&connector->dev->mode_config.connection_mutex, &ctx);  in drm_helper_probe_detect_ctx()
353 			ret = funcs->detect_ctx(connector, &ctx, force);  in drm_helper_probe_detect_ctx()
354 		else if (connector->funcs->detect)  in drm_helper_probe_detect_ctx()
355 			ret = connector->funcs->detect(connector, force);  in drm_helper_probe_detect_ctx()
368 	if (ret != connector->status)  in drm_helper_probe_detect_ctx()
369 		connector->epoch_counter += 1;  in drm_helper_probe_detect_ctx()
378  * drm_helper_probe_detect - probe connector status
379  * @connector: connector to probe
383  * This function calls the detect callbacks of the connector.
388 drm_helper_probe_detect(struct drm_connector *connector,  in drm_helper_probe_detect()  argument
392 	const struct drm_connector_helper_funcs *funcs = connector->helper_private;  in drm_helper_probe_detect()
393 	struct drm_device *dev = connector->dev;  in drm_helper_probe_detect()
397 		return drm_helper_probe_detect_ctx(connector, force);  in drm_helper_probe_detect()
404 		ret = funcs->detect_ctx(connector, ctx, force);  in drm_helper_probe_detect()
405 	else if (connector->funcs->detect)  in drm_helper_probe_detect()
406 		ret = connector->funcs->detect(connector, force);  in drm_helper_probe_detect()
410 	if (ret != connector->status)  in drm_helper_probe_detect()
411 		connector->epoch_counter += 1;  in drm_helper_probe_detect()
417 static int drm_helper_probe_get_modes(struct drm_connector *connector)  in drm_helper_probe_get_modes()  argument
420 		connector->helper_private;  in drm_helper_probe_get_modes()
423 	count = connector_funcs->get_modes(connector);  in drm_helper_probe_get_modes()
427 		drm_err(connector->dev, ".get_modes() returned %pe\n",  in drm_helper_probe_get_modes()
436 	if (count == 0 && connector->status == connector_status_connected)  in drm_helper_probe_get_modes()
437 		count = drm_edid_override_connector_update(connector);  in drm_helper_probe_get_modes()
442 static int __drm_helper_update_and_validate(struct drm_connector *connector,  in __drm_helper_update_and_validate()  argument
446 	struct drm_device *dev = connector->dev;  in __drm_helper_update_and_validate()
451 	drm_connector_list_update(connector);  in __drm_helper_update_and_validate()
453 	if (connector->interlace_allowed)  in __drm_helper_update_and_validate()
455 	if (connector->doublescan_allowed)  in __drm_helper_update_and_validate()
457 	if (connector->stereo_allowed)  in __drm_helper_update_and_validate()
460 	list_for_each_entry(mode, &connector->modes, head) {  in __drm_helper_update_and_validate()
476 		ret = drm_mode_validate_pipeline(mode, connector, ctx,  in __drm_helper_update_and_validate()
491 		mode->status = drm_mode_validate_ycbcr420(mode, connector);  in __drm_helper_update_and_validate()
499  * @connector: connector to probe
503  * Based on the helper callbacks implemented by @connector in struct
505  * be added to the connector's probed_modes list, then culled (based on validity
514  * 1. All modes currently on the connector's modes list are marked as stale
516  * 2. New modes are added to the connector's probed_modes list with
521  *    - if the connector status is connector_status_connected, standard
539  *    - drm_mode_validate_flag() checks the modes against basic connector
549  * 5. Any mode whose status is not OK is pruned from the connector's modes list,
554  * The number of modes found on @connector.
556 int drm_helper_probe_single_connector_modes(struct drm_connector *connector,  in drm_helper_probe_single_connector_modes()  argument
559 	struct drm_device *dev = connector->dev;  in drm_helper_probe_single_connector_modes()
569 	DRM_DEBUG_KMS("[CONNECTOR:%d:%s]\n", connector->base.id,  in drm_helper_probe_single_connector_modes()
570 			connector->name);  in drm_helper_probe_single_connector_modes()
581 	list_for_each_entry(mode, &connector->modes, head)  in drm_helper_probe_single_connector_modes()
584 	old_status = connector->status;  in drm_helper_probe_single_connector_modes()
586 	if (connector->force) {  in drm_helper_probe_single_connector_modes()
587 		if (connector->force == DRM_FORCE_ON ||  in drm_helper_probe_single_connector_modes()
588 		    connector->force == DRM_FORCE_ON_DIGITAL)  in drm_helper_probe_single_connector_modes()
589 			connector->status = connector_status_connected;  in drm_helper_probe_single_connector_modes()
591 			connector->status = connector_status_disconnected;  in drm_helper_probe_single_connector_modes()
592 		if (connector->funcs->force)  in drm_helper_probe_single_connector_modes()
593 			connector->funcs->force(connector);  in drm_helper_probe_single_connector_modes()
595 		ret = drm_helper_probe_detect(connector, &ctx, true);  in drm_helper_probe_single_connector_modes()
600 		} else if (WARN(ret < 0, "Invalid return value %i for connector detection\n", ret))  in drm_helper_probe_single_connector_modes()
603 		connector->status = ret;  in drm_helper_probe_single_connector_modes()
612 	if (old_status != connector->status) {  in drm_helper_probe_single_connector_modes()
613 		DRM_DEBUG_KMS("[CONNECTOR:%d:%s] status updated from %s to %s\n",  in drm_helper_probe_single_connector_modes()
614 			      connector->base.id,  in drm_helper_probe_single_connector_modes()
615 			      connector->name,  in drm_helper_probe_single_connector_modes()
617 			      drm_get_connector_status_name(connector->status));  in drm_helper_probe_single_connector_modes()
639 	if (connector->status == connector_status_disconnected) {  in drm_helper_probe_single_connector_modes()
640 		DRM_DEBUG_KMS("[CONNECTOR:%d:%s] disconnected\n",  in drm_helper_probe_single_connector_modes()
641 			connector->base.id, connector->name);  in drm_helper_probe_single_connector_modes()
642 		drm_connector_update_edid_property(connector, NULL);  in drm_helper_probe_single_connector_modes()
643 		drm_mode_prune_invalid(dev, &connector->modes, false);  in drm_helper_probe_single_connector_modes()
647 	count = drm_helper_probe_get_modes(connector);  in drm_helper_probe_single_connector_modes()
649 	if (count == 0 && (connector->status == connector_status_connected ||  in drm_helper_probe_single_connector_modes()
650 			   connector->status == connector_status_unknown)) {  in drm_helper_probe_single_connector_modes()
651 		count = drm_add_modes_noedid(connector, 1024, 768);  in drm_helper_probe_single_connector_modes()
658 		if (connector->connector_type == DRM_MODE_CONNECTOR_DisplayPort)  in drm_helper_probe_single_connector_modes()
659 			drm_set_preferred_mode(connector, 640, 480);  in drm_helper_probe_single_connector_modes()
661 	count += drm_helper_probe_add_cmdline_mode(connector);  in drm_helper_probe_single_connector_modes()
663 		ret = __drm_helper_update_and_validate(connector, maxX, maxY, &ctx);  in drm_helper_probe_single_connector_modes()
670 	drm_mode_prune_invalid(dev, &connector->modes, true);  in drm_helper_probe_single_connector_modes()
679 	if (list_empty(&connector->modes) &&  in drm_helper_probe_single_connector_modes()
680 	    connector->connector_type == DRM_MODE_CONNECTOR_DisplayPort) {  in drm_helper_probe_single_connector_modes()
681 		count = drm_add_modes_noedid(connector, 640, 480);  in drm_helper_probe_single_connector_modes()
682 		ret = __drm_helper_update_and_validate(connector, maxX, maxY, &ctx);  in drm_helper_probe_single_connector_modes()
687 		drm_mode_prune_invalid(dev, &connector->modes, true);  in drm_helper_probe_single_connector_modes()
694 	if (list_empty(&connector->modes))  in drm_helper_probe_single_connector_modes()
697 	drm_mode_sort(&connector->modes);  in drm_helper_probe_single_connector_modes()
699 	DRM_DEBUG_KMS("[CONNECTOR:%d:%s] probed modes :\n", connector->base.id,  in drm_helper_probe_single_connector_modes()
700 			connector->name);  in drm_helper_probe_single_connector_modes()
701 	list_for_each_entry(mode, &connector->modes, head) {  in drm_helper_probe_single_connector_modes()
712  * @dev: drm_device whose connector state changed
726  * If only a single connector has changed, consider calling
741  * drm_kms_helper_connector_hotplug_event - fire off a KMS connector hotplug event
742  * @connector: drm_connector which has changed
745  * fine-grained uevent for a single connector.
747 void drm_kms_helper_connector_hotplug_event(struct drm_connector *connector)  in drm_kms_helper_connector_hotplug_event()  argument
749 	struct drm_device *dev = connector->dev;  in drm_kms_helper_connector_hotplug_event()
752 	drm_sysfs_connector_hotplug_event(connector);  in drm_kms_helper_connector_hotplug_event()
764 	struct drm_connector *connector;  in output_poll_execute()  local
789 	drm_for_each_connector_iter(connector, &conn_iter) {  in output_poll_execute()
791 		if (connector->force)  in output_poll_execute()
796 		if (!connector->polled || connector->polled == DRM_CONNECTOR_POLL_HPD)  in output_poll_execute()
799 		old_status = connector->status;  in output_poll_execute()
803 		    !(connector->polled & DRM_CONNECTOR_POLL_DISCONNECT))  in output_poll_execute()
808 		old_epoch_counter = connector->epoch_counter;  in output_poll_execute()
809 		connector->status = drm_helper_probe_detect(connector, NULL, false);  in output_poll_execute()
810 		if (old_epoch_counter != connector->epoch_counter) {  in output_poll_execute()
826 			if (connector->status == connector_status_unknown) {  in output_poll_execute()
827 				connector->status = old_status;  in output_poll_execute()
832 			new = drm_get_connector_status_name(connector->status);  in output_poll_execute()
834 			DRM_DEBUG_KMS("[CONNECTOR:%d:%s] "  in output_poll_execute()
836 				      connector->base.id,  in output_poll_execute()
837 				      connector->name,  in output_poll_execute()
839 			DRM_DEBUG_KMS("[CONNECTOR:%d:%s] epoch counter %llu -> %llu\n",  in output_poll_execute()
840 				      connector->base.id, connector->name,  in output_poll_execute()
841 				      old_epoch_counter, connector->epoch_counter);  in output_poll_execute()
868  * connector ->detect hook.
925  * Note that a connector can be both polled and probed from the hotplug handler,
952 static bool check_connector_changed(struct drm_connector *connector)  in check_connector_changed()  argument
954 	struct drm_device *dev = connector->dev;  in check_connector_changed()
959 	drm_WARN_ON(dev, !(connector->polled & DRM_CONNECTOR_POLL_HPD));  in check_connector_changed()
963 	old_status = connector->status;  in check_connector_changed()
964 	old_epoch_counter = connector->epoch_counter;  in check_connector_changed()
965 	connector->status = drm_helper_probe_detect(connector, NULL, false);  in check_connector_changed()
967 	if (old_epoch_counter == connector->epoch_counter) {  in check_connector_changed()
968 		drm_dbg_kms(dev, "[CONNECTOR:%d:%s] Same epoch counter %llu\n",  in check_connector_changed()
969 			    connector->base.id,  in check_connector_changed()
970 			    connector->name,  in check_connector_changed()
971 			    connector->epoch_counter);  in check_connector_changed()
976 	drm_dbg_kms(dev, "[CONNECTOR:%d:%s] status updated from %s to %s\n",  in check_connector_changed()
977 		    connector->base.id,  in check_connector_changed()
978 		    connector->name,  in check_connector_changed()
980 		    drm_get_connector_status_name(connector->status));  in check_connector_changed()
982 	drm_dbg_kms(dev, "[CONNECTOR:%d:%s] Changed epoch counter %llu => %llu\n",  in check_connector_changed()
983 		    connector->base.id,  in check_connector_changed()
984 		    connector->name,  in check_connector_changed()
986 		    connector->epoch_counter);  in check_connector_changed()
993  * @connector: drm_connector
995  * Drivers can use this helper function to run a detect cycle on a connector
999  * interrupts for a single connector. Drivers that want to send a
1001  * per connector need to use drm_helper_hpd_irq_event().
1006  * Note that a connector can be both polled and probed from the hotplug
1010  * A boolean indicating whether the connector status changed or not
1012 bool drm_connector_helper_hpd_irq_event(struct drm_connector *connector)  in drm_connector_helper_hpd_irq_event()  argument
1014 	struct drm_device *dev = connector->dev;  in drm_connector_helper_hpd_irq_event()
1018 	changed = check_connector_changed(connector);  in drm_connector_helper_hpd_irq_event()
1022 		drm_kms_helper_connector_hotplug_event(connector);  in drm_connector_helper_hpd_irq_event()
1023 		drm_dbg_kms(dev, "[CONNECTOR:%d:%s] Sent hotplug event\n",  in drm_connector_helper_hpd_irq_event()
1024 			    connector->base.id,  in drm_connector_helper_hpd_irq_event()
1025 			    connector->name);  in drm_connector_helper_hpd_irq_event()
1042  * interrupts for each connector.
1044  * Drivers which support hotplug interrupts for each connector individually and
1047  * code and directly call drm_kms_helper_hotplug_event() in case the connector
1053  * Note that a connector can be both polled and probed from the hotplug handler,
1057  * A boolean indicating whether the connector status changed or not
1061 	struct drm_connector *connector, *first_changed_connector = NULL;  in drm_helper_hpd_irq_event()  local
1070 	drm_for_each_connector_iter(connector, &conn_iter) {  in drm_helper_hpd_irq_event()
1072 		if (!(connector->polled & DRM_CONNECTOR_POLL_HPD))  in drm_helper_hpd_irq_event()
1075 		if (check_connector_changed(connector)) {  in drm_helper_hpd_irq_event()
1077 				drm_connector_get(connector);  in drm_helper_hpd_irq_event()
1078 				first_changed_connector = connector;  in drm_helper_hpd_irq_event()
1124  * drm_connector_helper_get_modes_from_ddc - Updates the connector's EDID
1125  *                                           property from the connector's
1127  * @connector: The connector
1132  * Uses a connector's DDC channel to retrieve EDID data and update the
1133  * connector's EDID property and display modes. Drivers can use this
1137 int drm_connector_helper_get_modes_from_ddc(struct drm_connector *connector)  in drm_connector_helper_get_modes_from_ddc()  argument
1142 	if (!connector->ddc)  in drm_connector_helper_get_modes_from_ddc()
1145 	edid = drm_get_edid(connector, connector->ddc);  in drm_connector_helper_get_modes_from_ddc()
1148 	drm_connector_update_edid_property(connector, edid);  in drm_connector_helper_get_modes_from_ddc()
1151 		count = drm_add_edid_modes(connector, edid);  in drm_connector_helper_get_modes_from_ddc()
1160  * drm_connector_helper_get_modes_fixed - Duplicates a display mode for a connector
1161  * @connector: the connector
1164  * This function duplicates a display modes for a connector. Drivers for hardware
1165  * that only supports a single fixed mode can use this function in their connector's
1171 int drm_connector_helper_get_modes_fixed(struct drm_connector *connector,  in drm_connector_helper_get_modes_fixed()  argument
1174 	struct drm_device *dev = connector->dev;  in drm_connector_helper_get_modes_fixed()
1188 	drm_mode_probed_add(connector, mode);  in drm_connector_helper_get_modes_fixed()
1191 		connector->display_info.width_mm = mode->width_mm;  in drm_connector_helper_get_modes_fixed()
1193 		connector->display_info.height_mm = mode->height_mm;  in drm_connector_helper_get_modes_fixed()
1200  * drm_connector_helper_get_modes - Read EDID and update connector.
1201  * @connector: The connector
1203  * Read the EDID using drm_edid_read() (which requires that connector->ddc is
1204  * set), and update the connector using the EDID.
1206  * This can be used as the "default" connector helper .get_modes() hook if the
1208  * custom .get_modes() hooks should do regarding EDID read and connector update.
1212 int drm_connector_helper_get_modes(struct drm_connector *connector)  in drm_connector_helper_get_modes()  argument
1217 	drm_edid = drm_edid_read(connector);  in drm_connector_helper_get_modes()
1220 	 * Unconditionally update the connector. If the EDID was read  in drm_connector_helper_get_modes()
1221 	 * successfully, fill in the connector information derived from the  in drm_connector_helper_get_modes()
1222 	 * EDID. Otherwise, if the EDID is NULL, clear the connector  in drm_connector_helper_get_modes()
1225 	drm_edid_connector_update(connector, drm_edid);  in drm_connector_helper_get_modes()
1227 	count = drm_edid_connector_add_modes(connector);  in drm_connector_helper_get_modes()
1236  * drm_connector_helper_tv_get_modes - Fills the modes availables to a TV connector
1237  * @connector: The connector
1239  * Fills the available modes for a TV connector based on the supported
1242  * This can be used as the default TV connector helper .get_modes() hook
1246  * The number of modes added to the connector.
1248 int drm_connector_helper_tv_get_modes(struct drm_connector *connector)  in drm_connector_helper_tv_get_modes()  argument
1250 	struct drm_device *dev = connector->dev;  in drm_connector_helper_tv_get_modes()
1253 	struct drm_cmdline_mode *cmdline = &connector->cmdline_mode;  in drm_connector_helper_tv_get_modes()
1274 		if (drm_object_property_get_default_value(&connector->base,  in drm_connector_helper_tv_get_modes()
1310 		drm_mode_probed_add(connector, mode);  in drm_connector_helper_tv_get_modes()