init. 1AQQW051HEADmaster

1 files changed, 1788 insertions, 0 deletions

diff --git a/Core/EM/Terminal/TerminalSetup.c b/Core/EM/Terminal/TerminalSetup.c
new file mode 100644
index 0000000..312c0f1
--- /dev/null
+++ b/Core/EM/Terminal/TerminalSetup.c
@@ -0,0 +1,1788 @@
+//****************************************************************************
+//****************************************************************************
+//**                                                                        **
+//**             (C)Copyright 1985-20014, American Megatrends, Inc.          **
+//**                                                                        **
+//**                          All Rights Reserved.                          **
+//**                                                                        **
+//**             5555 Oakbrook Pkwy, Suite 200, Norcross, GA 30093          **
+//**                                                                        **
+//**                          Phone (770)-246-8600                          **
+//**                                                                        **
+//****************************************************************************
+//****************************************************************************
+// $Header: /Alaska/BIN/Modules/Terminal/TerminalSetup.c 68    5/29/14 5:20a Deepthins $
+//
+// $Revision: 68 $
+//
+// $Date: 5/29/14 5:20a $
+//**********************************************************************
+// Revision History
+// ----------------
+// $Log: /Alaska/BIN/Modules/Terminal/TerminalSetup.c $
+// 
+// 68    5/29/14 5:20a Deepthins
+// [TAG]  		EIP166561
+// [Category]  	Bug Fix
+// [Severity]  	Normal
+// [Symptom]  	Runtime attribute set for the some of the variables used by
+// terminal driver.
+// [RootCause]  	Runtime attribute set for the some of the variables used
+// by terminal driver.
+// [Solution]  	Runtime attribute is removed
+// [Files]  		TerminalSetup.c
+// 
+// 67    3/17/14 12:16a Anbuprakashp
+// [TAG]  		EIP156273
+// [Category]  	Improvement
+// [Description]  	Avoid Build issue happened in Non english version of
+// the OS with Serial Redirection label 4.6.3_Terminal_53
+// [Files]  		Terminal.sd,TerminalSetup.c
+// 
+// 66    9/04/13 3:27a Anbuprakashp
+// [TAG]  		EIP134648
+// [Category]  	Bug Fix
+// [Severity]  	Minor
+// [Symptom]  	Build error occurs in Sharkbay platform if tokens
+// "TOTAL_SIO_SERIAL_PORTS" and "TOTAL_PCI_SERIAL_PORTS" are set to 0
+// [RootCause]  	TerminalSetup.c file Status Variable Initialization is
+// missing.Terminal.sd file, Condition (TOTAL_SERIAL_PORTS > 0) need to be
+// added to avoid build error.
+// [Solution]  	Terminal.sd file, Condition (TOTAL_SERIAL_PORTS > 0) added
+// to avoid build error.
+// Status variable initialzed properly.
+// [Files]  		Terminal.sd,TerminalSetup.c
+// 
+// 65    8/21/13 1:23a Anbuprakashp
+// [TAG]  		EIP131785
+// [Category]  	Bug Fix
+// [Severity]  	Minor
+// [Symptom]  	Serial Redirection PCI COM port function numbers are
+// changing randomly for every reboot
+// [RootCause]  	COM port number and its associated PCI Function numbers
+// are
+// changing due to the funtion (ValidatePciSerialNvram) in TerminalSetup.c
+// file of the SerialRedirection module.Here, It fail to make particular
+// PCI COM port function number to Zero.
+// As it wrongly comparing device path for the PCI com port.
+// 
+// [Solution]  	PCI serial COM port's Device Path comparing condition
+// commented.
+// [Files]  		TerminalSetup.c
+// 
+// 64    5/27/13 6:34a Rameshr
+// [TAG]  		EIP121329
+// [Category]  	Improvement
+// [Description]  	Serial Mouse Detection added based on the SDL token and
+// by default kept disabled
+// 
+// [Files]  		SerialIo.c, TerminalSetup.c , Terminal.sdl
+// 
+// 63    5/02/13 9:27a Kapilporwal
+// [TAG]  		EIP117486
+// [Description]  	CppCheck error in Terminal label 4.6.3_Terminal_50
+// [Files]  		SerialIo.c, Terminal.c, TerminalSetup.c,
+// TerminalSimpleTextOut.c
+// 
+// 62    2/11/13 3:00a Rameshr
+// [TAG]  		EIP113629
+// [Category]  	New Feature
+// [Description]  	Terminal driver support for ctrl+key(ASCII Control
+// Char) combinations
+// [Files]  		Terminal.sdl, TerminalSetup.c, TerminalSimpleTextIn.c
+// 
+// 61    6/29/12 5:29a Srilathasc
+// [TAG]  		EIP93519 
+// [Category]  	Improvement
+// [Description]  	make hardware flow control maximum re-try count as SDL
+// token.
+// [Files]  		Terminal.sdl, TerminalSetup.c, SerialIo.c
+// 
+// 60    3/30/12 12:16a Rajeshms
+// [TAG]  		EIP86477 
+// [Category]  	Improvement
+// [Description]  	PuttyKeyPad value is returned as non-zero(PUTTY_VT100)
+// from GetSetupValuesForTerminal() if there is any error in that
+// function.
+// [Files]  		TerminalSetup.c
+// 
+// 59    3/29/12 11:58p Rajeshms
+// [TAG]  		EIP84341
+// [Category]  	Improvement
+// [Description]  	Added Separate PCI_UART_INPUT_CLOCK token for setting
+// the Clock for PCI Serial UART.
+// [Files]  		Terminal.sdl, TerminalSetup.c, SerialIo.c, LegacySredir.c,
+// LegacySredir_Setup.c
+// 
+// 58    12/12/11 6:53a Rajeshms
+// [TAG]  		EIP71636
+// [Category]  	New Feature
+// [Description]  	Implement the AMI_SERIAL_PROTOCOL for non-generic PCI
+// Serial Device.
+// [Files]  		AmiSerial.c, AmiSerial.sdl, AmiSerial.mak, AmiSerial.chm,
+// AmiSerial.dxs, AmiSerial.cif, Terminal.c, SerialIo.c, TerminalSetup.c,
+// InitTerminalStrings.c, TerminalSetupVar.h, Terminal.cif,
+// TerminalAmiSerial.h, LegacySredir_Setup.c
+// 
+// 57    11/03/11 4:47a Rameshr
+// [TAG]  		EIP73026
+// [Category]  	Improvement
+// [Description]  	SetNvramVariable used on line 1039, conditionally not
+// set
+// [Files]  		TerminalSetup.c
+// 
+// 56    10/19/11 6:42a Rajeshms
+// [TAG]  		EIP71973
+// [Category]  	Bug Fix
+// [Severity]  	Normal
+// [Symptom]  	ASCII Control characters that are used to display graphics
+// characters are not  redirected to remote if Putty/teraterm application
+// is used.
+// [RootCause]  	Putty/Teraterm application does not use ASCII control
+// characters as Printable characters. 
+// [Solution]  	DONT_SEND_ASCII_CONTROL_PRINTABLE_CHARACTERS token has
+// been created, if disabled it will not send the ASCII control
+// characters.
+// [Files]  		Terminal.sdl, TerminalSetup.c, TerminalSimpleTextOut.c
+// 
+// 55    9/20/11 3:05a Rajeshms
+// [TAG]  		EIP70320
+// [Category]  	Bug Fix
+// [Severity]  	Critical
+// [Symptom]  	SPCR table is not created with EFI_SPECIFICATION_VERSION
+// 0x2000A
+// [RootCause]  	Comport was returned as 0xff from
+// GetAcpiSpcrTableValues() as the PORT number is zero indexed after
+// EFI_SPECIFICATION_VERSION 0x2000A.
+// [Solution]  	The comport number is not subtracted with 1 if
+// EFI_SPECIFICATION_VERSION is equal to greater  than0x2000A
+// [Files]  		Terminal.sd, TerminalSetup.c
+// 
+// 54    8/29/11 6:26a Rameshr
+// [TAG] - EIP 55335
+// [Category]- IMPROVEMENT
+// [Description]- Add optional code to clear keyboard buffer at
+// ReadyToBoot in Terminal driver
+// [Files] - Terminal.c , Terminal.h, Terminal.sdl, TerminalSetup.c
+// 
+// 53    7/13/11 2:47a Rajeshms
+// [TAG]- EIP 36616
+// [Category]- New Feature
+// [Description]- Add Setup option for Various Putty keyPad support in
+// Terminal driver.
+// [Files]- Terminal.c, Terminal.h, Terminal.sd, Terminal.sdl,
+// Terminal.uni, TerminalBoard.h, TerminalSetup.c, TerminalSimpleTextIn.c
+// 
+// 52    5/19/11 1:58a Rameshr
+// [TAG] - EIP 59741 
+// [Category]- BUG FIX
+// [Severity]- Minor
+// [Symptom] - System hangs if the Serial port doesn't work 
+// [RootCause]- Serial Port says valid, but when we try to write, Terminal
+// Holding Register never gets Empty.
+// [Solution] - Added Error Count when the maximum error count reached,
+// SerialIoWrite has been stopped
+// [Files] - SerialIo.c, Terminal.sdl , TerminalSetup.c
+// 
+// 51    4/29/11 5:04a Rameshr
+// [TAG] - EIP 54870 
+// [Category]- BUG FIX
+// [Severity]- Major
+// [Symptom] - Legacy Console Redirection doesn't work on 2nd PCI Serial
+// Port 
+// [RootCause]- Terminal creats the same Nvram variable name for all the
+// PCI Serial devices 
+// [Solution] - Created seperate Nvram Variable name for each PCI serial
+// devices Ahci recovery driver shutdown code exectued only when the
+// Recovery from Ahci driver started 
+// [Files] - TerminalSetup.c
+// 
+// 50    4/12/11 4:31a Rameshr
+// [TAG]- EIP 57688
+// [Category]- New Feature
+// [Description]- Add Setup option for Vt-UTF8 combo key support in
+// terminal driver 
+// [Files]- Terminal.c, Terminal.h, Terminal.sd, Terminal.sdl ,
+// Terminal.uni, Terminalboard.h, TerminalSetup.c, TerminalSimpletextin.c
+// 
+// 49    3/02/11 3:14a Rameshr
+// [TAG]- EIP 54313
+// [Category]-IMPROVEMENT
+// [Description]- Terminal driver Getvariable calls assumed to have valid
+// values. Added code to return the error code when there is an failure in
+// the getvariable call. 
+// [Files]- TerminalSetup.c, InitTerminalString.c
+// 
+// 48    3/02/11 3:07a Rameshr
+// [TAG]- EIP 54526
+// [Category]-IMPROVEMENT
+// [Description]- PCI serial MMIO device width support added through SDL
+// token 
+// [Files]- SerialIo.c , TerminalSetup.c , Terminal.sdl
+// 
+// 47    2/07/11 12:55a Rameshr
+// [TAG] - EIP 53292
+// [Category]- BUG FIX
+// [Severity]- Minor
+// [Symptom] - CPU Exception D in Terminal when enabling more than 1
+// Serial Port.
+// [RootCause]- ComPort value is not initilized , that returns junk value
+// causing the invalid exection.
+// [Solution] - Initilized to 0xFF
+// [Files] - TerminalSetup.c
+// 
+// 46    1/20/11 1:16a Lavanyap
+// [TAG] - EIP51898
+// [Category] - BUG FIX
+// [Severity] - Minor
+// [Symptom] - SDL tokens are not working in Terminal driver when Terminal
+// source module is not available in project.
+// [RootCause] - Tokens are defined in Terminal binary module and are used
+// in source module,so SDL token value changes cannot take effect when
+// source module is not present in the project.
+// [Solution] - Replaced SDL tokens used in source module with variables
+// defined in binary module.
+// [Files] - Terminal.c, TerminalSetup.c
+// 
+// 45    11/29/10 11:58p Rajeshms
+// Build error resolved that caused because of previous Check-in.
+// 
+// 44    11/29/10 7:28a Rajeshms
+// [TAG] - EIP 39842
+// [Category]- BUG FIX
+// [Severity]- Normal
+// [Symptom] - PCI Serial Doesn't work when we change the PCI Serial
+// device to different Slot(TOTAL_PCI_SERIAL_PORTS=1).
+// [RootCause] - NVRAM variable was not set to Zero once device was
+// removed from that slot so eventhough device(in another slot) is
+// detected its not shown in Setup.  
+// [Solution] - NVRAM variable which was set previously when device was
+// present is set to ZERO if the device is not present in current slot.
+// [Files] - TerminalSetup.c
+// 
+// 43    11/03/10 2:07a Rajeshms
+// [TAG] - EIP 46234
+// [Category]- BUG FIX
+// [Severity]- Normal
+// [Symptom] - If TOTAL_PCI_SERIAL_PORTS=1, the BIOS will hang in POST in
+// non-debug mode.Was reproduced in CrownBay.
+// [RootCause] - In non-debug mode terminal driver gets garbage value for
+// UINT8 ComPort; in some cases so it hangs.  
+// [Solution] - UINT8 Comport is initialised to zero.
+// [Files] - TerminalSetup.c
+// 
+// 42    11/02/10 4:15a Lavanyap
+// [TAG] - EIP42299
+// [Category] - IMPROVEMENT
+// [Description] - Console Redirection can support 10 COM Ports.
+// [Files] - InitTerminalStrings.c, SerialIo.c, Terminal.sd, 
+//           Terminal.sdl, Terminal.uni, TerminalSetup.c
+// 
+// 41    10/19/10 8:35a Rajeshms
+// [TAG]- EIP 39562
+// [Category]-IMPROVEMENT
+// [Description]- Show entire PCI address of redirection device in Setup
+// [Files]- Terminal.c, TerminalSetup.c, InitTerminalStrings.c
+// 
+// 40    6/01/10 12:32a Rameshr
+// Support for Baud Rate 38400 in Terminal Driver
+// EIP 38852
+// 
+// 39    5/03/10 1:14a Rameshr
+// Issue:Need to handle different Base Hz values for SerialStatusCode,
+// Terminal, and Legacy Serial Redirection.
+// Solution: Moved Uart input clock into Core.sdl token and used in all
+// the above modules.
+// EIP: 37332
+// 
+// 38    5/03/10 12:22a Rameshr
+// Issue:VT-UTF8 mode support for Console redirection with Debugger
+// Solution: Serial Port attribute Setup questions added for the debugger
+// console redirection port.
+// EIP 37440
+// 
+// 37    4/19/10 1:44a Rameshr
+// Build problem resolved because of removing
+// DEFAULT_CONSOLE_REDIRECTION_ENABLE SDL token.
+// 
+// 36    3/31/10 12:30a Rameshr
+// Recorder mode support Added.
+// EIP 34388
+// 
+// 35    1/21/10 4:11p Artems
+// 
+// 34    12/16/09 6:35p Artems
+// 
+// 33    11/26/09 6:00a Rameshr
+// SPCR table OEMID and OEMTABLEID configured through SDL tokens.
+// EIP:26773
+// 
+// 32    10/26/09 9:48a Yul
+// EIP 26401
+// Console Redirection freezes when "CTRL + R" (refresh screen) is used
+// 
+// 31    10/21/09 11:28a Artems
+// EIP 25955 - fixed switching mode mechanism
+// 
+// 30    10/08/09 6:02p Pats
+// EIP 23731: Need to remove SIO serial port from Console Redirection
+// Setup menu if TOTAL_SIO_SERIAL_PORTS is 0.
+// Solution: In SetSerialPortsEnabledVar_Sio(), "#if (TOTAL_SERIAL_PORTS >
+// 0)" changed to "#if (TOTAL_SIO_SERIAL_PORTS > 0)".
+// 
+// 29    9/28/09 4:08p Rameshr
+// Terminal assumes UID to be started from 0. This assumption removed as
+// UID should be unique and not be started from 0.
+// EIP 17239
+// 
+// 28    9/21/09 11:38a Rameshr
+// SerailIo driver to handle Pciserial device based on the SDL token
+// settings.
+// EIP 23764
+// 
+// 27    9/04/09 3:55p Krishnakumarg
+// DEFAULT_DEBUGGER_CONSOLE_REDIRECTION_ENABLE token created for setting
+// default option for debugger port.
+// 
+// 26    7/17/09 2:48p Rameshr
+// ESC sequence information moved from Lib to Board module.
+// Uart fifo size added as SDL token.
+// EIP 23064
+// 
+// 25    7/02/09 5:01p Rameshr
+// Coding Standard and File header updated.
+// 
+// 24    11/12/08 5:55p Ambikas
+// 
+// 23    9/08/08 4:52p Ambikas
+// 
+// 22    5/13/08 3:40p Rameshraju
+// Terminal Resolution 100 x 31 support Added
+// 
+// 21    4/14/08 7:51p Ambikas
+// 
+// 20    4/14/08 7:42p Ambikas
+// 
+// 19    4/14/08 4:52p Ambikas
+// 
+// 18    4/14/08 4:46p Ambikas
+// 
+// 17    11/07/07 4:53p Ambikas
+// We have reverted to the version of VfrCompile which uses 1 based
+// arrays.  
+// Array indeces have been changed accordingly.  
+// 
+// 16    10/11/07 7:42a Ambikas
+// 
+// 15    6/12/07 3:58p Ambikas
+// 
+// 14    6/11/07 11:36a Ambikas
+// 
+// 13    6/10/07 6:02p Ambikas
+// 
+// 12    6/06/07 7:52p Ambikas
+// We now save the pci device path of pci serial port rather than segment
+// and bus numbers.
+// 
+// 11    6/05/07 6:26p Ambikas
+// 
+// 10    6/05/07 11:55a Ambikas
+// 
+// 9     6/4/2007 7:34p Ambikas
+// 
+// 8     6/4/2007 7:30p Ambikas
+// If TOTAL_SERIAL_PORTS is 0, then the setup data structures for the
+// serial ports in Terminal.sd will not be defined.  So, we comment out
+// code which references those data structures and just return default 
+// values. 
+// 
+// 7     5/30/2007 12:18p Ambikas
+// 
+// 6     5/29/2007 8:35p Ambikas
+// 
+// 5     5/24/2007 2:33p Ambikas
+// 
+// 4     8/24/2006 7:07p Felixp
+// x64 support (warnings/errors fixed)
+// 
+// 3     8/24/2006 3:34p Felixp
+// x64 support (warnings/errors fixed)
+// 
+// 2     5/05/2006 5:35p Ambikas
+//
+// 1     11/11/2005 2:07p Ambikas
+//
+//**********************************************************************
+//<AMI_FHDR_START>
+//
+// Name: TerminalSetup.c
+//
+// Description: This file contains functions used by 
+//              Terminal.lib/Terminalx64.lib to get Terminal/Serial 
+//              related setup values.  
+//
+//<AMI_FHDR_END>
+//**********************************************************************
+
+
+#include <Protocol\SerialIo.h>  //for SERIAL_IO_MODE
+#include <Token.h>              //for sdl tokens
+#include <AmiDxeLib.h>          //for pRS
+#include "TerminalBoard.h"
+
+#include <Protocol\SerialIo.h>
+#include <Setup.h>
+#include "TerminalSetupVar.h"
+#include <protocol\PciRootBridgeIo.h>
+#include <Pci.h>
+
+#define PCI_CFG_ADDRESS(bus,dev,func,reg) \
+    ((UINT64)((((UINTN)bus) << 24) + (((UINTN)dev) << 16) + (((UINTN)func) << 8) + ((UINTN)reg)))& 0x00000000ffffffff
+
+#define HARDWARE_LOOPBACK       1
+#define SOFTWARE_LOOPBACK       2
+
+#ifdef UART_INPUT_CLOCK
+UINTN   SioUartInputClock = UART_INPUT_CLOCK;
+#else
+//
+// Set the default value((24000000/13)MHz input clock) if the UART_INPUT_CLOCK SDL token is not present.
+//
+UINTN   SioUartInputClock=1843200;
+#endif
+
+UINTN   PciUartInputClock = PCI_UART_INPUT_CLOCK;
+
+//for serial io defaults
+UINT32 UartDefaultBaudRate              = UART_DEFAULT_BAUD_RATE;
+EFI_PARITY_TYPE UartDefaultParity       = UART_DEFAULT_PARITY;
+UINT8 UartDefaultDataBits               = UART_DEFAULT_DATA_BITS;
+EFI_STOP_BITS_TYPE UartDefaultStopBits  = UART_DEFAULT_STOP_BITS;
+UINT8 SerialIo_PciSerialSupport         = SERIALIO_PCI_SERIAL_SUPPORT;
+BOOLEAN ValidateNvram                   = FALSE;
+
+UINT32 TimeoutForDeterminingLoneEscChar = 
+                                    TIMEOUT_FOR_DETERMINING_LONE_ESC_CHAR;
+
+UINT32 EscSequenceCheckingIntervel = 
+                                    (TIMEOUT_FOR_DETERMINING_LONE_ESC_CHAR/NUMBER_OF_TIME_FOR_ESC_SEQUENCE_CHECKING);
+
+CHAR16 RefreshScreenKey     = REFRESH_SCREEN_KEY;
+UINT8 SPCR_OEM_ID[6]     = CONVERT_TO_STRING(SPCR_ACPI_OEM_ID);		
+UINT8 SPCR_OEM_TBL_ID[8] = CONVERT_TO_STRING(SPCR_ACPI_OEM_TBL_ID);	
+UINT32 gTotalSioSerialPorts = TOTAL_SIO_SERIAL_PORTS;
+UINT32 gTotalPciSerialPorts = TOTAL_PCI_SERIAL_PORTS;
+UINTN  TotalTerminalDev=TOTAL_SERIAL_PORTS; 
+UINT32 Uart_Fifo_Size=UART_FIFO_SIZE;
+UINT8  PciComMmioWidth=PCI_SERIAL_MMIO_WIDTH;
+UINT8  MaxFailuresAllowed = MAX_FAILURES_ALLOWED;
+UINT32 MaximumSerialWriteErrorCount = MAXIMUM_SERIAL_WRITE_ERROR_COUNT; 
+BOOLEAN SerialWriteErrorCheck= SERIAL_WRITE_ERROR_CHECK;
+BOOLEAN ClearTerminalKBBufferReadyToBoot= CLEAR_TERMINAL_KB_BUFFER_AT_READYTOBOOT;
+BOOLEAN ASCIIControlCodeSupport= ASCII_CONTROL_CODE_SUPPORT;
+BOOLEAN SerialMouseDetection=SERIAL_MOUSE_DETECTION;
+
+
+EFI_GUID gTerminalVarGuid   = TERMINAL_VAR_GUID;
+EFI_GUID gSetupGuid         = SETUP_GUID; 
+EFI_GUID gDebuggerTerminalVarGuid   = DEBUGGER_TERMINAL_VAR_GUID;
+EFI_GUID  gEfiPciRootBridgeIoProtocolGuid = EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL_GUID;
+
+UINT64 gAcpiSpcrTableComBaudRates[8] = 
+                                {0, 0, 0, 9600, 19200, 38400, 57600, 115200};
+
+CHAR16 *gPciSerialPortsDevicePathVarName[MAX_PCI_SERIAL_PORTS];
+
+SETUP_DATA gSetupData;
+
+//Terminal Driver global variables for SDL tokens.
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    Dont_Send_Ascii_Control_Printable_Characters
+//
+// Description:	Variable to replace DONT_SEND_ASCII_CONTROL_PRINTABLE_CHARACTERS.
+//              token.
+// Notes: BOOLEAN
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END>
+BOOLEAN  Dont_Send_Ascii_Control_Printable_Characters =
+#ifdef DONT_SEND_ASCII_CONTROL_PRINTABLE_CHARACTERS
+    DONT_SEND_ASCII_CONTROL_PRINTABLE_CHARACTERS
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    SpcrInterfaceType
+//
+// Description:	Variable to replace spcr_interface_type token.
+//
+// Notes: UINT8
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END>
+UINT8 SpcrInterfaceType = 
+#ifdef spcr_interface_type
+    spcr_interface_type
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    SpcrAddrSpcId
+//
+// Description:	Variable to replace spcr_addr_spc_id token.
+//
+// Notes: UINT8
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END>
+UINT8 SpcrAddrSpcId = 
+#ifdef spcr_addr_spc_id
+    spcr_addr_spc_id
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    SpcrAddrBitWidth
+//
+// Description:	Variable to replace spcr_addr_bit_width token.
+//
+// Notes: UINT8
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END> 
+UINT8 SpcrAddrBitWidth = 
+#ifdef spcr_addr_bit_width
+    spcr_addr_bit_width
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    SpcrAddrBitOffset
+//
+// Description:	Variable to replace spcr_addr_bit_offset token.
+//
+// Notes: UINT8
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END> 
+UINT8 SpcrAddrBitOffset = 
+#ifdef spcr_addr_bit_offset
+    spcr_addr_bit_offset
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    SpcrAccessSize
+//
+// Description:	Variable to replace spcr_access_size token.
+//
+// Notes: UINT8
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END> 
+UINT8 SpcrAccessSize = 
+#ifdef spcr_access_size
+    spcr_access_size
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    SpcrInterruptType
+//
+// Description:	Variable to replace spcr_interrupt_type token.
+//
+// Notes: UINT8
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END> 
+UINT8 SpcrInterruptType = 
+#ifdef spcr_interrupt_type
+    spcr_interrupt_type
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    SpcrGlobalSystemInit
+//
+// Description:	Variable to replace spcr_global_system_int token.
+//
+// Notes: UINT8
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END> 
+UINT8 SpcrGlobalSystemInit = 
+#ifdef spcr_global_system_int
+    spcr_global_system_int
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    SpcrParity
+//
+// Description:	Variable to replace spcr_parity token.
+//
+// Notes: UINT8
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END> 
+UINT8 SpcrParity = 
+#ifdef spcr_parity
+    spcr_parity
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    SpcrStopBits
+//
+// Description:	Variable to replace spcr_stop_bits token.
+//
+// Notes: UINT8
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END> 
+UINT8 SpcrStopBits = 
+#ifdef spcr_stop_bits
+    spcr_stop_bits
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    SpcrPciDeviceId
+//
+// Description:	Variable to replace spcr_pci_device_id token.
+//
+// Notes: UINT16
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END> 
+UINT16 SpcrPciDeviceId = 
+#ifdef spcr_pci_device_id
+    spcr_pci_device_id
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    SpcrPciVendorId
+//
+// Description:	Variable to replace spcr_pci_vendor_id token.
+//
+// Notes: UINT16
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END> 
+UINT16 SpcrPciVendorId = 
+#ifdef spcr_pci_vendor_id
+    spcr_pci_vendor_id
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    SpcrPciBusNumber
+//
+// Description:	Variable to replace spcr_pci_bus_number token.
+//
+// Notes: UINT8
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END> 
+UINT8 SpcrPciBusNumber = 
+#ifdef spcr_pci_bus_number
+    spcr_pci_bus_number
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    SpcrPciDeviceNumber
+//
+// Description:	Variable to replace spcr_interface_type token.
+//
+// Notes: UINT8
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END> 
+UINT8 SpcrPciDeviceNumber = 
+#ifdef spcr_pci_device_number
+    spcr_pci_device_number
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    SpcrPciFunctionNumber
+//
+// Description:	Variable to replace spcr_pci_function_number token.
+//
+// Notes: UINT8
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END> 
+UINT8 SpcrPciFunctionNumber = 
+#ifdef spcr_pci_function_number
+    spcr_pci_function_number
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    SpcrPciFlags
+//
+// Description:	Variable to replace spcr_pci_flags token.
+//
+// Notes: UINT8
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END> 
+UINT8 SpcrPciFlags = 
+#ifdef spcr_pci_flags
+    spcr_pci_flags
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    SpcrPciSegment
+//
+// Description:	Variable to replace spcr_pci_segment token.
+//
+// Notes: UINT8
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END>  
+UINT8 SpcrPciSegment = 
+#ifdef spcr_pci_segment
+    spcr_pci_segment
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    AcpiOemRev
+//
+// Description:	Variable to replace ACPI_OEM_REV token.
+//
+// Notes: UINT64
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END>  
+UINT64 AcpiOemRev = 
+#ifdef ACPI_OEM_REV
+    ACPI_OEM_REV
+#else
+    0
+#endif
+    ;
+
+//<AMI_SHDR_START>
+//----------------------------------------------------------------------------
+// Name:    CoreRevision
+//
+// Description:	Variable to replace CORE_REVISION token.
+//
+// Notes: UINT64
+//
+//----------------------------------------------------------------------------
+//<AMI_SHDR_END>  
+UINT8 CoreRevision = 
+#ifdef CORE_REVISION
+    CORE_REVISION
+#else
+    0
+#endif
+    ;
+
+//**********************************************************************
+//<AMI_PHDR_START>
+//
+// Procedure: InitSerialPortsEnabledVar
+//
+// Input: VOID
+//
+// Output: VOID
+//
+// Description: Initializes the variables SERIAL_PORTS_ENABLED_VAR and 
+//              PCI_SERIAL_PORTS_LOCATION_VAR.  
+//              SERIAL_PORTS_ENABLED_VAR keeps track of which serial ports
+//              (both SuperIO and PCI) are enabled. 
+//              PCI_SERIAL_PORTS_LOCATION_VAR keeps contains location 
+//              information about the pci serial ports (device and function 
+//              numbers).  
+//                          
+//<AMI_PHDR_END>
+//**********************************************************************  
+VOID InitSerialPortsEnabledVar(VOID)
+{
+    UINTN DebuggerSerialPortsEnabledVarSize = sizeof(DEBUGGER_SERIAL_PORTS_ENABLED_VAR); 
+    DEBUGGER_SERIAL_PORTS_ENABLED_VAR DebuggerSerialPortsEnabledVar; 
+    EFI_STATUS Status = EFI_SUCCESS;
+
+#if (TOTAL_SERIAL_PORTS > 0)
+
+    UINTN SerialPortsEnabledVarSize = sizeof(SERIAL_PORTS_ENABLED_VAR); 
+    SERIAL_PORTS_ENABLED_VAR SerialPortsEnabledVar; 
+
+#if (TOTAL_PCI_SERIAL_PORTS > 0)
+    UINTN PciSerialPortsLocationVarSize = 
+                                    sizeof(PCI_SERIAL_PORTS_LOCATION_VAR);
+    PCI_SERIAL_PORTS_LOCATION_VAR PciSerialPortsLocationVar; 
+#endif
+#if (TOTAL_SIO_SERIAL_PORTS > 0)
+    UINTN SioSerialPortsLocationVarSize = 
+                                    sizeof(SIO_SERIAL_PORTS_LOCATION_VAR);
+    SIO_SERIAL_PORTS_LOCATION_VAR SioSerialPortsLocationVar; 
+#endif
+
+    pBS->SetMem(&SerialPortsEnabledVar, 
+                sizeof(SERIAL_PORTS_ENABLED_VAR), 
+                0);
+    Status = pRS->SetVariable(SERIAL_PORTS_ENABLED_VAR_C_NAME, 
+                                &gTerminalVarGuid, 
+                                EFI_VARIABLE_BOOTSERVICE_ACCESS,
+                                SerialPortsEnabledVarSize,
+                                &SerialPortsEnabledVar); 
+    ASSERT_EFI_ERROR(Status);
+
+#if (TOTAL_SIO_SERIAL_PORTS > 0)
+    Status = pRS->GetVariable(SIO_SERIAL_PORTS_LOCATION_VAR_C_NAME, 
+                                &gTerminalVarGuid, 
+                                NULL, 
+                                &SioSerialPortsLocationVarSize, 
+                                &SioSerialPortsLocationVar);
+    if (EFI_ERROR(Status)) {
+        pBS->SetMem(&SioSerialPortsLocationVar, 
+                    sizeof(SIO_SERIAL_PORTS_LOCATION_VAR), 
+                    0);
+        Status = pRS->SetVariable(SIO_SERIAL_PORTS_LOCATION_VAR_C_NAME, 
+                                    &gTerminalVarGuid, 
+                                    (EFI_VARIABLE_BOOTSERVICE_ACCESS | 
+                                            EFI_VARIABLE_NON_VOLATILE),
+                                    SioSerialPortsLocationVarSize, 
+                                    &SioSerialPortsLocationVar); 
+        ASSERT_EFI_ERROR(Status);
+    }
+#endif
+
+
+#if (TOTAL_PCI_SERIAL_PORTS > 0)
+    Status = pRS->GetVariable(PCI_SERIAL_PORTS_LOCATION_VAR_C_NAME, 
+                                &gTerminalVarGuid, 
+                                NULL, 
+                                &PciSerialPortsLocationVarSize, 
+                                &PciSerialPortsLocationVar);
+    if (EFI_ERROR(Status)) {
+        pBS->SetMem(&PciSerialPortsLocationVar, 
+                    sizeof(PCI_SERIAL_PORTS_LOCATION_VAR), 
+                    0);
+        Status = pRS->SetVariable(PCI_SERIAL_PORTS_LOCATION_VAR_C_NAME, 
+                                    &gTerminalVarGuid, 
+                                    (EFI_VARIABLE_BOOTSERVICE_ACCESS | 
+                                            EFI_VARIABLE_NON_VOLATILE),
+                                    PciSerialPortsLocationVarSize, 
+                                    &PciSerialPortsLocationVar); 
+        ASSERT_EFI_ERROR(Status);
+    }
+#endif
+
+#endif
+    //
+    // Initilize the Amidebugger Serial Port variables.
+    //
+    pBS->SetMem(&DebuggerSerialPortsEnabledVar, 
+                sizeof(DEBUGGER_SERIAL_PORTS_ENABLED_VAR), 
+                0);
+    Status = pRS->SetVariable(DEBUGGER_SERIAL_PORTS_ENABLED_VAR_C_NAME, 
+                                &gDebuggerTerminalVarGuid, 
+                                EFI_VARIABLE_BOOTSERVICE_ACCESS,
+                                DebuggerSerialPortsEnabledVarSize,
+                                &DebuggerSerialPortsEnabledVar); 
+}
+
+//**********************************************************************
+//<AMI_PHDR_START>
+//
+// Procedure: SetSerialPortsEnabledVar_Sio
+//
+// Input: IN UINT8 Port
+//
+// Output: VOID
+//
+// Description: Sets SERIAL_PORTS_ENABLED_VAR[Port] to 1.
+//
+//<AMI_PHDR_END>
+//**********************************************************************  
+UINT8 SetSerialPortsEnabledVar_Sio(IN UINT8 Uid)
+{
+    UINTN DebuggerSerialPortsEnabledVarSize = sizeof(DEBUGGER_SERIAL_PORTS_ENABLED_VAR);
+    UINT32 DebuggerSerialPortsEnabledVarAttributes=0;
+    DEBUGGER_SERIAL_PORTS_ENABLED_VAR DebuggerSerialPortsEnabledVar;
+    EFI_STATUS Status = EFI_SUCCESS;	
+
+    if(Uid == 0xFF) {
+
+        //
+        // Handle the Serial Port that is coming from Ami debugger
+        //
+        Status = pRS->GetVariable(DEBUGGER_SERIAL_PORTS_ENABLED_VAR_C_NAME, 
+                                &gDebuggerTerminalVarGuid, 
+                                &DebuggerSerialPortsEnabledVarAttributes, 
+                                &DebuggerSerialPortsEnabledVarSize, 
+                                &DebuggerSerialPortsEnabledVar);
+	ASSERT_EFI_ERROR(Status);
+
+        //
+        // Port Present Status.
+        //
+        DebuggerSerialPortsEnabledVar.PortEnabled=1;
+
+        Status = pRS->SetVariable(DEBUGGER_SERIAL_PORTS_ENABLED_VAR_C_NAME, 
+                                &gDebuggerTerminalVarGuid, 
+                                EFI_VARIABLE_BOOTSERVICE_ACCESS,
+                                DebuggerSerialPortsEnabledVarSize,
+                                &DebuggerSerialPortsEnabledVar);
+	ASSERT_EFI_ERROR(Status);
+        //
+        // Return 0xFF, so that it's known as this serial port is coming 
+        // from AmiDebugger
+        //
+        return 0xFF; 
+    }
+
+#if (TOTAL_SIO_SERIAL_PORTS > 0)
+{
+
+    UINTN SerialPortsEnabledVarSize = sizeof(SERIAL_PORTS_ENABLED_VAR);
+    UINT32 SerialPortsEnabledVarAttributes=0;
+    SERIAL_PORTS_ENABLED_VAR SerialPortsEnabledVar;
+
+    UINTN SioSerialPortsLocationVarSize = 
+                                    sizeof(SIO_SERIAL_PORTS_LOCATION_VAR);
+    UINT32 SioSerialPortsLocationVarAttributes=0;
+    SIO_SERIAL_PORTS_LOCATION_VAR SioSerialPortsLocationVar; 
+    EFI_STATUS Status = EFI_SUCCESS;	
+    UINT32 i = 0;
+    UINT8 ComPort = 0xFF; 
+
+    Status = pRS->GetVariable(SERIAL_PORTS_ENABLED_VAR_C_NAME, 
+                                &gTerminalVarGuid, 
+                                &SerialPortsEnabledVarAttributes, 
+                                &SerialPortsEnabledVarSize, 
+                                &SerialPortsEnabledVar);
+    ASSERT_EFI_ERROR(Status);
+
+    if(EFI_ERROR(Status)) {
+        return 0xFF;
+    }
+
+    Status = pRS->GetVariable(SIO_SERIAL_PORTS_LOCATION_VAR_C_NAME, 
+                                &gTerminalVarGuid, 
+                                &SioSerialPortsLocationVarAttributes, 
+                                &SioSerialPortsLocationVarSize, 
+                                &SioSerialPortsLocationVar);
+    ASSERT_EFI_ERROR(Status);
+
+    if(EFI_ERROR(Status)) {
+        return 0xFF;
+    }
+
+    for (i = 0; i < TOTAL_SIO_SERIAL_PORTS; i++) {
+        if ((SioSerialPortsLocationVar.PortUid[i] == Uid ) && 
+            (SioSerialPortsLocationVar.Valid[i] == 0xFF)) {
+            SerialPortsEnabledVar.PortsEnabled[i] = 1;
+            ComPort = i; 
+            break;            
+        }
+    }
+
+    if (i == TOTAL_SIO_SERIAL_PORTS) {
+        for (i = 0; i < TOTAL_SIO_SERIAL_PORTS; i++) {
+            if ((!SerialPortsEnabledVar.PortsEnabled[i]) &&
+                (SioSerialPortsLocationVar.Valid[i] == 0)) {
+                
+                SerialPortsEnabledVar.PortsEnabled[i] = 1;
+                ComPort = i; 
+               
+                SioSerialPortsLocationVar.PortUid[i] = Uid;
+                SioSerialPortsLocationVar.Valid[i] = 0xFF;
+
+                Status = pRS->SetVariable(
+                                    SIO_SERIAL_PORTS_LOCATION_VAR_C_NAME,
+                                    &gTerminalVarGuid, 
+                                    (EFI_VARIABLE_BOOTSERVICE_ACCESS |
+                                            EFI_VARIABLE_NON_VOLATILE),
+                                    SioSerialPortsLocationVarSize, 
+                                    &SioSerialPortsLocationVar); 
+
+                ASSERT_EFI_ERROR(Status);
+                break;
+            }
+        }
+    }
+
+    Status = pRS->SetVariable(SERIAL_PORTS_ENABLED_VAR_C_NAME, 
+                                &gTerminalVarGuid, 
+                                EFI_VARIABLE_BOOTSERVICE_ACCESS,
+                                SerialPortsEnabledVarSize,
+                                &SerialPortsEnabledVar); 
+    ASSERT_EFI_ERROR(Status);
+
+    return ComPort; 
+}
+#else 
+
+    return 0xFF;
+
+#endif
+}
+
+#if (TOTAL_PCI_SERIAL_PORTS > 0)
+//**********************************************************************
+//<AMI_PHDR_START>
+//
+// Procedure: ValidatePciSerialNvram
+//
+// Input:  IN SERIAL_PORTS_ENABLED_VAR SerialPortsEnabledVar,
+//         IN EFI_DEVICE_PATH_PROTOCOL *DevicePath
+//
+// Output: EFI_STATUS
+//
+// Description: Checks for the Presence of PCI Serial device with values
+//              present in the NVRAM Variable PciSerialPortsLocationVar.
+//              If found donot change NVRAM variable.If not found delete
+//              the NVRAM variable describing the device path  and make 
+//              current PciSerialPortsLocationVar.Bus[i],Device[i] and
+//              function[i] to zero.
+//
+//<AMI_PHDR_END>
+//********************************************************************** 
+EFI_STATUS ValidatePciSerialNvram(
+    IN SERIAL_PORTS_ENABLED_VAR SerialPortsEnabledVar,
+	IN EFI_DEVICE_PATH_PROTOCOL *DevicePath)
+{
+    UINT64      PciAddress;
+    UINT8       RevisionId[4];
+    UINT8       SetNvramVariable=0;
+    UINT8       i = 0;
+    EFI_STATUS  Status;
+
+    UINTN PciSerialPortsLocationVarSize = sizeof(PCI_SERIAL_PORTS_LOCATION_VAR);
+    UINT32 PciSerialPortsLocationVarAttributes=0;
+    PCI_SERIAL_PORTS_LOCATION_VAR PciSerialPortsLocationVar;
+    
+	UINTN PciSerialPortDevicePathVarSize = 0;
+    UINT32 PciSerialPortDevicePathVarAttributes = 0;
+    EFI_DEVICE_PATH_PROTOCOL *PciSerialPortDevicePathVar = NULL;
+
+    EFI_PCI_ROOT_BRIDGE_IO_PROTOCOL	*gPciRootBridgeIo=NULL;
+
+    if (ValidateNvram == TRUE) {
+        return EFI_SUCCESS;
+    }           
+
+    Status = pBS->LocateProtocol( &gEfiPciRootBridgeIoProtocolGuid,
+                                  NULL,
+                                  &gPciRootBridgeIo );
+
+    ASSERT_EFI_ERROR(Status);
+    if (EFI_ERROR(Status)) { 
+        return Status;
+    }
+
+    ValidateNvram = TRUE;
+    Status = pRS->GetVariable(PCI_SERIAL_PORTS_LOCATION_VAR_C_NAME,
+                              &gTerminalVarGuid, 
+                              &PciSerialPortsLocationVarAttributes,
+                              &PciSerialPortsLocationVarSize, 
+                              &PciSerialPortsLocationVar );
+    if(EFI_ERROR(Status)) {
+        return Status;
+    }
+
+    ASSERT_EFI_ERROR(Status);
+
+    for (i = 0; i < TOTAL_PCI_SERIAL_PORTS; i++) {
+        if (!SerialPortsEnabledVar.PortsEnabled[gTotalSioSerialPorts+i]) {
+            if ((PciSerialPortsLocationVar.Bus[i] == 0) &&
+                (PciSerialPortsLocationVar.Device[i] == 0) &&
+                (PciSerialPortsLocationVar.Function[i] == 0)) {
+                continue;
+            }
+
+            PciAddress = PCI_CFG_ADDRESS (PciSerialPortsLocationVar.Bus[i],
+                                          PciSerialPortsLocationVar.Device[i],
+                                          PciSerialPortsLocationVar.Function[i],
+                                          PCI_REV_ID_OFFSET
+                                          );
+            //
+            //Get the Class Code
+            //
+            Status = gPciRootBridgeIo->Pci.Read(
+                                        gPciRootBridgeIo,
+                                        EfiPciWidthUint32,
+                                        PciAddress,
+                                        1,
+                                        &RevisionId);
+            ASSERT_EFI_ERROR(Status);
+
+            Status = GetEfiVariable(gPciSerialPortsDevicePathVarName[i],
+                                    &gTerminalVarGuid, 
+                                    &PciSerialPortDevicePathVarAttributes, 
+                                    &PciSerialPortDevicePathVarSize, 
+                                    &PciSerialPortDevicePathVar);
+            if (EFI_ERROR(Status)) { 
+                return Status;
+            }
+
+            //
+            //Check for the presence of the PCI Serial device
+            //
+            if ((RevisionId[3] == PCI_CL_COMM) &&
+                ((RevisionId[2] == PCI_CL_COMM_CSL_SERIAL) ||
+                (RevisionId[2] == PCI_CL_COMM_CSL_OTHER)) ) {
+                continue;
+            }
+
+            //
+            //Its not PCI serial Device,So delete NVRAM variable describing device path of the device.
+            //
+            SetNvramVariable = 1;
+            Status = pRS->SetVariable(gPciSerialPortsDevicePathVarName[i],
+                                      &gTerminalVarGuid,
+                                      (EFI_VARIABLE_BOOTSERVICE_ACCESS |
+                                      EFI_VARIABLE_NON_VOLATILE), 
+                                      NULL,
+                                      NULL);
+            ASSERT_EFI_ERROR(Status);
+            //
+            //Initialise Bus,Dev,func. to Zero and set variable to represent that device is not present.
+            //
+            PciSerialPortsLocationVar.Bus[i] = 0;
+            PciSerialPortsLocationVar.Device[i] = 0;
+            PciSerialPortsLocationVar.Function[i] = 0;
+        }
+    }
+    if (SetNvramVariable == 1) {
+        Status = pRS->SetVariable(PCI_SERIAL_PORTS_LOCATION_VAR_C_NAME,
+                                  &gTerminalVarGuid, 
+                                  (EFI_VARIABLE_BOOTSERVICE_ACCESS |
+                                      EFI_VARIABLE_NON_VOLATILE), 
+                                  PciSerialPortsLocationVarSize, 
+                                  &PciSerialPortsLocationVar);
+        ASSERT_EFI_ERROR(Status);
+    }
+    return EFI_SUCCESS;
+}
+#endif
+
+//**********************************************************************
+//<AMI_PHDR_START>
+//
+// Procedure: SetSerialPortsEnabledVar_Pci
+//
+// Input: 
+//      IN EFI_DEVICE_PATH_PROTOCOL *DevicePath
+//      IN UINT8 Device
+//      IN UINT8 Function
+//
+// Output: the assigned com port number
+//      UINT8 
+//
+// Description: Keeping track of which pci serial ports are enabled 
+//              a bit complicated.
+//              Unlike the SuperIO serial ports, pci serial ports do not 
+//              have UIDs.  
+//              We distinguish them by their locations.  
+//              For each pci serial port, we store the entire device 
+//              path under the variable names in 
+//              gPciSerialPortsDevicePathVarName ("COM5," "COM6", etc).
+//              We check the parameter "DevicePath" against our stored 
+//              device paths.
+//              If it matches, we return the com port number of that 
+//              device path.
+//              If it doesn't match, we use a new entry in 
+//              SERIAL_PORTS_ENABLED_VAR for the pci serial port.  
+//              We also use a new entry in PCI_SERIAL_PORTS_LOCATION_VAR 
+//              and store the device and function numbers. 
+//
+//<AMI_PHDR_END>
+//**********************************************************************  
+UINT8 SetSerialPortsEnabledVar_Pci(
+    IN EFI_DEVICE_PATH_PROTOCOL *DevicePath,
+    IN UINT8 Bus,
+    IN UINT8 Device, 
+    IN UINT8 Function,
+    IN UINT8 Port,
+    IN BOOLEAN AmiPciSerialDetected)
+{
+#if (TOTAL_PCI_SERIAL_PORTS > 0)
+    UINTN SerialPortsEnabledVarSize = sizeof(SERIAL_PORTS_ENABLED_VAR); 
+    UINT32 SerialPortsEnabledVarAttributes=0;
+    SERIAL_PORTS_ENABLED_VAR SerialPortsEnabledVar; 
+
+    UINTN PciSerialPortsLocationVarSize = 
+                                    sizeof(PCI_SERIAL_PORTS_LOCATION_VAR);
+    UINT32 PciSerialPortsLocationVarAttributes=0;
+    PCI_SERIAL_PORTS_LOCATION_VAR PciSerialPortsLocationVar; 
+
+    UINTN PciSerialPortDevicePathVarSize = 0;
+    UINT32 PciSerialPortDevicePathVarAttributes = 0;
+    EFI_DEVICE_PATH_PROTOCOL *PciSerialPortDevicePathVar = NULL; 
+
+    EFI_STATUS Status = EFI_SUCCESS;	
+    UINT32 i = 0;
+    UINT8 ComPort=0xFF; 
+    CHAR16 PciSerialPortName[TOTAL_PCI_SERIAL_PORTS][6];
+
+    for ( i = 0; i < TOTAL_PCI_SERIAL_PORTS; i++) {
+        Swprintf(PciSerialPortName[i], L"COM%x", gTotalSioSerialPorts+i);
+        gPciSerialPortsDevicePathVarName[i] = PciSerialPortName[i];
+    }
+
+    Status = pRS->GetVariable(SERIAL_PORTS_ENABLED_VAR_C_NAME, 
+                                &gTerminalVarGuid,
+                                &SerialPortsEnabledVarAttributes, 
+                                &SerialPortsEnabledVarSize, 
+                                &SerialPortsEnabledVar);
+    ASSERT_EFI_ERROR(Status);
+
+    if(EFI_ERROR(Status)) {
+        return 0xFF;
+    }
+
+	Status = ValidatePciSerialNvram(SerialPortsEnabledVar,DevicePath);
+
+    if (EFI_ERROR(Status)) {
+        return 0xFF;
+    }
+
+    Status = pRS->GetVariable(PCI_SERIAL_PORTS_LOCATION_VAR_C_NAME, 
+                                &gTerminalVarGuid, 
+                                &PciSerialPortsLocationVarAttributes, 
+                                &PciSerialPortsLocationVarSize, 
+                                &PciSerialPortsLocationVar);
+    ASSERT_EFI_ERROR(Status);
+
+    if(EFI_ERROR(Status)) {
+        return 0xFF;
+    }
+
+    for (i = 0; i < TOTAL_PCI_SERIAL_PORTS; i++) {
+        if ((PciSerialPortsLocationVar.Device[i] == Device) && 
+            (PciSerialPortsLocationVar.Function[i] == Function)) {
+            Status = GetEfiVariable(gPciSerialPortsDevicePathVarName[i],
+                                    &gTerminalVarGuid, 
+                                    &PciSerialPortDevicePathVarAttributes, 
+                                    &PciSerialPortDevicePathVarSize, 
+                                    &PciSerialPortDevicePathVar);
+            if (!EFI_ERROR(Status)) {
+                if (!DPCmp(DevicePath, PciSerialPortDevicePathVar)) {
+                    SerialPortsEnabledVar.PortsEnabled[gTotalSioSerialPorts+i] = 1;
+                    ComPort = gTotalSioSerialPorts+i; 
+                    break;            
+                }
+            }
+        }
+    }
+
+    if (i == TOTAL_PCI_SERIAL_PORTS) {
+        for (i = 0; i < TOTAL_PCI_SERIAL_PORTS; i++) {
+            if ((!SerialPortsEnabledVar.PortsEnabled[gTotalSioSerialPorts+i]) &&
+                (PciSerialPortsLocationVar.Device[i] == 0) &&
+                (PciSerialPortsLocationVar.Function[i] == 0)) {
+                Status = GetEfiVariable(
+                                    gPciSerialPortsDevicePathVarName[i],
+                                    &gTerminalVarGuid, 
+                                    &PciSerialPortDevicePathVarAttributes,
+                                    &PciSerialPortDevicePathVarSize, 
+                                    &PciSerialPortDevicePathVar);
+                if (Status == EFI_NOT_FOUND) {
+                    SerialPortsEnabledVar.PortsEnabled[gTotalSioSerialPorts+i] = 1;
+                    ComPort = gTotalSioSerialPorts+i; 
+               
+                    PciSerialPortDevicePathVarSize = DPLength(DevicePath);
+                    Status = pRS->SetVariable(
+                                        gPciSerialPortsDevicePathVarName[i],
+                                        &gTerminalVarGuid,
+                                        (EFI_VARIABLE_BOOTSERVICE_ACCESS |
+                                            EFI_VARIABLE_NON_VOLATILE), 
+                                        PciSerialPortDevicePathVarSize, 
+                                        DevicePath);
+                    ASSERT_EFI_ERROR(Status);
+
+      			    PciSerialPortsLocationVar.Bus[i] = Bus;              
+				    PciSerialPortsLocationVar.Device[i] = Device;
+                    PciSerialPortsLocationVar.Function[i] = Function;
+                    if(AmiPciSerialDetected) {
+                        PciSerialPortsLocationVar.AmiPciSerialPresent[i] = TRUE;
+                        PciSerialPortsLocationVar.Port[i] = Port;
+                    }
+
+                    Status = pRS->SetVariable(
+                                    PCI_SERIAL_PORTS_LOCATION_VAR_C_NAME,
+                                    &gTerminalVarGuid, 
+                                    (EFI_VARIABLE_BOOTSERVICE_ACCESS |
+                                            EFI_VARIABLE_NON_VOLATILE),
+                                    PciSerialPortsLocationVarSize, 
+                                    &PciSerialPortsLocationVar); 
+                    ASSERT_EFI_ERROR(Status);
+
+                    break;
+                }
+            }
+        }
+    }
+
+    Status = pRS->SetVariable(SERIAL_PORTS_ENABLED_VAR_C_NAME,
+                                &gTerminalVarGuid,
+                                EFI_VARIABLE_BOOTSERVICE_ACCESS,
+                                SerialPortsEnabledVarSize, 
+                                &SerialPortsEnabledVar); 
+    ASSERT_EFI_ERROR(Status);
+
+    return ComPort; 
+
+#else 
+
+    return 0xFF;
+
+#endif
+}
+
+//**********************************************************************
+//<AMI_PHDR_START>
+//
+// Procedure: GetSetupValuesForSerialIoMode
+//
+// Input: 
+//      IN UINT8 Port
+//      IN OUT SERIAL_IO_MODE *SerialIoMode
+//
+// Output: VOID
+//
+// Description: Returns the user configured SERIAL_IO_MODE values.
+//
+//<AMI_PHDR_END>
+//**********************************************************************  
+VOID GetSetupValuesForSerialIoMode(
+    IN UINT8 Port, 
+    IN OUT SERIAL_IO_MODE *SerialIoMode)
+{
+    UINT32 SetupDataAttributes = 0;
+    UINTN SetupDataVarSize = sizeof(SETUP_DATA); 
+
+    UINT8 LoopbackEnable = 0;
+    UINT8 FlowControl = 0;
+    EFI_STATUS Status = EFI_SUCCESS;
+
+#if (TOTAL_SERIAL_PORTS == 0)
+
+    LoopbackEnable          = UART_DEFAULT_LOOPBACK_ENABLE;
+    FlowControl             = UART_DEFAULT_FLOW_CONTROL;
+    SerialIoMode->BaudRate  = 
+                gAcpiSpcrTableComBaudRates[UART_DEFAULT_BAUD_RATE_INDEX];
+    SerialIoMode->Parity    = UART_DEFAULT_PARITY;
+    SerialIoMode->DataBits  = UART_DEFAULT_DATA_BITS;
+    SerialIoMode->StopBits  = UART_DEFAULT_STOP_BITS;
+
+#else
+
+    Status = pRS->GetVariable(L"Setup", &gSetupGuid, &SetupDataAttributes,
+                                &SetupDataVarSize, &gSetupData);
+
+    if (EFI_ERROR(Status)) {
+        LoopbackEnable          = UART_DEFAULT_LOOPBACK_ENABLE;
+        FlowControl             = UART_DEFAULT_FLOW_CONTROL;
+        SerialIoMode->BaudRate  = 
+                gAcpiSpcrTableComBaudRates[UART_DEFAULT_BAUD_RATE_INDEX];
+        SerialIoMode->Parity    = UART_DEFAULT_PARITY;
+        SerialIoMode->DataBits  = UART_DEFAULT_DATA_BITS;
+        SerialIoMode->StopBits  = UART_DEFAULT_STOP_BITS;
+    } else {
+        LoopbackEnable          = gSetupData.LoopbackEnable[Port];
+        FlowControl             = gSetupData.FlowControl[Port];
+        SerialIoMode->BaudRate  = 
+                    gAcpiSpcrTableComBaudRates[gSetupData.BaudRate[Port]];
+        SerialIoMode->Parity    = gSetupData.Parity[Port];
+        SerialIoMode->DataBits  = gSetupData.DataBits[Port];
+        SerialIoMode->StopBits  = gSetupData.StopBits[Port];
+    }
+
+#endif
+
+    SerialIoMode->ControlMask = 0;
+    if (FlowControl == HARDWARE_FLOW_CONTROL_SETUP_OPTION) 
+        SerialIoMode->ControlMask |= EFI_SERIAL_HARDWARE_FLOW_CONTROL_ENABLE;
+    else if (FlowControl == SOFTWARE_FLOW_CONTROL_SETUP_OPTION)
+        SerialIoMode->ControlMask |= EFI_SERIAL_SOFTWARE_FLOW_CONTROL_ENABLE;
+}
+
+//**********************************************************************
+//<AMI_PHDR_START>
+//
+// Procedure: GetDefaultConsoleRedirectionStatus
+//
+// Description: Returns the default settings of the ConsoleRedirection
+//              enable status 
+//
+// Input:  IN UINT8 Port
+//
+// Output: OUT UINT8 RedirectionStatus
+//
+//
+//<AMI_PHDR_END>
+//**********************************************************************  
+UINT8 GetDefaultConsoleRedirectionStatus(
+    IN UINT8 Port 
+)
+{
+    switch (Port) {
+#if (TOTAL_SIO_SERIAL_PORTS > 0)
+        case 0:
+                return COM0_DEFAULT_CONSOLE_REDIRECTION_ENABLE;
+#endif
+
+#if (TOTAL_SIO_SERIAL_PORTS > 1)
+        case 1:
+                return COM1_DEFAULT_CONSOLE_REDIRECTION_ENABLE;
+#endif
+
+#if (TOTAL_SIO_SERIAL_PORTS > 2)
+        case 2:
+                return COM2_DEFAULT_CONSOLE_REDIRECTION_ENABLE;
+#endif
+
+#if (TOTAL_SIO_SERIAL_PORTS > 3)
+        case 3:
+                return COM3_DEFAULT_CONSOLE_REDIRECTION_ENABLE;
+#endif
+
+#if (TOTAL_SIO_SERIAL_PORTS > 4)
+        case 4:
+                return COM4_DEFAULT_CONSOLE_REDIRECTION_ENABLE;
+#endif
+
+#if (TOTAL_SIO_SERIAL_PORTS > 5)
+        case 5:
+                return COM5_DEFAULT_CONSOLE_REDIRECTION_ENABLE;
+#endif
+
+#if (TOTAL_SIO_SERIAL_PORTS > 6)
+        case 6:
+                return COM6_DEFAULT_CONSOLE_REDIRECTION_ENABLE;
+#endif
+
+#if (TOTAL_SIO_SERIAL_PORTS > 7)
+        case 7:
+                return COM7_DEFAULT_CONSOLE_REDIRECTION_ENABLE;
+#endif
+
+#if (TOTAL_SIO_SERIAL_PORTS > 8)
+        case 8:
+                return COM8_DEFAULT_CONSOLE_REDIRECTION_ENABLE;
+#endif
+
+#if (TOTAL_SIO_SERIAL_PORTS > 9)
+        case 9:
+                return COM9_DEFAULT_CONSOLE_REDIRECTION_ENABLE;
+#endif
+
+#if (TOTAL_PCI_SERIAL_PORTS > 0)
+        case (TOTAL_SIO_SERIAL_PORTS):
+                return PCI0_DEFAULT_CONSOLE_REDIRECTION_ENABLE;
+#endif
+
+#if (TOTAL_PCI_SERIAL_PORTS > 1)
+        case (TOTAL_SIO_SERIAL_PORTS+1):
+                return PCI1_DEFAULT_CONSOLE_REDIRECTION_ENABLE;
+#endif
+
+#if (TOTAL_PCI_SERIAL_PORTS > 2)
+        case (TOTAL_SIO_SERIAL_PORTS+2):
+                return PCI2_DEFAULT_CONSOLE_REDIRECTION_ENABLE;
+#endif
+
+#if (TOTAL_PCI_SERIAL_PORTS > 3)
+        case (TOTAL_SIO_SERIAL_PORTS+3):
+                return PCI3_DEFAULT_CONSOLE_REDIRECTION_ENABLE;
+#endif
+
+    }
+
+    return 0;
+}
+
+//**********************************************************************
+//<AMI_PHDR_START>
+//
+// Procedure: GetSetupValuesForTerminal
+//
+// Input: 
+//      IN UINT8 Port
+//      IN OUT UINT8 *ConsoleRedirectionEnable
+//      IN OUT UINT8 *TerminalType
+//      IN OUT BOOLEAN *SupportExRes
+//      IN OUT BOOLEAN *RecorderMode, 
+//      IN OUT UINT8 *Disable_Terminal_For_SCT_Test
+//
+// Output: VOID
+//
+// Description: Returns the Setup setttings for the terminal 
+//              (whether redirection is enabled and the terminal type).
+//
+//<AMI_PHDR_END>
+//**********************************************************************  
+VOID GetSetupValuesForTerminal(
+    IN UINT8 Port, 
+    IN OUT UINT8 *ConsoleRedirectionEnable, 
+    IN OUT UINT8 *TerminalType,
+    IN OUT BOOLEAN *SupportExRes, 
+    IN OUT BOOLEAN *VtUtf8, 
+    IN OUT BOOLEAN *RecorderMode, 
+    IN OUT BOOLEAN *PuttyKeyPad,
+    IN OUT UINT8 *Disable_Terminal_For_SCT_Test)
+{
+    UINT32 SetupDataAttributes = 0;
+    UINTN SetupDataSize = sizeof(SETUP_DATA);     
+
+    EFI_STATUS Status ;
+
+    *Disable_Terminal_For_SCT_Test = DISABLE_TERMINAL_FOR_SCT_TEST;
+
+    Status = pRS->GetVariable(L"Setup", &gSetupGuid, &SetupDataAttributes,
+                                    &SetupDataSize, &gSetupData);
+    
+    if(Port == (UINT8)-1){
+        //
+        // If the redirection comes Via Ami debugger
+        //
+#ifdef CONSOLE_REDIRECTION_SUPPORT
+#if CONSOLE_REDIRECTION_SUPPORT == 1
+        if(EFI_ERROR(Status)) {
+            //
+            // If the Setup Variable is not Found Return the Default values
+            //
+            *ConsoleRedirectionEnable = DEFAULT_DEBUGGER_CONSOLE_REDIRECTION_ENABLE;
+            *TerminalType = DEFAULT_TERMINAL_TYPE;
+            *SupportExRes = FALSE;
+            *VtUtf8 = VTUTF8_ENABLE;
+            *RecorderMode = FALSE;
+            *PuttyKeyPad = PUTTY_VT100;
+        } else {
+            //
+            // Setup Values Found for the Debugger Serial port. 
+            //
+            *ConsoleRedirectionEnable=gSetupData.DebuggerConsoleRedirectionEnable;
+            *TerminalType = gSetupData.DebuggerTerminalType;
+            *SupportExRes = FALSE;
+            *VtUtf8 = VTUTF8_ENABLE;
+            *RecorderMode = FALSE;
+            *PuttyKeyPad = PUTTY_VT100;
+        }
+#else
+        //
+        // CONSOLE_REDIRECTION_SUPPORT token is defined in Amidebugger module. 
+        // But if this token is disabled, return the default values. 
+        //
+        *ConsoleRedirectionEnable = DEFAULT_DEBUGGER_CONSOLE_REDIRECTION_ENABLE;
+        *TerminalType = DEFAULT_TERMINAL_TYPE;
+        *SupportExRes = FALSE;
+        *VtUtf8 = VTUTF8_ENABLE;
+        *RecorderMode = FALSE;
+        *PuttyKeyPad = PUTTY_VT100;
+#endif
+#else 
+        //
+        // CONSOLE_REDIRECTION_SUPPORT token is defined in Amidebugger module. 
+        // If this token is not present, return the default values. 
+        //
+        *ConsoleRedirectionEnable = DEFAULT_DEBUGGER_CONSOLE_REDIRECTION_ENABLE;
+        *TerminalType = DEFAULT_TERMINAL_TYPE;
+        *SupportExRes = FALSE;
+        *VtUtf8 = VTUTF8_ENABLE;
+        *RecorderMode = FALSE;
+        *PuttyKeyPad = PUTTY_VT100;
+
+#endif
+
+        return;
+    } 
+
+#if (TOTAL_SERIAL_PORTS == 0)
+
+    *ConsoleRedirectionEnable = GetDefaultConsoleRedirectionStatus(Port);
+    *TerminalType = DEFAULT_TERMINAL_TYPE;
+    *SupportExRes = FALSE;
+    *VtUtf8 = VTUTF8_ENABLE;
+    *RecorderMode = FALSE;
+    *PuttyKeyPad = PUTTY_VT100;
+
+#else
+    if (EFI_ERROR(Status)) {
+        *ConsoleRedirectionEnable = GetDefaultConsoleRedirectionStatus(Port);
+        *TerminalType = DEFAULT_TERMINAL_TYPE;
+        *SupportExRes = FALSE;
+        *VtUtf8 = VTUTF8_ENABLE;
+        *RecorderMode = FALSE;
+        *PuttyKeyPad = PUTTY_VT100;
+    } else {
+        *ConsoleRedirectionEnable = 
+                                    gSetupData.ConsoleRedirectionEnable[Port];
+        *TerminalType = gSetupData.TerminalType[Port];
+        *SupportExRes = (gSetupData.Resolution[Port] == 0) ? FALSE : TRUE;
+        *VtUtf8 = (gSetupData.VtUtf8[Port] == 0) ? FALSE : TRUE;
+        *RecorderMode = (gSetupData.RecorderMode[Port] == 0) ? FALSE : TRUE;
+        *PuttyKeyPad = gSetupData.PuttyFunctionKeyPad[Port];
+    }
+#endif
+}
+
+//**********************************************************************
+//<AMI_PHDR_START>
+//
+// Procedure: GetAcpiSpcrTableValues
+//
+// Input: 
+//      IN OUT UINT8 *AcpiSpcrTableComPort
+//      IN OUT UINT8 *AcpiSpcrTableConsoleRedirectionEnable
+//      IN OUT UINT8 *AcpiSpcrTableTerminalType
+//      IN OUT UINT8 *AcpiSpcrTableBaudRate
+//      IN OUT UINT8 *AcpiSpcrTableFlowControl
+//
+// Output: VOID
+//
+// Description: Returns the configurable aspects of the acpi spcr table 
+//              com port (the com port number, whether the console 
+//              redirection is enabled, the terminal type, baude rate, 
+//              and flow control type used).  
+//
+//<AMI_PHDR_END>
+//**********************************************************************  
+VOID GetAcpiSpcrTableValues(
+    IN OUT UINT8 *AcpiSpcrTableComPort, 
+    IN OUT UINT8 *AcpiSpcrTableConsoleRedirectionEnable, 
+    IN OUT UINT8 *AcpiSpcrTableTerminalType, 
+    IN OUT UINT8 *AcpiSpcrTableBaudRate, 
+    IN OUT UINT8 *AcpiSpcrTableFlowControl)
+{
+    UINT32 SetupDataAttributes = 0;
+    UINTN SetupDataSize = sizeof(SETUP_DATA); 
+
+    EFI_STATUS Status = EFI_SUCCESS ;
+
+#if (TOTAL_SERIAL_PORTS == 0)
+
+    *AcpiSpcrTableComPort = DEFAULT_ACPI_SPCR_COM_PORT;
+    *AcpiSpcrTableConsoleRedirectionEnable = 
+                            DEFAULT_ACPI_SPCR_CONSOLE_REDIRECTION_ENABLE;
+    *AcpiSpcrTableTerminalType = DEFAULT_ACPI_SPCR_TABLE_TERMINAL_TYPE;
+    *AcpiSpcrTableBaudRate = UART_DEFAULT_BAUD_RATE_INDEX;
+    *AcpiSpcrTableFlowControl = UART_DEFAULT_FLOW_CONTROL;
+
+#else
+
+    Status = pRS->GetVariable(L"Setup", &gSetupGuid, &SetupDataAttributes,
+                                &SetupDataSize, &gSetupData);
+
+    if (EFI_ERROR(Status)) {
+        *AcpiSpcrTableComPort = DEFAULT_ACPI_SPCR_COM_PORT;
+        *AcpiSpcrTableConsoleRedirectionEnable = 
+                            DEFAULT_ACPI_SPCR_CONSOLE_REDIRECTION_ENABLE;
+        *AcpiSpcrTableTerminalType = DEFAULT_ACPI_SPCR_TABLE_TERMINAL_TYPE;
+        *AcpiSpcrTableBaudRate = UART_DEFAULT_BAUD_RATE_INDEX;
+        *AcpiSpcrTableFlowControl = UART_DEFAULT_FLOW_CONTROL;
+    } else {
+#if EFI_SPECIFICATION_VERSION<0x2000A
+        *AcpiSpcrTableComPort = gSetupData.AcpiSpcrPort-1;
+#else
+        *AcpiSpcrTableComPort = gSetupData.AcpiSpcrPort;
+#endif
+         
+        *AcpiSpcrTableConsoleRedirectionEnable = 
+                                gSetupData.AcpiSpcrConsoleRedirectionEnable;
+        *AcpiSpcrTableTerminalType = gSetupData.AcpiSpcrTerminalType;
+        *AcpiSpcrTableBaudRate = 
+                            gSetupData.AcpiSpcrBaudRate;
+        *AcpiSpcrTableFlowControl = 
+                            gSetupData.AcpiSpcrFlowControl;
+    }
+
+#endif
+}
+
+#include <Protocol\ComponentName.h>
+#ifndef EFI_COMPONENT_NAME2_PROTOCOL_GUID //old Core
+BOOLEAN LanguageCodesEqual(
+    CONST CHAR8* LangCode1, CONST CHAR8* LangCode2
+){
+    return    LangCode1[0]==LangCode2[0] 
+           && LangCode1[1]==LangCode2[1]
+           && LangCode1[2]==LangCode2[2];
+}
+#endif
+
+#ifndef LANGUAGE_CODE_ENGLISH
+CHAR8 SupportedLanguages[] = "eng";
+#else
+CHAR8 SupportedLanguages[] = LANGUAGE_CODE_ENGLISH;
+#endif
+
+//****************************************************************************
+//****************************************************************************
+//**                                                                        **
+//**             (C)Copyright 1985-20014, American Megatrends, Inc.          **
+//**                                                                        **
+//**                          All Rights Reserved.                          **
+//**                                                                        **
+//**             5555 Oakbrook Pkwy, Suite 200, Norcross, GA 30093          **
+//**                                                                        **
+//**                          Phone (770)-246-8600                          **
+//**                                                                        **
+//****************************************************************************
+//****************************************************************************