Skip to content

Commit 6c65fe6

Browse files
committed
[CK_TILE] GEMM bridge: document variant scope in README
Adds a "Variant scope" section clarifying that the bridge is one shared, variant-aware driver (not per-variant driver copies), that only gemm_universal is wired and validated through the bridge on this PR, and that the gemm_multi_d/gemm_preshuffle/grouped_gemm configs/ dirs are scaffolding following the per-variant convention -- not yet working support. Notes that grouped GEMM and stream-K are separate bridge efforts (#8136 stream-K).
1 parent 2ba4630 commit 6c65fe6

1 file changed

Lines changed: 21 additions & 0 deletions

File tree

  • projects/composablekernel/tile_engine/ops/gemm

projects/composablekernel/tile_engine/ops/gemm/README.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,27 @@ auto-detected (`HIP_VISIBLE_DEVICES`, then `rocm-smi`/`amd-smi`); override with
9494
| dtype | `fp16` (bf16 follows in #8190) |
9595
| layout | `rcr` (rrr/crr/ccr follow in #8191; row-major C only — ck_tile rejects column-major C at build) |
9696

97+
### Variant scope
98+
99+
The bridge is **one shared, variant-aware driver** (`gemm_full_benchmark.py` +
100+
`run_one_gemm_kernel.py`), not a per-variant copy of the driver. `--variant`
101+
selects the per-variant `configs/` directory, mirroring the existing Tile Engine
102+
layout where each variant (`gemm_universal/`, `gemm_multi_d/`,
103+
`gemm_preshuffle/`, `grouped_gemm/`) owns its own subdirectory.
104+
105+
What that means for this PR:
106+
107+
- **Only `gemm_universal` is wired and validated through the bridge here.** It is
108+
the foundation variant; the dispatcher codegen path is exercised and parity-
109+
checked for it alone.
110+
- The `gemm_multi_d/`, `gemm_preshuffle/`, and `grouped_gemm/` `configs/`
111+
directories are **scaffolding** that follows the per-variant convention so the
112+
layout is ready. `--variant` will select them, but the bridge does **not** yet
113+
produce correct kernels for those variants on this PR — do not treat their
114+
presence as working support.
115+
- Grouped GEMM and stream-K go through **separate bridge efforts** (stream-K in
116+
#8136, grouped GEMM on its own branch), not this PR.
117+
97118
### Deprecation note
98119

99120
The per-variant `*_instance_builder.py` scripts (e.g.

0 commit comments

Comments
 (0)