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

Chapter 8

 

Wire Adapter

Wireless Universal Serial Bus Specification, Revision 1.0

8.6.2.9 Set Notification Filter

This command instructs the device to filter one or more notifications. The RCCB for this command is given below.

Table 8-87. Set Notification Filter RCCB

Offset

Field

Size

Value

 

 

 

Description

 

 

 

 

 

0

bCommandType

1

0

GENERAL Command Type

 

 

 

 

 

1

wCommand

2

24

SET_NOTIFICATION_FILTER Command

3

bCommandContext

1

Number

Host assigned ID for this command.

 

 

 

 

Valid values are 1 through FEH.

 

 

 

 

 

4

wNotification

2

Bitmap

Each bit in this bitmap identifies the notification to be

 

 

 

 

filtered. If a bit is set then that notification must not be sent

 

 

 

 

to the host.

 

 

 

 

 

 

Bit

 

Notification

 

 

 

 

 

0

 

AS_PROBE_IE_RECEIVED

 

 

 

 

 

1

 

BEACON_RECEIVED

 

 

 

 

 

2

 

BEACON_SIZE_CHANGE

 

 

 

 

 

3

 

BPOIE_CHANGE

 

 

 

 

 

4

 

BP_SLOT_CHANGE

 

 

 

 

 

5

 

BP_SWITCH_IE_RECEIVED

 

 

 

 

 

6

 

DEV_ADDR_CONFLICT

 

 

 

 

 

7

 

DRP_AVAILABITY_CHANGE

 

 

 

 

.

8

.

DRP

 

 

 

 

.

15:9 .

Reserved

 

 

 

 

 

6

bEnableState

1

Number

Specifies whether to enable or disable the filter.

 

 

 

 

 

Value

 

Description

 

 

 

 

 

0

 

Filter DISABLED

 

 

 

 

 

 

 

Filter is disabled. This is the default filter

 

 

 

 

 

 

 

state on power up or after a RESET

 

 

 

 

 

 

 

command completes successfully.

 

 

 

 

 

1

 

Filter ENABLED

 

 

 

 

 

 

 

 

The device will confirm the result of the set notification filter operation by sending back an RCEB on the Radio Control Interrupt Endpoint. The RCEB for this command is given below.

Table 8-88. Set Notification Filter RCEB

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bEventType

1

0

GENERAL Event Type

 

 

 

 

 

1

wEvent

2

24

Result of SET_NOTIFICATION_FILTER Command

 

 

 

 

 

3

bEventContext

1

Number

This should match the bCommandContext in the

 

 

 

 

RCCB.

 

 

 

 

 

4

bResultCode

1

Number

Indicates the completion status of the command.

 

 

 

 

See Table 8-69 for a list of result codes.

 

 

 

 

 

268

Chapter 8

 

Wire Adapter

Wireless Universal Serial Bus Specification, Revision 1.0

8.6.2.10Set TX Power

This command is used to set the default transmit power for transmissions by this device. The RCCB for this command is given below.

Table 8-89. Set TX Power RCCB

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bCommandType

1

0

GENERAL Command Type

 

 

 

 

 

1

wCommand

2

25

SET_TX_POWER Command

3

bCommandContext

1

Number

Host assigned ID for this command.

 

 

 

 

Valid values are 1 through FEH.

 

 

 

 

 

4

bPowerLevel

1

Number

Value indicating the number of steps below the highest

 

 

 

 

power level that must be used.

 

 

 

 

 

If the power level for transmission of a packet is not set by other means, then the device must use the power level specified in bPowerLevel to transmit that packet.

The default state on power up or after a RESET command completes successfully is the highest power level.

The RCEB for this command is given in Table 8-90.

Table 8-90. Set TX Power RCEB

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bEventType

1

0

GENERAL Event Type

 

 

 

 

 

1

wEvent

2

25

Result of SET_TX_POWER Command

 

 

 

 

 

3

bEventContext

1

Number

This should match the bCommandContext in the RCCB.

 

 

 

 

 

4

bResultCode

1

Number

Indicates the completion status of the command. See

 

 

 

 

Table 8-69 for a list of result codes.

 

 

 

 

 

8.6.2.11Sleep

On reception of this command the device will start hibernation after transmitting the Hibernation Mode IE in its beacons for the specified number of times if the device is not enabled for remote wake. If it is enabled for remote wake then it keeps sending beacons in every superframe. In the latter case, the device will wake up the host (if the host is sleeping) if it needs to send a notification that is not filtered.

The RCCB for this command is given below.

Table 8-91. Sleep RCCB

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bCommandType

1

0

GENERAL Command Type

 

 

 

 

 

1

wCommand

2

26

SLEEP Command

 

 

 

 

 

3

bCommandContext

1

Number

Host assigned ID for this command.

 

 

 

 

Valid values are 1 through FEH.

 

 

 

 

 

4

bHibernationCount

1

Number

Number of superframes until the device begins

 

 

 

 

hibernation. This field is only valid when remote wake is

 

 

 

 

disabled on the device.

 

 

 

 

 

6

bHibernationDuration

1

Number

Number of superframes for which the device intends to

 

 

 

 

hibernate. This field is only valid when remote wake is

 

 

 

 

disabled on the device.

269

Chapter 8

 

Wire Adapter

Wireless Universal Serial Bus Specification, Revision 1.0

