3.10.34 PL011_Uart

ARM PrimeCell UART(PL011). This model is written in LISA+.

PL011_Uart contains the following CADI targets:

  • PL011_Uart

PL011_Uart contains the following MTI components:

Limitations

This component does not implement the DMA functionality of the PL011 PrimeCell.

Performance

Arm expects this component to have little effect on the performance of PV systems. However, at very high baud rates such as in excess of 1MHz, simulation performance might be reduced.

Additional parameter information

untimed_fifos

When false, characters of serial data are clocked to/from the SerialData port at a rate controlled by the clk_in_ref clock rate and the baud-rate-divider configuration of the UART clock. Enabling untimed_fifos permits serial data to be sent/received as fast as it can be generated/consumed. The modem control signals are still generated correctly, so the UART is not able to transmit data faster than the receiving end can handle. For example, TelnetTerminal uses the CTS signal to avoid overflowing its TCP/IP buffer.

Table 3-360 Ports

Name Protocol Type Description
clk_in_ref ClockSignal Slave Clock input, typically 14.745MHz, which sets the master transmit/receive rate.
intr 2.7.2 Signal protocol Master Interrupt signal.
pvbus PVBus Slave Slave port for register access.
serial_out 2.4.16 SerialData protocol Master Serial input/output and control signals. Used to communicate with a serial device, such as a terminal.

Table 3-361 Parameters for PL011_Uart

Name Type Default value Description
baud_rate int 0x9600 Baud rate.
clock_rate int 0xe10000 Clock rate for PL011.
enable_dc4 bool 0x1 Enable DC4 commands (try echo -e "help\024" in a Linux shell in a serial console)
in_file string "" Input file for data to be read by the UART
in_file_escape_sequence string "##" Input file escape sequence
out_file string "" Output file to hold data written by the UART (use '-' to send all output to stdout)
revision string "r1p4" Revision to simulate
shutdown_on_eot bool 0x0 Shutdown simulation when a EOT (ASCII 4) char is transmitted (useful for regression tests when semihosting is not available)
shutdown_tag string "" Shutdown simulation when a string is transmitted
uart_enable bool 0x0 Enable uart when the system starts up. (clock_rate and baud_rate are only valid when this option is enabled.)
unbuffered_output bool 0x0 Unbuffered output
untimed_fifos bool 0x1 Ignore the clock rate and transmit/receive serial data immediately
Non-ConfidentialPDF file icon PDF version100964_1161_00_en
Copyright © 2014–2019 Arm Limited or its affiliates. All rights reserved.