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

Chapter 8

 

Wire Adapter

Wireless Universal Serial Bus Specification, Revision 1.0

8.5HWA Interfaces, Descriptors and Control

This section provides details on the HWA specific interfaces, includes all the descriptors an HWA should present to host software, HWA class specific control transfers, additional notifications that an HWA can return to host software and describes how isochronous streaming is supported on an HWA.

8.5.1 HWA Isochronous Streaming Overview

On a Host Wire Adapter the basic data flow model for Isochronous pipes is identical to the Bulk streaming model. Host software sends “buffer oriented” transfer requests to the Wire Adapter. The Host Client model is already based on a client device driver queuing multiple requests to the Wired or Wireless USB Stack in order to achieve streaming. The host software can propagate the request stream without modification to the HWA. It is expected that host software will only have to subdivide client transfer requests into a series of smaller transfer requests depending on the buffering available on that RPipe. Note that although the transfer request model is ‘buffer oriented’ the transfer requests coming from the client already have per-frame annotations. Host software will include the packetization and when to send/receive (timestamp) information in the transfer request to the HWA. This is very important as only the client has knowledge of how per-frame annotations should be applied to a stream. For instance, a client may change the per-frame data amount in order to maintain synchronization. Note that a relative (as opposed to explicit, per packet) timestamp is sufficient.

For IN transfers, it is important that the feedback/response pipe provide sufficient information for the host software to map data packets received in specific frames to the appropriate client request buffer area. This means the HWA must annotate the received data stream with packet boundaries, upon receipt (timestamp) and correctly identify bad and/or missing packets. An isochronous transfer result is always followed by an isochronous packet status array. Note that relative timestamp information is sufficient. See Section 8.5.5 for details.

8.5.2 HWA Descriptors

Host Wire Adapters must support a class specific security descriptor, identical to the security descriptor returned by all wireless USB devices, to be used by the host to identify the encryption types supported on the host wire adapters logical down stream ports. It must return the security descriptor as part of its configuration descriptor. A Host Wire Adapter returns different descriptors based on whether it is operating at high-speed or full speed.

8.5.2.1 Device Descriptor

Table 8-39. 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

200H

USB Specification Release Number in Binary-Coded

 

 

 

 

Decimal. This field identifies the release of the USB

 

 

 

 

Specification with which the device and its

 

 

 

 

descriptors are compliant.

 

 

 

 

 

4

bDeviceClass

1

EFH

Miscellaneous

 

 

 

 

 

5

bDeviceSubClass

1

02H

Common Class

 

 

 

 

 

6

bDeviceProtocol

1

02H

Wire Adapter Multifunction Peripheral

 

 

 

 

 

7

bMaxPacketSize0

1

Number

Maximum packet size for endpoint zero

 

 

 

 

 

8

idVendor

2

ID

Vendor ID (assigned by the USB-IF)

 

 

 

 

 

236

Chapter 8

 

Wire Adapter

Wireless Universal Serial Bus Specification, Revision 1.0

Table 8-39. Device Descriptor (cont.)

Offset

Field

Size

Value

Description

 

 

 

 

 

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

 

 

 

 

 

All Host Wire Adapters have a UWB Radio and hence have to export a Radio Control Interface as well (see Section 8.6). To correctly enumerate the HWA, it 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.

8.5.2.2 Device_Qualifier Descriptor

Table 8-40. Device_Qualifier Descriptor

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bLength

1

0AH

Size of this descriptor in bytes, including this field.

 

 

 

 

 

1

bDescriptorType

1

6

DEVICE_QUALIFIER Type

 

 

 

 

 

2

bcdUSB

2

200H

USB Specification Release Number in Binary-Coded

 

 

 

 

Decimal. This field identifies the release of the USB

 

 

 

 

Specification with which the device and its

 

 

 

 

descriptors are compliant.

4

bDeviceClass

1

EFH

Miscellaneous

 

 

 

 

 

5

bDeviceSubClass

1

02

Common Class

 

 

 

 

 

6

bDeviceProtocol

1

02

Wire Adapter Multifunction Peripheral

 

 

 

 

 

7

bMaxPacketSize0

1

Number

Maximum packet size for endpoint zero.

 

 

 

 

 

8

bNumConfigurations

1

1

Number of possible configurations.

 

 

 

 

 

9

bReserved

