thread_context.hh revision 10190
12817Sksewell@umich.edu/* 29426SAndreas.Sandberg@ARM.com * Copyright (c) 2011-2012 ARM Limited 39920Syasuko.eckert@amd.com * Copyright (c) 2013 Advanced Micro Devices, Inc. 48733Sgeoffrey.blake@arm.com * All rights reserved 58733Sgeoffrey.blake@arm.com * 68733Sgeoffrey.blake@arm.com * The license below extends only to copyright in the software and shall 78733Sgeoffrey.blake@arm.com * not be construed as granting a license to any other intellectual 88733Sgeoffrey.blake@arm.com * property including but not limited to intellectual property relating 98733Sgeoffrey.blake@arm.com * to a hardware implementation of the functionality of the software 108733Sgeoffrey.blake@arm.com * licensed hereunder. You may use the software subject to the license 118733Sgeoffrey.blake@arm.com * terms below provided that you ensure that this notice is replicated 128733Sgeoffrey.blake@arm.com * unmodified and in its entirety in all distributions of the software, 138733Sgeoffrey.blake@arm.com * modified or unmodified, in source code or in binary form. 148733Sgeoffrey.blake@arm.com * 152817Sksewell@umich.edu * Copyright (c) 2004-2006 The Regents of The University of Michigan 162817Sksewell@umich.edu * All rights reserved. 172817Sksewell@umich.edu * 182817Sksewell@umich.edu * Redistribution and use in source and binary forms, with or without 192817Sksewell@umich.edu * modification, are permitted provided that the following conditions are 202817Sksewell@umich.edu * met: redistributions of source code must retain the above copyright 212817Sksewell@umich.edu * notice, this list of conditions and the following disclaimer; 222817Sksewell@umich.edu * redistributions in binary form must reproduce the above copyright 232817Sksewell@umich.edu * notice, this list of conditions and the following disclaimer in the 242817Sksewell@umich.edu * documentation and/or other materials provided with the distribution; 252817Sksewell@umich.edu * neither the name of the copyright holders nor the names of its 262817Sksewell@umich.edu * contributors may be used to endorse or promote products derived from 272817Sksewell@umich.edu * this software without specific prior written permission. 282817Sksewell@umich.edu * 292817Sksewell@umich.edu * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 302817Sksewell@umich.edu * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 312817Sksewell@umich.edu * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 322817Sksewell@umich.edu * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 332817Sksewell@umich.edu * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 342817Sksewell@umich.edu * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 352817Sksewell@umich.edu * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 362817Sksewell@umich.edu * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 372817Sksewell@umich.edu * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 382817Sksewell@umich.edu * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 392817Sksewell@umich.edu * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 402817Sksewell@umich.edu * 412817Sksewell@umich.edu * Authors: Kevin Lim 422817Sksewell@umich.edu */ 432817Sksewell@umich.edu 442817Sksewell@umich.edu#ifndef __CPU_O3_THREAD_CONTEXT_HH__ 452817Sksewell@umich.edu#define __CPU_O3_THREAD_CONTEXT_HH__ 462817Sksewell@umich.edu 476658Snate@binkert.org#include "config/the_isa.hh" 488229Snate@binkert.org#include "cpu/o3/isa_specific.hh" 492935Sksewell@umich.edu#include "cpu/thread_context.hh" 502817Sksewell@umich.edu 512834Sksewell@umich.educlass EndQuiesceEvent; 522834Sksewell@umich.edunamespace Kernel { 532834Sksewell@umich.edu class Statistics; 548902Sandreas.hansson@arm.com} 552834Sksewell@umich.edu 562817Sksewell@umich.edu/** 572817Sksewell@umich.edu * Derived ThreadContext class for use with the O3CPU. It 582817Sksewell@umich.edu * provides the interface for any external objects to access a 592817Sksewell@umich.edu * single thread's state and some general CPU state. Any time 602817Sksewell@umich.edu * external objects try to update state through this interface, 612817Sksewell@umich.edu * the CPU will create an event to squash all in-flight 622817Sksewell@umich.edu * instructions in order to ensure state is maintained correctly. 632817Sksewell@umich.edu * It must be defined specifically for the O3CPU because 642817Sksewell@umich.edu * not all architectural state is located within the O3ThreadState 652817Sksewell@umich.edu * (such as the commit PC, and registers), and specific actions 662817Sksewell@umich.edu * must be taken when using this interface (such as squashing all 672817Sksewell@umich.edu * in-flight instructions when doing a write to this interface). 682817Sksewell@umich.edu */ 692817Sksewell@umich.edutemplate <class Impl> 702817Sksewell@umich.educlass O3ThreadContext : public ThreadContext 712817Sksewell@umich.edu{ 722817Sksewell@umich.edu public: 732817Sksewell@umich.edu typedef typename Impl::O3CPU O3CPU; 742817Sksewell@umich.edu 752817Sksewell@umich.edu /** Pointer to the CPU. */ 762817Sksewell@umich.edu O3CPU *cpu; 772817Sksewell@umich.edu 782817Sksewell@umich.edu /** Pointer to the thread state that this TC corrseponds to. */ 792817Sksewell@umich.edu O3ThreadState<Impl> *thread; 802817Sksewell@umich.edu 813784Sgblack@eecs.umich.edu /** Returns a pointer to the ITB. */ 826022Sgblack@eecs.umich.edu TheISA::TLB *getITBPtr() { return cpu->itb; } 833784Sgblack@eecs.umich.edu 843784Sgblack@eecs.umich.edu /** Returns a pointer to the DTB. */ 856022Sgblack@eecs.umich.edu TheISA::TLB *getDTBPtr() { return cpu->dtb; } 863784Sgblack@eecs.umich.edu 878887Sgeoffrey.blake@arm.com CheckerCPU *getCheckerCpuPtr() { return NULL; } 888733Sgeoffrey.blake@arm.com 899023Sgblack@eecs.umich.edu TheISA::Decoder * 909023Sgblack@eecs.umich.edu getDecoderPtr() 919023Sgblack@eecs.umich.edu { 929023Sgblack@eecs.umich.edu return cpu->fetch.decoder[thread->threadId()]; 939023Sgblack@eecs.umich.edu } 948541Sgblack@eecs.umich.edu 952817Sksewell@umich.edu /** Returns a pointer to this CPU. */ 962817Sksewell@umich.edu virtual BaseCPU *getCpuPtr() { return cpu; } 972817Sksewell@umich.edu 982817Sksewell@umich.edu /** Reads this CPU's ID. */ 9910110Sandreas.hansson@arm.com virtual int cpuId() const { return cpu->cpuId(); } 1002817Sksewell@umich.edu 10110190Sakash.bagdia@arm.com /** Reads this CPU's Socket ID. */ 10210190Sakash.bagdia@arm.com virtual uint32_t socketId() const { return cpu->socketId(); } 10310190Sakash.bagdia@arm.com 10410110Sandreas.hansson@arm.com virtual int contextId() const { return thread->contextId(); } 1055714Shsul@eecs.umich.edu 1065714Shsul@eecs.umich.edu virtual void setContextId(int id) { thread->setContextId(id); } 1075714Shsul@eecs.umich.edu 1085715Shsul@eecs.umich.edu /** Returns this thread's ID number. */ 10910110Sandreas.hansson@arm.com virtual int threadId() const { return thread->threadId(); } 1105715Shsul@eecs.umich.edu virtual void setThreadId(int id) { return thread->setThreadId(id); } 1115715Shsul@eecs.umich.edu 1122817Sksewell@umich.edu /** Returns a pointer to the system. */ 1132817Sksewell@umich.edu virtual System *getSystemPtr() { return cpu->system; } 1142817Sksewell@umich.edu 1152817Sksewell@umich.edu /** Returns a pointer to this thread's kernel statistics. */ 1163548Sgblack@eecs.umich.edu virtual TheISA::Kernel::Statistics *getKernelStats() 1172817Sksewell@umich.edu { return thread->kernelStats; } 1182817Sksewell@umich.edu 1198541Sgblack@eecs.umich.edu /** Returns a pointer to this thread's process. */ 1208541Sgblack@eecs.umich.edu virtual Process *getProcessPtr() { return thread->getProcessPtr(); } 1218754Sgblack@eecs.umich.edu 1228852Sandreas.hansson@arm.com virtual PortProxy &getPhysProxy() { return thread->getPhysProxy(); } 1232817Sksewell@umich.edu 1248852Sandreas.hansson@arm.com virtual FSTranslatingPortProxy &getVirtProxy(); 1253675Sktlim@umich.edu 1268706Sandreas.hansson@arm.com virtual void initMemProxies(ThreadContext *tc) 1278706Sandreas.hansson@arm.com { thread->initMemProxies(tc); } 1288799Sgblack@eecs.umich.edu 1298852Sandreas.hansson@arm.com virtual SETranslatingPortProxy &getMemProxy() 1308706Sandreas.hansson@arm.com { return thread->getMemProxy(); } 1312817Sksewell@umich.edu 1322817Sksewell@umich.edu /** Returns this thread's status. */ 1332817Sksewell@umich.edu virtual Status status() const { return thread->status(); } 1342817Sksewell@umich.edu 1352817Sksewell@umich.edu /** Sets this thread's status. */ 1362817Sksewell@umich.edu virtual void setStatus(Status new_status) 1372817Sksewell@umich.edu { thread->setStatus(new_status); } 1382817Sksewell@umich.edu 1392817Sksewell@umich.edu /** Set the status to Active. Optional delay indicates number of 1402817Sksewell@umich.edu * cycles to wait before beginning execution. */ 1419180Sandreas.hansson@arm.com virtual void activate(Cycles delay = Cycles(1)); 1422817Sksewell@umich.edu 1432817Sksewell@umich.edu /** Set the status to Suspended. */ 1449180Sandreas.hansson@arm.com virtual void suspend(Cycles delay = Cycles(0)); 1452817Sksewell@umich.edu 1462817Sksewell@umich.edu /** Set the status to Halted. */ 1479180Sandreas.hansson@arm.com virtual void halt(Cycles delay = Cycles(0)); 1482817Sksewell@umich.edu 1492817Sksewell@umich.edu /** Dumps the function profiling information. 1502817Sksewell@umich.edu * @todo: Implement. 1512817Sksewell@umich.edu */ 1522817Sksewell@umich.edu virtual void dumpFuncProfile(); 1538777Sgblack@eecs.umich.edu 1542817Sksewell@umich.edu /** Takes over execution of a thread from another CPU. */ 1552817Sksewell@umich.edu virtual void takeOverFrom(ThreadContext *old_context); 1562817Sksewell@umich.edu 1572817Sksewell@umich.edu /** Registers statistics associated with this TC. */ 1582817Sksewell@umich.edu virtual void regStats(const std::string &name); 1592817Sksewell@umich.edu 1602817Sksewell@umich.edu /** Reads the last tick that this thread was activated on. */ 1612817Sksewell@umich.edu virtual Tick readLastActivate(); 1622817Sksewell@umich.edu /** Reads the last tick that this thread was suspended on. */ 1632817Sksewell@umich.edu virtual Tick readLastSuspend(); 1642817Sksewell@umich.edu 1652817Sksewell@umich.edu /** Clears the function profiling information. */ 1662817Sksewell@umich.edu virtual void profileClear(); 1672817Sksewell@umich.edu /** Samples the function profiling information. */ 1682817Sksewell@umich.edu virtual void profileSample(); 1692817Sksewell@umich.edu 1702817Sksewell@umich.edu /** Copies the architectural registers from another TC into this TC. */ 1712817Sksewell@umich.edu virtual void copyArchRegs(ThreadContext *tc); 1722817Sksewell@umich.edu 1732817Sksewell@umich.edu /** Resets all architectural registers to 0. */ 1742817Sksewell@umich.edu virtual void clearArchRegs(); 1752817Sksewell@umich.edu 1762817Sksewell@umich.edu /** Reads an integer register. */ 1779426SAndreas.Sandberg@ARM.com virtual uint64_t readIntReg(int reg_idx) { 1789426SAndreas.Sandberg@ARM.com return readIntRegFlat(flattenIntIndex(reg_idx)); 1799426SAndreas.Sandberg@ARM.com } 1802817Sksewell@umich.edu 1819426SAndreas.Sandberg@ARM.com virtual FloatReg readFloatReg(int reg_idx) { 1829426SAndreas.Sandberg@ARM.com return readFloatRegFlat(flattenFloatIndex(reg_idx)); 1839426SAndreas.Sandberg@ARM.com } 1842817Sksewell@umich.edu 1859426SAndreas.Sandberg@ARM.com virtual FloatRegBits readFloatRegBits(int reg_idx) { 1869426SAndreas.Sandberg@ARM.com return readFloatRegBitsFlat(flattenFloatIndex(reg_idx)); 1879426SAndreas.Sandberg@ARM.com } 1882817Sksewell@umich.edu 1899920Syasuko.eckert@amd.com virtual CCReg readCCReg(int reg_idx) { 1909920Syasuko.eckert@amd.com return readCCRegFlat(flattenCCIndex(reg_idx)); 1919920Syasuko.eckert@amd.com } 1929920Syasuko.eckert@amd.com 1932817Sksewell@umich.edu /** Sets an integer register to a value. */ 1949426SAndreas.Sandberg@ARM.com virtual void setIntReg(int reg_idx, uint64_t val) { 1959426SAndreas.Sandberg@ARM.com setIntRegFlat(flattenIntIndex(reg_idx), val); 1969426SAndreas.Sandberg@ARM.com } 1972817Sksewell@umich.edu 1989426SAndreas.Sandberg@ARM.com virtual void setFloatReg(int reg_idx, FloatReg val) { 1999426SAndreas.Sandberg@ARM.com setFloatRegFlat(flattenFloatIndex(reg_idx), val); 2009426SAndreas.Sandberg@ARM.com } 2012817Sksewell@umich.edu 2029426SAndreas.Sandberg@ARM.com virtual void setFloatRegBits(int reg_idx, FloatRegBits val) { 2039426SAndreas.Sandberg@ARM.com setFloatRegBitsFlat(flattenFloatIndex(reg_idx), val); 2049426SAndreas.Sandberg@ARM.com } 2052817Sksewell@umich.edu 2069920Syasuko.eckert@amd.com virtual void setCCReg(int reg_idx, CCReg val) { 2079920Syasuko.eckert@amd.com setCCRegFlat(flattenCCIndex(reg_idx), val); 2089920Syasuko.eckert@amd.com } 2099920Syasuko.eckert@amd.com 2107720Sgblack@eecs.umich.edu /** Reads this thread's PC state. */ 2117720Sgblack@eecs.umich.edu virtual TheISA::PCState pcState() 2127720Sgblack@eecs.umich.edu { return cpu->pcState(thread->threadId()); } 2137720Sgblack@eecs.umich.edu 2147720Sgblack@eecs.umich.edu /** Sets this thread's PC state. */ 2157720Sgblack@eecs.umich.edu virtual void pcState(const TheISA::PCState &val); 2167720Sgblack@eecs.umich.edu 2178733Sgeoffrey.blake@arm.com virtual void pcStateNoRecord(const TheISA::PCState &val); 2188733Sgeoffrey.blake@arm.com 2192817Sksewell@umich.edu /** Reads this thread's PC. */ 2207720Sgblack@eecs.umich.edu virtual Addr instAddr() 2217720Sgblack@eecs.umich.edu { return cpu->instAddr(thread->threadId()); } 2222817Sksewell@umich.edu 2232817Sksewell@umich.edu /** Reads this thread's next PC. */ 2247720Sgblack@eecs.umich.edu virtual Addr nextInstAddr() 2257720Sgblack@eecs.umich.edu { return cpu->nextInstAddr(thread->threadId()); } 2262817Sksewell@umich.edu 2277720Sgblack@eecs.umich.edu /** Reads this thread's next PC. */ 2287720Sgblack@eecs.umich.edu virtual MicroPC microPC() 2297720Sgblack@eecs.umich.edu { return cpu->microPC(thread->threadId()); } 2305259Sksewell@umich.edu 2312817Sksewell@umich.edu /** Reads a miscellaneous register. */ 2324172Ssaidi@eecs.umich.edu virtual MiscReg readMiscRegNoEffect(int misc_reg) 2335715Shsul@eecs.umich.edu { return cpu->readMiscRegNoEffect(misc_reg, thread->threadId()); } 2344172Ssaidi@eecs.umich.edu 2354172Ssaidi@eecs.umich.edu /** Reads a misc. register, including any side-effects the 2364172Ssaidi@eecs.umich.edu * read might have as defined by the architecture. */ 2372817Sksewell@umich.edu virtual MiscReg readMiscReg(int misc_reg) 2385715Shsul@eecs.umich.edu { return cpu->readMiscReg(misc_reg, thread->threadId()); } 2392817Sksewell@umich.edu 2402817Sksewell@umich.edu /** Sets a misc. register. */ 2414172Ssaidi@eecs.umich.edu virtual void setMiscRegNoEffect(int misc_reg, const MiscReg &val); 2422817Sksewell@umich.edu 2432817Sksewell@umich.edu /** Sets a misc. register, including any side-effects the 2442817Sksewell@umich.edu * write might have as defined by the architecture. */ 2454172Ssaidi@eecs.umich.edu virtual void setMiscReg(int misc_reg, const MiscReg &val); 2462817Sksewell@umich.edu 2476313Sgblack@eecs.umich.edu virtual int flattenIntIndex(int reg); 2486313Sgblack@eecs.umich.edu virtual int flattenFloatIndex(int reg); 2499920Syasuko.eckert@amd.com virtual int flattenCCIndex(int reg); 25010033SAli.Saidi@ARM.com virtual int flattenMiscIndex(int reg); 2516313Sgblack@eecs.umich.edu 2522817Sksewell@umich.edu /** Returns the number of consecutive store conditional failures. */ 2532817Sksewell@umich.edu // @todo: Figure out where these store cond failures should go. 2542817Sksewell@umich.edu virtual unsigned readStCondFailures() 2552817Sksewell@umich.edu { return thread->storeCondFailures; } 2562817Sksewell@umich.edu 2572817Sksewell@umich.edu /** Sets the number of consecutive store conditional failures. */ 2582817Sksewell@umich.edu virtual void setStCondFailures(unsigned sc_failures) 2592817Sksewell@umich.edu { thread->storeCondFailures = sc_failures; } 2602817Sksewell@umich.edu 2612817Sksewell@umich.edu // Only really makes sense for old CPU model. Lots of code 2622817Sksewell@umich.edu // outside the CPU still checks this function, so it will 2632817Sksewell@umich.edu // always return false to keep everything working. 2642817Sksewell@umich.edu /** Checks if the thread is misspeculating. Because it is 2652817Sksewell@umich.edu * very difficult to determine if the thread is 2662817Sksewell@umich.edu * misspeculating, this is set as false. */ 2672817Sksewell@umich.edu virtual bool misspeculating() { return false; } 2682817Sksewell@umich.edu 2692817Sksewell@umich.edu /** Executes a syscall in SE mode. */ 2702817Sksewell@umich.edu virtual void syscall(int64_t callnum) 2715715Shsul@eecs.umich.edu { return cpu->syscall(callnum, thread->threadId()); } 2722817Sksewell@umich.edu 2732817Sksewell@umich.edu /** Reads the funcExeInst counter. */ 2742817Sksewell@umich.edu virtual Counter readFuncExeInst() { return thread->funcExeInst; } 2758777Sgblack@eecs.umich.edu 2765595Sgblack@eecs.umich.edu /** Returns pointer to the quiesce event. */ 2775595Sgblack@eecs.umich.edu virtual EndQuiesceEvent *getQuiesceEvent() 2785595Sgblack@eecs.umich.edu { 2795595Sgblack@eecs.umich.edu return this->thread->quiesceEvent; 2805595Sgblack@eecs.umich.edu } 2819382SAli.Saidi@ARM.com /** check if the cpu is currently in state update mode and squash if not. 2829382SAli.Saidi@ARM.com * This function will return true if a trap is pending or if a fault or 2839382SAli.Saidi@ARM.com * similar is currently writing to the thread context and doesn't want 2849382SAli.Saidi@ARM.com * reset all the state (see noSquashFromTC). 2859382SAli.Saidi@ARM.com */ 2869382SAli.Saidi@ARM.com inline void conditionalSquash() 2879382SAli.Saidi@ARM.com { 2889382SAli.Saidi@ARM.com if (!thread->trapPending && !thread->noSquashFromTC) 2899382SAli.Saidi@ARM.com cpu->squashFromTC(thread->threadId()); 2909382SAli.Saidi@ARM.com } 2915595Sgblack@eecs.umich.edu 2929426SAndreas.Sandberg@ARM.com virtual uint64_t readIntRegFlat(int idx); 2939426SAndreas.Sandberg@ARM.com virtual void setIntRegFlat(int idx, uint64_t val); 2949426SAndreas.Sandberg@ARM.com 2959426SAndreas.Sandberg@ARM.com virtual FloatReg readFloatRegFlat(int idx); 2969426SAndreas.Sandberg@ARM.com virtual void setFloatRegFlat(int idx, FloatReg val); 2979426SAndreas.Sandberg@ARM.com 2989426SAndreas.Sandberg@ARM.com virtual FloatRegBits readFloatRegBitsFlat(int idx); 2999426SAndreas.Sandberg@ARM.com virtual void setFloatRegBitsFlat(int idx, FloatRegBits val); 3009920Syasuko.eckert@amd.com 3019920Syasuko.eckert@amd.com virtual CCReg readCCRegFlat(int idx); 3029920Syasuko.eckert@amd.com virtual void setCCRegFlat(int idx, CCReg val); 3032817Sksewell@umich.edu}; 3042817Sksewell@umich.edu 3052817Sksewell@umich.edu#endif 306