update userdemo version v1.0

Author: Ocean-lhy

.gitattributes

@@ -0,0 +1,4 @@
+components/otool_esp_component/** -text
+components/M5IOE1/** -text
+components/M5PM1/** -text
+components/m5_py32bin_tools/** -text

.github/workflows/Arduino-Lint-Check.yml

@@ -36,8 +36,11 @@
 
 # Build files
 build/
+build-*/
 cmake-build-*/
 managed_components/
+/sdkconfig
+/sdkconfig.idf*
 
 # PlatformIO
 .pio/

.gitignore

@@ -0,0 +1,6 @@
+[submodule "components/M5PM1"]
+	path = components/M5PM1
+	url = https://github.com/m5stack/M5PM1.git
+[submodule "components/M5IOE1"]
+	path = components/M5IOE1
+	url = https://github.com/m5stack/M5IOE1.git

.gitmodules

@@ -0,0 +1,43 @@
+cmake_minimum_required(VERSION 3.16)
+
+if(POLICY CMP0079)
+    cmake_policy(SET CMP0079 NEW)
+endif()
+
+# The vendored Wi-Fi Remote component uses this value to select its Kconfig.
+set(ENV{ESP_IDF_VERSION} "6.1")
+
+# This project embeds every enabled audio asset in the factory application
+# image. Force the list empty so an existing build cache cannot retain an older
+# file-backed audio configuration.
+set(OTOOL_AUDIO_EXTERNAL_FILES ""
+    CACHE INTERNAL "No project-managed external audio files" FORCE)
+
+include($ENV{IDF_PATH}/tools/cmake/project.cmake)
+project(m5corep4x_user_demo)
+
+if(NOT IDF_VERSION_MAJOR EQUAL 6 OR NOT IDF_VERSION_MINOR EQUAL 1)
+    message(FATAL_ERROR
+        "M5CoreP4X UserDemo requires ESP-IDF 6.1; found ${IDF_VERSION} at $ENV{IDF_PATH}")
+endif()
+
+# Required dependency fixes for the vendored components under ESP-IDF 6.1.
+idf_component_get_property(esp_dsp_lib espressif__esp-dsp COMPONENT_LIB)
+if(TARGET ${esp_dsp_lib})
+    target_compile_options(${esp_dsp_lib} PRIVATE
+        "$<$<COMPILE_LANGUAGE:CXX>:-include>"
+        "$<$<COMPILE_LANGUAGE:CXX>:cmath>")
+endif()
+
+idf_component_get_property(i2c_bus_lib espressif__i2c_bus COMPONENT_LIB)
+if(TARGET ${i2c_bus_lib} AND TARGET idf::esp_driver_gpio)
+    target_link_libraries(${i2c_bus_lib} PRIVATE idf::esp_driver_gpio)
+endif()
+
+idf_component_get_property(esp_hosted_mcu_lib esp-hosted-mcu COMPONENT_LIB)
+if(TARGET ${esp_hosted_mcu_lib} AND TARGET idf::esp_driver_sdmmc AND TARGET idf::esp_driver_dma AND TARGET idf::esp_driver_gpio)
+    target_link_libraries(${esp_hosted_mcu_lib} PRIVATE
+        idf::esp_driver_sdmmc
+        idf::esp_driver_dma
+        idf::esp_driver_gpio)
+endif()

CMakeLists.txt

@@ -1,48 +1,58 @@
-# Product Name
+# M5CoreP4X UserDemo
 
-## Overview
+M5CoreP4X UserDemo is the preinstalled ESP-IDF demonstration firmware for the M5Stack M5CoreP4X. It presents the complete device UI and demonstrates board-level capabilities including power control, display, touch, audio, RTC, IMU, microSD, Ethernet, ESP-Hosted Wi-Fi, USB Host, infrared, and Grove I2C.
 
-### SKU:xxx
+## Hardware and Environment
 
-Description of the product
+- M5Stack M5CoreP4X with ESP32-P4, 16 MiB flash, and PSRAM
+- M5Stack A172 Stamp-AddOn C6 For P4 module with compatible ESP-Hosted slave firmware (required for Wi-Fi)
+- ESP-IDF v6.1
+- Optional microSD card, Ethernet connection, USB devices, and Grove I2C peripherals
 
-## Related Link
+## Demonstrated Features
 
