2006-01-31 18:12:49 +01:00
|
|
|
/*
|
|
|
|
* Copyright (c) 2002-2005 The Regents of The University of Michigan
|
|
|
|
* 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: Ron Dreslinski
|
|
|
|
* Steve Reinhardt
|
|
|
|
* Ali Saidi
|
2006-01-31 18:12:49 +01:00
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
2006-08-15 01:25:07 +02:00
|
|
|
* @file
|
|
|
|
* Declaration of a request, the overall memory request consisting of
|
2006-01-31 18:12:49 +01:00
|
|
|
the parts of the request that are persistent throughout the transaction.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __MEM_REQUEST_HH__
|
|
|
|
#define __MEM_REQUEST_HH__
|
|
|
|
|
2006-08-15 11:07:15 +02:00
|
|
|
#include "sim/host.hh"
|
2006-08-12 01:43:10 +02:00
|
|
|
#include "sim/root.hh"
|
2006-02-15 20:21:09 +01:00
|
|
|
|
2006-08-15 23:41:22 +02:00
|
|
|
#include <cassert>
|
|
|
|
|
2006-02-15 20:21:09 +01:00
|
|
|
class Request;
|
|
|
|
|
|
|
|
typedef Request* RequestPtr;
|
|
|
|
|
2006-06-28 23:28:33 +02:00
|
|
|
|
2006-02-15 20:53:02 +01:00
|
|
|
/** The request is a Load locked/store conditional. */
|
|
|
|
const unsigned LOCKED = 0x001;
|
|
|
|
/** The virtual address is also the physical address. */
|
|
|
|
const unsigned PHYSICAL = 0x002;
|
|
|
|
/** The request is an ALPHA VPTE pal access (hw_ld). */
|
|
|
|
const unsigned VPTE = 0x004;
|
|
|
|
/** Use the alternate mode bits in ALPHA. */
|
|
|
|
const unsigned ALTMODE = 0x008;
|
|
|
|
/** The request is to an uncacheable address. */
|
|
|
|
const unsigned UNCACHEABLE = 0x010;
|
|
|
|
/** The request should not cause a page fault. */
|
|
|
|
const unsigned NO_FAULT = 0x020;
|
2006-02-15 23:52:49 +01:00
|
|
|
/** The request should be prefetched into the exclusive state. */
|
|
|
|
const unsigned PF_EXCLUSIVE = 0x100;
|
|
|
|
/** The request should be marked as LRU. */
|
|
|
|
const unsigned EVICT_NEXT = 0x200;
|
2006-04-10 18:23:17 +02:00
|
|
|
/** The request should ignore unaligned access faults */
|
|
|
|
const unsigned NO_ALIGN_FAULT = 0x400;
|
2006-06-30 16:25:25 +02:00
|
|
|
/** The request was an instruction read. */
|
|
|
|
const unsigned INST_READ = 0x800;
|
2006-02-15 20:53:02 +01:00
|
|
|
|
2006-01-31 18:12:49 +01:00
|
|
|
class Request
|
|
|
|
{
|
2006-04-07 21:54:48 +02:00
|
|
|
private:
|
2006-05-31 06:12:29 +02:00
|
|
|
/**
|
|
|
|
* The physical address of the request. Valid only if validPaddr
|
|
|
|
* is set. */
|
2006-01-31 18:12:49 +01:00
|
|
|
Addr paddr;
|
|
|
|
|
2006-05-31 06:12:29 +02:00
|
|
|
/**
|
|
|
|
* The size of the request. This field must be set when vaddr or
|
|
|
|
* paddr is written via setVirt() or setPhys(), so it is always
|
|
|
|
* valid as long as one of the address fields is valid. */
|
2006-01-31 18:12:49 +01:00
|
|
|
int size;
|
2006-02-15 20:53:02 +01:00
|
|
|
|
2006-04-07 21:54:48 +02:00
|
|
|
/** Flag structure for the request. */
|
2006-02-15 20:53:02 +01:00
|
|
|
uint32_t flags;
|
2006-01-31 20:20:39 +01:00
|
|
|
|
2006-05-31 06:12:29 +02:00
|
|
|
/**
|
|
|
|
* The time this request was started. Used to calculate
|
|
|
|
* latencies. This field is set to curTick any time paddr or vaddr
|
|
|
|
* is written. */
|
|
|
|
Tick time;
|
2006-01-31 20:20:39 +01:00
|
|
|
|
|
|
|
/** The address space ID. */
|
|
|
|
int asid;
|
2006-05-31 06:12:29 +02:00
|
|
|
/** The virtual address of the request. */
|
|
|
|
Addr vaddr;
|
2006-01-31 20:20:39 +01:00
|
|
|
|
2006-01-31 18:12:49 +01:00
|
|
|
/** The return value of store conditional. */
|
2006-01-31 20:20:39 +01:00
|
|
|
uint64_t scResult;
|
2006-01-31 18:12:49 +01:00
|
|
|
|
2006-05-31 06:12:29 +02:00
|
|
|
/** The cpu number (for statistics, typically). */
|
2006-01-31 20:20:39 +01:00
|
|
|
int cpuNum;
|
2006-05-31 06:12:29 +02:00
|
|
|
/** The requesting thread id (for statistics, typically). */
|
2006-01-31 20:20:39 +01:00
|
|
|
int threadNum;
|
2006-01-31 18:12:49 +01:00
|
|
|
|
|
|
|
/** program counter of initiating access; for tracing/debugging */
|
|
|
|
Addr pc;
|
2006-05-31 06:12:29 +02:00
|
|
|
|
|
|
|
/** Whether or not paddr is valid (has been written yet). */
|
|
|
|
bool validPaddr;
|
|
|
|
/** Whether or not the asid & vaddr are valid. */
|
|
|
|
bool validAsidVaddr;
|
|
|
|
/** Whether or not the sc result is valid. */
|
|
|
|
bool validScResult;
|
|
|
|
/** Whether or not the cpu number & thread ID are valid. */
|
|
|
|
bool validCpuAndThreadNums;
|
|
|
|
/** Whether or not the pc is valid. */
|
2006-04-07 21:54:48 +02:00
|
|
|
bool validPC;
|
|
|
|
|
|
|
|
public:
|
2006-05-31 06:12:29 +02:00
|
|
|
/** Minimal constructor. No fields are initialized. */
|
|
|
|
Request()
|
|
|
|
: validPaddr(false), validAsidVaddr(false),
|
|
|
|
validScResult(false), validCpuAndThreadNums(false), validPC(false)
|
|
|
|
{}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Constructor for physical (e.g. device) requests. Initializes
|
|
|
|
* just physical address, size, flags, and timestamp (to curTick).
|
|
|
|
* These fields are adequate to perform a request. */
|
|
|
|
Request(Addr _paddr, int _size, int _flags)
|
|
|
|
: validCpuAndThreadNums(false)
|
|
|
|
{ setPhys(_paddr, _size, _flags); }
|
|
|
|
|
2006-06-03 00:15:20 +02:00
|
|
|
Request(int _asid, Addr _vaddr, int _size, int _flags, Addr _pc,
|
|
|
|
int _cpuNum, int _threadNum)
|
|
|
|
{
|
|
|
|
setThreadContext(_cpuNum, _threadNum);
|
|
|
|
setVirt(_asid, _vaddr, _size, _flags, _pc);
|
|
|
|
}
|
|
|
|
|
2006-05-31 06:12:29 +02:00
|
|
|
/**
|
|
|
|
* Set up CPU and thread numbers. */
|
|
|
|
void setThreadContext(int _cpuNum, int _threadNum)
|
|
|
|
{
|
|
|
|
cpuNum = _cpuNum;
|
|
|
|
threadNum = _threadNum;
|
|
|
|
validCpuAndThreadNums = true;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Set up a physical (e.g. device) request in a previously
|
|
|
|
* allocated Request object. */
|
|
|
|
void setPhys(Addr _paddr, int _size, int _flags)
|
|
|
|
{
|
|
|
|
paddr = _paddr;
|
|
|
|
size = _size;
|
|
|
|
flags = _flags;
|
|
|
|
time = curTick;
|
|
|
|
validPaddr = true;
|
|
|
|
validAsidVaddr = false;
|
|
|
|
validPC = false;
|
|
|
|
validScResult = false;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Set up a virtual (e.g., CPU) request in a previously
|
|
|
|
* allocated Request object. */
|
|
|
|
void setVirt(int _asid, Addr _vaddr, int _size, int _flags, Addr _pc)
|
|
|
|
{
|
|
|
|
asid = _asid;
|
|
|
|
vaddr = _vaddr;
|
|
|
|
size = _size;
|
|
|
|
flags = _flags;
|
|
|
|
pc = _pc;
|
|
|
|
time = curTick;
|
|
|
|
validPaddr = false;
|
|
|
|
validAsidVaddr = true;
|
|
|
|
validPC = true;
|
|
|
|
validScResult = false;
|
|
|
|
}
|
|
|
|
|
|
|
|
/** Set just the physical address. This should only be used to
|
|
|
|
* record the result of a translation, and thus the vaddr must be
|
|
|
|
* valid before this method is called. Otherwise, use setPhys()
|
|
|
|
* to guarantee that the size and flags are also set.
|
|
|
|
*/
|
|
|
|
void setPaddr(Addr _paddr)
|
|
|
|
{
|
|
|
|
assert(validAsidVaddr);
|
|
|
|
paddr = _paddr;
|
|
|
|
validPaddr = true;
|
|
|
|
}
|
|
|
|
|
|
|
|
/** Accessor for paddr. */
|
|
|
|
Addr getPaddr() { assert(validPaddr); return paddr; }
|
|
|
|
|
|
|
|
/** Accessor for size. */
|
|
|
|
int getSize() { assert(validPaddr || validAsidVaddr); return size; }
|
|
|
|
/** Accessor for time. */
|
|
|
|
Tick getTime() { assert(validPaddr || validAsidVaddr); return time; }
|
|
|
|
|
|
|
|
/** Accessor for flags. */
|
|
|
|
uint32_t getFlags() { assert(validPaddr || validAsidVaddr); return flags; }
|
|
|
|
/** Accessor for paddr. */
|
|
|
|
void setFlags(uint32_t _flags)
|
|
|
|
{ assert(validPaddr || validAsidVaddr); flags = _flags; }
|
|
|
|
|
|
|
|
/** Accessor function for vaddr.*/
|
|
|
|
Addr getVaddr() { assert(validAsidVaddr); return vaddr; }
|
|
|
|
|
|
|
|
/** Accessor function for asid.*/
|
|
|
|
int getAsid() { assert(validAsidVaddr); return asid; }
|
|
|
|
|
2006-06-06 20:06:30 +02:00
|
|
|
/** Accessor function to check if sc result is valid. */
|
|
|
|
bool scResultValid() { return validScResult; }
|
2006-05-31 06:12:29 +02:00
|
|
|
/** Accessor function for store conditional return value.*/
|
|
|
|
uint64_t getScResult() { assert(validScResult); return scResult; }
|
|
|
|
/** Accessor function for store conditional return value.*/
|
|
|
|
void setScResult(uint64_t _scResult)
|
|
|
|
{ scResult = _scResult; validScResult = true; }
|
|
|
|
|
|
|
|
/** Accessor function for cpu number.*/
|
|
|
|
int getCpuNum() { assert(validCpuAndThreadNums); return cpuNum; }
|
|
|
|
/** Accessor function for thread number.*/
|
|
|
|
int getThreadNum() { assert(validCpuAndThreadNums); return threadNum; }
|
|
|
|
|
|
|
|
/** Accessor function for pc.*/
|
|
|
|
Addr getPC() { assert(validPC); return pc; }
|
2006-04-07 21:54:48 +02:00
|
|
|
|
2006-06-28 20:35:00 +02:00
|
|
|
/** Accessor Function to Check Cacheability. */
|
2006-10-08 19:53:24 +02:00
|
|
|
bool isUncacheable() { return (getFlags() & UNCACHEABLE) != 0; }
|
2006-06-28 20:35:00 +02:00
|
|
|
|
2006-10-08 19:53:24 +02:00
|
|
|
bool isInstRead() { return (getFlags() & INST_READ) != 0; }
|
|
|
|
|
|
|
|
bool isLocked() { return (getFlags() & LOCKED) != 0; }
|
2006-06-30 16:25:25 +02:00
|
|
|
|
2006-05-26 20:17:33 +02:00
|
|
|
friend class Packet;
|
2006-01-31 20:20:39 +01:00
|
|
|
};
|
2006-01-31 18:12:49 +01:00
|
|
|
|
|
|
|
#endif // __MEM_REQUEST_HH__
|