[mirror_edk2.git] / ArmPlatformPkg / Include / Drivers / PL011Uart.h

/** @file\r
*\r
*  Copyright (c) 2011-2012, ARM Limited. All rights reserved.\r
*  \r
*  This program and the accompanying materials                          \r
*  are licensed and made available under the terms and conditions of the BSD License         \r
*  which accompanies this distribution.  The full text of the license may be found at        \r
*  http://opensource.org/licenses/bsd-license.php                                            \r
*\r
*  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
*  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
*\r
**/\r
\r
#ifndef __PL011_UART_H__\r
#define __PL011_UART_H__\r
\r
#include <Uefi.h>\r
#include <Protocol/SerialIo.h>\r
\r
// PL011 Registers\r
#define UARTDR                    0x000\r
#define UARTRSR                   0x004\r
#define UARTECR                   0x004\r
#define UARTFR                    0x018\r
#define UARTILPR                  0x020\r
#define UARTIBRD                  0x024\r
#define UARTFBRD                  0x028\r
#define UARTLCR_H                 0x02C\r
#define UARTCR                    0x030\r
#define UARTIFLS                  0x034\r
#define UARTIMSC                  0x038\r
#define UARTRIS                   0x03C\r
#define UARTMIS                   0x040\r
#define UARTICR                   0x044\r
#define UARTDMACR                 0x048\r
\r
// Data status bits\r
#define UART_DATA_ERROR_MASK      0x0F00\r
\r
// Status reg bits\r
#define UART_STATUS_ERROR_MASK    0x0F\r
\r
// Flag reg bits\r
#define PL011_UARTFR_RI           (1 << 8)  // Ring indicator\r
#define PL011_UARTFR_TXFE         (1 << 7)  // Transmit FIFO empty\r
#define PL011_UARTFR_RXFF         (1 << 6)  // Receive  FIFO full\r
#define PL011_UARTFR_TXFF         (1 << 5)  // Transmit FIFO full\r
#define PL011_UARTFR_RXFE         (1 << 4)  // Receive  FIFO empty\r
#define PL011_UARTFR_BUSY         (1 << 3)  // UART busy\r
#define PL011_UARTFR_DCD          (1 << 2)  // Data carrier detect\r
#define PL011_UARTFR_DSR          (1 << 1)  // Data set ready\r
#define PL011_UARTFR_CTS          (1 << 0)  // Clear to send\r
\r
// Flag reg bits - alternative names\r
#define UART_TX_EMPTY_FLAG_MASK   PL011_UARTFR_TXFE\r
#define UART_RX_FULL_FLAG_MASK    PL011_UARTFR_RXFF\r
#define UART_TX_FULL_FLAG_MASK    PL011_UARTFR_TXFF\r
#define UART_RX_EMPTY_FLAG_MASK   PL011_UARTFR_RXFE\r
#define UART_BUSY_FLAG_MASK       PL011_UARTFR_BUSY\r
\r
// Control reg bits\r
#define PL011_UARTCR_CTSEN        (1 << 15) // CTS hardware flow control enable\r
#define PL011_UARTCR_RTSEN        (1 << 14) // RTS hardware flow control enable\r
#define PL011_UARTCR_RTS          (1 << 11) // Request to send\r
#define PL011_UARTCR_DTR          (1 << 10) // Data transmit ready.\r
#define PL011_UARTCR_RXE          (1 << 9)  // Receive enable\r
#define PL011_UARTCR_TXE          (1 << 8)  // Transmit enable\r
#define PL011_UARTCR_LBE          (1 << 7)  // Loopback enable\r
#define PL011_UARTCR_UARTEN       (1 << 0)  // UART Enable\r
\r
// Line Control Register Bits\r
#define PL011_UARTLCR_H_SPS       (1 << 7)  // Stick parity select\r
#define PL011_UARTLCR_H_WLEN_8    (3 << 5)\r
#define PL011_UARTLCR_H_WLEN_7    (2 << 5)\r
#define PL011_UARTLCR_H_WLEN_6    (1 << 5)\r
#define PL011_UARTLCR_H_WLEN_5    (0 << 5)\r
#define PL011_UARTLCR_H_FEN       (1 << 4)  // FIFOs Enable\r
#define PL011_UARTLCR_H_STP2      (1 << 3)  // Two stop bits select\r
#define PL011_UARTLCR_H_EPS       (1 << 2)  // Even parity select\r
#define PL011_UARTLCR_H_PEN       (1 << 1)  // Parity Enable\r
#define PL011_UARTLCR_H_BRK       (1 << 0)  // Send break\r
\r
/*\r
\r
  Programmed hardware of Serial port.\r
\r
  @return    Always return EFI_UNSUPPORTED.\r
\r
**/\r
RETURN_STATUS\r
EFIAPI\r
PL011UartInitializePort (\r
  IN OUT UINTN               UartBase,\r
  IN OUT UINT64              *BaudRate,\r
  IN OUT UINT32              *ReceiveFifoDepth,\r
  IN OUT EFI_PARITY_TYPE     *Parity,\r
  IN OUT UINT8               *DataBits,\r
  IN OUT EFI_STOP_BITS_TYPE  *StopBits\r
  );\r
