1/* 2 * Copyright (c) 2002-2005 The Regents of The University of Michigan 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions are 7 * met: redistributions of source code must retain the above copyright 8 * notice, this list of conditions and the following disclaimer; 9 * redistributions in binary form must reproduce the above copyright 10 * notice, this list of conditions and the following disclaimer in the 11 * documentation and/or other materials provided with the distribution; 12 * neither the name of the copyright holders nor the names of its 13 * contributors may be used to endorse or promote products derived from 14 * this software without specific prior written permission. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 17 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 18 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 19 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 20 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 21 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 22 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 26 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27 * 28 * Authors: Steve Reinhardt 29 */ 30 31/** 32 * @file 33 * Port object definitions. 34 */ 35#include <cstring> 36 37#include "base/chunk_generator.hh" 38#include "base/trace.hh" 39#include "mem/mem_object.hh" 40#include "mem/port.hh" 41
|
42/**
43 * Special class for port objects that are used as peers for
44 * unconnected ports. Assigning instances of this class to newly
45 * allocated ports allows us to guarantee that every port has a peer
46 * object (so there's no need to check for null peer pointers), while
47 * catching uses of unconnected ports.
48 */
|
42class DefaultPeerPort : public Port 43{ 44 protected: 45 void blowUp() 46 {
|
54 Port *peer = getPeer();
55 fatal("unconnected port: %s", peer ? peer->name() : "<unknown>");
|
47 fatal("%s: Unconnected port!", peer->name()); |
48 } 49 50 public:
|
59 DefaultPeerPort(Port *_peer)
60 : Port("default_port", NULL, _peer)
|
51 DefaultPeerPort() 52 : Port("default_port") |
53 { } 54 55 bool recvTiming(PacketPtr) 56 { 57 blowUp(); 58 return false; 59 } 60 61 Tick recvAtomic(PacketPtr) 62 { 63 blowUp(); 64 return 0; 65 } 66 67 void recvFunctional(PacketPtr) 68 { 69 blowUp(); 70 } 71 72 void recvStatusChange(Status) 73 { 74 blowUp(); 75 } 76 77 int deviceBlockSize() 78 { 79 blowUp(); 80 return 0; 81 } 82 83 void getDeviceAddressRanges(AddrRangeList &, bool &) 84 { 85 blowUp(); 86 } 87 88 bool isDefaultPort() const { return true; } 89}; 90
|
91DefaultPeerPort defaultPeerPort; |
92
|
100Port::Port(const std::string &_name, MemObject *_owner, Port *_peer) :
101 portName(_name),
102 peer(_peer ? _peer : new DefaultPeerPort(this)),
103 owner(_owner)
|
93Port::Port() 94 : peer(&defaultPeerPort), owner(NULL) |
95{ 96} 97
|
107Port::~Port()
|
98Port::Port(const std::string &_name, MemObject *_owner) 99 : portName(_name), peer(&defaultPeerPort), owner(_owner) |
100{
|
109 disconnectFromPeer();
|
101} 102
|
112void
113Port::disconnectFromPeer()
|
103Port::~Port() |
104{
|
115 if (peer) {
116 assert(peer->getPeer() == this);
117 peer->disconnect();
118 }
|
105} 106 107void
|
122Port::disconnect()
|
108Port::setPeer(Port *port) |
109{
|
124 // This notification should come only from our peer, so we must
125 // have one,
126 assert(peer != NULL);
127 // We must clear 'peer' here, else if owner->deletePort() calls
128 // delete on us then we'll recurse infinitely through the Port
129 // destructor.
130 peer = NULL;
131 // If owner->deletePort() returns true, then we've been deleted,
132 // so don't do anything but get out of here. If not, reset peer
133 // pointer to a DefaultPeerPort.
134 if (!(owner && owner->deletePort(this)))
135 peer = new DefaultPeerPort(this);
|
110 DPRINTF(Config, "setting peer to %s\n", port->name()); 111 112 peer = port; |
113} 114 115void
|
139Port::setPeer(Port *port)
|
116Port::removeConn() |
117{
|
141 DPRINTF(Config, "setting peer to %s, old peer %s\n",
142 port->name(), peer ? peer->name() : "<null>");
143
144 // You'd think we'd want to disconnect from the previous peer
145 // here, but it turns out that with some functional ports the old
146 // peer keeps using the connection, and it works because
147 // functional ports are unidirectional.
148 //
149 // disconnectFromPeer();
150
151 peer = port;
|
118 if (peer->getOwner()) 119 peer->getOwner()->deletePortRefs(peer); 120 peer = NULL; |
121} 122 123void 124Port::blobHelper(Addr addr, uint8_t *p, int size, MemCmd cmd) 125{ 126 Request req; 127 128 for (ChunkGenerator gen(addr, size, peerBlockSize()); 129 !gen.done(); gen.next()) { 130 req.setPhys(gen.addr(), gen.size(), 0); 131 Packet pkt(&req, cmd, Packet::Broadcast); 132 pkt.dataStatic(p); 133 sendFunctional(&pkt); 134 p += gen.size(); 135 } 136} 137 138void 139Port::writeBlob(Addr addr, uint8_t *p, int size) 140{ 141 blobHelper(addr, p, size, MemCmd::WriteReq); 142} 143 144void 145Port::readBlob(Addr addr, uint8_t *p, int size) 146{ 147 blobHelper(addr, p, size, MemCmd::ReadReq); 148} 149 150void 151Port::memsetBlob(Addr addr, uint8_t val, int size) 152{ 153 // quick and dirty... 154 uint8_t *buf = new uint8_t[size]; 155 156 std::memset(buf, val, size); 157 blobHelper(addr, buf, size, MemCmd::WriteReq); 158 159 delete [] buf; 160} 161 162 163void 164Port::printAddr(Addr a) 165{ 166 Request req(a, 1, 0); 167 Packet pkt(&req, MemCmd::PrintReq, Packet::Broadcast); 168 Packet::PrintReqState prs(std::cerr); 169 pkt.senderState = &prs; 170 171 sendFunctional(&pkt); 172}
|