Araçlar KBColor: Hackintosh dizüstüler için klavye ışığı ve fan kontrolü, ACPI dökümünden SSDT hazırlayan kurulum yardımcısıyla (ASUS TUF / Acer Predator)

Merhaba arkadaşlar,

Oyun dizüstülerinde macOS altında genelde iki şey eksik kalıyor: klavye ışığının rengi/parlaklığı ve fan modu (Sessiz / Normal / Turbo). Bunun için önce kendi ASUS TUF FX506LU'ma bir menü çubuğu uygulaması yazmıştım. Bir arkadaşın Acer Predator'una uyarlarken her model için SSDT'leri elle hazırlamanın ne kadar zahmetli olduğunu gördüm. Bu yüzden işi otomatikleştiren bir kurulum yardımcısı hazırladım.

Uygulama hâlâ geliştirme aşamasında. Yaşadığınız sorunları ve sonuçları lütfen bu konunun altına yazın. Uygulama gelen geri bildirimlere göre geliştirilecek ve yeni modeller eklenecek.

Neler yapıyor?

KBColor Kurulum (kurulum yardımcısı):

• ACPI dökümünüzün olduğu klasörü seçiyorsunuz.
• Dizüstünüzü tanıyor ve gerekli yolları (WMI metotları, EC alanları, fan tuşu olayı vb.) dökümden kendisi buluyor.
• SSDT'leri hazırlayıp derliyor. config.plist için gereken rename'lerin Find/Replace değerlerini sizin DSDT'nizden hesaplıyor.
• Hazırladığı her şeyi sizin tablolarınızla acpiexec içinde, macOS'taki gibi çalıştırıp test ediyor. Hata veren tablo size verilmiyor.
• Sonunda EFI'nize yapmanız gerekenleri adım adım anlatan bir README.html hazırlıyor.
• EFI'nize kendisi hiçbir şey yazmıyor. Değişiklikleri siz yapıyorsunuz.

KBColor (menü çubuğu uygulaması):

• Klavye rengi: tüm klavye ya da (destekleyen modellerde) 4 bölge ayrı ayrı
• Efektler (Acer): Sabit, Nefes, Neon, Dalga, Kayma, Zoom; hız ve yön
• Parlaklık kaydırıcısı
• Fan modu: ASUS'ta Sessiz / Normal / Turbo, Acer'da Normal / Turbo / Özel %
• Fn+F5 (ASUS) ya da Turbo tuşu (Acer) ile mod değiştirme, ekranda bildirim
• Sıcaklığa göre otomatik fan modu
• CPU sıcaklığı, güç tüketimi, pil ve fan devri (RPM) göstergeleri

Desteklenen modeller

• Acer Predator / Nitro (PredatorSense WMI kullanan modeller). Predator Helios 300 PH315-52 dökümüyle test edildi.
• ASUS TUF (FX506 ailesi EC düzeni). FX506LU üzerinde kullanılıyor.
• Farklı EC düzenine sahip ASUS TUF'lar: aşağıda anlatılan "Windows ile keşif" yöntemiyle.

Modeliniz tanınmazsa DSDT ve SSDT dosyalarınızı bu konuya ekleyin, profil eklemeye çalışırım.

İndirme
KBColor Kurulum (son sürüm): KBColor-Kurulum-2.0.0.zip dosyasını indirmeniz yeterli, kext ve uygulama içinde.
Kaynak kod: GitHub - atlntq/KBColor: Keyboard light and fan control for hackintosh laptops, with a setup assistant that builds the SSDTs from your ACPI dump (Acer Predator/Nitro, ASUS TUF)

Kurulum adım adım

1. Yamasız ACPI dökümünü alın
Aşağıdaki yollardan biri yeterli:

• OpenCore: config.plist → Misc → Debug → SysReport = True yapın ve bir kez açılış yapın. Dökümü EFI bölümündeki SysReport/ACPI klasöründe bulursunuz. İşiniz bitince SysReport'u tekrar False yapın.
• Windows veya Linux: SSDTTime → "Dump the current system's ACPI tables"
• Linux: sudo acpidump -b

Önemli: Kendi yamaladığınız bir DSDT değil, orijinal tablolar olmalı.

2. KBColor Kurulum'u açın
Zip'i açıp uygulamayı çalıştırın. Uygulama imzasız olduğu için macOS ilk açılışta engeller. Sistem Ayarları → Gizlilik ve Güvenlik bölümünde en alttaki KBColor satırında Yine de Aç'a basıp onaylayın (bir kez yeterli). Sequoia'da sağ tık → Aç artık işe yaramıyor.

