passes/proc/proc.cc

   1 /*
   2  *  yosys -- Yosys Open SYnthesis Suite
   3  *
   4  *  Copyright (C) 2012  Clifford Wolf <clifford@clifford.at>
   5  *
   6  *  Permission to use, copy, modify, and/or distribute this software for any
   7  *  purpose with or without fee is hereby granted, provided that the above
   8  *  copyright notice and this permission notice appear in all copies.
   9  *
  10  *  THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  11  *  WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  12  *  MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  13  *  ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  14  *  WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  15  *  ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  16  *  OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  17  *
  18  */
  19
  20 #include "kernel/register.h"
  21 #include "kernel/log.h"
  22 #include <stdlib.h>
  23 #include <stdio.h>
  24
  25 USING_YOSYS_NAMESPACE
  26 PRIVATE_NAMESPACE_BEGIN
  27
  28 struct ProcPass : public Pass {
  29         ProcPass() : Pass("proc", "translate processes to netlists") { }
  30         virtual void help()
  31         {
  32                 //   |---v---|---v---|---v---|---v---|---v---|---v---|---v---|---v---|---v---|---v---|
  33                 log("\n");
  34                 log("    proc [options] [selection]\n");
  35                 log("\n");
  36                 log("This pass calls all the other proc_* passes in the most common order.\n");
  37                 log("\n");
  38                 log("    proc_clean\n");
  39                 log("    proc_rmdead\n");
  40                 log("    proc_init\n");
  41                 log("    proc_arst\n");
  42                 log("    proc_mux\n");
  43                 log("    proc_dlatch\n");
  44                 log("    proc_dff\n");
  45                 log("    proc_clean\n");
  46                 log("\n");
  47                 log("This replaces the processes in the design with multiplexers,\n");
  48                 log("flip-flops and latches.\n");
  49                 log("\n");
  50                 log("The following options are supported:\n");
  51                 log("\n");
  52                 log("    -global_arst [!]<netname>\n");
  53                 log("        This option is passed through to proc_arst.\n");
  54                 log("\n");
  55         }
  56         virtual void execute(std::vector<std::string> args, RTLIL::Design *design)
  57         {
  58                 std::string global_arst;
  59
  60                 log_header(design, "Executing PROC pass (convert processes to netlists).\n");
  61                 log_push();
  62
  63                 size_t argidx;
  64                 for (argidx = 1; argidx < args.size(); argidx++)
  65                 {
  66                         if (args[argidx] == "-global_arst" && argidx+1 < args.size()) {
  67                                 global_arst = args[++argidx];
  68                                 continue;
  69                         }
  70                         break;
  71                 }
  72                 extra_args(args, argidx, design);
  73
  74                 Pass::call(design, "proc_clean");
  75                 Pass::call(design, "proc_rmdead");
  76                 Pass::call(design, "proc_init");
  77                 if (global_arst.empty())
  78                         Pass::call(design, "proc_arst");
  79                 else
  80                         Pass::call(design, "proc_arst -global_arst " + global_arst);
  81                 Pass::call(design, "proc_mux");
  82                 Pass::call(design, "proc_dlatch");
  83                 Pass::call(design, "proc_dff");
  84                 Pass::call(design, "proc_clean");
  85
  86                 log_pop();
  87         }
  88 } ProcPass;
  89
  90 PRIVATE_NAMESPACE_END