/*

* Copyright (c) 2002-2007 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:  Provides information on CSD fax calls.

*

*/

#ifndef __CCSDFAX_H

#define __CCSDFAX_H

#include <etel.h>

#include <etelmm.h>

#include <rconnmon.h>

#include "ConnMonDef.h"

class CConnMonServer;

class CCsdFaxUpNotifier;

class CCsdStatusNotifier;

/**

*  CCsdFax

*  @lib CONMONN.LIB

*  @since

*/

NONSHARABLE_CLASS( CCsdFax ) : public CBase

    {

    public:

        // Constructors and destructor

        CCsdFax(

                CConnMonServer* aServer,

                RTelServer* aTelServer,

                RMobilePhone* aMobilePhone );

        void ConstructL();

        ~CCsdFax();

        enum TCsdFaxState

        {

        EModuleClosed = 0,

        ELineOpen,

        ECallOpen

        };

        /**

        * Checks if an external call exists.

        * @since

        * @return KErrNone if successfull, otherwise a system wide error code.

        */

        TInt FindCall();

        /**

        * Opens an external data call.

        * @since

        * @param aName The name of the call.

        * @return KErrNone if successfull, otherwise a system wide error code.

        */

        TInt OpenCall( const TDes& aName );

        /**

        * Closes the external call.

        * @since

        * @return void

        */

        void CloseCall();

        /**

        * Checks if external CSD call is still valid.

        * @since

        * @return ETrue if context is valid, EFalse otherwise.

        */

        TBool IsValid();

        /**

        * Gets the fax bearer.

        * @since

        * @param aBearer On return, contains the bearer.

        * @return KErrNone if successfull, otherwise a system wide error code.

        */

        TInt GetBearer( TInt& aBearer, TBearerInfo& aBearerInfo ) const;

        /**

        * Gets the status of the external connection.

        * @since

        * @param aStatus On return, contains the connection status.

        * @return KErrNone if successfull, otherwise a system wide error code.

        */

        TInt GetStatus( TInt& aStatus ) const;

        /**

        * Maps the data call status to nifvar.h values

        * @since

        * @param aStatus On return, contains the mapped connection status (in/out).

        * @return KErrNone if successfull, otherwise a system wide error code.

        */

        TInt MapStatus( TInt& aStatus ) const;

        /**

        * Gets the dial up number of the external data call.

        * @since

        * @param aNumber On return, contains the dial up number.

        * @return KErrNone if successfull, otherwise a system wide error code.

        */

        TInt GetTelNumber( TDes& aNumber ) const;

        /**

        * Gets the start time of the connection.

        * @since

        * @param aTime On return, contains the start time.

        * @return KErrNone if successfull, otherwise a system wide error code.

        */

        TInt GetStartTime( TTime& aTime ) const;

        /**

        * Closes the external data call.

        * @since

        * @return KErrNone if successfull, otherwise a system wide error code.

        */

        TInt Stop();

        /**

        * Removes connection from server tables.

        * @since

        * @return void.

        */

        void RemoveFromServer();

        void SetConnectionId( const TUint& aConnectionId ) { iConnectionId = aConnectionId; }

        TUint ConnectionId() const { return iConnectionId; }

    private: // Data

        CConnMonServer* iServer;

        // Pointer to ETel server

        RTelServer* iTelServer;

        // Pointer to mobile phone

        RMobilePhone* iMobilePhone;

        // "Data" line

        RLine iLine;

        // Open external data call

        RMobileCall iCall;

        // Name of the open external call

        TName iCsdFaxCallName ;

        // Connection ID

        TUint iConnectionId;

        // Tells fax module state

        TCsdFaxState iState;

        // Connection up event watcher

        CCsdFaxUpNotifier* iConnUpNotifier;

        // Connection status event watcher

        CCsdStatusNotifier* iStatusNotifier;

    };

/**

*  CCsdFaxUpNotifier

*  @lib CONNMON.LIB

*  @since

*/

NONSHARABLE_CLASS( CCsdFaxUpNotifier ) : public CActive

    {

    public: // Constructors and destructor

        CCsdFaxUpNotifier(

                CCsdFax* aFaxModule,

                CConnMonServer* aServer,

                RMobilePhone* aMobilePhone,

                RLine& aLine );

        void Construct();

        ~CCsdFaxUpNotifier();

    public:  // New methods

        /**

        * Requests a new event (connection up) from ETEL.

        * @since

        * @param

        * @return void

        */

        void Receive();

    private: // Methods from base classes

        /**

        * From CActive Cancels the asyncronous request

        * @since

        * @param

        * @return void

        */

        void DoCancel();

        /**

        * From CActive Handles the the event that has arrived from ETEL.

        * @since

        * @param

        * @return void

        */

        void RunL();

    private: // Data

        CCsdFax*        iFaxModule;

        CConnMonServer* iServer;

        RMobilePhone*   iMobilePhone;

        RLine&          iLine;

        TBuf<KMaxName>  iName;

        TEventInfo      iEventInfo;

    };

/**

*  CCsdStatusNotifier

*  @lib CONNMON.LIB

*  @since

*/

NONSHARABLE_CLASS( CCsdStatusNotifier ) : public CActive

    {

    public: // Constructors and destructor

        CCsdStatusNotifier(

                CCsdFax* aFaxModule,

                CConnMonServer* aServer );

        void Construct();

        ~CCsdStatusNotifier();

    public:  // New methods

        /**

        * Starts listening to status change events from ETEL.

        * @since

        * @param aCall The call whose status messages will be watched to.

        * @return void

        */

        void Start( RMobileCall* aCall );

        /**

        * Requests a new event (status changed) from ETEL.

        * @since

        * @param

        * @return void

        */

        void Receive();

    private: // Methods from base classes

        /**

        * From CActive Cancels the asyncronous request

        * @since

        * @param

        * @return void

        */

        void DoCancel();

        /**

        * From CActive Handles the the event that has arrived from ETEL.

        * @since

        * @param

        * @return void

        */

        void RunL();

    private: // Data

        CCsdFax*                       iFaxModule;

        CConnMonServer*                iServer;

        RMobileCall*                   iCall;

        RMobileCall::TMobileCallStatus iMobileCallStatus;

        TEventInfo                     iEventInfo;

    };

#endif // __CCSDFAX_H

// End-of-file