Functions

temu_addArrayProperty

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_addArrayProperty(temu_Class * Cls, const char * Name, int offset, temu_Type T, int NumElems, const char * Doc)

Description

Add a fixed length array property without setters / getters

Result

0 if the property was added

Parameters

Table 1. temu_addArrayProperty Parameters
Parameter Type Description

Cls

temu_Class *

Class pointer

Name

const char *

Name of property

offset

int

Offset from object pointer

T

temu_Type

Property type

NumElems

int

Array length

Doc

const char *

Documentation string

temu_addArrayPseudoProperty

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_addArrayPseudoProperty(temu_Class * Cls, const char * Name, temu_Type T, int NumElems, const char * Doc)

Description

Add an array pseudo-property

Result

0 if the property was added

Parameters

Table 2. temu_addArrayPseudoProperty Parameters
Parameter Type Description

Cls

temu_Class *

Class pointer

Name

const char *

Name of property

T

temu_Type

Property type

NumElems

int

Array length

Doc

const char *

Documentation string

temu_addField

Include

#include "temu-c/Support/Register.h"

Signature

void temu_addField(temu_Register * R, const char * Name, uint64_t Mask, uint64_t Reset, uint64_t Flags, const char * Doc)

Description

Add field to meta register

Adds a field to the meta register.

Parameters

Table 3. temu_addField Parameters
Parameter Type Description

R

temu_Register *

Meta register pointer.

Name

const char *

Name of of field (must be a C-compatible identifier)

Mask

uint64_t

Mask identifying the bits in the register corresponding to the field. Mask must contain consecutive bits only.

Reset

uint64_t

Reset value.

Flags

uint64_t

Flags used: TEMU_FIELD_WR means field is writable, TEMU_FIELD_WARM_RESET means the field is subject to reset actions also on warm resets.

Doc

const char *

Documentation string

temu_addInterfaceArray

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_addInterfaceArray(temu_Class * Cls, const char * IfaceName, const char * IfaceType, void * Iface, size_t Count, size_t Size, const char * Doc)

Description

Add an array of interfaces to a class

Interface arrays are especially useful when e.g. multiple "network ports" are available, although they can be added manually with distinct names (e.g. uartaiface, uartbiface, etc), the interface array registration allows for the addition of several interfaces at once. Individual interfaces are then referred to with normal index syntax, e.g. obj:uartiface[0].

Parameters

Table 4. temu_addInterfaceArray Parameters
Parameter Type Description

Cls

temu_Class *

Class pointer

IfaceName

const char *

name of interface

IfaceType

const char *

name of interface type

Iface

void *

Pointer to array of interfaces

Count

size_t

Number of interfaces in array

Size

size_t

Size of one interface (e.g. sizeof(uartiface[0]))

Doc

const char *

Documentation comment for interface

temu_addInterfaceReference

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_addInterfaceReference(temu_Class * Cls, const char * PropName, int Offset, const char * TypeName, int Count, unsigned int Flags, temu_PropWriter Wr, temu_PropReader Rd, const char * Doc)

Description

Add a interface reference property.

Parameters

Table 5. temu_addInterfaceReference Parameters
Parameter Type Description

Cls

temu_Class *

The class object

PropName

const char *

Name of the property to add.

Offset

int

Offset in bytes from the start of the class to the value the property refers to.

TypeName

const char *

Interface type name.

Count

int

Set to > 1 to indicate that the property is an array, the value is the length of the array.

Flags

unsigned int

Flags for property, 1 implies property is mandatory to set.

Wr

temu_PropWriter

Property write function. This function can have side-effects.

Rd

int),temu_PropReader

Property read function. This function can have side-effects.

Doc

const char *

Documentation string

temu_addLoggingCategory

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_addLoggingCategory(temu_Class * Cls, unsigned int CategoryId, const char * Category)

Description

temu_addLogginCategory adds a logging category to the class

Result

0 for success, 1 indicates failure.

Parameters

Table 6. temu_addLoggingCategory Parameters
Parameter Type Description

Cls

temu_Class *

the class

CategoryId

unsigned int

The category id. Valid range is [8,16)

Category

const char *

The category name

temu_addPort

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_addPort(temu_Class * C, const char * IfaceRefName, const char * IfaceName, const char * Doc)

Description

Make interface reference property and an interface inverses

A port is a bidirectional interface. Thus, if an interface reference is connected to another objects interface, the remote object will be told to issue a reverse connection. This is convenient as it simplifies device connection during system configuration and construction. That is, instead of calling the connect two times with the inverse connections explicitly, only one call is needed.

Result

0 on success, non-zero otherwise.

Parameters

Table 7. temu_addPort Parameters
Parameter Type Description

C

temu_Class *

The class object

IfaceRefName

const char *

the name of the interface reference property

IfaceName

const char *

Name of interface that is the inverse of the interface ref property.

Doc

const char *

Documentation string

temu_addProperty

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_addProperty(temu_Class * Cls, const char * PropName, int Offset, temu_Type Typ, int Count, temu_PropWriter Wr, temu_PropReader Rd, const char * Doc)

Description

Add a property to a class.

Parameters

Table 8. temu_addProperty Parameters
Parameter Type Description

Cls

temu_Class *

The class object

PropName

const char *

Name of the property to add.

Offset

int

Offset in bytes from the start of the class to the value the property refers to.

Typ

temu_Type

Type of the property.

Count

int

Set to > 1 to indicate that the property is an array, the value is the length of the array.

Wr

temu_PropWriter

Property write function. This function can have side-effects.

Rd

int),temu_PropReader

Property read function. This function can have side-effects.

Doc

const char *

Documentation string

temu_addPseudoInterfaceReference

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_addPseudoInterfaceReference(temu_Class * Cls, const char * PropName, const char * TypeName, int Count, unsigned int Flags, temu_PropWriter Wr, temu_PropReader Rd, temu_PropWriter Set, temu_PropReader Get, const char * Doc)

Description

Add a interface reference property.

Parameters

Table 9. temu_addPseudoInterfaceReference Parameters
Parameter Type Description

Cls

temu_Class *

The class object

PropName

const char *

Name of the property to add.

TypeName

const char *

Interface type name.

Count

int

Set to > 1 to indicate that the property is an array, the value is the length of the array.

Flags

unsigned int

Flags for property, 1 implies property is mandatory to set.

Wr

temu_PropWriter

Property write function. This function can have side-effects.

Rd

int),temu_PropReader

Property read function. This function can have side-effects.

Set

temu_PropWriter

Property set function. Non-semantic.

Get

int),temu_PropReader

Property get function. Non-semantic.

Doc

const char *

Documentation string

temu_addPseudoProperty

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_addPseudoProperty(temu_Class * Cls, const char * PropName, temu_Type Typ, int Count, temu_PropWriter Wr, temu_PropReader Rd, temu_PropWriter Set, temu_PropReader Get, const char * Doc)

Description

Add property without storage

A pseudo property does not have backing storage (and therefore no offset). They exist to provide access to computed properties.

Pseudo properties also work fine with C++ types with non-standard layout.

Pseudo properties are snapshotted if the set and get functions are implemented. The set and get should implement read and write without semantic effect. That is, if the property is a register, then the read and write should have the effect of an actual register access (including event rescheduling etc), while for a get/set, only the value of the register is modified, event restoration is done differently.

Parameters

Table 10. temu_addPseudoProperty Parameters
Parameter Type Description

Cls

temu_Class *

class to add pseudo property to

PropName

const char *

name of pseudo property

Typ

temu_Type

Type of property

Count

int

number of elements, 1 for a scalar.

Wr

temu_PropWriter

Property write function (semantic effect)

Rd

int),temu_PropReader

Property read function (semantic effect)

Set

temu_PropWriter

Property set function (non-semantic)

Get

int),temu_PropReader

Property get function (non-semantic)

Doc

const char *

Documentation string

temu_addRegister

Include

#include "temu-c/Support/Register.h"

Signature

temu_Register * temu_addRegister(temu_RegisterBank * Bank, const char * Name, int Offset, temu_Type Typ, int Count, temu_PropWriter Wr, temu_PropReader Rd, const char * Doc, uint32_t DeviceOffset, uint32_t Stride)

Description

Add register property to class

Adds a register with the given name to a class. It returns a reference to a meta register which can be used to add fields.

Result

A reference to a meta register which can be used to add fields.

Parameters

Table 11. temu_addRegister Parameters
Parameter Type Description

Bank

temu_RegisterBank *

Register bank to add register to

Name

const char *

Name of register (must be a valid C-identifier)

Offset

int

Offset to storage element in the device struct.

Typ

temu_Type

Type of register, note that registers are limited to unsigned integer types with fixed width.

Count

int

Number of registers (normally 1)

Wr

temu_PropWriter

Register write function

Rd

int),temu_PropReader

Register read function

Doc

const char *

Documentation string for register.

DeviceOffset

uint32_t

Offset of register in memory system. This is the same offset that is used in the memory transaction interface.

Stride

uint32_t

In case the register is an array of registers, then the stride is used for the offset in physical address space between each register.

temu_addRegisterBank

Include

#include "temu-c/Support/Register.h"

Signature

temu_RegisterBank * temu_addRegisterBank(temu_Class * C, const char * Name, temu_MemAccessIface * MemAccessIface)

Description

Adds a register bank to a TEMU class

Result

Pointer to the new register bank

Parameters

Table 12. temu_addRegisterBank Parameters
Parameter Type Description

C

temu_Class *

Pointer to the TEMU class

Name

const char *

Name of the register

MemAccessIface

temu_MemAccessIface *

Pointer to the register memory access interface

temu_addScalarProperty

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_addScalarProperty(temu_Class * Cls, const char * Name, int offset, temu_Type T, const char * Doc)

Description

Add a scalar (one element) property without setters / getters

Result

0 if the property was added

Parameters

Table 13. temu_addScalarProperty Parameters
Parameter Type Description

Cls

temu_Class *

Class pointer

Name

const char *

Name of property

offset

int

Offset from object pointer

T

temu_Type

Property type

Doc

const char *

Documentation string

temu_addScalarPseudoProperty

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_addScalarPseudoProperty(temu_Class * Cls, const char * Name, temu_Type T, const char * Doc)

Description

Add a scalar (one element) pseudo-property

Result

0 if the property was added

Parameters

Table 14. temu_addScalarPseudoProperty Parameters
Parameter Type Description

Cls

temu_Class *

Class pointer

Name

const char *

Name of property

T

temu_Type

Property type

Doc

const char *

Documentation string

temu_armGetAPSR

Include

#include "temu-c/Support/Cpu.h"

Signature

uint32_t temu_armGetAPSR(void * Cpu)

Description

Get the ARM processor state register

Result

APSR value

Parameters

Table 15. temu_armGetAPSR Parameters
Parameter Type Description

Cpu

void *

ARM CPU pointer

temu_armGetExecMode

Include

#include "temu-c/Support/Cpu.h"

Signature

unsigned int temu_armGetExecMode(void * Cpu)

Description

Get the ARM execution mode

Result

Execution mode

Parameters

Table 16. temu_armGetExecMode Parameters
Parameter Type Description

Cpu

void *

ARM CPU pointer

temu_armGetFPEXC

Include

#include "temu-c/Support/Cpu.h"

Signature

uint32_t temu_armGetFPEXC(void * Cpu)

Description

Get the ARM FPEXC register

Result

FPEXC value

Parameters

Table 17. temu_armGetFPEXC Parameters
Parameter Type Description

Cpu

void *

ARM CPU pointer

temu_armGetFPINST

Include

#include "temu-c/Support/Cpu.h"

Signature

uint32_t temu_armGetFPINST(void * Cpu, int Idx)

Description

Get the ARM FPINST register

Result

FPINST value

Parameters

Table 18. temu_armGetFPINST Parameters
Parameter Type Description

Cpu

void *

ARM CPU pointer

Idx

int

FPINST register number

temu_armGetFPSCR

Include

#include "temu-c/Support/Cpu.h"

Signature

uint32_t temu_armGetFPSCR(void * Cpu)

Description

Get the ARM FPSCR register

Result

FPSCR value

Parameters

Table 19. temu_armGetFPSCR Parameters
Parameter Type Description

Cpu

void *

ARM CPU pointer

temu_armSetAPSR

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_armSetAPSR(void * Cpu, uint32_t Value)

Description

Set the ARM processor state register

Parameters

Table 20. temu_armSetAPSR Parameters
Parameter Type Description

Cpu

void *

ARM CPU pointer

Value

uint32_t

Value to set the APSR to

temu_armSetExecMode

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_armSetExecMode(void * Cpu, unsigned int Mode)

Description

Set the ARM execution mode

Parameters

Table 21. temu_armSetExecMode Parameters
Parameter Type Description

Cpu

void *

ARM CPU pointer

Mode

unsigned int

Execution mode

temu_armSetFPEXC

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_armSetFPEXC(void * Cpu, uint32_t Value)

Description

Set the ARM FPEXC register

Parameters

Table 22. temu_armSetFPEXC Parameters
Parameter Type Description

Cpu

void *

ARM CPU pointer

Value

uint32_t

FPEXC value

temu_armSetFPINST

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_armSetFPINST(void * Cpu, int Idx, uint32_t Value)

Description

Set the ARM FPINST register

Parameters

Table 23. temu_armSetFPINST Parameters
Parameter Type Description

Cpu

void *

ARM CPU pointer

Idx

int

FPINST register number

Value

uint32_t

FPINST value

temu_armSetFPSCR

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_armSetFPSCR(void * Cpu, uint32_t Value)

Description

Set the ARM FPSCR register

Parameters

Table 24. temu_armSetFPSCR Parameters
Parameter Type Description

Cpu

void *

ARM CPU pointer

Value

uint32_t

FPSCR value

temu_asDouble

Include

#include "temu-c/Support/Objsys.h"

Signature

double temu_asDouble(temu_Propval Pv)

Description

Converts the given property to double

Result

Returns the property as an unsigned integer

Parameters

Table 25. temu_asDouble Parameters
Parameter Type Description

Pv

temu_Propval

The property to be converted

temu_asInteger

Include

#include "temu-c/Support/Objsys.h"

Signature

int64_t temu_asInteger(temu_Propval Pv)

Description

Converts the given propery to integer

Result

Returns the property as integer

Parameters

Table 26. temu_asInteger Parameters
Parameter Type Description

Pv

temu_Propval

The property to be converted

temu_asUnsigned

Include

#include "temu-c/Support/Objsys.h"

Signature

uint64_t temu_asUnsigned(temu_Propval Pv)

Description

Converts the given property to unsigned integer

Result

Returns the property as an unsigned integer

Parameters

Table 27. temu_asUnsigned Parameters
Parameter Type Description

Pv

temu_Propval

The property to be converted

temu_assemble

Include

#include "temu-c/Support/Assembler.h"

Signature

uint32_t temu_assemble(void * Cpu, const char * AsmStr)

Description

Assemble an instruction

Result

Instruction bitpattern.

Parameters

Table 28. temu_assemble Parameters
Parameter Type Description

Cpu

void *

processor for which to assemble.

AsmStr

const char *

String with instruction in the CPUs assembler.

temu_assembleToMemory

Include

#include "temu-c/Support/Assembler.h"

Signature

void temu_assembleToMemory(void * Cpu, const char * AsmStr, uint64_t Addr)

Description

Assemble an instruction to memory

Parameters

Table 29. temu_assembleToMemory Parameters
Parameter Type Description

Cpu

void *

processor for which to assemble.

AsmStr

const char *

String with instruction in the CPUs assembler.

Addr

uint64_t

Physical address of where to put the instruction.

temu_asyncSocketAdd

Include

#include "temu-c/Support/Events.h"

Signature

int temu_asyncSocketAdd(temu_TimeSource * TS, int Sock, unsigned int Flags, void (*)(void *) CB, void * Data)

Description

Add asynchronous event triggered by file descriptor changes

Result

Returns the file descriptor (Sock) if successful, otherwise -1.

Parameters

Table 30. temu_asyncSocketAdd Parameters
Parameter Type Description

TS

temu_TimeSource *

the synchronous queue or time source object (normally a CPU object)

Sock

int

File descriptor for the socket. This can also be a pipe FD. Note that the function is likely to be renamed. Note that in case you are intending to read from the socket, make sure it is non-blocking.

Flags

unsigned int

TEMU_ASYNC_READ in case you wish to be notified about data available to read.

CB

void (*)(void *)

Callback when event is triggered.

Data

void *

Data pointer passed to callback.

temu_asyncSocketRemove

Include

#include "temu-c/Support/Events.h"

Signature

void temu_asyncSocketRemove(int Fd, unsigned int Flags)

Description

Remove an asynchronous event triggered by file descriptor changes

Parameters

Table 31. temu_asyncSocketRemove Parameters
Parameter Type Description

Fd

int

The ID of the socket to remove

Flags

unsigned int

The flags of removing

temu_asyncStop

Include

#include "temu-c/Support/Scheduler.h"

Signature

void temu_asyncStop()

Description

Stop the current scheduler

The function returns immediately, before the scheduler has stopped. The function is suitable for use in e.g. signal handlers.

temu_asyncTimerAdd

Include

#include "temu-c/Support/Events.h"

Signature

int temu_asyncTimerAdd(temu_TimeSource * TS, double T, unsigned int Flags, void (*)(void *) CB, void * Data)

Description

Add asynchronously activated wall-clock timed events

The callback function will be called synchronously by the emulator core associated with Q. That means that when CB is executing it is safe to do anything that can be done from a normal event or MMIO handler.

Note that the event is only called when a CPU core or machine is running. When the timer has triggered, it is temporarily disabled and the CB is posted on the synchornous event queue as an async event. This will be executed when the next normal event expires (e.g. at the end of the current quanta). After the event has been called, depending on wether the timer is cyclic or not, it will be reactivated. This means that if the emulator is paused, at most one call to the event handler will be issued, and this will be done when the emulator is resumed.

Result

Returns a file descriptor or timer ID.

Parameters

Table 32. temu_asyncTimerAdd Parameters
Parameter Type Description

TS

temu_TimeSource *

The time source object (normally a CPU object)

T

double

Delta seconds in the future for the first event to be posted.

Flags

unsigned int

Set to TEMU_ASYNC_CYCLIC if the event should be executed as a cyclic event.

CB

void (*)(void *)

Call back function on when timer expires

Data

void *

Context data to be passed to the callback function

temu_asyncTimerRemove

Include

#include "temu-c/Support/Events.h"

Signature

void temu_asyncTimerRemove(int Fd)

Description

Remove an async timer

Parameters

Table 33. temu_asyncTimerRemove Parameters
Parameter Type Description

Fd

int

Timer ID to remove

temu_bitreverse16

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint16_t temu_bitreverse16(uint16_t Word)

Description

Reverses bits in a 16 bit word.

that this should be replaced with __buintin_bitreverse16(), but that is only supported in clang at present, not GCC.

Result

Word with reversed bits.

Parameters

Table 34. temu_bitreverse16 Parameters
Parameter Type Description

Word

uint16_t

The word to reverse the bits in

temu_bitreverse32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_bitreverse32(uint32_t Word)

Description

Reverses bits in a 32 bit word.

that this should be replaced with __buintin_bitreverse32(), but that is only supported in clang at present, not GCC.

Result

Word with reversed bits.

Parameters

Table 35. temu_bitreverse32 Parameters
Parameter Type Description

Word

uint32_t

The word to reverse the bits in

temu_buffCopy

Include

#include "temu-c/Support/Buffer.h"

Signature

temu_Buff temu_buffCopy(const temu_Buff * B)

Description

Copy COW buffer. This will make a new buff object, but the underlying data will not be copied.

Result

Buffer object referring to the same data as B.

Parameters

Table 36. temu_buffCopy Parameters
Parameter Type Description

B

const temu_Buff *

The buffer to copy.

temu_buffCreate

Include

#include "temu-c/Support/Buffer.h"

Signature

temu_Buff temu_buffCreate(uint32_t size)

Description

Create a new COW buffer of size bytes.

Result

Buffer object.

Parameters

Table 37. temu_buffCreate Parameters
Parameter Type Description

size

uint32_t

Size of buffer in bytes

temu_buffDispose

Include

#include "temu-c/Support/Buffer.h"

Signature

void temu_buffDispose(temu_Buff * B)

Description

Delete buffer. The buffer B will be deleted. If there are no more copies of the buffer data anywhere, the data will be deallocated.

Parameters

Table 38. temu_buffDispose Parameters
Parameter Type Description

B

temu_Buff *

buffer to delete.

temu_buffLen

Include

#include "temu-c/Support/Buffer.h"

Signature

uint32_t temu_buffLen(const temu_Buff * B)

Description

Get buffer length

Result

Length of buffer in bytes

Parameters

Table 39. temu_buffLen Parameters
Parameter Type Description

B

const temu_Buff *

buffer

temu_buffReadableData

Include

#include "temu-c/Support/Buffer.h"

Signature

const uint8_t * temu_buffReadableData(const temu_Buff * B)

Description

Get a pointer to readable buffer data

The pointer to the readable data will be returned.

Result

Pointer to data buffer.

Parameters

Table 40. temu_buffReadableData Parameters
Parameter Type Description

B

const temu_Buff *

Buffer to get read pointer from

temu_buffRemoveHead

Include

#include "temu-c/Support/Buffer.h"

Signature

void temu_buffRemoveHead(temu_Buff * B, uint32_t len)

Description

Remove len bytes from the start of the buffer.

Removing bytes from the buffer start will not change the underlying buffer object. And is not seen as a write for the purpose of the data block.

This does not affect other copies of this buffer.

Parameters

Table 41. temu_buffRemoveHead Parameters
Parameter Type Description

B

temu_Buff *

buffer to remove data from

len

uint32_t

Number of bytes to remove.

temu_buffRemoveTail

Include

#include "temu-c/Support/Buffer.h"

Signature

void temu_buffRemoveTail(temu_Buff * B, uint32_t len)

Description

Remove len bytes from the end of the buffer.

Removing bytes from the buffer tail will not change the underlying buffer object. And is not seen as a write for the purpose of the data block.

This does not affect other copies of this buffer.

Parameters

Table 42. temu_buffRemoveTail Parameters
Parameter Type Description

B

temu_Buff *

buffer to remove data from

len

uint32_t

Number of bytes to remove.

temu_buffWritableData

Include

#include "temu-c/Support/Buffer.h"

Signature

uint8_t * temu_buffWritableData(temu_Buff * B)

Description

Get a pointer to writable data.

If the data have more than one reference, a new copy of the data will be created.

Result

Pointer to writable data.

Parameters

Table 43. temu_buffWritableData Parameters
Parameter Type Description

B

temu_Buff *

Buffer to get data pointer from.

temu_checkSanity

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_checkSanity(int Report)

Description

Check object system sanity.

The function traverses all objects and their properties and ensures that all (scalar) interface properties are connected. An object can override the default check by implementing the checkSanity function in the ObjectIface.

Result

Returns 0 if the object system is connected. Returns non-zero if the object system is not properly connected.

Parameters

Table 44. temu_checkSanity Parameters
Parameter Type Description

Report

int

set to 1 to have the function report connectivity issues on stdout, 2 to report on stderr, and 0 to not report at all.

temu_checkpointGetLength

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_checkpointGetLength(void * Ctxt, const char * Name)

Description

Get number of entries for the serialized property

Result

Length of the property in elements. Negative on error.

Parameters

Table 45. temu_checkpointGetLength Parameters
Parameter Type Description

Ctxt

void *

Context passed to deserialise function

Name

const char *

Name of property / key in the serialized file

temu_checkpointGetValue

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Propval temu_checkpointGetValue(void * Ctxt, const char * Name, int Idx)

Description

Get value for named snapshot value

Result

Property value with the contents saved to the snapshot

Parameters

Table 46. temu_checkpointGetValue Parameters
Parameter Type Description

Ctxt

void *

Context is passed to deserialise interface function

Name

const char *

Name of the saved value

Idx

int

Index of the saved value (if array)

temu_classCmdAddParam

Include

#include "temu-c/Support/CommandLine.h"

Signature

int temu_classCmdAddParam(void * Cmd, const char * Name, temu_CmdOptionKind Type, int Required, const char * Doc)

Description

Add parameter to command

Result

0 on success, other values indicates errors

Parameters

Table 47. temu_classCmdAddParam Parameters
Parameter Type Description

Cmd

void *

Command handle

Name

const char *

Name of parameter to add

Type

temu_CmdOptionKind

Type of the parameter

Required

int

Set to 1 if the parameter must be set for the command

Doc

const char *

Documentation string for the parameter

temu_classCmdGetOption

Include

#include "temu-c/Support/CommandLine.h"

Signature

const temu_CmdArg * temu_classCmdGetOption(int argc, const temu_CmdArg * args, const char * OptName)

Description

Get named command option

Result

Pointer to command argument or NULL in case it is not found.

Parameters

Table 48. temu_classCmdGetOption Parameters
Parameter Type Description

argc

int

Number of arguments

args

const temu_CmdArg *

Argument vector

OptName

const char *

Name of parameter / option to get

temu_classCmdGetOptionAsInteger

Include

#include "temu-c/Support/CommandLine.h"

Signature

int64_t temu_classCmdGetOptionAsInteger(int argc, const temu_CmdArg * args, const char * OptName)

Description

Get named command option as signed integer

Can only get valid numeric parameters. The function will never fail if the type is numeric and the option is required. For optional arguments, use the generic access function temu_classCmdGetOption()

Result

The value of the parameter converted to an integer.

Parameters

Table 49. temu_classCmdGetOptionAsInteger Parameters
Parameter Type Description

argc

int

Number of arguments

args

const temu_CmdArg *

Argument vector

OptName

const char *

Name of parameter / option to get

temu_classCmdGetOptionAsUnsigned

Include

#include "temu-c/Support/CommandLine.h"

Signature

uint64_t temu_classCmdGetOptionAsUnsigned(int argc, const temu_CmdArg * args, const char * OptName)

Description

Get named command option as unsigned integer

Can only get valid numeric parameters. The function will never fail if the type is numeric and the option is required. For optional arguments, use the generic access function temu_classCmdGetOption()

Result

The value of the parameter converted to an unsigned integer.

Parameters

Table 50. temu_classCmdGetOptionAsUnsigned Parameters
Parameter Type Description

argc

int

Number of arguments

args

const temu_CmdArg *

Argument vector

OptName

const char *

Name of parameter / option to get

temu_classForName

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Class * temu_classForName(const char * ClsName)

Description

Get the class pointer for the named class

Result

Pointer to the class if found, otherwise NULL

Parameters

Table 51. temu_classForName Parameters
Parameter Type Description

ClsName

const char *

The name of the class

temu_classForObject

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Class * temu_classForObject(const temu_Object * Obj)

Description

Get the class for the given object.

Result

Pointer to the class type object

Parameters

Table 52. temu_classForObject Parameters
Parameter Type Description

Obj

const temu_Object *

Pointer to the object

temu_classGetCmd

Include

#include "temu-c/Support/CommandLine.h"

Signature

void * temu_classGetCmd(temu_Class * Cls, const char * Name)

Description

Get an already registered command handle from class

This function can be used to for example get commands registered in the metaclass, such as the new command. The command can then have arguments added.

Result

Opaque handle to command. NULL in case of failure.

Parameters

Table 53. temu_classGetCmd Parameters
Parameter Type Description

Cls

temu_Class *

Class pointer

Name

const char *

Name of command to get

temu_classHasCommand

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_classHasCommand(const temu_Class * Cls, const char * CmdName)

Description

Query whether the class has a specific command implemented

Result

0 if command is not implemented by class, 1 if implemented.

Parameters

Table 54. temu_classHasCommand Parameters
Parameter Type Description

Cls

const temu_Class *

class to query for a command.

CmdName

const char *

Command name class is expected to implement.

temu_clearLeftmostBit32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_clearLeftmostBit32(uint32_t Word)

Description

Clear lower set bit in word

Result

A copy of Word with ther lowest set bit cleared

Parameters

Table 55. temu_clearLeftmostBit32 Parameters
Parameter Type Description

Word

uint32_t

The word, in which the lower set bit will be cleared

temu_clearLeftmostBit64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_clearLeftmostBit64(uint64_t Word)

Description

Clear lower set bit in word

Result

A copy of Word with ther lowest set bit cleared

Parameters

Table 56. temu_clearLeftmostBit64 Parameters
Parameter Type Description

Word

uint64_t

The word, in which the lower set bit will be cleared

temu_clearMemAttr

Include

#include "temu-c/Memory/Memory.h"

Signature

void temu_clearMemAttr(void * Obj, uint64_t Addr, uint64_t Len, temu_MemoryAttr Attr)

Description

Clear attribute on memory space location

Parameters

Table 57. temu_clearMemAttr Parameters
Parameter Type Description

Obj

void *

