-
Notifications
You must be signed in to change notification settings - Fork 22
Build and install from source
If SteamDeckGyroDSU is already installed and you want to update to the newest version, look into Update section below.
To build the server and install it as a service for the first time switch to desktop mode, open terminal and enter following commands in order:
cd
git clone https://github.com/kmicki/SteamDeckGyroDSU.git
cd SteamDeckGyroDSU
./buildinstall.sh
If you haven't used sudo before, first run passwd to set a password.
After that, restart the system and the DSU server should be active.
To disable the server, use command:
systemctl --user disable sdgyrodsu.service
systemctl --user stop sdgyrodsu.service
To enable it again:
systemctl --user enable --now sdgyrodsu.service
If the repository was deleted from your device in the meantime, clone it again with commands below. Otherwise, skip those commands.
cd
git clone https://github.com/kmicki/SteamDeckGyroDSU.git
Run following commands to update the server:
cd
cd SteamDeckGyroDSU
git checkout master
git pull
./buildupdate.sh
After that, the new version of the server should be running.
The program is for Steam Deck specifically so instructions are for building on Steam Deck.
Steps below (reinstall dependencies+build+grant permissions+install as a service) are included in install.sh script. Follow the steps if you don't want to use the script.
Repository depends on libraries that are already installed in the Steam Deck's system. Unfortunately, even though the libraries are there, the header files are not, so they have to be reinstalled.
Those packages are:
- gcc
- glibc
- linux-api-headers
- ncurses
To do that:
sudo steamos-readonly disable
sudo pacman-key --init
sudo pacman-key --populate
sudo pacman -S --noconfirm gcc
sudo pacman -S --noconfirm glibc
sudo pacman -S --noconfirm linux-api-headers
sudo pacman -S --noconfirm ncurses
sudo steamos-readonly enable
As you see above, this requires disabling read only filesystem. It is necessary only to reinstall those packages. Building/installing/running a server is possible with read-only filesystem enabled.
Build using following commands in a project's directory:
mkdir -p bin
g++ -std=c++2a $(find inc -type d -printf '-I %p\n') -g $(find src -type f -iregex '.*\.cpp' -printf '%p\n') -pthread -lncurses -o bin/sdgyrodsu
If the server was installed using install.sh script, it should be running as a service after system restart. Otherwise, see below.
When program is running, the DSU (cemuhook protocol) server providing motion data is available at Deck's IP address and UDP port 26760.
Use following commands to create a new user group and add current user to the group and then grant that group permission to read from hiddev file of Steam Deck controls (run those in a repository's main directory):
sudo groupadd usbaccess
sudo gpasswd -a $USER usbaccess
sudo cp pkg/51-deck-controls.rules /etc/udev/rules.d/
Then restart the system.
If you want to run server automatically when Steam Deck is ON, install it as a service.
First prepare permissions as described in a previous section (service will be non-root).
Then run those commands from repository directory:
mkdir -p $HOME/sdgyrodsu
cp bin/sdgyrodsu $HOME/sdgyrodsu/
cp pkg/sdgyrodsu.service $HOME/.config/systemd/user/
systemctl --user enable --now sdgyrodsu.service
You can use the server without installing a user service. Granting permissions is still necessary. Without granting permissions it will work only when run as root.
./bin/sdgyrodsu