util: support config files in parallel_sim.sh

Previously, running experiments with different configurations required creating
separate wrapper scripts (kmh_v3_btb.sh, kmh_v3_ideal.sh, kmh_v3_btb_nosc.sh, etc.).
This violates the DRY principle and makes configuration management difficult.

Modified `parallel_sim.sh` to auto-detect file type and support both modes:
- Legacy mode: Execute .sh wrapper scripts (backward compatible)
- New mode: Directly invoke gem5 with .py config files

- `util/xs_scripts/parallel_sim.sh`:
  - Auto-detect .sh vs .py files using file extension
  - Support optional 5th parameter for extra gem5 arguments
  - Update help message with examples
  - Maintain full backward compatibility with existing wrapper scripts

- `.github/workflows/gem5-perf-template.yml`:
  - Add `config_path` parameter (recommended, replaces script_path)
  - Add `extra_args` parameter for gem5 command-line arguments
  - Keep `script_path` for backward compatibility

- `.github/workflows/gem5-ideal-btb-perf.yml`:
  - Use `configs/example/idealkmhv3.py` directly

- `.github/workflows/gem5-ideal-btb-perf-nosc.yml`:
  - Use `configs/example/idealkmhv3.py` with `--disable-mgsc`

- `.github/workflows/gem5-ideal-btb-perf-weekly.yml`:
  - Migrate all jobs to use config files directly

1. **DRY compliance**: Configuration logic only in .py files
2. **Flexible parameters**: Support arbitrary gem5 arguments without new scripts
3. **Better traceability**: Experiment logs show full config + arguments
4. **Backward compatible**: Existing wrapper scripts continue to work