The memory space object

Addr

uint64_t

Physical address where to map the device

Len

uint64_t

Length in bytes of area where the attribute should be set.

Attr

temu_MemoryAttr

The attribute to clear.

temu_clearRightMostBits32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_clearRightMostBits32(uint32_t Word)

Description

Clear right most bit in a word

Result

A copy of Word, in which right most bit to be cleared

Parameters

Table 58. temu_clearRightMostBits32 Parameters
Parameter Type Description

Word

uint32_t

The word, in which right most bit to be cleared

temu_clearRightMostBits64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_clearRightMostBits64(uint64_t Word)

Description

Clear right most bit in a word

Result

A copy of Word, in which right most bit to be cleared

Parameters

Table 59. temu_clearRightMostBits64 Parameters
Parameter Type Description

Word

uint64_t

The word, in which right most bit to be cleared

temu_clz16

Include

#include "temu-c/Support/Bitmanip.h"

Signature

int temu_clz16(uint16_t Word)

Description

Count leading zeroes

Result

Number of leading zeros in Word

Parameters

Table 60. temu_clz16 Parameters
Parameter Type Description

Word

uint16_t

the word, in which leading zeros to be counted

temu_clz32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

int temu_clz32(uint32_t Word)

Description

Count leading zeroes

Result

Number of leading zeros in Word

Parameters

Table 61. temu_clz32 Parameters
Parameter Type Description

Word

uint32_t

the word, in which leading zeros to be counted

temu_clz64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

int temu_clz64(uint64_t Word)

Description

Count leading zeroes

Result

The number of leading zeros in Word

Parameters

Table 62. temu_clz64 Parameters
Parameter Type Description

Word

uint64_t

The word, in which leading zeros to be counted

temu_cmdAddOption

Include

#include "temu-c/Support/CommandLine.h"

Signature

void temu_cmdAddOption(void * Cmd, const char * OptName, temu_CmdOptionKind Type, int Required, const char * Doc, const char * Default)

Description

Add named argument to command

Parameters

Table 63. temu_cmdAddOption Parameters
Parameter Type Description

Cmd

void *

Pointer to the command object

OptName

const char *

Option name

Type

temu_CmdOptionKind

Option type

Required

int

Pass 0 if the option is not required, otherwise required

Doc

const char *

Option documentation

Default

const char *

Default value of the option

temu_cmdGetData

Include

#include "temu-c/Support/CommandLine.h"

Signature

void * temu_cmdGetData(void * Ctxt)

Description

Get data pointer from command context This function shall be called in a command handler on the passed context.

Result

data pointer

Parameters

Table 64. temu_cmdGetData Parameters
Parameter Type Description

Ctxt

void *

Pointer to the context of the command

temu_cmdGetInterpreter

Include

#include "temu-c/Support/CommandLine.h"

Signature

void * temu_cmdGetInterpreter(void * Ctxt)

Description

Get pointer to the command interpreter This function shall be called in a command handler on the passed context.

Result

Pointer to interpreter

Parameters

Table 65. temu_cmdGetInterpreter Parameters
Parameter Type Description

Ctxt

void *

Pointer to the context of the command

temu_cmdGetOptionAsInteger

Include

#include "temu-c/Support/CommandLine.h"

Signature

int64_t temu_cmdGetOptionAsInteger(void * Ctxt, const char * OptName)

Description

Get named option as integer from command context This function shall be called in a command handler on the passed context.

Result

The integer bound to the named argument

Parameters

Table 66. temu_cmdGetOptionAsInteger Parameters
Parameter Type Description

Ctxt

void *

Command context

OptName

const char *

Option name

temu_cmdGetOptionAsObject

Include

#include "temu-c/Support/CommandLine.h"

Signature

void * temu_cmdGetOptionAsObject(void * Ctxt, const char * OptName)

Description

Get named option as object pointer from command context This function shall be called in a command handler on the passed context.

Result

Pointer to the option object

Parameters

Table 67. temu_cmdGetOptionAsObject Parameters
Parameter Type Description

Ctxt

void *

Command context

OptName

const char *

Option name

temu_cmdGetOptionAsReal

Include

#include "temu-c/Support/CommandLine.h"

Signature

double temu_cmdGetOptionAsReal(void * Ctxt, const char * OptName)

Description

Get named option as double from command context This function shall be called in a command handler on the passed context.

Result

The real value of the option as double

Parameters

Table 68. temu_cmdGetOptionAsReal Parameters
Parameter Type Description

Ctxt

void *

Command context

OptName

const char *

Option name

temu_cmdGetOptionAsString

Include

#include "temu-c/Support/CommandLine.h"

Signature

const char * temu_cmdGetOptionAsString(void * Ctxt, const char * OptName)

Description

Get named option as string from command context This function shall be called in a command handler on the passed context.

Result

C-string of the name of the option

Parameters

Table 69. temu_cmdGetOptionAsString Parameters
Parameter Type Description

Ctxt

void *

Command context

OptName

const char *

Option name

temu_cmdGetPosOpt

Include

#include "temu-c/Support/CommandLine.h"

Signature

const char * temu_cmdGetPosOpt(void * Ctxt, size_t Idx)

Description

Get positional option at index This function shall be called in a command handler on the passed context.

Result

The option at position Idx as a C-string

Parameters

Table 70. temu_cmdGetPosOpt Parameters
Parameter Type Description

Ctxt

void *

Command context

Idx

size_t

Index of the option

temu_cmdGetPosOptSize

Include

#include "temu-c/Support/CommandLine.h"

Signature

size_t temu_cmdGetPosOptSize(void * Ctxt)

Description

Get number of positional options given This function shall be called in a command handler on the passed context.

Result

The number of position optionals in Ctxt

Parameters

Table 71. temu_cmdGetPosOptSize Parameters
Parameter Type Description

Ctxt

void *

Command context

temu_cmdGetVariable

Include

#include "temu-c/Support/CommandLine.h"

Signature

const char * temu_cmdGetVariable(const char * Key)

Description

Get a variable in the command line

Result

In case the variable is not found NULL, otherwise a borrowed string.

Parameters

Table 72. temu_cmdGetVariable Parameters
Parameter Type Description

Key

const char *

Variable name

temu_cmdOptionIsValid

Include

#include "temu-c/Support/CommandLine.h"

Signature

int temu_cmdOptionIsValid(void * Ctxt, const char * OptName)

Description

Return 1 if the option is valid, 0 if invalid / not set This function shall be called in a command handler on the passed context.

Result

1 if the option is valid, 0 if invalid / not set

Parameters

Table 73. temu_cmdOptionIsValid Parameters
Parameter Type Description

Ctxt

void *

Command context

OptName

const char *

Option name

temu_cmdSetVariable

Include

#include "temu-c/Support/CommandLine.h"

Signature

int temu_cmdSetVariable(const char * Key, const char * Value)

Description

Set a variable in the command line

Result

Non-zero on errors

Parameters

Table 74. temu_cmdSetVariable Parameters
Parameter Type Description

Key

const char *

Variable name (must match [A-Za-z_][A-Za-z0-9_]*)

Value

const char *

Value to assign to variable

temu_componentAddDelegateIface

Include

#include "temu-c/Support/Component.h"

Signature

void temu_componentAddDelegateIface(temu_Component * Comp, const char * Name, temu_IfaceRef Iface)

Description

Add delegate interface to component

Delegate interfaces are interfaces in objects internal in the component. It is possible to use the connect function to attach directly to a component delegated interface (although, in practice the connection is done to the internal object’s interface).

Note that delegate interface do not support interface arrays, and can only expose a single interface instance at present.

Parameters

Table 75. temu_componentAddDelegateIface Parameters
Parameter Type Description

Comp

temu_Component *

the component to add the delegate interface to.

Name

const char *

name of the delegate interface

Iface

temu_IfaceRef

Interface reference which the delegated interface is resolved to

temu_componentAddDelegateProp

Include

#include "temu-c/Support/Component.h"

Signature

void temu_componentAddDelegateProp(temu_Component * Comp, const char * Name, temu_Object * Obj, const char * PropName)

Description

Add delegate property to component

Delegate property are properties in objects internal in the component. It is possible to use the connect function to connect from a delegated property directly using the component instead of the underlying object.

Parameters

Table 76. temu_componentAddDelegateProp Parameters
Parameter Type Description

Comp

temu_Component *

the component to add the delegate interface to.

Name

const char *

name of the delegate property

Obj

temu_Object *

Object to which the property resolves to.

PropName

const char *

Name of property in Obj

temu_componentCreate

Include

#include "temu-c/Support/Component.h"

Signature

temu_Component * temu_componentCreate(const char * Name)

Description

Allocate a component object.

The component create shall be called in the component constructor/create function (the create function passed to the registerComponent function). It will allocate an opaque component object with the relevant name.

The returned component is what the component constructor should return.

Result

Component pointer

Parameters

Table 77. temu_componentCreate Parameters
Parameter Type Description

Name

const char *

Name of component

temu_componentDispose

Include

#include "temu-c/Support/Component.h"

Signature

void temu_componentDispose(void * Comp)

Description

Deallocate a component object

The component dispose shall be called by the component destructor/dispose function registered in the registerComponent call.

Note that a component is seen as owning all the objects created with createComponentObject, and subsequently, all objects created will be recursively deleted when deleting the component.

Parameters

Table 78. temu_componentDispose Parameters
Parameter Type Description

Comp

void *

Component to dispose.

temu_componentGetDelegateIface

Include

#include "temu-c/Support/Component.h"

Signature

temu_IfaceRef temu_componentGetDelegateIface(temu_Component * Comp, const char * Name)

Description

Query the component for a delegated interface

Normally this function is not needed for the end user, however some usecases can be seen for exposing this. It returns the IfaceRef that has been added as a delegate interface. The main use is to redelegate delegated interfaces in a component of components.

Result

Interface reference associated with Name, if none is found, iref type will be teTY_Invalid.

Parameters

Table 79. temu_componentGetDelegateIface Parameters
Parameter Type Description

Comp

temu_Component *

The component to query the IfaceRef from

Name

const char *

Name of the interface reference.

temu_componentGetDelegateProp

Include

#include "temu-c/Support/Component.h"

Signature

temu_PropName temu_componentGetDelegateProp(temu_Component * Comp, const char * Name)

Description

Query the compontent for a delegated property

Normally this should not be called by the user. But is useful in case the user constructs components of components in which case a component can redelegate delegated properties.

Result

Object name pair with the target object and property name.

Parameters

Table 80. temu_componentGetDelegateProp Parameters
Parameter Type Description

Comp

temu_Component *

The componten to query

Name

const char *

Name of delegated property

temu_componentGetObject

Include

#include "temu-c/Support/Component.h"

Signature

temu_Object * temu_componentGetObject(temu_Component * Comp, const char * Name)

Description

Get named object in component

Result

NULL if the object is not a member in the component

Parameters

Table 81. temu_componentGetObject Parameters
Parameter Type Description

Comp

temu_Component *

Component pointer

Name

const char *

String without the component prefix (i.e. local name)

temu_connect

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_connect(temu_Object * A, const char * PropName, temu_Object * B, const char * IfaceName)

Description

Connect an interface property in object A to the interface in object B. If A.PropName is an interface array, B,B:IfaceName will be appended to it. For dynamic arrays, it is pushed to the end, for static arrays, it is placed in the first null slot (unless, the indexing syntax is used in the property name).

Result

0 on success, otherwise non-zero

Parameters

Table 82. temu_connect Parameters
Parameter Type Description

A

temu_Object *

The object to connect.

PropName

const char *

The name of the property in object A

B

temu_Object *

The object to connect to.

IfaceName

const char *

The name of the interface in object B

temu_cpuDisableTraps

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_cpuDisableTraps(void * Cpu)

Description

Disable traps on processor

Parameters

Table 83. temu_cpuDisableTraps Parameters
Parameter Type Description

Cpu

void *

CPU pointer

temu_cpuEnableTraps

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_cpuEnableTraps(void * Cpu)

Description

Enable traps on processor

Parameters

Table 84. temu_cpuEnableTraps Parameters
Parameter Type Description

Cpu

void *

CPU pointer

temu_cpuGetFpr32

Include

#include "temu-c/Support/Cpu.h"

Signature

float temu_cpuGetFpr32(void * Cpu, unsigned int Reg)

Description

Get a 32 bit floating point register

Result

Host float with the content of the FPU register

Parameters

Table 85. temu_cpuGetFpr32 Parameters
Parameter Type Description

Cpu

void *

CPU pointer

Reg

unsigned int

FPU register number

temu_cpuGetFpr32Bits

Include

#include "temu-c/Support/Cpu.h"

Signature

uint32_t temu_cpuGetFpr32Bits(void * Cpu, unsigned int Reg)

Description

Get a 32 bit floating point register

Result

Floating point register contents

Parameters

Table 86. temu_cpuGetFpr32Bits Parameters
Parameter Type Description

Cpu

void *

CPU pointer

Reg

unsigned int

FPU register number

temu_cpuGetFpr64

Include

#include "temu-c/Support/Cpu.h"

Signature

double temu_cpuGetFpr64(void * Cpu, unsigned int Reg)

Description

Get 64 bit floating point register as double

Result

FPU register value

Parameters

Table 87. temu_cpuGetFpr64 Parameters
Parameter Type Description

Cpu

void *

CPU pointer

Reg

unsigned int

FPU register number

temu_cpuGetFpr64Bits

Include

#include "temu-c/Support/Cpu.h"

Signature

uint64_t temu_cpuGetFpr64Bits(void * Cpu, unsigned int Reg)

Description

Get 64 bit floating point register contents

Result

FPU register value

Parameters

Table 88. temu_cpuGetFpr64Bits Parameters
Parameter Type Description

Cpu

void *

CPU pointer

Reg

unsigned int

FPU register number

temu_cpuGetFreq

Include

#include "temu-c/Support/Cpu.h"

Signature

uint64_t temu_cpuGetFreq(void * Cpu)

Description

Get the clock frequency for the CPU

Result

The configured clock frequency in Hz.

Parameters

Table 89. temu_cpuGetFreq Parameters
Parameter Type Description

Cpu

void *

The CPU object

temu_cpuGetMachine

Include

#include "temu-c/Support/Cpu.h"

Signature

void * temu_cpuGetMachine(void * Cpu)

Description

Get the Machine for a given CPU

Result

Pointer to the machine object

Parameters

Table 90. temu_cpuGetMachine Parameters
Parameter Type Description

Cpu

void *

Pointer to the CPU object

temu_cpuGetPc

Include

#include "temu-c/Support/Cpu.h"

Signature

uint64_t temu_cpuGetPc(void * Cpu)

Description

Get the program counter

The program counter will be returned.

Result

The value of the program counter register

Parameters

Table 91. temu_cpuGetPc Parameters
Parameter Type Description

Cpu

void *

The CPU object

temu_cpuGetReg

Include

#include "temu-c/Support/Cpu.h"

Signature

uint64_t temu_cpuGetReg(void * Cpu, unsigned int Reg)

Description

Gets the register in the processor

Result

Register value

Parameters

Table 92. temu_cpuGetReg Parameters
Parameter Type Description

Cpu

void *

CPU pointer

Reg

unsigned int

Register number

temu_cpuGetSpr

Include

#include "temu-c/Support/Cpu.h"

Signature

uint64_t temu_cpuGetSpr(void * Cpu, unsigned int RegId)

Description

Get the PowerPC SPR register

Result

Value of SPR specified in RegId.

Parameters

Table 93. temu_cpuGetSpr Parameters
Parameter Type Description

Cpu

void *

Processor pointer

RegId

unsigned int

SPR register number

temu_cpuGetStat

Include

#include "temu-c/Support/Cpu.h"

Signature

uint64_t temu_cpuGetStat(void * Obj, int Stat)

Description

Get processor statistics

Result

Statistics value

Parameters

Table 94. temu_cpuGetStat Parameters
Parameter Type Description

Obj

void *

Processor pointer

Stat

int

Statistics ID

temu_cpuRaiseTrap

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_cpuRaiseTrap(void * Cpu, int Trap, unsigned int Flags)

Description

Raise a trap The function simulates a trap being raised at the current PC.

Parameters

Table 95. temu_cpuRaiseTrap Parameters
Parameter Type Description

Cpu

void *

Processor pointer

Trap

int

Trap ID. This is target dependent, for the SPARC this is the TT value of the trap.

Flags

unsigned int

set flag 1 to enable longjmp trap (this is useful in MMIO handlers to force a trap while a core is running). Set to 0 if called from outside the core or in e.g. an event handler.

temu_cpuReset

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_cpuReset(void * Cpu, int ResetType)

Description

Reset the processor.

Resetting the CPU will result in a reset cascade where all connected devices are also reset.

Parameters

Table 96. temu_cpuReset Parameters
Parameter Type Description

Cpu

void *

The CPU object

ResetType

int

The type of reset, by convention 0 means cold reset, and 1 indicates a warm reset.

temu_cpuResetStat

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_cpuResetStat(void * Obj, int Stat)

Description

Clear processor statistics

Parameters

Table 97. temu_cpuResetStat Parameters
Parameter Type Description

Obj

void *

Processor pointer

Stat

int

Statistics ID

temu_cpuRun

Include

#include "temu-c/Support/Cpu.h"

Signature

uint64_t temu_cpuRun(void * Cpu, uint64_t Cycles)

Description

Run the processor for a number of cycles

The function runs the processor for a number of cycles. If you wish to run the processor with another time unit, you can compute the cycles from the clock frequency of the emulated processor.

In case the processor halts or enters idle mode and there are no pending events the function will return early.

Result

The number of executed cycles.

Parameters

Table 98. temu_cpuRun Parameters
Parameter Type Description

Cpu

void *

The CPU object

Cycles

uint64_t

The number of cycles to run the processor for.

temu_cpuSetFpr32

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_cpuSetFpr32(void * Cpu, unsigned int Reg, float Value)

Description

Set floating point register value

Parameters

Table 99. temu_cpuSetFpr32 Parameters
Parameter Type Description

Cpu

void *

CPU pointer

Reg

unsigned int

Floating point register number

Value

float

Floating point value to set

temu_cpuSetFpr32Bits

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_cpuSetFpr32Bits(void * Cpu, unsigned int Reg, uint32_t Value)

Description

Set 32 bit floating point register value

Parameters

Table 100. temu_cpuSetFpr32Bits Parameters
Parameter Type Description

Cpu

void *

CPU pointer

Reg

unsigned int

Floating point register number

Value

uint32_t

Floating point value to set

temu_cpuSetFpr64

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_cpuSetFpr64(void * Cpu, unsigned int Reg, double Value)

Description

Set FPU register value

Parameters

Table 101. temu_cpuSetFpr64 Parameters
Parameter Type Description

Cpu

void *

CPU pointer

Reg

unsigned int

FPU register number

Value

double

Value to set to register

temu_cpuSetFpr64Bits

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_cpuSetFpr64Bits(void * Cpu, unsigned int Reg, uint64_t Value)

Description

Set FPU register value

Parameters

Table 102. temu_cpuSetFpr64Bits Parameters
Parameter Type Description

Cpu

void *

CPU pointer

Reg

unsigned int

FPU register number

Value

uint64_t

Value to set to register

temu_cpuSetPc

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_cpuSetPc(void * Cpu, uint64_t Pc)

Description

Set the program counter

The program counter will be set to the supplied value.

For targets with delay slots (SPARC, MIPS etc), the function will also set the next PC to PC + sizeof(instruction).

Parameters

Table 103. temu_cpuSetPc Parameters
Parameter Type Description

Cpu

void *

The CPU object

Pc

uint64_t

The program counter.

temu_cpuSetReg

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_cpuSetReg(void * Cpu, unsigned int Reg, uint64_t Value)

Description

Set the register in the processor

Parameters

Table 104. temu_cpuSetReg Parameters
Parameter Type Description

Cpu

void *

CPU pointer

Reg

unsigned int

Register number

Value

uint64_t

Value to write to register

temu_cpuSetSpr

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_cpuSetSpr(void * Cpu, unsigned int RegId, uint64_t Value)

Description

Set the PowerPC SPR register

Parameters

Table 105. temu_cpuSetSpr Parameters
Parameter Type Description

Cpu

void *

Processor pointer

RegId

unsigned int

SPR register number

Value

uint64_t

New SPR value

temu_cpuStep

Include

#include "temu-c/Support/Cpu.h"

Signature

uint64_t temu_cpuStep(void * Cpu, uint64_t Steps)

Description

Run the processor for a number of steps

This function is different from temu_cpuRun, which runs for a time. The steps here indicates instructions executed (including trapping instructions). This can be contrasted to the run function which may advance the cycle counter by more than one for an instruction (depending on the timing models).

The function may return early in case the processor halts its execution or has entered idle mode and there are no events pending.

Result

The number of executed steps.

Parameters

Table 106. temu_cpuStep Parameters
Parameter Type Description

Cpu

void *

The CPU object

Steps

uint64_t

The number of steps to run the processor for.

temu_cpuTranslateAddress

Include

#include "temu-c/Support/Cpu.h"

Signature

int temu_cpuTranslateAddress(void * Cpu, uint64_t Va, uint32_t flags, uint64_t * physAddressResult)

Description

Uses the MMU to translate the given virtual address Va to the physical address in the emulator

Result

error code. 0 on success, non-zero otherwise,

Parameters

Table 107. temu_cpuTranslateAddress Parameters
Parameter Type Description

Cpu

void *

the CPU object

Va

uint64_t

the virtual address to be translated

flags

uint32_t

flags for the translation (CPU specific)

physAddressResult

uint64_t *

the result in a uint64_t pointer

temu_cpuTranslateAddressWithRootPointer

Include

#include "temu-c/Support/Cpu.h"

Signature

int temu_cpuTranslateAddressWithRootPointer(void * cpu, uint64_t va, uint32_t flags, uint64_t * physAddressResult, uint64_t pageTableRoot)

Description

Uses the an explicit page table pointer to translate a virtual address to physical address.

The routine is dependent on the processor having hardware managed page tables. Hence this works e.g. for SPARC and ARM processors, but not for PowerPC.

Result

error code. 0 on success, non-zero otherwise,

Parameters

Table 108. temu_cpuTranslateAddressWithRootPointer Parameters
Parameter Type Description

cpu

void *

the CPU object

va

uint64_t

the virtual address to be translated

flags

uint32_t

flags for the translation (CPU specific)

physAddressResult

uint64_t *

the result in a uint64_t pointer

pageTableRoot

uint64_t

The page table to use for the translation

temu_createClassCmd

Include

#include "temu-c/Support/CommandLine.h"

Signature

void * temu_createClassCmd(temu_Class * Cls, const char * Name, const char * Doc, temu_ObjectCommandFunc F)

Description

Register a class command

Result

Opaque handle to command. NULL in case of failure.

Parameters

Table 109. temu_createClassCmd Parameters
Parameter Type Description

Cls

temu_Class *

Class pointer

Name

const char *

Name of command

Doc

const char *

Documentation string for command

F

temu_ObjectCommandFunc

Command handler function

temu_createCmd

Include

#include "temu-c/Support/CommandLine.h"

Signature

void * temu_createCmd(const char * Name, temu_CommandFunc F, const char * Doc, void * Data)

Description

Create and register global command

Result

Parameters

Table 110. temu_createCmd Parameters
Parameter Type Description

Name

const char *

Name of command

F

temu_CommandFunc

Command function to invoke

Doc

const char *

Documentation string

Data

void *

Data pointer. Some commands e.g. disassemble will increase the address between invocations. This must be saved in some data object which can be provided when the command is created.

temu_createComponentObject

Include

#include "temu-c/Support/Component.h"

Signature

temu_Object * temu_createComponentObject(temu_Component * Comp, const char * Class, const temu_CreateArg * Args, const char * ObjNameFmt, ...)

Description

Create an object in a component.

This function works as the temu_createObject, except that the object created is inserted in the component.

The function is indended to be used in the component constructor.

Object names are uniqued using the objnamefmt paramters and following varargs. Plus, that the name of the component itself is prefixed as '[compname]-'.

Result

Pointer to created object.

Parameters

Table 111. temu_createComponentObject Parameters
Parameter Type Description

Comp

temu_Component *

The component under which the object is to be created.

Class

const char *

class of the created object

Args

const temu_CreateArg *

NULL terminated array of create arguments for the constructor.

ObjNameFmt

const char *

Name of created object, but it allows for printf style string names, simplifying the creation of multiple objects of the same type.

temu_createGdbServer

Include

#include "temu-c/GdbServer/GdbServer.h"

Signature

void * temu_createGdbServer(uint16_t Port)

Description

Create a new GDB server

Result

Opaque handle to GDB server.

Parameters

Table 112. temu_createGdbServer Parameters
Parameter Type Description

Port

uint16_t

TCP port to start server on.

temu_createObject

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Object * temu_createObject(const char * ClsName, const char * ObjName, const temu_CreateArg * Args)

Description

Create object with class and name.

Result

Allocated object. Result is NULL in case of: class does not exist, object already allocated with the given name, out of memory.

Parameters

Table 113. temu_createObject Parameters
Parameter Type Description

ClsName

const char *

Name of class used for instantiation

ObjName

const char *

Name of object in object system

Args

const temu_CreateArg *

Named argument pairs to pass into constructor. The list of args should be terminated by a TEMU_NULL_ARG. In case no arguments are passed, pass in NULL.

temu_crossesBoundary32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

_Bool temu_crossesBoundary32(uint32_t A, uint32_t L, uint32_t Size)

Description

Checks whether A + L crosses power of 2 boundary (e.g. page)

Result

True if boundary is crossed. False otherwise.

Parameters

Table 114. temu_crossesBoundary32 Parameters
Parameter Type Description

A

uint32_t

Address value

L

uint32_t

Length / offset value

Size

uint32_t

boundary size (power of 2 size)

temu_crossesBoundary64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

_Bool temu_crossesBoundary64(uint64_t A, uint64_t L, uint64_t Size)

Description

Checks whether A + L crosses power of 2 boundary (e.g. page)

Result

True if boundary is crossed. False otherwise.

Parameters

Table 115. temu_crossesBoundary64 Parameters
Parameter Type Description

A

uint64_t

Address value

L

uint64_t

Length / offset value

Size

uint64_t

boundary size (power of 2 size)

temu_ctz16

Include

#include "temu-c/Support/Bitmanip.h"

Signature

int temu_ctz16(uint16_t Word)

Description

Count trailing zeroes, this can be used as a square root on a power of 2 word.

Result

Number of trailing zeros in Word

Parameters

Table 116. temu_ctz16 Parameters
Parameter Type Description

Word

uint16_t

the word, in which trailing zeros to be counted

temu_ctz32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

int temu_ctz32(uint32_t Word)

Description

Count trailing zeroes, this can be used as a square root on a power of 2 word.

Result

Number of trailing zeros in Word

Parameters

Table 117. temu_ctz32 Parameters
Parameter Type Description

Word

uint32_t

the word, in which trailing zeros to be counted

temu_ctz64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

int temu_ctz64(uint64_t Word)

Description

Count trailing zeroes

Result

The number of trailing zeros in Word

Parameters

Table 118. temu_ctz64 Parameters
Parameter Type Description

Word

uint64_t

The word, in which trailing zeros to be counted

temu_cyclesToNanos

Include

#include "temu-c/Support/Time.h"

Signature

int64_t temu_cyclesToNanos(int64_t Cycles, int64_t Freq)

Description

Convert cycles to nanoseconds

Result

Cycles converted to nanoseconds

Parameters

Table 119. temu_cyclesToNanos Parameters
Parameter Type Description

Cycles

int64_t

Cycle count to convert

Freq

int64_t

Frequency in Hz

temu_cyclesToOtherFreqRoundedUp

Include

#include "temu-c/Support/Time.h"

Signature

int64_t temu_cyclesToOtherFreqRoundedUp(int64_t Cycles, int64_t SourceFreq, int64_t TargetFreq)

Description

Convert cycles to another frequency base, rounding upwards

Result

Cycles, converted from source frequency to target frequency

Parameters

Table 120. temu_cyclesToOtherFreqRoundedUp Parameters
Parameter Type Description

Cycles

int64_t

Cycle count in source frequency ticks

SourceFreq

int64_t

Frequency in Hz of the source

TargetFreq

int64_t

Frequency in Hz for the converted value

temu_cyclesToOtherFreqTruncated

Include

#include "temu-c/Support/Time.h"

Signature

int64_t temu_cyclesToOtherFreqTruncated(int64_t Cycles, int64_t SourceFreq, int64_t TargetFreq)

Description

Convert cycles to another frequency base, with truncated result

Result

Cycles, converted from source frequency to target frequency

Parameters

Table 121. temu_cyclesToOtherFreqTruncated Parameters
Parameter Type Description

Cycles

int64_t

