// 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

	}