// Copyright (c) 1994-2009 Nokia Corporation and/or its subsidiary(-ies).
// All rights reserved.
// This component and the accompanying materials are made available
// under the terms of the License "Eclipse Public License v1.0"
// which accompanies this distribution, and is available
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
// template\template_variant\specific\monitor.cpp
// Kernel crash debugger - Template specific
// 
//

#include <kernel/monitor.h>
#include "variant.h"

//
// UART code
//
void CrashDebugger::InitUart()
	{
	// Wait for last kernel trace to appear
	TTemplate::BootWaitMilliSeconds(100);

	//
	// TO DO: (mandatory)
	//
	// Initialise the UART for outputing debug strings. Need to work with the following settings:
	//  - 115200Baud
	//  - 8 data bits, 1 stop bit
	//  - No parity
	// Obtain and use UART linear base address to access the UART registers, e.g.
	// TUint32 debugPortBase = TTemplate::DebugPortAddr();
	//
	}

void CrashDebugger::UartOut(TUint aChar)
	{
	//
	// TO DO: (mandatory)
	//
	// Output aChar through debug UART
	// Obtain and use UART linear base address to access the UART register, e.g.
	// Should take in consideration software flow control and check if Power is stable as per example below (pseudo-code):
	//
	TUint c=0;
	// TUint32 debugPortBase = TTemplate::DebugPortAddr();		TO DO: (mandatory): Uncomment this
	// while (!(input FIFO empty))								TO DO: (mandatory): Implement
		{ 
		if (CheckPower())
			return;
	//	c=(read received char);									TO DO: (mandatory): Implement
		if (c==19)            // XOFF
			{
			FOREVER
				{
				// wait for XON
	//			while((input FIFO empty))						TO DO: (mandatory): Implement
					{
					if (CheckPower())
						return;
					}
	//			c=(read received char);							TO DO: (mandatory): Implement
				if (c==17)    // XON
					break;
				else if (c==3)		// Ctrl C
					Leave(KErrCancel);
				}
			}
		
		// coverity[dead_error_condition]
		// The next line should be reachable when this template file is edited for use
		else if (c==3)		// Ctrl C
			Leave(KErrCancel);
		}

	// while ((output FIFO full))					TO DO: (mandatory): wait for last char to leave the FIFO (Implement)
		CheckPower();
	// (write aChar to output port - or FIFO);					TO DO: (mandatory): Implement
	}

TUint8 CrashDebugger::UartIn()
	{
	//
	// TO DO: (mandatory)
	//
	// Wait for a char to arrive at input port, read it and return its value
	// Use the UART linear base address obtained as in below example to access the UART registers
	// Example below is pseudo-code:
	//
	// TUint32 debugPortBase = TTemplate::DebugPortAddr();		TO DO: (mandatory): Uncomment this
	// while ((input FIFO empty))					TO DO: (mandatory): wait for a character to arrive (Implement)
		{
		if (CheckPower())
			return 0x0d;
		}
	// return (read received char);								TO DO: (mandatory): Implement
	return 0;	// EXAMPLE ONLY
	}

TBool CrashDebugger::CheckPower()
	{
	//
	// TO DO: (mandatory)
	//
	// Check if power supply is stable and return ETrue if not
	//
	return EFalse;	// EXAMPLE ONLY
	}