feat: support esp32s3

Author: lijunru-hub

.gitlab/ci/build.yml

@@ -785,9 +785,12 @@ build_example_usb_device_usb_extend_screen:
   extends:
     - .build_examples_template
     - .rules:build:example_usb_device_usb_extend_screen
+  parallel:
+    matrix:
+      - IMAGE: espressif/idf:release-v5.3
+      - IMAGE: espressif/idf:release-v5.4
   variables:
     EXAMPLE_DIR: examples/usb/device/usb_extend_screen
-    IMAGE: espressif/idf:release-v5.3
 
 build_example_usb_device_usb_webcam:
   extends:

.gitlab/ci/deploy.yml

@@ -116,7 +116,7 @@ pack-upload_files:
     - job: "build_example_usb_device_bootloader_uf2: [espressif/idf:release-v5.3]"
     - job: "build_example_usb_device_usb_dongle: [espressif/idf:release-v5.3]"
     - job: "build_example_usb_device_usb_dual_uvc_device: [espressif/idf:release-v5.3]"
-    - job: "build_example_usb_device_usb_extend_screen"
+    - job: "build_example_usb_device_usb_extend_screen: [espressif/idf:release-v5.4]"
     - job: "build_example_usb_device_usb_hid_device: [espressif/idf:release-v5.0]"
     - job: "build_example_usb_device_usb_lcd_display"
     - job: "build_example_usb_device_usb_msc_wireless_disk: [espressif/idf:release-v5.0]"

examples/usb/device/usb_extend_screen/README.md

@@ -1,60 +1,87 @@
-## USB Extension Screen Example
+## USB Extended Display Example
 
