Skip to content

i2c-i801 driver port for macOS X + ELAN SMBus macOS X driver for Thinkpad T480s, L380, P52

License

Notifications You must be signed in to change notification settings

VoodooSMBus/VoodooSMBus

Repository files navigation

What is VoodooSMBus? Actions Status

VoodooSMBus solves two related problems:

  1. VoodooSMBus is a project that provides a kernel extension (driver) for macOS that adds support for the SMBus capabilities of Intel I/O Controller Hubs (ICH), also called i801 SMBus.
  2. VoodooSMBus also contains a slave device driver for the ELAN Touchpad device found on the SMBus of some Thinkpad models (T480s, L380, P52) making it possible to use multitouch gestures efficiently.

This project is heavily inspired by https://github.com/alexandred/VoodooI2C and a complete reimplementation of the ideas in https://github.com/gokula/ELANSMBus. Multitouch support is made possible by the implementation VoodooI2C.

VoodooSMBus ports the i2c-i8011 driver and the elan_i2c_smbus2 from linux to macOS.

In the future we might want to split up the project, similar as it has been done in VoodooI2C, into a controller kext and kexts for the slave device drivers.

Installation

Configuration

Some settings can be configured in the Configuration dictionary in Info.plist:

  • DisableWhileTyping Enable disable while typing functionality. After a key press the touchpad is deactivated for a certain amount of time, specified by
  • DisableWhileTypingTimeoutMs The amount of time in milliseconds that touch input is ignored after typing
  • DisableWhileTrackpoint Disables the touchpad when the trackpoint is in use.
  • DisableWhileTrackpointTimeoutMs The amount of time in milliseconds that touch input is ignored after trackpoint usage
  • IgnoreSetTouchpadStatus Ignores messages from the keyboard driver to disable the touchpad. If not ignored, the touchpad can usually be toggled with the PrtSc key.

Current Status

Currently the following Intel I/O Controller Hubs are supported and tested:

Name Id Device
Sunrise Point-LP (PCH) pci8086,9d23 Thinkpad T480s, L380
Cannon Lake-H (PCH) pci8086,a323 Thinkpad P52

It should be trivial to add support for all controllers listed in 1.

Trackpoint support is implemented, make sure to activate the trackpoint in BIOS.

For a list of planned features, see https://github.com/leo-labs/VoodooSMBus/labels/enhancement

Supported Gestures

For supported gestures please see https://voodooi2c.github.io/#Supported%20Gestures/Supported%20Gestures

Acknowledgements

Thanks to:

Footnotes

1: https://github.com/torvalds/linux/blob/master/drivers/i2c/busses/i2c-i801.c

2: https://github.com/torvalds/linux/blob/master/drivers/input/mouse/elan_i2c_smbus.c