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

139 lines
4.5 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:14:05 +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:
2024-01-21 07:47:12 +00:00
If you already have `SteamDeckGyroDSU` installed you can skip Step 2 or we do recommend running the `update.sh` from `home/deck/sdgyrodsu` to make sure you have the latest version of `SteamDeckGyroDSU`.
### Step 0: Edit the RetroDECK Layout
This step will be removed in the 0.8b update as the new profile version will have it enabled by default.
Launch RetroDECK.
2024-01-21 08:22:26 +00:00
- Press the `Steam` button - `Controller Settings` - Make sure that the RetroDECK Layout is selected.
2024-01-21 08:22:36 +00:00
- Press `Edit Layout` - You will be on the `Action Set` - `RetroDECK - Set`.
2024-01-21 07:47:12 +00:00
- Go down to `Gyro` - Change it from `As Joystick` to `Directional Pad`.
- You don't need to put in any values of the menus bellow, just go back with `B` button to RetroDECK.
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-22 05:22:58 +00:00
### Step 2: Set RetroDECK Resolution
Go to back to game mode `Game Mode`
Go to RetroDECK.
But before you launch RetroDECK click on the `⚙️` icon - `Properties` - `Shortcut` - `Game Resolution`
Set the Resolution from `Default` to `1920x1080`
Also turn on `Set resolution for internal and external display` (this might be hidden sometimes just go back one menu and go in again to make it show up).
### Step 3:
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:47:12 +00:00
**In Yuzu:**
2024-01-20 21:21:47 +00:00
2024-01-21 07:47:12 +00:00
<img src="../../../wiki_images/emulators/yuzu/yuzu-controls.png" width="600">
2024-01-21 06:51:53 +00:00
2024-01-21 07:47:12 +00:00
Go to: `Emulation` - `Configure` - `Controls`
2024-01-21 06:51:53 +00:00
2024-01-22 05:22:58 +00:00
### Step 4: Configure Controls
2024-01-21 07:47:12 +00:00
Press the `Input Device` dropdown menu select `Steam Virtual Gamepad 0`.
2024-01-21 06:51:53 +00:00
2024-01-21 07:47:12 +00:00
Make sure that the `Motion` is checked in the bottom left and click the `Configure` underneath the `Motion` checkbox.
2024-01-21 06:51:53 +00:00
2024-01-22 05:22:58 +00:00
### Step 5: Test and Configure Motion
2024-01-21 06:51:53 +00:00
2024-01-21 07:47:12 +00:00
<img src="../../../wiki_images/emulators/yuzu/yuzu-motion-configure.png" width="600">
2024-01-21 06:51:53 +00:00
2024-01-21 07:47:12 +00:00
Make sure that the localhost IP-adress and port exists to the left side of the menu.
2024-01-21 06:51:53 +00:00
2024-01-21 07:47:12 +00:00
If it does not exist you will need to manually add it:
2024-01-21 06:51:53 +00:00
2024-01-21 07:47:12 +00:00
- Server: `127.0.0.1`
- Port: `26760`
- Press `Add Server`
2024-01-21 06:51:53 +00:00
2024-01-21 07:47:12 +00:00
Press the `Test` button to make sure you are getting data from `SteamDeckGyroDSU`.
2024-01-21 06:51:53 +00:00
2024-01-21 07:47:12 +00:00
If all has gone well you will get a message saying:
2024-01-21 07:08:53 +00:00
2024-01-21 07:47:12 +00:00
`Successfully received data from the server.`
2024-01-21 07:08:53 +00:00
2024-01-22 05:22:58 +00:00
### Step 6: Go back to Controls and press the motion button
2024-01-21 07:08:53 +00:00
2024-01-21 08:05:23 +00:00
<img src="../../../wiki_images/emulators/yuzu/yuzu-hidden-motion.png" width="600">
Go back to `Controls`
Now you need to press the `Motion` button and `Shake the Steam Deck` to bind the motion.
2024-01-22 05:22:58 +00:00
<img src="../../../wiki_images/emulators/yuzu/yuzu-gyro-box.png" width="600">
2024-01-21 08:05:23 +00:00
2024-01-22 05:22:58 +00:00
If all is working correctly the tiny box in the middle of the controller should move with your built in Gyro.
2024-01-21 08:05:23 +00:00
2024-01-22 05:22:58 +00:00
### Step 6: Quit RetroDECK
2024-01-21 08:05:23 +00:00
2024-01-22 05:22:58 +00:00
Press `OK` - Press the `Quit Emulator Hotkey` (Select + Start) or go to `File` - `Quit Yuzu`
2024-01-21 08:05:23 +00:00
2024-01-22 05:22:58 +00:00
Quit the `RetroDECK Configurator` and Quit RetorDECK.
2024-01-21 07:47:12 +00:00
2024-01-22 05:22:58 +00:00
### Step 7: Revert the Resolution to Default
2024-01-21 07:47:12 +00:00
2024-01-22 05:22:58 +00:00
Revert the changed you made to resolution in Step 2:
2024-01-21 07:47:12 +00:00
2024-01-22 05:22:58 +00:00
Click on the `⚙️` icon - `Properties` - `Shortcut` - `Game Resolution`
2024-01-21 07:08:53 +00:00
2024-01-22 05:22:58 +00:00
Set the Resolution from`1920x1080` to `Default`
2024-01-21 07:08:53 +00:00
2024-01-22 05:22:58 +00:00
Also turn off `Set resolution for internal and external display`
2024-01-20 21:21:47 +00:00
2024-01-22 05:22:58 +00:00
### Step 8: Launch RetroDECK
2024-01-20 21:21:47 +00:00
2024-01-22 05:22:58 +00:00
You can now launch RetroDECK and play Yuzu with motion.
2024-01-21 08:21:02 +00:00
2024-01-21 08:18:05 +00:00
## Linux Desktop or Steam Deck Docked with External Gyro Enabled Controllers
**Prerequisites:**
- A gyro enabled external controller.
2024-01-20 21:21:47 +00:00
2024-01-21 08:18:05 +00:00
### Step 1:
2024-01-20 21:21:47 +00:00
2024-01-21 08:18:05 +00:00
WIP