| /* |
| Simple DirectMedia Layer |
| Copyright (C) 1997-2025 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_hints_c.h" |
| #include "../SDL_sysjoystick.h" |
| #include "SDL_hidapijoystick_c.h" |
| #include "SDL_hidapi_rumble.h" |
| |
| #ifdef SDL_JOYSTICK_HIDAPI_XBOX360 |
| |
| // Define this if you want to log all packets from the controller |
| // #define DEBUG_XBOX_PROTOCOL |
| |
| typedef struct |
| { |
| SDL_HIDAPI_Device *device; |
| bool connected; |
| int player_index; |
| bool player_lights; |
| Uint8 last_state[USB_PACKET_LENGTH]; |
| } SDL_DriverXbox360W_Context; |
| |
| static void HIDAPI_DriverXbox360W_RegisterHints(SDL_HintCallback callback, void *userdata) |
| { |
| SDL_AddHintCallback(SDL_HINT_JOYSTICK_HIDAPI_XBOX, callback, userdata); |
| SDL_AddHintCallback(SDL_HINT_JOYSTICK_HIDAPI_XBOX_360, callback, userdata); |
| SDL_AddHintCallback(SDL_HINT_JOYSTICK_HIDAPI_XBOX_360_WIRELESS, callback, userdata); |
| } |
| |
| static void HIDAPI_DriverXbox360W_UnregisterHints(SDL_HintCallback callback, void *userdata) |
| { |
| SDL_RemoveHintCallback(SDL_HINT_JOYSTICK_HIDAPI_XBOX, callback, userdata); |
| SDL_RemoveHintCallback(SDL_HINT_JOYSTICK_HIDAPI_XBOX_360, callback, userdata); |
| SDL_RemoveHintCallback(SDL_HINT_JOYSTICK_HIDAPI_XBOX_360_WIRELESS, callback, userdata); |
| } |
| |
| static bool HIDAPI_DriverXbox360W_IsEnabled(void) |
| { |
| return SDL_GetHintBoolean(SDL_HINT_JOYSTICK_HIDAPI_XBOX_360_WIRELESS, |
| SDL_GetHintBoolean(SDL_HINT_JOYSTICK_HIDAPI_XBOX_360, SDL_GetHintBoolean(SDL_HINT_JOYSTICK_HIDAPI_XBOX, SDL_GetHintBoolean(SDL_HINT_JOYSTICK_HIDAPI, SDL_HIDAPI_DEFAULT)))); |
| } |
| |
| static bool HIDAPI_DriverXbox360W_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) |
| { |
| const int XB360W_IFACE_PROTOCOL = 129; // Wireless |
| |
| if ((vendor_id == USB_VENDOR_MICROSOFT && (product_id == USB_PRODUCT_XBOX360_WIRELESS_RECEIVER_THIRDPARTY2 || product_id == USB_PRODUCT_XBOX360_WIRELESS_RECEIVER_THIRDPARTY1 || product_id == USB_PRODUCT_XBOX360_WIRELESS_RECEIVER) && interface_protocol == 0) || |
| (type == SDL_GAMEPAD_TYPE_XBOX360 && interface_protocol == XB360W_IFACE_PROTOCOL)) { |
| return true; |
| } |
| return false; |
| } |
| |
| static bool SetSlotLED(SDL_hid_device *dev, Uint8 slot, bool on) |
| { |
| const bool blink = false; |
| Uint8 mode = on ? ((blink ? 0x02 : 0x06) + slot) : 0; |
| Uint8 led_packet[] = { 0x00, 0x00, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 }; |
| |
| led_packet[3] = 0x40 + (mode % 0x0e); |
| if (SDL_hid_write(dev, led_packet, sizeof(led_packet)) != sizeof(led_packet)) { |
| return false; |
| } |
| return true; |
| } |
| |
| static void UpdateSlotLED(SDL_DriverXbox360W_Context *ctx) |
| { |
| if (ctx->player_lights && ctx->player_index >= 0) { |
| SetSlotLED(ctx->device->dev, (ctx->player_index % 4), true); |
| } else { |
| SetSlotLED(ctx->device->dev, 0, false); |
| } |
| } |
| |
| static void SDLCALL SDL_PlayerLEDHintChanged(void *userdata, const char *name, const char *oldValue, const char *hint) |
| { |
| SDL_DriverXbox360W_Context *ctx = (SDL_DriverXbox360W_Context *)userdata; |
| bool player_lights = SDL_GetStringBoolean(hint, true); |
| |
| if (player_lights != ctx->player_lights) { |
| ctx->player_lights = player_lights; |
| |
| UpdateSlotLED(ctx); |
| HIDAPI_UpdateDeviceProperties(ctx->device); |
| } |
| } |
| |
| static void UpdatePowerLevel(SDL_Joystick *joystick, Uint8 level) |
| { |
| int percent = (int)SDL_roundf((level / 255.0f) * 100.0f); |
| SDL_SendJoystickPowerInfo(joystick, SDL_POWERSTATE_ON_BATTERY, percent); |
| } |
| |
| static bool HIDAPI_DriverXbox360W_InitDevice(SDL_HIDAPI_Device *device) |
| { |
| SDL_DriverXbox360W_Context *ctx; |
| |
| // Requests controller presence information from the wireless dongle |
| const Uint8 init_packet[] = { 0x08, 0x00, 0x0F, 0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 }; |
| |
| HIDAPI_SetDeviceName(device, "Xbox 360 Wireless Controller"); |
| |
| ctx = (SDL_DriverXbox360W_Context *)SDL_calloc(1, sizeof(*ctx)); |
| if (!ctx) { |
| return false; |
| } |
| ctx->device = device; |
| |
| device->context = ctx; |
| |
| if (SDL_hid_write(device->dev, init_packet, sizeof(init_packet)) != sizeof(init_packet)) { |
| SDL_SetError("Couldn't write init packet"); |
| return false; |
| } |
| |
| device->type = SDL_GAMEPAD_TYPE_XBOX360; |
| |
| return true; |
| } |
| |
| static int HIDAPI_DriverXbox360W_GetDevicePlayerIndex(SDL_HIDAPI_Device *device, SDL_JoystickID instance_id) |
| { |
| return -1; |
| } |
| |
| static void HIDAPI_DriverXbox360W_SetDevicePlayerIndex(SDL_HIDAPI_Device *device, SDL_JoystickID instance_id, int player_index) |
| { |
| SDL_DriverXbox360W_Context *ctx = (SDL_DriverXbox360W_Context *)device->context; |
| |
| if (!ctx) { |
| return; |
| } |
| |
| ctx->player_index = player_index; |
| |
| UpdateSlotLED(ctx); |
| } |
| |
| static bool HIDAPI_DriverXbox360W_OpenJoystick(SDL_HIDAPI_Device *device, SDL_Joystick *joystick) |
| { |
| SDL_DriverXbox360W_Context *ctx = (SDL_DriverXbox360W_Context *)device->context; |
| |
| SDL_AssertJoysticksLocked(); |
| |
| SDL_zeroa(ctx->last_state); |
| |
| // Initialize player index (needed for setting LEDs) |
| ctx->player_index = SDL_GetJoystickPlayerIndex(joystick); |
| ctx->player_lights = SDL_GetHintBoolean(SDL_HINT_JOYSTICK_HIDAPI_XBOX_360_PLAYER_LED, true); |
| UpdateSlotLED(ctx); |
| |
| SDL_AddHintCallback(SDL_HINT_JOYSTICK_HIDAPI_XBOX_360_PLAYER_LED, |
| SDL_PlayerLEDHintChanged, ctx); |
| |
| // Initialize the joystick capabilities |
| joystick->nbuttons = 11; |
| joystick->naxes = SDL_GAMEPAD_AXIS_COUNT; |
| joystick->nhats = 1; |
| joystick->connection_state = SDL_JOYSTICK_CONNECTION_WIRELESS; |
| |
| return true; |
| } |
| |
| static bool HIDAPI_DriverXbox360W_RumbleJoystick(SDL_HIDAPI_Device *device, SDL_Joystick *joystick, Uint16 low_frequency_rumble, Uint16 high_frequency_rumble) |
| { |
| Uint8 rumble_packet[] = { 0x00, 0x01, 0x0f, 0xc0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 }; |
| |
| rumble_packet[5] = (low_frequency_rumble >> 8); |
| rumble_packet[6] = (high_frequency_rumble >> 8); |
| |
| if (SDL_HIDAPI_SendRumble(device, rumble_packet, sizeof(rumble_packet)) != sizeof(rumble_packet)) { |
| return SDL_SetError("Couldn't send rumble packet"); |
| } |
| return true; |
| } |
| |
| static bool HIDAPI_DriverXbox360W_RumbleJoystickTriggers(SDL_HIDAPI_Device *device, SDL_Joystick *joystick, Uint16 left_rumble, Uint16 right_rumble) |
| { |
| return SDL_Unsupported(); |
| } |
| |
| static Uint32 HIDAPI_DriverXbox360W_GetJoystickCapabilities(SDL_HIDAPI_Device *device, SDL_Joystick *joystick) |
| { |
| SDL_DriverXbox360W_Context *ctx = (SDL_DriverXbox360W_Context *)device->context; |
| Uint32 result = SDL_JOYSTICK_CAP_RUMBLE; |
| |
| if (ctx->player_lights) { |
| result |= SDL_JOYSTICK_CAP_PLAYER_LED; |
| } |
| return result; |
| } |
| |
| static bool HIDAPI_DriverXbox360W_SetJoystickLED(SDL_HIDAPI_Device *device, SDL_Joystick *joystick, Uint8 red, Uint8 green, Uint8 blue) |
| { |
| return SDL_Unsupported(); |
| } |
| |
| static bool HIDAPI_DriverXbox360W_SendJoystickEffect(SDL_HIDAPI_Device *device, SDL_Joystick *joystick, const void *data, int size) |
| { |
| return SDL_Unsupported(); |
| } |
| |
| static bool HIDAPI_DriverXbox360W_SetJoystickSensorsEnabled(SDL_HIDAPI_Device *device, SDL_Joystick *joystick, bool enabled) |
| { |
| return SDL_Unsupported(); |
| } |
| |
| static void HIDAPI_DriverXbox360W_HandleStatePacket(SDL_Joystick *joystick, SDL_hid_device *dev, SDL_DriverXbox360W_Context *ctx, Uint8 *data, int size) |
| { |
| Sint16 axis; |
| const bool invert_y_axes = true; |
| Uint64 timestamp = SDL_GetTicksNS(); |
| |
| if (ctx->last_state[2] != data[2]) { |
| Uint8 hat = 0; |
| |
| if (data[2] & 0x01) { |
| hat |= SDL_HAT_UP; |
| } |
| if (data[2] & 0x02) { |
| hat |= SDL_HAT_DOWN; |
| } |
| if (data[2] & 0x04) { |
| hat |= SDL_HAT_LEFT; |
| } |
| if (data[2] & 0x08) { |
| hat |= SDL_HAT_RIGHT; |
| } |
| SDL_SendJoystickHat(timestamp, joystick, 0, hat); |
| |
| SDL_SendJoystickButton(timestamp, joystick, SDL_GAMEPAD_BUTTON_START, ((data[2] & 0x10) != 0)); |
| SDL_SendJoystickButton(timestamp, joystick, SDL_GAMEPAD_BUTTON_BACK, ((data[2] & 0x20) != 0)); |
| SDL_SendJoystickButton(timestamp, joystick, SDL_GAMEPAD_BUTTON_LEFT_STICK, ((data[2] & 0x40) != 0)); |
| SDL_SendJoystickButton(timestamp, joystick, SDL_GAMEPAD_BUTTON_RIGHT_STICK, ((data[2] & 0x80) != 0)); |
| } |
| |
| if (ctx->last_state[3] != data[3]) { |
| SDL_SendJoystickButton(timestamp, joystick, SDL_GAMEPAD_BUTTON_LEFT_SHOULDER, ((data[3] & 0x01) != 0)); |
| SDL_SendJoystickButton(timestamp, joystick, SDL_GAMEPAD_BUTTON_RIGHT_SHOULDER, ((data[3] & 0x02) != 0)); |
| SDL_SendJoystickButton(timestamp, joystick, SDL_GAMEPAD_BUTTON_GUIDE, ((data[3] & 0x04) != 0)); |
| SDL_SendJoystickButton(timestamp, joystick, SDL_GAMEPAD_BUTTON_SOUTH, ((data[3] & 0x10) != 0)); |
| SDL_SendJoystickButton(timestamp, joystick, SDL_GAMEPAD_BUTTON_EAST, ((data[3] & 0x20) != 0)); |
| SDL_SendJoystickButton(timestamp, joystick, SDL_GAMEPAD_BUTTON_WEST, ((data[3] & 0x40) != 0)); |
| SDL_SendJoystickButton(timestamp, joystick, SDL_GAMEPAD_BUTTON_NORTH, ((data[3] & 0x80) != 0)); |
| } |
| |
| axis = ((int)data[4] * 257) - 32768; |
| SDL_SendJoystickAxis(timestamp, joystick, SDL_GAMEPAD_AXIS_LEFT_TRIGGER, axis); |
| axis = ((int)data[5] * 257) - 32768; |
| SDL_SendJoystickAxis(timestamp, joystick, SDL_GAMEPAD_AXIS_RIGHT_TRIGGER, axis); |
| axis = SDL_Swap16LE(*(Sint16 *)(&data[6])); |
| SDL_SendJoystickAxis(timestamp, joystick, SDL_GAMEPAD_AXIS_LEFTX, axis); |
| axis = SDL_Swap16LE(*(Sint16 *)(&data[8])); |
| if (invert_y_axes) { |
| axis = ~axis; |
| } |
| SDL_SendJoystickAxis(timestamp, joystick, SDL_GAMEPAD_AXIS_LEFTY, axis); |
| axis = SDL_Swap16LE(*(Sint16 *)(&data[10])); |
| SDL_SendJoystickAxis(timestamp, joystick, SDL_GAMEPAD_AXIS_RIGHTX, axis); |
| axis = SDL_Swap16LE(*(Sint16 *)(&data[12])); |
| if (invert_y_axes) { |
| axis = ~axis; |
| } |
| SDL_SendJoystickAxis(timestamp, joystick, SDL_GAMEPAD_AXIS_RIGHTY, axis); |
| |
| SDL_memcpy(ctx->last_state, data, SDL_min(size, sizeof(ctx->last_state))); |
| } |
| |
| static bool HIDAPI_DriverXbox360W_UpdateDevice(SDL_HIDAPI_Device *device) |
| { |
| SDL_DriverXbox360W_Context *ctx = (SDL_DriverXbox360W_Context *)device->context; |
| SDL_Joystick *joystick = NULL; |
| Uint8 data[USB_PACKET_LENGTH]; |
| int size; |
| |
| if (device->num_joysticks > 0) { |
| joystick = SDL_GetJoystickFromID(device->joysticks[0]); |
| } |
| |
| while ((size = SDL_hid_read_timeout(device->dev, data, sizeof(data), 0)) > 0) { |
| #ifdef DEBUG_XBOX_PROTOCOL |
| HIDAPI_DumpPacket("Xbox 360 wireless packet: size = %d", data, size); |
| #endif |
| if (size == 2 && data[0] == 0x08) { |
| bool connected = (data[1] & 0x80) ? true : false; |
| #ifdef DEBUG_JOYSTICK |
| SDL_Log("Connected = %s", connected ? "TRUE" : "FALSE"); |
| #endif |
| if (connected != ctx->connected) { |
| ctx->connected = connected; |
| |
| if (connected) { |
| SDL_JoystickID joystickID; |
| |
| HIDAPI_JoystickConnected(device, &joystickID); |
| |
| } else if (device->num_joysticks > 0) { |
| HIDAPI_JoystickDisconnected(device, device->joysticks[0]); |
| } |
| } |
| } else if (size == 29 && data[0] == 0x00 && data[1] == 0x0f && data[2] == 0x00 && data[3] == 0xf0) { |
| // Serial number is data[7-13] |
| #ifdef DEBUG_JOYSTICK |
| SDL_Log("Battery status (initial): %d", data[17]); |
| #endif |
| if (joystick) { |
| UpdatePowerLevel(joystick, data[17]); |
| } |
| } else if (size == 29 && data[0] == 0x00 && data[1] == 0x00 && data[2] == 0x00 && data[3] == 0x13) { |
| #ifdef DEBUG_JOYSTICK |
| SDL_Log("Battery status: %d", data[4]); |
| #endif |
| if (joystick) { |
| UpdatePowerLevel(joystick, data[4]); |
| } |
| } else if (size == 29 && data[0] == 0x00 && (data[1] & 0x01) == 0x01) { |
| if (joystick) { |
| HIDAPI_DriverXbox360W_HandleStatePacket(joystick, device->dev, ctx, data + 4, size - 4); |
| } |
| } |
| } |
| |
| if (size < 0 && device->num_joysticks > 0) { |
| // Read error, device is disconnected |
| HIDAPI_JoystickDisconnected(device, device->joysticks[0]); |
| } |
| return (size >= 0); |
| } |
| |
| static void HIDAPI_DriverXbox360W_CloseJoystick(SDL_HIDAPI_Device *device, SDL_Joystick *joystick) |
| { |
| SDL_DriverXbox360W_Context *ctx = (SDL_DriverXbox360W_Context *)device->context; |
| |
| SDL_RemoveHintCallback(SDL_HINT_JOYSTICK_HIDAPI_XBOX_360_PLAYER_LED, |
| SDL_PlayerLEDHintChanged, ctx); |
| } |
| |
| static void HIDAPI_DriverXbox360W_FreeDevice(SDL_HIDAPI_Device *device) |
| { |
| } |
| |
| SDL_HIDAPI_DeviceDriver SDL_HIDAPI_DriverXbox360W = { |
| SDL_HINT_JOYSTICK_HIDAPI_XBOX_360_WIRELESS, |
| true, |
| HIDAPI_DriverXbox360W_RegisterHints, |
| HIDAPI_DriverXbox360W_UnregisterHints, |
| HIDAPI_DriverXbox360W_IsEnabled, |
| HIDAPI_DriverXbox360W_IsSupportedDevice, |
| HIDAPI_DriverXbox360W_InitDevice, |
| HIDAPI_DriverXbox360W_GetDevicePlayerIndex, |
| HIDAPI_DriverXbox360W_SetDevicePlayerIndex, |
| HIDAPI_DriverXbox360W_UpdateDevice, |
| HIDAPI_DriverXbox360W_OpenJoystick, |
| HIDAPI_DriverXbox360W_RumbleJoystick, |
| HIDAPI_DriverXbox360W_RumbleJoystickTriggers, |
| HIDAPI_DriverXbox360W_GetJoystickCapabilities, |
| HIDAPI_DriverXbox360W_SetJoystickLED, |
| HIDAPI_DriverXbox360W_SendJoystickEffect, |
| HIDAPI_DriverXbox360W_SetJoystickSensorsEnabled, |
| HIDAPI_DriverXbox360W_CloseJoystick, |
| HIDAPI_DriverXbox360W_FreeDevice, |
| }; |
| |
| #endif // SDL_JOYSTICK_HIDAPI_XBOX360 |
| |
| #endif // SDL_JOYSTICK_HIDAPI |