/*

* Copyright (c) 2002-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:  This implements UsbActivePersonalityHandler class.

*

*/

// INCLUDE FILES

#include <etelmm.h>             // for fetching the IMEI code

#include <mmtsy_names.h>        // for RTelServer names

#include <UsbWatcherInternalCRKeys.h>

#include <cusbpersonalitynotifier.h>

#include <cusbpersonalityplugin.h>

#include <tusbpersonalityparams.h>

#include <startupdomainpskeys.h> //for global system state

#include "cusbactivepersonalityhandler.h"

#include "cusbglobalsystemstateobserver.h"

// CONSTANTS

// const TInt KSerialNumberLength = 12;

const TInt KContainerIdLength = 16;

// ============================ MEMBER FUNCTIONS ==============================

// ----------------------------------------------------------------------------

// C++ default constructor can NOT contain any code, that might leave.

// ----------------------------------------------------------------------------

//

CUsbActivePersonalityHandler::CUsbActivePersonalityHandler(

    RUsb& aUsbMan, CUsbWatcher& aOwner )

    : CActive( EPriorityStandard )

    , iUsbMan( aUsbMan )

    , iOwner( aOwner )

    {

    CActiveScheduler::Add( this );

    }

// ----------------------------------------------------------------------------

// Symbian 2nd phase constructor can leave.

// ----------------------------------------------------------------------------

//

void CUsbActivePersonalityHandler::ConstructL()

    {

    LOG_FUNC

    iPersonalityNotifier = CUsbPersonalityNotifier::NewL();

    iPersonalityParams = new ( ELeave ) TUsbPersonalityParams( iUsbMan,

            *iPersonalityNotifier );

    ConstructUsbSerialNumberL();

    }

// ----------------------------------------------------------------------------

// Two-phased constructor.

// ----------------------------------------------------------------------------

//

CUsbActivePersonalityHandler* CUsbActivePersonalityHandler::NewL(

        RUsb& aUsbMan, CUsbWatcher& aOwner )

    {

    LOG_FUNC

    CUsbActivePersonalityHandler* self = new ( ELeave )

            CUsbActivePersonalityHandler( aUsbMan, aOwner );

    CleanupStack::PushL( self );

    self->ConstructL();

    CleanupStack::Pop(); // pop self

    return self;

    }

// Destructor

CUsbActivePersonalityHandler::~CUsbActivePersonalityHandler()

    {

    LOG_FUNC

    Cancel(); // cancel any outstanding requests

    delete iCurrentPersonalityHandler;

    delete iPersonalityNotifier;

    delete iPersonalityParams;

    }

// ----------------------------------------------------------------------------

// Construct USB serial number. Some of the personalities may need this.

// ----------------------------------------------------------------------------

//

void CUsbActivePersonalityHandler::ConstructUsbSerialNumberL()

    {

    LOG_FUNC

    RTelServer telServer;

    RMobilePhone phone;

    LEAVEIFERROR( telServer.Connect() );

    CleanupClosePushL( telServer );

    LEAVEIFERROR( telServer.LoadPhoneModule( KMmTsyModuleName ) );

    LEAVEIFERROR( phone.Open( telServer, KMmTsyPhoneName ) );

    CleanupClosePushL( phone );

    // to store the serial number to be published as the USB device's serial

    // number, fetch it from telephony server.

    TRequestStatus status;

    phone.GetPhoneId( status, iPhoneInfo );

    User::WaitForRequest( status );

    // make sure that the serial number fulfills USB requirements and then

    // convert the serial number so that it can be printed to log

    TLex lex( iPhoneInfo.iSerialNumber );

    TInt length = iPhoneInfo.iSerialNumber.Length();

    // currently the serial number is used for the USB container ID

    // the container ID length must be at least 16 bytes

    // also, even when serial number is not used for the container id

    // it must be at least 12, see below

    if( length < KContainerIdLength )

        {

        // In GSM, the complete IMEI can used as USB serial number. But in

        // CDMA, the ESN is too short for a valid Mass Storage serial number

        // (Mass-Storage and Bulk Only Transport specs both require minimum

        // 12 byte number), so it is extended with leading zeroes. When

        // doing this, make sure not to write anything over descriptor's

        // max length

        if( iPhoneInfo.iSerialNumber.MaxLength() < KContainerIdLength )

            {

            iPhoneInfo.iSerialNumber.SetLength( KContainerIdLength );

            }

        while( length < KContainerIdLength )

            {

            iPhoneInfo.iSerialNumber.Append( '0' );

            ++length;

            }

        }

    CleanupStack::PopAndDestroy( 2, &telServer );

    }

