The USB HID DInput gamepad has the following controls.
| Control | Description |
|---|---|
| X | 8 bits, 0..255, left stick |
| Y | 8 bits, 0..255, left stick |
| Z | 8 bits, 0..255, right stick |
| RZ | 8 bits, 0..255, right stick |
| Hat | 8 way hat switch/direction pad |
| Buttons | 12 buttons |
The HID report has been carefully chosen so it works with the Xbox Adaptive Controller (XAC). The X,Y axes map to the XAC left joystick. The Z,RZ axes map to the XAC right joystick. The hat switch maps to the XAC dpad. The buttons map to XAC buttons.
The XAC firmware must be updated to the June 2024 version or newer for all features to work. Use the Xbox Accessory app to update the firmware. The app runs on Xbox console and Windows. On Windows, install the free app from the Microsoft Store.
This has been tested on the following boards.
- Raspberry Pi Pico
- Raspberry Pi Pico W
- Raspberry Pi Pico 2W
But it should work on other RP2040 boards. And with some changes it should work on other boards supported by the Adafruit TinyUSB library such as SAMD21/SAMD51, nRF52840, etc.
For Arduino Leonardo, Pro Micro, and Micro boards see https://github.com/controllercustom/dinput_pluggable
For ESP32-S3 boards see https://github.com/controllercustom/dinput_ESP32
Install this library by downloading a zip file from this repo. Use the IDE "Add .ZIP library" option.
The XAC default button mapping for external USB joystick buttons is unexpected. See this video on how map buttons so they are useful.
https://www.youtube.com/watch?list=PLGr-X28QXcrsVR17qugfIKH1C1aAaD5yM&v=gm4w4qXaDm8