/*
* Copyright (c) 2003 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:  SWIM reader interface
*
*/



#ifndef CSWIMREADERIF_H
#define CSWIMREADERIF_H

//  INCLUDES
#include "ScardReader.h"
#include "ScardNotifyObserver.h"

//  CONSTANTS  
const TUint8 KGetStatus = 0xf0;

//  FORWARD DECLARATIONS
class CSwimReader;
class CSwimReaderLauncher;
class CSwimSysAgentObserver;

// CLASS DECLARATION

/**
*  Implements SwimReader interface class
*  
*
*  @lib SwimReader.lib
*  @since Series60 2.1
*/
class CSwimReaderIF : public CActive, public MScardReader
    {
    public: // Constructors and destructor
       
        /**
        * Two-phased constructor.
        * @param aNotifyObserver Pointer to notify observer
        * @param aReaderID Reader ID
        * @param aLauncher Pointer to reader launcher
        */    
        static CSwimReaderIF* NewL( MScardNotifyObserver* aNotifyObserver,
                                    TReaderID aReaderID,
                                    CSwimReaderLauncher* aLauncher );
        
        /**
        * Destructor.
        */
        virtual ~CSwimReaderIF();
    

    public: // New functions
        
        /**
        * Cancel transmit
        * @return void
        */
        void CancelTransmit();
        
        /**
        * Close SwimReader IF
        * @return KErrNone
        */
        TInt Close();
        
        /**
        * Get the ATR bytes
        * @param aAtr ATR bytes
        * @return KScErrNotSupported
        */
        TInt GetATR( TScardATR& aAtr );
        
        /**
        * Get card status or presence bits according to aTag parameter
        * @param aStatus Clients request status
        * @param aTag Tag for request type
        * @param aValue Value of tag
        * @param aTimeout Timeout for GetCapabilities request
        * @return ETrue
        */        
        TBool GetCapabilities( TRequestStatus& aStatus,
                               const TInt32 aTag,
                               TPtr8& aValue,
                               const TInt32 aTimeout );
        
        /**
        * Notifies Scard Server about card event
        * @param aStatus TScardServiceStatus
        * @return void
        */
        void Notify( TScardServiceStatus aStatus );
        
        /**
        * Open connection to Etel server
        * @param  aStatus TRequestStatus
        * @return void 
        */            
        void Open( TRequestStatus& aStatus );

        /**
        * Send a CommandAPDU on a slot and return ResponseAPDU from slot
        * @param aStatus TRequestStatus
        * @param aCommandAPDU Command APDU
        * @param aResponceAPDU Response APDU
        * @param aTimeout Timeout
        * @return void
        */
        void TransmitToCard( TRequestStatus& aStatus,
                             const TPtrC8& aCommandAPDU,
                             TPtr8& aResponseAPDU,
                             const TInt32 aTimeout);

    private:
        
        /**
        * C++ default constructor.
        * @param aNotifyObserver Pointer to notify observer
        * @param aReaderID Reader ID
        * @param aLauncher Pointer to reader launcher
        */ 
        CSwimReaderIF( MScardNotifyObserver* aNotifyObserver, 
                       TReaderID aReaderID,
                       CSwimReaderLauncher* aLauncher );
        
        /**
        * By default Symbian 2nd phase constructor is private.
        */
        void ConstructL();

        /**
        * Handle open APDU
        * @return void
        */
        void HandleOpen();

        /**
        * From CActive, RunL
        * @return void
        */
        void RunL();

        /**
        * Cancel the asyncronous request
        * @return void
        */
        void DoCancel();
    
    private: // Data
        // Enumerator for reader IF phases
        enum TReaderIFPhase
            {
            EOpen,
            EGetATR,
            ETransmitToCard
            };
        // error code
        TInt                            iErr;
        // Pointer to client status. Not owned.
        TRequestStatus*                 iClientStatus;
        // Pointer to SwimReader object. Owned.
        CSwimReader*                    iFunctionalLevel;
        // Historical bytes
        TBuf8<KMaxATRHistoricalBytes>   iHistoricals;
        // Reader ID
        TReaderID                       iID;
        // Reader IF phase
        TReaderIFPhase                  iIFPhase;
        // Pointer to ReaderLauncher object. Not owned. 
        CSwimReaderLauncher*            iLauncher;
        // Pointer to NotifyObserver object
        MScardNotifyObserver*           iNotifyObserver;
         // Pointer to System Agent Observer. Owned.
        CSwimSysAgentObserver*          iSysAgentObserver;
        
    private:    // Friend classes
        friend class CSwimReaderLauncher;
    
    };

#endif      // CSWIMREADERIF_H

// End of file