```bash
bash parallel_sim.sh kmh_v3_btb.sh workload.lst /cpt my_exp

bash parallel_sim.sh configs/example/idealkmhv3.py workload.lst /cpt my_exp

bash parallel_sim.sh configs/example/idealkmhv3.py workload.lst /cpt my_exp "--disable-mgsc"

Change-Id: I4c1f515b3913311fb05c0b9274e103460d349966

Author: jensen-yan

.github/workflows/gem5-ideal-btb-perf-nosc.yml

@@ -13,5 +13,6 @@ jobs:
   perf_test:
     uses: ./.github/workflows/gem5-perf-template.yml
     with:
-      script_path: ../kmh_v3_btb_nosc.sh
+      config_path: configs/example/idealkmhv3.py
+      extra_args: "--disable-mgsc"
       benchmark_type: "spec06-0.8c"

.github/workflows/gem5-ideal-btb-perf-weekly.yml

@@ -11,19 +11,19 @@ jobs:
   perf_test_spec06:
     uses: ./.github/workflows/gem5-perf-template.yml
     with:
-      script_path: ../kmh_v3_ideal.sh
+      config_path: configs/example/idealkmhv3.py
       benchmark_type: "spec06-1.0c"
-  
+
   perf_test_spec17:
     uses: ./.github/workflows/gem5-perf-template.yml
     with:
-      script_path: ../kmh_v3_ideal.sh
-      benchmark_type: "spec17-1.0c" 
-  
+      config_path: configs/example/idealkmhv3.py
+      benchmark_type: "spec17-1.0c"
+
   perf_test_spec06_vector:
     uses: ./.github/workflows/gem5-perf-template.yml
     with:
-      script_path: ../kmh_v3_ideal.sh
+      config_path: configs/example/idealkmhv3.py
       benchmark_type: "spec06-rvv-1.0c"
       vector_type: "simple"
       check_result: false

.github/workflows/gem5-ideal-btb-perf.yml

@@ -18,5 +18,5 @@ jobs:
   perf_test:
     uses: ./.github/workflows/gem5-perf-template.yml
     with:
-      script_path: ../kmh_v3_ideal.sh
+      config_path: configs/example/idealkmhv3.py
       benchmark_type: "spec06-0.8c"

.github/workflows/gem5-perf-template.yml

@@ -3,9 +3,19 @@ name: gem5 Performance Test Template (Unified)
 on:
   workflow_call:
     inputs:
+      config_path:
+        required: false
+        type: string
+        description: "Config file (.py) or script (.sh) path (relative to util/xs_scripts/)"
       script_path:
-        required: true
+        required: false
         type: string
+        description: "DEPRECATED: Use config_path instead. Still supported for backward compatibility."
+      extra_args:
+        required: false
+        type: string
+        default: ""
+        description: "Extra arguments for gem5 (e.g., --disable-mgsc). Only works with .py config files."
       benchmark_type:
         required: true
         type: string
@@ -123,10 +133,15 @@ jobs:
           export GEM5_BUILD_TYPE=fast
           mkdir -p $GEM5_HOME/util/xs_scripts/test
           cd $GEM5_HOME/util/xs_scripts/test
-          bash ../parallel_sim.sh `realpath ${{ inputs.script_path }}` \
+
+          # Use config_path if provided, otherwise fall back to script_path for backward compatibility
+          CONFIG_OR_SCRIPT="${{ inputs.config_path || inputs.script_path }}"
+
+          bash ../parallel_sim.sh `realpath $CONFIG_OR_SCRIPT` \
             ${{ steps.config.outputs.checkpoint_list }} \
             ${{ steps.config.outputs.checkpoint_root_node}} \
-            spec_all
+            spec_all \
+            "${{ inputs.extra_args }}"
       - name: Setup gem5_data_proc environment
         run: |
           # 使用本地数据处理仓库，避免GitHub网络问题

util/xs_scripts/parallel_sim.sh

@@ -2,7 +2,25 @@
 
 function print_help() {
     printf "Usage:
-    bash $0 arch_script.sh workload_list.lst checkpoint_top_dir task_tag\n"
+    bash $0 <config_file_or_script> workload_list.lst checkpoint_top_dir task_tag [extra_gem5_args]
+
+Arguments:
+    config_file_or_script:  Config file (*.py) or wrapper script (*.sh)
+    workload_list.lst:      List of workloads to run
+    checkpoint_top_dir:     Root directory for checkpoints
+    task_tag:               Tag for this experiment
+    extra_gem5_args:        Optional extra arguments for gem5 (only for .py mode)
+
+Examples:
+    # Legacy mode (using .sh script)
+    bash $0 kmh_v3_btb.sh workload.lst /cpt/dir my_exp
+
+    # New mode (using .py config)
+    bash $0 configs/example/idealkmhv3.py workload.lst /cpt/dir my_exp
+
+    # New mode with extra args
+    bash $0 configs/example/idealkmhv3.py workload.lst /cpt/dir my_exp_nosc \"--disable-mgsc\"
+\n"
     exit 1
 }
 
@@ -13,7 +31,32 @@ fi
 
 set -x
 
-export arch_script=`realpath $1`
+# Setup gem5 environment (similar to common.sh)
+script_dir=$(dirname -- "$( readlink -f -- "$0"; )")
+export gem5_home=$(dirname $(dirname $script_dir))
+export GEM5_BUILD_TYPE=${GEM5_BUILD_TYPE:-opt}
+export gem5=$(realpath $gem5_home/build/RISCV/gem5.$GEM5_BUILD_TYPE)
+
+echo "Using gem5 binary: $gem5"
+
+# Detect if first parameter is a script (.sh) or config file (.py)
+export first_param=`realpath $1`
+
+if [[ "$first_param" == *.sh ]]; then
+    # Legacy mode: using wrapper script
+    export use_legacy_mode=true
+    export arch_script="$first_param"
+    echo "ℹ️  Legacy mode: using script $arch_script"
+else
+    # New mode: using config file directly
+    export use_legacy_mode=false
+    export config_file="$first_param"
+    export extra_gem5_args="${5:-}"  # Optional 5th parameter
+    echo "ℹ️  Config mode: using $config_file"
+    if [ -n "$extra_gem5_args" ]; then
+        echo "ℹ️  Extra gem5 args: $extra_gem5_args"
+    fi
+fi
 
 # Note 1: workload list contains the workload name, checkpoint path, and parameters, looks like:
 #       astar_biglakes_122060000000 astar_biglakes_122060000000_0.244818/0/ 0 0 20 20
@@ -70,9 +113,16 @@ function run() {
 
     touch running
 
-    script_dir=$(dirname -- "$( readlink -f -- "$0"; )")
-    bash $arch_script $1 # checkpoint
-    check $?
+    if [ "$use_legacy_mode" = true ]; then
+        # Legacy mode: call wrapper script
+        bash $arch_script $1 # checkpoint
+        check $?
+    else
+        # New mode: directly call gem5 with config file
+        # config_file is already an absolute path from realpath
+        $gem5 $config_file --generic-rv-cpt=$1 $extra_gem5_args
+        check $?
+    fi
 
     rm running
     touch completed