orcasim::modeling::ProcessorBase< T > Class Template Reference

This class implements the base operation for generic processor implementations. More...

#include <ProcessorBase.hpp>

Inheritance diagram for orcasim::modeling::ProcessorBase< T >:

Public Member Functions
	ProcessorBase (std::string name, MemoryAddr initial_pc, Memory *mem)
	Default constructor. More...
	~ProcessorBase ()
	Destructor. More...
virtual SimulationTime	Run ()=0
	Run method from the base TimedModel class, overloaded. More...
ProcessorState< T > *	GetState ()
	This method returns the state model of the processor. More...
Memory *	GetMemory ()
	This method returns a pointer to the object that models the memory core. More...
virtual void	Reset ()=0
	Resets the instance to its starting state. More...
a name that identifies the model, advisably not empty.
Default ctor.
std::string	GetName ()
	Getter method for the <_name> field. More...
void	SetName (std::string s)
	Setter method for the <_name> field. More...

Private Attributes
struct ProcessorState< T >	_state
	struct that represent the state of a processor. More...
Memory *	_memory
	We assume that every processor is attached to a memory core. More...

Detailed Description

template<typename T>
class orcasim::modeling::ProcessorBase< T >

This class implements the base operation for generic processor implementations.

This class uses templates to handle the size of internal registers (registers are limited to have the same size)

Definition at line 47 of file ProcessorBase.hpp.

Constructor & Destructor Documentation

ProcessorBase()

template<typename T >

ProcessorBase::ProcessorBase	(	std::string	name,
		MemoryAddr	initial_pc,
		Memory *	mem
	)

Default constructor.

Parameters

name	A short name or description of the instance
initial_pc	Memory address to which the PC register will point to at the startup.

Definition at line 41 of file ProcessorBase.cpp.

                                        : TimedModel(name) {

    // set mem ptr
    _memory = mem;

    // reset registers
    for (int i = 0; i < NUMBER_OF_REGISTERS; i++)
        _state.regs[i] = 0;

    // reset PC
    _state.pc_prev = initial_pc;
    _state.pc = initial_pc;
    _state.pc_next = _state.pc + sizeof(T);

    // reset flags
    #ifdef ORCA_ENABLE_GDBRSP
    _state.bp = 0;  // no breakpoint reached yet
    _state.pause = 1;  // starts paused in gdb mode
    _state.steps = 0;  // no steps to be performed, wait for gdb
    _gdbserver = new RspServer<T>(&_state,
        _memory, "127.0.0.1", GDBSERVER_PORT++);
    #endif

    // reset special flags
    _state.terminated = false;
}

~ProcessorBase()

template<typename T >

ProcessorBase::~ProcessorBase

(

)

Destructor.

Definition at line 70 of file ProcessorBase.cpp.

                                 {
    #ifdef ORCA_ENABLE_GDBRSP
    delete _gdbserver;
    #endif
}

Member Function Documentation

GetMemory()

template<typename T >

Memory * ProcessorBase::GetMemory ( )

inline

This method returns a pointer to the object that models the memory core.

It is made private to avoid being changed by the processor core implementation.

Returns

a pointers to the memory model

Definition at line 86 of file ProcessorBase.cpp.

                                           {
    return _memory;
}

GetName()

std::string Model::GetName ( )

inherited

Getter method for the <_name> field.

Definition at line 34 of file Model.cpp.

                         {
    return _name;
}

GetState()

template<typename T >

ProcessorState< T > * ProcessorBase::GetState ( )

inline

This method returns the state model of the processor.

Access the current state of the processor.

This is ideally used from the top level simulator to report processor states at the end of simulation.

Returns

a pointer to the processor state struct.

A pointer to the state of the processor.

Definition at line 81 of file ProcessorBase.cpp.

                                                     {
    return &_state;
}

Reset()

virtual void orcasim::base::TimedModel::Reset ( )

pure virtualinherited

Resets the instance to its starting state.

Must be implemented by subclasses

Implemented in orcasim::models::orca::NetBridge, orcasim::models::orca::DmaNetif, and orcasim::models::hermes::HermesRouter.

Run()

template<typename T >

SimulationTime ProcessorBase::Run ( )

pure virtual

Run method from the base TimedModel class, overloaded.

We include in the overloading external components that would apply to all processors. Examples include energy estimation (through counters) and GDBRSP.

Returns

the number of cycles to skip until next schedule.

Implements orcasim::base::TimedModel.

Implemented in orcasim::models::hfriscv::HFRiscV, and orcasim::gdbrsp::GdbProcessorBase< T >.

Definition at line 91 of file ProcessorBase.cpp.

                                     {
    return 0;
    // nothing todo
}

SetName()

void Model::SetName ( std::string  s )

inherited

Setter method for the <_name> field.

Parameters

s	Value to be set

Definition at line 38 of file Model.cpp.

                                        {
    _name = name;
}

Member Data Documentation

_memory

template<typename T>

Memory* orcasim::modeling::ProcessorBase< T >::_memory

private

We assume that every processor is attached to a memory core.

For now, the only core available is untimed.

Definition at line 58 of file ProcessorBase.hpp.

_state

template<typename T>

struct ProcessorState< T > orcasim::modeling::ProcessorBase< T >::_state

private

struct that represent the state of a processor.

All processor share the same state model, which permit us to implement features such as the GDB's remote debug server.

Definition at line 53 of file ProcessorBase.hpp.

---

The documentation for this class was generated from the following files:

• orcasim-modeling/include/ProcessorBase.hpp
• orcasim-modeling/src/ProcessorBase.cpp