The DXE core calls library constructors after it calls DEBUG macros, so we need more error handling in the lib. signed-off-by: andrewfish git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@12118 6f19259b-4bc3-4df7-8a09-765794883524
		
			
				
	
	
		
			124 lines
		
	
	
		
			3.6 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			124 lines
		
	
	
		
			3.6 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/** @file
 | 
						|
  Serial Port Lib that thunks back to Emulator services to write to StdErr.
 | 
						|
  All read functions are stubed out.
 | 
						|
 | 
						|
  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>
 | 
						|
  Portions copyright (c) 2011, Apple Inc. All rights reserved.<BR>
 | 
						|
  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 <PiDxe.h>
 | 
						|
#include <Library/SerialPortLib.h>
 | 
						|
#include <Library/EmuThunkLib.h>
 | 
						|
 | 
						|
 | 
						|
 | 
						|
 | 
						|
/**
 | 
						|
  Initialize the serial device hardware.
 | 
						|
 | 
						|
  If no initialization is required, then return RETURN_SUCCESS.
 | 
						|
  If the serial device was successfully initialized, then return RETURN_SUCCESS.
 | 
						|
  If the serial device could not be initialized, then return RETURN_DEVICE_ERROR.
 | 
						|
 | 
						|
  @retval RETURN_SUCCESS        The serial device was initialized.
 | 
						|
  @retval RETURN_DEVICE_ERROR   The serial device could not be initialized.
 | 
						|
 | 
						|
**/
 | 
						|
RETURN_STATUS
 | 
						|
EFIAPI
 | 
						|
SerialPortInitialize (
 | 
						|
  VOID
 | 
						|
  )
 | 
						|
{
 | 
						|
  return RETURN_SUCCESS;
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
  Write data from buffer to serial device.
 | 
						|
 | 
						|
  Writes NumberOfBytes data bytes from Buffer to the serial device.
 | 
						|
  The number of bytes actually written to the serial device is returned.
 | 
						|
  If the return value is less than NumberOfBytes, then the write operation failed.
 | 
						|
  If Buffer is NULL, then ASSERT().
 | 
						|
  If NumberOfBytes is zero, then return 0.
 | 
						|
 | 
						|
  @param  Buffer           The pointer to the data buffer to be written.
 | 
						|
  @param  NumberOfBytes    The number of bytes to written to the serial device.
 | 
						|
 | 
						|
  @retval 0                NumberOfBytes is 0.
 | 
						|
  @retval >0               The number of bytes written to the serial device.
 | 
						|
                           If this value is less than NumberOfBytes, then the read operation failed.
 | 
						|
 | 
						|
**/
 | 
						|
UINTN
 | 
						|
EFIAPI
 | 
						|
SerialPortWrite (
 | 
						|
  IN UINT8     *Buffer,
 | 
						|
  IN UINTN     NumberOfBytes
 | 
						|
  )
 | 
						|
{
 | 
						|
  if (gEmuThunk == NULL) {
 | 
						|
    return NumberOfBytes;
 | 
						|
  }
 | 
						|
  
 | 
						|
  return gEmuThunk->WriteStdErr (Buffer, NumberOfBytes);
 | 
						|
}
 | 
						|
 | 
						|
 | 
						|
/**
 | 
						|
  Read data from serial device and save the datas in buffer.
 | 
						|
 | 
						|
  Reads NumberOfBytes data bytes from a serial device into the buffer
 | 
						|
  specified by Buffer. The number of bytes actually read is returned.
 | 
						|
  If the return value is less than NumberOfBytes, then the rest operation failed.
 | 
						|
  If Buffer is NULL, then ASSERT().
 | 
						|
  If NumberOfBytes is zero, then return 0.
 | 
						|
 | 
						|
  @param  Buffer           The pointer to the data buffer to store the data read from the serial device.
 | 
						|
  @param  NumberOfBytes    The number of bytes which will be read.
 | 
						|
 | 
						|
  @retval 0                Read data failed; No data is to be read.
 | 
						|
  @retval >0               The actual number of bytes read from serial device.
 | 
						|
 | 
						|
**/
 | 
						|
UINTN
 | 
						|
EFIAPI
 | 
						|
SerialPortRead (
 | 
						|
  OUT UINT8     *Buffer,
 | 
						|
  IN  UINTN     NumberOfBytes
 | 
						|
  )
 | 
						|
{
 | 
						|
  return 0;
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
  Polls a serial device to see if there is any data waiting to be read.
 | 
						|
 | 
						|
  Polls a serial device to see if there is any data waiting to be read.
 | 
						|
  If there is data waiting to be read from the serial device, then TRUE is returned.
 | 
						|
  If there is no data waiting to be read from the serial device, then FALSE is returned.
 | 
						|
 | 
						|
  @retval TRUE             Data is waiting to be read from the serial device.
 | 
						|
  @retval FALSE            There is no data waiting to be read from the serial device.
 | 
						|
 | 
						|
**/
 | 
						|
BOOLEAN
 | 
						|
EFIAPI
 | 
						|
SerialPortPoll (
 | 
						|
  VOID
 | 
						|
  )
 | 
						|
{
 | 
						|
  return FALSE;
 | 
						|
}
 | 
						|
 | 
						|
 |