Ajazz Stream Deck Protocol

How to interface with a Ajazz Stream Deck device.

Synopsis

The device uses the HID protocol to communicate with its software.

Configuration

The number of keys can be determined from the HID device descriptors. There is currently no known provision to determine their layout or size. The buttons on the current version of the device (AKP153) are arranged in a grid and numbered from top right through to bottom left as follows:

 -----------------------------
| 0d | 0a | 07 | 04 | 01 | 10 |
|----|----|----|----|----|----|
| 0e | 0b | 08 | 05 | 02 | 11 |
|----|----|----|----|----|----|
| 0f | 0c | 09 | 06 | 03 | 12 |
 -----------------------------

Note: 10~12 are icons without buttons.

Host to Device

Feature reports

0x01 Firmware Version

0x01

Output reports

every packet size = 512, zero padding up to 512 bytes

Set Brightness

PC = PERCENTAGE (0-100)

0x43, 0x52, 0x54, 0x00, 0x00, 0x4c, 0x49, 0x47, 0x00, 0x00, PC

Set Image

image size : 85x85

First Packet

SIZE0, SIZE1 : BigEndian 16bit Image Data Size

0x43, 0x52, 0x54, 0x00, 0x00, 0x42, 0x41, 0x54, 0x00, 0x00, SIZE0, SIZE1, TG1, 0x00, 0x00, 0x00,

Subsequent packets

Jpeg encoded data, Packet Size = 512

ex) 8000 bytes = 512 * 16 packets

data

Stop

flush images

0x43, 0x52, 0x54, 0x00, 0x00, 0x53, 0x54, 0x50,

Clear

TG0 = 0, TG1 = BUTTON(1-18) : Clear Button
TG0 = 0, TG1 = 0xff : Clear All
TG0 = 0x44, TG1 = 0x43 : Clear and show logo image

0x43, 0x52, 0x54, 0x00, 0x00, 0x43, 0x4c, 0x45, 0x00, 0x00, TG0, TG1, 0x00, 0x00, 0x00, 0x00,

Input reports