Cycle count in source frequency ticks

SourceFreq

int64_t

Frequency in Hz of the source

TargetFreq

int64_t

Frequency in Hz for the converted value

temu_cyclesToSecs

Include

#include "temu-c/Support/Time.h"

Signature

double temu_cyclesToSecs(int64_t Cycles, int64_t Freq)

Description

Convert cycles to seconds

Result

Cycles converted to seconds

Parameters

Table 122. temu_cyclesToSecs Parameters
Parameter Type Description

Cycles

int64_t

Cycle count to convert

Freq

int64_t

Frequency in Hz

temu_cyclesToSteps

Include

#include "temu-c/Support/Time.h"

Signature

uint64_t temu_cyclesToSteps(temu_TimeSource * TS, uint64_t Cycles)

Description

Convert cycles to steps

Result

Cycles converted to steps given the time source IPC/CPI configuration.

Parameters

Table 123. temu_cyclesToSteps Parameters
Parameter Type Description

TS

temu_TimeSource *

Time source object

Cycles

uint64_t

Cycle count to convert to steps

temu_cyclesToStepsRoundedUp

Include

#include "temu-c/Support/Time.h"

Signature

uint64_t temu_cyclesToStepsRoundedUp(temu_TimeSource * TS, uint64_t Cycles)

Description

Convert cycles to steps, rounding upwards

Result

Cycles converted to steps given the time source IPC/CPI configuration.

Parameters

Table 124. temu_cyclesToStepsRoundedUp Parameters
Parameter Type Description

TS

temu_TimeSource *

Time source object

Cycles

uint64_t

Cycle count to convert to steps

temu_debuggerAttach

Include

#include "temu-c/Support/Debugger.h"

Signature

void temu_debuggerAttach(void * debugger, temu_DebuggerIface * debuggerIface)

Description

Attach a debugger to the current scheduler

This attaches a debugger to the scheduler, ensuring it is notified about events such as breakpoints and watchpoints.

temu_debuggerConnected

Include

#include "temu-c/Support/Debugger.h"

Signature

void temu_debuggerConnected()

Description

Notify debugger infrastructure that a remote connection has been made

temu_debuggerCont

Include

#include "temu-c/Support/Debugger.h"

Signature

void temu_debuggerCont()

Description

Resume the scheduler from a debugger

Resumes the scheduler after a stop or breakpoint. Note the function returns immediately. The debugger server is expected to listen for events through the debugger interface instead.

temu_debuggerDetach

Include

#include "temu-c/Support/Debugger.h"

Signature

void temu_debuggerDetach(void * debugger)

Description

Detach the debugger from the current scheduler

This attaches a debugger to the scheduler, ensuring it is notified about events such as breakpoints and watchpoints.

temu_debuggerGetCurrentProcessor

Include

#include "temu-c/Support/Debugger.h"

Signature

int temu_debuggerGetCurrentProcessor()

Description

Return current processor number

Returns -1 when running, or stopped CPU number after breakpoint hit.

Result

temu_debuggerStep

Include

#include "temu-c/Support/Debugger.h"

Signature

void temu_debuggerStep(temu_TimeSource * cpu, int steps)

Description

Step the given processor.

The debugger must be attached, and the function will block until the scheduler is running using temu_run*() functions.

temu_debuggerStop

Include

#include "temu-c/Support/Debugger.h"

Signature

void temu_debuggerStop()

Description

Stop the scheduler from a debugger

This function is intended to be used by the GDB server. It stops the scheduler as soon as possible, without returning from the temu_run*() functions.

The function is blocking until the core has been stopped. If the core is currently not running, this function waits until someone calls temu_run*().

temu_deserialiseJSON

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_deserialiseJSON(const char * FileName)

Description

De-serialise the simulation state.

The function clears the whole internal object system, reads the JSON file FileName and creates all the objects.

If a class implements the ObjectIface, the (optional) deserialise procedure will be called.

Result

0 on success, otherwise non-zero

Parameters

Table 125. temu_deserialiseJSON Parameters
Parameter Type Description

FileName

const char *

The filename that contains the JSON data

temu_deserialiseProp

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_deserialiseProp(void * Ctxt, temu_Object * Obj, const char * Name)

Description

temu_deserialiseProp Deserialize a serialized property

Parameters

Table 126. temu_deserialiseProp Parameters
Parameter Type Description

Ctxt

void *

An opaque context, this is the same context as is passed to the deserialise interface function.

Obj

temu_Object *

Object being deserialised

Name

const char *

The name of the property

temu_dictCreate

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Dict * temu_dictCreate()

Description

Creates a dictionary object

Result

A pointer to the dictionary object

temu_dictDispose

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_dictDispose(temu_Dict * Dict)

Description

Delete a dictionary object

Parameters

Table 127. temu_dictDispose Parameters
Parameter Type Description

Dict

temu_Dict *

Pointer to the dictionary object to be deleted

temu_dictGetNextKey

Include

#include "temu-c/Support/Objsys.h"

Signature

const char * temu_dictGetNextKey(temu_Dict * Dict, const char * Key)

Description

Given a specific key of a dictionary, the next key is provided by this function

Result

The key that comes after Key, or nullptr on failure

Parameters

Table 128. temu_dictGetNextKey Parameters
Parameter Type Description

Dict

temu_Dict *

The dictionary that contains the keys

Key

const char *

The key, whose next value in the dict to be provided

temu_dictGetValue

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Propval temu_dictGetValue(temu_Dict * Dict, const char * Name)

Description

Retrieve a dictionary value by name

Result

The value

Parameters

Table 129. temu_dictGetValue Parameters
Parameter Type Description

Dict

temu_Dict *

Pointer to the dictionary object

Name

const char *

The name associated with the value to be retrieved

temu_dictInsertValue

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_dictInsertValue(temu_Dict * Dict, const char * Name, temu_Propval Val)

Description

Inserts a name/value pair to a dictionary

Result

0 on success. Other values indicate failures (e.g. the key is already used)

Parameters

Table 130. temu_dictInsertValue Parameters
Parameter Type Description

Dict

temu_Dict *

Pointer to the dictionary object

Name

const char *

The name to be inserted

Val

temu_Propval

The value to be inserted

temu_dictRemoveValue

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_dictRemoveValue(temu_Dict * Dict, const char * Name)

Description

Erase a name/value pair from a dictionary by name

Result

0 on success. Other values indicate errors (e.g. key was unavailable in the dictionary)

Parameters

Table 131. temu_dictRemoveValue Parameters
Parameter Type Description

Dict

temu_Dict *

Pointer to the dictionary object

Name

const char *

The name of the pair to be removed

temu_disassemble

Include

#include "temu-c/Support/Assembler.h"

Signature

char * temu_disassemble(void * Cpu, uint32_t Instr)

Description

Disassemble an instruction.

Result

A pointer to a malloced instruction string or null incase of failure.

temu_disassembleAuto

Include

#include "temu-c/Support/Assembler.h"

Signature

const char * temu_disassembleAuto(void * Cpu, uint32_t Instr)

Description

Disassemble an instruction.

Result

A pointer to a a thread local instruction string or null incase of failure.

temu_disassembleMemory

Include

#include "temu-c/Support/Assembler.h"

Signature

char * temu_disassembleMemory(void * Cpu, uint64_t Addr)

Description

Disassemble an instruction in memory

The function dissasmbles an instruction and retuns a string allocated on the heap. You are responsible for its release using free().

Result

A pointer to a malloced instruction string or null incase of failure.

Parameters

Table 132. temu_disassembleMemory Parameters
Parameter Type Description

Cpu

void *

CPU whose memory space will be used for disasembling.

Addr

uint64_t

Physical address of instruction to dissassemble.

temu_disposeGdbServer

Include

#include "temu-c/GdbServer/GdbServer.h"

Signature

void temu_disposeGdbServer(void * Gdb)

Description

Dispose a GDB server

Parameters

Table 133. temu_disposeGdbServer Parameters
Parameter Type Description

Gdb

void *

Pointer returned by temu_createGdbServer()

temu_disposeObject

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_disposeObject(temu_Object * Obj)

Description

Dispose object. The function will call the Objects dispose function.

Parameters

Table 134. temu_disposeObject Parameters
Parameter Type Description

Obj

temu_Object *

The object to delete.

temu_disposeSymtab

Include

#include "temu-c/Support/Loader.h"

Signature

void temu_disposeSymtab(temu_Symtab * Sym)

Description

Dispose (deallocate) the symbol table

Parameters

Table 135. temu_disposeSymtab Parameters
Parameter Type Description

Sym

temu_Symtab *

Symbol table pointer to free.

temu_elfHasDwarf

Include

#include "temu-c/Support/Loader.h"

Signature

int temu_elfHasDwarf(const char * file)

Description

Return non-zero if file has DWARF data

Result

0 if file does not contain DWARF, 1 if the file contains DWARF.

Parameters

Table 136. temu_elfHasDwarf Parameters
Parameter Type Description

file

const char *

Path to file to check for DWARF-info.

temu_ethGetEthTypeSizeField

Include

#include "temu-c/Bus/Ethernet.h"

Signature

uint16_t temu_ethGetEthTypeSizeField(temu_EthFrame * Frame)

Description

Get length / EtherType field. By ethernet standard, the size field which is 16 bit, will be a length if it is

1500 and an ethertype tag if it is >= 1536.

Result

temu_ethGetPayload

Include

#include "temu-c/Bus/Ethernet.h"

Signature

const uint8_t * temu_ethGetPayload(temu_EthFrame * Frame)

Description

Get a readable pointer to the payload. Note that the first bytes will often be an LLC header, it may not be your actual data payload.

Result

temu_eventDepublish

Include

#include "temu-c/Support/Events.h"

Signature

void temu_eventDepublish(int64_t EvID)

Description

It is possible to depublish events explicitly, but this is rarely needed as it is managed at termination time automatically.

Parameters

Table 137. temu_eventDepublish Parameters
Parameter Type Description

EvID

int64_t

Event ID

temu_eventDeschedule

Include

#include "temu-c/Support/Events.h"

Signature

void temu_eventDeschedule(int64_t EvID)

Description

Deschedule event

Parameters

Table 138. temu_eventDeschedule Parameters
Parameter Type Description

EvID

int64_t

The event ID of the event to deschedule.

temu_eventGetCycles

Include

#include "temu-c/Support/Events.h"

Signature

int64_t temu_eventGetCycles(temu_TimeSource * TS, int64_t EvID)

Description

Get delta time in cycles for the given event and queue

Result

Number of simulated cycles in the future the event will trigger

Parameters

Table 139. temu_eventGetCycles Parameters
Parameter Type Description

TS

temu_TimeSource *

The time source object (normally a CPU object)

EvID

int64_t

the event to get the cycles for.

temu_eventGetNanos

Include

#include "temu-c/Support/Events.h"

Signature

int64_t temu_eventGetNanos(temu_TimeSource * TS, int64_t EvID)

Description

Get delta time in nanoseconds for the given event and queue

Result

Number of simulated nanoseconds in the future when the event will trigger

Parameters

Table 140. temu_eventGetNanos Parameters
Parameter Type Description

TS

temu_TimeSource *

The time source object (normally a CPU object)

EvID

int64_t

the event to get the nanoseconds for.

temu_eventGetSecs

Include

#include "temu-c/Support/Events.h"

Signature

double temu_eventGetSecs(temu_TimeSource * TS, int64_t EvID)

Description

Get delta time in seconds for the given event and queue

Result

Number of simulated seconds in the future when the event will trigger

Parameters

Table 141. temu_eventGetSecs Parameters
Parameter Type Description

TS

temu_TimeSource *

The time source object (normally a CPU object)

EvID

int64_t

the event to get the seconds for.

temu_eventIsScheduled

Include

#include "temu-c/Support/Events.h"

Signature

int temu_eventIsScheduled(int64_t EvID)

Description

Check if event is scheduled

Result

Zero (0) in case the event is not scheduled, otherwise non-zero for scheduled events.

Parameters

Table 142. temu_eventIsScheduled Parameters
Parameter Type Description

EvID

int64_t

The event ID to check whether it is scheduled.

temu_eventPostAsync

Include

#include "temu-c/Support/Events.h"

Signature

void temu_eventPostAsync(temu_TimeSource * TS, temu_ThreadSafeCb CB, void * Data, temu_SyncEvent Sync)

Description

Post an event to an asynchronous queue

Parameters

Table 143. temu_eventPostAsync Parameters
Parameter Type Description

TS

temu_TimeSource *

the asynchronous queue or time source object (normally a CPU object)

CB

temu_ThreadSafeCb

The callback function to call when the event happens

Data

void *

The context data to be passed to the callback function

Sync

temu_SyncEvent

Execute on CPU or machine level.

temu_eventPostCycles

Include

#include "temu-c/Support/Events.h"

Signature

void temu_eventPostCycles(temu_TimeSource * TS, int64_t EvID, int64_t Delta, temu_SyncEvent Sync)

Description

Post events with a relative time in cycles in the future

Note that if posting a scheduled event, a warning will be printed and the event will be automatically descheduled before being inserted in the event queue.

Parameters

Table 144. temu_eventPostCycles Parameters
Parameter Type Description

TS

temu_TimeSource *

The time source object (normally a CPU object)

EvID

int64_t

The even ID returned by one of the event publish functions.

Delta

int64_t

The number of CPU clock cycles in the future to post the event. This should be > 0.

Sync

temu_SyncEvent

whether the event should be executed on the CPU queue or the machine queue.

temu_eventPostCyclesAbsolute

Include

#include "temu-c/Support/Events.h"

Signature

void temu_eventPostCyclesAbsolute(temu_TimeSource * TS, int64_t EvID, int64_t AbsTime, temu_SyncEvent Sync)

Description

Post events with an absolute time in cycles The function is only well defined for times >= current time. Timestamps

current time will have undefined behaviour.

Parameters

Table 145. temu_eventPostCyclesAbsolute Parameters
Parameter Type Description

TS

temu_TimeSource *

The time source object (normally a CPU object)

EvID

int64_t

The even ID returned by one of the event publish functions.

AbsTime

int64_t

The absolute time stamp to run the event at, this should be > current time.

Sync

temu_SyncEvent

whether the event should be executed on the CPU queue or the machine queue.

temu_eventPostImmediate

Include

#include "temu-c/Support/Events.h"

Signature

void temu_eventPostImmediate(temu_TimeSource * TS, int64_t EvID, temu_SyncEvent Sync)

Description

Post events in the immediate event queue

Immediate events are executed either after the current instruction is finished or when the machine quanta expires in case of machine synchronised events. This is the same as for stacked events, however immediate events are executed in FIFO order.

Parameters

Table 146. temu_eventPostImmediate Parameters
Parameter Type Description

TS

temu_TimeSource *

The time source object (normally a CPU object)

EvID

int64_t

The even ID returned by one of the event publish functions.

Sync

temu_SyncEvent

whether the event should be executed on the CPU queue or the machine queue.

temu_eventPostNanos

Include

#include "temu-c/Support/Events.h"

Signature

void temu_eventPostNanos(temu_TimeSource * TS, int64_t EvID, int64_t Delta, temu_SyncEvent Sync)

Description

Post events with a relative time in nanoseconds in the future

Parameters

Table 147. temu_eventPostNanos Parameters
Parameter Type Description

TS

temu_TimeSource *

The time source object (normally a CPU object)

EvID

int64_t

The even ID returned by one of the event publish functions.

Delta

int64_t

The number of nanoseconds in the future to post the event. This should be > 0.

Sync

temu_SyncEvent

whether the event should be executed on the CPU queue or the machine queue.

temu_eventPostNanosAbsolute

Include

#include "temu-c/Support/Events.h"

Signature

void temu_eventPostNanosAbsolute(temu_TimeSource * TS, int64_t EvID, int64_t AbsTime, temu_SyncEvent Sync)

Description

Post events with an absolute time in nanoseconds The function is only well defined for times >= current time. Timestamps

current time will have undefined behaviour.

Parameters

Table 148. temu_eventPostNanosAbsolute Parameters
Parameter Type Description

TS

temu_TimeSource *

The time source object (normally a CPU object)

EvID

int64_t

The even ID returned by one of the event publish functions.

AbsTime

int64_t

The absolute time stamp to run the event at, this should be > current time.

Sync

temu_SyncEvent

whether the event should be executed on the CPU queue or the machine queue.

temu_eventPostSecs

Include

#include "temu-c/Support/Events.h"

Signature

void temu_eventPostSecs(temu_TimeSource * TS, int64_t EvID, double Delta, temu_SyncEvent Sync)

Description

Post events with a relative time in seconds in the future

Parameters

Table 149. temu_eventPostSecs Parameters
Parameter Type Description

TS

temu_TimeSource *

The time source object (normally a CPU object)

EvID

int64_t

The even ID returned by one of the event publish functions.

Delta

double

The number of seconds in the future to post the event. This should be > 0.

Sync

temu_SyncEvent

whether the event should be executed on the CPU queue or the machine queue.

temu_eventPostStack

Include

#include "temu-c/Support/Events.h"

Signature

void temu_eventPostStack(temu_TimeSource * TS, int64_t EvID, temu_SyncEvent Sync)

Description

Post events in the event queue stack

Stacked events are executed either after the current instruction is finished or when the machine quanta expires in case of machine synchronised events.

Parameters

Table 150. temu_eventPostStack Parameters
Parameter Type Description

TS

temu_TimeSource *

The time source object (normally a CPU object)

EvID

int64_t

The even ID returned by one of the event publish functions.

Sync

temu_SyncEvent

whether the event should be executed on the CPU queue or the machine queue.

temu_eventPostSteps

Include

#include "temu-c/Support/Events.h"

Signature

void temu_eventPostSteps(temu_TimeSource * TS, int64_t EvID, int64_t Delta, temu_SyncEvent Sync)

Description

Post events with a relative trigger in steps

Posting an event in steps is not effected by the IPC/CPI setting of the clock.

Parameters

Table 151. temu_eventPostSteps Parameters
Parameter Type Description

TS

temu_TimeSource *

The time source object (normally a CPU object)

EvID

int64_t

The even ID returned by one of the event publish functions.

Delta

int64_t

The number of CPU steps in the future to post the event. This should be > 0.

Sync

temu_SyncEvent

whether the event should be executed on the CPU queue or the machine queue.

temu_eventPublish

Include

#include "temu-c/Support/Events.h"

Signature

int64_t temu_eventPublish(const char * EvName, void * Obj, void (*)(temu_Event *) Func)

Description

Publish an event.

The function will allocate an event structure in the global event heap and return the event ID.

A typical use is to call the function in the object constructor and assign the event id to a field in the object. This field should not be snapshotted (i.e. it will be reassigned in the constructor) when restoring an object anyway.

This function is non thread safe. Object construction is expected to be done in a single thread (e.g. the main thread).

Result

The event ID >= 0 in case of success. Negative values indicate errors.

Parameters

Table 152. temu_eventPublish Parameters
Parameter Type Description

EvName

const char *

Name of the event

Obj

void *

The object associated with the event

Func

void (*)(temu_Event *)

The event callback function.

temu_eventPublishStruct

Include

#include "temu-c/Support/Events.h"

Signature

int64_t temu_eventPublishStruct(const char * EvName, temu_Event * Ev, void * Obj, void (*)(temu_Event *) Func)

Description

Publish a preallocated event object.

The event objects can be embedded in your own class if needed.

Result

The event ID.

Parameters

Table 153. temu_eventPublishStruct Parameters
Parameter Type Description

EvName

const char *

Name of the event

Ev

temu_Event *

Pointer to the event struct

Obj

void *

The object associated with the event

Func

void (*)(temu_Event *)

The event callback function.

temu_eventQueueGetFreq

Include

#include "temu-c/Support/Events.h"

Signature

uint64_t temu_eventQueueGetFreq(temu_TimeSource * TS)

Description

Get the frequency in Hz of the given time source.

Result

Parameters

Table 154. temu_eventQueueGetFreq Parameters
Parameter Type Description

TS

temu_TimeSource *

Time source

temu_eventRescheduleCycles

Include

#include "temu-c/Support/Events.h"

Signature

void temu_eventRescheduleCycles(temu_TimeSource * TS, int64_t EvID, int64_t Delta, temu_SyncEvent Sync)

Description

Reschedule event with relative time in cycles

This function automatically deschedules the event before scheduling it again. The function ensures only one lock is taken for the pattern:

  • is scheduled?

  • de-schedule

  • post

Parameters

Table 155. temu_eventRescheduleCycles Parameters
Parameter Type Description

TS

temu_TimeSource *

The time source object (normally a CPU object)

EvID

int64_t

The even ID returned by one of the event publish functions.

Delta

int64_t

The number of CPU clock cycles in the future to post the event. This should be > 0.

Sync

temu_SyncEvent

whether the event should be executed on the CPU queue or the machine queue.

temu_eventSetPeriodCycles

Include

#include "temu-c/Support/Events.h"

Signature

void temu_eventSetPeriodCycles(int64_t EvID, int64_t Period)

Description

Set the cycles property on an event.

Periodic events have the advantage that they do not slip due to reposting of event with respect to the event triggering time and behaves as if the reposting is 1, automatic and 2, is relative to the event schedule time. which differ from the triggering time by possibly a few cycles. Note, calling this function does not reschedule the event.

Parameters

Table 156. temu_eventSetPeriodCycles Parameters
Parameter Type Description

EvID

int64_t

Event ID

Period

int64_t

Cycles to add as period.

temu_eventSetRTPeriodNanos

Include

#include "temu-c/Support/Events.h"

Signature

void temu_eventSetRTPeriodNanos(int64_t EvID, int64_t Period)

Description

Set the RT period (nanoseconds), this should be the same as the cycle period, but it should be in nanoseconds and tno cycles

Parameters

Table 157. temu_eventSetRTPeriodNanos Parameters
Parameter Type Description

EvID

int64_t

Event ID

Period

int64_t

Period in nanoseconds

temu_eventSetRTTime

Include

#include "temu-c/Support/Events.h"

Signature

void temu_eventSetRTTime(int64_t EvID, int64_t Time)

Description

Set the RT time (nanoseconds absoulute time computed from temu_timeGetMonotonicWct()). This time is used by events flagged with TEMU_EVENT_RT to delay the execution of the event handler function.

Parameters

Table 158. temu_eventSetRTTime Parameters
Parameter Type Description

EvID

int64_t

Event ID

Time

int64_t

Absolute time to trigger event at in WCT

temu_eventSetRealTime

Include

#include "temu-c/Support/Events.h"

Signature

int temu_eventSetRealTime(int64_t EvID)

Description

Mark an event as real-time.

With a real-time event, it is meant that the event will execute at roughly real-time. In the case when the event is posted, it will compute a rough triggering time in wall clock. When the event is executed it will do two things:

  1. Check if the event wall-clock time is before the current time, if so emit a "temu.realtime-slip" notification".

  2. Check if the event is triggered in the future (with respect to wall clock), if so sleep until the wall-clock has caught up.

Due to the behaviour, the real-time events are suitable only for relatively short event times, as long sleep times may make the emulator non responsive. Especially at present, this will block the execution of async events as the event queue is halted until the wall-clock catches up to the simulated time.

Note that RT event support is primarily used to slow down the emulator artificially, this is accomplished by enabling real-time mode on the relevant model.

This function should only be called on in-flight events.

Result

0 On success.

Parameters

Table 159. temu_eventSetRealTime Parameters
Parameter Type Description

EvID

int64_t

Event ID to make real-time

temu_execCommand

Include

#include "temu-c/Support/CommandLine.h"

Signature

int temu_execCommand(const char * Cmd)

Description

Executes a single command

Result

0 on success, otherwise a non-zero value

Parameters

Table 160. temu_execCommand Parameters
Parameter Type Description

Cmd

const char *

The command to be executed

temu_execCommandFile

Include

#include "temu-c/Support/CommandLine.h"

Signature

int temu_execCommandFile(const char * File)

Description

Executes the commands in the file "File"

Result

0 on success, otherwise a non-zero value

Parameters

Table 161. temu_execCommandFile Parameters
Parameter Type Description

File

const char *

Path to the file with the commands to be executed

temu_floatingPointPropval

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Propval temu_floatingPointPropval(temu_Type T, double V)

Description

Create a floating point propval of the given type

Result

Property value with the given type and value.

Parameters

Table 162. temu_floatingPointPropval Parameters
Parameter Type Description

T

temu_Type

Type ID, must be a teTY_Float or teTY_Double

V

double

Value

temu_foreachClass

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_foreachClass(void (*)(temu_Class *, void *) Func, void * Arg)

Description

Call function on every class in the object system The function is called with the metaclass pointer and the argument. NOTE: This function is experimental.

Parameters

Table 163. temu_foreachClass Parameters
Parameter Type Description

Func

void (*)(temu_Class *, void *)

Function to call

Arg

void *

Argument passed as the last parameter to Func

temu_foreachComponent

Include

#include "temu-c/Support/Component.h"

Signature

void temu_foreachComponent(void (*)(temu_Component *, void *) Func, void * Arg)

Description

Iterate over all components and call a function on them

Parameters

Table 164. temu_foreachComponent Parameters
Parameter Type Description

Func

void (*)(temu_Component *, void *)

The function to be called on each component, with the signature Func)(temu_Component,void*)

Arg

void *

The second argument to be passed to the function, for passing context

temu_foreachInterface

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_foreachInterface(temu_Class * C, void (*)(temu_Class *, const char *, void *) Func, void * Arg)

Description

Call function on every interface in a class. The function is called with the class pointer, interface name and the argument. NOTE: This function is experimental.

Parameters

Table 165. temu_foreachInterface Parameters
Parameter Type Description

C

temu_Class *

Class to iterate properties

Func

void (*)(temu_Class *, const char *, void *)

Function to call

Arg

void *

Argument passed as the last parameter to Func

temu_foreachObject

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_foreachObject(void (*)(temu_Object *, void *) Func, void * Arg)

Description

Call function on every object in the object system The function is called with the object pointer and the argument. NOTE: This function is experimental.

Parameters

Table 166. temu_foreachObject Parameters
Parameter Type Description

Func

void (*)(temu_Object *, void *)

Function to call

Arg

void *

Argument passed as the last parameter to Func

temu_foreachProcessor

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_foreachProcessor(void (*)(temu_Object *, void *) Func, void * Arg)

Description

Call function on every processor in the object system The function is called with the CPU pointer and the argument. NOTE: This function is experimental.

Parameters

Table 167. temu_foreachProcessor Parameters
Parameter Type Description

Func

void (*)(temu_Object *, void *)

Function to call

Arg

void *

Argument passed as the last parameter to Func

temu_foreachProperty

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_foreachProperty(temu_Class * C, void (*)(temu_Class *, const char *, void *) Func, void * Arg)

Description

Call function on every property in a class. The function is called with the class pointer, property name and the argument. NOTE: This function is experimental.

Parameters

Table 168. temu_foreachProperty Parameters
Parameter Type Description

C

temu_Class *

Class to iterate properties

Func

void (*)(temu_Class *, const char *, void *)

Function to call

Arg

void *

Argument passed as the last parameter to Func

temu_foreachRootComponent

Include

#include "temu-c/Support/Component.h"

Signature

void temu_foreachRootComponent(void (*)(temu_Component *, void *) Func, void * Arg)

Description

Iterate over all root components and call a function on them

Parameters

Table 169. temu_foreachRootComponent Parameters
Parameter Type Description

Func

void (*)(temu_Component *, void *)

The function to be called on each component, with the signature Func)(temu_Component,void*)

Arg

void *

The second argument to be passed to the function, for passing context

temu_gdbAddCpu

Include

#include "temu-c/GdbServer/GdbServer.h"

Signature

void temu_gdbAddCpu(void * Gdb, const char * CpuName)

Description

Add named CPU to GDB server

Parameters

Table 170. temu_gdbAddCpu Parameters
Parameter Type Description

Gdb

void *

Pointer returned by temu_createGdbServer()

CpuName

const char *

Name of processor object.

temu_gdbAddMachine

Include

#include "temu-c/GdbServer/GdbServer.h"

Signature

void temu_gdbAddMachine(void * Gdb, const char * MachineName)

Description

Add named machine to GDB server

Parameters

Table 171. temu_gdbAddMachine Parameters
Parameter Type Description

Gdb

void *

Pointer returned by temu_createGdbServer()

MachineName

const char *

Name of Machine object.

temu_gdbAsyncStop

Include

#include "temu-c/GdbServer/GdbServer.h"

Signature

void temu_gdbAsyncStop(void * Gdb)

Description

Tell GDB server to stop at next safe point in time.

Parameters

Table 172. temu_gdbAsyncStop Parameters
Parameter Type Description

Gdb

void *

Pointer returned by temu_createGdbServer()

temu_gdbRun

Include

#include "temu-c/GdbServer/GdbServer.h"

