yosys/frontends/verific/verificsva.cc

1214 lines
31 KiB
C++
Raw Normal View History

/*
* yosys -- Yosys Open SYnthesis Suite
*
* Copyright (C) 2012 Clifford Wolf <clifford@clifford.at>
*
* Permission to use, copy, modify, and/or distribute this software for any
* purpose with or without fee is hereby granted, provided that the above
* copyright notice and this permission notice appear in all copies.
*
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*
*/
// Currently supported property styles:
// seq
// not seq
// seq |-> seq
// seq |-> not seq
// seq |-> seq until expr
// seq |-> not seq until expr
//
// Currently supported sequence operators:
// seq ##[N:M] seq
// seq or seq
// seq and seq
// expr throughout seq
// seq [*N:M]
//
// Notes:
// |-> is a placeholder for |-> and |=>
// "until" is a placeholder for all until operators
// ##[N:M] includes ##N, ##[*], ##[+]
// [*N:M] includes [*N], [*], [+]
// [=N:M], [->N:M] includes [=N], [->N]
//
// Expressions can be any boolean expression, including expressions
// that use $past, $rose, $fell, $stable, and sequence.triggered.
//
// -------------------------------------------------------
//
// SVA Properties Simplified Syntax (essentially a todo-list):
//
// prop:
// not prop
// prop or prop
// prop and prop
// seq |-> prop
// if (expr) prop [else prop]
// always prop
// prop until prop
// prop implies prop
// prop iff prop
// accept_on (expr) prop
// reject_on (expr) prop
//
// seq:
// expr
// seq ##[N:M] seq
// seq or seq
// seq and seq
// seq intersect seq
// first_match (seq)
// expr throughout seq
// seq within seq
// seq [*N:M]
// expr [=N:M]
// expr [->N:M]
#include "kernel/yosys.h"
#include "frontends/verific/verific.h"
USING_YOSYS_NAMESPACE
#ifdef VERIFIC_NAMESPACE
using namespace Verific;
#endif
PRIVATE_NAMESPACE_BEGIN
// Non-deterministic FSM
struct SvaNFsmNode
{
// Edge: Activate the target node if ctrl signal is true, consumes clock cycle
// Link: Activate the target node if ctrl signal is true, doesn't consume clock cycle
vector<pair<int, SigBit>> edges, links;
};
// Non-deterministic FSM after resolving links
struct SvaUFsmNode
{
// Edge: Activate the target node if all bits in ctrl signal are true, consumes clock cycle
// Accept: This node functions as an accept node if all bits in ctrl signal are true
vector<pair<int, SigSpec>> edges;
vector<SigSpec> accept;
bool reachable;
};
// Deterministic FSM
struct SvaDFsmNode
{
// A DFSM state corresponds to a set of NFSM states. We represent DFSM states as sorted vectors
// of NFSM state node ids. Edge/accept controls are constants matched against the ctrl sigspec.
SigSpec ctrl;
vector<pair<vector<int>, Const>> edges;
vector<Const> accept, reject;
// additional temp data for getReject()
Wire *ffoutwire;
SigBit statesig;
SigSpec nextstate;
// additional temp data for getDFsm()
int outnode;
};
struct SvaFsm
{
Module *module;
VerificClocking clocking;
SigBit trigger_sig = State::S1, disable_sig;
SigBit throughout_sig = State::S1;
bool materialized = false;
vector<SigBit> disable_stack;
vector<SigBit> throughout_stack;
int startNode, acceptNode;
vector<SvaNFsmNode> nodes;
SigBit final_accept_sig = State::Sx;
SigBit final_reject_sig = State::Sx;
SvaFsm(const VerificClocking &clking, SigBit trig = State::S1)
{
module = clking.module;
clocking = clking;
trigger_sig = trig;
startNode = createNode();
acceptNode = createNode();
}
void pushDisable(SigBit sig)
{
log_assert(!materialized);
disable_stack.push_back(disable_sig);
if (disable_sig == State::S0)
disable_sig = sig;
else
disable_sig = module->Or(NEW_ID, disable_sig, sig);
}
void popDisable()
{
log_assert(!materialized);
log_assert(!disable_stack.empty());
disable_sig = disable_stack.back();
disable_stack.pop_back();
}
void pushThroughout(SigBit sig)
{
log_assert(!materialized);
throughout_stack.push_back(throughout_sig);
if (throughout_sig == State::S1)
throughout_sig = sig;
else
throughout_sig = module->And(NEW_ID, throughout_sig, sig);
}
void popThroughout()
{
log_assert(!materialized);
log_assert(!throughout_stack.empty());
throughout_sig = throughout_stack.back();
throughout_stack.pop_back();
}
int createNode()
{
log_assert(!materialized);
int idx = GetSize(nodes);
nodes.push_back(SvaNFsmNode());
return idx;
}
void createEdge(int from_node, int to_node, SigBit ctrl = State::S1)
{
log_assert(!materialized);
log_assert(0 <= from_node && from_node < GetSize(nodes));
log_assert(0 <= to_node && to_node < GetSize(nodes));
log_assert(from_node != acceptNode);
log_assert(to_node != acceptNode);
if (throughout_sig != State::S1) {
if (ctrl != State::S1)
ctrl = module->And(NEW_ID, throughout_sig, ctrl);
else
ctrl = throughout_sig;
}
nodes[from_node].edges.push_back(make_pair(to_node, ctrl));
}
void createLink(int from_node, int to_node, SigBit ctrl = State::S1)
{
log_assert(!materialized);
log_assert(0 <= from_node && from_node < GetSize(nodes));
log_assert(0 <= to_node && to_node < GetSize(nodes));
log_assert(from_node != acceptNode);
if (throughout_sig != State::S1) {
if (ctrl != State::S1)
ctrl = module->And(NEW_ID, throughout_sig, ctrl);
else
ctrl = throughout_sig;
}
nodes[from_node].links.push_back(make_pair(to_node, ctrl));
}
void make_link_order(vector<int> &order, int node, int min)
{
order[node] = std::max(order[node], min);
for (auto &it : nodes[node].links)
make_link_order(order, it.first, order[node]+1);
}
// ----------------------------------------------------
// Generating NFSM circuit to acquire accept signal
SigBit getAccept()
{
log_assert(!materialized);
materialized = true;
vector<Wire*> state_wire(GetSize(nodes));
vector<SigBit> state_sig(GetSize(nodes));
vector<SigBit> next_state_sig(GetSize(nodes));
// Create state signals
{
SigBit not_disable = State::S1;
if (disable_sig != State::S0)
not_disable = module->Not(NEW_ID, disable_sig);
for (int i = 0; i < GetSize(nodes); i++)
{
Wire *w = module->addWire(NEW_ID);
state_wire[i] = w;
state_sig[i] = w;
if (i == startNode)
state_sig[i] = module->Or(NEW_ID, state_sig[i], trigger_sig);
if (disable_sig != State::S0)
state_sig[i] = module->And(NEW_ID, state_sig[i], not_disable);
}
}
// Follow Links
{
vector<int> node_order(GetSize(nodes));
vector<vector<int>> order_to_nodes;
for (int i = 0; i < GetSize(nodes); i++)
make_link_order(node_order, i, 0);
for (int i = 0; i < GetSize(nodes); i++) {
if (node_order[i] >= GetSize(order_to_nodes))
order_to_nodes.resize(node_order[i]+1);
order_to_nodes[node_order[i]].push_back(i);
}
for (int order = 0; order < GetSize(order_to_nodes); order++)
for (int node : order_to_nodes[order])
{
for (auto &it : nodes[node].links)
{
int target = it.first;
SigBit ctrl = state_sig[node];
if (it.second != State::S1)
ctrl = module->And(NEW_ID, ctrl, it.second);
state_sig[target] = module->Or(NEW_ID, state_sig[target], ctrl);
}
}
}
// Construct activations
{
vector<SigSpec> activate_sig(GetSize(nodes));
vector<SigBit> activate_bit(GetSize(nodes));
for (int i = 0; i < GetSize(nodes); i++) {
for (auto &it : nodes[i].edges)
activate_sig[it.first].append(module->And(NEW_ID, state_sig[i], it.second));
}
for (int i = 0; i < GetSize(nodes); i++) {
if (GetSize(activate_sig[i]) == 0)
next_state_sig[i] = State::S0;
else if (GetSize(activate_sig[i]) == 1)
next_state_sig[i] = activate_sig[i];
else
next_state_sig[i] = module->ReduceOr(NEW_ID, activate_sig[i]);
}
}
// Create state FFs
for (int i = 0; i < GetSize(nodes); i++)
{
if (next_state_sig[i] != State::S0) {
clocking.addDff(NEW_ID, next_state_sig[i], state_wire[i], Const(0, 1));
} else {
module->connect(state_wire[i], State::S0);
}
}
final_accept_sig = state_sig[acceptNode];
return final_accept_sig;
}
// ----------------------------------------------------
// Generating quantifier-based NFSM circuit to acquire reject signal
SigBit getAnyAllRejectWorker(bool /* allMode */)
{
// FIXME
log_abort();
}
SigBit getAnyReject()
{
return getAnyAllRejectWorker(false);
}
SigBit getAllReject()
{
return getAnyAllRejectWorker(true);
}
// ----------------------------------------------------
// Generating DFSM circuit to acquire reject signal
vector<SvaUFsmNode> unodes;
dict<vector<int>, SvaDFsmNode> dnodes;
void node_to_unode(int node, int unode, SigSpec ctrl)
{
if (node == acceptNode)
unodes[unode].accept.push_back(ctrl);
for (auto &it : nodes[node].edges) {
if (it.second != State::S1) {
SigSpec s = {ctrl, it.second};
s.sort_and_unify();
unodes[unode].edges.push_back(make_pair(it.first, s));
} else {
unodes[unode].edges.push_back(make_pair(it.first, ctrl));
}
}
for (auto &it : nodes[node].links) {
if (it.second != State::S1) {
SigSpec s = {ctrl, it.second};
s.sort_and_unify();
node_to_unode(it.first, unode, s);
} else {
node_to_unode(it.first, unode, ctrl);
}
}
}
void mark_reachable_unode(int unode)
{
if (unodes[unode].reachable)
return;
unodes[unode].reachable = true;
for (auto &it : unodes[unode].edges)
mark_reachable_unode(it.first);
}
void usortint(vector<int> &vec)
{
vector<int> newvec;
std::sort(vec.begin(), vec.end());
for (int i = 0; i < GetSize(vec); i++)
if (i == GetSize(vec)-1 || vec[i] != vec[i+1])
newvec.push_back(vec[i]);
vec.swap(newvec);
}
bool cmp_ctrl(const pool<SigBit> &ctrl_bits, const SigSpec &ctrl)
{
for (int i = 0; i < GetSize(ctrl); i++)
if (ctrl_bits.count(ctrl[i]) == 0)
return false;
return true;
}
void create_dnode(const vector<int> &state, bool firstmatch)
{
if (dnodes.count(state) != 0)
return;
SvaDFsmNode dnode;
dnodes[state] = SvaDFsmNode();
for (int unode : state) {
log_assert(unodes[unode].reachable);
for (auto &it : unodes[unode].edges)
dnode.ctrl.append(it.second);
for (auto &it : unodes[unode].accept)
dnode.ctrl.append(it);
}
dnode.ctrl.sort_and_unify();
if (GetSize(dnode.ctrl) > 10)
log_error("SVA property DFSM state ctrl signal has over 10 bits. Stopping to prevent exponential design size explosion.\n");
for (int i = 0; i < (1 << GetSize(dnode.ctrl)); i++)
{
Const ctrl_val(i, GetSize(dnode.ctrl));
pool<SigBit> ctrl_bits;
for (int i = 0; i < GetSize(dnode.ctrl); i++)
if (ctrl_val[i] == State::S1)
ctrl_bits.insert(dnode.ctrl[i]);
vector<int> new_state;
bool accept = false;
for (int unode : state)
for (auto &it : unodes[unode].accept)
if (cmp_ctrl(ctrl_bits, it))
accept = true;
if (!accept || !firstmatch) {
for (int unode : state)
for (auto &it : unodes[unode].edges)
if (cmp_ctrl(ctrl_bits, it.second))
new_state.push_back(it.first);
}
if (accept)
dnode.accept.push_back(ctrl_val);
if (new_state.empty()) {
if (!accept)
dnode.reject.push_back(ctrl_val);
} else {
usortint(new_state);
dnode.edges.push_back(make_pair(new_state, ctrl_val));
create_dnode(new_state, firstmatch);
}
}
dnodes[state] = dnode;
}
void getFirstAcceptReject(SigBit *accept_p, SigBit *reject_p)
{
log_assert(!materialized);
materialized = true;
// Create unlinked NFSM
unodes.resize(GetSize(nodes));
for (int node = 0; node < GetSize(nodes); node++)
node_to_unode(node, node, SigSpec());
mark_reachable_unode(startNode);
// Create DFSM
create_dnode(vector<int>{startNode}, true);
dnodes.sort();
// Create DFSM Circuit
SigSpec accept_sig, reject_sig;
for (auto &it : dnodes)
{
SvaDFsmNode &dnode = it.second;
dnode.ffoutwire = module->addWire(NEW_ID);
dnode.statesig = dnode.ffoutwire;
if (it.first == vector<int>{startNode})
dnode.statesig = module->Or(NEW_ID, dnode.statesig, trigger_sig);
}
for (auto &it : dnodes)
{
SvaDFsmNode &dnode = it.second;
for (auto &edge : dnode.edges) {
SigBit trig = module->Eq(NEW_ID, {dnode.ctrl, dnode.statesig}, {edge.second, State::S1});
dnodes.at(edge.first).nextstate.append(trig);
}
if (accept_p) {
for (auto &value : dnode.accept)
accept_sig.append(module->Eq(NEW_ID, {dnode.ctrl, dnode.statesig}, {value, State::S1}));
}
if (reject_p) {
for (auto &value : dnode.reject)
reject_sig.append(module->Eq(NEW_ID, {dnode.ctrl, dnode.statesig}, {value, State::S1}));
}
}
for (auto &it : dnodes)
{
SvaDFsmNode &dnode = it.second;
if (GetSize(dnode.nextstate) == 0) {
module->connect(dnode.ffoutwire, State::S0);
} else
if (GetSize(dnode.nextstate) == 1) {
clocking.addDff(NEW_ID, dnode.nextstate, dnode.ffoutwire, State::S0);
} else {
SigSpec nextstate = module->ReduceOr(NEW_ID, dnode.nextstate);
clocking.addDff(NEW_ID, nextstate, dnode.ffoutwire, State::S0);
}
}
if (accept_p)
{
if (GetSize(accept_sig) == 0)
final_accept_sig = State::S0;
else if (GetSize(accept_sig) == 1)
final_accept_sig = accept_sig;
else
final_accept_sig = module->ReduceOr(NEW_ID, accept_sig);
*accept_p = final_accept_sig;
}
if (reject_p)
{
if (GetSize(reject_sig) == 0)
final_reject_sig = State::S0;
else if (GetSize(reject_sig) == 1)
final_reject_sig = reject_sig;
else
final_reject_sig = module->ReduceOr(NEW_ID, reject_sig);
*reject_p = final_reject_sig;
}
}
SigBit getFirstAccept()
{
SigBit accept;
getFirstAcceptReject(nullptr, &accept);
return accept;
}
SigBit getReject()
{
SigBit reject;
getFirstAcceptReject(nullptr, &reject);
return reject;
}
void getDFsm(SvaFsm &output_fsm, int output_start_node, int output_accept_node, int output_reject_node)
{
log_assert(!materialized);
materialized = true;
// Create unlinked NFSM
unodes.resize(GetSize(nodes));
for (int node = 0; node < GetSize(nodes); node++)
node_to_unode(node, node, SigSpec());
mark_reachable_unode(startNode);
// Create DFSM
create_dnode(vector<int>{startNode}, true);
dnodes.sort();
// Create DFSM Graph
for (auto &it : dnodes)
{
it.second.outnode = output_fsm.createNode();
if (it.first == vector<int>{startNode})
output_fsm.createLink(output_start_node, it.second.outnode);
if (output_accept_node >= 0) {
for (auto &value : it.second.accept)
output_fsm.createLink(it.second.outnode, output_accept_node, module->Eq(NEW_ID, it.second.ctrl, value));
}
if (output_reject_node >= 0) {
for (auto &value : it.second.reject)
output_fsm.createLink(it.second.outnode, output_reject_node, module->Eq(NEW_ID, it.second.ctrl, value));
}
}
for (auto &it : dnodes)
{
for (auto &edge : it.second.edges)
output_fsm.createEdge(it.second.outnode, dnodes.at(edge.first).outnode, module->Eq(NEW_ID, it.second.ctrl, edge.second));
}
}
// ----------------------------------------------------
// State dump for verbose log messages
void dump_nodes()
{
if (nodes.empty())
return;
log(" non-deterministic encoding:\n");
for (int i = 0; i < GetSize(nodes); i++)
{
log(" node %d:%s\n", i, i == startNode ? " [start]" : i == acceptNode ? " [accept]" : "");
for (auto &it : nodes[i].edges) {
if (it.second != State::S1)
log(" egde %s -> %d\n", log_signal(it.second), it.first);
else
log(" egde -> %d\n", it.first);
}
for (auto &it : nodes[i].links) {
if (it.second != State::S1)
log(" link %s -> %d\n", log_signal(it.second), it.first);
else
log(" link -> %d\n", it.first);
}
}
}
void dump_unodes()
{
if (unodes.empty())
return;
log(" unlinked non-deterministic encoding:\n");
for (int i = 0; i < GetSize(unodes); i++)
{
if (!unodes[i].reachable)
continue;
log(" unode %d:%s\n", i, i == startNode ? " [start]" : "");
for (auto &it : unodes[i].edges) {
if (!it.second.empty())
log(" egde %s -> %d\n", log_signal(it.second), it.first);
else
log(" egde -> %d\n", it.first);
}
for (auto &ctrl : unodes[i].accept) {
if (!ctrl.empty())
log(" accept %s\n", log_signal(ctrl));
else
log(" accept\n");
}
}
}
void dump_dnodes()
{
if (dnodes.empty())
return;
log(" deterministic encoding:\n");
for (auto &it : dnodes)
{
log(" dnode {");
for (int i = 0; i < GetSize(it.first); i++)
log("%s%d", i ? "," : "", it.first[i]);
log("}:%s\n", GetSize(it.first) == 1 && it.first[0] == startNode ? " [start]" : "");
log(" ctrl %s\n", log_signal(it.second.ctrl));
for (auto &edge : it.second.edges) {
log(" edge %s -> {", log_signal(edge.second));
for (int i = 0; i < GetSize(edge.first); i++)
log("%s%d", i ? "," : "", edge.first[i]);
log("}\n");
}
for (auto &value : it.second.accept)
log(" accept %s\n", log_signal(value));
for (auto &value : it.second.reject)
log(" reject %s\n", log_signal(value));
}
}
void dump()
{
if (!nodes.empty())
log(" number of NFSM states: %d\n", GetSize(nodes));
if (!unodes.empty()) {
int count = 0;
for (auto &unode : unodes)
if (unode.reachable)
count++;
log(" number of reachable UFSM states: %d\n", count);
}
if (!dnodes.empty())
log(" number of DFSM states: %d\n", GetSize(dnodes));
if (verific_verbose >= 2) {
dump_nodes();
dump_unodes();
dump_dnodes();
}
if (trigger_sig != State::S1)
log(" trigger signal: %s\n", log_signal(trigger_sig));
if (final_accept_sig != State::Sx)
log(" accept signal: %s\n", log_signal(final_accept_sig));
if (final_reject_sig != State::Sx)
log(" reject signal: %s\n", log_signal(final_reject_sig));
}
};
PRIVATE_NAMESPACE_END
YOSYS_NAMESPACE_BEGIN
pool<int> verific_sva_prims = {
// Copy&paste from Verific 3.16_484_32_170630 Netlist.h
PRIM_SVA_IMMEDIATE_ASSERT, PRIM_SVA_ASSERT, PRIM_SVA_COVER, PRIM_SVA_ASSUME,
PRIM_SVA_EXPECT, PRIM_SVA_POSEDGE, PRIM_SVA_NOT, PRIM_SVA_FIRST_MATCH,
PRIM_SVA_ENDED, PRIM_SVA_MATCHED, PRIM_SVA_CONSECUTIVE_REPEAT,
PRIM_SVA_NON_CONSECUTIVE_REPEAT, PRIM_SVA_GOTO_REPEAT,
PRIM_SVA_MATCH_ITEM_TRIGGER, PRIM_SVA_AND, PRIM_SVA_OR, PRIM_SVA_SEQ_AND,
PRIM_SVA_SEQ_OR, PRIM_SVA_EVENT_OR, PRIM_SVA_OVERLAPPED_IMPLICATION,
PRIM_SVA_NON_OVERLAPPED_IMPLICATION, PRIM_SVA_OVERLAPPED_FOLLOWED_BY,
PRIM_SVA_NON_OVERLAPPED_FOLLOWED_BY, PRIM_SVA_INTERSECT, PRIM_SVA_THROUGHOUT,
PRIM_SVA_WITHIN, PRIM_SVA_AT, PRIM_SVA_DISABLE_IFF, PRIM_SVA_SAMPLED,
PRIM_SVA_ROSE, PRIM_SVA_FELL, PRIM_SVA_STABLE, PRIM_SVA_PAST,
PRIM_SVA_MATCH_ITEM_ASSIGN, PRIM_SVA_SEQ_CONCAT, PRIM_SVA_IF,
PRIM_SVA_RESTRICT, PRIM_SVA_TRIGGERED, PRIM_SVA_STRONG, PRIM_SVA_WEAK,
PRIM_SVA_NEXTTIME, PRIM_SVA_S_NEXTTIME, PRIM_SVA_ALWAYS, PRIM_SVA_S_ALWAYS,
PRIM_SVA_S_EVENTUALLY, PRIM_SVA_EVENTUALLY, PRIM_SVA_UNTIL, PRIM_SVA_S_UNTIL,
PRIM_SVA_UNTIL_WITH, PRIM_SVA_S_UNTIL_WITH, PRIM_SVA_IMPLIES, PRIM_SVA_IFF,
PRIM_SVA_ACCEPT_ON, PRIM_SVA_REJECT_ON, PRIM_SVA_SYNC_ACCEPT_ON,
PRIM_SVA_SYNC_REJECT_ON, PRIM_SVA_GLOBAL_CLOCKING_DEF,
PRIM_SVA_GLOBAL_CLOCKING_REF, PRIM_SVA_IMMEDIATE_ASSUME,
PRIM_SVA_IMMEDIATE_COVER, OPER_SVA_SAMPLED, OPER_SVA_STABLE
};
struct VerificSvaImporter
{
VerificImporter *importer = nullptr;
Module *module = nullptr;
Netlist *netlist = nullptr;
Instance *root = nullptr;
VerificClocking clocking;
bool mode_assert = false;
bool mode_assume = false;
bool mode_cover = false;
bool mode_trigger = false;
bool eventually = false;
Instance *net_to_ast_driver(Net *n)
{
if (n == nullptr)
return nullptr;
if (n->IsMultipleDriven())
return nullptr;
Instance *inst = n->Driver();
if (inst == nullptr)
return nullptr;
if (!verific_sva_prims.count(inst->Type()))
return nullptr;
if (inst->Type() == PRIM_SVA_ROSE || inst->Type() == PRIM_SVA_FELL ||
inst->Type() == PRIM_SVA_STABLE || inst->Type() == OPER_SVA_STABLE ||
inst->Type() == PRIM_SVA_PAST || inst->Type() == PRIM_SVA_TRIGGERED)
return nullptr;
return inst;
}
Instance *get_ast_input(Instance *inst) { return net_to_ast_driver(inst->GetInput()); }
Instance *get_ast_input1(Instance *inst) { return net_to_ast_driver(inst->GetInput1()); }
Instance *get_ast_input2(Instance *inst) { return net_to_ast_driver(inst->GetInput2()); }
Instance *get_ast_input3(Instance *inst) { return net_to_ast_driver(inst->GetInput3()); }
Instance *get_ast_control(Instance *inst) { return net_to_ast_driver(inst->GetControl()); }
// ----------------------------------------------------------
// SVA Importer
struct ParserErrorException {
};
[[noreturn]] void parser_error(std::string errmsg)
{
if (!importer->mode_keep)
log_error("%s", errmsg.c_str());
log_warning("%s", errmsg.c_str());
throw ParserErrorException();
}
[[noreturn]] void parser_error(std::string errmsg, linefile_type loc)
{
parser_error(stringf("%s at %s:%d.\n", errmsg.c_str(), LineFile::GetFileName(loc), LineFile::GetLineNo(loc)));
}
[[noreturn]] void parser_error(std::string errmsg, Instance *inst)
{
parser_error(stringf("%s at %s (%s)", errmsg.c_str(), inst->View()->Owner()->Name(), inst->Name()), inst->Linefile());
}
[[noreturn]] void parser_error(Instance *inst)
{
parser_error(stringf("Verific SVA primitive %s (%s) is currently unsupported in this context",
inst->View()->Owner()->Name(), inst->Name()), inst->Linefile());
}
int parse_sequence(SvaFsm &fsm, int start_node, Net *net)
{
Instance *inst = net_to_ast_driver(net);
if (inst == nullptr) {
int node = fsm.createNode();
fsm.createLink(start_node, node, importer->net_map_at(net));
return node;
}
if (inst->Type() == PRIM_SVA_AT)
{
VerificClocking new_clocking(importer, net);
if (!clocking.property_matches_sequence(new_clocking))
parser_error("Mixed clocking is currently not supported", inst);
return parse_sequence(fsm, start_node, new_clocking.body_net);
}
if (inst->Type() == PRIM_SVA_SEQ_CONCAT)
{
const char *sva_low_s = inst->GetAttValue("sva:low");
const char *sva_high_s = inst->GetAttValue("sva:high");
int sva_low = atoi(sva_low_s);
int sva_high = atoi(sva_high_s);
bool sva_inf = !strcmp(sva_high_s, "$");
int node = parse_sequence(fsm, start_node, inst->GetInput1());
for (int i = 0; i < sva_low; i++) {
int next_node = fsm.createNode();
fsm.createEdge(node, next_node);
node = next_node;
}
if (sva_inf)
{
fsm.createEdge(node, node);
}
else
{
for (int i = sva_low; i < sva_high; i++)
{
int next_node = fsm.createNode();
fsm.createEdge(node, next_node);
fsm.createLink(node, next_node);
node = next_node;
}
}
node = parse_sequence(fsm, node, inst->GetInput2());
return node;
}
if (inst->Type() == PRIM_SVA_CONSECUTIVE_REPEAT)
{
const char *sva_low_s = inst->GetAttValue("sva:low");
const char *sva_high_s = inst->GetAttValue("sva:high");
int sva_low = atoi(sva_low_s);
int sva_high = atoi(sva_high_s);
bool sva_inf = !strcmp(sva_high_s, "$");
Net *body_net = inst->GetInput();
Instance *body_inst = net_to_ast_driver(body_net);
if (body_inst != nullptr)
parser_error(body_inst);
int node = parse_sequence(fsm, start_node, body_net);
for (int i = 1; i < sva_low; i++)
{
int next_node = fsm.createNode();
fsm.createEdge(node, next_node);
node = parse_sequence(fsm, next_node, body_net);
}
if (sva_inf)
{
int next_node = fsm.createNode();
fsm.createEdge(node, next_node);
next_node = parse_sequence(fsm, next_node, body_net);
fsm.createLink(next_node, node);
}
else
{
for (int i = sva_low; i < sva_high; i++)
{
int next_node = fsm.createNode();
fsm.createEdge(node, next_node);
next_node = parse_sequence(fsm, next_node, body_net);
fsm.createLink(node, next_node);
node = next_node;
}
}
return node;
}
if (inst->Type() == PRIM_SVA_SEQ_OR)
{
int node = parse_sequence(fsm, start_node, inst->GetInput1());
int node2 = parse_sequence(fsm, start_node, inst->GetInput2());
fsm.createLink(node2, node);
return node;
}
if (inst->Type() == PRIM_SVA_SEQ_AND)
{
SvaFsm fsm1(clocking);
fsm1.createLink(parse_sequence(fsm1, fsm1.startNode, inst->GetInput1()), fsm1.acceptNode);
SvaFsm fsm2(clocking);
fsm2.createLink(parse_sequence(fsm2, fsm2.startNode, inst->GetInput2()), fsm2.acceptNode);
SvaFsm combined_fsm(clocking);
fsm1.getDFsm(combined_fsm, combined_fsm.startNode, -1, combined_fsm.acceptNode);
fsm2.getDFsm(combined_fsm, combined_fsm.startNode, -1, combined_fsm.acceptNode);
int node = fsm.createNode();
combined_fsm.getDFsm(fsm, start_node, -1, node);
return node;
}
if (inst->Type() == PRIM_SVA_THROUGHOUT)
{
log_assert(get_ast_input1(inst) == nullptr);
SigBit expr = importer->net_map_at(inst->GetInput1());
fsm.pushThroughout(expr);
int node = parse_sequence(fsm, start_node, inst->GetInput2());
fsm.popThroughout();
return node;
}
parser_error(inst);
}
void get_fsm_accept_reject(SvaFsm &fsm, SigBit *accept_p, SigBit *reject_p, bool swap_accpet_reject = false)
{
log_assert(accept_p != nullptr || reject_p != nullptr);
if (swap_accpet_reject)
get_fsm_accept_reject(fsm, reject_p, accept_p);
else if (reject_p == nullptr)
*accept_p = fsm.getAccept();
else if (accept_p == nullptr)
*reject_p = fsm.getReject();
else
fsm.getFirstAcceptReject(accept_p, reject_p);
}
void parse_property(Net *net, SigBit *accept_p, SigBit *reject_p)
{
Instance *inst = net_to_ast_driver(net);
if (inst == nullptr)
{
if (accept_p != nullptr)
*accept_p = importer->net_map_at(net);
if (reject_p != nullptr)
*reject_p = module->Not(NEW_ID, importer->net_map_at(net));
}
else
if (inst->Type() == PRIM_SVA_OVERLAPPED_IMPLICATION ||
inst->Type() == PRIM_SVA_NON_OVERLAPPED_IMPLICATION)
{
Net *antecedent_net = inst->GetInput1();
Net *consequent_net = inst->GetInput2();
int node;
SvaFsm antecedent_fsm(clocking);
node = parse_sequence(antecedent_fsm, antecedent_fsm.startNode, antecedent_net);
if (inst->Type() == PRIM_SVA_NON_OVERLAPPED_IMPLICATION) {
int next_node = antecedent_fsm.createNode();
antecedent_fsm.createEdge(node, next_node);
node = next_node;
}
Instance *consequent_inst = net_to_ast_driver(consequent_net);
if (consequent_inst && (consequent_inst->Type() == PRIM_SVA_UNTIL || consequent_inst->Type() == PRIM_SVA_S_UNTIL ||
consequent_inst->Type() == PRIM_SVA_UNTIL_WITH || consequent_inst->Type() == PRIM_SVA_S_UNTIL_WITH))
{
bool until_with = consequent_inst->Type() == PRIM_SVA_UNTIL_WITH || consequent_inst->Type() == PRIM_SVA_S_UNTIL_WITH;
Net *until_net = consequent_inst->GetInput2();
Instance *until_inst = net_to_ast_driver(until_net);
consequent_net = consequent_inst->GetInput1();
consequent_inst = net_to_ast_driver(consequent_net);
if (until_inst != nullptr)
parser_error(until_inst);
SigBit until_sig = importer->net_map_at(until_net);
SigBit not_until_sig = module->Not(NEW_ID, until_sig);
antecedent_fsm.createEdge(node, node, not_until_sig);
antecedent_fsm.createLink(node, antecedent_fsm.acceptNode, until_with ? State::S1 : not_until_sig);
}
else
{
antecedent_fsm.createLink(node, antecedent_fsm.acceptNode);
}
SigBit antecedent_match = antecedent_fsm.getAccept();
if (verific_verbose) {
log(" Antecedent FSM:\n");
antecedent_fsm.dump();
}
bool consequent_not = false;
if (consequent_inst && consequent_inst->Type() == PRIM_SVA_NOT) {
consequent_not = true;
consequent_net = consequent_inst->GetInput();
consequent_inst = net_to_ast_driver(consequent_net);
}
SvaFsm consequent_fsm(clocking, antecedent_match);
node = parse_sequence(consequent_fsm, consequent_fsm.startNode, consequent_net);
consequent_fsm.createLink(node, consequent_fsm.acceptNode);
get_fsm_accept_reject(consequent_fsm, accept_p, reject_p, consequent_not);
if (verific_verbose) {
log(" Consequent FSM:\n");
consequent_fsm.dump();
}
}
else
{
bool prop_not = inst->Type() == PRIM_SVA_NOT;
if (prop_not) {
net = inst->GetInput();
inst = net_to_ast_driver(net);
}
SvaFsm fsm(clocking);
int node = parse_sequence(fsm, fsm.startNode, net);
fsm.createLink(node, fsm.acceptNode);
get_fsm_accept_reject(fsm, accept_p, reject_p, prop_not);
if (verific_verbose) {
log(" Sequence FSM:\n");
fsm.dump();
}
}
}
void import()
{
try
{
module = importer->module;
netlist = root->Owner();
if (verific_verbose)
log(" importing SVA property at root cell %s (%s) at %s:%d.\n", root->Name(), root->View()->Owner()->Name(),
LineFile::GetFileName(root->Linefile()), LineFile::GetLineNo(root->Linefile()));
RTLIL::IdString root_name = module->uniquify(importer->mode_names || root->IsUserDeclared() ? RTLIL::escape_id(root->Name()) : NEW_ID);
clocking = VerificClocking(importer, root->GetInput());
if (clocking.body_net == nullptr)
parser_error(stringf("Failed to parse SVA clocking"), root);
// parse SVA sequence into trigger signal
Net *net = clocking.body_net;
SigBit accept_bit = State::S0, reject_bit = State::S0;
if (mode_assert || mode_assume) {
parse_property(net, nullptr, &reject_bit);
} else {
parse_property(net, &accept_bit, nullptr);
}
if (mode_trigger)
{
module->connect(importer->net_map_at(root->GetOutput()), accept_bit);
}
else
{
SigBit sig_a = module->Not(NEW_ID, reject_bit);
SigBit sig_en = module->Or(NEW_ID, accept_bit, reject_bit);
// add final FF stage
SigBit sig_a_q = module->addWire(NEW_ID);
SigBit sig_en_q = module->addWire(NEW_ID);
clocking.addDff(NEW_ID, sig_a, sig_a_q, State::S0);
clocking.addDff(NEW_ID, sig_en, sig_en_q, State::S0);
// generate assert/assume/cover cell
RTLIL::Cell *c = nullptr;
if (mode_assert) c = module->addAssert(root_name, sig_a_q, sig_en_q);
if (mode_assume) c = module->addAssume(root_name, sig_a_q, sig_en_q);
if (mode_cover) c = module->addCover(root_name, sig_a_q, sig_en_q);
importer->import_attributes(c->attributes, root);
}
}
catch (ParserErrorException)
{
}
}
};
void import_sva_assert(VerificImporter *importer, Instance *inst)
{
VerificSvaImporter worker;
worker.importer = importer;
worker.root = inst;
worker.mode_assert = true;
worker.import();
}
void import_sva_assume(VerificImporter *importer, Instance *inst)
{
VerificSvaImporter worker;
worker.importer = importer;
worker.root = inst;
worker.mode_assume = true;
worker.import();
}
void import_sva_cover(VerificImporter *importer, Instance *inst)
{
VerificSvaImporter worker;
worker.importer = importer;
worker.root = inst;
worker.mode_cover = true;
worker.import();
}
void import_sva_trigger(VerificImporter *importer, Instance *inst)
{
VerificSvaImporter worker;
worker.importer = importer;
worker.root = inst;
worker.mode_trigger = true;
worker.import();
}
YOSYS_NAMESPACE_END