\r
/**\r
  Set the serial device control bits.\r
\r
  @param  UartBase                The base address of the PL011 UART.\r
  @param  Control                 Control bits which are to be set on the serial device.\r
\r
  @retval EFI_SUCCESS             The new control bits were set on the serial device.\r
  @retval EFI_UNSUPPORTED         The serial device does not support this operation.\r
  @retval EFI_DEVICE_ERROR        The serial device is not functioning correctly.\r
\r
**/\r
RETURN_STATUS\r
EFIAPI\r
PL011UartSetControl (\r
    IN UINTN                    UartBase,\r
    IN UINT32                   Control\r
  );\r
\r
/**\r
  Get the serial device control bits.\r
\r
  @param  UartBase                The base address of the PL011 UART.\r
  @param  Control                 Control signals read from the serial device.\r
\r
  @retval EFI_SUCCESS             The control bits were read from the serial device.\r
  @retval EFI_DEVICE_ERROR        The serial device is not functioning correctly.\r
\r
**/\r
RETURN_STATUS\r
EFIAPI\r
PL011UartGetControl (\r
    IN UINTN                    UartBase,\r
    OUT UINT32                  *Control\r
  );\r
\r
/**\r
  Write data to serial device.\r
\r
  @param  Buffer           Point of data buffer which need to be written.\r
  @param  NumberOfBytes    Number of output bytes which are cached in Buffer.\r
\r
  @retval 0                Write data failed.\r
  @retval !0               Actual number of bytes written to serial device.\r
\r
**/\r
UINTN\r
EFIAPI\r
PL011UartWrite (\r
  IN  UINTN       UartBase,\r
  IN  UINT8       *Buffer,\r
  IN  UINTN       NumberOfBytes\r
  );\r
\r
/**\r
  Read data from serial device and save the data in buffer.\r
\r
  @param  Buffer           Point of data buffer which need to be written.\r
  @param  NumberOfBytes    Number of output bytes which are cached in Buffer.\r
\r
  @retval 0                Read data failed.\r
  @retval !0               Actual number of bytes read from serial device.\r
\r
**/\r
UINTN\r
EFIAPI\r
PL011UartRead (\r
  IN  UINTN       UartBase,\r
  OUT UINT8       *Buffer,\r
  IN  UINTN       NumberOfBytes\r
  );\r
\r
/**\r
  Check to see if any data is available to be read from the debug device.\r
\r
  @retval EFI_SUCCESS       At least one byte of data is available to be read\r
  @retval EFI_NOT_READY     No data is available to be read\r
  @retval EFI_DEVICE_ERROR  The serial device is not functioning properly\r
\r
**/\r
BOOLEAN\r
EFIAPI\r
PL011UartPoll (\r
  IN  UINTN       UartBase\r
  );\r