Signature

int temu_gdbRun(void * Gdb)

Description

Run the GDB server loop

Result

Parameters

Table 173. temu_gdbRun Parameters
Parameter Type Description

Gdb

void *

Pointer returned by temu_createGdbServer()

temu_gdbWaitForConnection

Include

#include "temu-c/GdbServer/GdbServer.h"

Signature

void temu_gdbWaitForConnection(void * Gdb)

Description

Wait current thread for a user to connect

Parameters

Table 174. temu_gdbWaitForConnection Parameters
Parameter Type Description

Gdb

void *

Pointer returned by temu_createGdbServer()

temu_generateObjectGraph

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_generateObjectGraph(const char * Path, int Display)

Description

Print the current object graph as a dot file

Pass NULL (or nullptr) to generate to stdout. And set Display to non-zero to automatically display the generated dot-file.

Result

0 if the generation was successful. Non-zero in case of failure.

Parameters

Table 175. temu_generateObjectGraph Parameters
Parameter Type Description

Path

const char *

Destination file to write the graph to. NULL indicates stdout.

Display

int

If non-zero, the function will attempt to display the graph by running it through dot and .

temu_getComponentCount

Include

#include "temu-c/Support/Objsys.h"

Signature

size_t temu_getComponentCount()

Description

temu_getComponentCount Get the number of components in the current simulation

Result

The number of components in the current simulation

temu_getComponents

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Component ** temu_getComponents()

Description

temu_getComponents Get the number of components in the current simulation

Result

An array of the pointers to the components in the current simulation, the length of the array can be obtained from temu_getComponentCount()

temu_getCycles

Include

#include "temu-c/Support/Time.h"

Signature

int64_t temu_getCycles(temu_TimeSource * TS)

Description

Get current time in cycles.

Result

Current cycles as it is understood by the object.

Parameters

Table 176. temu_getCycles Parameters
Parameter Type Description

TS

temu_TimeSource *

Time source object

temu_getExecutionState

Include

#include "temu-c/Support/Scheduler.h"

Signature

temu_ExecutionState temu_getExecutionState()

Description

Get the current execution status of TEMU

Result

Current execution status

temu_getFieldValue

Include

#include "temu-c/Support/Register.h"

Signature

uint64_t temu_getFieldValue(temu_Object * Obj, const char * RegName, unsigned int RegIdx, const char * FieldName)

Description

Retrieve the value of a field in a register

Result

The value of the field

Parameters

Table 177. temu_getFieldValue Parameters
Parameter Type Description

Obj

temu_Object *

The object of the class the has the register

RegName

const char *

Register name

RegIdx

unsigned int

Register index

FieldName

const char *

Field name

temu_getInterfaceName

Include

#include "temu-c/Support/Objsys.h"

Signature

const char * temu_getInterfaceName(temu_Object * Obj, void * Iface)

Description

temu_getInterfaceName Get Interface Name of the Obj

Result

The name of the interface

Parameters

Table 178. temu_getInterfaceName Parameters
Parameter Type Description

Obj

temu_Object *

Pointer to the object containing the interface

Iface

void *

Interface to be find w.r.t. Object

temu_getInterfaceRef

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_IfaceRef temu_getInterfaceRef(temu_Object * Obj, const char * IfaceName, int Idx)

Description

Retrieve a reference to an interface identified by its name and index

Result

The interface reference as a temu_IfaceRef object

Parameters

Table 179. temu_getInterfaceRef Parameters
Parameter Type Description

Obj

temu_Object *

Pointer to the object containing the interface

IfaceName

const char *

Name of the interface

Idx

int

Interface index

temu_getLoggingCategory

Include

#include "temu-c/Support/Objsys.h"

Signature

const char * temu_getLoggingCategory(temu_Class * Cls, unsigned int CategoryId)

Description

temu_getLogginCategory adds a logging category to the class

Result

Pointer to the category string, NULL for failure.

Parameters

Table 180. temu_getLoggingCategory Parameters
Parameter Type Description

Cls

temu_Class *

the class

CategoryId

unsigned int

The category id. Valid range is [8,16)

temu_getMajorVersion

Include

#include "temu-c/Support/Version.h"

Signature

unsigned int temu_getMajorVersion()

Description

Get TEMU major version as number.

Result

Major version number

temu_getMinorVersion

Include

#include "temu-c/Support/Version.h"

Signature

unsigned int temu_getMinorVersion()

Description

Get TEMU minor version as number.

Result

Minor version number

temu_getModelRegisterBankInfo

Include

#include "temu-c/Support/Register.h"

Signature

const temu_ModelRegInfo * temu_getModelRegisterBankInfo(temu_Class * C)

Description

Get list of class register banks The returned object is thread local. It will be destroyed on the next call in the current thread.

Result

Thread local mobel reg info object with a list of all register banks.

Parameters

Table 181. temu_getModelRegisterBankInfo Parameters
Parameter Type Description

C

temu_Class *

The class object.

temu_getNanos

Include

#include "temu-c/Support/Time.h"

Signature

int64_t temu_getNanos(temu_TimeSource * TS)

Description

Get current time in nanoseconds

Result

Current nanoseconds as it is understood by the object.

Parameters

Table 182. temu_getNanos Parameters
Parameter Type Description

TS

temu_TimeSource *

Time source object

temu_getPatchVersion

Include

#include "temu-c/Support/Version.h"

Signature

unsigned int temu_getPatchVersion()

Description

Get TEMU patch version as number.

Result

Patch version number

temu_getProcessorCount

Include

#include "temu-c/Support/Objsys.h"

Signature

size_t temu_getProcessorCount()

Description

temu_getProcessorCount Get the number of processors in the current simulation

Result

The number of processors in the current simulation

temu_getProcessors

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Object ** temu_getProcessors()

Description

temu_getProcessors Get the list of processors in the current simulation

Result

An array of processor pointers, the length can be obtained from temu_getProcessorCount()

temu_getPropAccessor

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_PropAccessor temu_getPropAccessor(temu_Object * Obj, const char * PropName, int PropIdx)

Description

Get a reference to the named property

This is useful as a replacement of temu_getPropref and temu_getPropName. The resulting data structure lets you automatically disambiguate between properties and pseudo properties.

The index used will be PropIdx, or K if the PropName string has an array suffix [K].

Result

A struct containing prop accessor data.

Parameters

Table 183. temu_getPropAccessor Parameters
Parameter Type Description

Obj

temu_Object *

An object of a class with the relevant property registered.

PropName

const char *

The name of the property to be queried.

PropIdx

int

Index in property array.

temu_getPropDynLength

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_getPropDynLength(const temu_Object * Obj, const char * PropName)

Description

Get the dynamic length of the property

Normally, the temu_getPropLength() would return 1 for a dynamic array. This means that there is one dynamic array. In case the length of the dynamic array is needed, this function can be used.

Result

Dynamic length of property

Parameters

Table 184. temu_getPropDynLength Parameters
Parameter Type Description

Obj

const temu_Object *

Pointer to the object of the property

PropName

const char *

Name of the property

temu_getPropLength

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_getPropLength(const temu_Object * Obj, const char * PropName)

Description

Returns property length/size if a property is an array

Result

The length of the property

Parameters

Table 185. temu_getPropLength Parameters
Parameter Type Description

Obj

const temu_Object *

Pointer to the object of the property

PropName

const char *

Name of the property

temu_getPropName

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_PropName temu_getPropName(const temu_Object * Obj, const char * PropName)

Description

Get a reference to a named property.

Result

Prop name object, note that the returned name string is not the same as the passed string. The returned string has a lifetime bound to the class, hence it can be returned without any problems.

Parameters

Table 186. temu_getPropName Parameters
Parameter Type Description

Obj

const temu_Object *

An object of a class with the relevant property registered.

PropName

const char *

The name of the property to be queried.

temu_getPropType

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Type temu_getPropType(const temu_Object * Obj, const char * PropName)

Description

Get the type of a property

Result

Property type

Parameters

Table 187. temu_getPropType Parameters
Parameter Type Description

Obj

const temu_Object *

Pointer to the object of the property

PropName

const char *

Name of the property

temu_getPropref

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Propref temu_getPropref(const temu_Object * Obj, const char * PropName)

Description

Get a reference to the named property. The propref is a typetag and a pointer to the raw value, as such it does not work with delegated properties in components, nor with pseudo properties.

Result

Object of the property reference

Parameters

Table 188. temu_getPropref Parameters
Parameter Type Description

Obj

const temu_Object *

An object of a class with the relevant property registered.

PropName

const char *

The name of the property to be queried.

temu_getRegister

Include

#include "temu-c/Support/Register.h"

Signature

temu_Register * temu_getRegister(temu_RegisterBank * Bank, const char * Name)

Description

Get a register from a register bank by name

Result

Pointer to the register object

Parameters

Table 189. temu_getRegister Parameters
Parameter Type Description

Bank

temu_RegisterBank *

Pointer to the register bank object

Name

const char *

Name of the register

temu_getRegisterBank

Include

#include "temu-c/Support/Register.h"

Signature

temu_RegisterBank * temu_getRegisterBank(temu_Class * C, const char * Name)

Description

Get a register bank from a class by name

Result

Pointer to the register bank

Parameters

Table 190. temu_getRegisterBank Parameters
Parameter Type Description

C

temu_Class *

Pointer to the TEMU class

Name

const char *

Name of the register bank

temu_getRegisterBankName

Include

#include "temu-c/Support/Register.h"

Signature

const char * temu_getRegisterBankName(temu_RegisterBank * Bank)

Description

Retrieves the register bank name from its object

Result

Bank name as a C-string

Parameters

Table 191. temu_getRegisterBankName Parameters
Parameter Type Description

Bank

temu_RegisterBank *

Pointer to the register bank name

temu_getRegisterColdResetValue

Include

#include "temu-c/Support/Register.h"

Signature

uint64_t temu_getRegisterColdResetValue(temu_Register * Reg)

Description

Returns the cold reset value of the register (computed from the field info data). Cold reset is also known as a hard reset, and implies that the power has been off for some time.

Result

The cold reset value

Parameters

Table 192. temu_getRegisterColdResetValue Parameters
Parameter Type Description

Reg

temu_Register *

Pointer to the register

temu_getRegisterDocs

Include

#include "temu-c/Support/Register.h"

Signature

const char * temu_getRegisterDocs(temu_Register * R)

Description

Get the documentation of a register as a string

Result

The documentation of the register as a C-string

Parameters

Table 193. temu_getRegisterDocs Parameters
Parameter Type Description

R

temu_Register *

Pointer to the register

temu_getRegisterInfo

Include

#include "temu-c/Support/Register.h"

Signature

const temu_RegisterInfo * temu_getRegisterInfo(temu_Class * C, const char * RegName)

Description

Get register info for named register The returned object is thread local. It will be destroyed on the next call in the current thread.

Result

Thread local register info object.

Parameters

Table 194. temu_getRegisterInfo Parameters
Parameter Type Description

C

temu_Class *

The class object.

RegName

const char *

Register name.

temu_getRegisterName

Include

#include "temu-c/Support/Register.h"

Signature

const char * temu_getRegisterName(temu_Register * R)

Description

Retrieve register name from pointer

Result

The name of the register

Parameters

Table 195. temu_getRegisterName Parameters
Parameter Type Description

R

temu_Register *

Pointer to the register

temu_getRegisterReadMask

Include

#include "temu-c/Support/Register.h"

Signature

uint64_t temu_getRegisterReadMask(temu_Register * Reg)

Description

Get the current read mask of a register

Result

The value of the mask

Parameters

Table 196. temu_getRegisterReadMask Parameters
Parameter Type Description

Reg

temu_Register *

Pointer to the register

temu_getRegisterWarmResetValue

Include

#include "temu-c/Support/Register.h"

Signature

uint64_t temu_getRegisterWarmResetValue(temu_Register * Reg)

Description

Returns the warm reset value of the register

Result

The warm reset value

Parameters

Table 197. temu_getRegisterWarmResetValue Parameters
Parameter Type Description

Reg

temu_Register *

Pointer to the register

temu_getRegisterWriteMask

Include

#include "temu-c/Support/Register.h"

Signature

uint64_t temu_getRegisterWriteMask(temu_Register * Reg)

Description

Get the current write mask of a register

Result

The value of the mask

Parameters

Table 198. temu_getRegisterWriteMask Parameters
Parameter Type Description

Reg

temu_Register *

Pointer to the register

temu_getScheduledProcessor

Include

#include "temu-c/Support/Scheduler.h"

Signature

temu_TimeSource * temu_getScheduledProcessor(unsigned int cpu)

Description

Get processor in global scheduler

Result

Processor pointer as a time source.

Parameters

Table 199. temu_getScheduledProcessor Parameters
Parameter Type Description

cpu

unsigned int

Processor number to get

temu_getScheduledProcessorCount

Include

#include "temu-c/Support/Scheduler.h"

Signature

unsigned int temu_getScheduledProcessorCount()

Description

Get the number of processors in the global scheduler.

Result

Number of processors in global scheduler.

temu_getSecs

Include

#include "temu-c/Support/Time.h"

Signature

double temu_getSecs(temu_TimeSource * TS)

Description

Get current time in seconds

Result

Current seconds as it is understood by the object.

Parameters

Table 200. temu_getSecs Parameters
Parameter Type Description

TS

temu_TimeSource *

Time source object

temu_getSteps

Include

#include "temu-c/Support/Time.h"

Signature

int64_t temu_getSteps(temu_TimeSource * TS)

Description

Get current step count

Result

Current steps as it is understood by the object.

Parameters

Table 201. temu_getSteps Parameters
Parameter Type Description

TS

temu_TimeSource *

Time source object

temu_getVTable

Include

#include "temu-c/Support/Objsys.h"

Signature

void * temu_getVTable(const temu_Object * Obj)

Description

Get the VTable pointer for an object. This only works for internal objects that inherits from temu_Object.

Result

Pointer to the vtable in question

Parameters

Table 202. temu_getVTable Parameters
Parameter Type Description

Obj

const temu_Object *

The object in question

temu_getVTableForClass

Include

#include "temu-c/Support/Objsys.h"

Signature

void * temu_getVTableForClass(temu_Class * Cls)

Description

Get the VTable pointer for a class

Result

Pointer to the vtable in question

Parameters

Table 203. temu_getVTableForClass Parameters
Parameter Type Description

Cls

temu_Class *

The class, for which the vtable is to be retrieved

temu_getValue

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Propval temu_getValue(temu_Object * Obj, const char * PropName, int Idx)

Description

Get the value of a property from an object

Result

The value of the property

Parameters

Table 204. temu_getValue Parameters
Parameter Type Description

Obj

temu_Object *

The object that contains the property

PropName

const char *

Property name

Idx

int

Index of the property. Set to 0 if the property is not an array

temu_getValueDouble

Include

#include "temu-c/Support/Objsys.h"

Signature

double temu_getValueDouble(temu_Object * Obj, const char * PropName, int Idx)

Description

Get property (without side effects)

Result

The property value converted to double

Parameters

Table 205. temu_getValueDouble Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property

Idx

int

Index in property array (set to 0 if scalar)

temu_getValueI16

Include

#include "temu-c/Support/Objsys.h"

Signature

int16_t temu_getValueI16(temu_Object * Obj, const char * PropName, int Idx)

Description

Get the value of a property from an object if it is an int16

Result

The value of the property

Parameters

Table 206. temu_getValueI16 Parameters
Parameter Type Description

Obj

temu_Object *

The object that contains the property

PropName

const char *

Property name

Idx

int

Index of the property. Set to 0 if the property is not an array

temu_getValueI32

Include

#include "temu-c/Support/Objsys.h"

Signature

int32_t temu_getValueI32(temu_Object * Obj, const char * PropName, int Idx)

Description

Get the value of a property from an object if it is an int32

Result

The value of the property

Parameters

Table 207. temu_getValueI32 Parameters
Parameter Type Description

Obj

temu_Object *

The object that contains the property

PropName

const char *

Property name

Idx

int

Index of the property. Set to 0 if the property is not an array

temu_getValueI64

Include

#include "temu-c/Support/Objsys.h"

Signature

int64_t temu_getValueI64(temu_Object * Obj, const char * PropName, int Idx)

Description

Get the value of a property from an object if it is an int64

Result

The value of the property

Parameters

Table 208. temu_getValueI64 Parameters
Parameter Type Description

Obj

temu_Object *

The object that contains the property

PropName

const char *

Property name

Idx

int

Index of the property. Set to 0 if the property is not an array

temu_getValueI8

Include

#include "temu-c/Support/Objsys.h"

Signature

int8_t temu_getValueI8(temu_Object * Obj, const char * PropName, int Idx)

Description

Get the value of a property from an object if it is an int8

Result

The value of the property

Parameters

Table 209. temu_getValueI8 Parameters
Parameter Type Description

Obj

temu_Object *

The object that contains the property

PropName

const char *

Property name

Idx

int

Index of the property. Set to 0 if the property is not an array

temu_getValueSigned

Include

#include "temu-c/Support/Objsys.h"

Signature

int64_t temu_getValueSigned(temu_Object * Obj, const char * PropName, int Idx)

Description

Get property (without side effects)

Result

The property value converted to signed

Parameters

Table 210. temu_getValueSigned Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property

Idx

int

Index in property array (set to 0 if scalar)

temu_getValueU16

Include

#include "temu-c/Support/Objsys.h"

Signature

uint16_t temu_getValueU16(temu_Object * Obj, const char * PropName, int Idx)

Description

Get the value of a property from an object if it is an uint16

Result

The value of the property

Parameters

Table 211. temu_getValueU16 Parameters
Parameter Type Description

Obj

temu_Object *

The object that contains the property

PropName

const char *

Property name

Idx

int

Index of the property. Set to 0 if the property is not an array

temu_getValueU32

Include

#include "temu-c/Support/Objsys.h"

Signature

uint32_t temu_getValueU32(temu_Object * Obj, const char * PropName, int Idx)

Description

Get the value of a property from an object if it is an uint32

Result

The value of the property

Parameters

Table 212. temu_getValueU32 Parameters
Parameter Type Description

Obj

temu_Object *

The object that contains the property

PropName

const char *

Property name

Idx

int

Index of the property. Set to 0 if the property is not an array

temu_getValueU64

Include

#include "temu-c/Support/Objsys.h"

Signature

uint64_t temu_getValueU64(temu_Object * Obj, const char * PropName, int Idx)

Description

Get the value of a property from an object if it is an uint64

Result

The value of the property

Parameters

Table 213. temu_getValueU64 Parameters
Parameter Type Description

Obj

temu_Object *

The object that contains the property

PropName

const char *

Property name

Idx

int

Index of the property. Set to 0 if the property is not an array

temu_getValueU8

Include

#include "temu-c/Support/Objsys.h"

Signature

uint8_t temu_getValueU8(temu_Object * Obj, const char * PropName, int Idx)

Description

Get the value of a property from an object if it is an uint8

Result

The value of the property

Parameters

Table 214. temu_getValueU8 Parameters
Parameter Type Description

Obj

temu_Object *

The object that contains the property

PropName

const char *

Property name

Idx

int

Index of the property. Set to 0 if the property is not an array

temu_getValueUnsigned

Include

#include "temu-c/Support/Objsys.h"

Signature

uint64_t temu_getValueUnsigned(temu_Object * Obj, const char * PropName, int Idx)

Description

Get property (without side effects)

Result

The property value converted to unsigned

Parameters

Table 215. temu_getValueUnsigned Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property

Idx

int

Index in property array (set to 0 if scalar)

temu_getVersionString

Include

#include "temu-c/Support/Version.h"

Signature

const char * temu_getVersionString()

Description

Get TEMU version string.

Result

Version string in format like: MAJOR . MINOR . PATCH ( REVISION )

temu_identifyTrailingZeroes32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_identifyTrailingZeroes32(uint32_t Word)

Description

Get word with all trailing zeroes set

Result

A copy of word, with trailing zeros set

Parameters

Table 216. temu_identifyTrailingZeroes32 Parameters
Parameter Type Description

Word

uint32_t

The word, in which trailing zeros to be set

temu_identifyTrailingZeroes64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_identifyTrailingZeroes64(uint64_t Word)

Description

Get word with all trailing zeroes set

Result

A copy of word, with trailing zeros set

Parameters

Table 217. temu_identifyTrailingZeroes64 Parameters
Parameter Type Description

Word

uint64_t

The word, in which trailing zeros to be set

temu_identifyTrailingZeroesAndFirst32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_identifyTrailingZeroesAndFirst32(uint32_t Word)

Description

Get word with all trailing zeroes set, and the fist bit set

Result

Word, with all trailing zeroes set, and the fist bit set

Parameters

Table 218. temu_identifyTrailingZeroesAndFirst32 Parameters
Parameter Type Description

Word

uint32_t

Word to get trailing zero mask from

temu_identifyTrailingZeroesAndFirst64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_identifyTrailingZeroesAndFirst64(uint64_t Word)

Description

Get word with all trailing zeroes set, and the fist bit set

Result

Word, with all trailing zeroes set, and the fist bit set

Parameters

Table 219. temu_identifyTrailingZeroesAndFirst64 Parameters
Parameter Type Description

Word

uint64_t

Word to get trailing zero mask from

temu_ifaceRefArrayAlloc

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_IfaceRefArray temu_ifaceRefArrayAlloc(unsigned int Reserve)

Description

Allocate interface array.

Result

The allocated interface array.

Parameters

Table 220. temu_ifaceRefArrayAlloc Parameters
Parameter Type Description

Reserve

unsigned int

Number of entries to reserve initially.

temu_ifaceRefArrayGet

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_IfaceRef temu_ifaceRefArrayGet(temu_IfaceRefArray * Arr, unsigned int idx)

Description

Get the index of the interface reference array.

Result

The interface array with in bounds.

Parameters

Table 221. temu_ifaceRefArrayGet Parameters
Parameter Type Description

Arr

temu_IfaceRefArray *

The interface reference array

idx

unsigned int

is the index of the array

temu_ifaceRefArrayPush

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_ifaceRefArrayPush(temu_IfaceRefArray * Arr, temu_IfaceRef Iface)

Description

Push an interface reference to the interface array.

Parameters

Table 222. temu_ifaceRefArrayPush Parameters
Parameter Type Description

Arr

temu_IfaceRefArray *

The interface reference array

Iface

temu_IfaceRef

The interface reference (object-interface pointer pair)

temu_ifaceRefArrayPush2

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_ifaceRefArrayPush2(temu_IfaceRefArray * Arr, temu_Object * Obj, void * Iface)

Description

Push an object and raw interface pointer to an interface array.

Parameters

Table 223. temu_ifaceRefArrayPush2 Parameters
Parameter Type Description

Arr

temu_IfaceRefArray *

The interface reference array.

Obj

temu_Object *

The object implementing the relevant interface

Iface

void *

Pointer to the interface struct.

temu_ifaceRefArraySize

Include

#include "temu-c/Support/Objsys.h"

Signature

unsigned int temu_ifaceRefArraySize(temu_IfaceRefArray * Arr)

Description

Get the length of a dynamically allocated interface array.

Result

The length in number of entries.

Parameters

Table 224. temu_ifaceRefArraySize Parameters
Parameter Type Description

Arr

temu_IfaceRefArray *

The interface array to get the size from.

temu_imageIsELF

Include

#include "temu-c/Support/Loader.h"

Signature

int temu_imageIsELF(const char * file)

Description

Return non-zero if file is an ELF file

Result

0 if file is not an ELF file, 1 if the file is an ELF file.

Parameters

Table 225. temu_imageIsELF Parameters
Parameter Type Description

file

const char *

Path to file to check for ELFiness.

temu_indexForInterface

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_indexForInterface(const temu_Object * Obj, const void * Iface)

Description

Get index for interface

Result

Index of interface if it is in an iface array. Otherwise it returns -1. Consequently the function only have valid result for interface arrays.

Parameters

Table 226. temu_indexForInterface Parameters
Parameter Type Description

Obj

const temu_Object *

Pointer to the object that contains the interface

Iface

const void *

Pointer to the interface

temu_initConfigDirs

Include

#include "temu-c/Support/Init.h"

Signature

void temu_initConfigDirs()

Description

Create the temu config directories (typically ~/.config/temu/)

This function is invoked by the init function normally, but it is useful in some cases to create the config dirs without calling init.

temu_initGdbServerLib

Include

#include "temu-c/GdbServer/GdbServer.h"

Signature

void temu_initGdbServerLib()

Description

Initialise the GDB Server Library

temu_initLicense

Include

#include "temu-c/Support/Init.h"

Signature

int temu_initLicense()

Description

Init only license system.

Initialise the license manager only. This can be used to check for whether the license is valid before proceeding with rest of the system initialisation. The function does not terminate the application on invalid license, but returns a non-zero value.

Result

0 if the license is valid, other values indicate errors.

temu_initPathSupport

Include

#include "temu-c/Support/Init.h"

Signature

void temu_initPathSupport(const char * Argv0)

Description

Initialise path finding support

This function initialises auxillary path support needed by TEMU for locating supporting tools (e.g. stuff in libexec) and automatically appending of scripting search paths.

In the future, this will likely be merged into initSupportLib for a unified init function, but this will break API compatibility, so this change is deferred to TEMU 3.

Call the Function passing Argv0 of whatever you would do to invoke the temu command line tool. E.g. if temu is in your path and this is the installation you wish to use, the parameter should be "temu". However, if you wish to use a custom installation, pass the full path to the temu program. The base path can contain ~ for the current home dir and ~foo for the home dir of user foo.

Note that it is not an error to omit this initialisation, but omitting it will imply that temu cannot launch UI models such as the ConsoleUI model.

Parameters

Table 227. temu_initPathSupport Parameters
Parameter Type Description

Argv0

const char *

Name of TEMU executable (typically passed as argv[0] to main)

temu_initSupportLib

Include

#include "temu-c/Support/Init.h"

Signature

void temu_initSupportLib()

Description

Initialisation of TEMU support library.

Call this function before any other use of TEMU. The function does not return failures, but halts on failed initialisation.

The function should be called as early as possible in the application’s execution. Preferably in the main function (though there is no strict requirement for this).

The initialisation function is at present not thread safe, call it in the main thread only!

temu_inlineDeserialiseJSON

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_inlineDeserialiseJSON(const char * FileName)

Description

De-serialise the simulation state.

This function directly restores properties on already created objects. It does not clear the objects system. Thus pointers to objects remains stable after a snapshot restore.

If a class implements the ObjectIface, the (optional) deserialise procedure will be called.

Result

0 on success, otherwise non-zero

Parameters

Table 228. temu_inlineDeserialiseJSON Parameters
Parameter Type Description

FileName

const char *

The filename that contains the JSON data

temu_isComponent

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_isComponent(const temu_Object * Obj)

Description

temu_isComponent Checks if an object is a component

Result

0 for false, non-zero for true

Parameters

Table 229. temu_isComponent Parameters
Parameter Type Description

Obj

const temu_Object *

The object to test

temu_isCpu

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_isCpu(const temu_Object * Obj)

Description

Predicate for identifying CPU classes. In release without assert builds this runs in O(1) time.

Result

0 for false, non-zero for true

Parameters

Table 230. temu_isCpu Parameters
Parameter Type Description

Obj

const temu_Object *

The object to test

temu_isDiscrete

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_isDiscrete(temu_Propval Pv)

Description

Checks whether the numeric property is an integer-like

Result

0 for false, non-zero for true

Parameters

Table 231. temu_isDiscrete Parameters
Parameter Type Description

Pv

temu_Propval

The property to be checked

temu_isMachine

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_isMachine(const temu_Object * Obj)

Description

Predicate for identifying CPU classes. In release without assert builds this runs in O(1) time..

Result

0 for false, non-zero for true

Parameters

Table 232. temu_isMachine Parameters
Parameter Type Description

Obj

const temu_Object *

The object to test

temu_isMemory

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_isMemory(const temu_Object * Obj)

Description

temu_isMemory Checks whether an object is a memory object

Result

0 for false, non-zero for true

Parameters

Table 233. temu_isMemory Parameters
Parameter Type Description

Obj

const temu_Object *

The object to test

temu_isNormalProperty

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_isNormalProperty(temu_Object * Obj, const char * PropName)

Description

temu_isNormalProperty Checks whether a property is a normal property (not a pseudo-property)

Result

0 for false, non-zero for true

Parameters

Table 234. temu_isNormalProperty Parameters
Parameter Type Description

Obj

temu_Object *

The object that contains the property

PropName

const char *

The property name

temu_isNumber

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_isNumber(temu_Propval Pv)

Description

Checks whether a property is a number

Result

0 for false, non-zero for true

Parameters

Table 235. temu_isNumber Parameters
Parameter Type Description

Pv

temu_Propval

The property to be checked

temu_isPow2_32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

