/** @file Serial I/O Port library functions with no library constructor/destructor Copyright (c) 2008 - 2010, Apple Inc. All rights reserved.
Copyright (c) 2011 - 2016, ARM Ltd. All rights reserved.
Copyright (c) 2017, Rockchip Inc. All rights reserved.
This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at http://opensource.org/licenses/bsd-license.php THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. **/ #include #include #include #include /* uart some key registers offset */ #define UART_RBR 0x00 #define UART_THR 0x00 #define UART_DLL 0x00 #define UART_DLH 0x04 #define UART_IER 0x04 #define UART_LCR 0x0c #define UART_MCR 0x10 #define UART_LSR 0x14 #define UART_USR 0x7c #define UART_SRR 0x88 #define UART_SFE 0x98 #define UART_SRT 0x9c #define UART_STET 0xa0 #define UART_LSR_TEMT 0x40 /* Transmitter empty */ /* UART_IER */ #define THRE_INT_ENABLE (1<<7) #define THRE_INT_DISABLE (0) #define ENABLE_MODEM_STATUS_INT (1<<3) #define DISABLE_MODEM_STATUS_INT (0) #define ENABLE_RECEIVER_LINE_STATUS_INT (1<<2) #define DISABLE_RECEIVER_LINE_STATUS_INT (0) #define ENABLE_TRANSMIT_HOLDING_EM_INT (1<<1) /* Enable Transmit Holding Register Empty Interrupt. */ #define DISABLE_TRANSMIT_HOLDING_EM_INT (0) #define ENABLE_RECEIVER_DATA_INT (1) /* Enable Received Data Available Interrupt. */ #define DISABLE_RECEIVER_DATA_INT (0) /* UART_IIR */ #define IR_MODEM_STATUS (0) #define NO_INT_PENDING (1) #define THR_EMPTY (2) #define RECEIVER_DATA_AVAILABLE (0x04) #define RECEIVER_LINE_AVAILABLE (0x06) #define BUSY_DETECT (0x07) #define CHARACTER_TIMEOUT (0x0c) /* UART_LCR */ #define LCR_DLA_EN (1<<7) #define BREAK_CONTROL_BIT (1<<6) #define PARITY_DISABLED (0) #define PARITY_ENABLED (1<<3) #define ONE_STOP_BIT (0) #define ONE_HALF_OR_TWO_BIT (1<<2) #define LCR_WLS_5 (0x00) #define LCR_WLS_6 (0x01) #define LCR_WLS_7 (0x02) #define LCR_WLS_8 (0x03) #define UART_DATABIT_MASK (0x03) /* UART_MCR */ #define IRDA_SIR_DISABLED (0) #define IRDA_SIR_ENSABLED (1<<6) #define AUTO_FLOW_DISABLED (0) #define AUTO_FLOW_ENSABLED (1<<5) /* UART_LSR */ #define THRE_BIT_EN (1<<5) /* UART_USR */ #define UART_RECEIVE_FIFO_EMPTY (0) #define UART_RECEIVE_FIFO_NOT_EMPTY (1<<3) #define UART_TRANSMIT_FIFO_FULL (0) #define UART_TRANSMIT_FIFO_NOT_FULL (1<<1) #define UART_TRANSMIT_FIFO_EMPTY (1<<2) #define UART_IS_BUSY (1<<0) /* UART_SFE */ #define SHADOW_FIFI_ENABLED (1) #define SHADOW_FIFI_DISABLED (0) /* UART_SRT */ #define RCVR_TRIGGER_ONE (0) #define RCVR_TRIGGER_QUARTER_FIFO (1) #define RCVR_TRIGGER_HALF_FIFO (2) #define RCVR_TRIGGER_TWO_LESS_FIFO (3) /* UART_STET */ #define TX_TRIGGER_EMPTY (0) #define TX_TRIGGER_TWO_IN_FIFO (1) #define TX_TRIGGER_ONE_FOUR_FIFO (2) #define TX_TRIGGER_HALF_FIFO (3) /* UART_SRR */ #define UART_RESET (1) #define RCVR_FIFO_REST (1<<1) #define XMIT_FIFO_RESET (1<<2) #define UART_MODE_X_DIV 16 #define UART_BIT5 5 #define UART_BIT6 6 #define UART_BIT7 7 #define UART_BIT8 8 /** Initialise the serial port to the specified settings. The serial port is re-configured only if the specified settings are different from the current settings. All unspecified settings will be set to the default values. @param UartBase The base address of the serial device. @param UartClkInHz The clock in Hz for the serial device. Ignored if the PCD PL011UartInteger is not 0 @param BaudRate The baud rate of the serial device. If the baud rate is not supported, the speed will be reduced to the nearest supported one and the variable's value will be updated accordingly. @param ReceiveFifoDepth The number of characters the device will buffer on input. Value of 0 will use the device's default FIFO depth. @param Parity If applicable, this is the EFI_PARITY_TYPE that is computed or checked as each character is transmitted or received. If the device does not support parity, the value is the default parity value. @param DataBits The number of data bits in each character. @param StopBits If applicable, the EFI_STOP_BITS_TYPE number of stop bits per character. If the device does not support stop bits, the value is the default stop bit value. @retval RETURN_SUCCESS All attributes were set correctly on the serial device. @retval RETURN_INVALID_PARAMETER One or more of the attributes has an unsupported value. **/ RETURN_STATUS EFIAPI UartInitializePort ( IN UINTN UartBase, IN UINT32 UartClkInHz, IN OUT UINT64 *BaudRate, IN OUT UINT32 *ReceiveFifoDepth, IN OUT EFI_PARITY_TYPE *Parity, IN OUT UINT8 *DataBits, IN OUT EFI_STOP_BITS_TYPE *StopBits ) { UINT32 Lcr, Rate; //do {} while ((MmioRead32(UartBase + UART_USR) & UART_IS_BUSY)); // UART reset, rx fifo & tx fifo reset MmioWrite32(UartBase + UART_SRR, UART_RESET | RCVR_FIFO_REST | XMIT_FIFO_RESET); // UART interrupt disable MmioWrite32(UartBase + UART_IER, 0x00); // UART set iop MmioWrite32(UartBase + UART_MCR, IRDA_SIR_DISABLED); // UART set lcr Lcr = MmioRead32(UartBase + UART_LCR); Lcr &= ~UART_DATABIT_MASK; // byte set switch (*DataBits) { case UART_BIT5: Lcr |= LCR_WLS_5; break; case UART_BIT6: Lcr |= LCR_WLS_6; break; case UART_BIT7: Lcr |= LCR_WLS_7; break; case UART_BIT8: default: Lcr |= LCR_WLS_8; break; } // Parity set switch (*Parity) { case NoParity: Lcr |= PARITY_DISABLED; break; case DefaultParity: default: Lcr |= PARITY_ENABLED; break; } // stopbits set switch (*StopBits) { case TwoStopBits: case OneFiveStopBits: Lcr |= ONE_HALF_OR_TWO_BIT; break; case OneStopBit: default: Lcr |= ONE_STOP_BIT; break; } MmioWrite32(UartBase + UART_LCR, Lcr); // UART set baudrate /* uart rate is div for 24M input clock */ Rate = PcdGet32 (UartClkInHz) / UART_MODE_X_DIV / *BaudRate; Lcr = MmioRead32(UartBase + UART_LCR); MmioWrite32(UartBase + UART_LCR, Lcr | LCR_DLA_EN); MmioWrite32(UartBase + UART_DLL, Rate & 0xFF); MmioWrite32(UartBase + UART_DLH, (Rate >> 8) & 0xff); Lcr = MmioRead32(UartBase + UART_LCR); MmioWrite32(UartBase + UART_LCR, Lcr & (~LCR_DLA_EN)); // UART set fifo /* shadow FIFO enable */ MmioWrite32(UartBase + UART_SFE, SHADOW_FIFI_ENABLED); /* fifo 2 less than */ MmioWrite32(UartBase + UART_SRT, RCVR_TRIGGER_TWO_LESS_FIFO); /* 2 char in tx fifo */ MmioWrite32(UartBase + UART_STET, TX_TRIGGER_TWO_IN_FIFO); return RETURN_SUCCESS; } /** Assert or deassert the control signals on a serial port. The following control signals are set according their bit settings : . Request to Send . Data Terminal Ready @param[in] UartBase UART registers base address @param[in] Control The following bits are taken into account : . EFI_SERIAL_REQUEST_TO_SEND : assert/deassert the "Request To Send" control signal if this bit is equal to one/zero. . EFI_SERIAL_DATA_TERMINAL_READY : assert/deassert the "Data Terminal Ready" control signal if this bit is equal to one/zero. . EFI_SERIAL_HARDWARE_LOOPBACK_ENABLE : enable/disable the hardware loopback if this bit is equal to one/zero. . EFI_SERIAL_SOFTWARE_LOOPBACK_ENABLE : not supported. . EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE : enable/ disable the hardware flow control based on CTS (Clear To Send) and RTS (Ready To Send) control signals. @retval RETURN_SUCCESS The new control bits were set on the device. @retval RETURN_UNSUPPORTED The device does not support this operation. **/ RETURN_STATUS EFIAPI UartSetControl ( IN UINTN UartBase, IN UINT32 Control ) { return RETURN_SUCCESS; } /** Retrieve the status of the control bits on a serial device. @param[in] UartBase UART registers base address @param[out] Control Status of the control bits on a serial device : . EFI_SERIAL_DATA_CLEAR_TO_SEND, EFI_SERIAL_DATA_SET_READY, EFI_SERIAL_RING_INDICATE, EFI_SERIAL_CARRIER_DETECT, EFI_SERIAL_REQUEST_TO_SEND, EFI_SERIAL_DATA_TERMINAL_READY are all related to the DTE (Data Terminal Equipment) and DCE (Data Communication Equipment) modes of operation of the serial device. . EFI_SERIAL_INPUT_BUFFER_EMPTY : equal to one if the receive buffer is empty, 0 otherwise. . EFI_SERIAL_OUTPUT_BUFFER_EMPTY : equal to one if the transmit buffer is empty, 0 otherwise. . EFI_SERIAL_HARDWARE_LOOPBACK_ENABLE : equal to one if the hardware loopback is enabled (the ouput feeds the receive buffer), 0 otherwise. . EFI_SERIAL_SOFTWARE_LOOPBACK_ENABLE : equal to one if a loopback is accomplished by software, 0 otherwise. . EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE : equal to one if the hardware flow control based on CTS (Clear To Send) and RTS (Ready To Send) control signals is enabled, 0 otherwise. @retval RETURN_SUCCESS The control bits were read from the serial device. **/ RETURN_STATUS EFIAPI UartGetControl ( IN UINTN UartBase, OUT UINT32 *Control ) { return RETURN_SUCCESS; } /** Write data to serial device. @param Buffer Point of data buffer which need to be written. @param NumberOfBytes Number of output bytes which are cached in Buffer. @retval 0 Write data failed. @retval !0 Actual number of bytes written to serial device. **/ UINTN EFIAPI UartWrite ( IN UINTN UartBase, IN UINT8 *Buffer, IN UINTN NumberOfBytes ) { UINT8* CONST Final = &Buffer[NumberOfBytes]; while (Buffer < Final) { do {} while ((MmioRead32(UartBase + UART_USR) & UART_TRANSMIT_FIFO_NOT_FULL) == 0); MmioWrite32(UartBase + UART_THR, *Buffer++); } return NumberOfBytes; } /** Read data from serial device and save the data in buffer. @param Buffer Point of data buffer which need to be written. @param NumberOfBytes Number of output bytes which are cached in Buffer. @retval 0 Read data failed. @retval !0 Actual number of bytes read from serial device. **/ UINTN EFIAPI UartRead ( IN UINTN UartBase, OUT UINT8 *Buffer, IN UINTN NumberOfBytes ) { UINTN Count; for (Count = 0; Count < NumberOfBytes; Count++, Buffer++) { do {} while ((MmioRead32(UartBase + UART_USR) & UART_RECEIVE_FIFO_NOT_EMPTY) == 0); *Buffer = (UINT8)MmioRead32(UartBase + UART_RBR); } return NumberOfBytes; } /** Check to see if any data is available to be read from the debug device. @retval TRUE At least one byte of data is available to be read @retval FALSE No data is available to be read **/ BOOLEAN EFIAPI UartPoll ( IN UINTN UartBase ) { return (MmioRead32(UartBase + UART_USR) & UART_RECEIVE_FIFO_NOT_EMPTY) == UART_RECEIVE_FIFO_NOT_EMPTY; }