Skip to content

Fix Stream Deck Plus HID read length to match report descriptor#10

Open
callmepain wants to merge 1 commit intoStreamController:masterfrom
callmepain:fix/streamdeck-plus-hid-read-length
Open

Fix Stream Deck Plus HID read length to match report descriptor#10
callmepain wants to merge 1 commit intoStreamController:masterfrom
callmepain:fix/streamdeck-plus-hid-read-length

Conversation

@callmepain
Copy link

Summary

  • The Stream Deck Plus USB HID report descriptor declares a 512-byte input report, but _read_control_states() was reading only 14 bytes.
  • HIDAPI 0.15.0 with the libusb backend silently drops HID reports when the requested read size is smaller than the report descriptor's declared size.
  • This breaks dial TURN events on real hardware (button presses still work because they arrive in shorter reports).
  • Verified by capturing raw HID data: 512-byte reads return all events correctly, while 14-byte reads return no data for dial rotations.

Changes

  • Added class constant _INPUT_REPORT_LEN = 512 to StreamDeckPlus, matching the USB HID report descriptor.
  • Changed self.device.read(14) to self.device.read(self._INPUT_REPORT_LEN) in _read_control_states().

Test plan

  • Verified dial TURN events are received on real Stream Deck Plus hardware with HIDAPI 0.15.0 (libusb backend)
  • Verified button presses and touchscreen events continue to work correctly
  • Confirm no regressions on other platforms / HIDAPI backends

The Stream Deck Plus USB HID report descriptor declares a 512-byte
input report. Reading only 14 bytes worked with older HIDAPI versions,
but HIDAPI 0.15.0 using the libusb backend silently drops reports when
the requested size is smaller than the descriptor's report size. This
causes dial TURN events to never arrive, while button presses (which
appear in shorter reports) still work.

Capturing raw HID data confirms 512-byte reads return all events
correctly, whereas 14-byte reads return no data for dial rotations.

Add a class constant _INPUT_REPORT_LEN = 512 (matching the HID report
descriptor) and use it in _read_control_states() instead of the
hard-coded 14-byte read.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant