Skip to content
KernelIndex
Search⌘K

submission 400223

nataliakokoromyti · python · License unknown

Use it

Vendorable · source mirrored · license unknownView source →

No package. Vendor the mirrored source: 1803 lines, June 9 Researcher Reciprocity License v1.0.

submission.py
curl "https://kernelindex.com/api/v1/implementations/kernelbot-nvfp4-group-gemm-400223?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
NVFP4 group GEMMsuite of 4 cases
NVIDIA B200
79.9µs
#223 of 310
2026-01-25

Reported · How evidence levels are derived →

Source and license

sourceavailable
revision digestsha256:599086ac24b3f12b33e94f50ab2e2dd194da199d3c782bcce5ab83c6e6596d2d
license declaredunknown
license concludedunknown
authorsnataliakokoromyti
imported2026-08-15

Techniques

Extracted from the mirrored source by pattern, never inferred. Each row cites its line.

fp4tiled_mma, # Tiled MMA object defining NVFP4 GEMM compute pattern
fused-epilogueepi_tile = sm100_utils.compute_epilogue_tile_shape(
mbarriertmem_alloc_barrier = pipeline.NamedBarrier(
shared-memorya_smem_layout_staged: cute.ComposedLayout,
tcgen05acc_tmem_ptr + tcgen05.find_tmem_tensor_col_offset(tCtAcc),
warp-specializationab_pipeline_producer_group = pipeline.CooperativeGroup(pipeline.Agent.Thread)

Kernel source

submission.py1803 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.utils.layout import LayoutEnum
from cutlass.cute.runtime import make_ptr

import functools
import os
from typing import Tuple, List

import torch
from task import input_t, output_t

# Kernel configuration parameters
# Size of tma descriptor in bytes
bytes_per_tensormap = 128
# Number of tensormaps: a, b, sfa, sfb
num_tensormaps = 4
# Shape of the K dimension for the MMA instruction
mma_inst_shape_k = 64
# FP4 data type for A and B
ab_dtype = cutlass.Float4E2M1FN
# FP8 data type for scale factors
sf_dtype = cutlass.Float8E4M3FN
# FP16 output type
c_dtype = cutlass.Float16
# Scale factor block size (16 elements share one scale)
sf_vec_size = 16

# Tunable configs: set POPCORN_CFG=0..3 before running to select.
_CONFIGS = [
    # Baseline (reference layout).
    {"mma_tiler_mnk": (128, 128, 256), "threads_per_cta": 128, "num_ab_stage": 1, "num_acc_stage": 1, "num_tmem_alloc_cols": 512},
    # More pipelining, same tile.
    {"mma_tiler_mnk": (128, 128, 256), "threads_per_cta": 128, "num_ab_stage": 2, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
    # Taller M tile, narrower N.
    {"mma_tiler_mnk": (128, 64, 256), "threads_per_cta": 128, "num_ab_stage": 2, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
    # Taller N tile, narrower M.
    {"mma_tiler_mnk": (64, 128, 256), "threads_per_cta": 128, "num_ab_stage": 2, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
    # Larger K tile to reduce K-loop overhead.
    {"mma_tiler_mnk": (128, 64, 512), "threads_per_cta": 128, "num_ab_stage": 2, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
    # More threads per CTA for better occupancy.
    {"mma_tiler_mnk": (128, 64, 256), "threads_per_cta": 256, "num_ab_stage": 2, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
    # Larger K tile to reduce loop overhead on big-K cases.
    {"mma_tiler_mnk": (128, 128, 512), "threads_per_cta": 128, "num_ab_stage": 2, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
    # Deeper AB pipeline with more threads for better overlap.
    {"mma_tiler_mnk": (128, 128, 256), "threads_per_cta": 256, "num_ab_stage": 3, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
    # Larger N tile to reduce CTA count on wide-N cases.
    {"mma_tiler_mnk": (128, 256, 256), "threads_per_cta": 256, "num_ab_stage": 2, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
]
_cfg_idx = int(os.environ.get("POPCORN_CFG", "0"))
if _cfg_idx < 0 or _cfg_idx >= len(_CONFIGS):
    _cfg_idx = 0
_cfg = _CONFIGS[_cfg_idx]
_PER_GROUP_LAUNCH = os.environ.get("POPCORN_GROUP_LAUNCH", "0") == "1"
_USE_SINGLE_KERNEL = os.environ.get("POPCORN_USE_SINGLE_KERNEL", "0") == "1"
_USE_TORCH_SCALED_MM = os.environ.get("POPCORN_USE_TORCH_SCALED_MM", "0") == "1"
_USE_TMA_STORE = os.environ.get("POPCORN_USE_TMA_STORE", "0") == "1"

# Tile sizes for M, N, K dimensions
mma_tiler_mnk = _cfg["mma_tiler_mnk"]
# Number of threads per CUDA thread block
threads_per_cta = _cfg["threads_per_cta"]
# Stage numbers of shared memory and tmem
num_acc_stage = _cfg["num_acc_stage"]
num_ab_stage = _cfg["num_ab_stage"]
# Stage numbers of C shared memory for TMA store
num_c_stage = 1
# Total number of columns in tmem
num_tmem_alloc_cols = _cfg["num_tmem_alloc_cols"]


# Helper function for ceiling division
def ceil_div(a, b):
    return (a + b - 1) // b


# The CuTe reference implementation for NVFP4 block-scaled GEMM
@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,
    tensor_of_group_map: 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,
    num_tma_load_bytes: cutlass.Constexpr[int],
):
    """
    GPU device kernel performing the Group GEMM computation.
    """
    warp_idx = cute.arch.warp_idx()
    warp_idx = cute.arch.make_warp_uniform(warp_idx)
    tidx, _, _ = cute.arch.thread_idx()

    bidx, bidy, bidz = cute.arch.block_idx()
    group_idx = tensor_of_group_map[bidz, 0]
    coord_x = tensor_of_group_map[bidz, 1]
    coord_y = tensor_of_group_map[bidz, 2]

    #
    # 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)
    # Local partition for global C Tensor
    # (bM, bN, RestM, RestN, RestL)
    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
    )
    # Setup smem tensor for A, B, SFA, SFB
    # (MMA, MMA_M, MMA_K, STAGE)
    sA = smem.allocate_tensor(
        element_type=ab_dtype,
        layout=a_smem_layout_staged.outer,
        byte_alignment=128,
        swizzle=a_smem_layout_staged.inner,
    )
    # (MMA, MMA_N, MMA_K, STAGE)
    sB = smem.allocate_tensor(
        element_type=ab_dtype,
        layout=b_smem_layout_staged.outer,
        byte_alignment=128,
        swizzle=b_smem_layout_staged.inner,
    )
    # (MMA, MMA_M, MMA_K, STAGE)
    sSFA = smem.allocate_tensor(
        element_type=sf_dtype,
        layout=sfa_smem_layout_staged,
        byte_alignment=128,
    )
    # (MMA, MMA_N, MMA_K, STAGE)
    sSFB = smem.allocate_tensor(
        element_type=sf_dtype,
        layout=sfb_smem_layout_staged,
        byte_alignment=128,
    )

    # Initialize mainloop ab_pipeline, acc_pipeline and their states
    ab_pipeline_producer_group = pipeline.CooperativeGroup(pipeline.Agent.Thread)
    ab_pipeline_consumer_group = pipeline.CooperativeGroup(pipeline.Agent.Thread, 1)
    ab_producer, ab_consumer = pipeline.PipelineTmaUmma.create(
        barrier_storage=storage.ab_mbar_ptr.data_ptr(),
        num_stages=num_ab_stage,
        producer_group=ab_pipeline_producer_group,
        consumer_group=ab_pipeline_consumer_group,
        tx_count=num_tma_load_bytes,
    ).make_participants()
    acc_producer, acc_consumer = 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,
            threads_per_cta,
        ),
    ).make_participants()

    #
    # Local_tile partition global tensors
    #
    # (bM, bK, RestM, RestK, RestL)
    gA_mkl = cute.local_tile(
        mA_mkl, cute.slice_(mma_tiler_mnk, (None, 0, None)), (None, None, None)
    )
    # (bN, bK, RestN, RestK, RestL)
    gB_nkl = cute.local_tile(
        mB_nkl, cute.slice_(mma_tiler_mnk, (0, None, None)), (None, None, None)
    )
    # (bM, bK, RestM, RestK, RestL)
    gSFA_mkl = cute.local_tile(
        mSFA_mkl, cute.slice_(mma_tiler_mnk, (None, 0, None)), (None, None, None)
    )
    # (bN, bK, RestN, RestK, RestL)
    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)
    # (MMA, MMA_M, MMA_K, RestM, RestK, RestL)
    tCgA = thr_mma.partition_A(gA_mkl)
    # (MMA, MMA_N, MMA_K, RestN, RestK, RestL)
    tCgB = thr_mma.partition_B(gB_nkl)
    # (MMA, MMA_M, MMA_K, RestM, RestK, RestL)
    tCgSFA = thr_mma.partition_A(gSFA_mkl)
    # (MMA, MMA_N, MMA_K, RestN, RestK, RestL)
    tCgSFB = thr_mma.partition_B(gSFB_nkl)
    # (MMA, MMA_M, MMA_N, RestM, RestN, RestL)
    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 follows specialized layout defined in the following link:
    # https://docs.nvidia.com/cuda/cublas/index.html?highlight=fp4#d-block-scaling-factors-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)

    # Let warp 0 initialize tensormap
    if warp_idx == 0:
        tensormap_manager.init_tensormap_from_atom(
            tma_atom_a, tensormap_a_smem_ptr, 0
        )
        tensormap_manager.init_tensormap_from_atom(
            tma_atom_b, tensormap_b_smem_ptr, 0
        )
        tensormap_manager.init_tensormap_from_atom(
            tma_atom_sfa, tensormap_sfa_smem_ptr, 0
        )
        tensormap_manager.init_tensormap_from_atom(
            tma_atom_sfb, tensormap_sfb_smem_ptr, 0
        )
        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,
            ),
            0,
            (
                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)

    cute.arch.barrier()

    #
    # Partition global/shared tensor for TMA load A/B/SFA/SFB
    #
    # TMA Partition_S/D for A
    # ((atom_v, rest_v), STAGE)
    # ((atom_v, rest_v), RestM, RestK, RestL)
    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),
    )
    # TMA Partition_S/D for B
    # ((atom_v, rest_v), STAGE)
    # ((atom_v, rest_v), RestN, RestK, RestL)
    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),
    )
    #  TMA Partition_S/D for SFA
    # ((atom_v, rest_v), STAGE)
    # ((atom_v, rest_v), RestM, RestK, RestL)
    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)
    # TMA Partition_S/D for SFB
    # ((atom_v, rest_v), STAGE)
    # ((atom_v, rest_v), RestN, RestK, RestL)
    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
    #
    # (MMA, MMA_M, MMA_K, STAGE)
    tCrA = tiled_mma.make_fragment_A(sA)
    # (MMA, MMA_N, MMA_K, STAGE)
    tCrB = tiled_mma.make_fragment_B(sB)
    # (MMA, MMA_M, MMA_N)
    acc_shape = tiled_mma.partition_shape_C(mma_tiler_mnk[:2])
    # (MMA, MMA_M, MMA_N)
    tCtAcc_fake = tiled_mma.make_fragment_C(acc_shape)
    #
    # Alloc tensor memory buffer
    #
    tmem_alloc_barrier = pipeline.NamedBarrier(
        barrier_id=1,
        num_threads=threads_per_cta,
    )
    tmem = utils.TmemAllocator(
        storage.tmem_holding_buf,
        barrier_for_retrieve=tmem_alloc_barrier,
    )
    tmem.allocate(num_tmem_alloc_cols)
    tmem.wait_for_alloc()
    acc_tmem_ptr = tmem.retrieve_ptr(cutlass.Float32)
    tCtAcc = cute.make_tensor(acc_tmem_ptr, tCtAcc_fake.layout)

    #
    # Make SFA/SFB tmem tensor
    #
    # Get SFA tmem ptr
    sfa_tmem_ptr = cute.recast_ptr(
        acc_tmem_ptr + tcgen05.find_tmem_tensor_col_offset(tCtAcc),
        dtype=sf_dtype,
    )
    # (MMA, MMA_M, MMA_K)
    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)
    # Get SFB tmem ptr
    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,
    )
    # (MMA, MMA_N, MMA_K)
    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)

    #
    # Partition for S2T copy of SFA/SFB
    #
    # Make S2T CopyAtom
    copy_atom_s2t = cute.make_copy_atom(
        tcgen05.Cp4x32x128bOp(tcgen05.CtaGroup.ONE),
        sf_dtype,
    )
    # (MMA, MMA_MN, MMA_K, STAGE)
    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)
    # ((ATOM_V, REST_V), Rest_Tiler, MMA_MN, MMA_K, STAGE)
    tCsSFA_compact_s2t_ = thr_copy_s2t_sfa.partition_S(tCsSFA_compact)
    # ((ATOM_V, REST_V), Rest_Tiler, MMA_MN, MMA_K, STAGE)
    tCsSFA_compact_s2t = tcgen05.get_s2t_smem_desc_tensor(
        tiled_copy_s2t_sfa, tCsSFA_compact_s2t_
    )
    # ((ATOM_V, REST_V), Rest_Tiler, MMA_MN, MMA_K)
    tCtSFA_compact_s2t = thr_copy_s2t_sfa.partition_D(tCtSFA_compact)

    # (MMA, MMA_MN, MMA_K, STAGE)
    tCsSFB_compact = cute.filter_zeros(sSFB)
    # (MMA, MMA_MN, MMA_K)
    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)
    # ((ATOM_V, REST_V), Rest_Tiler, MMA_MN, MMA_K, STAGE)
    tCsSFB_compact_s2t_ = thr_copy_s2t_sfb.partition_S(tCsSFB_compact)
    # ((ATOM_V, REST_V), Rest_Tiler, MMA_MN, MMA_K, STAGE)
    tCsSFB_compact_s2t = tcgen05.get_s2t_smem_desc_tensor(
        tiled_copy_s2t_sfb, tCsSFB_compact_s2t_
    )
    # ((ATOM_V, REST_V), Rest_Tiler, MMA_MN, MMA_K)
    tCtSFB_compact_s2t = thr_copy_s2t_sfb.partition_D(tCtSFB_compact)

    # 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)
    # ((atom_v, rest_v), RestK)
    tAgA = tAgA[(None, mma_tile_coord_mnl[0], None, mma_tile_coord_mnl[2])]
    # ((atom_v, rest_v), RestK)
    tBgB = tBgB[(None, mma_tile_coord_mnl[1], None, mma_tile_coord_mnl[2])]
    # ((atom_v, rest_v), RestK)
    tAgSFA = tAgSFA[(None, mma_tile_coord_mnl[0], None, mma_tile_coord_mnl[2])]
    # ((atom_v, rest_v), RestK)
    tBgSFB = tBgSFB[(None, mma_tile_coord_mnl[1], None, mma_tile_coord_mnl[2])]

    #
    # Main loop
    #
    if warp_idx == 0:
        # Wait for accumulator buffer empty
        acc_empty = acc_producer.acquire_and_advance()
        # Set ACCUMULATE field to False for the first k_tile iteration
        tiled_mma.set(tcgen05.Field.ACCUMULATE, False)
        # Execute k_tile loop
        for k_tile in range(k_tile_cnt):
            # Wait for AB buffer empty
            ab_empty = ab_producer.acquire_and_advance()

            #  TMA load A/B/SFA/SFB to shared memory
            cute.copy(
                tma_atom_a,
                tAgA[(None, k_tile)],
                tAsA[(None, ab_empty.index)],
                tma_bar_ptr=ab_empty.barrier,
                tma_desc_ptr=tensormap_manager.get_tensormap_ptr(
                    tensormap_a_gmem_ptr,
                    cute.AddressSpace.generic,
                ),
            )
            cute.copy(
                tma_atom_b,
                tBgB[(None, k_tile)],
                tBsB[(None, ab_empty.index)],
                tma_bar_ptr=ab_empty.barrier,
                tma_desc_ptr=tensormap_manager.get_tensormap_ptr(
                    tensormap_b_gmem_ptr,
                    cute.AddressSpace.generic,
                ),
            )
            cute.copy(
                tma_atom_sfa,
                tAgSFA[(None, k_tile)],
                tAsSFA[(None, ab_empty.index)],
                tma_bar_ptr=ab_empty.barrier,
                tma_desc_ptr=tensormap_manager.get_tensormap_ptr(
                    tensormap_sfa_gmem_ptr,
                    cute.AddressSpace.generic,
                ),
            )
            cute.copy(
                tma_atom_sfb,
                tBgSFB[(None, k_tile)],
                tBsSFB[(None, ab_empty.index)],
                tma_bar_ptr=ab_empty.barrier,
                tma_desc_ptr=tensormap_manager.get_tensormap_ptr(
                    tensormap_sfb_gmem_ptr,
                    cute.AddressSpace.generic,
                ),
            )

            # Wait for AB buffer full
            ab_full = ab_consumer.wait_and_advance()

            #  Copy SFA/SFB from shared memory to TMEM
            s2t_stage_coord = (None, None, None, None, ab_full.index)
            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,
                    ab_full.index,
                )

                # 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)

            # Async arrive AB buffer empty
            ab_full.release()
        acc_empty.commit()

    #
    # Epilogue
    # 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)
    # (TmemCpy, NumTmemCpy)
    tDtAcc = thr_copy_t2r.partition_S(tCtAcc[None,0,0])
    # (TmemCpy, NumTmemCpy)
    tDgC = thr_copy_t2r.partition_D(tCgC[None,0,0])

    # (TmemCpy, NumTmemCpy)
    tDrAcc = cute.make_rmem_tensor(tDgC.shape, cutlass.Float32)
    # (TmemCpy, NumTmemCpy)
    tDrC = cute.make_rmem_tensor(tDgC.shape, c_dtype)

    # Release TMEM allocation lock
    tmem.relinquish_alloc_permit()
    # Wait for accumulator buffer full
    acc_full = acc_consumer.wait_and_advance()

    # Copy accumulator to register
    cute.copy(tiled_copy_t2r, tDtAcc, tDrAcc)
    acc_vec = tDrAcc.load()
    tDrC.store(acc_vec.to(c_dtype))

    # STG Atom, just to ensure functionality
    # For performance optimization, better to use Tma store operation to
    # reduce address calculation and predicate calulation instructions
    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)
    # ((atom_v, rest_v), NumGmemCpy)
    tDcC = thr_copy_r2g.partition_D(cC)

    # ((atom_v, rest_v), NumGmemCpy)
    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)):
        # Swap residue_m and residue_n to match the order of tDcC
        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))

    acc_full.release()
    # Deallocate TMEM
    cute.arch.barrier()
    tmem.free(acc_tmem_ptr)
    pass




