submission 401255
leymore4172 · python · License unknown
Use it
Vendorable · source mirrored · license unknownView source →
No package. Vendor the mirrored source: 985 lines, June 9 Researcher Reciprocity License v1.0.
submission.py
curl "https://kernelindex.com/api/v1/implementations/kernelbot-nvfp4-group-gemm-401255?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:82736d63dc633428da15ff668dc6a1903c3a710b9ef4e7679f45e3dd75e867e3
license declaredunknown
license concludedunknown
authorsleymore4172
imported2026-08-15
Techniques
Extracted from the mirrored source by pattern, never inferred. Each row cites its line.
fp4
Warp-specialized GPU kernel for NVFP4 Group GEMM.fused-epilogue
- Epilogue warps (0-3): Consumer of accumulator, store to global memorymbarrier
tmem_alloc_barrier = pipeline.NamedBarrier(shared-memory
a_smem_layout_staged: cute.ComposedLayout,tcgen05
acc_tmem_ptr + tcgen05.find_tmem_tensor_col_offset(tCtAcc),warp-specialization
- TMA warp (5): Producer for TMA loadsKernel source
submission.py985 lines
import cutlass
import cutlass.cute as cute
import cutlass.utils as utils
import cutlass.pipeline as pipeline
from cutlass.cute.nvgpu import cpasync, tcgen05
import cutlass.utils.blackwell_helpers as sm100_utils
import cutlass.utils.blockscaled_layout as blockscaled_utils
from cutlass.cute.runtime import make_ptr
import functools
from typing import Tuple, List
import torch
from task import input_t, output_t
# Kernel configuration parameters
bytes_per_tensormap = 128
num_tensormaps = 4
mma_tiler_mnk = (128, 128, 256)
mma_inst_shape_k = 64
ab_dtype = cutlass.Float4E2M1FN
sf_dtype = cutlass.Float8E4M3FN
c_dtype = cutlass.Float16
sf_vec_size = 16
num_acc_stage = 1
num_ab_stage = 4
num_tmem_alloc_cols = 512
# Warp specialization configuration (6 warps total = 192 threads)
EPILOG_WARP_IDS = (0, 1, 2, 3)
MMA_WARP_ID = 4
TMA_WARP_ID = 5
THREADS_PER_CTA = 192 # 6 warps * 32 threads
def ceil_div(a, b):
return (a + b - 1) // b
@cute.kernel
def kernel(
tiled_mma: cute.TiledMma,
tma_atom_a: cute.CopyAtom,
mA_mkl: cute.Tensor,
tma_atom_b: cute.CopyAtom,
mB_nkl: cute.Tensor,
tma_atom_sfa: cute.CopyAtom,
mSFA_mkl: cute.Tensor,
tma_atom_sfb: cute.CopyAtom,
mSFB_nkl: cute.Tensor,
tensor_of_abc_ptrs: cute.Tensor,
tensor_of_sfasfb_ptrs: cute.Tensor,
tensormaps: cute.Tensor,
tensor_of_problem_sizes: cute.Tensor,
a_smem_layout_staged: cute.ComposedLayout,
b_smem_layout_staged: cute.ComposedLayout,
sfa_smem_layout_staged: cute.Layout,
sfb_smem_layout_staged: cute.Layout,
cta_mn_list: List[Tuple[int, int]],
num_tma_load_bytes: cutlass.Constexpr[int],
):
"""
Warp-specialized GPU kernel for NVFP4 Group GEMM.
- TMA warp (5): Producer for TMA loads
- MMA warp (4): Consumer of AB data, producer of accumulator
- Epilogue warps (0-3): Consumer of accumulator, store to global memory
"""
warp_idx = cute.arch.warp_idx()
warp_idx = cute.arch.make_warp_uniform(warp_idx)
tidx, _, _ = cute.arch.thread_idx()
# Named barriers for synchronization
# tmem_alloc_barrier: 160 threads (warps 0-4, excludes TMA warp)
tmem_alloc_barrier = pipeline.NamedBarrier(
barrier_id=1,
num_threads=32 * 5, # MMA + epilogue warps = 160 threads
)
# tensormap_ab_init_barrier: 64 threads (MMA + TMA warps)
tensormap_ab_init_barrier = pipeline.NamedBarrier(
barrier_id=2,
num_threads=64, # MMA + TMA = 2 warps
)
#
# Delinearize bidz to coord_x, coord_y and group_idx for each CTA
#
bidx, bidy, bidz = cute.arch.block_idx()
group_idx = 0
find = False
coord_x = 0
coord_y = 0
cta_rest = bidz
for _, (cta_m, cta_n) in enumerate(cta_mn_list):
if cta_rest >= (cta_m * cta_n):
group_idx += 1
cta_rest -= cta_m * cta_n
else:
if not find:
coord_y = cta_rest // cta_m
coord_x = cta_rest % cta_m
cta_rest -= cta_m * cta_n
find = True
#
# Construct C Tensor for each CTA
#
mC_mnl_iter = cute.make_ptr(
c_dtype, tensor_of_abc_ptrs[group_idx, 2], cute.AddressSpace.gmem
).align(32)
m = tensor_of_problem_sizes[group_idx, 0]
n = tensor_of_problem_sizes[group_idx, 1]
k = tensor_of_problem_sizes[group_idx, 2]
l = tensor_of_problem_sizes[group_idx, 3]
mC_mnl_layout = cute.make_layout(
(m, n, l),
stride=(cute.assume(n, 32), 1, cute.assume(m * n, 32),))
mC_mnl = cute.make_tensor(mC_mnl_iter, mC_mnl_layout)
gC_mnl = cute.local_tile(
mC_mnl, cute.slice_(mma_tiler_mnk, (None, None, 0)), (coord_x, coord_y, 0)
)
#
# Define shared storage for kernel
#
size_tensormap_in_i64 = num_tensormaps * bytes_per_tensormap // 8
@cute.struct
class SharedStorage:
tensormap_buffer: cute.struct.MemRange[cutlass.Int64, size_tensormap_in_i64]
ab_mbar_ptr: cute.struct.MemRange[cutlass.Int64, num_ab_stage * 2]
acc_mbar_ptr: cute.struct.MemRange[cutlass.Int64, num_acc_stage * 2]
tmem_holding_buf: cutlass.Int32
smem = utils.SmemAllocator()
storage = smem.allocate(SharedStorage)
tensormap_smem_ptr = storage.tensormap_buffer.data_ptr()
tensormap_a_smem_ptr = tensormap_smem_ptr
tensormap_b_smem_ptr = tensormap_a_smem_ptr + bytes_per_tensormap // 8
tensormap_sfa_smem_ptr = tensormap_b_smem_ptr + bytes_per_tensormap // 8
tensormap_sfb_smem_ptr = tensormap_sfa_smem_ptr + bytes_per_tensormap // 8
tmem_holding_buf = storage.tmem_holding_buf
# Setup smem tensors for A, B, SFA, SFB
sA = smem.allocate_tensor(
element_type=ab_dtype,
layout=a_smem_layout_staged.outer,
byte_alignment=128,
swizzle=a_smem_layout_staged.inner,
)
sB = smem.allocate_tensor(
element_type=ab_dtype,
layout=b_smem_layout_staged.outer,
byte_alignment=128,
swizzle=b_smem_layout_staged.inner,
)
sSFA = smem.allocate_tensor(
element_type=sf_dtype,
layout=sfa_smem_layout_staged,
byte_alignment=128,
)
sSFB = smem.allocate_tensor(
element_type=sf_dtype,
layout=sfb_smem_layout_staged,
byte_alignment=128,
)
# Initialize pipelines
# AB pipeline: TMA warp is producer, MMA warp is consumer
ab_pipeline = pipeline.PipelineTmaUmma.create(
barrier_storage=storage.ab_mbar_ptr.data_ptr(),
num_stages=num_ab_stage,
producer_group=pipeline.CooperativeGroup(pipeline.Agent.Thread),
consumer_group=pipeline.CooperativeGroup(pipeline.Agent.Thread, 1),
tx_count=num_tma_load_bytes,
)
# ACC pipeline: MMA warp is producer, epilogue warps are consumers
acc_pipeline = pipeline.PipelineUmmaAsync.create(
barrier_storage=storage.acc_mbar_ptr.data_ptr(),
num_stages=num_acc_stage,
producer_group=pipeline.CooperativeGroup(pipeline.Agent.Thread),
consumer_group=pipeline.CooperativeGroup(pipeline.Agent.Thread, 32 * len(EPILOG_WARP_IDS)),
)
#
# Local_tile partition global tensors
#
gA_mkl = cute.local_tile(
mA_mkl, cute.slice_(mma_tiler_mnk, (None, 0, None)), (None, None, None)
)
gB_nkl = cute.local_tile(
mB_nkl, cute.slice_(mma_tiler_mnk, (0, None, None)), (None, None, None)
)
gSFA_mkl = cute.local_tile(
mSFA_mkl, cute.slice_(mma_tiler_mnk, (None, 0, None)), (None, None, None)
)
gSFB_nkl = cute.local_tile(
mSFB_nkl, cute.slice_(mma_tiler_mnk, (0, None, None)), (None, None, None)
)
#
# Partition global tensor for TiledMMA_A/B/C
#
thr_mma = tiled_mma.get_slice(tidx)
tCgA = thr_mma.partition_A(gA_mkl)
tCgB = thr_mma.partition_B(gB_nkl)
tCgSFA = thr_mma.partition_A(gSFA_mkl)
tCgSFB = thr_mma.partition_B(gSFB_nkl)
tCgC = thr_mma.partition_C(gC_mnl)
# Update tma descriptor with the correct shapes and strides
tensormap_manager = utils.TensorMapManager(
utils.TensorMapUpdateMode.SMEM,
128,
)
tensormap_a_gmem_ptr = tensormap_manager.get_tensormap_ptr(
tensormaps[(bidz, 0, None)].iterator
)
tensormap_b_gmem_ptr = tensormap_manager.get_tensormap_ptr(
tensormaps[(bidz, 1, None)].iterator
)
tensormap_sfa_gmem_ptr = tensormap_manager.get_tensormap_ptr(
tensormaps[(bidz, 2, None)].iterator
)
tensormap_sfb_gmem_ptr = tensormap_manager.get_tensormap_ptr(
tensormaps[(bidz, 3, None)].iterator
)
mA_mkl_iter = cute.make_ptr(
ab_dtype, tensor_of_abc_ptrs[group_idx, 0], cute.AddressSpace.gmem
).align(32)
mB_nkl_iter = cute.make_ptr(
ab_dtype, tensor_of_abc_ptrs[group_idx, 1], cute.AddressSpace.gmem
).align(32)
sfa_mkl_iter = cute.make_ptr(
sf_dtype, tensor_of_sfasfb_ptrs[group_idx, 0], cute.AddressSpace.gmem
).align(32)
sfb_nkl_iter = cute.make_ptr(
sf_dtype, tensor_of_sfasfb_ptrs[group_idx, 1], cute.AddressSpace.gmem
).align(32)
mA_mkl_layout = cute.make_layout(
(m, k, l), stride=(cute.assume(k, 32), 1, cute.assume(m * k, 32),))
mB_nkl_layout = cute.make_layout(
(n, k, l), stride=(cute.assume(k, 32), 1, cute.assume(n * k, 32),))
# SFA, SFB layout
atom_shape = ((32, 4), (sf_vec_size, 4))
atom_stride = ((16, 4), (0, 1))
sfa_layout = cute.tile_to_shape(
cute.make_layout(atom_shape, stride=atom_stride),
mA_mkl_layout.shape,
(2, 1, 3),
)
sfb_layout = cute.tile_to_shape(
cute.make_layout(atom_shape, stride=atom_stride),
mB_nkl_layout.shape,
(2, 1, 3),
)
real_tensor_a = cute.make_tensor(mA_mkl_iter, mA_mkl_layout)
real_tensor_b = cute.make_tensor(mB_nkl_iter, mB_nkl_layout)
real_tensor_sfa = cute.make_tensor(sfa_mkl_iter, sfa_layout)
real_tensor_sfb = cute.make_tensor(sfb_nkl_iter, sfb_layout)
#
# TMA Partition for A/B/SFA/SFB
#
tAsA, tAgA = cpasync.tma_partition(
tma_atom_a,
0,
cute.make_layout(1),
cute.group_modes(sA, 0, 3),
cute.group_modes(tCgA, 0, 3),
)
tBsB, tBgB = cpasync.tma_partition(
tma_atom_b,
0,
cute.make_layout(1),
cute.group_modes(sB, 0, 3),
cute.group_modes(tCgB, 0, 3),
)
tAsSFA, tAgSFA = cpasync.tma_partition(
tma_atom_sfa,
0,
cute.make_layout(1),
cute.group_modes(sSFA, 0, 3),
cute.group_modes(tCgSFA, 0, 3),
)
tAsSFA = cute.filter_zeros(tAsSFA)
tAgSFA = cute.filter_zeros(tAgSFA)
tBsSFB, tBgSFB = cpasync.tma_partition(
tma_atom_sfb,
0,
cute.make_layout(1),
cute.group_modes(sSFB, 0, 3),
cute.group_modes(tCgSFB, 0, 3),
)
tBsSFB = cute.filter_zeros(tBsSFB)
tBgSFB = cute.filter_zeros(tBgSFB)
#
# Partition shared/tensor memory tensor for TiledMMA_A/B/C
#
tCrA = tiled_mma.make_fragment_A(sA)
tCrB = tiled_mma.make_fragment_B(sB)
acc_shape = tiled_mma.partition_shape_C(mma_tiler_mnk[:2])
tCtAcc_fake = tiled_mma.make_fragment_C(acc_shape)
# Number of K loops
k_tile_cnt = cute.ceil_div(real_tensor_a.shape[1], mma_tiler_mnk[2])
#
# Slice to per mma tile index
#
mma_tile_coord_mnl = (coord_x, coord_y, 0)
tAgA = tAgA[(None, mma_tile_coord_mnl[0], None, mma_tile_coord_mnl[2])]
tBgB = tBgB[(None, mma_tile_coord_mnl[1], None, mma_tile_coord_mnl[2])]
tAgSFA = tAgSFA[(None, mma_tile_coord_mnl[0], None, mma_tile_coord_mnl[2])]
tBgSFB = tBgSFB[(None, mma_tile_coord_mnl[1], None, mma_tile_coord_mnl[2])]
#
# ==================== TMA WARP (PRODUCER) ====================
#
# Get raw mbarrier pointers from pipeline's sync objects
ab_full_mbar_ptr = ab_pipeline.sync_object_full.mbarrier_base
ab_empty_mbar_ptr = ab_pipeline.sync_object_empty.mbarrier_base
acc_full_mbar_ptr = acc_pipeline.sync_object_full.mbarrier_base
acc_empty_mbar_ptr = acc_pipeline.sync_object_empty.mbarrier_base
if warp_idx == TMA_WARP_ID:
# Wait for MMA warp to initialize tensormaps
tensormap_ab_init_barrier.arrive_and_wait()
# Raw mbarrier state tracking
tma_wr_k_tile = cutlass.Int32(0)
smem_wr_buffer = tma_wr_k_tile % num_ab_stage
tma_wr_phase = tma_wr_k_tile // num_ab_stage % 2
# Peek (try_wait) AB buffer empty for first iteration
peek_ab_empty_status = cute.arch.mbarrier_conditional_try_wait(
tma_wr_k_tile < k_tile_cnt,
ab_empty_mbar_ptr + smem_wr_buffer,
tma_wr_phase ^ 1, # empty phase is inverted
)
for k_tile in cutlass.range(0, k_tile_cnt, 1, unroll=1):
# Calculate next iteration values
tma_wr_k_tile_next = tma_wr_k_tile + 1
smem_wr_buffer_next = tma_wr_k_tile_next % num_ab_stage
tma_wr_phase_next = tma_wr_k_tile_next // num_ab_stage % 2
# Wait for AB buffer empty (conditionally)
if peek_ab_empty_status == 0:
cute.arch.mbarrier_wait(
ab_empty_mbar_ptr + smem_wr_buffer, tma_wr_phase ^ 1
)
# Arrive and expect tx bytes on full barrier
with cute.arch.elect_one():
cute.arch.mbarrier_arrive_and_expect_tx(
ab_full_mbar_ptr + smem_wr_buffer, num_tma_load_bytes
)
# TMA load A/B/SFA/SFB to shared memory
cute.copy(
tma_atom_a,
tAgA[(None, tma_wr_k_tile)],
tAsA[(None, smem_wr_buffer)],
tma_bar_ptr=ab_full_mbar_ptr + smem_wr_buffer,
tma_desc_ptr=tensormap_manager.get_tensormap_ptr(
tensormap_a_gmem_ptr,
cute.AddressSpace.generic,
),
)
cute.copy(
tma_atom_b,
tBgB[(None, tma_wr_k_tile)],
tBsB[(None, smem_wr_buffer)],
tma_bar_ptr=ab_full_mbar_ptr + smem_wr_buffer,
tma_desc_ptr=tensormap_manager.get_tensormap_ptr(
tensormap_b_gmem_ptr,
cute.AddressSpace.generic,
),
)
cute.copy(
tma_atom_sfa,
tAgSFA[(None, tma_wr_k_tile)],
tAsSFA[(None, smem_wr_buffer)],
tma_bar_ptr=ab_full_mbar_ptr + smem_wr_buffer,
tma_desc_ptr=tensormap_manager.get_tensormap_ptr(
tensormap_sfa_gmem_ptr,
cute.AddressSpace.generic,
),
)
cute.copy(
tma_atom_sfb,
tBgSFB[(None, tma_wr_k_tile)],
tBsSFB[(None, smem_wr_buffer)],
tma_bar_ptr=ab_full_mbar_ptr + smem_wr_buffer,
tma_desc_ptr=tensormap_manager.get_tensormap_ptr(
tensormap_sfb_gmem_ptr,
cute.AddressSpace.generic,
),
)
# Peek (try_wait) AB buffer empty for next iteration
peek_ab_empty_status = cute.arch.mbarrier_conditional_try_wait(
tma_wr_k_tile_next < k_tile_cnt,
ab_empty_mbar_ptr + smem_wr_buffer_next,
tma_wr_phase_next ^ 1,
)
tma_wr_k_tile = tma_wr_k_tile_next
smem_wr_buffer = smem_wr_buffer_next
tma_wr_phase = tma_wr_phase_next
# TMA warp done - no explicit tail needed
#
# ==================== MMA WARP (CONSUMER/PRODUCER) ====================
#
if warp_idx == MMA_WARP_ID:
# Initialize tensormaps for A, B, SFA and SFB
tensormap_manager.init_tensormap_from_atom(
tma_atom_a, tensormap_a_smem_ptr, MMA_WARP_ID
)
tensormap_manager.init_tensormap_from_atom(
tma_atom_b, tensormap_b_smem_ptr, MMA_WARP_ID
)
tensormap_manager.init_tensormap_from_atom(
tma_atom_sfa, tensormap_sfa_smem_ptr, MMA_WARP_ID
)
tensormap_manager.init_tensormap_from_atom(
tma_atom_sfb, tensormap_sfb_smem_ptr, MMA_WARP_ID
)
# Update tensormaps with actual tensor information
tensormap_manager.update_tensormap(
(real_tensor_a, real_tensor_b, real_tensor_sfa, real_tensor_sfb),
(tma_atom_a, tma_atom_b, tma_atom_sfa, tma_atom_sfb),
(tensormap_a_gmem_ptr, tensormap_b_gmem_ptr,
tensormap_sfa_gmem_ptr, tensormap_sfb_gmem_ptr),
MMA_WARP_ID,
(tensormap_a_smem_ptr, tensormap_b_smem_ptr,
tensormap_sfa_smem_ptr, tensormap_sfb_smem_ptr),
)
tensormap_manager.fence_tensormap_update(tensormap_a_gmem_ptr)
tensormap_manager.fence_tensormap_update(tensormap_b_gmem_ptr)
tensormap_manager.fence_tensormap_update(tensormap_sfa_gmem_ptr)
tensormap_manager.fence_tensormap_update(tensormap_sfb_gmem_ptr)
# Prefetch TMA descriptors
cpasync.prefetch_descriptor(tma_atom_a)
cpasync.prefetch_descriptor(tma_atom_b)
cpasync.prefetch_descriptor(tma_atom_sfa)
cpasync.prefetch_descriptor(tma_atom_sfb)
# Signal TMA warp that tensormaps are ready
tensormap_ab_init_barrier.arrive_and_wait()
# Sync for TMEM allocation
tmem_alloc_barrier.arrive_and_wait()
# Retrieve TMEM pointer
acc_tmem_ptr = cute.arch.retrieve_tmem_ptr(
cutlass.Float32,
alignment=16,
ptr_to_buffer_holding_addr=tmem_holding_buf,
)
tCtAcc = cute.make_tensor(acc_tmem_ptr, tCtAcc_fake.layout)
# Make SFA/SFB tmem tensors
sfa_tmem_ptr = cute.recast_ptr(
acc_tmem_ptr + tcgen05.find_tmem_tensor_col_offset(tCtAcc),
dtype=sf_dtype,
)
tCtSFA_layout = blockscaled_utils.make_tmem_layout_sfa(
tiled_mma,
mma_tiler_mnk,
sf_vec_size,
cute.slice_(sfa_smem_layout_staged, (None, None, None, 0)),
)
tCtSFA = cute.make_tensor(sfa_tmem_ptr, tCtSFA_layout)
sfb_tmem_ptr = cute.recast_ptr(
acc_tmem_ptr
+ tcgen05.find_tmem_tensor_col_offset(tCtAcc)
+ tcgen05.find_tmem_tensor_col_offset(tCtSFA),
dtype=sf_dtype,
)
tCtSFB_layout = blockscaled_utils.make_tmem_layout_sfb(
tiled_mma,
mma_tiler_mnk,
sf_vec_size,
cute.slice_(sfb_smem_layout_staged, (None, None, None, 0)),
)
tCtSFB = cute.make_tensor(sfb_tmem_ptr, tCtSFB_layout)
# S2T copy setup for SFA/SFB
copy_atom_s2t = cute.make_copy_atom(
tcgen05.Cp4x32x128bOp(tcgen05.CtaGroup.ONE),
sf_dtype,
)
tCsSFA_compact = cute.filter_zeros(sSFA)
tCtSFA_compact = cute.filter_zeros(tCtSFA)
tiled_copy_s2t_sfa = tcgen05.make_s2t_copy(copy_atom_s2t, tCtSFA_compact)
thr_copy_s2t_sfa = tiled_copy_s2t_sfa.get_slice(0)
tCsSFA_compact_s2t_ = thr_copy_s2t_sfa.partition_S(tCsSFA_compact)
tCsSFA_compact_s2t = tcgen05.get_s2t_smem_desc_tensor(
tiled_copy_s2t_sfa, tCsSFA_compact_s2t_
)
tCtSFA_compact_s2t = thr_copy_s2t_sfa.partition_D(tCtSFA_compact)
tCsSFB_compact = cute.filter_zeros(sSFB)
tCtSFB_compact = cute.filter_zeros(tCtSFB)
tiled_copy_s2t_sfb = tcgen05.make_s2t_copy(copy_atom_s2t, tCtSFB_compact)
thr_copy_s2t_sfb = tiled_copy_s2t_sfb.get_slice(0)
tCsSFB_compact_s2t_ = thr_copy_s2t_sfb.partition_S(tCsSFB_compact)
tCsSFB_compact_s2t = tcgen05.get_s2t_smem_desc_tensor(
tiled_copy_s2t_sfb, tCsSFB_compact_s2t_
)
tCtSFB_compact_s2t = thr_copy_s2t_sfb.partition_D(tCtSFB_compact)
# ACC state tracking (single stage, so always use index 0)
acc_stage_idx = cutlass.Int32(0)
# Raw mbarrier state tracking for AB consumer
mma_rd_k_tile = cutlass.Int32(0)
smem_rd_buffer = mma_rd_k_tile % num_ab_stage
mma_rd_phase = mma_rd_k_tile // num_ab_stage % 2
# Peek (try_wait) AB buffer full for first iteration
peek_ab_full_status = cute.arch.mbarrier_conditional_try_wait(
mma_rd_k_tile < k_tile_cnt,
ab_full_mbar_ptr + smem_rd_buffer,
mma_rd_phase, # full phase (no inversion)
)
# Wait for accumulator buffer empty using raw mbarrier
# Phase 0 ^ 1 = 1 for producer waiting on empty (consumer signals)
cute.arch.mbarrier_wait(acc_empty_mbar_ptr + acc_stage_idx, cutlass.Int32(1))
# Set ACCUMULATE field to False for the first k_tile iteration
tiled_mma.set(tcgen05.Field.ACCUMULATE, False)
# MMA mainloop
for k_tile in range(k_tile_cnt):
# Calculate next iteration values
mma_rd_k_tile_next = cutlass.Int32(k_tile + 1)
smem_rd_buffer_next = mma_rd_k_tile_next % num_ab_stage
mma_rd_phase_next = mma_rd_k_tile_next // num_ab_stage % 2
# Conditionally wait for AB buffer full
if peek_ab_full_status == 0:
cute.arch.mbarrier_wait(
ab_full_mbar_ptr + smem_rd_buffer, mma_rd_phase
)
# Copy SFA/SFB from shared memory to TMEM
s2t_stage_coord = (None, None, None, None, smem_rd_buffer)
tCsSFA_compact_s2t_staged = tCsSFA_compact_s2t[s2t_stage_coord]
tCsSFB_compact_s2t_staged = tCsSFB_compact_s2t[s2t_stage_coord]
cute.copy(
tiled_copy_s2t_sfa,
tCsSFA_compact_s2t_staged,
tCtSFA_compact_s2t,
)
cute.copy(
tiled_copy_s2t_sfb,
tCsSFB_compact_s2t_staged,
tCtSFB_compact_s2t,
)
# tCtAcc += tCrA * tCrSFA * tCrB * tCrSFB
num_kblocks = cute.size(tCrA, mode=[2])
for kblock_idx in cutlass.range(num_kblocks, unroll_full=True):
kblock_coord = (None, None, kblock_idx, smem_rd_buffer)
# Set SFA/SFB tensor to tiled_mma
sf_kblock_coord = (None, None, kblock_idx)
tiled_mma.set(tcgen05.Field.SFA, tCtSFA[sf_kblock_coord].iterator)
tiled_mma.set(tcgen05.Field.SFB, tCtSFB[sf_kblock_coord].iterator)
cute.gemm(
tiled_mma,
tCtAcc,
tCrA[kblock_coord],
tCrB[kblock_coord],
tCtAcc,
)
# Enable accumulate on tCtAcc after first kblock
tiled_mma.set(tcgen05.Field.ACCUMULATE, True)
# Release AB buffer for TMA warp using tcgen05.commit (async after MMA)
with cute.arch.elect_one():
tcgen05.commit(ab_empty_mbar_ptr + smem_rd_buffer)
# Peek for next iteration
peek_ab_full_status = cute.arch.mbarrier_conditional_try_wait(
mma_rd_k_tile_next < k_tile_cnt,
ab_full_mbar_ptr + smem_rd_buffer_next,
mma_rd_phase_next,
)
mma_rd_k_tile = mma_rd_k_tile_next
smem_rd_buffer = smem_rd_buffer_next
mma_rd_phase = mma_rd_phase_next
# Commit accumulator for epilogue warps using tcgen05.commit (async after MMA)
with cute.arch.elect_one():
tcgen05.commit(acc_full_mbar_ptr + acc_stage_idx)
#
# ==================== EPILOGUE WARPS (CONSUMER) ====================
#
if warp_idx < MMA_WARP_ID:
# Allocate TMEM (only first epilogue warp does allocation)
if warp_idx == EPILOG_WARP_IDS[0]:
cute.arch.alloc_tmem(
num_tmem_alloc_cols,
tmem_holding_buf,
is_two_cta=False,
)
# Sync for TMEM allocation
tmem_alloc_barrier.arrive_and_wait()
# Retrieve TMEM pointer
acc_tmem_ptr = cute.arch.retrieve_tmem_ptr(
cutlass.Float32,
alignment=16,
ptr_to_buffer_holding_addr=tmem_holding_buf,
)
tCtAcc = cute.make_tensor(acc_tmem_ptr, tCtAcc_fake.layout)
# Partition for epilogue
op = tcgen05.Ld32x32bOp(tcgen05.Repetition.x128, tcgen05.Pack.NONE)
copy_atom_t2r = cute.make_copy_atom(op, cutlass.Float32)
tiled_copy_t2r = tcgen05.make_tmem_copy(copy_atom_t2r, tCtAcc[None, 0, 0])
thr_copy_t2r = tiled_copy_t2r.get_slice(tidx)
tDtAcc = thr_copy_t2r.partition_S(tCtAcc[None, 0, 0])
tDgC = thr_copy_t2r.partition_D(tCgC[None, 0, 0])
tDrAcc = cute.make_rmem_tensor(tDgC.shape, cutlass.Float32)
tDrC = cute.make_rmem_tensor(tDgC.shape, c_dtype)
# Wait for accumulator buffer full using raw mbarrier
# Phase 0 for consumer waiting on full (producer signals)
cute.arch.mbarrier_wait(acc_full_mbar_ptr, cutlass.Int32(0))
# Copy accumulator to register
cute.copy(tiled_copy_t2r, tDtAcc, tDrAcc)
acc_vec = tDrAcc.load()
tDrC.store(acc_vec.to(c_dtype))
# STG Atom for global memory store
simt_atom = cute.make_copy_atom(
cute.nvgpu.CopyUniversalOp(), c_dtype, num_bits_per_copy=16
)
thread_layout = cute.make_layout(
(1, THREADS_PER_CTA), stride=(THREADS_PER_CTA, 1))
value_layout = cute.make_layout((1, 1))
tiled_copy_r2g = cute.make_tiled_copy_tv(
simt_atom, thread_layout, value_layout
)
thr_copy_r2g = tiled_copy_r2g.get_slice(tidx)
cC = cute.make_identity_tensor(gC_mnl.shape)
tDcC = thr_copy_r2g.partition_D(cC)
tDpC = cute.make_rmem_tensor(tDrC.shape, cutlass.Boolean)
residue_m = mC_mnl.shape[0] - cutlass.Int32(coord_x) * mma_tiler_mnk[0]
residue_n = mC_mnl.shape[1] - cutlass.Int32(coord_y) * mma_tiler_mnk[1]
for i in range(cute.size(tDrC.shape)):
tDpC[i] = cute.elem_less(tDcC[i], (residue_n, residue_m))
cute.copy(simt_atom, cute.flatten(tDrC), cute.flatten(tDgC), pred=cute.flatten(tDpC))
# Release accumulator buffer using raw mbarrier
cute.arch.mbarrier_arrive(acc_empty_mbar_ptr)
# Deallocate TMEM
if warp_idx == EPILOG_WARP_IDS[0]:
cute.arch.relinquish_tmem_alloc_permit(is_two_cta=False)
cute.arch.barrier()
if warp_idx == EPILOG_WARP_IDS[0]:
cute.arch.dealloc_tmem(acc_tmem_ptr, num_tmem_alloc_cols, is_two_cta=False)
pass
@cute.jit
def my_kernel(
ptr_of_tensor_of_problem_sizes: cute.Pointer,
ptr_of_tensor_of_abc_ptrs: cute.Pointer,
ptr_of_tensor_of_sfasfb_ptrs: cute.Pointer,
ptr_of_tensor_of_tensormap: cute.Pointer,
total_num_clusters: cutlass.Int32,
problem_sizes: List[Tuple[int, int, int, int]],
num_groups: cutlass.Int32,
):
tensor_of_abc_ptrs = cute.make_tensor(
ptr_of_tensor_of_abc_ptrs, cute.make_layout((num_groups, 3), stride=(3, 1))
)
tensor_of_sfasfb_ptrs = cute.make_tensor(
ptr_of_tensor_of_sfasfb_ptrs, cute.make_layout((num_groups, 2), stride=(2, 1))
)
tensor_of_problem_sizes = cute.make_tensor(
ptr_of_tensor_of_problem_sizes, cute.make_layout((num_groups, 4), stride=(4, 1))
)
tensor_of_tensormap = cute.make_tensor(
ptr_of_tensor_of_tensormap, cute.make_layout((total_num_clusters, 4, 16), stride=(64, 16, 1))
)
# Use fake shape for initial Tma descriptor and atom setup
min_a_shape = (cutlass.Int32(64), cutlass.Int32(64), cutlass.Int32(64), cutlass.Int32(1))
min_b_shape = (cutlass.Int32(64), cutlass.Int32(64), cutlass.Int32(64), cutlass.Int32(1))
initial_a = cute.make_tensor(
cute.make_ptr(ab_dtype, 0, cute.AddressSpace.gmem, assumed_align=16),
cute.make_layout(
(min_a_shape[0], cute.assume(min_a_shape[2], 32), min_a_shape[3]),
stride=(
cute.assume(min_a_shape[2], 32),
1,
cute.assume(min_a_shape[0] * min_a_shape[2], 32),
),
),
)
initial_b = cute.make_tensor(
cute.make_ptr(ab_dtype, 0, cute.AddressSpace.gmem, assumed_align=16),
cute.make_layout(
(min_b_shape[1], cute.assume(min_b_shape[2], 32), min_b_shape[3]),
stride=(
cute.assume(min_b_shape[2], 32),
1,
cute.assume(min_b_shape[1] * min_b_shape[2], 32),
),
),
)
# Setup sfa/sfb tensor
sfa_layout = blockscaled_utils.tile_atom_to_shape_SF(initial_a.shape, sf_vec_size)
sfb_layout = blockscaled_utils.tile_atom_to_shape_SF(initial_b.shape, sf_vec_size)
initial_sfa = cute.make_tensor(
cute.make_ptr(sf_dtype, 0, cute.AddressSpace.gmem, assumed_align=16), sfa_layout)
initial_sfb = cute.make_tensor(
cute.make_ptr(sf_dtype, 0, cute.AddressSpace.gmem, assumed_align=16), sfb_layout)
# Select MMA operation
mma_op = tcgen05.MmaMXF4NVF4Op(
sf_dtype,
(mma_tiler_mnk[0], mma_tiler_mnk[1], mma_inst_shape_k),
tcgen05.CtaGroup.ONE,
tcgen05.OperandSource.SMEM,
)
tiled_mma = cute.make_tiled_mma(mma_op)
cluster_layout_vmnk = cute.tiled_divide(
cute.make_layout((1, 1, 1)),
(tiled_mma.thr_id.shape,),
)
# Compute A/B/SFA/SFB/C shared memory layout
a_smem_layout_staged = sm100_utils.make_smem_layout_a(
tiled_mma, mma_tiler_mnk, ab_dtype, num_ab_stage,
)
b_smem_layout_staged = sm100_utils.make_smem_layout_b(
tiled_mma, mma_tiler_mnk, ab_dtype, num_ab_stage,
)
sfa_smem_layout_staged = blockscaled_utils.make_smem_layout_sfa(
tiled_mma, mma_tiler_mnk, sf_vec_size, num_ab_stage,
)
sfb_smem_layout_staged = blockscaled_utils.make_smem_layout_sfb(
tiled_mma, mma_tiler_mnk, sf_vec_size, num_ab_stage,
)
atom_thr_size = cute.size(tiled_mma.thr_id.shape)
# Setup TMA for A
a_smem_layout = cute.slice_(a_smem_layout_staged, (None, None, None, 0))
tma_atom_a, tma_tensor_a = cute.nvgpu.make_tiled_tma_atom_A(
cpasync.CopyBulkTensorTileG2SOp(tcgen05.CtaGroup.ONE),
initial_a,
a_smem_layout,
mma_tiler_mnk,
tiled_mma,
cluster_layout_vmnk.shape,
)
# Setup TMA for B
b_smem_layout = cute.slice_(b_smem_layout_staged, (None, None, None, 0))
tma_atom_b, tma_tensor_b = cute.nvgpu.make_tiled_tma_atom_B(
cpasync.CopyBulkTensorTileG2SOp(tcgen05.CtaGroup.ONE),
initial_b,
b_smem_layout,
mma_tiler_mnk,
tiled_mma,
cluster_layout_vmnk.shape,
)
# Setup TMA for SFA
sfa_smem_layout = cute.slice_(sfa_smem_layout_staged, (None, None, None, 0))
tma_atom_sfa, tma_tensor_sfa = cute.nvgpu.make_tiled_tma_atom_A(
cpasync.CopyBulkTensorTileG2SOp(tcgen05.CtaGroup.ONE),
initial_sfa,
sfa_smem_layout,
mma_tiler_mnk,
tiled_mma,
cluster_layout_vmnk.shape,
internal_type=cutlass.Int16,
)
# Setup TMA for SFB
sfb_smem_layout = cute.slice_(sfb_smem_layout_staged, (None, None, None, 0))
tma_atom_sfb, tma_tensor_sfb = cute.nvgpu.make_tiled_tma_atom_B(
cpasync.CopyBulkTensorTileG2SOp(tcgen05.CtaGroup.ONE),
initial_sfb,
sfb_smem_layout,
mma_tiler_mnk,
tiled_mma,
cluster_layout_vmnk.shape,
internal_type=cutlass.Int16,
)
# Compute TMA load bytes
a_copy_size = cute.size_in_bytes(ab_dtype, a_smem_layout)
b_copy_size = cute.size_in_bytes(ab_dtype, b_smem_layout)
sfa_copy_size = cute.size_in_bytes(sf_dtype, sfa_smem_layout)
sfb_copy_size = cute.size_in_bytes(sf_dtype, sfb_smem_layout)
num_tma_load_bytes = (
a_copy_size + b_copy_size + sfa_copy_size + sfb_copy_size
) * atom_thr_size
# Store CTA shape information for each Group
cta_mn_list = []
for group_idx, (m, n, k, l) in enumerate(problem_sizes):
x, y = cute.ceil_div(problem_sizes[group_idx][:2], mma_tiler_mnk[0:2])
cta_mn_list.append((x, y))
# Compute grid size
grid = (1, 1, total_num_clusters)
# Launch the kernel
kernel(
tiled_mma,
tma_atom_a,
tma_tensor_a,
tma_atom_b,
tma_tensor_b,
tma_atom_sfa,
tma_tensor_sfa,
tma_atom_sfb,
tma_tensor_sfb,
tensor_of_abc_ptrs,
tensor_of_sfasfb_ptrs,
tensor_of_tensormap,
tensor_of_problem_sizes,
a_smem_layout_staged,
b_smem_layout_staged,
sfa_smem_layout_staged,
sfb_smem_layout_staged,
cta_mn_list,
num_tma_load_bytes,
).launch(
grid=grid,
block=[THREADS_PER_CTA, 1, 1],
cluster=(1, 1, 1),
)
return
# Global cache for compiled kernels
_compiled_kernel_cache = {}
def compile_kernel(problem_sizes):
"""Compile the kernel once and cache it using problem_sizes as the key."""
global _compiled_kernel_cache
cache_key = f"{len(problem_sizes)}"
if cache_key in _compiled_kernel_cache:
return _compiled_kernel_cache[cache_key]
cute_ptr_of_tensor_of_problem_sizes = make_ptr(
cutlass.Int32, 0, cute.AddressSpace.gmem, assumed_align=16,
)
cute_ptr_of_tensor_of_abc_ptrs = make_ptr(
cutlass.Int64, 0, cute.AddressSpace.gmem, assumed_align=16,
)
cute_ptr_of_tensor_of_sfasfb_ptrs = make_ptr(
cutlass.Int64, 0, cute.AddressSpace.gmem, assumed_align=16,
)
total_num_clusters = cutlass.Int32(1)
num_groups = cutlass.Int32(len(problem_sizes))
cute_ptr_of_tensor_of_tensormap = make_ptr(
cutlass.Int64, 0, cute.AddressSpace.gmem, assumed_align=16,
)
compiled_func = cute.compile(
my_kernel,
cute_ptr_of_tensor_of_problem_sizes,
cute_ptr_of_tensor_of_abc_ptrs,
cute_ptr_of_tensor_of_sfasfb_ptrs,
cute_ptr_of_tensor_of_tensormap,
total_num_clusters,
problem_sizes,
num_groups
)
_compiled_kernel_cache[cache_key] = compiled_func
return compiled_func
def custom_kernel(data: input_t) -> output_t:
"""Execute the block-scaled group GEMM kernel."""
abc_tensors, _, sfasfb_reordered_tensors, problem_sizes = data
compiled_func = compile_kernel(problem_sizes)
abc_ptrs = []
sfasfb_ptrs = []
for i, ((a, b, c), (sfa_reordered, sfb_reordered), (m, n, k, l)) in enumerate(
zip(abc_tensors, sfasfb_reordered_tensors, problem_sizes)
):
abc_ptrs.append((a.data_ptr(), b.data_ptr(), c.data_ptr()))
sfasfb_ptrs.append((sfa_reordered.data_ptr(), sfb_reordered.data_ptr()))
tensor_of_problem_sizes = torch.tensor(
problem_sizes, dtype=torch.int32, device="cuda"
)
tensor_of_abc_ptrs = torch.tensor(abc_ptrs, dtype=torch.int64, device="cuda")
tensor_of_sfasfb_ptrs = torch.tensor(sfasfb_ptrs, dtype=torch.int64, device="cuda")
cta_tile_shape_mn = [128, mma_tiler_mnk[1]]
cluster_tile_shape_mn = tuple(
x * y for x, y in zip(cta_tile_shape_mn, (1, 1))
)
total_num_clusters = 0
num_groups = len(problem_sizes)
for m, n, _, _ in problem_sizes:
num_clusters_mn = tuple(
(x + y - 1) // y for x, y in zip((m, n), cluster_tile_shape_mn)
)
total_num_clusters += functools.reduce(lambda x, y: x * y, num_clusters_mn)
tensormap_shape = (total_num_clusters, num_tensormaps, bytes_per_tensormap // 8)
tensor_of_tensormap = torch.empty(tensormap_shape, dtype=torch.int64, device="cuda")
cute_ptr_of_tensor_of_abc_ptrs = make_ptr(
cutlass.Int64,
tensor_of_abc_ptrs.data_ptr(),
cute.AddressSpace.gmem,
assumed_align=16,
)
cute_ptr_of_tensor_of_sfasfb_ptrs = make_ptr(
cutlass.Int64,
tensor_of_sfasfb_ptrs.data_ptr(),
cute.AddressSpace.gmem,
assumed_align=16,
)
cute_ptr_of_tensor_of_problem_sizes = make_ptr(
cutlass.Int32,
tensor_of_problem_sizes.data_ptr(),
cute.AddressSpace.gmem,
assumed_align=16,
)
cute_ptr_of_tensor_of_tensormap = make_ptr(
cutlass.Int64,
tensor_of_tensormap.data_ptr(),
cute.AddressSpace.gmem,
assumed_align=16,
)
compiled_func(
cute_ptr_of_tensor_of_problem_sizes,
cute_ptr_of_tensor_of_abc_ptrs,
cute_ptr_of_tensor_of_sfasfb_ptrs,
cute_ptr_of_tensor_of_tensormap,
total_num_clusters,
problem_sizes,
num_groups,
)
res = []
for i in range(num_groups):
res.append(abc_tensors[i][2])
return res
scrolls · 985 lines total
Source code from GPU Mode and the KernelBot dataset · June 9 Researcher Reciprocity License v1.0
Best evidence level for this revision: reported
JSON