Skip to content

Releases

IntelBTUnified 1.0.1

Choose a tag to compare

@laguillo laguillo released this 12 Nov 20:14

Fixes bluetoothd crash-looping, which shows up as Bluetooth turning itself off and on and devices failing to connect.

Fix

  • The bluetoothd/BlueTool patches are written into the file's page cache. On macOS 26 those binaries are APFS-compressed on the sealed system volume in 64 KB chunks whose hash is checked on every pagein. When a patched page stayed in memory while a neighbouring page of the same chunk was evicted (more likely under memory pressure), the pagein failed (compressed data hash mismatch), bluetoothd died with SIGBUS and launchd restarted it over and over. Upstream BlueToolFixup works the same way and has the same problem.
  • The kext now hooks vnode_pagein and evicts the chunk's patched pages before the pagein. They are re-read and re-patched the next time they are used.
  • New boot-arg -ibtnoevict turns this off, for diagnosis only.

Downloads

  • IntelBTUnified-1.0.1-AX210.zip: AX210/AX211 firmware only (≈0.6 MB).
  • IntelBTUnified-1.0.1-full.zip: every firmware (≈11 MB).

Status

  • Tested on an Intel AX210 (8087:0032) with macOS 26.7.3 (Tahoe) and Lilu 1.7.3: no more bluetoothd crashes, and headphones connect. The failing pagein that used to crash bluetoothd was reproduced before the fix and no longer fails with it.
  • Everything else is as in 1.0.0: the other chips and macOS 12 – 25 are untested, and the kext is unsigned. Keep the previous kext so you can roll back.

Upgrading

Replace EFI/OC/Kexts/IntelBTUnified.kext with the one from the zip and reboot. config.plist does not change. Check with kextstat | grep IntelBTUnified that version 1.0.1 is loaded.

IntelBTUnified 1.0.0

Choose a tag to compare

@laguillo laguillo released this 20 Oct 13:24

First release: a single kext (Lilu plugin + firmware driver) that replaces IntelBluetoothFirmware, IntelBTPatcher and BlueToolFixup on macOS 12 or later.

Downloads

  • IntelBTUnified-1.0.0-AX210.zip: AX210/AX211 firmware only (≈0.6 MB).
  • IntelBTUnified-1.0.0-full.zip: every firmware (≈11 MB).

Status

  • Tested only on an Intel AX210 (8087:0032) with macOS 26.7 (Tahoe) and Lilu 1.7.3: it loads the firmware, connects and plays A2DP audio.
  • Untested: the other chips, macOS 12 – 25 and BLE devices.
  • It has not been possible to confirm in the kernel log that the HCI patch is hooked.
  • The kext is unsigned. Use it at your own risk and keep the original kexts so you can roll back.

Installation

Copy IntelBTUnified.kext to EFI/OC/Kexts/, remove the three old kexts from config.plist and add this one after Lilu. Details and boot-args in the README (also available in Spanish).