get-component-list – deprecated get-device-reg
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

get-device-offset

Synopsis

get-device-offset "bank" offset size [-l|-b]
read-device-offset "bank" offset size [-l|-b]

Description

Read and return the value from the bank object bank, i.e. device.bank.<bank-name>, or from other object implementing the transaction or io_memory interface. The old way to specify register banks (device.<bank-name>) is supported but deprecated. The offset is the byte offset from the start of the bank/object and size is the number of bytes to read, from 1 to 8. For devices that still use function numbers to identify memory mappings, the bank argument can be in the form device.<function_number>.

The get-device-offset command performs an inquiry read, typically used for non-intrusive inspection, while read-device-offset does a standard access that may trigger side-effects in the device. Note that not all device models support inquiry accesses.

Some devices, such as ones written in DML, provide a preferred byte endianness that data should be interpreted in. The command will use this endianness unless the -l or -b flags are used to select an alternate one.

Not all devices support accesses that span several registers or that accesses a register partially. (For DML 1.2 devices, such support must be enabled in the device when it is compiled. This limitation is planned to be removed in the next version of the language.)

Provided By

Simics Core

See Also

get-device-reg, read-device-offset, set-device-offset, set-device-reg, print-device-reg-info, print-device-regs
get-component-list – deprecated get-device-reg