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

     2 // All rights reserved.

     3 // This component and the accompanying materials are made available

     4 // under the terms of the License "Eclipse Public License v1.0"

     5 // which accompanies this distribution, and is available

     6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".

     7 //

     8 // Initial Contributors:

     9 // Nokia Corporation - initial contribution.

    10 //

    11 // Contributors:

    12 //

    13 // Description:

    14 //

    15 

    16 #include <d32usbdi.h>

    17 

    18 #include <d32usbtransfers.h>

    19 #include "usbtransferstrategy.h"

    20 #include "zerocopytransferstrategy.h"

    21 

    22 

    23 /**

    24 Opens an interface identified by a token.  When the hub driver loads a driver (via function driver

    25 framework), this token is generated to allow the driver to open the interface.

    26 

    27 This also causes the interface's descriptors to be parsed for future reference.

    28 

    29 @param[in] aToken The token for the interface to open.

    30 @return System-wide error code.

    31 */

    32 EXPORT_C TInt RUsbInterface::Open(TUint32 aToken, TOwnerType aType)

    33 	{

    34 	TPckgC<TUint32> token(aToken);

    35 	TInt err = DoCreate(Name(), VersionRequired(), KNullUnit, NULL, &token, aType);

    36 	if(err == KErrNone)

    37 		{

    38 		// Create a transfer strategy

    39 		iTransferStrategy = new RUsbZeroCopyTransferStrategy;

    40 		if(!iTransferStrategy)

    41 			{

    42 			Close();

    43 			return KErrNoMemory;

    44 			}

    45 

    46 		// Get descriptor size

    47 		TInt interfaceDescSize = 0;

    48 		err = DoControl(EGetInterfaceDescriptorSize, &interfaceDescSize);

    49 		if(err != KErrNone)

    50 			{

    51 			Close();

    52 			return err;

    53 			}

    54 		iInterfaceDescriptorData = HBufC8::New(interfaceDescSize);

    55 

    56 		if(!iInterfaceDescriptorData)

    57 			{

    58 			Close();

    59 			return KErrNoMemory;

    60 			}

    61 

    62 		// Get descriptor data

    63 		TPtr8 interfaceDesc = iInterfaceDescriptorData->Des();

    64 		err = DoControl(EGetInterfaceDescriptor, &interfaceDesc);

    65 		if(err != KErrNone)

    66 			{

    67 			Close();

    68 			return err;

    69 			}

    70 

    71 		// Parse descriptor

    72 		TUsbGenericDescriptor* parsed = NULL;

    73 		err = UsbDescriptorParser::Parse(*iInterfaceDescriptorData, parsed);

    74 		if(err != KErrNone)

    75 			{

    76 			if(parsed)

    77 				{

    78 				parsed->DestroyTree(); //or however much has been completed

    79 				delete parsed;

    80 				}

    81 			Close();

    82 			return err;

    83 			}

    84 

    85 		iHeadInterfaceDescriptor = TUsbInterfaceDescriptor::Cast(parsed);

    86 		if(!iHeadInterfaceDescriptor)

    87 			{

    88 			if(parsed)

    89 				{

    90 				parsed->DestroyTree();

    91 				delete parsed;

    92 				}

    93 			Close();

    94 			return KErrCorrupt;

    95 			}

    96 		}

    97 

    98 	return err;

    99 	}

   100 	

   101 /**

   102 Close handle to interface.

   103 

   104 Closes any pipe handles still open.

   105 */

   106 EXPORT_C void RUsbInterface::Close()

   107 	{

   108 	iAlternateSetting = 0;

   109 	if(iHeadInterfaceDescriptor)

   110 		{

   111 		iHeadInterfaceDescriptor->DestroyTree();

   112 		delete iHeadInterfaceDescriptor;

   113 		iHeadInterfaceDescriptor = NULL;

   114 		}

   115 	if(iInterfaceDescriptorData)

   116 		{

   117 		delete iInterfaceDescriptorData;

   118 		iInterfaceDescriptorData = NULL;

   119 		}

   120 	if(iTransferStrategy)

   121 		{

   122 		iTransferStrategy->Close();

   123 		delete iTransferStrategy;

   124 		iTransferStrategy = NULL;

   125 		}

   126 	RBusLogicalChannel::Close();

   127 	}

   128 

   129 

   130 EXPORT_C TInt RUsbInterface::RegisterTransferDescriptor(RUsbTransferDescriptor& aTransfer)

   131 	{

   132 	TTransferMemoryDetails details;

   133 	details.iType		= aTransfer.iType;

   134 	details.iSize		= aTransfer.iMaxSize;

   135 	details.iMaxPackets	= aTransfer.iMaxNumPackets;

   136 	TInt err = DoControl(EGetSizeAndAlignment, &details);

   137 	if(err != KErrNone)

   138 		{

   139 		return err;

   140 		}

   141 	return iTransferStrategy->RegisterTransferDescriptor(aTransfer, details.iSize, details.iAlignment, details.iMaxPackets);

   142 	}

   143 	

   144 EXPORT_C void RUsbInterface::ResetTransferDescriptors()

   145 	{

   146 	iTransferStrategy->ResetTransferDescriptors();

   147 	}

   148 

   149 EXPORT_C TInt RUsbInterface::InitialiseTransferDescriptors()

   150 	{

   151 	return iTransferStrategy->InitialiseTransferDescriptors(*this);

   152 	}

   153 

   154