int temu_isPow2_32(uint32_t Word)

Description

Predicate for checking if word is a power of 2 See Hacker’s Delight, 1st edition, p11

Result

0 for false, otherwise true

Parameters

Table 236. temu_isPow2_32 Parameters
Parameter Type Description

Word

uint32_t

The word to be checked

temu_isPow2_64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

int temu_isPow2_64(uint64_t Word)

Description

Predicate for checking if word is a power of 2

Result

0 for false, otherwise true

Parameters

Table 237. temu_isPow2_64 Parameters
Parameter Type Description

Word

uint64_t

The word to be checked

temu_isPseudoProperty

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_isPseudoProperty(temu_Object * Obj, const char * PropName)

Description

temu_isPseudoProperty Checks whether a property is a pseudo-property

Result

0 for false, non-zero for true

Parameters

Table 238. temu_isPseudoProperty Parameters
Parameter Type Description

Obj

temu_Object *

The object that contains the property

PropName

const char *

The property name

temu_isQualifiedAs

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_isQualifiedAs(const temu_Object * Obj, unsigned int Qualifier)

Description

temu_isQualifiedAs Check if an object is qualified as Qualifier

Result

0 for false, non-zero for true

Parameters

Table 239. temu_isQualifiedAs Parameters
Parameter Type Description

Obj

const temu_Object *

The object to be checked

Qualifier

unsigned int

The qualification to be checked

temu_isReal

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_isReal(temu_Propval Pv)

Description

Checks whether a property is a real number

Result

0 for false, non-zero for true

Parameters

Table 240. temu_isReal Parameters
Parameter Type Description

Pv

temu_Propval

The property to be checked

temu_isString

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_isString(temu_Propval Pv)

Description

Checks whether a property is a string

Result

0 for false, non-zero for true

Parameters

Table 241. temu_isString Parameters
Parameter Type Description

Pv

temu_Propval

The property to be checked

temu_isolateLeftmostBit32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_isolateLeftmostBit32(uint32_t Word)

Description

Isolate left most bit

Result

A copy of word, in which the right most set bit will be cleared

Parameters

Table 242. temu_isolateLeftmostBit32 Parameters
Parameter Type Description

Word

uint32_t

The word, in which the right most set bit will be cleared

temu_isolateLeftmostBit64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_isolateLeftmostBit64(uint64_t Word)

Description

Isolate left most bit

Result

A copy of word, in which the right most set bit will be cleared

Parameters

Table 243. temu_isolateLeftmostBit64 Parameters
Parameter Type Description

Word

uint64_t

The word, in which the right most set bit will be cleared

temu_isolateRightMostZeroBit32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_isolateRightMostZeroBit32(uint32_t Word)

Description

Isolate right most bit with value zero (it will be 1 in the result)

Result

A copy of Word, in which the right most bit with value zero will be isolated

Parameters

Table 244. temu_isolateRightMostZeroBit32 Parameters
Parameter Type Description

Word

uint32_t

The word, in which the right most bit with value zero will be isolated

temu_isolateRightMostZeroBit64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_isolateRightMostZeroBit64(uint64_t Word)

Description

Isolate right most bit with value zero (it will be 1 in the result)

Result

A copy of Word, in which the right most bit with value zero will be isolated

Parameters

Table 245. temu_isolateRightMostZeroBit64 Parameters
Parameter Type Description

Word

uint64_t

The word, in which the right most bit with value zero will be isolated

temu_lineDataGetLine

Include

#include "temu-c/Support/DataLoggers.h"

Signature

const char * temu_lineDataGetLine(void * Obj, uint64_t Line)

Description

Get line with number.

Result

A string that is borrowed.

Parameters

Table 246. temu_lineDataGetLine Parameters
Parameter Type Description

Obj

void *

Data-logging object

Line

uint64_t

Line number to read out

temu_lineDataGetLineCount

Include

#include "temu-c/Support/DataLoggers.h"

Signature

uint64_t temu_lineDataGetLineCount(void * Obj)

Description

Get number of lines in log.

Result

Number of logged lines

Parameters

Table 247. temu_lineDataGetLineCount Parameters
Parameter Type Description

Obj

void *

Data-logging object

temu_listAppend

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_listAppend(temu_List * List, temu_Propval Val)

Description

Add an element to the end of a linked-list

Parameters

Table 248. temu_listAppend Parameters
Parameter Type Description

List

temu_List *

The list, to which the element to be added

Val

temu_Propval

The element to be added

temu_listCreate

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_List temu_listCreate(temu_Type Typ)

Description

Create a linked-list object

Result

A newly created list.

Parameters

Table 249. temu_listCreate Parameters
Parameter Type Description

Typ

temu_Type

The type to be stored in the elements of the linked list

temu_listDispose

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_listDispose(temu_List * List)

Description

Delete a linked-list object

Parameters

Table 250. temu_listDispose Parameters
Parameter Type Description

List

temu_List *

The list to be deleted

temu_listGetHead

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_ListNode * temu_listGetHead(temu_List * List)

Description

Get the first element of a linked-list

Result

Pointer to the first element of the linked-list

Parameters

Table 251. temu_listGetHead Parameters
Parameter Type Description

List

temu_List *

The list, whose first element is requested

temu_listGetNext

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_ListNode * temu_listGetNext(temu_ListNode * Node)

Description

Get the next element of a linked list

Result

The next element if available, otherwise nullptr

Parameters

Table 252. temu_listGetNext Parameters
Parameter Type Description

Node

temu_ListNode *

The node, whose next element is requested

temu_listGetPrev

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_ListNode * temu_listGetPrev(temu_ListNode * Node)

Description

Get the previous element of a linked list

Result

The previous element if available, otherwise nullptr

Parameters

Table 253. temu_listGetPrev Parameters
Parameter Type Description

Node

temu_ListNode *

The node, whose next element is requested

temu_listGetTail

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_ListNode * temu_listGetTail(temu_List * List)

Description

Get the last element of a linked-list

Result

Pointer to the last element of the linked-list

Parameters

Table 254. temu_listGetTail Parameters
Parameter Type Description

List

temu_List *

The list, whose last element is requested

temu_listNodeGetVal

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Propval temu_listNodeGetVal(temu_ListNode * Node)

Description

Get value of a linked-list node

Result

The value extracted from the node

Parameters

Table 255. temu_listNodeGetVal Parameters
Parameter Type Description

Node

temu_ListNode *

The node, from which the value to be extracted

temu_listPrepend

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_listPrepend(temu_List * List, temu_Propval Val)

Description

Add an element to the beginning of a linked-list

Parameters

Table 256. temu_listPrepend Parameters
Parameter Type Description

List

temu_List *

The list, to which the element to be added

Val

temu_Propval

The element to be added

temu_listRemoveHead

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Propval temu_listRemoveHead(temu_List * List)

Description

Removes the first element of a linked-list

Result

The element that was removed from the list

Parameters

Table 257. temu_listRemoveHead Parameters
Parameter Type Description

List

temu_List *

The list, from which the first element to be removed

temu_listRemoveTail

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Propval temu_listRemoveTail(temu_List * List)

Description

Removes the last element of a linked-list

Result

The element that was removed from the list

Parameters

Table 258. temu_listRemoveTail Parameters
Parameter Type Description

List

temu_List *

The list, from which the last element to be removed

temu_loadBinaryImage

Include

#include "temu-c/Support/Loader.h"

Signature

int temu_loadBinaryImage(void * mem, const char * file, uint64_t pa)

Description

Loads a raw binary image to the memory object at the given address.

The function will assume that the file is a raw binary. This way you can load an ELF file as is to memory (e.g. where it is expected by the boot loader).

Result

0 on success, other values indicates errors.

Parameters

Table 259. temu_loadBinaryImage Parameters
Parameter Type Description

mem

void *

Memory object, must conform to the mem interface.

file

const char *

Path to file to load.

pa

uint64_t

Physical address where to load the image.

temu_loadElfImage

Include

#include "temu-c/Support/Loader.h"

Signature

int temu_loadElfImage(void * mem, const char * file, uint64_t pa)

Description

Loads an ELF file without going through filetype detection

Result

0 on success, other values indicates errors

Parameters

Table 260. temu_loadElfImage Parameters
Parameter Type Description

mem

void *

Memory object, must conform to the mem interface.

file

const char *

Path to file to load.

pa

uint64_t

Unused argument

temu_loadElfImageAndStartAddr

Include

#include "temu-c/Support/Loader.h"

Signature

int temu_loadElfImageAndStartAddr(void * Mem, const char * FileName, uint64_t * StartAddr)

Description

Loads an ELF file without going through filetype detection

Result

0 on success, 1 for successful load but without valid StartAddr, negative values indicate error.

Parameters

Table 261. temu_loadElfImageAndStartAddr Parameters
Parameter Type Description

Mem

void *

Memory object, must conform to the mem interface.

FileName

const char *

Path to file to load.

StartAddr

uint64_t *

Pointer where to place the start address of the elf file

temu_loadImage

Include

#include "temu-c/Support/Loader.h"

Signature

int temu_loadImage(void * mem, const char * file)

Description

Loads a binary image to the memory object.

The function will autodetect the file type (based on extensions and magic headers in the file).

Binary images will be placed at address 0.

The image can be one of the supported file formats.

Result

0 on success, other values indicates errors.

Parameters

Table 262. temu_loadImage Parameters
Parameter Type Description

mem

void *

Memory object, must conform to the mem interface.

file

const char *

Path to file to load.

temu_loadImageAndStartAddr

Include

#include "temu-c/Support/Loader.h"

Signature

int temu_loadImageAndStartAddr(void * Mem, const char * FileName, uint64_t * StartAddr)

Description

Loads a binary image to the memory object.

The function will autodetect the file type (based on extensions and magic headers in the file).

Binary images will be placed at address 0.

The image can be one of the supported file formats.

This specific variant, will return the start address of the binary, the StartAddr is typically embedded in the ELF or SREC files. The function therefore allows you to set the program counter to the correct start address after the function has been called.

Result

0 on success, 1 for successful load but without valid StartAddr, negative values indicate error.

Parameters

Table 263. temu_loadImageAndStartAddr Parameters
Parameter Type Description

Mem

void *

Memory object, must conform to the mem interface.

FileName

const char *

Path to file to load.

StartAddr

uint64_t *

Pointer to location to store the start address.

temu_loadPlugin

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_loadPlugin(const char * PluginName)

Description

Load a plugin. When a plugin is loaded the temu_pluginInit function will be called. This function should create and define any classes that the plugin provides.

The function loads plugins following the operating system’s loading rules. This means in particular that first, the plugin will be found in the RPATH location of libTEMUSupport (which refers to the TEMU lib directory). Secondly, it will look in the LD_LIBRARY_PATH and other standard load directories.

In practice, it will look for lib Plugin .so in the TEMU plugin paths, or libTEMU Plugin .so in the same paths. It will then fallback on attempting to load libTEMU Plugin .so from the system load paths. If the plugin name contains a slash '/' it will be treated as a path and not a plugin name.

Result

0 on success, non-zero otherwise.

Parameters

Table 264. temu_loadPlugin Parameters
Parameter Type Description

PluginName

const char *

A path or plugin name

temu_loadPluginGlobal

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_loadPluginGlobal(const char * PluginName)

Description

Load a plugin. When a plugin is loaded the temu_pluginInit function will be called. This function should create and define any classes that the plugin provides.

The plugin will be made available globally for the linker (e.g. using RTLD_GLOBAL).

This is not recommended for normal TEMU plugins.

The function loads plugins following the operating system’s loading rules. This means in particular that first, the plugin will be found in the RPATH location of libTEMUSupport (which refers to the TEMU lib directory). Secondly, it will look in the LD_LIBRARY_PATH and other standard load directories.

In practice, it will look for lib Plugin .so in the TEMU plugin paths, or libTEMU Plugin .so in the same paths. It will then fallback on attempting to load libTEMU Plugin .so from the system load paths. If the plugin name contains a slash '/' it will be treated as a path and not a plugin name.

Result

0 on success, non-zero otherwise.

Parameters

Table 265. temu_loadPluginGlobal Parameters
Parameter Type Description

PluginName

const char *

A path or plugin name

temu_loadSrecImage

Include

#include "temu-c/Support/Loader.h"

Signature

int temu_loadSrecImage(void * mem, const char * file, uint64_t pa)

Description

Loads an SREC file without going through filetype detection.

Result

0 on success, other values indicates errors

Parameters

Table 266. temu_loadSrecImage Parameters
Parameter Type Description

mem

void *

Memory object, must conform to the mem interface.

file

const char *

Path to file to load.

pa

uint64_t

Unused argument

temu_loadSrecImageAndStartAddr

Include

#include "temu-c/Support/Loader.h"

Signature

int temu_loadSrecImageAndStartAddr(void * mem, const char * fileName, uint32_t * startAddr)

Description

Loads an SREC file without going through filetype detection.

Result

0 on success, 1 for successful load but without valid StartAddr, negative values indicate error.

Parameters

Table 267. temu_loadSrecImageAndStartAddr Parameters
Parameter Type Description

mem

void *

Memory object, must conform to the mem interface.

fileName

const char *

Path to file to load.

startAddr

uint32_t *

Start address, will be set if result is 0

temu_loadSymtab

Include

#include "temu-c/Support/Loader.h"

Signature

int temu_loadSymtab(const char * FileName, temu_Symtab ** Sym)

Description

Loads the symbol table from a given ELF file.

The symbol table is allocated and the pointer of the allocated symbol table is placed in Sym. The user is responsible for disposing the symbol table with temu_disposeSymtab().

Result

0 on success, other values indicates errors.

Parameters

Table 268. temu_loadSymtab Parameters
Parameter Type Description

FileName

const char *

Name of ELF file

Sym

temu_Symtab **

Address of your symtab pointer.

temu_logConfigError

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logConfigError(const void * Obj, const char * Msg, ...)

Description

Log configuration error

Parameters

Table 269. temu_logConfigError Parameters
Parameter Type Description

Obj

const void *

Object

Msg

const char *

Printf formatted message string

temu_logConfigFatal

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logConfigFatal(const void * Obj, const char * Msg, ...)

Description

Log configuration fatal error

Parameters

Table 270. temu_logConfigFatal Parameters
Parameter Type Description

Obj

const void *

Object

Msg

const char *

Printf formatted message string

temu_logConfigInfo

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logConfigInfo(const void * Obj, const char * Msg, ...)

Description

Log configuration info

Parameters

Table 271. temu_logConfigInfo Parameters
Parameter Type Description

Obj

const void *

Object

Msg

const char *

Printf formatted message string

temu_logConfigWarning

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logConfigWarning(const void * Obj, const char * Msg, ...)

Description

Log configuration warning

Parameters

Table 272. temu_logConfigWarning Parameters
Parameter Type Description

Obj

const void *

Object

Msg

const char *

Printf formatted message string

temu_logDebugFunc

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logDebugFunc(const void * Obj, const char * Msg, ...)

Description

Log a message with debug severity

Parameters

Table 273. temu_logDebugFunc Parameters
Parameter Type Description

Obj

const void *

is the source of the log message

Msg

const char *

The message to log

temu_logError

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logError(const void * Obj, const char * Msg, ...)

Description

Log a message with error severity

Parameters

Table 274. temu_logError Parameters
Parameter Type Description

Obj

const void *

is the source of the log message

Msg

const char *

The message to log

temu_logFatal

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logFatal(const void * Obj, const char * Msg, ...)

Description

Log a message with fatal severity; The program will terminate after calling this

Parameters

Table 275. temu_logFatal Parameters
Parameter Type Description

Obj

const void *

is the source of the log message

Msg

const char *

The message to log

temu_logInfo

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logInfo(const void * Obj, const char * Msg, ...)

Description

Log a message with info severity

Parameters

Table 276. temu_logInfo Parameters
Parameter Type Description

Obj

const void *

is the source of the log message

Msg

const char *

The message to log

temu_logSetAdvancedFunc

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logSetAdvancedFunc(void (*)(void *, temu_Object *, unsigned int, temu_LogLevel, const char *) LogFunc, void * UserData)

Description

Set advanced logging function.

It is possible to provide a custom function for handling logging messages from TEMU. This can be used by a simulator that provides a centralized logging facility to also handle TEMU logging messages. By default, the messages will be printed to stderr using fputs.

The advanced logging function does not get messages with a terminating linefeed. In addition, the function receives the object, category and log level as its own parameters.

The message does not contain object name / time stamps. The integrator would be expected to extract the time stamp from the objects time source if set.

LogFunc will take the following parameters:

User data

Void pointer passed to UserData parameter (may be NULL).

Object pointer

Pointer to object issuing the log message (may be NULL).

Category

Category id of log message.

Log level

Severity of logging message.

Message

The log message, as a '

' terminated string.

Parameters

Table 277. temu_logSetAdvancedFunc Parameters
Parameter Type Description

LogFunc

void (*)(void *, temu_Object *, unsigned int, temu_LogLevel, const char *)

Logging function to use. NULL to restore the default.

UserData

void *

User data to pass to the logging functions first parameter.

temu_logSetColour

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logSetColour(int Enable)

Description

Enable colours on logging

Parameters

Table 278. temu_logSetColour Parameters
Parameter Type Description

Enable

int

0 to disable colours, 1 to enable

temu_logSetDefaultFile

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logSetDefaultFile(FILE * FP)

Description

Set the logging file for the default logging function. Pass NULL to restore default (stderr).

Parameters

Table 279. temu_logSetDefaultFile Parameters
Parameter Type Description

FP

FILE *

Logging file pointer, NULL to restore default.

temu_logSetFunc

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logSetFunc(void (*)(const char *) LogFunc)

Description

Set logging function.

It is possible to provide a custom function for handling logging messages from TEMU. This can be used by a simulator that provides a centralized logging facility to also handle TEMU logging messages. By default, the messages will be printed to stderr using fputs. Note that messages will be terminated by " n

", so if your logging system adds a linefeed, the message may need to be transformed.

Parameters

Table 280. temu_logSetFunc Parameters
Parameter Type Description

LogFunc

void (*)(const char *)

Logging function to use. NULL to restore the default.

temu_logSetLevel

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logSetLevel(temu_LogLevel LogLevel)

Description

Set logging level. Messages will be logged if they are of the set level or higher priority.

Parameters

Table 281. temu_logSetLevel Parameters
Parameter Type Description

LogLevel

temu_LogLevel

The logging level.

temu_logSetSeverity

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logSetSeverity(void * Obj, unsigned int Category, temu_LogLevel Severity)

Description

Set severity for specific category.

Parameters

Table 282. temu_logSetSeverity Parameters
Parameter Type Description

Obj

void *

Object for which to modify logging severity

Category

unsigned int

Category to change severity for (e.g. teLC_DefaultCat)

Severity

temu_LogLevel

The log level for which messages shall be emitted.

temu_logSimError

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logSimError(const void * Obj, const char * Msg, ...)

Description

Log simulation error

Parameters

Table 283. temu_logSimError Parameters
Parameter Type Description

Obj

const void *

Object

Msg

const char *

Printf formatted message string

temu_logSimFatal

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logSimFatal(const void * Obj, const char * Msg, ...)

Description

Log fatal issue Fatal messages result in termination of the program after the message.

Parameters

Table 284. temu_logSimFatal Parameters
Parameter Type Description

Obj

const void *

Object

Msg

const char *

Printf formatted message string

temu_logSimInfo

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logSimInfo(const void * Obj, const char * Msg, ...)

Description

Log simulation info

Parameters

Table 285. temu_logSimInfo Parameters
Parameter Type Description

Obj

const void *

Object

Msg

const char *

Printf formatted message string

temu_logSimWarning

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logSimWarning(const void * Obj, const char * Msg, ...)

Description

Log simulation warning

Parameters

Table 286. temu_logSimWarning Parameters
Parameter Type Description

Obj

const void *

Object

Msg

const char *

Printf formatted message string

temu_logTargetError

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logTargetError(const void * Obj, const char * Msg, ...)

Description

Log target error

Parameters

Table 287. temu_logTargetError Parameters
Parameter Type Description

Obj

const void *

Object

Msg

const char *

Printf formatted message string

temu_logTargetFatal

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logTargetFatal(const void * Obj, const char * Msg, ...)

Description

Log target fatal error This should typically never happen, but it may be convenient in some cases.

Parameters

Table 288. temu_logTargetFatal Parameters
Parameter Type Description

Obj

const void *

Object

Msg

const char *

Printf formatted message string

temu_logTargetInfo

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logTargetInfo(const void * Obj, const char * Msg, ...)

Description

Log target info

Parameters

Table 289. temu_logTargetInfo Parameters
Parameter Type Description

Obj

const void *

Object

Msg

const char *

Printf formatted message string

temu_logTargetWarning

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logTargetWarning(const void * Obj, const char * Msg, ...)

Description

Log target warning

Parameters

Table 290. temu_logTargetWarning Parameters
Parameter Type Description

Obj

const void *

Object

Msg

const char *

Printf formatted message string

temu_logToCategory

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logToCategory(const void * Obj, unsigned int Category, temu_LogLevel Severity, const char * Msg, ...)

Description

Log message in the numbered category

Parameters

Table 291. temu_logToCategory Parameters
Parameter Type Description

Obj

const void *

Object that is the source of the log message

Category

unsigned int

Category of message (e.g. teLC_DefaultCat)

Severity

temu_LogLevel

The log level for which the message shall be emitted.

Msg

const char *

Printf formatted message string.

temu_logTrace

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logTrace(const void * Obj, const char * Msg, ...)

Description

Log a message with trace severity

Parameters

Table 292. temu_logTrace Parameters
Parameter Type Description

Obj

const void *

is the source of the log message

Msg

const char *

The message to log

temu_logWarning

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_logWarning(const void * Obj, const char * Msg, ...)

Description

Log a message with warning severity

Parameters

Table 293. temu_logWarning Parameters
Parameter Type Description

Obj

const void *

is the source of the log message

Msg

const char *

The message to log

temu_machineReset

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_machineReset(void * Machine, int ResetType)

Description

Reset the Machine

Resetting the Machine will result in a reset cascade where all connected devices and processors are also reset.

Parameters

Table 294. temu_machineReset Parameters
Parameter Type Description

Machine

void *

The Machine object

ResetType

int

The type of reset, by convention 0 means cold reset, and 1 indicates a warm reset.

temu_machineRun

Include

#include "temu-c/Support/Cpu.h"

Signature

uint64_t temu_machineRun(void * Machine, uint64_t NanoSecs)

Description

Run the machine for a number of nanoseconds

The function runs the machine and for a number of nanoseconds. This will run all the CPUs in the system.

In case a processor halts or enters idle mode, the function returns early.

Result

The number of executed nanoseconds.

Parameters

Table 295. temu_machineRun Parameters
Parameter Type Description

Machine

void *

The machine object

NanoSecs

uint64_t

The number of nanosecs to run each processor for.

temu_mapMemorySpace

Include

#include "temu-c/Memory/Memory.h"

Signature

int temu_mapMemorySpace(void * Obj, uint64_t Addr, uint64_t Len, temu_Object * MemObj)

Description

Map memory object into address space

Result

Zero on success, other values indicates that the mapping failed

Parameters

Table 296. temu_mapMemorySpace Parameters
Parameter Type Description

Obj

void *

The memory space object

Addr

uint64_t

Physical address where to map the device

Len

uint64_t

Length in bytes of area where the object is mapped.

MemObj

temu_Object *

The memory object. This object must correspond to the MemAccessIface

temu_mapMemorySpaceFlags

Include

#include "temu-c/Memory/Memory.h"

Signature

int temu_mapMemorySpaceFlags(void * Obj, uint64_t Addr, uint64_t Len, temu_Object * MemObj, uint32_t Flags)

Description

Map memory object into address space with flags

Result

Zero on success, other values indicates that the mapping failed

Parameters

Table 297. temu_mapMemorySpaceFlags Parameters
Parameter Type Description

Obj

void *

The memory space object

Addr

uint64_t

Physical address where to map the device

Len

uint64_t

Length in bytes of area where the object is mapped.

MemObj

temu_Object *

The memory object. This object must correspond to the MemAccessIface

Flags

uint32_t

Sticky flags for memory accesses to that object (e.g. cachable)

temu_memoryClearAttr

Include

#include "temu-c/Support/Memory.h"

Signature

void temu_memoryClearAttr(void * Obj, uint64_t Addr, uint64_t Len, temu_MemoryAttr Attr)

Description

Clears an attribute on the given memory range

Parameters

Table 298. temu_memoryClearAttr Parameters
Parameter Type Description

Obj

void *

Memory space object

Addr

uint64_t

Physical address of start

Len

uint64_t

Length of memory range

Attr

temu_MemoryAttr

Attribute to clear

temu_memoryGetAttrs

Include

#include "temu-c/Support/Memory.h"

Signature

temu_MemoryAttrs temu_memoryGetAttrs(void * Obj, uint64_t Addr)

Description

Get memory attributes for address

Result

Memory attributes for the address

Parameters

Table 299. temu_memoryGetAttrs Parameters
Parameter Type Description

Obj

void *

Memory space

Addr

uint64_t

Physical addres

temu_memoryInstallTrampoline

Include

#include "temu-c/Support/Memory.h"

Signature

int temu_memoryInstallTrampoline(void * Obj, uint64_t Addr, void (*)(void *) Tramp)

Description

Install trampoline function in PDC cache

Result

0 on success

Parameters

Table 300. temu_memoryInstallTrampoline Parameters
Parameter Type Description

Obj

void *

Memory space

Addr

uint64_t

Physical address

Tramp

void (*)(void *)

Trampoline function, takes CPU pointer as first argument.

temu_memoryMap

Include

#include "temu-c/Support/Memory.h"

Signature

int temu_memoryMap(void * Obj, uint64_t Addr, uint64_t Len, void * MemObj, uint32_t Flags)

Description

temu_memoryMap Maps an object into a memory space. The object must have an interface named MemAccessIface, of the type defined as TEMU_MEM_ACCESS_IFACE_TYPE

Result

Zero on success

Parameters

Table 301. temu_memoryMap Parameters
Parameter Type Description

Obj

void *

is the memory space object

Addr

uint64_t

the physical address

Len

uint64_t

the length in bytes

MemObj

void *

is the object that is mapped into the memory space it needs to be of a class that follows the rules above

Flags

uint32_t

are flags that are copied into the memory transaction object’s flag field when a transaction reaches an object

temu_memoryMapNamedIface

Include

#include "temu-c/Support/Memory.h"

Signature

int temu_memoryMapNamedIface(void * Obj, uint64_t Addr, uint64_t Len, void * MemObj, const char * IfaceName, uint32_t Flags)

Description

temu_memoryMapNamedIface Maps an object into a memory space using the named memory access interface. The interface named by IfaceName must be of the type TEMU_MEM_ACCESS_IFACE_TYPE

Result

Zero on success

Parameters

Table 302. temu_memoryMapNamedIface Parameters
Parameter Type Description

Obj

void *

is the memory space object

Addr

uint64_t

the physical address

Len

uint64_t

the length in bytes

MemObj

void *

is the object that is mapped into the memory space it needs to be of a class that follows the rules above

IfaceName

const char *

Name of the memory access interface

Flags

uint32_t

are flags that are copied into the memory transaction object’s flag field when a transaction reaches an object

temu_memoryRead

Include

#include "temu-c/Support/Memory.h"

Signature

int temu_memoryRead(void * mem, uint8_t * buff, uint64_t addr, uint32_t size, int swap)

Description

Read block of data via memory block transfer interfaces

Result

Negative on failures. Other values indicate success. The convention is to return the number of bytes read which should be == size.

Parameters

Table 303. temu_memoryRead Parameters
Parameter Type Description

mem

void *

Pointer to memory space object

buff

uint8_t *

The buffer to which the memory should be stored

addr

uint64_t

The address of the memory block to be read

size

uint32_t

The size to be read

swap

int

setting this to 0 indicates reading a byte array, 1 a uint16 array, 2 a uint32 array and 3 a uint64 array

temu_memoryReadData

Include

#include "temu-c/Support/Memory.h"

Signature

int temu_memoryReadData(void * obj, uint64_t addr, uint8_t * buff, unsigned int unitSize, uint32_t size, unsigned int flags)

Description

Read block of data via large memory transactions.

Result

Negative on failures. Other values indicate success.

Parameters

Table 304. temu_memoryReadData Parameters
Parameter Type Description

obj

void *

Memory space object

addr

uint64_t

Physical address inside memory space

buff

uint8_t *

Data buffer

unitSize

unsigned int

Log size of transaction unit size (0 = u8, 1 = u16, 2 = u32, 3 = u64)

size

uint32_t

Number of units to transfer

flags

unsigned int

Memory transaction flags (e.g. TEMU_MT_LITTLE_ENDIAN)

temu_memoryReadPhys16

