docs(sleep): Update light-sleep USB wake-up source

2026-10-02 03:00:34 +03:00 · 2026-07-03 15:04:33 +08:00
parent 08b5996134
commit 2859a9b24a
6 changed files with 36 additions and 6 deletions
@@ -284,6 +284,21 @@ RTC 控制器中内嵌定时器，可用于在预定义的时间到达后唤醒

    可调用 :cpp:func:`esp_sleep_enable_ulp_wakeup` 函数来启用此唤醒源。

+.. only:: SOC_PM_SUPPORT_USB_WAKEUP
+
+    USB 唤醒（仅限 Light-sleep 模式）
+    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+    当检测到 USB 2.0 高速 OTG 总线有活动时，{IDF_TARGET_NAME} 从 Light-sleep 模式中唤醒。该唤醒源适用于这样的 USB 设备应用：当 USB 主机将总线挂起时进入 Light-sleep 模式，在主机恢复总线时唤醒。
+
+    该唤醒源仅在具备 USB-OTG 功能且支持高速 USB 的目标芯片上可用。USB Serial/JTAG 外设不支持该功能。
+
+    休眠期间，高速连接类外设的电源域（``ESP_PD_DOMAIN_CNNT``）必须保持上电。可以使用 :cpp:func:`esp_sleep_pd_config` 函数进行配置::
+
+        esp_sleep_pd_config(ESP_PD_DOMAIN_CNNT, ESP_PD_OPTION_ON);
+
+    可以使用 :cpp:func:`esp_sleep_enable_usb_wakeup` 函数来启用该唤醒源。
+
 .. only:: SOC_RTCIO_WAKE_SUPPORTED

    Light-sleep 模式下的 GPIO 唤醒