Скачиваний:
31
Добавлен:
02.05.2014
Размер:
3.51 Mб
Скачать

Chapter 8

 

Wire Adapter

Wireless Universal Serial Bus Specification, Revision 1.0

Table 8-16. Abort Transfer Request

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bLength

1

08H

Length of this request

 

 

 

 

 

1

bRequestType

1

84H

REQUEST_TYPE_ABORT – abort the specified

 

 

 

 

transfer

 

 

 

 

 

2

wRPipe

2

Number

RPipe on which the transfer must be aborted

 

 

 

 

 

4

dwTransferID

4

Number

Host-assigned ID for the transfer request to be

 

 

 

 

aborted

 

 

 

 

 

8.4DWA Interfaces, Descriptors and Control

This section provides details on the DWA specific interfaces and includes all the descriptors that a DWA should present to host software. It also defines the DWA class specific control transfers and describes how isochronous streaming is supported on a DWA.

8.4.1 DWA Isochronous Streaming Interface

This interface is reported only by Device Wire Adapters that support isochronous endpoints on downstream connected devices. The number of isochronous endpoints in this interface determines the number of downstream isochronous streams the DWA can support simultaneously. The DWA isochronous endpoints have special configuration procedures described in the next section. However, once they are configured they behave like standard Wireless USB isochronous endpoints as described in Section 4.11.

8.4.2 DWA Isochronous Streaming Overview

A Device Wire Adapter supports isochronous transfers only if it has an upstream Wireless USB isochronous endpoint. When Host software is requested to transfer Isochronous data from a device connected downstream of a DWA, the host software driver for the DWA will establish a corresponding Isochronous stream to an upstream Wireless USB isochronous endpoint on the DWA. The host will transfer the data as a stream to/from the DWA. For isochronous OUT data transfers, the DWA will start performing the transfer as per the timestamp information present in Wireless USB header that is sent with every Wireless USB isochronous packet. For isochronous IN data transfers, the DWA will start performing the transfer as soon as it receives the first IN transaction on the upstream Wireless USB bus. The association from the downstream endpoint to its corresponding upstream endpoint is specified in the RPipe descriptor. See Section 8.4.6 for details.

8.4.3 DWA Descriptors

Device Wire Adapters must support standard Wireless USB device commands as defined in the Framework chapter of this specification.

8.4.3.1 Device Descriptor

Table 8-17. Device Descriptor

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bLength

1

12H

Size of this descriptor in bytes, including this field.

 

 

 

 

 

1

bDescriptorType

1

1

DEVICE Descriptor Type.

 

 

 

 

 

2

bcdUSB

2

250H

Wireless USB Specification Release Number in

 

 

 

 

Binary-Coded Decimal. This field identifies the

 

 

 

 

release of the Wireless USB Specification with which

 

 

 

 

this device and its descriptors are compliant.

4

bDeviceClass

1

Number

 

 

 

 

 

 

217

Chapter 8

 

Wire Adapter

Wireless Universal Serial Bus Specification, Revision 1.0

Table 8-17. Device Descriptor (cont.)

Offset

Field

Size

Value

Descriptor

 

 

 

 

 

5

bDeviceSubClass

1

Number

 

 

 

 

 

 

6

bDeviceProtocol

1

Number

 

 

 

 

 

 

7

bMaxPacketSize0

1

FFH

Maximum packet size for endpoint zero.

 

 

 

 

 

8

idVendor

2

ID

Vendor ID (assigned by the USB-IF)

 

 

 

 

 

10

idProduct

2

ID

Product ID (assigned by manufacturer)

 

 

 

 

 

12

bcdDevice

2

BCD

Device release number in binary-coded-decimal

 

 

 

 

 

14

iManufacturer

1

Index

Index of string descriptor describing manufacturer

 

 

 

 

 

15

iProduct

1

Index

Index of string descriptor describing product

 

 

 

 

 

16

iSerialNumber

1

Index

Index of string descriptor describing product serial

 

 

 

 

number

 

 

 

 

 

17

bNumConfigurations

1

1

Number of possible configurations

 

 

 

 

 

If the Device Wire Adapter exports an Isochronous interface then it must use an Interface Association Descriptor to group the two interfaces (Data Transfer Interface and Isochronous Streaming Interface) together so that one driver is loaded for both. In such a case the Device Wire Adapter must set bDeviceClass, bDeviceSubClass and bDeviceProtocol fields to EFH, 02H and 02H respectively. This class code is defined as the Wire Adapter Multifunction Peripheral (WAMP) class code.

