Skip to main content

Stream Deck XL

Introduction​

The Stream Deck XL Family are 32-Key USB 2.0-compliant input devices featuring an 4×8 grid of keys atop a single high-DPI LCD screen. They communicate with the host via the USB HID protocol, enabling key event reporting, image upload, and device configuration.

For all concepts, data types, report structures, and shared commands refer to the General Reference page. This page documents only what is specific to the 32-key family.

Devices Overview​

Summary​

NameModelVIDPIDCapabilities
Stream Deck Module 3220GAT99020x0FD90x00BA32 Keys Layout
Stream Deck XL20GAT99010x0FD90x006C32 Keys Layout
Stream Deck XL 202220GAT99020x0FD90x008F32 Keys Layout
note

All models in this family share the same HID command set and 32-key layout. Adjust the PID when targeting a specific model.

Capabilities & Physical Characteristics​

32 Keys Layout​

EntityProperty
LCD Image1024 × 600 px (high DPI)
Keys matrix8 × 4
Key Image96 × 96 px
Keypad Keys Index Layout​
Image showing the 32 keys keypad buttons index layout.
Unit Pixel Layout​
Image showing the 32 keys unit pixel layout.

Command Descriptions​

Output Reports​

The Report ID of output reports is 0x02. When the payload does not fit into a single report, it must be split into multiple chunks.

Update Key Image​

Uploads an image for a specific key.

OffsetTypeNote
+ 0x00Output ReportReport ID: 0x02, Command: 0x07
+ 0x02UINT8Key Index
+ 0x03UINT8Transfer is Done flag (0x01 = last chunk)
+ 0x04UINT16Chunk Contents Size
+ 0x06UINT16Chunk Index (zero-based)
+ 0x08UINT8[]Chunk Data

Update Full Screen Image​

Uploads an image for the entire LCD.

OffsetTypeNote
+ 0x00Output ReportReport ID: 0x02, Command: 0x08
+ 0x02UINT8Reserved
+ 0x03UINT8Transfer is Done flag (0x01 = last chunk)
+ 0x04UINT16Chunk Contents Size
+ 0x06UINT16Chunk Index (zero-based)
+ 0x08UINT8[]Chunk Data

Update Background​

Uploads an image to be stored as a background at a given index.

OffsetTypeNote
+ 0x00Output ReportReport ID: 0x02, Command: 0x0D
+ 0x02UINT8Background Index
+ 0x03UINT8Transfer is Done flag (0x01 = last chunk)
+ 0x04UINT16Chunk Index (zero-based)
+ 0x06UINT16Chunk Contents Size
+ 0x08UINT8[]Chunk Data

Setter Feature Reports (Device-Specific)​

Show Background by Index​

Displays a previously stored background by its index.

OffsetTypeNote
+ 0x00Feature ReportReport ID: 0x03, Command: 0x13
+ 0x02UINT8Background Index

Device Setup & Communication​

Uploading Images​

Key Image​

  1. Prepare a 96 × 96 px image.
  2. Rotate the image 180° before upload (required for all models in this family).
  3. Export in JPEG format.
  4. Send using the Update Key Image command sequence.

Full LCD Image​

  1. Prepare a 1024 × 600 px image.
  2. Rotate the image 180° before upload (required for all models in this family).
  3. Export in JPEG format.
  4. Send using the Update Full Screen Image command sequence.

INDEX​

Input Reports Reference​

Report IDCommandDescription
0x010x00Key press state change

Output Reports Reference​

Report IDCommandDescription
0x020x07Update Key Image
0x020x08Update Full Screen Image
0x020x0DUpdate Background

Feature Reports Reference​

Setter Feature Reports​

Report IDCommandDescription
0x030x02Show Logo
0x030x05Fill LCD with Color
0x030x06Fill Key with Color
0x030x08Set Backlight Brightness
0x030x0DSet Sleep Mode Duration
0x030x13Show Background by Index

Getter Feature Reports​

Report IDCommandDescription
0x04Get Firmware Version (LD)
0x05Get Firmware Version (AP2)
0x06Get Unit Serial Number
0x07Get Firmware Version (AP1)
0x08Get Unit Information
0x0AGet Sleep Mode Duration