SpecializeOption.cpp

Go to the documentation of this file.

//===- SpecializeOption.cpp -------------------------------------*- C++ -*-===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
 
#include "PassDetails.h"
#include "mlir/IR/ImplicitLocOpBuilder.h"
#include "mlir/IR/Threading.h"
 
using namespace mlir;
using namespace circt;
using namespace firrtl;
 
namespace {
struct SpecializeOptionPass
    : public SpecializeOptionBase<SpecializeOptionPass> {
  using SpecializeOptionBase::numInstances;
  using SpecializeOptionBase::select;
 
  void runOnOperation() override {
    auto circuit = getOperation();
    if (select.empty()) {
      markAllAnalysesPreserved();
      return;
    }
 
    DenseMap<StringAttr, OptionCaseOp> selected;
    for (const auto &optionAndCase : select) {
      size_t eq = optionAndCase.find("=");
      if (eq == std::string::npos) {
        mlir::emitError(circuit.getLoc(),
                        "invalid option format: \"" + optionAndCase + '"');
        return signalPassFailure();
      }
 
      std::string optionName = optionAndCase.substr(0, eq);
      auto optionOp = circuit.lookupSymbol<OptionOp>(optionName);
      if (!optionOp) {
        mlir::emitWarning(circuit.getLoc(), "unknown option \"")
            << optionName << '"';
        continue;
      }
 
      std::string caseName = optionAndCase.substr(eq + 1);
      auto caseOp = optionOp.lookupSymbol<OptionCaseOp>(caseName);
      if (!caseOp) {
        mlir::emitWarning(circuit.getLoc(), "invalid option case \"")
            << caseName << '"';
        continue;
      }
      selected[StringAttr::get(&getContext(), optionName)] = caseOp;
    }
 
    bool failed = false;
    mlir::parallelForEach(
        &getContext(), circuit.getOps<FModuleOp>(), [&](auto module) {
          module.walk([&](firrtl::InstanceChoiceOp inst) {
            auto it = selected.find(inst.getOptionNameAttr());
            if (it == selected.end()) {
              inst.emitError("missing specialization for option ")
                  << inst.getOptionNameAttr();
              failed = true;
              return;
            }
 
            ImplicitLocOpBuilder builder(inst.getLoc(), inst);
            auto newInst = builder.create<InstanceOp>(
                inst->getResultTypes(), inst.getTargetOrDefaultAttr(it->second),
                inst.getNameAttr(), inst.getNameKindAttr(),
                inst.getPortDirectionsAttr(), inst.getPortNamesAttr(),
                inst.getAnnotationsAttr(), inst.getPortAnnotationsAttr(),
                builder.getArrayAttr({}), UnitAttr{}, inst.getInnerSymAttr());
            inst.replaceAllUsesWith(newInst);
            inst.erase();
 
            ++numInstances;
          });
        });
 
    if (failed)
      signalPassFailure();
  }
};
} // namespace
 
std::unique_ptr<Pass> firrtl::createSpecializeOptionPass() {
  return std::make_unique<SpecializeOptionPass>();
}