thread_context.hh

Go to the documentation of this file.

/*
 * Copyright 2019 Google, Inc.
 *
 * 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.
 */
 
#ifndef __ARCH_ARM_FASTMODEL_IRIS_THREAD_CONTEXT_HH__
#define __ARCH_ARM_FASTMODEL_IRIS_THREAD_CONTEXT_HH__
 
#include <list>
#include <map>
#include <memory>
#include <optional>
#include <unordered_map>
 
#include "arch/arm/fastmodel/iris/memory_spaces.hh"
#include "arch/arm/regs/vec.hh"
#include "cpu/base.hh"
#include "cpu/thread_context.hh"
#include "iris/IrisInstance.h"
#include "iris/detail/IrisErrorCode.h"
#include "iris/detail/IrisObjects.h"
#include "sim/system.hh"
 
namespace gem5
{
 
namespace Iris
{
 
// This class is the base for ThreadContexts which read and write state using
// the Iris API.
class ThreadContext : public gem5::ThreadContext
{
  public:
    typedef std::map<std::string, iris::ResourceInfo> ResourceMap;
 
    typedef std::vector<iris::ResourceId> ResourceIds;
    typedef std::map<int, std::string> IdxNameMap;
 
    typedef std::unordered_map<Iris::CanonicalMsn, iris::MemorySpaceId>
        MemorySpaceMap;
 
  protected:
    gem5::BaseCPU *_cpu;
    int _threadId;
    ContextID _contextId;
    System *_system;
    gem5::BaseMMU *_mmu;
    gem5::BaseISA *_isa;
 
    std::string _irisPath;
    iris::InstanceId _instId = iris::IRIS_UINT64_MAX;
 
    // Temporary holding places for the vector reg accessors to return.
    // These are not updated live, only when requested.
    mutable std::vector<ArmISA::VecRegContainer> vecRegs;
    mutable std::vector<ArmISA::VecPredRegContainer> vecPredRegs;
 
    Status _status = Active;
    Event *enableAfterPseudoEvent;
 
    virtual void initFromIrisInstance(const ResourceMap &resources);
 
    iris::ResourceId extractResourceId(
            const ResourceMap &resources, const std::string &name);
    void extractResourceMap(ResourceIds &ids,
            const ResourceMap &resources, const IdxNameMap &idx_names);
    iris::MemorySpaceId getMemorySpaceId(const Iris::CanonicalMsn& msn) const;
 
 
    ResourceIds miscRegIds;
    ResourceIds intReg32Ids;
    ResourceIds intReg64Ids;
    ResourceIds flattenedIntIds;
    ResourceIds ccRegIds;
 
    iris::ResourceId pcRscId = iris::IRIS_UINT64_MAX;
    iris::ResourceId icountRscId;
 
    ResourceIds vecRegIds;
    ResourceIds vecPredRegIds;
 
    std::vector<iris::MemorySpaceInfo> memorySpaces;
    std::vector<iris::MemorySupportedAddressTranslationResult> translations;
    MemorySpaceMap memorySpaceIds;
 
    // A queue to keep track of instruction count based events.
    EventQueue comInstEventQueue;
    // A helper function to maintain the IRIS step count. This makes sure the
    // step count is correct even after IRIS resets it for us, and also handles
    // events which are supposed to happen at the current instruction count.
    void maintainStepping();
 
 
    using BpId = uint64_t;
    struct BpInfo
    {
        Addr pc;
        std::vector<BpId> ids;
        using EventList = std::list<PCEvent *>;
        std::shared_ptr<EventList> events;
 
        BpInfo(Addr _pc) : pc(_pc), events(new EventList) {}
 
        bool empty() const { return events->empty(); }
        bool validIds() const { return !ids.empty(); }
        void clearIds() { ids.clear(); }
    };
 
    using BpInfoPtr = std::unique_ptr<BpInfo>;
    using BpInfoMap = std::map<Addr, BpInfoPtr>;
    using BpInfoIt = BpInfoMap::iterator;
 
    BpInfoMap bps;
    std::optional<Addr> bpAddr;
 
    BpInfoIt getOrAllocBp(Addr pc);
 
    void installBp(BpInfoIt it);
    void uninstallBp(BpInfoIt it);
    void delBp(BpInfoIt it);
 
