Fix typo.

[mirror_edk2.git] / Vlv2TbltDevicePkg / Library / SerialPortLib / SerialPortLib.c

/** @file\r
  Serial I/O Port library functions with no library constructor/destructor\r
\r
  Copyright (c) 2006 - 2014, Intel Corporation. All rights reserved.<BR>\r
                                                                                   \r\r
  This program and the accompanying materials are licensed and made available under\r\r
  the terms and conditions of the BSD License that accompanies this distribution.  \r\r
  The full text of the license may be found at                                     \r\r
  http://opensource.org/licenses/bsd-license.php.                                  \r\r
                                                                                   \r\r
  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,            \r\r
  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.    \r\r
                                                                                   \r\r
  This software and associated documentation\r
  (if any) is furnished under a license and may only be used or\r
  copied in accordance with the terms of the license.  Except as\r
  permitted by such license, no part of this software or\r
  documentation may be reproduced, stored in a retrieval system, or\r
  transmitted in any form or by any means without the express written\r
  consent of Intel Corporation.\r
\r
  Module Name:  SerialPortLib.c\r
\r
**/\r
\r
#include "PlatformSerialPortLib.h"\r
\r
UINT16 gComBase  = 0x3f8;\r
UINTN  gBps      = 115200;\r
UINT8  gData     = 8;\r
UINT8  gStop     = 1;\r
UINT8  gParity   = 0;\r
UINT8  gBreakSet = 0;\r
\r
/**\r
  Initialize Serial Port\r
\r
  The Baud Rate Divisor registers are programmed and the LCR\r
  is used to configure the communications format. Hard coded\r
  UART config comes from globals in DebugSerialPlatform lib.\r
\r
  @param None\r
\r
  @retval None\r
\r
**/\r
RETURN_STATUS\r
EFIAPI\r
UARTInitialize (\r
  VOID\r
  )\r
{\r
  UINTN Divisor;\r
  UINT8 OutputData;\r
  UINT8 Data;\r
\r
  //\r
  // Map 5..8 to 0..3\r
  //\r
  Data = (UINT8) (gData - (UINT8) 5);\r
\r
  //\r
  // Calculate divisor for baud generator\r
  //\r
  Divisor = 115200 / gBps;\r
\r
  //\r
  // Set communications format\r
  //\r
  OutputData = (UINT8) ((DLAB << 7) | ((gBreakSet << 6) | ((gParity << 3) | ((gStop << 2) | Data))));\r
  IoWrite8 (gComBase + LCR_OFFSET, OutputData);\r
\r
  //\r
  // Configure baud rate\r
  //\r
  IoWrite8 (gComBase + BAUD_HIGH_OFFSET, (UINT8) (Divisor >> 8));\r
  IoWrite8 (gComBase + BAUD_LOW_OFFSET, (UINT8) (Divisor & 0xff));\r
\r
  //\r
  // Switch back to bank 0\r
  //\r
  OutputData = (UINT8) ((~DLAB << 7) | ((gBreakSet << 6) | ((gParity << 3) | ((gStop << 2) | Data))));\r
  IoWrite8 (gComBase + LCR_OFFSET, OutputData);\r
\r
  return RETURN_SUCCESS;\r
}\r
\r
/**\r
  Common function to initialize UART Serial device and USB Serial device.\r
\r
  @param None\r
\r
  @retval None\r
\r
**/\r
RETURN_STATUS\r
EFIAPI\r
SerialPortInitialize (\r
  VOID\r
  )\r
{\r
\r
  UARTInitialize ();\r
\r
\r
  return RETURN_SUCCESS;\r
}\r
\r
/**\r
  Write data to serial device.\r
\r
  If the buffer is NULL, then return 0;\r
  if NumberOfBytes is zero, then return 0.\r
\r
  @param  Buffer           Point of data buffer which need to be writed.\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 writed to serial device.\r
\r
**/\r
UINTN\r
EFIAPI\r
UARTDbgOut (\r
  IN UINT8     *Buffer,\r
  IN UINTN     NumberOfBytes\r
)\r
{\r
  UINTN Result;\r
  UINT8 Data;\r
\r
  if (NULL == Buffer) {\r
    return 0;\r
  }\r
\r
  Result = NumberOfBytes;\r
\r
  while (NumberOfBytes--) {\r
    //\r
    // Wait for the serial port to be ready.\r
    //\r
    do {\r
      Data = IoRead8 ((UINT16) PcdGet64 (PcdSerialRegisterBase) + LSR_OFFSET);\r
    } while ((Data & LSR_TXRDY) == 0);\r
    IoWrite8 ((UINT16) PcdGet64 (PcdSerialRegisterBase), *Buffer++);\r
  }\r
\r
  return Result;\r
}\r
\r
/**\r
  Common function to write data to UART Serial device and USB Serial device.\r
\r
  @param  Buffer           Point of data buffer which need to be writed.\r
  @param  NumberOfBytes    Number of output bytes which are cached in Buffer.\r
\r
**/\r
UINTN\r
EFIAPI\r
SerialPortWrite (\r
  IN UINT8     *Buffer,\r
  IN UINTN     NumberOfBytes\r
)\r
{\r
  if (FeaturePcdGet (PcdStatusCodeUseIsaSerial)) {\r
    UARTDbgOut (Buffer, NumberOfBytes);\r
  }\r
\r
  return RETURN_SUCCESS;\r
}\r
\r
/**\r
  Read data from serial device and save the datas in buffer.\r
\r
  If the buffer is NULL, then return 0;\r
  if NumberOfBytes is zero, then return 0.\r
\r
  @param  Buffer           Point of data buffer which need to be writed.\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 raed to serial device.\r
\r
**/\r
UINTN\r
EFIAPI\r
UARTDbgIn (\r
  OUT UINT8     *Buffer,\r
  IN  UINTN     NumberOfBytes\r
)\r
{\r
  UINTN Result;\r
  UINT8 Data;\r
\r
  if (NULL == Buffer) {\r
    return 0;\r
  }\r
\r
  Result = NumberOfBytes;\r
\r
  while (NumberOfBytes--) {\r
    //\r
    // Wait for the serial port to be ready.\r
    //\r
    do {\r
      Data = IoRead8 ((UINT16) PcdGet64 (PcdSerialRegisterBase) + LSR_OFFSET);\r
    } while ((Data & LSR_RXDA) == 0);\r
\r
    *Buffer++ = IoRead8 ((UINT16) PcdGet64 (PcdSerialRegisterBase));\r
  }\r
\r
  return Result;\r
}\r
\r
/**\r
  Common function to Read data from UART serial device, USB serial device and save the datas in buffer.\r
\r
  @param  Buffer           Point of data buffer which need to be writed.\r
  @param  NumberOfBytes    Number of output bytes which are cached in Buffer.\r
\r
**/\r
UINTN\r
EFIAPI\r
SerialPortRead (\r
  OUT UINT8     *Buffer,\r
  IN  UINTN     NumberOfBytes\r
)\r
{\r
  if (FeaturePcdGet (PcdStatusCodeUseIsaSerial)) {\r
    UARTDbgIn (Buffer, NumberOfBytes);\r
  }\r
\r
  return RETURN_SUCCESS;\r
}\r
\r
\r
/**\r
  Polls a serial device to see if there is any data waiting to be read.\r
\r
  Polls aserial device to see if there is any data waiting to be read.\r
  If there is data waiting to be read from the serial device, then TRUE is returned.\r
  If there is no data waiting to be read from the serial device, then FALSE is returned.\r
\r
  @retval TRUE             Data is waiting to be read from the serial device.\r
  @retval FALSE            There is no data waiting to be read from the serial device.\r
\r
**/\r
BOOLEAN\r
EFIAPI\r
SerialPortPoll (\r
  VOID\r
  )\r
{\r
  UINT8  Data;\r
\r
  //\r
  // Read the serial port status.\r
  //\r
  Data = IoRead8 ((UINT16) PcdGet64 (PcdSerialRegisterBase) + LSR_OFFSET);\r
\r
  return (BOOLEAN) ((Data & LSR_RXDA) != 0);\r
}\r