VIRTUTECH CONFIDENTIAL    Previous - Up - Next

4   Supported Components

The following sections list components that are supported for the SunFire architecture. There also exist other components in Simics, such as various PCI devices, that may work for SunFire but that have not been tested.

The default machines are constructed from components in the -system.include files in [simics]/targets/sunfire/. See the Configuration and Checkpointing chapter in the Simics User Guide for information on how to define your own machine, or make modifications to an existing machine.

4.1   SunFire Components

4.1.1   sunfire-3500-backplane

Description
The "sunfire-3500-backplane" component represents the chassis, backplane and clock-board of a Sun Enterprise 3500 server, with slots for up to five boards.
Attributes
cpu_frequency
Required attribute; read/write access; type: Integer.

Processor frequency in MHz. Supported frequencies are 168, 200, 248, 296, 336, 360, 400, 464, 496, 592, 720, 800, 992.

hostid
Required attribute; read/write access; type: Integer.

The hostid of the machine.

mac_address
Required attribute; read/write access; type: String.

The main MAC address is the machine.

master_cpu
Optional attribute; read/write access; type: s|o.

Internal attribute.

obp_bugfix_done
Optional attribute; read/write access; type: b.

Internal attribute.

rtc_time
Required attribute; read/write access; type: String.

The date and time of the Real-Time clock.

Commands
create-sunfire-3500-backplane ["name"] cpu_frequency hostid "mac_address" "rtc_time"
Creates a non-instantiated component of the class "sunfire-3500-backplane". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sunfire-3500-backplane>.get-nvram-hostid
Reads the Sun hostid from the NVRAM.
<sunfire-3500-backplane>.get-nvram-mac
Reads the default MAC address from the NVRAM.
<sunfire-3500-backplane>.get-prom-env ["variable"]
Prints an OBP variable with its value, or all variables if no argument is specified. Only variables with string, integer, boolean and enumeration types are supported.
<sunfire-3500-backplane>.info
Print detailed information about the configuration of the device.
<sunfire-3500-backplane>.key-switch ["position"]
Changes the position of the key-switch on the clock-board. Possible arguments are "diag", "insecure" and "secure". If no argument is specified, the current position is reported.
<sunfire-3500-backplane>.set-nvram-hostid hostid
Writes the Sun hostid into the NVRAM.
<sunfire-3500-backplane>.set-nvram-mac "mac"
Writes the default MAC address into the NVRAM.
<sunfire-3500-backplane>.set-prom-defaults
Restores all OBP variables to their default values.
<sunfire-3500-backplane>.set-prom-env "variable" (int|"string")
Sets the value OBP variable in the NVRAM. Only variables with string, integer, boolean and enumeration types are supported.
<sunfire-3500-backplane>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
central-cpusunfire-central-cpudown
keyboardserialdown
mouseserialdown
remote_consoleserialdown
slot[0-15]sunfire-backplanedown
ttyaserialdown
ttybserialdown

4.1.2   sunfire-4500-backplane

Description
The "sunfire-4500-backplane" component represents the chassis, backplane and clock-board of a Sun Enterprise 4500 server, with slots for up to eight boards.
Attributes
cpu_frequency
Required attribute; read/write access; type: Integer.

Processor frequency in MHz. Supported frequencies are 168, 200, 248, 296, 336, 360, 400, 464, 496, 592, 720, 800, 992.

hostid
Required attribute; read/write access; type: Integer.

The hostid of the machine.

mac_address
Required attribute; read/write access; type: String.

The main MAC address is the machine.

master_cpu
Optional attribute; read/write access; type: s|o.

Internal attribute.

obp_bugfix_done
Optional attribute; read/write access; type: b.

Internal attribute.

rtc_time
Required attribute; read/write access; type: String.

The date and time of the Real-Time clock.

