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

Chapter 7

 

Wireless USB Framework

Wireless Universal Serial Bus Specification, Revision 1.0

7.4Standard Wireless USB Descriptors

All devices must support the required set of standard device descriptors defined in USB 2.0, chapter 9. All standard device descriptors are available once the device is in the Connected device state (see Section 7.1). Wireless USB defines several changes to some of the standard descriptors defined in USB 2.0, see the summary in Table 7-24. This specification includes only the USB 2.0 defined descriptors that are modified by the Wireless USB specification.

Table 7-24. Summary of Changes to USB 2.0 Defined Standard Descriptors

Descriptor Type

Wireless

Explanation

 

USB Delta

 

DEVICE

No change

No change to the base descriptor, except for the

 

 

version number in bcdUSB field, Wireless USB

 

 

also requires an additional standard device-level

 

 

capabilities descriptor, see section 7.4.1.

CONFIGURATION

Changes

Updates required for Wireless USB. See Section

 

 

7.4.2.

STRING

No change

 

INTERFACE

No change

 

ENDPOINT

Changes

Updates required for Wireless USB. Also require

 

 

extensions to endpoint capabilities which utilize a

 

 

companion descriptor, see Section 7.4.2.

DEVICE_QUALIFIER

n/a

Not allowed for a Wireless USB device

OTHER_SPEED_CONFIGURATION

n/a

Not allowed for a Wireless USB device

 

 

 

INTERFACE_POWER

n/a

Not allowed for a Wireless USB device

OTG

n/a

Not allowed for a Wireless USB device

DEBUG

No Change

See Debug device specification

 

 

http://developer.intel.com/technology/usb/spec.htm

INTERFACE_ASSOCIATION

No change

 

 

 

 

The USB 2.0 specification [1], Section 9.4 lists the standard descriptor types. Table 7-25 is the list of additional descriptor types and assigned descriptor type values for Wireless USB.

Table 7-25. Wireless USB Standard Extension Descriptor Types

Descriptor Types

Value

Section Reference

SECURITY

12

Section 7.4.5.1

KEY

13

Section 7.4.5.2

 

 

 

ENCRYPTION TYPE

14

Section 7.4.5.1.1

 

 

 

BOS

15

Section 7.4.1

DEVICE CAPABILITY

16

Section 7.4.1

 

 

 

WIRELESS_ENDPOINT_COMPANION

17

Section 7.4.2

 

 

 

7.4.1 Device Level Descriptors

The Device descriptor describes general information about a USB device. Please refer to Section 9.6.1 of the USB 2.0 specification for a full description of the Device descriptor. The bMaxPacketSize0 field is the only field in the standard device descriptor with a different requirement than that documented in the USB 2.0.

Wireless USB requires the bMaxPacketSize0 field to be set to FFH (see Section 4.8.1). In addition, devices that conform to this revision of the Wireless USB specification must have the value of 0250H in the bcdUSB field. Additional device-level information for devices is contained in the BOS descriptor, see below.

161

Chapter 7

 

Wireless USB Framework

Wireless Universal Serial Bus Specification, Revision 1.0

This section defines a flexible and extensible framework for describing and adding device-level capabilities to the set of USB standard specifications. As mentioned above, there exists a device descriptor, but all device-level capability extensions are defined using the following framework.

The BOS descriptor (Binary device Object Store, see Table 7-26) defines a root descriptor that is similar to the configuration descriptor, and is the base descriptor for accessing a family of related descriptors. A host can read a BOS descriptor and learn from the wTotalLength field the entire size of the device-level descriptor set, or it can read in the entire BOS descriptor set of device capabilities. The host accesses this descriptor using the GetDescriptor() request. The descriptor type in the GetDescriptor() request is set to BOS (see Table 7-26). There is no way for a host to read individual device capability descriptors. The entire set can only be accessed via reading the BOS descriptor with a GetDescriptor() request and using the length reported in the wTotalLength field.

Table 7-26. BOS Descriptor

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bLength

1

Number

Size of this descriptor.

1

bDescriptorType

1

Constant

Descriptor type: BOS.

 

 

 

 

 

2

wTotalLength

2

Number

Length of this descriptor and all of its sub

 

 

 

 

descriptors.

4

bNumDeviceCaps

1

Number

The number of separate device capability

 

 

 

 

descriptors in the BOS.

Individual, technology-specific or generic device-level capabilities are reported via Device Capability descriptors. The format of the Device Capability descriptor is defined in Table 7-27. The Device Capability descriptor has a generic header, with a sub-type field (bDevCapabilityType) which defines the layout of the remainder of the descriptor. The codes for bDevCapabilityType are defined in Table 7-28.

Table 7-27. Format of a Device Capability Descriptor

Offset

Field

Size

Value

Description

0

bLength

1

Number

Size of this descriptor.

1

bDescriptorType

1

Constant

Descriptor type: DEVICE CAPABILITY Type.

2

bDevCapabilityType

1

Number

Valid values are listed in Table 7-28.

 

 

 

 

 

3

Capability-

VAR

Variable

Capability-specific format.

 

Dependent

 

 

 

Device Capability descriptors are always returned as part of the BOS information returned by a GetDescriptor(BOS) request. A Device Capability cannot be directly accessed with a GetDescriptor() or SetDescriptor() request.

Table 7-28. Device Capability Type Codes

Capability

Value

Description

Code

 

 

 

Wireless_USB

01H

Defines the set of Wireless USB-specific device level capabilities.

Reserved

00H, 02-FFH

Reserved for future use.

 

 

 

The following section(s) define the specific device capabilities.

162

Chapter 7

 

Wireless USB Framework

Wireless Universal Serial Bus Specification, Revision 1.0

