Extend USB config-descriptor quirk to the full BlackShark V3 family #1

Merged
charles merged 2 commits from blackshark-v3-xbox into master 2026-07-21 02:24:06 +00:00
Owner

Adds the remaining BlackShark V3 family PIDs to the quirk (module + kernel patch + README):

Model Wired/headset Dongle
BlackShark V3 0579 057a
BlackShark V3 Pro 0576 0577
BlackShark V3 for Xbox 0a4e 0a55

Only 0577 is empirically confirmed; the rest are same-family additions. The for-Xbox pair (0a4e/0a55) may enumerate via a different descriptor path, so the 255-byte trigger is not guaranteed to apply there — the widened read is spec-compliant and harmless if it does not.

🤖 Generated with Claude Code

Adds the remaining BlackShark V3 family PIDs to the quirk (module + kernel patch + README): | Model | Wired/headset | Dongle | |---|---|---| | BlackShark V3 | 0579 | 057a | | BlackShark V3 Pro | 0576 | 0577 | | BlackShark V3 for Xbox | 0a4e | 0a55 | Only 0577 is empirically confirmed; the rest are same-family additions. The for-Xbox pair (0a4e/0a55) may enumerate via a different descriptor path, so the 255-byte trigger is not guaranteed to apply there — the widened read is spec-compliant and harmless if it does not. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
The quirk previously covered only the V3 Pro wireless dongle (1532:0577).
Add the remaining three members of the BlackShark V3 family: V3 Pro wired
(0576), V3 wired (0579), and V3 wireless dongle (057a).

Module: match all four PIDs via c255_match_pid(); dmesg now reports the
actual matched PID. Patch: four PID-sorted table entries with corrected
hunk/diffstat counts, reworded to the family. README: device table,
runtime usbcore.quirks example, and status updated.

Only 0577 is empirically confirmed; the other three are same-family
additions, expected to share the enumeration firmware behaviour. The
multi-device patch is held for upstream submission until the initial
single-device patch has landed.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Extend the quirk to the for-Xbox variant of the family. Module switches
c255_match_pid() to a switch statement covering all six PIDs; patch adds
two PID-sorted table entries with corrected hunk/diffstat counts.

These two IDs, like the non-Pro-dongle members, are unverified. The
for-Xbox devices may additionally enumerate via a different descriptor
path, so the 255-byte trigger is not guaranteed to apply; the widened
read is spec-compliant and harmless if it does not.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
charles merged commit 87a428d8bf into master 2026-07-21 02:24:06 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
charles/razer-blackshark-v3-quirk!1
No description provided.