<transaction_translator>.wait-for-get <transaction_translator>.wait-for-set
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

<transaction_translator>.wait-for-read

Synopsis

<transaction_translator>.wait-for-read address [size] [-l|-b] [initiator]

Description

The command issues a read transaction (via 'SIM_issue_transaction') to address. For objects implementing multiple memory transaction interfaces, the interface chosen is determined by the SIM_new_map_target call. The SIM_new_map_target call documents the priority of each memory transaction interface. If the transaction is not completed immediately the command postpones the execution of a script branch until the transaction is completed.

The size argument specifies how many bytes should be read. It defaults to 4, but can be set to any positive value.

Providing initiator is rarely needed, but some devices may only accept accesses from certain initiating objects. If provided, initiator is the object that will be used as the source of the access.

The -l and -b flags are used to select little-endian or big-endian byte order, respectively. They determine how the bytes in memory should be interpreted as a value. If neither is given, the byte order of the initiator is used if specified and a processor, or else the order of the current frontend processor.

When used in an expression the command returns the value read.

If a request fails an error is reported.

Provided By

Simics Core

See Also

wait-for-read, wait-for-write, wait-for-get, wait-for-set
<transaction_translator>.wait-for-get <transaction_translator>.wait-for-set