Mirrors/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2026-08-18 06:35:35 +03:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'feat/support_usb_wakeup_v5.5' into 'release/v5.5'

Browse Source 
feat: support usb as wakeup source from light sleep (v5.5)

See merge request espressif/esp-idf!49511
This commit is contained in:
Jiang Jiang Jian
2026-06-17 19:50:18 +08:00
parent 842f62b0d3 be36da06b4
commit ad91c6ed0f
18 changed files with 444 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
components/esp_hw_support/include/esp_sleep.h
View File

@@ -1,5 +1,5 @@
/*
* SPDX-FileCopyrightText: 2015-2025 Espressif Systems (Shanghai) CO LTD
* SPDX-FileCopyrightText: 2015-2026 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Apache-2.0
*/
@@ -119,9 +119,10 @@ typedef enum {
ESP_SLEEP_WAKEUP_WIFI, //!< Wakeup caused by WIFI (light sleep only)
ESP_SLEEP_WAKEUP_COCPU, //!< Wakeup caused by COCPU int
ESP_SLEEP_WAKEUP_COCPU_TRAP_TRIG, //!< Wakeup caused by COCPU crash
ESP_SLEEP_WAKEUP_BT, //!< Wakeup caused by BT (light sleep only)
ESP_SLEEP_WAKEUP_VAD, //!< Wakeup caused by VAD
ESP_SLEEP_WAKEUP_VBAT_UNDER_VOLT, //!< Wakeup caused by VDD_BAT under voltage.
ESP_SLEEP_WAKEUP_BT, //!< Wakeup caused by BT (light sleep only)
ESP_SLEEP_WAKEUP_VAD, //!< Wakeup caused by VAD
ESP_SLEEP_WAKEUP_VBAT_UNDER_VOLT, //!< Wakeup caused by VDD_BAT under voltage.
ESP_SLEEP_WAKEUP_USB, //!< Wakeup caused by USB HS (light sleep only)
} esp_sleep_source_t;
/**
@@ -134,7 +135,6 @@ typedef enum {
/* Leave this type define for compatibility */
typedef esp_sleep_source_t esp_sleep_wakeup_cause_t;
enum {
ESP_ERR_SLEEP_REJECT = ESP_ERR_INVALID_STATE,
ESP_ERR_SLEEP_TOO_SHORT_SLEEP_DURATION = ESP_ERR_INVALID_ARG,
@@ -536,6 +536,22 @@ esp_err_t esp_sleep_enable_bt_wakeup(void);
*/
esp_err_t esp_sleep_disable_bt_wakeup(void);
/**
* @brief Enable wakeup by High-Speed USB-OTG
* @return
* - ESP_OK on success
* - ESP_ERR_NOT_SUPPORTED if wakeup from USB is not supported
*/
esp_err_t esp_sleep_enable_usb_wakeup(void);
/**
* @brief Disable wakeup by High-Speed USB-OTG
* @return
* - ESP_OK on success
* - ESP_ERR_NOT_SUPPORTED if wakeup from USB is not supported
*/
esp_err_t esp_sleep_disable_usb_wakeup(void);
/**
* @brief Enable wakeup by WiFi MAC
* @return

30
components/esp_hw_support/sleep_modes.c
View File

@@ -1730,6 +1730,11 @@ esp_err_t esp_sleep_disable_wakeup_source(esp_sleep_source_t source)
else if (CHECK_SOURCE(source, ESP_SLEEP_WAKEUP_VBAT_UNDER_VOLT, RTC_VBAT_UNDER_VOLT_TRIG_EN)) {
s_config.wakeup_triggers &= ~RTC_VBAT_UNDER_VOLT_TRIG_EN;
}
#endif
#if SOC_PM_SUPPORT_USB_WAKEUP
else if (CHECK_SOURCE(source, ESP_SLEEP_WAKEUP_USB, RTC_USB_TRIG_EN)) {
s_config.wakeup_triggers &= ~RTC_USB_TRIG_EN;
}
#endif
else {
ESP_LOGE(TAG, "Incorrect wakeup source (%d) to disable.", (int) source);
@@ -2299,6 +2304,26 @@ esp_err_t esp_sleep_disable_bt_wakeup(void)
#endif
}
esp_err_t esp_sleep_enable_usb_wakeup(void)
{
#if SOC_PM_SUPPORT_USB_WAKEUP
s_config.wakeup_triggers |= RTC_USB_TRIG_EN;
return ESP_OK;
#else
return ESP_ERR_NOT_SUPPORTED;
#endif
}
esp_err_t esp_sleep_disable_usb_wakeup(void)
{
#if SOC_PM_SUPPORT_USB_WAKEUP
s_config.wakeup_triggers &= (~RTC_USB_TRIG_EN);
return ESP_OK;
#else
return ESP_ERR_NOT_SUPPORTED;
#endif
}
esp_sleep_wakeup_cause_t esp_sleep_get_wakeup_cause(void)
{
if (esp_rom_get_reset_reason(0) != RESET_REASON_CORE_DEEP_SLEEP && !s_light_sleep_wakeup) {
@@ -2461,6 +2486,11 @@ uint32_t esp_sleep_get_wakeup_causes(void)
if (wakeup_cause_raw & RTC_VBAT_UNDER_VOLT_TRIG_EN) {
wakeup_cause |= BIT(ESP_SLEEP_WAKEUP_VBAT_UNDER_VOLT);
}
#endif
#if SOC_PM_SUPPORT_USB_WAKEUP
if (wakeup_cause_raw & RTC_USB_TRIG_EN) {
wakeup_cause |= BIT(ESP_SLEEP_WAKEUP_USB);
}
#endif
if (wakeup_cause == 0) {
wakeup_cause |= BIT(ESP_SLEEP_WAKEUP_UNDEFINED);

45
components/hal/esp32p4/include/hal/usb_utmi_ll.h
View File

@@ -1,5 +1,5 @@
/*
* SPDX-FileCopyrightText: 2024 Espressif Systems (Shanghai) CO LTD
* SPDX-FileCopyrightText: 2024-2026 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Apache-2.0
*/
@@ -11,7 +11,9 @@
#include "soc/lp_clkrst_struct.h"
#include "soc/hp_sys_clkrst_struct.h"
#include "soc/hp_system_struct.h"
#include "soc/lp_system_struct.h"
#include "soc/usb_utmi_struct.h"
#include "hal/config.h"
#ifdef __cplusplus
extern "C" {
@@ -75,6 +77,29 @@ FORCE_INLINE_ATTR void _usb_utmi_ll_reset_register(void)
// P_AON_CLKRST.hp_usb_clkrst_ctrlx is shared register, so this function must be used in an atomic way
#define usb_utmi_ll_reset_register(...) (void)__DECLARE_RCC_ATOMIC_ENV; _usb_utmi_ll_reset_register(__VA_ARGS__)
/**
* @brief Enable/disable 15k pulldown resistors on D+/D- lines
*
* In USB Host mode, 15k pulldown resistors must be connected on both D+ and D-.
* In USB Device mode, pulldown resistors must be disconnected.
*
* @note On ESP32-P4 v3+, pulldowns are no longer controlled by USB-OTG peripheral
* and must be controlled by software via LP_SYS registers.
* On earlier revisions, pulldowns are controlled by the USB-OTG hardware.
*
* @param[in] enable true to connect pulldowns (Host mode), false to disconnect (Device mode)
*/
FORCE_INLINE_ATTR void usb_utmi_ll_enable_data_pulldowns(bool enable)
{
#if HAL_CONFIG(CHIP_SUPPORT_MIN_REV) >= 300
LP_SYS.hp_usb_otghs_phy_ctrl.hp_utmiotg_dppulldown = enable;
LP_SYS.hp_usb_otghs_phy_ctrl.hp_utmiotg_dmpulldown = enable;
#else
// On pre-v3 ESP32-P4, pulldowns are controlled by the USB-OTG peripheral
(void)enable;
#endif
}
/**
* @brief Enable precise detection of VBUS
*
@@ -86,6 +111,24 @@ FORCE_INLINE_ATTR void usb_utmi_ll_enable_precise_detection(bool enable)
HP_SYSTEM.sys_usbotg20_ctrl.sys_otg_suspendm = enable;
}
/**
* @brief Set USB OTG2.0 suspend state for PMU USB wakeup logic
*
* @param[in] in_suspend True if USB OTG2.0 is suspended
*/
FORCE_INLINE_ATTR void usb_utmi_ll_set_suspend_state(bool in_suspend)
{
LP_SYS.usb_ctrl.usbotg20_in_suspend = in_suspend;
}
/**
* @brief Clear USB OTG2.0 wakeup status sent to PMU
*/
FORCE_INLINE_ATTR void usb_utmi_ll_clear_wakeup_status(void)
{
LP_SYS.usb_ctrl.usbotg20_wakeup_clr = 1;
}
#ifdef __cplusplus
}
#endif

24
components/hal/include/hal/usb_utmi_hal.h
View File

@@ -1,5 +1,5 @@
/*
* SPDX-FileCopyrightText: 2024 Espressif Systems (Shanghai) CO LTD
* SPDX-FileCopyrightText: 2024-2026 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Apache-2.0
*/
@@ -57,6 +57,28 @@ void _usb_utmi_hal_disable(void);
#define usb_utmi_hal_disable(...) do {(void)__DECLARE_RCC_ATOMIC_ENV; _usb_utmi_hal_disable(__VA_ARGS__);} while(0)
#endif
/**
* @brief Enable/disable 15k pulldown resistors on D+/D- lines
*
* In USB Host mode, 15k pulldown resistors must be connected on both D+ and D-.
* In USB Device mode, pulldown resistors must be disconnected.
*
* @param[in] enable true to connect pulldowns (Host mode), false to disconnect (Device mode)
*/
void usb_utmi_hal_enable_data_pulldowns(bool enable);
/**
* @brief Set USB OTG2.0 suspend state for PMU USB wakeup logic
*
* @param[in] in_suspend True if USB OTG2.0 is suspended
*/
void usb_utmi_hal_set_suspend_state(bool in_suspend);
/**
* @brief Clear USB OTG2.0 wakeup status sent to PMU
*/
void usb_utmi_hal_clear_wakeup_status(void);
#endif // (SOC_USB_UTMI_PHY_NUM > 0)
#ifdef __cplusplus

17
components/hal/usb_utmi_hal.c
View File

@@ -1,5 +1,5 @@
/*
* SPDX-FileCopyrightText: 2024 Espressif Systems (Shanghai) CO LTD
* SPDX-FileCopyrightText: 2024-2026 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Apache-2.0
*/
@@ -23,6 +23,21 @@ void _usb_utmi_hal_init(usb_utmi_hal_context_t *hal)
usb_utmi_ll_configure_ls(hal->dev, true);
}
void usb_utmi_hal_enable_data_pulldowns(bool enable)
{
usb_utmi_ll_enable_data_pulldowns(enable);
}
void usb_utmi_hal_set_suspend_state(bool in_suspend)
{
usb_utmi_ll_set_suspend_state(in_suspend);
}
void usb_utmi_hal_clear_wakeup_status(void)
{
usb_utmi_ll_clear_wakeup_status();
}
void _usb_utmi_hal_disable(void)
{
_usb_utmi_ll_enable_bus_clock(false);

4
components/soc/esp32p4/include/soc/Kconfig.soc_caps.in
View File

@@ -1395,6 +1395,10 @@ config SOC_USB_UTMI_PHY_NO_POWER_OFF_ISO
bool
default y
config SOC_PM_SUPPORT_USB_WAKEUP
int
default 1
config SOC_PARLIO_GROUPS
int
default 1

1
components/soc/esp32p4/include/soc/soc_caps.h
View File

@@ -494,6 +494,7 @@
// USB PHY Caps
#define SOC_USB_UTMI_PHY_NUM (1U)
#define SOC_USB_UTMI_PHY_NO_POWER_OFF_ISO 1
#define SOC_PM_SUPPORT_USB_WAKEUP (1U)
/*-------------------------- PARLIO CAPS --------------------------------------*/
#define SOC_PARLIO_GROUPS 1U /*!< Number of parallel IO peripherals */

15
components/usb/include/esp_private/usb_phy.h
View File

@@ -1,11 +1,12 @@
/*
* SPDX-FileCopyrightText: 2015-2025 Espressif Systems (Shanghai) CO LTD
* SPDX-FileCopyrightText: 2015-2026 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Apache-2.0
*/
#pragma once
#include <stdbool.h>
#include <stdint.h>
#include "esp_err.h"
#include "soc/soc_caps.h"
@@ -158,6 +159,18 @@ esp_err_t __attribute__((deprecated)) usb_phy_otg_dev_set_speed(usb_phy_handle_t
*/
esp_err_t __attribute__((deprecated)) usb_phy_action(usb_phy_handle_t handle, usb_phy_action_t action);
/**
* @brief Set the USB OTG suspend state for USB wakeup logic
*
* @param in_suspend True if the USB OTG bus is suspended
*/
void usb_phy_set_otg_suspend_state(bool in_suspend);
/**
* @brief Clear USB OTG wakeup status from the USB wakeup logic
*/
void usb_phy_clear_otg_wakeup_status(void);
/**
* @brief Delete a USB PHY
*

18
components/usb/usb_phy.c
View File

@@ -1,5 +1,5 @@
/*
* SPDX-FileCopyrightText: 2015-2025 Espressif Systems (Shanghai) CO LTD
* SPDX-FileCopyrightText: 2015-2026 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Apache-2.0
*/
@@ -265,6 +265,22 @@ esp_err_t usb_phy_action(usb_phy_handle_t handle, usb_phy_action_t action)
return ret;
}
void usb_phy_set_otg_suspend_state(bool in_suspend)
{
#if SOC_USB_UTMI_PHY_NUM
usb_utmi_hal_set_suspend_state(in_suspend);
#else
(void)in_suspend;
#endif
}
void usb_phy_clear_otg_wakeup_status(void)
{
#if SOC_USB_UTMI_PHY_NUM
usb_utmi_hal_clear_wakeup_status();
#endif
}
static esp_err_t usb_phy_install(void)
{
PHY_ENTER_CRITICAL();

1
docs/en/api-reference/system/sleep_modes.rst
View File

@@ -556,6 +556,7 @@ Application Examples
:esp32c3: - :example:`system/deep_sleep` demonstrates the usage of Deep-sleep wakeup triggered by various sources, such as the RTC timer, GPIOs, supported by ESP32-C3.
:esp32h2: - :example:`system/deep_sleep` demonstrates the usage of Deep-sleep wakeup triggered by various sources, such as the RTC timer and EXT1, supported by ESP32-H2.
- :example:`system/light_sleep` demonstrates the usage of Light-sleep wakeup triggered by various sources, such as the timer, GPIOs, supported by {IDF_TARGET_NAME}.
:SOC_PM_SUPPORT_USB_WAKEUP: - :example:`peripherals/usb/device/tusb_cdc_acm_wakeup` demonstrates the usage of USB 2.0 wakeup from Light-sleep.
:SOC_TOUCH_SENSOR_SUPPORTED and SOC_PM_SUPPORT_TOUCH_SENSOR_WAKEUP: - :example:`peripherals/touch_sensor/touch_sens_sleep` demonstrates the usage of Light-sleep and Deep-sleep wakeup triggered by the touch sensor.
API Reference

1
docs/zh_CN/api-reference/system/sleep_modes.rst
View File

@@ -556,6 +556,7 @@ UART 输出处理
:esp32c3: - :example:`system/deep_sleep` 演示如何通过 ESP32-C3 的唤醒源，如 RTC 定时器、GPIO 等，触发 Deep-sleep 唤醒。
:esp32h2: - :example:`system/deep_sleep` 演示如何通过 ESP32-H2 的唤醒源，如 RTC 定时器、EXT1 等，触发 Deep-sleep 唤醒。
- :example:`system/light_sleep` 演示如何使用 {IDF_TARGET_NAME} 的唤醒源，如定时器，GPIO 等，触发 Light-sleep 唤醒。
:SOC_PM_SUPPORT_USB_WAKEUP: - :example:`peripherals/usb/device/tusb_cdc_acm_wakeup` 演示如何使用 USB 2.0 将芯片从 Light-sleep 唤醒。
:SOC_TOUCH_SENSOR_SUPPORTED and SOC_PM_SUPPORT_TOUCH_SENSOR_WAKEUP: - :example:`peripherals/touch_sensor/touch_sens_sleep` 演示如何使用触摸传感器唤醒 Light-sleep 或 Deep-sleep。
API 参考

4
examples/peripherals/.build-test-rules.yml
View File

@@ -538,6 +538,10 @@ examples/peripherals/usb/device:
depends_filepatterns:
- examples/peripherals/usb/device/**/*
examples/peripherals/usb/device/tusb_cdc_acm_wakeup:
disable:
- if: SOC_USB_OTG_SUPPORTED != 1 or SOC_PM_SUPPORT_USB_WAKEUP != 1
examples/peripherals/usb/device/tusb_ncm:
disable:
- if: SOC_USB_OTG_SUPPORTED != 1 or SOC_WIFI_SUPPORTED != 1

8
examples/peripherals/usb/device/tusb_cdc_acm_wakeup/CMakeLists.txt Normal file
View File

@@ -0,0 +1,8 @@
# The following five lines of boilerplate have to be in your project's
# CMakeLists in this exact order for cmake to work correctly
cmake_minimum_required(VERSION 3.22)
include($ENV{IDF_PATH}/tools/cmake/project.cmake)
# "Trim" the build. Include the minimal set of components, main, and anything it depends on.
idf_build_set_property(MINIMAL_BUILD ON)
project(tusb_cdc_acm_wakeup)

86
examples/peripherals/usb/device/tusb_cdc_acm_wakeup/README.md Normal file
View File

@@ -0,0 +1,86 @@
| Supported Targets | ESP32-P4 |
| ----------------- | -------- |
# TinyUSB CDC ACM Wakeup Example
(See the README.md file in the upper level 'examples' directory for more information about examples.)
This example shows how to set up an ESP chip as a USB CDC ACM device that enters light sleep when the USB bus is suspended and wakes up from USB activity.
The wakeup source is available only on USB-OTG capable targets with High-Speed USB support. It is not supported by USB Serial/JTAG-only peripherals.
As a USB stack, a TinyUSB component is used.
## How to use example
The example implements a USB CDC ACM echo device. When the host suspends the USB bus, the `tud_suspend_cb` callback configures the USB peripheral suspend state and enters light sleep. USB bus activity from the host wakes the chip and the CDC ACM echo device continues running.
### Hardware Required
Any ESP board that supports High-Speed USB-OTG wakeup from light sleep.
#### Pin Assignment
_Note:_ In case your board doesn't have micro-USB connector connected to USB-OTG peripheral, you may have to DIY a cable and connect **D+** and **D-** to the pins listed below.
See common pin assignments for USB Device examples from [upper level](../../README.md#common-pin-assignments).
### Build and Flash
Build the project and flash it to the board, then run monitor tool to view serial output:
```bash
idf.py -p PORT flash monitor
```
(Replace PORT with the name of the serial port to use.)
(To exit the serial monitor, type ``Ctrl-]``.)
See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects.
## Example Output
After the flashing you should see this output:
```
I (285) tusb_cdc_acm_wakeup: USB initialization
I (455) TinyUSB: TinyUSB Driver installed
I (465) tusb_cdc_acm_wakeup: USB initialization DONE
```
Connect to the serial port (e.g. on Linux, it should be `/dev/ttyACM0`) by any terminal application (e.g. `picocom /dev/ttyACM0`).
Now you can send data strings to the device, the device will echo back the same data string.
To trigger USB suspend from the host, disable or suspend the CDC ACM device on the host side. On Windows, open Device Manager, find the COM port for the device, and disable it. On Linux, you can unbind the CDC ACM driver for the device or put the USB device into autosuspend. On macOS, disconnecting the terminal application and letting the host suspend the interface can also trigger suspend depending on the host power policy.
When the USB host suspends and resumes the bus, the monitor output should include:
```
I (122142) tusb_cdc_acm_wakeup: 0x4ff3afa4 48 65 6c 6c 6f |Hello|
I (122272) tusb_cdc_acm_wakeup: Data from channel 0:
I (122272) tusb_cdc_acm_wakeup: 0x4ff3afa4 48 65 6c 6c 6f |Hello|
I (122402) tusb_cdc_acm_wakeup: Data from channel 0:
I (122402) tusb_cdc_acm_wakeup: 0x4ff3afa4 48 65 6c 6c 6f |Hello|
I (122622) tusb_cdc_acm_wakeup: Data from channel 0:
I (122622) tusb_cdc_acm_wakeup: 0x4ff3afa4 48 65 6c 6c 6f |Hello|
I (127432) tusb_cdc_acm_wakeup: Line state changed on channel 0: DTR:0, RTS:0
I (132402) tusb_cdc_acm_wakeup: USB suspended, entering light sleep
I (132422) tusb_cdc_acm_wakeup: Woke up from: USB
I (132422) tusb_cdc_acm_wakeup: USB resumed
I (145762) tusb_cdc_acm_wakeup: Line state changed on channel 0: DTR:0, RTS:0
I (145812) tusb_cdc_acm_wakeup: Line state changed on channel 0: DTR:0, RTS:0
I (145812) tusb_cdc_acm_wakeup: Line state changed on channel 0: DTR:0, RTS:0
I (145822) tusb_cdc_acm_wakeup: Line state changed on channel 0: DTR:0, RTS:0
I (145822) tusb_cdc_acm_wakeup: Line state changed on channel 0: DTR:0, RTS:0
I (145832) tusb_cdc_acm_wakeup: Line state changed on channel 0: DTR:0, RTS:0
I (148762) tusb_cdc_acm_wakeup: Data from channel 0:
I (148762) tusb_cdc_acm_wakeup: 0x4ff3afa4 48 65 6c 6c 6f |Hello|
I (148902) tusb_cdc_acm_wakeup: Data from channel 0:
I (148902) tusb_cdc_acm_wakeup: 0x4ff3afa4 48 65 6c 6c 6f |Hello|
I (149032) tusb_cdc_acm_wakeup: Data from channel 0:
I (149032) tusb_cdc_acm_wakeup: 0x4ff3afa4 48 65 6c 6c 6f |Hello|
I (149252) tusb_cdc_acm_wakeup: Data from channel 0:
I (149252) tusb_cdc_acm_wakeup: 0x4ff3afa4 48 65 6c 6c 6f |Hello|
I (151382) tusb_cdc_acm_wakeup: Line state changed on channel 0: DTR:0, RTS:0
I (155312) tusb_cdc_acm_wakeup: USB suspended, entering light sleep
```

3
examples/peripherals/usb/device/tusb_cdc_acm_wakeup/main/CMakeLists.txt Normal file
View File

@@ -0,0 +1,3 @@
idf_component_register(SRCS "tusb_cdc_acm_wakeup_main.c"
INCLUDE_DIRS .
PRIV_REQUIRES usb hal)

4
examples/peripherals/usb/device/tusb_cdc_acm_wakeup/main/idf_component.yml Normal file
View File

@@ -0,0 +1,4 @@
## IDF Component Manager Manifest File
dependencies:
espressif/esp_tinyusb:
version: "^2.0.1~1"

164
examples/peripherals/usb/device/tusb_cdc_acm_wakeup/main/tusb_cdc_acm_wakeup_main.c Normal file
View File

@@ -0,0 +1,164 @@
/*
* SPDX-FileCopyrightText: 2026 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Unlicense OR CC0-1.0
*/
#include <assert.h>
#include <stdint.h>
#include <string.h>
#include "esp_log.h"
#include "esp_rom_uart.h"
#include "esp_sleep.h"
#include "esp_private/usb_phy.h"
#include "freertos/FreeRTOS.h"
#include "freertos/queue.h"
#include "freertos/task.h"
#include "sdkconfig.h"
#include "soc/soc_caps.h"
#include "tinyusb.h"
#include "tinyusb_cdc_acm.h"
#include "tinyusb_default_config.h"
#if !SOC_PM_SUPPORT_USB_WAKEUP || !SOC_PM_SUPPORT_CNNT_PD
#error This example requires a target with SOC_PM_SUPPORT_USB_WAKEUP.
#endif
static const char *TAG = "tusb_cdc_acm_wakeup";
static uint8_t rx_buf[CONFIG_TINYUSB_CDC_RX_BUFSIZE + 1];
/**
* @brief Application Queue
*/
static QueueHandle_t app_queue;
typedef struct {
uint8_t buf[CONFIG_TINYUSB_CDC_RX_BUFSIZE + 1]; // Data buffer
size_t buf_len; // Number of bytes received
uint8_t itf; // Index of CDC device interface
} app_message_t;
/**
* @brief CDC device RX callback
*
* CDC device signals, that new data were received
*
* @param[in] itf CDC device index
* @param[in] event CDC event type
*/
void tinyusb_cdc_rx_callback(int itf, cdcacm_event_t *event)
{
(void) event;
size_t rx_size = 0;
esp_err_t ret = tinyusb_cdcacm_read(itf, rx_buf, CONFIG_TINYUSB_CDC_RX_BUFSIZE, &rx_size);
if (ret == ESP_OK) {
app_message_t tx_msg = {
.buf_len = rx_size,
.itf = itf,
};
memcpy(tx_msg.buf, rx_buf, rx_size);
xQueueSend(app_queue, &tx_msg, 0);
} else {
ESP_LOGE(TAG, "Read Error");
}
}
/**
* @brief CDC device line change callback
*
* CDC device signals, that the DTR, RTS states changed
*
* @param[in] itf CDC device index
* @param[in] event CDC event type
*/
void tinyusb_cdc_line_state_changed_callback(int itf, cdcacm_event_t *event)
{
int dtr = event->line_state_changed_data.dtr;
int rts = event->line_state_changed_data.rts;
ESP_LOGI(TAG, "Line state changed on channel %d: DTR:%d, RTS:%d", itf, dtr, rts);
}
void tud_suspend_cb(bool remote_wakeup_en)
{
(void) remote_wakeup_en;
ESP_LOGI(TAG, "USB suspended, entering light sleep");
usb_phy_set_otg_suspend_state(true);
esp_rom_output_tx_wait_idle(CONFIG_ESP_CONSOLE_UART_NUM);
esp_err_t err = esp_light_sleep_start();
if (err != ESP_OK) {
ESP_LOGW(TAG, "Light sleep rejected: %s", esp_err_to_name(err));
} else {
uint32_t causes = esp_sleep_get_wakeup_causes();
if (causes & BIT(ESP_SLEEP_WAKEUP_UNDEFINED)) {
ESP_LOGW(TAG, "Woke up from an unknown source: 0x%lx", causes);
} else if (causes & BIT(ESP_SLEEP_WAKEUP_USB)) {
ESP_LOGI(TAG, "Woke up from: USB");
}
}
usb_phy_set_otg_suspend_state(false);
usb_phy_clear_otg_wakeup_status();
}
void tud_resume_cb(void)
{
ESP_LOGI(TAG, "USB resumed");
}
void tud_reset_cb(void)
{
ESP_LOGI(TAG, "USB reset");
}
void app_main(void)
{
// Create FreeRTOS primitives
app_queue = xQueueCreate(5, sizeof(app_message_t));
assert(app_queue);
app_message_t msg;
ESP_ERROR_CHECK(esp_sleep_cpu_retention_init());
ESP_ERROR_CHECK(esp_sleep_enable_usb_wakeup());
ESP_ERROR_CHECK(esp_sleep_pd_config(ESP_PD_DOMAIN_CNNT, ESP_PD_OPTION_ON));
ESP_LOGI(TAG, "USB initialization");
const tinyusb_config_t tusb_cfg = TINYUSB_DEFAULT_CONFIG();
ESP_ERROR_CHECK(tinyusb_driver_install(&tusb_cfg));
tinyusb_config_cdcacm_t acm_cfg = {
.cdc_port = TINYUSB_CDC_ACM_0,
.callback_rx = &tinyusb_cdc_rx_callback, // the first way to register a callback
.callback_rx_wanted_char = NULL,
.callback_line_state_changed = NULL,
.callback_line_coding_changed = NULL
};
ESP_ERROR_CHECK(tinyusb_cdcacm_init(&acm_cfg));
/* the second way to register a callback */
ESP_ERROR_CHECK(tinyusb_cdcacm_register_callback(
TINYUSB_CDC_ACM_0,
CDC_EVENT_LINE_STATE_CHANGED,
&tinyusb_cdc_line_state_changed_callback));
ESP_LOGI(TAG, "USB initialization DONE");
while (1) {
if (xQueueReceive(app_queue, &msg, portMAX_DELAY)) {
if (msg.buf_len) {
/* Print received data */
ESP_LOGI(TAG, "Data from channel %d:", msg.itf);
ESP_LOG_BUFFER_HEXDUMP(TAG, msg.buf, msg.buf_len, ESP_LOG_INFO);
/* Write back */
tinyusb_cdcacm_write_queue(msg.itf, msg.buf, msg.buf_len);
esp_err_t err = tinyusb_cdcacm_write_flush(msg.itf, 0);
if (err != ESP_OK) {
ESP_LOGE(TAG, "CDC ACM write flush error: %s", esp_err_to_name(err));
}
}
}
}
}

3
examples/peripherals/usb/device/tusb_cdc_acm_wakeup/sdkconfig.defaults Normal file
View File

@@ -0,0 +1,3 @@
CONFIG_PM_ENABLE=y
CONFIG_PM_POWER_DOWN_PERIPHERAL_IN_LIGHT_SLEEP=y
CONFIG_TINYUSB_CDC_ENABLED=y