rename esp32_16MB_V4_M_eth_debug -> esp32_16MB_QEMU_debug

plus removed non-working "option 3" (online tool) for backtrace decoding

Author: softhack007

.github/scripts/monitor-qemu.py

@@ -89,5 +89,5 @@ def monitor_output(firmware_dir):
                 exception_lines = []
 
 if __name__ == '__main__':
-    firmware_dir = sys.argv[1] if len(sys.argv) > 1 else '.pio/build/esp32_16MB_V4_M_eth_debug'
+    firmware_dir = sys.argv[1] if len(sys.argv) > 1 else '.pio/build/esp32_16MB_QEMU_debug'
     monitor_output(firmware_dir)

.github/scripts/run-qemu.sh

@@ -9,7 +9,7 @@
 
 set -e
 
-FIRMWARE_DIR="${1:-.pio/build/esp32_16MB_V4_M_eth_debug}"
+FIRMWARE_DIR="${1:-.pio/build/esp32_16MB_QEMU_debug}"
 QEMU_DIR="${2:-qemu-esp32}"
 HTTP_PORT="${3:-8080}"  # Default to 8080 (non-privileged port)
 
@@ -54,7 +54,7 @@ echo "HTTP will be accessible at: http://localhost:${HTTP_PORT}"
 FLASH_IMAGE="/tmp/wled_flash.bin"
 echo "Creating flash image at $FLASH_IMAGE"
 
-# Create a 16MB flash image (0x1000000 bytes) for esp32_16MB_V4_M_eth_debug
+# Create a 16MB flash image (0x1000000 bytes) for esp32_16MB_QEMU_debug
 dd if=/dev/zero of="$FLASH_IMAGE" bs=1M count=16 2>/dev/null
 
 # Write bootloader at 0x1000

.github/workflows/qemu-e2e-test.yml

@@ -27,9 +27,9 @@ jobs:
         uses: actions/cache@v4
         with:
           path: ~/.platformio
-          key: ${{ runner.os }}-pio-esp32_16MB_V4_M_eth_debug-${{ hashFiles('**/platformio.ini') }}
+          key: ${{ runner.os }}-pio-esp32_16MB_QEMU_debug-${{ hashFiles('**/platformio.ini') }}
           restore-keys: |
-            ${{ runner.os }}-pio-esp32_16MB_V4_M_eth_debug-
+            ${{ runner.os }}-pio-esp32_16MB_QEMU_debug-
       
       - name: Set up Python
         uses: actions/setup-python@v5
@@ -52,13 +52,13 @@ jobs:
         run: npm run build
 
       - name: Build ESP32 firmware
-        run: pio run -e esp32_16MB_V4_M_eth_debug
+        run: pio run -e esp32_16MB_QEMU_debug
 
       - name: Upload firmware artifacts
         uses: actions/upload-artifact@v4
         with:
           name: esp32-firmware
-          path: .pio/build/esp32_16MB_V4_M_eth_debug/
+          path: .pio/build/esp32_16MB_QEMU_debug/
           retention-days: 1
 
   # Job 2: Test with QEMU ESP32
@@ -85,7 +85,7 @@ jobs:
         uses: actions/download-artifact@v4
         with:
           name: esp32-firmware
-          path: .pio/build/esp32_16MB_V4_M_eth_debug/
+          path: .pio/build/esp32_16MB_QEMU_debug/
 
       - name: Install Node.js dependencies
         run: npm ci
@@ -116,7 +116,7 @@ jobs:
       - name: Start QEMU with WLED firmware in background
         run: |
           chmod +x .github/scripts/run-qemu.sh
-          bash .github/scripts/run-qemu.sh .pio/build/esp32_16MB_V4_M_eth_debug qemu-esp32 8080 > qemu-output.log 2>&1 &
+          bash .github/scripts/run-qemu.sh .pio/build/esp32_16MB_QEMU_debug qemu-esp32 8080 > qemu-output.log 2>&1 &
           echo "Waiting for QEMU to start and WLED to boot..."
           sleep 45
       