Commands
create-sunfire-4500-backplane ["name"] cpu_frequency hostid "mac_address" "rtc_time"
Creates a non-instantiated component of the class "sunfire-4500-backplane". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sunfire-4500-backplane>.get-nvram-hostid
Reads the Sun hostid from the NVRAM.
<sunfire-4500-backplane>.get-nvram-mac
Reads the default MAC address from the NVRAM.
<sunfire-4500-backplane>.get-prom-env ["variable"]
Prints an OBP variable with its value, or all variables if no argument is specified. Only variables with string, integer, boolean and enumeration types are supported.
<sunfire-4500-backplane>.info
Print detailed information about the configuration of the device.
<sunfire-4500-backplane>.key-switch ["position"]
Changes the position of the key-switch on the clock-board. Possible arguments are "diag", "insecure" and "secure". If no argument is specified, the current position is reported.
<sunfire-4500-backplane>.set-nvram-hostid hostid
Writes the Sun hostid into the NVRAM.
<sunfire-4500-backplane>.set-nvram-mac "mac"
Writes the default MAC address into the NVRAM.
<sunfire-4500-backplane>.set-prom-defaults
Restores all OBP variables to their default values.
<sunfire-4500-backplane>.set-prom-env "variable" (int|"string")
Sets the value OBP variable in the NVRAM. Only variables with string, integer, boolean and enumeration types are supported.
<sunfire-4500-backplane>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
central-cpusunfire-central-cpudown
keyboardserialdown
mouseserialdown
remote_consoleserialdown
slot[0-15]sunfire-backplanedown
ttyaserialdown
ttybserialdown

4.1.3   sunfire-6500-backplane

Description
The "sunfire-6500-backplane" component represents the chassis, backplane and clock-board of a Sun Enterprise 6500 server, with slots for up to sixteen boards.
Attributes
cpu_frequency
Required attribute; read/write access; type: Integer.

Processor frequency in MHz. Supported frequencies are 168, 200, 248, 296, 336, 360, 400, 464, 496, 592, 720, 800, 992.

hostid
Required attribute; read/write access; type: Integer.

The hostid of the machine.

mac_address
Required attribute; read/write access; type: String.

The main MAC address is the machine.

master_cpu
Optional attribute; read/write access; type: s|o.

Internal attribute.

obp_bugfix_done
Optional attribute; read/write access; type: b.

Internal attribute.

rtc_time
Required attribute; read/write access; type: String.

The date and time of the Real-Time clock.

Commands
create-sunfire-6500-backplane ["name"] cpu_frequency hostid "mac_address" "rtc_time"
Creates a non-instantiated component of the class "sunfire-6500-backplane". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sunfire-6500-backplane>.get-nvram-hostid
Reads the Sun hostid from the NVRAM.
<sunfire-6500-backplane>.get-nvram-mac
Reads the default MAC address from the NVRAM.
<sunfire-6500-backplane>.get-prom-env ["variable"]
Prints an OBP variable with its value, or all variables if no argument is specified. Only variables with string, integer, boolean and enumeration types are supported.
<sunfire-6500-backplane>.info
Print detailed information about the configuration of the device.
<sunfire-6500-backplane>.key-switch ["position"]
Changes the position of the key-switch on the clock-board. Possible arguments are "diag", "insecure" and "secure". If no argument is specified, the current position is reported.
<sunfire-6500-backplane>.set-nvram-hostid hostid
Writes the Sun hostid into the NVRAM.
<sunfire-6500-backplane>.set-nvram-mac "mac"
Writes the default MAC address into the NVRAM.
<sunfire-6500-backplane>.set-prom-defaults
Restores all OBP variables to their default values.
<sunfire-6500-backplane>.set-prom-env "variable" (int|"string")
Sets the value OBP variable in the NVRAM. Only variables with string, integer, boolean and enumeration types are supported.
<sunfire-6500-backplane>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
central-cpusunfire-central-cpudown
keyboardserialdown
mouseserialdown
remote_consoleserialdown
slot[0-15]sunfire-backplanedown
ttyaserialdown
ttybserialdown

4.1.4   sunfire-cpu-board

Description
The "sunfire-cpu-board" component represents a processor board with up to two UltraSPARC II processors and 4GB of memory, for use in Sun Enterprise 3500-6500 servers.
Attributes
memory_megs
Required attribute; read/write access; type: Integer.

The amount of RAM in megabytes on the processor board.

num_cpus
Required attribute; read/write access; type: Integer.

Number of processors on the board (1 or 2).

