// Copyright (c) 1999-2009 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members

// which accompanies this distribution, and is available

// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".

//

// Initial Contributors:

// Nokia Corporation - initial contribution.

//

// Contributors:

//

// Description:

//

#ifndef __ASALTDEFS_H__

#define __ASALTDEFS_H__

/** @file

@publishedAll

@released

*/

// System includes

#include <e32std.h>

#include <babitflags.h>

/** 

 Flags used to indicate the States for enum TASAltStateFlags

 */

typedef TBitFlags TASAltClientServerStateFlags;

/** 

 Major Version used while connecting to the Alarm Alert Server

 */

const TInt KASAltVersionMajor = 3;

/** 

 Minor Version used while connecting to the Alarm Alert Server

 */

const TInt KASAltVersionMinor = 0;

/** 

 Build Version used while connecting to the Alarm Alert Server

 */

const TInt KASAltVersionBuild = 0;

/** 

 Number of message Slots

 */

const TInt KAlmMessageSlots	= 5;

/** 

 The individual op codes which the Alert Server and Alarm Server

 handshake using

 */

enum TASAltOpCode

    {

	/**

	 Notify the alarm server (asynchronously) when the Alert Server

	 wishes to perform some action.

	 */

    EASAltOpCodeNotify = 0,

	/**

	 Cancel an earlier notification

	 */

    EASAltOpCodeNotifyCancel,

	/**

	 Change the visibility of the Alert Server UI furniture

	 */

	EASAltOpCodeVisible,

	/**

	 Update the Alert Server flags

	 */

    EASAltOpCodeSetState,

	/**

	 Inform the Alert Server of the currently notifying alarm

	 */

    EASAltOpCodeSetAlarm,

	/**

	 Inform the Alert Server that the currently alerting alarm

	 has been snoozed.

	 */

	EASAltOpCodeSetDeferTime,

	/**

	 Retrieve the time from the Alert Server when a quiet period 

	 should be terminated

	 */

	EASAltOpCodeGetUserTime,

	/**

	 Create an outstanding request with the Alert Server. Used

	 as a mechanism to obtain Alert Server thread death notifications.

	 */

	EASAltOpCodeLogon,

	/**

	 Ask the Alert Server to start playing the specified alarm sound

	 */

	EASAltOpCodeStartPlayingSound,

	/**

	 Ask the Alert Server to stop playing any sound

	 */

	EASAltOpCodeStopPlayingSound

	/**

	Ask the  Alert Server to change vissibility for all alarms

	*/

	, EASAltOpCodeVisibleAll,

	/**

	Ask the  Alert Server to update states for all alarms

	*/

	EASAltOpCodeSetStateAll,

	/**

	Ask the  Alert Server to stop playing all sounds.

	*/

	EASAltOpCodeStopPlayingSoundAll,

	/**

	Ask the  Alert Server to delete alarm with provided Id

	*/

	EASAltOpCodeDeleteAlarm,

	/**

	 Retrieve the time from the Alert Server when a quiet period 

	 should be terminated

	 */

	EASAltOpCodeGetEndQuietTime,

	/**

	Ask the Alarm Server to get number of simultaneously supported alarms

	*/

	EASAltOpCodeGetMaxAlarms,

	/**

	Ask the  Alert Server to delete all alarms

	*/

	EASAltOpCodeDeleteAlarmAll,

	EASAltOpCodeLast

    };

/**

 All communication from the Alert Server to the Alarm Server

 occurs via a single outstanding TRequesStatus which is handled

 by the Alarm Server (as an active object). This enumeration

 describes the type of action that the Alarm Server should take in

 response to a request from the Alert Server.

 */

enum TASAltAlertServerResponse

	{

	/**

	 The Alert Server wishes the Alarm Server to

	 silence all alarms.

	 */

	EASAltAlertServerResponseSilence = 0,

	/**

	 The Alert Server wishes the Alarm Server to

	 enter a global quiet period.

	 */

	EASAltAlertServerResponseQuietPeriod,

	/**

	 The Alert Server wishes the Alarm Server to

	 acknowledge (clear) the currently notifying alarm.

	 */

	EASAltAlertServerResponseClear,

	/**

	 The Alert Server wishes the Alarm Server to

	 acknowledge (clear) the currently notifying alarm

	 and all others that are awaiting notification.

	 */

	EASAltAlertServerResponseClearAll,

	/**

	 The Alert Server wishes the Alarm Server to

	  snooze the currently notifying alarm.

	 */

	EASAltAlertServerResponseSnooze,

	/**

	 The Alert Server wishes the Alarm Server to

	 temporarily pause all sound (i.e stop sending sound

	 play events to the Alert Server).

	 */

	EASAltAlertServerResponsePauseSound

	};

/**

 Flags for TASAltClientServerStateFlags

 */

enum TASAltStateFlags

	{

	/**

	 The Alert Server should not play any sound

	 */

	EASAltStateFlagsSilentRunning = 1,

	/**

	 The Alarm Server is currently within a quiet period

	 */

	EASAltStateFlagsInQuietPeriod = 2,

	/**

	 The Alarm Server currently has more than one alarm

	 ready to notify.

	 */

	EASAltStateFlagsMoreThanOneDueAlarm	= 3,

	/**

	 There wasn't sufficient memory within the Alarm

	 Server to allocate room for a snoozed alarm. I'm

	 note convinced we need this anymore

	 */

	EASAltStateFlagsNoMemoryForSnoozeAlarm = 4,

	/**

	 There isn't any sound filename for the current

	 alarm.

	 */

	EASAltStateFlagsAlarmHasNoSoundFileName	= 5,

	/**

	 This isn't used by the Alert Server.

	 */

	EASAltStateFlagsSoundIsPaused = 6

	};

// Literal constants

_LIT(KAlarmAlertServerName, "!AlarmAlertServer");

#endif