6  * DRM core CRTC related functions
55  * A CRTC represents the overall display pipeline. It receives pixel data from
57  * to the CRTC, specifying display timings. On the output side the data is fed
61  * To create a CRTC, a KMS drivers allocates and zeroes an instances of
65  * The CRTC is also the entry point for legacy modeset operations, see
74  * drm_crtc_from_index - find the registered CRTC at an index
76  * @idx: index of registered CRTC to find for
78  * Given a CRTC index, return the registered CRTC from DRM device's
86 	struct drm_crtc *crtc;  in drm_crtc_from_index()  local
88 	drm_for_each_crtc(crtc, dev)  in drm_crtc_from_index()
89 		if (idx == crtc->index)  in drm_crtc_from_index()
90 			return crtc;  in drm_crtc_from_index()
96 int drm_crtc_force_disable(struct drm_crtc *crtc)  in drm_crtc_force_disable()  argument
99 		.crtc = crtc,  in drm_crtc_force_disable()
102 	WARN_ON(drm_drv_uses_atomic_modeset(crtc->dev));  in drm_crtc_force_disable()
121 	struct drm_crtc *crtc;  in drm_crtc_register_all()  local
124 	drm_for_each_crtc(crtc, dev) {  in drm_crtc_register_all()
125 		drm_debugfs_crtc_add(crtc);  in drm_crtc_register_all()
127 		if (crtc->funcs->late_register)  in drm_crtc_register_all()
128 			ret = crtc->funcs->late_register(crtc);  in drm_crtc_register_all()
138 	struct drm_crtc *crtc;  in drm_crtc_unregister_all()  local
140 	drm_for_each_crtc(crtc, dev) {  in drm_crtc_unregister_all()
141 		if (crtc->funcs->early_unregister)  in drm_crtc_unregister_all()
142 			crtc->funcs->early_unregister(crtc);  in drm_crtc_unregister_all()
143 		drm_debugfs_crtc_remove(crtc);  in drm_crtc_unregister_all()
147 static int drm_crtc_crc_init(struct drm_crtc *crtc)  in drm_crtc_crc_init()  argument
150 	spin_lock_init(&crtc->crc.lock);  in drm_crtc_crc_init()
151 	init_waitqueue_head(&crtc->crc.wq);  in drm_crtc_crc_init()
152 	crtc->crc.source = kstrdup("auto", GFP_KERNEL);  in drm_crtc_crc_init()
153 	if (!crtc->crc.source)  in drm_crtc_crc_init()
159 static void drm_crtc_crc_fini(struct drm_crtc *crtc)  in drm_crtc_crc_fini()  argument
162 	kfree(crtc->crc.source);  in drm_crtc_crc_fini()
176 	struct drm_crtc *crtc = fence_to_crtc(fence);  in drm_crtc_fence_get_driver_name()  local
178 	return crtc->dev->driver->name;  in drm_crtc_fence_get_driver_name()
183 	struct drm_crtc *crtc = fence_to_crtc(fence);  in drm_crtc_fence_get_timeline_name()  local
185 	return crtc->timeline_name;  in drm_crtc_fence_get_timeline_name()
193 struct dma_fence *drm_crtc_create_fence(struct drm_crtc *crtc)  in drm_crtc_create_fence()  argument
201 	dma_fence_init(fence, &drm_crtc_fence_ops, &crtc->fence_lock,  in drm_crtc_create_fence()
202 		       crtc->fence_context, ++crtc->fence_seqno);  in drm_crtc_create_fence()
208  * DOC: standard CRTC properties
213  * 	Atomic property for setting the power state of the CRTC. When set to 1
214  * 	the CRTC will actively display content. When set to 0 the CRTC will be
215  * 	powered off. There is no expectation that user-space will reset CRTC
227  * 	Atomic property for setting the CRTC display timings. The value is the
228  * 	ID of a blob containing the DRM mode info. To disable the CRTC,
231  * 	Setting MODE_ID to 0 will release reserved resources for the CRTC.
235  * drm_crtc_init_with_planes - Initialise a new CRTC object with
238  * @crtc: CRTC object to init
239  * @primary: Primary plane for CRTC
240  * @cursor: Cursor plane for CRTC
241  * @funcs: callbacks for the new CRTC
242  * @name: printf style format string for the CRTC name, or NULL for default name
244  * Inits a new object created as base part of a driver crtc object. Drivers
253 int drm_crtc_init_with_planes(struct drm_device *dev, struct drm_crtc *crtc,  in drm_crtc_init_with_planes()  argument
265 	/* crtc index is used with 32bit bitmasks */  in drm_crtc_init_with_planes()
273 	crtc->dev = dev;  in drm_crtc_init_with_planes()
274 	crtc->funcs = funcs;  in drm_crtc_init_with_planes()
276 	INIT_LIST_HEAD(&crtc->commit_list);  in drm_crtc_init_with_planes()
277 	spin_lock_init(&crtc->commit_lock);  in drm_crtc_init_with_planes()
279 	drm_modeset_lock_init(&crtc->mutex);  in drm_crtc_init_with_planes()
280 	ret = drm_mode_object_add(dev, &crtc->base, DRM_MODE_OBJECT_CRTC);  in drm_crtc_init_with_planes()
288 		crtc->name = kvasprintf(GFP_KERNEL, name, ap);  in drm_crtc_init_with_planes()
291 		crtc->name = kasprintf(GFP_KERNEL, "crtc-%d",  in drm_crtc_init_with_planes()
294 	if (!crtc->name) {  in drm_crtc_init_with_planes()
295 		drm_mode_object_unregister(dev, &crtc->base);  in drm_crtc_init_with_planes()
299 	crtc->fence_context = dma_fence_context_alloc(1);  in drm_crtc_init_with_planes()
300 	spin_lock_init(&crtc->fence_lock);  in drm_crtc_init_with_planes()
301 	snprintf(crtc->timeline_name, sizeof(crtc->timeline_name),  in drm_crtc_init_with_planes()
302 		 "CRTC:%d-%s", crtc->base.id, crtc->name);  in drm_crtc_init_with_planes()
304 	crtc->base.properties = &crtc->properties;  in drm_crtc_init_with_planes()
306 	list_add_tail(&crtc->head, &config->crtc_list);  in drm_crtc_init_with_planes()
307 	crtc->index = config->num_crtc++;  in drm_crtc_init_with_planes()
309 	crtc->primary = primary;  in drm_crtc_init_with_planes()
310 	crtc->cursor = cursor;  in drm_crtc_init_with_planes()
312 		primary->possible_crtcs = drm_crtc_mask(crtc);  in drm_crtc_init_with_planes()
314 		cursor->possible_crtcs = drm_crtc_mask(crtc);  in drm_crtc_init_with_planes()
316 	ret = drm_crtc_crc_init(crtc);  in drm_crtc_init_with_planes()
318 		drm_mode_object_unregister(dev, &crtc->base);  in drm_crtc_init_with_planes()
323 		drm_object_attach_property(&crtc->base, config->prop_active, 0);  in drm_crtc_init_with_planes()
324 		drm_object_attach_property(&crtc->base, config->prop_mode_id, 0);  in drm_crtc_init_with_planes()
325 		drm_object_attach_property(&crtc->base,  in drm_crtc_init_with_planes()
327 		drm_object_attach_property(&crtc->base,  in drm_crtc_init_with_planes()
336  * drm_crtc_cleanup - Clean up the core crtc usage
337  * @crtc: CRTC to cleanup
339  * This function cleans up @crtc and removes it from the DRM mode setting
340  * core. Note that the function does *not* free the crtc structure itself,
343 void drm_crtc_cleanup(struct drm_crtc *crtc)  in drm_crtc_cleanup()  argument
345 	struct drm_device *dev = crtc->dev;  in drm_crtc_cleanup()
352 	drm_crtc_crc_fini(crtc);  in drm_crtc_cleanup()
354 	kfree(crtc->gamma_store);  in drm_crtc_cleanup()
355 	crtc->gamma_store = NULL;  in drm_crtc_cleanup()
357 	drm_modeset_lock_fini(&crtc->mutex);  in drm_crtc_cleanup()
359 	drm_mode_object_unregister(dev, &crtc->base);  in drm_crtc_cleanup()
360 	list_del(&crtc->head);  in drm_crtc_cleanup()
363 	WARN_ON(crtc->state && !crtc->funcs->atomic_destroy_state);  in drm_crtc_cleanup()
364 	if (crtc->state && crtc->funcs->atomic_destroy_state)  in drm_crtc_cleanup()
365 		crtc->funcs->atomic_destroy_state(crtc, crtc->state);  in drm_crtc_cleanup()
367 	kfree(crtc->name);  in drm_crtc_cleanup()
369 	memset(crtc, 0, sizeof(*crtc));  in drm_crtc_cleanup()
374  * drm_mode_getcrtc - get CRTC configuration
379  * Construct a CRTC configuration structure to return to the user.
390 	struct drm_crtc *crtc;  in drm_mode_getcrtc()  local
396 	crtc = drm_crtc_find(dev, file_priv, crtc_resp->crtc_id);  in drm_mode_getcrtc()
397 	if (!crtc)  in drm_mode_getcrtc()
400 	plane = crtc->primary;  in drm_mode_getcrtc()
402 	crtc_resp->gamma_size = crtc->gamma_size;  in drm_mode_getcrtc()
418 	drm_modeset_lock(&crtc->mutex, NULL);  in drm_mode_getcrtc()
419 	if (crtc->state) {  in drm_mode_getcrtc()
420 		if (crtc->state->enable) {  in drm_mode_getcrtc()
421 			drm_mode_convert_to_umode(&crtc_resp->mode, &crtc->state->mode);  in drm_mode_getcrtc()
427 		crtc_resp->x = crtc->x;  in drm_mode_getcrtc()
428 		crtc_resp->y = crtc->y;  in drm_mode_getcrtc()
430 		if (crtc->enabled) {  in drm_mode_getcrtc()
431 			drm_mode_convert_to_umode(&crtc_resp->mode, &crtc->mode);  in drm_mode_getcrtc()
440 	drm_modeset_unlock(&crtc->mutex);  in drm_mode_getcrtc()
448 	struct drm_crtc *crtc = set->crtc;  in __drm_mode_set_config_internal()  local
453 	WARN_ON(drm_drv_uses_atomic_modeset(crtc->dev));  in __drm_mode_set_config_internal()
460 	drm_for_each_crtc(tmp, crtc->dev) {  in __drm_mode_set_config_internal()
468 	ret = crtc->funcs->set_config(set, ctx);  in __drm_mode_set_config_internal()
470 		struct drm_plane *plane = crtc->primary;  in __drm_mode_set_config_internal()
472 		plane->crtc = fb ? crtc : NULL;  in __drm_mode_set_config_internal()
476 	drm_for_each_crtc(tmp, crtc->dev) {  in __drm_mode_set_config_internal()
504 	WARN_ON(drm_drv_uses_atomic_modeset(set->crtc->dev));  in drm_mode_set_config_internal()
512  *     CRTC viewport
513  * @crtc: CRTC that framebuffer will be displayed on
519 int drm_crtc_check_viewport(const struct drm_crtc *crtc,  in drm_crtc_check_viewport()  argument
529 	if (crtc->state &&  in drm_crtc_check_viewport()
530 	    drm_rotation_90_or_270(crtc->primary->state->rotation))  in drm_crtc_check_viewport()
540  * drm_mode_setcrtc - set CRTC configuration
545  * Build a new CRTC configuration based on user request.
557 	struct drm_crtc *crtc;  in drm_mode_setcrtc()  local
578 	crtc = drm_crtc_find(dev, file_priv, crtc_req->crtc_id);  in drm_mode_setcrtc()
579 	if (!crtc) {  in drm_mode_setcrtc()
580 		DRM_DEBUG_KMS("Unknown CRTC ID %d\n", crtc_req->crtc_id);  in drm_mode_setcrtc()
583 	DRM_DEBUG_KMS("[CRTC:%d:%s]\n", crtc->base.id, crtc->name);  in drm_mode_setcrtc()
585 	plane = crtc->primary;  in drm_mode_setcrtc()
606 				DRM_DEBUG_KMS("CRTC doesn't have current FB\n");  in drm_mode_setcrtc()
667 		ret = drm_crtc_check_viewport(crtc, crtc_req->x, crtc_req->y,  in drm_mode_setcrtc()
727 	set.crtc = crtc;  in drm_mode_setcrtc()
736 		ret = crtc->funcs->set_config(&set, &ctx);  in drm_mode_setcrtc()
768 	struct drm_crtc *crtc = obj_to_crtc(obj);  in drm_mode_crtc_set_obj_prop()  local
770 	if (crtc->funcs->set_property)  in drm_mode_crtc_set_obj_prop()
771 		ret = crtc->funcs->set_property(crtc, property, value);  in drm_mode_crtc_set_obj_prop()