submission 383079
leymore4172 · python · License unknown
Use it
Vendorable · source mirrored · license unknownView source →
No package. Vendor the mirrored source: 1661 lines, June 9 Researcher Reciprocity License v1.0.
submission.py
curl "https://kernelindex.com/api/v1/implementations/kernelbot-modal-nvfp4-dual-gemm-383079?include=source"interfacepython
Compatibility
measured onNVIDIA B200
declared hardwareNVIDIA B200
architecturessm_100
dtypesfp8_e4m3, nvfp4
Benchmark evidence
1 measurement across 1 GPU, fastest first.
Operation / workload
Hardware
Latency
Rank
Observed
Reported · How evidence levels are derived →
Source and license
sourceavailable
revision digestsha256:5fa37c8ea65f887f93cbe0d6e55165438c32e0cbd539e2e985fb38879da31695
license declaredunknown
license concludedunknown
authorsleymore4172
imported2026-08-15
Techniques
Extracted from the mirrored source by pattern, never inferred. Each row cites its line.
fused-epilogue
epilogue.mbarrier
self.epilog_sync_barrier = pipeline.NamedBarrier(persistent-kernel
"""Persistent blockscaled dual GEMM:shared-memory
self.smem_capacity = utils.get_smem_capacity_in_bytes("sm_100")tcgen05
self.cta_group = tcgen05.CtaGroup.TWO if self.use_2cta_instrs else tcgen05.CtaGroup.ONEwarp-specialization
ab_pipeline_producer_group = pipeline.CooperativeGroup(pipeline.Agent.Thread)Kernel source
submission.py1661 lines
import cuda.bindings.driver as cuda
import os
import torch
from task import input_t, output_t
import cutlass
import cutlass.cute as cute
from cutlass.cute.nvgpu import cpasync, tcgen05
import cutlass.torch as cutlass_torch
import cutlass.utils as utils
import cutlass.pipeline as pipeline
from cutlass.pipeline import pipeline_init_arrive, pipeline_init_wait
import cutlass.utils.blackwell_helpers as sm100_utils
import cutlass.utils.blockscaled_layout as blockscaled_utils
from cutlass.cute.runtime import make_ptr
# TMA cache eviction policy constants
_TMA_CACHE_EVICT_NORMAL = 0x1000000000000000
_TMA_CACHE_EVICT_FIRST = 0x12F0000000000000
_TMA_CACHE_EVICT_LAST = 0x14F0000000000000
# -----------------------------------------------------------------------------
# Problem constants
# -----------------------------------------------------------------------------
# A/B are NVFP4 (e2m1) and scale factors are FP8 (e4m3fnuz). Output is FP16.
AB_DTYPE = cutlass.Float4E2M1FN
SF_DTYPE = cutlass.Float8E4M3FN
C_DTYPE = cutlass.Float16
SF_VEC_SIZE = 16
def _silu(x):
# x * sigmoid(x) using tanh: sigmoid(x) = 0.5 * (1 + tanh(x/2))
return x * 0.5 * (1.0 + cute.math.tanh(x * 0.5, fastmath=True))
# -----------------------------------------------------------------------------
# Persistent dual-GEMM kernel (warp-specialized) for SM100 (Blackwell)
# -----------------------------------------------------------------------------
class Sm100BlockScaledPersistentDualGemmKernel:
"""Persistent blockscaled dual GEMM:
C = silu(A @ B1) * (A @ B2)
This is adapted from CUTLASS CuTeDSL Blackwell persistent blockscaled GEMM
example, extended to load/compute two B matrices and fuse SwiGLU-style
epilogue.
"""
def __init__(
self,
*,
sf_vec_size: int,
mma_tiler_mn: tuple[int, int],
cluster_shape_mn: tuple[int, int],
ab_stages: int = 0,
prefetch_dist: int = -1,
):
self.acc_dtype = cutlass.Float32
self.sf_vec_size = sf_vec_size
self.use_2cta_instrs = mma_tiler_mn[0] == 256
self.cluster_shape_mn = cluster_shape_mn
self.mma_tiler = (*mma_tiler_mn, 1) # K is deferred
self.cta_group = tcgen05.CtaGroup.TWO if self.use_2cta_instrs else tcgen05.CtaGroup.ONE
# Warp specialization (same as CUTLASS example)
self.epilog_warp_id = (0, 1, 2, 3)
self.mma_warp_id = 4
self.tma_warp_id = 5
self.threads_per_cta = 32 * len((self.mma_warp_id, self.tma_warp_id, *self.epilog_warp_id))
# Barriers
self.epilog_sync_barrier = pipeline.NamedBarrier(
barrier_id=1,
num_threads=32 * len(self.epilog_warp_id),
)
self.tmem_alloc_barrier = pipeline.NamedBarrier(
barrier_id=2,
num_threads=32 * len((self.mma_warp_id, *self.epilog_warp_id)),
)
self.occupancy = 1
self.smem_capacity = utils.get_smem_capacity_in_bytes("sm_100")
# TMEM capacity (SM100)
self.num_tmem_alloc_cols = 512
# Optional overrides
# - ab_stages: 0 = auto, >0 = override (clamped to max that fits)
# - prefetch_dist: -1 = auto (=num_ab_stage), 0 = disable,
# >0 = explicit (clamped to <= num_ab_stage)
self.ab_stages_param = ab_stages
self.prefetch_dist_param = prefetch_dist
self.prefetch_dist = 0
self.prefetch_enabled = False
def _setup_attributes(self):
# MMA inst shapes (MN is configured, K is fixed by tcgen05 op)
self.mma_inst_shape_mn = (self.mma_tiler[0], self.mma_tiler[1])
self.mma_inst_shape_mn_sfb = (
self.mma_inst_shape_mn[0] // (2 if self.use_2cta_instrs else 1),
cute.round_up(self.mma_inst_shape_mn[1], 128),
)
tiled_mma = sm100_utils.make_blockscaled_trivial_tiled_mma(
self.a_dtype,
self.a_major_mode,
self.b_major_mode,
self.sf_dtype,
self.sf_vec_size,
self.cta_group,
self.mma_inst_shape_mn,
)
tiled_mma_sfb = sm100_utils.make_blockscaled_trivial_tiled_mma(
self.a_dtype,
self.a_major_mode,
self.b_major_mode,
self.sf_dtype,
self.sf_vec_size,
tcgen05.CtaGroup.ONE,
self.mma_inst_shape_mn_sfb,
)
# Compute mma/cluster/tile shapes
mma_inst_shape_k = cute.size(tiled_mma.shape_mnk, mode=[2])
mma_inst_tile_k = 4
self.mma_tiler = (
self.mma_inst_shape_mn[0],
self.mma_inst_shape_mn[1],
mma_inst_shape_k * mma_inst_tile_k,
)
self.mma_tiler_sfb = (
self.mma_inst_shape_mn_sfb[0],
self.mma_inst_shape_mn_sfb[1],
mma_inst_shape_k * mma_inst_tile_k,
)
self.cta_tile_shape_mnk = (
self.mma_tiler[0] // cute.size(tiled_mma.thr_id.shape),
self.mma_tiler[1],
self.mma_tiler[2],
)
self.cta_tile_shape_mnk_sfb = (
self.mma_tiler_sfb[0] // cute.size(tiled_mma.thr_id.shape),
self.mma_tiler_sfb[1],
self.mma_tiler_sfb[2],
)
# Cluster layout
self.cluster_layout_vmnk = cute.tiled_divide(
cute.make_layout((*self.cluster_shape_mn, 1)),
(tiled_mma.thr_id.shape,),
)
self.cluster_layout_sfb_vmnk = cute.tiled_divide(
cute.make_layout((*self.cluster_shape_mn, 1)),
(tiled_mma_sfb.thr_id.shape,),
)
# Multicast info
self.num_mcast_ctas_a = cute.size(self.cluster_layout_vmnk.shape[2])
self.num_mcast_ctas_b = cute.size(self.cluster_layout_vmnk.shape[1])
self.num_mcast_ctas_sfb = cute.size(self.cluster_layout_sfb_vmnk.shape[1])
self.is_a_mcast = self.num_mcast_ctas_a > 1
self.is_b_mcast = self.num_mcast_ctas_b > 1
self.is_sfb_mcast = self.num_mcast_ctas_sfb > 1
# Epilogue subtile
self.epi_tile = sm100_utils.compute_epilogue_tile_shape(
self.cta_tile_shape_mnk,
self.use_2cta_instrs,
self.c_layout,
self.c_dtype,
)
self.epi_tile_n = cute.size(self.epi_tile[1])
# Stages (dual-gemm: force 1 acc stage to fit TMEM)
self.num_acc_stage, self.num_ab_stage, self.num_c_stage = self._compute_stages_dual(
tiled_mma,
self.mma_tiler,
self.a_dtype,
self.b_dtype,
self.epi_tile,
self.c_dtype,
self.c_layout,
self.sf_dtype,
self.sf_vec_size,
self.smem_capacity,
self.occupancy,
self.ab_stages_param,
)
# Prefetch distance:
# -1 => auto (=num_ab_stage)
# 0 => disabled
# >0 => explicit (clamped to <= num_ab_stage)
if self.prefetch_dist_param < 0:
self.prefetch_dist = self.num_ab_stage
else:
self.prefetch_dist = self.prefetch_dist_param
if self.prefetch_dist > self.num_ab_stage:
self.prefetch_dist = self.num_ab_stage
if self.prefetch_dist < 0:
self.prefetch_dist = 0
self.prefetch_enabled = self.prefetch_dist > 0
# Shared memory layouts
self.a_smem_layout_staged = sm100_utils.make_smem_layout_a(
tiled_mma,
self.mma_tiler,
self.a_dtype,
self.num_ab_stage,
)
self.b_smem_layout_staged = sm100_utils.make_smem_layout_b(
tiled_mma,
self.mma_tiler,
self.b_dtype,
self.num_ab_stage,
)
self.sfa_smem_layout_staged = blockscaled_utils.make_smem_layout_sfa(
tiled_mma,
self.mma_tiler,
self.sf_vec_size,
self.num_ab_stage,
)
self.sfb_smem_layout_staged = blockscaled_utils.make_smem_layout_sfb(
tiled_mma,
self.mma_tiler,
self.sf_vec_size,
self.num_ab_stage,
)
self.c_smem_layout_staged = sm100_utils.make_smem_layout_epi(
self.c_dtype,
self.c_layout,
self.epi_tile,
self.num_c_stage,
)
# TMEM col accounting
sf_atom_mn = 32
self.num_sfa_tmem_cols = (self.cta_tile_shape_mnk[0] // sf_atom_mn) * 4
self.num_sfb_tmem_cols = (self.cta_tile_shape_mnk_sfb[1] // sf_atom_mn) * 4
# Accumulator cols per GEMM (include acc stage)
self.num_accumulator_tmem_cols = self.cta_tile_shape_mnk[1] * self.num_acc_stage
used_cols = (
2 * self.num_accumulator_tmem_cols
+ self.num_sfa_tmem_cols
+ 2 * self.num_sfb_tmem_cols
)
if used_cols > self.num_tmem_alloc_cols:
raise ValueError(
f"TMEM overcommit: need {used_cols} cols but only have {self.num_tmem_alloc_cols}. "
f"Try smaller mma_tiler_mn or fewer stages."
)
@cute.jit
def __call__(
self,
a_tensor: cute.Tensor,
b1_tensor: cute.Tensor,
b2_tensor: cute.Tensor,
sfa_tensor: cute.Tensor,
sfb1_tensor: cute.Tensor,
sfb2_tensor: cute.Tensor,
c_tensor: cute.Tensor,
max_active_clusters: int,
):
# Infer dtypes/layouts
self.a_dtype = a_tensor.element_type
self.b_dtype = b1_tensor.element_type
self.sf_dtype = sfa_tensor.element_type
self.c_dtype = c_tensor.element_type
# Layout major modes
self.a_major_mode = utils.LayoutEnum.from_tensor(a_tensor).mma_major_mode()
self.b_major_mode = utils.LayoutEnum.from_tensor(b1_tensor).mma_major_mode()
self.c_layout = utils.LayoutEnum.from_tensor(c_tensor)
# Require matching dtypes
if cutlass.const_expr(self.a_dtype != self.b_dtype):
raise TypeError(f"A/B type must match: {self.a_dtype} != {self.b_dtype}")
# Attributes (tiler, stages, layouts, multicast)
self._setup_attributes()
# Re-wrap SFA/SFB tensors to the blockscaled SF atom layout
sfa_layout = blockscaled_utils.tile_atom_to_shape_SF(a_tensor.shape, self.sf_vec_size)
sfa_tensor = cute.make_tensor(sfa_tensor.iterator, sfa_layout)
sfb_layout = blockscaled_utils.tile_atom_to_shape_SF(b1_tensor.shape, self.sf_vec_size)
sfb1_tensor = cute.make_tensor(sfb1_tensor.iterator, sfb_layout)
sfb2_tensor = cute.make_tensor(sfb2_tensor.iterator, sfb_layout)
# Make tiled MMA
tiled_mma = sm100_utils.make_blockscaled_trivial_tiled_mma(
self.a_dtype,
self.a_major_mode,
self.b_major_mode,
self.sf_dtype,
self.sf_vec_size,
self.cta_group,
self.mma_inst_shape_mn,
)
tiled_mma_sfb = sm100_utils.make_blockscaled_trivial_tiled_mma(
self.a_dtype,
self.a_major_mode,
self.b_major_mode,
self.sf_dtype,
self.sf_vec_size,
tcgen05.CtaGroup.ONE,
self.mma_inst_shape_mn_sfb,
)
atom_thr_size = cute.size(tiled_mma.thr_id.shape)
# --- TMA atoms ---
a_op = sm100_utils.cluster_shape_to_tma_atom_A(self.cluster_shape_mn, tiled_mma.thr_id)
b_op = sm100_utils.cluster_shape_to_tma_atom_B(self.cluster_shape_mn, tiled_mma.thr_id)
sfa_op = a_op
sfb_op = sm100_utils.cluster_shape_to_tma_atom_SFB(self.cluster_shape_mn, tiled_mma.thr_id)
a_smem_layout = cute.slice_(self.a_smem_layout_staged, (None, None, None, 0))
b_smem_layout = cute.slice_(self.b_smem_layout_staged, (None, None, None, 0))
sfa_smem_layout = cute.slice_(self.sfa_smem_layout_staged, (None, None, None, 0))
sfb_smem_layout = cute.slice_(self.sfb_smem_layout_staged, (None, None, None, 0))
tma_atom_a, tma_tensor_a = cute.nvgpu.make_tiled_tma_atom_A(
a_op,
a_tensor,
a_smem_layout,
self.mma_tiler,
tiled_mma,
self.cluster_layout_vmnk.shape,
)
tma_atom_b1, tma_tensor_b1 = cute.nvgpu.make_tiled_tma_atom_B(
b_op,
b1_tensor,
b_smem_layout,
self.mma_tiler,
tiled_mma,
self.cluster_layout_vmnk.shape,
)
tma_atom_b2, tma_tensor_b2 = cute.nvgpu.make_tiled_tma_atom_B(
b_op,
b2_tensor,
b_smem_layout,
self.mma_tiler,
tiled_mma,
self.cluster_layout_vmnk.shape,
)
tma_atom_sfa, tma_tensor_sfa = cute.nvgpu.make_tiled_tma_atom_A(
sfa_op,
sfa_tensor,
sfa_smem_layout,
self.mma_tiler,
tiled_mma,
self.cluster_layout_vmnk.shape,
internal_type=cutlass.Int16,
)
tma_atom_sfb1, tma_tensor_sfb1 = cute.nvgpu.make_tiled_tma_atom_B(
sfb_op,
sfb1_tensor,
sfb_smem_layout,
self.mma_tiler_sfb,
tiled_mma_sfb,
self.cluster_layout_sfb_vmnk.shape,
internal_type=cutlass.Int16,
)
tma_atom_sfb2, tma_tensor_sfb2 = cute.nvgpu.make_tiled_tma_atom_B(
sfb_op,
sfb2_tensor,
sfb_smem_layout,
self.mma_tiler_sfb,
tiled_mma_sfb,
self.cluster_layout_sfb_vmnk.shape,
internal_type=cutlass.Int16,
)
# Special handling for cta_tile_shape_n == 192 (SFB layout is stored in 128-col chunks)
if cutlass.const_expr(self.cta_tile_shape_mnk[1] == 192):
x = tma_tensor_sfb1.stride[0][1]
y = cute.ceil_div(tma_tensor_sfb1.shape[0][1], 4)
new_shape = (
(tma_tensor_sfb1.shape[0][0], ((2, 2), y)),
tma_tensor_sfb1.shape[1],
tma_tensor_sfb1.shape[2],
)
# Use right multiplication for ScaledBasis (3 * x instead of x * 3)
x_times_3 = 3 * x
new_stride = (
(tma_tensor_sfb1.stride[0][0], ((x, x), x_times_3)),
tma_tensor_sfb1.stride[1],
tma_tensor_sfb1.stride[2],
)
tma_tensor_sfb_new_layout = cute.make_layout(new_shape, stride=new_stride)
tma_tensor_sfb1 = cute.make_tensor(
tma_tensor_sfb1.iterator, tma_tensor_sfb_new_layout
)
tma_tensor_sfb2 = cute.make_tensor(
tma_tensor_sfb2.iterator, tma_tensor_sfb_new_layout
)
# TMA load byte count (for barrier/pipeline)
a_copy_size = cute.size_in_bytes(self.a_dtype, a_smem_layout)
b_copy_size = cute.size_in_bytes(self.b_dtype, b_smem_layout)
sfa_copy_size = cute.size_in_bytes(self.sf_dtype, sfa_smem_layout)
sfb_copy_size = cute.size_in_bytes(self.sf_dtype, sfb_smem_layout)
self.num_tma_load_bytes = (
a_copy_size + 2 * b_copy_size + sfa_copy_size + 2 * sfb_copy_size
) * atom_thr_size
# Setup TMA store for C
epi_smem_layout = cute.slice_(self.c_smem_layout_staged, (None, None, 0))
tma_atom_c, tma_tensor_c = cpasync.make_tiled_tma_atom(
cpasync.CopyBulkTensorTileS2GOp(),
c_tensor,
epi_smem_layout,
self.epi_tile,
)
# Compute grid size (simple grid, non-persistent)
# Calculate number of tiles (CTAs) needed, then account for cluster shape
c_shape = cute.slice_(self.cta_tile_shape_mnk, (None, None, 0))
gc = cute.zipped_divide(c_tensor, tiler=c_shape)
num_ctas_mnl = gc[(0, (None, None, None))].shape
# For non-persistent, grid = (num_clusters_m * cluster_m, num_clusters_n * cluster_n, l)
num_clusters_m = cute.ceil_div(num_ctas_mnl[0], self.cluster_shape_mn[0])
num_clusters_n = cute.ceil_div(num_ctas_mnl[1], self.cluster_shape_mn[1])
grid = (
num_clusters_m * self.cluster_shape_mn[0],
num_clusters_n * self.cluster_shape_mn[1],
num_ctas_mnl[2],
)
self.buffer_align_bytes = 1024
# Define shared storage for kernel
@cute.struct
class SharedStorage:
ab_full_mbar_ptr: cute.struct.MemRange[cutlass.Int64, self.num_ab_stage]
ab_empty_mbar_ptr: cute.struct.MemRange[cutlass.Int64, self.num_ab_stage]
acc_full_mbar_ptr: cute.struct.MemRange[cutlass.Int64, self.num_acc_stage]
acc_empty_mbar_ptr: cute.struct.MemRange[cutlass.Int64, self.num_acc_stage]
tmem_dealloc_mbar_ptr: cutlass.Int64
tmem_holding_buf: cutlass.Int32
# (EPI_TILE_M, EPI_TILE_N, STAGE)
sC: cute.struct.Align[
cute.struct.MemRange[
self.c_dtype,
cute.cosize(self.c_smem_layout_staged.outer),
],
self.buffer_align_bytes,
]
# (MMA, MMA_M, MMA_K, STAGE)
sA: cute.struct.Align[
cute.struct.MemRange[
self.a_dtype,
cute.cosize(self.a_smem_layout_staged.outer),
],
self.buffer_align_bytes,
]
# (MMA, MMA_N, MMA_K, STAGE) -- B1
sB1: cute.struct.Align[
cute.struct.MemRange[
self.b_dtype,
cute.cosize(self.b_smem_layout_staged.outer),
],
self.buffer_align_bytes,
]
# (MMA, MMA_N, MMA_K, STAGE) -- B2
sB2: cute.struct.Align[
cute.struct.MemRange[
self.b_dtype,
cute.cosize(self.b_smem_layout_staged.outer),
],
self.buffer_align_bytes,
]
# (MMA, MMA_M, MMA_K, STAGE)
sSFA: cute.struct.Align[
cute.struct.MemRange[
self.sf_dtype,
cute.cosize(self.sfa_smem_layout_staged),
],
self.buffer_align_bytes,
]
# (MMA, MMA_N, MMA_K, STAGE)
sSFB1: cute.struct.Align[
cute.struct.MemRange[
self.sf_dtype,
cute.cosize(self.sfb_smem_layout_staged),
],
self.buffer_align_bytes,
]
# (MMA, MMA_N, MMA_K, STAGE)
sSFB2: cute.struct.Align[
cute.struct.MemRange[
self.sf_dtype,
cute.cosize(self.sfb_smem_layout_staged),
],
self.buffer_align_bytes,
]
self.shared_storage = SharedStorage
# Launch
self.kernel(
tiled_mma,
tiled_mma_sfb,
tma_atom_a,
tma_tensor_a,
tma_atom_b1,
tma_tensor_b1,
tma_atom_b2,
tma_tensor_b2,
tma_atom_sfa,
tma_tensor_sfa,
tma_atom_sfb1,
tma_tensor_sfb1,
tma_atom_sfb2,
tma_tensor_sfb2,
tma_atom_c,
tma_tensor_c,
self.cluster_layout_vmnk,
self.cluster_layout_sfb_vmnk,
self.a_smem_layout_staged,
self.b_smem_layout_staged,
self.sfa_smem_layout_staged,
self.sfb_smem_layout_staged,
self.c_smem_layout_staged,
self.epi_tile,
).launch(
grid=grid,
block=[self.threads_per_cta, 1, 1],
cluster=(*self.cluster_shape_mn, 1),
min_blocks_per_mp=1,
)
return
# -------------------------------------------------------------------------
# Device kernel
# -------------------------------------------------------------------------
@cute.kernel
def kernel(
self,
tiled_mma: cute.TiledMma,
tiled_mma_sfb: cute.TiledMma,
tma_atom_a: cute.CopyAtom,
mA_mkl: cute.Tensor,
tma_atom_b1: cute.CopyAtom,
mB_nkl1: cute.Tensor,
tma_atom_b2: cute.CopyAtom,
mB_nkl2: cute.Tensor,
tma_atom_sfa: cute.CopyAtom,
mSFA_mkl: cute.Tensor,
tma_atom_sfb1: cute.CopyAtom,
mSFB_nkl1: cute.Tensor,
tma_atom_sfb2: cute.CopyAtom,
mSFB_nkl2: cute.Tensor,
tma_atom_c: cute.CopyAtom,
mC_mnl: cute.Tensor,
cluster_layout_vmnk: cute.Layout,
cluster_layout_sfb_vmnk: cute.Layout,
a_smem_layout_staged: cute.ComposedLayout,
b_smem_layout_staged: cute.ComposedLayout,
sfa_smem_layout_staged: cute.Layout,
sfb_smem_layout_staged: cute.Layout,
c_smem_layout_staged: cute.ComposedLayout | cute.Layout,
epi_tile: cute.Tile,
):
warp_idx = cute.arch.warp_idx()
warp_idx = cute.arch.make_warp_uniform(warp_idx)
# Prefetch TMA descriptors
if warp_idx == self.tma_warp_id:
cpasync.prefetch_descriptor(tma_atom_a)
cpasync.prefetch_descriptor(tma_atom_b1)
cpasync.prefetch_descriptor(tma_atom_b2)
cpasync.prefetch_descriptor(tma_atom_sfa)
cpasync.prefetch_descriptor(tma_atom_sfb1)
cpasync.prefetch_descriptor(tma_atom_sfb2)
cpasync.prefetch_descriptor(tma_atom_c)
use_2cta_instrs = cute.size(tiled_mma.thr_id.shape) == 2
# Coords inside cluster
bidx, bidy, bidz = cute.arch.block_idx()
mma_tile_coord_v = bidx % cute.size(tiled_mma.thr_id.shape)
is_leader_cta = mma_tile_coord_v == 0
cta_rank_in_cluster = cute.arch.make_warp_uniform(cute.arch.block_idx_in_cluster())
block_in_cluster_coord_vmnk = cluster_layout_vmnk.get_flat_coord(cta_rank_in_cluster)
block_in_cluster_coord_sfb_vmnk = cluster_layout_sfb_vmnk.get_flat_coord(cta_rank_in_cluster)
tidx, tid_y, tid_z = cute.arch.thread_idx()
# Shared memory alloc
smem = utils.SmemAllocator()
storage = smem.allocate(self.shared_storage)
# Pipelines
ab_pipeline_producer_group = pipeline.CooperativeGroup(pipeline.Agent.Thread)
num_tma_producer = self.num_mcast_ctas_a + self.num_mcast_ctas_b - 1
ab_pipeline_consumer_group = pipeline.CooperativeGroup(pipeline.Agent.Thread, num_tma_producer)
ab_pipeline = pipeline.PipelineTmaUmma.create(
barrier_storage=storage.ab_full_mbar_ptr.data_ptr(),
num_stages=self.num_ab_stage,
producer_group=ab_pipeline_producer_group,
consumer_group=ab_pipeline_consumer_group,
tx_count=self.num_tma_load_bytes,
cta_layout_vmnk=cluster_layout_vmnk,
defer_sync=True,
)
acc_pipeline_producer_group = pipeline.CooperativeGroup(pipeline.Agent.Thread)
num_acc_consumer_threads = len(self.epilog_warp_id) * (2 if use_2cta_instrs else 1)
acc_pipeline_consumer_group = pipeline.CooperativeGroup(
pipeline.Agent.Thread,
num_acc_consumer_threads,
)
acc_pipeline = pipeline.PipelineUmmaAsync.create(
barrier_storage=storage.acc_full_mbar_ptr.data_ptr(),
num_stages=self.num_acc_stage,
producer_group=acc_pipeline_producer_group,
consumer_group=acc_pipeline_consumer_group,
cta_layout_vmnk=cluster_layout_vmnk,
defer_sync=True,
)
# TMEM allocator
tmem = utils.TmemAllocator(
storage.tmem_holding_buf,
barrier_for_retrieve=self.tmem_alloc_barrier,
allocator_warp_id=self.epilog_warp_id[0],
is_two_cta=use_2cta_instrs,
two_cta_tmem_dealloc_mbar_ptr=storage.tmem_dealloc_mbar_ptr,
)
# Cluster arrive
pipeline_init_arrive(cluster_shape_mn=self.cluster_shape_mn, is_relaxed=True)
# Setup SMEM tensors
sC = storage.sC.get_tensor(c_smem_layout_staged.outer, swizzle=c_smem_layout_staged.inner)
sA = storage.sA.get_tensor(a_smem_layout_staged.outer, swizzle=a_smem_layout_staged.inner)
sB1 = storage.sB1.get_tensor(b_smem_layout_staged.outer, swizzle=b_smem_layout_staged.inner)
sB2 = storage.sB2.get_tensor(b_smem_layout_staged.outer, swizzle=b_smem_layout_staged.inner)
sSFA = storage.sSFA.get_tensor(sfa_smem_layout_staged)
sSFB1 = storage.sSFB1.get_tensor(sfb_smem_layout_staged)
sSFB2 = storage.sSFB2.get_tensor(sfb_smem_layout_staged)
# Multicast masks
a_full_mcast_mask = None
b_full_mcast_mask = None
sfa_full_mcast_mask = None
sfb_full_mcast_mask = None
if cutlass.const_expr(self.is_a_mcast or self.is_b_mcast or use_2cta_instrs):
a_full_mcast_mask = cpasync.create_tma_multicast_mask(
cluster_layout_vmnk,
block_in_cluster_coord_vmnk,
mcast_mode=2,
)
b_full_mcast_mask = cpasync.create_tma_multicast_mask(
cluster_layout_vmnk,
block_in_cluster_coord_vmnk,
mcast_mode=1,
)
sfa_full_mcast_mask = cpasync.create_tma_multicast_mask(
cluster_layout_vmnk,
block_in_cluster_coord_vmnk,
mcast_mode=2,
)
sfb_full_mcast_mask = cpasync.create_tma_multicast_mask(
cluster_layout_sfb_vmnk,
block_in_cluster_coord_sfb_vmnk,
mcast_mode=1,
)
# Local tile partition global tensors
gA_mkl = cute.local_tile(mA_mkl, cute.slice_(self.mma_tiler, (None, 0, None)), (None, None, None))
gB_nkl1 = cute.local_tile(mB_nkl1, cute.slice_(self.mma_tiler, (0, None, None)), (None, None, None))
gB_nkl2 = cute.local_tile(mB_nkl2, cute.slice_(self.mma_tiler, (0, None, None)), (None, None, None))
gSFA_mkl = cute.local_tile(mSFA_mkl, cute.slice_(self.mma_tiler, (None, 0, None)), (None, None, None))
gSFB_nkl1 = cute.local_tile(
mSFB_nkl1,
cute.slice_(self.mma_tiler_sfb, (0, None, None)),
(None, None, None),
)
gSFB_nkl2 = cute.local_tile(
mSFB_nkl2,
cute.slice_(self.mma_tiler_sfb, (0, None, None)),
(None, None, None),
)
gC_mnl = cute.local_tile(mC_mnl, cute.slice_(self.mma_tiler, (None, None, 0)), (None, None, None))
# Partition global tensors for TiledMMA (needed for static TMA partitions)
thr_mma = tiled_mma.get_slice(mma_tile_coord_v)
thr_mma_sfb = tiled_mma_sfb.get_slice(mma_tile_coord_v)
tCgA = thr_mma.partition_A(gA_mkl)
tCgB1 = thr_mma.partition_B(gB_nkl1)
tCgB2 = thr_mma.partition_B(gB_nkl2)
tCgSFA = thr_mma.partition_A(gSFA_mkl)
tCgSFB1 = thr_mma_sfb.partition_B(gSFB_nkl1)
tCgSFB2 = thr_mma_sfb.partition_B(gSFB_nkl2)
tCgC = thr_mma.partition_C(gC_mnl)
k_tile_cnt = cute.size(gA_mkl, mode=[3])
# Partition global tensors for TMA
a_cta_layout = cute.make_layout(cute.slice_(cluster_layout_vmnk, (0, 0, None, 0)).shape)
tAsA, tAgA = cpasync.tma_partition(
tma_atom_a,
block_in_cluster_coord_vmnk[2],
a_cta_layout,
cute.group_modes(sA, 0, 3),
cute.group_modes(tCgA, 0, 3),
)
b_cta_layout = cute.make_layout(cute.slice_(cluster_layout_vmnk, (0, None, 0, 0)).shape)
tBsB1, tBgB1 = cpasync.tma_partition(
tma_atom_b1,
block_in_cluster_coord_vmnk[1],
b_cta_layout,
cute.group_modes(sB1, 0, 3),
cute.group_modes(tCgB1, 0, 3),
)
tBsB2, tBgB2 = cpasync.tma_partition(
tma_atom_b2,
block_in_cluster_coord_vmnk[1],
b_cta_layout,
cute.group_modes(sB2, 0, 3),
cute.group_modes(tCgB2, 0, 3),
)
sfa_cta_layout = a_cta_layout
tAsSFA, tAgSFA = cpasync.tma_partition(
tma_atom_sfa,
block_in_cluster_coord_vmnk[2],
sfa_cta_layout,
cute.group_modes(sSFA, 0, 3),
cute.group_modes(tCgSFA, 0, 3),
)
tAsSFA = cute.filter_zeros(tAsSFA)
tAgSFA = cute.filter_zeros(tAgSFA)
sfb_cta_layout = cute.make_layout(cute.slice_(cluster_layout_sfb_vmnk, (0, None, 0, 0)).shape)
tBsSFB1, tBgSFB1 = cpasync.tma_partition(
tma_atom_sfb1,
block_in_cluster_coord_sfb_vmnk[1],
sfb_cta_layout,
cute.group_modes(sSFB1, 0, 3),
cute.group_modes(tCgSFB1, 0, 3),
)
tBsSFB1 = cute.filter_zeros(tBsSFB1)
tBgSFB1 = cute.filter_zeros(tBgSFB1)
tBsSFB2, tBgSFB2 = cpasync.tma_partition(
tma_atom_sfb2,
block_in_cluster_coord_sfb_vmnk[1],
sfb_cta_layout,
cute.group_modes(sSFB2, 0, 3),
cute.group_modes(tCgSFB2, 0, 3),
)
tBsSFB2 = cute.filter_zeros(tBsSFB2)
tBgSFB2 = cute.filter_zeros(tBgSFB2)
# MMA fragments
tCrA = tiled_mma.make_fragment_A(sA)
tCrB1 = tiled_mma.make_fragment_B(sB1)
tCrB2 = tiled_mma.make_fragment_B(sB2)
acc_shape = tiled_mma.partition_shape_C(self.mma_tiler[:2])
tCtAcc_fake = tiled_mma.make_fragment_C(cute.append(acc_shape, self.num_acc_stage))
# Cluster wait before tmem alloc
pipeline_init_wait(cluster_shape_mn=self.cluster_shape_mn)
# ---------------------------------------------------------------------
# Specialized TMA warp (load A/B/SF)
# ---------------------------------------------------------------------
if warp_idx == self.tma_warp_id:
# Simple grid scheduling (like shiyegao, no persistent scheduler)
ab_producer_state = pipeline.make_pipeline_state(
pipeline.PipelineUserType.Producer, self.num_ab_stage
)
mma_tile_coord_mnl = (
bidx // cute.size(tiled_mma.thr_id.shape),
bidy,
bidz,
)
tAgA_slice = tAgA[(None, mma_tile_coord_mnl[0], None, mma_tile_coord_mnl[2])]
tBgB1_slice = tBgB1[(None, mma_tile_coord_mnl[1], None, mma_tile_coord_mnl[2])]
tBgB2_slice = tBgB2[(None, mma_tile_coord_mnl[1], None, mma_tile_coord_mnl[2])]
tAgSFA_slice = tAgSFA[(None, mma_tile_coord_mnl[0], None, mma_tile_coord_mnl[2])]
slice_n_sfb = mma_tile_coord_mnl[1]
if cutlass.const_expr(self.cta_tile_shape_mnk[1] == 64):
slice_n_sfb = mma_tile_coord_mnl[1] // 2
tBgSFB1_slice = tBgSFB1[(None, slice_n_sfb, None, mma_tile_coord_mnl[2])]
tBgSFB2_slice = tBgSFB2[(None, slice_n_sfb, None, mma_tile_coord_mnl[2])]
# Prefetch: initial batch to prime the TMA pipeline
if self.prefetch_enabled:
for pf_k_tile in cutlass.range(
0, min(self.prefetch_dist, k_tile_cnt), unroll=1
):
cute.prefetch(tma_atom_a, tAgA_slice[(None, pf_k_tile)])
cute.prefetch(tma_atom_b1, tBgB1_slice[(None, pf_k_tile)])
cute.prefetch(tma_atom_b2, tBgB2_slice[(None, pf_k_tile)])
cute.prefetch(tma_atom_sfa, tAgSFA_slice[(None, pf_k_tile)])
cute.prefetch(tma_atom_sfb1, tBgSFB1_slice[(None, pf_k_tile)])
cute.prefetch(tma_atom_sfb2, tBgSFB2_slice[(None, pf_k_tile)])
ab_producer_state.reset_count()
peek_ab_empty_status = cutlass.Boolean(1)
if ab_producer_state.count < k_tile_cnt:
peek_ab_empty_status = ab_pipeline.producer_try_acquire(ab_producer_state)
for k_tile_prefetch in cutlass.range(0, k_tile_cnt, 1, unroll=1):
ab_pipeline.producer_acquire(ab_producer_state, peek_ab_empty_status)
bar = ab_pipeline.producer_get_barrier(ab_producer_state)
# TMA load A/B1/B2/SFA/SFB1/SFB2
try:
cute.copy(
tma_atom_a,
tAgA_slice[(None, ab_producer_state.count)],
tAsA[(None, ab_producer_state.index)],
tma_bar_ptr=bar,
mcast_mask=a_full_mcast_mask,
cache_policy=cutlass.Int64(cutlass.Int64(_TMA_CACHE_EVICT_FIRST).ir_value()),
)
except TypeError:
cute.copy(
tma_atom_a,
tAgA_slice[(None, ab_producer_state.count)],
tAsA[(None, ab_producer_state.index)],
tma_bar_ptr=bar,
mcast_mask=a_full_mcast_mask,
)
try:
cute.copy(
tma_atom_b1,
tBgB1_slice[(None, ab_producer_state.count)],
tBsB1[(None, ab_producer_state.index)],
tma_bar_ptr=bar,
mcast_mask=b_full_mcast_mask,
cache_policy=cutlass.Int64(cutlass.Int64(_TMA_CACHE_EVICT_FIRST).ir_value()),
)
except TypeError:
cute.copy(
tma_atom_b1,
tBgB1_slice[(None, ab_producer_state.count)],
tBsB1[(None, ab_producer_state.index)],
tma_bar_ptr=bar,
mcast_mask=b_full_mcast_mask,
)
try:
cute.copy(
tma_atom_b2,
tBgB2_slice[(None, ab_producer_state.count)],
tBsB2[(None, ab_producer_state.index)],
tma_bar_ptr=bar,
mcast_mask=b_full_mcast_mask,
cache_policy=cutlass.Int64(cutlass.Int64(_TMA_CACHE_EVICT_FIRST).ir_value()),
)
except TypeError:
cute.copy(
tma_atom_b2,
tBgB2_slice[(None, ab_producer_state.count)],
tBsB2[(None, ab_producer_state.index)],
tma_bar_ptr=bar,
mcast_mask=b_full_mcast_mask,
)
try:
cute.copy(
tma_atom_sfa,
tAgSFA_slice[(None, ab_producer_state.count)],
tAsSFA[(None, ab_producer_state.index)],
tma_bar_ptr=bar,
mcast_mask=sfa_full_mcast_mask,
cache_policy=cutlass.Int64(cutlass.Int64(_TMA_CACHE_EVICT_FIRST).ir_value()),
)
except TypeError:
cute.copy(
tma_atom_sfa,
tAgSFA_slice[(None, ab_producer_state.count)],
tAsSFA[(None, ab_producer_state.index)],
tma_bar_ptr=bar,
mcast_mask=sfa_full_mcast_mask,
)
try:
cute.copy(
tma_atom_sfb1,
tBgSFB1_slice[(None, ab_producer_state.count)],
tBsSFB1[(None, ab_producer_state.index)],
tma_bar_ptr=bar,
mcast_mask=sfb_full_mcast_mask,
cache_policy=cutlass.Int64(cutlass.Int64(_TMA_CACHE_EVICT_FIRST).ir_value()),
)
except TypeError:
cute.copy(
tma_atom_sfb1,
tBgSFB1_slice[(None, ab_producer_state.count)],
tBsSFB1[(None, ab_producer_state.index)],
tma_bar_ptr=bar,
mcast_mask=sfb_full_mcast_mask,
)
try:
cute.copy(
tma_atom_sfb2,
tBgSFB2_slice[(None, ab_producer_state.count)],
tBsSFB2[(None, ab_producer_state.index)],
tma_bar_ptr=bar,
mcast_mask=sfb_full_mcast_mask,
cache_policy=cutlass.Int64(cutlass.Int64(_TMA_CACHE_EVICT_FIRST).ir_value()),
)
except TypeError:
cute.copy(
tma_atom_sfb2,
tBgSFB2_slice[(None, ab_producer_state.count)],
tBsSFB2[(None, ab_producer_state.index)],
tma_bar_ptr=bar,
mcast_mask=sfb_full_mcast_mask,
)
# Prefetch: rolling prefetch for next tiles
if self.prefetch_enabled:
if k_tile_prefetch < k_tile_cnt - self.prefetch_dist:
future_k_tile = ab_producer_state.count + self.prefetch_dist
cute.prefetch(tma_atom_a, tAgA_slice[(None, future_k_tile)])
cute.prefetch(tma_atom_b1, tBgB1_slice[(None, future_k_tile)])
cute.prefetch(tma_atom_b2, tBgB2_slice[(None, future_k_tile)])
cute.prefetch(tma_atom_sfa, tAgSFA_slice[(None, future_k_tile)])
cute.prefetch(tma_atom_sfb1, tBgSFB1_slice[(None, future_k_tile)])
cute.prefetch(tma_atom_sfb2, tBgSFB2_slice[(None, future_k_tile)])
ab_producer_state.advance()
peek_ab_empty_status = cutlass.Boolean(1)
if ab_producer_state.count < k_tile_cnt:
peek_ab_empty_status = ab_pipeline.producer_try_acquire(ab_producer_state)
ab_pipeline.producer_tail(ab_producer_state)
# ---------------------------------------------------------------------
# Specialized MMA warp
# ---------------------------------------------------------------------
if warp_idx == self.mma_warp_id:
tmem.wait_for_alloc()
acc_tmem_ptr = tmem.retrieve_ptr(self.acc_dtype)
# Acc1/Acc2 base (MMA, MMA_M, MMA_N, STAGE)
tCtAcc1_base = cute.make_tensor(acc_tmem_ptr, tCtAcc_fake.layout)
acc2_ptr = acc_tmem_ptr + self.num_accumulator_tmem_cols
tCtAcc2_base = cute.make_tensor(acc2_ptr, tCtAcc_fake.layout)
# SFA/SFB TMEM tensors
sfa_tmem_ptr = cute.recast_ptr(
acc_tmem_ptr + 2 * self.num_accumulator_tmem_cols,
dtype=self.sf_dtype,
)
tCtSFA_layout = blockscaled_utils.make_tmem_layout_sfa(
tiled_mma,
self.mma_tiler,
self.sf_vec_size,
cute.slice_(sfa_smem_layout_staged, (None, None, None, 0)),
)
tCtSFA = cute.make_tensor(sfa_tmem_ptr, tCtSFA_layout)
sfb1_tmem_ptr = cute.recast_ptr(
acc_tmem_ptr + 2 * self.num_accumulator_tmem_cols + self.num_sfa_tmem_cols,
dtype=self.sf_dtype,
)
tCtSFB_layout = blockscaled_utils.make_tmem_layout_sfb(
tiled_mma,
self.mma_tiler,
self.sf_vec_size,
cute.slice_(sfb_smem_layout_staged, (None, None, None, 0)),
)
tCtSFB1 = cute.make_tensor(sfb1_tmem_ptr, tCtSFB_layout)
sfb2_tmem_ptr = cute.recast_ptr(
acc_tmem_ptr
+ 2 * self.num_accumulator_tmem_cols
+ self.num_sfa_tmem_cols
+ self.num_sfb_tmem_cols,
dtype=self.sf_dtype,
)
tCtSFB2 = cute.make_tensor(sfb2_tmem_ptr, tCtSFB_layout)
# S2T copy/partition
(
tiled_copy_s2t_sfa,
tCsSFA_compact_s2t,
tCtSFA_compact_s2t,
) = self.mainloop_s2t_copy_and_partition(sSFA, tCtSFA)
(
tiled_copy_s2t_sfb,
tCsSFB1_compact_s2t,
tCtSFB1_compact_s2t,
) = self.mainloop_s2t_copy_and_partition(sSFB1, tCtSFB1)
(
tiled_copy_s2t_sfb2,
tCsSFB2_compact_s2t,
tCtSFB2_compact_s2t,
) = self.mainloop_s2t_copy_and_partition(sSFB2, tCtSFB2)
# Simple grid scheduling (like shiyegao, no persistent scheduler)
ab_consumer_state = pipeline.make_pipeline_state(
pipeline.PipelineUserType.Consumer, self.num_ab_stage
)
acc_producer_state = pipeline.make_pipeline_state(
pipeline.PipelineUserType.Producer, self.num_acc_stage
)
mma_tile_coord_mnl = (
bidx // cute.size(tiled_mma.thr_id.shape),
bidy,
bidz,
)
acc_stage_index = acc_producer_state.index
tCtAcc1 = tCtAcc1_base[(None, None, None, acc_stage_index)]
tCtAcc2 = tCtAcc2_base[(None, None, None, acc_stage_index)]
ab_consumer_state.reset_count()
peek_ab_full_status = cutlass.Boolean(1)
if ab_consumer_state.count < k_tile_cnt and is_leader_cta:
peek_ab_full_status = ab_pipeline.consumer_try_wait(ab_consumer_state)
if is_leader_cta:
acc_pipeline.producer_acquire(acc_producer_state)
# Adjust SFB pointers for tiles where SFB is stored in 128-col chunks
tCtSFB1_mma = tCtSFB1
tCtSFB2_mma = tCtSFB2
if cutlass.const_expr(self.cta_tile_shape_mnk[1] == 192):
offset = cutlass.Int32(2) if mma_tile_coord_mnl[1] % 2 == 1 else cutlass.Int32(0)
shifted_ptr1 = cute.recast_ptr(
acc_tmem_ptr + 2 * self.num_accumulator_tmem_cols + self.num_sfa_tmem_cols + offset,
dtype=self.sf_dtype,
)
tCtSFB1_mma = cute.make_tensor(shifted_ptr1, tCtSFB_layout)
shifted_ptr2 = cute.recast_ptr(
acc_tmem_ptr
+ 2 * self.num_accumulator_tmem_cols
+ self.num_sfa_tmem_cols
+ self.num_sfb_tmem_cols
+ offset,
dtype=self.sf_dtype,
)
tCtSFB2_mma = cute.make_tensor(shifted_ptr2, tCtSFB_layout)
elif cutlass.const_expr(self.cta_tile_shape_mnk[1] == 64):
offset = cutlass.Int32((mma_tile_coord_mnl[1] % 2) * 2)
shifted_ptr1 = cute.recast_ptr(
acc_tmem_ptr + 2 * self.num_accumulator_tmem_cols + self.num_sfa_tmem_cols + offset,
dtype=self.sf_dtype,
)
tCtSFB1_mma = cute.make_tensor(shifted_ptr1, tCtSFB_layout)
shifted_ptr2 = cute.recast_ptr(
acc_tmem_ptr
+ 2 * self.num_accumulator_tmem_cols
+ self.num_sfa_tmem_cols
+ self.num_sfb_tmem_cols
+ offset,
dtype=self.sf_dtype,
)
tCtSFB2_mma = cute.make_tensor(shifted_ptr2, tCtSFB_layout)
tiled_mma.set(tcgen05.Field.ACCUMULATE, False)
for k_tile in range(k_tile_cnt):
if is_leader_cta:
ab_pipeline.consumer_wait(ab_consumer_state, peek_ab_full_status)
s2t_stage_coord = (None, None, None, None, ab_consumer_state.index)
cute.copy(
tiled_copy_s2t_sfa,
tCsSFA_compact_s2t[s2t_stage_coord],
tCtSFA_compact_s2t,
)
cute.copy(
tiled_copy_s2t_sfb,
tCsSFB1_compact_s2t[s2t_stage_coord],
tCtSFB1_compact_s2t,
)
cute.copy(
tiled_copy_s2t_sfb2,
tCsSFB2_compact_s2t[s2t_stage_coord],
tCtSFB2_compact_s2t,
)
num_kblocks = cute.size(tCrA, mode=[2])
for kblock_idx in cutlass.range(num_kblocks, unroll_full=True):
kblock_coord = (None, None, kblock_idx, ab_consumer_state.index)
sf_kblock_coord = (None, None, kblock_idx)
tiled_mma.set(tcgen05.Field.SFA, tCtSFA[sf_kblock_coord].iterator)
tiled_mma.set(tcgen05.Field.SFB, tCtSFB1_mma[sf_kblock_coord].iterator)
cute.gemm(
tiled_mma,
tCtAcc1,
tCrA[kblock_coord],
tCrB1[kblock_coord],
tCtAcc1,
)
tiled_mma.set(tcgen05.Field.SFB, tCtSFB2_mma[sf_kblock_coord].iterator)
cute.gemm(
tiled_mma,
tCtAcc2,
tCrA[kblock_coord],
tCrB2[kblock_coord],
tCtAcc2,
)
tiled_mma.set(tcgen05.Field.ACCUMULATE, True)
ab_pipeline.consumer_release(ab_consumer_state)
ab_consumer_state.advance()
peek_ab_full_status = cutlass.Boolean(1)
if ab_consumer_state.count < k_tile_cnt:
if is_leader_cta:
peek_ab_full_status = ab_pipeline.consumer_try_wait(ab_consumer_state)
if is_leader_cta:
acc_pipeline.producer_commit(acc_producer_state)
acc_producer_state.advance()
acc_pipeline.producer_tail(acc_producer_state)
# ---------------------------------------------------------------------
# Specialized epilogue warps (also allocate TMEM)
# ---------------------------------------------------------------------
if warp_idx < self.mma_warp_id:
tmem.allocate(self.num_tmem_alloc_cols)
tmem.wait_for_alloc()
acc_tmem_ptr = tmem.retrieve_ptr(self.acc_dtype)
tCtAcc1_base = cute.make_tensor(acc_tmem_ptr, tCtAcc_fake.layout)
tCtAcc2_base = cute.make_tensor(
acc_tmem_ptr + self.num_accumulator_tmem_cols,
tCtAcc_fake.layout,
)
epi_tidx = tidx
# Partition for tmem -> reg for both accumulators
tiled_copy_t2r_1, tTR_tAcc1_base, tTR_rAcc1 = self.epilog_tmem_copy_and_partition(
epi_tidx, tCtAcc1_base, tCgC, epi_tile, use_2cta_instrs
)
tiled_copy_t2r_2, tTR_tAcc2_base, tTR_rAcc2 = self.epilog_tmem_copy_and_partition(
epi_tidx, tCtAcc2_base, tCgC, epi_tile, use_2cta_instrs
)
# Use one copy atom (they should be identical)
tiled_copy_t2r = tiled_copy_t2r_1
tTR_rC = cute.make_rmem_tensor(tTR_rAcc1.shape, self.c_dtype)
tiled_copy_r2s, tRS_rC, tRS_sC = self.epilog_smem_copy_and_partition(
tiled_copy_t2r,
tTR_rC,
epi_tidx,
sC,
)
tma_atom_c, bSG_sC, bSG_gC_partitioned = self.epilog_gmem_copy_and_partition(
epi_tidx,
tma_atom_c,
tCgC,
epi_tile,
sC,
)
# Simple grid scheduling (like shiyegao, no persistent scheduler)
acc_consumer_state = pipeline.make_pipeline_state(
pipeline.PipelineUserType.Consumer, self.num_acc_stage
)
c_producer_group = pipeline.CooperativeGroup(
pipeline.Agent.Thread,
32 * len(self.epilog_warp_id),
)
c_pipeline = pipeline.PipelineTmaStore.create(
num_stages=self.num_c_stage,
producer_group=c_producer_group,
)
mma_tile_coord_mnl = (
bidx // cute.size(tiled_mma.thr_id.shape),
bidy,
bidz,
)
bSG_gC = bSG_gC_partitioned[(None, None, None, *mma_tile_coord_mnl)]
acc_stage_index = acc_consumer_state.index
tTR_tAcc1 = tTR_tAcc1_base[(None, None, None, None, None, acc_stage_index)]
tTR_tAcc2 = tTR_tAcc2_base[(None, None, None, None, None, acc_stage_index)]
acc_pipeline.consumer_wait(acc_consumer_state)
tTR_tAcc1 = cute.group_modes(tTR_tAcc1, 3, cute.rank(tTR_tAcc1))
tTR_tAcc2 = cute.group_modes(tTR_tAcc2, 3, cute.rank(tTR_tAcc2))
bSG_gC = cute.group_modes(bSG_gC, 1, cute.rank(bSG_gC))
subtile_cnt = cute.size(tTR_tAcc1.shape, mode=[3])
num_prev_subtiles = cutlass.Int32(0)
for subtile_idx in cutlass.range(subtile_cnt):
real_subtile_idx = subtile_idx
# Load both accumulators
tTR_tAcc1_mn = tTR_tAcc1[(None, None, None, real_subtile_idx)]
tTR_tAcc2_mn = tTR_tAcc2[(None, None, None, real_subtile_idx)]
cute.copy(tiled_copy_t2r, tTR_tAcc1_mn, tTR_rAcc1)
cute.copy(tiled_copy_t2r, tTR_tAcc2_mn, tTR_rAcc2)
# Fused epilogue: silu(acc1) * acc2
x = tiled_copy_r2s.retile(tTR_rAcc1).load()
y = tiled_copy_r2s.retile(tTR_rAcc2).load()
out = _silu(x) * y
tRS_rC.store(out.to(self.c_dtype))
# Store to SMEM
c_buffer = (num_prev_subtiles + real_subtile_idx) % self.num_c_stage
cute.copy(
tiled_copy_r2s,
tRS_rC,
tRS_sC[(None, None, None, c_buffer)],
)
cute.arch.fence_proxy(
cute.arch.ProxyKind.async_shared,
space=cute.arch.SharedSpace.shared_cta,
)
self.epilog_sync_barrier.arrive_and_wait()
# TMA store to GMEM (one warp)
if warp_idx == self.epilog_warp_id[0]:
try:
cute.copy(
tma_atom_c,
bSG_sC[(None, c_buffer)],
bSG_gC[(None, real_subtile_idx)],
cache_policy=cutlass.Int64(cutlass.Int64(_TMA_CACHE_EVICT_FIRST).ir_value()),
)
except TypeError:
cute.copy(
tma_atom_c,
bSG_sC[(None, c_buffer)],
bSG_gC[(None, real_subtile_idx)],
)
c_pipeline.producer_commit()
c_pipeline.producer_acquire()
self.epilog_sync_barrier.arrive_and_wait()
# Release accumulator buffer
with cute.arch.elect_one():
acc_pipeline.consumer_release(acc_consumer_state)
acc_consumer_state.advance()
tmem.relinquish_alloc_permit()
self.epilog_sync_barrier.arrive_and_wait()
tmem.free(acc_tmem_ptr)
c_pipeline.producer_tail()
return
# -------------------------------------------------------------------------
# Helper functions (mostly reused from CUTLASS example)
# -------------------------------------------------------------------------
def mainloop_s2t_copy_and_partition(
self,
sSF: cute.Tensor,
tSF: cute.Tensor,
):
tCsSF_compact = cute.filter_zeros(sSF)
tCtSF_compact = cute.filter_zeros(tSF)
copy_atom_s2t = cute.make_copy_atom(tcgen05.Cp4x32x128bOp(self.cta_group), self.sf_dtype)
tiled_copy_s2t = tcgen05.make_s2t_copy(copy_atom_s2t, tCtSF_compact)
thr_copy_s2t = tiled_copy_s2t.get_slice(0)
tCsSF_compact_s2t_ = thr_copy_s2t.partition_S(tCsSF_compact)
tCsSF_compact_s2t = tcgen05.get_s2t_smem_desc_tensor(tiled_copy_s2t, tCsSF_compact_s2t_)
tCtSF_compact_s2t = thr_copy_s2t.partition_D(tCtSF_compact)
return tiled_copy_s2t, tCsSF_compact_s2t, tCtSF_compact_s2t
def epilog_tmem_copy_and_partition(
self,
tidx: cutlass.Int32,
tAcc: cute.Tensor,
gC_mnl: cute.Tensor,
epi_tile: cute.Tile,
use_2cta_instrs: cutlass.Boolean | bool,
):
copy_atom_t2r = sm100_utils.get_tmem_load_op(
self.cta_tile_shape_mnk,
self.c_layout,
self.c_dtype,
self.acc_dtype,
epi_tile,
use_2cta_instrs,
)
tAcc_epi = cute.flat_divide(tAcc[((None, None), 0, 0, None)], epi_tile)
tiled_copy_t2r = tcgen05.make_tmem_copy(copy_atom_t2r, tAcc_epi[(None, None, 0, 0, 0)])
thr_copy_t2r = tiled_copy_t2r.get_slice(tidx)
tTR_tAcc = thr_copy_t2r.partition_S(tAcc_epi)
gC_mnl_epi = cute.flat_divide(
gC_mnl[((None, None), 0, 0, None, None, None)], epi_tile
)
tTR_gC = thr_copy_t2r.partition_D(gC_mnl_epi)
tTR_rAcc = cute.make_rmem_tensor(
tTR_gC[(None, None, None, 0, 0, 0, 0, 0)].shape,
self.acc_dtype,
)
return tiled_copy_t2r, tTR_tAcc, tTR_rAcc
def epilog_smem_copy_and_partition(
self,
tiled_copy_t2r: cute.TiledCopy,
tTR_rC: cute.Tensor,
tidx: cutlass.Int32,
sC: cute.Tensor,
):
copy_atom_r2s = sm100_utils.get_smem_store_op(
self.c_layout,
self.c_dtype,
self.acc_dtype,
tiled_copy_t2r,
)
tiled_copy_r2s = cute.make_tiled_copy_D(copy_atom_r2s, tiled_copy_t2r)
thr_copy_r2s = tiled_copy_r2s.get_slice(tidx)
tRS_sC = thr_copy_r2s.partition_D(sC)
tRS_rC = tiled_copy_r2s.retile(tTR_rC)
return tiled_copy_r2s, tRS_rC, tRS_sC
def epilog_gmem_copy_and_partition(
self,
tidx: cutlass.Int32,
atom: cute.CopyAtom | cute.TiledCopy,
gC_mnl: cute.Tensor,
epi_tile: cute.Tile,
sC: cute.Tensor,
):
gC_epi = cute.flat_divide(gC_mnl[((None, None), 0, 0, None, None, None)], epi_tile)
tma_atom_c = atom
sC_for_tma_partition = cute.group_modes(sC, 0, 2)
gC_for_tma_partition = cute.group_modes(gC_epi, 0, 2)
bSG_sC, bSG_gC = cpasync.tma_partition(
tma_atom_c,
0,
cute.make_layout(1),
sC_for_tma_partition,
gC_for_tma_partition,
)
return tma_atom_c, bSG_sC, bSG_gC
@staticmethod
def _compute_stages_dual(
tiled_mma: cute.TiledMma,
mma_tiler_mnk: tuple[int, int, int],
a_dtype,
b_dtype,
epi_tile: cute.Tile,
c_dtype,
c_layout: utils.LayoutEnum,
sf_dtype,
sf_vec_size: int,
smem_capacity: int,
occupancy: int,
ab_stages: int = 0,
):
# Dual-GEMM: accumulator stage count depends on N tile to fit TMEM.
# For N=64 we can afford 2 stages; for N>=128 we keep 1 stage.
num_acc_stage = 2 if mma_tiler_mnk[1] == 64 else 1
num_c_stage = 2
a_smem_layout_stage_one = sm100_utils.make_smem_layout_a(
tiled_mma,
mma_tiler_mnk,
a_dtype,
1,
)
b_smem_layout_stage_one = sm100_utils.make_smem_layout_b(
tiled_mma,
mma_tiler_mnk,
b_dtype,
1,
)
sfa_smem_layout_stage_one = blockscaled_utils.make_smem_layout_sfa(
tiled_mma,
mma_tiler_mnk,
sf_vec_size,
1,
)
sfb_smem_layout_stage_one = blockscaled_utils.make_smem_layout_sfb(
tiled_mma,
mma_tiler_mnk,
sf_vec_size,
1,
)
c_smem_layout_stage_one = sm100_utils.make_smem_layout_epi(
c_dtype,
c_layout,
epi_tile,
1,
)
ab_bytes_per_stage = (
cute.size_in_bytes(a_dtype, a_smem_layout_stage_one)
+ 2 * cute.size_in_bytes(b_dtype, b_smem_layout_stage_one)
+ cute.size_in_bytes(sf_dtype, sfa_smem_layout_stage_one)
+ 2 * cute.size_in_bytes(sf_dtype, sfb_smem_layout_stage_one)
)
mbar_helpers_bytes = 1024
c_bytes_per_stage = cute.size_in_bytes(c_dtype, c_smem_layout_stage_one)
c_bytes = c_bytes_per_stage * num_c_stage
max_ab_stage = (
smem_capacity // occupancy - (mbar_helpers_bytes + c_bytes)
) // ab_bytes_per_stage
if max_ab_stage < 1:
max_ab_stage = 1
num_ab_stage = max_ab_stage
if ab_stages > 0:
num_ab_stage = min(ab_stages, max_ab_stage)
num_c_stage += (
smem_capacity
- occupancy * ab_bytes_per_stage * num_ab_stage
- occupancy * (mbar_helpers_bytes + c_bytes)
) // (occupancy * c_bytes_per_stage)
if num_c_stage < 1:
num_c_stage = 1
return num_acc_stage, num_ab_stage, num_c_stage
@staticmethod
def _compute_grid(
c: cute.Tensor,
cta_tile_shape_mnk: tuple[int, int, int],
cluster_shape_mn: tuple[int, int],
max_active_clusters: int,
):
c_shape = cute.slice_(cta_tile_shape_mnk, (None, None, 0))
gc = cute.zipped_divide(c, tiler=c_shape)
num_ctas_mnl = gc[(0, (None, None, None))].shape
cluster_shape_mnl = (*cluster_shape_mn, 1)
tile_sched_params = utils.PersistentTileSchedulerParams(num_ctas_mnl, cluster_shape_mnl)
grid = utils.StaticPersistentTileScheduler.get_grid_shape(tile_sched_params, max_active_clusters)
return tile_sched_params, grid
# -----------------------------------------------------------------------------
# Compilation / dispatch
# -----------------------------------------------------------------------------
_COMPILED: dict[tuple[int, int, int, int, int, int], callable] = {}
def _get_max_active_clusters(cluster_shape_mn: tuple[int, int]) -> int:
cluster_size = cluster_shape_mn[0] * cluster_shape_mn[1]
hardware_info = cutlass.utils.HardwareInfo()
return hardware_info.get_max_active_clusters(cluster_size)
def _compile_for_config(
mma_m: int,
mma_n: int,
cluster_m: int,
cluster_n: int,
ab_stages: int,
prefetch_dist: int,
):
key = (mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist)
if key in _COMPILED:
return _COMPILED[key]
gemm = Sm100BlockScaledPersistentDualGemmKernel(
sf_vec_size=SF_VEC_SIZE,
mma_tiler_mn=(mma_m, mma_n),
cluster_shape_mn=(cluster_m, cluster_n),
ab_stages=ab_stages,
prefetch_dist=prefetch_dist,
)
max_active_clusters = _get_max_active_clusters((cluster_m, cluster_n))
@cute.jit
def my_kernel(
a_ptr: cute.Pointer,
b1_ptr: cute.Pointer,
b2_ptr: cute.Pointer,
sfa_ptr: cute.Pointer,
sfb1_ptr: cute.Pointer,
sfb2_ptr: cute.Pointer,
c_ptr: cute.Pointer,
problem_size: tuple,
):
m, n, k, l = problem_size
a_tensor = cute.make_tensor(
a_ptr,
cute.make_layout(
(m, cute.assume(k, 32), l),
stride=(cute.assume(k, 32), 1, cute.assume(m * k, 32)),
),
)
b1_tensor = cute.make_tensor(
b1_ptr,
cute.make_layout(
(n, cute.assume(k, 32), l),
stride=(cute.assume(k, 32), 1, cute.assume(n * k, 32)),
),
)
b2_tensor = cute.make_tensor(
b2_ptr,
cute.make_layout(
(n, cute.assume(k, 32), l),
stride=(cute.assume(k, 32), 1, cute.assume(n * k, 32)),
),
)
c_tensor = cute.make_tensor(
c_ptr,
cute.make_layout(
(cute.assume(m, 32), n, l),
stride=(n, 1, m * n),
),
)
# Scale factor tensors are reinterpreted internally into the blockscaled SF layout.
sfa_tensor = cute.make_tensor(sfa_ptr, cute.make_layout(1))
sfb1_tensor = cute.make_tensor(sfb1_ptr, cute.make_layout(1))
sfb2_tensor = cute.make_tensor(sfb2_ptr, cute.make_layout(1))
gemm(
a_tensor,
b1_tensor,
b2_tensor,
sfa_tensor,
sfb1_tensor,
sfb2_tensor,
c_tensor,
max_active_clusters,
)
return
# Compile once (use dummy pointers)
a_ptr = make_ptr(AB_DTYPE, 0, cute.AddressSpace.gmem, assumed_align=16)
b1_ptr = make_ptr(AB_DTYPE, 0, cute.AddressSpace.gmem, assumed_align=16)
b2_ptr = make_ptr(AB_DTYPE, 0, cute.AddressSpace.gmem, assumed_align=16)
c_ptr = make_ptr(C_DTYPE, 0, cute.AddressSpace.gmem, assumed_align=16)
sfa_ptr = make_ptr(SF_DTYPE, 0, cute.AddressSpace.gmem, assumed_align=32)
sfb1_ptr = make_ptr(SF_DTYPE, 0, cute.AddressSpace.gmem, assumed_align=32)
sfb2_ptr = make_ptr(SF_DTYPE, 0, cute.AddressSpace.gmem, assumed_align=32)
compiled = cute.compile(
my_kernel,
a_ptr,
b1_ptr,
b2_ptr,
sfa_ptr,
sfb1_ptr,
sfb2_ptr,
c_ptr,
(0, 0, 0, 0),
options="--opt-level 3",
)
_COMPILED[key] = compiled
return compiled
# -----------------------------------------------------------------------------
# Config selection / tuning
# -----------------------------------------------------------------------------
# Config tuple:
# (mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist)
# where:
# - ab_stages: 0 = auto; >0 = override (clamped to max that fits)
# - prefetch_dist: -1 = auto (=num_ab_stage); 0 = disable;
# >0 = explicit (clamped to <= num_ab_stage)
_NVFP4_DUAL_GEMM_FORCE_CONFIG_ENV = "NVFP4_DUAL_GEMM_FORCE_CONFIG"
def _parse_force_config() -> tuple[int, int, int, int, int, int] | None:
cfg = os.environ.get(_NVFP4_DUAL_GEMM_FORCE_CONFIG_ENV)
if not cfg:
return None
parts = [p.strip() for p in cfg.split(",") if p.strip()]
try:
values = [int(p) for p in parts]
except ValueError as e:
raise ValueError(
f"{_NVFP4_DUAL_GEMM_FORCE_CONFIG_ENV} must be comma-separated ints, got: {cfg!r}"
) from e
if len(values) == 4:
mma_m, mma_n, cluster_m, cluster_n = values
return (mma_m, mma_n, cluster_m, cluster_n, 0, -1)
if len(values) == 6:
mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist = values
return (mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist)
raise ValueError(
f"{_NVFP4_DUAL_GEMM_FORCE_CONFIG_ENV} must have 4 or 6 ints, got {len(values)}: {cfg!r}"
)
# Tuned configs for the public benchmark shapes (m, n, k).
# Update via local search/profiling on Blackwell.
_TUNED_CONFIGS: dict[tuple[int, int, int], tuple[int, int, int, int, int, int]] = {
(256, 4096, 7168): (256, 64, 2, 1, 0, -1),
(512, 4096, 7168): (256, 128, 4, 1, 0, -1),
(256, 3072, 4096): (256, 64, 2, 1, 0, -1),
(512, 3072, 7168): (256, 128, 4, 1, 0, -1),
}
def _select_config(m: int, n: int, k: int) -> tuple[int, int, int, int, int, int]:
forced = _parse_force_config()
if forced is not None:
mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist = forced
if (m % mma_m != 0) or (n % mma_n != 0):
raise ValueError(
f"Forced config {forced} is incompatible with problem (m={m}, n={n}, k={k})"
)
return forced
tuned = _TUNED_CONFIGS.get((m, n, k))
if tuned is not None:
return tuned
# Fallback heuristic (non-benchmark shapes).
mma_m = 256 if (m % 256 == 0) else 128
mma_n = 128 if (n % 128 == 0 and n >= 3072) else 64
cluster_m = 2 if mma_m == 256 else 1
cluster_n = 1
ab_stages = 0
prefetch_dist = -1
return (mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist)
def custom_kernel(data: input_t) -> output_t:
a, b1, b2, _, _, _, sfa_permuted, sfb1_permuted, sfb2_permuted, c = data
# Torch uses float4_e2m1fn_x2, so logical K is doubled.
m = c.shape[0]
n = c.shape[1]
l = c.shape[2]
k = a.shape[1] * 2
mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist = _select_config(m, n, k)
compiled = _compile_for_config(mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist)
a_ptr = make_ptr(AB_DTYPE, a.data_ptr(), cute.AddressSpace.gmem, assumed_align=16)
b1_ptr = make_ptr(AB_DTYPE, b1.data_ptr(), cute.AddressSpace.gmem, assumed_align=16)
b2_ptr = make_ptr(AB_DTYPE, b2.data_ptr(), cute.AddressSpace.gmem, assumed_align=16)
c_ptr = make_ptr(C_DTYPE, c.data_ptr(), cute.AddressSpace.gmem, assumed_align=16)
sfa_ptr = make_ptr(SF_DTYPE, sfa_permuted.data_ptr(), cute.AddressSpace.gmem, assumed_align=32)
sfb1_ptr = make_ptr(SF_DTYPE, sfb1_permuted.data_ptr(), cute.AddressSpace.gmem, assumed_align=32)
sfb2_ptr = make_ptr(SF_DTYPE, sfb2_permuted.data_ptr(), cute.AddressSpace.gmem, assumed_align=32)
compiled(a_ptr, b1_ptr, b2_ptr, sfa_ptr, sfb1_ptr, sfb2_ptr, c_ptr, (m, n, k, l))
return c
scrolls · 1661 lines total
Source code from GPU Mode and the KernelBot dataset · June 9 Researcher Reciprocity License v1.0
Changes from previous submission
Against this author's previous submission submission 364470.
⋯ 35 unchanged linesdef _silu(x):# x * sigmoid(x) using tanh: sigmoid(x) = 0.5 * (1 + tanh(x/2))- # Optimized: half_x * (1 + tanh) = half_x + half_x * tanh (FMA pattern)- half_x = x * 0.5- return half_x + half_x * cute.math.tanh(half_x, fastmath=True)+ return x * 0.5 * (1.0 + cute.math.tanh(x * 0.5, fastmath=True))# -----------------------------------------------------------------------------⋯ 17 unchanged linessf_vec_size: int,mma_tiler_mn: tuple[int, int],cluster_shape_mn: tuple[int, int],- ab_stages_override: int = 0, # 0 means auto-compute- prefetch_dist: int = 0, # K-tile prefetch distance (0 disables, -1 means auto)- num_c_stage_override: int = 0, # 0 means auto-compute- occupancy: int = 1,- buffer_align_bytes: int = 1024,- tma_cache_policy_a: int = _TMA_CACHE_EVICT_FIRST,- tma_cache_policy_b: int = _TMA_CACHE_EVICT_FIRST,- mainloop_unroll: int = 1,+ ab_stages: int = 0,+ prefetch_dist: int = -1,):self.acc_dtype = cutlass.Float32self.sf_vec_size = sf_vec_size⋯ 20 unchanged linesnum_threads=32 * len((self.mma_warp_id, *self.epilog_warp_id)),)- self.occupancy = occupancy+ self.occupancy = 1self.smem_capacity = utils.get_smem_capacity_in_bytes("sm_100")# TMEM capacity (SM100)self.num_tmem_alloc_cols = 512- # TMA prefetch distance in K-tiles (0 disables, -1 means auto=num_ab_stage)- self.prefetch_dist = prefetch_dist+ # Optional overrides+ # - ab_stages: 0 = auto, >0 = override (clamped to max that fits)+ # - prefetch_dist: -1 = auto (=num_ab_stage), 0 = disable,+ # >0 = explicit (clamped to <= num_ab_stage)+ self.ab_stages_param = ab_stages+ self.prefetch_dist_param = prefetch_dist++ self.prefetch_dist = 0self.prefetch_enabled = False- # Pipeline stage overrides (0 = auto)- self.ab_stages_override = ab_stages_override- self.num_c_stage_override = num_c_stage_override-- # SMEM alignment- self.buffer_align_bytes = buffer_align_bytes-- # TMA cache policies- self.tma_cache_policy_a = tma_cache_policy_a- self.tma_cache_policy_b = tma_cache_policy_b-- # Main loop unroll factor- self.mainloop_unroll = mainloop_unroll-def _setup_attributes(self):# MMA inst shapes (MN is configured, K is fixed by tcgen05 op)self.mma_inst_shape_mn = (self.mma_tiler[0], self.mma_tiler[1])⋯ 87 unchanged linesself.sf_vec_size,self.smem_capacity,self.occupancy,+ self.ab_stages_param,)- # Apply stage overrides if specified- if self.ab_stages_override > 0:- self.num_ab_stage = self.ab_stages_override- if self.num_c_stage_override > 0:- self.num_c_stage = self.num_c_stage_override- if self.num_c_stage < 1:- self.num_c_stage = 1-- # Prefetch distance (clamped to [0, num_ab_stage]; -1 means auto=num_ab_stage)- if self.prefetch_dist < 0:+ # Prefetch distance:+ # -1 => auto (=num_ab_stage)+ # 0 => disabled+ # >0 => explicit (clamped to <= num_ab_stage)+ if self.prefetch_dist_param < 0:self.prefetch_dist = self.num_ab_stage+ else:+ self.prefetch_dist = self.prefetch_dist_paramif self.prefetch_dist > self.num_ab_stage:self.prefetch_dist = self.num_ab_stage+ if self.prefetch_dist < 0:+ self.prefetch_dist = 0self.prefetch_enabled = self.prefetch_dist > 0# Shared memory layouts⋯ 28 unchanged linesself.num_c_stage,)- # TMEM column accounting+ # TMEM col accountingsf_atom_mn = 32self.num_sfa_tmem_cols = (self.cta_tile_shape_mnk[0] // sf_atom_mn) * 4self.num_sfb_tmem_cols = (self.cta_tile_shape_mnk_sfb[1] // sf_atom_mn) * 4- self.num_sf_tmem_cols = self.num_sfa_tmem_cols + 2 * self.num_sfb_tmem_cols- # Overlapping accumulator (CUTLASS SM100 pattern):- # When num_acc_stage==1 (e.g., N>=128 for dual-gemm), we can still double-buffer the- # accumulators by letting stage0/stage1 overlap by num_sf_tmem_cols columns.- self.overlapping_accum = self.num_acc_stage == 1- # Release index for the overlapped portion (ceil(num_sf_tmem_cols/epi_tile_n) - 1)- self.iter_acc_early_release_in_epilogue = max(- 0, (self.num_sf_tmem_cols + self.epi_tile_n - 1) // self.epi_tile_n - 1- )+ # Accumulator cols per GEMM (include acc stage)+ self.num_accumulator_tmem_cols = self.cta_tile_shape_mnk[1] * self.num_acc_stage- if self.overlapping_accum:- # Two accumulators, each uses N columns per stage, with 2 logical stages overlapped.- self.num_accumulator_tmem_cols_per_acc = self.cta_tile_shape_mnk[1]- self.acc_stage_stride_cols = 2 * self.cta_tile_shape_mnk[1] - self.num_sf_tmem_cols- if self.acc_stage_stride_cols <= 0:- raise ValueError(- f"Invalid accumulator overlap: stride={self.acc_stage_stride_cols} cols (N={self.cta_tile_shape_mnk[1]}, sf_cols={self.num_sf_tmem_cols})"- )- self.num_accumulator_tmem_cols_total = (- 4 * self.cta_tile_shape_mnk[1] - self.num_sf_tmem_cols- )- else:- # Two accumulators, each has num_acc_stage stages- self.num_accumulator_tmem_cols_per_acc = (- self.cta_tile_shape_mnk[1] * self.num_acc_stage- )- self.acc_stage_stride_cols = self.cta_tile_shape_mnk[1]- self.num_accumulator_tmem_cols_total = 2 * self.num_accumulator_tmem_cols_per_acc-- used_cols = self.num_accumulator_tmem_cols_total + self.num_sf_tmem_cols+ used_cols = (+ 2 * self.num_accumulator_tmem_cols+ + self.num_sfa_tmem_cols+ + 2 * self.num_sfb_tmem_cols+ )if used_cols > self.num_tmem_alloc_cols:raise ValueError(f"TMEM overcommit: need {used_cols} cols but only have {self.num_tmem_alloc_cols}. "⋯ 181 unchanged linesnum_ctas_mnl[2],)+ self.buffer_align_bytes = 1024+# Define shared storage for kernel@cute.structclass SharedStorage:⋯ 147 unchanged linesuse_2cta_instrs = cute.size(tiled_mma.thr_id.shape) == 2- cache_policy_a = cutlass.Int64(cutlass.Int64(self.tma_cache_policy_a).ir_value())- cache_policy_b = cutlass.Int64(cutlass.Int64(self.tma_cache_policy_b).ir_value())-# Coords inside clusterbidx, bidy, bidz = cute.arch.block_idx()mma_tile_coord_v = bidx % cute.size(tiled_mma.thr_id.shape)⋯ 179 unchanged linestCrB2 = tiled_mma.make_fragment_B(sB2)acc_shape = tiled_mma.partition_shape_C(self.mma_tiler[:2])- if cutlass.const_expr(self.overlapping_accum):- num_acc_stage_overlapped = 2- tCtAcc_fake = tiled_mma.make_fragment_C(- cute.append(acc_shape, num_acc_stage_overlapped)- )- # Overlap stage0/stage1 in TMEM by num_sf_tmem_cols columns.- tCtAcc_fake = cute.make_tensor(- tCtAcc_fake.iterator,- cute.make_layout(- tCtAcc_fake.shape,- stride=(- tCtAcc_fake.stride[0],- tCtAcc_fake.stride[1],- tCtAcc_fake.stride[2],- self.acc_stage_stride_cols * tCtAcc_fake.stride[0][1],- ),- ),- )- else:- tCtAcc_fake = tiled_mma.make_fragment_C(cute.append(acc_shape, self.num_acc_stage))+ tCtAcc_fake = tiled_mma.make_fragment_C(cute.append(acc_shape, self.num_acc_stage))# Cluster wait before tmem allocpipeline_init_wait(cluster_shape_mn=self.cluster_shape_mn)⋯ 22 unchanged linestBgSFB2_slice = tBgSFB2[(None, slice_n_sfb, None, mma_tile_coord_mnl[2])]# Prefetch: initial batch to prime the TMA pipelineif self.prefetch_enabled:- for pf_k_tile in cutlass.range(0, self.prefetch_dist, 1, unroll=1):- if pf_k_tile < k_tile_cnt:- cute.prefetch(tma_atom_a, tAgA_slice[(None, pf_k_tile)])- cute.prefetch(tma_atom_b1, tBgB1_slice[(None, pf_k_tile)])- cute.prefetch(tma_atom_b2, tBgB2_slice[(None, pf_k_tile)])- cute.prefetch(tma_atom_sfa, tAgSFA_slice[(None, pf_k_tile)])- cute.prefetch(tma_atom_sfb1, tBgSFB1_slice[(None, pf_k_tile)])- cute.prefetch(tma_atom_sfb2, tBgSFB2_slice[(None, pf_k_tile)])+ for pf_k_tile in cutlass.range(+ 0, min(self.prefetch_dist, k_tile_cnt), unroll=1+ ):+ cute.prefetch(tma_atom_a, tAgA_slice[(None, pf_k_tile)])+ cute.prefetch(tma_atom_b1, tBgB1_slice[(None, pf_k_tile)])+ cute.prefetch(tma_atom_b2, tBgB2_slice[(None, pf_k_tile)])+ cute.prefetch(tma_atom_sfa, tAgSFA_slice[(None, pf_k_tile)])+ cute.prefetch(tma_atom_sfb1, tBgSFB1_slice[(None, pf_k_tile)])+ cute.prefetch(tma_atom_sfb2, tBgSFB2_slice[(None, pf_k_tile)])ab_producer_state.reset_count()peek_ab_empty_status = cutlass.Boolean(1)if ab_producer_state.count < k_tile_cnt:⋯ 9 unchanged linestAsA[(None, ab_producer_state.index)],tma_bar_ptr=bar,mcast_mask=a_full_mcast_mask,- cache_policy=cache_policy_a,+ cache_policy=cutlass.Int64(cutlass.Int64(_TMA_CACHE_EVICT_FIRST).ir_value()),)except TypeError:cute.copy(⋯ 10 unchanged linestBsB1[(None, ab_producer_state.index)],tma_bar_ptr=bar,mcast_mask=b_full_mcast_mask,- cache_policy=cache_policy_b,+ cache_policy=cutlass.Int64(cutlass.Int64(_TMA_CACHE_EVICT_FIRST).ir_value()),)except TypeError:cute.copy(⋯ 10 unchanged linestBsB2[(None, ab_producer_state.index)],tma_bar_ptr=bar,mcast_mask=b_full_mcast_mask,- cache_policy=cache_policy_b,+ cache_policy=cutlass.Int64(cutlass.Int64(_TMA_CACHE_EVICT_FIRST).ir_value()),)except TypeError:cute.copy(⋯ 10 unchanged linestAsSFA[(None, ab_producer_state.index)],tma_bar_ptr=bar,mcast_mask=sfa_full_mcast_mask,- cache_policy=cache_policy_a,+ cache_policy=cutlass.Int64(cutlass.Int64(_TMA_CACHE_EVICT_FIRST).ir_value()),)except TypeError:cute.copy(⋯ 10 unchanged linestBsSFB1[(None, ab_producer_state.index)],tma_bar_ptr=bar,mcast_mask=sfb_full_mcast_mask,- cache_policy=cache_policy_b,+ cache_policy=cutlass.Int64(cutlass.Int64(_TMA_CACHE_EVICT_FIRST).ir_value()),)except TypeError:cute.copy(⋯ 10 unchanged linestBsSFB2[(None, ab_producer_state.index)],tma_bar_ptr=bar,mcast_mask=sfb_full_mcast_mask,- cache_policy=cache_policy_b,+ cache_policy=cutlass.Int64(cutlass.Int64(_TMA_CACHE_EVICT_FIRST).ir_value()),)except TypeError:cute.copy(⋯ 5 unchanged lines)# Prefetch: rolling prefetch for next tilesif self.prefetch_enabled:- future_k_tile = ab_producer_state.count + self.prefetch_dist- if future_k_tile < k_tile_cnt:+ if k_tile_prefetch < k_tile_cnt - self.prefetch_dist:+ future_k_tile = ab_producer_state.count + self.prefetch_distcute.prefetch(tma_atom_a, tAgA_slice[(None, future_k_tile)])cute.prefetch(tma_atom_b1, tBgB1_slice[(None, future_k_tile)])cute.prefetch(tma_atom_b2, tBgB2_slice[(None, future_k_tile)])⋯ 16 unchanged lines# Acc1/Acc2 base (MMA, MMA_M, MMA_N, STAGE)tCtAcc1_base = cute.make_tensor(acc_tmem_ptr, tCtAcc_fake.layout)- acc2_ptr = acc_tmem_ptr + self.num_accumulator_tmem_cols_per_acc+ acc2_ptr = acc_tmem_ptr + self.num_accumulator_tmem_colstCtAcc2_base = cute.make_tensor(acc2_ptr, tCtAcc_fake.layout)# SFA/SFB TMEM tensorssfa_tmem_ptr = cute.recast_ptr(- acc_tmem_ptr + self.num_accumulator_tmem_cols_total,+ acc_tmem_ptr + 2 * self.num_accumulator_tmem_cols,dtype=self.sf_dtype,)tCtSFA_layout = blockscaled_utils.make_tmem_layout_sfa(⋯ 5 unchanged linestCtSFA = cute.make_tensor(sfa_tmem_ptr, tCtSFA_layout)sfb1_tmem_ptr = cute.recast_ptr(- acc_tmem_ptr + self.num_accumulator_tmem_cols_total + self.num_sfa_tmem_cols,+ acc_tmem_ptr + 2 * self.num_accumulator_tmem_cols + self.num_sfa_tmem_cols,dtype=self.sf_dtype,)tCtSFB_layout = blockscaled_utils.make_tmem_layout_sfb(⋯ 6 unchanged linessfb2_tmem_ptr = cute.recast_ptr(acc_tmem_ptr- + self.num_accumulator_tmem_cols_total+ + 2 * self.num_accumulator_tmem_cols+ self.num_sfa_tmem_cols+ self.num_sfb_tmem_cols,dtype=self.sf_dtype,⋯ 29 unchanged linesbidy,bidz,)- if cutlass.const_expr(self.overlapping_accum):- acc_stage_index = acc_producer_state.phase ^ 1- else:- acc_stage_index = acc_producer_state.index+ acc_stage_index = acc_producer_state.indextCtAcc1 = tCtAcc1_base[(None, None, None, acc_stage_index)]tCtAcc2 = tCtAcc2_base[(None, None, None, acc_stage_index)]ab_consumer_state.reset_count()⋯ 8 unchanged linesif cutlass.const_expr(self.cta_tile_shape_mnk[1] == 192):offset = cutlass.Int32(2) if mma_tile_coord_mnl[1] % 2 == 1 else cutlass.Int32(0)shifted_ptr1 = cute.recast_ptr(- acc_tmem_ptr + self.num_accumulator_tmem_cols_total + self.num_sfa_tmem_cols + offset,+ acc_tmem_ptr + 2 * self.num_accumulator_tmem_cols + self.num_sfa_tmem_cols + offset,dtype=self.sf_dtype,)tCtSFB1_mma = cute.make_tensor(shifted_ptr1, tCtSFB_layout)shifted_ptr2 = cute.recast_ptr(acc_tmem_ptr- + self.num_accumulator_tmem_cols_total+ + 2 * self.num_accumulator_tmem_cols+ self.num_sfa_tmem_cols+ self.num_sfb_tmem_cols+ offset,⋯ 3 unchanged lineselif cutlass.const_expr(self.cta_tile_shape_mnk[1] == 64):offset = cutlass.Int32((mma_tile_coord_mnl[1] % 2) * 2)shifted_ptr1 = cute.recast_ptr(- acc_tmem_ptr + self.num_accumulator_tmem_cols_total + self.num_sfa_tmem_cols + offset,+ acc_tmem_ptr + 2 * self.num_accumulator_tmem_cols + self.num_sfa_tmem_cols + offset,dtype=self.sf_dtype,)tCtSFB1_mma = cute.make_tensor(shifted_ptr1, tCtSFB_layout)shifted_ptr2 = cute.recast_ptr(acc_tmem_ptr- + self.num_accumulator_tmem_cols_total+ + 2 * self.num_accumulator_tmem_cols+ self.num_sfa_tmem_cols+ self.num_sfb_tmem_cols+ offset,⋯ 21 unchanged linestCtSFB2_compact_s2t,)num_kblocks = cute.size(tCrA, mode=[2])- # Interleaved execution: GEMM1 then GEMM2 for each kblockfor kblock_idx in cutlass.range(num_kblocks, unroll_full=True):kblock_coord = (None, None, kblock_idx, ab_consumer_state.index)sf_kblock_coord = (None, None, kblock_idx)-- # GEMM1: set scale factors and computetiled_mma.set(tcgen05.Field.SFA, tCtSFA[sf_kblock_coord].iterator)tiled_mma.set(tcgen05.Field.SFB, tCtSFB1_mma[sf_kblock_coord].iterator)- cute.gemm(tiled_mma, tCtAcc1, tCrA[kblock_coord], tCrB1[kblock_coord], tCtAcc1)-- # GEMM2: SFA is same, only SFB changes+ cute.gemm(+ tiled_mma,+ tCtAcc1,+ tCrA[kblock_coord],+ tCrB1[kblock_coord],+ tCtAcc1,+ )tiled_mma.set(tcgen05.Field.SFB, tCtSFB2_mma[sf_kblock_coord].iterator)- cute.gemm(tiled_mma, tCtAcc2, tCrA[kblock_coord], tCrB2[kblock_coord], tCtAcc2)-- # Enable accumulate after first kblock for both GEMMs+ cute.gemm(+ tiled_mma,+ tCtAcc2,+ tCrA[kblock_coord],+ tCrB2[kblock_coord],+ tCtAcc2,+ )tiled_mma.set(tcgen05.Field.ACCUMULATE, True)ab_pipeline.consumer_release(ab_consumer_state)ab_consumer_state.advance()⋯ 16 unchanged linesacc_tmem_ptr = tmem.retrieve_ptr(self.acc_dtype)tCtAcc1_base = cute.make_tensor(acc_tmem_ptr, tCtAcc_fake.layout)tCtAcc2_base = cute.make_tensor(- acc_tmem_ptr + self.num_accumulator_tmem_cols_per_acc,+ acc_tmem_ptr + self.num_accumulator_tmem_cols,tCtAcc_fake.layout,)⋯ 44 unchanged linesbidz,)bSG_gC = bSG_gC_partitioned[(None, None, None, *mma_tile_coord_mnl)]- if cutlass.const_expr(self.overlapping_accum):- acc_stage_index = acc_consumer_state.phase- reverse_subtile = (- cutlass.Boolean(True) if acc_stage_index == 0 else cutlass.Boolean(False)- )- else:- acc_stage_index = acc_consumer_state.index+ acc_stage_index = acc_consumer_state.indextTR_tAcc1 = tTR_tAcc1_base[(None, None, None, None, None, acc_stage_index)]tTR_tAcc2 = tTR_tAcc2_base[(None, None, None, None, None, acc_stage_index)]acc_pipeline.consumer_wait(acc_consumer_state)⋯ 4 unchanged linesnum_prev_subtiles = cutlass.Int32(0)for subtile_idx in cutlass.range(subtile_cnt):real_subtile_idx = subtile_idx- if cutlass.const_expr(self.overlapping_accum):- if reverse_subtile:- real_subtile_idx = (- self.cta_tile_shape_mnk[1] // self.epi_tile_n - 1 - subtile_idx- )# Load both accumulatorstTR_tAcc1_mn = tTR_tAcc1[(None, None, None, real_subtile_idx)]tTR_tAcc2_mn = tTR_tAcc2[(None, None, None, real_subtile_idx)]cute.copy(tiled_copy_t2r, tTR_tAcc1_mn, tTR_rAcc1)cute.copy(tiled_copy_t2r, tTR_tAcc2_mn, tTR_rAcc2)-- # Async arrive accumulator buffer empty earlier when overlapping_accum is enabled- if cutlass.const_expr(self.overlapping_accum):- if subtile_idx == self.iter_acc_early_release_in_epilogue:- cute.arch.fence_view_async_tmem_load()- with cute.arch.elect_one():- acc_pipeline.consumer_release(acc_consumer_state)- acc_consumer_state.advance()# Fused epilogue: silu(acc1) * acc2x = tiled_copy_r2s.retile(tTR_rAcc1).load()y = tiled_copy_r2s.retile(tTR_rAcc2).load()⋯ 28 unchanged lines)c_pipeline.producer_commit()c_pipeline.producer_acquire()- # Note: Second barrier removed - relies on c_pipeline for TMA ordering- # and num_c_stage >= 2 for buffer separation- # self.epilog_sync_barrier.arrive_and_wait()- # Release accumulator buffer (non-overlapped case releases after full epilogue)- if cutlass.const_expr(not self.overlapping_accum):- with cute.arch.elect_one():- acc_pipeline.consumer_release(acc_consumer_state)- acc_consumer_state.advance()+ self.epilog_sync_barrier.arrive_and_wait()+ # Release accumulator buffer+ with cute.arch.elect_one():+ acc_pipeline.consumer_release(acc_consumer_state)+ acc_consumer_state.advance()tmem.relinquish_alloc_permit()self.epilog_sync_barrier.arrive_and_wait()⋯ 112 unchanged linessf_vec_size: int,smem_capacity: int,occupancy: int,+ ab_stages: int = 0,):# Dual-GEMM: accumulator stage count depends on N tile to fit TMEM.# For N=64 we can afford 2 stages; for N>=128 we keep 1 stage.⋯ 41 unchanged linesc_bytes_per_stage = cute.size_in_bytes(c_dtype, c_smem_layout_stage_one)c_bytes = c_bytes_per_stage * num_c_stage- num_ab_stage = (+ max_ab_stage = (smem_capacity // occupancy - (mbar_helpers_bytes + c_bytes)) // ab_bytes_per_stage- if num_ab_stage < 1:- num_ab_stage = 1+ if max_ab_stage < 1:+ max_ab_stage = 1+ num_ab_stage = max_ab_stage+ if ab_stages > 0:+ num_ab_stage = min(ab_stages, max_ab_stage)+num_c_stage += (smem_capacity- occupancy * ab_bytes_per_stage * num_ab_stage⋯ 26 unchanged lines# ------------------------------------------------------------------------------ _COMPILED: dict[tuple[int, ...], callable] = {}+ _COMPILED: dict[tuple[int, int, int, int, int, int], callable] = {}- def _tma_cache_policy(policy: int) -> int:- if policy == 0:- return _TMA_CACHE_EVICT_NORMAL- if policy == 1:- return _TMA_CACHE_EVICT_FIRST- if policy == 2:- return _TMA_CACHE_EVICT_LAST- return _TMA_CACHE_EVICT_NORMAL---def _get_max_active_clusters(cluster_shape_mn: tuple[int, int]) -> int:cluster_size = cluster_shape_mn[0] * cluster_shape_mn[1]hardware_info = cutlass.utils.HardwareInfo()⋯ 5 unchanged linesmma_n: int,cluster_m: int,cluster_n: int,- *,- ab_stages: int = 0,- prefetch_dist: int = 0,- num_c_stage: int = 0,- occupancy: int = 1,- buffer_align_bytes: int = 1024,- cache_policy_a: int = 1,- cache_policy_b: int = 1,- mainloop_unroll: int = 1,+ ab_stages: int,+ prefetch_dist: int,):- key = (- mma_m,- mma_n,- cluster_m,- cluster_n,- ab_stages,- prefetch_dist,- num_c_stage,- occupancy,- buffer_align_bytes,- cache_policy_a,- cache_policy_b,- mainloop_unroll,- )+ key = (mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist)if key in _COMPILED:return _COMPILED[key]⋯ 1 unchanged linessf_vec_size=SF_VEC_SIZE,mma_tiler_mn=(mma_m, mma_n),cluster_shape_mn=(cluster_m, cluster_n),- ab_stages_override=ab_stages,+ ab_stages=ab_stages,prefetch_dist=prefetch_dist,- num_c_stage_override=num_c_stage,- occupancy=occupancy,- buffer_align_bytes=buffer_align_bytes,- tma_cache_policy_a=_tma_cache_policy(cache_policy_a),- tma_cache_policy_b=_tma_cache_policy(cache_policy_b),- mainloop_unroll=mainloop_unroll,)max_active_clusters = _get_max_active_clusters((cluster_m, cluster_n))⋯ 58 unchanged linesreturn# Compile once (use dummy pointers)- a_ptr = make_ptr(AB_DTYPE, 0, cute.AddressSpace.gmem, assumed_align=32)- b1_ptr = make_ptr(AB_DTYPE, 0, cute.AddressSpace.gmem, assumed_align=32)- b2_ptr = make_ptr(AB_DTYPE, 0, cute.AddressSpace.gmem, assumed_align=32)+ a_ptr = make_ptr(AB_DTYPE, 0, cute.AddressSpace.gmem, assumed_align=16)+ b1_ptr = make_ptr(AB_DTYPE, 0, cute.AddressSpace.gmem, assumed_align=16)+ b2_ptr = make_ptr(AB_DTYPE, 0, cute.AddressSpace.gmem, assumed_align=16)c_ptr = make_ptr(C_DTYPE, 0, cute.AddressSpace.gmem, assumed_align=16)sfa_ptr = make_ptr(SF_DTYPE, 0, cute.AddressSpace.gmem, assumed_align=32)sfb1_ptr = make_ptr(SF_DTYPE, 0, cute.AddressSpace.gmem, assumed_align=32)⋯ 15 unchanged lines_COMPILED[key] = compiledreturn compiled- # Tuned configs for the public benchmark shapes (m, n, k).- # Format:- # (mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist, num_c_stage, occupancy,- # buffer_align_bytes, cache_policy_a, cache_policy_b, mainloop_unroll)- #- # Notes:- # - ab_stages=0 / num_c_stage=0 mean auto-compute.- # - prefetch_dist: 0 disables, -1 means auto=num_ab_stage.- # - cache_policy: 0=NORMAL, 1=FIRST, 2=LAST.- _TUNED_CONFIGS: dict[tuple[int, int, int], tuple[int, ...]] = {- (256, 4096, 7168): (256, 64, 2, 1, 0, 0, 0, 1, 1024, 1, 1, 1),- (512, 4096, 7168): (256, 128, 2, 1, 0, 0, 0, 1, 1024, 1, 1, 1),- (256, 3072, 4096): (256, 64, 2, 1, 0, 0, 0, 1, 1024, 1, 1, 1),- (512, 3072, 7168): (256, 128, 2, 1, 0, 0, 0, 1, 1024, 1, 1, 1),- }+ # -----------------------------------------------------------------------------+ # Config selection / tuning+ # -----------------------------------------------------------------------------+ # Config tuple:+ # (mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist)+ # where:+ # - ab_stages: 0 = auto; >0 = override (clamped to max that fits)+ # - prefetch_dist: -1 = auto (=num_ab_stage); 0 = disable;+ # >0 = explicit (clamped to <= num_ab_stage)+ _NVFP4_DUAL_GEMM_FORCE_CONFIG_ENV = "NVFP4_DUAL_GEMM_FORCE_CONFIG"- _FORCE_CONFIG_STR: str | None = None- _FORCE_CONFIG: tuple[int, ...] | None = None-- def _get_force_config() -> tuple[int, ...] | None:- global _FORCE_CONFIG_STR, _FORCE_CONFIG- force = os.environ.get("NVFP4_DUAL_GEMM_FORCE_CONFIG")- if not force:- _FORCE_CONFIG_STR = None- _FORCE_CONFIG = None+ def _parse_force_config() -> tuple[int, int, int, int, int, int] | None:+ cfg = os.environ.get(_NVFP4_DUAL_GEMM_FORCE_CONFIG_ENV)+ if not cfg:return None- if force == _FORCE_CONFIG_STR and _FORCE_CONFIG is not None:- return _FORCE_CONFIG- parts = [int(x.strip()) for x in force.split(",") if x.strip()]- if len(parts) != 12:+ parts = [p.strip() for p in cfg.split(",") if p.strip()]+ try:+ values = [int(p) for p in parts]+ except ValueError as e:raise ValueError(- "NVFP4_DUAL_GEMM_FORCE_CONFIG must have 12 comma-separated ints: "- "mma_m,mma_n,cluster_m,cluster_n,ab_stages,prefetch_dist,num_c_stage,occupancy,buffer_align_bytes,cache_a,cache_b,unroll"- )- cfg = tuple(parts)- _FORCE_CONFIG_STR = force- _FORCE_CONFIG = cfg- return cfg+ f"{_NVFP4_DUAL_GEMM_FORCE_CONFIG_ENV} must be comma-separated ints, got: {cfg!r}"+ ) from e+ if len(values) == 4:+ mma_m, mma_n, cluster_m, cluster_n = values+ return (mma_m, mma_n, cluster_m, cluster_n, 0, -1)- def _select_config(m: int, n: int, k: int) -> tuple[int, ...]:- force_cfg = _get_force_config()- if force_cfg is not None:- return force_cfg+ if len(values) == 6:+ mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist = values+ return (mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist)- tuned = _TUNED_CONFIGS.get((m, n, k))- if tuned is not None:- return tuned+ raise ValueError(+ f"{_NVFP4_DUAL_GEMM_FORCE_CONFIG_ENV} must have 4 or 6 ints, got {len(values)}: {cfg!r}"+ )- # Fallback heuristic (non-benchmark shapes).- default_ab_stages = 0- default_prefetch_dist = 0- default_num_c_stage = 0- default_occupancy = 1- default_buffer_align_bytes = 1024- default_cache_a = 1 # FIRST- default_cache_b = 1 # FIRST- default_unroll = 1- # Prefer larger N tiles when M is large enough to keep the MMA/epilogue busy.- if (m % 256 == 0) and (n % 128 == 0) and (m >= 512):- return (- 256,- 128,- 2,- 1,- default_ab_stages,- default_prefetch_dist,- default_num_c_stage,- default_occupancy,- default_buffer_align_bytes,- default_cache_a,- default_cache_b,- default_unroll,- )+ # Tuned configs for the public benchmark shapes (m, n, k).+ # Update via local search/profiling on Blackwell.+ _TUNED_CONFIGS: dict[tuple[int, int, int], tuple[int, int, int, int, int, int]] = {+ (256, 4096, 7168): (256, 64, 2, 1, 0, -1),+ (512, 4096, 7168): (256, 128, 4, 1, 0, -1),+ (256, 3072, 4096): (256, 64, 2, 1, 0, -1),+ (512, 3072, 7168): (256, 128, 4, 1, 0, -1),+ }- # Default: 256x64 (2-CTA tcgen05) for most shapes.- if (m % 256 == 0) and (n % 64 == 0):- return (- 256,- 64,- 2,- 1,- default_ab_stages,- default_prefetch_dist,- default_num_c_stage,- default_occupancy,- default_buffer_align_bytes,- default_cache_a,- default_cache_b,- default_unroll,- )- # Smaller fallback.- if n % 64 == 0:- return (- 128,- 64,- 1,- 1,- default_ab_stages,- default_prefetch_dist,- default_num_c_stage,- default_occupancy,- default_buffer_align_bytes,- default_cache_a,- default_cache_b,- default_unroll,- )+ def _select_config(m: int, n: int, k: int) -> tuple[int, int, int, int, int, int]:+ forced = _parse_force_config()+ if forced is not None:+ mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist = forced+ if (m % mma_m != 0) or (n % mma_n != 0):+ raise ValueError(+ f"Forced config {forced} is incompatible with problem (m={m}, n={n}, k={k})"+ )+ return forced- if (m % 256 == 0) and (n % 128 == 0):- return (- 256,- 128,- 2,- 1,- default_ab_stages,- default_prefetch_dist,- default_num_c_stage,- default_occupancy,- default_buffer_align_bytes,- default_cache_a,- default_cache_b,- default_unroll,- )+ tuned = _TUNED_CONFIGS.get((m, n, k))+ if tuned is not None:+ return tuned- return (- 128,- 128,- 1,- 1,- default_ab_stages,- default_prefetch_dist,- default_num_c_stage,- default_occupancy,- default_buffer_align_bytes,- default_cache_a,- default_cache_b,- default_unroll,- )+ # Fallback heuristic (non-benchmark shapes).+ mma_m = 256 if (m % 256 == 0) else 128+ mma_n = 128 if (n % 128 == 0 and n >= 3072) else 64+ cluster_m = 2 if mma_m == 256 else 1+ cluster_n = 1+ ab_stages = 0+ prefetch_dist = -1+ return (mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist)def custom_kernel(data: input_t) -> output_t:⋯ 5 unchanged linesl = c.shape[2]k = a.shape[1] * 2- (- mma_m,- mma_n,- cluster_m,- cluster_n,- ab_stages,- prefetch_dist,- num_c_stage,- occupancy,- buffer_align_bytes,- cache_policy_a,- cache_policy_b,- mainloop_unroll,- ) = _select_config(m, n, k)- compiled = _compile_for_config(- mma_m,- mma_n,- cluster_m,- cluster_n,- ab_stages=ab_stages,- prefetch_dist=prefetch_dist,- num_c_stage=num_c_stage,- occupancy=occupancy,- buffer_align_bytes=buffer_align_bytes,- cache_policy_a=cache_policy_a,- cache_policy_b=cache_policy_b,- mainloop_unroll=mainloop_unroll,- )+ mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist = _select_config(m, n, k)+ compiled = _compile_for_config(mma_m, mma_n, cluster_m, cluster_n, ab_stages, prefetch_dist)- a_ptr = make_ptr(AB_DTYPE, a.data_ptr(), cute.AddressSpace.gmem, assumed_align=32)- b1_ptr = make_ptr(AB_DTYPE, b1.data_ptr(), cute.AddressSpace.gmem, assumed_align=32)- b2_ptr = make_ptr(AB_DTYPE, b2.data_ptr(), cute.AddressSpace.gmem, assumed_align=32)+ a_ptr = make_ptr(AB_DTYPE, a.data_ptr(), cute.AddressSpace.gmem, assumed_align=16)+ b1_ptr = make_ptr(AB_DTYPE, b1.data_ptr(), cute.AddressSpace.gmem, assumed_align=16)+ b2_ptr = make_ptr(AB_DTYPE, b2.data_ptr(), cute.AddressSpace.gmem, assumed_align=16)c_ptr = make_ptr(C_DTYPE, c.data_ptr(), cute.AddressSpace.gmem, assumed_align=16)sfa_ptr = make_ptr(SF_DTYPE, sfa_permuted.data_ptr(), cute.AddressSpace.gmem, assumed_align=32)
scrolls · 831 diff lines total
Best evidence level for this revision: reported
JSON