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

//

/**

 @file

 @publishedAll

 @released

*/

#ifndef __OBEXCONSTANTS_H

#define __OBEXCONSTANTS_H

#include <e32std.h>

#include <es_sock.h>

#include <ir_sock.h>

#include <bt_sock.h>

#include <obexpanics.h>

//common to request & resp digests

/** @internalComponent */

const TInt KChallResponseSize = 58;

/** @internalComponent */

const TInt KMinChallResponseSize = 18; //Nonce(16) + tag(1) + size(1)

/** @internalComponent */

const TInt KObexNonceSize = 16;

/** @internalComponent */

const TUint8 KObexRequireUID = 0x01;

//request or chall

/** @internalComponent */

const TUint KObexChallNonceTag = 0;

/** @internalComponent */

const TUint8 KObexChallOptionsTag = 0x01;

/** @internalComponent */

const TUint8 KObexChallRealmTag = 0x02;

/** @internalComponent */

const TInt KObexChallOptionSize = 1; //this can't be changed from one without making

/** @internalComponent */

const TUint KObexChallHeaderSize = 23; //assuming no Realm data

//response

/** @internalComponent */

const TUint KObexRespTag = 0;

/** @internalComponent */

const TInt KObexRespSize = 16;

/** @internalComponent */

const TUint8 KObexRespUserIDTag = 0x01;

/** @internalComponent */

const TUint8 KObexRespNonceTag = 0x02;

/** @internalComponent */

const TUint8 KObexHeaderTypeMask = 0xc0;

/** @internalComponent */

const TUint8 KObexHeaderTypeOffset = 6;

#ifdef _UNICODE

/** @internalComponent */

const TInt KUidOBEXTransportModule = 0x10003d56;

#else

/** @internalComponent */

const TInt KUidOBEXTransportModule = 0x1000169c;

#endif

/** @internalComponent */

const TInt KUsbIntStringDescLength = 30;

/** @internalComponent */

const TUint8 KFourByteTimeHeaderAddress = 0xc4;

// Header mask definitions.

// Old style accessor for which headers are present or

// should be sent by an object.  Now deprecated, use the

// header iterator instead.

/** @internalComponent */

const TUint16 KObexHdrName				= 0x0001;

/** @internalComponent */

const TUint16 KObexHdrType				= 0x0002;

/** @internalComponent */

const TUint16 KObexHdrLength			= 0x0004;

/** @internalComponent */

const TUint16 KObexHdrTime				= 0x0008;

/** @internalComponent */

const TUint16 KObexHdrDescription		= 0x0010;

/** @internalComponent */

const TUint16 KObexHdrTarget			= 0x0020;

/** @internalComponent */

const TUint16 KObexHdrConnectionID		= 0x0040;

/** @internalComponent */

const TUint16 KObexHdrBody				= 0x0080;

/** @internalComponent */

const TUint16 KObexHdrEndOfBody			= 0x0100;

/** @internalComponent */

const TUint16 KObexHdrHttp				= 0x0200;

/** @internalComponent */

const TUint16 KObexHdrAppParam			= 0x0400;

/** @internalComponent */

const TUint16 KObexHdrUserDefined		= 0x0800;

/** @internalComponent */

const TUint16 KObexHdrCount				= 0x1000;

/** @internalComponent */

const TUint16 KObexHdrCreatorID			= 0x2000;

/** @internalComponent */

const TUint16 KObexHdrWanUUID			= 0x4000;

/** @internalComponent */

const TUint16 KObexHdrObjectClass		= 0x8000;

/** @internalComponent */

const TUint8  KObexUserDefinedHdrAddrMin	 = 0x30; //start of user defined header address range

/** @internalComponent */

const TUint8  KObexUserDefinedHdrAddrMax	 = 0x3F; //end of user defined header address range

/** @internalComponent */

const TUint8 KObexVersion           	= 0x10;		///< Version 1.0 (still correct for Obex spec v 1.2)

