machine
system_info -- A short string describing what this system is.
hardware:name -- Name of the machine. Used for the top-level component.
hardware:memory_megs -- Amount of RAM in the machine, in MiB. The highest supported value is 65536 (64 GiB). More than 64 GiB is not supported since the x86QSP1 processor is limited to a 36-bit physical address space.
Type: int
Amount of RAM in the machine, in MiB. The highest supported value is 65536 (64 GiB). More than 64 GiB is not supported since the x86QSP1 processor is limited to a 36-bit physical address space.
Default value: 8192
hardware:processor:class -- It should be specified as processor component class without the "processor_" prefix and with underscores replaced with hyphens, e.g. x86-intel64. Tip: to obtain the list of processor component classes please use the "list-classes substr = processor_" Simics command.
Type: str
It should be specified as processor component class without the "processor_" prefix and with underscores replaced with hyphens, e.g. x86-intel64. Tip: to obtain the list of processor component classes please use the "list-classes substr = processor_" Simics command.
Default value: x86QSP1
hardware:processor:num_cores -- Number of cores per physical processor or slot in the machine. Allowed values are 1 - 128.
Type: int
Number of cores per physical processor or slot in the machine. Allowed values are 1 - 128.
Default value: 1
hardware:processor:freq_mhz -- Processor frequency in MHz.
hardware:processor:cpi -- Clock cycles per executed instruction for the processors. Must be a power of 2.
Type: int
Clock cycles per executed instruction for the processors. Must be a power of 2.
Default value: 1
hardware:processor:num_slots -- Number of physical processors in the machine.
hardware:processor:num_cores_small -- Number of small cores per physical processor in the machine (only applicable if the processor class specified by the cpu_comp_class parameter supports heterogeneous setups).
Type: int
Number of small cores per physical processor in the machine (only applicable if the processor class specified by the cpu_comp_class parameter supports heterogeneous setups).
Default value: 0
hardware:processor:num_threads -- Number of threads per processor core in the machine.
hardware:processor:num_threads_small -- Number of threads per small core in the machine (only applicable if the processor class specified by the cpu_comp_class parameter supports heterogeneous setups).
Type: int
Number of threads per small core in the machine (only applicable if the processor class specified by the cpu_comp_class parameter supports heterogeneous setups).
Default value: 0
Allowed values: [0, 1, 2, 4]
hardware:processor:apic_freq_mhz -- APIC frequency in MHz.
hardware:consoles:con0:create -- Create a console for COM1 (a.k.a. com[0]).
Type: bool
Create a console for COM1 (a.k.a. com[0]).
Default value: True
hardware:consoles:con0:show -- Automatically display the text console on the first serial port.
Type: bool
Automatically display the text console on the first serial port.
Default value: True
hardware:consoles:con0:fg_color -- The foreground color, or RGB in #12ab89 format.
hardware:consoles:con0:bg_color -- The background color, or RGB in #12ab89 format.
hardware:consoles:con1:create -- Create a console for COM2 (a.k.a. com[1]).
Type: bool
Create a console for COM2 (a.k.a. com[1]).
Default value: False
hardware:consoles:con1:show -- Automatically display the text console on the second serial port.
Type: bool
Automatically display the text console on the second serial port.
Default value: False
hardware:consoles:con1:fg_color -- The foreground color, or RGB in #12ab89 format.
hardware:consoles:con1:bg_color -- The background color, or RGB in #12ab89 format.
hardware:consoles:gfx_con:create -- Create a graphics console.
Type: bool
Create a graphics console.
Default value: True
hardware:consoles:gfx_con:show -- Automatically display the graphics console.
Type: bool
Automatically display the graphics console.
Default value: True
hardware:storage:disk0:name -- The name of the disk component.
hardware:storage:disk0:slot -- IDE/SATA slot to connect to.
hardware:storage:disk0:create --
hardware:storage:disk0:interface -- Create and connect to the target machine a virtual hard disk of type SATA or IDE. Simics object machine_name.disk0 is created and connected to the target machine.
Type: str
Create and connect to the target machine a virtual hard disk of type SATA or IDE. Simics object machine_name.disk0 is created and connected to the target machine.
Default value: sata
Allowed values: ['sata', 'ide']
hardware:storage:disk0:image -- Disk image file for the machine_name.disk0 virtual disk. Files in craff (Simics own file format), VHDX, and raw formats are supported.
Type: file
Disk image file for the machine_name.disk0 virtual disk. Files in craff (Simics own file format), VHDX, and raw formats are supported.
Default value: ^software:linux:os_image
hardware:storage:disk0:size -- Size of the machine_name.disk0 virtual disk in bytes. If NIL, the size of disk0_image is used.
hardware:storage:disk1:name -- The name of the disk component.
hardware:storage:disk1:slot -- IDE/SATA slot to connect to.
hardware:storage:disk1:create --
hardware:storage:disk1:interface -- Create and connect to the target machine a virtual hard disk of type SATA or IDE. Simics object machine_name.disk0 is created and connected to the target machine.
Type: str
Create and connect to the target machine a virtual hard disk of type SATA or IDE. Simics object machine_name.disk0 is created and connected to the target machine.
Default value: sata
Allowed values: ['sata', 'ide']
hardware:storage:disk1:image -- Disk image file for the machine_name.disk0 virtual disk. Files in craff (Simics own file format), VHDX, and raw formats are supported.
Type: file
Disk image file for the machine_name.disk0 virtual disk. Files in craff (Simics own file format), VHDX, and raw formats are supported.
Default value: ^software:linux:auxiliary_image
hardware:storage:disk1:size -- Size of the machine_name.disk0 virtual disk in bytes. If NIL, the size of disk0_image is used.
hardware:storage:cdrom:create --
hardware:storage:cdrom:name -- The name of the cdrom component.
hardware:storage:cdrom:interface -- Create and connect to the target machine a virtual hard disk of type SATA or IDE. Creates a Simics object called machine_name.disk0, connected to the target machine.
Type: str
Create and connect to the target machine a virtual hard disk of type SATA or IDE. Creates a Simics object called machine_name.disk0, connected to the target machine.
Default value: sata
Allowed values: ['sata', 'ide']
hardware:rtc:time -- The date and time of the simulated real-time clock set when the configuration is created. The format is "YYYY-MM-DD HH:MM:SS". Can also be set to "auto" to use the current host time.
Type: str
The date and time of the simulated real-time clock set when the configuration is created. The format is "YYYY-MM-DD HH:MM:SS". Can also be set to "auto" to use the current host time.
Default value: auto
hardware:usb_tablet:create -- Connects a USB tablet device for input using absolute positioning that provides a better user experience than a mouse.
Type: bool
Connects a USB tablet device for input using absolute positioning that provides a better user experience than a mouse.
Default value: True
hardware:apic_bus:class -- APIC bus class. It should be the apic bus class that comes with the same module as the apic used in the CPU model. If set to "auto_apic_bus" the script will attempt to find the correct apic bus class automatically. If that fails the apic-bus class will be used.
Type: str
APIC bus class. It should be the apic bus class that comes with the same module as the apic used in the CPU model. If set to "auto_apic_bus" the script will attempt to find the correct apic bus class automatically. If that fails the apic-bus class will be used.
Default value: auto_apic_bus
hardware:nic:mac_address -- MAC address of the built-in Ethernet adapter in the ICH10 chipset. The format is "XX:XX:XX:XX:XX:XX". Can also be set to "auto" to obtain an auto-generated unique MAC address.
Type: str
MAC address of the built-in Ethernet adapter in the ICH10 chipset. The format is "XX:XX:XX:XX:XX:XX". Can also be set to "auto" to obtain an auto-generated unique MAC address.
Default value: auto
hardware:firmware:bios -- BIOS file.
hardware:firmware:lan_bios -- ROM BIOS file for the ICH10 LAN Ethernet adaptor
hardware:firmware:spi_flash -- The ICH10 SPI flash file to use.
hardware:simulation:enable_break_on_reboot -- Interrupts the simulation if the machine is rebooted.
hardware:simulation:system_clock:enable -- Enables a configuration with a separate clock to which devices are bound instead of to the first CPU.
Type: bool
Enables a configuration with a separate clock to which devices are bound instead of to the first CPU.
Default value: ^simulation:system_clock:enable
hardware:simulation:system_clock:class -- The class used for the system clock if the enable_system_clock parameter is true.
Type: str
The class used for the system clock if the enable_system_clock parameter is true.
Default value: ^simulation:system_clock:class
hardware:simulation:use_vmp -- Enables host virtualization (VMP) for better simulation performance. This option affects simulated time. See the performance chapter in the Simics User's Guide for more information about VMP.
Type: bool
Enables host virtualization (VMP) for better simulation performance. This option affects simulated time. See the performance chapter in the Simics User's Guide for more information about VMP.
Default value: ^simulation:use_vmp
hardware:output:system -- The system top-level component object, output parameter
hardware:output:console -- The serial console of the created system, output parameter
hardware:output:mac_address -- The mac address assigned to the NIC, output parameter
hardware:output:eth_slot -- Board ethernet connector, output parameter
software:firmware:bios -- BIOS file.
software:firmware:lan_bios -- ROM BIOS file for the ICH10 LAN Ethernet adaptor
software:firmware:spi_flash -- The ICH10 SPI flash file to use.
software:linux:os_image -- Bootable disk image that will be used for the first disk and should auto-boot the desired OS.
Type: file
Bootable disk image that will be used for the first disk and should auto-boot the desired OS.
Default value: %simics%/targets/qsp-x86/images/cl-b28910-v2.craff
software:linux:auxiliary_image -- Optional image that will be used for the second disk.
Type: file
Optional image that will be used for the second disk.
Default value: %simics%/targets/qsp-x86/images/efi_agent_and_grub_only.craff
software:linux:auto_login -- Automatically log in as a "simics" user on the serial console.
Type: bool
Automatically log in as a "simics" user on the serial console.
Default value: True
software:linux:auto_login_root -- Automatically log in as a "root" user on the serial console. When the parameter is set it overrides the "auto_login" parameter.
Type: bool
Automatically log in as a "root" user on the serial console. When the parameter is set it overrides the "auto_login" parameter.
Default value: False
software:osa:create -- Create the top-level node for OS awareness. Does not configure the OS awareness.
Type: bool
Create the top-level node for OS awareness. Does not configure the OS awareness.
Default value: True
software:osa:create_tracker -- Creates the Linux tracker object.
software:osa:tracker_params -- OS awareness parameter file for the Linux kernel running on the machine.
Type: file
OS awareness parameter file for the Linux kernel running on the machine.
Default value: %simics%/targets/qsp-x86/images/cl-b28910-v2.params
simulation:use_vmp -- Enables host virtualization (VMP) for better simulation performance. This option affects simulated time. See the performance chapter in the Simics User's Guide for more information about VMP.
Type: bool
Enables host virtualization (VMP) for better simulation performance. This option affects simulated time. See the performance chapter in the Simics User's Guide for more information about VMP.
Default value: True
simulation:enable_break_on_reboot -- Interrupts the simulation if the machine is rebooted.
simulation:system_clock:enable -- Enables a configuration with a separate clock to which devices are bound instead of to the first CPU.
Type: bool
Enables a configuration with a separate clock to which devices are bound instead of to the first CPU.
Default value: False
simulation:system_clock:class -- The class used for the system clock if the enable_system_clock parameter is true.
Type: str
The class used for the system clock if the enable_system_clock parameter is true.
Default value: clock
network
switch:create_network -- Creates an Ethernet switch and connects the primary Ethernet adapter to it.
Type: bool
Creates an Ethernet switch and connects the primary Ethernet adapter to it.
Default value: True
switch:ethernet_switch:name -- Name of the created ethernet switch
switch:ethernet_switch:global_id -- Global ID for the link in a distributed setup (it should only be set if the link should be distributed and must match the links in other Simics sessions).
Type: int
Global ID for the link in a distributed setup (it should only be set if the link should be distributed and must match the links in other Simics sessions).
Default value: 0
switch:ethernet_switch:goal_latency -- Goal latency in seconds for communication (see also the set-min-latency command)
Type: float
Goal latency in seconds for communication (see also the set-min-latency command)
Default value: 1e-05
service_node:create -- Create a service node.
service_node:name -- Name of the created service node
service_node:ethernet_switch --
service_node:ip_address -- IP address of the service node
service_node:clock -- Name of clock to use for service node
service_node:connect_real_network -- Connects the simulated Ethernet switch to the host network using NAPT (Network Address and Port Translation)
Type: str
Connects the simulated Ethernet switch to the host network using NAPT (Network Address and Port Translation)
Allowed values: ['napt']
service_node:dhcp:setup -- Setup service node DHCP service
service_node:dhcp:domain -- Domain name to use for the DHCP server in the service node
Type: str
Domain name to use for the DHCP server in the service node
Default value: network.sim
service_node:dhcp:pool:starting_ip_address -- First IP address to serve from the DHCP server in the service node
Type: str
First IP address to serve from the DHCP server in the service node
Default value: 10.10.0.100
service_node:dhcp:pool:size -- Size of the IP address pool for the DHCP server in the service node
Type: int
Size of the IP address pool for the DHCP server in the service node
Default value: 100
ip_address -- The IP address to assign to the given MAC over DHCP
persistent_state
system -- The root of the hierarchy for the persistent state objects.
writable_state_dir -- If not NIL, the parameter is interpreted as a directory name. It is passed as an argument to the enable-writable-persistent-state command in order to set up a writable persistent state for the configuration.
output