Installers Guide to the Bose® Serial interface
June 28, 2011
Bose Confidential Information
Page 15/42
Do Not Redistribute
A rare but important notification packet is the Assert packet which indicates the Console
encountered a fatal internal condition and will reboot. The other notification packets indicate
various internal events of the Console (debug messages) and should be ignored by the Client.
The format of a Notification Packet is as follows:
<Length> <Status> 01 <Notification-Type> <Payload>
Table 5-4 Notification Packet Format
Byte
Number
Value (Hex)
Name
Explanation
0
<Length>
Length
The total number of bytes in the
packet. Variable
1
<Status>
Status
Error bit = 0, Notification bit = 1
2
01
OpCode1
The Value 1
3
<Notification-Type>
Notification Type
Where <Notification-Type>indicates
the notification type. See
Table 5-5 Notification Packet
Notification-Types
4
—
<Payload>
Payload
The data associated with the
notification type
Table 5-5 Notification Packet Notification-Types
<Notification-Type>
(Hex)
Name
Explanation
00
Debug
See Section 5.3.4.3 Debug Notification Packets
02
Assert
See Section 5.3.4.2 Assert Notification Packets
04
Key Press
Notification
See Section 5.3.4.1 Key Press Notification Packets
5.3.4.1 Key Press Notification Packets
Key press Notification packets can be enabled or disabled and the state of Hard Key press
notifications can be queried using the Echo command (See
Echo - Hard and Soft Key Press
Notification). Key Press Notification packets are only sent if the key Press notifications are
enabled. Note that Hard Key Press Notification is set false when the Console reboots and Soft
Key Press notification is set false when the console enters Low Power mode.
When Key Press Notification is enabled, the Client is notified with two separate packets: 1) when
a key is pressed and 2) when the key is released. There is no separate notification if the key has
been held but the Client can determine the hold time by using its own timer and subtracting the
arrival times of the release and press notifications.
Since a key can be pressed/released on the remotes or the Console at any time, these packets
may occur between the times a Client sends a command and receives a response packet and a
ready packet.
They can be identified by the Status byte and the Key Press Notification OpCode: 0x0104.