Wiki/wiki-rtd/docs/wiki_emulator_guides/yuzu/yuzu-gyro.md

87 lines
4.3 KiB
Markdown
Raw Normal View History

2024-01-21 07:08:53 +00:00
# How to enable Gyro working Gyro in Yuzu
2024-01-20 21:14:14 +00:00
2024-01-21 07:08:53 +00:00
## Steam Deck with Gyro
2024-01-20 21:14:14 +00:00
2024-01-21 07:08:53 +00:00
This is a step by step guide on how to get working Gyro with Yuzu utilizing the Steam Deck's built in gyro.<br>
We are looking into building this feature into RetroDECK in the future.
2024-01-20 21:14:14 +00:00
2024-01-21 07:09:08 +00:00
#### Prerequisites: RetroDECK Steam Deck Controller Layout
2024-01-20 21:14:14 +00:00
2024-01-21 07:08:53 +00:00
Make you have `The Official RetroDECK Steam Deck Controller Layout` installed and enabled.
2024-01-20 21:14:14 +00:00
2024-01-21 07:08:53 +00:00
If you don't have it read up on `Step 3` from the getting started guide.
2024-01-20 21:14:14 +00:00
2024-01-21 07:08:53 +00:00
[Steam Deck -RetroDECK Installation](../../wiki_devices/steamdeck/steamdeck-start.md).
2024-01-20 21:14:14 +00:00
2024-01-21 07:13:45 +00:00
#### I already have SteamDeckGyroDSU installed:
If you already have `SteamDeckGyroDSU` installed you can skip Step 1 or we do recommend running the `update.sh` from `home/deck/sdgyrodsu` to make sure you have the latest version of `SteamDeckGyroDSU`.
2024-01-20 21:14:14 +00:00
2024-01-21 07:13:45 +00:00
### Step 1: Install SteamDeckGyroDSU
2024-01-20 21:14:14 +00:00
2024-01-21 07:08:53 +00:00
[SteamDeckGyroDSU](https://github.com/kmicki/SteamDeckGyroDSU)
2024-01-20 21:14:14 +00:00
2024-01-21 07:08:53 +00:00
Go to `Desktop Mode` and open the built in terminal `Konsole` from the KDE Menu (Start Menu).
2024-01-20 21:14:14 +00:00
2024-01-21 07:08:53 +00:00
Copy the following command into the terminal and hit enter:
2024-01-20 21:14:14 +00:00
2024-01-21 07:08:53 +00:00
`bash <(curl -sL https://raw.githubusercontent.com/kmicki/SteamDeckGyroDSU/master/pkg/update.sh)`
2024-01-20 21:14:14 +00:00
2024-01-21 07:08:53 +00:00
This will Install SteamDeckGyroDSU and also create a new folder under `HOME` `$HOME/sdgyrodsu/` aka `home/deck/sdgyrodsu`
2024-01-20 21:14:14 +00:00
2024-01-21 07:08:53 +00:00
In that folder you will find two other files that is good to know about:
2024-01-20 21:14:14 +00:00
2024-01-21 07:08:53 +00:00
- `update.sh` - For updating SteamDeckGyroDSU
2024-01-20 21:14:14 +00:00
2024-01-21 07:08:53 +00:00
- `uninstall.sh` - For uninstalling SteamDeckGyroDSU
2024-01-20 21:14:14 +00:00
2024-01-21 07:13:45 +00:00
### Step 2: Open Yuzu in Game Mode
2024-01-20 21:14:14 +00:00
2024-01-21 07:13:45 +00:00
Go to `Game Mode` and launch RetroDECK.
2024-01-20 21:14:14 +00:00
2024-01-21 07:13:45 +00:00
Open the `RetroDECK Configurator` and launch Yuzu from: `Main Menu` - `RetroDECK Configurator` - `Open Emulator` - `Yuzu`
2024-01-20 21:21:47 +00:00
2024-01-21 07:08:53 +00:00
## Linux Desktop or Steam Deck Docked with External Gyro Enabled Controllers
2024-01-20 21:21:47 +00:00
2024-01-21 07:08:53 +00:00
**Prerequisites:**
2024-01-21 06:51:53 +00:00
2024-01-21 07:08:53 +00:00
- A gyro enabled external controller.
2024-01-21 06:51:53 +00:00
2024-01-21 07:08:53 +00:00
Check these sources:
2024-01-21 06:51:53 +00:00
2024-01-21 07:08:53 +00:00
https://youtu.be/q-ehLPk9HXI?si=banG3-fO0hxjAofs
2024-01-21 06:51:53 +00:00
2024-01-21 07:08:53 +00:00
https://www.reddit.com/r/SteamDeck/s/kUp6w0fIJA
2024-01-21 06:51:53 +00:00
2024-01-21 07:08:53 +00:00
https://github.com/kmicki/SteamDeckGyroDSU.
2024-01-21 06:51:53 +00:00
2024-01-21 07:08:53 +00:00
In Desktop mode, install SteamDeckGyroDSU either through EmuDeck (Gyroscope -> More Info in menu) or manually https://github.com/kmicki/SteamDeckGyroDSU. Restart the SteamDeck after installation regardless of which method you used.
In Gaming mode (will not work in desktop), open a game in Yuzu and open the Menu (F11 with a keyboard or bind a back button to F11)
From the menu bar select Emulation -> Configure..., then select Controls from the left side bar
In the top left select Handheld from the Connect Controller dropdown menu (others report that Pro Controller works too)
From the Input Device dropdown menu just to the right, select Steam Virtual Gamepad 0 (for some reason this defaulted to Keyboard Only for me)
At the bottom to the left of the controller selector, ensure Motion is checked and click the Configure button underneath
If not already there, add a server on 127.0.0.1:26760 and click Test to ensure the gyro DSU server is working correctly, then click OK
Open the Steam overlay, navigate to controller settings, click Edit Layout and set Gyro Behavior to As Directional Pad
2024-01-20 21:21:47 +00:00
2024-01-21 07:08:53 +00:00
Back on the Yuzu Controls configuration page, you need to click a button that is hidden offscreen. There are two options for how to click it.
2024-01-20 21:21:47 +00:00
2024-01-21 07:08:53 +00:00
You should still have focus on the Configure button under Motion (highlighted blue), hit tab (on a keyboard or bind tab to a back button) repeatedly to move focus to the next element. Continue to do this until there is focus on the slider bar under the ZR mapping. Click tab one more time to put focus onto the offscreen button that configures the motion mapping. Click enter (on a keyboard or bind enter to a back button).
2024-01-20 21:21:47 +00:00
2024-01-21 07:08:53 +00:00
Another user found they were able to see the hidden button by setting the game resolution to 1920x1200 for both the internal and external screen, clicking the button, then setting the resolution back after the motion mapping is set. I didn't try this method so I don't know if that was done through the game settings or Yuzu settings, but worth giving it a shot if you know where to change the resolution and/or don't want to have to click tab a bunch.
2024-01-20 21:21:47 +00:00
2024-01-21 07:08:53 +00:00
Once you've clicked the button (via either method) pick up the Steam Deck and give it a little shake. If everything worked correctly, you should see a wire frame box moving above the image of the Switch/Pro Controller.
2024-01-20 21:21:47 +00:00
2024-01-21 07:08:53 +00:00
Enjoy your motion controls!