Switch.hh revision 6145
16145Snate@binkert.org 26145Snate@binkert.org/* 36145Snate@binkert.org * Copyright (c) 1999-2008 Mark D. Hill and David A. Wood 46145Snate@binkert.org * All rights reserved. 56145Snate@binkert.org * 66145Snate@binkert.org * Redistribution and use in source and binary forms, with or without 76145Snate@binkert.org * modification, are permitted provided that the following conditions are 86145Snate@binkert.org * met: redistributions of source code must retain the above copyright 96145Snate@binkert.org * notice, this list of conditions and the following disclaimer; 106145Snate@binkert.org * redistributions in binary form must reproduce the above copyright 116145Snate@binkert.org * notice, this list of conditions and the following disclaimer in the 126145Snate@binkert.org * documentation and/or other materials provided with the distribution; 136145Snate@binkert.org * neither the name of the copyright holders nor the names of its 146145Snate@binkert.org * contributors may be used to endorse or promote products derived from 156145Snate@binkert.org * this software without specific prior written permission. 166145Snate@binkert.org * 176145Snate@binkert.org * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 186145Snate@binkert.org * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 196145Snate@binkert.org * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 206145Snate@binkert.org * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 216145Snate@binkert.org * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 226145Snate@binkert.org * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 236145Snate@binkert.org * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 246145Snate@binkert.org * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 256145Snate@binkert.org * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 266145Snate@binkert.org * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 276145Snate@binkert.org * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 286145Snate@binkert.org */ 296145Snate@binkert.org 306145Snate@binkert.org/* 316145Snate@binkert.org * $Id$ 326145Snate@binkert.org * 336145Snate@binkert.org * Description: The actual modelled switch. It use the perfect switch and a 346145Snate@binkert.org * Throttle object to control and bandwidth and timing *only for 356145Snate@binkert.org * the output port*. So here we have un-realistic modelling, 366145Snate@binkert.org * since the order of PerfectSwitch and Throttle objects get 376145Snate@binkert.org * woke up affect the message timing. A more accurate model would 386145Snate@binkert.org * be having two set of system states, one for this cycle, one for 396145Snate@binkert.org * next cycle. And on the cycle boundary swap the two set of 406145Snate@binkert.org * states. 416145Snate@binkert.org * 426145Snate@binkert.org */ 436145Snate@binkert.org 446145Snate@binkert.org#ifndef Switch_H 456145Snate@binkert.org#define Switch_H 466145Snate@binkert.org 476145Snate@binkert.org#include "Global.hh" 486145Snate@binkert.org#include "Vector.hh" 496145Snate@binkert.org 506145Snate@binkert.orgclass MessageBuffer; 516145Snate@binkert.orgclass PerfectSwitch; 526145Snate@binkert.orgclass NetDest; 536145Snate@binkert.orgclass SimpleNetwork; 546145Snate@binkert.orgclass Throttle; 556145Snate@binkert.org 566145Snate@binkert.orgclass Switch { 576145Snate@binkert.orgpublic: 586145Snate@binkert.org // Constructors 596145Snate@binkert.org 606145Snate@binkert.org // constructor specifying the number of ports 616145Snate@binkert.org Switch(SwitchID sid, SimpleNetwork* network_ptr); 626145Snate@binkert.org void addInPort(const Vector<MessageBuffer*>& in); 636145Snate@binkert.org void addOutPort(const Vector<MessageBuffer*>& out, const NetDest& routing_table_entry, int link_latency, int bw_multiplier); 646145Snate@binkert.org const Throttle* getThrottle(LinkID link_number) const; 656145Snate@binkert.org const Vector<Throttle*>* getThrottles() const; 666145Snate@binkert.org void clearRoutingTables(); 676145Snate@binkert.org void clearBuffers(); 686145Snate@binkert.org void reconfigureOutPort(const NetDest& routing_table_entry); 696145Snate@binkert.org 706145Snate@binkert.org void printStats(ostream& out) const; 716145Snate@binkert.org void clearStats(); 726145Snate@binkert.org void printConfig(ostream& out) const; 736145Snate@binkert.org 746145Snate@binkert.org // Destructor 756145Snate@binkert.org ~Switch(); 766145Snate@binkert.org 776145Snate@binkert.org void print(ostream& out) const; 786145Snate@binkert.orgprivate: 796145Snate@binkert.org 806145Snate@binkert.org // Private copy constructor and assignment operator 816145Snate@binkert.org Switch(const Switch& obj); 826145Snate@binkert.org Switch& operator=(const Switch& obj); 836145Snate@binkert.org 846145Snate@binkert.org // Data Members (m_ prefix) 856145Snate@binkert.org PerfectSwitch* m_perfect_switch_ptr; 866145Snate@binkert.org Vector<Throttle*> m_throttles; 876145Snate@binkert.org Vector<MessageBuffer*> m_buffers_to_free; 886145Snate@binkert.org SwitchID m_switch_id; 896145Snate@binkert.org}; 906145Snate@binkert.org 916145Snate@binkert.org// Output operator declaration 926145Snate@binkert.orgostream& operator<<(ostream& out, const Switch& obj); 936145Snate@binkert.org 946145Snate@binkert.org// ******************* Definitions ******************* 956145Snate@binkert.org 966145Snate@binkert.org// Output operator definition 976145Snate@binkert.orgextern inline 986145Snate@binkert.orgostream& operator<<(ostream& out, const Switch& obj) 996145Snate@binkert.org{ 1006145Snate@binkert.org obj.print(out); 1016145Snate@binkert.org out << flush; 1026145Snate@binkert.org return out; 1036145Snate@binkert.org} 1046145Snate@binkert.org 1056145Snate@binkert.org#endif //Switch_H 106