VIRTUTECH CONFIDENTIAL    Previous - Up - Next

4   Supported Components

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

The default machines are constructed from components in the -system.include files in [simics]/targets/serengeti/. 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   Serengeti Components

4.1.1   serengeti-3800-chassis

Description

The "sunfire-3800-chassis" component represents the chassis, backplane and system-console of a Sun Fire 3800 server, with slots for up to two processor boards and two I/O boards. The system is sometimes called SP for Service Provider server.

Attributes

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.

rtc_time

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

The date and time of the Real-Time clock.

Commands

create-serengeti-3800-chassis ["name"] hostid "mac_address" "rtc_time"

Creates a non-instantiated component of the class "serengeti-3800-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

new-serengeti-3800-chassis ["name"] hostid "mac_address" "rtc_time"

Creates an instantiated component of the class "serengeti-3800-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

<serengeti-3800-chassis>.get-nvram-hostid

Reads the Sun hostid from the NVRAM.

<serengeti-3800-chassis>.get-nvram-mac

Reads the default MAC address from the NVRAM.

<serengeti-3800-chassis>.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.

<serengeti-3800-chassis>.info

Print detailed information about the configuration of the device.

<serengeti-3800-chassis>.set-nvram-hostid hostid

Writes the Sun hostid into the NVRAM.

<serengeti-3800-chassis>.set-nvram-mac "mac"

Writes the default MAC address into the NVRAM.

<serengeti-3800-chassis>.set-prom-env "variable" (int|"string")

Sets the value of an OBP variable. Only variables with string, integer, boolean and enumeration types are supported.

<serengeti-3800-chassis>.status

Print detailed information about the current status of the device.

Connectors

Name	Type	Direction
console	serial	down
cpu-slot0	serengeti-cpu-board	down
cpu-slot2	serengeti-cpu-board	down
io-slot6	serengeti-sp-io-board	down
io-slot8	serengeti-sp-io-board	down

4.1.2   serengeti-4800-chassis

Description

The "sunfire-4800-chassis" component represents the chassis, backplane and system-console of a Sun Fire 4800 server, with slots for up to three processor boards and two I/O boards. The system is sometimes called MD for Midrange Desk-side server.

Attributes

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.

rtc_time

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

The date and time of the Real-Time clock.

Commands

create-serengeti-4800-chassis ["name"] hostid "mac_address" "rtc_time"

Creates a non-instantiated component of the class "serengeti-4800-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

new-serengeti-4800-chassis ["name"] hostid "mac_address" "rtc_time"

Creates an instantiated component of the class "serengeti-4800-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

<serengeti-4800-chassis>.get-nvram-hostid

Reads the Sun hostid from the NVRAM.

<serengeti-4800-chassis>.get-nvram-mac

Reads the default MAC address from the NVRAM.

<serengeti-4800-chassis>.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.

<serengeti-4800-chassis>.info

Print detailed information about the configuration of the device.

<serengeti-4800-chassis>.set-nvram-hostid hostid

Writes the Sun hostid into the NVRAM.

<serengeti-4800-chassis>.set-nvram-mac "mac"

Writes the default MAC address into the NVRAM.

<serengeti-4800-chassis>.set-prom-env "variable" (int|"string")

Sets the value of an OBP variable. Only variables with string, integer, boolean and enumeration types are supported.

<serengeti-4800-chassis>.status

Print detailed information about the current status of the device.

Connectors

Name	Type	Direction
console	serial	down
cpu-slot0	serengeti-cpu-board	down
cpu-slot2	serengeti-cpu-board	down
cpu-slot4	serengeti-cpu-board	down
io-slot6	serengeti-io-board	down
io-slot8	serengeti-io-board	down

4.1.3   serengeti-4810-chassis

Description

The "sunfire-4810-chassis" component represents the chassis, backplane and system-console of a Sun Fire 4810 server, with slots for up to three processor boards and two I/O boards. The system is sometimes called ME for Midrange Enterprise server.

Attributes

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.

rtc_time

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

The date and time of the Real-Time clock.

Commands

create-serengeti-4810-chassis ["name"] hostid "mac_address" "rtc_time"

Creates a non-instantiated component of the class "serengeti-4810-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