7.4.1.1Wireless USB Device Capabilities – UWB

This section defines the required device-level capabilities descriptor which must be implemented by all Wireless USB devices. Wireless USB Device Capabilities – UWB descriptors cannot be directly accessed with a GetDescriptor() or SetDescriptor() request.

Table 7-29. Wireless USB Device Capabilities on UWB Descriptor

Offset

Field

Size

Value

Description

 

 

 

 

 

 

0

bLength

1

Number

Size of this descriptor.

 

 

 

 

 

1

bDescriptorType

1

Constant

Descriptor type: DEVICE CAPABILITY Type.

2

bDevCapabilityType

1

Constant

Capability type: WIRELESS USB.

3

bmAttributes

1

Bitmap

Bitmap encoding of supported device level

 

 

 

 

features. A value of one in a bit location

 

 

 

 

indicates a feature is supported; a value of

 

 

 

 

zero indicates it is not supported. Encodings

 

 

 

 

are:

 

 

 

 

 

 

Bit

Encoding

 

 

 

 

0

Reserved. Must be set to zero.

 

 

 

 

1

P2P-DRD. A value of one in this

 

 

 

 

 

bit location indicates that this

 

 

 

 

 

device is Peer to Peer DRD

 

 

 

 

 

capable.

 

 

 

 

 

3:2

Beacon Behavior. This field

 

 

 

 

 

encodes the beaconing behavior

 

 

 

 

 

of the device. The encoded

 

 

 

 

 

values are:

 

 

 

 

 

Value

Description

 

 

 

 

 

00B

Reserved.

 

 

 

 

 

01B

Self-Beacon

 

 

 

 

 

10B

Directed Beacon

 

 

 

 

 

11B

No-Beacon

 

 

 

 

7:4

Reserved. Must be set to zero.

163

Chapter 7

 

Wireless USB Framework

Wireless Universal Serial Bus Specification, Revision 1.0

Table 7-29. Wireless USB Device Capabilities on UWB Descriptor (cont.)

Offset

Field

Size

Value

 

Description

 

 

 

 

 

4

wPHYRates

2

Bitmap

Describes the PHY-level signaling rate

 

 

 

 

capabilities of this device implementation

 

 

 

 

represented as a bit-mask. Bit positions are

 

 

 

 

assigned to speed capabilities possible in a

 

 

 

 

PHY implementation. A ‘1’ in a bit position

 

 

 

 

indicates the associated data rate is

 

 

 

 

supported by the device. Encodings are:

 

 

 

 

Bit

Data Rate (Mbps)

 

 

 

 

0

53.3 **required

 

 

 

 

1

80

 

 

 

 

2

106.7 **required

 

 

 

 

3

160

 

 

 

 

4

200 **required

 

 

 

 

5

320

 

 

 

 

6

400

 

 

 

 

7

480

 

 

 

 

15:8

Reserved. Must be zero.

 

 

 

 

** Required encodings must be a one (1B).

164

Chapter 7

 

Wireless USB Framework

Wireless Universal Serial Bus Specification, Revision 1.0

Table 7-29. Wireless USB Device Capabilities on UWB Descriptor (cont.)

Offset

Field

Size

Value

 

Description

 

 

 

 

 

6

bmTFITXPowerInfo

1

Bitmap

This bit mask reports the PHY transmit power

 

 

 

 

levels supported by this device when

 

 

 

 

transmitting on a TFI channel. See below for

 

 

 

 

details.

 

 

 

 

 

 

Bit

Encoding

 

 

 

 

3:0

Power Level Steps. Specifies

 

 

 

 

 

the number of steps from the

 

 

 

 

 

base TFI transmit power level

 

 

 

 

 

supported by the device.

 

 

 

 

7:4

Step Size. The value specifies

 

 

 

 

 

the number of dB between

 

 

 

 

 

supported power levels as

 

 

 

 

 

follows:

 

 

 

 

 

 

Value

Step Size (dB)

 

 

 

 

 

0

1.0

 

 

 

 

 

1

1.25

 

 

 

 

 

2

1.5

 

 

 

 

 

3

1.75

 

 

 

 

 

4

2.0

 

 

 

 

 

5

2.25

 

 

 

 

 

6

2.5

 

 

 

 

 

7

2.75

 

 

 

 

 

8

3.0

 

 

 

 

 

9

3.25

 

 

 

 

 

10

3.5

 

 

 

 

 

11

3.75

 

 

 

 

 

12

4.0

 

 

 

 

 

13

4.25

 

 

 

 

 

14

4.5

 

 

 

 

 

15

4.75

7

bmFFITXPowerInfo

1

Bitmap

This bit mask reports the PHY transmit power

 

 

 

 

levels supported by this device when

 

 

 

 

transmitting on an FFI channel. The encoding

 

 

 

 

of this field is identical to the

 

 

 

 

bmTFITXPowerInfo field. See below for

 

 

 

 

details.

 

 

8

bmBandGroup

2

Bitmap

This bit map reports which UWB band groups

 

 

 

 

are supported by this implementation. See

 

 

 

 

below for details.

 

10

bReserved

1

Zero

Reserved for future use, must be zero

 

 

 

 

 

 

 

The fields bmFFITXPowerInfo and bmTFITXPowerInfo report the PHY transmit power levels supported by the device. The fields report the step size between power levels and the number of steps supported. This information can be used in the Set WUSB Data request to set the devices’ maximum transmit power for various types of packets transmitted by the device to the Wireless USB channel. The power level for data packets is set by the bmTXAttributes Transmit Power field in a WDTCTA, see Section 5.2.1.2. The host must use only those power levels reported by this descriptor. See Section 4.10.1 for detailed information and additional requirements on TPC.

165

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