/** @internalComponent */

const TUint8 KObexObjectFieldSize   	= 127;

/** @internalComponent */

const TUint8 KObexObjectDescriptionSize = 255;

// Extended errors for IrObex

/** Must not use as not in the allocated range */

const TInt KErrIrObexRespBase			= - 5500; 

/** Extended error for IrObex - No other infrared device found */

const TInt KErrIrObexClientNoDevicesFound = -5501;

/** Extended error for IrObex - Other IR device cannot handle IrObex */

const TInt KErrIrObexClientPeerDoesNotHaveObex = -5502;

/** Extended error for IrObex - Other IR device aborted the transfer */

const TInt KErrIrObexClientPutPeerAborted	= -5503;

/** Extended error for IrObex - Peer device aborted data transmission/obex sending */

const TInt KErrIrObexServerPutPeerAborted = -5507;

/** Extended error for IrObex - Cannot authorise the challenge so link dropped */

const TInt KErrIrObexConnectChallRejected = -5512;

// Other Obex errors defined in the system but no longer used

// Do not reuse the number!

// KErrIrObexClientPutPeerCannotHandleObject -5504

// KErrIrObexServerPutFileWriteError		-5509

// KErrIrObexClientFirstPutFailed			-5510

// KErrIrObexClientSubsequentPutFailed		-5511

/** Unexpected event for the given state */

const TInt KErrIrObexBadEvent = -5513;

/** Event occurred while Server is stopped */

const TInt KErrIrObexServerStopped = -5514;

/** Packet received while state machine is in a wait state */

const TInt KErrIrObexPacketDuringWait = -5515;

// There are other error codes defined at the end of this file,

// which are a direct mapping of specific Obex error codes and

// are returned by the client.

// Flags used by Connect

// ...None in OBEX 1.0

// Flags used by SetPath

/** @internalComponent */

const TUint8 KObexSetPathParent	= 0x01;

/**

Version number for TObexTransportInfo and derived classes.  

When iVersion is set to this value the following fields of TObexTransportInfo  

must be set:

iTransportName, 

iReceiveMtu

iTransmitMtu

The iVersion member variable must be set to this value. If in future any of the 

iFuture variables are used a new version constant will be created.

@see TObexTransportInfo

@publishedAll

@released

*/

const TInt KObexTransportInfoVersion0 = 0;	

/**

Default for the receive and transmit MTU sizes

Use this default value for setting the iReceiveMtu or iTransmitMtu in TObexTransportInfo

objects or derived classes.

@see TObexTransportInfo

@publishedAll

@released

*/

const TInt KObexDefaultMtuSize = 4000;

/**

Default value for the number of discovery slots to use.  Use this value as a default 

for iDiscoverySlots in TObexIrdaV2TransportInfo.  

@see TObexIrdaV2TransportInfo

@publishedAll

@released

*/

const TUint KObexIrdaDefaultDiscoverySlotsToUse = 1;

/**

Default value for the number of discovery attempts made.  Use this value as a default for iDiscoveryAttempts

in TObexIrdaV2TransportInfo.  

@see TObexIrdaV2TransportInfo

@publishedAll

@released

*/

const TUint KObexIrdaDefaultDiscoveryAttempts = 4;

// Constants used to define which transport Obex will run over.

// Used in TObexTransportInfo and TObexProtocolInfo's iTransport member.

/**

Protocol string when running over IrDA

@see TObexIrProtocolInfo

@see TObexTransportInfo

@publishedAll

@released

*/

_LIT(KObexIrTTPProtocol, "IrTinyTP");

/**

Protocol string when running over IrDA

Using this version indicates that the configuration object contains discovery parameters.

@see TObexIrProtocolInfo

@publishedAll

@released

*/

_LIT(KObexIrTTPProtocolV2, "IrTinyTP-V2");