3. Döküm klasörünü seçin
Döküm klasörünü seç ve hazırla düğmesine basıp .aml dosyalarının olduğu klasörü seçin. Uygulama neleri bulduğunu ✓ / ! / ✗ işaretleriyle gösterir ve masaüstüne (isterseniz başka bir klasöre) bir paket kaydeder:

• EFI/OC/ACPI/: SSDT-KBLT.aml, SSDT-FANM.aml
• EFI/OC/Kexts/KBColor.kext
• KBColor.app
• config-ekle.plist: config.plist'e eklenecek girdiler
• README.html: sizin bilgisayarınıza özel kurulum adımları ve test sonuçları

4. EFI'yi güncelleyin (README.html'deki adımlar)

1. Önce EFI'nizin yedeğini bir USB belleğe alın.
2. EFI bölümünü bağlayın.
3. SSDT'leri EFI/OC/ACPI, kext'i EFI/OC/Kexts içine kopyalayın.
4. ProperTree ile config.plist'i açın:
   • ACPI → Add: önce SSDT-KBLT, sonra SSDT-FANM (sıra önemli; OC Snapshot alfabetik dizdiği için sırayı sonradan kontrol edin)
   • ACPI → Patch: README'deki rename (Find/Replace değerleri sizin DSDT'nize göre hesaplanmış olarak yazıyor)
   • Kernel → Add: KBColor.kext
5. Kaydedip yeniden başlatın.
6. Terminal'de kontrol edin:
   
   Kod:

   ioreg -l -w0 -c KBColor | grep -E '"(Capabilities|FanMode|CPUFanRPM|Effect|Brightness|Color)"'

   Satırlar görünüyorsa SSDT'ler ve kext çalışıyor.

5. Menü çubuğu uygulamasını kurun
Paketteki KBColor.app'i Uygulamalar klasörüne atıp açın (2. adımdaki "Yine de Aç" onayı burada da gerekiyor). Menü çubuğunda CPU sıcaklığı görünür, menü oradan açılır. "Açılışta başlat" seçeneğini işaretlemeyi unutmayın.

Windows ile keşif (adresleri dökümde olmayan modeller)
Bazı modellerde klavye renginin ve parlaklığının EC'de hangi adreste tutulduğu ACPI tablolarında yazmıyor. Bu durumda kurulum yardımcısı keşif moduna geçiyor:

1. Geçici bir "sonda" paketi hazırlanıyor (SSDT-KBCP + kext). Bunu README-kesif.html'deki adımlarla EFI'ye kurup yeniden başlatıyorsunuz.
2. Uygulama 4 adımda yol gösteriyor: Windows'ta (Armoury Crate vb.) klavyeyi kırmızı / yeşil / mavi yapıyor, parlaklığı değiştiriyorsunuz. Her adımdan sonra macOS'a dönüp Görüntü al'a basıyorsunuz. Uygulama yeniden başlatmalar arasında kaldığı yerden devam ediyor.
3. Uygulama görüntüleri karşılaştırıp aday adresleri buluyor ve bunları klavyede canlı deniyor ("ışık söndü mü?", "klavye mora döndü mü?"). Her denemeden sonra eski değer geri yazılıyor.
4. Siz onayladıktan sonra son paket hazırlanıyor. README'de sondayı EFI'den kaldırma adımı da yer alıyor.

Geliştirme durumu ve geri bildirim
Uygulama hâlâ geliştiriliyor. Henüz gerçek donanımda doğrulanmayan kısımlar:

• Keşif modunun canlı kısmı (sonda, görüntü alma ve test yazma)
• Acer'da fan modu ve Turbo LED'i: bu çağrılar BIOS'un SMI işleyicisinden geçtiği için simülasyonda test edilemiyor.

Bir sorun yaşarsanız ya da denediyseniz, lütfen bu konunun altına şunları yazın:

• Dizüstü modeli, macOS ve OpenCore sürümü
• Kurulum yardımcısının gösterdiği sonuç (✓ / ! / ✗ satırları) ya da README.html'deki "Doğrulama" tablosu
• Sorun kurulumdan sonraysa şu iki komutun çıktısı:
  
  Kod:

  ioreg -l -w0 -c KBColor

  Kod:

  log show --last 5m --predicate 'sender == "KBColor" OR eventMessage CONTAINS "ACPI"' | tail -50

• Modeliniz tanınmadıysa ACPI dökümünüz (DSDT ve SSDT dosyaları, zip olarak)

Uygulama gelen geri bildirimlere göre düzeltilecek ve yeni modeller eklenecek. Şimdiden teşekkürler!