/*

* Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "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:  

*

*/

#ifndef __MAPMAN_H__

#define __MAPMAN_H__

#include <e32cmn.h>

//helper maths functions

TUint32 Clp2(TUint32 aNumber);

TUint32 Log2(TUint32 aNumber);

class TAddressAllocator;

class DMutex;

/**

Responsible for creating outbound mappings so that

PCI peripherals can access system memory.

*/

class TMappingManager

	{

public:

	TMappingManager(TInt aNumOfBars, TAddressAllocator& aAllocator, TUint32 aBaseAddress);

	~TMappingManager();

	TInt CreateMapping(TUint32 aPhysicalAddress, TInt aSize, TUint32& aPciAddress);

	TInt RemoveMapping(TUint32 aPhysicalAddress);

	TInt GetPciAddress(TUint32 aPhysicalAddress, TUint32& aPciAddress);

	TInt GetPhysicalAddress(TUint32 aPciAddress, TUint32& aPhysicalAddress);

private:

	/**

	Associates BAR with an allocated PCI address

	*/

	struct TMapping

		{

		TMapping();

		static TBool UsedCompare(const TMapping& aKeyMapping, const TMapping& aMapping);

		static TBool PhysAddrCompare(const TUint32*, const TMapping& aMapping);

		static TBool ContainsPhysical(const TUint32*, const TMapping& aMapping);

		static TBool ContainsPci(const TUint32*, const TMapping& aMapping);

		inline TUint32 PciAddress(TUint32 aPhysAddress);

		inline TUint32 PhysAddress(TUint32 aPciAddress);

		TUint32 iPciAddr;

		TUint32 iPhysAddr;

		TUint32 iSize;

		TBool iUsed;

		};

	void DoCreateMapping(TInt aBarIndex, TUint32 aPhysicalAddress, TInt& aSize, TUint32& aPciAddress);

	TAddressAllocator& iAllocator;

	const TInt iNumOfBars;

	const TUint32 iBaseAddress;

	RArray<TMapping> iMappings;

	DMutex* iMutex;

	};

#endif // __MAPMAN_H__