    virtual const std::vector<iris::MemorySpaceId> &getBpSpaceIds() const = 0;
 
 
    iris::IrisErrorCode instanceRegistryChanged(
            uint64_t esId, const iris::IrisValueMap &fields, uint64_t time,
            uint64_t sInstId, bool syncEc, std::string &error_message_out);
    iris::IrisErrorCode phaseInitLeave(
            uint64_t esId, const iris::IrisValueMap &fields, uint64_t time,
            uint64_t sInstId, bool syncEc, std::string &error_message_out);
    iris::IrisErrorCode simulationTimeEvent(
            uint64_t esId, const iris::IrisValueMap &fields, uint64_t time,
            uint64_t sInstId, bool syncEc, std::string &error_message_out);
    iris::IrisErrorCode breakpointHit(
            uint64_t esId, const iris::IrisValueMap &fields, uint64_t time,
            uint64_t sInstId, bool syncEc, std::string &error_message_out);
    iris::IrisErrorCode semihostingEvent(
            uint64_t esId, const iris::IrisValueMap &fields, uint64_t time,
            uint64_t sInstId, bool syncEc, std::string &error_message_out);
 
    iris::EventStreamId regEventStreamId;
    iris::EventStreamId initEventStreamId;
    iris::EventStreamId timeEventStreamId;
    iris::EventStreamId breakpointEventStreamId;
    iris::EventStreamId semihostingEventStreamId;
 
    mutable iris::IrisInstance client;
    iris::IrisCppAdapter &call() const { return client.irisCall(); }
    iris::IrisCppAdapter &noThrow() const { return client.irisCallNoThrow(); }
 
    mutable ArmISA::PCState pc;
 
    void readMem(iris::MemorySpaceId space,
                 Addr addr, void *p, size_t size);
    void writeMem(iris::MemorySpaceId space,
                  Addr addr, const void *p, size_t size);
    bool translateAddress(Addr &paddr, iris::MemorySpaceId p_space,
                          Addr vaddr, iris::MemorySpaceId v_space);
 
  public:
    ThreadContext(gem5::BaseCPU *cpu, int id, System *system,
                  gem5::BaseMMU *mmu, gem5::BaseISA *isa,
                  iris::IrisConnectionInterface *iris_if,
                  const std::string &iris_path);
    virtual ~ThreadContext();
 
    virtual bool translateAddress(Addr &paddr, Addr vaddr) = 0;
 
    bool schedule(PCEvent *e) override;
    bool remove(PCEvent *e) override;
 
    void scheduleInstCountEvent(Event *event, Tick count) override;
    void descheduleInstCountEvent(Event *event) override;
    Tick getCurrentInstCount() override;
 
    gem5::BaseCPU *getCpuPtr() override { return _cpu; }
    int cpuId() const override { return _cpu->cpuId(); }
    uint32_t socketId() const override { return _cpu->socketId(); }
 
    int threadId() const override { return _threadId; }
    void setThreadId(int id) override { _threadId = id; }
 
    int contextId() const override { return _contextId; }
    void setContextId(int id) override { _contextId = id; }
 
    BaseMMU *
    getMMUPtr() override
    {
        return _mmu;
    }
 
    CheckerCPU *getCheckerCpuPtr() override { return nullptr; }
    InstDecoder *
    getDecoderPtr() override
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    System *getSystemPtr() override { return _cpu->system; }
 
    BaseISA *
    getIsaPtr() const override
    {
        return _isa;
    }
 
    void sendFunctional(PacketPtr pkt) override;
 
    Process *
    getProcessPtr() override
    {
        panic("%s not implemented.", __FUNCTION__);
    }
    void
    setProcessPtr(Process *p) override
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    Status status() const override;
    void setStatus(Status new_status) override;
    void activate() override { setStatus(Active); }
    void suspend() override { setStatus(Suspended); }
    void halt() override { setStatus(Halted); }
 
    void
    takeOverFrom(gem5::ThreadContext *old_context) override
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    void regStats(const std::string &name) override {}
 
    // Not necessarily the best location for these...
    // Having an extra function just to read these is obnoxious
    Tick
    readLastActivate() override
    {
        panic("%s not implemented.", __FUNCTION__);
    }
    Tick readLastSuspend() override
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    void
    copyArchRegs(gem5::ThreadContext *tc) override
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    void
    clearArchRegs() override
    {
        warn("Ignoring clearArchRegs()");
    }
 
    //
    // New accessors for new decoder.
    //
    RegVal getReg(const RegId &reg) const override;
    void getReg(const RegId &reg, void *val) const override;
    void *getWritableReg(const RegId &reg) override;
 
    void setReg(const RegId &reg, RegVal val) override;
    void setReg(const RegId &reg, const void *val) override;
 
    iris::ResourceId getIntRegRscId(RegIndex int_reg) const;
    virtual RegVal readIntReg(RegIndex reg_idx) const;
 