Commands
create-sunfire-cpu-board ["name"] num_cpus memory_megs
Creates a non-instantiated component of the class "sunfire-cpu-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sunfire-cpu-board>.info
Print detailed information about the configuration of the device.
<sunfire-cpu-board>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
backplanesunfire-backplaneup
central-cpusunfire-central-cpuup
cache-cpu[0-1]timing-modeldown

4.1.5   sunfire-sbus-board

Description
The "sunfire-sbus-board" component represents an I/O board with slots for up to three SBus cards, for use in Sun Enterprise 3500-6500 servers. The board has one HME ethernet controller and one FAS SCSI controller on-board.

The UPA in the table is relative the first UPA on the board. (The UPA is an identifier for each CPU and I/O controller in the system. There are two UPAs per board, resulting in a total of 32.)

SBus slot mappings:

Simics slotUPASBus SlotBus addressNote
0101,0 at 0,0
1010,0 at 1,0
2020,0 at 2,0
3131,0 at 3,0On-board fas, hme
Attributes
mac_address
Required attribute; read/write access; type: String.

The MAC address of the onboard Ethernet adapter.

scsi_id
Optional attribute; read/write access; type: Integer.

The ID on the SCSI bus.

Commands
create-sunfire-sbus-board ["name"] "mac_address" [scsi_id]
Creates a non-instantiated component of the class "sunfire-sbus-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sunfire-sbus-board>.info
Print detailed information about the configuration of the device.
<sunfire-sbus-board>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
backplanesunfire-backplaneup
ethernetethernet-linkdown
scsi-busscsi-busdown
slot[0-2]sun-sbusdown

4.1.6   sunfire-pci-board

Description
The "sunfire-pci-board" component represents an I/O board with slots for up to two PCI cards, for use in Sun Enterprise 3500-6500 servers. The board has one HME ethernet controller and one ISP SCSI controller on-board.

The UPA in the table is relative the first UPA on the board. (The UPA is an identifier for each CPU and I/O controller in the system. There are two UPAs per board, resulting in a total of 32.)

PCI slot mappings:

Simics slotUPAPCI BusPCI SlotBus addressNote
00A20,2000
10B10,4000On-board hme
21A21,2000
31B31,4000On board isp
Attributes
mac_address
Required attribute; read/write access; type: String.

The MAC address of the onboard Ethernet adapter.

scsi_id
Optional attribute; read/write access; type: Integer.

The ID on the SCSI bus.

Commands
create-sunfire-pci-board ["name"] "mac_address" [scsi_id]
Creates a non-instantiated component of the class "sunfire-pci-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sunfire-pci-board>.info
Print detailed information about the configuration of the device.
<sunfire-pci-board>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
backplanesunfire-backplaneup
ethernetethernet-linkdown
pci-slot0pci-busdown
pci-slot2pci-busdown
scsi-busscsi-busdown

4.2   SBus and PCI Device Components

4.2.1   sun-sbus-fas-hme

Description
The "sun-sbus-fas-hme" component represents an SBus card with one HME ethernet controller and one FAS SCSI controller for use in Sun systems.
Attributes
mac_address
Required attribute; read/write access; type: String.

The MAC address of the Ethernet adapter.

scsi_id
Optional attribute; read/write access; type: Integer.

The ID on the SCSI bus.

Commands
create-sun-sbus-fas-hme ["name"] "mac_address" [scsi_id]
Creates a non-instantiated component of the class "sun-sbus-fas-hme". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sun-sbus-fas-hme>.info
Print detailed information about the configuration of the device.
<sun-sbus-fas-hme>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
sbussun-sbusup
ethernetethernet-linkdown
scsi-busscsi-busdown

4.2.2   sun-pci-ce

Description
The "sun-pci-ce" component represents a PCI card with a Cassini gigabit Ethernet adapter, for use in Sun systems.
Attributes
mac_address
Required attribute; read/write access; type: String.

The MAC address of the Ethernet adapter.

Commands
create-sun-pci-ce ["name"] "mac_address"
Creates a non-instantiated component of the class "sun-pci-ce". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sun-pci-ce>.info
Print detailed information about the configuration of the device.
<sun-pci-ce>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
pci-buspci-busup
ethernetethernet-linkdown

4.2.3   sun-pci-hme

Description
The "sun-pci-hme" component represents a PCI card with a HME Ethernet adapter, for use in Sun systems.
Attributes
mac_address
Required attribute; read/write access; type: String.