-Try with [LaunchPad](https://espressif.github.io/esp-launchpad/?flashConfigURL=https://dl.espressif.com/AE/esp-iot-solution/config.toml)
+Use [LaunchPad](https://espressif.github.io/esp-launchpad/?flashConfigURL=https://dl.espressif.com/AE/esp-iot-solution/config.toml) to flash this example.
 
-The USB Extension Screen Example allows the P4 development board to be used as an additional screen for Windows. It supports the following features:
+The USB extended display example allows the [ESP32_S3_LCD_EV_BOARD](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s3/esp32-s3-lcd-ev-board/index.html) / [ESP32_P4_FUNCTION_EV_BOARD](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32p4/esp32-p4-function-ev-board/index.html) development boards to function as a secondary display for Windows. It supports the following features:
 
-* Supports a screen refresh rate of 1024*600@60FPS
-* Supports up to five touch points
-* Supports audio input and output
+* **P4**: Supports a screen refresh rate of **1024×576@60FPS**.
+* **S3**: Supports a screen refresh rate of **800×480@13FPS**.
+* Supports up to **five-point touch input**.
+* Supports **audio input and output**.
 
 ## Required Hardware
 
-* Development Board
-  1. [ESP32-P4-Function-EV-Board](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32p4/esp32-p4-function-ev-board/user_guide.html#getting-started) development board
-  2. A 1024*600 MIPI screen from the development kit
-  3. A speaker
+### P4 Development Board
 
-* Connections
-  1. Connect the high-speed USB port on the development board to the PC
+1. [ESP32-P4-Function-EV-Board](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32p4/esp32-p4-function-ev-board/user_guide.html#getting-started) development board.
+2. A **1024×600** MIPI display from the development kit.
+3. A speaker.
+
+### S3 Development Board
+
+1. [ESP32-S3-LCD-EV-Board](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s3/esp32-s3-lcd-ev-board/user_guide.html#getting-started) development board.
+2. A **800×480** or **480×480** RGB display from the development kit.
+3. A speaker.
+
+## Hardware Connection
+
+1. Connect the high-speed USB port on the development board to the PC.
 
 ## Compilation and Flashing
 
-### P4 Device Side
+### Device Side
 
-Build the project and flash it to the board, then run the monitor tool to view serial output:
+Build the project, flash it to the board, and run the monitor tool to check the serial output:
 
-* Run `. ./export.sh` to set up the IDF environment
-* Run `idf.py set-target esp32p4` to set the target chip
-* If there are any errors in the previous step, run `pip install "idf-component-manager~=1.1.4"` to upgrade your component manager
-* Run `idf.py -p PORT flash monitor` to build, flash, and monitor the project
+1. Run `. ./export.sh` to set up the IDF environment.
+2. Run `idf.py set-target esp32p4` to set the target chip.
+3. If you encounter any errors in the previous step, run `pip install "idf-component-manager~=1.1.4"` to upgrade the component manager.
+4. Run `idf.py -p PORT flash monitor` to build, flash, and monitor the project.
 
 (To exit the serial monitor, press `Ctrl-]`.)
 
-Refer to the Getting Started Guide for all steps to configure and use ESP-IDF to build projects.
+Refer to the **Getting Started Guide** for full instructions on configuring and using ESP-IDF to build projects.
 
-> Note: This example will fetch an AVI file online. Ensure that you are connected to the internet during the initial compilation.
+>> **Note:** This example fetches AVI files online. Ensure you have an internet connection during the first compilation.
 
 ### PC Side
 
-For preparation, refer to the [windows_driver](./windows_driver/README.md)
+For preparation, refer to [windows_driver](./windows_driver/README_cn.md).
 
 ![Demo](https://dl.espressif.com/AE/esp-iot-solution/p4_usb_extern_screen.gif)
 
-## Other Issues
+## Troubleshooting
 
-### Touch Screen Does Not Control the P4 Screen
+### The touchscreen controls the wrong display
 
-* In the Control Panel, select `Tablet PC Settings`
-* In the configuration section, select `Setup`
-* Follow the prompts to choose the P4 extension screen
+1. Open **Control Panel** and select **Tablet PC Settings**.
+2. Under the **Display** section, select **Setup**.
+3. Follow the on-screen instructions to choose the correct extended display.
 
 ### Adjusting JPEG Image Quality
 
-* Modify the `string_desc_arr` vendor interface string in the `usb_descriptor.c` file. Change `Ejpg4` to the desired image quality level; the higher the number, the better the quality, but it will use more memory for the same frame.
+* Modify `CONFIG_USB_EXTEND_SCREEN_JPEG_QUALITY`. A higher value increases image quality but also consumes more memory per frame.
+
+### Changing the Secondary Screen Resolution
+
+* Modify `CONFIG_USB_EXTEND_SCREEN_HEIGHT` and `CONFIG_USB_EXTEND_SCREEN_WIDTH`.
+
+**Note:** The driver currently does not support portrait-oriented screens. Please use a screen designed for landscape mode.
+
+### Adjusting Image Output Frame Rate
+
+* Modify `CONFIG_USB_EXTEND_SCREEN_MAX_FPS`. Lowering this value effectively reduces USB bandwidth usage. If USB audio stuttering occurs, consider decreasing this value.
+
+### Modifying the Maximum Frame Size
+
+* Modify `CONFIG_USB_EXTEND_SCREEN_FRAME_LIMIT_B` to limit the maximum image size received from the PC driver.
+
+### Disabling Touchscreen Functionality
+
+* Set `CONFIG_HID_TOUCH_ENABLE` to `n`.
 
-### Modify Screen Resolution
+### Disabling Audio Functionality
 
-- Update the `usb_descriptor.c` file by changing the `string_desc_arr` vendor interface string. Modify `R1024x600` to the desired screen resolution.
+* Set `CONFIG_UAC_AUDIO_ENABLE` to `n`.
 
-**Note**: Currently, the driver does not support portrait mode screens. Please use hardware that is designed for landscape orientation.
+**Note:** If only the secondary screen function is enabled, change the PID to `0x2987`.

examples/usb/device/usb_extend_screen/README_cn.md

@@ -2,29 +2,39 @@
 
 使用 [LaunchPad](https://espressif.github.io/esp-launchpad/?flashConfigURL=https://dl.espressif.com/AE/esp-iot-solution/config.toml) 烧录该示例
 
-USB 扩展屏示例可以将 P4 开发板作为一块 windows 的副屏。支持以下功能。
+USB 扩展屏示例可以将 [ESP32_S3_LCD_EV_BOARD](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s3/esp32-s3-lcd-ev-board/index.html) / [ESP32_P4_FUNCTION_EV_BOARD](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32p4/esp32-p4-function-ev-board/index.html) 开发板作为一块 windows 的副屏。支持以下功能。
 
-* 支持 1024*600@60FPS 的屏幕刷新速率
+* P4: 支持 1024*576@60FPS 的屏幕刷新速率
+
+* S3: 支持 800*480@13FPS 的屏幕刷新速率
 
 * 支持最多五点的屏幕触摸
 
 * 支持音频的输入和输出
 
 ## 所需硬件
 
-* 开发板
+* P4 开发板
 
    1. [ESP32-P4-Function-EV-Board](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32p4/esp32-p4-function-ev-board/user_guide.html#getting-started) 开发板
    2. 开发套件中的一块 1024*600 的 MIPI 屏幕
    3. 一个扬声器
 
+* S3 开发板
+
+   1. [ESP32-S3-LCD-EV-Board](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s3/esp32-s3-lcd-ev-board/user_guide.html#getting-started) 开发板
+   2. 开发套件中的一块 800\*480 / 480\*480 的 RGB 屏幕
+   3. 一个扬声器
+
+## 硬件连接
+
 * 连接
 
     1. 将开发板上的高速 USB 口连接到 PC 上
 
 ## 编译和烧录
 
-### P4 设备端
+### 设备端
 
 构建项目并将其烧录到板子上，然后运行监控工具以查看串行输出：
 
@@ -47,20 +57,38 @@ USB 扩展屏示例可以将 P4 开发板作为一块 windows 的副屏。支持
 
 ## 其他问题
 
-### 触摸屏控制的不是 P4 的屏幕
+### 触摸屏控制的不是设备端的屏幕
 
 * 在控制面板中选择 `平板电脑设置`
 
 * 在配置栏中选择 `设置`
 
-* 按照提示选择 P4 扩展屏
+* 按照提示选择扩展屏
 
 ### 调高/调低 JPEG 的图片质量
 
-* 修改 `usb_descriptor.c` 文件中的 `string_desc_arr` Vendor 接口字符串，将 `Ejpg4` 修改为所需的图片质量，数字越大质量越高，同样的一帧图像占用内存更多。
+* 修改 `CONFIG_USB_EXYEEND_SCREEN_JEPG_QUALITY`，数字越大质量越高，同样的一帧图像占用内存更多。
+
+### 修改副屏分辨率
+
+* 修改 `CONFIG_USB_EXTEND_SCREEN_HEIGHT` 和 `CONFIG_USB_EXTEND_SCREEN_WIDTH`
+
+Note: 目前驱动不支持竖屏的屏幕，请使用硬件上为横屏的屏幕。
+
+### 修改图像输出帧率
+
+* 修改 `CONFIG_USB_EXTEND_SCREEN_MAX_FPS`，降低该值可以有效的减少 USB 带宽，当 USB AUDIO 音频卡顿时，可以适当减少此值。
+
+### 修改一帧图像的最大值
+
+* 修改 `CONFIG_USB_EXTEND_SCREEN_FRAME_LIMIT_B`，可以限制 PC 驱动传来的图像最大长度。
+
+### 不启用触摸屏功能
+
+* 修改 `CONFIG_HID_TOUCH_ENABLE` 为 `n`
 
-### 修改屏幕分辨率
+### 不启用音频功能
 
-* 修改 `usb_descriptor.c` 文件中的 `string_desc_arr` Vendor 接口字符串，将 `R1024x600` 修改为所需的屏幕大小
+* 修改 `CONFIG_UAC_AUDIO_ENABLE` 为 `n`
 
-Note: 目前驱动不支持竖屏的屏幕，请使用硬件上为横屏的屏幕。
+Note: 当只启用副屏功能，请将 PID 修改为 `0x2987`

examples/usb/device/usb_extend_screen/common_components/bsp_extra/CMakeLists.txt

@@ -0,0 +1,8 @@
+file(GLOB_RECURSE SRCS src/*.c)
+
+set(priv_requires "esp32_s3_lcd_ev_board")
+
+idf_component_register(
+    SRCS ${SRCS}
+    INCLUDE_DIRS "include"
+    PRIV_REQUIRES ${priv_requires})

examples/usb/device/usb_extend_screen/common_components/bsp_extra/idf_component.yml

@@ -0,0 +1,11 @@
+## IDF Component Manager Manifest File
+dependencies:
+  idf: ">=5.0"
+
+  chmorgan/esp-audio-player: "1.0.*"
+  chmorgan/esp-file-iterator: "1.0.0"
+  espressif/led_strip: ^2
+
+  esp_codec_dev:
+    public: true
+    version: "~1.3.0"