/** * @file * * AMD Integrated Debug Debug_library Routines * * Contains all functions related to HDTOUT * * @xrefitem bom "File Content Label" "Release Content" * @e project: AGESA * @e sub-project: IDS * @e \$Revision: 84150 $ @e \$Date: 2012-12-12 15:46:25 -0600 (Wed, 12 Dec 2012) $ */ /***************************************************************************** * Copyright (c) 2008 - 2013, Advanced Micro Devices, Inc. * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of Advanced Micro Devices, Inc. nor the names of * its contributors may be used to endorse or promote products derived * from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL ADVANCED MICRO DEVICES, INC. BE LIABLE FOR ANY * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ****************************************************************************** */ /*---------------------------------------------------------------------------------------- * M O D U L E S U S E D *---------------------------------------------------------------------------------------- */ #include "AGESA.h" #include "Ids.h" #include "IdsLib.h" #include "amdlib.h" #include "AMD.h" #include "IdsDebugPrint.h" #include "Filecode.h" CODE_GROUP (G1_PEICC) RDATA_GROUP (G1_PEICC) #define FILECODE PROC_IDS_DEBUG_IDSDPSERIAL_FILECODE /** * Determine whether IDS console is enabled. * * * @retval TRUE Alway return true * **/ STATIC BOOLEAN AmdIdsSerialSupport ( VOID ) { return TRUE; } /** * Get Serial customize Filter * * @param[in,out] Filter Filter do be filled * * @retval FALSE Alway return FALSE * **/ STATIC BOOLEAN AmdIdsSerialGetFilter ( IN OUT UINT64 *Filter ) { return FALSE; } #define IDS_SERIAL_PORT_LSR (IDS_SERIAL_PORT + 5) #define IDS_LSR_TRANSMIT_HOLDING_REGISTER_EMPTY_MASK BIT5 /** * Send byte to Serial Port * * Before use this routine, please make sure Serial Communications Chip have been initialed * * @param[in] ByteSended Byte to be sended * * @retval TRUE Byte sended successfully * @retval FALSE Byte sended failed * **/ STATIC BOOLEAN AmdIdsSerialSendByte ( IN CHAR8 ByteSended ) { UINT32 RetryCount; UINT8 Value; //Wait until LSR.Bit5 (Transmitter holding register Empty) RetryCount = 200; do { LibAmdIoRead (AccessWidth8, IDS_SERIAL_PORT_LSR, &Value, NULL); RetryCount--; } while (((Value & IDS_LSR_TRANSMIT_HOLDING_REGISTER_EMPTY_MASK) == 0) && (RetryCount > 0)); if (RetryCount == 0) { //Time expired return FALSE; } else { LibAmdIoWrite (AccessWidth8, IDS_SERIAL_PORT, &ByteSended, NULL); return TRUE; } } /** * Print formated string * * @param[in] Buffer - Point to input buffer * @param[in] BufferSize - Buffer size * @param[in] debugPrintPrivate - Option * **/ STATIC VOID AmdIdsSerialPrint ( IN CHAR8 *Buffer, IN UINTN BufferSize, IN IDS_DEBUG_PRINT_PRIVATE_DATA *debugPrintPrivate ) { BOOLEAN SendStatus; UINT32 RetryCount; RetryCount = 200; while (BufferSize--) { do { if (*Buffer == '\n') { SendStatus = AmdIdsSerialSendByte ('\r'); } SendStatus = AmdIdsSerialSendByte (*Buffer); RetryCount--; } while ((SendStatus == FALSE) && (RetryCount > 0)); Buffer ++; } } /** * Init local private data * * @param[in] Flag - filter flag * @param[in] debugPrintPrivate - Point to debugPrintPrivate * **/ STATIC VOID AmdIdsSerialInitPrivateData ( IN UINT64 Flag, IN IDS_DEBUG_PRINT_PRIVATE_DATA *debugPrintPrivate ) { } CONST IDS_DEBUG_PRINT ROMDATA IdsDebugPrintSerialInstance = { AmdIdsSerialSupport, AmdIdsSerialGetFilter, AmdIdsSerialInitPrivateData, AmdIdsSerialPrint };