Motion evdev: Difference between revisions

Add a note about dolphin combining IMU on switch controllers.
m (Add 2 missing lines at the top)
(Add a note about dolphin combining IMU on switch controllers.)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
These instruction are made with a Nintendo Pro controller and Joy-Cons. While the overall process will be the same the motion axis may not match those found on a Sony DualShock 4.
Dolphin supports the motion [https://en.wikipedia.org/wiki/Evdev evdev] devices but setting it up is a bit awkward. Nintendo Switch controllers (Joy-Con and Pro controller) are supported through the hid-nintendo driver. Sony DualShock 4 and DualSense through hid-sony/hid-playstation.


* Recent dolphin version (do not use 5.0 stable!)
The HID kernel driver exposes 2 (or more) evdev devices, one for the buttons and another for the accelerators/gyroscopes. The hid-nintendo driver exposes the motion axis on an "IMU" device while hid-playstation named it "Wireless Controller Motion Sensors". Do note that Nintendo Joy-Cons will have 2 devices each (4 in total).
* HID Nintendo kernel driver (dkms https://github.com/nicman23/dkms-hid-nintendo)
* Switch pro or Joy-Con.


The HID Nintendo kernel driver exposes 2 evdev devices, one for the buttons and another (IMU) for the accelerators/gyroscopes. Do note that Joy-Cons will have 2 devices each (4 in total).
You may need to add the users to a specific group to be allowed access. On Arch Linux this group is ''input''.


The IMU input device does not automatically get tagged with `uaccess` while the "regular" device is. If you do not see an IMU device listed in Dolphin's devicelist add the following udev rule to /etc/udev/rules.f/99-hidnintendo.rules. reload udev rules with "udevadm control --reload-rules" and reconnect the device(s).
It took me a bit of time figuring out which axis corresponds with the right motion control in Dolphin. '''These axis might change in the future when evdev standardizes them.
 
<pre>
ACTION!="add", GOTO="imuend"
SUBSYSTEM!="input", GOTO="imuend"
KERNEL!="event*", GOTO="imuend"
 
ATTRS{id/vendor}=="057e", ATTRS{id/product}=="2009", ATTRS{name}=="*IMU*", TAG+="uaccess"
ATTRS{id/vendor}=="057e", ATTRS{id/product}=="2006", ATTRS{name}=="*IMU*", TAG+="uaccess"
ATTRS{id/vendor}=="057e", ATTRS{id/product}=="2007", ATTRS{name}=="*IMU*", TAG+="uaccess"
ATTRS{id/vendor}=="057e", ATTRS{id/product}=="200e", ATTRS{name}=="*IMU*", TAG+="uaccess"
ATTRS{id/vendor}=="057e", ATTRS{id/product}=="2017", ATTRS{name}=="*IMU*", TAG+="uaccess"
 
LABEL="imuend"
</pre>
 
It took me a bit of time figuring out which axis corresponds with the right motion control in dolphin. '''These axis might change in the future when evdev standardizes them.
'''
'''
{| class="wikitable"
{| class="wikitable"
!Dolphin motion
!Dolphin motion
!Evdev axis HID Nintendo
!Switch controllers
!Sony DualSense/DualShock4
|-
|-
|Accel Up
|Accel Up
|Accel Z+
|Accel Z+
|Accel Y+
|-
|-
|Accel Down
|Accel Down
|Accel Z-
|Accel Z-
|Accel Y-
|-
|-
|Accel Left
|Accel Left
|Accel Y+
|Accel Y+
|Accel X-
|-
|-
|Accel Right
|Accel Right
|Accel Y-
|Accel Y-
|Accel X+
|-
|-
|Accel Forward
|Accel Forward
|Accel X+
|Accel X+
|Accel Z-
|-
|-
|Accel Backward
|Accel Backward
|Accel X-
|Accel X-
|Accel Z+
|-
|-
|Pitch Up
|Pitch Up
|Gyro Y-
|Gyro Y-
|Gyro X+
|-
|-
|Pitch Down
|Pitch Down
|Gyro Y+
|Gyro Y+
|Gyro X-
|-
|-
|Roll Left
|Roll Left
|Gyro X-
|Gyro X-
|Gyro Z+
|-
|-
|Roll Right
|Roll Right
|Gyro X+
|Gyro X+
|Gyro Z-
|-
|-
|Yaw Left
|Yaw Left
|Gyro Z+
|Gyro Z+
|Gyro Y+
|-
|-
|Yaw Right
|Yaw Right
|Gyro Z-
|Gyro Z-
|Gyro Y-
|}
|}


As the default buttons are all wrong reset all buttons in the Wii Remote configuration. To configure the motion controls you have to use the advanced config window. Right click on each motion button in the Wii Remote configure window. Select the appropriate IMU device at the top in the device selection.
As the default buttons are all wrong reset all buttons in the Wii Remote configuration. To configure the motion controls you have to use the advanced config window. Right click on each motion button in the Wii Remote configure window. Select the appropriate IMU device at the top in the device selection.
NOTE: Dolphin has been combining the IMU device with the "regular" device for my Switch controllers so there is no need to change the to the IMU device (it also doesn't show up anymore).


[[File:Select_imu_device.png]]
[[File:Select_imu_device.png]]


Select the corresponding Accel or Gyro axis, select it and click ok. For example for "Accel Up" in dolphin you need to select "Accel Z+". The end result should look like below.
Select the corresponding Accel or Gyro axis, select it and click OK. For example for ''Accel Up'' in Dolphin you need to select ''Accel Z+''. The end result should look like below.


[[File:Advanced_config_result.png]]
[[File:Advanced_config_result.png]]


Repeat this for every motion.
Repeat this for every motion.
[[Category:Tutorials]]