standard-pcie-switch

Description

A standard PCIe switch with 4 downstream slots that contains the mandatory capabilities for a PCIe function in all ports.

Interfaces Implemented

conf_object, log_object

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.
state-change: Notifier on potential DML state change

Port Objects

dsp[0..3]: standard-pcie-switch.dsp
usp: standard-pcie-switch.usp

Commands for this class

info – print information about the object
status – print status of the object

Provided By

standard-pcie-switch

standard-pcie-switch.dsp

Interfaces Implemented

conf_object, log_object, pcie_device, pcie_hotplug_events, pcie_link_readiness, pcie_link_training, transaction_translator, translation_flush

Connects

clkreq (optional): Required interfaces: signal
upstream_target (optional): Required interfaces: pcie_map; Optional interfaces: io_memory, memory_space, pcie_link_control, port_space, ram, rom, transaction, transaction_translator, translator

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Port Objects

bank.msix_data: standard-pcie-switch.dsp.msix_data
bank.pcie_config: standard-pcie-switch.dsp.pcie_config
downstream_port: pcie-downstream-port – This class manages the downstream address spaces and connected devices for PCIe switches and Root Complexes
port.HRESET: standard-pcie-switch.dsp.HRESET
port._upstream_egress: standard-pcie-switch.dsp._upstream_egress
port._upstream_egress_dead_end: standard-pcie-switch.dsp._upstream_egress_dead_end
port.upstream_ingress: standard-pcie-switch.dsp.upstream_ingress
port.upstream_message: standard-pcie-switch.dsp.upstream_message – consumes Upstream PCIe Messages
port.upstream_message_router: standard-pcie-switch.dsp.upstream_message_router
upstream_ingress_targets: standard-pcie-switch.dsp.upstream_ingress_targets

Commands for interface transaction_translator

memory-map – print physical memory map
wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

Attributes

clkreq: Optional attribute; read/write access; type: o|[os]|n
CLKREQ output signal (active high)
Required interface: signal

standard-pcie-switch.dsp.HRESET

Interfaces Implemented

conf_object, log_object, signal

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

standard-pcie-switch.dsp._upstream_egress

Interfaces Implemented

conf_object, log_object, transaction_translator, translation_flush

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface transaction_translator

memory-map – print physical memory map
wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

standard-pcie-switch.dsp._upstream_egress_dead_end

Interfaces Implemented

conf_object, log_object, transaction

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface transaction

wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

standard-pcie-switch.dsp.msix_data

Interfaces Implemented

conf_object, log_object, bank_instrumentation_subscribe, instrumentation_order, register_view, register_view_catalog, register_view_read_only, transaction

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface bank_instrumentation_subscribe

bp-break-bank – set device access break
bp-run-until-bank – run until specified device access occurs
bp-trace-bank – enable tracing of device accesses
bp-wait-for-bank – wait for specified device access

Commands for interface instrumentation_order

instrumentation-move – reorder instrumentation connections
instrumentation-order – list instrumentation order for object

Commands for interface transaction

wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

standard-pcie-switch.dsp.pcie_config

Interfaces Implemented

conf_object, log_object, bank_instrumentation_subscribe, instrumentation_order, pcie_function_info, register_view, register_view_catalog, register_view_read_only, transaction

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface bank_instrumentation_subscribe

bp-break-bank – set device access break
bp-run-until-bank – run until specified device access occurs
bp-trace-bank – enable tracing of device accesses
bp-wait-for-bank – wait for specified device access

Commands for interface instrumentation_order

instrumentation-move – reorder instrumentation connections
instrumentation-order – list instrumentation order for object

Commands for interface pcie_function_info

pcie-dma-read – memory PCIe DMA Read
pcie-dma-write – memory PCIe (DMA) Write
pcie-memory-probe – probe an upstream PCIe DMA

Commands for interface transaction

wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

Attributes