# Host-side JIT function to prepare tensors and launch GPU kernel.
@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,
    ptr_of_tensor_of_group_map: cute.Pointer,
    total_num_clusters: cutlass.Int32,
    problem_sizes: List[
        Tuple[int, int, int, int]
    ],  # Problem sizes for each group
    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))
    )
    tensor_of_group_map = cute.make_tensor(
        ptr_of_tensor_of_group_map, cute.make_layout((total_num_clusters, 3), stride=(3, 1))
    )

    # Use fake shape for initial Tma descriptor and atom setup
    # The real Tma desc and atom will be updated during kernel execution.
    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 by filling A/B tensor to scale factor atom layout
    # ((Atom_M, Rest_M),(Atom_K, Rest_K),RestL)
    sfa_layout = blockscaled_utils.tile_atom_to_shape_SF(
        initial_a.shape, sf_vec_size
    )
    # ((Atom_N, Rest_N),(Atom_K, Rest_K),RestL)
    sfb_layout = blockscaled_utils.tile_atom_to_shape_SF(
        initial_b.shape, sf_vec_size
    )
    # Create initial SFA and SFB tensors with fake shape and null pointer.
    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

    # Compute grid size
    grid = (1, 1, total_num_clusters)

    # Launch the kernel
    kernel(
        # MMA (Matrix Multiply-Accumulate) configuration
        tiled_mma,                  # Tiled MMA object defining NVFP4 GEMM compute pattern
        
        # TMA (Tensor Memory Accelerator) atoms and tensors for input matrix A
        tma_atom_a,                 # TMA copy atom defining how to load A from global memory
        tma_tensor_a,               # Tensor descriptor for A (created from smallest A tensor)
        
        # TMA atoms and tensors for input matrix B
        tma_atom_b,                 # TMA copy atom defining how to load B from global memory
        tma_tensor_b,               # Tensor descriptor for B (created from smallest B tensor)
        
        # TMA atoms and tensors for scale factor A
        tma_atom_sfa,               # TMA copy atom for loading scale factors for A
        tma_tensor_sfa,             # Tensor descriptor for SFA (block scale factors for A)
        
        # TMA atoms and tensors for scale factor B
        tma_atom_sfb,               # TMA copy atom for loading scale factors for B
        tma_tensor_sfb,             # Tensor descriptor for SFB (block scale factors for B)
        
        # Runtime tensor metadata for dynamic group access
        tensor_of_abc_ptrs,         # Device tensor containing pointers to A, B, C for all groups
        tensor_of_sfasfb_ptrs,      # Device tensor containing pointers to SFA, SFB for all groups
        tensor_of_tensormap,        # Pre-allocated buffer for tensormap descriptors per CTA
        tensor_of_problem_sizes,    # Device tensor containing (m, n, k, l) for each group
        tensor_of_group_map,        # Device tensor mapping CTA idx -> (group_idx, coord_x, coord_y)
        
        # Shared memory layouts with staging for pipelined execution
        a_smem_layout_staged,       # Staged shared memory layout for A (includes stage dimension)
        b_smem_layout_staged,       # Staged shared memory layout for B (includes stage dimension)
        sfa_smem_layout_staged,     # Staged shared memory layout for SFA (includes stage dimension)
        sfb_smem_layout_staged,     # Staged shared memory layout for SFB (includes stage dimension)
        
        # Pipeline synchronization parameter
        num_tma_load_bytes,         # Total bytes to load per TMA transaction (for barrier setup)
    ).launch(
        grid=grid,
        block=[threads_per_cta, 1, 1],
        cluster=(1, 1, 1),
    )

