From bb8eee8fac287c4368b7530d2b1ef78af08c5d29 Mon Sep 17 00:00:00 2001
From: chenzw <[EMAIL REDACTED]>
Date: Fri, 30 Jan 2026 20:53:18 +0800
Subject: [PATCH] Added support for the GameSir-G7 Pro 8K controller
---
VisualC-GDK/SDL/SDL.vcxproj | 1 +
VisualC-GDK/SDL/SDL.vcxproj.filters | 1 +
VisualC/SDL/SDL.vcxproj | 1 +
VisualC/SDL/SDL.vcxproj.filters | 3 +
Xcode/SDL/SDL.xcodeproj/project.pbxproj | 4 +
include/SDL3/SDL_hints.h | 17 +
src/joystick/SDL_gamepad.c | 2 +
src/joystick/SDL_joystick.c | 10 +
src/joystick/SDL_joystick_c.h | 3 +
src/joystick/hidapi/SDL_hidapi_gamesir.c | 1040 ++++++++++++++++++++
src/joystick/hidapi/SDL_hidapijoystick.c | 3 +
src/joystick/hidapi/SDL_hidapijoystick_c.h | 2 +
src/joystick/usb_ids.h | 2 +
13 files changed, 1089 insertions(+)
create mode 100644 src/joystick/hidapi/SDL_hidapi_gamesir.c
diff --git a/VisualC-GDK/SDL/SDL.vcxproj b/VisualC-GDK/SDL/SDL.vcxproj
index c92e3b4f8328c..4ecdb0fb457f2 100644
--- a/VisualC-GDK/SDL/SDL.vcxproj
+++ b/VisualC-GDK/SDL/SDL.vcxproj
@@ -722,6 +722,7 @@
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapijoystick.c" />
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_8bitdo.c" />
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_flydigi.c" />
+ <ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_gamesir.c" />
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_combined.c" />
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_gamecube.c" />
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_gip.c" />
diff --git a/VisualC-GDK/SDL/SDL.vcxproj.filters b/VisualC-GDK/SDL/SDL.vcxproj.filters
index 06bcb2460c467..9970a0834c22d 100644
--- a/VisualC-GDK/SDL/SDL.vcxproj.filters
+++ b/VisualC-GDK/SDL/SDL.vcxproj.filters
@@ -68,6 +68,7 @@
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapijoystick.c" />
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_8bitdo.c" />
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_flydigi.c" />
+ <ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_gamesir.c" />
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_combined.c" />
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_gamecube.c" />
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_gip.c" />
diff --git a/VisualC/SDL/SDL.vcxproj b/VisualC/SDL/SDL.vcxproj
index 4ce70c0261b72..db8a11f436519 100644
--- a/VisualC/SDL/SDL.vcxproj
+++ b/VisualC/SDL/SDL.vcxproj
@@ -823,6 +823,7 @@
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapijoystick.c" />
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_8bitdo.c" />
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_flydigi.c" />
+ <ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_gamesir.c" />
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_combined.c" />
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_gamecube.c" />
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_gip.c" />
diff --git a/VisualC/SDL/SDL.vcxproj.filters b/VisualC/SDL/SDL.vcxproj.filters
index 3c2dab84a9410..0798f3d750eb6 100644
--- a/VisualC/SDL/SDL.vcxproj.filters
+++ b/VisualC/SDL/SDL.vcxproj.filters
@@ -1561,6 +1561,9 @@
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_flydigi.c">
<Filter>joystick\hidapi</Filter>
</ClCompile>
+ <ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_gamesir.c">
+ <Filter>joystick\hidapi</Filter>
+ </ClCompile>
<ClCompile Include="..\..\src\joystick\hidapi\SDL_hidapi_combined.c">
<Filter>joystick\hidapi</Filter>
</ClCompile>
diff --git a/Xcode/SDL/SDL.xcodeproj/project.pbxproj b/Xcode/SDL/SDL.xcodeproj/project.pbxproj
index a7c4f3d01ab86..b7413706328d6 100644
--- a/Xcode/SDL/SDL.xcodeproj/project.pbxproj
+++ b/Xcode/SDL/SDL.xcodeproj/project.pbxproj
@@ -556,6 +556,7 @@
F3FA5A242B59ACE000FEAD97 /* yuv_rgb_lsx.h in Headers */ = {isa = PBXBuildFile; fileRef = F3FA5A1B2B59ACE000FEAD97 /* yuv_rgb_lsx.h */; };
F3FA5A252B59ACE000FEAD97 /* yuv_rgb_common.h in Headers */ = {isa = PBXBuildFile; fileRef = F3FA5A1C2B59ACE000FEAD97 /* yuv_rgb_common.h */; };
F3FBB1082DDF93AB0000F99F /* SDL_hidapi_flydigi.c in Sources */ = {isa = PBXBuildFile; fileRef = F3395BA72D9A5971007246C9 /* SDL_hidapi_flydigi.c */; };
+ F3FBB10A2DDF93AB0000F9A0 /* SDL_hidapi_gamesir.c in Sources */ = {isa = PBXBuildFile; fileRef = F3FBB1092DDF93AB0000F9A0 /* SDL_hidapi_gamesir.c */; };
F3FD042E2C9B755700824C4C /* SDL_hidapi_nintendo.h in Headers */ = {isa = PBXBuildFile; fileRef = F3FD042C2C9B755700824C4C /* SDL_hidapi_nintendo.h */; };
F3FD042F2C9B755700824C4C /* SDL_hidapi_steam_hori.c in Sources */ = {isa = PBXBuildFile; fileRef = F3FD042D2C9B755700824C4C /* SDL_hidapi_steam_hori.c */; };
FA73671D19A540EF004122E4 /* CoreVideo.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = FA73671C19A540EF004122E4 /* CoreVideo.framework */; platformFilters = (ios, maccatalyst, macos, tvos, ); settings = {ATTRIBUTES = (Required, ); }; };
@@ -969,6 +970,7 @@
F338A1192D1B37E4007CDFDF /* SDL_tray.c */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.c; path = SDL_tray.c; sourceTree = "<group>"; };
F3395BA72D9A5971007246C8 /* SDL_hidapi_8bitdo.c */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.c; path = SDL_hidapi_8bitdo.c; sourceTree = "<group>"; };
F3395BA72D9A5971007246C9 /* SDL_hidapi_flydigi.c */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.c; path = SDL_hidapi_flydigi.c; sourceTree = "<group>"; };
+ F3FBB1092DDF93AB0000F9A0 /* SDL_hidapi_gamesir.c */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.c; path = SDL_hidapi_gamesir.c; sourceTree = "<group>"; };
F344003C2D4022E1003F26D7 /* INSTALL.md */ = {isa = PBXFileReference; lastKnownFileType = net.daringfireball.markdown; path = INSTALL.md; sourceTree = "<group>"; };
F362B9152B3349E200D30B94 /* controller_list.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = controller_list.h; sourceTree = "<group>"; };
F362B9162B3349E200D30B94 /* SDL_gamepad_c.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = SDL_gamepad_c.h; sourceTree = "<group>"; };
@@ -1966,6 +1968,7 @@
F32305FE28939F6400E66D30 /* SDL_hidapi_combined.c */,
F3E6C38F2EE9F20000A6B39E /* SDL_hidapi_flydigi.h */,
F3395BA72D9A5971007246C9 /* SDL_hidapi_flydigi.c */,
+ F3FBB1092DDF93AB0000F9A0 /* SDL_hidapi_gamesir.c */,
A7D8A7C923E2513E00DCD162 /* SDL_hidapi_gamecube.c */,
F3B6B8092DC3EA54004954FD /* SDL_hidapi_gip.c */,
89E5801D2D03602200DAF6D3 /* SDL_hidapi_lg4ff.c */,
@@ -3150,6 +3153,7 @@
00002B20A48E055EB0350000 /* SDL_camera_coremedia.m in Sources */,
000080903BC03006F24E0000 /* SDL_filesystem.c in Sources */,
F3FBB1082DDF93AB0000F99F /* SDL_hidapi_flydigi.c in Sources */,
+ F3FBB10A2DDF93AB0000F9A0 /* SDL_hidapi_gamesir.c in Sources */,
0000481D255AF155B42C0000 /* SDL_sysfsops.c in Sources */,
0000494CC93F3E624D3C0000 /* SDL_systime.c in Sources */,
000095FA1BDE436CF3AF0000 /* SDL_time.c in Sources */,
diff --git a/include/SDL3/SDL_hints.h b/include/SDL3/SDL_hints.h
index 2f01e8d267aec..94800dacae4d7 100644
--- a/include/SDL3/SDL_hints.h
+++ b/include/SDL3/SDL_hints.h
@@ -1893,6 +1893,23 @@ extern "C" {
*/
#define SDL_HINT_JOYSTICK_HIDAPI_FLYDIGI "SDL_JOYSTICK_HIDAPI_FLYDIGI"
+/**
+ * A variable controlling whether the HIDAPI driver for GameSir controllers
+ * should be used.
+ *
+ * The variable can be set to the following values:
+ *
+ * - "0": HIDAPI driver is not used.
+ * - "1": HIDAPI driver is used.
+ *
+ * The default is the value of SDL_HINT_JOYSTICK_HIDAPI.
+ *
+ * This hint should be set before initializing joysticks and gamepads.
+ *
+ * \since This hint is available since SDL 3.5.0.
+ */
+#define SDL_HINT_JOYSTICK_HIDAPI_GAMESIR "SDL_JOYSTICK_HIDAPI_GAMESIR"
+
/**
* A variable controlling whether the HIDAPI driver for Nintendo Switch
* controllers should be used.
diff --git a/src/joystick/SDL_gamepad.c b/src/joystick/SDL_gamepad.c
index 09f11e133a990..95c9e0fc49baf 100644
--- a/src/joystick/SDL_gamepad.c
+++ b/src/joystick/SDL_gamepad.c
@@ -1266,6 +1266,8 @@ static GamepadMapping_t *SDL_CreateMappingForHIDAPIGamepad(SDL_GUID guid)
// Apex 5 has additional shoulder macro buttons
SDL_strlcat(mapping_string, "misc2:b15,misc3:b16,", sizeof(mapping_string));
}
+ } else if (SDL_IsJoystickGameSirController(vendor, product)) {
+ SDL_strlcat(mapping_string, "paddle1:b11,paddle2:b12,paddle3:b13,paddle4:b14,misc2:b15,misc3:b16,", sizeof(mapping_string));
} else if (vendor == USB_VENDOR_8BITDO && product == USB_PRODUCT_8BITDO_ULTIMATE2_WIRELESS) {
SDL_strlcat(mapping_string, "paddle1:b12,paddle2:b11,paddle3:b14,paddle4:b13,", sizeof(mapping_string));
} else {
diff --git a/src/joystick/SDL_joystick.c b/src/joystick/SDL_joystick.c
index c3bfa6b792ef8..d3fc824d6bb9a 100644
--- a/src/joystick/SDL_joystick.c
+++ b/src/joystick/SDL_joystick.c
@@ -3314,6 +3314,16 @@ bool SDL_IsJoystickFlydigiController(Uint16 vendor_id, Uint16 product_id)
return false;
}
+bool SDL_IsJoystickGameSirController(Uint16 vendor_id, Uint16 product_id)
+{
+ if (vendor_id != USB_VENDOR_GAMESIR) {
+ return false;
+ }
+
+ return (product_id == USB_PRODUCT_GAMESIR_GAMEPAD_G7_PRO_HID ||
+ product_id == USB_PRODUCT_GAMESIR_GAMEPAD_G7_PRO_8K_HID);
+}
+
bool SDL_IsJoystickSteamDeck(Uint16 vendor_id, Uint16 product_id)
{
EControllerType eType = GuessControllerType(vendor_id, product_id);
diff --git a/src/joystick/SDL_joystick_c.h b/src/joystick/SDL_joystick_c.h
index 55665db6daf09..2eac02b9304d8 100644
--- a/src/joystick/SDL_joystick_c.h
+++ b/src/joystick/SDL_joystick_c.h
@@ -141,6 +141,9 @@ extern bool SDL_IsJoystickSInputController(Uint16 vendor_id, Uint16 product_id);
// Function to return whether a joystick is a Flydigi controller
extern bool SDL_IsJoystickFlydigiController(Uint16 vendor_id, Uint16 product_id);
+// Function to return whether a joystick is a GameSir controller
+extern bool SDL_IsJoystickGameSirController(Uint16 vendor_id, Uint16 product_id);
+
// Function to return whether a joystick is a Steam Deck
extern bool SDL_IsJoystickSteamDeck(Uint16 vendor_id, Uint16 product_id);
diff --git a/src/joystick/hidapi/SDL_hidapi_gamesir.c b/src/joystick/hidapi/SDL_hidapi_gamesir.c
new file mode 100644
index 0000000000000..a7d7d22761b9c
--- /dev/null
+++ b/src/joystick/hidapi/SDL_hidapi_gamesir.c
@@ -0,0 +1,1040 @@
+/*
+ Simple DirectMedia Layer
+ Copyright (C) 1997-2026 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.
+*/
+
+#include "SDL_internal.h"
+
+#ifdef SDL_JOYSTICK_HIDAPI
+
+#include "../SDL_sysjoystick.h"
+#include "SDL_hidapijoystick_c.h"
+#include "SDL_hidapi_rumble.h"
+
+#ifdef SDL_JOYSTICK_HIDAPI_GAMESIR
+
+#define GAMESIR_PACKET_HEADER_0 0xA1
+#define GAMESIR_PACKET_HEADER_1_GAMEPAD 0xC8
+
+
+#define BTN_A 0x01
+#define BTN_B 0x02
+#define BTN_C 0x04
+#define BTN_X 0x08
+#define BTN_Y 0x10
+#define BTN_Z 0x20
+#define BTN_L1 0x40
+#define BTN_R1 0x80
+
+
+#define BTN_L2 0x01
+#define BTN_R2 0x02
+#define BTN_SELECT 0x04
+#define BTN_START 0x08
+#define BTN_HOME 0x10
+#define BTN_L3 0x20
+#define BTN_R3 0x40
+#define BTN_CAPTURE 0x80
+
+
+#define BTN_UP 0x01
+#define BTN_UP_L 0x08
+#define BTN_UP_R 0x02
+#define BTN_DOWN 0x05
+#define BTN_DOWN_L 0x06
+#define BTN_DOWN_R 0X04
+#define BTN_LEFT 0x07
+#define BTN_RIGHT 0x03
+
+
+#define BTN_M 0x10
+#define BTN_MUTE 0x20
+#define BTN_L4 0x40
+#define BTN_R4 0x80
+
+
+#define BTN_L5 0x01
+#define BTN_R5 0x02
+#define BTN_L6 0x04
+#define BTN_R6 0x08
+#define BTN_L7 0x10
+#define BTN_R7 0x20
+#define BTN_L8 0x40
+#define BTN_R8 0x80
+
+#ifndef DEG2RAD
+#define DEG2RAD(x) ((float)(x) * (float)(SDL_PI_F / 180.f))
+#endif
+
+#define LOAD16(A, B) (Sint16)((Uint16)(A) | (((Uint16)(B)) << 8))
+
+typedef struct {
+ Uint8 cmd;
+ Uint8 mode;
+} Gamesir_CommandMode;
+
+typedef struct {
+ bool sensors_supported;
+ bool sensors_enabled;
+ Uint64 sensor_timestamp_ns;
+ Uint64 sensor_timestamp_step_ns;
+ float accelScale;
+ float gyroScale;
+ Uint8 last_state[USB_PACKET_LENGTH];
+ SDL_hid_device *output_handle;
+} SDL_DriverGamesir_Context;
+
+
+static void HIDAPI_DriverGameSir_RegisterHints(SDL_HintCallback callback, void *userdata)
+{
+ SDL_AddHintCallback(SDL_HINT_JOYSTICK_HIDAPI_GAMESIR, callback, userdata);
+}
+
+
+static void HIDAPI_DriverGameSir_UnregisterHints(SDL_HintCallback callback, void *userdata)
+{
+ SDL_RemoveHintCallback(SDL_HINT_JOYSTICK_HIDAPI_GAMESIR, callback, userdata);
+}
+
+
+static bool HIDAPI_DriverGameSir_IsEnabled(void)
+{
+ return SDL_GetHintBoolean(SDL_HINT_JOYSTICK_HIDAPI_GAMESIR, SDL_GetHintBoolean(SDL_HINT_JOYSTICK_HIDAPI, SDL_HIDAPI_DEFAULT));
+}
+
+
+static bool HIDAPI_DriverGameSir_IsSupportedDevice(SDL_HIDAPI_Device *device, const char *name, SDL_GamepadType type, Uint16 vendor_id, Uint16 product_id, Uint16 version, int interface_number, int interface_class, int interface_subclass, int interface_protocol)
+{
+ return SDL_IsJoystickGameSirController(vendor_id, product_id);
+}
+
+
+static bool SendGameSirModeSwitch(SDL_HIDAPI_Device *device)
+{
+ Gamesir_CommandMode cmd = { 0x01 };
+ Uint8 buf[64];
+ SDL_zero(buf);
+ buf[0] = 0xA2;
+ SDL_memcpy(buf + 1, &cmd, sizeof(cmd));
+
+ SDL_hid_device *handle = NULL;
+#if defined(SDL_PLATFORM_WIN32) || defined(SDL_PLATFORM_WINGDK)
+ SDL_DriverGamesir_Context *ctx = (SDL_DriverGamesir_Context *)device->context;
+ if (ctx && ctx->output_handle) {
+ handle = ctx->output_handle;
+ }
+#else
+ handle = device->dev;
+#endif
+ if (handle == NULL) {
+ SDL_SetError("Gamesir: output handle is null");
+ return false;
+ }
+ for (int attempt = 0; attempt < 3; ++attempt) {
+ int result = SDL_hid_write(handle, buf, sizeof(buf));
+ if (result < 0) {
+ return false;
+ }
+
+
+ for (int i = 0; i < 10; ++i) {
+ SDL_Delay(1);
+
+ Uint8 data[USB_PACKET_LENGTH] = {0};
+ int size = SDL_hid_read_timeout(handle, data, sizeof(data), 0);
+ if (size < 0) {
+ break;
+ }
+ if (size == 0) {
+ continue;
+ }
+
+ if (size == 64 && data[0] == 0xA1 && data[1] == 0x43 && data[2] == 0x01) {
+ return true;
+ }
+ }
+ }
+
+ SDL_Delay(10);
+ return true;
+}
+
+#if defined(SDL_PLATFORM_WIN32) || defined(SDL_PLATFORM_WINGDK)
+#include <windows.h>
+#include <setupapi.h>
+#include <hidsdi.h>
+#if defined(SDL_PLATFORM_WIN32) && defined(_MSC_VER)
+ #pragma comment(lib, "setupapi.lib")
+ #pragma comment(lib, "hid.lib")
+#endif
+
+
+static char *FindHIDInterfacePath(USHORT vid, USHORT pid, int collection_index ) {
+ GUID hidGuid;
+ HidD_GetHidGuid(&hidGuid);
+
+ HDEVINFO deviceInfoSet = SetupDiGetClassDevs(&hidGuid, NULL, NULL, DIGCF_PRESENT | DIGCF_DEVICEINTERFACE);
+ if (deviceInfoSet == INVALID_HANDLE_VALUE) {
+ return NULL;
+ }
+
+ SP_DEVICE_INTERFACE_DATA deviceInterfaceData;
+ deviceInterfaceData.cbSize = sizeof(SP_DEVICE_INTERFACE_DATA);
+
+ for (DWORD i = 0; SetupDiEnumDeviceInterfaces(deviceInfoSet, NULL, &hidGuid, i, &deviceInterfaceData); i++) {
+ DWORD requiredSize = 0;
+ SetupDiGetDeviceInterfaceDetail(deviceInfoSet, &deviceInterfaceData, NULL, 0, &requiredSize, NULL);
+
+ PSP_DEVICE_INTERFACE_DETAIL_DATA deviceDetail = (PSP_DEVICE_INTERFACE_DETAIL_DATA)SDL_malloc(requiredSize);
+ if (!deviceDetail) continue;
+ deviceDetail->cbSize = sizeof(SP_DEVICE_INTERFACE_DETAIL_DATA);
+
+ if (!SetupDiGetDeviceInterfaceDetail(deviceInfoSet, &deviceInterfaceData, deviceDetail, requiredSize, NULL, NULL)) {
+ SDL_free(deviceDetail);
+ continue;
+ }
+
+
+ HANDLE hDevice = CreateFile(deviceDetail->DevicePath,
+ GENERIC_READ | GENERIC_WRITE,
+ FILE_SHARE_READ | FILE_SHARE_WRITE,
+ NULL,
+ OPEN_EXISTING,
+ FILE_FLAG_OVERLAPPED,
+ NULL);
+
+ if (hDevice == INVALID_HANDLE_VALUE) {
+ SDL_free(deviceDetail);
+ continue;
+ }
+
+
+ HIDD_ATTRIBUTES attributes;
+ attributes.Size = sizeof(attributes);
+ if (!HidD_GetAttributes(hDevice, &attributes) ||
+ attributes.VendorID != vid ||
+ attributes.ProductID != pid) {
+ CloseHandle(hDevice);
+ SDL_free(deviceDetail);
+ continue;
+ }
+
+
+ PHIDP_PREPARSED_DATA preparsedData = NULL;
+ if (!HidD_GetPreparsedData(hDevice, &preparsedData) || !preparsedData) {
+ CloseHandle(hDevice);
+ SDL_free(deviceDetail);
+ continue;
+ }
+
+ HIDP_CAPS caps;
+ if (HidP_GetCaps(preparsedData, &caps) != HIDP_STATUS_SUCCESS) {
+ HidD_FreePreparsedData(preparsedData);
+ CloseHandle(hDevice);
+ SDL_free(deviceDetail);
+ continue;
+ }
+
+
+ if (caps.InputReportByteLength == 64 && caps.OutputReportByteLength == 64 ||
+ caps.InputReportByteLength == 37 && caps.OutputReportByteLength == 37) {
+
+ char col_str[16];
+ snprintf(col_str, sizeof(col_str), "col%02d", collection_index);
+ if (SDL_strcasestr(deviceDetail->DevicePath, col_str)) {
+ char *result = SDL_strdup(deviceDetail->DevicePath);
+ HidD_FreePreparsedData(preparsedData);
+ CloseHandle(hDevice);
+ SDL_free(deviceDetail);
+ SetupDiDestroyDeviceInfoList(deviceInfoSet);
+ return result;
+ }
+ }
+
+ HidD_FreePreparsedData(preparsedData);
+ CloseHandle(hDevice);
+ SDL_free(deviceDetail);
+ }
+
+ SetupDiDestroyDeviceInfoList(deviceInfoSet);
+ return NULL;
+}
+#endif
+
+
+static bool HIDAPI_DriverGameSir_InitDevice(SDL_HIDAPI_Device *device)
+{
+ Uint16 vendor_id = device->vendor_id;
+ Uint16 product_id = device->product_id;
+ SDL_hid_device *output_handle = NULL;
+
+ struct SDL_hid_device_info *devs = SDL_hid_enumerate(vendor_id, product_id);
+ for (struct SDL_hid_device_info *info = devs; info; info = info->next) {
+ if (info->interface_number == 0) {
+#if defined(SDL_PLATFORM_WIN32) || defined(SDL_PLATFORM_WINGDK)
+ if (!output_handle) {
+ char *col02_path = FindHIDInterfacePath(vendor_id, product_id, 2);
+ if (col02_path) {
+ output_handle = SDL_hid_open_path(col02_path);
+ SDL_free(col02_path);
+ }
+ }
+#else
+
+#endif
+ }
+ if (info->interface_number == -1) {
+#if defined(SDL_PLATFORM_WIN32) || defined(SDL_PLATFORM_WINGDK)
+ if (info->usage_page == 0x0001 && info->usage == 0x0005) {
+ output_handle = SDL_hid_open_path(info->path);
+ if (output_handle) {
+ SDL_Log("GameSir: Opened output interface via path pattern");
+ break;
+ }
+
+ }
+#endif
+ }
+ else if (!output_handle && info->interface_number == 1) {
+ output_handle = SDL_hid_open_path(info->path);
+ }
+ }
+ SDL_hid_free_enumeration(devs);
+
+ SDL_DriverGamesir_Context *ctx = (SDL_DriverGamesir_Context *)SDL_calloc(1, sizeof(*ctx));
+ if (!ctx) {
+ SDL_hid_close(device->dev);
+ if (output_handle) {
+ SDL_hid_close(output_handle);
+ }
+ return false;
+ }
+
+ ctx->output_handle = output_handle;
+ device->context = ctx;
+
+
+ switch (device->product_id) {
+ case USB_PRODUCT_GAMESIR_GAMEPAD_G7_PRO_HID:
+ HIDAPI_SetDeviceName(device, "GameSir-G7 Pro (HID)");
+ ctx->sensors_supported = true;
+ SDL_Log("GameSir: Device detected - G7 Pro HID mode (PID 0x%04X)", device->product_id);
+ break;
+ case USB_PRODUCT_GAMESIR_GAMEPAD_G7_PRO_8K_HID:
+ HIDAPI_SetDeviceName(device, "GameSir-G7 Pro 8K (HID)");
+ ctx->sensors_supported = true;
+ SDL_Log("GameSir: Device detected - G7 Pro 8K HID mode (PID 0x%04X)", device->product_id);
+ break;
+ default:
+ HIDAPI_SetDeviceName(device, "GameSir Controller");
+ break;
+ }
+ SendGameSirModeSwitch(device);
+
+ return HIDAPI_JoystickConnected(device, NULL);
+}
+
+
+static int HIDAPI_DriverGameSir_GetDevicePlayerIndex(SDL_HIDAPI_Device *device, SDL_JoystickID instance_id)
+{
+ return -1;
+}
+
+
+static void HIDAPI_DriverGameSir_SetDevicePlayerIndex(SDL_HIDAPI_Device *device, SDL_JoystickID instance_id, int player_index)
+{
+}
+
+
+static bool HIDAPI_DriverGameSir_OpenJoystick(SDL_HIDAPI_Device *device, SDL_Joystick *joystick)
+{
+ SDL_DriverGamesir_Context *ctx = (SDL_DriverGamesir_Context *)device->context;
+
+ SDL_AssertJoysticksLocked();
+
+ if (!ctx) {
+ return false;
+ }
+
+ SDL_zeroa(ctx->last_state);
+
+
+
+ SendGameSirModeSwitch(device);
+
+
+ if (device->product_id == USB_PRODUCT_GAMESIR_GAMEPAD_G7_PRO_HID) {
+ if (device->is_bluetooth) {
+ joystick->connection_state = SDL_JOYSTICK_CONNECTION_WIRELESS;
+ SDL_Log("GameSir: Joystick opened - Connection type: Bluetooth (wireless, HID mode)");
+ } else {
+ joystick->connection_state = SDL_JOYSTICK_CONNECTION_WIRED;
+ SDL_Log("GameSir: Joystick opened - Connection type: USB/2.4G (HID mode)");
+ }
+ } else if (device->product_id == USB_PRODUCT_GAMESIR_GAMEPAD_G7_PRO_8K_HID) {
+ if (device->is_bluetooth) {
+ joystick->connection_state = SDL_JOYSTICK_CONNECTION_WIRELESS;
+ SDL_Log("GameSir: Joystick opened - Connection type: Bluetooth (wireless, 8K HID mode)");
+ } else {
+ joystick->connection_state = SDL_JOYSTICK_CONNECTION_WIRED;
+ SDL_Log("GameSir: Joystick opened - Connection type: USB/2.4G (8K HID mode)");
+ }
+ } else if (device->is_bluetooth) {
+ joystick->connection_state = SDL_JOYSTICK_CONNECTION_WIRELESS;
+ SDL_Log("GameSir: Joystick opened - Connection type: Bluetooth (wireless)");
+ } else {
+ joystick->connection_state = SDL_JOYSTICK_CONNECTION_WIRED;
+ SDL_Log("GameSir: Joystick opened - Connection type: USB (wired)");
+ }
+
+
+ joystick->nbuttons = 35;
+ joystick->naxes = SDL_GAMEPAD_AXIS_COUNT;
+ joystick->nhats = 1;
+
+ if (ctx->sensors_supported) {
+
+
+ ctx->sensor_timestamp_step_ns = SDL_NS_PER_SECOND / 125;
+ // 加速度计缩放因子：假设范围为±2g，16位带符号值（-32768到32767）
+ // 32768对应2g，所以缩放因子 = 2 * SDL_STANDARD_GRAVITY / 32768.0f
+ ctx->accelScale = 2.0f * SDL_STANDARD_GRAVITY / 32768.0f;
+
+ // 陀螺仪缩放因子：参考PS4的实现方式
+ // PS4使用 (gyro_numerator / gyro_denominator) * (π / 180)
+ // 默认值为 (1 / 16) * (π / 180)，对应量程约为 ±2048 度/秒
+ // 这是游戏手柄陀螺仪的常见量程
+ const float gyro_numerator = 1.0f;
+ const float gyro_denominator = 16.0f;
+ ctx->gyroScale = (gyro_numerator / gyro_denominator) * (SDL_PI_F / 180.0f);
+
+ const float flSensorRate = 1000.0f;
+ SDL_PrivateJoystickAddSensor(joystick, SDL_SENSOR_GYRO, flSensorRate);
+ SDL_PrivateJoystickAddSensor(joystick, SDL_SENSOR_ACCEL, flSensorRate);
+ }
+
+ return true;
+}
+
+
+static bool HIDAPI_DriverGameSir_RumbleJoystick(SDL_HIDAPI_Device *device, SDL_Joystick *joystick, Uint16 low_frequency_rumble, Uint16 high_frequency_rumble)
+{
+ if (!device) {
+ return false;
+ }
+ SDL_DriverGamesir_Context *ctx = (SDL_DriverGamesir_Context *)device->context;
+ if (!ctx) {
+ return false;
+ }
+ Uint8 buf[64];
+ SDL_zero(buf);
+
+ buf[0] = 0xA2;
+ buf[1] = 0x03;
+
+
+ buf[2] = (Uint8)(low_frequency_rumble / 256);
+
+
+ buf[3] = (Uint8)(high_frequency_rumble / 256);
+
+ SDL_hid_device *handle = NULL;
+#if defined(SDL_PLATFORM_WIN32) || defined(SDL_PLATFORM_WINGDK)
+ if (ctx && ctx->output_handle) {
+ handle = ctx->output_handle;
+ }
+#else
+ handle = device->dev;
+#endif
+
+ if (handle == NULL) {
+ SDL_SetError("Gamesir: output handle is null");
+ return false;
+ }
+
+ int result = SDL_hid_write(handle, buf, sizeof(buf));
+ if (result < 0) {
+ SDL_SetError("Gamesir: Failed to send rumble command, error: %s", SDL_GetError());
+ return false;
+ }
+
+ return true;
+}
+
+
+static bool HIDAPI_DriverGameSir_RumbleJoystickTriggers(SDL_HIDAPI_Device *device, SDL_Joystick *joystick, Uint16 left_rumble, Uint16 right_rumble)
+{
+ if (!device) {
+ return false;
+ }
+ SDL_DriverGamesir_Context *ctx = (SDL_DriverGamesir_Context *)device->context;
+ if (!ctx) {
+ return false;
+ }
+ Uint8 buf[64];
+ SDL_zero(buf);
+
+ buf[0] = 0xA2;
+ buf[1] = 0x03;
+
+
+ buf[4] = (Uint8)(left_rumble / 256);
+
+
+ buf[5] = (Uint8)(right_rumble / 256);
+
+ SDL_hid_device *handle = NULL;
+#if defined(SDL_PLATFORM_WIN32) || defined(SDL_PLATFORM_WINGDK)
+ if (ctx && ctx->output_handle) {
+ handle = ctx->output_handle;
+ }
+#else
+ handle = device->dev;
+#endif
+
+ if (handle == NULL) {
+ SDL_SetError("Gamesir: output handle is null");
+ return false;
+ }
+
+ int result = SDL_hid_write(handle, buf, sizeof(buf));
+ if (result < 0) {
+ SDL_SetError("Gamesir: Failed to send trigger rumble command, error: %s", SDL_GetError());
+ return false;
+ }
+
+ return true;
+}
+
+
+static Uint32 HIDAPI_DriverGameSir_GetJoystickCapabilities(SDL_HIDAPI_Device *device, SDL_Joystick *joystick)
+{
+ SDL_DriverGamesir_Context *ctx = (SDL_DriverGamesir_Context *)device->context;
+ Uint32 caps = SDL_JOYSTICK_CAP_RUMBLE | SDL_JOYSTICK_CAP_TRIGGER_RUMBLE;
+ if (ctx && ctx->sensors_supported) {
+
+
+ }
+ return caps;
+}
+
+
+static bool HIDAPI_DriverGameSir_SetJoystickLED(SDL_HIDAPI_Device *device, SDL_Joystick *joystick, Uint8 red, Uint8 green, Uint8 blue)
+{
+ if (!device) {
+ return false;
+ }
+
+
+ if (device->product_id == USB_PRODUCT_GAMESIR_GAMEPAD_G7_PRO_HID ||
+ device->product_id == USB_PRODUCT_GAMESIR_GAMEPAD_G7_PRO_8K_HID) {
+ return SDL_Unsupported();
+ }
+
+ SDL_DriverGamesir_Context *ctx = (SDL_DriverGamesir_Context *)device->context;
+ if (!ctx) {
+ return false;
+ }
+ Uint8 buf[64];
+ SDL_zero(buf);
+
+ buf[0] = 0xA2;
+ buf[1] = 0x04;
+ buf[2] = 0x01;
+ buf[3] = 0x01;
+
+
+ buf[4] = red;
+ buf[5] = green;
+ buf[6] = blue;
+
+ SDL_hid_device *handle = NULL;
+#if defined(SDL_PLATFORM_WIN32) || defined(SDL_PLATFORM_WINGDK)
+ if (ctx && ctx->output_handle) {
+ handle = ctx->output_handle;
+ }
+#else
+ handle = device->dev;
+#endif
+
+ if (handle == NULL) {
+ SDL_SetError("Gamesir: output handle is null");
+ return false;
+ }
+
+ int result = SDL_hid_write(handle, buf, sizeof(buf));
+ if (result < 0) {
+ SDL_SetError("Gamesir: Failed to send LED command, error: %s", SDL_GetError());
+ return false;
+ }
+
+ return true;
+}
+
+static bool HIDAPI_DriverGameSir_SendJoystickEffect(SDL_HIDAPI_Device *device, SDL_Joystick *joystick, const void *data, int size)
+{
+ return SDL_Unsupported();
+}
+
+static bool HIDAPI_DriverGameSir_SetJoystickSensorsEnabled(SDL_HIDAPI_Device *device, SDL_Joystick *joystick, bool enabled)
+{
+ SDL_DriverGamesir_Context *ctx = (SDL_DriverGamesir_Context *)device->context;
+ if (ctx && ctx->sensors_supported) {
+ ctx->sensors_enabled = enabled;
+ return true;
+ }
+ return SDL_Unsupported();
+}
+
+static bool ApplyCircularDeadzone(Sint16 x, Sint16 y, Sint16 *out_x, Sint16 *out_y)
+{
+ const Sint16 MAX_AXIS = 32767;
+ const float deadzone_percent = 5.0f;
+ const float deadzone_radius = (float)MAX_AXIS * deadzone_percent / 100.0f;
+
+
+ float distance = SDL_sqrtf((float)x * (float)x + (float)y * (float)y);
+ if (distance == 0.0f) {
+ *out_x = 0;
+ *out_y = 0;
+ return false;
+ }
+
+ if (distance < deadzone_radius) {
+
+ *out_x = 0;
+ *out_y = 0;
+ return false;
+ }
+
+ float scale = (distance - deadzone_radius) / (MAX_AXIS - deadzone_radius);
+ float normalized_x = (float)x / distance;
+ float normalized_y = (float)y / distance;
+
+ *out_x = (Sint16)(normalized_x * scale * MAX_AXIS);
+ *out_y = (Sint16)(normalized_y * scale * MAX_AXIS);
+
+ return true;
+}
+
+static void HIDAPI_DriverGameSir_HandleStatePacket(SDL_Joystick *joystick, SDL_DriverGamesir_Context *ctx, Uint8 *data, int size)
+{
+ Sint16 axis;
+ Uint64 timestamp = SDL_GetTicksNS();
+
+ if (!joystick || !ctx || !data || size <= 0) {
+ return;
+ }
+
+ // 检查数据包格式：可能包含报告ID（0x43）作为第一个字节
+ // 实际数据包格式：43 a1 c8 [按钮数据...]
+ // 如果第一个字节是0x43，第二个字节是0xa1，第三个字节是0xc8，则跳过报告ID
+ Uint8 *packet_data = data;
+ int packet_size = size;
+
+ if (size >= 3 && data[0] == 0x43 && data[1] == GAMESIR_PACKET_HEADER_0 && data[2] == GAMESIR_PACKET_HEADER_1_GAMEPAD) {
+ // 数据包包含报告ID，跳过第一个字节
+ packet_data = data + 1;
+ packet_size = size - 1;
+ } else if (size >= 2 && data[0] == GAMESIR_PACKET_HEADER_0 && data[1] == GAMESIR_PACKET_HEADER_1_GAMEPAD) {
+ // 标准格式：没有报告ID，直接是头部字节
+ packet_data = data;
+ packet_size = size;
+ } else {
+ // 不匹配的数据包格式，直接返回
+ return;
+ }
+
+ bool is_initial_packet = (ctx->last_state[0] == 0 && ctx->last_state[1] == 0 && ctx->last_state[
(Patch may be truncated, please check the link at the top of this post.)