The MAC address of the Ethernet adapter.

Commands
create-sun-pci-hme ["name"] "mac_address"
Creates a non-instantiated component of the class "sun-pci-hme". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sun-pci-hme>.info
Print detailed information about the configuration of the device.
<sun-pci-hme>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
pci-buspci-busup
ethernetethernet-linkdown

4.2.4   sun-pci-hme-isp

Description
The "sun-pci-hme-isp" component represents a PCI card with one HME Ethernet adapter and one ISP SCSI controller for use in Sun systems.
Attributes
mac_address
Required attribute; read/write access; type: String.

The MAC address of the Ethernet adapter.

scsi_id
Optional attribute; read/write access; type: Integer.

The ID on the SCSI bus.

Commands
create-sun-pci-hme-isp ["name"] "mac_address" [scsi_id]
Creates a non-instantiated component of the class "sun-pci-hme-isp". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sun-pci-hme-isp>.info
Print detailed information about the configuration of the device.
<sun-pci-hme-isp>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
pci-buspci-busup
ethernetethernet-linkdown
scsi-busscsi-busdown

4.2.5   sun-pci-pgx64

Description
The "sun-pci-pgx64" component represents a PCI card with a PGX64 (Rage XL) graphics adapter, for use in Sun systems.
Commands
create-sun-pci-pgx64 ["name"]
Creates a non-instantiated component of the class "sun-pci-pgx64". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sun-pci-pgx64>.info
Print detailed information about the configuration of the device.
<sun-pci-pgx64>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
pci-buspci-busup
consolegraphics-consoledown

4.2.6   sun-pci-qlc

Description
The "sun-pci-qlc" component represents a PCI card with a QLC Fibre-Channel SCSI controller for use in Sun systems.
Attributes
loop_id
Required attribute; read/write access; type: Integer.

The FC loop ID of the QLC controller.

Commands
create-sun-pci-qlc ["name"] loop_id
Creates a non-instantiated component of the class "sun-pci-qlc". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sun-pci-qlc>.info
Print detailed information about the configuration of the device.
<sun-pci-qlc>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
pci-buspci-busup
fc-loopsimple-fc-loopdown

4.2.7   sun-pci-qlc-qlc

Description
The "sun-pci-qlc-qlc" component represents a PCI card with two QLC Fibre-Channel SCSI controller for use in Sun systems.
Attributes
loop_id0
Required attribute; read/write access; type: Integer.

The FC loop ID of the first QLC controller.

loop_id1
Required attribute; read/write access; type: Integer.

The FC loop ID of the second QLC controller.

Commands
create-sun-pci-qlc-qlc ["name"] loop_id0 loop_id1
Creates a non-instantiated component of the class "sun-pci-qlc-qlc". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sun-pci-qlc-qlc>.info
Print detailed information about the configuration of the device.
<sun-pci-qlc-qlc>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
pci-buspci-busup
fc-loop[0-1]simple-fc-loopdown

4.2.8   pci-bcm5703c

Description
The "pci-bcm5703c" component represents a Broadcom 5703C PCI based gigabit Ethernet adapter.
Attributes
bios
Optional attribute; read/write access; type: String.

The x86 BIOS file to use.

mac_address
Required attribute; read/write access; type: String.

The MAC address of the Ethernet adapter.

Commands
create-pci-bcm5703c ["name"] "mac_address" ["bios"]
Creates a non-instantiated component of the class "pci-bcm5703c". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<pci-bcm5703c>.info
Print detailed information about the configuration of the device.
<pci-bcm5703c>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
pci-buspci-busup
ethernetethernet-linkdown

4.2.9   pci-bcm5704c

Description
The "pci-bcm5704c" component represents a Broadcom 5704C PCI based dual-port gigabit Ethernet adapter.
Attributes
bios
Optional attribute; read/write access; type: String.

The x86 BIOS file to use.

mac_address0
Required attribute; read/write access; type: String.

The MAC address of the first Ethernet adapter.

mac_address1
Required attribute; read/write access; type: String.

The MAC address of the second Ethernet adapter.