-- [Document & Datasheet](https://docs.m5stack.com/en/unit/product_Link)
+After startup, the device opens the LVGL Startup screen. Users can swipe between the main status, Info, and Function screens. The Function screen provides interactive pages for power control, touch, microSD, I2C scanning, IMU, recording, network ping, Wi-Fi, USB, infrared transmit and receive, music, sleep, and power-off operations.
 
-## Required Libraries:
+The startup path initializes board power, RTC, audio, Ethernet, LCD, and touch. Ethernet connection waiting, the startup sound, and time-consuming page operations run in background tasks. The absence of an optional peripheral does not prevent the remaining demonstration pages from starting.
 
-- [Adafruit_BMP280_Library](https://github.com/adafruit/Required_Libraries_Link)
+## Build
 
-## License
-
-- [Product Name- MIT](LICENSE)
-
-## Remaining steps(Editorial Staff Look,After following the steps, remember to delete all the content below)
+```bash
+source esp-idf/export.sh
+idf.py -B build set-target esp32p4
+idf.py -B build build
+```
 
-1. Change [clang format check path](./.github/workflows/clang-format-check.yml#L42-L47).
-2. Add License content to [LICENSE](/LICENSE).
-3. Change link on line 78 of [bug-report.yml](./.github/ISSUE_TEMPLATE/bug-report.yml#L79).
+The application image is generated at:
 
-```cpp
-Example
-# M5Unit-ENV
+```text
+build/m5corep4x_user_demo.bin
+```
 
-## Overview
+## Flash and Monitor
 
-### SKU:U001 & U001-B & U001-C
+Connect the download/debug USB port and replace the serial port with the one assigned by the host:
 
-Contains M5Stack-**UNIT ENV** series related case programs.ENV is an environmental sensor with integrated SHT30 and QMP6988 internally to detect temperature, humidity, and atmospheric pressure data.
+```bash
+idf.py -B build -p /dev/ttyACM0 flash monitor
+```
 
-## Related Link
+## Repository Layout
 
-- [Document & Datasheet](https://docs.m5stack.com/en/unit/envIII)
+- `main/`: application entry point, startup initialization, and firmware metadata
+- `components/m5_corep4_component/`: M5CoreP4X board support, LVGL UI, and function pages
+- `components/otool_esp_component/`: shared peripheral and audio utilities
+- `sdkconfig.defaults`: ESP32-P4, flash, PSRAM, network, and component configuration baseline
+- `partitions.csv`: application, NVS, PHY, and SPIFFS partition definitions
+- `THIRD_PARTY_SOURCES.md`: sources and pinned versions for bundled third-party code
+- `USER_DEMO_CODE_REVIEW_CN.md`: Chinese engineering review produced using the User Demo review standard
 
-## Required Libraries:
+## Known Boundaries
 
-- [Adafruit_BMP280_Library](https://github.com/adafruit/Adafruit_BMP280_Library)
+- A successful build does not replace hardware validation. Touch, audio, wireless, networking, and repeated page-entry stability must still be tested on an M5CoreP4X before release.
+- Wi-Fi requires the A172 Stamp-AddOn C6 For P4 module. It uses ESP-Hosted communication between the module's ESP32-C6 and the ESP32-P4; when Wi-Fi fails, first verify that the module is installed, then check its slave firmware, power rails, and SDIO connection.
+- The microSD card uses SPI mode to avoid contention with the SDMMC resources used by ESP-Hosted.
 
 ## License
 
-- [M5Unit-ENV - MIT](LICENSE)
-```
+See [LICENSE](LICENSE) for the project license. Bundled third-party components remain subject to their respective licenses; see [THIRD_PARTY_SOURCES.md](THIRD_PARTY_SOURCES.md) for source details.

README.md

@@ -0,0 +1,37 @@
+# Vendored third-party sources
+
+The following Git-hosted dependencies are stored in this repository as
+ordinary source files. A checkout does not need to initialize Git submodules
+for these paths.
+
+| Path | Upstream | Commit | License |
+| --- | --- | --- | --- |
+| `components/otool_esp_component` | <https://github.com/onexs-xsi/otool_esp_component.git> | `82406f282adfe54e7bee5f46f9b54ba935e953b4` | MIT |
+| `components/M5IOE1` | <https://github.com/m5stack/M5IOE1.git> | `846eec7d05e25c09013be2acdb8804487f48a62e` | MIT |
+| `components/M5PM1` | <https://github.com/m5stack/M5PM1.git> | `be9a5456c007c333e7ac963f33bfde1ffa5d82ee` | MIT |
+| `components/otool_esp_component/otool_bmi270/BMI270_SensorAPI` | <https://github.com/boschsensortec/BMI270_SensorAPI.git> | `41129fcfe39c583ee5462d79195741945d51c1fe` | BSD-3-Clause |
+| `components/otool_esp_component/otool_bmi270/BMM150_SensorAPI` | <https://github.com/boschsensortec/BMM150_SensorAPI.git> | `0dce0617873cda1f6d51f6b7b961fdc2641e0c7c` | BSD-3-Clause |
+| `components/m5_py32bin_tools` | <https://gitlab.m5stack.com/moyongming/m5_py32bin_tools> | `779b99e7e094d5f254f040291a2498b0e369014e` | MIT (declared in `idf_component.yml`) |
+
+The snapshots were exported from the commits above with
+`git -c core.autocrlf=false archive` on 2026-07-28. Their upstream license
+files are retained in each source tree. The `m5_py32bin_tools` commit does
+not contain a standalone license file; its component manifest declares MIT.
+The vendored paths are marked `-text` in the root `.gitattributes` so Git
+preserves the upstream byte content, including mixed LF and CRLF line
+endings.
+
+The upstream-tracked `gui/build` and `gui/dist` directories in
+`m5_py32bin_tools` are generated PyInstaller artifacts (about 190 MB) and
+are intentionally excluded. The GUI source, build script, specification,
+firmware data, examples, and component source are retained.
+
+To update a snapshot, export the new fixed commit into a clean temporary
+directory, overlay any nested vendored trees, replace only the corresponding
+tracked source directory, update this table, and run the offline dependency
+contract plus a full firmware build. Do not copy ignored files, generated
+build artifacts, or a submodule's `.git` metadata into the repository.
+
+No active Git submodules remain. Upstream links in component manifests and
+documentation are informational metadata, not fetch configuration. ESP-IDF
+Component Manager dependencies remain unchanged.

THIRD_PARTY_SOURCES.md

@@ -0,0 +1,3 @@
+idf_component_register(SRCS "cJSON/cJSON.c"
+                            "cJSON/cJSON_Utils.c"
+                    INCLUDE_DIRS cJSON)