// Copyright (c) 1998-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_assp\interrupts.cpp

 // Template ASSP interrupt control and dispatch

 // 

 //

 #include <template_assp_priv.h>

 SInterruptHandler TemplateInterrupt::Handlers[KNumTemplateInts];

 void TemplateInterrupt::DisableAndClearAll()

 	{

 	//

 	// TO DO: (mandatory)

 	//

 	// Disable and clear all Hardware Interrupt sources

 	//

 	}

 void TemplateInterrupt::Init1()

 	{

 	//

 	// need to hook the ARM IRQ and FIQ handlers as early as possible and disable and clear all interrupt sources

 	//

 	__KTRACE_OPT(KBOOT,Kern::Printf("TemplateInterrupt::Init1()"));

 	TInt i;

 	for (i=0; i<KNumTemplateInts; i++)

 		{

 		Handlers[i].iPtr=(TAny*)i;

 		Handlers[i].iIsr=Spurious;

 		}

 	DisableAndClearAll();

 	Arm::SetIrqHandler((TLinAddr)TemplateInterrupt::IrqDispatch);

 	Arm::SetFiqHandler((TLinAddr)TemplateInterrupt::FiqDispatch);

 	}

 void TemplateInterrupt::Init3()

 	{

 	//

 	// TO DO: (optional)

 	//

 	// Any further initialisation of the Hardware Interrupt Controller

 	//

 	}

 void TemplateInterrupt::Spurious(TAny* anId)

 	{

 	//

 	// TO DO: (mandatory)

 	//

 	// handle an unexpected interrupt

 	//

 	Kern::Fault("SpuriousInt", (TInt)anId);		// EXAMPLE ONLY

 	}

 //

 // The APIs below assume ther is a second level Interrupt controller located at Variant level which handles

 // interrupts generated by hardware at that level.

 //

 EXPORT_C TInt Interrupt::Bind(TInt anId, TIsr anIsr, TAny* aPtr)

 	{

 	__KTRACE_OPT(KEXTENSION,Kern::Printf("Interrupt::Bind id=%d func=%08x ptr=%08x",anId,anIsr,aPtr));

 	TInt r=KErrNone;

 	// if ID indicates a chained interrupt, call variant...

 	if (anId<0 && ((((TUint)anId)>>16)&0x7fff)<(TUint)KNumTemplateInts)

 		r=TemplateAssp::Variant->InterruptBind(anId,anIsr,aPtr);

 	else if ((TUint)anId >= (TUint)KNumTemplateInts)

 		r=KErrArgument;

 	else

 		{

 		SInterruptHandler& h=TemplateInterrupt::Handlers[anId];

 		TInt irq=NKern::DisableAllInterrupts();

 		if (h.iIsr != TemplateInterrupt::Spurious)

 			r=KErrInUse;

 		else

 			{

 			h.iPtr=aPtr;

 			h.iIsr=anIsr;

 			}

 		NKern::RestoreInterrupts(irq);

 		}

 	return r;

 	}

 EXPORT_C TInt Interrupt::Unbind(TInt anId)

 	{

 	__KTRACE_OPT(KEXTENSION,Kern::Printf("Interrupt::Unbind id=%d",anId));

 	TInt r=KErrNone;

 	// if ID indicates a chained interrupt, call variant...

 	if (anId<0 && ((((TUint)anId)>>16)&0x7fff)<(TUint)KNumTemplateInts)

 		r=TemplateAssp::Variant->InterruptUnbind(anId);

 	else if ((TUint)anId >= (TUint)KNumTemplateInts)

 		r=KErrArgument;

 	else

 		{

 		SInterruptHandler& h=TemplateInterrupt::Handlers[anId];

 		TInt irq=NKern::DisableAllInterrupts();

 		if (h.iIsr == TemplateInterrupt::Spurious)

 			r=KErrGeneral;

 		else

 			{

 			h.iPtr=(TAny*)anId;

 			h.iIsr=TemplateInterrupt::Spurious;

 			//

 			// TO DO: (mandatory)

 			//

 			// Disable the corresponding Hardware Interrupt source

 			//

 			}

 		NKern::RestoreInterrupts(irq);

 		}

 	return r;

 	}

 EXPORT_C TInt Interrupt::Enable(TInt anId)

 	{

 	__KTRACE_OPT(KEXTENSION,Kern::Printf("Interrupt::Enable id=%d",anId));

 	TInt r=KErrNone;

 	// if ID indicates a chained interrupt, call variant...

 	if (anId<0 && ((((TUint)anId)>>16)&0x7fff)<(TUint)KNumTemplateInts)

 		r=TemplateAssp::Variant->InterruptEnable(anId);

 	else if ((TUint)anId>=(TUint)KNumTemplateInts)

 		r=KErrArgument;

 	else if (TemplateInterrupt::Handlers[anId].iIsr==TemplateInterrupt::Spurious)

 		r=KErrNotReady;

 	else

 		{

 		//

 		// TO DO: (mandatory)

 		//

 		// Enable the corresponding Hardware Interrupt source

 		//

 		}

 	return r;

 	}

 EXPORT_C TInt Interrupt::Disable(TInt anId)

 	{

 	__KTRACE_OPT(KEXTENSION,Kern::Printf("Interrupt::Disable id=%d",anId));

 	TInt r=KErrNone;

 	// if ID indicates a chained interrupt, call variant...

 	if (anId<0 && ((((TUint)anId)>>16)&0x7fff)<(TUint)KNumTemplateInts)

 		r=TemplateAssp::Variant->InterruptDisable(anId);

 	else if ((TUint)anId>=(TUint)KNumTemplateInts)

 		r=KErrArgument;

 	else

 		{

 		//

 		// TO DO: (mandatory)

 		//

 		// Disable the corresponding Hardware Interrupt source

 		//

 		}

 	return r;

 	}

 EXPORT_C TInt Interrupt::Clear(TInt anId)

 	{

 	__KTRACE_OPT(KEXTENSION,Kern::Printf("Interrupt::Clear id=%d",anId));

 	TInt r=KErrNone;

 	// if ID indicates a chained interrupt, call variant...

 	if (anId<0 && ((((TUint)anId)>>16)&0x7fff)<(TUint)KNumTemplateInts)

 		r=TemplateAssp::Variant->InterruptClear(anId);

 	else if ((TUint)anId>=(TUint)KNumTemplateInts)

 		r=KErrArgument;

 	else

 		{

 		//

 		// TO DO: (mandatory)

 		//

 		// Clear the corresponding Hardware Interrupt source

 		//

 		}

 	return r;

 	}

 EXPORT_C TInt Interrupt::SetPriority(TInt /*anId*/, TInt /*aPriority*/)

 	{

 	//

 	// If Interrupt priorities are supported the dispatchers need to take this in consideration

 	// (IrqDispatch/FiqDispatch)

 	//

 	return KErrNotSupported;

 	}