\r
#endif\r
Commit	Line	Data
051e63bb	1	/** @file\r
	2	*\r
	3	* Copyright (c) 2011-2012, ARM Limited. All rights reserved.\r
	4	* \r
	5	* This program and the accompanying materials \r
	6	* are licensed and made available under the terms and conditions of the BSD License \r
	7	* which accompanies this distribution. The full text of the license may be found at \r
	8	* http://opensource.org/licenses/bsd-license.php \r
	9	*\r
	10	* THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, \r
	11	* WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. \r
	12	*\r
	13	**/\r
	14	\r
	15	#ifndef __PL011_UART_H__\r
	16	#define __PL011_UART_H__\r
	17	\r
	18	#include <Uefi.h>\r
	19	#include <Protocol/SerialIo.h>\r
	20	\r
	21	// PL011 Registers\r
	22	#define UARTDR 0x000\r
	23	#define UARTRSR 0x004\r
	24	#define UARTECR 0x004\r
	25	#define UARTFR 0x018\r
	26	#define UARTILPR 0x020\r
	27	#define UARTIBRD 0x024\r
	28	#define UARTFBRD 0x028\r
	29	#define UARTLCR_H 0x02C\r
	30	#define UARTCR 0x030\r
	31	#define UARTIFLS 0x034\r
	32	#define UARTIMSC 0x038\r
	33	#define UARTRIS 0x03C\r
	34	#define UARTMIS 0x040\r
	35	#define UARTICR 0x044\r
	36	#define UARTDMACR 0x048\r
	37	\r
	38	// Data status bits\r
	39	#define UART_DATA_ERROR_MASK 0x0F00\r
	40	\r
	41	// Status reg bits\r
	42	#define UART_STATUS_ERROR_MASK 0x0F\r
	43	\r
	44	// Flag reg bits\r
	45	#define PL011_UARTFR_RI (1 << 8) // Ring indicator\r
	46	#define PL011_UARTFR_TXFE (1 << 7) // Transmit FIFO empty\r
	47	#define PL011_UARTFR_RXFF (1 << 6) // Receive FIFO full\r
	48	#define PL011_UARTFR_TXFF (1 << 5) // Transmit FIFO full\r
	49	#define PL011_UARTFR_RXFE (1 << 4) // Receive FIFO empty\r
	50	#define PL011_UARTFR_BUSY (1 << 3) // UART busy\r
	51	#define PL011_UARTFR_DCD (1 << 2) // Data carrier detect\r
	52	#define PL011_UARTFR_DSR (1 << 1) // Data set ready\r
	53	#define PL011_UARTFR_CTS (1 << 0) // Clear to send\r
	54	\r
	55	// Flag reg bits - alternative names\r
	56	#define UART_TX_EMPTY_FLAG_MASK PL011_UARTFR_TXFE\r
	57	#define UART_RX_FULL_FLAG_MASK PL011_UARTFR_RXFF\r
	58	#define UART_TX_FULL_FLAG_MASK PL011_UARTFR_TXFF\r
	59	#define UART_RX_EMPTY_FLAG_MASK PL011_UARTFR_RXFE\r
	60	#define UART_BUSY_FLAG_MASK PL011_UARTFR_BUSY\r
	61	\r
	62	// Control reg bits\r
	63	#define PL011_UARTCR_CTSEN (1 << 15) // CTS hardware flow control enable\r
	64	#define PL011_UARTCR_RTSEN (1 << 14) // RTS hardware flow control enable\r
