6  * DRM framebuffer helper functions
88  * The fb helper functions are useful to provide an fbdev on top of a drm kernel
90  * helper functions used by many drivers to implement the kernel mode setting
100  * They should also notify the fb helper code from updates to the output
107  * All other functions exported by the fb helper library can be used to
112  * helper must be called first to initialize the minimum required to make
117  * encoders and connectors. To finish up the fbdev helper initialization, the
152  * @info: fbdev registered by the helper
156 	struct drm_fb_helper *helper = info->par;  in drm_fb_helper_debug_enter()  local
160 	list_for_each_entry(helper, &kernel_fb_helper_list, kernel_fb_list) {  in drm_fb_helper_debug_enter()
161 		mutex_lock(&helper->client.modeset_mutex);  in drm_fb_helper_debug_enter()
162 		drm_client_for_each_modeset(mode_set, &helper->client) {  in drm_fb_helper_debug_enter()
179 		mutex_unlock(&helper->client.modeset_mutex);  in drm_fb_helper_debug_enter()
188  * @info: fbdev registered by the helper
192 	struct drm_fb_helper *helper = info->par;  in drm_fb_helper_debug_leave()  local
193 	struct drm_client_dev *client = &helper->client;  in drm_fb_helper_debug_leave()
194 	struct drm_device *dev = helper->dev;  in drm_fb_helper_debug_leave()
268  * @fb_helper: driver-allocated fbdev helper, can be NULL
271  * when implementing an fbcon on top of kms using this helper. This ensures that
287 	struct drm_fb_helper *helper;  in drm_fb_helper_restore_work_fn()  local
290 	list_for_each_entry(helper, &kernel_fb_helper_list, kernel_fb_list) {  in drm_fb_helper_restore_work_fn()
291 		struct drm_device *dev = helper->dev;  in drm_fb_helper_restore_work_fn()
296 		mutex_lock(&helper->lock);  in drm_fb_helper_restore_work_fn()
297 		drm_client_modeset_commit_locked(&helper->client);  in drm_fb_helper_restore_work_fn()
298 		mutex_unlock(&helper->lock);  in drm_fb_helper_restore_work_fn()
331  * @info: fbdev registered by the helper
366 	struct drm_fb_helper *helper = container_of(work, struct drm_fb_helper,  in drm_fb_helper_resume_worker()  local
370 	fb_set_suspend(helper->fbdev, 0);  in drm_fb_helper_resume_worker()
431 	struct drm_fb_helper *helper = container_of(work, struct drm_fb_helper,  in drm_fb_helper_damage_work()  local
433 	struct drm_device *dev = helper->dev;  in drm_fb_helper_damage_work()
434 	struct drm_clip_rect *clip = &helper->damage_clip;  in drm_fb_helper_damage_work()
439 	spin_lock_irqsave(&helper->damage_lock, flags);  in drm_fb_helper_damage_work()
443 	spin_unlock_irqrestore(&helper->damage_lock, flags);  in drm_fb_helper_damage_work()
449 	if (helper->buffer) {  in drm_fb_helper_damage_work()
450 		ret = drm_fb_helper_damage_blit(helper, &clip_copy);  in drm_fb_helper_damage_work()
455 	if (helper->fb->funcs->dirty) {  in drm_fb_helper_damage_work()
456 		ret = helper->fb->funcs->dirty(helper->fb, NULL, 0, 0, &clip_copy, 1);  in drm_fb_helper_damage_work()
457 		if (drm_WARN_ONCE(dev, ret, "Dirty helper failed: ret=%d\n", ret))  in drm_fb_helper_damage_work()
468 	spin_lock_irqsave(&helper->damage_lock, flags);  in drm_fb_helper_damage_work()
473 	spin_unlock_irqrestore(&helper->damage_lock, flags);  in drm_fb_helper_damage_work()
479  * @helper: driver-allocated fbdev helper structure to set up
480  * @funcs: pointer to structure of functions associate with this helper
482  * Sets up the bare minimum to make the framebuffer helper usable. This is
485 void drm_fb_helper_prepare(struct drm_device *dev, struct drm_fb_helper *helper,  in drm_fb_helper_prepare()  argument
488 	INIT_LIST_HEAD(&helper->kernel_fb_list);  in drm_fb_helper_prepare()
489 	spin_lock_init(&helper->damage_lock);  in drm_fb_helper_prepare()
490 	INIT_WORK(&helper->resume_work, drm_fb_helper_resume_worker);  in drm_fb_helper_prepare()
491 	INIT_WORK(&helper->damage_work, drm_fb_helper_damage_work);  in drm_fb_helper_prepare()
492 	helper->damage_clip.x1 = helper->damage_clip.y1 = ~0;  in drm_fb_helper_prepare()
493 	mutex_init(&helper->lock);  in drm_fb_helper_prepare()
494 	helper->funcs = funcs;  in drm_fb_helper_prepare()
495 	helper->dev = dev;  in drm_fb_helper_prepare()
502  * @fb_helper: driver-allocated fbdev helper structure to initialize
504  * This allocates the structures for the fbdev helper with the given limits.
542  * @fb_helper: driver-allocated fbdev helper
544  * A helper to alloc fb_info and the members cmap and apertures. Called
569 	 * for each IORESOURCE_MEM resource helper->dev->dev has and also  in drm_fb_helper_alloc_fbi()
596  * @fb_helper: driver-allocated fbdev helper, can be NULL
611  * @fb_helper: driver-allocated fbdev helper, can be NULL
666 	struct drm_fb_helper *helper = info->par;  in drm_fb_helper_damage()  local
667 	struct drm_clip_rect *clip = &helper->damage_clip;  in drm_fb_helper_damage()
670 	if (!drm_fbdev_use_shadow_fb(helper))  in drm_fb_helper_damage()
673 	spin_lock_irqsave(&helper->damage_lock, flags);  in drm_fb_helper_damage()
678 	spin_unlock_irqrestore(&helper->damage_lock, flags);  in drm_fb_helper_damage()
680 	schedule_work(&helper->damage_work);  in drm_fb_helper_damage()
756  * @info: fbdev registered by the helper
771  * @info: fbdev registered by the helper
786  * @info: fbdev registered by the helper
801  * @info: fbdev registered by the helper
816  * @info: fbdev registered by the helper
831  * @info: fbdev registered by the helper
846  * @fb_helper: driver-allocated fbdev helper, can be NULL
863  * @fb_helper: driver-allocated fbdev helper, can be NULL
1112  * @info: fbdev registered by the helper
1149  * @info: fbdev registered by the helper
1153  * A helper to implement the standard fbdev ioctl. Only
1294  * @info: fbdev registered by the helper
1364  * @info: fbdev registered by the helper
1469  * @info: fbdev registered by the helper
1725  * @fb_helper: fb helper instance to use as template
1728  * Sets up the variable and fixed fbdev metainformation from the given fb helper
1893  * as a helper to setup simple default values for the fbdev info structure.
1936  * @fb_helper: driver-allocated fbdev helper, can be NULL
1989  * drm_fb_helper_lastclose - DRM driver lastclose helper for fbdev emulation
2003  *                                     helper for fbdev emulation