/* Simple DirectMedia Layer Copyright (C) 1997-2020 Sam Lantinga 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" /* This is the iOS implementation of the SDL joystick API */ #include "SDL_assert.h" #include "SDL_events.h" #include "SDL_joystick.h" #include "SDL_hints.h" #include "SDL_stdinc.h" #include "../SDL_sysjoystick.h" #include "../SDL_joystick_c.h" #include "../usb_ids.h" #include "SDL_mfijoystick_c.h" #if !SDL_EVENTS_DISABLED #include "../../events/SDL_events_c.h" #endif #if TARGET_OS_IOS #define SDL_JOYSTICK_iOS_ACCELEROMETER #import #endif #if defined(__MACOSX__) #include #include #ifndef NSAppKitVersionNumber10_15 #define NSAppKitVersionNumber10_15 1894 #endif #endif /* __MACOSX__ */ #ifdef SDL_JOYSTICK_MFI #import static id connectObserver = nil; static id disconnectObserver = nil; #include #include /* remove compilation warnings for strict builds by defining these selectors, even though * they are only ever used indirectly through objc_msgSend */ @interface GCController (SDL) #if defined(__MACOSX__) && (__MAC_OS_X_VERSION_MAX_ALLOWED <= 101600) + (BOOL)supportsHIDDevice:(IOHIDDeviceRef)device; #endif @end @interface GCExtendedGamepad (SDL) #if !((__IPHONE_OS_VERSION_MAX_ALLOWED >= 121000) || (__APPLETV_OS_VERSION_MAX_ALLOWED >= 121000) || (__MAC_OS_VERSION_MAX_ALLOWED >= 1401000)) @property (nonatomic, readonly, nullable) GCControllerButtonInput *leftThumbstickButton; @property (nonatomic, readonly, nullable) GCControllerButtonInput *rightThumbstickButton; #endif #if !((__IPHONE_OS_VERSION_MAX_ALLOWED >= 130000) || (__APPLETV_OS_VERSION_MAX_ALLOWED >= 130000) || (__MAC_OS_VERSION_MAX_ALLOWED >= 1500000)) @property (nonatomic, readonly) GCControllerButtonInput *buttonMenu; @property (nonatomic, readonly, nullable) GCControllerButtonInput *buttonOptions; #endif #if !((__IPHONE_OS_VERSION_MAX_ALLOWED >= 140000) || (__APPLETV_OS_VERSION_MAX_ALLOWED >= 140000) || (__MAC_OS_VERSION_MAX_ALLOWED > 1500000)) @property (nonatomic, readonly, nullable) GCControllerButtonInput *buttonHome; #endif @end @interface GCMicroGamepad (SDL) #if !((__IPHONE_OS_VERSION_MAX_ALLOWED >= 130000) || (__APPLETV_OS_VERSION_MAX_ALLOWED >= 130000) || (__MAC_OS_VERSION_MAX_ALLOWED >= 1500000)) @property (nonatomic, readonly) GCControllerButtonInput *buttonMenu; #endif @end #if (__IPHONE_OS_VERSION_MAX_ALLOWED >= 140000) || (__APPLETV_OS_VERSION_MAX_ALLOWED >= 140000) || (__MAC_OS_VERSION_MAX_ALLOWED > 1500000) || (__MAC_OS_X_VERSION_MAX_ALLOWED > 101600) #define ENABLE_MFI_BATTERY #define ENABLE_MFI_RUMBLE #define ENABLE_MFI_LIGHT #define ENABLE_MFI_SENSORS #define ENABLE_PHYSICAL_INPUT_PROFILE #endif #ifdef ENABLE_MFI_RUMBLE #import #endif #endif /* SDL_JOYSTICK_MFI */ #ifdef SDL_JOYSTICK_iOS_ACCELEROMETER static const char *accelerometerName = "iOS Accelerometer"; static CMMotionManager *motionManager = nil; #endif /* SDL_JOYSTICK_iOS_ACCELEROMETER */ static SDL_JoystickDeviceItem *deviceList = NULL; static int numjoysticks = 0; int SDL_AppleTVRemoteOpenedAsJoystick = 0; static SDL_JoystickDeviceItem * GetDeviceForIndex(int device_index) { SDL_JoystickDeviceItem *device = deviceList; int i = 0; while (i < device_index) { if (device == NULL) { return NULL; } device = device->next; i++; } return device; } #ifdef SDL_JOYSTICK_MFI static void IOS_AddMFIJoystickDevice(SDL_JoystickDeviceItem *device, GCController *controller) { Uint16 *guid16 = (Uint16 *)device->guid.data; Uint16 vendor = 0; Uint16 product = 0; Uint8 subtype = 0; const char *name = NULL; /* Explicitly retain the controller because SDL_JoystickDeviceItem is a * struct, and ARC doesn't work with structs. */ device->controller = (__bridge GCController *) CFBridgingRetain(controller); if (controller.vendorName) { name = controller.vendorName.UTF8String; } if (!name) { name = "MFi Gamepad"; } device->name = SDL_CreateJoystickName(0, 0, NULL, name); if (controller.extendedGamepad) { GCExtendedGamepad *gamepad = controller.extendedGamepad; BOOL is_xbox = [controller.vendorName containsString: @"Xbox"]; BOOL is_ps4 = [controller.vendorName containsString: @"DUALSHOCK"]; #if TARGET_OS_TV BOOL is_MFi = (!is_xbox && !is_ps4); #endif int nbuttons = 0; /* These buttons are part of the original MFi spec */ device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_A); device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_B); device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_X); device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_Y); device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_LEFTSHOULDER); device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_RIGHTSHOULDER); nbuttons += 6; /* These buttons are available on some newer controllers */ #pragma clang diagnostic push #pragma clang diagnostic ignored "-Wunguarded-availability-new" if ([gamepad respondsToSelector:@selector(leftThumbstickButton)] && gamepad.leftThumbstickButton) { device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_LEFTSTICK); ++nbuttons; } if ([gamepad respondsToSelector:@selector(rightThumbstickButton)] && gamepad.rightThumbstickButton) { device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_RIGHTSTICK); ++nbuttons; } if ([gamepad respondsToSelector:@selector(buttonOptions)] && gamepad.buttonOptions) { device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_BACK); ++nbuttons; } if ([gamepad respondsToSelector:@selector(buttonHome)] && gamepad.buttonHome) { device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_GUIDE); ++nbuttons; } BOOL has_direct_menu = [gamepad respondsToSelector:@selector(buttonMenu)] && gamepad.buttonMenu; #if TARGET_OS_TV /* On tvOS MFi controller menu button brings you to the home screen */ if (is_MFi) { has_direct_menu = FALSE; } #endif device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_START); ++nbuttons; if (!has_direct_menu) { device->uses_pause_handler = SDL_TRUE; } #ifdef ENABLE_PHYSICAL_INPUT_PROFILE if ([controller respondsToSelector:@selector(physicalInputProfile)]) { if (controller.physicalInputProfile.buttons[GCInputDualShockTouchpadButton] != nil) { device->has_dualshock_touchpad = SDL_TRUE; device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_MISC1); ++nbuttons; } if (controller.physicalInputProfile.buttons[GCInputXboxPaddleOne] != nil) { device->has_xbox_paddles = SDL_TRUE; device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_PADDLE1); ++nbuttons; } if (controller.physicalInputProfile.buttons[GCInputXboxPaddleTwo] != nil) { device->has_xbox_paddles = SDL_TRUE; device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_PADDLE2); ++nbuttons; } if (controller.physicalInputProfile.buttons[GCInputXboxPaddleThree] != nil) { device->has_xbox_paddles = SDL_TRUE; device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_PADDLE3); ++nbuttons; } if (controller.physicalInputProfile.buttons[GCInputXboxPaddleFour] != nil) { device->has_xbox_paddles = SDL_TRUE; device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_PADDLE4); ++nbuttons; } } #endif #pragma clang diagnostic pop if (is_xbox) { vendor = USB_VENDOR_MICROSOFT; if (device->has_xbox_paddles) { /* Assume Xbox One Elite Series 2 Controller unless/until GCController flows VID/PID */ product = USB_PRODUCT_XBOX_ONE_ELITE_SERIES_2_BLUETOOTH; subtype = 1; } else { /* Assume Xbox One S BLE Controller unless/until GCController flows VID/PID */ product = USB_PRODUCT_XBOX_ONE_S_REV1_BLUETOOTH; subtype = 0; } } else if (is_ps4) { /* Assume DS4 Slim unless/until GCController flows VID/PID */ vendor = USB_VENDOR_SONY; product = USB_PRODUCT_SONY_DS4_SLIM; if (device->has_dualshock_touchpad) { subtype = 1; } else { subtype = 0; } } else { vendor = USB_VENDOR_APPLE; product = 1; subtype = 1; } device->naxes = 6; /* 2 thumbsticks and 2 triggers */ device->nhats = 1; /* d-pad */ device->nbuttons = nbuttons; } else if (controller.gamepad) { int nbuttons = 0; /* These buttons are part of the original MFi spec */ device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_A); device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_B); device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_X); device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_Y); device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_LEFTSHOULDER); device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_RIGHTSHOULDER); device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_START); nbuttons += 7; device->uses_pause_handler = SDL_TRUE; vendor = USB_VENDOR_APPLE; product = 2; subtype = 2; device->naxes = 0; /* no traditional analog inputs */ device->nhats = 1; /* d-pad */ device->nbuttons = nbuttons; } #if TARGET_OS_TV else if (controller.microGamepad) { int nbuttons = 0; device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_A); device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_B); /* Button X on microGamepad */ nbuttons += 2; device->button_mask |= (1 << SDL_CONTROLLER_BUTTON_START); ++nbuttons; device->uses_pause_handler = SDL_TRUE; vendor = USB_VENDOR_APPLE; product = 3; subtype = 3; device->naxes = 2; /* treat the touch surface as two axes */ device->nhats = 0; /* apparently the touch surface-as-dpad is buggy */ device->nbuttons = nbuttons; controller.microGamepad.allowsRotation = SDL_GetHintBoolean(SDL_HINT_APPLE_TV_REMOTE_ALLOW_ROTATION, SDL_FALSE); } #endif /* TARGET_OS_TV */ /* We only need 16 bits for each of these; space them out to fill 128. */ /* Byteswap so devices get same GUID on little/big endian platforms. */ *guid16++ = SDL_SwapLE16(SDL_HARDWARE_BUS_BLUETOOTH); *guid16++ = 0; *guid16++ = SDL_SwapLE16(vendor); *guid16++ = 0; *guid16++ = SDL_SwapLE16(product); *guid16++ = 0; *guid16++ = SDL_SwapLE16(device->button_mask); if (vendor == USB_VENDOR_APPLE) { /* Note that this is an MFI controller and what subtype it is */ device->guid.data[14] = 'm'; device->guid.data[15] = subtype; } else { device->guid.data[15] = subtype; } /* This will be set when the first button press of the controller is * detected. */ controller.playerIndex = -1; } #endif /* SDL_JOYSTICK_MFI */ #if defined(SDL_JOYSTICK_iOS_ACCELEROMETER) || defined(SDL_JOYSTICK_MFI) static void IOS_AddJoystickDevice(GCController *controller, SDL_bool accelerometer) { SDL_JoystickDeviceItem *device = deviceList; #if TARGET_OS_TV if (!SDL_GetHintBoolean(SDL_HINT_TV_REMOTE_AS_JOYSTICK, SDL_TRUE)) { /* Ignore devices that aren't actually controllers (e.g. remotes), they'll be handled as keyboard input */ if (controller && !controller.extendedGamepad && !controller.gamepad && controller.microGamepad) { return; } } #endif while (device != NULL) { if (device->controller == controller) { return; } device = device->next; } device = (SDL_JoystickDeviceItem *) SDL_calloc(1, sizeof(SDL_JoystickDeviceItem)); if (device == NULL) { return; } device->accelerometer = accelerometer; device->instance_id = SDL_GetNextJoystickInstanceID(); if (accelerometer) { #ifdef SDL_JOYSTICK_iOS_ACCELEROMETER device->name = SDL_strdup(accelerometerName); device->naxes = 3; /* Device acceleration in the x, y, and z axes. */ device->nhats = 0; device->nbuttons = 0; /* Use the accelerometer name as a GUID. */ SDL_memcpy(&device->guid.data, device->name, SDL_min(sizeof(SDL_JoystickGUID), SDL_strlen(device->name))); #else SDL_free(device); return; #endif /* SDL_JOYSTICK_iOS_ACCELEROMETER */ } else if (controller) { #ifdef SDL_JOYSTICK_MFI IOS_AddMFIJoystickDevice(device, controller); #else SDL_free(device); return; #endif /* SDL_JOYSTICK_MFI */ } if (deviceList == NULL) { deviceList = device; } else { SDL_JoystickDeviceItem *lastdevice = deviceList; while (lastdevice->next != NULL) { lastdevice = lastdevice->next; } lastdevice->next = device; } ++numjoysticks; SDL_PrivateJoystickAdded(device->instance_id); } #endif /* SDL_JOYSTICK_iOS_ACCELEROMETER || SDL_JOYSTICK_MFI */ static SDL_JoystickDeviceItem * IOS_RemoveJoystickDevice(SDL_JoystickDeviceItem *device) { SDL_JoystickDeviceItem *prev = NULL; SDL_JoystickDeviceItem *next = NULL; SDL_JoystickDeviceItem *item = deviceList; if (device == NULL) { return NULL; } next = device->next; while (item != NULL) { if (item == device) { break; } prev = item; item = item->next; } /* Unlink the device item from the device list. */ if (prev) { prev->next = device->next; } else if (device == deviceList) { deviceList = device->next; } if (device->joystick) { device->joystick->hwdata = NULL; } #ifdef SDL_JOYSTICK_MFI @autoreleasepool { if (device->controller) { /* The controller was explicitly retained in the struct, so it * should be explicitly released before freeing the struct. */ GCController *controller = CFBridgingRelease((__bridge CFTypeRef)(device->controller)); controller.controllerPausedHandler = nil; device->controller = nil; } } #endif /* SDL_JOYSTICK_MFI */ --numjoysticks; SDL_PrivateJoystickRemoved(device->instance_id); SDL_free(device->name); SDL_free(device); return next; } #if TARGET_OS_TV static void SDLCALL SDL_AppleTVRemoteRotationHintChanged(void *udata, const char *name, const char *oldValue, const char *newValue) { BOOL allowRotation = newValue != NULL && *newValue != '0'; @autoreleasepool { for (GCController *controller in [GCController controllers]) { if (controller.microGamepad) { controller.microGamepad.allowsRotation = allowRotation; } } } } #endif /* TARGET_OS_TV */ #if defined(__MACOSX__) static int is_macos11(void) { return (floor(NSAppKitVersionNumber) > NSAppKitVersionNumber10_15); } #endif static int IOS_JoystickInit(void) { #if defined(__MACOSX__) if (!is_macos11()) { return 0; } #endif @autoreleasepool { #ifdef SDL_JOYSTICK_iOS_ACCELEROMETER if (SDL_GetHintBoolean(SDL_HINT_ACCELEROMETER_AS_JOYSTICK, SDL_TRUE)) { /* Default behavior, accelerometer as joystick */ IOS_AddJoystickDevice(nil, SDL_TRUE); } #endif #ifdef SDL_JOYSTICK_MFI /* GameController.framework was added in iOS 7. */ if (![GCController class]) { return 0; } /* For whatever reason, this always returns an empty array on macOS 11.0.1 */ for (GCController *controller in [GCController controllers]) { IOS_AddJoystickDevice(controller, SDL_FALSE); } #if TARGET_OS_TV SDL_AddHintCallback(SDL_HINT_APPLE_TV_REMOTE_ALLOW_ROTATION, SDL_AppleTVRemoteRotationHintChanged, NULL); #endif /* TARGET_OS_TV */ NSNotificationCenter *center = [NSNotificationCenter defaultCenter]; connectObserver = [center addObserverForName:GCControllerDidConnectNotification object:nil queue:nil usingBlock:^(NSNotification *note) { GCController *controller = note.object; IOS_AddJoystickDevice(controller, SDL_FALSE); }]; disconnectObserver = [center addObserverForName:GCControllerDidDisconnectNotification object:nil queue:nil usingBlock:^(NSNotification *note) { GCController *controller = note.object; SDL_JoystickDeviceItem *device = deviceList; while (device != NULL) { if (device->controller == controller) { IOS_RemoveJoystickDevice(device); break; } device = device->next; } }]; #endif /* SDL_JOYSTICK_MFI */ } return 0; } static int IOS_JoystickGetCount(void) { return numjoysticks; } static void IOS_JoystickDetect(void) { } static const char * IOS_JoystickGetDeviceName(int device_index) { SDL_JoystickDeviceItem *device = GetDeviceForIndex(device_index); return device ? device->name : "Unknown"; } static int IOS_JoystickGetDevicePlayerIndex(int device_index) { #ifdef SDL_JOYSTICK_MFI SDL_JoystickDeviceItem *device = GetDeviceForIndex(device_index); if (device && device->controller) { return (int)device->controller.playerIndex; } #endif return -1; } static void IOS_JoystickSetDevicePlayerIndex(int device_index, int player_index) { #ifdef SDL_JOYSTICK_MFI SDL_JoystickDeviceItem *device = GetDeviceForIndex(device_index); if (device && device->controller) { device->controller.playerIndex = player_index; } #endif } static SDL_JoystickGUID IOS_JoystickGetDeviceGUID( int device_index ) { SDL_JoystickDeviceItem *device = GetDeviceForIndex(device_index); SDL_JoystickGUID guid; if (device) { guid = device->guid; } else { SDL_zero(guid); } return guid; } static SDL_JoystickID IOS_JoystickGetDeviceInstanceID(int device_index) { SDL_JoystickDeviceItem *device = GetDeviceForIndex(device_index); return device ? device->instance_id : -1; } static int IOS_JoystickOpen(SDL_Joystick *joystick, int device_index) { SDL_JoystickDeviceItem *device = GetDeviceForIndex(device_index); if (device == NULL) { return SDL_SetError("Could not open Joystick: no hardware device for the specified index"); } joystick->hwdata = device; joystick->instance_id = device->instance_id; joystick->naxes = device->naxes; joystick->nhats = device->nhats; joystick->nbuttons = device->nbuttons; joystick->nballs = 0; if (device->has_dualshock_touchpad) { SDL_PrivateJoystickAddTouchpad(joystick, 2); } device->joystick = joystick; @autoreleasepool { if (device->accelerometer) { #ifdef SDL_JOYSTICK_iOS_ACCELEROMETER if (motionManager == nil) { motionManager = [[CMMotionManager alloc] init]; } /* Shorter times between updates can significantly increase CPU usage. */ motionManager.accelerometerUpdateInterval = 0.1; [motionManager startAccelerometerUpdates]; #endif } else { #ifdef SDL_JOYSTICK_MFI if (device->uses_pause_handler) { GCController *controller = device->controller; controller.controllerPausedHandler = ^(GCController *c) { if (joystick->hwdata) { ++joystick->hwdata->num_pause_presses; } }; } #ifdef ENABLE_MFI_SENSORS if (@available(macOS 11.0, iOS 14.0, tvOS 14.0, *)) { GCController *controller = joystick->hwdata->controller; GCMotion *motion = controller.motion; if (motion && motion.hasRotationRate) { SDL_PrivateJoystickAddSensor(joystick, SDL_SENSOR_GYRO); } if (motion && motion.hasGravityAndUserAcceleration) { SDL_PrivateJoystickAddSensor(joystick, SDL_SENSOR_ACCEL); } } #endif /* ENABLE_MFI_SENSORS */ #endif /* SDL_JOYSTICK_MFI */ } } if (device->remote) { ++SDL_AppleTVRemoteOpenedAsJoystick; } return 0; } static void IOS_AccelerometerUpdate(SDL_Joystick *joystick) { #ifdef SDL_JOYSTICK_iOS_ACCELEROMETER const float maxgforce = SDL_IPHONE_MAX_GFORCE; const SInt16 maxsint16 = 0x7FFF; CMAcceleration accel; @autoreleasepool { if (!motionManager.isAccelerometerActive) { return; } accel = motionManager.accelerometerData.acceleration; } /* Convert accelerometer data from floating point to Sint16, which is what the joystick system expects. To do the conversion, the data is first clamped onto the interval [-SDL_IPHONE_MAX_G_FORCE, SDL_IPHONE_MAX_G_FORCE], then the data is multiplied by MAX_SINT16 so that it is mapped to the full range of an Sint16. You can customize the clamped range of this function by modifying the SDL_IPHONE_MAX_GFORCE macro in SDL_config_iphoneos.h. Once converted to Sint16, the accelerometer data no longer has coherent units. You can convert the data back to units of g-force by multiplying it in your application's code by SDL_IPHONE_MAX_GFORCE / 0x7FFF. */ /* clamp the data */ accel.x = SDL_min(SDL_max(accel.x, -maxgforce), maxgforce); accel.y = SDL_min(SDL_max(accel.y, -maxgforce), maxgforce); accel.z = SDL_min(SDL_max(accel.z, -maxgforce), maxgforce); /* pass in data mapped to range of SInt16 */ SDL_PrivateJoystickAxis(joystick, 0, (accel.x / maxgforce) * maxsint16); SDL_PrivateJoystickAxis(joystick, 1, -(accel.y / maxgforce) * maxsint16); SDL_PrivateJoystickAxis(joystick, 2, (accel.z / maxgforce) * maxsint16); #endif /* SDL_JOYSTICK_iOS_ACCELEROMETER */ } #ifdef SDL_JOYSTICK_MFI static Uint8 IOS_MFIJoystickHatStateForDPad(GCControllerDirectionPad *dpad) { Uint8 hat = 0; if (dpad.up.isPressed) { hat |= SDL_HAT_UP; } else if (dpad.down.isPressed) { hat |= SDL_HAT_DOWN; } if (dpad.left.isPressed) { hat |= SDL_HAT_LEFT; } else if (dpad.right.isPressed) { hat |= SDL_HAT_RIGHT; } if (hat == 0) { return SDL_HAT_CENTERED; } return hat; } #endif static void IOS_MFIJoystickUpdate(SDL_Joystick *joystick) { #if SDL_JOYSTICK_MFI @autoreleasepool { GCController *controller = joystick->hwdata->controller; Uint8 hatstate = SDL_HAT_CENTERED; int i; int pause_button_index = 0; if (controller.extendedGamepad) { GCExtendedGamepad *gamepad = controller.extendedGamepad; /* Axis order matches the XInput Windows mappings. */ Sint16 axes[] = { (Sint16) (gamepad.leftThumbstick.xAxis.value * 32767), (Sint16) (gamepad.leftThumbstick.yAxis.value * -32767), (Sint16) ((gamepad.leftTrigger.value * 65535) - 32768), (Sint16) (gamepad.rightThumbstick.xAxis.value * 32767), (Sint16) (gamepad.rightThumbstick.yAxis.value * -32767), (Sint16) ((gamepad.rightTrigger.value * 65535) - 32768), }; /* Button order matches the XInput Windows mappings. */ Uint8 buttons[joystick->nbuttons]; int button_count = 0; /* These buttons are part of the original MFi spec */ buttons[button_count++] = gamepad.buttonA.isPressed; buttons[button_count++] = gamepad.buttonB.isPressed; buttons[button_count++] = gamepad.buttonX.isPressed; buttons[button_count++] = gamepad.buttonY.isPressed; buttons[button_count++] = gamepad.leftShoulder.isPressed; buttons[button_count++] = gamepad.rightShoulder.isPressed; /* These buttons are available on some newer controllers */ #pragma clang diagnostic push #pragma clang diagnostic ignored "-Wunguarded-availability-new" if (joystick->hwdata->button_mask & (1 << SDL_CONTROLLER_BUTTON_LEFTSTICK)) { buttons[button_count++] = gamepad.leftThumbstickButton.isPressed; } if (joystick->hwdata->button_mask & (1 << SDL_CONTROLLER_BUTTON_RIGHTSTICK)) { buttons[button_count++] = gamepad.rightThumbstickButton.isPressed; } if (joystick->hwdata->button_mask & (1 << SDL_CONTROLLER_BUTTON_BACK)) { buttons[button_count++] = gamepad.buttonOptions.isPressed; } if (joystick->hwdata->button_mask & (1 << SDL_CONTROLLER_BUTTON_GUIDE)) { buttons[button_count++] = gamepad.buttonHome.isPressed; } /* This must be the last button, so we can optionally handle it with pause_button_index below */ if (joystick->hwdata->button_mask & (1 << SDL_CONTROLLER_BUTTON_START)) { if (joystick->hwdata->uses_pause_handler) { pause_button_index = button_count; buttons[button_count++] = joystick->delayed_guide_button; } else { buttons[button_count++] = gamepad.buttonMenu.isPressed; } } #ifdef ENABLE_PHYSICAL_INPUT_PROFILE if (joystick->hwdata->has_dualshock_touchpad) { buttons[button_count++] = controller.physicalInputProfile.buttons[GCInputDualShockTouchpadButton].isPressed; GCControllerDirectionPad *dpad; dpad = controller.physicalInputProfile.dpads[GCInputDualShockTouchpadOne]; if (dpad.xAxis.value || dpad.yAxis.value) { SDL_PrivateJoystickTouchpad(joystick, 0, 0, SDL_PRESSED, (1.0f + dpad.xAxis.value) * 0.5f, 1.0f - (1.0f + dpad.yAxis.value) * 0.5f, 1.0f); } else { SDL_PrivateJoystickTouchpad(joystick, 0, 0, SDL_RELEASED, 0.0f, 0.0f, 1.0f); } dpad = controller.physicalInputProfile.dpads[GCInputDualShockTouchpadTwo]; if (dpad.xAxis.value || dpad.yAxis.value) { SDL_PrivateJoystickTouchpad(joystick, 0, 1, SDL_PRESSED, (1.0f + dpad.xAxis.value) * 0.5f, 1.0f - (1.0f + dpad.yAxis.value) * 0.5f, 1.0f); } else { SDL_PrivateJoystickTouchpad(joystick, 0, 1, SDL_RELEASED, 0.0f, 0.0f, 1.0f); } } if (joystick->hwdata->has_xbox_paddles) { if (joystick->hwdata->button_mask & (1 << SDL_CONTROLLER_BUTTON_PADDLE1)) { buttons[button_count++] = controller.physicalInputProfile.buttons[GCInputXboxPaddleOne].isPressed; } if (joystick->hwdata->button_mask & (1 << SDL_CONTROLLER_BUTTON_PADDLE2)) { buttons[button_count++] = controller.physicalInputProfile.buttons[GCInputXboxPaddleTwo].isPressed; } if (joystick->hwdata->button_mask & (1 << SDL_CONTROLLER_BUTTON_PADDLE3)) { buttons[button_count++] = controller.physicalInputProfile.buttons[GCInputXboxPaddleThree].isPressed; } if (joystick->hwdata->button_mask & (1 << SDL_CONTROLLER_BUTTON_PADDLE4)) { buttons[button_count++] = controller.physicalInputProfile.buttons[GCInputXboxPaddleFour].isPressed; } /* SDL_Log("Paddles: [%d,%d,%d,%d]", controller.physicalInputProfile.buttons[GCInputXboxPaddleOne].isPressed, controller.physicalInputProfile.buttons[GCInputXboxPaddleTwo].isPressed, controller.physicalInputProfile.buttons[GCInputXboxPaddleThree].isPressed, controller.physicalInputProfile.buttons[GCInputXboxPaddleFour].isPressed); */ } #endif #pragma clang diagnostic pop hatstate = IOS_MFIJoystickHatStateForDPad(gamepad.dpad); for (i = 0; i < SDL_arraysize(axes); i++) { SDL_PrivateJoystickAxis(joystick, i, axes[i]); } for (i = 0; i < button_count; i++) { SDL_PrivateJoystickButton(joystick, i, buttons[i]); } #ifdef ENABLE_MFI_SENSORS if (@available(macOS 11.0, iOS 14.0, tvOS 14.0, *)) { GCMotion *motion = controller.motion; if (motion && motion.sensorsActive) { float data[3]; if (motion.hasRotationRate) { GCRotationRate rate = motion.rotationRate; data[0] = rate.x; data[1] = rate.z; data[2] = -rate.y; SDL_PrivateJoystickSensor(joystick, SDL_SENSOR_GYRO, data, 3); } if (motion.hasGravityAndUserAcceleration) { GCAcceleration accel = motion.acceleration; data[0] = -accel.x * SDL_STANDARD_GRAVITY; data[1] = -accel.y * SDL_STANDARD_GRAVITY; data[2] = -accel.z * SDL_STANDARD_GRAVITY; SDL_PrivateJoystickSensor(joystick, SDL_SENSOR_ACCEL, data, 3); } } } #endif /* ENABLE_MFI_SENSORS */ } else if (controller.gamepad) { GCGamepad *gamepad = controller.gamepad; /* Button order matches the XInput Windows mappings. */ Uint8 buttons[joystick->nbuttons]; int button_count = 0; buttons[button_count++] = gamepad.buttonA.isPressed; buttons[button_count++] = gamepad.buttonB.isPressed; buttons[button_count++] = gamepad.buttonX.isPressed; buttons[button_count++] = gamepad.buttonY.isPressed; buttons[button_count++] = gamepad.leftShoulder.isPressed; buttons[button_count++] = gamepad.rightShoulder.isPressed; pause_button_index = button_count; buttons[button_count++] = joystick->delayed_guide_button; hatstate = IOS_MFIJoystickHatStateForDPad(gamepad.dpad); for (i = 0; i < button_count; i++) { SDL_PrivateJoystickButton(joystick, i, buttons[i]); } } #if TARGET_OS_TV else if (controller.microGamepad) { GCMicroGamepad *gamepad = controller.microGamepad; Sint16 axes[] = { (Sint16) (gamepad.dpad.xAxis.value * 32767), (Sint16) (gamepad.dpad.yAxis.value * -32767), }; for (i = 0; i < SDL_arraysize(axes); i++) { SDL_PrivateJoystickAxis(joystick, i, axes[i]); } Uint8 buttons[joystick->nbuttons]; int button_count = 0; buttons[button_count++] = gamepad.buttonA.isPressed; buttons[button_count++] = gamepad.buttonX.isPressed; #pragma clang diagnostic push #pragma clang diagnostic ignored "-Wunguarded-availability-new" /* This must be the last button, so we can optionally handle it with pause_button_index below */ if (joystick->hwdata->button_mask & (1 << SDL_CONTROLLER_BUTTON_START)) { if (joystick->hwdata->uses_pause_handler) { pause_button_index = button_count; buttons[button_count++] = joystick->delayed_guide_button; } else { buttons[button_count++] = gamepad.buttonMenu.isPressed; } } #pragma clang diagnostic pop for (i = 0; i < button_count; i++) { SDL_PrivateJoystickButton(joystick, i, buttons[i]); } } #endif /* TARGET_OS_TV */ if (joystick->nhats > 0) { SDL_PrivateJoystickHat(joystick, 0, hatstate); } if (joystick->hwdata->uses_pause_handler) { for (i = 0; i < joystick->hwdata->num_pause_presses; i++) { SDL_PrivateJoystickButton(joystick, pause_button_index, SDL_PRESSED); SDL_PrivateJoystickButton(joystick, pause_button_index, SDL_RELEASED); } joystick->hwdata->num_pause_presses = 0; } #ifdef ENABLE_MFI_BATTERY if (@available(macos 11.0, iOS 14.0, tvOS 14.0, *)) { GCDeviceBattery *battery = controller.battery; if (battery) { SDL_JoystickPowerLevel ePowerLevel = SDL_JOYSTICK_POWER_UNKNOWN; switch (battery.batteryState) { case GCDeviceBatteryStateDischarging: { float power_level = battery.batteryLevel; if (power_level <= 0.05f) { ePowerLevel = SDL_JOYSTICK_POWER_EMPTY; } else if (power_level <= 0.20f) { ePowerLevel = SDL_JOYSTICK_POWER_LOW; } else if (power_level <= 0.70f) { ePowerLevel = SDL_JOYSTICK_POWER_MEDIUM; } else { ePowerLevel = SDL_JOYSTICK_POWER_FULL; } } break; case GCDeviceBatteryStateCharging: ePowerLevel = SDL_JOYSTICK_POWER_WIRED; break; case GCDeviceBatteryStateFull: ePowerLevel = SDL_JOYSTICK_POWER_FULL; break; default: break; } SDL_PrivateJoystickBatteryLevel(joystick, ePowerLevel); } } #endif /* ENABLE_MFI_BATTERY */ } #endif /* SDL_JOYSTICK_MFI */ } #ifdef ENABLE_MFI_RUMBLE @interface SDL_RumbleMotor : NSObject @end @implementation SDL_RumbleMotor { CHHapticEngine *engine API_AVAILABLE(macos(11.0), ios(13.0), tvos(14.0)); id player API_AVAILABLE(macos(11.0), ios(13.0), tvos(14.0)); bool active; } -(void)cleanup { if (self->player != nil) { [self->player cancelAndReturnError:nil]; self->player = nil; } if (self->engine != nil) { [self->engine stopWithCompletionHandler:nil]; self->engine = nil; } } -(int)setIntensity:(float)intensity { @autoreleasepool { if (@available(macos 11.0, iOS 14.0, tvOS 14.0, *)) { NSError *error; if (self->engine == nil) { return SDL_SetError("Haptics engine was stopped"); } if (intensity == 0.0f) { if (self->player && self->active) { [self->player stopAtTime:0 error:&error]; } self->active = false; return 0; } if (self->player == nil) { CHHapticEventParameter *param = [[CHHapticEventParameter alloc] initWithParameterID:CHHapticEventParameterIDHapticIntensity value:1.0f]; CHHapticEvent *event = [[CHHapticEvent alloc] initWithEventType:CHHapticEventTypeHapticContinuous parameters:[NSArray arrayWithObjects:param, nil] relativeTime:0 duration:GCHapticDurationInfinite]; CHHapticPattern *pattern = [[CHHapticPattern alloc] initWithEvents:[NSArray arrayWithObject:event] parameters:[[NSArray alloc] init] error:&error]; if (error != nil) { return SDL_SetError("Couldn't create haptic pattern: %s", [error.localizedDescription UTF8String]); } self->player = [self->engine createPlayerWithPattern:pattern error:&error]; if (error != nil) { return SDL_SetError("Couldn't create haptic player: %s", [error.localizedDescription UTF8String]); } self->active = false; } CHHapticDynamicParameter *param = [[CHHapticDynamicParameter alloc] initWithParameterID:CHHapticDynamicParameterIDHapticIntensityControl value:intensity relativeTime:0]; [self->player sendParameters:[NSArray arrayWithObject:param] atTime:0 error:&error]; if (error != nil) { return SDL_SetError("Couldn't update haptic player: %s", [error.localizedDescription UTF8String]); } if (!self->active) { [self->player startAtTime:0 error:&error]; self->active = true; } } return 0; } } -(id) initWithController:(GCController*)controller locality:(GCHapticsLocality)locality API_AVAILABLE(macos(11.0), ios(14.0), tvos(14.0)) { @autoreleasepool { self = [super init]; NSError *error; self->engine = [controller.haptics createEngineWithLocality:locality]; if (self->engine == nil) { SDL_SetError("Couldn't create haptics engine"); return nil; } [self->engine startAndReturnError:&error]; if (error != nil) { SDL_SetError("Couldn't start haptics engine"); return nil; } __weak typeof(self) weakSelf = self; self->engine.stoppedHandler = ^(CHHapticEngineStoppedReason stoppedReason) { SDL_RumbleMotor *_this = weakSelf; if (_this == nil) { return; } _this->player = nil; _this->engine = nil; }; self->engine.resetHandler = ^{ SDL_RumbleMotor *_this = weakSelf; if (_this == nil) { return; } _this->player = nil; [_this->engine startAndReturnError:nil]; }; return self; } } @end @interface SDL_RumbleContext : NSObject @end @implementation SDL_RumbleContext { SDL_RumbleMotor *m_low_frequency_motor; SDL_RumbleMotor *m_high_frequency_motor; SDL_RumbleMotor *m_left_trigger_motor; SDL_RumbleMotor *m_right_trigger_motor; } -(id) initWithLowFrequencyMotor:(SDL_RumbleMotor*)low_frequency_motor HighFrequencyMotor:(SDL_RumbleMotor*)high_frequency_motor LeftTriggerMotor:(SDL_RumbleMotor*)left_trigger_motor RightTriggerMotor:(SDL_RumbleMotor*)right_trigger_motor { self = [super init]; self->m_low_frequency_motor = low_frequency_motor; self->m_high_frequency_motor = high_frequency_motor; self->m_left_trigger_motor = left_trigger_motor; self->m_right_trigger_motor = right_trigger_motor; return self; } -(int) rumbleWithLowFrequency:(Uint16)low_frequency_rumble andHighFrequency:(Uint16)high_frequency_rumble { int result = 0; result += [self->m_low_frequency_motor setIntensity:((float)low_frequency_rumble / 65535.0f)]; result += [self->m_high_frequency_motor setIntensity:((float)high_frequency_rumble / 65535.0f)]; return ((result < 0) ? -1 : 0); } -(int) rumbleLeftTrigger:(Uint16)left_rumble andRightTrigger:(Uint16)right_rumble { int result = 0; if (self->m_left_trigger_motor && self->m_right_trigger_motor) { result += [self->m_left_trigger_motor setIntensity:((float)left_rumble / 65535.0f)]; result += [self->m_right_trigger_motor setIntensity:((float)right_rumble / 65535.0f)]; } else { result = SDL_Unsupported(); } return ((result < 0) ? -1 : 0); } -(void)cleanup { [self->m_low_frequency_motor cleanup]; [self->m_high_frequency_motor cleanup]; } @end static SDL_RumbleContext *IOS_JoystickInitRumble(GCController *controller) { @autoreleasepool { if (@available(macOS 11.0, iOS 14.0, tvOS 14.0, *)) { SDL_RumbleMotor *low_frequency_motor = [[SDL_RumbleMotor alloc] initWithController:controller locality:GCHapticsLocalityLeftHandle]; SDL_RumbleMotor *high_frequency_motor = [[SDL_RumbleMotor alloc] initWithController:controller locality:GCHapticsLocalityRightHandle]; SDL_RumbleMotor *left_trigger_motor = [[SDL_RumbleMotor alloc] initWithController:controller locality:GCHapticsLocalityLeftTrigger]; SDL_RumbleMotor *right_trigger_motor = [[SDL_RumbleMotor alloc] initWithController:controller locality:GCHapticsLocalityRightTrigger]; if (low_frequency_motor && high_frequency_motor) { return [[SDL_RumbleContext alloc] initWithLowFrequencyMotor:low_frequency_motor HighFrequencyMotor:high_frequency_motor LeftTriggerMotor:left_trigger_motor RightTriggerMotor:right_trigger_motor]; } } } return nil; } #endif /* ENABLE_MFI_RUMBLE */ static int IOS_JoystickRumble(SDL_Joystick *joystick, Uint16 low_frequency_rumble, Uint16 high_frequency_rumble) { #ifdef ENABLE_MFI_RUMBLE SDL_JoystickDeviceItem *device = joystick->hwdata; if (@available(macOS 11.0, iOS 14.0, tvOS 14.0, *)) { if (!device->rumble && device->controller && device->controller.haptics) { SDL_RumbleContext *rumble = IOS_JoystickInitRumble(device->controller); if (rumble) { device->rumble = (void *)CFBridgingRetain(rumble); } } } if (device->rumble) { SDL_RumbleContext *rumble = (__bridge SDL_RumbleContext *)device->rumble; return [rumble rumbleWithLowFrequency:low_frequency_rumble andHighFrequency:high_frequency_rumble]; } else { return SDL_Unsupported(); } #else return SDL_Unsupported(); #endif } static int IOS_JoystickRumbleTriggers(SDL_Joystick *joystick, Uint16 left_rumble, Uint16 right_rumble) { #ifdef ENABLE_MFI_RUMBLE SDL_JoystickDeviceItem *device = joystick->hwdata; if (@available(macOS 11.0, iOS 14.0, tvOS 14.0, *)) { if (!device->rumble && device->controller && device->controller.haptics) { SDL_RumbleContext *rumble = IOS_JoystickInitRumble(device->controller); if (rumble) { device->rumble = (void *)CFBridgingRetain(rumble); } } } if (device->rumble) { SDL_RumbleContext *rumble = (__bridge SDL_RumbleContext *)device->rumble; return [rumble rumbleLeftTrigger:left_rumble andRightTrigger:right_rumble]; } else { return SDL_Unsupported(); } #else return SDL_Unsupported(); #endif } static SDL_bool IOS_JoystickHasLED(SDL_Joystick *joystick) { #ifdef ENABLE_MFI_LIGHT @autoreleasepool { if (@available(macos 11.0, iOS 14.0, tvOS 14.0, *)) { GCController *controller = joystick->hwdata->controller; GCDeviceLight *light = controller.light; if (light) { return SDL_TRUE; } } } #endif /* ENABLE_MFI_LIGHT */ return SDL_FALSE; } static int IOS_JoystickSetLED(SDL_Joystick *joystick, Uint8 red, Uint8 green, Uint8 blue) { #ifdef ENABLE_MFI_LIGHT @autoreleasepool { if (@available(macos 11.0, iOS 14.0, tvOS 14.0, *)) { GCController *controller = joystick->hwdata->controller; GCDeviceLight *light = controller.light; if (light) { light.color = [[GCColor alloc] initWithRed:(float)red / 255.0f green:(float)green / 255.0f blue:(float)blue / 255.0f]; return 0; } } } #endif /* ENABLE_MFI_LIGHT */ return SDL_Unsupported(); } static int IOS_JoystickSetSensorsEnabled(SDL_Joystick *joystick, SDL_bool enabled) { #ifdef ENABLE_MFI_SENSORS @autoreleasepool { if (@available(macOS 11.0, iOS 14.0, tvOS 14.0, *)) { GCController *controller = joystick->hwdata->controller; GCMotion *motion = controller.motion; if (motion) { motion.sensorsActive = enabled ? YES : NO; return 0; } } } #endif /* ENABLE_MFI_SENSORS */ return SDL_Unsupported(); } static void IOS_JoystickUpdate(SDL_Joystick *joystick) { SDL_JoystickDeviceItem *device = joystick->hwdata; if (device == NULL) { return; } if (device->accelerometer) { IOS_AccelerometerUpdate(joystick); } else if (device->controller) { IOS_MFIJoystickUpdate(joystick); } } static void IOS_JoystickClose(SDL_Joystick *joystick) { SDL_JoystickDeviceItem *device = joystick->hwdata; if (device == NULL) { return; } device->joystick = NULL; @autoreleasepool { #ifdef ENABLE_MFI_RUMBLE if (device->rumble) { SDL_RumbleContext *rumble = (__bridge SDL_RumbleContext *)device->rumble; [rumble cleanup]; CFRelease(device->rumble); device->rumble = NULL; } #endif /* ENABLE_MFI_RUMBLE */ if (device->accelerometer) { #ifdef SDL_JOYSTICK_iOS_ACCELEROMETER [motionManager stopAccelerometerUpdates]; #endif } else if (device->controller) { #ifdef SDL_JOYSTICK_MFI GCController *controller = device->controller; controller.controllerPausedHandler = nil; controller.playerIndex = -1; #endif } } if (device->remote) { --SDL_AppleTVRemoteOpenedAsJoystick; } } static void IOS_JoystickQuit(void) { @autoreleasepool { #ifdef SDL_JOYSTICK_MFI NSNotificationCenter *center = [NSNotificationCenter defaultCenter]; if (connectObserver) { [center removeObserver:connectObserver name:GCControllerDidConnectNotification object:nil]; connectObserver = nil; } if (disconnectObserver) { [center removeObserver:disconnectObserver name:GCControllerDidDisconnectNotification object:nil]; disconnectObserver = nil; } #if TARGET_OS_TV SDL_DelHintCallback(SDL_HINT_APPLE_TV_REMOTE_ALLOW_ROTATION, SDL_AppleTVRemoteRotationHintChanged, NULL); #endif /* TARGET_OS_TV */ #endif /* SDL_JOYSTICK_MFI */ while (deviceList != NULL) { IOS_RemoveJoystickDevice(deviceList); } #ifdef SDL_JOYSTICK_iOS_ACCELEROMETER motionManager = nil; #endif } numjoysticks = 0; } static SDL_bool IOS_JoystickGetGamepadMapping(int device_index, SDL_GamepadMapping *out) { return SDL_FALSE; } #if defined(SDL_JOYSTICK_MFI) && defined(__MACOSX__) SDL_bool IOS_SupportedHIDDevice(IOHIDDeviceRef device) { if (is_macos11()) { return [GCController supportsHIDDevice:device] ? SDL_TRUE : SDL_FALSE; } return SDL_FALSE; } #endif SDL_JoystickDriver SDL_IOS_JoystickDriver = { IOS_JoystickInit, IOS_JoystickGetCount, IOS_JoystickDetect, IOS_JoystickGetDeviceName, IOS_JoystickGetDevicePlayerIndex, IOS_JoystickSetDevicePlayerIndex, IOS_JoystickGetDeviceGUID, IOS_JoystickGetDeviceInstanceID, IOS_JoystickOpen, IOS_JoystickRumble, IOS_JoystickRumbleTriggers, IOS_JoystickHasLED, IOS_JoystickSetLED, IOS_JoystickSetSensorsEnabled, IOS_JoystickUpdate, IOS_JoystickClose, IOS_JoystickQuit, IOS_JoystickGetGamepadMapping }; /* vi: set ts=4 sw=4 expandtab: */