/* * Copyright (c) 1998-2006 Apple Computer, Inc. All rights reserved. * * @APPLE_LICENSE_HEADER_START@ * * The contents of this file constitute Original Code as defined in and * are subject to the Apple Public Source License Version 1.2 (the * "License"). You may not use this file except in compliance with the * License. Please obtain a copy of the License at * http://www.apple.com/publicsource and read it before using this file. * * This Original Code and all software distributed under the License are * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. * Please see the License for the specific language governing rights and * limitations under the License. * * @APPLE_LICENSE_HEADER_END@ */ #ifndef _IOKIT_IOUSBPIPEV2_H #define _IOKIT_IOUSBPIPEV2_H #include <IOKit/IOService.h> #include <IOKit/IOMemoryDescriptor.h> #include <IOKit/usb/USB.h> #include <IOKit/usb/IOUSBController.h> #include <IOKit/usb/IOUSBControllerV2.h> #include <IOKit/usb/IOUSBPipe.h> /*! @class IOUSBPipeV2 @abstract The object representing an open pipe for a device. */ class IOUSBPipeV2 : public IOUSBPipe { friend class IOUSBInterface; friend class IOUSBDevice; OSDeclareDefaultStructors(IOUSBPipeV2) protected: #ifdef SUPPORTS_SS_USB IOUSBSuperSpeedEndpointCompanionDescriptor * _sscd; UInt32 _maxStream; UInt32 _maxBurst; UInt32 _configuredStreams; UInt32 _mult; UInt32 _bytesPerInterval; struct V2PipeExpansionData { }; V2PipeExpansionData * _v2PipeExpansionData; static IOUSBPipeV2 *ToEndpoint(const IOUSBEndpointDescriptor *endpoint, IOUSBSuperSpeedEndpointCompanionDescriptor *sscd, IOUSBDevice * device, IOUSBController * controller, IOUSBInterface *interface); public: using IOUSBPipe::Read; using IOUSBPipe::Write; using IOUSBPipe::Abort; virtual bool InitToEndpoint(const IOUSBEndpointDescriptor *endpoint, IOUSBSuperSpeedEndpointCompanionDescriptor *sscd, UInt8 speed, USBDeviceAddress address, IOUSBController * controller, IOUSBDevice * device, IOUSBInterface * interface); /*! @function Read Read from a stream on a bulk endpoint @param streamID ID of the stream to read from @param buffer place to put the transferred data @param noDataTimeout number of milliseconds of no bus activity until transaction times out. Note that if a tranasction times out the driver software may have to resynchronize the data toggle. See ClearPipeStall. @param completionTimeout number of milliseconds from the time the transaction is placed on the bus until it times out @param reqCount requested number of bytes to transfer. must be <= buffer->getLength() @param completion describes action to take when buffer has been filled @param bytesRead returns total bytes read for synchronous reads */ virtual IOReturn Read(UInt32 streamID, IOMemoryDescriptor * buffer, UInt32 noDataTimeout, UInt32 completionTimeout, IOByteCount reqCount, IOUSBCompletion * completion = 0, IOByteCount * bytesRead = 0); /*! @function Write Write to a stream on a bulk endpoint @param streamID ID of the stream to write to @param buffer place to get the transferred data @param noDataTimeout number of milliseconds of no bus activity until transaction times out. Note that if a tranasction times out the driver software may have to resynchronize the data toggle. See ClearPipeStall. @param completionTimeout number of milliseconds from the time the transaction is placed on the bus until it times out @param reqCount requested number of bytes to transfer. must be <= buffer->getLength() @param completion describes action to take when buffer has been emptied */ virtual IOReturn Write(UInt32 streamID, IOMemoryDescriptor * buffer, UInt32 noDataTimeout, UInt32 completionTimeout, IOByteCount reqCount, IOUSBCompletion * completion = 0); /*! @function SupportsStreams Returns non zero if the pipe supports streams. Return value is the max supported stream. */ virtual UInt32 SupportsStreams(void); /*! @function SupportsStreams @param streamID ID of the highest stream to creat (pass 0 to destroy streams) */ virtual IOReturn CreateStreams(UInt32 maxStreams); /*! @function Abort(stream) This method causes all outstanding I/O on a stream of a pipe to complete with return code kIOReturnAborted. It clears the halted bit but does NOT clear the toggle bit on the endpoint in the controller. If you wish to clear the toggle bit, see ClearPipeStall @param streamID ID of the stream to abort */ virtual IOReturn Abort(UInt32 streamID); /*! @function GetConfiguredStreams Get the number of streams which have been configured for the endpoint with CreateStreams */ virtual UInt32 GetConfiguredStreams(void); /*! @function GetSuperSpeedEndpointCompanionDescriptor returns the SuperSpeed endpoint companion descriptor for the pipe. */ virtual const IOUSBSuperSpeedEndpointCompanionDescriptor * GetSuperSpeedEndpointCompanionDescriptor(); /*! @function GetMaxBurst returns the value of bMaxBurst from the SuperSpeed endpoint companion descriptor */ virtual UInt8 GetMaxBurst(); /*! @function GetMaxBurst returns the value of bMaxBurst from the SuperSpeed endpoint companion descriptor */ virtual UInt8 GetMult(); /*! @function GetMaxBurst returns the value of bMaxBurst from the SuperSpeed endpoint companion descriptor */ virtual UInt16 GetBytesPerInterval(); #endif OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 0); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 1); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 2); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 3); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 4); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 5); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 6); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 7); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 8); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 9); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 10); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 11); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 12); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 13); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 14); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 15); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 16); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 17); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 18); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 19); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 20); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 21); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 22); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 23); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 24); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 25); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 26); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 27); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 28); OSMetaClassDeclareReservedUnused(IOUSBPipeV2, 29); }; #endif