espressif · peter-marcisovsky · Apr 10, 2026 · Apr 8, 2026
diff --git a/.github/ci/.build_and_run_idf_examples_config.toml b/.github/ci/.build_and_run_idf_examples_config.toml
@@ -7,6 +7,7 @@
 
 paths = [
     "examples/peripherals/usb/device",     # ESP-IDF USB Device examples path
+    "examples/network/sta2eth",            # Networking example using USB Device
 ]
 
 # Exclude cherryusb-based device examples

diff --git a/.github/ci/.idf-build-examples-rules.yml b/.github/ci/.idf-build-examples-rules.yml
@@ -7,3 +7,7 @@ examples/peripherals/usb/device:
 examples/peripherals/usb/device/tusb_ncm:
   disable:
     - if: SOC_USB_OTG_SUPPORTED != 1 or SOC_WIFI_SUPPORTED != 1
+
+examples/network/sta2eth:
+  disable:
+    - if: SOC_USB_OTG_SUPPORTED != 1 or SOC_WIFI_SUPPORTED != 1
diff --git a/.github/workflows/build_and_run_esp_usb_test_apps.yml b/.github/workflows/build_and_run_esp_usb_test_apps.yml
@@ -28,28 +28,33 @@ jobs:
       IDF_BUILD_APPS_VER: "2.13.3"
       # We are cloning esp-usb repo to get the test apps to build, the paths should be configured explicitly
       ESP_USB_PATH: esp-usb
-      ESP_USB_CONFIG_FILE: esp-usb/.idf_build_apps.toml
-      ESP_USB_MANIFEST: esp-usb/.build-test-rules.yml
-      ESP_USB_IGNORE_WARNING_FILE: esp-usb/.ignore_build_warnings.txt
       ESP_TINYUSB_TEST_APPS: esp-usb/device/esp_tinyusb/test_apps
     steps:
       - uses: actions/checkout@v5
         with:
           submodules: 'true'
       - name: Clone esp-usb repository
         run: |
-            git clone https://github.com/espressif/esp-usb.git
+            git clone https://github.com/espressif/esp-usb.git || {
+              echo "git clone of esp-usb repository failed"
+              exit 1
+            }
       - name: Build
         shell: bash
         run: |
