// Copyright (c) 2004-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 DMA Platform Specific Layer (PSL).

//

#include <kernel/kern_priv.h>

#include <template_assp.h>									// /assp/template_assp/

#include <drivers/dma.h>

// Debug support

class TDmaDesc

//

// Hardware DMA descriptor

//

	{

public:

	enum {KStopBitMask = 1};

public:

	TPhysAddr iDescAddr;

	TPhysAddr iSrcAddr;

	TPhysAddr iDestAddr;

	TUint32 iCmd;

	};

//////////////////////////////////////////////////////////////////////////////

// Test Support

//////////////////////////////////////////////////////////////////////////////

TDmaTestInfo TestInfo =

	{

	0,

	0,

	0,

	0,

	NULL,

	0,

	NULL,

	0,

	NULL

	};

EXPORT_C const TDmaTestInfo& DmaTestInfo()

//

//

//

	{

	return TestInfo;

	}

//////////////////////////////////////////////////////////////////////////////

// Helper Functions

//////////////////////////////////////////////////////////////////////////////

inline TBool IsHwDesAligned(TAny* aDes)

//

// Checks whether given hardware descriptor is 16-bytes aligned.

//

	{

	return ((TLinAddr)aDes & 0xF) == 0;

	}

//

// Returns value to set in DMA command register or in descriptor command field.

//

	{

	// TO DO: Construct CMD word from input values.

	// The return value should reflect the actual control word.

	}

//////////////////////////////////////////////////////////////////////////////

// Derived Channel (Scatter/Gather)

//////////////////////////////////////////////////////////////////////////////

class TTemplateSgChannel : public TDmaSgChannel

	{

public:

	TDmaDesc* iTmpDes;

	TPhysAddr iTmpDesPhysAddr;

	};

//////////////////////////////////////////////////////////////////////////////

// Derived Controller Class

//////////////////////////////////////////////////////////////////////////////

class TTemplateDmac : public TDmac

	{

public:

	TTemplateDmac();

	TInt Create();

private:

	// from TDmac (PIL pure virtual)

	virtual void StopTransfer(const TDmaChannel& aChannel);

	virtual TBool IsIdle(const TDmaChannel& aChannel);

	// from TDmac (PIL virtual)

	virtual void ChainHwDes(const SDmaDesHdr& aHdr, const SDmaDesHdr& aNextHdr);

	virtual void AppendHwDes(const TDmaChannel& aChannel, const SDmaDesHdr& aLastHdr,

							 const SDmaDesHdr& aNewHdr);

	virtual void UnlinkHwDes(const TDmaChannel& aChannel, SDmaDesHdr& aHdr);

	// other

	static void Isr(TAny* aThis);

	inline TDmaDesc* HdrToHwDes(const SDmaDesHdr& aHdr);

private:

	static const SCreateInfo KInfo;

public:

	TTemplateSgChannel iChannels[KChannelCount];

	};

static TTemplateDmac Controller;

const TDmac::SCreateInfo TTemplateDmac::KInfo =

	{

	};

TTemplateDmac::TTemplateDmac()

//

// Constructor.

//

	: TDmac(KInfo)

	{}

TInt TTemplateDmac::Create()

//

// Second phase construction.

//

	{

	TInt r = TDmac::Create(KInfo);							// Base class Create()

	if (r == KErrNone)

		{

		__DMA_ASSERTA(ReserveSetOfDes(KChannelCount) == KErrNone);

		for (TInt i=0; i < KChannelCount; ++i)

			{

			TDmaDesc* pD = HdrToHwDes(*iFreeHdr);

			iChannels[i].iTmpDes = pD;

			iFreeHdr = iFreeHdr->iNext;

			}

		r = Interrupt::Bind(EAsspIntIdDma, Isr, this);

		if (r == KErrNone)

			{

			// TO DO: Map DMA clients (requests) to DMA channels here.

			r = Interrupt::Enable(EAsspIntIdDma);

			}

		}

	return r;

	}

void TTemplateDmac::Transfer(const TDmaChannel& aChannel, const SDmaDesHdr& aHdr)

//

// Initiates a (previously constructed) request on a specific channel.

//

	{

	const TUint8 i = static_cast<TUint8>(aChannel.PslId());

	TDmaDesc* pD = HdrToHwDes(aHdr);

	__KTRACE_OPT(KDMA, Kern::Printf(">TTemplateDmac::Transfer channel=%d des=0x%08X", i, pD));

	// TO DO (for instance): Load the first descriptor address into the DMAC and start it

	// by setting the RUN bit.

	(void) *pD, (void) i;

	}

void TTemplateDmac::StopTransfer(const TDmaChannel& aChannel)

//

// Stops a running channel.

//

	{

	const TUint8 i = static_cast<TUint8>(aChannel.PslId());

	__KTRACE_OPT(KDMA, Kern::Printf(">TTemplateDmac::StopTransfer channel=%d", i));

	// TO DO (for instance): Clear the RUN bit of the channel.

	(void) i;

	}

TBool TTemplateDmac::IsIdle(const TDmaChannel& aChannel)

//

// Returns the state of a given channel.

//

	{

	const TUint8 i = static_cast<TUint8>(aChannel.PslId());

	__KTRACE_OPT(KDMA, Kern::Printf(">TTemplateDmac::IsIdle channel=%d", i));

	// TO DO (for instance): Return the state of the RUN bit of the channel.

	// The return value should reflect the actual state.

	(void) i;

	return ETrue;

	}

