Refactor GitHub workflows to remove paths-ignore for test files and update README with parallel flashing and erasing instructions

Author: PaulFirs

.github/workflows/test-erase.yml

@@ -12,10 +12,6 @@ on:
       - '.github/actions/setup-jlink-network/**'
       - '.github/workflows/test-erase.yml'
       - '.github/workflows/fw.*'
-    paths-ignore:
-      - '.github/workflows/test-scan.yml'
-      - '.github/workflows/test-flash.yml'
-      - '.github/workflows/test-rtt.yml'
   pull_request:
     paths:
       - 'src/bmlab_toolkit/erase_cli.py'
@@ -26,10 +22,6 @@ on:
       - '.github/actions/setup-jlink-network/**'
       - '.github/workflows/test-erase.yml'
       - '.github/workflows/fw.*'
-    paths-ignore:
-      - '.github/workflows/test-scan.yml'
-      - '.github/workflows/test-flash.yml'
-      - '.github/workflows/test-rtt.yml'
   workflow_dispatch:
 
 env:

.github/workflows/test-flash.yml

@@ -12,10 +12,6 @@ on:
       - '.github/actions/setup-jlink-network/**'
       - '.github/workflows/test-flash.yml'
       - '.github/workflows/fw.*'
-    paths-ignore:
-      - '.github/workflows/test-scan.yml'
-      - '.github/workflows/test-erase.yml'
-      - '.github/workflows/test-rtt.yml'
   pull_request:
     paths:
       - 'src/bmlab_toolkit/flashing.py'
@@ -26,10 +22,6 @@ on:
       - '.github/actions/setup-jlink-network/**'
       - '.github/workflows/test-flash.yml'
       - '.github/workflows/fw.*'
-    paths-ignore:
-      - '.github/workflows/test-scan.yml'
-      - '.github/workflows/test-erase.yml'
-      - '.github/workflows/test-rtt.yml'
   workflow_dispatch:
 
 env:

.github/workflows/test-rtt.yml

@@ -12,10 +12,6 @@ on:
       - '.github/actions/setup-jlink-network/**'
       - '.github/workflows/test-rtt.yml'
       - '.github/workflows/fw.*'
-    paths-ignore:
-      - '.github/workflows/test-scan.yml'
-      - '.github/workflows/test-flash.yml'
-      - '.github/workflows/test-erase.yml'
   pull_request:
     paths:
       - 'src/bmlab_toolkit/rtt_cli.py'
@@ -26,10 +22,6 @@ on:
       - '.github/actions/setup-jlink-network/**'
       - '.github/workflows/test-rtt.yml'
       - '.github/workflows/fw.*'
-    paths-ignore:
-      - '.github/workflows/test-scan.yml'
-      - '.github/workflows/test-flash.yml'
-      - '.github/workflows/test-erase.yml'
   workflow_dispatch:
 
 env:

.github/workflows/test-scan.yml

@@ -11,10 +11,6 @@ on:
       - 'pyproject.toml'
       - '.github/actions/setup-jlink-network/**'
       - '.github/workflows/test-scan.yml'
-    paths-ignore:
-      - '.github/workflows/test-flash.yml'
-      - '.github/workflows/test-erase.yml'
-      - '.github/workflows/test-rtt.yml'
   pull_request:
     paths:
       - 'src/bmlab_toolkit/scan_cli.py'
@@ -24,10 +20,6 @@ on:
       - 'pyproject.toml'
       - '.github/actions/setup-jlink-network/**'
       - '.github/workflows/test-scan.yml'
-    paths-ignore:
-      - '.github/workflows/test-flash.yml'
-      - '.github/workflows/test-erase.yml'
-      - '.github/workflows/test-rtt.yml'
   workflow_dispatch:
 
 env:

README.md

@@ -44,6 +44,16 @@ Flash with specific MCU:
 bmlab-flash <firmware_file> --mcu STM32F765ZG
 ```
 
+Flash multiple devices via IP addresses (parallel):
+```bash
+bmlab-flash firmware.bin --ip 192.168.1.100 192.168.1.101 192.168.1.102 --mcu STM32F765ZG
+```
+
+Flash multiple devices via USB serial (sequential due to USB driver limitations):
+```bash
+bmlab-flash firmware.bin --serial 123456 789012 345678 --mcu STM32F103RE
+```
+
 Specify programmer explicitly:
 ```bash
 bmlab-flash <firmware_file> --programmer jlink --serial 123456