# Single-group kernel (based on nvfp4_gemm) for per-group launches.
@cute.kernel
def kernel_single(
    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,
    tma_atom_c: cute.CopyAtom,
    mC_mnl: 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,
    c_smem_layout_staged: cute.Layout,
    epi_tile: cute.Tile,
    num_tma_load_bytes: cutlass.Constexpr[int],
):
    warp_idx = cute.arch.warp_idx()
    warp_idx = cute.arch.make_warp_uniform(warp_idx)
    tidx, _, _ = cute.arch.thread_idx()

    bidx, bidy, bidz = cute.arch.block_idx()
    cta_coord = (bidx, bidy, bidz)
    mma_tile_coord_mnl = (
        cta_coord[0] // cute.size(tiled_mma.thr_id.shape),
        cta_coord[1],
        cta_coord[2],
    )

    @cute.struct
    class SharedStorage:
        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)
    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,
    )
    if cutlass.const_expr(_USE_TMA_STORE):
        sC = smem.allocate_tensor(
            element_type=c_dtype,
            layout=c_smem_layout_staged.outer,
            byte_alignment=128,
            swizzle=c_smem_layout_staged.inner,
        )

    ab_pipeline_producer_group = pipeline.CooperativeGroup(pipeline.Agent.Thread)
    ab_pipeline_consumer_group = pipeline.CooperativeGroup(pipeline.Agent.Thread, 1)
    ab_producer, ab_consumer = pipeline.PipelineTmaUmma.create(
        barrier_storage=storage.ab_mbar_ptr.data_ptr(),
        num_stages=num_ab_stage,
        producer_group=ab_pipeline_producer_group,
        consumer_group=ab_pipeline_consumer_group,
        tx_count=num_tma_load_bytes,
    ).make_participants()
    acc_producer, acc_consumer = pipeline.PipelineUmmaAsync.create(
        barrier_storage=storage.acc_mbar_ptr.data_ptr(),
        num_stages=num_acc_stage,
        producer_group=ab_pipeline_producer_group,
        consumer_group=pipeline.CooperativeGroup(
            pipeline.Agent.Thread,
            threads_per_cta,
        ),
    ).make_participants()

    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)
    )
    gC_mnl = cute.local_tile(
        mC_mnl, cute.slice_(mma_tiler_mnk, (None, None, 0)), (None, None, None)
    )
    k_tile_cnt = cute.size(gA_mkl, mode=[3])

    thr_mma = tiled_mma.get_slice(0)
    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)

    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)

    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)

    tmem_alloc_barrier = pipeline.NamedBarrier(
        barrier_id=1,
        num_threads=threads_per_cta,
    )
    tmem = utils.TmemAllocator(
        storage.tmem_holding_buf,
        barrier_for_retrieve=tmem_alloc_barrier,
    )
    tmem.allocate(num_tmem_alloc_cols)
    tmem.wait_for_alloc()
    acc_tmem_ptr = tmem.retrieve_ptr(cutlass.Float32)
    tCtAcc = cute.make_tensor(acc_tmem_ptr, tCtAcc_fake.layout)

    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)

    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)

    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])]

    if warp_idx == 0:
        acc_empty = acc_producer.acquire_and_advance()
        tiled_mma.set(tcgen05.Field.ACCUMULATE, False)
        for k_tile in range(k_tile_cnt):
            ab_empty = ab_producer.acquire_and_advance()
            cute.copy(
                tma_atom_a,
                tAgA[(None, k_tile)],
                tAsA[(None, ab_empty.index)],
                tma_bar_ptr=ab_empty.barrier,
            )
            cute.copy(
                tma_atom_b,
                tBgB[(None, k_tile)],
                tBsB[(None, ab_empty.index)],
                tma_bar_ptr=ab_empty.barrier,
            )
            cute.copy(
                tma_atom_sfa,
                tAgSFA[(None, k_tile)],
                tAsSFA[(None, ab_empty.index)],
                tma_bar_ptr=ab_empty.barrier,
            )
            cute.copy(
                tma_atom_sfb,
                tBgSFB[(None, k_tile)],
                tBsSFB[(None, ab_empty.index)],
                tma_bar_ptr=ab_empty.barrier,
            )

            ab_full = ab_consumer.wait_and_advance()
            s2t_stage_coord = (None, None, None, None, ab_full.index)
            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,
            )

            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_full.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,
                    tCtSFB[sf_kblock_coord].iterator,
                )
                cute.gemm(
                    tiled_mma,
                    tCtAcc,
                    tCrA[kblock_coord],
                    tCrB[kblock_coord],
                    tCtAcc,
                )
                tiled_mma.set(tcgen05.Field.ACCUMULATE, True)
            ab_full.release()
        acc_empty.commit()

    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)
    thr_copy_t2r = tiled_copy_t2r.get_slice(tidx)
    tTR_tAcc = thr_copy_t2r.partition_S(tCtAcc)
    tTR_gC = thr_copy_t2r.partition_D(tCgC)
    tTR_rAcc = cute.make_rmem_tensor(
        tTR_gC[None, None, None, None, 0, 0, 0].shape, cutlass.Float32
    )
    tTR_rC = cute.make_rmem_tensor(
        tTR_gC[None, None, None, None, 0, 0, 0].shape, c_dtype
    )
    simt_atom = cute.make_copy_atom(cute.nvgpu.CopyUniversalOp(), c_dtype)
    tTR_gC = tTR_gC[(None, None, None, None, *mma_tile_coord_mnl)]

    acc_full = acc_consumer.wait_and_advance()
    cute.copy(tiled_copy_t2r, tTR_tAcc, tTR_rAcc)
    acc_vec = tTR_rAcc.load().to(c_dtype)
    tTR_rC.store(acc_vec)
    if cutlass.const_expr(_USE_TMA_STORE):
        tCgC_epi = cute.flat_divide(tCgC, epi_tile)
        bSG_sC, bSG_gC_partitioned = cpasync.tma_partition(
            tma_atom_c,
            0,
            cute.make_layout(1),
            cute.group_modes(sC, 0, 2),
            cute.group_modes(tCgC_epi, 0, 2),
        )
        c_producer_group = pipeline.CooperativeGroup(
            pipeline.Agent.Thread, 32
        )
        c_pipeline = pipeline.PipelineTmaStore.create(
            num_stages=num_c_stage, producer_group=c_producer_group
        )
        cute.copy(simt_atom, tTR_rC, bSG_sC[(None, 0)])
        cute.arch.fence_proxy(
            cute.arch.ProxyKind.async_shared,
            space=cute.arch.SharedSpace.shared_cta,
        )
        if warp_idx == 0:
            bSG_gC = bSG_gC_partitioned[(None, None, None, *mma_tile_coord_mnl)]
            cute.copy(
                tma_atom_c,
                bSG_sC[(None, 0)],
                bSG_gC[(None, 0)],
            )
            c_pipeline.producer_commit()
            c_pipeline.producer_tail()
    else:
        cute.copy(simt_atom, tTR_rC, tTR_gC)
    acc_full.release()

    cute.arch.barrier()
    tmem.free(acc_tmem_ptr)
    return