/**

Protocol string when running over IrDA

Using this version indicates that the configuration object contains the device nickname.

@see TObexIrProtocolInfo

@publishedAll

@capability WriteDeviceData If the TObexIrV3TransportInfo is passed as the argument

                            to CObexServer::NewL or CObexClient::NewL and the associated 

                            name is valid.

@released

*/

_LIT(KObexIrTTPProtocolV3, "IrTinyTP-V3");

/**

Protocol string when running over Bluetooth

@see TObexBluetoothProtocolInfo

@see TObexTransportInfo

@publishedAll

@released

*/

_LIT(KObexRfcommProtocol, "RFCOMM");

/**

Protocol string when running over USB

@see TObexUsbProtocolInfo

@see TObexTransportInfo

@publishedAll

@released

*/

_LIT(KObexUsbProtocol, "USB");

/**

Place holder for...

protocol string that should be used 

if a Win32 emulator USB transport were 

to be created for testing.

@see TObexUsbProtocolInfo

@see TObexTransportInfo

@publishedAll

@released

*/

_LIT(KObexWin32UsbProtocol, "Win32Usb");

/**

Protocol string when running over USB using client driver extensions

@see TObexUsbProtocolInfoV2

@see TObexTransportInfo

@publishedAll

@released

*/

_LIT(KObexUsbProtocolV2, "USB-V2");

/** 

This class is derived for each underlying transport protocol OBEX 

runs over.

The iTransport member holds the unique name for the transport. For example for

infra-red (TinyTP) this is "IrTinyTP" or KObexIrTTPProtocol.

@see TObexIrProtocolInfo for running over TinyTP

@see TObexBluetoothProtocolInfo for running over Rfcomm

@see TObexUsbProtocolInfo for running over USB

@see TObexUsbProtocolInfoV2 for running over USB using client driver extensions

@see KObexIrTTPProtocol

@see KObexIrTTPProtocolV2

@see KObexRfcommProtocol

@see KObexUsbProtocol

@see KObexUsbProtocolV2

@publishedAll

@released

*/

NONSHARABLE_CLASS(TObexProtocolInfo)

	{

public:

	/** Holds the unique name for the transport. */

	TBuf<60> iTransport;

private:

	// This data padding has been added to help prevent future binary compatibility breaks	

	// Neither iPadding1 nor iPadding2 have been zero'd because they are currently not used

	TUint32     iPadding1; 

	TUint32     iPadding2; 		

	};

/** 

Used to describe IrDA specific protocol information

To access the default OBEX server, the IAS class value should be "OBEX"

and the IAS attribute name "IrDA:TinyTP:LsapSel". 

@publishedAll

@released

*/

NONSHARABLE_CLASS(TObexIrProtocolInfo) : public TObexProtocolInfo

	{

public:

	/** IrDA address information for this connection, as used in the IrDA sockets interface.

	Refer to the SDK for more information about this.

	Its main use is for setting the port that the local machine will listen on. */

	TIrdaSockAddr iAddr;

	/** The IAS class value that the OBEX session will register its listener port,

	or request remote port with. */

	TBuf8<KIASClassNameMax> iClassName;

	/** The IAS attribute value that the OBEX session will register its listener port,

	or request remote port with. */

	TBuf8<KIASAttributeNameMax> iAttributeName;

	/** The number of discovery slots to use. */

	TUint8 iDiscoverySlots;

	/** The number of discovery attempts to make. */

	TUint8 iDiscoveryAttempts;

private:

	// This data padding has been added to help prevent future binary compatibility breaks	

	// None of these padding variables have been zero'd because they are currently not used

	TUint16     iPadding1; 

	TUint32     iPadding2; 		

	TUint32     iPadding3; 

	TUint32     iPadding4; 	

	};

/** 

Used to describe Bluetooth specific protocol information

@publishedAll

@released

*/

