开源项目：Universal Force Feedback 驱动教程

1. 项目介绍

Universal Force Feedback（简称Universal PIDFF）是一个为Linux系统设计的通用力反馈驱动程序。该项目主要针对Direct Drive轮基，通过一系列的优化和修补，使得Direct Drive轮基能够在Linux系统中更好地初始化和工作。它解决了原有pidff驱动程序的一些局限性，增加了多个轮基的初始化规则，修正了无限长度效果的bug，以及处理了边界值问题。

2. 项目快速启动

安装方式

AUR 包

对于Arch Linux用户，可以通过AUR包进行安装。维护者@Lawstorant提供了相应的AUR包。

DKMS

DKMS（Dynamic Kernel Module Support）会安装模块到系统中，并在每次更新内核时自动更新模块。这是大多数发行版的推荐安装方式。

1. 从发行版的包管理器安装dkms包。
2. 将仓库克隆到/usr/src/universal-pidff。
3. 使用sudo dkms install /usr/src/universal-pidff安装模块。
4. 使用sudo update-initramfs -u更新initramfs。
5. 重启系统。

手动安装

适用于调试目的，需要频繁更改代码库或分支。

1. 从发行版的包管理器安装linux-headers-$(uname -r)和build-essential包。
2. 将仓库克隆到任意位置并进入该目录。
3. 运行make命令。可以选择使用make debug启用调试日志。
4. 使用sudo insmod hid-universal-pidff.ko加载模块。
5. 使用sudo rmmod hid_universal_pidff卸载模块。

Steam Deck自动安装

1. 设置密码（如果之前没有设置）：

   passwd deck
   

2. 运行安装脚本：

   sudo sh -c "
   $(curl -fsSL https://raw.githubusercontent.com/JacKeTUs/universal-pidff/main/scripts/steam-deck-install.sh)
   "
   

Steam Deck手动安装

1. 设置密码（如果之前没有设置）：

   passwd deck
   

2. 禁用只读状态：

   sudo steamos-readonly disable
   

3. 初始化并填充密钥环：

   sudo pacman-key --init
   sudo pacman-key --populate archlinux
   sudo pacman-key --populate holo
   

4. 安装必要的软件包：

   linux=$(pacman -Qsq linux-neptune | tail -n 1)
   sudo pacman -Syu --noconfirm base-devel fakeroot glibc git $linux $linux-headers linux-api-headers
   

5. 下载AUR包并解压：

   wget https://aur.archlinux.org/cgit/aur.git/snapshot/universal-pidff-dkms-git.tar.gz
   tar -xf universal-pidff-dkms-git.tar.gz
   

6. 安装驱动：

   cd universal-pidff-dkms-git
   makepkg -scri --noconfirm
   

7. 重启并享受！

3. 应用案例和最佳实践

• 确保在安装驱动前已经安装了所有必要的依赖。
• 在Steam Deck上安装时，确保已经设置了密码并按照指示操作。

4. 典型生态项目

• Universal PIDFF驱动程序与多种Direct Drive轮基兼容，包括MOZA、Cammus、VRS DirectForce Pro等。
• 支持所有设备描述符中的FFB效果和所有输入（轮轴、按钮）。

请注意，该项目的使用和安装可能需要一些技术知识，建议在执行前充分了解相关内容。