Use uhubctl to disable and enable usb ports

Author: bugadani

.github/workflows/hil.yml

@@ -153,29 +153,29 @@ jobs:
           # RISC-V devices:
           - soc: esp32c2
             runner: esp32c2-jtag
-            usb: USB2
             host: aarch64
+            hubs: "1 3"
           - soc: esp32c3
             runner: esp32c3-usb
-            usb: ACM0
             host: armv7
+            hubs: "1-1"
           - soc: esp32c6
             runner: esp32c6-usb
-            usb: ACM0
             host: armv7
+            hubs: "1-1"
           - soc: esp32h2
             runner: esp32h2-usb
-            usb: USB0
             host: armv7
+            hubs: "1-1"
           # Xtensa devices:
           - soc: esp32s2
             runner: esp32s2-jtag
-            usb: USB1
             host: armv7
+            hubs: "1-1"
           - soc: esp32s3
             runner: esp32s3-usb
-            usb: USB0
             host: armv7
+            hubs: "1-1"
     steps:
       - uses: actions/download-artifact@v4
         with:
@@ -186,9 +186,22 @@ jobs:
         with:
           name: xtask-${{ matrix.target.host }}
 
+      - name: Enable USB ports
+        run: |
+          for hub in ${{ matrix.target.hubs }}; do
+            sudo uhubctl -a on -l $hub
+          done
+
       - name: Run Tests
         id: run-tests
         run: |
           export PATH=$PATH:/home/espressif/.cargo/bin
           chmod +x xtask
           ./xtask run-elfs ${{ matrix.target.soc }} tests-${{ matrix.target.soc }}
+
+      - name: Disable USB ports
+        if: ${{ always() }}
+        run: |
+          for hub in ${{ matrix.target.hubs }}; do
+            sudo uhubctl -a off -l $hub
+          done

hil-test/README.md

@@ -65,6 +65,8 @@ Some tests will require physical connections, please see the current [configurat
 ### Running Tests Remotes (ie. on Self-Hosted Runners)
 The [`hil.yml`] workflow builds the test suite for all our available targets and executes them.
 
+> The USB ports that are used by the devkits are powered DOWN between runs!
+
 Our self-hosted runners have the following setup:
 - ESP32-C2 (`esp32c2-jtag`):
   - Devkit: `ESP8684-DevKitM-1` connected via UART.
@@ -112,7 +114,7 @@ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --default-t
 # Source the current shell:
 . "$HOME/.cargo/env"
 # Install dependencies
-sudo apt install -y pkg-config libudev-dev
+sudo apt install -y pkg-config libudev-dev uhubctl
 # Install probe-rs
 cargo install probe-rs-tools --git https://github.com/probe-rs/probe-rs --rev 9bde591 --force
 # Add the udev rules