/*
* Copyright (c) 2007 - 2010 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:  Takes control over the EP0 vendor specific messages, and process requests
*
*/


#ifndef CUSBDEVCON_H
#define CUSBDEVCON_H

#include <e32std.h>
#include <e32base.h>
#include <d32usbc.h>
#include <usbman.h>
#include <usbwatcher.h>

class CUsbStateWatcher;     // watches device's USB states
class CStateMachine;        // state-machine
class CRequestsHandler;     // contains actual requests handlers

static const TUint KSetupPacketLength = 8; // 8 bytes, always
static const TUint KInactiveTimeForShutDown = 10000000; // microseconds

/**
 *  USB Device Controller
 *  Contains all needed subclasses, to 
 *  take control over EP0 vendor specific messages
 *  and processing requests
 *
 *
 *  @lib usbdevcon.lib
 *  @since S60 v.5.0 
 */
 
class CUsbDevCon : public CActive  
    {

public:
    
    /**
     * Two-phased constructor.
     *
     * @since S60 v.5.0
     * @return Constructed instance
     */ 
    static CUsbDevCon* NewL();
    
    /**
     * Two-phased constructor.
     *
     * @since S60 v.5.0
     * @return Constructed instance
     */ 
    static CUsbDevCon* NewLC();
    
    /**
    * Destructor.
    *
    * @since S60 v.5.0
    */
    virtual ~CUsbDevCon();
    
    /**
     * Performs action needed by specific usb state
     *
     * @since S60 v.5.0
     * @param aUsbState USB state
     */
    void ActAccordinglyToUsbStateL(TUsbcDeviceState aUsbState);
    
private:

    /**
     * Default construction
     *
     * @since S60 v.5.0
     */
    CUsbDevCon();
    
    /**
     * Two-phased constructor.
     *
     * @since S60 v.5.0
     */
    void ConstructL();
    
    /**
     * Take needed actions on starting services
     *
     * @since S60 v.5.0
     */
    void StartL();
    
    /**
     * Take needed actions on stopping services
     *
     * @since S60 v.5.0
     */
    void StopL();
    
    // from CActive
    
    /**
     * From CActive
     *
     */
    void RunL();
    
    /**
     * From CActive
     *
     */ 
   void DoCancel();
   
    /**
     * From CActive.
     *
     */ 
     TInt RunError( TInt /*aError*/ );

private: // data

    /**
     * USB state watcher
     * Own
     */
    CUsbStateWatcher* iUsbStateWatcher;

    /**
     * CStateMachine
     * Own
     */
    CStateMachine* iStateMachine;
    
    /**
     * Requests handler 
     * Own  
     */
    CRequestsHandler* iRequestsHandler;
    
    /**
     * USB client
     * Need to take control over EP0 
     * Also reference to it will be provided to handlers
     */
    RDevUsbcClient iLdd;
    
    /**
     * USB Watcher
     * Need to handle some requests (like GetPersonalities)
     * Reference to it will be provided to handlers
     */
    RUsbWatcher iUsbWatcher;
    
    /**
     * USB Manager
     * Need to handle some requests (like SetPersonality)
     * Reference to it will be provided to handlers
     */
    RUsb iUsbManager;
    
    /**
     * Previous USB state 
     */
    TInt iPrevUsbState;
    
    /**
     * Shuts down if USB inactive for specified period of time
     */
    RTimer iShutdownTimer;

    };

#endif // USBDEVCON_H