Skip to main content

Stream Deck Neo

Introduction

The Elgato Stream Deck Neo is a USB 2.0-compliant input device combining a 4×2 keypad, an informative LCD window, and two capacitive touch sensors (mapped as extra buttons). It communicates with the host via the USB HID protocol.

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 Stream Deck Neo.


Device Overview

Summary

NameModelVIDPIDCapabilities
Stream Deck Neo20GBJ99010x0FD90x009ANeo Layout

Capabilities & Physical Characteristics

Neo Layout

EntityProperty(-ies)
LCD Image480 × 320 px, high DPI
Buttons matrix4 × 2
Button Image96 × 96 px
Windowno touchscreen capabilities
Window Image248 × 58 px
Sensors2 (mapped as buttons)
Sensor Image96 × 16 px
Keypad Buttons Index Layout
Image showing the Stream Deck Neo keypad buttons index layout.
Unit Pixel Layout
Image showing the Stream Deck Neo unit pixel layout.

Command Descriptions

Input Reports

The Report ID of input reports is 0x01.


Buttons and Sensors Press State Change

An event is generated on every change of key or sensor state. On Stream Deck Neo, the two capacitive touch sensors are mapped as extra buttons appended at the end of the buttons array.

OffsetTypeNote
+ 0x00Input ReportReport ID: 0x01, Command: 0x00, Payload data length: number of buttons + number of mapped sensors
+ 0x04UINT8[]Each byte has value 0x00 when depressed, or 0x01 when pressed

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 Button Image

Uploads an image for a specific button.

OffsetTypeNote
+ 0x00Output ReportReport ID: 0x02, Command: 0x07
+ 0x02UINT8Button 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 complete 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 Window Image

Uploads a full image for the window strip.

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

Update Partial Window Image

Uploads an image into a rectangular region of the window.

OffsetTypeNote
+ 0x00Output ReportReport ID: 0x02, Command: 0x0C
+ 0x02UINT16X-coordinate
+ 0x04UINT16Y-coordinate
+ 0x06UINT16Image width
+ 0x08UINT16Image height
+ 0x0AUINT8Transfer is Done flag (0x01 = last chunk)
+ 0x0BUINT16Chunk Index (zero-based)
+ 0x0DUINT16Chunk Contents Size
+ 0x0FUINT8Reserved
+ 0x10UINT8[]Chunk Data
  • Use logical coordinates, without accounting for image rotation.

Device Setup & Communication

Uploading Images

Button Image

  1. Prepare a 96 × 96 px image.
  2. Rotate the image 180° before upload.
  3. Export in JPEG format.
  4. Send using the Update Button Image command sequence.

Full LCD Image

  1. Prepare a 480 × 320 px image.
  2. Rotate the image 180° before upload.
  3. Export in JPEG format.
  4. Send using the Update Full Screen Image command sequence.

Full Window Image

  1. Prepare a 248 × 58 px image.
  2. Rotate the image 180° before upload.
  3. Export in JPEG format.
  4. Send using the Update Window Image command sequence.

Partial Window Image

  1. Prepare the image at the desired logical dimensions.
  2. Rotate the image 180° before upload.
  3. Export in JPEG format.
  4. Send using the Update Partial Window Image command sequence.

INDEX

Input Reports Reference

Report IDCommandDescription
0x010x00Buttons and sensors press state change

Output Reports Reference

Report IDCommandDescription
0x020x07Update Button Image
0x020x08Update Full Screen Image
0x020x0BUpdate Window Image
0x020x0CUpdate Partial Window Image

Feature Reports Reference

Setter Feature Reports

Report IDCommandDescription
0x030x02Show Logo
0x030x05Fill LCD with Color
0x030x06Fill Button with Color
0x030x08Set Backlight Brightness
0x030x0DSet Sleep Mode Duration

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