OmniPad PS5 🎮🚀

⚖️ Legal Disclaimer & Fair Use Notice

This is an independent open-source research project developed strictly for educational, accessibility, and hardware interoperability purposes (allowing third-party controllers and adaptive peripherals to function on the console).

• No Proprietary Code: This repository contains no proprietary Sony Interactive Entertainment code, no game DRM circumvention, and no cryptographic keys. It builds against the open-source community SDK (ps5-payload-sdk).
• Nominative Fair Use: "PlayStation", "PS5", "DualSense", "DualShock", "Xbox", "Nintendo", and any other product names or trademarks mentioned belong exclusively to their respective holders. They are used purely for descriptive and compatibility identification purposes under nominative fair use.

💬 "Honestly? This whole project started because I was just a guy who wanted his Machenike G5 Pro Max SE controller working on his PS5."

I wanted to play 3-player and 4-player local games on my jailbroken PS5 (running FW 13.60 with kstuff and shadowmountplus). However, existing community tools either lacked 2.4GHz USB dongle hotplug support or broke on FW 13.60's user profile assignment screen (0x803B0006).

OmniPad PS5 is the result of solving that exact problem: building a low-level C subsystem for jailbroken PlayStation 5 consoles that provides dynamic 250Hz USB Hotplug (4ms polling) for 2.4G dongles and wired cables, while safely bypassing the profile assignment block.

This project is an open-source consolidation, enhancement, and evolution built directly upon pioneering research and code shared by talented developers across the PS5 homebrew community. Sincere gratitude and foundational credit belong to:

• 🎮 sinfiltros: Creator of AnyPad-PS5 — laid the groundwork for libScePad virtual DualSense emulation and native Bluetooth HCI/L2CAP research.
• 🔌 StonedModder / a-ddr: Authors of PoorDS4 and Ghostcontrol — provided vital reference implementations for USB HID parsing, controller wake-up handshakes (Switch Pro, DS3), and asynchronous FreeBSD /dev/ugen polling.
• 💉 MegaCadeDev: Author of YetAnotherControllerEnabler — pioneering research into SceShellUI ptrace code cave injection to overcome the 0x803B0006 profile assignment screen.
• 🛠️ ChendoChap, SpecterDev, flatz & ps5-payload-sdk contributors: Authors of the ps5-payload-sdk, kstuff, and kernel debugging tools making native C payloads possible.
• 🚀 LightningMods & etaHEN Team: For their tireless dedication to the PS5 homebrew ecosystem.

graph TD
    subgraph S1["1. Supported Peripherals"]
        USB["2.4GHz Wireless Dongles & USB Cables<br/>(Machenike G5 Pro/SE, 8BitDo, Xbox, Switch Pro, DS4, DS3)"]
    end

    subgraph S2["2. OmniPad PS5 Core (Native C)"]
        HOTPLUG["Dynamic USB Hotplug Driver<br/>(250Hz Polling / 4ms Tick)"]
        NORM["Canonical Input Normalizer<br/>(pad_packet_t & Deadzones)"]
        SLOTS["3-Slot Multi-Device Multiplexer<br/>(Virtual DualSense Pool)"]
        WEB["Web Server & REST API<br/>(Port 8095 - Dark UI)"]
        TCP["Local LAN Testing Socket<br/>(Port 9045 - TCP Stream)"]

        USB --> HOTPLUG
        HOTPLUG --> NORM
        NORM --> SLOTS
        SLOTS <--> WEB
        SLOTS <--> TCP
    end

    subgraph S3["3. ProsperoOS Kernel & ShellUI"]
        KERNEL["libScePad Virtual Device<br/>(Type 3 DualSense)"]
        KLOG["Kernel Log Monitor /dev/klog<br/>(64-bit Device ID Matching)"]
        SHELLUI["SceShellUI Injector<br/>(Code Cave + W^X Safe Interception)"]
        
        SLOTS --> KERNEL
        KERNEL --> KLOG
        SLOTS -.->|On Connect| SHELLUI
    end

    subgraph S4["4. User Gameplay Experience"]
        GAMES["PS5 Games & Emulators<br/>(Native Controller Recognition)"]
        KERNEL --> GAMES
    end

🔬 Developer Hardware Testing Disclosure: OmniPad PS5 is maintained by an independent solo developer. Currently, the developer physically owns and tests on a Machenike G5 Pro Max SE (2.4GHz USB Dongle & USB-C Cable).

Support for Xbox Series X|S, Xbox One, DualShock 4, DualShock 3, and Switch Pro was written based on official USB HID/GIP specifications, reference open-source drivers, and automated test suites. Because physical hardware was not on the developer's test bench during initial release, these decoders are currently considered EXPERIMENTAL. If you own these controllers, your testing reports and feedback are warmly welcomed to help fine-tune and verify them!

⚠️ Important Connection Notice (v1.0.4): OmniPad PS5 v1.0.4 operates exclusively via USB ports (physical USB cables and supported 2.4GHz USB wireless dongles). Direct wireless Bluetooth pairing through the console's internal antenna is currently in active development for v1.1.0 and is NOT active in v1.0.4.

