From: Haowen Tu <tuhaowen@uniontech.com>
To: laurent.pinchart@ideasonboard.com, rafael@kernel.org
Cc: gregkh@linuxfoundation.org, hansg@kernel.org,
kernel@uniontech.com, lenb@kernel.org,
linux-kernel@vger.kernel.org, linux-media@vger.kernel.org,
linux-pm@vger.kernel.org, linux-usb@vger.kernel.org,
mchehab@kernel.org, oneukum@suse.com, pavel@kernel.org,
stern@rowland.harvard.edu, tuhaowen@uniontech.com
Subject: [PATCH v4 4/4] media: uvcvideo: defer streaming restart after hibernation snapshot
Date: Wed, 29 Jul 2026 15:11:23 +0800 [thread overview]
Message-ID: <6179cdb467414a1949fabbd4d8dec29affe9c3ea.1785226280.git.tuhaowen@uniontech.com> (raw)
In-Reply-To: <cover.1785226280.git.tuhaowen@uniontech.com>
When a UVC camera is streaming and the system enters hibernation, the
streaming interface is frozen before the snapshot is created. The
original kernel then resumes devices with PMSG_THAW so it can write the
hibernation image.
Restarting UVC streaming during this transient phase can turn the camera
LED back on and generate USB traffic even though the normal successful
path writes the image and powers off. USB interface resume callbacks do
not receive the PM message, so use pm_hibernation_snapshot_done() to
detect this phase and defer the streaming restart.
The deferred state is kept in the UVC stream. If image writeout succeeds,
the system powers off and no restart is needed. If image writeout fails,
the PM core sends PM_HIBERNATION_IMAGE_WRITE_FAILED before userspace is
thawed; the UVC PM notifier then restarts streams whose resume was
deferred. If that recovery restart fails, fall back to the existing
streamoff error path so userspace is notified instead of waiting on
buffers indefinitely.
Signed-off-by: Haowen Tu <tuhaowen@uniontech.com>
---
drivers/media/usb/uvc/uvc_driver.c | 56 +++++++++++++++++++++++++++++-
drivers/media/usb/uvc/uvc_video.c | 19 +++++++++-
drivers/media/usb/uvc/uvcvideo.h | 2 ++
3 files changed, 75 insertions(+), 2 deletions(-)
diff --git a/drivers/media/usb/uvc/uvc_driver.c b/drivers/media/usb/uvc/uvc_driver.c
index 31b4ac3b48c1..3cf861e0fa95 100644
--- a/drivers/media/usb/uvc/uvc_driver.c
+++ b/drivers/media/usb/uvc/uvc_driver.c
@@ -13,6 +13,7 @@
#include <linux/list.h>
#include <linux/module.h>
#include <linux/slab.h>
+#include <linux/suspend.h>
#include <linux/usb.h>
#include <linux/usb/quirks.h>
#include <linux/usb/uvc.h>
@@ -38,6 +39,8 @@ unsigned int uvc_dbg_param;
unsigned int uvc_timeout_param = UVC_CTRL_STREAMING_TIMEOUT;
static struct usb_driver uvc_driver;
+static LIST_HEAD(uvc_pm_devices);
+static DEFINE_MUTEX(uvc_pm_mutex);
/* ------------------------------------------------------------------------
* Utility functions
@@ -2200,6 +2203,7 @@ static int uvc_probe(struct usb_interface *intf,
INIT_LIST_HEAD(&dev->entities);
INIT_LIST_HEAD(&dev->chains);
INIT_LIST_HEAD(&dev->streams);
+ INIT_LIST_HEAD(&dev->pm_list);
kref_init(&dev->ref);
atomic_set(&dev->nmappings, 0);
@@ -2346,6 +2350,10 @@ static int uvc_probe(struct usb_interface *intf,
if (!(dev->quirks & UVC_QUIRK_DISABLE_AUTOSUSPEND))
usb_enable_autosuspend(udev);
+ mutex_lock(&uvc_pm_mutex);
+ list_add_tail(&dev->pm_list, &uvc_pm_devices);
+ mutex_unlock(&uvc_pm_mutex);
+
uvc_dbg(dev, PROBE, "UVC device initialized\n");
return 0;
@@ -2370,6 +2378,10 @@ static void uvc_disconnect(struct usb_interface *intf)
UVC_SC_VIDEOSTREAMING)
return;
+ mutex_lock(&uvc_pm_mutex);
+ list_del_init(&dev->pm_list);
+ mutex_unlock(&uvc_pm_mutex);
+
uvc_unregister_video(dev);
kref_put(&dev->ref, uvc_delete);
}
@@ -2447,6 +2459,41 @@ static int uvc_reset_resume(struct usb_interface *intf)
return __uvc_resume(intf, 1);
}
+static int uvc_pm_notify(struct notifier_block *nb, unsigned long action,
+ void *data)
+{
+ struct uvc_device *dev;
+ struct uvc_streaming *stream;
+ int ret;
+
+ if (action != PM_HIBERNATION_IMAGE_WRITE_FAILED)
+ return NOTIFY_DONE;
+
+ mutex_lock(&uvc_pm_mutex);
+ list_for_each_entry(dev, &uvc_pm_devices, pm_list) {
+ list_for_each_entry(stream, &dev->streams, list) {
+ if (!stream->hibernate_resume_deferred)
+ continue;
+
+ stream->hibernate_resume_deferred = 0;
+ ret = uvc_video_resume(stream, 0);
+ if (ret < 0) {
+ mutex_lock(&stream->queue.mutex);
+ vb2_streamoff(&stream->queue.queue,
+ stream->queue.queue.type);
+ mutex_unlock(&stream->queue.mutex);
+ }
+ }
+ }
+ mutex_unlock(&uvc_pm_mutex);
+
+ return NOTIFY_OK;
+}
+
+static struct notifier_block uvc_pm_nb = {
+ .notifier_call = uvc_pm_notify,
+};
+
/* ------------------------------------------------------------------------
* Module parameters
*/
@@ -3291,8 +3338,15 @@ static int __init uvc_init(void)
uvc_debugfs_init();
+ ret = register_pm_notifier(&uvc_pm_nb);
+ if (ret < 0) {
+ uvc_debugfs_cleanup();
+ return ret;
+ }
+
ret = usb_register(&uvc_driver);
if (ret < 0) {
+ unregister_pm_notifier(&uvc_pm_nb);
uvc_debugfs_cleanup();
return ret;
}
@@ -3303,6 +3357,7 @@ static int __init uvc_init(void)
static void __exit uvc_cleanup(void)
{
usb_deregister(&uvc_driver);
+ unregister_pm_notifier(&uvc_pm_nb);
uvc_debugfs_cleanup();
}
@@ -3313,4 +3368,3 @@ MODULE_AUTHOR(DRIVER_AUTHOR);
MODULE_DESCRIPTION(DRIVER_DESC);
MODULE_LICENSE("GPL");
MODULE_VERSION(DRIVER_VERSION);
-
diff --git a/drivers/media/usb/uvc/uvc_video.c b/drivers/media/usb/uvc/uvc_video.c
index f6c8e3223796..2c57b7042856 100644
--- a/drivers/media/usb/uvc/uvc_video.c
+++ b/drivers/media/usb/uvc/uvc_video.c
@@ -12,6 +12,7 @@
#include <linux/list.h>
#include <linux/module.h>
#include <linux/slab.h>
+#include <linux/suspend.h>
#include <linux/usb.h>
#include <linux/usb/hcd.h>
#include <linux/videodev2.h>
@@ -2151,11 +2152,27 @@ int uvc_video_resume(struct uvc_streaming *stream, int reset)
if (!uvc_queue_streaming(&stream->queue))
return 0;
+ /*
+ * Defer restarting the streaming hardware during the transient THAW
+ * phase after a hibernation snapshot has been created. If writing the
+ * image succeeds, the system powers off and the restart is not needed.
+ * If writing fails, the PM core notifies the driver before userspace is
+ * thawed so deferred streams can be restarted.
+ */
+ if (pm_hibernation_snapshot_done()) {
+ stream->hibernate_resume_deferred = 1;
+ return 0;
+ }
+
ret = uvc_commit_video(stream, &stream->ctrl);
if (ret < 0)
return ret;
- return uvc_video_start_transfer(stream, GFP_NOIO);
+ ret = uvc_video_start_transfer(stream, GFP_NOIO);
+ if (!ret)
+ stream->hibernate_resume_deferred = 0;
+
+ return ret;
}
/* ------------------------------------------------------------------------
diff --git a/drivers/media/usb/uvc/uvcvideo.h b/drivers/media/usb/uvc/uvcvideo.h
index 0a0c01b2420f..c87eaaaf2749 100644
--- a/drivers/media/usb/uvc/uvcvideo.h
+++ b/drivers/media/usb/uvc/uvcvideo.h
@@ -475,6 +475,7 @@ struct uvc_streaming {
/* Buffers queue. */
unsigned int frozen : 1;
+ unsigned int hibernate_resume_deferred : 1;
struct uvc_video_queue queue;
struct workqueue_struct *async_wq;
void (*decode)(struct uvc_urb *uvc_urb, struct uvc_buffer *buf,
@@ -604,6 +605,7 @@ struct uvc_device {
/* Video Streaming interfaces */
struct list_head streams;
+ struct list_head pm_list;
struct kref ref;
/* Status Interrupt Endpoint */
--
2.20.1
next prev parent reply other threads:[~2026-07-29 7:12 UTC|newest]
Thread overview: 42+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-04-28 8:05 [PATCH 0/2] PM: hibernate: add helper to detect image-write phase Haowen Tu
2026-04-28 8:05 ` [PATCH 1/2] PM: hibernate: add pm_hibernation_storing_image() helper Haowen Tu
2026-05-26 13:43 ` Rafael J. Wysocki
2026-04-28 8:05 ` [PATCH 2/2] media: uvcvideo: skip resume when writing hibernation image Haowen Tu
2026-04-28 8:36 ` Oliver Neukum
2026-04-28 8:58 ` Haowen Tu
2026-04-28 9:13 ` Laurent Pinchart
2026-04-29 1:15 ` Haowen Tu
2026-04-29 1:16 ` Haowen Tu
2026-05-28 8:18 ` [PATCH v2 0/2] PM: hibernate: skip UVC resume after snapshot Haowen Tu
2026-05-28 8:18 ` [PATCH v2 1/2] PM: hibernate: add pm_hibernation_snapshot_done() helper Haowen Tu
2026-06-01 18:22 ` Rafael J. Wysocki
2026-06-02 3:24 ` Haowen Tu
2026-06-18 1:31 ` [PATCH v3 0/3] PM: hibernate: skip UVC streaming restart after snapshot Haowen Tu
2026-06-18 1:31 ` [PATCH v3 1/3] PM: hibernate: clear in_suspend before freeing the snapshot Haowen Tu
2026-07-22 15:37 ` Rafael J. Wysocki (Intel)
2026-06-18 1:31 ` [PATCH v3 2/3] PM: hibernate: add pm_hibernation_snapshot_done() helper Haowen Tu
2026-07-22 15:40 ` Rafael J. Wysocki (Intel)
2026-06-18 1:31 ` [PATCH v3 3/3] media: uvcvideo: skip streaming restart after hibernation snapshot Haowen Tu
2026-07-22 20:06 ` Laurent Pinchart
2026-07-23 1:39 ` Haowen Tu
2026-07-23 8:46 ` Laurent Pinchart
2026-07-29 7:11 ` [PATCH v4 0/4] PM: hibernate: defer UVC streaming restart after snapshot Haowen Tu
2026-07-29 7:11 ` [PATCH v4 1/4] PM: hibernate: clear in_suspend before freeing the snapshot Haowen Tu
2026-07-29 7:11 ` [PATCH v4 2/4] PM: hibernate: add pm_hibernation_snapshot_done() helper Haowen Tu
2026-07-29 7:11 ` [PATCH v4 3/4] PM: hibernate: notify on image write failure Haowen Tu
2026-07-29 7:11 ` Haowen Tu [this message]
2026-07-29 7:29 ` [PATCH v4 4/4] media: uvcvideo: defer streaming restart after hibernation snapshot Hans de Goede
2026-07-29 7:56 ` Haowen Tu
2026-07-29 14:08 ` Alan Stern
2026-07-29 14:43 ` Oliver Neukum
2026-07-29 14:54 ` Alan Stern
2026-07-30 13:16 ` Laurent Pinchart
2026-07-30 14:29 ` Alan Stern
2026-07-30 15:38 ` Laurent Pinchart
2026-07-31 1:30 ` Haowen Tu
2026-09-03 2:14 ` [PATCH v5 0/4] PM: hibernate: skip unnecessary THAW resume Haowen Tu
2026-09-03 2:14 ` [PATCH v5 1/4] PM: hibernate: clear in_suspend before freeing the snapshot Haowen Tu
2026-09-03 2:14 ` [PATCH v5 2/4] PM: hibernate: add pm_hibernation_snapshot_done() helper Haowen Tu
2026-09-03 2:14 ` [PATCH v5 3/4] PM: hibernate: allow devices to skip post-snapshot THAW Haowen Tu
2026-09-03 2:14 ` [PATCH v5 4/4] media: uvcvideo: skip post-snapshot hibernation THAW Haowen Tu
2026-05-28 8:18 ` [PATCH v2 2/2] media: uvcvideo: skip resume after hibernation snapshot Haowen Tu
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=6179cdb467414a1949fabbd4d8dec29affe9c3ea.1785226280.git.tuhaowen@uniontech.com \
--to=tuhaowen@uniontech.com \
--cc=gregkh@linuxfoundation.org \
--cc=hansg@kernel.org \
--cc=kernel@uniontech.com \
--cc=laurent.pinchart@ideasonboard.com \
--cc=lenb@kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-media@vger.kernel.org \
--cc=linux-pm@vger.kernel.org \
--cc=linux-usb@vger.kernel.org \
--cc=mchehab@kernel.org \
--cc=oneukum@suse.com \
--cc=pavel@kernel.org \
--cc=rafael@kernel.org \
--cc=stern@rowland.harvard.edu \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
all inboxes | Powered by JetHome®