Commands
create-pci-bcm5704c ["name"] "mac_address0" "mac_address1" ["bios"]
Creates a non-instantiated component of the class "pci-bcm5704c". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<pci-bcm5704c>.info
Print detailed information about the configuration of the device.
<pci-bcm5704c>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
pci-buspci-busup
ethernet[0-1]ethernet-linkdown

4.2.10   pci-sym53c875

Description
The "pci-sym53C875" component represents a SYM53C875PCI based SCSI controller.
Attributes
bios
Optional attribute; read/write access; type: String.

The x86 SCSI BIOS file to use.

Commands
create-pci-sym53c875 ["name"] ["bios"]
Creates a non-instantiated component of the class "pci-sym53c875". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<pci-sym53c875>.info
Print detailed information about the configuration of the device.
<pci-sym53c875>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
pci-buspci-busup
scsi-busscsi-busdown

4.2.11   pci-sym53c876

Description
The "pci-sym53C876" component represents a SYM53C876PCI based dual-port SCSI controller.
Commands
create-pci-sym53c876 ["name"]
Creates a non-instantiated component of the class "pci-sym53c876". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<pci-sym53c876>.info
Print detailed information about the configuration of the device.
<pci-sym53c876>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
pci-buspci-busup
scsi-bus[0-1]scsi-busdown

4.3   Standard Components

4.3.1   std-ethernet-link

Description
The "std-ethernet-link" component represents a standard Ethernet link.
Attributes
frame_echo
Optional attribute; read/write access; type: Integer.

Set this attribute to echo frames back to the sender. Default is not to echo frames.

link_name
Optional attribute; read/write access; type: String.

The name to use for the ethernet-link object. An error will be raised at instantiation time if the link cannot be given this name.

Commands
create-std-ethernet-link ["name"] ["link_name"] [frame_echo]
Creates a non-instantiated component of the class "std-ethernet-link". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
new-std-ethernet-link ["name"] ["link_name"] [frame_echo]
Creates an instantiated component of the class "std-ethernet-link". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<std-ethernet-link>.info
Print detailed information about the configuration of the device.
<std-ethernet-link>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
deviceethernet-linkany

4.3.2   std-service-node

Description
The "std-service-node" component represents a network service node that can be connected to Ethernet links to provide services such as DNS, DHCP/BOOTP, RARP and TFTP. A service node component does not have any connectors by default. Instead, connectors have to be added using the <std-service-node>.add-connector command.
Attributes
dynamic_connectors
Optional attribute; read/write access; type: [[iss]*].

List of user added connectors

next_connector_id
Optional attribute; read/write access; type: Integer.

Next service-node device ID.

Commands
create-std-service-node ["name"]
Creates a non-instantiated component of the class "std-service-node". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
new-std-service-node ["name"]
Creates an instantiated component of the class "std-service-node". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<std-service-node>.add-connector "ip" ["netmask"]
Adds a connector to the service-node with specified IP address and netmask. A connector must be created for the service-node before an Ethernet link can be connected to it. The ip argument is the IP address that the service node will use on the link. The netmask argument is optional, and defaults to 255.255.255.0.
The name of the new connector is returned.
<std-service-node>.info
Print detailed information about the configuration of the device.
<std-service-node>.status
Print detailed information about the current status of the device.

4.3.3   std-scsi-bus

Description
The "std-scsi-bus" component represents a 16 slot SCSI bus.
Commands
create-std-scsi-bus ["name"]
Creates a non-instantiated component of the class "std-scsi-bus". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<std-scsi-bus>.info
Print detailed information about the configuration of the device.
<std-scsi-bus>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
scsi-busscsi-busany

4.3.4   std-scsi-disk

Description
The "std-scsi-disk" component represents a SCSI-2 disk.
Attributes
file
Optional attribute; read/write access; type: String.

File with disk contents for the full disk Either a raw file or a CRAFF file.

scsi_id
Required attribute; read/write access; type: Integer.

The ID on the SCSI bus.

size
Required attribute; read/write access; type: Integer.

The size of the SCSI disk in bytes.

Commands
create-std-scsi-disk ["name"] scsi_id size ["file"]
Creates a non-instantiated component of the class "std-scsi-disk". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<std-scsi-disk>.info
Print detailed information about the configuration of the device.
<std-scsi-disk>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
scsi-busscsi-busup

4.3.5   std-scsi-cdrom

