112027Sjungma@eit.uni-kl.de/*****************************************************************************
212027Sjungma@eit.uni-kl.de
312027Sjungma@eit.uni-kl.de  Licensed to Accellera Systems Initiative Inc. (Accellera) under one or
412027Sjungma@eit.uni-kl.de  more contributor license agreements.  See the NOTICE file distributed
512027Sjungma@eit.uni-kl.de  with this work for additional information regarding copyright ownership.
612027Sjungma@eit.uni-kl.de  Accellera licenses this file to you under the Apache License, Version 2.0
712027Sjungma@eit.uni-kl.de  (the "License"); you may not use this file except in compliance with the
812027Sjungma@eit.uni-kl.de  License.  You may obtain a copy of the License at
912027Sjungma@eit.uni-kl.de
1012027Sjungma@eit.uni-kl.de    http://www.apache.org/licenses/LICENSE-2.0
1112027Sjungma@eit.uni-kl.de
1212027Sjungma@eit.uni-kl.de  Unless required by applicable law or agreed to in writing, software
1312027Sjungma@eit.uni-kl.de  distributed under the License is distributed on an "AS IS" BASIS,
1412027Sjungma@eit.uni-kl.de  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
1512027Sjungma@eit.uni-kl.de  implied.  See the License for the specific language governing
1612027Sjungma@eit.uni-kl.de  permissions and limitations under the License.
1712027Sjungma@eit.uni-kl.de
1812027Sjungma@eit.uni-kl.de *****************************************************************************/
1912027Sjungma@eit.uni-kl.de
2012027Sjungma@eit.uni-kl.de/*****************************************************************************
2112027Sjungma@eit.uni-kl.de
2212027Sjungma@eit.uni-kl.de  sc_export.cpp --
2312027Sjungma@eit.uni-kl.de
2412027Sjungma@eit.uni-kl.de  Original Author: Bishnupriya Bhattachary, Cadence, Design Systems,
2512027Sjungma@eit.uni-kl.de                   25 August, 2003
2612027Sjungma@eit.uni-kl.de
2712027Sjungma@eit.uni-kl.de  CHANGE LOG IS AT THE END OF THE FILE
2812027Sjungma@eit.uni-kl.de *****************************************************************************/
2912027Sjungma@eit.uni-kl.de
3012027Sjungma@eit.uni-kl.de#include "sysc/communication/sc_export.h"
3112027Sjungma@eit.uni-kl.de#include "sysc/kernel/sc_simcontext.h"
3212027Sjungma@eit.uni-kl.de#include "sysc/kernel/sc_module.h"
3312027Sjungma@eit.uni-kl.de#include "sysc/kernel/sc_object_int.h"
3412027Sjungma@eit.uni-kl.de
3512027Sjungma@eit.uni-kl.denamespace sc_core {
3612027Sjungma@eit.uni-kl.de
3712027Sjungma@eit.uni-kl.de// ----------------------------------------------------------------------------
3812027Sjungma@eit.uni-kl.de//  CLASS : sc_export_base
3912027Sjungma@eit.uni-kl.de//
4012027Sjungma@eit.uni-kl.de// ----------------------------------------------------------------------------
4112027Sjungma@eit.uni-kl.de
4212027Sjungma@eit.uni-kl.desc_export_base::sc_export_base() : sc_object(sc_gen_unique_name("export"))
4312027Sjungma@eit.uni-kl.de{
4412027Sjungma@eit.uni-kl.de    simcontext()->get_export_registry()->insert(this);
4512027Sjungma@eit.uni-kl.de}
4612027Sjungma@eit.uni-kl.de
4712027Sjungma@eit.uni-kl.desc_export_base::sc_export_base(const char* name_) : sc_object(name_)
4812027Sjungma@eit.uni-kl.de{
4912027Sjungma@eit.uni-kl.de    simcontext()->get_export_registry()->insert(this);
5012027Sjungma@eit.uni-kl.de}
5112027Sjungma@eit.uni-kl.de
5212027Sjungma@eit.uni-kl.desc_export_base::~sc_export_base()
5312027Sjungma@eit.uni-kl.de{
5412027Sjungma@eit.uni-kl.de    simcontext()->get_export_registry()->remove(this);
5512027Sjungma@eit.uni-kl.de}
5612027Sjungma@eit.uni-kl.de
5712027Sjungma@eit.uni-kl.de// called by construction_done() (does nothing by default)
5812027Sjungma@eit.uni-kl.de
5912027Sjungma@eit.uni-kl.devoid
6012027Sjungma@eit.uni-kl.desc_export_base::before_end_of_elaboration()
6112027Sjungma@eit.uni-kl.de{
6212027Sjungma@eit.uni-kl.de}
6312027Sjungma@eit.uni-kl.de
6412027Sjungma@eit.uni-kl.de// called when construction is done
6512027Sjungma@eit.uni-kl.de
6612027Sjungma@eit.uni-kl.devoid
6712027Sjungma@eit.uni-kl.desc_export_base::construction_done()
6812027Sjungma@eit.uni-kl.de{
6912027Sjungma@eit.uni-kl.de    if ( get_interface() == 0 )
7012027Sjungma@eit.uni-kl.de    {
7112027Sjungma@eit.uni-kl.de      report_error( SC_ID_SC_EXPORT_NOT_BOUND_AFTER_CONSTRUCTION_, 0);
7212027Sjungma@eit.uni-kl.de    }
7312027Sjungma@eit.uni-kl.de
7412027Sjungma@eit.uni-kl.de    sc_module* parent = static_cast<sc_module*>( get_parent_object() );
7512027Sjungma@eit.uni-kl.de    sc_object::hierarchy_scope scope( parent );
7612027Sjungma@eit.uni-kl.de    before_end_of_elaboration();
7712027Sjungma@eit.uni-kl.de}
7812027Sjungma@eit.uni-kl.de
7912027Sjungma@eit.uni-kl.de// called by elaboration_done() (does nothing by default)
8012027Sjungma@eit.uni-kl.de
8112027Sjungma@eit.uni-kl.devoid
8212027Sjungma@eit.uni-kl.desc_export_base::end_of_elaboration()
8312027Sjungma@eit.uni-kl.de{}
8412027Sjungma@eit.uni-kl.de
8512027Sjungma@eit.uni-kl.de// called when elaboration is done
8612027Sjungma@eit.uni-kl.de
8712027Sjungma@eit.uni-kl.devoid
8812027Sjungma@eit.uni-kl.desc_export_base::elaboration_done()
8912027Sjungma@eit.uni-kl.de{
9012027Sjungma@eit.uni-kl.de    sc_module* parent = static_cast<sc_module*>( get_parent_object() );
9112027Sjungma@eit.uni-kl.de    sc_object::hierarchy_scope scope( parent );
9212027Sjungma@eit.uni-kl.de    end_of_elaboration();
9312027Sjungma@eit.uni-kl.de}
9412027Sjungma@eit.uni-kl.de
9512027Sjungma@eit.uni-kl.de// called by start_simulation (does nothing)
9612027Sjungma@eit.uni-kl.de
9712027Sjungma@eit.uni-kl.devoid
9812027Sjungma@eit.uni-kl.desc_export_base::start_of_simulation()
9912027Sjungma@eit.uni-kl.de{}
10012027Sjungma@eit.uni-kl.de
10112027Sjungma@eit.uni-kl.de// called before simulation starts
10212027Sjungma@eit.uni-kl.de
10312027Sjungma@eit.uni-kl.devoid
10412027Sjungma@eit.uni-kl.desc_export_base::start_simulation()
10512027Sjungma@eit.uni-kl.de{
10612027Sjungma@eit.uni-kl.de    sc_module* parent = static_cast<sc_module*>( get_parent_object() );
10712027Sjungma@eit.uni-kl.de    sc_object::hierarchy_scope scope( parent );
10812027Sjungma@eit.uni-kl.de    start_of_simulation();
10912027Sjungma@eit.uni-kl.de}
11012027Sjungma@eit.uni-kl.de
11112027Sjungma@eit.uni-kl.de// called by simulation_done (does nothing)
11212027Sjungma@eit.uni-kl.de
11312027Sjungma@eit.uni-kl.devoid
11412027Sjungma@eit.uni-kl.desc_export_base::end_of_simulation()
11512027Sjungma@eit.uni-kl.de{}
11612027Sjungma@eit.uni-kl.de
11712027Sjungma@eit.uni-kl.de// called after simulation ends
11812027Sjungma@eit.uni-kl.de
11912027Sjungma@eit.uni-kl.devoid
12012027Sjungma@eit.uni-kl.desc_export_base::simulation_done()
12112027Sjungma@eit.uni-kl.de{
12212027Sjungma@eit.uni-kl.de    sc_module* parent = static_cast<sc_module*>( get_parent_object() );
12312027Sjungma@eit.uni-kl.de    sc_object::hierarchy_scope scope( parent );
12412027Sjungma@eit.uni-kl.de    end_of_simulation();
12512027Sjungma@eit.uni-kl.de}
12612027Sjungma@eit.uni-kl.de
12712027Sjungma@eit.uni-kl.devoid
12812027Sjungma@eit.uni-kl.desc_export_base::report_error( const char* id, const char* add_msg ) const
12912027Sjungma@eit.uni-kl.de{
13012027Sjungma@eit.uni-kl.de    char msg[BUFSIZ];
13112027Sjungma@eit.uni-kl.de    if( add_msg != 0 ) {
13212027Sjungma@eit.uni-kl.de        std::sprintf( msg, "%s: export '%s' (%s)", add_msg, name(), kind() );
13312027Sjungma@eit.uni-kl.de    } else {
13412027Sjungma@eit.uni-kl.de        std::sprintf( msg, "export '%s' (%s)", name(), kind() );
13512027Sjungma@eit.uni-kl.de    }
13612027Sjungma@eit.uni-kl.de    SC_REPORT_ERROR( id, msg );
13712027Sjungma@eit.uni-kl.de}
13812027Sjungma@eit.uni-kl.de
13912027Sjungma@eit.uni-kl.de
14012027Sjungma@eit.uni-kl.de// ----------------------------------------------------------------------------
14112027Sjungma@eit.uni-kl.de//  CLASS : sc_export_registry
14212027Sjungma@eit.uni-kl.de//
14312027Sjungma@eit.uni-kl.de//  Registry for all exports.
14412027Sjungma@eit.uni-kl.de//  FOR INTERNAL USE ONLY!
14512027Sjungma@eit.uni-kl.de// ----------------------------------------------------------------------------
14612027Sjungma@eit.uni-kl.de
14712027Sjungma@eit.uni-kl.devoid
14812027Sjungma@eit.uni-kl.desc_export_registry::insert( sc_export_base* export_ )
14912027Sjungma@eit.uni-kl.de{
15012027Sjungma@eit.uni-kl.de    if( sc_is_running() ) {
15112027Sjungma@eit.uni-kl.de	export_->report_error(SC_ID_INSERT_EXPORT_, "simulation running");
15212027Sjungma@eit.uni-kl.de    }
15312027Sjungma@eit.uni-kl.de
15412027Sjungma@eit.uni-kl.de    if( m_simc->elaboration_done()  ) {
15512027Sjungma@eit.uni-kl.de       export_->report_error(SC_ID_INSERT_EXPORT_, "elaboration done");
15612027Sjungma@eit.uni-kl.de    }
15712027Sjungma@eit.uni-kl.de
15812027Sjungma@eit.uni-kl.de
15912027Sjungma@eit.uni-kl.de#ifdef DEBUG_SYSTEMC
16012027Sjungma@eit.uni-kl.de    // check if port_ is already inserted
16112027Sjungma@eit.uni-kl.de    for( int i = size() - 1; i >= 0; -- i ) {
16212027Sjungma@eit.uni-kl.de	if( export_ == m_export_vec[i] ) {
16312027Sjungma@eit.uni-kl.de	    export_->report_error( SC_ID_INSERT_EXPORT_,
16412027Sjungma@eit.uni-kl.de	                           "export already inserted ");
16512027Sjungma@eit.uni-kl.de	}
16612027Sjungma@eit.uni-kl.de    }
16712027Sjungma@eit.uni-kl.de#endif
16812027Sjungma@eit.uni-kl.de
16912027Sjungma@eit.uni-kl.de/*
17012027Sjungma@eit.uni-kl.de    //TBD:  maybe we want to do this stuf for later
17112027Sjungma@eit.uni-kl.de
17212027Sjungma@eit.uni-kl.de    // append the port to the current module's vector of ports
17312027Sjungma@eit.uni-kl.de    sc_module* curr_module = m_simc->hierarchy_curr();
17412027Sjungma@eit.uni-kl.de    if( curr_module == 0 ) {
17512027Sjungma@eit.uni-kl.de	port_->report_error( SC_ID_PORT_OUTSIDE_MODULE_ );
17612027Sjungma@eit.uni-kl.de    }
17712027Sjungma@eit.uni-kl.de    curr_module->append_port( port_ );
17812027Sjungma@eit.uni-kl.de*/
17912027Sjungma@eit.uni-kl.de
18012027Sjungma@eit.uni-kl.de    // insert
18112027Sjungma@eit.uni-kl.de    m_export_vec.push_back( export_ );
18212027Sjungma@eit.uni-kl.de}
18312027Sjungma@eit.uni-kl.de
18412027Sjungma@eit.uni-kl.devoid
18512027Sjungma@eit.uni-kl.desc_export_registry::remove( sc_export_base* export_ )
18612027Sjungma@eit.uni-kl.de{
18712027Sjungma@eit.uni-kl.de    if (size()==0) return;
18812027Sjungma@eit.uni-kl.de    int i;
18912027Sjungma@eit.uni-kl.de    for( i = size() - 1; i >= 0; -- i ) {
19012027Sjungma@eit.uni-kl.de	if( export_ == m_export_vec[i] ) {
19112027Sjungma@eit.uni-kl.de	    break;
19212027Sjungma@eit.uni-kl.de	}
19312027Sjungma@eit.uni-kl.de    }
19412027Sjungma@eit.uni-kl.de    if( i == -1 ) {
19512027Sjungma@eit.uni-kl.de	export_->report_error( SC_ID_SC_EXPORT_NOT_REGISTERED_ );
19612027Sjungma@eit.uni-kl.de    }
19712027Sjungma@eit.uni-kl.de
19812027Sjungma@eit.uni-kl.de    // remove
19912027Sjungma@eit.uni-kl.de    m_export_vec[i] = m_export_vec[size() - 1];
20012027Sjungma@eit.uni-kl.de    m_export_vec.resize(size()-1);
20112027Sjungma@eit.uni-kl.de}
20212027Sjungma@eit.uni-kl.de
20312027Sjungma@eit.uni-kl.de// constructor
20412027Sjungma@eit.uni-kl.de
20512027Sjungma@eit.uni-kl.desc_export_registry::sc_export_registry( sc_simcontext& simc_ )
20612027Sjungma@eit.uni-kl.de: m_construction_done(0),
20712027Sjungma@eit.uni-kl.de  m_export_vec(),
20812027Sjungma@eit.uni-kl.de  m_simc( &simc_ )
20912027Sjungma@eit.uni-kl.de{
21012027Sjungma@eit.uni-kl.de}
21112027Sjungma@eit.uni-kl.de
21212027Sjungma@eit.uni-kl.de
21312027Sjungma@eit.uni-kl.de// destructor
21412027Sjungma@eit.uni-kl.de
21512027Sjungma@eit.uni-kl.desc_export_registry::~sc_export_registry()
21612027Sjungma@eit.uni-kl.de{
21712027Sjungma@eit.uni-kl.de}
21812027Sjungma@eit.uni-kl.de
21912027Sjungma@eit.uni-kl.de// called when construction is done
22012027Sjungma@eit.uni-kl.de
22112027Sjungma@eit.uni-kl.debool
22212027Sjungma@eit.uni-kl.desc_export_registry::construction_done()
22312027Sjungma@eit.uni-kl.de{
22412027Sjungma@eit.uni-kl.de    if( m_construction_done == size() )
22512027Sjungma@eit.uni-kl.de      // nothing has been updated
22612027Sjungma@eit.uni-kl.de      return true;
22712027Sjungma@eit.uni-kl.de
22812027Sjungma@eit.uni-kl.de    for( int i = size()-1; i >= m_construction_done; --i ) {
22912027Sjungma@eit.uni-kl.de	m_export_vec[i]->construction_done();
23012027Sjungma@eit.uni-kl.de    }
23112027Sjungma@eit.uni-kl.de
23212027Sjungma@eit.uni-kl.de    m_construction_done = size();
23312027Sjungma@eit.uni-kl.de    return false;
23412027Sjungma@eit.uni-kl.de}
23512027Sjungma@eit.uni-kl.de
23612027Sjungma@eit.uni-kl.de// called when elaboration is done
23712027Sjungma@eit.uni-kl.de
23812027Sjungma@eit.uni-kl.devoid
23912027Sjungma@eit.uni-kl.desc_export_registry::elaboration_done()
24012027Sjungma@eit.uni-kl.de{
24112027Sjungma@eit.uni-kl.de    for( int i = size() - 1; i >= 0; -- i ) {
24212027Sjungma@eit.uni-kl.de	m_export_vec[i]->elaboration_done();
24312027Sjungma@eit.uni-kl.de    }
24412027Sjungma@eit.uni-kl.de}
24512027Sjungma@eit.uni-kl.de
24612027Sjungma@eit.uni-kl.de// called before simulation begins
24712027Sjungma@eit.uni-kl.de
24812027Sjungma@eit.uni-kl.devoid
24912027Sjungma@eit.uni-kl.desc_export_registry::start_simulation()
25012027Sjungma@eit.uni-kl.de{
25112027Sjungma@eit.uni-kl.de    for( int i = size() - 1; i >= 0; -- i ) {
25212027Sjungma@eit.uni-kl.de	m_export_vec[i]->start_simulation();
25312027Sjungma@eit.uni-kl.de    }
25412027Sjungma@eit.uni-kl.de}
25512027Sjungma@eit.uni-kl.de
25612027Sjungma@eit.uni-kl.devoid
25712027Sjungma@eit.uni-kl.desc_export_registry::simulation_done()
25812027Sjungma@eit.uni-kl.de{
25912027Sjungma@eit.uni-kl.de    for( int i = size() - 1; i >= 0; -- i ) {
26012027Sjungma@eit.uni-kl.de	m_export_vec[i]->simulation_done();
26112027Sjungma@eit.uni-kl.de    }
26212027Sjungma@eit.uni-kl.de}
26312027Sjungma@eit.uni-kl.de
26412027Sjungma@eit.uni-kl.de} // namespace sc_core
26512027Sjungma@eit.uni-kl.de
26612027Sjungma@eit.uni-kl.de// $Log: sc_export.cpp,v $
26712027Sjungma@eit.uni-kl.de// Revision 1.8  2011/08/26 20:45:40  acg
26812027Sjungma@eit.uni-kl.de//  Andy Goodrich: moved the modification log to the end of the file to
26912027Sjungma@eit.uni-kl.de//  eliminate source line number skew when check-ins are done.
27012027Sjungma@eit.uni-kl.de//
27112027Sjungma@eit.uni-kl.de// Revision 1.7  2011/08/24 22:05:36  acg
27212027Sjungma@eit.uni-kl.de//  Torsten Maehne: initialization changes to remove warnings.
27312027Sjungma@eit.uni-kl.de//
27412027Sjungma@eit.uni-kl.de// Revision 1.6  2011/05/09 04:07:37  acg
27512027Sjungma@eit.uni-kl.de//  Philipp A. Hartmann:
27612027Sjungma@eit.uni-kl.de//    (1) Restore hierarchy in all phase callbacks.
27712027Sjungma@eit.uni-kl.de//    (2) Ensure calls to before_end_of_elaboration.
27812027Sjungma@eit.uni-kl.de//
27912027Sjungma@eit.uni-kl.de// Revision 1.5  2011/02/18 20:31:05  acg
28012027Sjungma@eit.uni-kl.de//  Philipp A. Hartmann: added error messages for calls that cannot be done
28112027Sjungma@eit.uni-kl.de//  after elaboration.
28212027Sjungma@eit.uni-kl.de//
28312027Sjungma@eit.uni-kl.de// Revision 1.4  2011/02/18 20:23:45  acg
28412027Sjungma@eit.uni-kl.de//  Andy Goodrich: Copyright update.
28512027Sjungma@eit.uni-kl.de//
28612027Sjungma@eit.uni-kl.de// Revision 1.3  2011/02/18 20:07:04  acg
28712027Sjungma@eit.uni-kl.de//  Philipp A. Hartmann: Patch to revert to sprintf from snprintf to keep
28812027Sjungma@eit.uni-kl.de//  some versions of MSVC happy.
28912027Sjungma@eit.uni-kl.de//
29012027Sjungma@eit.uni-kl.de// Revision 1.2  2011/02/14 17:50:16  acg
29112027Sjungma@eit.uni-kl.de//  Andy Goodrich: testing for sc_port and sc_export instantiations during
29212027Sjungma@eit.uni-kl.de//  end of elaboration and issuing appropriate error messages.
29312027Sjungma@eit.uni-kl.de//
29412027Sjungma@eit.uni-kl.de// Revision 1.1.1.1  2006/12/15 20:20:04  acg
29512027Sjungma@eit.uni-kl.de// SystemC 2.3
29612027Sjungma@eit.uni-kl.de//
29712027Sjungma@eit.uni-kl.de// Revision 1.4  2006/01/26 21:00:50  acg
29812027Sjungma@eit.uni-kl.de//  Andy Goodrich: conversion to use sc_event::notify(SC_ZERO_TIME) instead of
29912027Sjungma@eit.uni-kl.de//  sc_event::notify_delayed()
30012027Sjungma@eit.uni-kl.de//
30112027Sjungma@eit.uni-kl.de// Revision 1.3  2006/01/13 18:47:42  acg
30212027Sjungma@eit.uni-kl.de// Added $Log command so that CVS comments are reproduced in the source.
30312027Sjungma@eit.uni-kl.de//
30412027Sjungma@eit.uni-kl.de
30512027Sjungma@eit.uni-kl.de// Taf!
306