instruction.h

Go to the documentation of this file.

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you 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.
 */
#ifndef TVM_S_TIR_SCHEDULE_INSTRUCTION_H_
#define TVM_S_TIR_SCHEDULE_INSTRUCTION_H_
 
#include <tvm/ffi/reflection/registry.h>
#include <tvm/ir/prim/expr.h>
 
#include <utility>
 
namespace tvm {
 
namespace s_tir {
 
// Forward declaration
class Schedule;
 
using FInstructionApply =
    ffi::TypedFunction<ffi::Array<Any>(Schedule sch, const ffi::Array<Any>& inputs,
                                       const ffi::Array<Any>& attrs, const Any& decision)>;
 
using FInstructionAsPython =
    ffi::TypedFunction<ffi::String(const ffi::Array<Any>& inputs, const ffi::Array<Any>& attrs,
                                   const Any& decision, const ffi::Array<ffi::String>& outputs)>;
 
using FInstructionAttrsAsJSON = ffi::TypedFunction<ffi::ObjectRef(ffi::Array<Any> attrs)>;
 
using FInstructionAttrsFromJSON = ffi::TypedFunction<ffi::Array<Any>(ffi::ObjectRef json_attrs)>;
 
class InstructionKindObj : public ffi::Object {
 public:
  ffi::String name;
  bool is_pure{false};
  FInstructionApply f_apply_to_schedule{nullptr};
  FInstructionAsPython f_as_python{nullptr};
  FInstructionAttrsAsJSON f_attrs_as_json{nullptr};
  FInstructionAttrsFromJSON f_attrs_from_json{nullptr};
 
  static void RegisterReflection() {
    namespace refl = tvm::ffi::reflection;
    refl::ObjectDef<InstructionKindObj>()
        .def_ro("name", &InstructionKindObj::name)
        .def_ro("_is_pure", &InstructionKindObj::is_pure);
  }
 
  bool IsPostproc() const;
  TVM_FFI_DECLARE_OBJECT_INFO_FINAL("s_tir.InstructionKind", InstructionKindObj, ffi::Object);
};
 
class InstructionKind : public ffi::ObjectRef {
 public:
  explicit InstructionKind(ffi::UnsafeInit tag, ffi::ObjectPtr<InstructionKindObj> data)
      : ffi::ObjectRef(tag) {
    data_ = std::move(data);
  }
 
  static InstructionKind Get(const ffi::String& name);
  TVM_FFI_DEFINE_OBJECT_REF_METHODS_NOTNULLABLE(InstructionKind, ffi::ObjectRef,
                                                InstructionKindObj);
};
 
class InstructionNode : public ffi::Object {
 public:
  explicit InstructionNode(ffi::UnsafeInit tag) : kind(tag) {}
 
  explicit InstructionNode(InstructionKind kind) : kind(std::move(kind)) {}
  InstructionKind kind;
  ffi::Array<Any> inputs;
  ffi::Array<Any> attrs;
  ffi::Array<Any> outputs;
 
  static void RegisterReflection() {
    namespace refl = tvm::ffi::reflection;
    refl::ObjectDef<InstructionNode>()
        .def_ro("kind", &InstructionNode::kind)
        .def_ro("inputs", &InstructionNode::inputs)
        .def_ro("attrs", &InstructionNode::attrs)
        .def_ro("outputs", &InstructionNode::outputs);
  }
  TVM_FFI_DECLARE_OBJECT_INFO_FINAL("s_tir.Instruction", InstructionNode, ffi::Object);
};
 
class Instruction : public ffi::ObjectRef {
 public:
  explicit Instruction(InstructionKind kind, ffi::Array<Any> inputs, ffi::Array<Any> attrs,
                       ffi::Array<Any> outputs);
 
  TVM_FFI_DEFINE_OBJECT_REF_METHODS_NOTNULLABLE(Instruction, ffi::ObjectRef, InstructionNode);
};
 
class InstructionKindDef {
 public:
  explicit InstructionKindDef(const ffi::String& name);
 
  InstructionKindDef& set_is_pure(bool is_pure) {
    get_mutable()->is_pure = is_pure;
    return *this;
  }
 
  InstructionKindDef& set_apply_to_schedule(FInstructionApply f_apply_to_schedule) {
    get_mutable()->f_apply_to_schedule = std::move(f_apply_to_schedule);
    return *this;
  }
 
  InstructionKindDef& set_as_python(FInstructionAsPython f_as_python) {
    get_mutable()->f_as_python = std::move(f_as_python);
    return *this;
  }
 
  InstructionKindDef& set_attrs_as_json(FInstructionAttrsAsJSON f_attrs_as_json) {
    get_mutable()->f_attrs_as_json = std::move(f_attrs_as_json);
    return *this;
  }
 
  InstructionKindDef& set_attrs_from_json(FInstructionAttrsFromJSON f_attrs_from_json) {
    get_mutable()->f_attrs_from_json = std::move(f_attrs_from_json);
    return *this;
  }
 
 private:
  InstructionKindObj* get_mutable() const {
    return const_cast<InstructionKindObj*>(inst_kind_.get());
  }
 
  InstructionKind inst_kind_;
};
 
}  // namespace s_tir
}  // namespace tvm
 
#endif  //  TVM_S_TIR_SCHEDULE_INSTRUCTION_H_