@@ -88,13 +98,42 @@ bmlab-rtt -v
 
 # Specify programmer explicitly (default: jlink)
 bmlab-rtt --programmer jlink --serial 123456
+
+# Monitor multiple devices via IP (parallel, saves logs to files)
+bmlab-rtt --ip 192.168.1.100 192.168.1.101 192.168.1.102 --output-dir rtt_logs --timeout 10
+
+# Monitor multiple devices via USB (sequential, saves logs to files)
+bmlab-rtt --serial 123456 789012 --mcu STM32F103RE --output-dir rtt_logs --timeout 10
 ```
 
+**Note:** Multiple devices require `--output-dir`. Logs are saved as `rtt_192_168_1_100.log` or `rtt_serial_123456.log`.
+
 Get RTT help:
 ```bash
 bmlab-rtt --help
 ```
 
+### Erasing Flash Memory
+
+Erase flash memory on a device:
+
+```bash
+# Erase with auto-detected device
+bmlab-erase --mcu STM32F103RE
+
+# Erase specific device by serial
+bmlab-erase --serial 123456 --mcu STM32F103RE
+
+# Erase device via IP
+bmlab-erase --ip 192.168.1.100 --mcu STM32F765ZG
+
+# Erase multiple devices via IP (parallel)
+bmlab-erase --ip 192.168.1.100 192.168.1.101 192.168.1.102 --mcu STM32F103RE
+
+# Erase multiple devices via USB (sequential)
+bmlab-erase --serial 123456 789012 345678 --mcu STM32F103RE
+```
+
 ### Scanning for Devices
 
 Scan for USB-connected JLink devices:
@@ -114,65 +153,6 @@ bmlab-scan --network 192.168.1.0/24 --start-ip 100 --end-ip 150
 bmlab-scan --network 192.168.1.0/24 --log-level DEBUG
 ```
 
-### Parallel Flashing
-
-Flash multiple devices simultaneously using the provided script:
-
-```bash
-# Flash multiple IPs from command line
-examples/parallel_flash.sh firmware.bin 192.168.1.100 192.168.1.101 192.168.1.102
-
-# Flash with specific MCU type
-examples/parallel_flash.sh --mcu STM32F765ZG firmware.bin 192.168.1.100 192.168.1.101
-
-# Flash from IP list file
-cat > ips.txt << EOF
-192.168.1.100
-192.168.1.101
-192.168.1.102
-EOF
-
-examples/parallel_flash.sh firmware.bin $(cat ips.txt)
-```
-
-The script outputs simple status for each device:
-```
-192.168.1.100 OK
-192.168.1.101 OK
-192.168.1.102 FAULT
-```
-
-### Parallel RTT Reading
-
-Read RTT from multiple devices simultaneously and save to log files:
-
-```bash
-# Read RTT from multiple devices (default 10 seconds)
-examples/parallel_rtt.sh 192.168.1.100 192.168.1.101 192.168.1.102
-
-# Read for 30 seconds with specific MCU
-examples/parallel_rtt.sh --mcu STM32F765ZG --timeout 30 192.168.1.100 192.168.1.101
-
-# Read indefinitely until Ctrl+C
-examples/parallel_rtt.sh --timeout 0 192.168.1.100 192.168.1.101
-
-# Read from IP list file
-examples/parallel_rtt.sh $(cat ips.txt)
-```
-
-Output:
-```
-Output directory: rtt_logs_20251214_143052
-
-192.168.1.100 OK (saved to rtt_logs_20251214_143052/rtt_192.168.1.100.log)
-192.168.1.101 OK (saved to rtt_logs_20251214_143052/rtt_192.168.1.101.log)
-192.168.1.102 FAULT (see rtt_logs_20251214_143052/rtt_192.168.1.102.log)
-
-All RTT sessions completed
-```
-
-Log files are saved in a timestamped directory with ANSI color codes removed for clean text output.
-
 ### Python API
 
 #### Flashing