@@ -206,12 +206,9 @@ jobs:
               echo ""
               echo "   Method B - Using ESP-IDF addr2line:"
               echo "     ~/.platformio/packages/toolchain-xtensa-esp32/bin/xtensa-esp32-elf-addr2line \\"
-              echo "       -pfiaC -e .pio/build/esp32_16MB_V4_M_eth_debug/firmware.elf \\"
+              echo "       -pfiaC -e .pio/build/esp32_16MB_QEMU_debug/firmware.elf \\"
               echo "       0x401771aa 0x4015b4c5 0x40134813 ..."
               echo ""
-              echo "   Method C - Using online decoder:"
-              echo "     https://github.com/me-no-dev/EspExceptionDecoder"
-              echo ""
               echo "4. The decoded output will show:"
               echo "   - Function names where the crash occurred"
               echo "   - Source file locations (file:line)"

docs/QEMU-ISSUES.md

@@ -2,9 +2,9 @@
 
 ## Build Configuration
 
-**Important**: QEMU testing uses the **V4 Mainline ethernet debug build** (`esp32_16MB_V4_M_eth_debug`).
+**Important**: QEMU testing uses the **V4 Mainline ethernet debug build** (`esp32_16MB_QEMU_debug`).
 
-### Why esp32_16MB_V4_M_eth_debug Build?
+### Why esp32_16MB_QEMU_debug Build?
 - **16MB Flash**: Provides sufficient space for all features and debugging symbols
 - WiFi hardware is not emulated in QEMU
 - WiFi initialization causes crashes in QEMU
@@ -158,7 +158,7 @@ pio device monitor --filter esp32_exception_decoder
 ```bash
 # Install toolchain (if not already from PlatformIO)
 ~/.platformio/packages/toolchain-xtensa-esp32/bin/xtensa-esp32-elf-addr2line \
-  -pfiaC -e .pio/build/esp32_16MB_V4_M_eth_debug/firmware.elf \
+  -pfiaC -e .pio/build/esp32_16MB_QEMU_debug/firmware.elf \
   0x401771aa 0x4015b4c5 0x40134813 0x40103cd0 0x40135d33 0x401383c6 0x4016107e
 ```
 

e2e-tests/README.md

@@ -36,7 +36,7 @@ Test the actual firmware running in QEMU ESP32 emulator:
 1. **Build the firmware**:
    ```bash
    npm run build  # Build web UI
-   pio run -e esp32_16MB_V4_M_eth_debug  # Build V4 M ethernet debug firmware (WiFi disabled, 15+ min first time)
+   pio run -e esp32_16MB_QEMU_debug  # Build V4 M ethernet debug firmware (WiFi disabled, 15+ min first time)
    ```
 
 2. **Setup QEMU** (first time only):
@@ -46,7 +46,7 @@ Test the actual firmware running in QEMU ESP32 emulator:
 
 3. **Run firmware in QEMU** (in a separate terminal):
    ```bash
-   bash .github/scripts/run-qemu.sh .pio/build/esp32_16MB_V4_M_eth_debug qemu-esp32 8080
+   bash .github/scripts/run-qemu.sh .pio/build/esp32_16MB_QEMU_debug qemu-esp32 8080
    ```
 
    Wait ~30-45 seconds for ESP32 to boot and start the web server.

platformio.ini

@@ -1833,7 +1833,7 @@ lib_ignore = IRremoteESP8266 ; use with WLED_DISABLE_INFRARED for faster compila
 
 
 ## for testing with QEMU
-[env:esp32_16MB_V4_M_eth_debug]
+[env:esp32_16MB_QEMU_debug]
 extends = esp32_4MB_V4_M_base
 board = esp32_16MB-poe       ;; needed for ethernet boards (selects "esp32-poe" as variant)
 board_build.partitions = ${esp32.extreme_partitions} ;; WLED extended for 16MB flash: 3.2MB firmware,  9 MB filesystem