sl@0: // Copyright (c) 2005-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: //
sl@0: 
sl@0: #include <ecam.h>
sl@0: #include <ecam/ecamplugin.h>
sl@0: #include <ecam/ecaminfoplugin.h>
sl@0: #include "ecamversion.h"
sl@0: #include <mm/mmpluginutils.h>
sl@0: 
sl@0: #ifdef SYMBIAN_ENABLE_SPLIT_HEADERS
sl@0: #include <ecamuidsdef.hrh>
sl@0: #include <ecamconst.h>
sl@0: #endif
sl@0: _LIT(KECamImplFaulty,"FaultyECamImpl");
sl@0: const TUint KPanicECamWrongEventClassUsed = 1;
sl@0: 
sl@0: const TInt KCameraIndex0 = 0;
sl@0: const TInt KCameraIndex1 = 1;
sl@0: const TInt KCameraIndex2 = 2;
sl@0: const TInt KCameraIndex3 = 3;
sl@0: const TInt KCameraIndex4 = 4;
sl@0: const TInt KCameraIndex5 = 5;
sl@0: const TInt KCameraIndex6 = 6;
sl@0: const TInt KCameraIndex7 = 7;
sl@0: 
sl@0: EXPORT_C TECAMEvent::TECAMEvent(TUid aEventType, TInt aErrorCode)
sl@0: : iEventType(aEventType), iErrorCode(aErrorCode)
sl@0: 	{
sl@0: 	}
sl@0: 
sl@0: EXPORT_C TECAMEvent::TECAMEvent()
sl@0: 	{
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: This method may be used by MCameraObserver2::HandleEvent to know whether a particular event received 
sl@0: has been encapsulated in a correct version of TECAMEvent base class. 
sl@0: Indirectly, its provided implementation also specifies different events which are supposed to use a specific version
sl@0: of TECAMEvent base class.
sl@0: This static method will be provided per derived version of TECAMEvent base class. So, MCameraObserver2::HandleEvent 
sl@0: implementation may consist of 2 parts: 
sl@0: 1) Recognize the class which encapsulated the event(aECAMEvent) and type-cast to that class.
sl@0: 2) Recognize the event.
sl@0: 
sl@0: Note : MCameraObserver2::HandleEvent should ignore unrecognised events and unrecognized version of TECAMEvent base 
sl@0: class. Unless clearly stated to use a particular derived version of TECAMEvent base class, events should use 
sl@0: class TECAMEvent.
sl@0: 	
sl@0: @param  aECAMEvent
sl@0: 	    TECAMEvent class reference providing details of a particular event
sl@0: 
sl@0: @return ETrue : This implies that the received event is recognized and belongs to this class. 
sl@0: 		MCameraObserver2::HandleEvent implementation may type-cast the aECAMEvent to TECAMEvent2 and proceed.
sl@0: 		EFalse : This is not an error condition. This implies that the event does not belong to this class. If event 
sl@0: 		is a known event, this may belong to the base class or to some other version of base class.  
sl@0: 		MCameraObserver2::HandleEvent implementation may call any other such methods existing for different derived versions 
sl@0: 		of TECAMEvent base class untill ETrue is retrieved.
sl@0: 		If EFalse is retrieved in each of such methods, implementation may type-cast the aECAMEvent to 
sl@0: 		the base class and proceed further to recognise the event. This implies that:-
sl@0: 		1) the given event is unrecognised and belong to base class or any derived class or an unrecognised derived class.
sl@0: 		2) the given event is recognised and belong to base class. 
sl@0: 						
sl@0: */
sl@0: EXPORT_C TBool TECAMEvent2::IsEventEncapsulationValid(const TECAMEvent& aECAMEvent)
sl@0: 	{
sl@0: 	/*
sl@0: 	checks whether the event type being represented by aECAMEvent belongs to this class or not.
sl@0: 	*/
sl@0: 	
sl@0: 	if(aECAMEvent.iEventType.iUid <= KECamUidEvent2RangeEnd && aECAMEvent.iEventType.iUid >= KECamUidEvent2RangeBegin)
sl@0: 		{
sl@0: 		TECAMEvent2 ecamEvent = static_cast<const TECAMEvent2&>(aECAMEvent);
sl@0: 			
sl@0: 		/*
sl@0: 		event type is being correctly represented only if its class uid 
sl@0: 		matches with uid used for class TECAMEvent2
sl@0: 		*/
sl@0: 		if (ecamEvent.EventClassUsed().iUid == KUidECamEventClass2UidValue)
sl@0: 			{
sl@0: 			return ETrue;
sl@0: 			}
sl@0: 		/*
sl@0: 		event type is not being correctly represented only if its class uid does not
sl@0: 		match with uid used for class TECAMEvent2. Faulty ECam Implementation
sl@0: 		*/
sl@0: 		else
sl@0: 			{
sl@0: 			User::Panic(KECamImplFaulty, KPanicECamWrongEventClassUsed);
sl@0: 			}
sl@0: 		}
sl@0: 			
sl@0: 	switch(aECAMEvent.iEventType.iUid)
sl@0: 		{
sl@0: 		//fall through
sl@0: 		case KUidECamEventCameraSettingPreCaptureWarningUidValue:
sl@0: 		case KUidECamEventCIPSetColorSwapEntryUidValue:
sl@0: 		case KUidECamEventCIPRemoveColorSwapEntryUidValue:
sl@0: 		case KUidECamEventCIPSetColorAccentEntryUidValue:
sl@0: 		case KUidECamEventCIPRemoveColorAccentEntryUidValue:
sl@0: 		/*
sl@0: 		event type belongs to this class
sl@0: 		*/
sl@0: 			{
sl@0: 			TECAMEvent2 ecamEvent = static_cast<const TECAMEvent2&>(aECAMEvent);
sl@0: 			
sl@0: 			/*
sl@0: 			event type is being correctly represented only if its class uid 
sl@0: 			matches with uid used for class TECAMEvent2
sl@0: 			*/
sl@0: 			if (ecamEvent.EventClassUsed().iUid == KUidECamEventClass2UidValue)
sl@0: 				{
sl@0: 				return ETrue;
sl@0: 				}
sl@0: 			/*
sl@0: 			event type is not being correctly represented only if its class uid does not
sl@0: 			match with uid used for class TECAMEvent2. Faulty ECam Implementation
sl@0: 			*/
sl@0: 			else
sl@0: 				{
sl@0: 				User::Panic(KECamImplFaulty, KPanicECamWrongEventClassUsed);
sl@0: 				}
sl@0: 			}
sl@0: 		
sl@0: 		default: 
sl@0: 			/*
sl@0: 			Ignore if event type does not belong to this class
sl@0: 			*/
sl@0: 			return EFalse;
sl@0: 		}
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Constructor.
sl@0: 
sl@0: @param  aEventType
sl@0:         A UID to define the type of event.
sl@0:         
sl@0: @param  aErrorCode
sl@0:         The error code associated with the event.
sl@0: 
sl@0: @param  aParam
sl@0: 		This signifies different things for different valid events.
sl@0: 		
sl@0: 		For example: 
sl@0: 		For KUidECamEventCIPSetColorSwapEntry; KUidECamEventCIPRemoveColorSwapEntry; KUidECamEventCIPSetColorAccentEntry
sl@0: 		and KUidECamEventCIPRemoveColorAccentEntry, aParam represents color entry.
sl@0: 		
sl@0: 		For KUidECamEventCameraSettingPreCaptureWarning, aParam represents bit field describing all PreCaptureWarnings currently issued.
sl@0: 		
sl@0: 		Future events may also use this class.
sl@0: */
sl@0: EXPORT_C TECAMEvent2::TECAMEvent2(TUid aEventType, TInt aErrorCode, TInt aParam)
sl@0: : TECAMEvent(aEventType, aErrorCode), iEventClassUsed(KUidECamEventClass2), iParam(aParam)
sl@0: 	{	
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Gives the uid representing this version of TECAMEvent base class.
sl@0: 
sl@0: @return Uid representing this version of TECAMEvent base class. Uid used is KUidECamEventClass2.
sl@0: */
sl@0: EXPORT_C const TUid& TECAMEvent2::EventClassUsed() const
sl@0: 	{
sl@0: 	return iEventClassUsed;
sl@0: 	}
sl@0:   	
sl@0: 
sl@0: EXPORT_C TInt CCamera::CamerasAvailable()
sl@0: 	{
sl@0: 	return CCameraPlugin::CamerasAvailable();
sl@0: 	}
sl@0: 
sl@0: 
sl@0: EXPORT_C CCamera* CCamera::NewL(MCameraObserver2& aObserver,TInt aCameraIndex,TInt aPriority)
sl@0: 	{
sl@0: 	return CCameraPlugin::NewL(aObserver, aCameraIndex, aPriority, KCameraDefaultVersion);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C CCamera* CCamera::NewDuplicateL(MCameraObserver2& aObserver,TInt aCameraHandle)
sl@0: 	{
sl@0: 	return CCameraPlugin::NewDuplicateL(aObserver, aCameraHandle, KCameraDefaultVersion);
sl@0: 	}
sl@0: 
sl@0: 
sl@0: EXPORT_C CCamera* CCamera::NewL(MCameraObserver& aObserver,TInt aCameraIndex)
sl@0: 	{
sl@0: 	return CCameraPlugin::NewL(aObserver, aCameraIndex, KCameraDefaultVersion);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C CCamera* CCamera::NewDuplicateL(MCameraObserver& aObserver,TInt aCameraHandle)
sl@0: 	{
sl@0: 	return CCameraPlugin::NewDuplicateL(aObserver, aCameraHandle, KCameraDefaultVersion);
sl@0: 	}
sl@0: 	
sl@0: EXPORT_C CCamera* CCamera::New2L(MCameraObserver2& aObserver,TInt aCameraIndex,TInt aPriority)
sl@0: 	{
sl@0: 	return CCameraPlugin::NewL(aObserver, aCameraIndex, aPriority,KCameraFirstVersion);
sl@0: 	}
sl@0: 
sl@0: EXPORT_C CCamera* CCamera::NewDuplicate2L(MCameraObserver2& aObserver,TInt aCameraHandle)
sl@0: 	{
sl@0: 	return CCameraPlugin::NewDuplicateL(aObserver, aCameraHandle, KCameraFirstVersion);
sl@0: 	}
sl@0: 	
sl@0: EXPORT_C TInt CCamera::CameraVersion()
sl@0: 	{
sl@0: 	return((static_cast<CCameraPlugin*>(this))->CameraVersion());
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: @internalComponent
sl@0: 
sl@0: Used to create the CCameraStatusWatch class object. This is needed by the method TReservedInfo::SubscribeReserveInfoL
sl@0: in order to grab the reserve notification from the ECam implementation and hence further forward it to the observer
sl@0: MReserveObserver.
sl@0: 
sl@0: @param aReserveObserver
sl@0: 	   Reference to an observer.
sl@0: 
sl@0: @param aCameraIndex
sl@0: 	   The camera index for which the subscription is needed.
sl@0: 	   
sl@0: @param aSecureId
sl@0: 	   The secure ID of the process where serialized part of the ECam implementation runs.
sl@0: 
sl@0: @leave May leave with any error code
sl@0: */
sl@0: CCameraStatusWatch* CCameraStatusWatch::NewL(MReserveObserver& aReserveObserver, TInt aCameraIndex, TInt aSecureId)
sl@0: 	{
sl@0: 	CCameraStatusWatch* self = new(ELeave) CCameraStatusWatch(aReserveObserver, aCameraIndex, aSecureId);
sl@0: 	CleanupStack::PushL(self);
sl@0: 	self->ConstructL();
sl@0: 	CleanupStack::Pop();
sl@0: 	return self;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Destructor. 
sl@0: The destructor has to be called by the client when it does not need the desired reserve notifications any more.
sl@0: 
sl@0: @publishedPartner
sl@0: @prototype
sl@0: */
sl@0: EXPORT_C CCameraStatusWatch::~CCameraStatusWatch()
sl@0: 	{
sl@0: 	Cancel();
sl@0: 	iProperty.Close();
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Constructor
sl@0: */	
sl@0: CCameraStatusWatch::CCameraStatusWatch(MReserveObserver& aReserveObserver, TInt aCameraIndex, TInt aSecureId): 
sl@0: 																					   CActive(EPriorityHigh), 
sl@0: 																					   iReserveObserver(aReserveObserver),
sl@0: 																					   iCameraIndex(aCameraIndex),
sl@0: 																					   iSecureId(aSecureId)
sl@0: 	{
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Second Phase Constructor.
sl@0: Attaches to the Property as implied by the camera index, adds the active object to the active scheduler list and kicks
sl@0: off the	RunL.
sl@0: 
sl@0: @leave May leave with any error code
sl@0: 
sl@0: @note Serialized part of the ECam implementation is assumed to define the Properties and publish them whenever there is 
sl@0: 	  change in the reserve status.
sl@0: */
sl@0: void CCameraStatusWatch::ConstructL()
sl@0: 	{
sl@0: 	switch(iCameraIndex)
sl@0: 		{
sl@0: 		case KCameraIndex0:
sl@0: 			{
sl@0: 			User::LeaveIfError(iProperty.Attach(TUid::Uid(iSecureId), KUidECamPropertyCameraIndex0ReservedStatus));
sl@0: 			break;	
sl@0: 			}
sl@0: 		case KCameraIndex1:
sl@0: 			{
sl@0: 			User::LeaveIfError(iProperty.Attach(TUid::Uid(iSecureId), KUidECamPropertyCameraIndex1ReservedStatus));
sl@0: 			break;	
sl@0: 			}
sl@0: 		case KCameraIndex2:
sl@0: 			{
sl@0: 			User::LeaveIfError(iProperty.Attach(TUid::Uid(iSecureId), KUidECamPropertyCameraIndex2ReservedStatus));
sl@0: 			break;	
sl@0: 			}
sl@0: 		case KCameraIndex3:
sl@0: 			{
sl@0: 			User::LeaveIfError(iProperty.Attach(TUid::Uid(iSecureId), KUidECamPropertyCameraIndex3ReservedStatus));
sl@0: 			break;	
sl@0: 			}
sl@0: 		case KCameraIndex4:
sl@0: 			{
sl@0: 			User::LeaveIfError(iProperty.Attach(TUid::Uid(iSecureId), KUidECamPropertyCameraIndex4ReservedStatus));
sl@0: 			break;	
sl@0: 			}
sl@0: 		case KCameraIndex5:
sl@0: 			{
sl@0: 			User::LeaveIfError(iProperty.Attach(TUid::Uid(iSecureId), KUidECamPropertyCameraIndex5ReservedStatus));
sl@0: 			break;	
sl@0: 			}
sl@0: 		case KCameraIndex6:
sl@0: 			{
sl@0: 			User::LeaveIfError(iProperty.Attach(TUid::Uid(iSecureId), KUidECamPropertyCameraIndex6ReservedStatus));
sl@0: 			break;	
sl@0: 			}
sl@0: 		case KCameraIndex7:
sl@0: 			{
sl@0: 			User::LeaveIfError(iProperty.Attach(TUid::Uid(iSecureId), KUidECamPropertyCameraIndex7ReservedStatus));
sl@0: 			break;	
sl@0: 			}
sl@0: 		default:
sl@0: 			{
sl@0: 			User::Leave(KErrArgument);
sl@0: 			}
sl@0: 		}
sl@0: 
sl@0: 	CActiveScheduler::Add(this);
sl@0: 	
sl@0: 	iProperty.Subscribe(iStatus);
sl@0: 	SetActive();
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Re-issues the subscription notice. Checks the updated value of the Property and notifies the client via 
sl@0: MReserveObserver. 
sl@0: 
sl@0: @note Serialized part of the ECam implementation is assumed to define the Properties and publish them whenever there is 
sl@0: 	  change in the reserve status.
sl@0: */
sl@0: void CCameraStatusWatch::RunL()
sl@0: 	{
sl@0: 	TBool reserved;
sl@0: 	TInt error = iProperty.Get(reserved);
sl@0: 	
sl@0: 	TECamReserveStatus reserveStatus;
sl@0: 	if(error != KErrNone)
sl@0: 		{
sl@0: 		reserveStatus = ECameraStatusUnknown;
sl@0: 		}
sl@0: 	else
sl@0: 		{
sl@0: 		if(!reserved)
sl@0: 			{
sl@0: 			reserveStatus = ECameraUnReserved;
sl@0: 			}
sl@0: 		else
sl@0: 			{
sl@0: 			reserveStatus = ECameraReserved;
sl@0: 			}	
sl@0: 		}
sl@0: 	
sl@0: 	iReserveObserver.ReserveStatus(iCameraIndex, reserveStatus, error);
sl@0: 	
sl@0: 	if(error == KErrNone)
sl@0: 		{
sl@0: 		iProperty.Subscribe(iStatus);
sl@0: 		SetActive();
sl@0: 		}
sl@0: 	}	
sl@0: 
sl@0: /** 
sl@0: Cancels any outstanding subscription.
sl@0: */
sl@0: void CCameraStatusWatch::DoCancel()
sl@0: 	{
sl@0: 	iProperty.Cancel();
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Client uses it to subscribe for the reserve notification of particular camera. The notifications are send to the client
sl@0: through MReserveObserver callbacks. Should the client not wish to continue with the subscription, it is supposed
sl@0: to delete the CCameraStatusWatch class pointer passed to it. 
sl@0: 
sl@0: @param aReserveObserver
sl@0: 	   Reference to an observer
sl@0: 	   
sl@0: @param aCameraIndex
sl@0: 	   The index of the camera for which the subscription is to be done.
sl@0: 	   
sl@0: @param aCameraStatusWatch
sl@0: 	   Reference to the CCameraStatusWatch*. Client is supposed to delete the CCameraStatusWatch object once it does not wish to
sl@0: 	   further continue with the subscription.
sl@0: 	   
sl@0: @leave May leave with any error code.
sl@0: */
sl@0: EXPORT_C void TReservedInfo::SubscribeReserveInfoL(MReserveObserver& aReserveObserver, TInt aCameraIndex, CCameraStatusWatch*& aCameraStatusWatch)
sl@0: 	{
sl@0: 	// Get the MSecureIdPlugin 
sl@0: 	TUid interfaceUid = {KUidOnboardCameraSecureIdPlugin};
sl@0: 	TUid dtor;
sl@0: 	MSecureIdPlugin* secureIdInfo = 
sl@0: 		static_cast<MSecureIdPlugin*>
sl@0: 			(MmPluginUtils::CreateImplementationL(interfaceUid, dtor, KECamPluginMatchString, KRomOnlyResolverUid));
sl@0: 												  
sl@0: 	CleanupStack::PushL(secureIdInfo);
sl@0: 	
sl@0: 	//Retrieve the secure ID
sl@0: 	TInt secureId = 0;
sl@0: 	secureIdInfo->GetSecureIdL(secureId);
sl@0: 	
sl@0: 	secureIdInfo->Release();
sl@0: 	
sl@0: 	CleanupStack::Pop(secureIdInfo);
sl@0: 
sl@0: 	REComSession::DestroyedImplementation(dtor);
sl@0: 	REComSession::FinalClose(); // don't have to do this here, but might as well tidy up
sl@0: 	
sl@0: 	//create CCameraStatusWatch and kicks off RunL. This implies property attached and subscribed.
sl@0: 	CCameraStatusWatch* cameraStatusWatch = CCameraStatusWatch::NewL(aReserveObserver, aCameraIndex, secureId);
sl@0: 	aCameraStatusWatch = cameraStatusWatch;
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: Default Constructor
sl@0: */		
sl@0: EXPORT_C CCamera::CCamera()
sl@0: 	{	
sl@0: 	}