1

Zero

Reserved for future use, must be zero.

 

 

 

 

 

8.5.2.3 Configuration Descriptor

Table 8-41. 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

237

Chapter 8

 

Wire Adapter

Wireless Universal Serial Bus Specification, Revision 1.0

Table 8-41. Configuration Descriptor (cont.)

Offset

Field

Size

Value

Description

 

 

 

 

 

7

bmAttributes

1

Bitmap

Configuration characteristics

 

 

 

 

D7: Reserved (set to one)

 

 

 

 

D6: Self-powered

 

 

 

 

D5: Remote Wakeup

 

 

 

 

D4...0: Reserved (reset to zero)

 

 

 

 

 

8

bMaxPower

1

mA

Maximum power consumption of the USB device

 

 

 

 

from the bus in this specific configuration when the

 

 

 

 

device is fully operational. Expressed in 2 mA units

 

 

 

 

(i.e., 50 = 100 mA).

8.5.2.4 Other_Speed_Configuration Descriptor

Table 8-42. Other_Speed_Configuration Descriptor

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bLength

1

9

Size of this descriptor in bytes, including this field.

 

 

 

 

 

1

bDescriptorType

1

7

Other_Speed_Configuration Descriptor Type

 

 

 

 

 

2

wTotalLength

2

Number

Total length of all descriptors in this configuration

 

 

 

 

 

4

bNumInterfaces

1

Number

Number of interfaces supported by this speed

 

 

 

 

configuration.

5

bConfigurationValue

1

Number

Value to use to select configuration

6

iConfiguration

1

Index

Index of string descriptor

 

 

 

 

 

7

bmAttributes

1

Bitmap

Same as Configuration descriptor

8

bMaxPower

1

mA

Same as Configuration descriptor

 

 

 

 

 

8.5.2.5 Security Descriptors

A Host Wire Adapter must return a security descriptor and all its associated encryption descriptors in its configuration descriptor.

Table 8-43. Wire Adapter Class Security Descriptor

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bLength

1

5

Size of this descriptor in bytes, including this field.

 

 

 

 

 

1

bDescriptorType

1

12

Security Descriptor Type

 

 

 

 

 

2

wTotalLength

2

Number

Total length of this descriptor and all encryption

 

 

 

 

descriptors returned

4

bNumEncryptionTypes

1

Number

Number of supported encryption Types

 

 

 

 

 

The Host Wire Adapter will return the number of Encryption descriptors as noted in the bNumEncryptionsTypes field immediately after the Security descriptor. Since this Encryption Descriptor is only used to inform the host software of the supported encryption methods, the bAuthKeyIndex field must be set to 0x0 in every Encryption Descriptor that is returned by the Wire Adapter.

NOTE: The security descriptor and its associated encryption descriptors that are returned as part of the configuration description are used only to determine the supported encryption methods of the Host Wire Adapter device on its logical downstream ports.

238

Chapter 8

 

Wire Adapter

Wireless Universal Serial Bus Specification, Revision 1.0

8.5.2.6 Data Transfer Interface Descriptor

Table 8-44. 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

01H

Host Wire Adapter Control/Data Streaming interface

 

 

 

 

 

8

iInterface

1

Index

Index of String Descriptor describing this interface

 

 

 

 

 

8.5.2.7 Wire Adapter Class Descriptor

This descriptor describes the characteristics of the HWA to host software. This includes but is not limited to the amount of buffering available on the HWA, the number of RPipes, the maximum number of IEs that the HWA has storage for and the number of devices that this HWA can have connected to it at the same time.

Table 8-45. 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 maximum number of simultaneous devices that

 

 

 

 

this HWA can support.

5

bmAttributes

1

Bitmap

Reserved, must be set to zero.

 

 

 

 

 

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

For Host Wire Adapters, this field must be set to 0.

12

bNumMMCIEs

1

Number

This field specifies the number of MMC IE blocks that

 

 

 

 

a HWA can support at the same time. Each block

 

 

 

 

must have at least 255 bytes of storage. Valid values

 

 

 

 

are in the range of 1H to FFH. A zero in this field is

 

 

 

 

undefined for an HWA.

 

 

 

 

 

13

DeviceRemovable

1

Bitmap

For Host Wire Adapters, this field is of length 1 and

 

 

 

 

all bits are set to 0.

239

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