Include

#include "temu-c/Support/Memory.h"

Signature

int temu_memoryReadPhys16(void * Obj, uint64_t Addr, uint16_t * Word)

Description

Issue a big endian memory read transaction (without initiator)

Result

0 on success, other values imply failure and will not update the word.

Parameters

Table 305. temu_memoryReadPhys16 Parameters
Parameter Type Description

Obj

void *

Memory space

Addr

uint64_t

Physical address

Word

uint16_t *

16 bit word that is read

temu_memoryReadPhys16Little

Include

#include "temu-c/Support/Memory.h"

Signature

int temu_memoryReadPhys16Little(void * Obj, uint64_t Addr, uint16_t * Word)

Description

Issue a little endian memory read transaction (without initiator)

Result

0 on success, other values imply failure and will not update the word.

Parameters

Table 306. temu_memoryReadPhys16Little Parameters
Parameter Type Description

Obj

void *

Memory space

Addr

uint64_t

Physical address

Word

uint16_t *

16 bit word that is read

temu_memoryReadPhys32

Include

#include "temu-c/Support/Memory.h"

Signature

int temu_memoryReadPhys32(void * Obj, uint64_t Addr, uint32_t * Word)

Description

Issue a big endian memory read transaction (without initiator)

Result

0 on success, other values imply failure and will not update the word.

Parameters

Table 307. temu_memoryReadPhys32 Parameters
Parameter Type Description

Obj

void *

Memory space

Addr

uint64_t

Physical address

Word

uint32_t *

32 bit word that is read

temu_memoryReadPhys32Little

Include

#include "temu-c/Support/Memory.h"

Signature

int temu_memoryReadPhys32Little(void * Obj, uint64_t Addr, uint32_t * Word)

Description

Issue a little endian memory read transaction (without initiator)

Result

0 on success, other values imply failure and will not update the word.

Parameters

Table 308. temu_memoryReadPhys32Little Parameters
Parameter Type Description

Obj

void *

Memory space

Addr

uint64_t

Physical address

Word

uint32_t *

32 bit word that is read

temu_memorySetAttr

Include

#include "temu-c/Support/Memory.h"

Signature

void temu_memorySetAttr(void * Obj, uint64_t Addr, uint64_t Len, temu_MemoryAttr Attr)

Description

Sets an attribute on the given memory range

Parameters

Table 309. temu_memorySetAttr Parameters
Parameter Type Description

Obj

void *

Memory space object

Addr

uint64_t

Physical address of start

Len

uint64_t

Length of memory range

Attr

temu_MemoryAttr

Attribute to set

temu_memoryWrite

Include

#include "temu-c/Support/Memory.h"

Signature

int temu_memoryWrite(void * mem, uint64_t addr, uint8_t * buff, uint32_t size, int swap)

Description

Write block of data via memory block transfer interfaces

Result

Negative on failure. Other values indicate success. The convention is to return the number of bytes written, which should be == size.

Parameters

Table 310. temu_memoryWrite Parameters
Parameter Type Description

mem

void *

Pointer to memory space object

buff

uint8_t *

The buffer to which the memory should be stored

addr

uint64_t

The address, at which the write should be done

size

uint32_t

The size to be read

swap

int

Negative on failures. Other values indicate success.

temu_memoryWriteData

Include

#include "temu-c/Support/Memory.h"

Signature

int temu_memoryWriteData(void * obj, uint64_t addr, const uint8_t * buff, unsigned int unitSize, uint32_t size, unsigned int flags)

Description

Write block of data via large memory transactions.

Result

Negative on failures. Other values indicate success.

Parameters

Table 311. temu_memoryWriteData Parameters
Parameter Type Description

obj

void *

Memory space object

addr

uint64_t

Physical address inside memory space

buff

const uint8_t *

Data buffer

unitSize

unsigned int

Log size of transaction unit size (0 = u8, 1 = u16, 2 = u32, 3 = u64)

size

uint32_t

Number of units to transfer

flags

unsigned int

Memory transaction flags (e.g. TEMU_MT_LITTLE_ENDIAN)

temu_memoryWritePhys32

Include

#include "temu-c/Support/Memory.h"

Signature

int temu_memoryWritePhys32(void * Obj, uint64_t Addr, uint32_t Word)

Description

Issue a big endian memory write transaction (without initiator)

Result

0 on success

Parameters

Table 312. temu_memoryWritePhys32 Parameters
Parameter Type Description

Obj

void *

Memory space

Addr

uint64_t

Physical address

Word

uint32_t

32 bit word to write

temu_memoryWritePhys32Little

Include

#include "temu-c/Support/Memory.h"

Signature

int temu_memoryWritePhys32Little(void * Obj, uint64_t Addr, uint32_t Word)

Description

Issue a little endian memory write transaction (without initiator)

Result

0 on success

Parameters

Table 313. temu_memoryWritePhys32Little Parameters
Parameter Type Description

Obj

void *

Memory space

Addr

uint64_t

Physical address

Word

uint32_t

32 bit word to write

temu_nameForClass

Include

#include "temu-c/Support/Objsys.h"

Signature

const char * temu_nameForClass(temu_Class * Cls)

Description

temu_nameForClass Get the class name from its object

Result

The name of the class as a C-string

Parameters

Table 314. temu_nameForClass Parameters
Parameter Type Description

Cls

temu_Class *

Pointer to the object of the class in question

temu_nameForInterface

Include

#include "temu-c/Support/Objsys.h"

Signature

const char * temu_nameForInterface(const temu_Object * Obj, const void * Iface)

Description

Get name for interface

Result

The name of the interface as C-string

Parameters

Table 315. temu_nameForInterface Parameters
Parameter Type Description

Obj

const temu_Object *

Pointer to the object that contains the interface

Iface

const void *

Pointer to the interface

temu_nameForObject

Include

#include "temu-c/Support/Objsys.h"

Signature

const char * temu_nameForObject(const temu_Object * Obj)

Description

Get the name of an object

Result

Name of the object as C-string

Parameters

Table 316. temu_nameForObject Parameters
Parameter Type Description

Obj

const temu_Object *

Pointer to the object

temu_nanosToCycles

Include

#include "temu-c/Support/Time.h"

Signature

int64_t temu_nanosToCycles(int64_t Nanos, int64_t Freq)

Description

Convert nanoseconds to cycles

This function truncates the result in case of non-exact conversion.

Result

Nanoseconds converted to cycles

Parameters

Table 317. temu_nanosToCycles Parameters
Parameter Type Description

Nanos

int64_t

Nanoseconds to convert

Freq

int64_t

Frequency in Hz

temu_nanosToCyclesRoundedUp

Include

#include "temu-c/Support/Time.h"

Signature

int64_t temu_nanosToCyclesRoundedUp(int64_t Nanos, int64_t Freq)

Description

Convert nanoseconds to cycles rounded upwards

This function rounds up the result in case of non-exact conversion.

Result

Nanoseconds converted to cycles

Parameters

Table 318. temu_nanosToCyclesRoundedUp Parameters
Parameter Type Description

Nanos

int64_t

Nanoseconds to convert

Freq

int64_t

Frequency in Hz

temu_nanosToSecs

Include

#include "temu-c/Support/Time.h"

Signature

double temu_nanosToSecs(int64_t Nanos)

Description

Convert nanoseconds to seconds

Result

Nanoseconds converted to seconds

Parameters

Table 319. temu_nanosToSecs Parameters
Parameter Type Description

Nanos

int64_t

Nanoseconds to convert

temu_normaliseRead16

Include

#include "temu-c/Support/Memory.h"

Signature

uint16_t temu_normaliseRead16(uint16_t Value, int Sz, int Off)

Description

Normalise a value for reads where only 16 bit transactions are supported by the device model, but the target is allowed to read non-16 bit quantities.

Given a 32 bit register value, the function extracts the bits from it that was actually requested.

Result

Parameters

Table 320. temu_normaliseRead16 Parameters
Parameter Type Description

Value

uint16_t

Register value

Sz

int

Size in log number of bytes (0 or 1)

Off

int

Offset in bytes within the 32 bit word of the transaction (0 or 2)

temu_normaliseRead32

Include

#include "temu-c/Support/Memory.h"

Signature

uint32_t temu_normaliseRead32(uint32_t Value, int Sz, int Off)

Description

Normalise a value for reads where only 32 bit transactions are supported by the device model, but the target is allowed to read non-32 bit quantities.

Given a 32 bit register value, the function extracts the bits from it that was actually requested.

Result

Parameters

Table 321. temu_normaliseRead32 Parameters
Parameter Type Description

Value

uint32_t

Register value

Sz

int

Size in log number of bytes (0, 1, or 2)

Off

int

Offset in bytes within the 32 bit word of the transaction (0-3)

temu_normaliseWrite16

Include

#include "temu-c/Support/Memory.h"

Signature

uint16_t temu_normaliseWrite16(uint16_t OldVal, uint16_t NewVal, int Sz, int Off)

Description

Normalise a value for writes where only 16 bit transactions are supported by the device model, but the target is allowed to write non-16 bit quantity. The function mixes the old register value with the new one based on the size and offset parameter. The problem exists because the memory access interface has a value entry, which always ends up in the lower bits, so if we write to the higher bits in in a 16 bit register, then by just forwarding the the value as is to the write handler, will result in a write of the lower bits and a clear of the upper bits (for a store unsigned).

Thus a normalisation is neded where we mix the written word with the old bits. So for transaction size of 8, and an offset of8, the resulting word is (old

0x00ff) | (new

8)

Result

Parameters

Table 322. temu_normaliseWrite16 Parameters
Parameter Type Description

OldVal

uint16_t

Old regiseter value.

NewVal

uint16_t

Content in memory transaction (new value).

Sz

int

Size in log number of bytes

Off

int

Offset in bytes within the 16 bit word of the transaction.

temu_normaliseWrite32

Include

#include "temu-c/Support/Memory.h"

Signature

uint32_t temu_normaliseWrite32(uint32_t OldVal, uint32_t NewVal, int Sz, int Off)

Description

Normalise a value for writes where only 32 bit transactions are supported by the device model, but the target is allowed to write non-32 bit quantity. The function mixes the old register value with the new one based on the size and offset parameter. The problem exists because the memory access interface has a value entry, which always ends up in the lower bits, so if we write to the higher bits in in a 32 bit register, then by just forwarding the the value as is to the write handler, will result in a write of the lower bits and a clear of the upper bits (for a store unsigned).

Thus a normalisation is needed where we mix the written word with the old bits. So for transaction size of 16, and an offset of 16, the resulting word is (old

0x0000ffff) | (new

16)

Result

Parameters

Table 323. temu_normaliseWrite32 Parameters
Parameter Type Description

OldVal

uint32_t

Old regiseter value.

NewVal

uint32_t

Content in memory transaction (new value).

Sz

int

Size in log number of bytes

Off

int

Offset in bytes within the 32 bit word of the transaction.

temu_notify

Include

#include "temu-c/Support/Notifications.h"

Signature

void temu_notify(int64_t Id, void * NotInfo)

Description

Call event subscriber, EvInfo is a per event specific struct the event handler must cast this to the appropriate type.

Parameters

Table 324. temu_notify Parameters
Parameter Type Description

Id

int64_t

Notification ID

NotInfo

void *

Ponter to pass to notification handlers

temu_notifyFast

Include

#include "temu-c/Support/Notifications.h"

Signature

void temu_notifyFast(int64_t * Id, void * NotInfo)

Description

Quick inline call macro that do not call the function for an invalid event id. This saves the function call to the notify function, minimising the cost for unset event handlers.

Parameters

Table 325. temu_notifyFast Parameters
Parameter Type Description

Id

int64_t *

Notification ID

NotInfo

void *

Pointer to pass to notification handlers

temu_objectForName

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Object * temu_objectForName(const char * Name)

Description

Get object for name

Result

Pointer to the object

Parameters

Table 326. temu_objectForName Parameters
Parameter Type Description

Name

const char *

The name of the object

temu_objectGetLogLevel

Include

#include "temu-c/Support/Logging.h"

Signature

temu_LogLevel temu_objectGetLogLevel(void * Obj, unsigned int Category)

Description

Get object specific logging level for category

Result

Logging level for the given Category

Parameters

Table 327. temu_objectGetLogLevel Parameters
Parameter Type Description

Obj

void *

Object

Category

unsigned int

Category

temu_objectHasCmd

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_objectHasCmd(const temu_Object * Obj, const char * CmdName)

Description

Check if object has a command

Result

0 in case command does not exist. Otherwise 1.

Parameters

Table 328. temu_objectHasCmd Parameters
Parameter Type Description

Obj

const temu_Object *

Object pointer

CmdName

const char *

Name of command

temu_objectHasIface

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_objectHasIface(const temu_Object * Obj, const char * IfaceName)

Description

Check if the object has a named interface

Result

0 if the interface does not exist, otherwise the interface exists

Parameters

Table 329. temu_objectHasIface Parameters
Parameter Type Description

Obj

const temu_Object *

Pointer to the object to query

IfaceName

const char *

Interface name to look for

temu_objectHasProp

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_objectHasProp(const temu_Object * Obj, const char * PropName)

Description

Check if the object has a named property

Result

0 if the property does not exist, otherwise the property is valid

Parameters

Table 330. temu_objectHasProp Parameters
Parameter Type Description

Obj

const temu_Object *

Pointer to the object of the property

PropName

const char *

Name of the property

temu_objectInvokeCmd

Include

#include "temu-c/Support/CommandLine.h"

Signature

int temu_objectInvokeCmd(temu_Object * Obj, void * I, const char * Name, int Argc, temu_CmdArg * Argv)

Description

Invoke command on object

Result

Command result. 0 means success.

Parameters

Table 331. temu_objectInvokeCmd Parameters
Parameter Type Description

Obj

temu_Object *

Object

I

void *

Interpreter context

Name

const char *

Name of command

Argc

int

Number of arguments

Argv

temu_CmdArg *

Argument vector

temu_objectSetLogLevel

Include

#include "temu-c/Support/Logging.h"

Signature

void temu_objectSetLogLevel(void * Obj, unsigned int Category, temu_LogLevel LogLevel)

Description

Set object specific logging level for category

Parameters

Table 332. temu_objectSetLogLevel Parameters
Parameter Type Description

Obj

void *

Object

Category

unsigned int

Category

LogLevel

temu_LogLevel

Level to set for the given Category

temu_objsysClear

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_objsysClear()

Description

Erase all classes, interfaces, properties and objects registered in the object system.

temu_objsysClearObjects

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_objsysClearObjects()

Description

Erase all objects, but do not delete classes.

temu_parity32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

int temu_parity32(uint32_t Word)

Description

Compute parity of word

Result

The parity of the word

Parameters

Table 333. temu_parity32 Parameters
Parameter Type Description

Word

uint32_t

The word, in which parity to be computed

temu_parity64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

int temu_parity64(uint64_t Word)

Description

Compute parity

Result

The parity of word

Parameters

Table 334. temu_parity64 Parameters
Parameter Type Description

Word

uint64_t

The word, in which parity to be computed

temu_parseCommandLineOptions

Include

#include "temu-c/Support/CommandLine.h"

Signature

int temu_parseCommandLineOptions(int argc, const char ** argv)

Description

Parses command line options The TEMU command supports a number of built in command line options. A simulator embedding TEMU may want initialise these options in the same way that the TEMU CLI does. Note that not all options are supported this way as some options will only be registered by the temu CLI application itself.

In general interactive options will not work (options that can be interpreted as a command). It is possible to use temu_printCommandLineHelp() to list currently registered options from an application that embedds temu.

Result

0 on success, otherwise non-zero value.

Parameters

Table 335. temu_parseCommandLineOptions Parameters
Parameter Type Description

argc

int

Number of arguments

argv

const char **

Command line arguments

temu_pluginPathAppend

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_pluginPathAppend(const char * Path)

Description

temu_pluginPathAppend Add a path to the list of paths, where T-emu searches for plugins

Parameters

Table 336. temu_pluginPathAppend Parameters
Parameter Type Description

Path

const char *

The path to append

temu_pluginPathPrint

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_pluginPathPrint()

Description

temu_pluginPathPrint Print the list of paths, where T-emu searches for plugins

temu_pluginPathRemove

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_pluginPathRemove(const char * Path)

Description

temu_pluginPathRemove Remove a path from the list of paths, where T-emu searches for plugins

Parameters

Table 337. temu_pluginPathRemove Parameters
Parameter Type Description

Path

const char *

to remove

temu_popcount32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

int temu_popcount32(uint32_t Word)

Description

Count number of bits set in word

Result

The number of bits

Parameters

Table 338. temu_popcount32 Parameters
Parameter Type Description

Word

uint32_t

The word, in which bits to be counted

temu_popcount64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

int temu_popcount64(uint64_t Word)

Description

Count count number of bit set

Result

The number of bits set in Word

Parameters

Table 339. temu_popcount64 Parameters
Parameter Type Description

Word

uint64_t

The word, in which bits to be counted

temu_postCallback

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_postCallback(void * Obj, temu_SafeCb Cb, void * Arg)

Description

Post a callback in a time source

The posting will be thread-safe and the callback will be excuted by the main thread (the one calling the cpu or machine run / step functions). The main thread is the thread calling cpu run if there is only a single cpu in the system, and the thread calling machine run if there are multiple CPUs in the system.

