How macintelk/intelbtunified works
IntelBTUnified is a macOS kernel extension combining an Intel Bluetooth firmware driver with a Lilu plugin that patches HCI requests and macOS Bluetooth components. The principal path is USB-device matching, controller setup, generation-specific firmware loading, then Bluetooth operation; the plugin provides separate compatibility patches. The README documents plugin behavior and packaging capabilities, while sampled driver excerpts show USB transport and generation-specific firmware logic. Several driver dispatch and lifecycle details were not sampled, so those links are left unverified.
Main entry points: IntelBluetoothFirmware.cpp Device driver · BtIntel.cpp Intel HCI core · IntelBTUnified.cpp Lilu plugin · IntelBluetoothOpsGen2.cpp Gen2 operations
Components 16
Lilu compatibility plugin
- Lilu plugin
src/IntelBTUnified.cpp - HCI patch
src/IntelBTUnified.cpp - BlueTool patches
src/IntelBTUnified.cpp
Firmware driver
- Device driver
src/driver/IntelBluetoothFirmware.cpp - USB transport
src/driver/USBDeviceController.cpp
Intel protocol operations
- Intel HCI core
src/driver/BtIntel.cpp - Gen1 operations
src/driver/IntelBluetoothOpsGen1.cpp - Gen2 operations
src/driver/IntelBluetoothOpsGen2.cpp - Gen3 operations
src/driver/IntelBluetoothOpsGen3.cpp - Vendor commands
src/driver/BtIntelVSC.cpp - Firmware requests
src/driver/BtIntelFw.cpp
Firmware resources
- Supported devices
devices.txt - Firmware files
fw
Other components
- macOS Bluetooth
- Lilu
- Intel USB controller
Connections 20
- macOS Bluetooth → Lilu plugin: loads plugin
README.md - Lilu → Lilu plugin: hosts plugin
README.md - Lilu plugin → HCI patch: applies
README.md - Lilu plugin → BlueTool patches: applies
README.md - Intel USB controller → Device driver: matches device
README.md - Device driver → USB transport: initializes
- Intel HCI core → USB transport: sends HCI
src/driver/BtIntel.cpp - Device driver → Intel HCI core: selects operations
- Device driver → Gen1 operations: dispatches
README.md - Device driver → Gen2 operations: dispatches
README.md - Device driver → Gen3 operations: dispatches
README.md - Gen1 operations → Firmware requests: requests firmware
src/driver/BtIntelFw.cpp - Gen2 operations → Firmware requests: requests firmware
- Gen3 operations → Firmware requests: requests firmware
- Firmware requests → Firmware files: loads resources
README.md - Supported devices → Device driver: defines support
README.md - Gen1 operations → Intel HCI core: uses HCI core
- Gen2 operations → Intel HCI core: uses HCI core
- Gen3 operations → Gen2 operations: extends operations
- Vendor commands → Intel HCI core: uses controller core