+
           . ${IDF_PATH}/export.sh
           pip install --no-cache-dir idf-build-apps==${{ env.IDF_BUILD_APPS_VER }} pyyaml --upgrade
           export PEDANTIC_FLAGS="-DIDF_CI_BUILD -Werror -Werror=deprecated-declarations -Werror=unused-variable -Werror=unused-but-set-variable -Werror=unused-function"
           export EXTRA_CFLAGS="${PEDANTIC_FLAGS} -Wstrict-prototypes"
           export EXTRA_CXXFLAGS="${PEDANTIC_FLAGS}"
           python .github/ci/override_managed_component.py tinyusb . ${{ env.ESP_TINYUSB_TEST_APPS }}/*/
-          idf-build-apps find --config-file ${{ env.ESP_USB_CONFIG_FILE }} -p ${{ env.ESP_TINYUSB_TEST_APPS }} -t all --manifest-files ${{ env.ESP_USB_MANIFEST }} --manifest-rootpath ${{ env.ESP_USB_PATH }}
-          idf-build-apps build --config-file ${{ env.ESP_USB_CONFIG_FILE }} -p ${{ env.ESP_TINYUSB_TEST_APPS }} -t all --manifest-files ${{ env.ESP_USB_MANIFEST }} --manifest-rootpath ${{ env.ESP_USB_PATH }} --ignore-warning-files ${{ env.ESP_USB_IGNORE_WARNING_FILE }}
+
+          # Config and manifest files for idf-build-apps are used from the esp-usb repository automatically
+          # Here we only overload path using CLI parameter -p to build only device test apps
+          cd ${{ env.ESP_USB_PATH }}
+          idf-build-apps find -p device --disable-targets esp32s31
+          idf-build-apps build -p device --disable-targets esp32s31
       - uses: actions/upload-artifact@v6
         with:
           # Test apps builds live under the repository workspace, we use workspace-relative glob

diff --git a/.github/workflows/build_and_run_idf_examples.yml b/.github/workflows/build_and_run_idf_examples.yml
@@ -11,6 +11,8 @@ concurrency:
 
 jobs:
   build:
+    # Run the workflow, only with BUILD_AND_TEST_EXTERNAL_EXAMPLES PR label
+    if: contains(github.event.pull_request.labels.*.name, 'BUILD_AND_TEST_EXTERNAL_EXAMPLES')
     name: Build
     strategy:
       fail-fast: false
@@ -24,44 +26,53 @@ jobs:
       IDF_BUILD_APPS_VER: "2.13.3"
       CONFIG_PATH: ${{ github.workspace }}/.github/ci/.build_and_run_idf_examples_config.toml
       MANIFEST_PATH: ${{ github.workspace }}/.github/ci/.idf-build-examples-rules.yml
+      USB_DEVICE_EXAMPLES_PATH: ${{ github.workspace }}  # Will be set-up in "Setup IDF Examples path" step
+      NETWORK_EXAMPLES_PATH: ${{ github.workspace }}  # Will be set-up in "Setup IDF Examples path" step
     steps:
       - uses: actions/checkout@v5
       - name: Install Python dependencies
         shell: bash
         run: |
           . ${IDF_PATH}/export.sh
           pip install --no-cache-dir idf-build-apps==${{ env.IDF_BUILD_APPS_VER }} pyyaml --upgrade
-      - name: Build Network USB related examples
-        shell: bash
+      - name: Setup IDF Examples path
         run: |
+
+          # USB Host and USB Device examples path
+          echo "USB_DEVICE_EXAMPLES_PATH=${IDF_PATH}/examples/peripherals/usb/device" >> $GITHUB_ENV
+
+          # Networking example using USB Device path
+          echo "NETWORK_EXAMPLES_PATH=${IDF_PATH}/examples/network/sta2eth" >> $GITHUB_ENV
+      - name: Override device component
+        run: |
+
           . ${IDF_PATH}/export.sh
-          # Hint: To build network example we just use default config and network build rules provided by IDF
-          export EXAMPLES_PATH="${IDF_PATH}/examples/network/sta2eth"
-          export MANIFEST_FILE="${IDF_PATH}/examples/network/.build-test-rules.yml"
-          python .github/ci/override_managed_component.py tinyusb . ${EXAMPLES_PATH}
-          idf-build-apps find -p ${EXAMPLES_PATH} -t esp32s2 --manifest-files ${MANIFEST_FILE} --manifest-rootpath ${IDF_PATH}
-          idf-build-apps build -p ${EXAMPLES_PATH} -t esp32s2 --manifest-files ${MANIFEST_FILE} --manifest-rootpath ${IDF_PATH}
+          # Override device component in USB device examples
+          python .github/ci/override_managed_component.py tinyusb . ${{ env.USB_DEVICE_EXAMPLES_PATH }}/*
+          # Override device component in network examples
+          python .github/ci/override_managed_component.py tinyusb . ${{ env.NETWORK_EXAMPLES_PATH }}
       - name: Build USB Device examples
         shell: bash
         run: |
+
           . ${IDF_PATH}/export.sh
-          python .github/ci/override_managed_component.py tinyusb . ${IDF_PATH}/examples/peripherals/usb/device/tusb_*
           cd ${IDF_PATH}
-          idf-build-apps find --config-file ${CONFIG_PATH} --manifest-file ${MANIFEST_PATH}
-          idf-build-apps build --config-file ${CONFIG_PATH} --manifest-file ${MANIFEST_PATH}
+
+          idf-build-apps find --config-file ${CONFIG_PATH} --manifest-file ${MANIFEST_PATH} --disable-targets esp32s31
+          idf-build-apps build --config-file ${CONFIG_PATH} --manifest-file ${MANIFEST_PATH} --disable-targets esp32s31
       - uses: actions/upload-artifact@v6
-        env:
-          IDF_ROOT: "/opt/esp/idf"
         with:
           # We upload only USB Device example binaries to run them on the target
           name: usb_device_examples_bin_${{ matrix.idf_ver }}
           path: |
-              ${{ env.IDF_ROOT }}/**/build_esp*/bootloader/bootloader.bin
-              ${{ env.IDF_ROOT }}/**/build_esp*/partition_table/partition-table.bin
-              ${{ env.IDF_ROOT }}/**/build_esp*/tusb_*.bin
-              ${{ env.IDF_ROOT }}/**/build_esp*/tusb_*.elf
-              ${{ env.IDF_ROOT }}/**/build_esp*/flasher_args.json
-              ${{ env.IDF_ROOT }}/**/build_esp*/config/sdkconfig.json
+              ${{ env.USB_DEVICE_EXAMPLES_PATH }}/**/build_esp*/bootloader/bootloader.bin
+              ${{ env.USB_DEVICE_EXAMPLES_PATH }}/**/build_esp*/partition_table/partition-table.bin
+              ${{ env.USB_DEVICE_EXAMPLES_PATH }}/**/build_esp*/tusb_*.bin
+              ${{ env.USB_DEVICE_EXAMPLES_PATH }}/**/build_esp*/tusb_*.elf
+              ${{ env.USB_DEVICE_EXAMPLES_PATH }}/**/build_esp*/flasher_args.json
+              ${{ env.USB_DEVICE_EXAMPLES_PATH }}/**/build_esp*/config/sdkconfig.json
+              ${{ env.USB_DEVICE_EXAMPLES_PATH }}/**/pytest_*.py
+              ${{ env.USB_DEVICE_EXAMPLES_PATH }}/**/sdkconfig.*
           if-no-files-found: error
   run-target:
     name: Run