// ----------------------------------------------------------------------------

// Confirm that personality can be loaded.

// ----------------------------------------------------------------------------

//

void CUsbActivePersonalityHandler::ConfirmPersonalityUnload( TRequestStatus&

        aStatus )

    {

    LOG_FUNC

    aStatus = KRequestPending;

    iRequestStatus = &aStatus;

    if( iState != EUsbPersonalityStarted )

        {

        TRequestStatus* status = &iStatus;

        SetActive();

        User::RequestComplete( status, KErrGeneral );

        return;

        }

    // Cancel all notes before confirmation

    iPersonalityParams->PersonalityNotifier().CancelAll();

    if( iCurrentPersonalityHandler )

        {

        iCurrentPersonalityHandler->ConfirmPersonalityUnload( iStatus );

        SetActive();

        }

    else

        {

        TRequestStatus* status = &iStatus;

        SetActive();

        User::RequestComplete( status, KErrNone );

        }

    }

// ----------------------------------------------------------------------------

// Start personality.

// ----------------------------------------------------------------------------

//

void CUsbActivePersonalityHandler::StartPersonality( TInt& aPersonalityId,

        TInt aAskOnConnectionSetting, TRequestStatus& aStatus )

    {

    LOG_FUNC

    LOG2( "PersonalityId = %d, AskOnConnectionSetting = %d", aPersonalityId,

            aAskOnConnectionSetting );

    // Remove all notes.

    iPersonalityNotifier->CancelAll();

    iPersonalityId = &aPersonalityId;

    iAskOnConnectionSetting = aAskOnConnectionSetting;

    aStatus = KRequestPending;

    iRequestStatus = &aStatus;

    // prepare current personality for start and return

    if( iCurrentPersonalityHandler )

        {

        LOG( "Previous PersonalityHandler not deleted" );

        User::RequestComplete( iRequestStatus, KErrGeneral );

        return;

        }

    TRAPD( ret, ( iCurrentPersonalityHandler = NewPersonalityHandlerL(

            *iPersonalityId ) ) );

    if( ( ret == KErrNone) && iCurrentPersonalityHandler )

        {

        LOG( "PersonalityHandler created" );

        iCurrentPersonalityHandler->PreparePersonalityStart( iStatus );

        iState = EUsbPersonalityPrepareStart;

        SetActive();

        }

    else

        {

        LOG( "Error: PersonalityHandler create failed" );

        User::RequestComplete( iRequestStatus, KErrGeneral );

        }

    }

// ----------------------------------------------------------------------------

// Stop current personality.

// ----------------------------------------------------------------------------

//

void CUsbActivePersonalityHandler::StopPersonality( TRequestStatus& aStatus )

    {

    LOG_FUNC

    aStatus = KRequestPending;

    iRequestStatus = &aStatus;

    iState = EUsbPersonalityPrepareStop;

    // prepare current personality for stop and return

    if( iCurrentPersonalityHandler )

        {

        LOG( "Call PersonalityPlugin to prepare stop" );

        iCurrentPersonalityHandler->PreparePersonalityStop( iStatus );

        SetActive();

        }

    else

        {

        LOG( "No current PersonalityPlugin, return immediately" );

        TRequestStatus* status = &iStatus;

        SetActive();

        User::RequestComplete( status, KErrNone );

        }

    }

// ----------------------------------------------------------------------------

