Synaptic 触控板驱动: VoodooRMI
概述
笔记本触控板一般有三种连接方式:
- I2C 连接
- SMBus 连接
- PS2 连接
VoodooRMI 主要应用于通过 SMBus 和 I2C 连接的触控板,源码基于 Linux 版 Synaptic RMI 驱动程序。
⚠️ 注意:根据触控板功能选择 I2C 或 SMBus,不可同时使用两种通道。
驱动特性
- Force Touch 模拟(按压触控板时增加手指压力反馈)
- 三指和四指手势支持
- PS2 Passthrough 上的轨迹点功能
- 兼容 SMBus 或 I2C 连接的触控板
兼容性
SMBus
macOS
- 需 VoodooPS2 ≥ 2.2.0
- 在 IORegistryExplorer 中验证:
ApplePS2SynapticsTrackpad → Intertouch Support = True
- 在系统日志中检测:
VoodooPS2Trackpad: Trackpad supports SMBus operation
(需sudo dmesg
)
Windows
在设备管理器中检查:
- Synaptics SMBus 设备
I2C
macOS
- 需 VoodooI2C ≥ 2.5
- 在 IORegistry 中验证:
VoodooI2CHIDDevice
的 HIDDescriptor 包含VendorID 0x6cb
或- 父设备名包含
SYN
/SYNA
Windows
在设备管理器中:
- 检查 "HID 兼容的触摸板"
- 属性中确认:
- General → Location 显示 "I2C HID Device"
- Details → Hardware IDs 包含
VID_06CB
(或SYN
/SYNA
)
版本需求
SMBus
- VoodooPS2 ≥ 2.2.0(建议 ≥ 2.2.5,最好是最新版本,适用于 HP Elitebook 等多路复用 PS2 控制器设备)
I2C
- VoodooI2C ≥ 2.5
- 按文档确认是否需要 GPIO pinning
- 轮询模式可正常工作
VoodooSMBus 说明
VoodooRMI 已包含 VoodooSMBus。若需自建,请从 VoodooSMBus git repo 的 Dev
分支构建。
安装指南
必需 Kexts(添加至引导加载程序 Clover/OpenCore)
通用组件
VoodooRMI.kext
VoodooRMI.kext/Contents/PlugIns/VoodooInput.kext
SMBus 触控板
VoodooSMBus.kext
VoodooRMI.kext/Contents/PlugIns/RMISMBus.kext
I2C 触控板
VoodooI2C.kext
VoodooRMI.kext/Contents/PlugIns/RMII2C.kext
VoodooPS2 配置
启用组件
- [x] VoodooPS2Controller.kext
- [x] VoodooPS2Mouse.kext
- [x] VoodooPS2Keyboard.kext
- [x] VoodooPS2Trackpad.kext
禁用组件
- [ ] VoodooInput.kext
⚠️ 如果不走 I2C 或者 SMBUS 通道的话,这个 voodooInput 也是需要勾选的,这里是用的 PS2 里插件的 VoodooInput。
OpenCore 用户注意事项
在 config.plist
中按此顺序加载 Kexts:
VoodooInput.kext
VoodooRMI.kext
实际操作截图
强烈建议
❌ 不要 将 Kexts 安装到以下系统目录:
/Library/Extensions
(L/E)/System/Library/Extensions
(S/L/E)
资源和最后建议
驱动名称 | 说明 | 源项目下载地址 |
---|---|---|
VoodooI2C.kext | I2C触摸板/屏 驱动 | https://github.com/VoodooI2C/VoodooI2C/releases |
VoodooPS2Controller.kext | PS2键盘/鼠标/触摸板 驱动,最常用 | https://github.com/acidanthera/VoodooPS2/releases |
VoodooInput.kext | 提供Magic TrackPad 2触控模拟 | https://github.com/acidanthera/VoodooInput/releases |
VoodooSMBus.kext | 提供SMBus支持 | https://github.com/VoodooSMBus/VoodooSMBus/releases |
VoodooRMI.kext | Synaptic 触摸板/小红点驱动 | https://github.com/VoodooSMBus/VoodooRMI/releases |
上述各驱动在使用时,通常需要将其 plugin 中的kext 也启用,如上图 ps2controller 除了主 kext 勾选外,还勾选了插件中的键盘,鼠标,触控板,
如果全部使用 ps2controller,则还应当勾选其中的 voodooinput 插件。
对于示例,使用的 synatics 触控板,因此额外勾选 Voodoosmbus 和 voodooRMI 驱动和相应插件,具体见图。