/* * nextpnr -- Next Generation Place and Route * * Copyright (C) 2018 Clifford Wolf * Copyright (C) 2018 Miodrag Milanovic * * 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. * */ #ifndef NO_GUI #include #include "application.h" #include "mainwindow.h" #endif #ifndef NO_PYTHON #include "pybindings.h" #endif #include #include #include #include #include #include #include "command.h" #include "design_utils.h" #include "jsonparse.h" #include "jsonwrite.h" #include "log.h" #include "timing.h" #include "util.h" #include "version.h" NEXTPNR_NAMESPACE_BEGIN CommandHandler::CommandHandler(int argc, char **argv) : argc(argc), argv(argv) { log_streams.clear(); } bool CommandHandler::parseOptions() { options.add(getGeneralOptions()).add(getArchOptions()); try { po::parsed_options parsed = po::command_line_parser(argc, argv) .style(po::command_line_style::default_style ^ po::command_line_style::allow_guessing) .options(options) .positional(pos) .run(); po::store(parsed, vm); po::notify(vm); return true; } catch (std::exception &e) { std::cout << e.what() << "\n"; return false; } } bool CommandHandler::executeBeforeContext() { if (vm.count("help") || argc == 1) { std::cerr << boost::filesystem::basename(argv[0]) << " -- Next Generation Place and Route (git sha1 " GIT_COMMIT_HASH_STR ")\n"; std::cerr << options << "\n"; return argc != 1; } if (vm.count("version")) { std::cerr << boost::filesystem::basename(argv[0]) << " -- Next Generation Place and Route (git sha1 " GIT_COMMIT_HASH_STR ")\n"; return true; } validate(); if (vm.count("quiet")) { log_streams.push_back(std::make_pair(&std::cerr, LogLevel::WARNING_MSG)); } else { log_streams.push_back(std::make_pair(&std::cerr, LogLevel::LOG_MSG)); } if (vm.count("log")) { std::string logfilename = vm["log"].as(); logfile.open(logfilename); if (!logfile.is_open()) log_error("Failed to open log file '%s' for writing.\n", logfilename.c_str()); log_streams.push_back(std::make_pair(&logfile, LogLevel::LOG_MSG)); } return false; } po::options_description CommandHandler::getGeneralOptions() { po::options_description general("General options"); general.add_options()("help,h", "show help"); general.add_options()("verbose,v", "verbose output"); general.add_options()("quiet,q", "quiet mode, only errors and warnings displayed"); general.add_options()("log,l", po::value(), "log file, all log messages are written to this file regardless of -q"); general.add_options()("debug", "debug output"); general.add_options()("force,f", "keep running after errors"); #ifndef NO_GUI general.add_options()("gui", "start gui"); general.add_options()("gui-no-aa", "disable anti aliasing (use together with --gui option)"); #endif #ifndef NO_PYTHON general.add_options()("run", po::value>(), "python file to execute instead of default flow"); pos.add("run", -1); general.add_options()("pre-pack", po::value>(), "python file to run before packing"); general.add_options()("pre-place", po::value>(), "python file to run before placement"); general.add_options()("pre-route", po::value>(), "python file to run before routing"); general.add_options()("post-route", po::value>(), "python file to run after routing"); #endif general.add_options()("json", po::value(), "JSON design file to ingest"); general.add_options()("write", po::value(), "JSON design file to write"); general.add_options()("seed", po::value(), "seed value for random number generator"); general.add_options()("randomize-seed,r", "randomize seed value for random number generator"); general.add_options()( "placer", po::value(), std::string("placer algorithm to use; available: " + boost::algorithm::join(Arch::availablePlacers, ", ") + "; default: " + Arch::defaultPlacer) .c_str()); general.add_options()("slack_redist_iter", po::value(), "number of iterations between slack redistribution"); general.add_options()("cstrweight", po::value(), "placer weighting for relative constraint satisfaction"); general.add_options()("starttemp", po::value(), "placer SA start temperature"); general.add_options()("placer-budgets", "use budget rather than criticality in placer timing weights"); general.add_options()("pack-only", "pack design only without placement or routing"); general.add_options()("no-route", "process design without routing"); general.add_options()("no-place", "process design without placement"); general.add_options()("no-pack", "process design without packing"); general.add_options()("ignore-loops", "ignore combinational loops in timing analysis"); general.add_options()("version,V", "show version"); general.add_options()("test", "check architecture database integrity"); general.add_options()("freq", po::value(), "set target frequency for design in MHz"); general.add_options()("timing-allow-fail", "allow timing to fail in design"); general.add_options()("no-tmdriv", "disable timing-driven placement"); general.add_options()("save", po::value(), "project file to write"); general.add_options()("load", po::value(), "project file to read"); return general; } void CommandHandler::setupContext(Context *ctx) { if (vm.count("verbose")) { ctx->verbose = true; } if (vm.count("debug")) { ctx->verbose = true; ctx->debug = true; } if (vm.count("force")) { ctx->force = true; } if (vm.count("seed")) { ctx->rngseed(vm["seed"].as()); } if (vm.count("randomize-seed")) { srand(time(NULL)); int r; do { r = rand(); } while (r == 0); ctx->rngseed(r); } if (vm.count("slack_redist_iter")) { ctx->slack_redist_iter = vm["slack_redist_iter"].as(); if (vm.count("freq") && vm["freq"].as() == 0) { ctx->auto_freq = true; #ifndef NO_GUI if (!vm.count("gui")) #endif log_warning("Target frequency not specified. Will optimise for max frequency.\n"); } } if (vm.count("ignore-loops")) { settings->set("timing/ignoreLoops", true); } if (vm.count("timing-allow-fail")) { settings->set("timing/allowFail", true); } if (vm.count("placer")) { std::string placer = vm["placer"].as(); if (std::find(Arch::availablePlacers.begin(), Arch::availablePlacers.end(), placer) == Arch::availablePlacers.end()) log_error("Placer algorithm '%s' is not supported (available options: %s)\n", placer.c_str(), boost::algorithm::join(Arch::availablePlacers, ", ").c_str()); settings->set("placer", placer); } else { settings->set("placer", Arch::defaultPlacer); } if (vm.count("cstrweight")) { settings->set("placer1/constraintWeight", vm["cstrweight"].as()); } if (vm.count("starttemp")) { settings->set("placer1/startTemp", vm["starttemp"].as()); } if (vm.count("placer-budgets")) { settings->set("placer1/budgetBased", true); } if (vm.count("freq")) { auto freq = vm["freq"].as(); if (freq > 0) ctx->target_freq = freq * 1e6; } ctx->timing_driven = true; if (vm.count("no-tmdriv")) ctx->timing_driven = false; } int CommandHandler::executeMain(std::unique_ptr ctx) { if (vm.count("test")) { ctx->archcheck(); return 0; } #ifndef NO_GUI if (vm.count("gui")) { Application a(argc, argv, (vm.count("gui-no-aa") > 0)); MainWindow w(std::move(ctx), chipArgs); try { if (vm.count("json")) { std::string filename = vm["json"].as(); std::ifstream f(filename); if (!parse_json_file(f, filename, w.getContext())) log_error("Loading design failed.\n"); customAfterLoad(w.getContext()); w.notifyChangeContext(); w.updateLoaded(); } else if (vm.count("load")) { w.projectLoad(vm["load"].as()); } else w.notifyChangeContext(); } catch (log_execution_error_exception) { // show error is handled by gui itself } w.show(); return a.exec(); } #endif if (vm.count("json")) { std::string filename = vm["json"].as(); std::ifstream f(filename); if (!parse_json_file(f, filename, ctx.get())) log_error("Loading design failed.\n"); customAfterLoad(ctx.get()); } #ifndef NO_PYTHON init_python(argv[0], true); python_export_global("ctx", *ctx); if (vm.count("run")) { std::vector files = vm["run"].as>(); for (auto filename : files) execute_python_file(filename.c_str()); } else #endif if (vm.count("json") || vm.count("load")) { bool do_pack = vm.count("pack-only")!=0 || vm.count("no-pack")==0; bool do_place = vm.count("pack-only")==0 && vm.count("no-place")==0; bool do_route = vm.count("pack-only")==0 && vm.count("no-route")==0; if (do_pack) { run_script_hook("pre-pack"); if (!ctx->pack() && !ctx->force) log_error("Packing design failed.\n"); } assign_budget(ctx.get()); ctx->check(); print_utilisation(ctx.get()); if (do_place) { run_script_hook("pre-place"); if (!ctx->place() && !ctx->force) log_error("Placing design failed.\n"); ctx->check(); } if (do_route) { run_script_hook("pre-route"); if (!ctx->route() && !ctx->force) log_error("Routing design failed.\n"); run_script_hook("post-route"); } customBitstream(ctx.get()); } if (vm.count("write")) { std::string filename = vm["write"].as(); std::ofstream f(filename); if (!write_json_file(f, filename, ctx.get())) log_error("Saving design failed.\n"); } if (vm.count("save")) { project.save(ctx.get(), vm["save"].as()); } #ifndef NO_PYTHON deinit_python(); #endif return had_nonfatal_error ? 1 : 0; } void CommandHandler::conflicting_options(const boost::program_options::variables_map &vm, const char *opt1, const char *opt2) { if (vm.count(opt1) && !vm[opt1].defaulted() && vm.count(opt2) && !vm[opt2].defaulted()) { std::string msg = "Conflicting options '" + std::string(opt1) + "' and '" + std::string(opt2) + "'."; log_error("%s\n", msg.c_str()); } } void CommandHandler::printFooter() { int warning_count = get_or_default(message_count_by_level, LogLevel::WARNING_MSG, 0), error_count = get_or_default(message_count_by_level, LogLevel::ERROR_MSG, 0); if (warning_count > 0 || error_count > 0) log_always("%d warning%s, %d error%s\n", warning_count, warning_count == 1 ? "" : "s", error_count, error_count == 1 ? "" : "s"); } int CommandHandler::exec() { try { if (!parseOptions()) return -1; if (executeBeforeContext()) return 0; std::unique_ptr ctx; if (vm.count("load") && vm.count("gui") == 0) { ctx = project.load(vm["load"].as()); } else { ctx = createContext(); } settings = std::unique_ptr(new Settings(ctx.get())); setupContext(ctx.get()); setupArchContext(ctx.get()); int rc = executeMain(std::move(ctx)); printFooter(); return rc; } catch (log_execution_error_exception) { printFooter(); return -1; } } void CommandHandler::run_script_hook(const std::string &name) { #ifndef NO_PYTHON if (vm.count(name)) { std::vector files = vm[name].as>(); for (auto filename : files) execute_python_file(filename.c_str()); } #endif } NEXTPNR_NAMESPACE_END