isa.hh revision 12604:0cf3d5d3bd3e
1/* 2 * Copyright (c) 2010, 2012-2018 ARM Limited 3 * All rights reserved 4 * 5 * The license below extends only to copyright in the software and shall 6 * not be construed as granting a license to any other intellectual 7 * property including but not limited to intellectual property relating 8 * to a hardware implementation of the functionality of the software 9 * licensed hereunder. You may use the software subject to the license 10 * terms below provided that you ensure that this notice is replicated 11 * unmodified and in its entirety in all distributions of the software, 12 * modified or unmodified, in source code or in binary form. 13 * 14 * Copyright (c) 2009 The Regents of The University of Michigan 15 * All rights reserved. 16 * 17 * Redistribution and use in source and binary forms, with or without 18 * modification, are permitted provided that the following conditions are 19 * met: redistributions of source code must retain the above copyright 20 * notice, this list of conditions and the following disclaimer; 21 * redistributions in binary form must reproduce the above copyright 22 * notice, this list of conditions and the following disclaimer in the 23 * documentation and/or other materials provided with the distribution; 24 * neither the name of the copyright holders nor the names of its 25 * contributors may be used to endorse or promote products derived from 26 * this software without specific prior written permission. 27 * 28 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 29 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 30 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 31 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 32 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 33 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 34 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 35 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 36 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 37 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 38 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 39 * 40 * Authors: Gabe Black 41 */ 42 43#ifndef __ARCH_ARM_ISA_HH__ 44#define __ARCH_ARM_ISA_HH__ 45 46#include "arch/arm/isa_device.hh" 47#include "arch/arm/miscregs.hh" 48#include "arch/arm/registers.hh" 49#include "arch/arm/system.hh" 50#include "arch/arm/tlb.hh" 51#include "arch/arm/types.hh" 52#include "arch/generic/traits.hh" 53#include "debug/Checkpoint.hh" 54#include "enums/VecRegRenameMode.hh" 55#include "sim/sim_object.hh" 56#include "enums/DecoderFlavour.hh" 57 58struct ArmISAParams; 59struct DummyArmISADeviceParams; 60class ThreadContext; 61class Checkpoint; 62class EventManager; 63 64namespace ArmISA 65{ 66 class ISA : public SimObject 67 { 68 protected: 69 // Parent system 70 ArmSystem *system; 71 72 // Micro Architecture 73 const Enums::DecoderFlavour _decoderFlavour; 74 const Enums::VecRegRenameMode _vecRegRenameMode; 75 76 /** Dummy device for to handle non-existing ISA devices */ 77 DummyISADevice dummyDevice; 78 79 // PMU belonging to this ISA 80 BaseISADevice *pmu; 81 82 // Generic timer interface belonging to this ISA 83 std::unique_ptr<BaseISADevice> timer; 84 85 // Cached copies of system-level properties 86 bool highestELIs64; 87 bool haveSecurity; 88 bool haveLPAE; 89 bool haveVirtualization; 90 bool haveLargeAsid64; 91 uint8_t physAddrRange64; 92 93 /** MiscReg metadata **/ 94 struct MiscRegLUTEntry { 95 uint32_t lower; // Lower half mapped to this register 96 uint32_t upper; // Upper half mapped to this register 97 uint64_t _reset; // value taken on reset (i.e. initialization) 98 uint64_t _res0; // reserved 99 uint64_t _res1; // reserved 100 uint64_t _raz; // read as zero (fixed at 0) 101 uint64_t _rao; // read as one (fixed at 1) 102 public: 103 MiscRegLUTEntry() : 104 lower(0), upper(0), 105 _reset(0), _res0(0), _res1(0), _raz(0), _rao(0) {} 106 uint64_t reset() const { return _reset; } 107 uint64_t res0() const { return _res0; } 108 uint64_t res1() const { return _res1; } 109 uint64_t raz() const { return _raz; } 110 uint64_t rao() const { return _rao; } 111 // raz/rao implies writes ignored 112 uint64_t wi() const { return _raz | _rao; } 113 }; 114 115 /** Metadata table accessible via the value of the register */ 116 static std::vector<struct MiscRegLUTEntry> lookUpMiscReg; 117 118 class MiscRegLUTEntryInitializer { 119 struct MiscRegLUTEntry &entry; 120 std::bitset<NUM_MISCREG_INFOS> &info; 121 typedef const MiscRegLUTEntryInitializer& chain; 122 public: 123 chain mapsTo(uint32_t l, uint32_t u = 0) const { 124 entry.lower = l; 125 entry.upper = u; 126 return *this; 127 } 128 chain res0(uint64_t mask) const { 129 entry._res0 = mask; 130 return *this; 131 } 132 chain res1(uint64_t mask) const { 133 entry._res1 = mask; 134 return *this; 135 } 136 chain raz(uint64_t mask) const { 137 entry._raz = mask; 138 return *this; 139 } 140 chain rao(uint64_t mask) const { 141 entry._rao = mask; 142 return *this; 143 } 144 chain implemented(bool v = true) const { 145 info[MISCREG_IMPLEMENTED] = v; 146 return *this; 147 } 148 chain unimplemented() const { 149 return implemented(false); 150 } 151 chain unverifiable(bool v = true) const { 152 info[MISCREG_UNVERIFIABLE] = v; 153 return *this; 154 } 155 chain warnNotFail(bool v = true) const { 156 info[MISCREG_WARN_NOT_FAIL] = v; 157 return *this; 158 } 159 chain mutex(bool v = true) const { 160 info[MISCREG_MUTEX] = v; 161 return *this; 162 } 163 chain banked(bool v = true) const { 164 info[MISCREG_BANKED] = v; 165 return *this; 166 } 167 chain bankedChild(bool v = true) const { 168 info[MISCREG_BANKED_CHILD] = v; 169 return *this; 170 } 171 chain userNonSecureRead(bool v = true) const { 172 info[MISCREG_USR_NS_RD] = v; 173 return *this; 174 } 175 chain userNonSecureWrite(bool v = true) const { 176 info[MISCREG_USR_NS_WR] = v; 177 return *this; 178 } 179 chain userSecureRead(bool v = true) const { 180 info[MISCREG_USR_S_RD] = v; 181 return *this; 182 } 183 chain userSecureWrite(bool v = true) const { 184 info[MISCREG_USR_S_WR] = v; 185 return *this; 186 } 187 chain user(bool v = true) const { 188 userNonSecureRead(v); 189 userNonSecureWrite(v); 190 userSecureRead(v); 191 userSecureWrite(v); 192 return *this; 193 } 194 chain privNonSecureRead(bool v = true) const { 195 info[MISCREG_PRI_NS_RD] = v; 196 return *this; 197 } 198 chain privNonSecureWrite(bool v = true) const { 199 info[MISCREG_PRI_NS_WR] = v; 200 return *this; 201 } 202 chain privSecureRead(bool v = true) const { 203 info[MISCREG_PRI_S_RD] = v; 204 return *this; 205 } 206 chain privSecureWrite(bool v = true) const { 207 info[MISCREG_PRI_S_WR] = v; 208 return *this; 209 } 210 chain privSecure(bool v = true) const { 211 privSecureRead(v); 212 privSecureWrite(v); 213 return *this; 214 } 215 chain hypRead(bool v = true) const { 216 info[MISCREG_HYP_RD] = v; 217 return *this; 218 } 219 chain hypWrite(bool v = true) const { 220 info[MISCREG_HYP_WR] = v; 221 return *this; 222 } 223 chain hyp(bool v = true) const { 224 hypRead(v); 225 hypWrite(v); 226 return *this; 227 } 228 chain monSecureRead(bool v = true) const { 229 info[MISCREG_MON_NS0_RD] = v; 230 return *this; 231 } 232 chain monSecureWrite(bool v = true) const { 233 info[MISCREG_MON_NS0_WR] = v; 234 return *this; 235 } 236 chain monNonSecureRead(bool v = true) const { 237 info[MISCREG_MON_NS1_RD] = v; 238 return *this; 239 } 240 chain monNonSecureWrite(bool v = true) const { 241 info[MISCREG_MON_NS1_WR] = v; 242 return *this; 243 } 244 chain mon(bool v = true) const { 245 monSecureRead(v); 246 monSecureWrite(v); 247 monNonSecureRead(v); 248 monNonSecureWrite(v); 249 return *this; 250 } 251 chain monSecure(bool v = true) const { 252 monSecureRead(v); 253 monSecureWrite(v); 254 return *this; 255 } 256 chain monNonSecure(bool v = true) const { 257 monNonSecureRead(v); 258 monNonSecureWrite(v); 259 return *this; 260 } 261 chain allPrivileges(bool v = true) const { 262 userNonSecureRead(v); 263 userNonSecureWrite(v); 264 userSecureRead(v); 265 userSecureWrite(v); 266 privNonSecureRead(v); 267 privNonSecureWrite(v); 268 privSecureRead(v); 269 privSecureWrite(v); 270 hypRead(v); 271 hypWrite(v); 272 monSecureRead(v); 273 monSecureWrite(v); 274 monNonSecureRead(v); 275 monNonSecureWrite(v); 276 return *this; 277 } 278 chain nonSecure(bool v = true) const { 279 userNonSecureRead(v); 280 userNonSecureWrite(v); 281 privNonSecureRead(v); 282 privNonSecureWrite(v); 283 hypRead(v); 284 hypWrite(v); 285 monNonSecureRead(v); 286 monNonSecureWrite(v); 287 return *this; 288 } 289 chain secure(bool v = true) const { 290 userSecureRead(v); 291 userSecureWrite(v); 292 privSecureRead(v); 293 privSecureWrite(v); 294 monSecureRead(v); 295 monSecureWrite(v); 296 return *this; 297 } 298 chain reads(bool v) const { 299 userNonSecureRead(v); 300 userSecureRead(v); 301 privNonSecureRead(v); 302 privSecureRead(v); 303 hypRead(v); 304 monSecureRead(v); 305 monNonSecureRead(v); 306 return *this; 307 } 308 chain writes(bool v) const { 309 userNonSecureWrite(v); 310 userSecureWrite(v); 311 privNonSecureWrite(v); 312 privSecureWrite(v); 313 hypWrite(v); 314 monSecureWrite(v); 315 monNonSecureWrite(v); 316 return *this; 317 } 318 chain exceptUserMode() const { 319 user(0); 320 return *this; 321 } 322 MiscRegLUTEntryInitializer(struct MiscRegLUTEntry &e, 323 std::bitset<NUM_MISCREG_INFOS> &i) 324 : entry(e), 325 info(i) 326 { 327 // force unimplemented registers to be thusly declared 328 implemented(1); 329 } 330 }; 331 332 const MiscRegLUTEntryInitializer InitReg(uint32_t reg) { 333 return MiscRegLUTEntryInitializer(lookUpMiscReg[reg], 334 miscRegInfo[reg]); 335 } 336 337 void initializeMiscRegMetadata(); 338 339 MiscReg miscRegs[NumMiscRegs]; 340 const IntRegIndex *intRegMap; 341 342 void 343 updateRegMap(CPSR cpsr) 344 { 345 if (cpsr.width == 0) { 346 intRegMap = IntReg64Map; 347 } else { 348 switch (cpsr.mode) { 349 case MODE_USER: 350 case MODE_SYSTEM: 351 intRegMap = IntRegUsrMap; 352 break; 353 case MODE_FIQ: 354 intRegMap = IntRegFiqMap; 355 break; 356 case MODE_IRQ: 357 intRegMap = IntRegIrqMap; 358 break; 359 case MODE_SVC: 360 intRegMap = IntRegSvcMap; 361 break; 362 case MODE_MON: 363 intRegMap = IntRegMonMap; 364 break; 365 case MODE_ABORT: 366 intRegMap = IntRegAbtMap; 367 break; 368 case MODE_HYP: 369 intRegMap = IntRegHypMap; 370 break; 371 case MODE_UNDEFINED: 372 intRegMap = IntRegUndMap; 373 break; 374 default: 375 panic("Unrecognized mode setting in CPSR.\n"); 376 } 377 } 378 } 379 380 BaseISADevice &getGenericTimer(ThreadContext *tc); 381 382 383 private: 384 inline void assert32(ThreadContext *tc) { 385 CPSR cpsr M5_VAR_USED = readMiscReg(MISCREG_CPSR, tc); 386 assert(cpsr.width); 387 } 388 389 inline void assert64(ThreadContext *tc) { 390 CPSR cpsr M5_VAR_USED = readMiscReg(MISCREG_CPSR, tc); 391 assert(!cpsr.width); 392 } 393 394 void tlbiVA(ThreadContext *tc, MiscReg newVal, uint16_t asid, 395 bool secure_lookup, uint8_t target_el); 396 397 void tlbiALL(ThreadContext *tc, bool secure_lookup, uint8_t target_el); 398 399 void tlbiALLN(ThreadContext *tc, bool hyp, uint8_t target_el); 400 401 void tlbiMVA(ThreadContext *tc, MiscReg newVal, bool secure_lookup, 402 bool hyp, uint8_t target_el); 403 404 void tlbiIPA(ThreadContext *tc, MiscReg newVal, bool secure_lookup, 405 uint8_t target_el); 406 407 void tlbiASID(ThreadContext *tc, uint16_t asid, bool secure_lookup, 408 uint8_t target_el); 409 410 public: 411 void clear(); 412 void clear64(const ArmISAParams *p); 413 414 MiscReg readMiscRegNoEffect(int misc_reg) const; 415 MiscReg readMiscReg(int misc_reg, ThreadContext *tc); 416 void setMiscRegNoEffect(int misc_reg, const MiscReg &val); 417 void setMiscReg(int misc_reg, const MiscReg &val, ThreadContext *tc); 418 419 RegId 420 flattenRegId(const RegId& regId) const 421 { 422 switch (regId.classValue()) { 423 case IntRegClass: 424 return RegId(IntRegClass, flattenIntIndex(regId.index())); 425 case FloatRegClass: 426 return RegId(FloatRegClass, flattenFloatIndex(regId.index())); 427 case VecRegClass: 428 return RegId(VecRegClass, flattenVecIndex(regId.index())); 429 case VecElemClass: 430 return RegId(VecElemClass, flattenVecElemIndex(regId.index())); 431 case CCRegClass: 432 return RegId(CCRegClass, flattenCCIndex(regId.index())); 433 case MiscRegClass: 434 return RegId(MiscRegClass, flattenMiscIndex(regId.index())); 435 } 436 return RegId(); 437 } 438 439 int 440 flattenIntIndex(int reg) const 441 { 442 assert(reg >= 0); 443 if (reg < NUM_ARCH_INTREGS) { 444 return intRegMap[reg]; 445 } else if (reg < NUM_INTREGS) { 446 return reg; 447 } else if (reg == INTREG_SPX) { 448 CPSR cpsr = miscRegs[MISCREG_CPSR]; 449 ExceptionLevel el = opModeToEL( 450 (OperatingMode) (uint8_t) cpsr.mode); 451 if (!cpsr.sp && el != EL0) 452 return INTREG_SP0; 453 switch (el) { 454 case EL3: 455 return INTREG_SP3; 456 case EL2: 457 return INTREG_SP2; 458 case EL1: 459 return INTREG_SP1; 460 case EL0: 461 return INTREG_SP0; 462 default: 463 panic("Invalid exception level"); 464 break; 465 } 466 } else { 467 return flattenIntRegModeIndex(reg); 468 } 469 } 470 471 int 472 flattenFloatIndex(int reg) const 473 { 474 assert(reg >= 0); 475 return reg; 476 } 477 478 int 479 flattenVecIndex(int reg) const 480 { 481 assert(reg >= 0); 482 return reg; 483 } 484 485 int 486 flattenVecElemIndex(int reg) const 487 { 488 assert(reg >= 0); 489 return reg; 490 } 491 492 int 493 flattenCCIndex(int reg) const 494 { 495 assert(reg >= 0); 496 return reg; 497 } 498 499 int 500 flattenMiscIndex(int reg) const 501 { 502 assert(reg >= 0); 503 int flat_idx = reg; 504 505 if (reg == MISCREG_SPSR) { 506 CPSR cpsr = miscRegs[MISCREG_CPSR]; 507 switch (cpsr.mode) { 508 case MODE_EL0T: 509 warn("User mode does not have SPSR\n"); 510 flat_idx = MISCREG_SPSR; 511 break; 512 case MODE_EL1T: 513 case MODE_EL1H: 514 flat_idx = MISCREG_SPSR_EL1; 515 break; 516 case MODE_EL2T: 517 case MODE_EL2H: 518 flat_idx = MISCREG_SPSR_EL2; 519 break; 520 case MODE_EL3T: 521 case MODE_EL3H: 522 flat_idx = MISCREG_SPSR_EL3; 523 break; 524 case MODE_USER: 525 warn("User mode does not have SPSR\n"); 526 flat_idx = MISCREG_SPSR; 527 break; 528 case MODE_FIQ: 529 flat_idx = MISCREG_SPSR_FIQ; 530 break; 531 case MODE_IRQ: 532 flat_idx = MISCREG_SPSR_IRQ; 533 break; 534 case MODE_SVC: 535 flat_idx = MISCREG_SPSR_SVC; 536 break; 537 case MODE_MON: 538 flat_idx = MISCREG_SPSR_MON; 539 break; 540 case MODE_ABORT: 541 flat_idx = MISCREG_SPSR_ABT; 542 break; 543 case MODE_HYP: 544 flat_idx = MISCREG_SPSR_HYP; 545 break; 546 case MODE_UNDEFINED: 547 flat_idx = MISCREG_SPSR_UND; 548 break; 549 default: 550 warn("Trying to access SPSR in an invalid mode: %d\n", 551 cpsr.mode); 552 flat_idx = MISCREG_SPSR; 553 break; 554 } 555 } else if (miscRegInfo[reg][MISCREG_MUTEX]) { 556 // Mutually exclusive CP15 register 557 switch (reg) { 558 case MISCREG_PRRR_MAIR0: 559 case MISCREG_PRRR_MAIR0_NS: 560 case MISCREG_PRRR_MAIR0_S: 561 { 562 TTBCR ttbcr = readMiscRegNoEffect(MISCREG_TTBCR); 563 // If the muxed reg has been flattened, work out the 564 // offset and apply it to the unmuxed reg 565 int idxOffset = reg - MISCREG_PRRR_MAIR0; 566 if (ttbcr.eae) 567 flat_idx = flattenMiscIndex(MISCREG_MAIR0 + 568 idxOffset); 569 else 570 flat_idx = flattenMiscIndex(MISCREG_PRRR + 571 idxOffset); 572 } 573 break; 574 case MISCREG_NMRR_MAIR1: 575 case MISCREG_NMRR_MAIR1_NS: 576 case MISCREG_NMRR_MAIR1_S: 577 { 578 TTBCR ttbcr = readMiscRegNoEffect(MISCREG_TTBCR); 579 // If the muxed reg has been flattened, work out the 580 // offset and apply it to the unmuxed reg 581 int idxOffset = reg - MISCREG_NMRR_MAIR1; 582 if (ttbcr.eae) 583 flat_idx = flattenMiscIndex(MISCREG_MAIR1 + 584 idxOffset); 585 else 586 flat_idx = flattenMiscIndex(MISCREG_NMRR + 587 idxOffset); 588 } 589 break; 590 case MISCREG_PMXEVTYPER_PMCCFILTR: 591 { 592 PMSELR pmselr = miscRegs[MISCREG_PMSELR]; 593 if (pmselr.sel == 31) 594 flat_idx = flattenMiscIndex(MISCREG_PMCCFILTR); 595 else 596 flat_idx = flattenMiscIndex(MISCREG_PMXEVTYPER); 597 } 598 break; 599 default: 600 panic("Unrecognized misc. register.\n"); 601 break; 602 } 603 } else { 604 if (miscRegInfo[reg][MISCREG_BANKED]) { 605 bool secureReg = haveSecurity && !highestELIs64 && 606 inSecureState(miscRegs[MISCREG_SCR], 607 miscRegs[MISCREG_CPSR]); 608 flat_idx += secureReg ? 2 : 1; 609 } 610 } 611 return flat_idx; 612 } 613 614 std::pair<int,int> getMiscIndices(int misc_reg) const 615 { 616 // Note: indexes of AArch64 registers are left unchanged 617 int flat_idx = flattenMiscIndex(misc_reg); 618 619 if (lookUpMiscReg[flat_idx].lower == 0) { 620 return std::make_pair(flat_idx, 0); 621 } 622 623 // do additional S/NS flattenings if mapped to NS while in S 624 bool S = haveSecurity && !highestELIs64 && 625 inSecureState(miscRegs[MISCREG_SCR], 626 miscRegs[MISCREG_CPSR]); 627 int lower = lookUpMiscReg[flat_idx].lower; 628 int upper = lookUpMiscReg[flat_idx].upper; 629 // upper == 0, which is CPSR, is not MISCREG_BANKED_CHILD (no-op) 630 lower += S && miscRegInfo[lower][MISCREG_BANKED_CHILD]; 631 upper += S && miscRegInfo[upper][MISCREG_BANKED_CHILD]; 632 return std::make_pair(lower, upper); 633 } 634 635 void serialize(CheckpointOut &cp) const 636 { 637 DPRINTF(Checkpoint, "Serializing Arm Misc Registers\n"); 638 SERIALIZE_ARRAY(miscRegs, NUM_PHYS_MISCREGS); 639 640 SERIALIZE_SCALAR(highestELIs64); 641 SERIALIZE_SCALAR(haveSecurity); 642 SERIALIZE_SCALAR(haveLPAE); 643 SERIALIZE_SCALAR(haveVirtualization); 644 SERIALIZE_SCALAR(haveLargeAsid64); 645 SERIALIZE_SCALAR(physAddrRange64); 646 } 647 void unserialize(CheckpointIn &cp) 648 { 649 DPRINTF(Checkpoint, "Unserializing Arm Misc Registers\n"); 650 UNSERIALIZE_ARRAY(miscRegs, NUM_PHYS_MISCREGS); 651 CPSR tmp_cpsr = miscRegs[MISCREG_CPSR]; 652 updateRegMap(tmp_cpsr); 653 654 UNSERIALIZE_SCALAR(highestELIs64); 655 UNSERIALIZE_SCALAR(haveSecurity); 656 UNSERIALIZE_SCALAR(haveLPAE); 657 UNSERIALIZE_SCALAR(haveVirtualization); 658 UNSERIALIZE_SCALAR(haveLargeAsid64); 659 UNSERIALIZE_SCALAR(physAddrRange64); 660 } 661 662 void startup(ThreadContext *tc) {} 663 664 Enums::DecoderFlavour decoderFlavour() const { return _decoderFlavour; } 665 666 Enums::VecRegRenameMode 667 vecRegRenameMode() const 668 { 669 return _vecRegRenameMode; 670 } 671 672 /// Explicitly import the otherwise hidden startup 673 using SimObject::startup; 674 675 typedef ArmISAParams Params; 676 677 const Params *params() const; 678 679 ISA(Params *p); 680 }; 681} 682 683template<> 684struct initRenameMode<ArmISA::ISA> 685{ 686 static Enums::VecRegRenameMode mode(const ArmISA::ISA* isa) 687 { 688 return isa->vecRegRenameMode(); 689 } 690 static bool equals(const ArmISA::ISA* isa1, const ArmISA::ISA* isa2) 691 { 692 return mode(isa1) == mode(isa2); 693 } 694}; 695 696#endif 697