new-serengeti-4810-chassis ["name"] hostid "mac_address" "rtc_time"

Creates an instantiated component of the class "serengeti-4810-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

<serengeti-4810-chassis>.get-nvram-hostid

Reads the Sun hostid from the NVRAM.

<serengeti-4810-chassis>.get-nvram-mac

Reads the default MAC address from the NVRAM.

<serengeti-4810-chassis>.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.

<serengeti-4810-chassis>.info

Print detailed information about the configuration of the device.

<serengeti-4810-chassis>.set-nvram-hostid hostid

Writes the Sun hostid into the NVRAM.

<serengeti-4810-chassis>.set-nvram-mac "mac"

Writes the default MAC address into the NVRAM.

<serengeti-4810-chassis>.set-prom-env "variable" (int|"string")

Sets the value of an OBP variable. Only variables with string, integer, boolean and enumeration types are supported.

<serengeti-4810-chassis>.status

Print detailed information about the current status of the device.

Connectors

Name	Type	Direction
console	serial	down
cpu-slot0	serengeti-cpu-board	down
cpu-slot2	serengeti-cpu-board	down
cpu-slot4	serengeti-cpu-board	down
io-slot6	serengeti-io-board	down
io-slot8	serengeti-io-board	down

4.1.4   serengeti-6800-chassis

Description

The "sunfire-6800-chassis" component represents the chassis, backplane and system-console of a Sun Fire 6800 server, with slots for up to six processor boards and four I/O boards. The system is sometimes called DS for Datacenter Server.

Attributes

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.

rtc_time

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

The date and time of the Real-Time clock.

Commands

create-serengeti-6800-chassis ["name"] hostid "mac_address" "rtc_time"

Creates a non-instantiated component of the class "serengeti-6800-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

new-serengeti-6800-chassis ["name"] hostid "mac_address" "rtc_time"

Creates an instantiated component of the class "serengeti-6800-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

<serengeti-6800-chassis>.get-nvram-hostid

Reads the Sun hostid from the NVRAM.

<serengeti-6800-chassis>.get-nvram-mac

Reads the default MAC address from the NVRAM.

<serengeti-6800-chassis>.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.

<serengeti-6800-chassis>.info

Print detailed information about the configuration of the device.

<serengeti-6800-chassis>.set-nvram-hostid hostid

Writes the Sun hostid into the NVRAM.

<serengeti-6800-chassis>.set-nvram-mac "mac"

Writes the default MAC address into the NVRAM.

<serengeti-6800-chassis>.set-prom-env "variable" (int|"string")

Sets the value of an OBP variable. Only variables with string, integer, boolean and enumeration types are supported.

<serengeti-6800-chassis>.status

Print detailed information about the current status of the device.

Connectors

Name	Type	Direction
console	serial	down
cpu-slot[0-5]	serengeti-cpu-board	down
io-slot[6-9]	serengeti-io-board	down

4.1.5   serengeti-cluster-chassis

Description

The "sunfire-cluster-chassis" component represents the chassis, backplane and system-console of up to sixteen Sun Fire 6800 servers connected in a cluster. This setup is to be considered experimental, and Solaris does not support all possible configurations of this component.

Attributes

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.

rtc_time

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

The date and time of the Real-Time clock.

Commands

create-serengeti-cluster-chassis ["name"] hostid "mac_address" "rtc_time"

Creates a non-instantiated component of the class "serengeti-cluster-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

new-serengeti-cluster-chassis ["name"] hostid "mac_address" "rtc_time"

Creates an instantiated component of the class "serengeti-cluster-chassis". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

<serengeti-cluster-chassis>.get-nvram-hostid

Reads the Sun hostid from the NVRAM.

<serengeti-cluster-chassis>.get-nvram-mac

Reads the default MAC address from the NVRAM.

<serengeti-cluster-chassis>.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.

<serengeti-cluster-chassis>.info

Print detailed information about the configuration of the device.

<serengeti-cluster-chassis>.set-nvram-hostid hostid

Writes the Sun hostid into the NVRAM.

<serengeti-cluster-chassis>.set-nvram-mac "mac"

Writes the default MAC address into the NVRAM.

<serengeti-cluster-chassis>.set-prom-env "variable" (int|"string")

