Skip to content

Add xsyetopz org and PID 1209:4A4F for OpenJoystickDriver Generic HID Gamepad - #1292

Merged
cnlohr merged 1 commit into
pidcodes:masterfrom
xsyetopz:xsyetopz-openjoystickdriver
Sep 30, 2026
Merged

cnlohr merged 1 commit into
pidcodes:masterfrom
xsyetopz:xsyetopz-openjoystickdriver

Conversation

@xsyetopz

@xsyetopz xsyetopz commented Sep 29, 2026 •

Copy link
Copy Markdown
Contributor

This PR here requests PID 0x4A4F under VID 0x1209 for OpenJoystickDriver, and adds the
xsyetopz org page.


OpenJoystickDriver is a userspace gamepad driver for macOS, and reads physical game controllers, then republishes their input as virtual HID device thru macOS's IOHIDUserDevice. One of its output modes, the (fallback) generic HID gamepad, IS NOT an emulation of any vendor's controller, but simply its own input-only layout: 16 x buttons, 4 x stick axes, 2 x trigger axes, and no output report. A connected device reports a USB transport, so hosts see it as a simple USB HID gamepad, which then reads its VID and PID like those of any physical device.


OSes, browsers (Gamepad API), SDL2 and SDL3, and games identify this device by VID:PID. They cache the report descriptor and choose button mappings by that identity. The identity therefore HAS TO be unique and stable across releases. End users cannot, and SHOULD NOT, choose their own PID, because a mapping published for one PID would not apply to another. Alternatives are unregistered VID or borrowed vendor's IDs, and neither is acceptable for a published driver.

The chosen PID is 0x4A4F ("JO"), which is outside the reserved 0x0000–0x1FFF ranges.

  • org/xsyetopz/index.md
  • 1209/4A4F/index.md

@cnlohr cnlohr left a comment •

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Similar to the other few virtual devices we approved recently, this is a mac OS virtual driver. Under MIT. All seems fine... Though painfully in swift, lol.

@cnlohr
cnlohr merged commit 77f2bdf into pidcodes:master Sep 30, 2026
2 checks passed
@xsyetopz

Copy link
Copy Markdown
Contributor Author

Similar to the other few virtual devices we approved recently, this is a mac OS virtual driver. Under MIT. All seems fine... Though painfully in swift, lol.

At least not in Obj-C, haha

@xsyetopz
xsyetopz deleted the xsyetopz-openjoystickdriver branch September 30, 2026 05:33
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.

2 participants