SDL/src/joystick/usb_ids.h

/*
  Simple DirectMedia Layer
  Copyright (C) 1997-2021 Sam Lantinga <slouken@libsdl.org>

  This software is provided 'as-is', without any express or implied
  warranty.  In no event will the authors be held liable for any damages
  arising from the use of this software.

  Permission is granted to anyone to use this software for any purpose,
  including commercial applications, and to alter it and redistribute it
  freely, subject to the following restrictions:

  1. The origin of this software must not be misrepresented; you must not
     claim that you wrote the original software. If you use this software
     in a product, an acknowledgment in the product documentation would be
     appreciated but is not required.
  2. Altered source versions must be plainly marked as such, and must not be
     misrepresented as being the original software.
  3. This notice may not be removed or altered from any source distribution.
*/

#ifndef usb_ids_h_
#define usb_ids_h_

/* Definitions of useful USB VID/PID values */

#define USB_VENDOR_AMAZON       0x1949
#define USB_VENDOR_APPLE        0x05ac
#define USB_VENDOR_GOOGLE       0x18d1
#define USB_VENDOR_HYPERKIN     0x2e24
#define USB_VENDOR_MICROSOFT    0x045e
#define USB_VENDOR_NINTENDO     0x057e
#define USB_VENDOR_NVIDIA       0x0955
#define USB_VENDOR_PDP          0x0e6f
#define USB_VENDOR_POWERA       0x24c6
#define USB_VENDOR_POWERA_ALT   0x20d6
#define USB_VENDOR_RAZER        0x1532
#define USB_VENDOR_SHENZHEN     0x0079
#define USB_VENDOR_SONY         0x054c
#define USB_VENDOR_VALVE        0x28de

#define USB_PRODUCT_AMAZON_LUNA_CONTROLLER              0x0419
#define USB_PRODUCT_GOOGLE_STADIA_CONTROLLER            0x9400
#define USB_PRODUCT_EVORETRO_GAMECUBE_ADAPTER           0x1846
#define USB_PRODUCT_NINTENDO_GAMECUBE_ADAPTER           0x0337
#define USB_PRODUCT_NINTENDO_SWITCH_PRO                 0x2009
#define USB_PRODUCT_NINTENDO_SWITCH_JOY_CON_LEFT        0x2006
#define USB_PRODUCT_NINTENDO_SWITCH_JOY_CON_RIGHT       0x2007
#define USB_PRODUCT_NINTENDO_SWITCH_JOY_CON_GRIP        0x200e
#define USB_PRODUCT_RAZER_PANTHERA                      0x0401
#define USB_PRODUCT_RAZER_PANTHERA_EVO                  0x1008
#define USB_PRODUCT_RAZER_ATROX                         0x0a00
#define USB_PRODUCT_SONY_DS4                            0x05c4
#define USB_PRODUCT_SONY_DS4_DONGLE                     0x0ba0
#define USB_PRODUCT_SONY_DS4_SLIM                       0x09cc
#define USB_PRODUCT_SONY_DS5                            0x0ce6
#define USB_PRODUCT_XBOX360_XUSB_CONTROLLER             0x02a1    /* XUSB driver software PID */
#define USB_PRODUCT_XBOX360_WIRED_CONTROLLER            0x028e
#define USB_PRODUCT_XBOX360_WIRELESS_RECEIVER           0x0719
#define USB_PRODUCT_XBOX_ONE_ELITE_SERIES_1             0x02e3
#define USB_PRODUCT_XBOX_ONE_ELITE_SERIES_2             0x0b00
#define USB_PRODUCT_XBOX_ONE_ELITE_SERIES_2_BLUETOOTH   0x0b05
#define USB_PRODUCT_XBOX_ONE_S                          0x02ea
#define USB_PRODUCT_XBOX_ONE_S_REV1_BLUETOOTH           0x02e0
#define USB_PRODUCT_XBOX_ONE_S_REV2_BLUETOOTH           0x02fd
#define USB_PRODUCT_XBOX_SERIES_X                       0x0b12
#define USB_PRODUCT_XBOX_SERIES_X_BLUETOOTH             0x0b13
#define USB_PRODUCT_XBOX_SERIES_X_VICTRIX_GAMBIT        0x02d6
#define USB_PRODUCT_XBOX_SERIES_X_PDP_BLUE              0x02d9
#define USB_PRODUCT_XBOX_SERIES_X_PDP_AFTERGLOW         0x02da
#define USB_PRODUCT_XBOX_SERIES_X_POWERA_FUSION_PRO2    0x4001
#define USB_PRODUCT_XBOX_SERIES_X_POWERA_SPECTRA        0x4002
#define USB_PRODUCT_XBOX_ONE_XBOXGIP_CONTROLLER         0x02ff    /* XBOXGIP driver software PID */
#define USB_PRODUCT_XBOX_ONE_XINPUT_CONTROLLER          0x02fe    /* Made up product ID for XInput */
#define USB_PRODUCT_STEAM_VIRTUAL_GAMEPAD               0x11ff

