Files
sglang/python/sglang/jit_kernel/fused_store_index_cache.py
2026-02-26 10:23:10 +08:00

104 lines
3.2 KiB
Python

"""
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,
)
if TYPE_CHECKING:
from tvm_ffi.module import Module
logger = logging.getLogger(__name__)
@cache_once
def _jit_nsa_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=["nsa/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 NSA)
f"FusedStoreCacheIndexerKernel<{args}>::run",
)
],
)
@cache_once
def can_use_nsa_fused_store(
key_dtype: torch.dtype, indices_dtype: torch.dtype, page_size: int
) -> bool:
logger = logging.getLogger(__name__)
try:
_jit_nsa_fused_store_module(key_dtype, indices_dtype, page_size)
return True
except Exception as e:
logger.warning(f"Failed to load nsa fused store JIT kernel: {e}")
return False
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 NSATokenToKVPool.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_nsa_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)