/*! * \file tl/op/gemm.h * \brief Define gemm operator. * */ #ifndef TVM_TL_OP_GEMM_H_ #define TVM_TL_OP_GEMM_H_ #include "operator.h" namespace tvm { namespace tl { using namespace tir; enum class GemmWarpPolicyType : uint8_t { kSquare = 0, kFullRow = 1, kFullCol = 2, kFree = 3, }; // Target GEMM instruction enum class GemmInst : uint8_t { kMMA, kWGMMA, kTCGEN5MMA, kMFMA }; class GemmWarpPolicyNode : public Object { public: mutable int m_warp{0}; mutable int n_warp{0}; int policy_type; TVM_FFI_DECLARE_OBJECT_INFO("tl.GemmWarpPolicy", GemmWarpPolicyNode, Object); static void RegisterReflection() { namespace refl = tvm::ffi::reflection; refl::ObjectDef() .def_ro("policy_type", &GemmWarpPolicyNode::policy_type) .def_ro("m_warp", &GemmWarpPolicyNode::m_warp) .def_ro("n_warp", &GemmWarpPolicyNode::n_warp); } std::pair ComputeWarpPartition(int M, int N, int block_size, Target target, GemmInst gemm_inst) const; bool isSquare() const { return policy_type == int(GemmWarpPolicyType::kSquare); } bool isFullRow() const { return policy_type == int(GemmWarpPolicyType::kFullRow); } bool isFullCol() const { return policy_type == int(GemmWarpPolicyType::kFullCol); } bool isFree() const { return policy_type == int(GemmWarpPolicyType::kFree); } }; class GemmWarpPolicy : public ObjectRef { public: TVM_FFI_DEFINE_OBJECT_REF_METHODS_NULLABLE(GemmWarpPolicy, ObjectRef, GemmWarpPolicyNode); explicit GemmWarpPolicy(GemmWarpPolicyType policy_type) { auto node = tvm::ffi::make_object(); node->policy_type = (int)policy_type; data_ = std::move(node); } explicit GemmWarpPolicy(int policy_type) { auto node = tvm::ffi::make_object(); node->policy_type = policy_type; data_ = std::move(node); } explicit GemmWarpPolicy(int m_warp, int n_warp) { auto node = tvm::ffi::make_object(); node->m_warp = m_warp; node->n_warp = n_warp; node->policy_type = (int)GemmWarpPolicyType::kFree; data_ = std::move(node); } }; class GemmNode : public TileOperatorNode { public: bool CheckWGMMA() const; tir::Buffer A, B, C; // pointer to the A, B, C PrimExpr Aptr, Bptr, Cptr; bool trans_A, trans_B; int M, N, K; int stride_A, stride_B; int offset_A, offset_B; PrimExpr clear_accum = const_false(); // k_pack please ref to bitblas/tl/mfma_macro_generator.py::k_pack // only will be enabled under cdna mfma instructions int kPack = 1; int wg_wait = 0; PrimExpr mbarptr; std::optional mbar; // mbar is optional, only used for TCGEN5MMA Array C_coords; mutable GemmWarpPolicy policy; TVM_FFI_DECLARE_OBJECT_INFO_FINAL("tl.Gemm", GemmNode, TileOperatorNode); static void RegisterReflection() { namespace refl = tvm::ffi::reflection; refl::ObjectDef() .def_ro("A", &GemmNode::A) .def_ro("B", &GemmNode::B) .def_ro("C", &GemmNode::C) .def_ro("Aptr", &GemmNode::Aptr) .def_ro("Bptr", &GemmNode::Bptr) .def_ro("Cptr", &GemmNode::Cptr) .def_ro("trans_A", &GemmNode::trans_A) .def_ro("trans_B", &GemmNode::trans_B) .def_ro("M", &GemmNode::M) .def_ro("N", &GemmNode::N) .def_ro("K", &GemmNode::K) .def_ro("stride_A", &GemmNode::stride_A) .def_ro("stride_B", &GemmNode::stride_B) .def_ro("offset_A", &GemmNode::offset_A) .def_ro("offset_B", &GemmNode::offset_B) .def_ro("clear_accum", &GemmNode::clear_accum) .def_ro("kPack", &GemmNode::kPack) .def_ro("wg_wait", &GemmNode::wg_wait) .def_ro("policy", &GemmNode::policy); } Stmt Lower(const LowerArgs &T, arith::Analyzer *analyzer) const override; LayoutMap InferLayout(const LayoutInferArgs &T, InferLevel level) const override; TileOperator Clone() const; private: GemmInst GetGemmInst(int block_size, Target target) const; bool AllowTCGEN5MMA(Target target) const; bool AllowWGMMA(int block_size, Target target) const; mutable bool completed_ = false; }; class Gemm : public TileOperator { public: TVM_FFI_DEFINE_OBJECT_REF_METHODS_NULLABLE(Gemm, TileOperator, GemmNode); TVM_DLL Gemm(Array args, BufferMap vmap); static const Op &Get(); }; } // namespace tl } // namespace tvm #endif // TVM_TL_OP_GEMM_H_