/* USB usage pages */
#define USB_USAGEPAGE_GENERIC_DESKTOP   0x0001
#define USB_USAGEPAGE_BUTTON            0x0009

/* USB usages for USAGE_PAGE_GENERIC_DESKTOP */
#define USB_USAGE_GENERIC_POINTER               0x0001
#define USB_USAGE_GENERIC_MOUSE                 0x0002
#define USB_USAGE_GENERIC_JOYSTICK              0x0004
#define USB_USAGE_GENERIC_GAMEPAD               0x0005
#define USB_USAGE_GENERIC_KEYBOARD              0x0006
#define USB_USAGE_GENERIC_KEYPAD                0x0007
#define USB_USAGE_GENERIC_MULTIAXISCONTROLLER   0x0008
#define USB_USAGE_GENERIC_X                     0x0030
#define USB_USAGE_GENERIC_Y                     0x0031
#define USB_USAGE_GENERIC_Z                     0x0032
#define USB_USAGE_GENERIC_RX                    0x0033
#define USB_USAGE_GENERIC_RY                    0x0034
#define USB_USAGE_GENERIC_RZ                    0x0035
#define USB_USAGE_GENERIC_SLIDER                0x0036
#define USB_USAGE_GENERIC_DIAL                  0x0037
#define USB_USAGE_GENERIC_WHEEL                 0x0038
#define USB_USAGE_GENERIC_HAT                   0x0039

/* Bluetooth SIG assigned Company Identifiers
   https://www.bluetooth.com/specifications/assigned-numbers/company-identifiers/ */
#define BLUETOOTH_VENDOR_AMAZON                 0x0171

#define BLUETOOTH_PRODUCT_LUNA_CONTROLLER       0x0419

#endif /* usb_ids_h_ */

/* vi: set ts=4 sw=4 expandtab: */
Added missing file from previous commit 2020-01-18 19:21:42 +00:00			`/*`
			`Simple DirectMedia Layer`
Updated copyright for 2021 2021-01-02 18:25:38 +00:00			`Copyright (C) 1997-2021 Sam Lantinga <slouken@libsdl.org>`
Added missing file from previous commit 2020-01-18 19:21:42 +00:00
			`This software is provided 'as-is', without any express or implied`
			`warranty. In no event will the authors be held liable for any damages`
			`arising from the use of this software.`

			`Permission is granted to anyone to use this software for any purpose,`
			`including commercial applications, and to alter it and redistribute it`
			`freely, subject to the following restrictions:`

			`1. The origin of this software must not be misrepresented; you must not`
			`claim that you wrote the original software. If you use this software`
			`in a product, an acknowledgment in the product documentation would be`
			`appreciated but is not required.`
			`2. Altered source versions must be plainly marked as such, and must not be`
			`misrepresented as being the original software.`
			`3. This notice may not be removed or altered from any source distribution.`
			`*/`

			`#ifndef usb_ids_h_`
			`#define usb_ids_h_`

			`/* Definitions of useful USB VID/PID values */`

Added HIDAPI support for the Amazon Luna Controller connected over USB in DirectInput mode 2021-07-07 16:49:33 +00:00			`#define USB_VENDOR_AMAZON 0x1949`
Added additional game controller button support on iOS/tvOS 2020-11-07 00:42:46 +00:00			`#define USB_VENDOR_APPLE 0x05ac`
Fixed bug 5466 - Add haptic support for Stadia Controller Dimitriy Ryazantcev Consider adding support for Stadia Controller haptics. Here is example code how to deal with it: https://github.com/chromium/chromium/blob/99314be8152e688bafbbf9a615536bdbb289ea87/device/gamepad/hid_haptic_gamepad.cc#L45 2021-01-23 19:06:35 +00:00			`#define USB_VENDOR_GOOGLE 0x18d1`
Added missing file from previous commit 2020-01-18 19:21:42 +00:00			`#define USB_VENDOR_HYPERKIN 0x2e24`
			`#define USB_VENDOR_MICROSOFT 0x045e`
			`#define USB_VENDOR_NINTENDO 0x057e`
			`#define USB_VENDOR_NVIDIA 0x0955`
			`#define USB_VENDOR_PDP 0x0e6f`
			`#define USB_VENDOR_POWERA 0x24c6`
