2004-02-11 22:07:55 +01:00
|
|
|
/*
|
2005-06-05 11:16:00 +02:00
|
|
|
* Copyright (c) 2004-2005 The Regents of The University of Michigan
|
2004-02-11 22:07:55 +01:00
|
|
|
* All rights reserved.
|
|
|
|
*
|
|
|
|
* Redistribution and use in source and binary forms, with or without
|
|
|
|
* modification, are permitted provided that the following conditions are
|
|
|
|
* met: redistributions of source code must retain the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer;
|
|
|
|
* redistributions in binary form must reproduce the above copyright
|
|
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
|
|
* documentation and/or other materials provided with the distribution;
|
|
|
|
* neither the name of the copyright holders nor the names of its
|
|
|
|
* contributors may be used to endorse or promote products derived from
|
|
|
|
* this software without specific prior written permission.
|
|
|
|
*
|
|
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
|
|
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
|
|
* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
|
|
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
|
|
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
|
|
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
|
|
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
|
|
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
2006-06-01 01:26:56 +02:00
|
|
|
*
|
|
|
|
* Authors: Ali Saidi
|
|
|
|
* Nathan Binkert
|
2004-02-11 22:07:55 +01:00
|
|
|
*/
|
|
|
|
|
2005-01-15 10:12:25 +01:00
|
|
|
#ifndef __DEV_IO_DEVICE_HH__
|
|
|
|
#define __DEV_IO_DEVICE_HH__
|
2004-02-11 22:07:55 +01:00
|
|
|
|
2008-03-24 06:08:02 +01:00
|
|
|
#include "base/fast_alloc.hh"
|
2006-04-11 19:42:47 +02:00
|
|
|
#include "mem/mem_object.hh"
|
2006-10-20 08:38:45 +02:00
|
|
|
#include "mem/packet.hh"
|
2006-07-21 01:03:47 +02:00
|
|
|
#include "mem/tport.hh"
|
2007-07-24 06:51:38 +02:00
|
|
|
#include "params/BasicPioDevice.hh"
|
|
|
|
#include "params/DmaDevice.hh"
|
|
|
|
#include "params/PioDevice.hh"
|
2006-10-20 08:38:45 +02:00
|
|
|
#include "sim/sim_object.hh"
|
2004-02-11 22:07:55 +01:00
|
|
|
|
2006-08-30 18:57:46 +02:00
|
|
|
class Event;
|
2005-01-15 10:12:25 +01:00
|
|
|
class Platform;
|
2006-01-31 20:20:39 +01:00
|
|
|
class PioDevice;
|
2006-03-21 21:45:31 +01:00
|
|
|
class DmaDevice;
|
2006-04-06 20:57:51 +02:00
|
|
|
class System;
|
2006-03-21 21:45:31 +01:00
|
|
|
|
|
|
|
/**
|
|
|
|
* The PioPort class is a programmed i/o port that all devices that are
|
|
|
|
* sensitive to an address range use. The port takes all the memory
|
|
|
|
* access types and roles them into one read() and write() call that the device
|
|
|
|
* must respond to. The device must also provide the addressRanges() function
|
2006-08-30 18:57:46 +02:00
|
|
|
* with which it returns the address ranges it is interested in.
|
|
|
|
*/
|
2006-07-21 01:03:47 +02:00
|
|
|
class PioPort : public SimpleTimingPort
|
2004-02-11 22:07:55 +01:00
|
|
|
{
|
|
|
|
protected:
|
2006-03-21 21:45:31 +01:00
|
|
|
/** The device that this port serves. */
|
2006-01-31 20:20:39 +01:00
|
|
|
PioDevice *device;
|
|
|
|
|
2006-10-20 09:10:12 +02:00
|
|
|
virtual Tick recvAtomic(PacketPtr pkt);
|
2006-01-31 20:20:39 +01:00
|
|
|
|
2006-08-30 18:57:46 +02:00
|
|
|
virtual void getDeviceAddressRanges(AddrRangeList &resp,
|
2007-05-22 08:36:09 +02:00
|
|
|
bool &snoop);
|
2006-01-31 20:20:39 +01:00
|
|
|
|
|
|
|
public:
|
2006-07-13 02:22:07 +02:00
|
|
|
|
2006-08-31 01:24:26 +02:00
|
|
|
PioPort(PioDevice *dev, System *s, std::string pname = "-pioport");
|
2006-01-31 20:20:39 +01:00
|
|
|
};
|
|
|
|
|
2006-04-20 23:14:30 +02:00
|
|
|
|
2006-06-18 17:10:08 +02:00
|
|
|
class DmaPort : public Port
|
2006-04-20 23:14:30 +02:00
|
|
|
{
|
2006-06-18 17:10:08 +02:00
|
|
|
protected:
|
2008-03-24 06:08:02 +01:00
|
|
|
struct DmaReqState : public Packet::SenderState, public FastAlloc
|
2006-06-18 17:10:08 +02:00
|
|
|
{
|
|
|
|
/** Event to call on the device when this transaction (all packets)
|
|
|
|
* complete. */
|
|
|
|
Event *completionEvent;
|
2006-06-09 01:43:50 +02:00
|
|
|
|
2006-06-18 17:10:08 +02:00
|
|
|
/** Where we came from for some sanity checking. */
|
|
|
|
Port *outPort;
|
2006-06-09 01:43:50 +02:00
|
|
|
|
2006-06-18 17:10:08 +02:00
|
|
|
/** Total number of bytes that this transaction involves. */
|
|
|
|
Addr totBytes;
|
2006-06-09 01:43:50 +02:00
|
|
|
|
2006-06-18 17:10:08 +02:00
|
|
|
/** Number of bytes that have been acked for this transaction. */
|
|
|
|
Addr numBytes;
|
2006-06-09 01:43:50 +02:00
|
|
|
|
2008-08-13 23:41:56 +02:00
|
|
|
/** Amount to delay completion of dma by */
|
|
|
|
Tick delay;
|
|
|
|
|
2010-06-02 19:58:16 +02:00
|
|
|
|
2008-08-13 23:41:56 +02:00
|
|
|
DmaReqState(Event *ce, Port *p, Addr tb, Tick _delay)
|
|
|
|
: completionEvent(ce), outPort(p), totBytes(tb), numBytes(0),
|
|
|
|
delay(_delay)
|
2006-06-18 17:10:08 +02:00
|
|
|
{}
|
|
|
|
};
|
2006-04-20 23:14:30 +02:00
|
|
|
|
2010-06-02 19:58:16 +02:00
|
|
|
MemObject *device;
|
2006-10-20 09:10:12 +02:00
|
|
|
std::list<PacketPtr> transmitList;
|
2006-01-31 20:20:39 +01:00
|
|
|
|
2006-07-13 02:22:07 +02:00
|
|
|
/** The system that device/port are in. This is used to select which mode
|
2006-04-20 23:14:30 +02:00
|
|
|
* we are currently operating in. */
|
2006-07-13 02:22:07 +02:00
|
|
|
System *sys;
|
2006-04-20 23:14:30 +02:00
|
|
|
|
|
|
|
/** Number of outstanding packets the dma port has. */
|
|
|
|
int pendingCount;
|
2006-01-31 20:20:39 +01:00
|
|
|
|
2006-07-13 02:22:07 +02:00
|
|
|
/** If a dmaAction is in progress. */
|
|
|
|
int actionInProgress;
|
|
|
|
|
|
|
|
/** If we need to drain, keep the drain event around until we're done
|
|
|
|
* here.*/
|
|
|
|
Event *drainEvent;
|
|
|
|
|
2007-05-10 00:20:24 +02:00
|
|
|
/** time to wait between sending another packet, increases as NACKs are
|
|
|
|
* recived, decreases as responses are recived. */
|
|
|
|
Tick backoffTime;
|
|
|
|
|
2010-06-02 19:58:16 +02:00
|
|
|
/** Minimum time that device should back off for after failed sendTiming */
|
|
|
|
Tick minBackoffDelay;
|
|
|
|
|
|
|
|
/** Maximum time that device should back off for after failed sendTiming */
|
|
|
|
Tick maxBackoffDelay;
|
|
|
|
|
2007-05-10 00:20:24 +02:00
|
|
|
/** If the port is currently waiting for a retry before it can send whatever
|
|
|
|
* it is that it's sending. */
|
|
|
|
bool inRetry;
|
|
|
|
|
2006-10-20 09:10:12 +02:00
|
|
|
virtual bool recvTiming(PacketPtr pkt);
|
|
|
|
virtual Tick recvAtomic(PacketPtr pkt)
|
2007-01-27 00:48:51 +01:00
|
|
|
{ panic("dma port shouldn't be used for pio access."); M5_DUMMY_RETURN }
|
2006-10-20 09:10:12 +02:00
|
|
|
virtual void recvFunctional(PacketPtr pkt)
|
2006-01-31 20:20:39 +01:00
|
|
|
{ panic("dma port shouldn't be used for pio access."); }
|
|
|
|
|
|
|
|
virtual void recvStatusChange(Status status)
|
|
|
|
{ ; }
|
|
|
|
|
2006-05-31 00:57:42 +02:00
|
|
|
virtual void recvRetry() ;
|
2006-01-31 20:20:39 +01:00
|
|
|
|
2006-08-30 18:57:46 +02:00
|
|
|
virtual void getDeviceAddressRanges(AddrRangeList &resp,
|
2007-05-22 08:36:09 +02:00
|
|
|
bool &snoop)
|
|
|
|
{ resp.clear(); snoop = false; }
|
2006-01-31 20:20:39 +01:00
|
|
|
|
2007-05-10 00:20:24 +02:00
|
|
|
void queueDma(PacketPtr pkt, bool front = false);
|
|
|
|
void sendDma();
|
|
|
|
|
|
|
|
/** event to give us a kick every time we backoff time is reached. */
|
|
|
|
EventWrapper<DmaPort, &DmaPort::sendDma> backoffEvent;
|
2006-03-21 21:45:31 +01:00
|
|
|
|
2006-01-31 20:20:39 +01:00
|
|
|
public:
|
2010-06-02 19:58:16 +02:00
|
|
|
DmaPort(MemObject *dev, System *s, Tick min_backoff, Tick max_backoff);
|
2006-04-20 23:14:30 +02:00
|
|
|
|
2006-05-26 20:17:33 +02:00
|
|
|
void dmaAction(Packet::Command cmd, Addr addr, int size, Event *event,
|
2010-08-23 18:18:41 +02:00
|
|
|
uint8_t *data, Tick delay, Request::Flags flag = 0);
|
2006-04-20 23:14:30 +02:00
|
|
|
|
|
|
|
bool dmaPending() { return pendingCount > 0; }
|
2006-01-31 20:20:39 +01:00
|
|
|
|
2009-06-05 08:21:12 +02:00
|
|
|
unsigned cacheBlockSize() const { return peerBlockSize(); }
|
2006-07-13 02:22:07 +02:00
|
|
|
unsigned int drain(Event *de);
|
2006-01-31 20:20:39 +01:00
|
|
|
};
|
|
|
|
|
2006-03-21 21:45:31 +01:00
|
|
|
/**
|
|
|
|
* This device is the base class which all devices senstive to an address range
|
|
|
|
* inherit from. There are three pure virtual functions which all devices must
|
|
|
|
* implement addressRanges(), read(), and write(). The magic do choose which
|
|
|
|
* mode we are in, etc is handled by the PioPort so the device doesn't have to
|
|
|
|
* bother.
|
|
|
|
*/
|
2006-04-11 19:42:47 +02:00
|
|
|
class PioDevice : public MemObject
|
2006-01-31 20:20:39 +01:00
|
|
|
{
|
|
|
|
protected:
|
|
|
|
|
2006-03-21 21:45:31 +01:00
|
|
|
/** The platform we are in. This is used to decide what type of memory
|
|
|
|
* transaction we should perform. */
|
2005-01-15 10:12:25 +01:00
|
|
|
Platform *platform;
|
2006-01-31 20:20:39 +01:00
|
|
|
|
2006-07-13 02:22:07 +02:00
|
|
|
System *sys;
|
|
|
|
|
2006-03-21 21:45:31 +01:00
|
|
|
/** The pioPort that handles the requests for us and provides us requests
|
|
|
|
* that it sees. */
|
2006-01-31 20:20:39 +01:00
|
|
|
PioPort *pioPort;
|
|
|
|
|
2006-04-06 06:51:46 +02:00
|
|
|
virtual void addressRanges(AddrRangeList &range_list) = 0;
|
2006-01-31 20:20:39 +01:00
|
|
|
|
2006-08-30 18:57:46 +02:00
|
|
|
/** Pure virtual function that the device must implement. Called
|
|
|
|
* when a read command is recieved by the port.
|
2006-04-07 00:04:49 +02:00
|
|
|
* @param pkt Packet describing this request
|
|
|
|
* @return number of ticks it took to complete
|
|
|
|
*/
|
2006-10-20 09:10:12 +02:00
|
|
|
virtual Tick read(PacketPtr pkt) = 0;
|
2006-01-31 20:20:39 +01:00
|
|
|
|
2006-03-21 21:45:31 +01:00
|
|
|
/** Pure virtual function that the device must implement. Called when a
|
2006-04-07 00:04:49 +02:00
|
|
|
* write command is recieved by the port.
|
|
|
|
* @param pkt Packet describing this request
|
|
|
|
* @return number of ticks it took to complete
|
|
|
|
*/
|
2006-10-20 09:10:12 +02:00
|
|
|
virtual Tick write(PacketPtr pkt) = 0;
|
2004-02-11 22:07:55 +01:00
|
|
|
|
|
|
|
public:
|
2007-07-24 06:51:38 +02:00
|
|
|
typedef PioDeviceParams Params;
|
|
|
|
PioDevice(const Params *p);
|
2004-02-11 22:07:55 +01:00
|
|
|
virtual ~PioDevice();
|
2006-01-31 20:20:39 +01:00
|
|
|
|
2007-07-24 06:51:38 +02:00
|
|
|
const Params *
|
|
|
|
params() const
|
|
|
|
{
|
|
|
|
return dynamic_cast<const Params *>(_params);
|
|
|
|
}
|
|
|
|
|
2006-04-10 20:40:22 +02:00
|
|
|
virtual void init();
|
|
|
|
|
2006-07-13 02:22:07 +02:00
|
|
|
virtual unsigned int drain(Event *de);
|
|
|
|
|
2006-06-14 05:19:28 +02:00
|
|
|
virtual Port *getPort(const std::string &if_name, int idx = -1)
|
2006-01-31 20:20:39 +01:00
|
|
|
{
|
2006-04-06 06:51:46 +02:00
|
|
|
if (if_name == "pio") {
|
2006-03-30 00:37:25 +02:00
|
|
|
if (pioPort != NULL)
|
2008-09-30 08:30:14 +02:00
|
|
|
fatal("%s: pio port already connected to %s",
|
|
|
|
name(), pioPort->getPeer()->name());
|
2006-07-13 02:22:07 +02:00
|
|
|
pioPort = new PioPort(this, sys);
|
2006-01-31 20:20:39 +01:00
|
|
|
return pioPort;
|
2006-04-06 06:51:46 +02:00
|
|
|
} else
|
2006-01-31 20:20:39 +01:00
|
|
|
return NULL;
|
|
|
|
}
|
2006-03-21 21:45:31 +01:00
|
|
|
friend class PioPort;
|
|
|
|
|
2004-02-11 22:07:55 +01:00
|
|
|
};
|
|
|
|
|
2006-03-30 00:37:25 +02:00
|
|
|
class BasicPioDevice : public PioDevice
|
|
|
|
{
|
|
|
|
protected:
|
|
|
|
/** Address that the device listens to. */
|
|
|
|
Addr pioAddr;
|
|
|
|
|
|
|
|
/** Size that the device's address range. */
|
2006-04-06 06:51:46 +02:00
|
|
|
Addr pioSize;
|
2006-03-30 00:37:25 +02:00
|
|
|
|
|
|
|
/** Delay that the device experinces on an access. */
|
|
|
|
Tick pioDelay;
|
|
|
|
|
|
|
|
public:
|
2007-07-24 06:51:38 +02:00
|
|
|
typedef BasicPioDeviceParams Params;
|
|
|
|
BasicPioDevice(const Params *p);
|
|
|
|
|
|
|
|
const Params *
|
|
|
|
params() const
|
|
|
|
{
|
|
|
|
return dynamic_cast<const Params *>(_params);
|
|
|
|
}
|
2006-03-30 00:37:25 +02:00
|
|
|
|
2006-04-10 20:14:06 +02:00
|
|
|
/** return the address ranges that this device responds to.
|
2006-08-15 01:25:07 +02:00
|
|
|
* @param range_list range list to populate with ranges
|
2006-04-10 20:14:06 +02:00
|
|
|
*/
|
2006-04-11 19:42:47 +02:00
|
|
|
void addressRanges(AddrRangeList &range_list);
|
2006-04-10 20:14:06 +02:00
|
|
|
|
2006-03-30 00:37:25 +02:00
|
|
|
};
|
|
|
|
|
2004-02-11 22:07:55 +01:00
|
|
|
class DmaDevice : public PioDevice
|
|
|
|
{
|
2007-05-10 00:20:24 +02:00
|
|
|
protected:
|
2006-01-31 20:20:39 +01:00
|
|
|
DmaPort *dmaPort;
|
2004-02-11 22:07:55 +01:00
|
|
|
|
|
|
|
public:
|
2007-07-24 06:51:38 +02:00
|
|
|
typedef DmaDeviceParams Params;
|
|
|
|
DmaDevice(const Params *p);
|
2004-02-11 22:07:55 +01:00
|
|
|
virtual ~DmaDevice();
|
2006-01-31 20:20:39 +01:00
|
|
|
|
2007-07-24 06:51:38 +02:00
|
|
|
const Params *
|
|
|
|
params() const
|
|
|
|
{
|
|
|
|
return dynamic_cast<const Params *>(_params);
|
|
|
|
}
|
|
|
|
|
2008-08-13 23:41:56 +02:00
|
|
|
void dmaWrite(Addr addr, int size, Event *event, uint8_t *data, Tick delay = 0)
|
2007-02-07 19:53:37 +01:00
|
|
|
{
|
2008-08-13 23:41:56 +02:00
|
|
|
dmaPort->dmaAction(MemCmd::WriteReq, addr, size, event, data, delay);
|
2007-02-07 19:53:37 +01:00
|
|
|
}
|
2006-04-20 23:14:30 +02:00
|
|
|
|
2008-08-13 23:41:56 +02:00
|
|
|
void dmaRead(Addr addr, int size, Event *event, uint8_t *data, Tick delay = 0)
|
2007-03-22 23:39:41 +01:00
|
|
|
{
|
2008-08-13 23:41:56 +02:00
|
|
|
dmaPort->dmaAction(MemCmd::ReadReq, addr, size, event, data, delay);
|
2007-03-22 23:39:41 +01:00
|
|
|
}
|
2006-04-20 23:14:30 +02:00
|
|
|
|
|
|
|
bool dmaPending() { return dmaPort->dmaPending(); }
|
|
|
|
|
2006-07-13 02:22:07 +02:00
|
|
|
virtual unsigned int drain(Event *de);
|
|
|
|
|
2009-06-05 08:21:12 +02:00
|
|
|
unsigned cacheBlockSize() const { return dmaPort->cacheBlockSize(); }
|
2007-03-22 23:39:41 +01:00
|
|
|
|
2006-06-14 05:19:28 +02:00
|
|
|
virtual Port *getPort(const std::string &if_name, int idx = -1)
|
2006-01-31 20:20:39 +01:00
|
|
|
{
|
2006-04-20 23:14:30 +02:00
|
|
|
if (if_name == "pio") {
|
|
|
|
if (pioPort != NULL)
|
2008-09-30 08:30:14 +02:00
|
|
|
fatal("%s: pio port already connected to %s",
|
|
|
|
name(), pioPort->getPeer()->name());
|
2006-07-13 02:22:07 +02:00
|
|
|
pioPort = new PioPort(this, sys);
|
2006-01-31 20:20:39 +01:00
|
|
|
return pioPort;
|
2006-04-20 23:14:30 +02:00
|
|
|
} else if (if_name == "dma") {
|
|
|
|
if (dmaPort != NULL)
|
2008-09-30 08:30:14 +02:00
|
|
|
fatal("%s: dma port already connected to %s",
|
2008-11-10 23:45:31 +01:00
|
|
|
name(), dmaPort->getPeer()->name());
|
2010-06-02 19:58:16 +02:00
|
|
|
dmaPort = new DmaPort(this, sys, params()->min_backoff_delay,
|
|
|
|
params()->max_backoff_delay);
|
2006-01-31 20:20:39 +01:00
|
|
|
return dmaPort;
|
2006-04-20 23:14:30 +02:00
|
|
|
} else
|
2006-01-31 20:20:39 +01:00
|
|
|
return NULL;
|
|
|
|
}
|
|
|
|
|
2006-03-21 21:45:31 +01:00
|
|
|
friend class DmaPort;
|
|
|
|
};
|
2006-01-31 20:20:39 +01:00
|
|
|
|
|
|
|
|
2005-01-15 10:12:25 +01:00
|
|
|
#endif // __DEV_IO_DEVICE_HH__
|