source: latest/src/global_functions.cc @ 1

/*------------------------------------------------------------\
|                                                             |
| Tool    :                  systemcass                       |
|                                                             |
| File    :                 global_functions.cc               |
|                                                             |
| Author  :                 Buchmann Richard                  |
|                           Nicolas Pouillon                  |
|                                                             |
| Date    :                   21_09_2005                      |
|                                                             |
\------------------------------------------------------------*/

/* 
 * This file is part of the Disydent Project
 * Copyright (C) Laboratoire LIP6 - Département ASIM
 * Universite Pierre et Marie Curie
 * 
 * Home page          : http://www-asim.lip6.fr/disydent
 * E-mail             : mailto:richard.buchmann@lip6.fr
 * 
 * This library is free software; you  can redistribute it and/or modify it
 * under the terms  of the GNU Library General Public  License as published
 * by the Free Software Foundation; either version 2 of the License, or (at
 * your option) any later version.
 * 
 * Disydent is distributed  in the hope  that it  will be
 * useful, but WITHOUT  ANY WARRANTY; without even the  implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
 * Public License for more details.
 * 
 * You should have received a copy  of the GNU General Public License along
 * with the GNU C Library; see the  file COPYING. If not, write to the Free
 * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */

#include<iostream>
#include<dlfcn.h>
#include"schedulers.h" // get_scheduling & run_schedule_editor
#include"sc_module.h" // check_all_method_process
#include"gen_code.h"  // gen_scheduling_code_for_dynamic_link & gen_scheduling_code_for_static_func
#include"sc_clock_ext.h" // clock list
#include"usage.h"
#include"module_hierarchy2dot.h"
#include"assert.h"

using namespace std;