@cute.jit
def my_kernel_single(
    a_ptr: cute.Pointer,
    b_ptr: cute.Pointer,
    sfa_ptr: cute.Pointer,
    sfb_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)),
        ),
    )
    b_tensor = cute.make_tensor(
        b_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))
    )
    sfa_layout = blockscaled_utils.tile_atom_to_shape_SF(
        a_tensor.shape, sf_vec_size
    )
    sfa_tensor = cute.make_tensor(sfa_ptr, sfa_layout)
    sfb_layout = blockscaled_utils.tile_atom_to_shape_SF(
        b_tensor.shape, sf_vec_size
    )
    sfb_tensor = cute.make_tensor(sfb_ptr, sfb_layout)

    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,),
    )

    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,
    )
    epi_tile = sm100_utils.compute_epilogue_tile_shape(
        mma_tiler_mnk[:2],
        False,
        LayoutEnum.ROW_MAJOR,
        c_dtype,
    )
    c_smem_layout_staged = sm100_utils.make_smem_layout_epi(
        c_dtype,
        LayoutEnum.ROW_MAJOR,
        epi_tile,
        num_c_stage,
    )

    atom_thr_size = cute.size(tiled_mma.thr_id.shape)

    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),
        a_tensor,
        a_smem_layout,
        mma_tiler_mnk,
        tiled_mma,
        cluster_layout_vmnk.shape,
    )
    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),
        b_tensor,
        b_smem_layout,
        mma_tiler_mnk,
        tiled_mma,
        cluster_layout_vmnk.shape,
    )
    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),
        sfa_tensor,
        sfa_smem_layout,
        mma_tiler_mnk,
        tiled_mma,
        cluster_layout_vmnk.shape,
        internal_type=cutlass.Int16,
    )
    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),
        sfb_tensor,
        sfb_smem_layout,
        mma_tiler_mnk,
        tiled_mma,
        cluster_layout_vmnk.shape,
        internal_type=cutlass.Int16,
    )

    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

    grid = (
        cute.ceil_div(c_tensor.shape[0], mma_tiler_mnk[0]),
        cute.ceil_div(c_tensor.shape[1], mma_tiler_mnk[1]),
        c_tensor.shape[2],
    )

    epi_smem_layout = cute.slice_(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,
        epi_tile,
    )

    kernel_single(
        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,
        tma_atom_c,
        c_tensor,
        a_smem_layout_staged,
        b_smem_layout_staged,
        sfa_smem_layout_staged,
        sfb_smem_layout_staged,
        c_smem_layout_staged,
        epi_tile,
        num_tma_load_bytes,
    ).launch(
        grid=grid,
        block=[threads_per_cta, 1, 1],
        cluster=(1, 1, 1),
    )
    return


_compiled_single_kernel_cache = None


def compile_kernel_single():
    global _compiled_single_kernel_cache
    if _compiled_single_kernel_cache is not None:
        return _compiled_single_kernel_cache

    a_ptr = make_ptr(
        ab_dtype, 0, cute.AddressSpace.gmem, assumed_align=16
    )
    b_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
    )
    sfb_ptr = make_ptr(
        sf_dtype, 0, cute.AddressSpace.gmem, assumed_align=32
    )
    _compiled_single_kernel_cache = cute.compile(
        my_kernel_single, a_ptr, b_ptr, sfa_ptr, sfb_ptr, c_ptr, (0, 0, 0, 0)
    )
    return _compiled_single_kernel_cache

# Global cache for compiled kernels (keyed by group size)
# Caches compiled kernels and host-side launch metadata to reduce overhead.
_compiled_kernel_cache = {}
_launch_cache = {}
_ptr_tensor_cache = {}


def _problem_sizes_key(problem_sizes):
    return tuple(tuple(int(v) for v in sizes) for sizes in problem_sizes)


def _device_cache_key(device):
    if device.type == "cuda":
        return ("cuda", device.index if device.index is not None else torch.cuda.current_device())
    return (device.type, None)


def _compute_total_num_clusters(problem_sizes, cluster_tile_shape_mn):
    total_num_clusters = 0
    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)
    return total_num_clusters


class _LaunchCacheEntry:
    def __init__(self, problem_sizes, device):
        self.problem_sizes_key = _problem_sizes_key(problem_sizes)
        self.num_groups = len(problem_sizes)
        self.tensor_of_problem_sizes = torch.tensor(
            problem_sizes, dtype=torch.int32, device=device
        )
        cta_tile_shape_mn = (mma_tiler_mnk[0], mma_tiler_mnk[1])
        cluster_tile_shape_mn = cta_tile_shape_mn
        self.total_num_clusters = _compute_total_num_clusters(
            problem_sizes, cluster_tile_shape_mn
        )
        cta_mn_list = []
        for m, n, _, _ in problem_sizes:
            x = ceil_div(m, cta_tile_shape_mn[0])
            y = ceil_div(n, cta_tile_shape_mn[1])
            cta_mn_list.append((x, y))
        group_map = []
        for group_idx, (cta_m, cta_n) in enumerate(cta_mn_list):
            for coord_y in range(cta_n):
                for coord_x in range(cta_m):
                    group_map.append((group_idx, coord_x, coord_y))
        self.tensor_of_group_map = torch.tensor(
            group_map, dtype=torch.int32, device=device
        )
        tensormap_shape = (
            self.total_num_clusters,
            num_tensormaps,
            bytes_per_tensormap // 8,
        )
        self.tensor_of_tensormap = torch.empty(
            tensormap_shape, dtype=torch.int64, device=device
        )


def _get_launch_cache(problem_sizes, device):
    key = (_device_cache_key(device), _problem_sizes_key(problem_sizes))
    entry = _launch_cache.get(key)
    if entry is None:
        entry = _LaunchCacheEntry(problem_sizes, device)
        _launch_cache[key] = entry
    return entry


def _get_ptr_tensors(abc_ptrs, sfasfb_ptrs, device):
    key = (_device_cache_key(device), tuple(abc_ptrs), tuple(sfasfb_ptrs))
    cached = _ptr_tensor_cache.get(key)
    if cached is not None:
        return cached
    tensor_of_abc_ptrs = torch.tensor(abc_ptrs, dtype=torch.int64, device=device)
    tensor_of_sfasfb_ptrs = torch.tensor(sfasfb_ptrs, dtype=torch.int64, device=device)
    _ptr_tensor_cache[key] = (tensor_of_abc_ptrs, tensor_of_sfasfb_ptrs)
    return tensor_of_abc_ptrs, tensor_of_sfasfb_ptrs
