diff -r 000000000000 -r 4e1aa6a622a0 accessoryservices/pluggeddisplay/pluggeddisplayengine/inc/hdmicablestatusfsm.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/accessoryservices/pluggeddisplay/pluggeddisplayengine/inc/hdmicablestatusfsm.h Tue Feb 02 00:53:00 2010 +0200 @@ -0,0 +1,313 @@ +/* +* Copyright (c) 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: Finite State Machine class for HDMI Cable Status. +* +*/ + + + +#ifndef C_HDMICABLESTATUSFSM_H +#define C_HDMICABLESTATUSFSM_H + + + +#include "pdefsm.h" + + +class CTVOutConfigForHDMI; +class CEDIDHandler; +class CAccessoryControlIf; +class CPDEngine; + + + +/** + * Finite State Machine class for HDMI Cable Status. + * + * @code + * ?good_class_usage_example(s) + * @endcode + * + * @lib none. + * @since TB 9.2 + */ +NONSHARABLE_CLASS( CHDMICableStatusFSM ): public CBase, public MPdeFSM, public MFSMForState + { + +public: + + /** + * Two-phased constructor. + * @param aAccessoryServer Accessory Server. + */ + static CHDMICableStatusFSM* NewL( + RAccessoryServer& aAccessoryServer, CPDEngine *aPdEngine ); + + + /** + * Destructor. + */ + virtual ~CHDMICableStatusFSM(); + +public: // New methods + + + /** + * This called after copy protection status change is done/tried + * in TV Out Configuration interface. + * + * @since TB 9.2 + * @param aError Symbian error code. + * @param aCurrentStatus Current status after setting (trial). + * @return void. + */ + void CopyProtectionSettingDone( + TInt aError = KErrNone, + TBool aCurrentStatus = EFalse ); + + /** + * This called after copy protection status change is notified + * from TV Out Configuration interface. + * + * @since TB 9.2 + * @param aNewStatus New Copy Protection status. + * @return void. + */ + void CopyProtectionStatusChanged( TBool aNewStatus ); + + /** + * This called after copy protection status listening has failed + * in TV Out Configuration interface. + * + * @since TB 9.2 + * @param aError Symbian error code. + * @return void. + */ + void CopyProtectionListenFailed( TInt aError ); + + /** + * This called after current copy protection status is read from + * TV OU Config interface. + * + * @since TB 9.2 + * @param aCopyProtectionStatus Current status. + * @return void. + */ + void CopyProtectionStatusGot( TBool aCopyProtectionStatus ); + + /** + * This called after setting change is notified + * from TV Out Configuration interface. + * + * @since TB 9.2 + * @param None. + * @return void. + */ + void SettingsChangedL(); + + + // from base class MPdeFSM + + + /** + * Process a command received from the Accessory FW. + * Process command handled will be replied through the MPDAsyCmdHandler + * interface when the command is fully handled. + * + * @since TB9.2 + * @param aCommand Command to be processed. + * @param aCmdParams Command parameters. + * @param aAsyCmdHandler Call back interface to process command response. + * @return TBool ETrue if command belonged to called FSM. + */ + virtual TBool ProcessCommandL( const TProcessCmdId aCommand, + const TASYCmdParams& aCmdParams, + MPDAsyCmdHandler& aAsyCmdHandler ); + + /** + * Get the Generic ID of connected accessory. + * + * @since TB9.2 + * @param aAccPolGenericID Object where to copy actual values. + * @return Error code. KErrNotFound if don't exist. + */ + virtual TInt GetAccPolGenericID( TAccPolGenericID& aAccPolGenericID ); + + +// from base class MFSMForBody + + + /** + * From MFSMForBody. + * Function is called by host object to indicate that FSM can proceed to + * initial state and make necessary initialization actions. + * + * @since TB 9.2 + * @param none. + * @return void. + */ + virtual void Start(); + + /** + * Get the FSM's Id. + * + * @since TB 9.2 + * @param none. + * @return TFSMId FSM identification. + */ + virtual TFSMId FSMID(); + + /** + * From MFSMForBody. + * Get the id of current state. + * + * @since TB 9.2 + * @param none. + * @return TFSMState Current state identification. + */ + virtual TFSMState CurrentStateID(); + + /** + * From MFSMForBody. + * Function is called whenever an event that might have impact + * on the state machine occurs. + * + * @since TB 9.2 + * @param aInterfaceId Interface identification. + * @param aEvent Event identification. + * @return none. + */ + virtual void Input( + TFSMInterfaceId aInterfaceId , + TFSMEventId aEvent ); + + /** + * From MFSMForBody. + * Get the pointer of current state object. + * + * @since TB 9.2 + * @param none. + * @return MFSMState* Current state's interface pointer. + */ + virtual MFSMState* CurrentState(); + + /** + * From MFSMForBody. + * Get the name of current state. + * + * @since TB 9.2 + * @param none. + * @return TPtrC Name of the current state. + */ + virtual TPtrC CurrentStateName(); + + /** + * Get the ids of current main and substate id. + * + * @since TB 9.2 + * @param none. + * @return TFSMMainAndSubState Current main- and substate ids. + * Substate id is zero if current state havent any substates. + */ + virtual TFSMMainAndSubState CurrentMainAndSubstateIDs(); + +// from base class MFSMForState + + /** + * From MFSMForState. + * Function is called by current state to indicate that FSM has to change + * its state. Pervious state has performed necessary exit actions if any. + * + * @since TB 9.2 + * @param aNextState Next state where to transit. + * @return TBool True is transition valid. False if nextstate value invalid. + */ + virtual TBool Transit( TFSMState aNextState ); + + CPDEngine * GetPDEngine() { return iPdEngine; } + +protected: + + +private: + + /** + * C++ default constructor. + */ + CHDMICableStatusFSM(); + + /** + * By default Symbian OS constructor is private. + * @param aAccessoryServer Accessory Server. + */ + void ConstructL( + RAccessoryServer& aAccessoryServer, CPDEngine *aPdEngine ); + + /** + * Initialize the Standby Figure settings + * + * @param None + * @return None + */ + void SetStandbyFiguresSettingsL(); + +private: // data + + /** + * An array for state object pointers. + * Own + */ + MFSMState* iStateArray[ EHDMICableStateNbrOfUsedStates ]; + + /** + * Identification of the current state. Used to point the + * corresponding state object in the above array. + * 0 <= a valid state id =< EHDMICableStateMaxValue + */ + TFSMState iCurrentStateId; + + /** + * TV Out Configuration's Listener. + * Own + */ + CTVOutConfigForHDMI* iTVOutConfigForHDMI; + + /** + * EDID data Handler. + * Own + */ + CEDIDHandler* iEDIDHandler; + + /** + * Accessory Control Interface. + * Own + */ + CAccessoryControlIf* iAccessoryControlIf; + + /** + * ASY Command Handler pointer. + * Not own + */ + MPDAsyCmdHandler* iAsyCmdHandler; + + /** + * Plugged Display Engine pointer. + * Not own + */ + CPDEngine *iPdEngine; + + }; + + +#endif // C_HDMICABLESTATUSFSM_H