// Copyright 2015 Citra Emulator Project // Licensed under GPLv2 or any later version // Refer to the license.txt file included. #pragma once #include #include #ifndef _MSC_VER #include #endif #include #include "common/bit_field.h" #include "common/common_funcs.h" #include "common/common_types.h" #include "core/frontend/input.h" #include "core/hle/kernel/kernel.h" #include "core/hle/service/service.h" #include "core/settings.h" namespace Kernel { class Event; class SharedMemory; } namespace CoreTiming { class EventType; }; namespace Service { namespace HID { /** * Structure of a Pad controller state. */ struct PadState { union { u32 hex{}; BitField<0, 1, u32> a; BitField<1, 1, u32> b; BitField<2, 1, u32> select; BitField<3, 1, u32> start; BitField<4, 1, u32> right; BitField<5, 1, u32> left; BitField<6, 1, u32> up; BitField<7, 1, u32> down; BitField<8, 1, u32> r; BitField<9, 1, u32> l; BitField<10, 1, u32> x; BitField<11, 1, u32> y; BitField<28, 1, u32> circle_right; BitField<29, 1, u32> circle_left; BitField<30, 1, u32> circle_up; BitField<31, 1, u32> circle_down; }; }; /** * Structure of a single entry of Pad state history within HID shared memory */ struct PadDataEntry { PadState current_state; PadState delta_additions; PadState delta_removals; s16 circle_pad_x; s16 circle_pad_y; }; /** * Structure of a single entry of touch state history within HID shared memory */ struct TouchDataEntry { u16 x; ///< Y-coordinate of a touchpad press on the lower screen u16 y; ///< X-coordinate of a touchpad press on the lower screen BitField<0, 7, u32> valid; ///< Set to 1 when this entry contains actual X/Y data, otherwise 0 }; /** * Structure of a single entry of accelerometer state history within HID shared memory */ struct AccelerometerDataEntry { s16 x; s16 y; s16 z; }; /** * Structure of a single entry of gyroscope state history within HID shared memory */ struct GyroscopeDataEntry { s16 x; s16 y; s16 z; }; /** * Structure of data stored in HID shared memory */ struct SharedMem { /// Pad data, this is used for buttons and the circle pad struct { s64 index_reset_ticks; ///< CPU tick count for when HID module updated entry index 0 s64 index_reset_ticks_previous; ///< Previous `index_reset_ticks` u32 index; ///< Index of the last updated pad state entry INSERT_PADDING_WORDS(0x2); PadState current_state; ///< Current state of the pad buttons // TODO(bunnei): Implement `raw_circle_pad_data` field u32 raw_circle_pad_data; ///< Raw (analog) circle pad data, before being converted INSERT_PADDING_WORDS(0x1); std::array entries; ///< Last 8 pad entries } pad; /// Touchpad data, this is used for touchpad input struct { s64 index_reset_ticks; ///< CPU tick count for when HID module updated entry index 0 s64 index_reset_ticks_previous; ///< Previous `index_reset_ticks` u32 index; ///< Index of the last updated touch entry INSERT_PADDING_WORDS(0x1); // TODO(bunnei): Implement `raw_entry` field TouchDataEntry raw_entry; ///< Raw (analog) touch data, before being converted std::array entries; ///< Last 8 touch entries, in pixel coordinates } touch; /// Accelerometer data struct { s64 index_reset_ticks; ///< CPU tick count for when HID module updated entry index 0 s64 index_reset_ticks_previous; ///< Previous `index_reset_ticks` u32 index; ///< Index of the last updated accelerometer entry INSERT_PADDING_WORDS(0x1); AccelerometerDataEntry raw_entry; INSERT_PADDING_BYTES(2); std::array entries; } accelerometer; /// Gyroscope data struct { s64 index_reset_ticks; ///< CPU tick count for when HID module updated entry index 0 s64 index_reset_ticks_previous; ///< Previous `index_reset_ticks` u32 index; ///< Index of the last updated accelerometer entry INSERT_PADDING_WORDS(0x1); GyroscopeDataEntry raw_entry; INSERT_PADDING_BYTES(2); std::array entries; } gyroscope; }; /** * Structure of calibrate params that GetGyroscopeLowCalibrateParam returns */ struct GyroscopeCalibrateParam { struct { // TODO (wwylele): figure out the exact meaning of these params s16 zero_point; s16 positive_unit_point; s16 negative_unit_point; } x, y, z; }; // TODO: MSVC does not support using offsetof() on non-static data members even though this // is technically allowed since C++11. This macro should be enabled once MSVC adds // support for that. #ifndef _MSC_VER #define ASSERT_REG_POSITION(field_name, position) \ static_assert(offsetof(SharedMem, field_name) == position * 4, \ "Field " #field_name " has invalid position") ASSERT_REG_POSITION(pad.index_reset_ticks, 0x0); ASSERT_REG_POSITION(touch.index_reset_ticks, 0x2A); #undef ASSERT_REG_POSITION #endif // !defined(_MSC_VER) struct DirectionState { bool up; bool down; bool left; bool right; }; /// Translates analog stick axes to directions. This is exposed for ir_rst module to use. DirectionState GetStickDirectionState(s16 circle_pad_x, s16 circle_pad_y); class Module final { public: Module(); class Interface : public ServiceFramework { public: Interface(std::shared_ptr hid, const char* name, u32 max_session); protected: /** * HID::GetIPCHandles service function * Inputs: * None * Outputs: * 1 : Result of function, 0 on success, otherwise error code * 2 : IPC Command Structure translate-header * 3 : Handle to HID shared memory * 4 : Event signaled by HID * 5 : Event signaled by HID * 6 : Event signaled by HID * 7 : Gyroscope event * 8 : Event signaled by HID */ void GetIPCHandles(Kernel::HLERequestContext& ctx); /** * HID::EnableAccelerometer service function * Inputs: * None * Outputs: * 1 : Result of function, 0 on success, otherwise error code */ void EnableAccelerometer(Kernel::HLERequestContext& ctx); /** * HID::DisableAccelerometer service function * Inputs: * None * Outputs: * 1 : Result of function, 0 on success, otherwise error code */ void DisableAccelerometer(Kernel::HLERequestContext& ctx); /** * HID::EnableGyroscopeLow service function * Inputs: * None * Outputs: * 1 : Result of function, 0 on success, otherwise error code */ void EnableGyroscopeLow(Kernel::HLERequestContext& ctx); /** * HID::DisableGyroscopeLow service function * Inputs: * None * Outputs: * 1 : Result of function, 0 on success, otherwise error code */ void DisableGyroscopeLow(Kernel::HLERequestContext& ctx); /** * HID::GetSoundVolume service function * Inputs: * None * Outputs: * 1 : Result of function, 0 on success, otherwise error code * 2 : u8 output value */ void GetSoundVolume(Kernel::HLERequestContext& ctx); /** * HID::GetGyroscopeLowRawToDpsCoefficient service function * Inputs: * None * Outputs: * 1 : Result of function, 0 on success, otherwise error code * 2 : float output value */ void GetGyroscopeLowRawToDpsCoefficient(Kernel::HLERequestContext& ctx); /** * HID::GetGyroscopeLowCalibrateParam service function * Inputs: * None * Outputs: * 1 : Result of function, 0 on success, otherwise error code * 2~6 (18 bytes) : struct GyroscopeCalibrateParam */ void GetGyroscopeLowCalibrateParam(Kernel::HLERequestContext& ctx); private: std::shared_ptr hid; }; void ReloadInputDevices(); private: void LoadInputDevices(); void UpdatePadCallback(u64 userdata, int cycles_late); void UpdateAccelerometerCallback(u64 userdata, int cycles_late); void UpdateGyroscopeCallback(u64 userdata, int cycles_late); // Handle to shared memory region designated to HID_User service Kernel::SharedPtr shared_mem; // Event handles Kernel::SharedPtr event_pad_or_touch_1; Kernel::SharedPtr event_pad_or_touch_2; Kernel::SharedPtr event_accelerometer; Kernel::SharedPtr event_gyroscope; Kernel::SharedPtr event_debug_pad; u32 next_pad_index = 0; u32 next_touch_index = 0; u32 next_accelerometer_index = 0; u32 next_gyroscope_index = 0; int enable_accelerometer_count = 0; // positive means enabled int enable_gyroscope_count = 0; // positive means enabled CoreTiming::EventType* pad_update_event; CoreTiming::EventType* accelerometer_update_event; CoreTiming::EventType* gyroscope_update_event; std::atomic is_device_reload_pending{true}; std::array, Settings::NativeButton::NUM_BUTTONS_HID> buttons; std::unique_ptr circle_pad; std::unique_ptr motion_device; std::unique_ptr touch_device; }; void InstallInterfaces(SM::ServiceManager& service_manager); /// Reload input devices. Used when input configuration changed void ReloadInputDevices(); } }