If the remote wake is disabled on the device, it will begin hibernation after transmitting a number of beacons including Hibernation Mode IE. The Hibernation Countdown field in this IE is set to the bHibernationCount for the first beacon and must be decremented by one for each superframe. After sending a beacon with its Hibernation Countdown set to a zero, the device stops sending beacons and begins hibernation. The Hibernation Duration field in this IE must be set to the value specified by the bHibernationDuration field. The device will stay in hibernation during the specified period, but it is not required to wake up by itself after the specified hibernation period. The host is responsible for waking up the device and requesting it to restart beaconing.

If remote wake is enabled on the device, it must keep sending beacons in every superframe. Before executing this command, the host must specify a set of IEs that the device must send. When the device detects a wake event, e.g. DRP conflict, and the event notification is required by the notification filter (see Section 8.6.2.9), it must wake up the host (if it’s sleeping) and send the notification to the host.

The RCEB for this command is given in Table 8-92.

Table 8-92. Sleep RCEB

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bEventType

1

0

GENERAL Event Type

 

 

 

 

 

1

wEvent

2

26

Result of SLEEP Command

3

bEventContext

1

Number

This should match the bCommandContext in the RCCB.

 

 

 

 

 

4

bResultCode

1

Number

Indicates the completion status of the command. See

 

 

 

 

Table 8-69 for a list of result codes.

 

 

 

 

 

The bResultCode field indicates whether the sleep operation was successful. If a sleep is not succeeding, it is a vendor specific decision when to time out the operation and return failure.

8.6.2.12Start Beaconing

This command instructs the device to begin beaconing on the specified channel.

The RCCB for this command is given below.

Table 8-93. Start Beaconing RCCB

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bCommandType

1

0

GENERAL Command Type

 

 

 

 

 

1

wCommand

2

27

START_BEACONING Command

 

 

 

 

 

3

bCommandContext

1

Number

Host assigned ID for this command.

 

 

 

 

Valid values are 1 through FEH.

 

 

 

 

 

4

wBPSTOffset

2

Number

The offset of a received beacon relative to the BPST of

 

 

 

 

the device measured in microseconds.

6

bChannelNumber

1

Number

The physical channel on which beaconing is to occur. The

 

 

 

 

encoding of the channel number is specified in Table

 

 

 

 

5-12.

 

 

 

 

 

The bChannelNumber field value is the physical layer channel on which beaconing will begin. The device must join the beacon group that is identified by wBPSTOffset. The value in wBPSTOffset must be a value that was returned in a Beacon Received notification, see Section 8.6.3.1.

If the device is currently beaconing, then the device’s response to this command is undefined.

If the host did not receive any Beacon Received notifications, then the host must set wBPSTOffset to zero and the device must start beaconing as soon as possible and establish a beacon group.

270

Chapter 8

 

Wire Adapter

Wireless Universal Serial Bus Specification, Revision 1.0

The device will confirm that the first beacon has been successfully transmitted or that the operation has failed by sending back an RCEB on the Radio Control Interrupt Endpoint. If the device successfully starts beaconing then it must listen to all the beacons during its beacon period and return any beacon received notifications that are not filtered to the host. In addition the Superframe Time Counter (STC), see Section 8.6.2.4 must be adjusted so that the zero of the STC corresponds to the new BPST.

The RCEB for this command is given in Table 8-94.

Table 8-94. Start Beaconing RCEB

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bEventType

1

0

GENERAL Event Type

 

 

 

 

 

1

wEvent

2

27

Result of START_BEACONING Command

 

 

 

 

 

3

bEventContext

1

Number

This should match the bCommandContext in the

 

 

 

 

RCCB.

 

 

 

 

 

4

bResultCode

1

Number

Indicates the completion status of the command.

 

 

 

 

See Table 8-69 for a list of result codes.

 

 

 

 

 

The bResultCode field indicates whether beacons have begun to be successfully transmitted. If an operation to start beaconing is not succeeding, it is a vendor specific decision when to time out the operation and return failure.

8.6.2.13Stop Beaconing

This command instructs the device to stop beaconing.

The RCCB for this command is given below.

Table 8-95. Stop Beaconing RCCB

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bCommandType

1

0

GENERAL Command Type

 

 

 

 

 

1

wCommand

2

28

STOP_BEACONING Command

 

 

 

 

 

3

bCommandContext

1

Number

Host assigned ID for this command.

 

 

 

 

Valid values are 1 through FFH.

 

 

 

 

 

This command is sent by the host software to stop beaconing that was started with the Start Beaconing command.

The device will confirm that beaconing has been stopped by sending back an RCEB on the Radio Control Interrupt Endpoint. The RCEB for this command is given below.

Table 8-96. Stop Beaconing RCEB

Offset

Field

Size

Value

Description

 

 

 

 

 

0

bEventType

1

0

GENERAL Event Type

 

 

 

 

 

1

wEvent

2

28

Result of STOP_BEACONING Command

 

 

 

 

 

3

bEventContext

1

Number

This should match the bCommandContext in the

 

 

 

 

RCCB.

4

bResultCode

1

Number

Indicates the completion status of the command.

 

 

 

 

See Table 8-69 for a list of result codes.

 

 

 

 

 

The bResultCode field indicates whether the beaconing operation successfully stopped. A beacon period must have passed without a beacon being transmitted for the confirmation to complete successfully. If ending beaconing is not succeeding, it is a vendor specific decision when to time out the operation and return failure. The STC will revert back to a free running timer until the device starts beaconing again.

271

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