function_number: Pseudo attribute; read-only access; type: i
PCIe function number of this bank
pcie_gen_speed: Optional attribute; read/write access; type: i
Based on the value of this attribute, the PCIe function will be configured to advertise its maximum supported link speed. It will advertise the highest supported link speed for the given PCIe generation. Note that this does not set the PCIe version of the device. The value of this attribute must be between 1 and 6.
pcie_link_width: Optional attribute; read/write access; type: i
Based on the value of this attribute, the PCIe function will be configured to advertise its maximum supported link width. The value of this attribute must be one of the following: 1, 2, 4, 8, or 16.

standard-pcie-switch.dsp.upstream_ingress

Interfaces Implemented

conf_object, log_object, pcie_ingress_handling, transaction_translator, translation_flush

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface transaction_translator

memory-map – print physical memory map
wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

standard-pcie-switch.dsp.upstream_ingress_targets

Interfaces Implemented

conf_object, log_object

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Port Objects

config: memory-space – Instances of the memory-space class provide linear address spaces into which devices and memory can be mapped.
io: memory-space – Instances of the memory-space class provide linear address spaces into which devices and memory can be mapped.
memory: memory-space – Instances of the memory-space class provide linear address spaces into which devices and memory can be mapped.
message: memory-space – Instances of the memory-space class provide linear address spaces into which devices and memory can be mapped.
port._dead_end: standard-pcie-switch.dsp.upstream_ingress_targets._dead_end
port.broadcast: standard-pcie-switch.dsp.upstream_ingress_targets.broadcast

standard-pcie-switch.dsp.upstream_ingress_targets._dead_end

Interfaces Implemented

conf_object, log_object, transaction

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface transaction

wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

standard-pcie-switch.dsp.upstream_ingress_targets.broadcast

Interfaces Implemented

conf_object, log_object, transaction

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface transaction

wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

standard-pcie-switch.dsp.upstream_message

Description

consumes Upstream PCIe Messages

Interfaces Implemented

conf_object, log_object, transaction

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface transaction

wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

standard-pcie-switch.dsp.upstream_message_router

Interfaces Implemented

conf_object, log_object, transaction_translator, translation_flush

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface transaction_translator

memory-map – print physical memory map
wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

standard-pcie-switch.usp

Interfaces Implemented

conf_object, log_object, pcie_device, transaction_translator, translation_flush

Connects

clkreq (optional): Required interfaces: signal
upstream_target (optional): Required interfaces: pcie_map; Optional interfaces: io_memory, memory_space, pcie_link_control, port_space, ram, rom, transaction, transaction_translator, translator

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Port Objects

bank.msix_data: standard-pcie-switch.usp.msix_data
bank.pcie_config: standard-pcie-switch.usp.pcie_config
downstream_port: pcie-downstream-port – This class manages the downstream address spaces and connected devices for PCIe switches and Root Complexes
port.HRESET: standard-pcie-switch.usp.HRESET
port._upstream_egress: standard-pcie-switch.usp._upstream_egress
port._upstream_egress_dead_end: standard-pcie-switch.usp._upstream_egress_dead_end
port.phy: standard-pcie-switch.usp.phy
port.upstream_ingress: standard-pcie-switch.usp.upstream_ingress
port.upstream_message: standard-pcie-switch.usp.upstream_message – consumes Upstream PCIe Messages
port.upstream_message_router: standard-pcie-switch.usp.upstream_message_router
upstream_ingress_targets: standard-pcie-switch.usp.upstream_ingress_targets

Commands for interface transaction_translator

memory-map – print physical memory map
wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

Attributes

clkreq: Optional attribute; read/write access; type: o|[os]|n
CLKREQ output signal (active high)
Required interface: signal

standard-pcie-switch.usp.HRESET

Interfaces Implemented

conf_object, log_object, signal

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

standard-pcie-switch.usp._upstream_egress

Interfaces Implemented

conf_object, log_object, transaction_translator, translation_flush

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface transaction_translator

memory-map – print physical memory map
wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

standard-pcie-switch.usp._upstream_egress_dead_end

Interfaces Implemented

conf_object, log_object, transaction

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface transaction

wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

standard-pcie-switch.usp.msix_data

Interfaces Implemented

