Command 0x1F02 - Set Notification Subscriptions

The host uses this command to specify which notifications the device should send on each of its available interfaces. By default, the device sends notifications to the host on all interfaces.

1

Sequence of events

The sequence of events is as follows:

  1. The host constructs the command request in the format below.

  2. The host sends the command request to the device.

  3. The device sends a response in the format below to the host.

  4. The device immediately begins routing notifications per the request.

  5. If the device restarts or loses power, the device resets its notification subscriptions to defaults, and the host must call this command again to change them.

Table - Request Data for Command 0x1F02 - Set Notification Subscriptions

Tag
Len
Value / Description
Typ
Req
Default

Beginning of any wrappers, at minimum including Request Message

1F02 = Command 0x1F02 - Set Notification Subscriptions

81

01

Subscribe

  • 0x00 = Unsubscribe

  • 0x01 = Subscribe

B

O

0x01

82

01

Notifications Affected

  • 0x00 = Only subscribe or unsubscribe to notification messages in the Notification Message ID List parameter

  • 0x01 = Subscribe or unsubscribe to all notifications

B

O

0x01

83

var

Notification Message ID List List of two-byte Notification Message IDs (MSB first) from section 7 Notifications to be subscribed / unsubscribed by this command. For example, to subscribe to Notification 0x0105 - Transaction Operation Complete on the interface being used to send this command, the host would include 0x0105 as two bytes in the list. The device ignores any Notification Message IDs in the list that do not exist.

B

O

Null

A4

var

Interfaces

List of interfaces this command should change the subscription settings for. If the host does not specify any interfaces here, the command applies only to the interface the host is using to send the command.

B

)

Null

/81

00

Apply changes to the USB interface

O

/82

00

Apply changes to the WLAN interface

O

/83

00

Apply changes to the Bluetooth® LE interface

O

/84

00

Apply changes to the UART interface

O

End of any wrappers, at minimum including Request Message

Table - Response Data for Command 0x1F02 - Set Notification Subscriptions

Tag
Len
Value / Description
Typ
Req
Default

Beginning of any wrappers, at minimum including Response Message

1F02 = Command 0x1F02 - Set Notification Subscriptions

No parameters.

End of any wrappers, at minimum including Response Message

Table - Request Example

Table - Response Example

Last updated