    iris::ResourceId getVecRegRscId(RegIndex vec_reg) const;
    virtual const ArmISA::VecRegContainer &readVecReg(const RegId &reg) const;
    virtual ArmISA::VecRegContainer &
    getWritableVecReg(const RegId &reg)
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    virtual RegVal
    readVecElem(const RegId &reg) const
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    iris::ResourceId getVecPredRegRscId(RegIndex vec_reg) const;
    virtual const ArmISA::VecPredRegContainer &
        readVecPredReg(const RegId &reg) const;
    virtual ArmISA::VecPredRegContainer &
    getWritableVecPredReg(const RegId &reg)
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    virtual RegVal
    readCCReg(RegIndex reg_idx) const
    {
        return readCCRegFlat(reg_idx);
    }
 
    virtual void setIntReg(RegIndex reg_idx, RegVal val);
 
    virtual void
    setVecReg(const RegId &reg, const ArmISA::VecRegContainer &val)
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    virtual void
    setVecElem(const RegId& reg, RegVal val)
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    virtual void
    setVecPredReg(const RegId &reg,
                  const ArmISA::VecPredRegContainer &val)
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    virtual void
    setCCReg(RegIndex reg_idx, RegVal val)
    {
        setCCRegFlat(reg_idx, val);
    }
 
    void pcStateNoRecord(const PCStateBase &val) override { pcState(val); }
 
    const PCStateBase &pcState() const override;
    void pcState(const PCStateBase &val) override;
 
    iris::ResourceId getMiscRegRscId(RegIndex misc_reg) const;
    RegVal readMiscRegNoEffect(RegIndex misc_reg) const override;
    RegVal
    readMiscReg(RegIndex misc_reg) override
    {
        return readMiscRegNoEffect(misc_reg);
    }
 
    void setMiscRegNoEffect(RegIndex misc_reg, const RegVal val) override;
    void
    setMiscReg(RegIndex misc_reg, const RegVal val) override
    {
        setMiscRegNoEffect(misc_reg, val);
    }
 
    // Also not necessarily the best location for these two.  Hopefully will go
    // away once we decide upon where st cond failures goes.
    unsigned
    readStCondFailures() const override
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    void
    setStCondFailures(unsigned sc_failures) override
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    iris::ResourceId getIntRegFlatRscId(RegIndex int_reg) const;
    virtual RegVal readIntRegFlat(RegIndex idx) const;
    virtual void setIntRegFlat(RegIndex idx, uint64_t val);
 
    virtual const ArmISA::VecRegContainer &readVecRegFlat(RegIndex idx) const;
    virtual ArmISA::VecRegContainer &
    getWritableVecRegFlat(RegIndex idx)
    {
        panic("%s not implemented.", __FUNCTION__);
    }
    virtual void
    setVecRegFlat(RegIndex idx, const ArmISA::VecRegContainer &val)
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    virtual RegVal
    readVecElemFlat(RegIndex idx) const
    {
        panic("%s not implemented.", __FUNCTION__);
    }
    virtual void
    setVecElemFlat(RegIndex idx, RegVal val)
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    virtual ArmISA::VecPredRegContainer readVecPredRegFlat(RegIndex idx) const;
    virtual ArmISA::VecPredRegContainer &
    getWritableVecPredRegFlat(RegIndex idx)
    {
        panic("%s not implemented.", __FUNCTION__);
    }
    virtual void
    setVecPredRegFlat(RegIndex idx,
            const ArmISA::VecPredRegContainer &val)
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    iris::ResourceId getCCRegFlatRscId(RegIndex cc_reg) const;
    virtual RegVal readCCRegFlat(RegIndex idx) const;
    virtual void setCCRegFlat(RegIndex idx, RegVal val);
    // hardware transactional memory
    void
    htmAbortTransaction(uint64_t htm_uid, HtmFailureFaultCause cause) override
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    BaseHTMCheckpointPtr &
    getHtmCheckpointPtr() override
    {
        panic("%s not implemented.", __FUNCTION__);
    }
 
    void
    setHtmCheckpointPtr(BaseHTMCheckpointPtr cpt) override
    {
        panic("%s not implemented.", __FUNCTION__);
    }
    void readMemWithCurrentMsn(Addr vaddr, size_t size, char *data);
    void writeMemWithCurrentMsn(Addr vaddr, size_t size, const char *data);
};
 
} // namespace Iris
} // namespace gem5
 
#endif // __ARCH_ARM_FASTMODEL_IRIS_THREAD_CONTEXT_HH__