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

 // e32\include\drivers\pccd_ifc.h

 // 

 //

 /**

  @file

  @publishedPartner

  @released

 */

 #ifndef __PCCD_IFC_H__

 #define __PCCD_IFC_H__

 #include <pccard.h>

 #include <drivers/locmedia.h>

 #include <platform.h>

 #include <assp.h>

 #define __PCCD_MACHINE_CODED__

 const TInt KMemConfigByteAccess=1;

 class PccdIfc

 	{

 public:

 	static DPcCardSocket* NewSocket(TInt aSocketNum);

 	static DPcCardMediaChange* NewMediaChange(TInt aMcId);

 	static DPcCardVcc* NewVcc(TInt aVccNum, TInt aMcId);

 	static DPccdChunkBase* NewChunk(TPccdMemType aType);

 	};

 	/**

 	 A base class that defines a Pc Card controller interface.

 	 @publishedPartner

 	 @released

 	 */

 class TPcCardControllerInterface

 	{

 public:

 	/**

 	 Allocate any resources. Only done once on kernel initialization so don't worry about cleanup if it fails.

 	 @return KErrNone if successful in allocating memory for the Pc Card. otherwise return KErrNoMemory.

 	 */

 	IMPORT_C TInt Create();

 public:

     /**

  	 Gets the physical address of Pc Card memory.

 	 @param aCard  A Pc Card whose physical address to be returned.

 	 @param aType  Memory type  of the Pc Card whose physical address to be returned.

 	 @return Physical address of Pc Card for the given memory type.

 	 @see TPccdMemType

 	 */    

 	virtual TUint32 MemPhysicalAddress(TInt aCard,TPccdMemType aType)=0;

 	/** 

 	 Sets the Pc Card controller h/w.

 	 Initialise the Pc Card Controller h/w.

 	 @return KErrNone if Pc Card contorller h/w is initialised.

      */

 	virtual TInt Init()=0;

     /**

 	 Gets the current settings for the Pc Card.

 	 @param aCard  A Pc Card whose signals to be indicated.

 	 @param anInd  Has current settings for the PC Card indicator signals into 'anInd' for the specified aCard.

 	 @return KErrNone if successful.

 	 @see TSocketIndicators.

 	 */

 	virtual TInt Indicators(TInt aCard,TSocketIndicators &anInd)=0;

     /**

  	 Enables the Pc Card Interface.

 	 @param aCard  A Pc Card whose interface to be enabled.

 	 */

 	virtual void InterfaceOn(TInt aCard)=0;

 	/**

  	 Disables the Pc Card Interface.

 	 @param aCard  A PC Card whose interface to be disabled.

 	 */

 	virtual void InterfaceOff(TInt aCard)=0;

 	/**

  	 To Apply/remove h/w reset.

      @param aCard  A Pc Card which has to be h/w reseted.

      @param anAssert To make the h/w reset guarented.

 	 */

     virtual void CardReset(TInt aCard,TBool anAssert)=0;

 	/**

  	 Gets Pc Card Rdy/Bsy status.

      @param aCard  Pc Card whose status to be returned.

 	 @return True if the card is ready.

 	 */

     virtual TBool CardReady(TInt aCard)=0;

 	/** 

 	 Configure memory configuration options.

      @param aCard   Pc Card whose memory to be configured.

 	 @param aMemType  Type of memory to be configured.

      @param aSpeed    Access speed of the memory involved.

 	 @param aWaitSig  This WaitSig should never checked since repeated accesses to MECR seem to crash the system

 	  in mysterious ways.

 	 @param aFlag    To modify the memory configuration attributes by ORing with memory chunk setup flags pKPccdBusWidth32 and KPccdDisableWaitStateCntrl  ,

 	 @return KErrNone if successful, KErrNotSupported if unsuccessful.

 	 @see TPccdMemType.

 	 @see TPccdAccessSpeed.

      */

 	virtual TInt MemConfig(TInt aCard,TPccdMemType aMemType,TPccdAccessSpeed aSpeed,TBool aWaitSig,TUint aFlag)=0;

     /**

      Gets the information of the socket.

      @param aSocket  Socket whose information to be retrieved.

      @param anInfo  Gets the socket information in anInfo.

 	 @see TPcCardSocketInfo.

 	 */

     virtual void SocketInfo(TSocket aSocket,TPcCardSocketInfo& anInfo)=0;

 	/**

      Checks the specified socket contains a card (and the media door for the socket is closed).

   	 @param anInfo  Has the socket information.

      @param aCard  Socket for which a card presence is checked.

 	 @return True if the socket contians a card (and the media door for the socket is closed).

 	 */

 	virtual TBool CardIsPresent(TInt aCard)=0;

     /**

   	 Gets the changed state  of the specified media (ex,removed,inserted..)

      @param aMediaChangeId  stores the state of the specified media change

 	 @return Mediastate when change to media takes place.

 	 @see TMediaState.

 	 */   

 	virtual TMediaState MediaState(TInt aMediaChangeId)=0;

     // Pc Card PSUs

 	/**

   	 Sets Vcc information for the Pc Card.

      @param aPsu    Power supply unit value supplied for the Pc Card.

      @param aninfo  Object of TPBusPsuInfo type passed to store the PSU information.

 	 @see TPBusPsuInfo.

 	 */

 	virtual void VccInfo(TInt aPsu,TPBusPsuInfo &aninfo)=0;

 	/**

      Sets Pc Card Vcc power supply OFF.

      @param aPsu  Power supply unit  for the Pc Card.

 	 */

     virtual void VccOff(TInt aPsu)=0;

 	/**

   	 Sets Pc Card Vcc power supply ON.

      @param aPsu  Power supply unit  for the Pc Card.

      @param aVoltageSetting  A voltage to power on Pc Card which is defined in enum TPccdSocketVcc.

 	 @see TPccdSocketVcc

 	 */

     virtual void VccOnFull(TInt aPsu,TPccdSocketVcc aVoltageSetting)=0;

     /**

 	 Sets Pc Card Vcc power supply ON with current limit.

 	 @param aPsu  Power supply unit  for the Pc Card.

  	 @param aVoltageSetting  A voltage of current limt to power on Pc Card which is defined in enum TPccdSocketVcc.

 	 @see TPccdSocketVcc

 	 */

     virtual void VccOnCurrentLimit(TInt aPsu,TPccdSocketVcc aVoltageSetting)=0;

     /**

 	 Sets Pc Card Vcc level (normally ADC reading). Return KErrNotReady if the voltage check isn't complete.

 	 @param aPsu  Power supply unit  for the Pc Card.

   	 */

     virtual TInt VccInMilliVolts(TInt aPsu)=0;

 	/*

 	 Gets Pc Card Vcc voltage status. 

 	 An alternative to using ADC, when voltage checking is performed using a comparator arrangement. 

 	 @param aPsu Power supply unit for the Pc Card.

 	 @return KErrNone if successful, KErrGeneral if failed.

 	 */

 	virtual TInt VccVoltCheck(TInt aPsu)=0;

 	// interrupts

 	/** 

 	 Gets a interrupt Id for Pc card.

 	 @param aCard  Pc Card to which interrupts Id is requested.

 	 @return InterruptId of the Pc Card.

      */

 	virtual TInt IntIdIReq(TInt aCard)=0;

     /**

      Gets ready interrupt Id when ready signal is asserted  on Pc Card.

      @param aCard  Pc Card which is interrupted through a ready signal.

 	 @return Ready interrupt Id for the Pc Card.

      */

 	virtual TInt IntIdRdyC(TInt aCard)=0;

     /**

      Gets interrupt status Id when status of Pc Card changes.

 	 @param aCard  Pc Card which is interrupted through a change in state.

 	 @return Interrupt status Id, for the Pc Card.

      */

 	virtual TInt IntIdStsC(TInt aCard)=0;

     /**

      Gets Mediachange interrupt Id when media changes, i,e  when media door is Opend/Closed.

      @param aMediaChangeId  An  media chagne Id which tells whether media door is closed / Opened.

 	 @return Media change interrupt id, when a change in media takes place.

      */

 	virtual TInt IntIdMediaChange(TInt aMediaChangeId)=0;

 	/**

      Acknowledge the media change interrupt.

      @param aMediaChangeId  An  media change Id which tells whether a door is closed / Opened.

 	 */

 	virtual void ClearMediaChange(TInt aMediaChangeId)=0;

 	// machine configuration

 	/**

      @param aSocket the socket ID.

 	 @param aMediaDeviceInfo , Media information of the scoket which has to be checked.

 	 @return True if Pc Card is present in the secified socket.

 	 */

 	virtual TBool IsPcCardSocket(TInt aSocket,SMediaDeviceInfo& aMediaDeviceInfo)=0;

 	/**  

 	 Gets information about from which socket does the media change took place.

 	 @param aSocket the socket ID.

 	 @return socket from which socket does the media change took place.

 	 */

 	virtual TInt MediaChangeFromSocket(TInt aSocket)=0;

 	/**

 	 Gets from which socket does the Vcc signal is generated.

 	 @param aSocket the socket ID.

 	 @return socket Id from which Vcc signal is generated.

 	 */

 	virtual TInt VccFromSocket(TInt aSocket)=0;

     };

 GLREF_D TPcCardControllerInterface* ThePccdCntrlInterface;

 #endif