Sets the value of an OBP variable. Only variables with string, integer, boolean and enumeration types are supported.

<serengeti-cluster-chassis>.status

Print detailed information about the current status of the device.

Connectors

Name	Type	Direction
console	serial	down
cpu-slot[0-5]	serengeti-cpu-board	down
cpu-slot[10-15]	serengeti-cpu-board	down
cpu-slot[100-105]	serengeti-cpu-board	down
cpu-slot[110-115]	serengeti-cpu-board	down
cpu-slot[120-125]	serengeti-cpu-board	down
cpu-slot[130-135]	serengeti-cpu-board	down
cpu-slot[140-145]	serengeti-cpu-board	down
cpu-slot[150-155]	serengeti-cpu-board	down
cpu-slot[20-25]	serengeti-cpu-board	down
cpu-slot[30-35]	serengeti-cpu-board	down
cpu-slot[40-45]	serengeti-cpu-board	down
cpu-slot[50-55]	serengeti-cpu-board	down
cpu-slot[60-65]	serengeti-cpu-board	down
cpu-slot[70-75]	serengeti-cpu-board	down
cpu-slot[80-85]	serengeti-cpu-board	down
cpu-slot[90-95]	serengeti-cpu-board	down
io-slot[106-109]	serengeti-io-board	down
io-slot[116-119]	serengeti-io-board	down
io-slot[126-129]	serengeti-io-board	down
io-slot[136-139]	serengeti-io-board	down
io-slot[146-149]	serengeti-io-board	down
io-slot[156-159]	serengeti-io-board	down
io-slot[16-19]	serengeti-io-board	down
io-slot[26-29]	serengeti-io-board	down
io-slot[36-39]	serengeti-io-board	down
io-slot[46-49]	serengeti-io-board	down
io-slot[56-59]	serengeti-io-board	down
io-slot[6-9]	serengeti-io-board	down
io-slot[66-69]	serengeti-io-board	down
io-slot[76-79]	serengeti-io-board	down
io-slot[86-89]	serengeti-io-board	down
io-slot[96-99]	serengeti-io-board	down

4.1.6   serengeti-us-iii-cpu-board

Description

The "serengeti-us-iii-cpu-board" component represents a processor board with up to four UltraSPARC III processors and 32GB of memory, for use in Sun Fire 3800-6800 servers.

Attributes

cpu_frequency

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

Processor frequency in MHz.

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 (0 to 4).

Commands

create-serengeti-us-iii-cpu-board ["name"] num_cpus memory_megs cpu_frequency

Creates a non-instantiated component of the class "serengeti-us-iii-cpu-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

<serengeti-us-iii-cpu-board>.info

Print detailed information about the configuration of the device.

<serengeti-us-iii-cpu-board>.status

Print detailed information about the current status of the device.

Connectors

Name	Type	Direction
chassis	serengeti-cpu-board	up
cache-cpu[0-3]	timing-model	down

4.1.7   serengeti-us-iii-plus-cpu-board

Description

The "serengeti-us-iii-plus-cpu-board" component represents a processor board with up to four UltraSPARC III Cu processors and 32GB of memory, for use in Sun Fire 3800-6800 servers.

Attributes

cpu_frequency

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

Processor frequency in MHz.

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 (0 to 4).

Commands

create-serengeti-us-iii-plus-cpu-board ["name"] num_cpus memory_megs cpu_frequency

Creates a non-instantiated component of the class "serengeti-us-iii-plus-cpu-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

<serengeti-us-iii-plus-cpu-board>.info

Print detailed information about the configuration of the device.

<serengeti-us-iii-plus-cpu-board>.status

Print detailed information about the current status of the device.

Connectors

Name	Type	Direction
chassis	serengeti-cpu-board	up
cache-cpu[0-3]	timing-model	down

4.1.8   serengeti-us-iv-cpu-board

Description

The "serengeti-us-iv-cpu-board" component represents a processor board with up to four dual-core UltraSPARC IV processors and 32GB of memory, for use in Sun Fire 3800-6800 servers.

Attributes

cpu_frequency

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

Processor frequency in MHz.

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 (0 to 4).

Commands

create-serengeti-us-iv-cpu-board ["name"] num_cpus memory_megs cpu_frequency