Description
The "std-scsi-cdrom" component represents a SCSI-2 CD-ROM.
Attributes
scsi_id
Required attribute; read/write access; type: Integer.

The ID on the SCSI bus.

Commands
create-std-scsi-cdrom ["name"] scsi_id
Creates a non-instantiated component of the class "std-scsi-cdrom". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<std-scsi-cdrom>.info
Print detailed information about the configuration of the device.
<std-scsi-cdrom>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
scsi-busscsi-busup

4.3.6   simple-fc-disk

Description
The "simple-fc-disk" component represents a SCSI-2 disk for use with Fibre-Channel SCSI controllers using the simplified FC protocol in Simics.
Attributes
file
Optional attribute; read/write access; type: String.

File with disk contents for the full disk Either a raw file or a CRAFF file.

loop_id
Required attribute; read/write access; type: Integer.

The loop ID for the FC disk.

node_name
Required attribute; read/write access; type: Integer.

The node name for the FC disk.

port_name
Required attribute; read/write access; type: Integer.

The port name for the FC disk.

size
Required attribute; read/write access; type: Integer.

The size of the FC disk in bytes.

Commands
create-simple-fc-disk ["name"] size ["file"] loop_id node_name port_name
Creates a non-instantiated component of the class "simple-fc-disk". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<simple-fc-disk>.info
Print detailed information about the configuration of the device.
<simple-fc-disk>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
fc-loopsimple-fc-loopup

4.3.7   std-text-console

Description
The "std-text-console" component represents a serial text console.
Attributes
bg_color
Optional attribute; read/write access; type: String.

The background color.

fg_color
Optional attribute; read/write access; type: String.

The foreground color.

height
Optional attribute; read/write access; type: Integer.

The height of the console window.

title
Optional attribute; read/write access; type: String.

The Window title.

width
Optional attribute; read/write access; type: Integer.

The width of the console window.

win32_font
Optional attribute; read/write access; type: String.

Font to use in the console on Windows host.

x11_font
Optional attribute; read/write access; type: String.

Font to use in the console when using X11 (Linux/Solaris host).

Commands
create-std-text-console ["name"] ["title"] ["bg_color"] ["fg_color"] ["x11_font"] ["win32_font"] [width] [height]
Creates a non-instantiated component of the class "std-text-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
new-std-text-console ["name"] ["title"] ["bg_color"] ["fg_color"] ["x11_font"] ["win32_font"] [width] [height]
Creates an instantiated component of the class "std-text-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<std-text-console>.info
Print detailed information about the configuration of the device.
<std-text-console>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
serialserialup

4.3.8   std-server-console

Description
The "std-server-console" component represents a serial console accessible from the host using telnet.
Attributes
telnet_port
Required attribute; read/write access; type: Integer.

TCP/IP port to connect the telnet service of the console to.

Commands
create-std-server-console ["name"] telnet_port
Creates a non-instantiated component of the class "std-server-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
new-std-server-console ["name"] telnet_port
Creates an instantiated component of the class "std-server-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<std-server-console>.info
Print detailed information about the configuration of the device.
<std-server-console>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
serialserialup

4.3.9   std-graphics-console

Description
The "std-graphics-console" component represents a graphical console for displaying output from a simulated graphics adapters and getting input for mouse and keyboard devices.
Attributes
window
Optional attribute; read/write access; type: b.

Try to open window if TRUE (default). FALSE disabled the window.

Commands
create-std-graphics-console ["name"] [window]
Creates a non-instantiated component of the class "std-graphics-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
new-std-graphics-console ["name"] [window]
Creates an instantiated component of the class "std-graphics-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<std-graphics-console>.info
Print detailed information about the configuration of the device.
<std-graphics-console>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
devicegraphics-consoleup
keyboardkeyboardup
mousemouseup

4.3.10   std-text-graphics-console

Description
The "std-text-graphics-console" component represents a text console for use with VGA instead of a graphics console.
Commands
create-std-text-graphics-console ["name"]
Creates a non-instantiated component of the class "std-text-graphics-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
new-std-text-graphics-console ["name"]
Creates an instantiated component of the class "std-text-graphics-console". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<std-text-graphics-console>.info
Print detailed information about the configuration of the device.
<std-text-graphics-console>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
devicegraphics-consoleup
keyboardkeyboardup

