// SPDX-FileCopyrightText: 2017 Citra Emulator Project // SPDX-License-Identifier: GPL-2.0-or-later #pragma once #include #include #include #include #include #include #include "common/logging/log.h" #include "common/param_package.h" #include "common/uuid.h" namespace Common::Input { // Type of data that is expected to recieve or send enum class InputType { None, Battery, Button, Stick, Analog, Trigger, Motion, Touch, Color, Vibration, Nfc, IrSensor, }; // Internal battery charge level enum class BatteryLevel : u32 { None, Empty, Critical, Low, Medium, Full, Charging, }; enum class PollingMode { // Constant polling of buttons, analogs and motion data Active, // Only update on button change, digital analogs Pasive, // Enable near field communication polling NFC, // Enable infrared camera polling IR, // Enable ring controller polling Ring, }; enum class CameraFormat { Size320x240, Size160x120, Size80x60, Size40x30, Size20x15, None, }; // Different results that can happen from a device request enum class DriverResult { Success, WrongReply, Timeout, UnsupportedControllerType, HandleInUse, ErrorReadingData, ErrorWritingData, NoDeviceDetected, InvalidHandle, NotSupported, Disabled, Unknown, }; // Nfc reply from the controller enum class NfcState { Success, NewAmiibo, WaitingForAmiibo, AmiiboRemoved, NotAnAmiibo, NotSupported, WrongDeviceState, WriteFailed, Unknown, }; // Hint for amplification curve to be used enum class VibrationAmplificationType { Linear, Exponential, }; // Analog properties for calibration struct AnalogProperties { // Anything below this value will be detected as zero float deadzone{}; // Anyting above this values will be detected as one float range{1.0f}; // Minimum value to be detected as active float threshold{0.5f}; // Drift correction applied to the raw data float offset{}; // Invert direction of the sensor data bool inverted{}; // Press once to activate, press again to release bool toggle{}; }; // Single analog sensor data struct AnalogStatus { float value{}; float raw_value{}; AnalogProperties properties{}; }; // Button data struct ButtonStatus { Common::UUID uuid{}; bool value{}; // Invert value of the button bool inverted{}; // Press once to activate, press again to release bool toggle{}; // Internal lock for the toggle status bool locked{}; }; // Internal battery data using BatteryStatus = BatteryLevel; // Analog and digital joystick data struct StickStatus { Common::UUID uuid{}; AnalogStatus x{}; AnalogStatus y{}; bool left{}; bool right{}; bool up{}; bool down{}; }; // Analog and digital trigger data struct TriggerStatus { Common::UUID uuid{}; AnalogStatus analog{}; ButtonStatus pressed{}; }; // 3D vector representing motion input struct MotionSensor { AnalogStatus x{}; AnalogStatus y{}; AnalogStatus z{}; }; // Motion data used to calculate controller orientation struct MotionStatus { // Gyroscope vector measurement in radians/s. MotionSensor gyro{}; // Acceleration vector measurement in G force MotionSensor accel{}; // Time since last measurement in microseconds u64 delta_timestamp{}; // Request to update after reading the value bool force_update{}; }; // Data of a single point on a touch screen struct TouchStatus { ButtonStatus pressed{}; AnalogStatus x{}; AnalogStatus y{}; int id{}; }; // Physical controller color in RGB format struct BodyColorStatus { u32 body{}; u32 buttons{}; u32 left_grip{}; u32 right_grip{}; }; // HD rumble data struct VibrationStatus { f32 low_amplitude{}; f32 low_frequency{}; f32 high_amplitude{}; f32 high_frequency{}; VibrationAmplificationType type; }; // Physical controller LED pattern struct LedStatus { bool led_1{}; bool led_2{}; bool led_3{}; bool led_4{}; }; // Raw data fom camera struct CameraStatus { CameraFormat format{CameraFormat::None}; std::vector data{}; }; struct NfcStatus { NfcState state{}; std::vector data{}; }; // List of buttons to be passed to Qt that can be translated enum class ButtonNames { Undefined, Invalid, // This will display the engine name instead of the button name Engine, // This will display the button by value instead of the button name Value, // Joycon button names ButtonLeft, ButtonRight, ButtonDown, ButtonUp, ButtonA, ButtonB, ButtonX, ButtonY, ButtonPlus, ButtonMinus, ButtonHome, ButtonCapture, ButtonStickL, ButtonStickR, TriggerL, TriggerZL, TriggerSL, TriggerR, TriggerZR, TriggerSR, // GC button names TriggerZ, ButtonStart, // DS4 button names L1, L2, L3, R1, R2, R3, Circle, Cross, Square, Triangle, Share, Options, Home, Touch, // Mouse buttons ButtonMouseWheel, ButtonBackward, ButtonForward, ButtonTask, ButtonExtra, }; // Callback data consisting of an input type and the equivalent data status struct CallbackStatus { InputType type{InputType::None}; ButtonStatus button_status{}; StickStatus stick_status{}; AnalogStatus analog_status{}; TriggerStatus trigger_status{}; MotionStatus motion_status{}; TouchStatus touch_status{}; BodyColorStatus color_status{}; BatteryStatus battery_status{}; VibrationStatus vibration_status{}; CameraFormat camera_status{CameraFormat::None}; NfcState nfc_status{NfcState::Unknown}; std::vector raw_data{}; }; // Triggered once every input change struct InputCallback { std::function on_change; }; /// An abstract class template for an input device (a button, an analog input, etc.). class InputDevice { public: virtual ~InputDevice() = default; // Request input device to update if necessary virtual void SoftUpdate() {} // Force input device to update data regardless of the current state virtual void ForceUpdate() {} // Sets the function to be triggered when input changes void SetCallback(InputCallback callback_) { callback = std::move(callback_); } // Triggers the function set in the callback void TriggerOnChange(const CallbackStatus& status) { if (callback.on_change) { callback.on_change(status); } } private: InputCallback callback; }; /// An abstract class template for an output device (rumble, LED pattern, polling mode). class OutputDevice { public: virtual ~OutputDevice() = default; virtual DriverResult SetLED([[maybe_unused]] const LedStatus& led_status) { return DriverResult::NotSupported; } virtual DriverResult SetVibration([[maybe_unused]] const VibrationStatus& vibration_status) { return DriverResult::NotSupported; } virtual bool IsVibrationEnabled() { return false; } virtual DriverResult SetPollingMode([[maybe_unused]] PollingMode polling_mode) { return DriverResult::NotSupported; } virtual DriverResult SetCameraFormat([[maybe_unused]] CameraFormat camera_format) { return DriverResult::NotSupported; } virtual NfcState SupportsNfc() const { return NfcState::NotSupported; } virtual NfcState WriteNfcData([[maybe_unused]] const std::vector& data) { return NfcState::NotSupported; } }; /// An abstract class template for a factory that can create input devices. template class Factory { public: virtual ~Factory() = default; virtual std::unique_ptr Create(const Common::ParamPackage&) = 0; }; namespace Impl { template using FactoryListType = std::unordered_map>>; template struct FactoryList { static FactoryListType list; }; template FactoryListType FactoryList::list; } // namespace Impl /** * Registers an input device factory. * @tparam InputDeviceType the type of input devices the factory can create * @param name the name of the factory. Will be used to match the "engine" parameter when creating * a device * @param factory the factory object to register */ template void RegisterFactory(const std::string& name, std::shared_ptr> factory) { auto pair = std::make_pair(name, std::move(factory)); if (!Impl::FactoryList::list.insert(std::move(pair)).second) { LOG_ERROR(Input, "Factory '{}' already registered", name); } } inline void RegisterInputFactory(const std::string& name, std::shared_ptr> factory) { RegisterFactory(name, std::move(factory)); } inline void RegisterOutputFactory(const std::string& name, std::shared_ptr> factory) { RegisterFactory(name, std::move(factory)); } /** * Unregisters an input device factory. * @tparam InputDeviceType the type of input devices the factory can create * @param name the name of the factory to unregister */ template void UnregisterFactory(const std::string& name) { if (Impl::FactoryList::list.erase(name) == 0) { LOG_ERROR(Input, "Factory '{}' not registered", name); } } inline void UnregisterInputFactory(const std::string& name) { UnregisterFactory(name); } inline void UnregisterOutputFactory(const std::string& name) { UnregisterFactory(name); } /** * Create an input device from given paramters. * @tparam InputDeviceType the type of input devices to create * @param params a serialized ParamPackage string that contains all parameters for creating the * device */ template std::unique_ptr CreateDeviceFromString(const std::string& params) { const Common::ParamPackage package(params); const std::string engine = package.Get("engine", "null"); const auto& factory_list = Impl::FactoryList::list; const auto pair = factory_list.find(engine); if (pair == factory_list.end()) { if (engine != "null") { LOG_ERROR(Input, "Unknown engine name: {}", engine); } return std::make_unique(); } return pair->second->Create(package); } inline std::unique_ptr CreateInputDeviceFromString(const std::string& params) { return CreateDeviceFromString(params); } inline std::unique_ptr CreateOutputDeviceFromString(const std::string& params) { return CreateDeviceFromString(params); } /** * Create an input device from given parameters. * @tparam InputDeviceType the type of input devices to create * @param package A ParamPackage that contains all parameters for creating the device */ template std::unique_ptr CreateDevice(const ParamPackage& package) { const std::string engine = package.Get("engine", "null"); const auto& factory_list = Impl::FactoryList::list; const auto pair = factory_list.find(engine); if (pair == factory_list.end()) { if (engine != "null") { LOG_ERROR(Input, "Unknown engine name: {}", engine); } return std::make_unique(); } return pair->second->Create(package); } inline std::unique_ptr CreateInputDevice(const ParamPackage& package) { return CreateDevice(package); } inline std::unique_ptr CreateOutputDevice(const ParamPackage& package) { return CreateDevice(package); } } // namespace Common::Input