T-EMU
2
The Terma Emulator
|
Go to the source code of this file.
Data Structures | |
struct | temu_CpuIface |
Common CPU interface. More... | |
struct | temu_TrapEventInfo |
Macros | |
#define | TEMU_ATC_FETCH 1 |
#define | TEMU_ATC_READ (1 << 1) |
#define | TEMU_ATC_WRITE (1 << 2) |
#define | TEMU_ATC_USER (1 << 3) |
#define | TEMU_ATC_SUPER (1 << 4) |
#define | TEMU_ATC_HYPER (1 << 5) |
Typedefs | |
typedef struct temu_CpuIface | temu_CpuIface |
Common CPU interface. More... | |
Enumerations | |
enum | temu_CpuState { teCS_Nominal, teCS_Halted, teCS_Idling } |
enum | temu_PowerState { tePS_Off, tePS_On } |
Used to indicate whether a model is powered on. More... | |
enum | temu_CpuExitReason { teCER_Normal = 0, teCER_Trap, teCER_Halt, teCER_Event, teCER_Break, teCER_WatchR, teCER_WatchW, teCER_Early } |
Functions | |
TEMU_IFACE_REFERENCE_TYPE (temu_Cpu) | |
typedef struct temu_CpuIface temu_CpuIface |
Common CPU interface.
The CPU interface provides common functionality that all processors must implement. This includes the reset and run methods. But also different register access functions. The register access functions are functions, because registers may be banked and we want some type of common interface that can access the current registers. Note that the interface currently only support 32 bit processors.
reset The function executing a reset. It takes as parameter the reset type, which is 0 for a default cold reset.
run Run the main emulator loop for a given number of cycles.
runUntil Run the main emulator loop until its cycle counter reach the end cycles.
step Run the given number of steps. A step is one instruction, completed or not. E.g. a trapping instruction does not complete but is counted as a step.
stepUntil Step the emulator, but stop if the step exceeds a certain fixed time.
raiseTrap Raises a trap on the CPU. THIS FUNCTION DOES NOT RETURN!!!
enterIdleMode Will call longjmp and enter idle mode immediately, this is useful for devices that activates power down mode.
exitEmuCore Will call longjmp to exit the emulator core. This can be used in certain cases where the other exit functions do not suite well. One being that a reset is called from an MMIO write or read, or from a watchdog event. The reset can otherwise be called when the emulator is not running, so in a model you can call reset and then exitEmuCore.
getGpr Read the currently visible general purpose registers. For banked registers (e.g. SPARC reg windows), you should look at the arch specific interface instead.
getFpr32 Read the currently visible floating point registers.
setSpr Set special purpose registers. The indexes have been explicitly choosen to be equal to what is assumed by the GDB protocol, but re-based at zero.
getSpr Read special purpose registers. The indexes have been explicitly choosen to be equal to what is assumed by GDB but rebased at zero.
disassemble This function will disassemble an instruction. The function returns a heap-allocated string (allocated with malloc()). The caller is responsible for calling free() and managing the lifetime.
invalidateAtc Invalidates the ATC cache for the given address range. Flags can be set to control the invalidation. Bit 0: don't invalidate fetch. Bit 1: don't Invalidate read, bit 2: don't invalidate write, bit 3 don't invalidate user, bit 4 don't invalidate super.
translateAddress Does a table walk and translates the virtual address to physical page address. For MMU free systems, the function returns the Va masked with ~(page size-1). Otherwise, the return is the translated page address and in the case of failure -1.
enum temu_CpuExitReason |
enum temu_CpuState |
enum temu_PowerState |
TEMU_IFACE_REFERENCE_TYPE | ( | temu_Cpu | ) |