# This function is used to compile the kernel once and cache it and then allow users to 
# run the kernel multiple times to get more accurate timing results.
def compile_kernel(problem_sizes):
    """
    Compile the kernel once and cache it using problem_sizes as the key.
    This should be called before any timing measurements.

    Returns:
        The compiled kernel function
    """
    global _compiled_kernel_cache
    
    # Use full problem sizes as the cache key to avoid mixing incompatible kernels.
    cache_key = _problem_sizes_key(problem_sizes)

    # Check if we already have a compiled kernel for these 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,
    )
    # Fake cluster numbers for compile only.
    total_num_clusters = cutlass.Int32(1)
    num_groups = cutlass.Int32(len(problem_sizes))
    # Each cluster needs its own set of tensormaps (one for A, B, SFA, SFB)
    # Shape: (total_num_clusters, num_tensormaps=4, bytes_per_tensormap/8=16)
    cute_ptr_of_tensor_of_tensormap = make_ptr(
        cutlass.Int64, 0, cute.AddressSpace.gmem, assumed_align=16,
    )
    cute_ptr_of_tensor_of_group_map = make_ptr(
        cutlass.Int32, 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,
        cute_ptr_of_tensor_of_group_map,
        total_num_clusters,
        problem_sizes,
        num_groups
    )
    # Store compiled kernel in cache with problem_sizes as key
    _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.
    
    This is the main entry point called by the evaluation framework.
    It converts PyTorch tensors to CuTe tensors, launches the kernel,
    and returns the result.
    
    Args:
        data: Tuple of (abc_tensors, sfasfb_tensors, problem_sizes) where:
            abc_tensors: list of tuples (a, b, c) where 
                a is torch.Tensor[float4e2m1fn_x2] of shape [m, k // 2, l]
                b is torch.Tensor[float4e2m1fn_x2] of shape [n, k // 2, l]
                c is torch.Tensor[float16] of shape [m, n, l]
            sfasfb_tensors: list of tuples (sfa, sfb) where 
                sfa is torch.Tensor[float8_e4m3fnuz] of shape [m, k // 16, l]
                sfb is torch.Tensor[float8_e4m3fnuz] of shape [n, k // 16, l]
            problem_sizes: list of tuples (m, n, k, l)
            each group has its own a, b, c, sfa, sfb with different m, n, k, l problem sizes
            l should always be 1 for each group.
            list size is the number of groups.
    
    Returns:
        list of c tensors where c is torch.Tensor[float16] of shape [m, n, l] for each group
    """
    abc_tensors, _, sfasfb_reordered_tensors, problem_sizes = data

    device = abc_tensors[0][0].device

    if _USE_TORCH_SCALED_MM:
        res = []
        for (a, b, c), (sfa_reordered, sfb_reordered), (m, n, k, l) in zip(
            abc_tensors, sfasfb_reordered_tensors, problem_sizes
        ):
            for l_idx in range(l):
                scale_a = sfa_reordered[..., l_idx].contiguous().view(-1)
                scale_b = sfb_reordered[..., l_idx].contiguous().view(-1)
                out = torch._scaled_mm(
                    a[:, :, l_idx].view(torch.float4_e2m1fn_x2),
                    b[:, :, l_idx].transpose(0, 1).view(torch.float4_e2m1fn_x2),
                    scale_a,
                    scale_b,
                    bias=None,
                    out_dtype=torch.float16,
                )
                c[:, :, l_idx] = out
            res.append(c)
        return res

    if _PER_GROUP_LAUNCH:
        res = []
        for (a, b, c), (sfa_reordered, sfb_reordered), (m, n, k, l) in zip(
            abc_tensors, sfasfb_reordered_tensors, problem_sizes
        ):
            if _USE_SINGLE_KERNEL:
                compiled_single = compile_kernel_single()
                a_ptr = make_ptr(
                    ab_dtype, a.data_ptr(), cute.AddressSpace.gmem, assumed_align=16
                )
                b_ptr = make_ptr(
                    ab_dtype, b.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_reordered.data_ptr(),
                    cute.AddressSpace.gmem,
                    assumed_align=32,
                )
                sfb_ptr = make_ptr(
                    sf_dtype,
                    sfb_reordered.data_ptr(),
                    cute.AddressSpace.gmem,
                    assumed_align=32,
                )
                compiled_single(a_ptr, b_ptr, sfa_ptr, sfb_ptr, c_ptr, (m, n, k, l))
            else:
                single_problem_sizes = [(m, n, k, l)]
                compiled_func = compile_kernel(single_problem_sizes)
                launch_cache = _get_launch_cache(single_problem_sizes, device)
                tensor_of_problem_sizes = launch_cache.tensor_of_problem_sizes

                tensor_of_abc_ptrs, tensor_of_sfasfb_ptrs = _get_ptr_tensors(
                    [(a.data_ptr(), b.data_ptr(), c.data_ptr())],
                    [(sfa_reordered.data_ptr(), sfb_reordered.data_ptr())],
                    device,
                )

                total_num_clusters = launch_cache.total_num_clusters
                num_groups = launch_cache.num_groups
                tensor_of_tensormap = launch_cache.tensor_of_tensormap

                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,
                )
                cute_ptr_of_tensor_of_group_map = make_ptr(
                    cutlass.Int32,
                    launch_cache.tensor_of_group_map.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,
                    cute_ptr_of_tensor_of_group_map,
                    total_num_clusters,
                    single_problem_sizes,
                    num_groups,
                )
            res.append(c)
        return res

    compiled_func = compile_kernel(problem_sizes)

    # Extract raw data pointers from all input tensors for each group
    # These will be passed to the GPU kernel to access the actual tensor data
    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)):
        # Store pointers to A, B, and C matrices for this group
        abc_ptrs.append((a.data_ptr(), b.data_ptr(), c.data_ptr()))
        # Store pointers to scale factor tensors for this group
        sfasfb_ptrs.append((sfa_reordered.data_ptr(), sfb_reordered.data_ptr()))

    # Create torch tensor to store problem sizes for all groups
    # Shape: (num_groups, 4) where each row contains (m, n, k, l) for that group
    # Layout: (num_groups, 4):(4, 1) means row-major storage
    launch_cache = _get_launch_cache(problem_sizes, device)
    tensor_of_problem_sizes = launch_cache.tensor_of_problem_sizes

    # Create torch tensors to store data pointers for all groups
    # These allow the GPU kernel to dynamically access different tensors per group
    # tensor_of_abc_ptrs: Shape (num_groups, 3) containing (a_ptr, b_ptr, c_ptr) per group
    # tensor_of_sfasfb_ptrs: Shape (num_groups, 2) containing (sfa_ptr, sfb_ptr) per group
    tensor_of_abc_ptrs, tensor_of_sfasfb_ptrs = _get_ptr_tensors(
        abc_ptrs, sfasfb_ptrs, device
    )

    total_num_clusters = launch_cache.total_num_clusters
    num_groups = launch_cache.num_groups
    tensor_of_tensormap = launch_cache.tensor_of_tensormap
    tensor_of_group_map = launch_cache.tensor_of_group_map

    # Create CuTe pointers to the metadata tensors that will be passed to the kernel
    # These allow the GPU kernel to read problem sizes and tensor pointers
    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,
    )
    cute_ptr_of_tensor_of_group_map = make_ptr(
        cutlass.Int32,
        tensor_of_group_map.data_ptr(),
        cute.AddressSpace.gmem,
        assumed_align=16,
    )

    # Launch the JIT-compiled GPU kernel with all prepared data
    # The kernel will perform block-scaled group GEMM: C = A * SFA * B * SFB for all groups
    compiled_func(
        cute_ptr_of_tensor_of_problem_sizes, # Pointer to problem sizes array
        cute_ptr_of_tensor_of_abc_ptrs,      # Pointer to ABC tensor pointers array
        cute_ptr_of_tensor_of_sfasfb_ptrs,   # Pointer to scale factor pointers array
        cute_ptr_of_tensor_of_tensormap,     # Pointer to tensormap buffer
        cute_ptr_of_tensor_of_group_map,     # Pointer to CTA -> group/coord map
        total_num_clusters,                  # Total number of CTAs to launch
        problem_sizes,                       # Problem sizes list (for host-side processing)
        num_groups,                          # Number of groups in this batch
    )

    res = []
    for i in range(num_groups):
        res.append(abc_tensors[i][2])
    return res
scrolls · 1803 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 399847.

⋯ 4 unchanged lines
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.utils.layout import LayoutEnum
from cutlass.cute.runtime import make_ptr
- import functools
- import os
+ import functools
+ import os
from typing import Tuple, List
import torch
from task import input_t, output_t
- # Kernel configuration parameters
- # Size of tma descriptor in bytes
- bytes_per_tensormap = 128
- # Number of tensormaps: a, b, sfa, sfb
- num_tensormaps = 4
- # Shape of the K dimension for the MMA instruction
- mma_inst_shape_k = 64
- # FP4 data type for A and B
- ab_dtype = cutlass.Float4E2M1FN
- # FP8 data type for scale factors
- sf_dtype = cutlass.Float8E4M3FN
- # FP16 output type
- c_dtype = cutlass.Float16
- # Scale factor block size (16 elements share one scale)
- sf_vec_size = 16
-
- # Tunable configs: set POPCORN_CFG=0..3 before running to select.
- _CONFIGS = [
- # Baseline (reference layout).
- {"mma_tiler_mnk": (128, 128, 256), "threads_per_cta": 128, "num_ab_stage": 1, "num_acc_stage": 1, "num_tmem_alloc_cols": 512},
- # More pipelining, same tile.
- {"mma_tiler_mnk": (128, 128, 256), "threads_per_cta": 128, "num_ab_stage": 2, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
- # Taller M tile, narrower N.
- {"mma_tiler_mnk": (128, 64, 256), "threads_per_cta": 128, "num_ab_stage": 4, "num_acc_stage": 3, "num_tmem_alloc_cols": 512},
- # Taller N tile, narrower M.
- {"mma_tiler_mnk": (64, 128, 256), "threads_per_cta": 128, "num_ab_stage": 2, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
- ]
- _cfg_idx = int(os.environ.get("POPCORN_CFG", "0"))
- if _cfg_idx < 0 or _cfg_idx >= len(_CONFIGS):
- _cfg_idx = 0
- _cfg = _CONFIGS[_cfg_idx]
-
- # Tile sizes for M, N, K dimensions
- mma_tiler_mnk = _cfg["mma_tiler_mnk"]
- # Number of threads per CUDA thread block
- threads_per_cta = _cfg["threads_per_cta"]
- # Stage numbers of shared memory and tmem
- num_acc_stage = _cfg["num_acc_stage"]
- num_ab_stage = _cfg["num_ab_stage"]
- # Total number of columns in tmem
- num_tmem_alloc_cols = _cfg["num_tmem_alloc_cols"]
+ # Kernel configuration parameters
+ # Size of tma descriptor in bytes
+ bytes_per_tensormap = 128
+ # Number of tensormaps: a, b, sfa, sfb
+ num_tensormaps = 4
+ # Shape of the K dimension for the MMA instruction
+ mma_inst_shape_k = 64
+ # FP4 data type for A and B
+ ab_dtype = cutlass.Float4E2M1FN
+ # FP8 data type for scale factors
+ sf_dtype = cutlass.Float8E4M3FN
+ # FP16 output type
+ c_dtype = cutlass.Float16
+ # Scale factor block size (16 elements share one scale)
+ sf_vec_size = 16
+ # Tunable configs: set POPCORN_CFG=0..3 before running to select.
+ _CONFIGS = [
+ # Baseline (reference layout).
+ {"mma_tiler_mnk": (128, 128, 256), "threads_per_cta": 128, "num_ab_stage": 1, "num_acc_stage": 1, "num_tmem_alloc_cols": 512},
+ # More pipelining, same tile.
+ {"mma_tiler_mnk": (128, 128, 256), "threads_per_cta": 128, "num_ab_stage": 2, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
+ # Taller M tile, narrower N.
+ {"mma_tiler_mnk": (128, 64, 256), "threads_per_cta": 128, "num_ab_stage": 2, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
+ # Taller N tile, narrower M.
+ {"mma_tiler_mnk": (64, 128, 256), "threads_per_cta": 128, "num_ab_stage": 2, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
+ # Larger K tile to reduce K-loop overhead.
+ {"mma_tiler_mnk": (128, 64, 512), "threads_per_cta": 128, "num_ab_stage": 2, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
+ # More threads per CTA for better occupancy.
+ {"mma_tiler_mnk": (128, 64, 256), "threads_per_cta": 256, "num_ab_stage": 2, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
+ # Larger K tile to reduce loop overhead on big-K cases.
+ {"mma_tiler_mnk": (128, 128, 512), "threads_per_cta": 128, "num_ab_stage": 2, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
+ # Deeper AB pipeline with more threads for better overlap.
+ {"mma_tiler_mnk": (128, 128, 256), "threads_per_cta": 256, "num_ab_stage": 3, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
+ # Larger N tile to reduce CTA count on wide-N cases.
+ {"mma_tiler_mnk": (128, 256, 256), "threads_per_cta": 256, "num_ab_stage": 2, "num_acc_stage": 2, "num_tmem_alloc_cols": 512},
+ ]
+ _cfg_idx = int(os.environ.get("POPCORN_CFG", "0"))
+ if _cfg_idx < 0 or _cfg_idx >= len(_CONFIGS):
+ _cfg_idx = 0
+ _cfg = _CONFIGS[_cfg_idx]
+ _PER_GROUP_LAUNCH = os.environ.get("POPCORN_GROUP_LAUNCH", "0") == "1"
+ _USE_SINGLE_KERNEL = os.environ.get("POPCORN_USE_SINGLE_KERNEL", "0") == "1"
+ _USE_TORCH_SCALED_MM = os.environ.get("POPCORN_USE_TORCH_SCALED_MM", "0") == "1"
+ _USE_TMA_STORE = os.environ.get("POPCORN_USE_TMA_STORE", "0") == "1"
+ # Tile sizes for M, N, K dimensions
+ mma_tiler_mnk = _cfg["mma_tiler_mnk"]
+ # Number of threads per CUDA thread block
+ threads_per_cta = _cfg["threads_per_cta"]
+ # Stage numbers of shared memory and tmem
+ num_acc_stage = _cfg["num_acc_stage"]
+ num_ab_stage = _cfg["num_ab_stage"]
+ # Stage numbers of C shared memory for TMA store
+ num_c_stage = 1
+ # Total number of columns in tmem
+ num_tmem_alloc_cols = _cfg["num_tmem_alloc_cols"]
+
+
# Helper function for ceiling division
def ceil_div(a, b):
return (a + b - 1) // b
⋯ 15 unchanged lines
tensor_of_sfasfb_ptrs: cute.Tensor,
tensormaps: cute.Tensor,
tensor_of_problem_sizes: cute.Tensor,
+ tensor_of_group_map: 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],
):
"""
⋯ 3 unchanged lines
warp_idx = cute.arch.make_warp_uniform(warp_idx)
tidx, _, _ = cute.arch.thread_idx()
- #
- # 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
+ group_idx = tensor_of_group_map[bidz, 0]
+ coord_x = tensor_of_group_map[bidz, 1]
+ coord_y = tensor_of_group_map[bidz, 2]
#
# Construct C Tensor for each CTA
⋯ 17 unchanged lines
)
#
- # 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
- )
+ # 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
+ )
# Setup smem tensor for A, B, SFA, SFB
# (MMA, MMA_M, MMA_K, STAGE)
sA = smem.allocate_tensor(
⋯ 77 unchanged lines
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
- )
+ 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
⋯ 26 unchanged lines
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)
-
- # Let warp 0 initialize tensormap
- if warp_idx == 0:
- tensormap_manager.init_tensormap_from_atom(
- tma_atom_a, tensormap_a_smem_ptr, 0
- )
- tensormap_manager.init_tensormap_from_atom(
- tma_atom_b, tensormap_b_smem_ptr, 0
- )
- tensormap_manager.init_tensormap_from_atom(
- tma_atom_sfa, tensormap_sfa_smem_ptr, 0
- )
- tensormap_manager.init_tensormap_from_atom(
- tma_atom_sfb, tensormap_sfb_smem_ptr, 0
- )
- 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,
- ),
- 0, # tma 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)
-
- cute.arch.barrier()
-
- #
- # Partition global/shared tensor for TMA load A/B/SFA/SFB
- #
+ 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)
+
+ # Let warp 0 initialize tensormap
+ if warp_idx == 0:
+ tensormap_manager.init_tensormap_from_atom(
+ tma_atom_a, tensormap_a_smem_ptr, 0
+ )
+ tensormap_manager.init_tensormap_from_atom(
+ tma_atom_b, tensormap_b_smem_ptr, 0
+ )
+ tensormap_manager.init_tensormap_from_atom(
+ tma_atom_sfa, tensormap_sfa_smem_ptr, 0
+ )
+ tensormap_manager.init_tensormap_from_atom(
+ tma_atom_sfb, tensormap_sfb_smem_ptr, 0
+ )
+ 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,
+ ),
+ 0,
+ (
+ 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)
+
+ cute.arch.barrier()
+
+ #
+ # Partition global/shared tensor for TMA load A/B/SFA/SFB
+ #
# TMA Partition_S/D for A
# ((atom_v, rest_v), STAGE)
# ((atom_v, rest_v), RestM, RestK, RestL)
⋯ 320 unchanged lines
pass
+
+
# Host-side JIT function to prepare tensors and launch GPU kernel.
@cute.jit
def my_kernel(
⋯ 1 unchanged lines
ptr_of_tensor_of_abc_ptrs: cute.Pointer,
ptr_of_tensor_of_sfasfb_ptrs: cute.Pointer,
ptr_of_tensor_of_tensormap: cute.Pointer,
+ ptr_of_tensor_of_group_map: cute.Pointer,
total_num_clusters: cutlass.Int32,
problem_sizes: List[
Tuple[int, int, int, int]
⋯ 10 unchanged lines
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))
+ tensor_of_tensormap = cute.make_tensor(
+ ptr_of_tensor_of_tensormap, cute.make_layout((total_num_clusters, 4, 16), stride=(64, 16, 1))
+ )
+ tensor_of_group_map = cute.make_tensor(
+ ptr_of_tensor_of_group_map, cute.make_layout((total_num_clusters, 3), stride=(3, 1))
)
# Use fake shape for initial Tma descriptor and atom setup
⋯ 135 unchanged lines
a_copy_size + b_copy_size + sfa_copy_size + sfb_copy_size
) * atom_thr_size
- # Store CTA shape information for each Group in a List
- 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)
- # Compute grid size
- grid = (1, 1, total_num_clusters)
-
# Launch the kernel
kernel(
# MMA (Matrix Multiply-Accumulate) configuration
⋯ 20 unchanged lines
tensor_of_sfasfb_ptrs, # Device tensor containing pointers to SFA, SFB for all groups
tensor_of_tensormap, # Pre-allocated buffer for tensormap descriptors per CTA
tensor_of_problem_sizes, # Device tensor containing (m, n, k, l) for each group
+ tensor_of_group_map, # Device tensor mapping CTA idx -> (group_idx, coord_x, coord_y)
# Shared memory layouts with staging for pipelined execution
a_smem_layout_staged, # Staged shared memory layout for A (includes stage dimension)
⋯ 1 unchanged lines
sfa_smem_layout_staged, # Staged shared memory layout for SFA (includes stage dimension)
sfb_smem_layout_staged, # Staged shared memory layout for SFB (includes stage dimension)
- # CTA grid configuration per group
- cta_mn_list, # List of (M_tiles, N_tiles) for each group
-
# Pipeline synchronization parameter
num_tma_load_bytes, # Total bytes to load per TMA transaction (for barrier setup)
).launch(
⋯ 1 unchanged lines
block=[threads_per_cta, 1, 1],
cluster=(1, 1, 1),
)
+
+ # Single-group kernel (based on nvfp4_gemm) for per-group launches.
+ @cute.kernel
+ def kernel_single(
+ 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,
+ tma_atom_c: cute.CopyAtom,
+ mC_mnl: 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,
+ c_smem_layout_staged: cute.Layout,
+ epi_tile: cute.Tile,
+ num_tma_load_bytes: cutlass.Constexpr[int],
+ ):
+ warp_idx = cute.arch.warp_idx()
+ warp_idx = cute.arch.make_warp_uniform(warp_idx)
+ tidx, _, _ = cute.arch.thread_idx()
+
+ bidx, bidy, bidz = cute.arch.block_idx()
+ cta_coord = (bidx, bidy, bidz)
+ mma_tile_coord_mnl = (
+ cta_coord[0] // cute.size(tiled_mma.thr_id.shape),
+ cta_coord[1],
+ cta_coord[2],
+ )
+
+ @cute.struct
+ class SharedStorage:
+ 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)
+ 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,
+ )
+ if cutlass.const_expr(_USE_TMA_STORE):
+ sC = smem.allocate_tensor(
+ element_type=c_dtype,
+ layout=c_smem_layout_staged.outer,
+ byte_alignment=128,
+ swizzle=c_smem_layout_staged.inner,
+ )
+
+ ab_pipeline_producer_group = pipeline.CooperativeGroup(pipeline.Agent.Thread)
+ ab_pipeline_consumer_group = pipeline.CooperativeGroup(pipeline.Agent.Thread, 1)
+ ab_producer, ab_consumer = pipeline.PipelineTmaUmma.create(
+ barrier_storage=storage.ab_mbar_ptr.data_ptr(),
+ num_stages=num_ab_stage,
+ producer_group=ab_pipeline_producer_group,
+ consumer_group=ab_pipeline_consumer_group,
+ tx_count=num_tma_load_bytes,
+ ).make_participants()
+ acc_producer, acc_consumer = pipeline.PipelineUmmaAsync.create(
+ barrier_storage=storage.acc_mbar_ptr.data_ptr(),
+ num_stages=num_acc_stage,
+ producer_group=ab_pipeline_producer_group,
+ consumer_group=pipeline.CooperativeGroup(
+ pipeline.Agent.Thread,
+ threads_per_cta,
+ ),
+ ).make_participants()
+
+ 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)
+ )
+ gC_mnl = cute.local_tile(
+ mC_mnl, cute.slice_(mma_tiler_mnk, (None, None, 0)), (None, None, None)
+ )
+ k_tile_cnt = cute.size(gA_mkl, mode=[3])
+
+ thr_mma = tiled_mma.get_slice(0)
+ 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)
+
+ 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)
+
+ 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)
+
+ tmem_alloc_barrier = pipeline.NamedBarrier(
+ barrier_id=1,
+ num_threads=threads_per_cta,
+ )
+ tmem = utils.TmemAllocator(
+ storage.tmem_holding_buf,
+ barrier_for_retrieve=tmem_alloc_barrier,
+ )
+ tmem.allocate(num_tmem_alloc_cols)
+ tmem.wait_for_alloc()
+ acc_tmem_ptr = tmem.retrieve_ptr(cutlass.Float32)
+ tCtAcc = cute.make_tensor(acc_tmem_ptr, tCtAcc_fake.layout)
+
+ 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)
+
+ 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)
+
+ 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])]
+
+ if warp_idx == 0:
+ acc_empty = acc_producer.acquire_and_advance()
+ tiled_mma.set(tcgen05.Field.ACCUMULATE, False)
+ for k_tile in range(k_tile_cnt):
+ ab_empty = ab_producer.acquire_and_advance()
+ cute.copy(
+ tma_atom_a,
+ tAgA[(None, k_tile)],
+ tAsA[(None, ab_empty.index)],
+ tma_bar_ptr=ab_empty.barrier,
+ )
+ cute.copy(
+ tma_atom_b,
+ tBgB[(None, k_tile)],
+ tBsB[(None, ab_empty.index)],
+ tma_bar_ptr=ab_empty.barrier,
+ )
+ cute.copy(
+ tma_atom_sfa,
+ tAgSFA[(None, k_tile)],
+ tAsSFA[(None, ab_empty.index)],
+ tma_bar_ptr=ab_empty.barrier,
+ )
+ cute.copy(
+ tma_atom_sfb,
+ tBgSFB[(None, k_tile)],
+ tBsSFB[(None, ab_empty.index)],
+ tma_bar_ptr=ab_empty.barrier,
+ )
+
+ ab_full = ab_consumer.wait_and_advance()
+ s2t_stage_coord = (None, None, None, None, ab_full.index)
+ 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,
+ )
+
+ 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_full.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,
+ tCtSFB[sf_kblock_coord].iterator,
+ )
+ cute.gemm(
+ tiled_mma,
+ tCtAcc,
+ tCrA[kblock_coord],
+ tCrB[kblock_coord],
+ tCtAcc,
+ )
+ tiled_mma.set(tcgen05.Field.ACCUMULATE, True)
+ ab_full.release()
+ acc_empty.commit()
+
+ 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)
+ thr_copy_t2r = tiled_copy_t2r.get_slice(tidx)
+ tTR_tAcc = thr_copy_t2r.partition_S(tCtAcc)
+ tTR_gC = thr_copy_t2r.partition_D(tCgC)
+ tTR_rAcc = cute.make_rmem_tensor(
+ tTR_gC[None, None, None, None, 0, 0, 0].shape, cutlass.Float32
+ )
+ tTR_rC = cute.make_rmem_tensor(
+ tTR_gC[None, None, None, None, 0, 0, 0].shape, c_dtype
+ )
+ simt_atom = cute.make_copy_atom(cute.nvgpu.CopyUniversalOp(), c_dtype)
+ tTR_gC = tTR_gC[(None, None, None, None, *mma_tile_coord_mnl)]
+
+ acc_full = acc_consumer.wait_and_advance()
+ cute.copy(tiled_copy_t2r, tTR_tAcc, tTR_rAcc)
+ acc_vec = tTR_rAcc.load().to(c_dtype)
+ tTR_rC.store(acc_vec)
+ if cutlass.const_expr(_USE_TMA_STORE):
+ tCgC_epi = cute.flat_divide(tCgC, epi_tile)
+ bSG_sC, bSG_gC_partitioned = cpasync.tma_partition(
+ tma_atom_c,
+ 0,
+ cute.make_layout(1),
+ cute.group_modes(sC, 0, 2),
+ cute.group_modes(tCgC_epi, 0, 2),
+ )
+ c_producer_group = pipeline.CooperativeGroup(
+ pipeline.Agent.Thread, 32
+ )
+ c_pipeline = pipeline.PipelineTmaStore.create(
+ num_stages=num_c_stage, producer_group=c_producer_group
+ )
+ cute.copy(simt_atom, tTR_rC, bSG_sC[(None, 0)])
+ cute.arch.fence_proxy(
+ cute.arch.ProxyKind.async_shared,
+ space=cute.arch.SharedSpace.shared_cta,
+ )
+ if warp_idx == 0:
+ bSG_gC = bSG_gC_partitioned[(None, None, None, *mma_tile_coord_mnl)]
+ cute.copy(
+ tma_atom_c,
+ bSG_sC[(None, 0)],
+ bSG_gC[(None, 0)],
+ )
+ c_pipeline.producer_commit()
+ c_pipeline.producer_tail()
+ else:
+ cute.copy(simt_atom, tTR_rC, tTR_gC)
+ acc_full.release()
+
+ cute.arch.barrier()
+ tmem.free(acc_tmem_ptr)
return
+ @cute.jit
+ def my_kernel_single(
+ a_ptr: cute.Pointer,
+ b_ptr: cute.Pointer,
+ sfa_ptr: cute.Pointer,
+ sfb_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)),
+ ),
+ )
+ b_tensor = cute.make_tensor(
+ b_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))
+ )
+ sfa_layout = blockscaled_utils.tile_atom_to_shape_SF(
+ a_tensor.shape, sf_vec_size
+ )
+ sfa_tensor = cute.make_tensor(sfa_ptr, sfa_layout)
+ sfb_layout = blockscaled_utils.tile_atom_to_shape_SF(
+ b_tensor.shape, sf_vec_size
+ )
+ sfb_tensor = cute.make_tensor(sfb_ptr, sfb_layout)
+
+ 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,),
+ )
+
+ 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,
+ )
+ epi_tile = sm100_utils.compute_epilogue_tile_shape(
+ mma_tiler_mnk[:2],
+ False,
+ LayoutEnum.ROW_MAJOR,
+ c_dtype,
+ )
+ c_smem_layout_staged = sm100_utils.make_smem_layout_epi(
+ c_dtype,
+ LayoutEnum.ROW_MAJOR,
+ epi_tile,
+ num_c_stage,
+ )
+
+ atom_thr_size = cute.size(tiled_mma.thr_id.shape)
+
+ 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),
+ a_tensor,
+ a_smem_layout,
+ mma_tiler_mnk,
+ tiled_mma,
+ cluster_layout_vmnk.shape,
+ )
+ 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),
+ b_tensor,
+ b_smem_layout,
+ mma_tiler_mnk,
+ tiled_mma,
+ cluster_layout_vmnk.shape,
+ )
+ 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),
+ sfa_tensor,
+ sfa_smem_layout,
+ mma_tiler_mnk,
+ tiled_mma,
+ cluster_layout_vmnk.shape,
+ internal_type=cutlass.Int16,
+ )
+ 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),
+ sfb_tensor,
+ sfb_smem_layout,
+ mma_tiler_mnk,
+ tiled_mma,
+ cluster_layout_vmnk.shape,
+ internal_type=cutlass.Int16,
+ )
+
+ 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
+
+ grid = (
+ cute.ceil_div(c_tensor.shape[0], mma_tiler_mnk[0]),
+ cute.ceil_div(c_tensor.shape[1], mma_tiler_mnk[1]),
+ c_tensor.shape[2],
+ )
+
+ epi_smem_layout = cute.slice_(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,
+ epi_tile,
+ )
+
+ kernel_single(
+ 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,
+ tma_atom_c,
+ c_tensor,
+ a_smem_layout_staged,
+ b_smem_layout_staged,
+ sfa_smem_layout_staged,
+ sfb_smem_layout_staged,
+ c_smem_layout_staged,
+ epi_tile,
+ num_tma_load_bytes,
+ ).launch(
+ grid=grid,
+ block=[threads_per_cta, 1, 1],
+ cluster=(1, 1, 1),
+ )
+ return
+
+
+ _compiled_single_kernel_cache = None
+
+
+ def compile_kernel_single():
+ global _compiled_single_kernel_cache
+ if _compiled_single_kernel_cache is not None:
+ return _compiled_single_kernel_cache
+
+ a_ptr = make_ptr(
+ ab_dtype, 0, cute.AddressSpace.gmem, assumed_align=16
+ )
+ b_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
+ )
+ sfb_ptr = make_ptr(
+ sf_dtype, 0, cute.AddressSpace.gmem, assumed_align=32
+ )
+ _compiled_single_kernel_cache = cute.compile(
+ my_kernel_single, a_ptr, b_ptr, sfa_ptr, sfb_ptr, c_ptr, (0, 0, 0, 0)
+ )
+ return _compiled_single_kernel_cache
+
# Global cache for compiled kernels (keyed by group size)
- # Caches compiled kernels and host-side launch metadata to reduce overhead.
- _compiled_kernel_cache = {}
- _launch_cache = {}
-
-
- def _problem_sizes_key(problem_sizes):
- return tuple(tuple(int(v) for v in sizes) for sizes in problem_sizes)
-
-
- def _device_cache_key(device):
- if device.type == "cuda":
- return ("cuda", device.index if device.index is not None else torch.cuda.current_device())
- return (device.type, None)
-
-
- def _compute_total_num_clusters(problem_sizes, cluster_tile_shape_mn):
- total_num_clusters = 0
- 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)
- return total_num_clusters
-
-
- class _LaunchCacheEntry:
- def __init__(self, problem_sizes, device):
- self.problem_sizes_key = _problem_sizes_key(problem_sizes)
- self.num_groups = len(problem_sizes)
- self.tensor_of_problem_sizes = torch.tensor(
- problem_sizes, dtype=torch.int32, device=device
- )
- cta_tile_shape_mn = (mma_tiler_mnk[0], mma_tiler_mnk[1])
- cluster_tile_shape_mn = cta_tile_shape_mn
- self.total_num_clusters = _compute_total_num_clusters(
- problem_sizes, cluster_tile_shape_mn
- )
+ # Caches compiled kernels and host-side launch metadata to reduce overhead.
+ _compiled_kernel_cache = {}
+ _launch_cache = {}
+ _ptr_tensor_cache = {}
+
+
+ def _problem_sizes_key(problem_sizes):
+ return tuple(tuple(int(v) for v in sizes) for sizes in problem_sizes)
+
+
+ def _device_cache_key(device):
+ if device.type == "cuda":
+ return ("cuda", device.index if device.index is not None else torch.cuda.current_device())
+ return (device.type, None)
+
+
+ def _compute_total_num_clusters(problem_sizes, cluster_tile_shape_mn):
+ total_num_clusters = 0
+ 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)
+ return total_num_clusters
+
+
+ class _LaunchCacheEntry:
+ def __init__(self, problem_sizes, device):
+ self.problem_sizes_key = _problem_sizes_key(problem_sizes)
+ self.num_groups = len(problem_sizes)
+ self.tensor_of_problem_sizes = torch.tensor(
+ problem_sizes, dtype=torch.int32, device=device
+ )
+ cta_tile_shape_mn = (mma_tiler_mnk[0], mma_tiler_mnk[1])
+ cluster_tile_shape_mn = cta_tile_shape_mn
+ self.total_num_clusters = _compute_total_num_clusters(
+ problem_sizes, cluster_tile_shape_mn
+ )
+ cta_mn_list = []
+ for m, n, _, _ in problem_sizes:
+ x = ceil_div(m, cta_tile_shape_mn[0])
+ y = ceil_div(n, cta_tile_shape_mn[1])
+ cta_mn_list.append((x, y))
+ group_map = []
+ for group_idx, (cta_m, cta_n) in enumerate(cta_mn_list):
+ for coord_y in range(cta_n):
+ for coord_x in range(cta_m):
+ group_map.append((group_idx, coord_x, coord_y))
+ self.tensor_of_group_map = torch.tensor(
+ group_map, dtype=torch.int32, device=device
+ )
tensormap_shape = (
self.total_num_clusters,
num_tensormaps,
bytes_per_tensormap // 8,
)
- self.tensor_of_tensormap = torch.empty(
- tensormap_shape, dtype=torch.int64, device=device
- )
-
-
- def _get_launch_cache(problem_sizes, device):
- key = (_device_cache_key(device), _problem_sizes_key(problem_sizes))
- entry = _launch_cache.get(key)
- if entry is None:
- entry = _LaunchCacheEntry(problem_sizes, device)
- _launch_cache[key] = entry
- return entry
+ self.tensor_of_tensormap = torch.empty(
+ tensormap_shape, dtype=torch.int64, device=device
+ )
+
+
+ def _get_launch_cache(problem_sizes, device):
+ key = (_device_cache_key(device), _problem_sizes_key(problem_sizes))
+ entry = _launch_cache.get(key)
+ if entry is None:
+ entry = _LaunchCacheEntry(problem_sizes, device)
+ _launch_cache[key] = entry
+ return entry
+
+
+ def _get_ptr_tensors(abc_ptrs, sfasfb_ptrs, device):
+ key = (_device_cache_key(device), tuple(abc_ptrs), tuple(sfasfb_ptrs))
+ cached = _ptr_tensor_cache.get(key)
+ if cached is not None:
+ return cached
+ tensor_of_abc_ptrs = torch.tensor(abc_ptrs, dtype=torch.int64, device=device)
+ tensor_of_sfasfb_ptrs = torch.tensor(sfasfb_ptrs, dtype=torch.int64, device=device)
+ _ptr_tensor_cache[key] = (tensor_of_abc_ptrs, tensor_of_sfasfb_ptrs)
+ return tensor_of_abc_ptrs, tensor_of_sfasfb_ptrs
# This function is used to compile the kernel once and cache it and then allow users to
# run the kernel multiple times to get more accurate timing results.
def compile_kernel(problem_sizes):
⋯ 6 unchanged lines
"""
global _compiled_kernel_cache
- # Use full problem sizes as the cache key to avoid mixing incompatible kernels.
- cache_key = _problem_sizes_key(problem_sizes)
+ # Use full problem sizes as the cache key to avoid mixing incompatible kernels.
+ cache_key = _problem_sizes_key(problem_sizes)
# Check if we already have a compiled kernel for these problem sizes
if cache_key in _compiled_kernel_cache:
⋯ 16 unchanged lines
cute_ptr_of_tensor_of_tensormap = make_ptr(
cutlass.Int64, 0, cute.AddressSpace.gmem, assumed_align=16,
)
+ cute_ptr_of_tensor_of_group_map = make_ptr(
+ cutlass.Int32, 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,
+ cute_ptr_of_tensor_of_group_map,
total_num_clusters,
problem_sizes,
num_groups
⋯ 30 unchanged lines
"""
abc_tensors, _, sfasfb_reordered_tensors, problem_sizes = data
- compiled_func = compile_kernel(problem_sizes)
- device = abc_tensors[0][0].device
-
- # Extract raw data pointers from all input tensors for each group
+ device = abc_tensors[0][0].device
+
+ if _USE_TORCH_SCALED_MM:
+ res = []
+ for (a, b, c), (sfa_reordered, sfb_reordered), (m, n, k, l) in zip(
+ abc_tensors, sfasfb_reordered_tensors, problem_sizes
+ ):
+ for l_idx in range(l):
+ scale_a = sfa_reordered[..., l_idx].contiguous().view(-1)
+ scale_b = sfb_reordered[..., l_idx].contiguous().view(-1)
+ out = torch._scaled_mm(
+ a[:, :, l_idx].view(torch.float4_e2m1fn_x2),
+ b[:, :, l_idx].transpose(0, 1).view(torch.float4_e2m1fn_x2),
+ scale_a,
+ scale_b,
+ bias=None,
+ out_dtype=torch.float16,
+ )
+ c[:, :, l_idx] = out
+ res.append(c)
+ return res
+
+ if _PER_GROUP_LAUNCH:
+ res = []
+ for (a, b, c), (sfa_reordered, sfb_reordered), (m, n, k, l) in zip(
+ abc_tensors, sfasfb_reordered_tensors, problem_sizes
+ ):
+ if _USE_SINGLE_KERNEL:
⋯ diff truncated
scrolls · 1201 diff lines total

Best evidence level for this revision: reported

JSON