""" This module provides JIT-compiled CUDA kernels for fusing multiple tensor copy operations into single kernel launches, reducing kernel launch overhead and improving CUDA graph replay performance. The kernels are compiled on-demand using TVM FFI and cached for subsequent use. """ from __future__ import annotations import logging from typing import TYPE_CHECKING import torch from sglang.jit_kernel.utils import ( cache_once, is_arch_support_pdl, load_jit, make_cpp_args, ) from sglang.kernel_api_logging import debug_kernel_api if TYPE_CHECKING: from tvm_ffi.module import Module logger = logging.getLogger(__name__) @cache_once def _jit_dsa_fused_store_module( key_dtype: torch.dtype, indices_dtype: torch.dtype, page_size: int ) -> Module: """ Build a JIT module that exposes: module.fused_store_index_k_cache(input_bf16, index_k_with_scale_u8, loc_i64) """ args = make_cpp_args(key_dtype, indices_dtype, page_size, is_arch_support_pdl()) return load_jit( "fused_store_index_k_cache", *args, cuda_files=["dsa/fused_store_index_cache.cuh"], cuda_wrappers=[ ( "fused_store_index_k_cache", # - Float = bf16_t (sgl_kernel/type.cuh) # - IndicesT = int64_t (out_cache_loc is int64 in SGLang SetKAndS) # - kPageSize = 64 (CUDA DSA) f"FusedStoreCacheIndexerKernel<{args}>::run", ) ], ) @cache_once def can_use_dsa_fused_store( key_dtype: torch.dtype, indices_dtype: torch.dtype, page_size: int ) -> bool: logger = logging.getLogger(__name__) try: _jit_dsa_fused_store_module(key_dtype, indices_dtype, page_size) return True except Exception as e: logger.warning(f"Failed to load dsa fused store JIT kernel: {e}") return False @debug_kernel_api def fused_store_index_k_cache( key: torch.Tensor, index_k_with_scale: torch.Tensor, out_cache_loc: torch.Tensor, page_size: int = 64, ) -> None: """ Fused: quantize bf16 key (N,128) -> fp8 + fp32 scale and write into DSATokenToKVPool.index_k_with_scale_buffer. key: (num_tokens, 128) bf16 (or reshapeable to it) index_k_with_scale: (num_pages, 64*(128+4)) uint8 out_cache_loc: (num_tokens,) int64 token indices in TokenToKVPool """ assert key.is_cuda assert index_k_with_scale.is_cuda assert out_cache_loc.is_cuda # 1) normalize shapes if key.dim() != 2: key = key.view(-1, key.shape[-1]) assert key.shape[1] == 128, f"expected key last-dim=128, got {key.shape}" # 2) dtypes assert key.dtype == torch.bfloat16, f"{key.dtype=}" assert index_k_with_scale.dtype == torch.uint8, f"{index_k_with_scale.dtype=}" assert out_cache_loc.dtype == torch.int64, f"{out_cache_loc.dtype=}" # 3) contiguity if not key.is_contiguous(): key = key.contiguous() if not out_cache_loc.is_contiguous(): out_cache_loc = out_cache_loc.contiguous() if not index_k_with_scale.is_contiguous(): index_k_with_scale = index_k_with_scale.contiguous() module = _jit_dsa_fused_store_module(key.dtype, out_cache_loc.dtype, page_size) module.fused_store_index_k_cache(key, index_k_with_scale, out_cache_loc)