65	#define PL011_UARTCR_RTS (1 << 11) // Request to send\r
66	#define PL011_UARTCR_DTR (1 << 10) // Data transmit ready.\r
67	#define PL011_UARTCR_RXE (1 << 9) // Receive enable\r
68	#define PL011_UARTCR_TXE (1 << 8) // Transmit enable\r
69	#define PL011_UARTCR_LBE (1 << 7) // Loopback enable\r
70	#define PL011_UARTCR_UARTEN (1 << 0) // UART Enable\r
71	\r
72	// Line Control Register Bits\r
73	#define PL011_UARTLCR_H_SPS (1 << 7) // Stick parity select\r
74	#define PL011_UARTLCR_H_WLEN_8 (3 << 5)\r
75	#define PL011_UARTLCR_H_WLEN_7 (2 << 5)\r
76	#define PL011_UARTLCR_H_WLEN_6 (1 << 5)\r
77	#define PL011_UARTLCR_H_WLEN_5 (0 << 5)\r
78	#define PL011_UARTLCR_H_FEN (1 << 4) // FIFOs Enable\r
79	#define PL011_UARTLCR_H_STP2 (1 << 3) // Two stop bits select\r
80	#define PL011_UARTLCR_H_EPS (1 << 2) // Even parity select\r
81	#define PL011_UARTLCR_H_PEN (1 << 1) // Parity Enable\r
82	#define PL011_UARTLCR_H_BRK (1 << 0) // Send break\r
83	\r
84	/*\r
85	\r
86	Programmed hardware of Serial port.\r
87	\r
88	@return Always return EFI_UNSUPPORTED.\r
89	\r
90	**/\r
91	RETURN_STATUS\r
92	EFIAPI\r
93	PL011UartInitializePort (\r
15e277d5	94	IN OUT UINTN UartBase,\r
	95	IN OUT UINT64 *BaudRate,\r
	96	IN OUT UINT32 *ReceiveFifoDepth,\r
	97	IN OUT EFI_PARITY_TYPE *Parity,\r
	98	IN OUT UINT8 *DataBits,\r
	99	IN OUT EFI_STOP_BITS_TYPE *StopBits\r
051e63bb	100	);\r
	101	\r
	102	/**\r
	103	Set the serial device control bits.\r
	104	\r
	105	@param UartBase The base address of the PL011 UART.\r
	106	@param Control Control bits which are to be set on the serial device.\r
	107	\r
	108	@retval EFI_SUCCESS The new control bits were set on the serial device.\r
	109	@retval EFI_UNSUPPORTED The serial device does not support this operation.\r
	110	@retval EFI_DEVICE_ERROR The serial device is not functioning correctly.\r
	111	\r
	112	**/\r
	113	RETURN_STATUS\r
	114	EFIAPI\r
	115	PL011UartSetControl (\r
	116	IN UINTN UartBase,\r
	117	IN UINT32 Control\r
	118	);\r
	119	\r
	120	/**\r
	121	Get the serial device control bits.\r
	122	\r
	123	@param UartBase The base address of the PL011 UART.\r
	124	@param Control Control signals read from the serial device.\r
	125	\r
	126	@retval EFI_SUCCESS The control bits were read from the serial device.\r
	127	@retval EFI_DEVICE_ERROR The serial device is not functioning correctly.\r
	128	\r
	129	**/\r
	130	RETURN_STATUS\r
	131	EFIAPI\r
	132	PL011UartGetControl (\r
	133	IN UINTN UartBase,\r
	134	OUT UINT32 *Control\r
	135	);\r
	136	\r
	137	/**\r
	138	Write data to serial device.\r
	139	\r
	140	@param Buffer Point of data buffer which need to be written.\r
	141	@param NumberOfBytes Number of output bytes which are cached in Buffer.\r
	142	\r
	143	@retval 0 Write data failed.\r
	144	@retval !0 Actual number of bytes written to serial device.\r
	145	\r
	146	**/\r
	147	UINTN\r
	148	EFIAPI\r
	149	PL011UartWrite (\r
	150	IN UINTN UartBase,\r
	151	IN UINT8 *Buffer,\r
	152	IN UINTN NumberOfBytes\r
	153	);\r
	154	\r
	155	/**\r
	156	Read data from serial device and save the data in buffer.\r
	157	\r
	158	@param Buffer Point of data buffer which need to be written.\r
	159	@param NumberOfBytes Number of output bytes which are cached in Buffer.\r
	160	\r
	161	@retval 0 Read data failed.\r
	162	@retval !0 Actual number of bytes read from serial device.\r
	163	\r
164	**/\r
165	UINTN\r
166	EFIAPI\r
167	PL011UartRead (\r
168	IN UINTN UartBase,\r
169	OUT UINT8 *Buffer,\r
170	IN UINTN NumberOfBytes\r
171	);\r
172	\r
173	/**\r
174	Check to see if any data is available to be read from the debug device.\r
175	\r
176	@retval EFI_SUCCESS At least one byte of data is available to be read\r
177	@retval EFI_NOT_READY No data is available to be read\r
178	@retval EFI_DEVICE_ERROR The serial device is not functioning properly\r
179	\r
180	**/\r
181	BOOLEAN\r
182	EFIAPI\r
183	PL011UartPoll (\r
184	IN UINTN UartBase\r
185	);\r
186	\r
187	#endif\r