conf_object, log_object, bank_instrumentation_subscribe, instrumentation_order, register_view, register_view_catalog, register_view_read_only, transaction

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface bank_instrumentation_subscribe

bp-break-bank – set device access break
bp-run-until-bank – run until specified device access occurs
bp-trace-bank – enable tracing of device accesses
bp-wait-for-bank – wait for specified device access

Commands for interface instrumentation_order

instrumentation-move – reorder instrumentation connections
instrumentation-order – list instrumentation order for object

Commands for interface transaction

wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

standard-pcie-switch.usp.pcie_config

Interfaces Implemented

conf_object, log_object, bank_instrumentation_subscribe, instrumentation_order, pcie_function_info, register_view, register_view_catalog, register_view_read_only, transaction

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface bank_instrumentation_subscribe

bp-break-bank – set device access break
bp-run-until-bank – run until specified device access occurs
bp-trace-bank – enable tracing of device accesses
bp-wait-for-bank – wait for specified device access

Commands for interface instrumentation_order

instrumentation-move – reorder instrumentation connections
instrumentation-order – list instrumentation order for object

Commands for interface pcie_function_info

pcie-dma-read – memory PCIe DMA Read
pcie-dma-write – memory PCIe (DMA) Write
pcie-memory-probe – probe an upstream PCIe DMA

Commands for interface transaction

wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

Attributes

function_number: Pseudo attribute; read-only access; type: i
PCIe function number of this bank
pcie_gen_speed: Optional attribute; read/write access; type: i
Based on the value of this attribute, the PCIe function will be configured to advertise its maximum supported link speed. It will advertise the highest supported link speed for the given PCIe generation. Note that this does not set the PCIe version of the device. The value of this attribute must be between 1 and 6.
pcie_link_width: Optional attribute; read/write access; type: i
Based on the value of this attribute, the PCIe function will be configured to advertise its maximum supported link width. The value of this attribute must be one of the following: 1, 2, 4, 8, or 16.

standard-pcie-switch.usp.phy

Interfaces Implemented

conf_object, log_object, pcie_link_readiness, transaction

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface transaction

wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

standard-pcie-switch.usp.upstream_ingress

Interfaces Implemented

conf_object, log_object, pcie_ingress_handling, transaction_translator, translation_flush

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface transaction_translator

memory-map – print physical memory map
wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

standard-pcie-switch.usp.upstream_ingress_targets

Interfaces Implemented

conf_object, log_object

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Port Objects

config: memory-space – Instances of the memory-space class provide linear address spaces into which devices and memory can be mapped.
io: memory-space – Instances of the memory-space class provide linear address spaces into which devices and memory can be mapped.
memory: memory-space – Instances of the memory-space class provide linear address spaces into which devices and memory can be mapped.
message: memory-space – Instances of the memory-space class provide linear address spaces into which devices and memory can be mapped.
port._dead_end: standard-pcie-switch.usp.upstream_ingress_targets._dead_end
port.broadcast: standard-pcie-switch.usp.upstream_ingress_targets.broadcast

standard-pcie-switch.usp.upstream_ingress_targets._dead_end

Interfaces Implemented

conf_object, log_object, transaction

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface transaction

wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

standard-pcie-switch.usp.upstream_ingress_targets.broadcast

Interfaces Implemented

conf_object, log_object, transaction

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface transaction

wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

standard-pcie-switch.usp.upstream_message

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface transaction

wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete

standard-pcie-switch.usp.upstream_message_router

Interfaces Implemented

conf_object, log_object, transaction_translator, translation_flush

Notifiers

cell-change: Notifier that is triggered after the object's cell was changed.
object-delete: Notifier that is triggered just before Simics object is deleted.
queue-change: Notifier that is triggered after the object's clock was changed. New clock can be obtained with the SIM_object_clock function.

Commands for interface transaction_translator

memory-map – print physical memory map
wait-for-get – issue an inquiry read transaction and wait for it to complete
wait-for-read – issue a read transaction and wait for it to complete
wait-for-set – issue an inquiry write transaction and wait for it to complete
wait-for-write – issue a write transaction and wait for it to complete