The callback will be executed as soon as possible, when the even queue is checked for events. Which in practice mean:

  • At the end of the current time quanta for multi-cpu systems.

  • At regular intervals for single CPU systems (a CPU runs a null-event periodically. Note that the callback will be called as soon as either a normal or the null event is executed.

The posting of this callback is thread-safe but not async / signal safe. I.e. do not do this from signal handler or async io callbacks.

When the event is executed, it is safe to do most emulator operations, including posting of events, calling API functions, etc.

The callback must however not:

  • Manipulate the object system meta state (i.e. creating or modifying classes)

  • Replace signal handlers (e.g. SIGINT)

  • Run or step the emulator in any way (e.g. by calling machineRun(), cpuRun() or using the CpuIface or MachineIface interfaces.

Parameters

Table 340. temu_postCallback Parameters
Parameter Type Description

Obj

void *

Time source

Cb

temu_SafeCb

Callback

Arg

void *

Argument passed to callback

temu_ppcClearAddressReservation

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_ppcClearAddressReservation(void * Cpu)

Description

Clear the PowerPC reserve address used by lwarx and stwcx

Parameters

Table 341. temu_ppcClearAddressReservation Parameters
Parameter Type Description

Cpu

void *

Processor pointer

temu_ppcGetCrReg

Include

#include "temu-c/Support/Cpu.h"

Signature

uint32_t temu_ppcGetCrReg(void * Cpu)

Description

Get the PowerPC CR register

Result

CR value

Parameters

Table 342. temu_ppcGetCrReg Parameters
Parameter Type Description

Cpu

void *

Processor pointer

temu_ppcGetCtrReg

Include

#include "temu-c/Support/Cpu.h"

Signature

uint32_t temu_ppcGetCtrReg(void * Cpu)

Description

Get the PowerPC CTR register

Result

The CTR value

Parameters

Table 343. temu_ppcGetCtrReg Parameters
Parameter Type Description

Cpu

void *

Processor pointer

temu_ppcGetFpscrReg

Include

#include "temu-c/Support/Cpu.h"

Signature

uint32_t temu_ppcGetFpscrReg(void * Cpu)

Description

Get the PowerPC FPSCR register

Result

The FPSCR value

Parameters

Table 344. temu_ppcGetFpscrReg Parameters
Parameter Type Description

Cpu

void *

Processor pointer

temu_ppcGetLrReg

Include

#include "temu-c/Support/Cpu.h"

Signature

uint64_t temu_ppcGetLrReg(void * Cpu)

Description

Get the PowerPC LR register

Result

The LR value

Parameters

Table 345. temu_ppcGetLrReg Parameters
Parameter Type Description

Cpu

void *

Processor pointer

temu_ppcGetMsrReg

Include

#include "temu-c/Support/Cpu.h"

Signature

uint64_t temu_ppcGetMsrReg(void * Cpu)

Description

Get the PowerPC MSR register

Result

MSR value

Parameters

Table 346. temu_ppcGetMsrReg Parameters
Parameter Type Description

Cpu

void *

Processor pointer

temu_ppcGetReserveAddress

Include

#include "temu-c/Support/Cpu.h"

Signature

uint64_t temu_ppcGetReserveAddress(void * Cpu)

Description

Get the PowerPC reserve address used by lwarx and stwcx

Result

The reserved address value

Parameters

Table 347. temu_ppcGetReserveAddress Parameters
Parameter Type Description

Cpu

void *

Processor pointer

temu_ppcGetXerReg

Include

#include "temu-c/Support/Cpu.h"

Signature

uint32_t temu_ppcGetXerReg(void * Cpu)

Description

Get the PowerPC XER register

Result

XER value

Parameters

Table 348. temu_ppcGetXerReg Parameters
Parameter Type Description

Cpu

void *

Processor pointer

temu_ppcIsReservationBitSet

Include

#include "temu-c/Support/Cpu.h"

Signature

int temu_ppcIsReservationBitSet(void * Cpu)

Description

Check if PowerPC reserve address is set lwarx and stwcx

Result

1 if reservation is set, 0 if cleared.

Parameters

Table 349. temu_ppcIsReservationBitSet Parameters
Parameter Type Description

Cpu

void *

Processor pointer

temu_ppcSetCrReg

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_ppcSetCrReg(void * Cpu, uint32_t Value)

Description

Set the PowerPC CR register

Parameters

Table 350. temu_ppcSetCrReg Parameters
Parameter Type Description

Cpu

void *

Processor pointer

Value

uint32_t

New CR value

temu_ppcSetCtrReg

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_ppcSetCtrReg(void * Cpu, uint32_t Value)

Description

Set the PowerPC CTR register

Parameters

Table 351. temu_ppcSetCtrReg Parameters
Parameter Type Description

Cpu

void *

Processor pointer

Value

uint32_t

New CTR value

temu_ppcSetFpscrReg

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_ppcSetFpscrReg(void * Cpu, uint32_t Value)

Description

Set the PowerPC FPSCR register

Parameters

Table 352. temu_ppcSetFpscrReg Parameters
Parameter Type Description

Cpu

void *

Processor pointer

Value

uint32_t

New FPSCR value

temu_ppcSetLrReg

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_ppcSetLrReg(void * Cpu, uint64_t Value)

Description

Set the PowerPC LR register

Parameters

Table 353. temu_ppcSetLrReg Parameters
Parameter Type Description

Cpu

void *

Processor pointer

Value

uint64_t

New LR value

temu_ppcSetMsrReg

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_ppcSetMsrReg(void * Cpu, uint64_t Value)

Description

Set the PowerPC MSR register

Parameters

Table 354. temu_ppcSetMsrReg Parameters
Parameter Type Description

Cpu

void *

Processor pointer

Value

uint64_t

New MSR value

temu_ppcSetReserveAddress

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_ppcSetReserveAddress(void * Cpu, uint64_t reserveAddress)

Description

Set the PowerPC reserve address used by lwarx and stwcx

Parameters

Table 355. temu_ppcSetReserveAddress Parameters
Parameter Type Description

Cpu

void *

Processor pointer

reserveAddress

uint64_t

New reserved address value

temu_ppcSetXerReg

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_ppcSetXerReg(void * Cpu, uint32_t Value)

Description

Set the PowerPC XER register

Parameters

Table 356. temu_ppcSetXerReg Parameters
Parameter Type Description

Cpu

void *

Processor pointer

Value

uint32_t

New XER value

temu_printCommandLineHelp

Include

#include "temu-c/Support/CommandLine.h"

Signature

void temu_printCommandLineHelp()

Description

Print command line help to temu stderr stream.

temu_printDiagnosticError

Include

#include "temu-c/Support/Console.h"

Signature

int temu_printDiagnosticError(const char * fileName, unsigned int line, unsigned int col, const char * fmt, ...)

Description

Print a diagnostic error

The function prints a message like "error: filename : line : col>

msg " "error: filename : line : msg " "error: filename : msg " "error: msg " Depending on whether fileName, line or col is set.

Result

length of the message

Parameters

Table 357. temu_printDiagnosticError Parameters
Parameter Type Description

fileName

const char *

Optional file name, set ton nullptr to skip

line

unsigned int

Optional line number, set to zero for no line number

col

unsigned int

Optional column number, set to zero for no column number

fmt

const char *

printf formatted string.

temu_printDiagnosticWarning

Include

#include "temu-c/Support/Console.h"

Signature

int temu_printDiagnosticWarning(const char * fileName, unsigned int line, unsigned int col, const char * fmt, ...)

Description

Print a diagnostic warning

The function prints a message like "warning: filename : line : col>

msg " "warning: filename : line : msg " "warning: filename : msg " "warning: msg " Depending on whether fileName, line or col is set.

Result

length of the message

Parameters

Table 358. temu_printDiagnosticWarning Parameters
Parameter Type Description

fileName

const char *

Optional file name, set ton nullptr to skip

line

unsigned int

Optional line number, set to zero for no line number

col

unsigned int

Optional column number, set to zero for no column number

fmt

const char *

printf formatted string.

temu_printerr

Include

#include "temu-c/Support/Console.h"

Signature

int temu_printerr(const char * Fmt, ...)

Description

fprintf(stderr, …​) wrapper. The function prints a formatted message to what TEMU considers to be the standard error. This function respects internal rerouting rules. Unlike plain fprintf, which writes to an explicit file.

The function is limited in that it keeps a local fixed length buffer for printing. This buffer is currently 1024 bytes, hence it is not possible to print messages longer than 1023 bytes.

Result

Number of bytes written

temu_printf

Include

#include "temu-c/Support/Console.h"

Signature

int temu_printf(const char * Fmt, ...)

Description

Printf wrapper. The function prints a formatted message to what TEMU considers to be the standard output. This function respects internal rerouting rules. Unlike plain printf, which writes only to stdout.

The function is limited in that it keeps a local fixed length buffer for printing. This buffer is 1024 bytes, hence it is not possible to print messages longer than 1023 bytes.

Result

Number of bytes written

temu_propInfoForClass

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_propInfoForClass(temu_Class * Cls, unsigned int PIIndex, unsigned int PICount, temu_PropInfo * PI)

Description

Get property info for class

It is possible to extract low level property info data using this function. This can be useful if integrating in another simulator or if integrating the system in e.g. a GUI in which you need to provide object introspection.

The function can be called with the PI array set to NULL to return the number of properties in the class.

You can read out all property fields using the following sequence:

Result

Number of read PI entries. In case PI is NULL, the total number of PIs for the class.

Parameters

Table 359. temu_propInfoForClass Parameters
Parameter Type Description

Cls

temu_Class *

The class to inspect

PIIndex

unsigned int

The property index to read from.

PICount

unsigned int

Size of PI array in number of entries.

PI

temu_PropInfo *

Pointer to an array of prop info objects to fill in.

temu_propagateRightMostBit32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_propagateRightMostBit32(uint32_t Word)

Description

Propagate the right most set bit to the bits below it

Result

Word with lower zero-bits set

Parameters

Table 360. temu_propagateRightMostBit32 Parameters
Parameter Type Description

Word

uint32_t

Word to propagate bits

temu_propagateRightMostBit64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_propagateRightMostBit64(uint64_t Word)

Description

Propagate the right most set bit to the bits below it

Result

Word with lower zero-bits set

Parameters

Table 361. temu_propagateRightMostBit64 Parameters
Parameter Type Description

Word

uint64_t

Word to propagate bits

temu_publishNotification

Include

#include "temu-c/Support/Notifications.h"

Signature

int64_t temu_publishNotification(const char * NotName, temu_Object * Obj)

Description

Publish a notification source A notification source is identified by an event name and an object pointer

Result

Notification ID of the published event.

Parameters

Table 362. temu_publishNotification Parameters
Parameter Type Description

NotName

const char *

Name of the notification

Obj

temu_Object *

Pointer to the object

temu_qualifyAs

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_qualifyAs(temu_Class * Cls, unsigned int Qualifier)

Description

Bless the class so that the isQualified predicate returns 1. Qualifiers with the MSb cleared are reserved for TEMU internals.

Parameters

Table 363. temu_qualifyAs Parameters
Parameter Type Description

Cls

temu_Class *

The class to be blessed

temu_qualifyAsCpu

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_qualifyAsCpu(temu_Class * Cls)

Description

Bless the class so that the isCpu predicate returns 1. There are certain assumptions that CPU classes must meet. These assumptions are not stable yet, so do not use this in user code.

Parameters

Table 364. temu_qualifyAsCpu Parameters
Parameter Type Description

Cls

temu_Class *

The class to be blessed

temu_qualifyAsMachine

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_qualifyAsMachine(temu_Class * Cls)

Description

Bless the class so that the isMachine predicate returns 1. There are certain assumptions that machine classes must meet. These assumptions are not stable yet, so do not use this in user code.

Parameters

Table 365. temu_qualifyAsMachine Parameters
Parameter Type Description

Cls

temu_Class *

The class to be blessed

temu_qualifyAsMemory

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_qualifyAsMemory(temu_Class * Cls)

Description

Bless the class so that the isMemory predicate returns 1

Parameters

Table 366. temu_qualifyAsMemory Parameters
Parameter Type Description

Cls

temu_Class *

The class to be blessed

temu_readFieldValue

Include

#include "temu-c/Support/Register.h"

Signature

uint64_t temu_readFieldValue(temu_Object * Obj, const char * RegName, unsigned int RegIdx, const char * FieldName)

Description

Retrieve the value of a field in a register with side-effects.

Result

The value of the field

Parameters

Table 367. temu_readFieldValue Parameters
Parameter Type Description

Obj

temu_Object *

The object of the class the has the register

RegName

const char *

Register name

RegIdx

unsigned int

Register index

FieldName

const char *

Field name

temu_readPCIeConfigRegister

Include

#include "temu-c/Support/PCIeHelper.h"

Signature

temu_Propval temu_readPCIeConfigRegister(temu_PCIExpressDevice * DevConf, uint32_t offset)

Description

Read register value from PCIe configuration

Result

return register value.

Parameters

Table 368. temu_readPCIeConfigRegister Parameters
Parameter Type Description

DevConf

temu_PCIExpressDevice *

PCIe configuration

offset

uint32_t

register offset in memory map.

temu_readProp

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Propval temu_readProp(temu_Object * Obj, const char * Name, int idx)

Description

Read property (with side effects)

Result

The read value, set to teTY_Invalid for failures

Parameters

Table 369. temu_readProp Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

Name

const char *

Name of property

idx

int

Index in property array (set to 0 if scalar)

temu_readValue

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Propval temu_readValue(temu_Object * Obj, const char * PropName, int Idx)

Description

Read a property value with side-effects

Result

The property value corresponding to the name. In case of the property not being found, the Typ field of the returned property will be teTY_Invalid.

Parameters

Table 370. temu_readValue Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Idx

int

Index of property, set to 0 if it is not an array.

temu_readValueDouble

Include

#include "temu-c/Support/Objsys.h"

Signature

double temu_readValueDouble(temu_Object * Obj, const char * PropName, int Idx)

Description

Read property (with side effects)

Result

The property value converted to double

Parameters

Table 371. temu_readValueDouble Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property

Idx

int

Index in property array (set to 0 if scalar)

temu_readValueI16

Include

#include "temu-c/Support/Objsys.h"

Signature

int16_t temu_readValueI16(temu_Object * Obj, const char * PropName, int Idx)

Description

Read typed properties.

The readValue[U|I][8|16|32|64] function reads a typed property. The accessor will fail with a fatal error if the read type is not the same as the property type. If the property type is unknown, use the temu_readValue function instead.

Result

The read out property value.

Parameters

Table 372. temu_readValueI16 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read

Idx

int

Index in property array, set to 0 if the property is not an array

temu_readValueI32

Include

#include "temu-c/Support/Objsys.h"

Signature

int32_t temu_readValueI32(temu_Object * Obj, const char * PropName, int Idx)

Description

Read typed properties.

The readValue[U|I][8|16|32|64] function reads a typed property. The accessor will fail with a fatal error if the read type is not the same as the property type. If the property type is unknown, use the temu_readValue function instead.

Result

The read out property value.

Parameters

Table 373. temu_readValueI32 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read

Idx

int

Index in property array, set to 0 if the property is not an array

temu_readValueI64

Include

#include "temu-c/Support/Objsys.h"

Signature

int64_t temu_readValueI64(temu_Object * Obj, const char * PropName, int Idx)

Description

Read typed properties.

The readValue[U|I][8|16|32|64] function reads a typed property. The accessor will fail with a fatal error if the read type is not the same as the property type. If the property type is unknown, use the temu_readValue function instead.

Result

The read out property value.

Parameters

Table 374. temu_readValueI64 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read

Idx

int

Index in property array, set to 0 if the property is not an array

temu_readValueI8

Include

#include "temu-c/Support/Objsys.h"

Signature

int8_t temu_readValueI8(temu_Object * Obj, const char * PropName, int Idx)

Description

Read typed properties.

The readValue[U|I][8|16|32|64] function reads a typed property. The accessor will fail with a fatal error if the read type is not the same as the property type. If the property type is unknown, use the temu_readValue function instead.

Result

The read out property value.

Parameters

Table 375. temu_readValueI8 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read

Idx

int

Index in property array, set to 0 if the property is not an array

temu_readValueSigned

Include

#include "temu-c/Support/Objsys.h"

Signature

int64_t temu_readValueSigned(temu_Object * Obj, const char * PropName, int Idx)

Description

Read property (with side effects)

Result

The property value converted to signed

Parameters

Table 376. temu_readValueSigned Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property

Idx

int

Index in property array (set to 0 if scalar)

temu_readValueU16

Include

#include "temu-c/Support/Objsys.h"

Signature

uint16_t temu_readValueU16(temu_Object * Obj, const char * PropName, int Idx)

Description

Read typed properties.

The readValue[U|I][8|16|32|64] function reads a typed property. The accessor will fail with a fatal error if the read type is not the same as the property type. If the property type is unknown, use the temu_readValue function instead.

Result

The read out property value.

Parameters

Table 377. temu_readValueU16 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read

Idx

int

Index in property array, set to 0 if the property is not an array

temu_readValueU32

Include

#include "temu-c/Support/Objsys.h"

Signature

uint32_t temu_readValueU32(temu_Object * Obj, const char * PropName, int Idx)

Description

Read typed properties.

The readValue[U|I][8|16|32|64] function reads a typed property. The accessor will fail with a fatal error if the read type is not the same as the property type. If the property type is unknown, use the temu_readValue function instead.

Result

The read out property value.

Parameters

Table 378. temu_readValueU32 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read

Idx

int

Index in property array, set to 0 if the property is not an array

temu_readValueU64

Include

#include "temu-c/Support/Objsys.h"

Signature

uint64_t temu_readValueU64(temu_Object * Obj, const char * PropName, int Idx)

Description

Read typed properties.

The readValue[U|I][8|16|32|64] function reads a typed property. The accessor will fail with a fatal error if the read type is not the same as the property type. If the property type is unknown, use the temu_readValue function instead.

Result

The read out property value.

Parameters

Table 379. temu_readValueU64 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read

Idx

int

Index in property array, set to 0 if the property is not an array

temu_readValueU8

Include

#include "temu-c/Support/Objsys.h"

Signature

uint8_t temu_readValueU8(temu_Object * Obj, const char * PropName, int Idx)

Description

Read typed properties.

The readValue[U|I][8|16|32|64] function reads a typed property. The accessor will fail with a fatal error if the read type is not the same as the property type. If the property type is unknown, use the temu_readValue function instead.

Result

The read out property value.

Parameters

Table 380. temu_readValueU8 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read

Idx

int

Index in property array, set to 0 if the property is not an array

temu_readValueUnsigned

Include

#include "temu-c/Support/Objsys.h"

Signature

uint64_t temu_readValueUnsigned(temu_Object * Obj, const char * PropName, int Idx)

Description

Read property (with side effects)

Result

The property value converted to unsigned

Parameters

Table 381. temu_readValueUnsigned Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property

Idx

int

Index in property array (set to 0 if scalar)

temu_registerClass

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Class * temu_registerClass(const char * ClsName, temu_ObjectCreateFunc Create, temu_ObjectDisposeFunc Dispose)

Description

Register a class in the TEMU object system. With these classes, the TEMU object system is responsible for allocation and de-allocation.

Result

A pointer to the class object that can be further used to register properties and interfaces.

Parameters

Table 382. temu_registerClass Parameters
Parameter Type Description

ClsName

const char *

The name of the class that is to be created.

Create

temu_ObjectCreateFunc

A constructor, the constructor is responsible for allocation and initialisation of the object.

Dispose

temu_ObjectDisposeFunc

A destructor, this function is responsible for deleting the objects of the class.

temu_registerComponent

Include

#include "temu-c/Support/Component.h"

Signature

temu_Class * temu_registerComponent(const char * CompClass, temu_ObjectCreateFunc Create, temu_ObjectDisposeFunc Dispose)

Description

Register a new component class in

Result

Pointer to the new class

Parameters

Table 383. temu_registerComponent Parameters
Parameter Type Description

CompClass

const char *

Name of the component to be registered

Create

temu_ObjectCreateFunc

The constructor function that allocates the component

Dispose

temu_ObjectDisposeFunc

The destructor function

temu_requireInterface

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_requireInterface(temu_Class * Cls, const char * PropName, const char * IfaceType)

Description

Associate the interface reference property with an interface type.

Setting the type, prevents the connect command / function to assign the connection if the target interface type is not the same as the property interface reference type.

Parameters

Table 384. temu_requireInterface Parameters
Parameter Type Description

Cls

temu_Class *

Class pointer

PropName

const char *

Name of interface reference property

IfaceType

const char *

Type required to connect the property

temu_roundDownNearestPow2_32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_roundDownNearestPow2_32(uint32_t Word)

Description

Round down to nearest power of 2

Result

A copy of Word rounded down to nearest power of 2

Parameters

Table 385. temu_roundDownNearestPow2_32 Parameters
Parameter Type Description

Word

uint32_t

The word to be round

temu_roundDownNearestPow2_64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_roundDownNearestPow2_64(uint64_t Word)

Description

Round up to nearest power of 2

Result

A copy of Word rounded down to nearest power of 2

Parameters

Table 386. temu_roundDownNearestPow2_64 Parameters
Parameter Type Description

Word

uint64_t

The word to be round

temu_roundDownToPow2_32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_roundDownToPow2_32(uint32_t Word, uint32_t Size)

Description

Round down to multiples of specified power of 2

Result

A rounded copy of Word

Parameters

Table 387. temu_roundDownToPow2_32 Parameters
Parameter Type Description

Word

uint32_t

The word to be rounded

Size

uint32_t

Power of 2 sized block

temu_roundDownToPow2_64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_roundDownToPow2_64(uint64_t Word, uint64_t Size)

Description

Round down to multiples of specified power of 2

Result

A rounded copy of Word

Parameters

Table 388. temu_roundDownToPow2_64 Parameters
Parameter Type Description

Word

uint64_t

The word to be rounded

Size

uint64_t

Power of 2 sided block

temu_roundUpNearestPow2_32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_roundUpNearestPow2_32(uint32_t Word)

Description

Round up to nearest power of 2

Result

A copy of Word rounded up to nearest power of 2

Parameters

Table 389. temu_roundUpNearestPow2_32 Parameters
Parameter Type Description

Word

uint32_t

The word to be round

temu_roundUpNearestPow2_64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_roundUpNearestPow2_64(uint64_t Word)

Description

Round up to nearest power of 2

Result

A copy of Word rounded up to nearest power of 2

Parameters

Table 390. temu_roundUpNearestPow2_64 Parameters
Parameter Type Description

Word

uint64_t

The word to be round

temu_roundUpToPow2_32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_roundUpToPow2_32(uint32_t Word, uint32_t Size)

Description

Round up to multiples of specified power of 2

Result

A rounded copy of Word

Parameters

Table 391. temu_roundUpToPow2_32 Parameters
Parameter Type Description

Word

uint32_t

The word to be rounded

Size

uint32_t

Power of 2 sized block

temu_roundUpToPow2_64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_roundUpToPow2_64(uint64_t Word, uint64_t Size)

Description

Round up to multiples of specified power of 2

Result

A rounded copy of Word

Parameters

Table 392. temu_roundUpToPow2_64 Parameters
Parameter Type Description

Word

uint64_t

The word to be rounded

Size

uint64_t

Power of 2 sized block

temu_run

Include

#include "temu-c/Support/Scheduler.h"

Signature

void temu_run()

Description

Run the current scheduler forever

temu_runForSteps

Include

#include "temu-c/Support/Scheduler.h"

Signature

void temu_runForSteps(int64_t steps)

Description

Run the current scheduler for a fixed number of steps

Parameters

Table 393. temu_runForSteps Parameters
Parameter Type Description

steps

int64_t

Time in steps (in scheduler units).

temu_runForTime

Include

#include "temu-c/Support/Scheduler.h"

Signature

void temu_runForTime(double secs)

Description

Run the current scheduler for a fixed time

Parameters

Table 394. temu_runForTime Parameters
Parameter Type Description

secs

double

Time in simulated seconds

temu_schedulerGetAccumulatedTime

Include

#include "temu-c/Support/Scheduler.h"

Signature

uint64_t temu_schedulerGetAccumulatedTime()

Description

Experimental function to get the accumulated nanoseconds for the scheduler.

To enable sampling the Scheduler-object’s measureTime property must be set.

Result

Accumulated nanoseconds of which temu_run* functions have run.

temu_schedulerGetAffinity

Include

#include "temu-c/Support/Scheduler.h"

Signature

int64_t temu_schedulerGetAffinity(unsigned int threadId)

Description

Experimental function to get the thread affinity for the scheduler.

Result

Affinity value, -1 implies not set. Other values indicate HOST CPUID.

Parameters

Table 395. temu_schedulerGetAffinity Parameters
Parameter Type Description

threadId

unsigned int

Thread ID starting with 0 to the number of threads set for the scheduler.

temu_schedulerGetSyncTime

Include

#include "temu-c/Support/Scheduler.h"

Signature

uint64_t temu_schedulerGetSyncTime(unsigned int threadId)

Description

Experimental function to get the accumulated nanoseconds for the scheduler synchronization.

To enable sampling, the Scheduler-object’s measureTime property must be set.

Result

Accumulated nanoseconds of which synchronisation code was run.

temu_schedulerGetWaitTime

Include

#include "temu-c/Support/Scheduler.h"

Signature

uint64_t temu_schedulerGetWaitTime(unsigned int threadId)

Description

Experimental function to get the accumulated nanoseconds for the scheduler barrier waits.

The wait time, includes both the actual barrier and the synchronization time.

So the true wait time is the wait - sync time.

To enable sampling, the Scheduler-object’s measureTime property must be set.

Result

Accumulated nanoseconds of which the wait was run.

temu_schedulerSetAffinity

Include

#include "temu-c/Support/Scheduler.h"

Signature

void temu_schedulerSetAffinity(unsigned int threadId, int hostCore)

Description

Experimental function to set thread affinity for the scheduler.

The function should be called before setting the number of threads, as threads automatically set the affinity if the hostCore is zero or above.

Parameters

Table 396. temu_schedulerSetAffinity Parameters
Parameter Type Description

threadId

unsigned int

Thread ID starting with 0 to the number of threads set for the scheduler.

hostCore

int

Host core id to bind thread to. Negative to not set affintity.

temu_secsToCycles

Include

#include "temu-c/Support/Time.h"

Signature

int64_t temu_secsToCycles(double Secs, int64_t Freq)

Description

Convert seconds to cycles

Result

Seconds converted to an integral number of cycles

Parameters

Table 397. temu_secsToCycles Parameters
Parameter Type Description

Secs

double

Seconds to convert

Freq

int64_t

Frequency in Hz

temu_secsToNanos

Include

#include "temu-c/Support/Time.h"

Signature

int64_t temu_secsToNanos(double Secs)

Description

Convert seconds to nanoseconds

Result

Seconds converted to an integral number of nanoseconds

Parameters

Table 398. temu_secsToNanos Parameters
Parameter Type Description

Secs

double

Seconds to convert

temu_serialiseJSON

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_serialiseJSON(const char * FileName)

Description

Serialise the simulation state to the given file name.

The serialisation writes a JSON formatted file and calls the serialise procedure in the (optional) ObjectIface if it is implemented.

The serialisation interface can for example be used to write out memory buffers to separate files as such data should not be written to a JSON file.

Result

0 on success, otherwise non-zero

Parameters

Table 399. temu_serialiseJSON Parameters
Parameter Type Description

FileName

const char *

The filename, to which the JSON data is to be stored

temu_serialiseProp

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_serialiseProp(void * Ctxt, const char * Name, temu_Type Typ, int Count, void * Data)

Description

Serialise an explicit property, this can be called from the serialisiation interface. Note that the availability of pseudo properties makes this function and the serialise interface more or less obsolete.

Parameters

Table 400. temu_serialiseProp Parameters
Parameter Type Description

Ctxt

void *

The context object that has the property (same as passed to serialise function in the interface)

Name

const char *

The name of the property

Typ

temu_Type

The type of the property

Count

int

0 if the property is not an array, otherwise the element number in the property

Data

void *

Serialized data

temu_serializeOnNotification

Include

#include "temu-c/Support/Scheduler.h"

Signature

void temu_serializeOnNotification(temu_Object * notificationSource, const char * notificationName, double seconds)

Description

Serialize execution for some time when notification is triggered

Parameters

Table 401. temu_serializeOnNotification Parameters
Parameter Type Description

notificationSource

temu_Object *

Object emitting notification.

notificationName

const char *

Name of notification to intercept.

seconds

double

Number of seconds (simulated time, for which to serialize execution).

temu_setFieldValue

Include

#include "temu-c/Support/Register.h"

Signature

int temu_setFieldValue(temu_Object * Obj, const char * RegName, unsigned int RegIdx, const char * FieldName, uint64_t Value)

Description

Set a field’s value in a register

Result

zero on success, otherwise non-zero value

Parameters

Table 402. temu_setFieldValue Parameters
Parameter Type Description

Obj

temu_Object *

The object that contains the register

RegName

const char *

Register name

RegIdx

unsigned int

Register index

FieldName

const char *

Field name

Value

uint64_t

The value to be set

temu_setMemAttr

Include

#include "temu-c/Memory/Memory.h"

Signature

void temu_setMemAttr(void * Obj, uint64_t Addr, uint64_t Len, temu_MemoryAttr Attr)

Description

Set attribute on memory space location

Parameters

Table 403. temu_setMemAttr Parameters
Parameter Type Description

Obj

void *

The memory space object

Addr

uint64_t

Physical address where to map the device

Len

uint64_t

Length in bytes of area where the attribute should be set.

Attr

temu_MemoryAttr

The attribute to set.

temu_setRightmostZeoroBit64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_setRightmostZeoroBit64(uint64_t Word)

Description

Set right most bit that is zero

Result

A copy of Word, with the right most bit cleared

Parameters

Table 404. temu_setRightmostZeoroBit64 Parameters
Parameter Type Description

Word

uint64_t

The word, in which the right most set bit will be set

temu_setRightmostZeroBit32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_setRightmostZeroBit32(uint32_t Word)

Description

Set right most bit that is zero

Result

A copy of Word, with the right most bit cleared

Parameters

Table 405. temu_setRightmostZeroBit32 Parameters
Parameter Type Description

Word

uint32_t

The word, in which the right most set bit will be cleared

temu_setTimeSource

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_setTimeSource(temu_Object * Obj, temu_TimeSource * TS)

Description

Set time source object for models. Typically TS is a CPU. You can only set the time source for an internal class.

Parameters

Table 406. temu_setTimeSource Parameters
Parameter Type Description

Obj

temu_Object *

Object to set time source in.

TS

temu_TimeSource *

Time source object (CPU or clock model)

temu_setVTable

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_setVTable(temu_Class * Cls, void * VTable)

Description

Set the VTable pointer.

Temu classes, provides the ability to, for internal objects query for a VTable manually in O(1) time. In practice this can be any pointer, but it is typically used to register performance sensitive interfaces. E.g. the CPU and machine classes have their own VTable types that refer to a number of interfaces they implement.

Result

0 on success, non-zero otherwise.

Parameters

Table 407. temu_setVTable Parameters
Parameter Type Description

Cls

temu_Class *

The class, for which the vtable to be set

VTable

void *

Pointer to the vtable to be used

temu_setValue

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_setValue(temu_Object * Obj, const char * PropName, temu_Propval Val, int Idx)

Description

Set a raw property value without side-effects

Parameters

Table 408. temu_setValue Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

temu_Propval

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_setValueDouble

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_setValueDouble(temu_Object * Obj, const char * PropName, double Val, int Idx)

Description

Set floating point property (without side effects)

Parameters

Table 409. temu_setValueDouble Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property

Val

double

The new property value

Idx

int

Index in property array (set to 0 if scalar)

temu_setValueI16

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_setValueI16(temu_Object * Obj, const char * PropName, int16_t Val, int Idx)

Description

Set a raw property value without side-effects

Parameters

Table 410. temu_setValueI16 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

int16_t

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_setValueI32

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_setValueI32(temu_Object * Obj, const char * PropName, int32_t Val, int Idx)

Description

Set a raw property value without side-effects

Parameters

Table 411. temu_setValueI32 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

int32_t

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_setValueI64

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_setValueI64(temu_Object * Obj, const char * PropName, int64_t Val, int Idx)

Description

Set a raw property value without side-effects

Parameters

Table 412. temu_setValueI64 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

int64_t

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_setValueI8

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_setValueI8(temu_Object * Obj, const char * PropName, int8_t Val, int Idx)

Description

Set a raw property value without side-effects

Parameters

Table 413. temu_setValueI8 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

int8_t

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_setValueSigned

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_setValueSigned(temu_Object * Obj, const char * PropName, int64_t Val, int Idx)

Description

Set signed property (without side effects)

Parameters

Table 414. temu_setValueSigned Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property

Val

int64_t

The new property value

Idx

int

Index in property array (set to 0 if scalar)

temu_setValueU16

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_setValueU16(temu_Object * Obj, const char * PropName, uint16_t Val, int Idx)

Description

Set a raw property value without side-effects

Parameters

Table 415. temu_setValueU16 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

uint16_t

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_setValueU32

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_setValueU32(temu_Object * Obj, const char * PropName, uint32_t Val, int Idx)

Description

Set a raw property value without side-effects

Parameters

Table 416. temu_setValueU32 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

uint32_t

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_setValueU64

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_setValueU64(temu_Object * Obj, const char * PropName, uint64_t Val, int Idx)

Description

Set a raw property value without side-effects

Parameters

Table 417. temu_setValueU64 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

uint64_t

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_setValueU8

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_setValueU8(temu_Object * Obj, const char * PropName, uint8_t Val, int Idx)

Description

Set a raw property value without side-effects

Parameters

Table 418. temu_setValueU8 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

uint8_t

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_setValueUnsigned

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_setValueUnsigned(temu_Object * Obj, const char * PropName, uint64_t Val, int Idx)

Description

Set unsigned property (without side effects)

Parameters

Table 419. temu_setValueUnsigned Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property

Val

uint64_t

The new property value

Idx

int

Index in property array (set to 0 if scalar)

temu_signed32AddOverflows

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_signed32AddOverflows(uint32_t a, uint32_t b, uint32_t carry)

Description

Checks whether the addition of signed inputs with carry would overflow; a+b+carry

Result

true if it overflows, false otherwise

Parameters

Table 420. temu_signed32AddOverflows Parameters
Parameter Type Description

a

uint32_t

is the first input

b

uint32_t

is the second input

carry

uint32_t

is the carry; can be either zero or one

temu_signedPropval

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Propval temu_signedPropval(temu_Type T, int64_t I)

Description

Create a signed propval of the given type

Result

Property value with the given type and value.

Parameters

Table 421. temu_signedPropval Parameters
Parameter Type Description

T

temu_Type

Type ID, must be a signed integer type tag

I

int64_t

Integer value

temu_snapshotGetLength

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_snapshotGetLength(void * Ctxt, const char * Name)

Description

Get number of entries for the serialized property

Result

Length of the property in elements. Negative on error.

Parameters

Table 422. temu_snapshotGetLength Parameters
Parameter Type Description

Ctxt

void *

Context passed to deserialise function

Name

const char *

Name of property / key in the serialized file

temu_snapshotGetValue

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Propval temu_snapshotGetValue(void * Ctxt, const char * Name, int Idx)

Description

Get value for named snapshot value

Result

Property value with the contents saved to the snapshot

Parameters

Table 423. temu_snapshotGetValue Parameters
Parameter Type Description

Ctxt

void *

Context is passed to deserialise interface function

Name

const char *

Name of the saved value

Idx

int

Index of the saved value (if array)

temu_sparcGetAsr

Include

#include "temu-c/Support/Cpu.h"

Signature

uint64_t temu_sparcGetAsr(void * Cpu, unsigned int Reg)

Description

Get ASR register value

Result

ASR register value

Parameters

Table 424. temu_sparcGetAsr Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer

Reg

unsigned int

ASR register ID

temu_sparcGetNPc

Include

#include "temu-c/Support/Cpu.h"

Signature

uint32_t temu_sparcGetNPc(void * Cpu)

Description

Get the nPC value

Result

nPC value

Parameters

Table 425. temu_sparcGetNPc Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer

temu_sparcGetPsr

Include

#include "temu-c/Support/Cpu.h"

Signature

uint32_t temu_sparcGetPsr(void * Cpu)

Description

Get the Processor State Register

Result

PSR value

Parameters

Table 426. temu_sparcGetPsr Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer

temu_sparcGetTbr

Include

#include "temu-c/Support/Cpu.h"

Signature

uint32_t temu_sparcGetTbr(void * Cpu)

Description

Get Trap Base Register value

Result

TBR value

Parameters

Table 427. temu_sparcGetTbr Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer

temu_sparcGetWim

Include

#include "temu-c/Support/Cpu.h"

Signature

uint32_t temu_sparcGetWim(void * Cpu)

Description

Get window invalidation mask register

Result

WIM value

Parameters

Table 428. temu_sparcGetWim Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer

temu_sparcGetWindowCount

Include

#include "temu-c/Support/Cpu.h"

Signature

int temu_sparcGetWindowCount(void * Cpu)

Description

Get how many register windows are supported by the CPU

Result

Number of register windows

Parameters

Table 429. temu_sparcGetWindowCount Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer

temu_sparcGetWindowedReg

Include

#include "temu-c/Support/Cpu.h"

Signature

uint32_t temu_sparcGetWindowedReg(void * Cpu, int Window, unsigned int Reg)

Description

Get a windowed SPARC register

Result

Register value

Parameters

Table 430. temu_sparcGetWindowedReg Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer

Window

int

Window number (-1 for current window)

Reg

unsigned int

Register number within window

temu_sparcGetY

Include

#include "temu-c/Support/Cpu.h"

Signature

uint64_t temu_sparcGetY(void * Cpu)

Description

Get the Y register of the CPU,

Result

Current Y register value

Parameters

Table 431. temu_sparcGetY Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer

temu_sparcSetAsr

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_sparcSetAsr(void * Cpu, unsigned int Reg, uint64_t Value)

Description

Set the ASR register

Parameters

Table 432. temu_sparcSetAsr Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer

Reg

unsigned int

ASR register ID

Value

uint64_t

Value to write

temu_sparcSetAsrReader

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_sparcSetAsrReader(void * Cpu, unsigned int Asr, temu_SparcAsrHandler Handler)

Description

Install the handler to be called when an ASR is read

Parameters

Table 433. temu_sparcSetAsrReader Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer

Asr

unsigned int

ASR register ID

Handler

temu_SparcAsrHandler

Function to call.

temu_sparcSetAsrWriter

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_sparcSetAsrWriter(void * Cpu, unsigned int Asr, temu_SparcAsrHandler Handler)

Description

Install the handler to be called when an ASR is written

Parameters

Table 434. temu_sparcSetAsrWriter Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer

Asr

unsigned int

ASR register ID

Handler

temu_SparcAsrHandler

Function to call.

temu_sparcSetNPc

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_sparcSetNPc(void * Cpu, uint32_t Value)

Description

Set the nPC value (next program counter)

When you use the setPC function, the NPC is also updated to PC+4. Use this to explicitly set NPC.

Parameters

Table 435. temu_sparcSetNPc Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer

Value

uint32_t

Value to write to NPC

temu_sparcSetPsr

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_sparcSetPsr(void * Cpu, uint32_t Value)

Description

Set the Processor State Register

Parameters

Table 436. temu_sparcSetPsr Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer

Value

uint32_t

Value to write

temu_sparcSetTbr

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_sparcSetTbr(void * Cpu, uint32_t Value)

Description

Set the Trap Base Register

Parameters

Table 437. temu_sparcSetTbr Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer,

Value

uint32_t

Value for TBR register

temu_sparcSetWim

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_sparcSetWim(void * Cpu, uint32_t Value)

Description

Set window invalidation mask register

Parameters

Table 438. temu_sparcSetWim Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer

Value

uint32_t

value to set in WIM

temu_sparcSetWindowedReg

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_sparcSetWindowedReg(void * Cpu, int Window, unsigned int Reg, uint32_t Value)

Description

Set a windowed SPARC register

Parameters

Table 439. temu_sparcSetWindowedReg Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer

Window

int

Window number (-1 for current window)

Reg

unsigned int

Register number within window

Value

uint32_t

Register value

temu_sparcSetY

Include

#include "temu-c/Support/Cpu.h"

Signature

void temu_sparcSetY(void * Cpu, uint64_t Value)

Description

Set the Y register of the CPU,

Parameters

Table 440. temu_sparcSetY Parameters
Parameter Type Description

Cpu

void *

SPARC CPU pointer

Value

uint64_t

Value to write to the Y register

temu_spwConnect

Include

#include "temu-c/Bus/Spacewire.h"

Signature

void temu_spwConnect(temu_SpwPortIfaceRef Dev1PortIface, temu_SpwPortIfaceRef Dev2PortIface)

Description

Connect two SpaceWire ports.

temu_spwDisconnect

Include

#include "temu-c/Bus/Spacewire.h"

Signature

void temu_spwDisconnect(temu_SpwPortIfaceRef Dev1PortIface, temu_SpwPortIfaceRef Dev2PortIface)

Description

Disconnect two SpaceWire ports.

temu_spwLinkStateToStr

Include

#include "temu-c/Bus/Spacewire.h"

Signature

const char * temu_spwLinkStateToStr(uint8_t linkState)

Description

Returns the string name for the link state.

Result

temu_spwLsmInit

Include

#include "temu-c/Bus/Spacewire.h"

Signature

void temu_spwLsmInit(temu_SpwLinkState * StatePtr)

Description

Initialize the link state.

temu_spwLsmUpdate

Include

#include "temu-c/Bus/Spacewire.h"

Signature

uint8_t temu_spwLsmUpdate(temu_SpwLinkState * StatePtr, uint8_t AS, uint8_t LS, uint8_t LD, uint8_t PortConnect, temu_SpwLinkState otherSideLinkState)

Description

Updates the link state.

Result

temu_spwRmapCRC

Include

#include "temu-c/Bus/Spacewire.h"

Signature

uint8_t temu_spwRmapCRC(const uint8_t * Data, uint32_t DataSize)

Description

Calculates the CRC over the specified data.

Result

temu_spwRmapCRCNextCode

Include

#include "temu-c/Bus/Spacewire.h"

Signature

uint8_t temu_spwRmapCRCNextCode(uint8_t InCRC, uint8_t InByte)

Description

Provided the previous calculated crc and a the current byte returns the next CRC value.

Result

temu_spwRmapDecodeBuffer

Include

#include "temu-c/Bus/Spacewire.h"

Signature

temu_SpwRmapDecodingOutcome temu_spwRmapDecodeBuffer(const temu_Buff * PktDataBuffer, temu_SpwRmapDecodedPacket * PktDecoded)

Description

Provided a buffer containing a SpaceWire Rmap packet attempts to decode it.

Result

temu_spwRmapDecodePacket

Include

#include "temu-c/Bus/Spacewire.h"

Signature

temu_SpwRmapDecodingOutcome temu_spwRmapDecodePacket(const temu_SpwPacket * Pkt, temu_SpwRmapDecodedPacket * PktDecoded)

Description

Provided a SpaceWire Rmap packet attempts to decode it.

Result

temu_spwRmapEncodeReadReplyHeaderForPacket

Include

#include "temu-c/Bus/Spacewire.h"

Signature

uint32_t temu_spwRmapEncodeReadReplyHeaderForPacket(const temu_SpwRmapDecodedPacket * DCmdPkt, uint8_t * Data, uint32_t AllocatedDataSize, uint8_t Status, uint32_t DataLength)

Description

Encodes the reply for a read command.

Result

temu_spwRmapEncodeRmwHeaderForPacket

Include

#include "temu-c/Bus/Spacewire.h"

Signature

uint32_t temu_spwRmapEncodeRmwHeaderForPacket(const temu_SpwRmapDecodedPacket * DCmdPkt, uint8_t * Data, uint32_t AllocatedDataSize, uint8_t Status, uint32_t DataLength)

Description

Encodes the reply for a rmw command.

Result

temu_spwRmapEncodeWriteReplyHeaderForPacket

Include

#include "temu-c/Bus/Spacewire.h"

Signature

uint32_t temu_spwRmapEncodeWriteReplyHeaderForPacket(const temu_SpwRmapDecodedPacket * DCmdPkt, uint8_t * Data, uint32_t AllocatedDataSize, uint8_t Status)

Description

Encodes the reply for a write command.

Result

temu_spwRmapHeaderReplySize

Include

#include "temu-c/Bus/Spacewire.h"

Signature

uint32_t temu_spwRmapHeaderReplySize(const temu_SpwRmapDecodedPacket * DCmdPkt)

Description

Returns the total packet-size required to reply to the command.

Result

temu_step

Include

#include "temu-c/Support/Scheduler.h"

Signature

void temu_step(temu_TimeSource * cpu, int steps)

Description

Step a processor in the current scheduler

Note that, the other processors may run if the step exceeds the quanta. The step function currently runs processors in sequence, it is not running processors in parallel. This means that stepping is always deterministic.

Parameters

Table 441. temu_step Parameters
Parameter Type Description

cpu

temu_TimeSource *

The processor to step

steps

int

The number of steps or instructions to execute

temu_stepsToCycles

Include

#include "temu-c/Support/Time.h"

Signature

uint64_t temu_stepsToCycles(temu_TimeSource * TS, uint64_t Steps)

Description

Convert steps to cycles

Result

Steps converted to cycles given the time source IPC/CPI configuration.

Parameters

Table 442. temu_stepsToCycles Parameters
Parameter Type Description

TS

temu_TimeSource *

Time source object

Steps

uint64_t

Step count to convert to cycles

temu_stepsToCyclesRoundedUp

Include

#include "temu-c/Support/Time.h"

Signature

uint64_t temu_stepsToCyclesRoundedUp(temu_TimeSource * TS, uint64_t Steps)

Description

Convert steps to cycles, rounding upwards

Result

Steps converted to cycles given the time source IPC/CPI configuration.

Parameters

Table 443. temu_stepsToCyclesRoundedUp Parameters
Parameter Type Description

TS

temu_TimeSource *

Time source object

Steps

uint64_t

Step count to convert to cycles

temu_stop

Include

#include "temu-c/Support/Scheduler.h"

Signature

void temu_stop()

Description

Stop the current scheduler

The function signals the scheduler to stop, and then waits until the scheduler is in the stopped state.

temu_subscribeNotification

Include

#include "temu-c/Support/Notifications.h"

Signature

int temu_subscribeNotification(const char * NotName, temu_Object * Source, void * Arg, temu_NotificationHandler NotFunc)

Description

Install notification functions for the given event generated by source

Result

Parameters

Table 444. temu_subscribeNotification Parameters
Parameter Type Description

NotName

const char *

Name of the notification

Source

temu_Object *

If source is NULL, the event subscriber will be notified by all the sources for the given name.

Arg

void *

Context argument to be passed to the callback notification function

NotFunc

temu_NotificationHandler

The callback function on notification

temu_swap16

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint16_t temu_swap16(uint16_t HWord)

Description

Swap bytes in 16 bit word

Result

the swapped word

Parameters

Table 445. temu_swap16 Parameters
Parameter Type Description

HWord

uint16_t

The word to be swapped

temu_swap32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_swap32(uint32_t Word)

Description

Swap bytes in 32 bit word

Result

the swapped word

Parameters

Table 446. temu_swap32 Parameters
Parameter Type Description

Word

uint32_t

The word to be swapped

temu_swap32Half

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_swap32Half(uint32_t Word)

Description

Swap half words inside 32 bit word

Result

the swapped word

Parameters

Table 447. temu_swap32Half Parameters
Parameter Type Description

Word

uint32_t

The word to be swapped

temu_swap64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_swap64(uint64_t DWord)

Description

Swap bytes in 64 bit word

Result

the swapped word

Parameters

Table 448. temu_swap64 Parameters
Parameter Type Description

DWord

uint64_t

The word to be swapped

temu_swap64Word

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_swap64Word(uint64_t DWord)

Description

Swap words inside 64 bit word

Result

the swapped word

Parameters

Table 449. temu_swap64Word Parameters
Parameter Type Description

DWord

uint64_t

The word to be swapped

temu_swapBigHost16

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint16_t temu_swapBigHost16(uint16_t HWord)

Description

Swap between big endian and host endian. Note that at present we only have little endian hosts, so these functions simply wrap. However, they declare intent and it is recommended that you use these for swapping when you want to go between little

>host and big

>host.

Result

the swapped word

Parameters

Table 450. temu_swapBigHost16 Parameters
Parameter Type Description

HWord

uint16_t

The word to be swapped

temu_swapBigHost32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_swapBigHost32(uint32_t Word)

Description

Swap between big endian and host endian. Note that at present we only have little endian hosts, so these functions simply wrap. However, they declare intent and it is recommended that you use these for swapping when you want to go between little

>host and big

>host.

Result

the swapped word

Parameters

Table 451. temu_swapBigHost32 Parameters
Parameter Type Description

Word

uint32_t

The word to be swapped

temu_swapBigHost32Half

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_swapBigHost32Half(uint32_t Word)

Description

Swap between big endian and host endian. Note that at present we only have little endian hosts, so these functions simply wrap. However, they declare intent and it is recommended that you use these for swapping when you want to go between little

>host and big

>host.

Result

the swapped word

Parameters

Table 452. temu_swapBigHost32Half Parameters
Parameter Type Description

Word

uint32_t

The word to be swapped

temu_swapBigHost64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_swapBigHost64(uint64_t DWord)

Description

Swap between big endian and host endian. Note that at present we only have little endian hosts, so these functions simply wrap. However, they declare intent and it is recommended that you use these for swapping when you want to go between little

>host and big

>host.

Result

the swapped word

Parameters

Table 453. temu_swapBigHost64 Parameters
Parameter Type Description

DWord

uint64_t

The word to be swapped

temu_swapBigHost64Word

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_swapBigHost64Word(uint64_t DWord)

Description

Swap between big endian and host endian. Note that at present we only have little endian hosts, so these functions simply wrap. However, they declare intent and it is recommended that you use these for swapping when you want to go between little

>host and big

>host.

Result

the swapped word

Parameters

Table 454. temu_swapBigHost64Word Parameters
Parameter Type Description

DWord

uint64_t

The word to be swapped

temu_swapLittleHost16

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint16_t temu_swapLittleHost16(uint16_t HWord)

Description

Swap between little endian and host endian. Note that at present we only have little endian hosts, so these functions simply wrap. However, they declare intent and it is recommended that you use these for swapping when you want to go between little

>host and big

>host.

Result

the swapped word

Parameters

Table 455. temu_swapLittleHost16 Parameters
Parameter Type Description

HWord

uint16_t

The word to be swapped

temu_swapLittleHost32

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_swapLittleHost32(uint32_t Word)

Description

Swap between little endian and host endian. Note that at present we only have little endian hosts, so these functions simply wrap. However, they declare intent and it is recommended that you use these for swapping when you want to go between little

>host and big

>host.

Result

the swapped word

Parameters

Table 456. temu_swapLittleHost32 Parameters
Parameter Type Description

Word

uint32_t

The word to be swapped

temu_swapLittleHost32Half

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint32_t temu_swapLittleHost32Half(uint32_t Word)

Description

Swap between little endian to host endian. Note that at present we only have little endian hosts, so these functions simply wrap. However, they declare intent and it is recommended that you use these for swapping when you want to go between little

>host and big

>host.

Result

the swapped word

Parameters

Table 457. temu_swapLittleHost32Half Parameters
Parameter Type Description

Word

uint32_t

The word to be swapped

temu_swapLittleHost64

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_swapLittleHost64(uint64_t DWord)

Description

Swap between little endian and host endian. Note that at present we only have little endian hosts, so these functions simply wrap. However, they declare intent and it is recommended that you use these for swapping when you want to go between little

>host and big

>host.

Result

the swapped word

Parameters

Table 458. temu_swapLittleHost64 Parameters
Parameter Type Description

DWord

uint64_t

The word to be swapped

temu_swapLittleHost64Word

Include

#include "temu-c/Support/Bitmanip.h"

Signature

uint64_t temu_swapLittleHost64Word(uint64_t DWord)

Description

Swap between little endian and host endian. Note that at present we only have little endian hosts, so these functions simply wrap. However, they declare intent and it is recommended that you use these for swapping when you want to go between little

>host and big

>host.

Result

the swapped word

Parameters

Table 459. temu_swapLittleHost64Word Parameters
Parameter Type Description

DWord

uint64_t

The word to be swapped

temu_symtabGetFuncName

Include

#include "temu-c/Support/Loader.h"

Signature

void temu_symtabGetFuncName(temu_Symtab * Sym, const char ** LocalFile, const char ** Symbol, uint64_t Addr)

Description

Get the function name associated with the given address

The address can be any address within the range of the function, i.e. from the start to othe end of the function. Thus this serves as a way to find the name of the current function given a PC value.

The function first searches for local symbols (e.g. static symbols in C). It then searches for global symbols and last for weak symbols.

If a local symbol is found, the LocalFile pointer will point at a string with the file name it is associated to, otherwise the local file pointer will be set to null.

The returned pointers are valid until the symbol table is disposed.

Parameters

Table 460. temu_symtabGetFuncName Parameters
Parameter Type Description

Sym

temu_Symtab *

Symboltable

LocalFile

const char **

The pointer it refers to will be set to NULL if the symbol found is global.

Symbol

const char **

The pointer will be set to NULL if a function cannot be found at the address.

Addr

uint64_t

Virtual address to find a function name for.

temu_symtabGetGlobalFuncRange

Include

#include "temu-c/Support/Loader.h"

Signature

int temu_symtabGetGlobalFuncRange(temu_Symtab * Sym, const char * FuncName, uint64_t * Addr, uint64_t * Size)

Description

Get the range of a global function

On success, the Addr and the Size references will be set to the starting virtual address of the function and the size in bytes respectively.

Result

0 on success (the function exists), other values indicate falures.

Parameters

Table 461. temu_symtabGetGlobalFuncRange Parameters
Parameter Type Description

Sym

temu_Symtab *

The Symbol table, from which the function is to be retrieved

FuncName

const char *

The function, whose range is required

Addr

uint64_t *

On success, gives the address of the function

Size

uint64_t *

On success, gives the size of the function start from Addr

temu_symtabGetGlobalObjRange

Include

#include "temu-c/Support/Loader.h"

Signature

int temu_symtabGetGlobalObjRange(temu_Symtab * Sym, const char * ObjectName, uint64_t * Addr, uint64_t * Size)

Description

Get the range of a global object

On success, the Addr and the Size references will be set to the starting virtual address of the object and the size in bytes respecivelly.

Result

0 on success (the object exists), other values indicate falures

Parameters

Table 462. temu_symtabGetGlobalObjRange Parameters
Parameter Type Description

Sym

temu_Symtab *

The Symbol table, from which the object to be retrieved

ObjectName

const char *

Name of the object, whose address range is to be obtained

Addr

uint64_t *

On success, gives the address of the object

Size

uint64_t *

On success, gives the size of the object start from Addr

temu_symtabGetLocalFuncRange

Include

#include "temu-c/Support/Loader.h"

Signature

int temu_symtabGetLocalFuncRange(temu_Symtab * Sym, const char * FileName, const char * FuncName, uint64_t * Addr, uint64_t * Size)

Description

Get the range of a local/static function

On success, the Addr and the Size references will be set to the starting virtual address of the function and the size in bytes respectively.

Result

0 on success (the function exists in the given file), other values indicate falures

Parameters

Table 463. temu_symtabGetLocalFuncRange Parameters
Parameter Type Description

Sym

temu_Symtab *

The Symbol table, from which the function to be retrieved

FileName

const char *

The file/compilation unit that contains the function

FuncName

const char *

The function, whose range is required

Addr

uint64_t *

On success, gives the address of the function

Size

uint64_t *

On success, gives the size of the function start from Addr

temu_symtabGetLocalObjRange

Include

#include "temu-c/Support/Loader.h"

Signature

int temu_symtabGetLocalObjRange(temu_Symtab * Sym, const char * FileName, const char * ObjectName, uint64_t * Addr, uint64_t * Size)

Description

Get the range of a local/static object

On success, the Addr and the Size references will be set to the starting virtual address of the object and the size in bytes respecivelly.

Result

0 on success (the object exists), other values indicate falures

Parameters

Table 464. temu_symtabGetLocalObjRange Parameters
Parameter Type Description

Sym

temu_Symtab *

The Symbol table, from which the object to be retrieved

FileName

const char *

The file/compilation unit that contains the function

ObjectName

const char *

The object, whose range is required

Addr

uint64_t *

On success, gives the address of the object

Size

uint64_t *

On success, gives the size of the object start from Addr

temu_symtabGetObjName

Include

#include "temu-c/Support/Loader.h"

Signature

void temu_symtabGetObjName(temu_Symtab * Sym, const char ** LocalFile, const char ** Symbol, uint64_t Addr)

Description

Get the object name associated with the given address

The address can be any address within the range of the object. Thus this serves as a way to find the name of a global or static object given an address.

The function first searches for local symbols (e.g. static symbols in C). It then searches for global symbols and last for weak symbols.

If a local symbol is found, the LocalFile pointer will point at a string with the file name it is associated to, otherwise the local file pointer will be set to NULL.

The returned pointers are valid until the symbol table is disposed.

Parameters

Table 465. temu_symtabGetObjName Parameters
Parameter Type Description

Sym

temu_Symtab *

Symboltable

LocalFile

const char **

The pointer it refers to will be set to NULL if the symbol found is global.

Symbol

const char **

The pointer will be set to NULL if an object cannot be found at the address.

Addr

uint64_t

Virtual address to find an object name for.

temu_timeGetCurrentSrtNanos

Include

#include "temu-c/Support/Time.h"

Signature

uint64_t temu_timeGetCurrentSrtNanos(temu_TimeSource * TS)

Description

Get the current simulated real-time in nanoseconds

Result

simulated time for the given object

Parameters

Table 466. temu_timeGetCurrentSrtNanos Parameters
Parameter Type Description

TS

temu_TimeSource *

The object in question

temu_timeGetMonotonicWct

Include

#include "temu-c/Support/Time.h"

Signature

uint64_t temu_timeGetMonotonicWct()

Description

Get monotonic time in nanoseconds.

The monotonic time is relative since some epoch of undefined start, but it is monotonic, unaffected by adjustments due to leap seconds, setting of the system clock, etc.

This function is primarily useful for doing performance measurements since the time returned is relative to an undefined point (although that undefined point will be consistent while the program is running).

In practice, on systems with clock_gettime() implemented, this function returns the timespec converted to nanoseconds, but on systems without clock_gettime(), e.g. Darwin and Windows, the function will only ensure that some notion of monotonic nanoseconds are returned. In Darwin for example, this results in a monotonic time returned which is relative to the first call to the function.

Result

Wall clock nanoseconds since an unspecified epoch.

temu_timeGetThreadWct

Include

#include "temu-c/Support/Time.h"

Signature

uint64_t temu_timeGetThreadWct()

Description

Returns wall clock nanoseconds of thread time

This is how much time the thread this is called from has been scheduled.

Result

wall clock nanoseconds of thread time

temu_typeToName

Include

#include "temu-c/Support/Objsys.h"

Signature

const char * temu_typeToName(temu_Type Typ)

Description

Get a string representing the type tag.

Result

The name as a C-string

Parameters

Table 467. temu_typeToName Parameters
Parameter Type Description

Typ

temu_Type

The type, whose name is required

temu_typenameForInterface

Include

#include "temu-c/Support/Objsys.h"

Signature

const char * temu_typenameForInterface(const temu_Object * Obj, const void * Iface)

Description

Get type name for interface

Result

The name of the type as C-string

Parameters

Table 468. temu_typenameForInterface Parameters
Parameter Type Description

Obj

const temu_Object *

Pointer to the object that contains the interface

Iface

const void *

Pointer to the interface

temu_unsignedPropval

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Propval temu_unsignedPropval(temu_Type T, uint64_t U)

Description

Create an unsigned propval of the given type

Result

Property value with the given type and value.

Parameters

Table 469. temu_unsignedPropval Parameters
Parameter Type Description

T

temu_Type

Type ID, must be an unsigned integer type tag

U

uint64_t

Integer value

temu_unsubscribeNotification

Include

#include "temu-c/Support/Notifications.h"

Signature

int temu_unsubscribeNotification(const char * NotName, temu_Object * Source, temu_NotificationHandler NotFunc)

Description

Remove notification handler for the given name and source. Note that this function runs in O(N) time. It is not meant for being used in performance critical code.

Result

Parameters

Table 470. temu_unsubscribeNotification Parameters
Parameter Type Description

NotName

const char *

Name of the notification

Source

temu_Object *

If source is NULL, the event subscriber will be notified by all the sources for the given name.

NotFunc

temu_NotificationHandler

The callback function to be called on notification

temu_unsubscribeNotificationArg

Include

#include "temu-c/Support/Notifications.h"

Signature

int temu_unsubscribeNotificationArg(const char * NotName, temu_Object * Source, temu_NotificationHandler NotFunc, void * Arg)

Description

Remove notification handler for the given name, source and arg. Note that this function runs in O(N) time. It is not meant for being used in performance critical code.

Result

zero on success, otherwise non-zero

Parameters

Table 471. temu_unsubscribeNotificationArg Parameters
Parameter Type Description

NotName

const char *

Name of the notification

Source

temu_Object *

If source is NULL, the event subscriber will be notified by all the sources for the given name.

NotFunc

temu_NotificationHandler

The callback function to be called on notification

Arg

void *

Context argument to be passed to the callback notification function

temu_vecCreate

Include

#include "temu-c/Support/Objsys.h"

Signature

temu_Vector temu_vecCreate(temu_Type Typ)

Description

Create a vector object

Result

the vector object created

Parameters

Table 472. temu_vecCreate Parameters
Parameter Type Description

Typ

temu_Type

The type of the elements

temu_vecDispose

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_vecDispose(temu_Vector * Vec)

Description

Delete a vector object

Parameters

Table 473. temu_vecDispose Parameters
Parameter Type Description

Vec

temu_Vector *

The vector object to be deleted

temu_vecGetData

Include

#include "temu-c/Support/Objsys.h"

Signature

void * temu_vecGetData(temu_Vector * Vec)

Description

Retrieve the array of elements of a vector

Result

Returns a pointer to the first element of the vector

Parameters

Table 474. temu_vecGetData Parameters
Parameter Type Description

Vec

temu_Vector *

The vector, whose elements are requested

temu_vecGetSize

Include

#include "temu-c/Support/Objsys.h"

Signature

size_t temu_vecGetSize(temu_Vector * Vec)

Description

Get the number of elements of a vector

Result

The number of elements in Vec

Parameters

Table 475. temu_vecGetSize Parameters
Parameter Type Description

Vec

temu_Vector *

The vector, whose size to be retrieved

temu_vecPush

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_vecPush(temu_Vector * Vec, temu_Propval Val)

Description

Add an element to a vector object

Parameters

Table 476. temu_vecPush Parameters
Parameter Type Description

Vec

temu_Vector *

The vector, to which the element to be added

Val

temu_Propval

The element to be added

temu_writeFieldValue

Include

#include "temu-c/Support/Register.h"

Signature

int temu_writeFieldValue(temu_Object * Obj, const char * RegName, unsigned int RegIdx, const char * FieldName, uint64_t Value)

Description

Set a field’s value in a register with side-effects

Result

zero on success, otherwise non-zero value

Parameters

Table 477. temu_writeFieldValue Parameters
Parameter Type Description

Obj

temu_Object *

The object that contains the register

RegName

const char *

Register name

RegIdx

unsigned int

Register index

FieldName

const char *

Field name

Value

uint64_t

The value to be set

temu_writePCIeConfigRegister

Include

#include "temu-c/Support/PCIeHelper.h"

Signature

void temu_writePCIeConfigRegister(temu_PCIExpressDevice * devConf, uint32_t offset, uint32_t value)

Description

Write value to PCIe config to the register with given offset.

Parameters

Table 478. temu_writePCIeConfigRegister Parameters
Parameter Type Description

devConf

temu_PCIExpressDevice *

PCIe configuration

offset

uint32_t

register offset in memory map.

value

uint32_t

new value fot the register

temu_writeProp

Include

#include "temu-c/Support/Objsys.h"

Signature

int temu_writeProp(temu_Object * Obj, const char * Name, int idx, temu_Propval * PV)

Description

Write property (with side effects)

Result

0 if the property was written

Parameters

Table 479. temu_writeProp Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

Name

const char *

Name of property

idx

int

Index in property array (set to 0 if scalar)

PV

temu_Propval *

Pointer to propval

temu_writeValue

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_writeValue(temu_Object * Obj, const char * PropName, temu_Propval Val, int Idx)

Description

Write a property value with side-effects

Parameters

Table 480. temu_writeValue Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

temu_Propval

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_writeValueDouble

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_writeValueDouble(temu_Object * Obj, const char * PropName, double Val, int Idx)

Description

Write floating point property (with side effects)

Parameters

Table 481. temu_writeValueDouble Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property

Val

double

The new property value

Idx

int

Index in property array (set to 0 if scalar)

temu_writeValueI16

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_writeValueI16(temu_Object * Obj, const char * PropName, int16_t Val, int Idx)

Description

Write a property value with side-effects

Parameters

Table 482. temu_writeValueI16 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

int16_t

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_writeValueI32

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_writeValueI32(temu_Object * Obj, const char * PropName, int32_t Val, int Idx)

Description

Write a property value with side-effects

Parameters

Table 483. temu_writeValueI32 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

int32_t

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_writeValueI64

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_writeValueI64(temu_Object * Obj, const char * PropName, int64_t Val, int Idx)

Description

Write a property value with side-effects

Parameters

Table 484. temu_writeValueI64 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

int64_t

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_writeValueI8

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_writeValueI8(temu_Object * Obj, const char * PropName, int8_t Val, int Idx)

Description

Write a property value with side-effects

Parameters

Table 485. temu_writeValueI8 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

int8_t

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_writeValueObj

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_writeValueObj(temu_Object * Obj, const char * PropName, temu_Object * Val, int Idx)

Description

Write a property value with side-effects

Parameters

Table 486. temu_writeValueObj Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

temu_Object *

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_writeValueSigned

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_writeValueSigned(temu_Object * Obj, const char * PropName, int64_t Val, int Idx)

Description

Write signed property (with side effects)

Parameters

Table 487. temu_writeValueSigned Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property

Val

int64_t

The new property value

Idx

int

Index in property array (set to 0 if scalar)

temu_writeValueU16

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_writeValueU16(temu_Object * Obj, const char * PropName, uint16_t Val, int Idx)

Description

Write a property value with side-effects

Parameters

Table 488. temu_writeValueU16 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

uint16_t

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_writeValueU32

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_writeValueU32(temu_Object * Obj, const char * PropName, uint32_t Val, int Idx)

Description

Write a property value with side-effects

Parameters

Table 489. temu_writeValueU32 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

uint32_t

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_writeValueU64

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_writeValueU64(temu_Object * Obj, const char * PropName, uint64_t Val, int Idx)

Description

Write a property value with side-effects

Parameters

Table 490. temu_writeValueU64 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

uint64_t

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_writeValueU8

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_writeValueU8(temu_Object * Obj, const char * PropName, uint8_t Val, int Idx)

Description

Write a property value with side-effects

Parameters

Table 491. temu_writeValueU8 Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property to read.

Val

uint8_t

The value to set. It must be of the correct type.

Idx

int

Index of property, set to 0 if it is not an array.

temu_writeValueUnsigned

Include

#include "temu-c/Support/Objsys.h"

Signature

void temu_writeValueUnsigned(temu_Object * Obj, const char * PropName, uint64_t Val, int Idx)

Description

Write unsigned property (with side effects)

Parameters

Table 492. temu_writeValueUnsigned Parameters
Parameter Type Description

Obj

temu_Object *

Object pointer

PropName

const char *

Name of property

Val

uint64_t

The new property value

Idx

int

Index in property array (set to 0 if scalar)

xemu_getBranchCounter

Include

#include "temu-c/Support/Profiling.h"

Signature

uint64_t * xemu_getBranchCounter(uint64_t src, uint64_t tgt)

Description

Get a branch counter for the specific arc

Result

Pointer to the counter

Parameters

Table 493. xemu_getBranchCounter Parameters
Parameter Type Description

src

uint64_t

Source physical address

tgt

uint64_t

Target physical address

xemu_writeBranchCounters

Include

#include "temu-c/Support/Profiling.h"

Signature

int xemu_writeBranchCounters(const char * fileName)

Description

Write branch counters in YAML format

Coverage is stored using physical addresses.

Result

0 if successful

Parameters

Table 494. xemu_writeBranchCounters Parameters
Parameter Type Description

fileName

const char *

Name of file to write