VitaOxiPad

Turn your PS Vita into a gamepad for your PC!

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

• VitaOxiPad
  • Description
  • Installation
  • Uses and options
    • Saving Configs
    • Using a Static IP
    • Configurations
  • What works
  • Client compilation
    • Windows
  • PS Vita server compilation
  • FAQ
    • Q1: Why Oxi?
    • Q2: Why isn't my PS Vita connecting to the PC?
    • Q3: I'm experiencing input lag. What can I do?
    • Q4: How do I update VitaOxiPad?
  • Thanks

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

• Make and Cmake;
• Flatbuffers (flatc);
• Rust (cargo).

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

• Thanks to all the people who contributed to VitaSDK, Vitadev Package manager and ViGEm Bus Driver;
• Rinnegatamante for the original VitaPad version;
• saidsay-so for the improved Rust VitaPad version;
• santarl for advice and help with accelerometer, gyroscope and also adding DualShock 4 digitizer emulation;
• gl33ntwine for creating the awesome article for those new to development for the PS Vita;
• CasualX for ViGEm client in Rust.