diff --git a/common/arch_pybindings_shared.h b/common/arch_pybindings_shared.h index c2fe3e24..46f1f9be 100644 --- a/common/arch_pybindings_shared.h +++ b/common/arch_pybindings_shared.h @@ -9,6 +9,8 @@ readonly_wrapper, conv_from_str>::def_wrap(ctx_cls, "top_module"); +readonly_wrapper>::def_wrap(ctx_cls, "timing_result"); fn_wrapper_0a>::def_wrap( ctx_cls, "getNameDelimiter"); diff --git a/common/basectx.h b/common/basectx.h index dbfdf5ee..507f29cd 100644 --- a/common/basectx.h +++ b/common/basectx.h @@ -84,6 +84,9 @@ struct BaseCtx // Context meta data dict attrs; + // Fmax data post timing analysis + TimingResult timing_result; + Context *as_ctx = nullptr; // Has the frontend loaded a design? diff --git a/common/command.cc b/common/command.cc index 7f276193..c175cd27 100644 --- a/common/command.cc +++ b/common/command.cc @@ -173,6 +173,9 @@ po::options_description CommandHandler::getGeneralOptions() general.add_options()("router2-heatmap", po::value(), "prefix for router2 resource congestion heatmaps"); + general.add_options()("report", po::value(), + "write timing and utilization report in JSON format to file"); + general.add_options()("placed-svg", po::value(), "write render of placement to SVG file"); general.add_options()("routed-svg", po::value(), "write render of routing to SVG file"); @@ -424,6 +427,14 @@ int CommandHandler::executeMain(std::unique_ptr ctx) ctx->writeSDF(f, vm.count("sdf-cvc")); } + if (vm.count("report")) { + std::string filename = vm["report"].as(); + std::ofstream f(filename); + if (!f) + log_error("Failed to open report file '%s' for writing.\n", filename.c_str()); + ctx->writeReport(f); + } + #ifndef NO_PYTHON deinit_python(); #endif diff --git a/common/context.h b/common/context.h index 4468d3dd..1175caee 100644 --- a/common/context.h +++ b/common/context.h @@ -76,6 +76,10 @@ struct Context : Arch, DeterministicRNG // -------------------------------------------------------------- + // provided by report.cc + void writeReport(std::ostream &out) const; + // -------------------------------------------------------------- + uint32_t checksum() const; void check() const; diff --git a/common/nextpnr_types.h b/common/nextpnr_types.h index bbf61934..1cae3dbe 100644 --- a/common/nextpnr_types.h +++ b/common/nextpnr_types.h @@ -217,6 +217,18 @@ struct ClockConstraint DelayPair period; }; +struct ClockFmax +{ + float achieved; + float constraint; +}; + +struct TimingResult +{ + // Achieved and target Fmax for all clock domains + dict clock_fmax; +}; + // Represents the contents of a non-leaf cell in a design // with hierarchy diff --git a/common/pybindings.cc b/common/pybindings.cc index bdd4f92a..2f672a41 100644 --- a/common/pybindings.cc +++ b/common/pybindings.cc @@ -285,8 +285,16 @@ PYBIND11_EMBEDDED_MODULE(MODULE_NAME, m) WRAP_MAP(m, WireMap, wrap_context, "WireMap"); WRAP_MAP_UPTR(m, RegionMap, "RegionMap"); - WRAP_VECTOR(m, PortRefVector, wrap_context); + typedef dict ClockFmaxMap; + WRAP_MAP(m, ClockFmaxMap, pass_through, "ClockFmaxMap"); + auto clk_fmax_cls = py::class_(m, "ClockFmax") + .def_readonly("achieved", &ClockFmax::achieved) + .def_readonly("constraint", &ClockFmax::constraint); + + auto tmg_result_cls = py::class_>(m, "TimingResult"); + readonly_wrapper>::def_wrap(tmg_result_cls, "clock_fmax"); arch_wrap_python(m); } diff --git a/common/report.cc b/common/report.cc new file mode 100644 index 00000000..4b3b2418 --- /dev/null +++ b/common/report.cc @@ -0,0 +1,68 @@ +/* + * nextpnr -- Next Generation Place and Route + * + * Copyright (C) 2021 gatecat + * + * 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. + * + */ + +#include "json11.hpp" +#include "nextpnr.h" + +NEXTPNR_NAMESPACE_BEGIN + +using namespace json11; + +namespace { +dict> get_utilization(const Context *ctx) +{ + // Sort by Bel type + dict> result; + for (auto &cell : ctx->cells) { + result[ctx->getBelBucketName(ctx->getBelBucketForCellType(cell.second.get()->type))].first++; + } + for (auto bel : ctx->getBels()) { + if (!ctx->getBelHidden(bel)) { + result[ctx->getBelBucketName(ctx->getBelBucketForBel(bel))].second++; + } + } + return result; +} +} // namespace +void Context::writeReport(std::ostream &out) const +{ + auto util = get_utilization(this); + dict util_json; + for (const auto &kv : util) { + util_json[kv.first.str(this)] = Json::object{ + {"used", kv.second.first}, + {"available", kv.second.second}, + }; + } + dict fmax_json; + for (const auto &kv : timing_result.clock_fmax) { + fmax_json[kv.first.str(this)] = Json::object{ + {"achieved", kv.second.achieved}, + {"constraint", kv.second.constraint}, + }; + } + out << Json(Json::object{ + {"utilization", util_json}, + {"fmax", fmax_json}, + }) + .dump() + << std::endl; +} + +NEXTPNR_NAMESPACE_END diff --git a/common/timing.cc b/common/timing.cc index d110498c..0cdb5be2 100644 --- a/common/timing.cc +++ b/common/timing.cc @@ -1315,6 +1315,8 @@ void timing_analysis(Context *ctx, bool print_histogram, bool print_fmax, bool p if (print_fmax) { log_break(); unsigned max_width = 0; + auto &result = ctx->timing_result; + result.clock_fmax.clear(); for (auto &clock : clock_reports) max_width = std::max(max_width, clock.first.str(ctx).size()); for (auto &clock : clock_reports) { @@ -1324,6 +1326,9 @@ void timing_analysis(Context *ctx, bool print_histogram, bool print_fmax, bool p if (ctx->nets.at(clock.first)->clkconstr) target = 1000 / ctx->getDelayNS(ctx->nets.at(clock.first)->clkconstr->period.minDelay()); + result.clock_fmax[clock.first].achieved = clock_fmax[clock.first]; + result.clock_fmax[clock.first].constraint = target; + bool passed = target < clock_fmax[clock.first]; if (!warn_on_failure || passed) log_info("Max frequency for clock %*s'%s': %.02f MHz (%s at %.02f MHz)\n", width, "", diff --git a/docs/report.md b/docs/report.md new file mode 100644 index 00000000..a766bb3d --- /dev/null +++ b/docs/report.md @@ -0,0 +1,22 @@ +# JSON Reports + +nextpnr can write a JSON report using `--report` post-place-and-route for integration with other build systems. It contains information on post-pack utilization and maximum achieved frequency for each clock domain, and is of the following format: + +``` +{ + "utilization": { + : { + "used": , + "available": + }, + ... + }, + "fmax": { + : { + "achieved": , + "constraint": + }, + ... + } +} +```