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; --- 25 unchanged lines hidden (view full) --- 34 * @file 35 * Declaration of a request, the overall memory request consisting of 36 the parts of the request that are persistent throughout the transaction. 37 */ 38 39#ifndef __MEM_REQUEST_HH__ 40#define __MEM_REQUEST_HH__ 41 |
42#include <cassert> 43 |
44#include "base/fast_alloc.hh" |
45#include "base/flags.hh" |
46#include "sim/host.hh" 47#include "sim/core.hh" 48 |
49class Request; 50 51typedef Request* RequestPtr; 52 |
53class Request : public FastAlloc 54{ 55 public: 56 typedef uint32_t FlagsType; 57 typedef ::Flags<FlagsType> Flags; |
58 |
59 /** ASI information for this request if it exists. */ 60 static const FlagsType ASI_BITS = 0x000000FF; 61 /** The request is a Load locked/store conditional. */ 62 static const FlagsType LOCKED = 0x00000100; 63 /** The virtual address is also the physical address. */ 64 static const FlagsType PHYSICAL = 0x00000200; 65 /** The request is an ALPHA VPTE pal access (hw_ld). */ 66 static const FlagsType VPTE = 0x00000400; 67 /** Use the alternate mode bits in ALPHA. */ 68 static const FlagsType ALTMODE = 0x00000800; 69 /** The request is to an uncacheable address. */ 70 static const FlagsType UNCACHEABLE = 0x00001000; 71 /** The request should not cause a page fault. */ 72 static const FlagsType NO_FAULT = 0x00002000; 73 /** The request should be prefetched into the exclusive state. */ 74 static const FlagsType PF_EXCLUSIVE = 0x00010000; 75 /** The request should be marked as LRU. */ 76 static const FlagsType EVICT_NEXT = 0x00020000; 77 /** The request should ignore unaligned access faults */ 78 static const FlagsType NO_ALIGN_FAULT = 0x00040000; 79 /** The request was an instruction read. */ 80 static const FlagsType INST_READ = 0x00080000; 81 /** This request is for a memory swap. */ 82 static const FlagsType MEM_SWAP = 0x00100000; 83 static const FlagsType MEM_SWAP_COND = 0x00200000; 84 /** The request should ignore unaligned access faults */ 85 static const FlagsType NO_HALF_WORD_ALIGN_FAULT = 0x00400000; 86 /** This request is to a memory mapped register. */ 87 static const FlagsType MMAPED_IPR = 0x00800000; |
88 |
89 private: 90 static const FlagsType PUBLIC_FLAGS = 0x00FF3FFF; 91 static const FlagsType PRIVATE_FLAGS = 0xFF000000; |
92 |
93 /** Whether or not the size is valid. */ 94 static const FlagsType VALID_SIZE = 0x01000000; 95 /** Whether or not paddr is valid (has been written yet). */ 96 static const FlagsType VALID_PADDR = 0x02000000; 97 /** Whether or not the vaddr & asid are valid. */ 98 static const FlagsType VALID_VADDR = 0x04000000; 99 /** Whether or not the pc is valid. */ 100 static const FlagsType VALID_PC = 0x10000000; 101 /** Whether or not the context ID is valid. */ 102 static const FlagsType VALID_CONTEXT_ID = 0x20000000; 103 static const FlagsType VALID_THREAD_ID = 0x40000000; 104 /** Whether or not the sc result is valid. */ 105 static const FlagsType VALID_EXTRA_DATA = 0x80000000; 106 |
107 private: 108 /** 109 * The physical address of the request. Valid only if validPaddr |
110 * is set. 111 */ |
112 Addr paddr; 113 114 /** 115 * The size of the request. This field must be set when vaddr or 116 * paddr is written via setVirt() or setPhys(), so it is always |
117 * valid as long as one of the address fields is valid. 118 */ |
119 int size; 120 121 /** Flag structure for the request. */ |
122 Flags flags; |
123 124 /** 125 * The time this request was started. Used to calculate 126 * latencies. This field is set to curTick any time paddr or vaddr |
127 * is written. 128 */ |
129 Tick time; 130 131 /** The address space ID. */ 132 int asid; 133 |
134 /** The virtual address of the request. */ 135 Addr vaddr; 136 |
137 /** 138 * Extra data for the request, such as the return value of |
139 * store conditional or the compare value for a CAS. */ 140 uint64_t extraData; 141 142 /** The context ID (for statistics, typically). */ 143 int _contextId; 144 /** The thread ID (id within this CPU) */ 145 int _threadId; 146 147 /** program counter of initiating access; for tracing/debugging */ 148 Addr pc; 149 |
150 public: 151 /** Minimal constructor. No fields are initialized. */ 152 Request() |
153 {} 154 155 /** 156 * Constructor for physical (e.g. device) requests. Initializes 157 * just physical address, size, flags, and timestamp (to curTick). |
158 * These fields are adequate to perform a request. 159 */ 160 Request(Addr paddr, int size, Flags flags) 161 { 162 setPhys(paddr, size, flags); 163 } |
164 |
165 Request(int asid, Addr vaddr, int size, Flags flags, Addr pc, 166 int cid, int tid) |
167 { |
168 setThreadContext(cid, tid); 169 setVirt(asid, vaddr, size, flags, pc); |
170 } 171 172 ~Request() {} // for FastAlloc 173 174 /** |
175 * Set up CPU and thread numbers. 176 */ 177 void 178 setThreadContext(int context_id, int thread_id) |
179 { |
180 _contextId = context_id; 181 _threadId = thread_id; 182 flags.set(VALID_CONTEXT_ID|VALID_THREAD_ID); |
183 } 184 185 /** 186 * Set up a physical (e.g. device) request in a previously |
187 * allocated Request object. 188 */ 189 void 190 setPhys(Addr _paddr, int _size, Flags _flags) |
191 { 192 assert(_size >= 0); 193 paddr = _paddr; 194 size = _size; |
195 time = curTick; |
196 197 flags.set(VALID_PADDR|VALID_SIZE); 198 flags.clear(VALID_VADDR|VALID_PC|VALID_EXTRA_DATA|MMAPED_IPR); 199 flags.update(_flags, PUBLIC_FLAGS); |
200 } 201 202 /** 203 * Set up a virtual (e.g., CPU) request in a previously |
204 * allocated Request object. 205 */ 206 void 207 setVirt(int _asid, Addr _vaddr, int _size, Flags _flags, Addr _pc) |
208 { 209 assert(_size >= 0); 210 asid = _asid; 211 vaddr = _vaddr; 212 size = _size; |
213 pc = _pc; 214 time = curTick; |
215 216 flags.set(VALID_VADDR|VALID_SIZE|VALID_PC); 217 flags.clear(VALID_PADDR|VALID_EXTRA_DATA|MMAPED_IPR); 218 flags.update(_flags, PUBLIC_FLAGS); |
219 } 220 |
221 /** 222 * Set just the physical address. This should only be used to |
223 * record the result of a translation, and thus the vaddr must be 224 * valid before this method is called. Otherwise, use setPhys() 225 * to guarantee that the size and flags are also set. 226 */ |
227 void 228 setPaddr(Addr _paddr) |
229 { |
230 assert(flags.any(VALID_VADDR)); |
231 paddr = _paddr; |
232 flags.set(VALID_PADDR); |
233 } 234 |
235 /** 236 * Accessor for paddr. 237 */ 238 Addr 239 getPaddr() 240 { 241 assert(flags.any(VALID_PADDR)); 242 return paddr; 243 } |
244 |
245 /** 246 * Accessor for size. 247 */ 248 int 249 getSize() 250 { 251 assert(flags.any(VALID_SIZE)); 252 return size; 253 } 254 |
255 /** Accessor for time. */ |
256 Tick 257 getTime() 258 { 259 assert(flags.any(VALID_PADDR|VALID_VADDR)); 260 return time; 261 } 262 |
263 void 264 setTime(Tick when) 265 { |
266 assert(flags.any(VALID_PADDR|VALID_VADDR)); |
267 time = when; 268 } 269 |
270 void resetTime() { setTime(curTick); } 271 |
272 /** Accessor for flags. */ |
273 Flags 274 getFlags() 275 { 276 assert(flags.any(VALID_PADDR|VALID_VADDR)); 277 return flags & PUBLIC_FLAGS; 278 } |
279 |
280 Flags 281 anyFlags(Flags _flags) 282 { 283 assert(flags.any(VALID_PADDR|VALID_VADDR)); 284 assert(_flags.none(~PUBLIC_FLAGS)); 285 return flags.any(_flags); 286 } 287 288 Flags 289 allFlags(Flags _flags) 290 { 291 assert(flags.any(VALID_PADDR|VALID_VADDR)); 292 assert(_flags.none(~PUBLIC_FLAGS)); 293 return flags.all(_flags); 294 } 295 296 /** Accessor for flags. */ 297 void 298 setFlags(Flags _flags) 299 { 300 assert(flags.any(VALID_PADDR|VALID_VADDR)); 301 assert(_flags.none(~PUBLIC_FLAGS)); 302 flags.set(_flags); 303 } 304 305 void 306 clearFlags(Flags _flags) 307 { 308 assert(flags.any(VALID_PADDR|VALID_VADDR)); 309 assert(_flags.none(~PUBLIC_FLAGS)); 310 flags.clear(_flags); 311 } 312 313 void 314 clearFlags() 315 { 316 assert(flags.any(VALID_PADDR|VALID_VADDR)); 317 flags.clear(PUBLIC_FLAGS); 318 } 319 |
320 /** Accessor function for vaddr.*/ |
321 Addr 322 getVaddr() 323 { 324 assert(flags.any(VALID_VADDR)); 325 return vaddr; 326 } |
327 328 /** Accessor function for asid.*/ |
329 int 330 getAsid() 331 { 332 assert(flags.any(VALID_VADDR)); 333 return asid; 334 } |
335 336 /** Accessor function for asi.*/ |
337 uint8_t 338 getAsi() 339 { 340 assert(flags.any(VALID_VADDR)); 341 return flags & ASI_BITS; 342 } |
343 344 /** Accessor function for asi.*/ |
345 void 346 setAsi(uint8_t a) 347 { 348 assert(flags.any(VALID_VADDR)); 349 flags.update(a, ASI_BITS); 350 } |
351 352 /** Accessor function for asi.*/ |
353 bool 354 isMmapedIpr() 355 { 356 assert(flags.any(VALID_PADDR)); 357 return flags.any(MMAPED_IPR); 358 } |
359 360 /** Accessor function for asi.*/ |
361 void 362 setMmapedIpr(bool r) 363 { 364 assert(VALID_VADDR); 365 flags.set(MMAPED_IPR); 366 } |
367 368 /** Accessor function to check if sc result is valid. */ |
369 bool 370 extraDataValid() 371 { 372 return flags.any(VALID_EXTRA_DATA); 373 } 374 |
375 /** Accessor function for store conditional return value.*/ |
376 uint64_t 377 getExtraData() const 378 { 379 assert(flags.any(VALID_EXTRA_DATA)); 380 return extraData; 381 } 382 |
383 /** Accessor function for store conditional return value.*/ |
384 void 385 setExtraData(uint64_t _extraData) 386 { 387 extraData = _extraData; 388 flags.set(VALID_EXTRA_DATA); 389 } |
390 391 /** Accessor function for context ID.*/ |
392 int 393 contextId() const 394 { 395 assert(flags.any(VALID_CONTEXT_ID)); 396 return _contextId; 397 } 398 |
399 /** Accessor function for thread ID. */ |
400 int 401 threadId() const 402 { 403 assert(flags.any(VALID_THREAD_ID)); 404 return _threadId; 405 } |
406 407 /** Accessor function for pc.*/ |
408 Addr 409 getPC() const 410 { 411 assert(flags.any(VALID_PC)); 412 return pc; 413 } |
414 415 /** Accessor Function to Check Cacheability. */ |
416 bool isUncacheable() const { return flags.any(UNCACHEABLE); } 417 bool isInstRead() const { return flags.any(INST_READ); } 418 bool isLocked() const { return flags.any(LOCKED); } 419 bool isSwap() const { return flags.any(MEM_SWAP|MEM_SWAP_COND); } 420 bool isCondSwap() const { return flags.any(MEM_SWAP_COND); } |
421 |
422 bool 423 isMisaligned() const 424 { 425 if (flags.any(NO_ALIGN_FAULT)) 426 return false; |
427 |
428 if ((vaddr & 0x1)) 429 return true; |
430 |
431 if (flags.any(NO_HALF_WORD_ALIGN_FAULT)) 432 return false; |
433 |
434 if ((vaddr & 0x2)) 435 return true; |
436 |
437 return false; 438 } |
439 440 friend class Packet; 441}; 442 443#endif // __MEM_REQUEST_HH__ |