4.4   Other Device Components

4.4.1   sun-type5-keyboard

Description
The "sun-type5-keyboard" component represents a Sun Type 5 serial keyboard for use in Sun systems.
Commands
create-sun-type5-keyboard ["name"]
Creates a non-instantiated component of the class "sun-type5-keyboard". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
new-sun-type5-keyboard ["name"]
Creates an instantiated component of the class "sun-type5-keyboard". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sun-type5-keyboard>.info
Print detailed information about the configuration of the device.
<sun-type5-keyboard>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
deviceserialup
consolekeyboarddown

4.4.2   sun-type5-mouse

Description
The "sun-type5-mouse" component represents a Sun Type 5 serial mouse for use in Sun systems.
Commands
create-sun-type5-mouse ["name"]
Creates a non-instantiated component of the class "sun-type5-mouse". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
new-sun-type5-mouse ["name"]
Creates an instantiated component of the class "sun-type5-mouse". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sun-type5-mouse>.info
Print detailed information about the configuration of the device.
<sun-type5-mouse>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
deviceserialup
consolemousedown

4.5   Timing Components

4.5.1   sample-gcache

Description
A pre-configured combined L1 instruction and data cache
Commands
create-sample-gcache ["name"]
Creates a non-instantiated component of the class "sample-gcache". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
new-sample-gcache ["name"]
Creates an instantiated component of the class "sample-gcache". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sample-gcache>.info
Print detailed information about the configuration of the device.
<sample-gcache>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
cpu-spacetiming-modelup

4.5.2   sample-ma-model

Description
A sample SPARC MAI model with a simple cache
Commands
create-sample-ma-model ["name"]
Creates a non-instantiated component of the class "sample-ma-model". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
new-sample-ma-model ["name"]
Creates an instantiated component of the class "sample-ma-model". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sample-ma-model>.info
Print detailed information about the configuration of the device.
<sample-ma-model>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
cpu-spacetiming-modelup

4.5.3   sample-ooo-model

Description

A sample SPARC MAI model based on ooo_micro_arch and a simple cache.

Commands
create-sample-ooo-model ["name"]
Creates a non-instantiated component of the class "sample-ooo-model". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
new-sample-ooo-model ["name"]
Creates an instantiated component of the class "sample-ooo-model". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.
<sample-ooo-model>.info
Print detailed information about the configuration of the device.
<sample-ooo-model>.status
Print detailed information about the current status of the device.

Connectors

NameTypeDirection
cpu-spacetiming-modelup

4.6   Base Components

The base components are abstract classes that contain generic component attributes and commands available for all components.

4.6.1   component

Description
Base component class, should not be instantiated.
Attributes
connections
Optional attribute; read/write access; type: [[sos]*].

List of connections for the component. The format is a list of lists, each containing the name of the connector, the connected component, and the name of the connector on the other component.

connectors
Pseudo class attribute; read-only access; type: D.

Dictionary of dictionaries with connectors defined by this component class, indexed by name. Each connector contains the name of the connector "type", a "direction" ("up", "down" or "any"), a flag indicating if the connector can be "empty", another flag that is set if the connector is "hotplug" capable, and finally a flag that is TRUE if muliple connections to this connector is allowed.

instantiated
Optional attribute; read/write access; type: b.

Set to TRUE if the component has been instantiated.

object_list
Optional attribute; read/write access; type: D.

Dictionary with objects that the component consists of.

object_prefix
Optional attribute; read/write access; type: String.

Object prefix string used by the component. The prefix is typically set by the set-component-prefix command before the component is created.

top_component
Optional attribute; read/write access; type: Object.

The top level component. Attribute is not valid until the component has been instantiated.

top_level
Optional attribute; read/write access; type: b.

Set to TRUE for top-level components, i.e. the root of a hierarchy.

4.6.2   top-component

Description
Base top-level component class, should not be instantiated.
Attributes
components
Optional attribute; read/write access; type: [o*].

List of components below the the top-level component. This attribute is not valid until the object has been instantiated.

cpu_list
Optional attribute; read/write access; type: [o*].

List of all processors below the the top-level component. This attribute is not valid until the object has been instantiated.

VIRTUTECH CONFIDENTIAL    Previous - Up - Next