Skip to content

FH-DualSense-Enhanced R3

Choose a tag to compare

@github-actions github-actions released this 15 Jul 15:14
· 82 commits to main since this release

Enhanced R3 中文说明

Enhanced R3 在 Enhanced R2 的动态扳机基础上加入按踏板状态路由的抓地力反馈:只踩刹车进入 L2,只踩油门进入 R2 扳机键,同时踩下时进入 R2 扳机键,L2 的 ABS 仍可独立介入。铺装、积水、泥土和碎石继续使用不同的材质频带。

R2 扳机键红线与握把红线现在拥有独立开关。默认关闭 R2 扳机键红线、开启握把红线;握把侧默认在左握把输出带 1.5 信号增益的断油脉冲。碰撞握把反馈加入方向包络;可选握把换挡冲击默认关闭,并使用独立的强度和持续时间普通设置。

USB 与 Bluetooth 现在共用同一套左右 PCM 波形。USB 继续使用手柄四声道音频端点;Bluetooth 通过 HID report 0x36 直接发送 3 kHz 双声道 HD haptics,保留路面纹理、发动机频率、红线波形和碰撞方向。如果当前连接拒绝 HD haptics,程序会自动回退到 compatible rumble,扳机不受影响。

游戏内原生振动可以保留菜单和过场反馈,但可能掩盖本项目的左右碰撞方向。验证方向或排查重复振动时,请关闭游戏内振动进行比较。本项目目前不会接管或完整复现游戏原生振动。

Enhanced R3 基于 Forza-Horizon-DualSense-Python 1.6.2,参考 HorizonHaptics 1.3.0,并使用 vDS 0.3.0-rc7 作为 Bluetooth HD haptics 协议参考。项目从 Enhanced R2 起使用独立 R 版本体系;历史 Enhanced R1 使用 1.6.2.post1。

Enhanced R3 highlights

Enhanced R3 routes dynamic traction feedback by pedal state while preserving the GT7-style L2 ABS wall, material-specific frequency bands, asymmetric EWMA smoothing, hysteresis, low-speed wheel rotation, and G-force damping introduced in Enhanced R2.

R2-trigger redline and grip redline now have independent switches. Trigger redline is off by default; grip redline is on by default on the left grip with a 1.5 signal gain. Directional collision haptics use a priority envelope. The optional grip gear-shift thump is off by default with independent normal settings for strength and duration.

USB and Bluetooth now share the same stereo PCM waveform renderer. USB uses the controller's four-channel audio endpoint; Bluetooth sends 3 kHz stereo HD haptics directly through HID report 0x36, preserving road texture, engine frequency, redline waveform, and collision direction. If the current connection rejects HD haptics, the app falls back to compatible rumble without interrupting adaptive triggers. The Bluetooth protocol implementation references vDS 0.3.0-rc7.

Recommended: launcher scripts

Download win_start.bat on Windows or linux_start.sh on Linux and run it. The launcher downloads the ZUV application bundle, and the Windows launcher installs uv when needed. uv then provisions the managed Python runtime. The published ZUV checks this fork's releases for updates.

If the automatic download is unreliable, use the manual ZUV fallback: download FH-DualSense-Enhanced.zuv.py from this Release, place it beside the launcher, and run the launcher again.

Standalone binaries

FH-DualSense-Enhanced-R3.exe for Windows contains Python and all application dependencies. It can be downloaded and run by itself without BAT, ZUV, uv, or a system Python installation. It does not self-update.

FH-DualSense-Enhanced-R3 is the standalone Linux build. It is built on Ubuntu, so older or substantially different distributions may need the ZUV launcher instead.

Required setup

Enable Steam Input and DualSense vibration, then enable Forza Horizon Data Out at 127.0.0.1:5300. Start FH-DualSense-Enhanced before launching the game. If no UDP packets arrive, allow the application and UDP 5300 through the firewall. Disable the firewall only for a short diagnostic comparison and turn it back on immediately. Disable in-game vibration when validating this project's directional collision output.


Heads up

  • A manually downloaded ZUV can be kept next to the launcher script. The launcher copies it into its managed app folder.
  • Settings live in data/user_preferences.json next to the launcher and survive updates.
  • Linux: the launcher does not install system udev rules. If HID access is denied, download 70-dualsense.rules, copy it to /etc/udev/rules.d/, reload the rules, and reconnect the controller.
  • Prerelease channel: run uv run FH-DualSense-Enhanced.zuv.py --prerelease to track rolling test builds.

Full Changelog: R2...R3