Creates a non-instantiated component of the class "serengeti-us-iv-cpu-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

<serengeti-us-iv-cpu-board>.info

Print detailed information about the configuration of the device.

<serengeti-us-iv-cpu-board>.status

Print detailed information about the current status of the device.

Connectors

Name	Type	Direction
chassis	serengeti-cpu-board	up
cache-cpu[0-3]	timing-model	down

4.1.9   serengeti-us-iv-plus-cpu-board

Description

The "serengeti-us-iv-plus-cpu-board" component represents a processor board with up to four dual-core UltraSPARC IV+ processors and 32GB of memory, for use in Sun Fire 3800-6800 servers.

Attributes

cpu_frequency

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

Processor frequency in MHz.

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 (0 to 4).

Commands

create-serengeti-us-iv-plus-cpu-board ["name"] num_cpus memory_megs cpu_frequency

Creates a non-instantiated component of the class "serengeti-us-iv-plus-cpu-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

<serengeti-us-iv-plus-cpu-board>.info

Print detailed information about the configuration of the device.

<serengeti-us-iv-plus-cpu-board>.status

Print detailed information about the current status of the device.

Connectors

Name	Type	Direction
chassis	serengeti-cpu-board	up
cache-cpu[0-3]	timing-model	down

4.1.10   serengeti-pci8-board

Description

The "serengeti-pci8-board" component represents an I/O board with slots for up to eight PCI cards, for use in Sun Fire 4800-6800 servers, i.e. not the SP model.

PCI Slot Mappings:

Simics slot	AID	PCI Bus	PCI Slot	Bus address
0	0	B	1	0,700000
1	0	B	2	0,700000
2	0	B	3	0,700000
3	0	A	1	0,600000
4	1	B	1	1,700000
5	1	B	2	1,700000
6	1	B	3	1,700000
7	1	A	1	1,600000

Commands

create-serengeti-pci8-board ["name"]

Creates a non-instantiated component of the class "serengeti-pci8-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

<serengeti-pci8-board>.info

Print detailed information about the configuration of the device.

<serengeti-pci8-board>.status

Print detailed information about the current status of the device.

Connectors

Name	Type	Direction
chassis	serengeti-io-board	up
pci-slot[0-7]	pci-bus	down

4.1.11   serengeti-cpci4-board

Description

The "serengeti-cpci4-board" component represents an I/O board with slots for up to four CompactPCI cards, for use in Sun Fire 4800-6800 servers, i.e. not the SP model.

PCI Slot Mappings:

Simics slot	AID	PCI Bus	PCI Slot	Bus address
0	0	B	1	0,700000
1	0	A	1	0,600000
2	1	B	1	1,700000
3	1	A	1	1,600000

Commands

create-serengeti-cpci4-board ["name"]

Creates a non-instantiated component of the class "serengeti-cpci4-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

<serengeti-cpci4-board>.info

Print detailed information about the configuration of the device.

<serengeti-cpci4-board>.status

Print detailed information about the current status of the device.

Connectors

Name	Type	Direction
chassis	serengeti-io-board	up
pci-slot[0-3]	cpci-bus	down

4.1.12   serengeti-sp-cpci6-board

Description

The "serengeti-sp-cpci6-board" component represents an I/O board with slots for up to six CompactPCI cards, for use in a Sun Fire 3800 server, i.e. only the SP model.

PCI Slot Mappings:

Simics slot	AID	PCI Bus	PCI Slot	Bus address
0	0	B	1	0,700000
1	0	B	2	0,700000
2	0	A	1	0,600000
3	1	B	1	1,700000
4	1	B	2	1,700000
5	1	A	1	1,600000

Commands

create-serengeti-sp-cpci6-board ["name"]

Creates a non-instantiated component of the class "serengeti-sp-cpci6-board". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

<serengeti-sp-cpci6-board>.info

Print detailed information about the configuration of the device.

<serengeti-sp-cpci6-board>.status

Print detailed information about the current status of the device.

Connectors

Name	Type	Direction
chassis	serengeti-sp-io-board	up
pci-slot[0-5]	cpci-bus	down

4.2   PCI Device Components

4.2.1   sun-cpci-hme-isp

Description

