636 lines
32 KiB
C++
636 lines
32 KiB
C++
// -*- mode: C++; c-file-style: "cc-mode" -*-
|
|
//*************************************************************************
|
|
// DESCRIPTION: Verilator: Resolve module/signal name references
|
|
//
|
|
// Code available from: https://verilator.org
|
|
//
|
|
//*************************************************************************
|
|
//
|
|
// Copyright 2003-2025 by Wilson Snyder. This program is free software; you
|
|
// can redistribute it and/or modify it under the terms of either the GNU
|
|
// Lesser General Public License Version 3 or the Perl Artistic License
|
|
// Version 2.0.
|
|
// SPDX-License-Identifier: LGPL-3.0-only OR Artistic-2.0
|
|
//
|
|
//*************************************************************************
|
|
// NO EDITS: Don't replace or delete nodes, as the parser symbol table
|
|
// has pointers into the ast tree.
|
|
//
|
|
// LINK TRANSFORMATIONS:
|
|
// Top-down traversal
|
|
// Cells:
|
|
// Read module if needed
|
|
// Link to module that instantiates it
|
|
//*************************************************************************
|
|
|
|
#include "V3PchAstNoMT.h" // VL_MT_DISABLED_CODE_UNIT
|
|
|
|
#include "V3LinkCells.h"
|
|
|
|
#include "V3Graph.h"
|
|
#include "V3Parse.h"
|
|
#include "V3SymTable.h"
|
|
|
|
#include <unordered_set>
|
|
#include <vector>
|
|
|
|
VL_DEFINE_DEBUG_FUNCTIONS;
|
|
|
|
//######################################################################
|
|
// Graph subclasses
|
|
|
|
class LinkCellsGraph final : public V3Graph {
|
|
public:
|
|
LinkCellsGraph() = default;
|
|
~LinkCellsGraph() override = default;
|
|
void loopsMessageCb(V3GraphVertex* vertexp, V3EdgeFuncP edgeFuncp) override;
|
|
};
|
|
|
|
class LinkCellsVertex final : public V3GraphVertex {
|
|
VL_RTTI_IMPL(LinkCellsVertex, V3GraphVertex)
|
|
AstNodeModule* const m_modp;
|
|
|
|
public:
|
|
LinkCellsVertex(V3Graph* graphp, AstNodeModule* modp)
|
|
: V3GraphVertex{graphp}
|
|
, m_modp{modp} {}
|
|
~LinkCellsVertex() override = default;
|
|
AstNodeModule* modp() const VL_MT_STABLE { return m_modp; }
|
|
string name() const override VL_MT_STABLE { return cvtToHex(modp()) + ' ' + modp()->name(); }
|
|
FileLine* fileline() const override { return modp()->fileline(); }
|
|
// Recursive modules get space for maximum recursion
|
|
uint32_t rankAdder() const override {
|
|
return m_modp->recursiveClone() ? (1 + v3Global.opt.moduleRecursionDepth()) : 1;
|
|
}
|
|
};
|
|
|
|
class LibraryVertex final : public V3GraphVertex {
|
|
VL_RTTI_IMPL(LibraryVertex, V3GraphVertex)
|
|
public:
|
|
explicit LibraryVertex(V3Graph* graphp)
|
|
: V3GraphVertex{graphp} {}
|
|
~LibraryVertex() override = default;
|
|
string name() const override VL_MT_STABLE { return "*LIBRARY*"; }
|
|
};
|
|
|
|
void LinkCellsGraph::loopsMessageCb(V3GraphVertex* vertexp, V3EdgeFuncP edgeFuncp) {
|
|
if (const LinkCellsVertex* const vvertexp = vertexp->cast<LinkCellsVertex>()) {
|
|
vvertexp->modp()->v3warn(E_UNSUPPORTED,
|
|
"Unsupported: Recursive multiple modules (module instantiates "
|
|
"something leading back to itself): "
|
|
<< vvertexp->modp()->prettyNameQ() << '\n'
|
|
<< vvertexp->modp()->warnMore()
|
|
<< "... note: self-recursion (module instantiating itself "
|
|
"directly) is supported.");
|
|
V3Error::abortIfErrors();
|
|
} else { // Everything should match above, but...
|
|
v3fatalSrc("Recursive instantiations");
|
|
}
|
|
}
|
|
|
|
//######################################################################
|
|
// Link state, as a visitor of each AstNode
|
|
|
|
class LinkCellsVisitor final : public VNVisitor {
|
|
// NODE STATE
|
|
// Entire netlist:
|
|
// AstNodeModule::user1p() // V3GraphVertex* Vertex describing this module
|
|
// AstNodeModule::user2p() // AstNodeModule* clone used for de-recursing
|
|
// AstCell::user1p() // ==V3NodeModule* if done, != if unprocessed
|
|
// AstCell::user2() // bool clone renaming completed
|
|
// Allocated across all readFiles in V3Global::readFiles:
|
|
// AstNode::user4p() // VSymEnt* Package and typedef symbol names
|
|
const VNUser1InUse m_inuser1;
|
|
const VNUser2InUse m_inuser2;
|
|
|
|
// STATE
|
|
VInFilter* const m_filterp; // Parser filter
|
|
|
|
// Below state needs to be preserved between each module call.
|
|
AstNodeModule* m_modp = nullptr; // Current module
|
|
AstVar* m_varp = nullptr; // Current variable
|
|
VSymGraph m_mods; // Symbol table of all module names
|
|
LinkCellsGraph m_graph; // Linked graph of all cell interconnects
|
|
LibraryVertex* m_libVertexp = nullptr; // Vertex at root of all libraries
|
|
int m_dedupNum = 0; // Package dedup number
|
|
const V3GraphVertex* m_topVertexp = nullptr; // Vertex of top module
|
|
std::unordered_set<string> m_declfnWarned; // Files we issued DECLFILENAME on
|
|
string m_origTopModuleName; // original name of the top module
|
|
|
|
// METHODS
|
|
V3GraphVertex* vertex(AstNodeModule* nodep) {
|
|
// Return corresponding vertex for this module
|
|
if (!nodep->user1p()) nodep->user1p(new LinkCellsVertex{&m_graph, nodep});
|
|
return nodep->user1u().toGraphVertex();
|
|
}
|
|
void newEdge(V3GraphVertex* fromp, V3GraphVertex* top, int weight, bool cuttable) {
|
|
const V3GraphEdge* const edgep = new V3GraphEdge{&m_graph, fromp, top, weight, cuttable};
|
|
UINFO(9, " newEdge " << edgep << " " << fromp->name() << " -> " << top->name());
|
|
}
|
|
|
|
AstNodeModule* findModuleSym(const string& modName) {
|
|
const VSymEnt* const foundp = m_mods.rootp()->findIdFallback(modName);
|
|
return foundp ? VN_AS(foundp->nodep(), NodeModule) : nullptr;
|
|
}
|
|
|
|
AstNodeModule* resolveModule(AstNode* nodep, const string& modName) {
|
|
AstNodeModule* modp = findModuleSym(modName);
|
|
if (!modp) {
|
|
// Read-subfile
|
|
// If file not found, make AstNotFoundModule, rather than error out.
|
|
// We'll throw the error when we know the module will really be needed.
|
|
const string prettyName = AstNode::prettyName(modName);
|
|
V3Parse parser{v3Global.rootp(), m_filterp};
|
|
// true below -> other simulators treat modules in link-found files as library cells
|
|
parser.parseFile(nodep->fileline(), prettyName, true, "");
|
|
V3Error::abortIfErrors();
|
|
// We've read new modules, grab new pointers to their names
|
|
readModNames();
|
|
// Check again
|
|
modp = findModuleSym(modName);
|
|
if (!modp) {
|
|
// This shouldn't throw a message as parseFile will create
|
|
// a AstNotFoundModule for us
|
|
nodep->v3error("Can't resolve module reference: '" << prettyName << "'");
|
|
}
|
|
}
|
|
return modp;
|
|
}
|
|
|
|
// VISITORS
|
|
void visit(AstNetlist* nodep) override {
|
|
readModNames();
|
|
iterateChildren(nodep);
|
|
// Find levels in graph
|
|
m_graph.removeRedundantEdgesMax(&V3GraphEdge::followAlwaysTrue);
|
|
if (dumpGraphLevel()) m_graph.dumpDotFilePrefixed("linkcells");
|
|
m_graph.rank();
|
|
for (V3GraphVertex& vtx : m_graph.vertices()) {
|
|
if (const LinkCellsVertex* const vvertexp = vtx.cast<LinkCellsVertex>()) {
|
|
// +1 so we leave level 1 for the new wrapper we'll make in a moment
|
|
AstNodeModule* const modp = vvertexp->modp();
|
|
modp->level(vvertexp->rank() + 1);
|
|
}
|
|
}
|
|
if (v3Global.opt.topModule() != "" && !m_topVertexp) {
|
|
v3error("Specified --top-module '" << v3Global.opt.topModule()
|
|
<< "' was not found in design.");
|
|
}
|
|
}
|
|
void visit(AstConstPool* nodep) override {}
|
|
void visit(AstNodeModule* nodep) override {
|
|
// Module: Pick up modnames, so we can resolve cells later
|
|
VL_RESTORER(m_modp);
|
|
{
|
|
// For nested modules/classes, child below parent
|
|
if (m_modp) newEdge(vertex(m_modp), vertex(nodep), 1, false);
|
|
//
|
|
m_modp = nodep;
|
|
UINFO(4, "Link Module: " << nodep);
|
|
if (nodep->fileline()->filebasenameNoExt() != nodep->prettyName()
|
|
&& !v3Global.opt.isLibraryFile(nodep->fileline()->filename())
|
|
&& !VN_IS(nodep, NotFoundModule) && !nodep->recursiveClone()
|
|
&& !nodep->internal()) {
|
|
// We only complain once per file, otherwise library-like files
|
|
// have a huge mess of warnings
|
|
const auto itFoundPair = m_declfnWarned.insert(nodep->fileline()->filename());
|
|
if (itFoundPair.second) {
|
|
nodep->v3warn(DECLFILENAME, "Filename '"
|
|
<< nodep->fileline()->filebasenameNoExt()
|
|
<< "' does not match " << nodep->typeName()
|
|
<< " name: " << nodep->prettyNameQ());
|
|
}
|
|
}
|
|
if (VN_IS(nodep, Iface) || VN_IS(nodep, Package)) {
|
|
nodep->inLibrary(true); // Interfaces can't be at top, unless asked
|
|
}
|
|
const bool topMatch = (v3Global.opt.topModule() == nodep->prettyName());
|
|
if (topMatch) {
|
|
m_topVertexp = vertex(nodep);
|
|
UINFO(2, "Link --top-module: " << nodep);
|
|
nodep->inLibrary(false); // Safer to make sure it doesn't disappear
|
|
}
|
|
if (v3Global.opt.topModule() == "" ? nodep->inLibrary() // Library cells are lower
|
|
: !topMatch) { // Any non-specified module is lower
|
|
// Put under a fake vertex so that the graph ranking won't indicate
|
|
// this is a top level module
|
|
if (!m_libVertexp) m_libVertexp = new LibraryVertex{&m_graph};
|
|
newEdge(m_libVertexp, vertex(nodep), 1, false);
|
|
}
|
|
// Note AstBind also has iteration on cells
|
|
iterateChildren(nodep);
|
|
nodep->checkTree();
|
|
}
|
|
}
|
|
|
|
void visit(AstIfaceRefDType* nodep) override {
|
|
// Cell: Resolve its filename. If necessary, parse it.
|
|
UINFO(4, "Link IfaceRef: " << nodep);
|
|
// Use findIdUpward instead of findIdFlat; it doesn't matter for now
|
|
// but we might support modules-under-modules someday.
|
|
AstNodeModule* const modp = resolveModule(nodep, nodep->ifaceName());
|
|
if (modp) {
|
|
if (VN_IS(modp, Iface)) {
|
|
// Track module depths, so can sort list from parent down to children
|
|
if (!nodep->isVirtual()) newEdge(vertex(m_modp), vertex(modp), 1, false);
|
|
if (!nodep->cellp()) nodep->ifacep(VN_AS(modp, Iface));
|
|
} else if (VN_IS(modp, NotFoundModule)) { // Will error out later
|
|
} else {
|
|
nodep->v3error("Non-interface used as an interface: "
|
|
<< nodep->ifaceNameQ() << "\n"
|
|
<< nodep->warnMore()
|
|
+ "... Perhaps intended an instantiation but "
|
|
"are missing parenthesis (IEEE 1800-2023 23.3.2)?");
|
|
}
|
|
}
|
|
iterateChildren(nodep);
|
|
for (AstPin* pinp = nodep->paramsp(); pinp; pinp = VN_AS(pinp->nextp(), Pin)) {
|
|
pinp->param(true);
|
|
if (pinp->name() == "") pinp->name("__paramNumber" + cvtToStr(pinp->pinNum()));
|
|
}
|
|
// Parser didn't know what was interface, resolve now
|
|
// For historical reasons virtual interface reference variables remain VARs
|
|
if (m_varp && !nodep->isVirtual()) m_varp->setIfaceRef();
|
|
// Note cannot do modport resolution here; modports are allowed underneath generates
|
|
UINFO(4, "Link IfaceRef done: " << nodep);
|
|
}
|
|
|
|
void visit(AstPackageExport* nodep) override {
|
|
// Package Import: We need to do the package before the use of a package
|
|
iterateChildren(nodep);
|
|
if (!nodep->packagep()) {
|
|
AstNodeModule* const modp = resolveModule(nodep, nodep->pkgName());
|
|
if (AstPackage* const pkgp = VN_CAST(modp, Package)) nodep->packagep(pkgp);
|
|
if (!nodep->packagep()) {
|
|
nodep->v3error("Export package not found: " << nodep->prettyPkgNameQ());
|
|
return;
|
|
}
|
|
}
|
|
}
|
|
void visit(AstPackageImport* nodep) override {
|
|
// Package Import: We need to do the package before the use of a package
|
|
iterateChildren(nodep);
|
|
if (!nodep->packagep()) {
|
|
AstNodeModule* const modp = resolveModule(nodep, nodep->pkgName());
|
|
if (AstPackage* const pkgp = VN_CAST(modp, Package)) nodep->packagep(pkgp);
|
|
// If not found, V3LinkDot will report errors
|
|
if (!nodep->packagep()) {
|
|
nodep->v3error("Import package not found: " << nodep->prettyPkgNameQ());
|
|
return;
|
|
}
|
|
}
|
|
newEdge(vertex(m_modp), vertex(nodep->packagep()), 1, false);
|
|
}
|
|
|
|
void visit(AstBind* nodep) override {
|
|
// Bind: Has cells underneath that need to be put into the new
|
|
// module, and cells which need resolution
|
|
// TODO this doesn't allow bind to dotted hier names, that would require
|
|
// this move to post param, which would mean we do not auto-read modules
|
|
// and means we cannot compute module levels until later.
|
|
UINFO(4, "Link Bind: " << nodep);
|
|
AstNodeModule* const modp = resolveModule(nodep, nodep->name());
|
|
if (modp) {
|
|
AstNode* const cellsp = nodep->cellsp()->unlinkFrBackWithNext();
|
|
// Module may have already linked, so need to pick up these new cells
|
|
VL_RESTORER(m_modp);
|
|
m_modp = modp;
|
|
// Important that this adds to end, as next iterate assumes does all cells
|
|
modp->addStmtsp(cellsp);
|
|
iterateAndNextNull(cellsp);
|
|
}
|
|
VL_DO_DANGLING(pushDeletep(nodep->unlinkFrBack()), nodep);
|
|
}
|
|
|
|
void visit(AstCell* nodep) override {
|
|
// Cell: Resolve its filename. If necessary, parse it.
|
|
// Execute only once. Complication is that cloning may result in
|
|
// user1 being set (for pre-clone) so check if user1() matches the
|
|
// m_mod, if 0 never did it, if !=, it is an unprocessed clone
|
|
const bool cloned = (nodep->user1p() && nodep->user1p() != m_modp);
|
|
if (nodep->user1p() == m_modp) return; // AstBind and AstNodeModule may call a cell twice
|
|
if (nodep->modName() == m_origTopModuleName) {
|
|
if (v3Global.opt.hierChild() && nodep->modName() == m_modp->origName()) {
|
|
// Only the root of the recursive instantiation can be a hierarchical block.
|
|
nodep->modName(m_modp->name());
|
|
} else {
|
|
// non-top module will be the top module of this run
|
|
VL_DO_DANGLING(pushDeletep(nodep->unlinkFrBack()), nodep);
|
|
return;
|
|
}
|
|
}
|
|
nodep->user1p(m_modp);
|
|
//
|
|
if (!nodep->modp() || cloned) {
|
|
UINFO(4, "Link Cell: " << nodep);
|
|
// Use findIdFallback instead of findIdFlat; it doesn't matter for now
|
|
// but we might support modules-under-modules someday.
|
|
AstNodeModule* cellmodp = resolveModule(nodep, nodep->modName());
|
|
if (cellmodp) {
|
|
if (cellmodp == m_modp || cellmodp->user2p() == m_modp) {
|
|
UINFO(1, "Self-recursive module " << cellmodp);
|
|
cellmodp->recursive(true);
|
|
nodep->recursive(true);
|
|
if (!cellmodp->recursiveClone()) {
|
|
// In the non-Vrcm, which needs to point to Vrcm flavor
|
|
//
|
|
// Make a clone which this cell points to
|
|
// Later, the clone's cells will also point clone'd name
|
|
// This lets us link the XREFs between the (uncloned) children so
|
|
// they don't point to the same module which would
|
|
// break parameter resolution.
|
|
AstNodeModule* otherModp = VN_CAST(cellmodp->user2p(), NodeModule);
|
|
if (!otherModp) {
|
|
otherModp = cellmodp->cloneTree(false);
|
|
otherModp->name(otherModp->name() + "__Vrcm");
|
|
otherModp->user1p(nullptr); // Need new vertex
|
|
otherModp->user2p(cellmodp);
|
|
otherModp->recursiveClone(true);
|
|
// user1 etc will retain its pre-clone value
|
|
cellmodp->user2p(otherModp);
|
|
v3Global.rootp()->addModulesp(otherModp);
|
|
newEdge(vertex(cellmodp), vertex(otherModp), 1, false);
|
|
}
|
|
cellmodp = otherModp;
|
|
nodep->modp(cellmodp);
|
|
} else {
|
|
// In the Vrcm, which needs to point back to Vrcm flavor
|
|
// The cell already has the correct resolution (to Vrcm)
|
|
nodep->modp(cellmodp);
|
|
// We don't create a V3GraphEdge (as it would be circular)
|
|
}
|
|
} else { // Non-recursive
|
|
// Track module depths, so can sort list from parent down to children
|
|
nodep->modp(cellmodp);
|
|
newEdge(vertex(m_modp), vertex(cellmodp), 1, false);
|
|
}
|
|
}
|
|
}
|
|
// Remove AstCell(AstPin("",nullptr)), it's a side effect of how we parse "()"
|
|
// the empty middle is identical to the empty rule that must find pins in "(,)".
|
|
if (nodep->pinsp() && !nodep->pinsp()->nextp() && nodep->pinsp()->name() == ""
|
|
&& !nodep->pinsp()->exprp()) {
|
|
pushDeletep(nodep->pinsp()->unlinkFrBackWithNext());
|
|
}
|
|
if (nodep->paramsp() && !nodep->paramsp()->nextp() && nodep->paramsp()->name() == ""
|
|
&& !nodep->paramsp()->exprp()) {
|
|
pushDeletep(nodep->paramsp()->unlinkFrBackWithNext());
|
|
}
|
|
// Convert .* to list of pins
|
|
bool pinStar = false;
|
|
bool pinDotName = false;
|
|
for (AstPin *nextp, *pinp = nodep->pinsp(); pinp; pinp = nextp) {
|
|
nextp = VN_AS(pinp->nextp(), Pin);
|
|
if (pinp->svDotName()) pinDotName = true;
|
|
if (pinp->dotStar()) {
|
|
if (pinStar) pinp->v3error("Duplicate .* in an instance (IEEE 1800-2023 23.3.2)");
|
|
pinStar = true;
|
|
// Done with this fake pin
|
|
VL_DO_DANGLING(pinp->unlinkFrBack()->deleteTree(), pinp);
|
|
}
|
|
}
|
|
// Convert unnamed pins to pin number based assignments
|
|
for (AstPin* pinp = nodep->pinsp(); pinp; pinp = VN_AS(pinp->nextp(), Pin)) {
|
|
if (pinp->name() == "") pinp->name("__pinNumber" + cvtToStr(pinp->pinNum()));
|
|
}
|
|
for (AstPin* pinp = nodep->paramsp(); pinp; pinp = VN_AS(pinp->nextp(), Pin)) {
|
|
pinp->param(true);
|
|
if (pinp->name() == "") pinp->name("__paramNumber" + cvtToStr(pinp->pinNum()));
|
|
}
|
|
if (nodep->modp()) {
|
|
nodep->modName(nodep->modp()->name());
|
|
// Note what pins exist
|
|
std::unordered_set<string> ports; // Symbol table of all connected port names
|
|
for (AstPin* pinp = nodep->pinsp(); pinp; pinp = VN_AS(pinp->nextp(), Pin)) {
|
|
if ((pinStar || pinDotName) && pinp->name().substr(0, 11) == "__pinNumber") {
|
|
pinp->v3error("Mixing positional and .*/named instantiation connection"
|
|
" (IEEE 1800-2023 23.3.2)");
|
|
}
|
|
if (!pinp->exprp()) {
|
|
if (pinp->name().substr(0, 11) == "__pinNumber") {
|
|
pinp->v3warn(PINNOCONNECT,
|
|
"Instance pin is not connected: " << pinp->prettyNameQ());
|
|
} else {
|
|
pinp->v3warn(PINCONNECTEMPTY,
|
|
"Instance pin connected by name with empty reference: "
|
|
<< pinp->prettyNameQ());
|
|
}
|
|
}
|
|
ports.insert(pinp->name());
|
|
}
|
|
// We search ports, rather than in/out declarations as they aren't resolved yet,
|
|
// and it's easier to do it now than in V3LinkDot when we'd need to repeat steps.
|
|
for (AstNode* portnodep = nodep->modp()->stmtsp(); portnodep;
|
|
portnodep = portnodep->nextp()) {
|
|
if (const AstPort* const portp = VN_CAST(portnodep, Port)) {
|
|
|
|
if (ports.find(portp->name()) == ports.end()
|
|
&& ports.find("__pinNumber" + cvtToStr(portp->pinNum())) == ports.end()) {
|
|
if (pinStar) {
|
|
UINFO(9, " need .* PORT " << portp);
|
|
// Create any not already connected
|
|
AstPin* const newp = new AstPin{
|
|
nodep->fileline(), 0, portp->name(),
|
|
new AstParseRef{nodep->fileline(), VParseRefExp::PX_TEXT,
|
|
portp->name(), nullptr, nullptr}};
|
|
newp->svDotName(true);
|
|
newp->svImplicit(true);
|
|
nodep->addPinsp(newp);
|
|
} else { // warn on the CELL that needs it, not the port
|
|
|
|
// We *might* not want to warn on this port, if it happened to be
|
|
// an input with a default value in the module declaration. Our
|
|
// AstPort* (portp) doesn't have that information, but the Module
|
|
// (nodep->modp()) statements do that have information in an AstVar*
|
|
// with the same name() as the port. We'll look for that in-line here,
|
|
// if a port is missing on this instance.
|
|
|
|
// Get the AstVar for this AstPort, if it exists, using this
|
|
// inefficient O(n) lookup to match the port name.
|
|
const AstVar* portp_varp = nullptr;
|
|
for (AstNode* module_stmtsp = nodep->modp()->stmtsp(); module_stmtsp;
|
|
module_stmtsp = module_stmtsp->nextp()) {
|
|
if (const AstVar* const varp = VN_CAST(module_stmtsp, Var)) {
|
|
if (!varp->isParam() && varp->name() == portp->name()) {
|
|
// not a parameter, same name, break, this is our varp
|
|
// (AstVar*)
|
|
portp_varp = varp;
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
// Is the matching Module port: an INPUT, with default value (in
|
|
// valuep):
|
|
if (portp_varp && portp_varp->isInput() && portp_varp->valuep()) {
|
|
// Do not warn
|
|
// Create b/c not already connected, and it does exist.
|
|
AstPin* const newp
|
|
= new AstPin{nodep->fileline(), 0, portp->name(), nullptr};
|
|
nodep->addPinsp(newp);
|
|
} else {
|
|
nodep->v3warn(PINMISSING,
|
|
"Instance has missing pin: "
|
|
<< portp->prettyNameQ() << '\n'
|
|
<< nodep->warnContextPrimary() << '\n'
|
|
<< portp->warnOther()
|
|
<< "... Location of port declaration\n"
|
|
<< portp->warnContextSecondary());
|
|
AstPin* const newp
|
|
= new AstPin{nodep->fileline(), 0, portp->name(), nullptr};
|
|
nodep->addPinsp(newp);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
if (VN_IS(nodep->modp(), Iface)) {
|
|
// Cell really is the parent's instantiation of an interface, not a normal module
|
|
// Make sure we have a variable to refer to this cell, so can <ifacename>.<innermember>
|
|
// in the same way that a child does. Rename though to avoid conflict with cell.
|
|
// This is quite similar to how classes work; when unpacked
|
|
// classes are better supported may remap interfaces to be more
|
|
// like a class.
|
|
if (!nodep->hasIfaceVar()) {
|
|
const string varName
|
|
= nodep->name() + "__Viftop"; // V3LinkDot looks for this naming
|
|
AstIfaceRefDType* const idtypep = new AstIfaceRefDType{
|
|
nodep->fileline(), nodep->name(), nodep->modp()->name()};
|
|
idtypep->ifacep(nullptr); // cellp overrides
|
|
idtypep->cellp(nodep); // Only set when real parent cell known.
|
|
AstVar* varp;
|
|
if (nodep->rangep()) {
|
|
// For arrayed interfaces, we replace cellp when de-arraying in V3Inst
|
|
AstNodeArrayDType* const arrp
|
|
= new AstUnpackArrayDType{nodep->fileline(), VFlagChildDType{}, idtypep,
|
|
nodep->rangep()->cloneTree(true)};
|
|
varp = new AstVar{nodep->fileline(), VVarType::IFACEREF, varName,
|
|
VFlagChildDType{}, arrp};
|
|
} else {
|
|
varp = new AstVar{nodep->fileline(), VVarType::IFACEREF, varName,
|
|
VFlagChildDType{}, idtypep};
|
|
}
|
|
varp->isIfaceParent(true);
|
|
nodep->addNextHere(varp);
|
|
nodep->hasIfaceVar(true);
|
|
}
|
|
}
|
|
if (nodep->modp()) { //
|
|
iterateChildren(nodep);
|
|
}
|
|
UINFO(4, " Link Cell done: " << nodep);
|
|
}
|
|
|
|
void visit(AstRefDType* nodep) override {
|
|
iterateChildren(nodep);
|
|
for (AstPin* pinp = nodep->paramsp(); pinp; pinp = VN_AS(pinp->nextp(), Pin)) {
|
|
pinp->param(true);
|
|
if (pinp->name() == "") pinp->name("__paramNumber" + cvtToStr(pinp->pinNum()));
|
|
}
|
|
if (m_varp) { // Parser didn't know what was interface, resolve now
|
|
AstNodeModule* const varModp = findModuleSym(nodep->name());
|
|
if (AstIface* const ifacep = VN_CAST(varModp, Iface)) {
|
|
// Might be an interface, but might also not really be due to interface being
|
|
// hidden by another declaration. Assume it is relevant and order as-if.
|
|
// This is safe because an interface cannot instantiate a module, so false
|
|
// module->interface edges are harmless.
|
|
newEdge(vertex(m_modp), vertex(ifacep), 1, false);
|
|
}
|
|
}
|
|
}
|
|
void visit(AstClassOrPackageRef* nodep) override {
|
|
iterateChildren(nodep);
|
|
// Inside a class, an extends or reference to another class
|
|
// Note we don't add a V3GraphEdge{vertex(m_modp), vertex(nodep->classOrPackagep()}
|
|
// We could for an extends, but for another reference we cannot, as
|
|
// it is legal to have classes both with parameters that link to each other
|
|
for (AstPin* pinp = nodep->paramsp(); pinp; pinp = VN_AS(pinp->nextp(), Pin)) {
|
|
pinp->param(true);
|
|
if (pinp->name() == "") pinp->name("__paramNumber" + cvtToStr(pinp->pinNum()));
|
|
}
|
|
}
|
|
|
|
void visit(AstVar* nodep) override {
|
|
{
|
|
VL_RESTORER(m_varp);
|
|
m_varp = nodep;
|
|
iterateAndNextNull(nodep->childDTypep());
|
|
}
|
|
iterateAndNextNull(nodep->delayp());
|
|
iterateAndNextNull(nodep->valuep());
|
|
iterateAndNextNull(nodep->attrsp());
|
|
}
|
|
|
|
void visit(AstNode* nodep) override { iterateChildren(nodep); }
|
|
|
|
// METHODS
|
|
void readModNames() {
|
|
// mangled_name, BlockOptions
|
|
const V3HierBlockOptSet& hierBlocks = v3Global.opt.hierBlocks();
|
|
const auto hierIt = vlstd::as_const(hierBlocks).find(v3Global.opt.topModule());
|
|
UASSERT((hierIt != hierBlocks.end()) == !!v3Global.opt.hierChild(),
|
|
"information of the top module must exist if --hierarchical-child is set");
|
|
// Look at all modules, and store pointers to all module names
|
|
for (AstNodeModule *nextp, *nodep = v3Global.rootp()->modulesp(); nodep; nodep = nextp) {
|
|
nextp = VN_AS(nodep->nextp(), NodeModule);
|
|
if (v3Global.opt.hierChild() && nodep->name() == hierIt->second.origName()) {
|
|
nodep->name(hierIt->first); // Change name of this module to be mangled name
|
|
// considering parameter
|
|
}
|
|
const AstNodeModule* const foundp = findModuleSym(nodep->name());
|
|
if (foundp && foundp != nodep) {
|
|
if (!(foundp->fileline()->warnIsOff(V3ErrorCode::MODDUP)
|
|
|| nodep->fileline()->warnIsOff(V3ErrorCode::MODDUP)
|
|
|| hierBlocks.find(nodep->name()) != hierBlocks.end())) {
|
|
nodep->v3warn(MODDUP, "Duplicate declaration of module: "
|
|
<< nodep->prettyNameQ() << '\n'
|
|
<< nodep->warnContextPrimary() << '\n'
|
|
<< foundp->warnOther()
|
|
<< "... Location of original declaration\n"
|
|
<< foundp->warnContextSecondary());
|
|
}
|
|
if (VN_IS(nodep, Package)) {
|
|
// Packages may be imported, we instead rename to be unique
|
|
nodep->name(nodep->name() + "__Vdedup" + cvtToStr(m_dedupNum++));
|
|
} else {
|
|
nodep->unlinkFrBack();
|
|
VL_DO_DANGLING(pushDeletep(nodep), nodep);
|
|
}
|
|
} else if (!foundp) {
|
|
m_mods.rootp()->insert(nodep->name(), new VSymEnt{&m_mods, nodep});
|
|
}
|
|
}
|
|
// if (debug() >= 9) m_mods.dump(cout, "-syms: ");
|
|
}
|
|
|
|
public:
|
|
// CONSTRUCTORS
|
|
LinkCellsVisitor(AstNetlist* nodep, VInFilter* filterp)
|
|
: m_filterp{filterp}
|
|
, m_mods{nodep} {
|
|
if (v3Global.opt.hierChild()) {
|
|
const V3HierBlockOptSet& hierBlocks = v3Global.opt.hierBlocks();
|
|
UASSERT(!v3Global.opt.topModule().empty(),
|
|
"top module must be explicitly specified in hierarchical mode");
|
|
const V3HierBlockOptSet::const_iterator hierIt
|
|
= hierBlocks.find(v3Global.opt.topModule());
|
|
UASSERT(hierIt != hierBlocks.end(),
|
|
"top module must be listed in --hierarchical-block");
|
|
m_origTopModuleName = hierIt->second.origName();
|
|
} else {
|
|
m_origTopModuleName = v3Global.opt.topModule();
|
|
}
|
|
iterate(nodep);
|
|
}
|
|
~LinkCellsVisitor() override = default;
|
|
};
|
|
|
|
//######################################################################
|
|
// Link class functions
|
|
|
|
void V3LinkCells::link(AstNetlist* nodep, VInFilter* filterp) {
|
|
UINFO(4, __FUNCTION__ << ": ");
|
|
{ LinkCellsVisitor{nodep, filterp}; }
|
|
}
|