// Copyright 2014 Dolphin Emulator Project // SPDX-License-Identifier: GPL-2.0-or-later #include #include #include #include #include #include "Common/Event.h" #include "Common/Flag.h" #include "Common/Logging/Log.h" #include "Common/ScopeGuard.h" #include "Common/Thread.h" #include "Core/Config/MainSettings.h" #include "Core/ConfigManager.h" #include "Core/Core.h" #include "Core/CoreTiming.h" #include "Core/HW/SI/SI.h" #include "Core/HW/SI/SI_Device.h" #include "Core/HW/SystemTimers.h" #include "Core/LibusbUtils.h" #include "Core/NetPlayProto.h" #include "InputCommon/GCAdapter.h" #include "InputCommon/GCPadStatus.h" #if defined(LIBUSB_API_VERSION) #define LIBUSB_API_VERSION_EXIST 1 #else #define LIBUSB_API_VERSION_EXIST 0 #endif #define LIBUSB_API_VERSION_ATLEAST(v) (LIBUSB_API_VERSION_EXIST && LIBUSB_API_VERSION >= (v)) #define LIBUSB_API_HAS_HOTPLUG LIBUSB_API_VERSION_ATLEAST(0x01000102) namespace GCAdapter { static bool CheckDeviceAccess(libusb_device* device); static void AddGCAdapter(libusb_device* device); static void ResetRumbleLockNeeded(); static void Reset(); static void Setup(); enum { NO_ADAPTER_DETECTED = 0, ADAPTER_DETECTED = 1, }; // Current adapter status: detected/not detected/in error (holds the error code) static std::atomic s_status = NO_ADAPTER_DETECTED; static libusb_device_handle* s_handle = nullptr; static std::array s_controller_type = { ControllerTypes::CONTROLLER_NONE, ControllerTypes::CONTROLLER_NONE, ControllerTypes::CONTROLLER_NONE, ControllerTypes::CONTROLLER_NONE}; static std::array s_controller_rumble{}; static std::mutex s_mutex; static u8 s_controller_payload[37]; static u8 s_controller_payload_swap[37]; // Only access with s_mutex held! static int s_controller_payload_size = {0}; static std::thread s_adapter_input_thread; static std::thread s_adapter_output_thread; static Common::Flag s_adapter_thread_running; static Common::Event s_rumble_data_available; static std::mutex s_init_mutex; static std::thread s_adapter_detect_thread; static Common::Flag s_adapter_detect_thread_running; static Common::Event s_hotplug_event; static std::function s_detect_callback; #if defined(__FreeBSD__) && __FreeBSD__ >= 11 static bool s_libusb_hotplug_enabled = true; #else static bool s_libusb_hotplug_enabled = false; #endif #if LIBUSB_API_HAS_HOTPLUG static libusb_hotplug_callback_handle s_hotplug_handle; #endif static std::unique_ptr s_libusb_context; static u8 s_endpoint_in = 0; static u8 s_endpoint_out = 0; static u64 s_last_init = 0; static std::optional s_config_callback_id = std::nullopt; static std::array s_config_si_device_type{}; static std::array s_config_rumble_enabled{}; static void Read() { Common::SetCurrentThreadName("GCAdapter Read Thread"); int payload_size = 0; while (s_adapter_thread_running.IsSet()) { int err = libusb_interrupt_transfer(s_handle, s_endpoint_in, s_controller_payload_swap, sizeof(s_controller_payload_swap), &payload_size, 16); if (err) ERROR_LOG_FMT(CONTROLLERINTERFACE, "adapter libusb read failed: err={}", libusb_error_name(err)); { std::lock_guard lk(s_mutex); std::swap(s_controller_payload_swap, s_controller_payload); s_controller_payload_size = payload_size; } Common::YieldCPU(); } } static void Write() { Common::SetCurrentThreadName("GCAdapter Write Thread"); int size = 0; while (true) { s_rumble_data_available.Wait(); if (!s_adapter_thread_running.IsSet()) return; u8 payload[5] = { 0x11, s_controller_rumble[0], s_controller_rumble[1], s_controller_rumble[2], s_controller_rumble[3], }; const int err = libusb_interrupt_transfer(s_handle, s_endpoint_out, payload, sizeof(payload), &size, 16); if (err != 0) ERROR_LOG_FMT(CONTROLLERINTERFACE, "adapter libusb write failed: err={}", libusb_error_name(err)); } } #if LIBUSB_API_HAS_HOTPLUG static int HotplugCallback(libusb_context* ctx, libusb_device* dev, libusb_hotplug_event event, void* user_data) { if (event == LIBUSB_HOTPLUG_EVENT_DEVICE_ARRIVED) { if (s_handle == nullptr) s_hotplug_event.Set(); } else if (event == LIBUSB_HOTPLUG_EVENT_DEVICE_LEFT) { if (s_handle != nullptr && libusb_get_device(s_handle) == dev) Reset(); // Reset a potential error status now that the adapter is unplugged if (s_status < 0) { s_status = NO_ADAPTER_DETECTED; if (s_detect_callback != nullptr) s_detect_callback(); } } return 0; } #endif static void ScanThreadFunc() { Common::SetCurrentThreadName("GC Adapter Scanning Thread"); NOTICE_LOG_FMT(CONTROLLERINTERFACE, "GC Adapter scanning thread started"); #if LIBUSB_API_HAS_HOTPLUG #ifndef __FreeBSD__ s_libusb_hotplug_enabled = libusb_has_capability(LIBUSB_CAP_HAS_HOTPLUG) != 0; #endif if (s_libusb_hotplug_enabled) { if (libusb_hotplug_register_callback( *s_libusb_context, (libusb_hotplug_event)(LIBUSB_HOTPLUG_EVENT_DEVICE_ARRIVED | LIBUSB_HOTPLUG_EVENT_DEVICE_LEFT), LIBUSB_HOTPLUG_ENUMERATE, 0x057e, 0x0337, LIBUSB_HOTPLUG_MATCH_ANY, HotplugCallback, nullptr, &s_hotplug_handle) != LIBUSB_SUCCESS) s_libusb_hotplug_enabled = false; if (s_libusb_hotplug_enabled) NOTICE_LOG_FMT(CONTROLLERINTERFACE, "Using libUSB hotplug detection"); } #endif while (s_adapter_detect_thread_running.IsSet()) { if (s_handle == nullptr) { std::lock_guard lk(s_init_mutex); Setup(); } if (s_libusb_hotplug_enabled) s_hotplug_event.Wait(); else Common::SleepCurrentThread(500); } NOTICE_LOG_FMT(CONTROLLERINTERFACE, "GC Adapter scanning thread stopped"); } void SetAdapterCallback(std::function func) { s_detect_callback = func; } static void RefreshConfig() { for (int i = 0; i < SerialInterface::MAX_SI_CHANNELS; ++i) { s_config_si_device_type[i] = Config::Get(Config::GetInfoForSIDevice(i)); s_config_rumble_enabled[i] = Config::Get(Config::GetInfoForAdapterRumble(i)); } } void Init() { if (s_handle != nullptr) return; s_libusb_context = std::make_unique(); if (Core::GetState() != Core::State::Uninitialized && Core::GetState() != Core::State::Starting) { if ((CoreTiming::GetTicks() - s_last_init) < SystemTimers::GetTicksPerSecond()) return; s_last_init = CoreTiming::GetTicks(); } s_status = NO_ADAPTER_DETECTED; if (!s_config_callback_id) s_config_callback_id = Config::AddConfigChangedCallback(RefreshConfig); RefreshConfig(); if (UseAdapter()) StartScanThread(); } void StartScanThread() { if (s_adapter_detect_thread_running.IsSet()) return; if (!s_libusb_context->IsValid()) return; s_adapter_detect_thread_running.Set(true); s_adapter_detect_thread = std::thread(ScanThreadFunc); } void StopScanThread() { if (s_adapter_detect_thread_running.TestAndClear()) { s_hotplug_event.Set(); s_adapter_detect_thread.join(); } } static void Setup() { int prev_status = s_status; // Reset the error status in case the adapter gets unplugged if (s_status < 0) s_status = NO_ADAPTER_DETECTED; s_controller_type.fill(ControllerTypes::CONTROLLER_NONE); s_controller_rumble.fill(0); s_libusb_context->GetDeviceList([](libusb_device* device) { if (CheckDeviceAccess(device)) { // Only connect to a single adapter in case the user has multiple connected AddGCAdapter(device); return false; } return true; }); if (s_status != ADAPTER_DETECTED && prev_status != s_status && s_detect_callback != nullptr) s_detect_callback(); } static bool CheckDeviceAccess(libusb_device* device) { libusb_device_descriptor desc; int ret = libusb_get_device_descriptor(device, &desc); if (ret != 0) { // could not acquire the descriptor, no point in trying to use it. ERROR_LOG_FMT(CONTROLLERINTERFACE, "libusb_get_device_descriptor failed with error: {}", ret); return false; } if (desc.idVendor != 0x057e || desc.idProduct != 0x0337) { // This isn’t the device we are looking for. return false; } NOTICE_LOG_FMT(CONTROLLERINTERFACE, "Found GC Adapter with Vendor: {:X} Product: {:X} Devnum: {}", desc.idVendor, desc.idProduct, 1); // In case of failure, capture the libusb error code into the adapter status Common::ScopeGuard status_guard([&ret] { s_status = ret; }); const u8 bus = libusb_get_bus_number(device); const u8 port = libusb_get_device_address(device); ret = libusb_open(device, &s_handle); if (ret == LIBUSB_ERROR_ACCESS) { ERROR_LOG_FMT( CONTROLLERINTERFACE, "Dolphin does not have access to this device: Bus {:03d} Device {:03d}: ID {:04X}:{:04X}.", bus, port, desc.idVendor, desc.idProduct); return false; } if (ret != 0) { ERROR_LOG_FMT(CONTROLLERINTERFACE, "libusb_open failed to open device with error = {}", ret); return false; } bool detach_failed = false; ret = libusb_kernel_driver_active(s_handle, 0); if (ret == 1) { // On macos detaching would fail without root or entitlement. // We assume user is using GCAdapterDriver and therefor don't want to detach anything #if !defined(__APPLE__) ret = libusb_detach_kernel_driver(s_handle, 0); detach_failed = ret < 0 && ret != LIBUSB_ERROR_NOT_FOUND && ret != LIBUSB_ERROR_NOT_SUPPORTED; #endif if (detach_failed) ERROR_LOG_FMT(CONTROLLERINTERFACE, "libusb_detach_kernel_driver failed with error: {}", ret); } // This call makes Nyko-brand (and perhaps other) adapters work. // However it returns LIBUSB_ERROR_PIPE with Mayflash adapters. const int transfer = libusb_control_transfer(s_handle, 0x21, 11, 0x0001, 0, nullptr, 0, 1000); if (transfer < 0) WARN_LOG_FMT(CONTROLLERINTERFACE, "libusb_control_transfer failed with error: {}", transfer); // this split is needed so that we don't avoid claiming the interface when // detaching the kernel driver is successful if (detach_failed) { libusb_close(s_handle); s_handle = nullptr; return false; } ret = libusb_claim_interface(s_handle, 0); if (ret != 0) { ERROR_LOG_FMT(CONTROLLERINTERFACE, "libusb_claim_interface failed with error: {}", ret); libusb_close(s_handle); s_handle = nullptr; return false; } // Updating the adapter status will be done in AddGCAdapter status_guard.Dismiss(); return true; } static void AddGCAdapter(libusb_device* device) { libusb_config_descriptor* config = nullptr; libusb_get_config_descriptor(device, 0, &config); for (u8 ic = 0; ic < config->bNumInterfaces; ic++) { const libusb_interface* interfaceContainer = &config->interface[ic]; for (int i = 0; i < interfaceContainer->num_altsetting; i++) { const libusb_interface_descriptor* interface = &interfaceContainer->altsetting[i]; for (u8 e = 0; e < interface->bNumEndpoints; e++) { const libusb_endpoint_descriptor* endpoint = &interface->endpoint[e]; if (endpoint->bEndpointAddress & LIBUSB_ENDPOINT_IN) s_endpoint_in = endpoint->bEndpointAddress; else s_endpoint_out = endpoint->bEndpointAddress; } } } int tmp = 0; unsigned char payload = 0x13; libusb_interrupt_transfer(s_handle, s_endpoint_out, &payload, sizeof(payload), &tmp, 16); s_adapter_thread_running.Set(true); s_adapter_input_thread = std::thread(Read); s_adapter_output_thread = std::thread(Write); s_status = ADAPTER_DETECTED; if (s_detect_callback != nullptr) s_detect_callback(); ResetRumbleLockNeeded(); } void Shutdown() { StopScanThread(); #if LIBUSB_API_HAS_HOTPLUG if (s_libusb_context->IsValid() && s_libusb_hotplug_enabled) libusb_hotplug_deregister_callback(*s_libusb_context, s_hotplug_handle); #endif Reset(); s_libusb_context.reset(); s_status = NO_ADAPTER_DETECTED; if (s_config_callback_id) { Config::RemoveConfigChangedCallback(*s_config_callback_id); s_config_callback_id = std::nullopt; } } static void Reset() { std::unique_lock lock(s_init_mutex, std::defer_lock); if (!lock.try_lock()) return; if (s_status != ADAPTER_DETECTED) return; if (s_adapter_thread_running.TestAndClear()) { s_rumble_data_available.Set(); s_adapter_input_thread.join(); s_adapter_output_thread.join(); } s_controller_type.fill(ControllerTypes::CONTROLLER_NONE); s_status = NO_ADAPTER_DETECTED; if (s_handle) { libusb_release_interface(s_handle, 0); libusb_close(s_handle); s_handle = nullptr; } if (s_detect_callback != nullptr) s_detect_callback(); NOTICE_LOG_FMT(CONTROLLERINTERFACE, "GC Adapter detached"); } GCPadStatus Input(int chan) { if (!UseAdapter()) return {}; if (s_handle == nullptr || s_status != ADAPTER_DETECTED) return {}; int payload_size = 0; u8 controller_payload_copy[37]; { std::lock_guard lk(s_mutex); std::copy(std::begin(s_controller_payload), std::end(s_controller_payload), std::begin(controller_payload_copy)); payload_size = s_controller_payload_size; } GCPadStatus pad = {}; if (payload_size != sizeof(controller_payload_copy) || controller_payload_copy[0] != LIBUSB_DT_HID) { // This can occur for a few frames on initialization. ERROR_LOG_FMT(CONTROLLERINTERFACE, "error reading payload (size: {}, type: {:02x})", payload_size, controller_payload_copy[0]); } else { bool get_origin = false; u8 type = controller_payload_copy[1 + (9 * chan)] >> 4; if (type != ControllerTypes::CONTROLLER_NONE && s_controller_type[chan] == ControllerTypes::CONTROLLER_NONE) { NOTICE_LOG_FMT(CONTROLLERINTERFACE, "New device connected to Port {} of Type: {:02x}", chan + 1, controller_payload_copy[1 + (9 * chan)]); get_origin = true; } s_controller_type[chan] = type; if (s_controller_type[chan] != ControllerTypes::CONTROLLER_NONE) { u8 b1 = controller_payload_copy[1 + (9 * chan) + 1]; u8 b2 = controller_payload_copy[1 + (9 * chan) + 2]; if (b1 & (1 << 0)) pad.button |= PAD_BUTTON_A; if (b1 & (1 << 1)) pad.button |= PAD_BUTTON_B; if (b1 & (1 << 2)) pad.button |= PAD_BUTTON_X; if (b1 & (1 << 3)) pad.button |= PAD_BUTTON_Y; if (b1 & (1 << 4)) pad.button |= PAD_BUTTON_LEFT; if (b1 & (1 << 5)) pad.button |= PAD_BUTTON_RIGHT; if (b1 & (1 << 6)) pad.button |= PAD_BUTTON_DOWN; if (b1 & (1 << 7)) pad.button |= PAD_BUTTON_UP; if (b2 & (1 << 0)) pad.button |= PAD_BUTTON_START; if (b2 & (1 << 1)) pad.button |= PAD_TRIGGER_Z; if (b2 & (1 << 2)) pad.button |= PAD_TRIGGER_R; if (b2 & (1 << 3)) pad.button |= PAD_TRIGGER_L; if (get_origin) pad.button |= PAD_GET_ORIGIN; pad.stickX = controller_payload_copy[1 + (9 * chan) + 3]; pad.stickY = controller_payload_copy[1 + (9 * chan) + 4]; pad.substickX = controller_payload_copy[1 + (9 * chan) + 5]; pad.substickY = controller_payload_copy[1 + (9 * chan) + 6]; pad.triggerLeft = controller_payload_copy[1 + (9 * chan) + 7]; pad.triggerRight = controller_payload_copy[1 + (9 * chan) + 8]; } else if (!Core::WantsDeterminism()) { // This is a hack to prevent a desync due to SI devices // being different and returning different values. // The corresponding code in DeviceGCAdapter has the same check pad.button = PAD_ERR_STATUS; } } return pad; } bool DeviceConnected(int chan) { return s_controller_type[chan] != ControllerTypes::CONTROLLER_NONE; } void ResetDeviceType(int chan) { s_controller_type[chan] = ControllerTypes::CONTROLLER_NONE; } bool UseAdapter() { const auto& si_devices = s_config_si_device_type; return std::any_of(si_devices.begin(), si_devices.end(), [](const auto device_type) { return device_type == SerialInterface::SIDEVICE_WIIU_ADAPTER; }); } void ResetRumble() { std::unique_lock lock(s_init_mutex, std::defer_lock); if (!lock.try_lock()) return; ResetRumbleLockNeeded(); } // Needs to be called when s_init_mutex is locked in order to avoid // being called while the libusb state is being reset static void ResetRumbleLockNeeded() { if (!UseAdapter() || (s_handle == nullptr || s_status != ADAPTER_DETECTED)) { return; } std::fill(std::begin(s_controller_rumble), std::end(s_controller_rumble), 0); unsigned char rumble[5] = {0x11, s_controller_rumble[0], s_controller_rumble[1], s_controller_rumble[2], s_controller_rumble[3]}; int size = 0; libusb_interrupt_transfer(s_handle, s_endpoint_out, rumble, sizeof(rumble), &size, 16); INFO_LOG_FMT(CONTROLLERINTERFACE, "Rumble state reset"); } void Output(int chan, u8 rumble_command) { if (s_handle == nullptr || !UseAdapter() || !s_config_rumble_enabled[chan]) return; // Skip over rumble commands if it has not changed or the controller is wireless if (rumble_command != s_controller_rumble[chan] && s_controller_type[chan] != ControllerTypes::CONTROLLER_WIRELESS) { s_controller_rumble[chan] = rumble_command; s_rumble_data_available.Set(); } } bool IsDetected(const char** error_message) { if (s_status >= 0) { if (error_message) *error_message = nullptr; return s_status == ADAPTER_DETECTED; } if (error_message) *error_message = libusb_strerror(static_cast(s_status.load())); return false; } } // namespace GCAdapter