usbmgmt/usbmgr/usbman/chargingplugin/public/CUsbBatteryChargingPlugin.h
author hgs
Thu, 16 Sep 2010 12:03:29 +0800
changeset 49 93c0009bd947
parent 0 c9bc50fca66e
permissions -rw-r--r--
201036_01

/*
* Copyright (c) 2008-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:
*
*/

/** @file
@internalComponent
*/

#ifndef USBBATTERYCHARGINGPLUGIN_H
#define USBBATTERYCHARGINGPLUGIN_H

#include <e32base.h>

#ifdef __CHARGING_PLUGIN_TEST_CODE__
#include <dummyldd.h>
#define __D32USBC_H__ // ensure that d32usbc is ignored
#define private protected
#else
#ifdef SYMBIAN_USB_BATTERYCHARGING_V1_1
#include <usb/d32usbc.h>
#else
#include <d32usbc.h>
#endif
#endif

#include <cusbmanextensionplugin.h>
#include <musbdevicenotify.h>
#ifdef SYMBIAN_USB_BATTERYCHARGING_V1_1
#include <musbchargingnotify.h>
#endif

#include "usbbatterycharging.h"
#include "devicestatetimer.h"
#include "motgobserver.h"
#include "usbchargingpublishedinfo.h"




class CUsbChargingReEnumerator;

// For host OTG enabled charging plug-in
#ifdef SYMBIAN_ENABLE_USB_OTG_HOST_PRIV
class CIdPinWatcher;
class COtgStateWatcher;
#endif

class CVBusWatcher;

enum TUsbBatteryChargingPanic
    {
    EUsbBatteryChargingPanicBadPluginState = 1,
    EUsbBatteryChargingPanicUnexpectedPluginState = 2,
    EUsbBatteryChargingPanicBadDeviceState = 3,
    EUsbBatteryChargingPanicBadOtgState = 4,
    EUsbBatteryChargingPanicBadVBusState = 5,
    EUsbBatteryChargingPanicBadCharingCurrentNegotiation = 6
    };

enum TUsbSpeedType
    {
    EUsbFullSpeed = 1,
    EUsbHighSpeed = 2   
    };

// For host OTG enabled charging plug-in
class MUsbBatteryChargingPluginInterface : public MUsbDeviceNotify,
#ifdef SYMBIAN_USB_BATTERYCHARGING_V1_1
    public MUsbChargingNotify,
#endif
    public MUsbChargingDeviceStateTimerObserver, public MOtgPropertiesObserver
    {
public:  // from MUsbDeviceNotify
    virtual void UsbServiceStateChange (TInt aLastError,
        TUsbServiceState aOldState, TUsbServiceState aNewState) = 0;
    virtual void UsbDeviceStateChange (TInt aLastError,
        TUsbDeviceState aOldState, TUsbDeviceState aNewState) = 0;
  
public: // from MUsbChargingDeviceStateTimerObserver
    virtual void DeviceStateTimeout() = 0;

public: // from MOtgPropertiesObserver
// For host OTG enabled charging plug-in
#ifdef SYMBIAN_ENABLE_USB_OTG_HOST_PRIV 
    virtual void MpsoIdPinStateChanged(TInt aValue) = 0;
    virtual void MpsoOtgStateChangedL(TUsbOtgState aNewState) = 0;
#endif    
    virtual void MpsoVBusStateChanged(TInt aNewState) = 0;
// From MUsbChargingNotify
#ifdef SYMBIAN_USB_BATTERYCHARGING_V1_1
    virtual void UsbChargingPortType(TUint aChargingPortType) = 0;
	virtual void PeerDeviceMaxPower(TUint aCurrent) = 0;
#endif
    };

class TUsbBatteryChargingPluginStateBase;
class TUsbBatteryChargingPluginStateIdle;
class TUsbBatteryChargingPluginStateNoValidCurrent;
class TUsbBatteryChargingPluginStateCurrentNegotiating;
class TUsbBatteryChargingPluginStateIdleNegotiated;
class TUsbBatteryChargingPluginStateBEndedCableNotPresent;


enum TUsbChargingPluginState
    {
    // The default first state of this plugin
    EPluginStateIdle = 0,
    
    // Start to negotiate with A device about the charging current
    // re-enumration is executed 
    EPluginStateCurrentNegotiating,
    
    // Negotiation failed
    EPluginStateNoValidCurrent,
      
    // charging is stopped for some reason, but negotiation is done already
    EPluginStateIdleNegotiated,
    
    // Deivce is connect with A end cable, so, no way to do a charging to itself 
    EPluginStateBEndedCableNotPresent,
        
    // State counter
    EPluginStateCount
    };