// Indicates USB device state change to personality when USB is started.

// ----------------------------------------------------------------------------

//

void CUsbActivePersonalityHandler::StateChangeNotify(

        TUsbDeviceState aStateOld, TUsbDeviceState aStateNew )

    {

    LOG_FUNC

    iDeviceState = aStateNew;        

    switch ( aStateNew )

        {

        case EUsbDeviceStateAddress:

            {

            if( iAskOnConnectionSetting &&

                    ( aStateOld != EUsbDeviceStateSuspended ) &&

                    ( aStateOld != EUsbDeviceStateConfigured ) 

                     )

                {

                iPersonalityParams->PersonalityNotifier().ShowQuery(

                        KCableConnectedNotifierUid, iDummy,

                        iPersonalityPckgBuf);

                }

            break;

            }

       default:

            // We do not handle other state here

			LOG( "DeviceStatechange ignored by ActivePersonalityhandler or EUsbDeviceStateConfigured" );

            break;

        }

    if( iCurrentPersonalityHandler )

        {

        LOG( "Notifying PersonalityPlugin of the new state" );

        iCurrentPersonalityHandler->StateChangeNotify( aStateNew );

        }

    }

// ----------------------------------------------------------------------------

// Standard active object error function. Handle error and complete

// outstanding request. We must not come here.

// ----------------------------------------------------------------------------

//

TInt CUsbActivePersonalityHandler::RunError( TInt /*aError*/ )

    {

    LOG_FUNC

    return KErrNone;

    }

// ----------------------------------------------------------------------------

// Executed when iStatus is completed.

// ----------------------------------------------------------------------------

//

void CUsbActivePersonalityHandler::RunL()

    {

    LOG_FUNC

    TInt ret = iStatus.Int();

    if( KErrNone != ret )

        {

        LOG1( "ERROR: CUsbActivePersonalityHandler::RunL iStatus = %d", ret );

        }

    switch( iState )

        {

        case EUsbPersonalityIdle:

            break;

        case EUsbPersonalityPrepareStart:

            {

            LOG( "EUsbPersonalityPrepareStart" );

            // then write the serial number to P&S for USB Manager

            PublishSerialNumber();

            iUsbMan.TryStart( *iPersonalityId, iStatus );

            iState = EUsbPersonalityStartUsb;

            SetActive();

            }

            break;

        case EUsbPersonalityStartUsb:

            LOG( "EUsbPersonalityStartUsb" );

            iState = EUsbPersonalityFinishStart;

            if( iCurrentPersonalityHandler )

                {

                iCurrentPersonalityHandler->FinishPersonalityStart( iStatus );

                SetActive();

                }

            else

                {

                TRequestStatus* status = &iStatus;

                SetActive();

                User::RequestComplete( status, KErrNone );

                }

            break;

        case EUsbPersonalityFinishStart:

            LOG( "EUsbPersonalityFinishStart" );

            User::RequestComplete( iRequestStatus, ret );

            iState = EUsbPersonalityStarted;

            break;

        case EUsbPersonalityPrepareStop:

            LOG( "EUsbPersonalityPrepareStop" );

            iUsbMan.TryStop( iStatus );

            iState = EUsbPersonalityStopUsb;

            SetActive();

            break;

        case EUsbPersonalityStopUsb:

            LOG( "EUsbPersonalityStopUsb" );

            iState = EUsbPersonalityFinishStop;

            if( iCurrentPersonalityHandler )

                {

                iCurrentPersonalityHandler->FinishPersonalityStop( iStatus );

                SetActive();

                }

            else

                {

                TRequestStatus* status = &iStatus;

                SetActive();

                User::RequestComplete( status, KErrNone );

                }

            break;

        case EUsbPersonalityFinishStop:

            LOG( "EUsbPersonalityFinishStop" );

            delete iCurrentPersonalityHandler;

            iCurrentPersonalityHandler = NULL;

            //iAskOnConnectionSetting may be have been set to off

            if ( iDeviceState == EUsbDeviceStateUndefined )

                {

	            iPersonalityParams->PersonalityNotifier().CancelQuery(

	                    KCableConnectedNotifierUid );

                }

            User::RequestComplete( iRequestStatus, ret );

            iState = EUsbPersonalityIdle;

            break;

        case EUsbPersonalityStarted:

            // This must unload event. Let's complete.

            User::RequestComplete( iRequestStatus, ret );

            break;

        default:

            LOG( "ERROR: unexpected state" );

            PANIC( KErrGeneral );

            break;

        }

    }

