Merge branch 'feat/add_usb_extend_lcd' into 'master'

feat: add usb extend screen

See merge request ae_group/esp-iot-solution!1058

Author: lijunru-hub

.gitlab/ci/build.yml

@@ -658,6 +658,14 @@ build_example_usb_device_usb_dual_uvc_device:
   variables:
     EXAMPLE_DIR: examples/usb/device/usb_dual_uvc_device
 
+build_example_usb_device_usb_extend_screen:
+  extends:
+    - .build_examples_template
+    - .rules:build:example_usb_device_usb_extend_screen
+  variables:
+    EXAMPLE_DIR: examples/usb/device/usb_extend_screen
+    IMAGE: espressif/idf:release-v5.3
+
 build_example_usb_device_usb_webcam:
   extends:
     - .build_examples_template

.gitlab/ci/deploy.yml

@@ -96,6 +96,7 @@ pack-upload_files:
     - job: "build_example_usb_host_usb_camera_mic_spk: [espressif/idf:release-v5.1]"
     - job: "build_example_usb_host_usb_cdc_4g_module: [espressif/idf:release-v5.1]"
     - job: "build_example_usb_host_usb_cdc_basic: [espressif/idf:release-v5.1]"
+    - job: "build_example_usb_device_usb_extend_screen"
   artifacts:
     when: always
     paths:

.gitlab/ci/rules.yml

@@ -502,6 +502,9 @@
 .patterns-example_usb_device_usb_dual_uvc_device: &patterns-example_usb_device_usb_dual_uvc_device
   - "examples/usb/device/usb_dual_uvc_device/**/*"
 
+.patterns-example_usb_device_usb_extend_screen: &patterns-example_usb_device_usb_extend_screen
+  - "examples/usb/device/usb_extend_screen/**/*"
+
 .patterns-example_usb_device_usb_webcam: &patterns-example_usb_device_usb_webcam
   - "examples/usb/device/usb_webcam/**/*"
 
@@ -1225,6 +1228,16 @@
     - <<: *if-dev-push
       changes: *patterns-components_avi_player
 
+.rules:build:example_usb_device_usb_extend_screen:
+  rules:
+    - <<: *if-protected
+    - <<: *if-label-build
+    - <<: *if-trigger-job
+    - <<: *if-dev-push
+      changes: *patterns-build_system
+    - <<: *if-dev-push
+      changes: *patterns-example_usb_device_usb_extend_screen
+
 .rules:build:example_usb_device_usb_webcam:
   rules:
     - <<: *if-protected

examples/.build-rules.yml

@@ -258,6 +258,10 @@ examples/usb/device/usb_webcam:
   enable:
     - if: IDF_TARGET in ["esp32s3","esp32s2"]
 
+examples/usb/device/usb_extend_screen:
+  enable:
+    - if: IDF_TARGET in ["esp32p4"]
+
 examples/usb/device/usb_hid_device:
   enable:
     - if: IDF_TARGET in ["esp32s2","esp32s3"]

examples/usb/device/usb_extend_screen/CMakeLists.txt

@@ -0,0 +1,7 @@
+# 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.16)
+
+include($ENV{IDF_PATH}/tools/cmake/project.cmake)
+add_compile_options(-Wno-ignored-qualifiers)
+project(usb_touch_screen)

examples/usb/device/usb_extend_screen/README.md

@@ -0,0 +1,54 @@
+## USB Extension Screen Example
+
+Try with [LaunchPad](https://espressif.github.io/esp-launchpad/?flashConfigURL=https://dl.espressif.com/AE/esp-iot-solution/config.toml)
+
+The USB Extension Screen Example allows the P4 development board to be used as an additional screen 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
+
+## 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
+
+* Connections
+  1. Connect the high-speed USB port on the development board to the PC
+
+## Compilation and Flashing
+
+### P4 Device Side
+
+Build the project and flash it to the board, then run the monitor tool to view 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
+
+(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.
+
+> Note: This example will fetch an AVI file online. Ensure that you are connected to the internet during the initial compilation.
+
+### PC Side
+
+For preparation, refer to the [windows_driver](./windows_driver/README.md)
+
+![Demo](https://dl.espressif.com/AE/esp-iot-solution/p4_usb_extern_screen.gif)
+
+## Other Issues
+
+### Touch Screen Does Not Control the P4 Screen
+
+* In the Control Panel, select `Tablet PC Settings`
+* In the configuration section, select `Setup`
+* Follow the prompts to choose the P4 extension screen
+
+### 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.

examples/usb/device/usb_extend_screen/README_cn.md

@@ -0,0 +1,60 @@
+## USB 扩展屏示例
+
+使用 [LaunchPad](https://espressif.github.io/esp-launchpad/?flashConfigURL=https://dl.espressif.com/AE/esp-iot-solution/config.toml) 烧录该示例
+
+USB 扩展屏示例可以将 P4 开发板作为一块 windows 的副屏。支持以下功能。
+
+* 支持 1024*600@60FPS 的屏幕刷新速率
+
+* 支持最多五点的屏幕触摸
+
+* 支持音频的输入和输出
+
+## 所需硬件
+
+* 开发板
+
+   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. 一个扬声器
+
+* 连接
+
+    1. 将开发板上的高速 USB 口连接到 PC 上
+
+## 编译和烧录
+
+### P4 设备端
+
+构建项目并将其烧录到板子上，然后运行监控工具以查看串行输出：
+
+* 运行 `. ./export.sh` 以设置 IDF 环境
+* 运行 `idf.py set-target esp32p4` 以设置目标芯片
+* 如果上一步出现任何错误，请运行 `pip install "idf-component-manager~=1.1.4"` 来升级你的组件管理器
+* 运行 `idf.py -p PORT flash monitor` 来构建、烧录并监控项目
+
+（要退出串行监视器，请按 `Ctrl-]`。）
+
+请参阅《入门指南》了解配置和使用 ESP-IDF 构建项目的所有步骤。
+
+>> 注意：此示例将在线获取 AVI 文件。请确保首次编译时连接互联网。
+
+### PC 端
+
+准备工作，请参考 [windows_driver](./windows_driver/README_cn.md)
+
+![Demo](https://dl.espressif.com/AE/esp-iot-solution/p4_usb_extern_screen.gif)
+
+## 其他问题
+
+### 触摸屏控制的不是 P4 的屏幕
+
+* 在控制面板中选择 `平板电脑设置`
+
+* 在配置栏中选择 `设置`
+
+* 按照提示选择 P4 扩展屏
+
+### 调高/调低 JPEG 的图片质量
+
+* 修改 `usb_descriptor.c` 文件中的 `string_desc_arr` Vendor 接口字符串，将 `Ejpg4` 修改为所需的图片质量，数字越大质量越高，同样的一帧图像占用内存更多。