Added support for the PowerA Fusion Pro 2 and the PDP Xbox Series X Afterglow and Blue controllers 2021-06-19 00:37:46 +00:00			`#define USB_VENDOR_POWERA_ALT 0x20d6`
Added missing file from previous commit 2020-01-18 19:21:42 +00:00			`#define USB_VENDOR_RAZER 0x1532`
Added support for the EVORETRO GameCube Adapter in PC mode 2021-01-22 19:42:42 +00:00			`#define USB_VENDOR_SHENZHEN 0x0079`
			`#define USB_VENDOR_SONY 0x054c`
Added missing file from previous commit 2020-01-18 19:21:42 +00:00			`#define USB_VENDOR_VALVE 0x28de`

Added HIDAPI support for the Amazon Luna Controller connected over USB in DirectInput mode 2021-07-07 16:49:33 +00:00			`#define USB_PRODUCT_AMAZON_LUNA_CONTROLLER 0x0419`
Fixed bug 5466 - Add haptic support for Stadia Controller Dimitriy Ryazantcev Consider adding support for Stadia Controller haptics. Here is example code how to deal with it: https://github.com/chromium/chromium/blob/99314be8152e688bafbbf9a615536bdbb289ea87/device/gamepad/hid_haptic_gamepad.cc#L45 2021-01-23 19:06:35 +00:00			`#define USB_PRODUCT_GOOGLE_STADIA_CONTROLLER 0x9400`
Added support for the EVORETRO GameCube Adapter in PC mode 2021-01-22 19:42:42 +00:00			`#define USB_PRODUCT_EVORETRO_GAMECUBE_ADAPTER 0x1846`
Added missing file from previous commit 2020-01-18 19:21:42 +00:00			`#define USB_PRODUCT_NINTENDO_GAMECUBE_ADAPTER 0x0337`
Fixed bug 5051 - Switch Pro Controller hidapi driver does not report battery levels when connected via Bluetooth bluenaxela+sdl I've noticed that the Switch Pro Controller hidapi driver does not report battery levels when connected via Bluetooth, despite having code for setting joystick->epowerlevel. This is caused by the driver always using k_eSwitchInputReportIDs_SimpleControllerState via Bluetooth. Using that mode means that the state reports you get back from the controller do not include battery state. Not using the full controller state over Bluetooth effectively makes this driver's support for setting joystick->epowerlevel entirely pointless, only ever reporting SDL_JOYSTICK_POWER_WIRED. Is there a reason this was set to only use SimpleControllerState via Bluetooth? I've attached a patch I'm using to allow getting battery level for the Switch Pro Controller. A couple notes about this patch: 1) It changes LoadStickCalibration to accept the input_mode that is selected, because that's really what should determine what is used for stick extents, since stick extents differ between the modes. 2) In my patch I only use FullControllerState when the vid/pid matches the official Switch Pro Controller, as a cautionary measure in case some third-party controllers have problems with FullControllerState mode via Bluetooth (I noticed a HORI Wireless Switch Pad I had seemed to not read controller calibration correctly for stick extents. Maybe it's calibration data was uninitialized on account of having never been used with a Switch? I'm unsure, though if that guess is right maybe SDL2 should be detecting an uninitiated calibration state and using some sensible defaults) 2020-03-22 18:01:14 +00:00			`#define USB_PRODUCT_NINTENDO_SWITCH_PRO 0x2009`
Hint SDL_HINT_JOYSTICK_HIDAPI_JOY_CONS added so we can recognise a Joy-Con as half a Pro Controller, so we can read its analog input and read its sensors just like we do a Pro Controller. 2021-01-18 11:57:29 +00:00			`#define USB_PRODUCT_NINTENDO_SWITCH_JOY_CON_LEFT 0x2006`
			`#define USB_PRODUCT_NINTENDO_SWITCH_JOY_CON_RIGHT 0x2007`
Added support for the Joy-Con Charging Grip when SDL_HINT_JOYSTICK_HIDAPI_JOY_CONS is enabled 2021-08-04 18:33:28 +00:00			`#define USB_PRODUCT_NINTENDO_SWITCH_JOY_CON_GRIP 0x200e`
Added missing file from previous commit 2020-01-18 19:21:42 +00:00			`#define USB_PRODUCT_RAZER_PANTHERA 0x0401`
			`#define USB_PRODUCT_RAZER_PANTHERA_EVO 0x1008`
