3.2.1. Motherboard peripheral parameters

This section describes the peripheral parameters that you can change on the motherboard. It contains:

Color LCD controller parameters

Table 3.4 lists the Color LCD Controller instantiation-time parameters that you can change when the model is started.

The syntax to use in a configuration file or on the command line is:

motherboard.pl111_clcd.parameter=value

Table 3.4. Color LCD controller configuration parameters

ParameterDescriptionTypeValuesDefault
pixel_double_limitThe threshold in horizontal pixels below which pixels sent to the frame-buffer are doubled in size in both dimensions.integer-0x12C

Ethernet parameters

Table 3.5 lists the Ethernet instantiation-time parameters that you can change when the model is started.

The syntax to use in a configuration file or on the command line is:

motherboard.smsc_91c111.parameter=value

Table 3.5. Ethernet configuration parameters

ParameterDescriptionTypeValuesDefault
enabledHost interface connection enabledbooleantrue or falsefalse
mac_addressHost/model MAC addressstringSee mac_address parameter00:02:f7:ef:31:11
promiscuousPut host into promiscuous mode, for example when sharing the Ethernet controller with the host OS.booleantrue or falsetrue

mac_address parameter

There are two options for the mac_address parameter:

  • If a MAC address is not specified, when the simulator is run it takes the default MAC address and changes its bottom two bytes from 00:02 to the bottom two bytes of the MAC address of one of the adaptors on the host PC. This provides some degree of MAC address uniqueness when running models on multiple hosts on a local network.

  • If you specify the MAC address as auto, this generates a completely random local MAC address each time the simulator is run. The address has bit 1 set and bit 0 clear in the first byte to indicate a locally-administered unicast MAC address.

Note

DHCP servers are used to allocate IP addresses, but because they sometimes do this based on the MAC address provided to them, then using random MAC addresses might interact with some DHCP servers.

For more information on how to set up and use the Ethernet component, see Using Ethernet with a VE RTSM

System controller parameters

Table 3.6 lists the system controller instantiation-time parameters that you can change when the model is started.

The syntax to use in a configuration file or on the command line is:

motherboard.sp810_sysctrl.parameter=value

Table 3.6. System controller configuration parameters

ParameterDescriptionTypeValuesDefault
sysidValue for system identification registerinteger0, 1, 2[a]0x00000000
use_s8Select whether switch S8 is enabledbooleantrue or falsefalse

[a] The sysid parameter takes values 0, 1, or 2. These correspond to SYS_ID register read values of:

  • sysid parameter value = 0 => SYS_ID register value = 0x0225f500, corresponding to REV_A

  • sysid parameter value = 1 => SYS_ID register value = 0x12257500, corresponding to REV_B

  • sysid parameter value = 2 => SYS_ID register value = 0x22252500, corresponding to REV_C.

Any other value for parameter sysid results in a SYS_ID register value of 0x0.


VE system register block parameters

Table 3.7 lists the VE system register instantiation-time parameters that you can change when the model is started.

The syntax to use in a configuration file or on the command line is:

motherboard.ve+sysregs.parameter=value

Table 3.7. System register configuration parameters

ParameterDescriptionTypeValuesDefault
user_switches_valueUser switchinteger-0x00
tilePresentCoreTile fitted statusbooleantrue or falsetrue

UART parameters

Table 3.8 lists the UART instantiation-time parameters that you can change when the model is started.

The syntax to use in a configuration file or on the command line is:

motherboard.pl011_uartx.parameter=value

where x is the UART identifier 0, 1, 2 or 3.

Table 3.8. UART configuration parameters

ParameterDescriptionTypeValuesDefault
baud_rateBaud rateinteger-0x9600
clock_rateClock rate for PL011integer-0xE10000
in_fileInput filestring [empty string]
out_fileOutput file (use “-” to send all output to stdout).string [empty string]
in_file_escape_sequenceInput file escape sequencestring ##
shutdown_on_eotShutdown simulation when an EOT (ASCII 4) char is transmitted.booleantrue or falsefalse
unbuferred_outputUnbuffered outputbooleantrue or falsefalse
untimed_fifosIgnore the clock rate and transmit/receive serial data immediately.booleantrue or falsefalse
uart_enableEnable the UART when the system starts.booleantrue or falsefalse

Watchdog parameters

Table 3.9 lists the watchdog instantiation-time parameters that you can change when the model is started.

The syntax to use in a configuration file or on the command line is:

motherboard.sp805_wdog.parameter=value

Table 3.9. Watchdog configuration parameters

ParameterDescriptionTypeValuesDefault
simhaltHalt on resetbooleantrue or falsefalse

Copyright © 2011 ARM. All rights reserved.ARM DUI 0575C
Non-ConfidentialID010512