class CUsbBatteryChargingPlugin : public CUsbmanExtensionPlugin,
    private MUsbBatteryChargingPluginInterface 
    {
    friend class TUsbBatteryChargingPluginStateBase;
    friend class TUsbBatteryChargingPluginStateIdle;
    friend class TUsbBatteryChargingPluginStateNoValidCurrent;
    friend class TUsbBatteryChargingPluginStateCurrentNegotiating;
    friend class TUsbBatteryChargingPluginStateIdleNegotiated;
    friend class TUsbBatteryChargingPluginStateBEndedCableNotPresent;
    
public:
    static CUsbBatteryChargingPlugin* NewL(MUsbmanExtensionPluginObserver& aObserver);
    ~CUsbBatteryChargingPlugin();

private: // from CUsbmanExtensionPlugin
    TAny* GetInterface(TUid aUid);
    
private:  // from MUsbBatteryChargingPluginInterface
    // from MUsbDeviceNotify
    void UsbServiceStateChange (TInt aLastError,
        TUsbServiceState aOldState, TUsbServiceState aNewState);
    void UsbDeviceStateChange (TInt aLastError,
        TUsbDeviceState aOldState, TUsbDeviceState aNewState);
  
    // from MUsbChargingDeviceStateTimerObserver
    void DeviceStateTimeout();

// For host OTG enabled charging plug-in
#ifdef SYMBIAN_ENABLE_USB_OTG_HOST_PRIV 
    // from MOtgPropertiesObserver
    void MpsoIdPinStateChanged(TInt aValue);
    void MpsoOtgStateChangedL(TUsbOtgState aNewState);
#endif
    
    void MpsoVBusStateChanged(TInt aNewState);

    // from MUsbChargingNotify
#ifdef SYMBIAN_USB_BATTERYCHARGING_V1_1    
    void UsbChargingPortType(TUint aChargingPortType);
	void PeerDeviceMaxPower(TUint aCurrent);
#endif

    void ResetFromChargingPossible();
    const TDesC8* ChargingTypeToString(TUint aChargingType);
private:
    CUsbBatteryChargingPlugin(MUsbmanExtensionPluginObserver& aObserver);
    void ConstructL();
    void Panic(TUsbBatteryChargingPanic aPanic);

private:
   
    void ReadCurrentRequestValuesL();
    void NegotiateChargingCurrent();
    void NegotiateNextCurrentValueL();
    void RequestCurrentL(TUint aMilliAmps);
    
    void ResetPlugin();
            
    void SetInitialConfigurationL();
    
    TBool IsUsbChargingPossible();
    
    void LogStateText(TUsbDeviceState aState);
   
    TUsbChargingPluginState SetState(TUsbChargingPluginState aState);
	void PublishChargingInfo();
	void UpdateChargingInfo();
	void QueryCurrentSpeed();
    
private: // owned
    RDevUsbcClient& iLdd;
         
    // More than one value will be tried by the negotiation process to 
    // aquire a as larger current value as possible for charging
    RArray<TInt> iCurrentValues;
    
    //value of requested current set to descriptor for negotiation
    TInt iRequestedCurrentValue;
    
    //index of requested value
    TInt iCurrentIndexRequested;
    
    //value of negotiated current
    TInt iAvailableMilliAmps; 

	//when ACARIDA, max power in B device's configuration
	TInt iBDevMaxPower;

    CUsbChargingDeviceStateTimer*   iDeviceStateTimer;
    CUsbChargingReEnumerator*       iDeviceReEnumerator;

// For host OTG enabled charging plug-in
#ifdef SYMBIAN_ENABLE_USB_OTG_HOST_PRIV     
    //Outer state watchers
    COtgStateWatcher *iOtgStateWatcher;
    CIdPinWatcher *iIdPinWatcher;
    //Outer states
    TInt iIdPinState;
    TUsbOtgState iOtgState;
#endif    
    
    TInt iVBusState;
    CVBusWatcher *iVBusWatcher;
    TUsbDeviceState iDeviceState;
    
    // Plug-in States
    TUsbChargingPluginState iPluginState; // Current state machine status
    TUsbBatteryChargingPluginStateBase* iCurrentState; // Owned
    TUsbBatteryChargingPluginStateBase* iPluginStates[EPluginStateCount]; // State implementations

    TUsbSpeedType iUsbSpeedType;
#ifdef SYMBIAN_USB_BATTERYCHARGING_V1_1		
    TUsbcChargerDetectorProperties iChargerDetectotCaps;
#endif
    TPckgBuf<TPublishedUsbChargingInfo> iChargingInfo;
    TPublishedUsbChargingInfo iLastPublishedInfo;
    };

#endif // USBBATTERYCHARGINGPLUGIN_H