NONSHARABLE_CLASS(TObexBluetoothProtocolInfo) : public TObexProtocolInfo

	{

public:

	/** 

	For OBEX servers:

	This defines the server channel on which the OBEX server listens 

	for connections. The server channel is set using SetPort on the 

	TRfcommSockAddr.

	Note:

	1) Unless the channel is defined as KRfcommPassiveAutoBind 

	it may be in use when the obex server attempts to 'bind' to it

	2) If the channel is defined as KRfcommPassiveAutoBind 

	then when the server is FIRST started it will attempt 

	to find a free RFComm channel. If this is successful 

	that free channel will be used as the server channel 

	for the life time of the obex server including

	when it is 'stopped' and re-'started'.

	3) When the obex server is stopped, and very

	briefly when a bluetooth connection comes down, the

	obex server releases its server channel. It is possible

	therefore that during this time another application might bind

	to it. This will cause an error when the obex server tries

	to re-bind.

	Also note that a Bluetooth OBEX server will itself set the Object Transfer

	bit in the Service Class as required by the Generic Object Exchange

	Profile so the user need not do this.	

	@see CObexServer

	For OBEX clients:

	This defines the server channel and the 

	device address to connect to. The server channel 

	and device address are set respectively using SetPort 

	and SetBTAddr on the TRfcommSockAddr.

	*/

	TRfcommSockAddr iAddr;

private:

	// This data padding has been added to help prevent future binary compatibility breaks	

	// Neither iPadding1 nor iPadding2 have been zero'd because they are currently not used

	TUint32     iPadding1; 

	TUint32     iPadding2; 	

	};

/** 

Used to describe USB specific protocol information

@publishedAll

@released

*/

NONSHARABLE_CLASS(TObexUsbProtocolInfo) : public TObexProtocolInfo

	{

public:

	/** Provides a string to be attached to the Obex function's Communication Class interface,

	which may be used to identify the Obex service. */

	TBuf16<KUsbIntStringDescLength> iInterfaceStringDescriptor;

	};

/** 

Used to set options used by the extended USB client driver for improved performance

@see TObexUsbProtocolInfo

@see RDevUsbcClient

@publishedAll

@released

*/

NONSHARABLE_CLASS(TObexUsbProtocolInfoV2) : public TObexUsbProtocolInfo

	{

public:

	/** Bitmap containing the bandwidth priorities to use on IN and OUT endpoints

	@see TUsbcBandwidthPriority

	*/

	TInt iBandwidthPriority;

	/** Specifies whether to use DMA on the bulk OUT endpoint */

	TBool iDmaOnOutEndpoint;

	/** Specifies whether to use DMA on the bulk IN endpoint */

	TBool iDmaOnInEndpoint;

private:

	// This data padding has been added to help prevent future binary compatibility breaks	

	// None of these padding variables have been zero'd because they are currently not used

	TUint32     iPadding1; 

	TUint32     iPadding2; 		

	TUint32     iPadding3; 

	TUint32     iPadding4; 	

	};

/**

Contains information about OBEX packet sizing policy, defining the

maximum buffer size for receive and transmit packets

*/

NONSHARABLE_CLASS(TObexProtocolPolicy)

	{

public:

	IMPORT_C TObexProtocolPolicy ();	// Sets version and default values

	IMPORT_C TInt SetReceiveMtu ( TUint16 aReceiveMtu );

	IMPORT_C TInt SetTransmitMtu ( TUint16 aTransmitMtu );

	IMPORT_C TUint16 Version () const;

	IMPORT_C TUint16 ReceiveMtu () const;

	IMPORT_C TUint16 TransmitMtu () const;

private:

	TUint16 iVersion;

	TUint16 iReceiveMtu;

	TUint16 iTransmitMtu;

	// This data padding has been added to help prevent future binary compatibility breaks	

	// None of these padding variables have been zero'd because they are currently not used

	TUint32     iPadding1; 

	TUint32     iPadding2; 		

	TUint32     iPadding3; 

	TUint32     iPadding4; 	

	};

struct TObexConnectionInfo;

/**

TObexConnectInfo