The "sun-cpci-hme-isp" component represents an CompactPCI card with one HME ethernet controller 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-cpci-hme-isp ["name"] "mac_address" [scsi_id]

Creates a non-instantiated component of the class "sun-cpci-hme-isp". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

<sun-cpci-hme-isp>.info

Print detailed information about the configuration of the device.

<sun-cpci-hme-isp>.status

Print detailed information about the current status of the device.

Connectors

Name	Type	Direction
pci-bus	cpci-bus	up
ethernet	ethernet-link	down
scsi-bus	scsi-bus	down

4.2.2   sun-cpci-isp-isp

Description

The "sun-cpci-isp-isp" component represents an CompactPCI card with two ISP SCSI controllers for use in Sun systems.

Attributes

scsi_id0

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

The ID on the SCSI bus for the first ISP.

scsi_id1

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

The ID on the SCSI bus for the second ISP.

Commands

create-sun-cpci-isp-isp ["name"] [scsi_id0] [scsi_id1]

Creates a non-instantiated component of the class "sun-cpci-isp-isp". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

<sun-cpci-isp-isp>.info

Print detailed information about the configuration of the device.

<sun-cpci-isp-isp>.status

Print detailed information about the current status of the device.

Connectors

Name	Type	Direction
pci-bus	cpci-bus	up
scsi-bus[0-1]	scsi-bus	down

4.2.3   sun-cpci-qlc-qlc

Description

The "sun-cpci-qlc-qlc" component represents an CompactPCI card with two QLC Fibre-Channel SCSI controllers 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-cpci-qlc-qlc ["name"] loop_id0 loop_id1

Creates a non-instantiated component of the class "sun-cpci-qlc-qlc". If name is not specified, the component will get a class-specific default name. The other arguments correspond to class attributes.

<sun-cpci-qlc-qlc>.info

Print detailed information about the configuration of the device.

<sun-cpci-qlc-qlc>.status

Print detailed information about the current status of the device.

Connectors

Name	Type	Direction
pci-bus	cpci-bus	up
fc-loop[0-1]	simple-fc-loop	down

4.2.4   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

Name	Type	Direction
pci-bus	pci-bus	up
ethernet	ethernet-link	down

4.2.5   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

Name	Type	Direction
pci-bus	pci-bus	up
ethernet	ethernet-link	down

4.2.6   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

Name	Type	Direction
pci-bus	pci-bus	up
ethernet	ethernet-link	down
scsi-bus	scsi-bus	down

4.2.7   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

Name	Type	Direction
pci-bus	pci-bus	up
console	graphics-console	down

4.2.8   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

Name	Type	Direction
pci-bus	pci-bus	up
fc-loop	simple-fc-loop	down

4.2.9   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

Name	Type	Direction
pci-bus	pci-bus	up
fc-loop[0-1]	simple-fc-loop	down

4.2.10   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

Name	Type	Direction
pci-bus	pci-bus	up
ethernet	ethernet-link	down

4.2.11   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

Name	Type	Direction
pci-bus	pci-bus	up
ethernet[0-1]	ethernet-link	down

4.2.12   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

Name	Type	Direction
pci-bus	pci-bus	up
scsi-bus	scsi-bus	down

4.2.13   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

Name	Type	Direction
pci-bus	pci-bus	up
scsi-bus[0-1]	scsi-bus	down

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

Name	Type	Direction
device	ethernet-link	any

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

Name	Type	Direction
scsi-bus	scsi-bus	any

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

Name	Type	Direction
scsi-bus	scsi-bus	up

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

Name	Type	Direction
scsi-bus	scsi-bus	up

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

Name	Type	Direction
fc-loop	simple-fc-loop	up

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

Name	Type	Direction
serial	serial	up

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

Name	Type	Direction
serial	serial	up

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

Name	Type	Direction
device	graphics-console	up
keyboard	keyboard	up
mouse	mouse	up

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

Name	Type	Direction
device	graphics-console	up
keyboard	keyboard	up

4.4   Timing Components

4.4.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

Name	Type	Direction
cpu-space	timing-model	up

4.4.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

Name	Type	Direction
cpu-space	timing-model	up

4.4.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

Name	Type	Direction
cpu-space	timing-model	up

4.5   Base Components

4.5.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.5.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