Added support for the Razer Atrox Arcade Stick 2020-04-18 04:30:58 +00:00			`#define USB_PRODUCT_RAZER_ATROX 0x0a00`
Added missing file from previous commit 2020-01-18 19:21:42 +00:00			`#define USB_PRODUCT_SONY_DS4 0x05c4`
			`#define USB_PRODUCT_SONY_DS4_DONGLE 0x0ba0`
			`#define USB_PRODUCT_SONY_DS4_SLIM 0x09cc`
Added initial support for the Sony PS5 Controller 2020-11-05 23:02:54 +00:00			`#define USB_PRODUCT_SONY_DS5 0x0ce6`
Be more explicit about Xbox 360/One device ids. When Xbox One/Series Controllers are connected via USB on Windows they all are using `XBOXGIP` driver and produce a special ProductID `0x02FF` (GIP software PID) for any connected controller. On the other hand `Xbox 360 Wireless Controller Reciever` (PID 0x0719) is using `XUSB` driver and produces special ProductID `0x02A1` (XUSB software PID) for each connected Xbox 360 Wireless Controller. Also fixed Xbox One Series X Controller comment. 2021-05-17 11:50:33 +00:00			`#define USB_PRODUCT_XBOX360_XUSB_CONTROLLER 0x02a1 /* XUSB driver software PID */`
Add Steam Virtual Gamepad and Xbox 360 Wired Controller defines instead of magic values See https://partner.steamgames.com/doc/features/steam_controller/steam_input_gamepad_emulation_bestpractices for details on what is Steam Virtual Gamepad. 2021-06-02 11:28:33 +00:00			`#define USB_PRODUCT_XBOX360_WIRED_CONTROLLER 0x028e`
Be more explicit about Xbox 360/One device ids. When Xbox One/Series Controllers are connected via USB on Windows they all are using `XBOXGIP` driver and produce a special ProductID `0x02FF` (GIP software PID) for any connected controller. On the other hand `Xbox 360 Wireless Controller Reciever` (PID 0x0719) is using `XUSB` driver and produces special ProductID `0x02A1` (XUSB software PID) for each connected Xbox 360 Wireless Controller. Also fixed Xbox One Series X Controller comment. 2021-05-17 11:50:33 +00:00			`#define USB_PRODUCT_XBOX360_WIRELESS_RECEIVER 0x0719`
Added support for the paddles on the Xbox One Elite Series 1 controller 2020-01-22 19:28:35 +00:00			`#define USB_PRODUCT_XBOX_ONE_ELITE_SERIES_1 0x02e3`
Added missing file from previous commit 2020-01-18 19:21:42 +00:00			`#define USB_PRODUCT_XBOX_ONE_ELITE_SERIES_2 0x0b00`
			`#define USB_PRODUCT_XBOX_ONE_ELITE_SERIES_2_BLUETOOTH 0x0b05`
Don't check the HIDAPI driver for the virtual device created by xow 2020-03-23 21:10:25 +00:00			`#define USB_PRODUCT_XBOX_ONE_S 0x02ea`
Added missing file from previous commit 2020-01-18 19:21:42 +00:00			`#define USB_PRODUCT_XBOX_ONE_S_REV1_BLUETOOTH 0x02e0`
			`#define USB_PRODUCT_XBOX_ONE_S_REV2_BLUETOOTH 0x02fd`
Added support for the PowerA Fusion Pro 2 and the PDP Xbox Series X Afterglow and Blue controllers 2021-06-19 00:37:46 +00:00			`#define USB_PRODUCT_XBOX_SERIES_X 0x0b12`
			`#define USB_PRODUCT_XBOX_SERIES_X_BLUETOOTH 0x0b13`
