RubyPort.hh revision 10919
16876Ssteve.reinhardt@amd.com/* 210089Sandreas.hansson@arm.com * Copyright (c) 2012-2013 ARM Limited 38922Swilliam.wang@arm.com * All rights reserved. 48922Swilliam.wang@arm.com * 58922Swilliam.wang@arm.com * The license below extends only to copyright in the software and shall 68922Swilliam.wang@arm.com * not be construed as granting a license to any other intellectual 78922Swilliam.wang@arm.com * property including but not limited to intellectual property relating 88922Swilliam.wang@arm.com * to a hardware implementation of the functionality of the software 98922Swilliam.wang@arm.com * licensed hereunder. You may use the software subject to the license 108922Swilliam.wang@arm.com * terms below provided that you ensure that this notice is replicated 118922Swilliam.wang@arm.com * unmodified and in its entirety in all distributions of the software, 128922Swilliam.wang@arm.com * modified or unmodified, in source code or in binary form. 138922Swilliam.wang@arm.com * 146876Ssteve.reinhardt@amd.com * Copyright (c) 2009 Advanced Micro Devices, Inc. 158717Snilay@cs.wisc.edu * Copyright (c) 2011 Mark D. Hill and David A. Wood 166876Ssteve.reinhardt@amd.com * All rights reserved. 176876Ssteve.reinhardt@amd.com * 186876Ssteve.reinhardt@amd.com * Redistribution and use in source and binary forms, with or without 196876Ssteve.reinhardt@amd.com * modification, are permitted provided that the following conditions are 206876Ssteve.reinhardt@amd.com * met: redistributions of source code must retain the above copyright 216876Ssteve.reinhardt@amd.com * notice, this list of conditions and the following disclaimer; 226876Ssteve.reinhardt@amd.com * redistributions in binary form must reproduce the above copyright 236876Ssteve.reinhardt@amd.com * notice, this list of conditions and the following disclaimer in the 246876Ssteve.reinhardt@amd.com * documentation and/or other materials provided with the distribution; 256876Ssteve.reinhardt@amd.com * neither the name of the copyright holders nor the names of its 266876Ssteve.reinhardt@amd.com * contributors may be used to endorse or promote products derived from 276876Ssteve.reinhardt@amd.com * this software without specific prior written permission. 286876Ssteve.reinhardt@amd.com * 296876Ssteve.reinhardt@amd.com * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 306876Ssteve.reinhardt@amd.com * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 316876Ssteve.reinhardt@amd.com * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 326876Ssteve.reinhardt@amd.com * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 336876Ssteve.reinhardt@amd.com * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 346876Ssteve.reinhardt@amd.com * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 356876Ssteve.reinhardt@amd.com * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 366876Ssteve.reinhardt@amd.com * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 376876Ssteve.reinhardt@amd.com * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 386876Ssteve.reinhardt@amd.com * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 396876Ssteve.reinhardt@amd.com * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 406876Ssteve.reinhardt@amd.com */ 416876Ssteve.reinhardt@amd.com 427039Snate@binkert.org#ifndef __MEM_RUBY_SYSTEM_RUBYPORT_HH__ 437039Snate@binkert.org#define __MEM_RUBY_SYSTEM_RUBYPORT_HH__ 446285Snate@binkert.org 457039Snate@binkert.org#include <cassert> 466285Snate@binkert.org#include <string> 476285Snate@binkert.org 486922SBrad.Beckmann@amd.com#include "mem/protocol/RequestStatus.hh" 4910301Snilay@cs.wisc.edu#include "mem/ruby/network/MessageBuffer.hh" 507909Shestness@cs.utexas.edu#include "mem/ruby/system/System.hh" 518229Snate@binkert.org#include "mem/mem_object.hh" 527039Snate@binkert.org#include "mem/tport.hh" 536876Ssteve.reinhardt@amd.com#include "params/RubyPort.hh" 546876Ssteve.reinhardt@amd.com 556876Ssteve.reinhardt@amd.comclass AbstractController; 566876Ssteve.reinhardt@amd.com 577039Snate@binkert.orgclass RubyPort : public MemObject 587039Snate@binkert.org{ 597039Snate@binkert.org public: 6010090Snilay@cs.wisc.edu class MemMasterPort : public QueuedMasterPort 6110090Snilay@cs.wisc.edu { 6210090Snilay@cs.wisc.edu private: 6310713Sandreas.hansson@arm.com ReqPacketQueue reqQueue; 6410713Sandreas.hansson@arm.com SnoopRespPacketQueue snoopRespQueue; 6510090Snilay@cs.wisc.edu 6610090Snilay@cs.wisc.edu public: 6710090Snilay@cs.wisc.edu MemMasterPort(const std::string &_name, RubyPort *_port); 6810090Snilay@cs.wisc.edu 6910090Snilay@cs.wisc.edu protected: 7010090Snilay@cs.wisc.edu bool recvTimingResp(PacketPtr pkt); 7110090Snilay@cs.wisc.edu void recvRangeChange() {} 7210090Snilay@cs.wisc.edu }; 7310090Snilay@cs.wisc.edu 7410090Snilay@cs.wisc.edu class MemSlavePort : public QueuedSlavePort 756882SBrad.Beckmann@amd.com { 767039Snate@binkert.org private: 7710713Sandreas.hansson@arm.com RespPacketQueue queue; 7810525Snilay@cs.wisc.edu bool access_backing_store; 796882SBrad.Beckmann@amd.com 806882SBrad.Beckmann@amd.com public: 8110090Snilay@cs.wisc.edu MemSlavePort(const std::string &_name, RubyPort *_port, 8210919Sbrandon.potter@amd.com bool _access_backing_store, PortID id); 836882SBrad.Beckmann@amd.com void hitCallback(PacketPtr pkt); 848717Snilay@cs.wisc.edu void evictionCallback(const Address& address); 856882SBrad.Beckmann@amd.com 866882SBrad.Beckmann@amd.com protected: 8710089Sandreas.hansson@arm.com bool recvTimingReq(PacketPtr pkt); 8810090Snilay@cs.wisc.edu 8910090Snilay@cs.wisc.edu Tick recvAtomic(PacketPtr pkt) 9010090Snilay@cs.wisc.edu { panic("RubyPort::MemSlavePort::recvAtomic() not implemented!\n"); } 9110090Snilay@cs.wisc.edu 9210089Sandreas.hansson@arm.com void recvFunctional(PacketPtr pkt); 9310090Snilay@cs.wisc.edu 9410090Snilay@cs.wisc.edu AddrRangeList getAddrRanges() const 9510090Snilay@cs.wisc.edu { AddrRangeList ranges; return ranges; } 966882SBrad.Beckmann@amd.com 976882SBrad.Beckmann@amd.com private: 9810089Sandreas.hansson@arm.com bool isPhysMemAddress(Addr addr) const; 996882SBrad.Beckmann@amd.com }; 1006882SBrad.Beckmann@amd.com 10110090Snilay@cs.wisc.edu class PioMasterPort : public QueuedMasterPort 1026882SBrad.Beckmann@amd.com { 1037039Snate@binkert.org private: 10410713Sandreas.hansson@arm.com ReqPacketQueue reqQueue; 10510713Sandreas.hansson@arm.com SnoopRespPacketQueue snoopRespQueue; 1068914Sandreas.hansson@arm.com 1076882SBrad.Beckmann@amd.com public: 10810090Snilay@cs.wisc.edu PioMasterPort(const std::string &_name, RubyPort *_port); 1096882SBrad.Beckmann@amd.com 1106882SBrad.Beckmann@amd.com protected: 11110090Snilay@cs.wisc.edu bool recvTimingResp(PacketPtr pkt); 11210090Snilay@cs.wisc.edu void recvRangeChange(); 1136882SBrad.Beckmann@amd.com }; 1146882SBrad.Beckmann@amd.com 11510090Snilay@cs.wisc.edu class PioSlavePort : public QueuedSlavePort 11610090Snilay@cs.wisc.edu { 11710090Snilay@cs.wisc.edu private: 11810713Sandreas.hansson@arm.com RespPacketQueue queue; 11910090Snilay@cs.wisc.edu 12010090Snilay@cs.wisc.edu public: 12110090Snilay@cs.wisc.edu PioSlavePort(const std::string &_name, RubyPort *_port); 12210090Snilay@cs.wisc.edu 12310090Snilay@cs.wisc.edu protected: 12410090Snilay@cs.wisc.edu bool recvTimingReq(PacketPtr pkt); 12510090Snilay@cs.wisc.edu 12610090Snilay@cs.wisc.edu Tick recvAtomic(PacketPtr pkt) 12710090Snilay@cs.wisc.edu { panic("recvAtomic not supported with ruby!"); } 12810090Snilay@cs.wisc.edu 12910090Snilay@cs.wisc.edu void recvFunctional(PacketPtr pkt) 13010090Snilay@cs.wisc.edu { panic("recvFunctional should never be called on pio slave port!"); } 13110090Snilay@cs.wisc.edu 13210090Snilay@cs.wisc.edu AddrRangeList getAddrRanges() const; 13310090Snilay@cs.wisc.edu }; 13410090Snilay@cs.wisc.edu 13510090Snilay@cs.wisc.edu struct SenderState : public Packet::SenderState 13610090Snilay@cs.wisc.edu { 13710090Snilay@cs.wisc.edu MemSlavePort *port; 13810090Snilay@cs.wisc.edu SenderState(MemSlavePort * _port) : port(_port) 13910090Snilay@cs.wisc.edu {} 14010090Snilay@cs.wisc.edu }; 14110090Snilay@cs.wisc.edu 1426876Ssteve.reinhardt@amd.com typedef RubyPortParams Params; 1436876Ssteve.reinhardt@amd.com RubyPort(const Params *p); 1446882SBrad.Beckmann@amd.com virtual ~RubyPort() {} 1456882SBrad.Beckmann@amd.com 1466882SBrad.Beckmann@amd.com void init(); 1476285Snate@binkert.org 1489294Sandreas.hansson@arm.com BaseMasterPort &getMasterPort(const std::string &if_name, 1499294Sandreas.hansson@arm.com PortID idx = InvalidPortID); 1509294Sandreas.hansson@arm.com BaseSlavePort &getSlavePort(const std::string &if_name, 1519294Sandreas.hansson@arm.com PortID idx = InvalidPortID); 1526876Ssteve.reinhardt@amd.com 1538615Snilay@cs.wisc.edu virtual RequestStatus makeRequest(PacketPtr pkt) = 0; 1548688Snilay@cs.wisc.edu virtual int outstandingCount() const = 0; 1558688Snilay@cs.wisc.edu virtual bool isDeadlockEventScheduled() const = 0; 1568688Snilay@cs.wisc.edu virtual void descheduleDeadlockEvent() = 0; 1576882SBrad.Beckmann@amd.com 1586882SBrad.Beckmann@amd.com // 1596882SBrad.Beckmann@amd.com // Called by the controller to give the sequencer a pointer. 1606882SBrad.Beckmann@amd.com // A pointer to the controller is needed for atomic support. 1616882SBrad.Beckmann@amd.com // 1626882SBrad.Beckmann@amd.com void setController(AbstractController* _cntrl) { m_controller = _cntrl; } 16310012Snilay@cs.wisc.edu uint32_t getId() { return m_version; } 16410913Sandreas.sandberg@arm.com DrainState drain() M5_ATTR_OVERRIDE; 1656285Snate@binkert.org 1667039Snate@binkert.org protected: 1677039Snate@binkert.org void ruby_hit_callback(PacketPtr pkt); 1688688Snilay@cs.wisc.edu void testDrainComplete(); 1698717Snilay@cs.wisc.edu void ruby_eviction_callback(const Address& address); 1706285Snate@binkert.org 17110089Sandreas.hansson@arm.com /** 17210089Sandreas.hansson@arm.com * Called by the PIO port when receiving a timing response. 17310089Sandreas.hansson@arm.com * 17410089Sandreas.hansson@arm.com * @param pkt Response packet 17510089Sandreas.hansson@arm.com * @param master_port_id Port id of the PIO port 17610089Sandreas.hansson@arm.com * 17710089Sandreas.hansson@arm.com * @return Whether successfully sent 17810089Sandreas.hansson@arm.com */ 17910089Sandreas.hansson@arm.com bool recvTimingResp(PacketPtr pkt, PortID master_port_id); 18010089Sandreas.hansson@arm.com 18110919Sbrandon.potter@amd.com RubySystem *m_ruby_system; 18210012Snilay@cs.wisc.edu uint32_t m_version; 1837039Snate@binkert.org AbstractController* m_controller; 1847039Snate@binkert.org MessageBuffer* m_mandatory_q_ptr; 1857910SBrad.Beckmann@amd.com bool m_usingRubyTester; 18610467Sandreas.hansson@arm.com System* system; 1876876Ssteve.reinhardt@amd.com 1887039Snate@binkert.org private: 18910090Snilay@cs.wisc.edu void addToRetryList(MemSlavePort * port) 1907910SBrad.Beckmann@amd.com { 19110875Spower.jg@gmail.com if (std::find(retryList.begin(), retryList.end(), port) != 19210875Spower.jg@gmail.com retryList.end()) return; 19310089Sandreas.hansson@arm.com retryList.push_back(port); 1947910SBrad.Beckmann@amd.com } 1957910SBrad.Beckmann@amd.com 19610090Snilay@cs.wisc.edu PioMasterPort pioMasterPort; 19710090Snilay@cs.wisc.edu PioSlavePort pioSlavePort; 19810090Snilay@cs.wisc.edu MemMasterPort memMasterPort; 19910090Snilay@cs.wisc.edu MemSlavePort memSlavePort; 20010090Snilay@cs.wisc.edu unsigned int gotAddrRanges; 20110090Snilay@cs.wisc.edu 2028922Swilliam.wang@arm.com /** Vector of M5 Ports attached to this Ruby port. */ 20310090Snilay@cs.wisc.edu typedef std::vector<MemSlavePort *>::iterator CpuPortIter; 20410090Snilay@cs.wisc.edu std::vector<MemSlavePort *> slave_ports; 20510090Snilay@cs.wisc.edu std::vector<PioMasterPort *> master_ports; 2068686Snilay@cs.wisc.edu 2077910SBrad.Beckmann@amd.com // 2087910SBrad.Beckmann@amd.com // Based on similar code in the M5 bus. Stores pointers to those ports 2097910SBrad.Beckmann@amd.com // that should be called when the Sequencer becomes available after a stall. 2107910SBrad.Beckmann@amd.com // 21110090Snilay@cs.wisc.edu std::vector<MemSlavePort *> retryList; 2126285Snate@binkert.org}; 2136285Snate@binkert.org 2147039Snate@binkert.org#endif // __MEM_RUBY_SYSTEM_RUBYPORT_HH__ 215