To avoid any confusion or unmet expectations, please note the exact state of Xbox hardware support:

1. Direct Bluetooth Pairing: NOT supported in v1.0.4. Xbox One / Series X|S controllers communicate via Bluetooth Low Energy (BLE) requiring SMP AES-128 cryptographic pairing over the console's internal radio. This stack is actively being finalized for v1.1.0.
2. Official "Xbox Wireless Adapter for Windows" (Microsoft Dongle): NOT supported. The official Microsoft PC dongle uses a proprietary Wi-Fi Direct / GIP protocol that is not recognized by the FreeBSD/ProsperoOS USB driver.
3. How to use Xbox Controllers Today in v1.0.4:
   • Option A (Wired): Connect via a data-capable USB-C (Series X|S) or Micro-USB (Xbox One) cable directly to any PS5 USB port. (Ensure your cable has data lines; charge-only cables will not transmit inputs).
   • Option B (Wireless via Third-Party USB Adapter): Pair your Xbox controller to an 8BitDo Wireless USB Adapter 2 plugged into the PS5. The 8BitDo adapter bridges the wireless signal into standard USB inputs.

• ❌ No Direct Console Bluetooth Yet: You cannot currently put a controller into Bluetooth sync mode and connect directly to the PS5 without a USB cable or USB adapter. (Coming in v1.1.0).
• ❌ No Gyroscope / Motion Controls: IMU sensors (accelerometer/gyro) report neutral values. Games strictly requiring motion controls must use the official DualSense on Player 1.
• ❌ No DualSense Adaptive Triggers / Haptics: Non-DualSense controllers do not have Sony's proprietary force-feedback trigger motors. Standard rumble is handled natively where supported.
• ❌ No Multi-touch Touchpad Surface: The touchpad is mapped as a single digital click (used by games to open maps or menus).
• ℹ️ Player 1 vs Virtual Slots: OmniPad emulates Players 2, 3, and 4 (3 virtual DualSense slots). The primary console user (Player 1) uses the official physical DualSense.

For full technical details and VID:PID tables, see docs/COMPATIBILITY.md.

💡 Pre-compiled Binary: You do not need to compile anything from source. Download the ready-to-run OmniPad-PS5.elf directly from the GitHub Releases tab (v1.0 Beta Test).

Send OmniPad-PS5.elf to your console using your preferred ELF loader or payload sender.

(A system notification will appear on the top right of your screen: OmniPad PS5 v1.0.4 Ativo! Painel: porta 8095)

• 2.4GHz Dongles & USB Cables (Instant Plug & Play in v1.0.4): Plug your USB dongle (e.g. Machenike G5 Pro Max SE, 8BitDo Wireless Adapter) or USB cable (DualShock 4, DualShock 3, Xbox, Switch Pro, etc.) into any front or rear USB port. The 250Hz hotplug driver recognizes it automatically within milliseconds.
• Direct Internal Bluetooth Wireless (In Development — Planned for v1.1.0): Direct wireless pairing via the console's internal Bluetooth antenna (bt_hci_usb) is actively being finalized and will be exposed in the Web UI in the v1.1.0 update. In v1.0.4, please use a USB cable or a wireless USB adapter/dongle (such as 8BitDo or manufacturer 2.4G dongles).

On firmwares like 13.60 (with kstuff-1.13-fpkg-dr-test5 & shadowmountplus v1.7 Beta 4), profile assignment is automated via safe SceShellUI code caves:

1. Press the PS / Home button on your controller (or click "Simulate PS Button" in the Web Dashboard).
2. The official PS5 profile selection menu will appear on screen.
3. Choose the desired user profile for Player 1, 2, 3, or 4.

Open the control center from any smartphone, PC, or console browser on your local network:

http://<PS5_IP>:8095/

• 🎮 Slot Status: Real-time visibility of all 4 player slots (connected gamepads and connection types).
• ⚡ Power Telemetry: Live power status (⚡ USB Cable / 5V for wired controllers and dongles).
• 🔘 Simulate PS Button: Remotely trigger the PS button to change accounts or open the system menu.
• 🔄 Disconnect Slot: Free any individual slot instantly without unplugging hardware.

• docs/COMPATIBILITY.md — Detailed controller compatibility and mappings.
• docs/FIRMWARE_1360_GUIDE.md — FW 13.60 architecture, Relapse exploit, and code cave injection details.
• docs/HOW_IT_WORKS.md — In-depth breakdown of USB hotplug and virtual pad lifecycle.

Licensed under the GNU GPL v3.0.

Fundamental credits to the community pioneers whose work inspired and paved the way:

• sinfiltros: Author of AnyPad-PS5 for the native Bluetooth HCI/L2CAP stack.
• StonedModder / a-ddr: Developers of PoorDS4 and Ghostcontrol for USB HID decoding and handshakes.
• MegaCadeDev: Author of YetAnotherControllerEnabler for SceShellUI injection insights.
• The ps5-payload-sdk, etaHEN, and kstuff research teams.