sl@0: // Copyright (c) 2007-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 the License "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: #ifndef D32USBDESCRIPTORS_H
sl@0: #define D32USBDESCRIPTORS_H
sl@0: 
sl@0: #include <e32base.h>
sl@0: 
sl@0: 
sl@0: /*****************************************************************************/
sl@0: /*                                                                           */
sl@0: /* USB descriptors parser framework                                          */
sl@0: /*                                                                           */
sl@0: /*****************************************************************************/
sl@0: 
sl@0: class TUsbGenericDescriptor;
sl@0: 
sl@0: /**
sl@0: The Symbian USB Descriptor Parsing Framework class.
sl@0: 
sl@0: This class is to aid users of USBDI by providing the facilities to parse the
sl@0: raw descriptor data into wrapper classes that allow access to the fields in 
sl@0: the descriptor bodies, and pointers to map the serial data blob into the tree 
sl@0: structure that descriptors logically have.
sl@0: 
sl@0: @publishedPartner Intended to be available to 3rd parties later
sl@0: @prototype
sl@0: */
sl@0: NONSHARABLE_CLASS(UsbDescriptorParser)
sl@0: 	{
sl@0: public:
sl@0: 	typedef TUsbGenericDescriptor* (*TUsbDescriptorParserL)(TPtrC8& aUsbDes, TUsbGenericDescriptor* aPreviousDesc);
sl@0: 
sl@0: public:
sl@0: 	// Main parse function.
sl@0: 	IMPORT_C static TInt Parse(const TDesC8& aUsbDes, TUsbGenericDescriptor*& aDesc);
sl@0: 
sl@0: 	// Custom parsing framework.
sl@0: 	IMPORT_C static void RegisterCustomParserL(TUsbDescriptorParserL aParserFunc);
sl@0: 	IMPORT_C static void UnregisterCustomParser(TUsbDescriptorParserL aParserFunc);
sl@0: 
sl@0: private:
sl@0: 	static TUsbGenericDescriptor* FindParserAndParseAndCheckL(TPtrC8& aUsbDes, TUsbGenericDescriptor* aPreviousDesc);
sl@0: 	static TUsbGenericDescriptor* FindParserAndParseL(TPtrC8& aUsbDes, TUsbGenericDescriptor* aPreviousDesc);
sl@0: 	static void ParseDescriptorTreeL(TPtrC8& aUsbDes, TUsbGenericDescriptor& aPreviousDesc);
sl@0: 	static void BuildTreeL(TUsbGenericDescriptor& aNewDesc, TUsbGenericDescriptor& aPreviousDesc);
sl@0: 	static TUsbGenericDescriptor& FindSuitableParentL(TUsbGenericDescriptor& aNewDesc, TUsbGenericDescriptor& aTopParent);
sl@0: 	static TUsbGenericDescriptor* UnknownUsbDescriptorParserL(TPtrC8& aUsbDes, TUsbGenericDescriptor* aPreviousDesc);
sl@0: 	};
sl@0: 
sl@0: 
sl@0: /*****************************************************************************/
sl@0: /*                                                                           */
sl@0: /* USB standard descriptors                                                  */
sl@0: /*                                                                           */
sl@0: /*****************************************************************************/
sl@0: 
sl@0: 
sl@0: /**
sl@0: Base class for USB descriptors.
sl@0: All USB descriptors contain type and length, and may have peers and children.
sl@0: 
sl@0: @publishedPartner Intended to be available to 3rd parties later
sl@0: @prototype
sl@0: */
sl@0: class TUsbGenericDescriptor
sl@0: 	{
sl@0: public:
sl@0: 	IMPORT_C TUsbGenericDescriptor();
sl@0: 	
sl@0: 	IMPORT_C void DestroyTree();
sl@0: 
sl@0: 	IMPORT_C TUint8 TUint8At(TInt aOffset) const;
sl@0: 	IMPORT_C TUint16 TUint16At(TInt aOffset) const;
sl@0: 	IMPORT_C TUint32 TUint32At(TInt aOffset) const;
sl@0: 
sl@0: 	IMPORT_C TUsbGenericDescriptor& operator=(const TUsbGenericDescriptor& aDescriptor);
sl@0: 
sl@0: 	/**
sl@0: 	Helper function to allow TUsbGenericDescriptor types to be placed on the cleanup stack.
sl@0: 	*/
sl@0: 	inline operator TCleanupItem() { return TCleanupItem(Cleanup,this); }
sl@0: 
sl@0: public:
sl@0: 	virtual TBool IsParent(TUsbGenericDescriptor& aPotentialParent);
sl@0: 	virtual TBool IsPeer(TUsbGenericDescriptor& aPotentialPeer);
sl@0: 	virtual TBool IsChild(TUsbGenericDescriptor& aPotentialChild);
sl@0: 
sl@0: private:
sl@0: 	IMPORT_C static void Cleanup(TAny* aPtr);
sl@0: 	static void WalkAndDelete(TUsbGenericDescriptor* aDesc);
sl@0: 
sl@0: public:		// USB standard fields
sl@0: 	/**
sl@0: 	The offset in a standard USB descriptor to the bLength field.
sl@0: 	*/
sl@0: 	static const TInt KbLengthOffset = 0;
sl@0: 
sl@0: 	/**
sl@0: 	The offset in a standard USB descriptor to the bDescriptorType field.
sl@0: 	*/
sl@0: 	static const TInt KbDescriptorTypeOffset = 1;
sl@0: 
sl@0: 	/**
sl@0: 	Standard Length field.
sl@0: 	*/
sl@0: 	TUint8	ibLength;
sl@0: 	
sl@0: 	/**
sl@0: 	Standard Type field.
sl@0: 	*/
sl@0: 	TUint8	ibDescriptorType;
sl@0: 	
sl@0: public:
sl@0: 	/**
sl@0: 	The flag to indicate whether the USB descriptor has been recognised
sl@0: 	and parsed.
sl@0: 	*/
sl@0: 	enum TUsbGenericDescriptorFlags
sl@0: 		{
sl@0: 		EUnrecognised = 0x00,
sl@0: 		ERecognised = 0x01,
sl@0: 		};
sl@0: 	
sl@0: public:		// Symbian generated fields
sl@0: 	/**
sl@0: 	Flag to show if the descriptor has been recognised and parsed, or if its data can only be represented as a
sl@0: 	binary blob.  This field should particularly be checked if writing code which may run on older versions of
sl@0: 	the operating system, where a (now) known descriptor may not have been parsed, or before parsing a new
sl@0: 	descriptor from a blob, where later versions of the operating system may have already extracted the fields.
sl@0: 	*/
sl@0: 	TUint8	iRecognisedAndParsed;
sl@0: 
sl@0: 	/**
sl@0: 	A pointer to the next peer of this descriptor, or NULL.
sl@0: 	As an example, an endpoint descriptor will contain pointers to any other endpoint descriptors on the same
sl@0: 	interface.
sl@0: 	*/
sl@0: 	TUsbGenericDescriptor* iNextPeer;
sl@0: 
sl@0: 	/**
sl@0: 	A pointer to the first child of this descriptor, or NULL.
sl@0: 	As an example, an interface descriptor will contain a pointer to the first endpoint descriptor on the
sl@0: 	interface. The iNextPeer member can then be used to examine other endpoints on the interface.
sl@0: 	*/
sl@0: 	TUsbGenericDescriptor* iFirstChild;
sl@0: 	
sl@0: 	/**
sl@0: 	A pointer to the parent to this descriptor, or NULL.
sl@0: 	As an example an endpoint descriptor from a configuration bundle will have the interface that it
sl@0: 	is a member of as it's parent.
sl@0: 	*/
sl@0: 	TUsbGenericDescriptor* iParent;
sl@0: 
sl@0: 	/**
sl@0: 	The binary blob that contains this descriptor
sl@0: 	*/
sl@0: 	TPtrC8			iBlob;
sl@0: 	};
sl@0: 
sl@0: enum TUsbDescriptorType
sl@0: 	{
sl@0: 	EDevice						= 1,
sl@0: 	EConfiguration				= 2,
sl@0: 	EString						= 3,
sl@0: 	EInterface					= 4,
sl@0: 	EEndpoint					= 5,
sl@0: 	EDeviceQualifier			= 6,
sl@0: 	EOtherSpeedConfiguration	= 7,
sl@0: 	EInterfacePower				= 8,
sl@0: 	EOTG						= 9,
sl@0: 	EDebug						= 10,
sl@0: 	EInterfaceAssociation		= 11,
sl@0: 	};
sl@0: 
sl@0: /**
sl@0: Device descriptor.
sl@0: 
sl@0: See section 9.6.1 of the USB 2.0 specification.
sl@0: 
sl@0: @publishedPartner Intended to be available to 3rd parties later
sl@0: @prototype
sl@0: */
sl@0: NONSHARABLE_CLASS(TUsbDeviceDescriptor) : public TUsbGenericDescriptor
sl@0: 	{
sl@0: public:
sl@0: 	IMPORT_C TUsbDeviceDescriptor();
sl@0: 	IMPORT_C static TUsbDeviceDescriptor* Cast(TUsbGenericDescriptor* aOriginal);
sl@0: 
sl@0: public:
sl@0: 	static const TInt KSizeInOctets = 18;
sl@0: 	enum TFieldOffsets
sl@0: 		{
sl@0: 		EbcdUSB				= 2,
sl@0: 		EbDeviceClass		= 4,
sl@0: 		EbDeviceSubClass	= 5,
sl@0: 		EbDeviceProtocol	= 6,
sl@0: 		EbMaxPacketSize0	= 7,
sl@0: 		EidVendor			= 8,
sl@0: 		EidProduct			= 10,
sl@0: 		EbcdDevice			= 12,
sl@0: 		EiManufacturer		= 14,
sl@0: 		EiProduct			= 15,
sl@0: 		EiSerialNumber		= 16,
sl@0: 		EbNumConfigurations	= 17
sl@0: 		};
sl@0: 
sl@0: public:
sl@0: 	IMPORT_C TUint16 USBBcd() const;
sl@0: 	IMPORT_C TUint8 DeviceClass() const;
sl@0: 	IMPORT_C TUint8 DeviceSubClass() const;
sl@0: 	IMPORT_C TUint8 DeviceProtocol() const;
sl@0: 	IMPORT_C TUint8 MaxPacketSize0() const;
sl@0: 	IMPORT_C TUint16 VendorId() const;
sl@0: 	IMPORT_C TUint16 ProductId() const;
sl@0: 	IMPORT_C TUint16 DeviceBcd() const;
sl@0: 	IMPORT_C TUint8 ManufacturerIndex() const;
sl@0: 	IMPORT_C TUint8 ProductIndex() const;
sl@0: 	IMPORT_C TUint8 SerialNumberIndex() const;
sl@0: 	IMPORT_C TUint8 NumConfigurations() const;
sl@0: 
sl@0: public:
sl@0: 	static TUsbDeviceDescriptor* ParseL(TPtrC8& aUsbDes, TUsbGenericDescriptor* aPreviousDesc);
sl@0: 	virtual TBool IsParent(TUsbGenericDescriptor& aPotentialParent);
sl@0: 	virtual TBool IsPeer(TUsbGenericDescriptor& aPotentialPeer);
sl@0: 	};
sl@0: 
sl@0: 
sl@0: /**
sl@0: Device Qualifier descriptor.
sl@0: 
sl@0: See section 9.6.2 of the USB 2.0 specification.
sl@0: 
sl@0: @publishedPartner Intended to be available to 3rd parties later
sl@0: @prototype
sl@0: */
sl@0: NONSHARABLE_CLASS(TUsbDeviceQualifierDescriptor) : public TUsbGenericDescriptor
sl@0: 	{
sl@0: public:
sl@0: 	IMPORT_C TUsbDeviceQualifierDescriptor();
sl@0: 	IMPORT_C static TUsbDeviceQualifierDescriptor* Cast(TUsbGenericDescriptor* aOriginal);
sl@0: 	
sl@0: public:
sl@0: 	static const TInt KSizeInOctets = 10;
sl@0: 	enum TFieldOffsets
sl@0: 		{
sl@0: 		EbcdUSB				= 2,
sl@0: 		EbDeviceClass		= 4,
sl@0: 		EbDeviceSubClass	= 5,
sl@0: 		EbDeviceProtocol	= 6,
sl@0: 		EbMaxPacketSize0	= 7,
sl@0: 		EbNumConfigurations	= 8,
sl@0: 		EbReserved			= 9
sl@0: 		};
sl@0: 
sl@0: public:
sl@0: 	IMPORT_C TUint16 USBBcd() const;
sl@0: 	IMPORT_C TUint8 DeviceClass() const;
sl@0: 	IMPORT_C TUint8 DeviceSubClass() const;
sl@0: 	IMPORT_C TUint8 DeviceProtocol() const;
sl@0: 	IMPORT_C TUint8 MaxPacketSize0() const;
sl@0: 	IMPORT_C TUint8 NumConfigurations() const;
sl@0: 	IMPORT_C TUint8 Reserved() const;
sl@0: 	
sl@0: public:
sl@0: 	static TUsbDeviceQualifierDescriptor* ParseL(TPtrC8& aUsbDes, TUsbGenericDescriptor* aPreviousDesc);
sl@0: 	virtual TBool IsParent(TUsbGenericDescriptor& aPotentialParent);
sl@0: 	virtual TBool IsPeer(TUsbGenericDescriptor& aPotentialPeer);
sl@0: 	};
sl@0: 
sl@0: 
sl@0: /**
sl@0: Configuration descriptor.
sl@0: 
sl@0: See section 9.6.3 of the USB 2.0 specification.
sl@0: 
sl@0: @publishedPartner Intended to be available to 3rd parties later
sl@0: @prototype
sl@0: */
sl@0: NONSHARABLE_CLASS(TUsbConfigurationDescriptor) : public TUsbGenericDescriptor
sl@0: 	{
sl@0: public:
sl@0: 	IMPORT_C TUsbConfigurationDescriptor();
sl@0: 	IMPORT_C static TUsbConfigurationDescriptor* Cast(TUsbGenericDescriptor* aOriginal);
sl@0: 
sl@0: public:
sl@0: 	static const TInt KSizeInOctets = 9;
sl@0: 	enum TFieldOffsets
sl@0: 		{
sl@0: 		EwTotalLength			= 2,
sl@0: 		EbNumInterfaces			= 4,
sl@0: 		EbConfigurationValue	= 5,
sl@0: 		EiConfiguration			= 6,
sl@0: 		EbmAttributes			= 7,
sl@0: 		EbMaxPower				= 8
sl@0: 		};
sl@0: 
sl@0: public:
sl@0: 	IMPORT_C TUint16 TotalLength() const;
sl@0: 	IMPORT_C TUint8 NumInterfaces() const;
sl@0: 	IMPORT_C TUint8 ConfigurationValue() const;
sl@0: 	IMPORT_C TUint8 ConfigurationIndex() const;
sl@0: 	IMPORT_C TUint8 Attributes() const;
sl@0: 	IMPORT_C TUint8 MaxPower() const;
sl@0: 
sl@0: public:
sl@0: 	static TUsbConfigurationDescriptor* ParseL(TPtrC8& aUsbDes, TUsbGenericDescriptor* aPreviousDesc);
sl@0: 	virtual TBool IsParent(TUsbGenericDescriptor& aPotentialParent);
sl@0: 	virtual TBool IsPeer(TUsbGenericDescriptor& aPotentialPeer);
sl@0: 	};
sl@0: 
sl@0: 
sl@0: /**
sl@0: Other Speed descriptor.
sl@0: 
sl@0: See section 9.6.4 of the USB 2.0 specification.
sl@0: 
sl@0: @publishedPartner Intended to be available to 3rd parties later
sl@0: @prototype
sl@0: */
sl@0: NONSHARABLE_CLASS(TUsbOtherSpeedDescriptor) : public TUsbGenericDescriptor
sl@0: 	{
sl@0: public:
sl@0: 	IMPORT_C TUsbOtherSpeedDescriptor();
sl@0: 	IMPORT_C static TUsbOtherSpeedDescriptor* Cast(TUsbGenericDescriptor* aOriginal);
sl@0: 
sl@0: public:
sl@0: 	static const TInt KSizeInOctets = 9;
sl@0: 	enum TFieldOffsets
sl@0: 		{
sl@0: 		EwTotalLength 			= 2,
sl@0: 		EbNumInterfaces			= 4,
sl@0: 		EbConfigurationValue	= 5,
sl@0: 		EiConfiguration			= 6,
sl@0: 		EbmAttributes			= 7,
sl@0: 		EbMaxPower				= 8
sl@0: 		};
sl@0: 
sl@0: public:
sl@0: 	IMPORT_C TUint16 TotalLength() const;
sl@0: 	IMPORT_C TUint8 NumInterfaces() const;
sl@0: 	IMPORT_C TUint8 ConfigurationValue() const;
sl@0: 	IMPORT_C TUint8 ConfigurationIndex() const;
sl@0: 	IMPORT_C TUint8 Attributes() const;
sl@0: 	IMPORT_C TUint8 MaxPower() const;
sl@0: 	
sl@0: public:
sl@0: 	static TUsbOtherSpeedDescriptor* ParseL(TPtrC8& aUsbDes, TUsbGenericDescriptor* aPreviousDesc);
sl@0: 	virtual TBool IsParent(TUsbGenericDescriptor& aPotentialParent);
sl@0: 	virtual TBool IsPeer(TUsbGenericDescriptor& aPotentialPeer);
sl@0: 	};
sl@0: 
sl@0: 
sl@0: /**
sl@0: Interface Association Descriptor
sl@0: 
sl@0: See the USB IAD ECN.
sl@0: 
sl@0: @publishedPartner Intended to be available to 3rd parties later
sl@0: @prototype
sl@0: */
sl@0: NONSHARABLE_CLASS(TUsbInterfaceAssociationDescriptor) : public TUsbGenericDescriptor
sl@0: 	{
sl@0: public:
sl@0: 	IMPORT_C TUsbInterfaceAssociationDescriptor();
sl@0: 	IMPORT_C static TUsbInterfaceAssociationDescriptor* Cast(TUsbGenericDescriptor* aOriginal);
sl@0: 
sl@0: public:
sl@0: 	static const TInt KSizeInOctets = 8;
sl@0: 	enum TFieldOffsets
sl@0: 		{
sl@0: 		EbFirstInterface	= 2,
sl@0: 		EbInterfaceCount	= 3,
sl@0: 		EbFunctionClass		= 4,
sl@0: 		EbFunctionSubClass	= 5,
sl@0: 		EbFunctionProtocol	= 6,
sl@0: 		EiFunction			= 7
sl@0: 		};
sl@0: 	
sl@0: public:
sl@0: 	IMPORT_C TUint8 FirstInterface() const;
sl@0: 	IMPORT_C TUint8 InterfaceCount() const;
sl@0: 	IMPORT_C TUint8 FunctionClass() const;
sl@0: 	IMPORT_C TUint8 FunctionSubClass() const;
sl@0: 	IMPORT_C TUint8 FunctionProtocol() const;
sl@0: 	IMPORT_C TUint8 FunctionIndex() const;
sl@0: 	
sl@0: public:
sl@0: 	static TUsbInterfaceAssociationDescriptor* ParseL(TPtrC8& aUsbDes, TUsbGenericDescriptor* aPreviousDesc);
sl@0: 	virtual TBool IsParent(TUsbGenericDescriptor& aPotentialParent);
sl@0: 	virtual TBool IsPeer(TUsbGenericDescriptor& aPotentialPeer);
sl@0: 	virtual TBool IsChild(TUsbGenericDescriptor& aPotentialChild);
sl@0: 	};
sl@0: 
sl@0: /**
sl@0: Interface descriptor.
sl@0: 
sl@0: See section 9.6.5 of the USB 2.0 specification.
sl@0: 
sl@0: @publishedPartner Intended to be available to 3rd parties later
sl@0: @prototype
sl@0: */
sl@0: NONSHARABLE_CLASS(TUsbInterfaceDescriptor) : public TUsbGenericDescriptor
sl@0: 	{
sl@0: public:
sl@0: 	IMPORT_C TUsbInterfaceDescriptor();
sl@0: 	IMPORT_C static TUsbInterfaceDescriptor* Cast(TUsbGenericDescriptor* aOriginal);
sl@0: 
sl@0: public:
sl@0: 	static const TInt KSizeInOctets = 9;
sl@0: 	enum TFieldOffsets
sl@0: 		{
sl@0: 		EbInterfaceNumber	= 2,
sl@0: 		EbAlternateSetting	= 3,
sl@0: 		EbNumEndpoints		= 4,
sl@0: 		EbInterfaceClass	= 5,
sl@0: 		EbInterfaceSubClass	= 6,
sl@0: 		EbInterfaceProtocol	= 7,
sl@0: 		EiInterface			= 8
sl@0: 		};
sl@0: 	
sl@0: public:
sl@0: 	IMPORT_C TUint8 InterfaceNumber() const;
sl@0: 	IMPORT_C TUint8 AlternateSetting() const;
sl@0: 	IMPORT_C TUint8 NumEndpoints() const;
sl@0: 	IMPORT_C TUint8 InterfaceClass() const;
sl@0: 	IMPORT_C TUint8 InterfaceSubClass() const;
sl@0: 	IMPORT_C TUint8 InterfaceProtocol() const;
sl@0: 	IMPORT_C TUint8 Interface() const;
sl@0: 	
sl@0: public:
sl@0: 	static TUsbInterfaceDescriptor* ParseL(TPtrC8& aUsbDes, TUsbGenericDescriptor* aPreviousDesc);
sl@0: 	virtual TBool IsParent(TUsbGenericDescriptor& aPotentialParent);
sl@0: 	virtual TBool IsPeer(TUsbGenericDescriptor& aPotentialPeer);
sl@0: 	};
sl@0: 
sl@0: /**
sl@0: Endpoint descriptor.
sl@0: 
sl@0: See section 9.6.6 of the USB 2.0 specification.
sl@0: Note these exclude support support for:
sl@0: 'Standard AC Interrupt Endpoint Descriptor'
sl@0: 'Standard AS Isochronous Synch Endpoint Descriptor'
sl@0: 'Standard AS Isochronous Audio Data Endpoint Descriptor'
sl@0: as defined in USB Audio Device Class Spec v1.0 which are all 9 bytes in size.
sl@0: To support these custom descriptors may be registered with the
sl@0: parser.
sl@0: 
sl@0: @publishedPartner Intended to be available to 3rd parties later
sl@0: @prototype
sl@0: */
sl@0: NONSHARABLE_CLASS(TUsbEndpointDescriptor) : public TUsbGenericDescriptor
sl@0: 	{
sl@0: public:
sl@0: 	IMPORT_C TUsbEndpointDescriptor();
sl@0: 	IMPORT_C static TUsbEndpointDescriptor* Cast(TUsbGenericDescriptor* aOriginal);
sl@0: 
sl@0: public:
sl@0: 	static const TInt KSizeInOctets = 7;
sl@0: 	enum TFieldOffsets
sl@0: 		{
sl@0: 		EbEndpointAddress	= 2,
sl@0: 		EbmAttributes		= 3,
sl@0: 		EwMaxPacketSize		= 4,
sl@0: 		EbInterval			= 6
sl@0: 		};
sl@0: 
sl@0: public:
sl@0: 	IMPORT_C TUint8 EndpointAddress() const;
sl@0: 	IMPORT_C TUint8 Attributes() const;
sl@0: 	IMPORT_C TUint16 MaxPacketSize() const;
sl@0: 	IMPORT_C TUint8 Interval() const;
sl@0: 	
sl@0: public:
sl@0: 	static TUsbEndpointDescriptor* ParseL(TPtrC8& aUsbDes, TUsbGenericDescriptor* aPreviousDesc);
sl@0: 	virtual TBool IsParent(TUsbGenericDescriptor& aPotentialParent);
sl@0: 	virtual TBool IsPeer(TUsbGenericDescriptor& aPotentialPeer);
sl@0: 	};
sl@0: 
sl@0: /**
sl@0: String descriptor
sl@0: 
sl@0: See section 9.6.7 of the USB 2.0 specification.
sl@0: 
sl@0: @publishedPartner Intended to be available to 3rd parties later
sl@0: @prototype
sl@0: */
sl@0: NONSHARABLE_CLASS(TUsbStringDescriptor) : public TUsbGenericDescriptor
sl@0: 	{
sl@0: public:
sl@0: 	IMPORT_C TUsbStringDescriptor();
sl@0: 	IMPORT_C static TUsbStringDescriptor* Cast(TUsbGenericDescriptor* aOriginal);
sl@0: 
sl@0: public:
sl@0: 	IMPORT_C TInt GetLangId(TInt aIndex) const;
sl@0: 	IMPORT_C void StringData(TDes16& aString) const;
sl@0: 
sl@0: public:
sl@0: 	static TUsbStringDescriptor* ParseL(TPtrC8& aUsbDes, TUsbGenericDescriptor* aPreviousDesc);
sl@0: 	virtual TBool IsParent(TUsbGenericDescriptor& aPotentialParent);
sl@0: 	virtual TBool IsPeer(TUsbGenericDescriptor& aPotentialPeer);
sl@0: 	};
sl@0: 
sl@0: /**
sl@0: OTG descriptor.
sl@0: 
sl@0: See section 6.4 of the USB 2.0 On-The-Go Supplement Revision 1.3
sl@0: 
sl@0: @publishedPartner Intended to be available to 3rd parties later
sl@0: @prototype
sl@0: */
sl@0: NONSHARABLE_CLASS(TUsbOTGDescriptor) : public TUsbGenericDescriptor
sl@0: 	{
sl@0: public:
sl@0: 	IMPORT_C TUsbOTGDescriptor();
sl@0: 	IMPORT_C static TUsbOTGDescriptor* Cast(TUsbGenericDescriptor* aOriginal);
sl@0: 
sl@0: public:
sl@0: 	static const TInt KSizeInOctets = 3;
sl@0: 	enum TFieldOffsets
sl@0: 		{
sl@0: 		EbmAttributes		= 2
sl@0: 		};
sl@0: 
sl@0: public:
sl@0: 	IMPORT_C TUint8 Attributes() const;
sl@0:     IMPORT_C TBool HNPSupported() const;
sl@0:     IMPORT_C TBool SRPSupported() const;
sl@0: public:
sl@0: 	static TUsbOTGDescriptor* ParseL(TPtrC8& aUsbDes, TUsbGenericDescriptor* aPreviousDesc);
sl@0: 	virtual TBool IsParent(TUsbGenericDescriptor& aPotentialParent);
sl@0: 	virtual TBool IsPeer(TUsbGenericDescriptor& aPotentialPeer);
sl@0: 	};
sl@0: 
sl@0: 
sl@0: #endif	// D32USBDESCRIPTORS_H