@@ -71,27 +82,21 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        idf_ver: ["release-v5.2", "release-v5.3", "release-v5.4", "release-v5.5", "release-v6.0", "latest"]
+        idf_ver: [
+          # Only run for IDF >= 5.4,
+          # For lower IDF versions, running pytest files from esp-idf outside of esp-idf container is too complicated
+          "release-v5.4",
+          "release-v5.5",
+          "release-v6.0",
+          "latest"]
         idf_target: ["esp32s2", "esp32p4"]
         runner_tag: ["usb_device"]
         eco_ver: ["eco_default", "eco4"]
         exclude:
-          # Exclude all "latest" runs for esp32p4 till the transition to ECO5 will be done
-          - idf_ver: "latest"
-            idf_target: "esp32p4"
-          # Exclude esp32p4 for releases before IDF 5.3 for all runner tags (esp32p4 support starts in IDF 5.3)
-          - idf_ver: "release-v5.2"
-            idf_target: "esp32p4"
           # Exclude eco4 version for esp32s2
           - idf_target: "esp32s2"
             eco_ver: "eco4"
           # Exclude eco_default for older IDF versions, esp32p4 ECO6 support starts in IDF 5.5
-          - idf_target: "esp32p4"
-            eco_ver: "eco_default"
-            idf_ver: "release-v5.2"
-          - idf_target: "esp32p4"
-            eco_ver: "eco_default"
-            idf_ver: "release-v5.3"
           - idf_target: "esp32p4"
             eco_ver: "eco_default"
             idf_ver: "release-v5.4"
@@ -108,13 +113,17 @@ jobs:
     runs-on: [self-hosted, linux, docker, "${{ matrix.idf_target }}", "${{ matrix.runner_tag }}", "${{ matrix.eco_ver }}"]
     container:
       # We run on espressif/idf image as we need the code of examples to be present to run pytest
-      image: espressif/idf:${{ matrix.idf_ver }}
+      image: python:3.11-bookworm
       options: --privileged --device-cgroup-rule="c 188:* rmw" --device-cgroup-rule="c 166:* rmw"
     env:
