Skip to content

Latest commit

 

History

History
241 lines (171 loc) · 11.1 KB

README.md

File metadata and controls

241 lines (171 loc) · 11.1 KB
Raw

VitaOxiPad

Turn your PS Vita into a gamepad for your PC!

Based on VitaPad by Rinnegatamante and Rust-based VitaPad by saidsay-so.

demo

Description

VitaOxiPad is a client-server application that turns your PS Vita into (almost) a DualShock 4. The PS Vita acts as a server to which the PC client will be connected within the local network (WiFi).

The gamepad chosen for emulation was a DualShock 4 v1 (vendor: 0x054C, product: 0x05C4) connected via USB. This allows to support a large number of Windows games without any fixes.

Installation

To set up VitaOxiPad, follow these steps:

  1. Install the Server on PS Vita:

    • Ensure your PS Vita is set up for homebrew applications.
    • Download the VitaOxiPad.vpk file.
    • Use VitaShell or another package manager to install the .vpk on your PS Vita.

  2. Install the Client on Windows PC:

    • Download the latest VitaOxiPad-x64.exe or VitaOxiPad-x32.exe from the releases page.
    • Install ViGEmBus on your PC.
    • Run the VitaOxiPad-x64.exe or VitaOxiPad-x32.exe and enter your PS Vita's IP address.

Uses and options

$ VitaOxiPad-x64.exe --help
Usage: VitaOxiPad-x64.exe <ip> [-p <port>] [-c <config>] [--polling-interval <polling-interval>] [-d]

Create a virtual controller and fetch its data from a Vita over the network.

Positional Arguments:
  ip                IP address of the Vita to connect to

Options:
  -p, --port        port to connect to (default: 5000)
  -c, --config      buttons and touchpads config (default: standart)
  --polling-interval
                    polling interval in microseconds (minimum = 6000)
  -d, --debug       enable debug mode
  -v, --version     show version information
  -s, --sample-config
                    print sample config file
  --help            display usage information

Saving Configs

VitaOxiPad searches for the config file in the following locations:

  • Current Executable Directory: config.toml
  • User's Home Directory: ~/vitaoxipad.toml or ~/.config/vitaoxipad.toml
  • Windows Path: C:\Users\%username%\vitaoxipad\vitaoxipad.toml

If no config file is found, default settings will be used.

With the --sample-config feature, you can generate a sample configuration file for VitaOxiPad. This output can be redirected to a vitaoxipad.toml file, allowing you to save your configuration options and avoid the need to specify flags each time you run the application.

To create a config file, run the following command:

VitaOxiPad-x64.exe --sample-config > vitaoxipad.toml

This will create a vitaoxipad.toml file in the current directory with sample configuration options.

Using a Static IP

If your router allows it, A static IP can be assigned to the PS Vita in the Wi-Fi router settings, allowing this IP address to be saved in the vitaoxipad.toml configuration file. This setup enables VitaOxiPad to run without the need to specify the IP address as a flag each time.

To set this up, the vitaoxipad.toml file should be edited to include the static IP address in the ip_address field:

ip = "PSVITA_STATIC_IP_ADDRESS"

Now, you can launch VitaOxiPad without any flags, and it will automatically use the IP address specified in the configuration file.

Configurations

There are currently 4 DualShock 4 configurations emulations that can be selected at client startup:

Configurations name PS Vita L1\R1 PS Vita front digitizer PS Vita rear digitizer
standart L1\R1 L3\R3 L2\R2
alt_triggers L2\R2 L3\R3 L1\R1
rear_touchpad L1\R1 upper area - L2\R2, lower area - L3\R3 DualShock 4 digitizer
front_touchpad L1\R1 DualShock 4 digitizer upper area - L2\R2, lower area - L3\R3

To better understand the emulation behavior, you can run 3D Controller Overlay after connecting your PS Vita.

What works

Feature Support Details
Buttons ✅ -
Sticks ✅ -
L1 and R1 ✅ Press only, as the PS Vita does not have analog triggers. This emulates a full press
L2/R2 and L3/R3 emulation ✅ Can be used of the back or front PS Vita digitizer for it
Select and Start ✅ -
Accelerometer and gyroscope ✅ A little less accurate than the DualShock 4, but still usable
DualShock 4 digitizer emulation ✅ Emulates up to two-finger simultaneous input, same as DualShock 4
DualShock 4 digitizer button ✅ Works as a quick tap on the digitizer. Supports front and rear digitizer
Battery ✅ PS Vita's battery status is sent to the emulated DualShock 4
Any configuration ✅ You can choose from ready-made configurations
DS4Windows support ✅ You need to enable Virtual Controller Support[*]
Sound ❌ Probably will never be realized

[*] - Virtual Controller Support can be found in the schmaldeo DS4Windows fork. This option can be found in Settings -> Device Options -> Virtual Controller Support.

Client compilation

Windows

To compile on Windows you will need

You can use MSYS2, which provides this in a convenient way.

Dependencies you will need for MSYS2 MINGW64:

pacman -S mingw-w64-x86_64-rust mingw-w64-x86_64-flatbuffers make git wget cmake

Clone the repository and log into it:

git clone --recurse-submodules https://github.com/DvaMishkiLapa/VitaOxiPad.git
cd ./VitaOxiPad

Build the client side:

cd ./client
cargo build --release --bin cli

You can check the finished binary by running in it:

 ./target/release/cli.exe your_PS_Vita_IP

PS Vita server compilation

  1. Make sure that you have cmake installed;
  2. Make sure you have VitaSDK installed and configured (try vdpm);

Sometimes, for whatever reason, flatbuffers are not installed in the VitaSDK (fatal error: flatbuffers/flatbuffers.h: No such file or directory).

You can install it manually via vdpm. Do this after installing the VitaSDK via vdpm:

./vdpm flatbuffers
  1. Install flatc v24.3.25 for your system. For Linux:
git clone --branch v24.3.25 https://github.com/google/flatbuffers.git && cd flatbuffers
cmake -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=Release
make -j
./flattests # this is quick, and should print "ALL TESTS PASSED"
sudo make install
sudo ldconfig
flatc --version # "flatc version 24.3.25"
  1. Build the project with the following commands:
cmake -S server -B build
cmake --build build

Then, install the generated VitaOxiPad.vpk file on your PS Vita.

FAQ

Q1: Why Oxi?

A: Now there are many projects with the name VitaPad. It's very confusing. In this implementation, the client application was written using Rust. Oxi - oxidation, the process that causes rusting.

Q2: Why isn't my PS Vita connecting to the PC?

A: Ensure both devices are on the same WiFi network and that the IP address entered in the client is correct.

Q3: I'm experiencing input lag. What can I do?

A: Input lag might be due to a poor WiFi connection. Try moving closer to the router or reducing network congestion.

Q4: How do I update VitaOxiPad?

A: Check the releases page for the latest version and follow the installation instructions provided. Or you can use VitaDB-Downloader on your PS Vita.

Thanks