5.4.3 VE - peripheral components

This section describes the peripheral components on the motherboard.

Color LCD controller - parameters

This section describes the parameters.

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

motherboard.pl111_clcd.parameter=value

Table 5-6 Color LCD controller parameters

Parameter Type Allowed values Default value Description
pixel_double_limit int - 0x12C The threshold in horizontal pixels below which pixels sent to the frame-buffer are doubled in size in both dimensions.

Elfloader - parameters

Configure this alternative method of loading elf files into the system.

Table 5-7 Elfloader parameters

Parameter Type Allowed values Default value Description
elf string - "" ELF file name.
lfile string - "" Load file for large address mapping.
ns_copy bool true, false true Copy whole file to NS memory space.

Ethernet - parameters

You can change these parameters after the model starts.

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

motherboard.smsc_91c111.parameter=value

Table 5-8 Ethernet parameters

Parameter Type Allowed values Default value Description
enabled bool true, false false Host interface connection enabled.
mac_address string See below. 00:02:f7:ef:31:11 Host/model MAC address.
promiscuous bool true, false true Put host into promiscuous mode, for example when sharing the Ethernet controller with the host OS.
mac_address
  • If you do not specify a MAC address, 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 increases the chance of the MAC address being unique 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, using random MAC addresses might interact with some DHCP servers.

System controller - parameters

You can change these parameters after the model starts.

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

motherboard.sp810_sysctrl.parameter=value

Table 5-9 System controller parameters

Parameter Type Allowed values Default value Description
sysid int - 0x00000000 Value for system identification register. 0, SYS_ID register value = 0x0225f500, corresponding to REV_A.1, SYS_ID register value = 0x12257500, corresponding to REV_B. 2, SYS_ID register value = 0x22252500, corresponding to REV_C. For other values: SYS_ID register value of 0x0.
use_s8 bool true, false false Select whether switch S8 is enabled.

System register block - parameters

You can change these parameters after the model starts.

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

motherboard.ve_sysregs.parameter=value

Table 5-10 System register parameters

Parameter Type Allowed values Default value Description
exit_on_shutdown bool true, false false SYS_CFG_SHUTDOWN exits simulation.
mmbSiteDefault int 0x0-0x2 0x1 Default MMB source (0=MB, 1=DB1, 2=DB2).
tilePresent bool true, false true CoreTile fitted status.
user_switches_value int - 0x00 User switches.

UART - parameters

You can change these parameters after the model starts.

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 5-11 UART parameters

Parameter Type Allowed values Default value Description
baud_rate int - 0x9600 Baud rate.
clock_rate int - 0xE10000 Clock rate for PL011.
generic_uart bool true, false false Permit access only to the subset of registers defined as Generic Uart in the SBSA specification.
in_file string - "" Input file for the UART to read.
out_file string - "" Output file (use "-" to send all output to stdout)
in_file_escape_sequence string - "##" Input file escape sequence.
revision string - "r1p4" Revision to simulate (affects ID register and FIFO capacity).
shutdown_on_eot bool true, false false Shut down simulation when an EOT (ASCII 4) char is transmitted. Useful for regression tests when semihosting is not available.
shutdown_tag string - "" String that causes a shutdown simulation when transmitted.
unbufferred_output bool true, false false Unbuffered output
untimed_fifos bool true, false true Ignore the clock rate and transmit/receive serial data immediately.
uart_enable bool true, false false Enable the UART when the system starts, to make baud_rate and clock_rate valid.

v8EmbeddedCrossTrigger_Matrix - parameters

This section describes the parameters.

Table 5-12 v8EmbeddedCrossTrigger_Matrix parameters

Name Type Allowed values Default value Description
has_CTIAUTHSTATUS bool true, false true Enables the CTIAUTHSTATUS register.
number-of-channels uint32_t 0x3-0x20, 3-32 0x4, 4 Number of channels in the CTM.

Watchdog - parameters

You can change these parameters after the model starts.

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

motherboard.sp805_wdog.parameter=value

Table 5-13 Watchdog parameters

Parameter Type Allowed values Default value Description
simhalt bool true, false false Halt on reset.
Non-ConfidentialPDF file icon PDF versionARM DUI0837I
Copyright © 2014-2016 ARM Limited or its affiliates. All rights reserved.