-      # We do not use ${IDF_PATH} here, because it is not available during download of artifacts step
-      IDF_ROOT: "/opt/esp/idf"
-      IDF_EXAMPLES_PATH: "${IDF_PATH}/examples/peripherals/usb/device"
+      # matrix-specific path to esp-idf Device examples
+      # eg: /__w/tinyusb/tinyusb/esp-usb/idf_examples_release-v5.4_esp32s2_usb_device/tusb_hid/build_esp32s2_default
+      USB_DEVICE_EXAMPLES_PATH: ${{ github.workspace }}  # Will be set-up in "Setup IDF Examples path" step
+      # matrix-specific directory to which Device example will be downloaded
+      # eg: idf_examples_release-v5.4_esp32s2_usb_device
+      USB_DEVICE_EXAMPLES_DIR: ${{ github.workspace }}  # Will be set-up in "Setup IDF Examples path" step
     steps:
+      - uses: actions/checkout@v5
       - name: ⚙️ Install System tools
         run: |
           apt update
@@ -123,15 +132,29 @@ jobs:
         env:
           PIP_EXTRA_INDEX_URL: "https://dl.espressif.com/pypi/"
         run: |
-          . ${IDF_PATH}/export.sh
           pip install --no-cache-dir --only-binary cryptography pytest-embedded pytest-embedded-serial-esp pytest-embedded-idf pyserial pyusb idf-ci pytest-ignore-test-results pytest-timeout netifaces
+      - name: Clone esp-usb repository
+        run: |
+            # Clone the esp-usb repository only to get the pytest.ini file
+            git clone https://github.com/espressif/esp-usb.git || {
+              echo "git clone of esp-usb repository failed"
+              exit 1
+            }
+      - name: Setup IDF Examples path
+      # Create matrix-specific directory name inside esp-usb dir (so we can run pytest with esp-usb's pytest.ini file)
+      # and save it's path to the USB_DEVICE_EXAMPLES_PATH variable
+        run: |
+          cd esp-usb
+          EXAMPLES_DIR="idf_examples_${{ matrix.idf_ver }}_${{ matrix.idf_target }}_${{ matrix.runner_tag }}"
+          echo "USB_DEVICE_EXAMPLES_DIR=${EXAMPLES_DIR}" >> "$GITHUB_ENV"
+          mkdir -p "$EXAMPLES_DIR" && cd "$EXAMPLES_DIR" && pwd
+          echo "USB_DEVICE_EXAMPLES_PATH=$(pwd)" >> "$GITHUB_ENV"
       - uses: actions/download-artifact@v7
         with:
-          # Need to set the path manually.
-          # The examples were built on a system files, which are not under the repository.
+          # Download the artifacts to esp-usb subdirectory to be able to run pytest with esp-usb's pytest.ini
           name: usb_device_examples_bin_${{ matrix.idf_ver }}
-          path: ${{ env.IDF_ROOT }}
+          path: ${{ env.USB_DEVICE_EXAMPLES_PATH }}
       - name: Run on target
         run: |
-          . ${IDF_PATH}/export.sh
-          pytest ${{ env.IDF_EXAMPLES_PATH }} --target ${{ matrix.idf_target }} -m ${{ matrix.runner_tag }} --ignore-result-cases=*ncm_example --build-dir=build_${{ matrix.idf_target }}
+          cd esp-usb
+          pytest ${{ env.USB_DEVICE_EXAMPLES_DIR }} --target ${{ matrix.idf_target }} -m ${{ matrix.runner_tag }} --ignore-result-cases="*ncm_example*"
diff --git a/.github/workflows/build_iot_examples.yml b/.github/workflows/build_iot_examples.yml
@@ -6,6 +6,8 @@ on:
 
 jobs:
   build:
+    # Run the workflow, only with BUILD_AND_TEST_EXTERNAL_EXAMPLES PR label
+    if: contains(github.event.pull_request.labels.*.name, 'BUILD_AND_TEST_EXTERNAL_EXAMPLES')
     name: Build
     strategy:
       matrix: