Emulate

For conceptual usage, see:

MemEmulate

Implementation

This Python API is provided by a Rogue C++ class exported into Python.

Native C++ class: - Emulate

Generated API

class rogue.interfaces.memory.Emulate(min, max)

C++: rogue::interfaces::memory::Emulate

Binding source: [Emulate.cpp]

Memory interface emulator device.

Responds to memory read and write transactions and allocates backing memory on demand. This is primarily used for testing Rogue memory trees without hardware.

__init__(min, max)

C++: rogue::interfaces::memory::Emulate

Constructs an emulator device.

This constructor is a low-level C++ allocation path. Prefer create() when shared ownership or Python exposure is required.

Parameters:

min – Minimum transaction size in bytes, or 0 if not a virtual root.
max – Maximum transaction size in bytes, or 0 if not a virtual root.

setName(name)

C++: rogue::interfaces::memory::Slave::setName()

Sets slave name.

Exposed to Python as setName.

Parameters:: name – New slave name string.

_addTransaction(transaction)

C++: rogue::interfaces::memory::Slave::addTransaction()

Adds a transaction to the internal tracking map.

This method is called by the sub-class to add a transaction into the local tracking map for later retrieval. This is used when the transaction will be completed later as the result of protocol data being returned to the Slave. Exposed to Python as _addTransaction().

Parameters:: transaction – Pointer to transaction as TransactionPtr.

_getTransaction(index)

C++: rogue::interfaces::memory::Slave::getTransaction()

Gets a transaction from the internal tracking map.

This method is called by the sub-class to retrieve an existing transaction using the unique transaction ID. If the transaction exists in the list the pointer to that transaction will be returned. If not a NULL pointer will be returned. When getTransaction() is called the map will also be checked for stale transactions which will be removed from the map. Exposed to Python as _getTransaction().