If the Device Wire Adapter does not support downstream Isochronous endpoints then bInterfaceClass, bInterfaceSubClass and bInterfaceProtocol identify the DWA interface on this device.

8.4.3.2 Binary Device Object (BOS) Descriptor

A Device Wire Adapter must define a BOS descriptor. Host software can read the BOS descriptor using the GetDescriptor() request with a descriptor type set to BOS.

A Device Wire Adapter must always have a Wireless USB Device Capabilities on UWB descriptor as part of its BOS Descriptor set. The values within the Wireless USB Device Capabilities on UWB descriptor are implementation specific, see Section 7.4.1.

8.4.3.3 Configuration Descriptor

Table 8-18. Configuration Descriptor

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bLength

1

9

Size of this descriptor in bytes, including this field.

 

 

 

 

 

1

bDescriptorType

1

2

CONFIGURATION Descriptor Type

 

 

 

 

 

2

wTotalLength

2

Number

Total length of all descriptors in this configuration

 

 

 

 

 

4

bNumInterfaces

1

Number

Number of interfaces included in this configuration

 

 

 

 

 

5

bConfigurationValue

1

Number

Value to use to reference this configuration

 

 

 

 

 

6

iConfiguration

1

Index

Index of String Descriptor describing this

 

 

 

 

configuration

 

 

 

 

 

218

Chapter 8

 

Wire Adapter

Wireless Universal Serial Bus Specification, Revision 1.0

Table 8-18. Configuration Descriptor (cont.)

Offset

Field

Size

Value

 

Description

 

 

 

 

 

7

bmAttributes

1

Bitmap

Configuration characteristics

 

 

 

 

Bit

Description

 

 

 

 

3:0

Reserved (reset to zero)

 

 

 

 

4

Battery-powered

 

 

 

 

5

Remote Wakeup

 

 

 

 

6

Self-powered

 

 

 

 

7

Reserved (set to one)

 

 

 

 

Self-powered (D6) must always be set to a one (1B).

 

 

 

 

If the DWA supports remote wakeup, D5 must be set

 

 

 

 

to one.

 

 

 

 

 

 

8

bMaxPower

1

0

Reserved and zero for Wireless USB Device.

 

 

 

 

 

 

8.4.3.4 Security Descriptors

The Device Wire Adapter has security capabilities of its own (on its logical upstream port), it reports those by responding to a Get Descriptor (SECURITY type) request, see Section 7.4.5.

8.4.3.5 Interface Association Descriptor

If the Device Wire Adapter has an Isochronous Streaming interface then it must use an Interface Association Descriptor to describe the two interfaces that it uses so that host software can enumerate the device correctly.

Table 8-19. Interface Association Descriptor

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bLength

1

8

Size of this descriptor in bytes, including this field.

 

 

 

 

 

1

bDescriptorType

1

0BH

INTERFACE_ASSOCIATION Descriptor Type

 

 

 

 

 

2

bFirstInterface

1

0

Interface number of the first interface

 

 

 

 

 

3

bInterfaceCount

1

2

Number of contiguous interfaces associated with this

 

 

 

 

function. This count includes this first interface as

 

 

 

 

well.

 

 

 

 

 

4

bFunctionClass

1

E0H

Wireless Controller

 

 

 

 

 

5

bFunctionSubClass

1

02H

Wireless USB Wire Adapter

 

 

 

 

 

6

bFunctionProtocol

1

02H

Device Wire Adapter Control/Data Streaming

 

 

 

 

interface

7

iFunction

1

Index

Index of a string descriptor that describes this Wire

 

 

 

 

Adapter

219

Chapter 8

 

Wire Adapter

Wireless Universal Serial Bus Specification, Revision 1.0

8.4.3.6 Data Transfer Interface Descriptor

The Device Wire Adapter interface descriptor and the other descriptors that are part of this interface describe the endpoints on the DWA that are necessary to communicate with devices connected downstream of the Device Wire Adapter.

Table 8-20. Data Transfer Interface Descriptor

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bLength

1

9

Size of this descriptor in bytes, including this field.

 

 

 

 

 

1

bDescriptorType

1

4

INTERFACE Descriptor Type

 

 

 

 

 

2

bInterfaceNumber

1

0

Number of this interface.

 

 

 

 

 

3

bAlternateSetting

1

0

Value used to select this alternate setting for the

 

 

 

 

interface identified in the prior field

 

 

 

 

 

