What is VoodooI2C?
VoodooI2C is a project consisting of macOS kernel extensions that add support for I2C bus devices. The project is split into two main components: the
core extension and various other
satellite extensions.
The Core
The core is the VoodooI2C.kext kernel extension. This kext is intended to be installed by anyone whose computer requires some form of I2C support. It consists of I2C controller drivers and is responsible for publishing device nubs to the IOService plane.
The Satellites
The satellites are a collection of various kernel extensions that implement support for a specific type of I2C device. An example of a satellite kext is VoodooI2CHID.kext which adds support for I2C-HID devices. Usually a user will install one satellite kext per class of I2C device.
Current Status
The following Intel I2C controllers are fully supported:
- INT33C2 and INT33C3 - Haswell era
- INT3432 and INT3433 - Broadwell era
- pci8086,9d60, pci8086,9d61, pci8086,9d62 and pci8086,9d63 - Skylake era
- pci8086,a160, pci8086,a161, pci8086,a162 and pci8086,a163 - Kaby Lake era
- pci8086,9de8, pci8086,9de9, pci8086,9dea and pci8086,9deb - Cannon Lake/Whiskey Lake era
- pci8086,a368, pci8086,a369, pci8086,a36a and pci8086,a36b - Coffee Lake era
- pci8086,2e8, pci8086,2e9, pci8086,2ea, pci8086,2eb, pci8086,6e8, pci8086,6e9, pci8086,6ea and pci8086,6eb- Comet Lake era
- pci8086,34e8, pci8086,34e9, pci8086,34ea and pci8086,34eb - Ice Lake era
The following device classes are fully supported:
- I2C-HID devices
- ELAN devices
- FTE devices
Note that there is sometimes an overlap between device classes. For example, some ELAN devices may also be I2C-HID devices.
Changelog v2.7
Since the last release there have been 13 commit(s). The descriptions for the first (at most) 10 of these are as follows
- 2.7 build of VoodooI2C and related projects (#491)
- Support secondary button (#445)
- Display interrupt type in IOReg (#493)
- VoodooI2CControllerNub: Release object when values not found in ACPI table (#483)
- Don't rely on defaults defined in VoodooI2CControllerBusConfig (#482)
- Add missing trailing newlines in logs (#480)
- Fix documented boot arg for force-polling (#479)
- Use bus timing defaults where necessary (#473)
- Revert "Fixing Images in GPIO Pinning docs. (#452)" (#477)
- Change resource parser from reference to pointer (#472)
VoodooI2CHID
- Minor memory leak fixes
- USB input support
Thank you
@1Revenger1 for work with VoodooI2CHID and
@LeeBinder and
@naveenkrdy for testing this build.
Compatibility
Please check the
compatibility page on the VoodooI2C wiki to find out if your device is compatible. If it is not on the list but you still suspect VoodooI2C may work for you, contact us on our
Gitter page.
Documentation and Troubleshooting
Please visit the
documentation site for further information how to install and troubleshoot VoodooI2C.
License
This program is protected by the GPL license. Please refer to the LICENSE.txt file for more information
Contributing
We are looking for competent C++, OS X kernel, Linux kernel, I2C, HID etc developers to help improve this project! Here are the guidelines for contributing:
- Fork this repository and clone to your local machine
- Create a new feature branch and add commits
- Push your feature branch to your fork
- Submit a pull request upstream
