OneFamily v1.2.2-beta4

Overview

OneFamily v1.2.2-beta4 delivers key compatibility and stability updates, including improved support for PowerA and third-party Xbox One wired controllers, dedicated Logitech RumblePad 2 and DirectInput gamepad parsing, automated GoldHEN payloads.ini path canonicalization, and multi-user login fixes.

---

Key Changes and Improvements

Xbox & Third-Party Controllers (Issue #23)

• PowerA Force Feedback Initialization: Added GIP wake-up handshake sequence for PowerA Xbox One wired controllers to ensure reliable motor initialization.
• Rumble Normalization & Outbound Circuit Breaker: Normalized Xbox One rumble scaling to prevent protocol buffer overruns and added an automatic pipe stall circuit breaker to protect the USB transfer loop.
• Multi-User & Virtual Pad Cleanup: Restricted physical DualShock 4 disconnects to Merge mode and resolved an uninitialized login counter issue, preventing invalid device disconnect calls during profile switching.

Generic HID & DirectInput Controllers (Issue #41, #22)

• Logitech RumblePad 2 Support: Added dedicated HID report layout handling for Logitech RumblePad 2 (VID 0x046d, PID 0xc218) in DirectInput mode, accurately mapping axes, D-Pad hat switch states, and all 10 face/shoulder buttons.
• Multi-Mode Gamepad Fallback: Improved endpoint detection when handling controllers that switch between XInput, DirectInput, and Switch modes.

Companion App & GoldHEN Auto-Boot (Issue #36, #35)

• Canonical Payloads Path: Standardized payloads.ini registration to /data/payloads/onefamily.bin = 1 and added automatic migration from legacy /user/data/payloads/ entries to eliminate duplicate launches.
• AutoRun Configuration Guide: Updated the in-app setup guide to instruct users to verify that GoldHEN Settings > PayLoader > Enable AutoRun is active on recent firmware versions (e.g., 11.02 / 12.50).

---

Included Files

• onefamily_companion.pkg: Companion App installer package for PS4 (includes embedded daemon payload).
• onefamily.bin: Standalone daemon binary payload for manual injection or staging.

---

Installation

1. Delete any existing /user/data/onefamily/onefamily.log before upgrading.
2. Install onefamily_companion.pkg via GoldHEN Package Installer.
3. Launch OneFamily Companion from the home menu and press X to complete setup.
4. Restart your PS4 and re-enable GoldHEN.

OneFamily v1.2.2-beta3

Overview

OneFamily v1.2.2-beta3 brings critical stability fixes across multiple controller families, adds a dedicated DualSense hardware configuration tab in the Companion App, and eliminates input anomalies on Xbox 360 wireless adapters and Nintendo Switch gamepads.

---

Key Changes and Improvements

Daemon & Input Drivers

• Xbox 360 Wireless Receiver (Issue #32): Fixed an issue where non-input RF announcements and status packets from wireless dongles fell through to the wired input parser, causing phantom button presses and stick drift.
• Switch & Switch Pro Analog Sticks: Corrected analog stick Y-axis inversion across all Nintendo Switch USB controllers, aligning vertical movement with native DualShock 4 controls.
• DualSense Bluetooth Protocol Realignment: Realigned byte offsets in the 0x31 Bluetooth output report to match Sony specifications. Adaptive Triggers, hardware LED Brightness levels, and Player Indicator LEDs now function correctly.
• USB Polling Pacing: Reduced USB interrupt transfer timeout from 4ms to 2ms, preventing loop delays and maintaining steady 250 Hz input responsiveness.
• Bus Topology Change Detection: Replaced repetitive bus scan logging with snapshot-based diff detection, eliminating log storms when no devices are plugged in.
• Rumble Safety: Blocked outbound rumble transfers to Switch input-only gamepads lacking vibration actuators or OUT endpoints.
• Xbox 360 Pipe Stall Recovery: Prevented transient transfer timeouts from prematurely disabling force feedback on wired gamepads.

Companion App

• DualSense Settings Tab: Added a dedicated configuration page to customize Adaptive Trigger profiles (Off, Hair Trigger, Continuous Resistance, Vibration), RGB Lightbar modes (Game Sync, Static Colors, Battery Level, Off), hardware LED Brightness dimmer, and Mute button remapping (Touchpad click toggle).
• Instant Configuration Sync: Settings changed in the Companion App are immediately written to the configuration file and applied by the daemon without requiring a reboot.

---

Included Files

• onefamily_companion.pkg: Companion App installer package for PS4 (includes embedded daemon payload).
• onefamily.bin: Standalone daemon binary payload for manual injection or staging.

---

Installation

1. Install onefamily_companion.pkg via Package Installer on your console.
2. Launch OneFamily Companion from the home menu to initialize or update the background daemon.
3. Restart PS4 and enable GoldHEN

OneFamily v1.2.2-beta2

Changes in v1.2.2-beta2

• Continuous 250 Hz active input streaming with DualShock 4 packet counter for rhythm and high-precision games.
• Low-latency rumble engine with 2ms transfer timeout and non-blocking rate-limiting to prevent input delay.
• Full DualSense Bluetooth features: 6-axis motion sensors (gyroscope and accelerometer), native touchpad tracking, RGB lightbar synchronization, and battery reporting.
• Universal touchpad emulation shortcuts (Share + Options / Share + D-Pad Up for Touchpad Click; Share + D-Pad Down for PS Button) with combo de-ghosting.
• Wireless 2.4 GHz dongle optimization (reduced polling timeout to 4ms and non-destructive endpoint recovery).
• Elimination of user picker cancel teardown: Circle/B no longer triggers controller disconnects or lockouts.
• DirectInput face button mapping alignment and stale packet length filtering on hardware mode switches.
• PlayStation 4 firmware 5.05 - 7.55 kernel panic protection guarding Ring 0 allowlist memory scanning.
• Automatic fallback resolution for /user/data/onefamily directory structure.

OneFamily v1.2.1

We are excited to release OneFamily v1.2.1! This update officially introduces field-verified native Bluetooth support for PlayStation 4 Firmware 13.52, alongside an all-new universal VID-First AOB kernel scanner with Greedy Nearest-Pairing designed to automatically detect and patch the /dev/bt controller allowlist across any other GoldHEN firmware versions (5.05 - 11.00+).

---

Key Improvements & Highlights

1. Pre-Verified Zero-Delay Static Table for FW 13.52

• Native 0 ms Instant Activation: Extracted and integrated the exact 12 allowlist offsets (static_1352[12]) for PS4 Firmware 13.52.
• Fast Integrity Verification: Performs an ultra-fast 1-cycle CPU layout check before patching Ring 0 memory, eliminating any scan overhead or delays at boot.
• register_dualsense = 0 Certified: Natively validated with the Orbis OS /dev/bt kernel subsystem, enabling immediate, seamless pairing of Sony DualSense & DualSense Edge controllers.

2. Universal VID-First AOB Dynamic Scanner (Success Rate > 90%)

• VID-First Clustering: Scans safe kernel memory ([0x4E0000, 0x660000)) directly for rare Thrustmaster Vendor ID comparisons (0x044F), completely bypassing generic x86-64 stack frame anchors and eliminating false positives.
• Strict Opcode Verification (aob_is_cmp_imm): Accurately differentiates CMP instructions from regular memory allocations (PAGE_SIZE), preventing false triggers.
• Greedy Nearest-Pairing Engine: Automatically pairs each discovered Vendor ID with its companion Product ID located within the same function block, resolving previous registration errors and ensuring both values are correctly patched simultaneously.
• Discovered Offsets Logging: Automatically logs discovered hex offsets to /data/onefamily/onefamily.log on newly encountered firmware versions.

3. Dual-Firmware Pre-Verified Architecture & Dynamic Fallback

• FW 12.50: 10 pre-verified offsets (0 ms boot).
• FW 13.52: 12 pre-verified offsets (0 ms boot).
• All other firmwares (5.05 - 11.00+): Universal dynamic VID-First AOB scanner automatically engages on boot.

---

Installation & Update

1. Download and install onefamily_companion.pkg using GoldHEN Package Installer.
2. Launch OneFamily Companion from your home screen once to apply and verify the payload installation.
3. Restart your PS4 console to launch the new OneFamily background daemon via GoldHEN autoboot.

OneFamily v1.2.0

We are thrilled to present the official OneFamily v1.2.0 release! This landmark update brings native Sony DualSense (PS5) & DualSense Edge wireless Bluetooth support for fw 12.50 only (I'm working hard to support all FWs avalaible, give me time), a dual-slot Virtual Pad architecture with native system multi-user / co-op account selection, an authentic 60 FPS procedural PS4 XMB dynamic wave background, a 3-tier universal rumble system for generic HID gamepads, and major stability fixes across Orbis OS kernels (FW 5.05 - 13.52+).

---

Key Improvements & Highlights

1. Native PS5 DualSense & DualSense Edge Bluetooth Wireless Support for FW 12.50

• Ring 0 Kernel Allowlist Patch: Native integration of the Orbis OS kernel allowlist patch, allowing PlayStation 5 DualSense and DualSense Edge controllers to pair wirelessly over Bluetooth without disabling standard DualShock 4 pads.
• Hybrid Multi-Firmware Compatibility:
  • Verified Static Table (FW 12.50): Zero-overhead allowlist execution protected by 64-bit magic header validation (0x56415741E5894855UL) and synchronized bthid_lock / bthid_unlock mutexes.
  • Safe Ring 0 AOB Dynamic Scanner: Dynamic signature scanner for other firmwares (9.00, 11.00, 13.00, 13.52+) verifying target opcode patterns within tight safety bounds.
  • Zero-Panic Safety Guarantee: Memory write protection (CR0 WP) is strictly preserved unless all integrity checkpoints pass.
• 64-bit Syscall Architecture (daemon_sys_call6): Dedicated inline assembly register constraints guaranteeing clean 64-bit pointers and resolving sys_kevent -EFAULT (-14).
• 250 Hz Low-Latency Reporting: Extended 78-byte Bluetooth report parser with CRC32 verification and 10-byte simple report fallback.

2. Dual-Slot Virtual Pad & Native Multi-User / Co-op Support

• Dual-Slot Architecture: Simultaneous connection support for two controllers (e.g., DualSense via Bluetooth + Xbox pad over USB, or physical DS4 + Virtual DS4).
• Native User Selection (sceUserServiceRequestSelectUser): Automatically prompts the official PS4 account picker when a new controller connects, assigning independent user profiles.
• Seamless Handover & Clean Teardown: Automatically powers off physical DS4s assigned to the same user slot to prevent input collision, and handles modal cancellations gracefully.

3. 3-Tier Universal Rumble System for Generic Controllers

• Comprehensive Rumble Support:
  • Tier 1 (Auto-Detect): Automatically identifies standard HID rumble signatures.
  • Tier 2 (INI Presets): Built-in presets for Logitech, ShanWan, DragonRise, GreenAsia, Betop, 8BitDo, and more.
  • Tier 3 (Raw Hex Directives): Full custom packet support (rumble_report = 05 L R 00 00) for boutique gamepads.
• Non-Destructive Profile Upgrader: Updates existing user controller profiles with the [Rumble] section during PKG installation while preserving all custom button remappings.
• Heartbeat Rumble Polling: Reads motor offsets [3..4] from scePadVirtualDeviceGetRemoteSetting with a 100 ms keep-alive heartbeat.

4. Procedural PS4 XMB Dynamic Wave Background & PlayStation Blue Theme

• XMB / Flow Wave Animation: Smooth multi-layered sinusoidal wave curves rendered procedurally with floating dust particles reminiscent of the native PS4 OS system theme.
• Zero-Stall RAM Compositing (Solid 60 FPS): Rendered to a high-speed L1/L2 RAM cache compositing buffer before flushing to framebuffers, eliminating uncached VRAM reads.
• PlayStation Blue Color Palette: All navigation icons, badges, borders, and UI accents restyled with authentic PlayStation Blue tones (#0070D1, #00A2FF).

---

Special Thanks & Acknowledgements

Special thanks to Diram1x for his foundational research and implementation of the DualSense Bluetooth kernel allowlist and input handling on Orbis OS.

---

Installation & Update

1. Download and install onefamily_companion.pkg using GoldHEN Package Installer.
2. Launch OneFamily Companion from your home screen once to apply and verify the payload installation.
3. Restart your PS4 console to launch the new OneFamily background daemon via GoldHEN autoboot.

OneFamily v1.1.6 - HOTFIX

What's New in v1.1.6 - HOTFIX

1. Generic USB HID Controller Support

• Integrated dynamic USB HID Report Descriptor parsing engine.
• Supports a wide variety of DirectInput / Generic HID gamepads, retro pads, fightsticks, and adapters.
• Custom profile remapping via clean UI in the Companion App and standardized .ini files in /data/onefamily/controllers/ (e.g. 2DC8_310B.ini, default.ini).

2. DualSense (PS5) Controller Temporarily Inhibited

• Due to ongoing stability and report descriptor timing issues on the PS4 Orbis USB stack, DualSense support is currently inhibited.
• When a DualSense controller is connected, the system immediately displays an on-screen notification:

  "OneFamily: DualSense support is in development"

• The controller will not instantiate a virtual pad and will not execute unstable input routines.

3. OTA Updates

• When a new stable release is out you'll be prompted to update the .pkg file. It will be downloaded in the /data/pkg/ directory.

---

Supported Controllers

1. Microsoft Xbox Family:

   • Xbox 360 Wired & Wireless (via official & 3rd-party PC 2.4G USB receivers)
   • Xbox One Original, One S, One X (Wired)
   • Xbox Series X|S Wireless Controller (Wired)
   • Xbox One Elite Series 1 & Series 2 (Wired)
   • Compatible 3rd-party XInput / GIP gamepads (PowerA, Razer, PDP, etc.)

2. Nintendo Switch Family:

   • Nintendo Switch Pro Controller (Official, with HD Rumble)
   • Joy-Con (L) & Joy-Con (R) via official Charging Grip
   • Nintendo Switch Online Classic Controllers (NES, SNES, N64, Genesis)
   • 3rd-party Switch wired controllers (PDP Faceoff, PowerA Wired, Horipad)

3. Sony PlayStation Family:

   • Sony PlayStation 3 (DualShock 3 / Sixaxis official, with initialization handshake)
   • (DualSense PS5 is temporarily disabled)

4. Google Stadia:

   • Google Stadia Controller (Wired)

5. Generic HID / DirectInput Controllers:

   • 8BitDo Ultimate 2 Wireless, Ultimate 2.4G, Ultimate 2C, SN30 Pro
   • GameSir G7, G3s, G4s, T1s, T2a
   • LanShen X1Pro, Xiaomi Mi Controller, Bionik Vulkan, Betop 2585N2
   • Any standard USB HID controller via /data/onefamily/controllers/default.ini or custom VID_PID profiles

---

Installation & Updating

1. Install onefamily_companion.pkg on your PS4 via GoldHEN Package Installer.
2. Launch the OneFamily Companion application.
3. The app will automatically detect your setup, install/update the payload, configure GoldHEN autoboot, and deploy default controller profiles.
4. Plug in any supported controller and enjoy system-wide control and in-game gameplay!

OneFamily v1.1.5

What's New in v1.1.5

1. DualSense (PS5) Controller Temporarily Inhibited

• Due to ongoing stability and report descriptor timing issues on the PS4 Orbis USB stack, DualSense support is currently inhibited.
• When a DualSense controller is connected, the system immediately displays an on-screen notification:

  "OneFamily: DualSense support is in development"

• The controller will not instantiate a virtual pad and will not execute unstable input routines.

2. OTA Updates

• When a new stable release is out you'll be prompted to update the .pkg file. It will be downloaded in the /data/pkg/ directory.

---

Supported Controllers

1. Microsoft Xbox Family:

   • Xbox 360 Wired & Wireless (via official & 3rd-party PC 2.4G USB receivers)
   • Xbox One Original, One S, One X (Wired)
   • Xbox Series X|S Wireless Controller (Wired)
   • Xbox One Elite Series 1 & Series 2 (Wired)
   • Compatible 3rd-party XInput / GIP gamepads (PowerA, Razer, PDP, etc.)

2. Nintendo Switch Family:

   • Nintendo Switch Pro Controller (Official, with HD Rumble)
   • Joy-Con (L) & Joy-Con (R) via official Charging Grip
   • Nintendo Switch Online Classic Controllers (NES, SNES, N64, Genesis)
   • 3rd-party Switch wired controllers (PDP Faceoff, PowerA Wired, Horipad)

3. Sony PlayStation Family:

   • Sony PlayStation 3 (DualShock 3 / Sixaxis official, with initialization handshake)
   • (DualSense PS5 is temporarily disabled)

4. Google Stadia:

   • Google Stadia Controller (Wired)

5. Generic HID / DirectInput Controllers:

   • 8BitDo Ultimate 2 Wireless, Ultimate 2.4G, Ultimate 2C, SN30 Pro
   • GameSir G7, G3s, G4s, T1s, T2a
   • LanShen X1Pro, Xiaomi Mi Controller, Bionik Vulkan, Betop 2585N2
   • Any standard USB HID controller via /data/onefamily/controllers/default.ini or custom VID_PID profiles

---

Installation & Updating

1. Install onefamily_companion.pkg on your PS4 via GoldHEN Package Installer.
2. Launch the OneFamily Companion application.
3. The app will automatically detect your setup, install/update the payload, configure GoldHEN autoboot, and deploy default controller profiles.
4. Plug in any supported controller and enjoy system-wide control and in-game gameplay!

OneFamily v1.1.4

Changes in v1.1.4

DualSense & DualSense Edge Communication Fixes

• Implemented full standard 64-byte USB Output Report (Report ID 0x02) complying with official Sony/Linux specifications, replacing previously truncated 48-byte packets that caused endpoint stalls.
• Configured mandatory hardware valid flag masks (valid_flag0: compatible vibration and haptics select; valid_flag1: lightbar and player indicator control).
• Added visual connection confirmation: DualSense now illuminates solid PlayStation Blue on the lightbar and activates the Player 1 center dot LED upon connection, taking the controller out of passive charging mode.
• Implemented dual-channel wake-up handshake: output reports are sent via Interrupt OUT, with automatic fallback to USB Control Transfer (SET_REPORT) if interrupt pipe communication fails.
• Implemented automatic input endpoint fallback: polls primary endpoint 0x84, and gracefully falls back to endpoint 0x81 if no reports are received, ensuring compatibility across all firmware revisions and USB hub topologies.
• Updated rumble packet generation to full 64-byte structures to ensure uninterrupted in-game vibration feedback.

Payload & Companion App Alignment

• Updated daemon and Companion App version numbers to v1.1.4 (01.14).
• Bundled the updated payload inside onefamily_companion.pkg for automatic guided payload synchronization upon launch.

Assets:

• onefamily_companion.pkg: OneFamily Companion App with integrated guided updater and configuration manager.
• onefamily.bin: GoldHEN background daemon payload for manual loading.

OneFamily v1.1.3

Changes in v1.1.3 (Hotfix)

Nintendo Switch Pro Controller Improvements

• Fixed analog stick Y-axis inversion on Nintendo Switch Pro controllers (both left and right sticks now correctly map UP to UP and DOWN to DOWN).
• Aligned raw 12-bit ADC stick data with PlayStation DualShock 4 coordinate space.

Disconnection & Original PS4 Controller Handover Fix

• Fixed an issue where disconnecting a USB controller could freeze or lock out the physical PS4 DualShock 4 controller.
• Improved physical disconnection detection in the USB driver: connection status is now continuously evaluated across all transfer states, including interrupt timeouts.
• On disconnect, the daemon cleanly unregisters and shuts down the Virtual Pad device, immediately releasing session ownership and restoring control to the original PlayStation controller.

Companion App & Daemon Alignment

• Updated daemon and Companion App version numbers to v1.1.3 (01.13).
• Bundled the updated payload inside onefamily_companion.pkg for automatic guided payload synchronization upon launch.

Assets:

• onefamily_companion.pkg: OneFamily Companion App with integrated guided updater and configuration manager.
• onefamily.bin: GoldHEN background daemon payload for manual loading.