/* * Copyright (c) 2022-2025, NVIDIA CORPORATION. All rights reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include "DevKernel.h" #include "RoutingKernel.h" #include "runner.h" #include "tensorrt_llm/kernels/trtllmGenKernels/batchedGemm/KernelRunner.h" #include "tensorrt_llm/kernels/trtllmGenKernels/batchedGemm/trtllmGen_bmm_export/trtllm/gen/DtypeDecl.h" #include "tensorrt_llm/kernels/trtllmGenKernels/batchedGemm/trtllmGen_bmm_export/trtllm/gen/SfLayoutDecl.h" #include #include namespace tensorrt_llm { namespace kernels { namespace trtllmGenFp8BlockScaleMoe { namespace btg = batchedGemm::trtllm::gen; namespace Routing { namespace { inline int32_t computeLog2(int32_t val, std::string const& name = "") { int32_t n = val; int32_t out = 0; while (n >>= 1) { ++out; } TLLM_CHECK_WITH_INFO((1 << out) == val, "Expected %s to be a power of 2, got %d", name.c_str(), val); return out; } } // namespace Runner::Runner() {} Runner::Runner(int32_t tileTokensDim) : mTileTokensDim(tileTokensDim) { } void Runner::run(void* routingLogits, void* routingBias, int32_t numTokens, int32_t numExperts, int32_t topK, int32_t nGroup, int32_t topkGroup, int32_t localExpertOffset, int32_t localNumExperts, float routedScalingFactor, int32_t* routingExpertIndexes, int32_t* expertCountHistogram, int32_t* permutedIdxSize, int32_t* expandedIdxToPermutedIdx, int32_t* permutedIdxToExpandedIdx, int32_t* permutedIdxToTokenIdx, void* expertWeights, int32_t* numTokensPerExpert, int32_t* ctaIdxXyToBatchIdx, int32_t* ctaIdxXyToMnLimit, int32_t* numNonExitingCtas, btg::Dtype dtypeElt, bool useRoutingScalesOnInput, bool useDeepSeekFp8, RoutingMethodType routingMethodType, cudaStream_t stream) { if (routingMethodType == RoutingMethodType::DeepSeekV3) { TLLM_CHECK_WITH_INFO(topK <= 8, "For DeepSeek routing method, must have topK <= 8"); TLLM_CHECK_WITH_INFO(topkGroup <= 4, "For DeepSeek routing method, must have topkGroup <= 4"); moe::dev::routing::Data routingData; routingData.mDtypeExpW = btg::Dtype::Bfloat16; routingData.mUsePdl = true; // output: routingData.mPtrExpertIdx = routingExpertIndexes; routingData.mPtrExpertCounts = expertCountHistogram; routingData.mPtrPermutedIdxSize = permutedIdxSize; routingData.mPtrExpandedIdxToPermutedIdx = expandedIdxToPermutedIdx; routingData.mPtrPermutedIdxToExpandedIdx = permutedIdxToExpandedIdx; routingData.mPtrPermutedIdxToTokenIdx = permutedIdxToTokenIdx; routingData.mPtrNumTokensPerExpert = numTokensPerExpert; routingData.mPtrExpertWeights = expertWeights; routingData.mPtrCtaIdxXyToBatchIdx = ctaIdxXyToBatchIdx; routingData.mPtrCtaIdxXyToMnLimit = ctaIdxXyToMnLimit; routingData.mPtrNumNonExitingCtas = numNonExitingCtas; routingData.mAllToAllRouteAct = false; // input: // routingData.mPtrRoutingWeights = args.mRoutingWeights; // routing weights (don't need if not using gemm) routingData.mPtrRoutingBias = routingBias; routingData.mPtrScores = reinterpret_cast(routingLogits); // routingData.mPtrIn = args.mInputActs; routingData.mNumTokens = numTokens; // routingData.mHiddenDim = args.mHiddenDim; routingData.mNumExperts = numExperts; routingData.mNumExpertGroups = nGroup; routingData.mNumLimitedGroups = topkGroup; routingData.mTopK = topK; routingData.mPaddingLog2 = computeLog2(mTileTokensDim); routingData.mLocalExpertsStartIdx = localExpertOffset; routingData.mLocalExpertsStrideLog2 = 0; routingData.mNumLocalExperts = localNumExperts; routingData.mRouteScale = routedScalingFactor; routingData.mUseRoutingSoftmax = false; moe::dev::routing::run(routingData, stream); } else if (routingMethodType == RoutingMethodType::Llama4) { TLLM_CHECK_WITH_INFO(topK == 1, "For Llama routing method, must have topK == 1"); if (nGroup > 0 || topkGroup > 0) { TLLM_LOG_WARNING("For Llama routing method, nGroup/topkGroup is ignored, got %d/%d.", nGroup, topkGroup); } moe::dev::routingLlama4::Data routingData; routingData.mDtypeExpW = btg::Dtype::Bfloat16; routingData.mUsePdl = true; // output: routingData.mPtrExpertIdx = routingExpertIndexes; routingData.mPtrExpertCounts = expertCountHistogram; routingData.mPtrPermutedIdxSize = permutedIdxSize; routingData.mPtrExpandedIdxToPermutedIdx = expandedIdxToPermutedIdx; // routingData.mPtrPermutedIdxToExpandedIdx = permuted_idx_to_expanded_idx; routingData.mPtrPermutedIdxToTokenIdx = permutedIdxToTokenIdx; // routingData.mPtrNumTokensPerExpert = num_tokens_per_expert; routingData.mPtrExpertWeights = expertWeights; routingData.mPtrCtaIdxXyToBatchIdx = ctaIdxXyToBatchIdx; routingData.mPtrCtaIdxXyToMnLimit = ctaIdxXyToMnLimit; routingData.mPtrNumNonExitingCtas = numNonExitingCtas; // routingData.mAllToAllRouteAct = false; // input: // routingData.mPtrRoutingWeights = args.mRoutingWeights; // routing weights (don't need if not using gemm) // routingData.mPtrRoutingBias = routingBias; routingData.mPtrScores = routingLogits; // routingData.mPtrIn = args.mInputActs; routingData.mNumTokens = numTokens; // routingData.mHiddenDim = args.mHiddenDim; routingData.mNumExperts = numExperts; // routingData.mNumExpertGroups = nGroup; // routingData.mNumLimitedGroups =topkGroup; routingData.mTopK = topK; routingData.mPaddingLog2 = computeLog2(mTileTokensDim); routingData.mLocalExpertsStartIdx = localExpertOffset; routingData.mLocalExpertsStrideLog2 = 0; routingData.mNumLocalExperts = localNumExperts; // routingData.mRouteScale = routed_scaling_factor; // routingData.mUseRoutingSoftmax = false; moe::dev::routingLlama4::run(routingData, stream); } else if (routingMethodType == RoutingMethodType::Renormalize /* default */ || routingMethodType == RoutingMethodType::RenormalizeNaive /* Softmax -> TopK */) { moe::dev::routingQwen3::Data routingData; // // Config // routingData.mDtypeExpW = btg::Dtype::Bfloat16; // routingData.mDtypeElt = dtypeElt; // no-op for now as hidden_state is not input routingData.mUsePdl = true; routingData.mDoSoftmaxBeforeTopK = routingMethodType == RoutingMethodType::RenormalizeNaive; routingData.mNormTopkProb = routingMethodType == RoutingMethodType::RenormalizeNaive; routingData.mPtrScores = routingLogits; // // Outputs // routingData.mPtrExpertIdx = routingExpertIndexes; routingData.mPtrExpertCounts = expertCountHistogram; routingData.mPtrPermutedIdxSize = permutedIdxSize; routingData.mPtrExpandedIdxToPermutedIdx = expandedIdxToPermutedIdx; routingData.mPtrPermutedIdxToTokenIdx = permutedIdxToTokenIdx; routingData.mPtrExpertWeights = expertWeights; // // Grouped Gemm Launch Config Buffers // routingData.mPtrCtaIdxXyToBatchIdx = ctaIdxXyToBatchIdx; routingData.mPtrCtaIdxXyToMnLimit = ctaIdxXyToMnLimit; routingData.mPtrNumNonExitingCtas = numNonExitingCtas; // // Inputs // routingData.mNumTokens = numTokens; routingData.mNumExperts = numExperts; routingData.mTopK = topK; routingData.mPaddingLog2 = computeLog2(mTileTokensDim); routingData.mLocalExpertsStartIdx = localExpertOffset; routingData.mLocalExpertsStrideLog2 = 0; routingData.mNumLocalExperts = localNumExperts; moe::dev::routingQwen3::run(routingData, stream); } else { TLLM_CHECK_WITH_INFO(false, "Unimplemented routing method %s of enum %d", serializeMoeRoutingMethodType(routingMethodType).c_str(), (int) routingMethodType); } } } // namespace Routing namespace PermuteGemm1 { tensorrt_llm::kernels::TrtllmGenBatchedGemmRunnerOptions getOptions( btg::Dtype dtypeElt, int32_t tileTokensDim, bool useDeepSeekFp8) { tensorrt_llm::kernels::TrtllmGenBatchedGemmRunnerOptions options = {.eltType = dtypeElt, .outputType = dtypeElt, .deepSeekFp8 = useDeepSeekFp8, .fusedAct = !useDeepSeekFp8, .routeAct = true, .staticBatch = false, .transposeMmaOutput = true, .tileSize = tileTokensDim, .epilogueTileM = useDeepSeekFp8 ? 64 : 128}; return options; } Runner::Runner(btg::Dtype dtypeElt, bool useDeepSeekFp8, int tileTokensDim) : mDtypeElt(dtypeElt) , mTileTokensDim(tileTokensDim) , mRunner(tensorrt_llm::kernels::TrtllmGenBatchedGemmRunner(getOptions(mDtypeElt, mTileTokensDim, useDeepSeekFp8))) { } void Runner::run(void* hiddenState, void* hiddenStateScale, void* weights, void* weightsScale, void* expertWeights, float* outputScalesScalar, float* outputScalesGateScalar, void* output, void* outputScale, int32_t topK, int32_t hiddenSize, int32_t intermediateSize, int32_t numExperts, int32_t numTokens, int32_t* permutedIdxToTokenIdx, int32_t* ptrNumNonExitingCtas, int32_t* ptrTotalNumPaddedTokens, int32_t* ptrCtaIdxXyToBatchIdx, int32_t* ptrCtaIdxXyToMnLimit, void* bmm1Workspace, bool useRoutingScalesOnInput, int device, cudaStream_t stream) { auto maxNumCtasInBatchDim = Routing::getMaxNumCtasInBatchDim(numTokens, topK, numExperts, mTileTokensDim); mRunner.run(numTokens, 2 * intermediateSize, hiddenSize, {}, numTokens, numExperts, maxNumCtasInBatchDim, hiddenState, hiddenStateScale, weights, weightsScale, expertWeights, /* perTokensSfB */ nullptr, outputScalesScalar, outputScalesGateScalar, output, outputScale, permutedIdxToTokenIdx, ptrTotalNumPaddedTokens, ptrCtaIdxXyToBatchIdx, ptrCtaIdxXyToMnLimit, ptrNumNonExitingCtas, bmm1Workspace, stream, device); } size_t Runner::getWorkspaceSizeInBytes( int32_t topK, int32_t hiddenSize, int32_t intermediateSize, int32_t numExperts, int32_t numTokens) { auto maxNumCtasInBatchDim = Routing::getMaxNumCtasInBatchDim(numTokens, topK, numExperts, mTileTokensDim); return mRunner.getWorkspaceSizeInBytes( numTokens, 2 * intermediateSize, hiddenSize, {}, numTokens, numExperts, maxNumCtasInBatchDim); } } // namespace PermuteGemm1 namespace Gemm2 { tensorrt_llm::kernels::TrtllmGenBatchedGemmRunnerOptions getOptions( btg::Dtype dtypeElt, btg::Dtype dtypeOut, int32_t tileTokensDim, bool useDeepSeekFp8) { tensorrt_llm::kernels::TrtllmGenBatchedGemmRunnerOptions options = {.eltType = dtypeElt, .outputType = dtypeOut, .deepSeekFp8 = useDeepSeekFp8, .fusedAct = false, .routeAct = false, .staticBatch = false, .transposeMmaOutput = true, .tileSize = tileTokensDim, .epilogueTileM = useDeepSeekFp8 ? 64 : 128}; return options; } Runner::Runner(btg::Dtype dtypeElt, btg::Dtype outputDtype, bool useDeepSeekFp8, int tileTokensDim) : mDtypeElt(dtypeElt) , mOutputDtype(outputDtype) , mTileTokensDim(tileTokensDim) , mRunner(tensorrt_llm::kernels::TrtllmGenBatchedGemmRunner( getOptions(mDtypeElt, mOutputDtype, mTileTokensDim, useDeepSeekFp8))) { } void Runner::run(void* permutedHiddenState, void* permutedHiddenStateScale, void* weights, void* weightsScale, float* outputScalesScalar, void* output, void* outputScale, int32_t topK, int32_t hiddenSize, int32_t intermediateSize, int32_t numExperts, int32_t numTokens, int32_t* ptrNumNonExitingCtas, int32_t* ptrTotalNumPaddedTokens, int32_t* ptrCtaIdxXyToBatchIdx, int32_t* ptrCtaIdxXyToMnLimit, void* bmm2Workspace, int device, cudaStream_t stream) { auto maxNumCtasInBatchDim = Routing::getMaxNumCtasInBatchDim(numTokens, topK, numExperts, mTileTokensDim); mRunner.run(numTokens, hiddenSize, intermediateSize, {}, numTokens, numExperts, maxNumCtasInBatchDim, permutedHiddenState, permutedHiddenStateScale, weights, weightsScale, /* perTokensSfA */ nullptr, /* perTokensSfB */ nullptr, outputScalesScalar, /* outputScalesGateScalar */ nullptr, output, outputScale, /* permutedIdxToTokenIdx */ nullptr, ptrTotalNumPaddedTokens, ptrCtaIdxXyToBatchIdx, ptrCtaIdxXyToMnLimit, ptrNumNonExitingCtas, bmm2Workspace, stream, device); } size_t Runner::getWorkspaceSizeInBytes( int32_t topK, int32_t hiddenSize, int32_t intermediateSize, int32_t numExperts, int32_t numTokens) { auto maxNumCtasInBatchDim = Routing::getMaxNumCtasInBatchDim(numTokens, topK, numExperts, mTileTokensDim); return mRunner.getWorkspaceSizeInBytes( numTokens, hiddenSize, intermediateSize, {}, numTokens, numExperts, maxNumCtasInBatchDim); } } // namespace Gemm2 namespace MoE { Runner::Runner(btg::Dtype dtypeElt, bool useDeepSeekFp8, int32_t tileTokensDim) : mPermuteGemm1(PermuteGemm1::Runner(dtypeElt, useDeepSeekFp8, tileTokensDim)) , mGemm2(Gemm2::Runner(dtypeElt, btg::Dtype::Bfloat16, useDeepSeekFp8, tileTokensDim)) { } void Runner::setOpsData(MoERunnerArgs const& args, MoEWorkspace const& workspace, moe::dev::convertsf::Data& convertSfData, moe::dev::activation::Data& activationData, moe::dev::finalize::Data& finalizeData) { // Setup sf conversion data if needed convertSfData.inSfPtr = args.hidden_states_scale; convertSfData.outSfPtr = workspace.hidden_states_scale_linear; convertSfData.hiddenDimSf = args.hidden_size / 16; convertSfData.numTokens = args.num_tokens; convertSfData.sfLayoutSrc = btg::SfLayout::R128c4; convertSfData.sfLayoutDst = btg::SfLayout::Linear; convertSfData.mUsePdl = true; // Setup activation data activationData.mDtypeElt = args.mDtypeElt; activationData.mUsePdl = true; activationData.mUseDeepSeekFp8 = true; activationData.inPtr = workspace.gemm1_output; activationData.outPtr = workspace.activation_output; activationData.inDqSfsPtr = workspace.gemm1_output_scale; activationData.outDqSfsPtr = workspace.activation_output_scale; activationData.innerDim = args.intermediate_size * 2; activationData.topK = args.top_k; activationData.numTokens = args.num_tokens; activationData.expandedIdxToPermutedIdx = workspace.expanded_idx_to_permuted_idx; activationData.totalNumPaddedTokens = workspace.total_num_padded_tokens; if (args.do_finalize) { // Setup finalize data finalizeData.mDtypeElt = args.mDtypeOut; finalizeData.mDtypeExpW = args.mDtypeExpW; finalizeData.mUsePdl = true; finalizeData.mUseDeepSeekFp8 = false; finalizeData.inPtr = workspace.gemm2_output; finalizeData.outPtr = args.output; finalizeData.inDqSfsPtr = workspace.gemm2_output_scale; finalizeData.outDqSfsPtr = args.output_scale; if (args.mUseRoutingScalesOnInput) { finalizeData.expertWeightsPtr = nullptr; } else { finalizeData.expertWeightsPtr = workspace.expert_weights; } finalizeData.expandedIdxToPermutedIdx = workspace.expanded_idx_to_permuted_idx; finalizeData.numTokens = args.num_tokens; finalizeData.numExperts = args.num_experts; finalizeData.topK = args.top_k; finalizeData.hiddenDim = args.hidden_size; finalizeData.totalNumPaddedTokens = workspace.total_num_padded_tokens; } } std::tuple Runner::getWorkspaceSizeInBytes(MoERunnerArgs const& args) { auto workspace_size_fc1 = static_cast(mPermuteGemm1.getWorkspaceSizeInBytes( args.top_k, args.hidden_size, args.intermediate_size, args.local_num_experts, args.num_tokens)); auto workspace_size_fc2 = static_cast(mGemm2.getWorkspaceSizeInBytes( args.top_k, args.hidden_size, args.intermediate_size, args.local_num_experts, args.num_tokens)); return std::make_tuple(workspace_size_fc1, workspace_size_fc2); } void Runner::run(MoERunnerArgs const& args, MoEWorkspace const& workspace, int device, cudaStream_t stream) { // Setup all operation data moe::dev::activation::Data activationData; moe::dev::finalize::Data finalizeData; moe::dev::convertsf::Data convertSfData; sync_check_cuda_error(stream); setOpsData(args, workspace, convertSfData, activationData, finalizeData); void* hidden_states_scale_linear{args.hidden_states_scale}; mPermuteGemm1.run(args.hidden_states, hidden_states_scale_linear, args.gemm1_weights, args.gemm1_weights_scale, workspace.expert_weights, args.output1_scales_scalar, args.output1_scales_gate_scalar, workspace.gemm1_output, workspace.gemm1_output_scale, args.top_k, args.hidden_size, args.intermediate_size, args.local_num_experts, args.num_tokens, workspace.permuted_idx_to_token_idx, workspace.num_non_exiting_ctas, workspace.total_num_padded_tokens, workspace.cta_idx_xy_to_batch_idx, workspace.cta_idx_xy_to_mn_limit, workspace.bmm1_workspace, args.mUseRoutingScalesOnInput, device, stream); // We do not fuse activation with FC1 for DeepSeek FP8 due to the weights shuffling constraint. void* gemm2_input = workspace.gemm1_output; void* gemm2_input_scale = workspace.gemm1_output_scale; // We do activation only for DeepSeek FP8, as cubins do not have fused activation. if (args.mDtypeElt == btg::Dtype::E4m3 && args.mUseDeepSeekFp8) { // Run activation moe::dev::activation::run(activationData, stream); gemm2_input = workspace.activation_output; gemm2_input_scale = workspace.activation_output_scale; } // Run gemm2 mGemm2.run(gemm2_input, gemm2_input_scale, args.gemm2_weights, args.gemm2_weights_scale, args.output2_scales_scalar, workspace.gemm2_output, workspace.gemm2_output_scale, args.top_k, args.hidden_size, args.intermediate_size, args.local_num_experts, args.num_tokens, workspace.num_non_exiting_ctas, workspace.total_num_padded_tokens, workspace.cta_idx_xy_to_batch_idx, workspace.cta_idx_xy_to_mn_limit, workspace.bmm2_workspace, device, stream); // Run finalize if (args.do_finalize) { // Run finalize moe::dev::finalize::run(finalizeData, stream); sync_check_cuda_error(stream); } } } // namespace MoE } // namespace trtllmGenFp8BlockScaleMoe } // namespace kernels } // namespace tensorrt_llm