namespace sc_core {

const char *temporary_dir = "/tmp";
const char *generated_files_dir = "./generated_by_systemcass";

static usage_t usage;

/* ***************************** */
/* Dumping functions (for debug) */
/* ***************************** */

template <typename T>
ostream& operator << (ostream &o, const vector<T*> &v)
{
  typename vector<T*>::const_iterator i;
  for (i = v.begin(); i != v.end(); ++i) {
    o << **i << " ";
  }
  return o;
}

/* ************ */
/*  clock list  */
/****************/

typedef std::set<const sc_clock*> clock_list_t;

ostream& 
operator << (ostream &o,
             const clock_list_t &cl)
{
  clock_list_t::const_iterator i;
  for (i = cl.begin(); i != cl.end(); ++i) {
    o << (*i)->name () << " ";
  }
  return o;
}

// clock list
void 
create_clock_list (clock_list_t  &c,
                   const equi_list_t &el)
{
        equi_list_t::const_iterator i;
        for (i = el.begin (); i != el.end(); ++i) {
                equi_t::const_iterator j;
                for (j = i->begin (); j != i->end (); ++j) {
                        if (j->kind () == sc_clock::kind_string)
                                c.insert ((const sc_clock*)j->object);
          }
        }
}

/* ************ */
/*  functions   */
/****************/

// function pointer to the simulation core (compiled and linked dynamically)
evaluation_fct_t func_simulate_1_cycle = NULL;
evaluation_fct_t func_combinationals = NULL;

/* ************ */
/* dynamic link */
/* ************ */

static void *handle = NULL;

static
void 
link (const char *lib)
{
  // chargement du code de simulate_1_cycle
  handle = dlopen(lib, RTLD_GLOBAL | RTLD_NOW);
  //handle = dlopen(lib, RTLD_LAZY | RTLD_GLOBAL | RTLD_NOW);
  
  if (handle == NULL) {
    const char *error = dlerror ();
    if (error)
      fprintf (stderr, "dlopen: %s\n",error);
    fprintf (stderr, 
             "Is there -rdynamic option into your command line ? "
             "If not, please do it.\n");
    exit(18);
  }

  union uni_fct_t {
    evaluation_fct_t fct_type;
    void            *dl_pointer_type;
  };
  uni_fct_t        temp;  
  temp.dl_pointer_type = dlsym (handle,"initialize");
  if (temp.dl_pointer_type == NULL) {
    const char *error = dlerror ();
    if (error)
      fprintf (stderr, "dlsym: %s\n",error);
    exit(19);
  }
  evaluation_fct_t func_initialize;
  func_initialize = temp.fct_type;
  func_initialize ();

  temp.dl_pointer_type = dlsym (handle,"simulate_1_cycle");
  if (temp.dl_pointer_type == NULL) {
    const char *error = dlerror ();
    if (error)
      fprintf (stderr, "dlsym: %s\n",error);
    exit(20);
  }
  func_simulate_1_cycle = temp.fct_type;
  
  temp.dl_pointer_type = dlsym (handle,"mealy_generation");
  if (temp.dl_pointer_type == NULL) {
    const char *error = dlerror ();
    if (error)
      fprintf (stderr, "dlsym: %s\n",error);
    exit(21);
  }  
  func_combinationals = temp.fct_type;

  /*
   *
   */
  if (dump_stage)
    cerr << "dynamic link done\n";
}

static
void
unlink ()
{
  if (handle)
  {
    if (dlclose (handle) != 0)
      cerr << "Warning : dlclose returns an error.\n" 
           << dlerror () << endl;
    handle = NULL;
  }
}

/* ************ */
/* initializing */
/* ************ */

bool  already_initialized = false;

static
void
use_static_func ()
{
  if (dump_stage)
    cerr << "Using static functions to schedule SystemC processes.\n";
  if (scheduling_method == CASS_SCHEDULING)
  {
    func_simulate_1_cycle = (evaluation_fct_t)sc_core::quasistatic_simulate_1_cycle;
    func_combinationals   = (evaluation_fct_t)sc_core::quasistatic_mealy_generation;
  } else {
    func_simulate_1_cycle = (evaluation_fct_t)sc_core::static_simulate_1_cycle;
    func_combinationals   = (evaluation_fct_t)sc_core::static_mealy_generation;
  }
}

static
void
compile_and_link (const char *base_name)
{
  if (dump_stage)
    cerr << "Using dynamically loaded functions to schedule SystemC processes.\n";
  // compilation du code de simulate_1_cycle
  compile_code(base_name);
   
  char lib_absolutepath[256]; 
#if defined(darwin) //macosx)
  sprintf(lib_absolutepath, "/tmp/%s.so", base_name);
#elif defined(linux)
  sprintf(lib_absolutepath, "/tmp/%s.so", base_name);
#else
  cerr << "ERROR\n"; exit (126);
#endif
  
        link (lib_absolutepath);
}

static
void 
internal_sc_initialize (void) 
{
        sort_equi_list ();

  check_all_method_process ();

  if (dump_netlist_info)
    cerr << "Module instance list\n"
         << "--------------------\n" 
         << instances_set << endl;
  
  /*
   * Initialize the signals table
   */
  create_signals_table ();
  bind_to_table ();
  if (dump_netlist_info)
  {
    print_table (cerr);
    cerr << endl;
    print_table_stats (cerr);
    cerr << endl;
  }
  // Init variables to be able to run combinational functions
#ifdef CHECK_FSM_RULES
        casc_fsm_step = STIMULI;
#endif

  pending_write_vector_capacity = get_signal_table_size ();
#if 0
  cerr << "pending_write_vector_capacity = " << pending_write_vector_capacity
<< "\n";
#endif
  if (pending_write_vector_capacity == 0)
    pending_write_vector = NULL;
  else
                pending_write_vector = (pending_write_vector_t) realloc (pending_write_vector, sizeof (pending_write) * pending_write_vector_capacity);
        
  // create the clock list
        clock_list_t clock_list;
  create_clock_list (clock_list, get_equi_list ());
  if (dump_netlist_info)
    cerr << "Clock list\n"
         << "----------\n"
         << clock_list << "\n\n";

  // Check if a clock exists in the system
  if (clock_list.empty ()) {
    cerr << "System need a clock.\n"
         << "Please define system clock using special type \"sc_clock\".\n";
    exit (22);
  }

        // Check if any constructor wrote into registers
        if (pending_write_vector_nb != 0)
        {
                cerr << "Error : Register/Signal writing is not allowed before sc_initialize.\n"
                        "Move initializations from constructors/sc_main to module reset sequences.\n";
                // we are unable to dump register(s) name(s) 
                // because the table binding is not yet completed.
                exit (24);
        }
 
  string base_name = get_scheduling (scheduling_method);

  if (dynamic_link_of_scheduling_code)
    compile_and_link (base_name.c_str());
  else
    use_static_func ();
  
        pending_write_vector_nb = 0;
 
  check_all_ports ();
  usage.start ();
  if (dump_stage)
    cerr << "sc_initialize () done.\n";
  already_initialized = true;
}

inline
void
check_and_initialize ()
{
  if (already_initialized == false) {
#if defined(SYSTEMC_VERSION_1_0)
                std::cerr << "Warning : call sc_initialize before executiong simulation.\n";
#endif
    internal_sc_initialize ();
    if (dump_module_hierarchy)
      module_hierarchy2dot (dump_module_hierarchy);
    if (nosimulation)
    {
      exit (0);
    }
        }
}

void sc_initialize(void) 
{
  cerr << "Warning : 'sc_initialize' function is deprecated since SystemC 2.1.\n"; 
  cerr << "Use 'sc_start(0)' instead.\n"; 
  check_and_initialize ();
}

/* ********** */
/* simulating */
/* ********** */

inline 
void 
sc_cycle( double duration)
{
  check_and_initialize ();
  sc_core::internal_sc_cycle0(duration);
}

inline
void 
sc_cycle( double       duration,
          sc_time_unit time_unit )
{
  check_and_initialize ();
  sc_core::internal_sc_cycle0(duration);
}

void 
sc_start(double d_val) 
{
        sc_cycle (d_val);
#ifdef DUMP_SIGNAL_STATS
        print_registers_writing_stats (cerr);
#endif
#ifdef DUMP_SCHEDULE_STATS
        print_schedule_stats (cerr);
#endif
}

void
sc_start (double       d_val,
          sc_time_unit d_tu)
{
  sc_start (sc_time (d_val, d_tu));
}

void
sc_start( const sc_time& duration )
{
        sc_start ((double)duration);
}

/* ****************** */
/* stoping simulation */
/* ****************** */

bool         have_to_stop = false;
sc_stop_mode stop_mode    = SC_STOP_FINISH_DELTA;

void
sc_stop ()
{
  switch (stop_mode)
  {
  case SC_STOP_IMMEDIATE    :
    exit (54);
    break;
  case SC_STOP_FINISH_DELTA :
  default :
    have_to_stop = true;
    break;
  }
}

void
sc_set_stop_mode (sc_stop_mode new_mode)
{
  if (new_mode == SC_STOP_IMMEDIATE)
    stop_mode = SC_STOP_IMMEDIATE;
}

sc_stop_mode
sc_get_stop_mode ()
{
  return stop_mode;
}

void
close_systemcass ()
{
  unlink ();
  if (print_user_resources)
  {
    usage.stop ();
    unsigned int d = usage;
    cerr << "Performances\n"
            "------------\n";
    cerr << "Time elapsed (sec) : " << d << endl;
    cerr << "Cycles done        : " << nb_cycles << endl;
    //sc_simulation_time () << endl;
    if (d == 0)
      cerr << "Performance (c/s)  : N/A" << endl;
    else
      cerr << "Performance (c/s)  : " << nb_cycles / d << endl;
//    cerr << "Memory used        : " << usage.get_memory_size () << endl;
  }
}

/////////////////////////

} // end of sc_core namespace