yosys/passes/opt/opt_merge.cc

378 lines
12 KiB
C++
Raw Normal View History

2013-01-05 04:13:26 -06:00
/*
* yosys -- Yosys Open SYnthesis Suite
*
* Copyright (C) 2012 Clifford Wolf <clifford@clifford.at>
2015-07-02 04:14:30 -05:00
*
2013-01-05 04:13:26 -06:00
* 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.
2015-07-02 04:14:30 -05:00
*
2013-01-05 04:13:26 -06:00
* 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.
*
*/
#include "kernel/register.h"
#include "kernel/sigtools.h"
#include "kernel/log.h"
#include "kernel/celltypes.h"
#include "libs/sha1/sha1.h"
2013-01-05 04:13:26 -06:00
#include <stdlib.h>
#include <stdio.h>
#include <set>
2014-09-27 09:17:53 -05:00
USING_YOSYS_NAMESPACE
PRIVATE_NAMESPACE_BEGIN
2016-03-31 01:52:49 -05:00
struct OptMergeWorker
2013-01-05 04:13:26 -06:00
{
RTLIL::Design *design;
RTLIL::Module *module;
SigMap assign_map;
SigMap dff_init_map;
2015-05-31 07:24:34 -05:00
bool mode_share_all;
2013-01-05 04:13:26 -06:00
CellTypes ct;
int total_count;
2020-03-10 18:13:44 -05:00
SHA1 checksum;
2013-01-05 04:13:26 -06:00
static void sort_pmux_conn(dict<RTLIL::IdString, RTLIL::SigSpec> &conn)
{
SigSpec sig_s = conn.at(ID::S);
2019-08-15 16:50:10 -05:00
SigSpec sig_b = conn.at(ID::B);
int s_width = GetSize(sig_s);
int width = GetSize(sig_b) / s_width;
vector<pair<SigBit, SigSpec>> sb_pairs;
for (int i = 0; i < s_width; i++)
sb_pairs.push_back(pair<SigBit, SigSpec>(sig_s[i], sig_b.extract(i*width, width)));
std::sort(sb_pairs.begin(), sb_pairs.end());
conn[ID::S] = SigSpec();
2019-08-15 16:50:10 -05:00
conn[ID::B] = SigSpec();
for (auto &it : sb_pairs) {
conn[ID::S].append(it.first);
2019-08-15 16:50:10 -05:00
conn[ID::B].append(it.second);
}
}
2013-01-05 04:13:26 -06:00
std::string int_to_hash_string(unsigned int v)
{
if (v == 0)
return "0";
std::string str = "";
while (v > 0) {
str += 'a' + (v & 15);
v = v >> 4;
}
return str;
}
std::string hash_cell_parameters_and_connections(const RTLIL::Cell *cell)
{
2020-03-10 18:13:44 -05:00
vector<string> hash_conn_strings;
std::string hash_string = cell->type.str() + "\n";
2013-01-05 04:13:26 -06:00
const dict<RTLIL::IdString, RTLIL::SigSpec> *conn = &cell->connections();
dict<RTLIL::IdString, RTLIL::SigSpec> alt_conn;
if (cell->type.in(ID($and), ID($or), ID($xor), ID($xnor), ID($add), ID($mul),
ID($logic_and), ID($logic_or), ID($_AND_), ID($_OR_), ID($_XOR_))) {
alt_conn = *conn;
2019-08-15 16:50:10 -05:00
if (assign_map(alt_conn.at(ID::A)) < assign_map(alt_conn.at(ID::B))) {
alt_conn[ID::A] = conn->at(ID::B);
alt_conn[ID::B] = conn->at(ID::A);
}
conn = &alt_conn;
2013-03-29 05:19:21 -05:00
} else
if (cell->type.in(ID($reduce_xor), ID($reduce_xnor))) {
2013-03-29 05:19:21 -05:00
alt_conn = *conn;
2019-08-15 16:50:10 -05:00
assign_map.apply(alt_conn.at(ID::A));
alt_conn.at(ID::A).sort();
2013-03-29 05:19:21 -05:00
conn = &alt_conn;
} else
if (cell->type.in(ID($reduce_and), ID($reduce_or), ID($reduce_bool))) {
2013-03-29 05:19:21 -05:00
alt_conn = *conn;
2019-08-15 16:50:10 -05:00
assign_map.apply(alt_conn.at(ID::A));
alt_conn.at(ID::A).sort_and_unify();
2013-03-29 05:19:21 -05:00
conn = &alt_conn;
} else
if (cell->type == ID($pmux)) {
alt_conn = *conn;
2019-08-15 16:50:10 -05:00
assign_map.apply(alt_conn.at(ID::A));
assign_map.apply(alt_conn.at(ID::B));
assign_map.apply(alt_conn.at(ID::S));
sort_pmux_conn(alt_conn);
conn = &alt_conn;
}
for (auto &it : *conn) {
2020-03-10 18:13:44 -05:00
RTLIL::SigSpec sig;
if (cell->output(it.first)) {
if (it.first == ID::Q && RTLIL::builtin_ff_cell_types().count(cell->type)) {
2020-03-10 18:13:44 -05:00
// For the 'Q' output of state elements,
// use its (* init *) attribute value
for (const auto &b : dff_init_map(it.second))
sig.append(b.wire ? State::Sx : b);
}
else
continue;
}
else
sig = assign_map(it.second);
string s = "C " + it.first.str() + "=";
for (auto &chunk : sig.chunks()) {
2013-01-05 04:13:26 -06:00
if (chunk.wire)
s += "{" + chunk.wire->name.str() + " " +
2013-01-05 04:13:26 -06:00
int_to_hash_string(chunk.offset) + " " +
int_to_hash_string(chunk.width) + "}";
else
s += RTLIL::Const(chunk.data).as_string();
2013-01-05 04:13:26 -06:00
}
hash_conn_strings.push_back(s + "\n");
2013-01-05 04:13:26 -06:00
}
2020-03-10 18:13:44 -05:00
for (auto &it : cell->parameters)
hash_conn_strings.push_back("P " + it.first.str() + "=" + it.second.as_string() + "\n");
std::sort(hash_conn_strings.begin(), hash_conn_strings.end());
for (auto it : hash_conn_strings)
hash_string += it;
2020-03-10 18:13:44 -05:00
checksum.update(hash_string);
return checksum.final();
2013-01-05 04:13:26 -06:00
}
2020-03-10 18:13:44 -05:00
bool compare_cell_parameters_and_connections(const RTLIL::Cell *cell1, const RTLIL::Cell *cell2)
2013-01-05 04:13:26 -06:00
{
2020-03-10 18:13:44 -05:00
log_assert(cell1 != cell2);
if (cell1->type != cell2->type) return false;
if (cell1->parameters != cell2->parameters)
return false;
if (cell1->connections_.size() != cell2->connections_.size())
return false;
for (const auto &it : cell1->connections_)
if (!cell2->connections_.count(it.first))
return false;
decltype(Cell::connections_) conn1, conn2;
conn1.reserve(cell1->connections_.size());
conn2.reserve(cell1->connections_.size());
for (const auto &it : cell1->connections_) {
if (cell1->output(it.first)) {
if (it.first == ID::Q && (cell1->type.begins_with("$dff") || cell1->type.begins_with("$dlatch") ||
2020-03-10 18:13:44 -05:00
cell1->type.begins_with("$_DFF") || cell1->type.begins_with("$_DLATCH") || cell1->type.begins_with("$_SR_") ||
cell1->type.in(ID($adff), ID($sr), ID($ff), ID($_FF_)))) {
2020-03-10 18:13:44 -05:00
// For the 'Q' output of state elements,
// use the (* init *) attribute value
auto &sig1 = conn1[it.first];
for (const auto &b : dff_init_map(it.second))
sig1.append(b.wire ? State::Sx : b);
auto &sig2 = conn2[it.first];
for (const auto &b : dff_init_map(cell2->getPort(it.first)))
sig2.append(b.wire ? State::Sx : b);
}
else {
conn1[it.first] = RTLIL::SigSpec();
conn2[it.first] = RTLIL::SigSpec();
}
}
else {
conn1[it.first] = assign_map(it.second);
conn2[it.first] = assign_map(cell2->getPort(it.first));
}
2013-01-05 04:13:26 -06:00
}
if (cell1->type == ID($and) || cell1->type == ID($or) || cell1->type == ID($xor) || cell1->type == ID($xnor) || cell1->type == ID($add) || cell1->type == ID($mul) ||
cell1->type == ID($logic_and) || cell1->type == ID($logic_or) || cell1->type == ID($_AND_) || cell1->type == ID($_OR_) || cell1->type == ID($_XOR_)) {
2019-08-15 16:50:10 -05:00
if (conn1.at(ID::A) < conn1.at(ID::B)) {
RTLIL::SigSpec tmp = conn1[ID::A];
conn1[ID::A] = conn1[ID::B];
conn1[ID::B] = tmp;
}
2019-08-15 16:50:10 -05:00
if (conn2.at(ID::A) < conn2.at(ID::B)) {
RTLIL::SigSpec tmp = conn2[ID::A];
conn2[ID::A] = conn2[ID::B];
conn2[ID::B] = tmp;
}
2013-03-29 05:19:21 -05:00
} else
if (cell1->type == ID($reduce_xor) || cell1->type == ID($reduce_xnor)) {
2019-08-15 16:50:10 -05:00
conn1[ID::A].sort();
conn2[ID::A].sort();
2013-03-29 05:19:21 -05:00
} else
if (cell1->type == ID($reduce_and) || cell1->type == ID($reduce_or) || cell1->type == ID($reduce_bool)) {
2019-08-15 16:50:10 -05:00
conn1[ID::A].sort_and_unify();
conn2[ID::A].sort_and_unify();
} else
if (cell1->type == ID($pmux)) {
sort_pmux_conn(conn1);
sort_pmux_conn(conn2);
}
2020-03-10 18:13:44 -05:00
return conn1 == conn2;
2013-01-05 04:13:26 -06:00
}
2016-03-31 01:52:49 -05:00
OptMergeWorker(RTLIL::Design *design, RTLIL::Module *module, bool mode_nomux, bool mode_share_all) :
2015-05-31 07:24:34 -05:00
design(design), module(module), assign_map(module), mode_share_all(mode_share_all)
2013-01-05 04:13:26 -06:00
{
total_count = 0;
ct.setup_internals();
ct.setup_internals_mem();
ct.setup_stdcells();
ct.setup_stdcells_mem();
if (mode_nomux) {
ct.cell_types.erase(ID($mux));
ct.cell_types.erase(ID($pmux));
2013-01-05 04:13:26 -06:00
}
ct.cell_types.erase(ID($tribuf));
ct.cell_types.erase(ID($_TBUF_));
ct.cell_types.erase(ID($anyseq));
ct.cell_types.erase(ID($anyconst));
ct.cell_types.erase(ID($allseq));
ct.cell_types.erase(ID($allconst));
2013-01-05 04:13:26 -06:00
log("Finding identical cells in module `%s'.\n", module->name.c_str());
assign_map.set(module);
dff_init_map.set(module);
for (auto &it : module->wires_)
if (it.second->attributes.count(ID::init) != 0) {
Const initval = it.second->attributes.at(ID::init);
for (int i = 0; i < GetSize(initval) && i < GetSize(it.second); i++)
if (initval[i] == State::S0 || initval[i] == State::S1)
dff_init_map.add(SigBit(it.second, i), initval[i]);
}
2013-01-05 04:13:26 -06:00
bool did_something = true;
while (did_something)
{
std::vector<RTLIL::Cell*> cells;
cells.reserve(module->cells_.size());
for (auto &it : module->cells_) {
2015-05-31 07:24:34 -05:00
if (!design->selected(module, it.second))
continue;
if (ct.cell_known(it.second->type) || (mode_share_all && it.second->known()))
2013-01-05 04:13:26 -06:00
cells.push_back(it.second);
}
did_something = false;
dict<std::string, RTLIL::Cell*> sharemap;
2013-01-05 04:13:26 -06:00
for (auto cell : cells)
{
2020-03-10 18:13:44 -05:00
if ((!mode_share_all && !ct.cell_known(cell->type)) || !cell->known())
continue;
auto hash = hash_cell_parameters_and_connections(cell);
auto r = sharemap.insert(std::make_pair(hash, cell));
if (!r.second) {
if (compare_cell_parameters_and_connections(cell, r.first->second)) {
if (cell->has_keep_attr()) {
if (r.first->second->has_keep_attr())
continue;
std::swap(r.first->second, cell);
}
did_something = true;
log_debug(" Cell `%s' is identical to cell `%s'.\n", cell->name.c_str(), r.first->second->name.c_str());
for (auto &it : cell->connections()) {
if (cell->output(it.first)) {
RTLIL::SigSpec other_sig = r.first->second->getPort(it.first);
log_debug(" Redirecting output %s: %s = %s\n", it.first.c_str(),
log_signal(it.second), log_signal(other_sig));
module->connect(RTLIL::SigSig(it.second, other_sig));
assign_map.add(it.second, other_sig);
2020-06-30 13:57:35 -05:00
if (it.first == ID::Q && RTLIL::builtin_ff_cell_types().count(cell->type)) {
2020-03-10 18:13:44 -05:00
for (auto c : it.second.chunks()) {
auto jt = c.wire->attributes.find(ID::init);
2020-03-10 18:13:44 -05:00
if (jt == c.wire->attributes.end())
continue;
for (int i = c.offset; i < c.offset + c.width; i++)
jt->second[i] = State::Sx;
}
dff_init_map.add(it.second, Const(State::Sx, GetSize(it.second)));
}
}
2013-01-05 04:13:26 -06:00
}
2020-03-10 18:13:44 -05:00
log_debug(" Removing %s cell `%s' from module `%s'.\n", cell->type.c_str(), cell->name.c_str(), module->name.c_str());
module->remove(cell);
total_count++;
2013-01-05 04:13:26 -06:00
}
}
}
}
log_suppressed();
2013-01-05 04:13:26 -06:00
}
};
2016-03-31 01:52:49 -05:00
struct OptMergePass : public Pass {
OptMergePass() : Pass("opt_merge", "consolidate identical cells") { }
2020-06-18 18:34:52 -05:00
void help() override
2013-03-01 01:58:55 -06:00
{
// |---v---|---v---|---v---|---v---|---v---|---v---|---v---|---v---|---v---|---v---|
log("\n");
2016-03-31 01:52:49 -05:00
log(" opt_merge [options] [selection]\n");
2013-03-01 01:58:55 -06:00
log("\n");
log("This pass identifies cells with identical type and input signals. Such cells\n");
log("are then merged to one cell.\n");
log("\n");
log(" -nomux\n");
log(" Do not merge MUX cells.\n");
log("\n");
2015-05-31 07:24:34 -05:00
log(" -share_all\n");
log(" Operate on all cell types, not just built-in types.\n");
log("\n");
2013-03-01 01:58:55 -06:00
}
2020-06-18 18:34:52 -05:00
void execute(std::vector<std::string> args, RTLIL::Design *design) override
2013-01-05 04:13:26 -06:00
{
2016-04-21 16:28:37 -05:00
log_header(design, "Executing OPT_MERGE pass (detect identical cells).\n");
2013-01-05 04:13:26 -06:00
bool mode_nomux = false;
2015-05-31 07:24:34 -05:00
bool mode_share_all = false;
2013-01-05 04:13:26 -06:00
size_t argidx;
for (argidx = 1; argidx < args.size(); argidx++) {
std::string arg = args[argidx];
if (arg == "-nomux") {
mode_nomux = true;
continue;
}
2015-05-31 07:24:34 -05:00
if (arg == "-share_all") {
mode_share_all = true;
continue;
}
2013-01-05 04:13:26 -06:00
break;
}
extra_args(args, argidx, design);
int total_count = 0;
for (auto module : design->selected_modules()) {
2016-03-31 01:52:49 -05:00
OptMergeWorker worker(design, module, mode_nomux, mode_share_all);
2013-01-05 04:13:26 -06:00
total_count += worker.total_count;
}
2014-08-30 12:37:12 -05:00
if (total_count)
design->scratchpad_set_bool("opt.did_something", true);
2013-01-05 04:13:26 -06:00
log("Removed a total of %d cells.\n", total_count);
}
2016-03-31 01:52:49 -05:00
} OptMergePass;
2015-07-02 04:14:30 -05:00
2014-09-27 09:17:53 -05:00
PRIVATE_NAMESPACE_END