Added support for the Victrix Gambit Tournament Controller 2021-07-31 01:23:42 +00:00			`#define USB_PRODUCT_XBOX_SERIES_X_VICTRIX_GAMBIT 0x02d6`
Added support for the PowerA Fusion Pro 2 and the PDP Xbox Series X Afterglow and Blue controllers 2021-06-19 00:37:46 +00:00			`#define USB_PRODUCT_XBOX_SERIES_X_PDP_BLUE 0x02d9`
Added support for the Victrix Gambit Tournament Controller 2021-07-31 01:23:42 +00:00			`#define USB_PRODUCT_XBOX_SERIES_X_PDP_AFTERGLOW 0x02da`
Added support for the PowerA Fusion Pro 2 and the PDP Xbox Series X Afterglow and Blue controllers 2021-06-19 00:37:46 +00:00			`#define USB_PRODUCT_XBOX_SERIES_X_POWERA_FUSION_PRO2 0x4001`
Added support for the full line of current PowerA Xbox Series X controllers 2021-07-23 23:32:35 +00:00			`#define USB_PRODUCT_XBOX_SERIES_X_POWERA_SPECTRA 0x4002`
Be more explicit about Xbox 360/One device ids. When Xbox One/Series Controllers are connected via USB on Windows they all are using `XBOXGIP` driver and produce a special ProductID `0x02FF` (GIP software PID) for any connected controller. On the other hand `Xbox 360 Wireless Controller Reciever` (PID 0x0719) is using `XUSB` driver and produces special ProductID `0x02A1` (XUSB software PID) for each connected Xbox 360 Wireless Controller. Also fixed Xbox One Series X Controller comment. 2021-05-17 11:50:33 +00:00			`#define USB_PRODUCT_XBOX_ONE_XBOXGIP_CONTROLLER 0x02ff /* XBOXGIP driver software PID */`
Fixed duplicating a device between XInput and HIDAPI 2020-12-04 02:17:03 +00:00			`#define USB_PRODUCT_XBOX_ONE_XINPUT_CONTROLLER 0x02fe /* Made up product ID for XInput */`
Add Steam Virtual Gamepad and Xbox 360 Wired Controller defines instead of magic values See https://partner.steamgames.com/doc/features/steam_controller/steam_input_gamepad_emulation_bestpractices for details on what is Steam Virtual Gamepad. 2021-06-02 11:28:33 +00:00			`#define USB_PRODUCT_STEAM_VIRTUAL_GAMEPAD 0x11ff`
Added missing file from previous commit 2020-01-18 19:21:42 +00:00
Generalized the raw input controller driver and moved XInput/WGI detection into it for XInput devices This fixes bad report parsing for various newer Xbox controllers, and this driver is now preferred over XInput, since it handles more than 4 controllers. 2020-11-24 02:24:05 +00:00			`/* USB usage pages */`
			`#define USB_USAGEPAGE_GENERIC_DESKTOP 0x0001`
			`#define USB_USAGEPAGE_BUTTON 0x0009`

			`/* USB usages for USAGE_PAGE_GENERIC_DESKTOP */`
			`#define USB_USAGE_GENERIC_POINTER 0x0001`
			`#define USB_USAGE_GENERIC_MOUSE 0x0002`
			`#define USB_USAGE_GENERIC_JOYSTICK 0x0004`
			`#define USB_USAGE_GENERIC_GAMEPAD 0x0005`
			`#define USB_USAGE_GENERIC_KEYBOARD 0x0006`
			`#define USB_USAGE_GENERIC_KEYPAD 0x0007`
			`#define USB_USAGE_GENERIC_MULTIAXISCONTROLLER 0x0008`
			`#define USB_USAGE_GENERIC_X 0x0030`
			`#define USB_USAGE_GENERIC_Y 0x0031`
			`#define USB_USAGE_GENERIC_Z 0x0032`
			`#define USB_USAGE_GENERIC_RX 0x0033`
			`#define USB_USAGE_GENERIC_RY 0x0034`
			`#define USB_USAGE_GENERIC_RZ 0x0035`
			`#define USB_USAGE_GENERIC_SLIDER 0x0036`
			`#define USB_USAGE_GENERIC_DIAL 0x0037`
			`#define USB_USAGE_GENERIC_WHEEL 0x0038`
			`#define USB_USAGE_GENERIC_HAT 0x0039`

Added HIDAPI backend for Amazon Luna Controller Model T28B69 connected via Bluetooth LE (VID:0171, PID:0419). To enter Bluetooth pairing mode hold B and Action (button with circle) buttons for 3 seconds. It works via usual HIDAPI if special filter driver is not installed: https://www.amazon.com/gp/help/customer/display.html?nodeId=GZCT4CTFHXLHEB9T With that driver installed it mimics Xbox One controller and works via XInput under Windows. Under DInput this controller is not usable at all. 2021-07-07 13:05:35 +00:00			`/* Bluetooth SIG assigned Company Identifiers`
			`https://www.bluetooth.com/specifications/assigned-numbers/company-identifiers/ */`
			`#define BLUETOOTH_VENDOR_AMAZON 0x0171`

			`#define BLUETOOTH_PRODUCT_LUNA_CONTROLLER 0x0419`

Added missing file from previous commit 2020-01-18 19:21:42 +00:00			`#endif /* usb_ids_h_ */`

			`/* vi: set ts=4 sw=4 expandtab: */`