module.cc revision 13191
112863Sgabeblack@google.com/* 212863Sgabeblack@google.com * Copyright 2018 Google, Inc. 312863Sgabeblack@google.com * 412863Sgabeblack@google.com * Redistribution and use in source and binary forms, with or without 512863Sgabeblack@google.com * modification, are permitted provided that the following conditions are 612863Sgabeblack@google.com * met: redistributions of source code must retain the above copyright 712863Sgabeblack@google.com * notice, this list of conditions and the following disclaimer; 812863Sgabeblack@google.com * redistributions in binary form must reproduce the above copyright 912863Sgabeblack@google.com * notice, this list of conditions and the following disclaimer in the 1012863Sgabeblack@google.com * documentation and/or other materials provided with the distribution; 1112863Sgabeblack@google.com * neither the name of the copyright holders nor the names of its 1212863Sgabeblack@google.com * contributors may be used to endorse or promote products derived from 1312863Sgabeblack@google.com * this software without specific prior written permission. 1412863Sgabeblack@google.com * 1512863Sgabeblack@google.com * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 1612863Sgabeblack@google.com * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 1712863Sgabeblack@google.com * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 1812863Sgabeblack@google.com * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 1912863Sgabeblack@google.com * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 2012863Sgabeblack@google.com * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 2112863Sgabeblack@google.com * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 2212863Sgabeblack@google.com * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 2312863Sgabeblack@google.com * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 2412863Sgabeblack@google.com * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 2512863Sgabeblack@google.com * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 2612863Sgabeblack@google.com * 2712863Sgabeblack@google.com * Authors: Gabe Black 2812863Sgabeblack@google.com */ 2912863Sgabeblack@google.com 3012863Sgabeblack@google.com#include "systemc/core/module.hh" 3112863Sgabeblack@google.com 3212950Sgabeblack@google.com#include <cassert> 3312863Sgabeblack@google.com 3412863Sgabeblack@google.com#include "base/logging.hh" 3513191Sgabeblack@google.com#include "systemc/ext/core/sc_export.hh" 3613091Sgabeblack@google.com#include "systemc/ext/core/sc_port.hh" 3713079Sgabeblack@google.com#include "systemc/ext/utils/sc_report_handler.hh" 3812863Sgabeblack@google.com 3912950Sgabeblack@google.comnamespace sc_gem5 4012863Sgabeblack@google.com{ 4112863Sgabeblack@google.com 4212863Sgabeblack@google.comnamespace 4312863Sgabeblack@google.com{ 4412863Sgabeblack@google.com 4512863Sgabeblack@google.comstd::list<Module *> _modules; 4612950Sgabeblack@google.comModule *_new_module; 4712863Sgabeblack@google.com 4813045Sgabeblack@google.comModule *_callbackModule = nullptr; 4913045Sgabeblack@google.com 5012863Sgabeblack@google.com} // anonymous namespace 5112863Sgabeblack@google.com 5213191Sgabeblack@google.comModule::Module(const char *name) : 5313191Sgabeblack@google.com _name(name), _sc_mod(nullptr), _obj(nullptr), _ended(false), 5413191Sgabeblack@google.com _deprecatedConstructor(false) 5512950Sgabeblack@google.com{ 5612950Sgabeblack@google.com panic_if(_new_module, "Previous module not finished.\n"); 5712950Sgabeblack@google.com _new_module = this; 5812950Sgabeblack@google.com} 5912950Sgabeblack@google.com 6013079Sgabeblack@google.comModule::~Module() 6113079Sgabeblack@google.com{ 6213079Sgabeblack@google.com if (_new_module == this) { 6313079Sgabeblack@google.com // Aborted module construction? 6413079Sgabeblack@google.com _new_module = nullptr; 6513079Sgabeblack@google.com } 6613079Sgabeblack@google.com allModules.remove(this); 6713079Sgabeblack@google.com} 6812982Sgabeblack@google.com 6912863Sgabeblack@google.comvoid 7012950Sgabeblack@google.comModule::finish(Object *this_obj) 7112863Sgabeblack@google.com{ 7212950Sgabeblack@google.com assert(!_obj); 7312950Sgabeblack@google.com _obj = this_obj; 7412863Sgabeblack@google.com _modules.push_back(this); 7512950Sgabeblack@google.com _new_module = nullptr; 7612982Sgabeblack@google.com // This is called from the constructor of this_obj, so it can't use 7712982Sgabeblack@google.com // dynamic cast. 7812982Sgabeblack@google.com sc_mod(static_cast<::sc_core::sc_module *>(this_obj->sc_obj())); 7913046Sgabeblack@google.com allModules.emplace_back(this); 8012863Sgabeblack@google.com} 8112863Sgabeblack@google.com 8212863Sgabeblack@google.comvoid 8312863Sgabeblack@google.comModule::pop() 8412863Sgabeblack@google.com{ 8512950Sgabeblack@google.com panic_if(!_modules.size(), "Popping from empty module list.\n"); 8612863Sgabeblack@google.com panic_if(_modules.back() != this, 8712863Sgabeblack@google.com "Popping module which isn't at the end of the module list.\n"); 8812950Sgabeblack@google.com panic_if(_new_module, "Pop with unfinished module.\n"); 8912950Sgabeblack@google.com _modules.pop_back(); 9012863Sgabeblack@google.com} 9112863Sgabeblack@google.com 9213091Sgabeblack@google.comvoid 9313091Sgabeblack@google.comModule::bindPorts(std::vector<const ::sc_core::sc_bind_proxy *> &proxies) 9413091Sgabeblack@google.com{ 9513091Sgabeblack@google.com panic_if(proxies.size() > ports.size(), 9613091Sgabeblack@google.com "Trying to bind %d interfaces/ports to %d ports.\n", 9713091Sgabeblack@google.com proxies.size(), ports.size()); 9813091Sgabeblack@google.com 9913091Sgabeblack@google.com auto proxyIt = proxies.begin(); 10013091Sgabeblack@google.com auto portIt = ports.begin(); 10113091Sgabeblack@google.com for (; proxyIt != proxies.end(); proxyIt++, portIt++) { 10213091Sgabeblack@google.com auto proxy = *proxyIt; 10313091Sgabeblack@google.com auto port = *portIt; 10413091Sgabeblack@google.com if (proxy->interface()) 10513091Sgabeblack@google.com port->vbind(*proxy->interface()); 10613091Sgabeblack@google.com else 10713091Sgabeblack@google.com port->vbind(*proxy->port()); 10813091Sgabeblack@google.com } 10913091Sgabeblack@google.com} 11013091Sgabeblack@google.com 11113191Sgabeblack@google.comvoid 11213191Sgabeblack@google.comModule::beforeEndOfElaboration() 11313191Sgabeblack@google.com{ 11413191Sgabeblack@google.com callbackModule(this); 11513191Sgabeblack@google.com _sc_mod->before_end_of_elaboration(); 11613191Sgabeblack@google.com for (auto p: ports) 11713191Sgabeblack@google.com p->before_end_of_elaboration(); 11813191Sgabeblack@google.com for (auto e: exports) 11913191Sgabeblack@google.com e->before_end_of_elaboration(); 12013191Sgabeblack@google.com callbackModule(nullptr); 12113191Sgabeblack@google.com} 12213191Sgabeblack@google.com 12313191Sgabeblack@google.comvoid 12413191Sgabeblack@google.comModule::endOfElaboration() 12513191Sgabeblack@google.com{ 12613191Sgabeblack@google.com if (_deprecatedConstructor && !_ended) { 12713191Sgabeblack@google.com std::string msg = csprintf("module '%s'", name()); 12813191Sgabeblack@google.com SC_REPORT_WARNING("(W509) module construction not properly completed: " 12913191Sgabeblack@google.com "did you forget to add a sc_module_name parameter to " 13013191Sgabeblack@google.com "your module constructor?", msg.c_str()); 13113191Sgabeblack@google.com } 13213191Sgabeblack@google.com callbackModule(this); 13313191Sgabeblack@google.com _sc_mod->end_of_elaboration(); 13413191Sgabeblack@google.com for (auto p: ports) 13513191Sgabeblack@google.com p->end_of_elaboration(); 13613191Sgabeblack@google.com for (auto e: exports) 13713191Sgabeblack@google.com e->end_of_elaboration(); 13813191Sgabeblack@google.com callbackModule(nullptr); 13913191Sgabeblack@google.com} 14013191Sgabeblack@google.com 14113191Sgabeblack@google.comvoid 14213191Sgabeblack@google.comModule::startOfSimulation() 14313191Sgabeblack@google.com{ 14413191Sgabeblack@google.com callbackModule(this); 14513191Sgabeblack@google.com _sc_mod->start_of_simulation(); 14613191Sgabeblack@google.com for (auto p: ports) 14713191Sgabeblack@google.com p->start_of_simulation(); 14813191Sgabeblack@google.com for (auto e: exports) 14913191Sgabeblack@google.com e->start_of_simulation(); 15013191Sgabeblack@google.com callbackModule(nullptr); 15113191Sgabeblack@google.com} 15213191Sgabeblack@google.com 15313191Sgabeblack@google.comvoid 15413191Sgabeblack@google.comModule::endOfSimulation() 15513191Sgabeblack@google.com{ 15613191Sgabeblack@google.com callbackModule(this); 15713191Sgabeblack@google.com _sc_mod->end_of_simulation(); 15813191Sgabeblack@google.com for (auto p: ports) 15913191Sgabeblack@google.com p->end_of_simulation(); 16013191Sgabeblack@google.com for (auto e: exports) 16113191Sgabeblack@google.com e->end_of_simulation(); 16213191Sgabeblack@google.com callbackModule(nullptr); 16313191Sgabeblack@google.com} 16413191Sgabeblack@google.com 16512863Sgabeblack@google.comModule * 16612950Sgabeblack@google.comcurrentModule() 16712863Sgabeblack@google.com{ 16812950Sgabeblack@google.com if (_modules.empty()) 16912950Sgabeblack@google.com return nullptr; 17012950Sgabeblack@google.com return _modules.back(); 17112863Sgabeblack@google.com} 17212863Sgabeblack@google.com 17312950Sgabeblack@google.comModule * 17413079Sgabeblack@google.comnewModuleChecked() 17513079Sgabeblack@google.com{ 17613079Sgabeblack@google.com if (!_new_module) { 17713079Sgabeblack@google.com SC_REPORT_ERROR("(E533) module name stack is empty: " 17813079Sgabeblack@google.com "did you forget to add a sc_module_name parameter to " 17913079Sgabeblack@google.com "your module constructor?", nullptr); 18013079Sgabeblack@google.com } 18113079Sgabeblack@google.com return _new_module; 18213079Sgabeblack@google.com} 18313079Sgabeblack@google.com 18413079Sgabeblack@google.comModule * 18512950Sgabeblack@google.comnewModule() 18612950Sgabeblack@google.com{ 18712950Sgabeblack@google.com return _new_module; 18812950Sgabeblack@google.com} 18912950Sgabeblack@google.com 19013045Sgabeblack@google.comvoid callbackModule(Module *m) { _callbackModule = m; } 19113045Sgabeblack@google.comModule *callbackModule() { return _callbackModule; } 19213045Sgabeblack@google.com 19313046Sgabeblack@google.comstd::list<Module *> allModules; 19412982Sgabeblack@google.com 19512950Sgabeblack@google.com} // namespace sc_gem5 196