//

//

	{

	// TO DO: Determine the proper return value, based on the arguments.

	// For instance:

	return KMaxTransferLen;

	}

//

// Returns the memory buffer alignment restrictions mask for a given transfer.

//

	{

	// TO DO: Determine the proper return value, based on the arguments.

	// For instance:

	return KMemAlignMask;

	}

//

//

	{

	TDmaDesc* pD = HdrToHwDes(aHdr);

	__KTRACE_OPT(KDMA, Kern::Printf("TTemplateDmac::InitHwDes 0x%08X", pD));

	// Unaligned descriptor? Bug in generic layer!

	__DMA_ASSERTD(IsHwDesAligned(pD));

	pD->iDescAddr = TDmaDesc::KStopBitMask;

	}

void TTemplateDmac::ChainHwDes(const SDmaDesHdr& aHdr, const SDmaDesHdr& aNextHdr)

//

// Chains hardware descriptors together by setting the next pointer of the original descriptor

// to the physical address of the descriptor to be chained.

//

	{

	TDmaDesc* pD = HdrToHwDes(aHdr);

	TDmaDesc* pN = HdrToHwDes(aNextHdr);

	__KTRACE_OPT(KDMA, Kern::Printf("TTemplateDmac::ChainHwDes des=0x%08X next des=0x%08X", pD, pN));

	// Unaligned descriptor? Bug in generic layer!

	__DMA_ASSERTD(IsHwDesAligned(pD) && IsHwDesAligned(pN));

	// TO DO: Modify pD->iCmd so that no end-of-transfer interrupt gets raised any longer.

	}

void TTemplateDmac::AppendHwDes(const TDmaChannel& aChannel, const SDmaDesHdr& aLastHdr,

								const SDmaDesHdr& aNewHdr)

//

// Appends a descriptor to the chain while the channel is running.

//

	{

	const TUint8 i = static_cast<TUint8>(aChannel.PslId());

	TDmaDesc* pL = HdrToHwDes(aLastHdr);

	TDmaDesc* pN = HdrToHwDes(aNewHdr);

	__KTRACE_OPT(KDMA, Kern::Printf(">TTemplateDmac::AppendHwDes channel=%d last des=0x%08X new des=0x%08X",

									i, pL, pN));

	// Unaligned descriptor? Bug in generic layer!

	__DMA_ASSERTD(IsHwDesAligned(pL) && IsHwDesAligned(pN));

	const TInt irq = NKern::DisableAllInterrupts();

	StopTransfer(aChannel);

	pL->iDescAddr = newPhys;

	const TTemplateSgChannel& channel = static_cast<const TTemplateSgChannel&>(aChannel);

	TDmaDesc* pD = channel.iTmpDes;

	// TO DO: Implement the appropriate algorithm for appending a descriptor here.

	(void) *pD, (void) i;

	NKern::RestoreInterrupts(irq);

	__KTRACE_OPT(KDMA, Kern::Printf("<TTemplateDmac::AppendHwDes"));

	}

void TTemplateDmac::UnlinkHwDes(const TDmaChannel& /*aChannel*/, SDmaDesHdr& aHdr)

//

// Unlink the last item in the h/w descriptor chain from a subsequent chain that it was

// possibly linked to.

//

	{

 	__KTRACE_OPT(KDMA, Kern::Printf(">TTemplateDmac::UnlinkHwDes"));

  	TDmaDesc* pD = HdrToHwDes(aHdr);

  	pD->iDescAddr = TDmaDesc::KStopBitMask;

	// TO DO: Modify pD->iCmd so that an end-of-transfer interrupt will get raised.

	}

void TTemplateDmac::Isr(TAny* aThis)

//

// This ISR reads the interrupt identification and calls back into the base class

// interrupt service handler with the channel identifier and an indication whether the

// transfer completed correctly or with an error.

//

	{

	TTemplateDmac& me = *static_cast<TTemplateDmac*>(aThis);

	// TO DO: Implement the behaviour described above, call HandleIsr().

	}

inline TDmaDesc* TTemplateDmac::HdrToHwDes(const SDmaDesHdr& aHdr)

//

// Changes return type of base class call.

//

	{

	return static_cast<TDmaDesc*>(TDmac::HdrToHwDes(aHdr));

	}

//////////////////////////////////////////////////////////////////////////////

// Channel Opening/Closing (Channel Allocator)

//////////////////////////////////////////////////////////////////////////////

//

//

//

	{

	__KTRACE_OPT(KDMA, Kern::Printf(">DmaChannelMgr::Open aOpenId=%d", aOpenId));

	__DMA_ASSERTA(aOpenId < static_cast<TUint32>(KChannelCount));

	TDmaChannel* pC = Controller.iChannels + aOpenId;

	if (pC->IsOpened())

		pC = NULL;

	else

		{

		pC->iController = &Controller;

		pC->iPslId = aOpenId;

		}

	return pC;

	}

//

//

//

	{

	// NOP

	}

//

//

//

	{

	return KErrNotSupported;

	}

//////////////////////////////////////////////////////////////////////////////

// DLL Exported Function

//////////////////////////////////////////////////////////////////////////////

DECLARE_STANDARD_EXTENSION()

//

// Creates and initializes a new DMA controller object on the kernel heap.

//

	{

	__KTRACE_OPT2(KBOOT, KDMA, Kern::Printf("Starting DMA Extension"));

	return Controller.Create();

	}