/*
* 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