4

bNumEndpoints

1

3

Number of endpoints used by this interface.

 

 

 

 

 

5

bInterfaceClass

1

E0H

Wireless Controller

 

 

 

 

 

6

bInterfaceSubclass

1

02H

Wireless USB Wire Adapter

 

 

 

 

 

7

bInterfaceProtocol

1

02H

Device Wire Adapter Control/Data Streaming

 

 

 

 

interface

8

iInterface

1

Index

Index of String Descriptor describing this interface

 

 

 

 

 

8.4.3.7 Wire Adapter Class Descriptor

This descriptor describes the characteristics of the DWA to host software. This includes but is not limited to the amount of buffering available on the DWA, the number of RPipes, the number of ports and if ports are user accessible.

Table 8-21. Wire Adapter Class Descriptor

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bLength

1

Number

Size of this descriptor in bytes, including this field.

 

 

 

 

 

1

bDescriptorType

1

21H

Wire Adapter Descriptor Type

 

 

 

 

 

2

bcdWAVersion

2

0100H

WA Class Specification Release Number in Binary-

 

 

 

 

Coded Decimal. This field identifies the release of

 

 

 

 

the WA Class Specification with which this interface

 

 

 

 

is compliant.

 

 

 

 

 

4

bNumPorts

1

Number

The number of ports supported by this Wire Adapter

 

 

 

 

 

220

Chapter 8

 

Wire Adapter

Wireless Universal Serial Bus Specification, Revision 1.0

Table 8-21. Wire Adapter Class Descriptor (cont.)

Offset

Field

Size

Value

 

Description

 

 

 

 

 

 

5

bmAttributes

1

Bitmap

Bit

Description

 

 

 

 

0

Logical Power Switching Mode

 

 

 

 

 

0:

Ganged power switching

 

 

 

 

 

 

(all ports’ power at once)

 

 

 

 

 

1:

Individual port power

 

 

 

 

 

 

switching

 

 

 

 

1

Over-current Protection Mode

 

 

 

 

 

0: Global Over-current

 

 

 

 

 

 

Protection. The Wire

 

 

 

 

 

 

Adapter reports over-

 

 

 

 

 

 

current as a summation of

 

 

 

 

 

 

all ports’ current draw,

 

 

 

 

 

 

without a breakdown of

 

 

 

 

 

 

individual port over-current

 

 

 

 

 

 

status.

 

 

 

 

 

1:

Individual Port Over-current

 

 

 

 

 

 

Protection. The Wire

 

 

 

 

 

 

Adapter reports over-

 

 

 

 

 

 

current on a per-port basis.

 

 

 

 

 

 

Each port has an over-

 

 

 

 

 

 

current status.

 

 

 

 

2

Port Indicators Supported

 

 

 

 

 

0:

Port Indicators are not

 

 

 

 

 

 

supported on its

 

 

 

 

 

 

downstream facing ports

 

 

 

 

 

 

and the PORT_INDICATOR

 

 

 

 

 

 

request has no effect.

 

 

 

 

 

1:

Port Indicators are

 

 

 

 

 

 

supported on its

 

 

 

 

 

 

downstream facing ports

 

 

 

 

 

 

and the PORT_INDICATOR

 

 

 

 

 

 

request controls the

 

 

 

 

 

 

indicators.

 

 

 

 

6:3

Reserved, reset to zero

 

 

 

 

7

Reserved

 

 

 

 

 

6

wNumRPipes

2

Number

The number of RPipes supported by this Wire

 

 

 

 

Adapter

 

 

8

wRPipeMaxBlock

2

Number

The maximum number of buffer blocks assignable to

 

 

 

 

all RPipes.

 

 

 

 

 

 

 

10

bRPipeBlockSize

1

Number

The size of an RPipe buffer block, expressed In the

 

 

 

 

form 2 bRpipeBlockSize-1 bytes per block. For example, a

 

 

 

 

value of 10 would be 512.

11

bPwrOn2PwrGood

1

Number

Time (in 2 ms intervals) from the time the power-on

 

 

 

 

sequence begins on a port until power is good on

 

 

 

 

that port. The USB System Software uses this

 

 

 

 

value to determine how long to wait before

 

 

 

 

accessing a powered-on port.

 

 

 

 

 

12

bNumMMCIEs

1

Number

This field is not used by DWAs and must be set to 0.

 

 

 

 

 

 

 

221

Соседние файлы в папке Wireless USB Specification Revision 1.0 May 12, 2005