// ----------------------------------------------------------------------------

// Standard active object cancellation function.

// ----------------------------------------------------------------------------

//

void CUsbActivePersonalityHandler::DoCancel()

    {

    LOG_FUNC

    LOG1( "CUsbActivePersonalityHandler::iState = %d", iState );

    switch( iState )

        {

        case EUsbPersonalityFinishStart:

            {

            TRequestStatus status;

            iUsbMan.TryStop( status );

            SetActive();

            User::WaitForRequest( status );

            }

            // Don't break. We need to cancel outstanding request.

        case EUsbPersonalityStarted:

        case EUsbPersonalityPrepareStop:

        case EUsbPersonalityFinishStop:

            if( iCurrentPersonalityHandler )

                {

                iCurrentPersonalityHandler->Cancel();

                }

            break;

        case EUsbPersonalityStopUsb:

            iUsbMan.CancelInterest( RUsb::ETryStop );

            break;

        case EUsbPersonalityStartUsb:

            iUsbMan.StartCancel();

            break;

        default:

            break;

        }

    if( iCurrentPersonalityHandler && ( iState != EUsbPersonalityStarted ) )

        {

        delete iCurrentPersonalityHandler;

        iCurrentPersonalityHandler = NULL;

        }

    // if started then this must unload confirmation

    if( iState != EUsbPersonalityStarted )

        {

        iState = EUsbPersonalityIdle;

        }

    // When cancel happens it means that we can cancel all queries & notes

    iPersonalityParams->PersonalityNotifier().CancelAll();

    User::RequestComplete( iRequestStatus, KErrCancel );

    }

// ----------------------------------------------------------------------------

// Creates and returns a class handler object for the given personality.

// ----------------------------------------------------------------------------

//

CUsbPersonality* CUsbActivePersonalityHandler::NewPersonalityHandlerL(

        TInt aPersonality )

    {

    LOG_FUNC

    TInt personalityCount = iOwner.Personalities().Count();

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

        {

        const TUsbSupportedPersonalityInf& pinf = iOwner.Personalities()[i];

        if( pinf.iPersonalityId == aPersonality )

            {

            iPersonalityParams->SetPersonalityId( aPersonality );

            CUsbPersonalityPlugin* plugin = CUsbPersonalityPlugin::NewL(

                    *iPersonalityParams, pinf.iPersonalityUid );

            iUseSerialNumber = pinf.iUseSerialNumber;

            return plugin;

            }

        }

    return NULL;

    }

// ----------------------------------------------------------------------------

// Publish serial number for USB Manager, if needed.

// ----------------------------------------------------------------------------

//

TInt CUsbActivePersonalityHandler::PublishSerialNumber()

    {

    LOG_FUNC

    TInt err = KErrNone;

    if( !iUseSerialNumber && iSerialNumberWritten )

        {

        // We are either in test mode or going to start up PC Suite

        // personality -> delete USB Manager's serial number P&S key

        // (if necessary)

        LOG( "Deleting published USB serial number" );

        err = RProperty::Delete( KUidSystemCategory, KUsbmanSvrUid.iUid );

        iSerialNumberWritten = EFalse;

        }

    else if( iUseSerialNumber && !iSerialNumberWritten )

        {

        // to finish, define and write the serial number P&S so that USB

        // Manager can fetch it

        _LIT_SECURITY_POLICY_PASS( KAPReadPolicy );

        _LIT_SECURITY_POLICY_PASS( KAPWritePolicy );