<pcie-downstream-port>.status <pcie_function_info>.pcie-dma-write
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

<pcie_function_info>.pcie-dma-read

Synopsis

<pcie_function_info>.pcie-dma-read address [size] [-l] [-b] [-inquiry] [-add-atoms]

Description

PCIe DMA read from a PCIe function. The DMA will be of size bytes to address. The default size is 4 bytes, but it can be anywhere between 1 and 1024 inclusive. This command will issue a transaction with the payload and flags set, pcie_requester_id atom set to the device id of the PCIe function, the pcie_type atom set to PCIE_Type_Mem and the initiator atom set to the function object. It will issue the transaction to the upstream target of the PCIe device the function belongs to.

The -inquiry flag is used to mark the issued transaction as an inquiry, which result in the DMA setting the memory without any side-effects. By default, the transaction is not using the inquiry flag.

The -l and -b flags are used to select little-endian or big-endian byte order, respectively used to determine how the bytes in memory should be interpreted as a value. If neither is given, then little endian is used.

Transaction atoms can be used for routing rules and access rights in a platform. The -add-atoms flag opens up the capability to set transaction atoms on the command line: once the flag is set the command accepts additional arguments that have names starting with ATOM_ prefix. Tab complete after setting the -add-atoms flag to see the available atoms. These arguments are used by the command to pass in atom values to the translators it passes through during the transaction probing.

Please note that the ATOM_... arguments can be used only to specify values for transaction atoms that have integer values and provide Python wrappings. Complex atoms such as pointers and structures are not available from CLI.

Note! The data, flags, pcie_requester_id, pcie_type and initiator atoms will be ignored if they are set using the -add-atoms as those are added by this command.

Provided By

Simics Core

See Also

<pcie_function_info>.pcie-dma-write
<pcie-downstream-port>.status <pcie_function_info>.pcie-dma-write