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)

atlntq · Cumartesi - 21:28

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)

Önce EFI'nizin yedeğini bir USB belleğe alın.
EFI bölümünü bağlayın.
SSDT'leri EFI/OC/ACPI, kext'i EFI/OC/Kexts içine kopyalayın.
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
Kaydedip yeniden başlatın.

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:

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.
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.
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.
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!

AirLife · Cumartesi - 21:45

Güzel konu ve destek. Başarılar hocam.

Emrecall · Pazar - 00:25

eskiden yabancı forumlar gezerek efi klasörü hazırlardık şimdi geldiğimiz noktaya şaşırıyorum eline sağlık düzenli güncellmesi gelirse tutulması muhtemel uygulama olmuş.

berkan · Pazar - 13:37

Asus vivobook serisi için destek gelecek mi?

atlntq · Dün 09:40 da

berkan' Alıntı:
Asus vivobook serisi için destek gelecek mi?

klavye aydınlatması olan her notebook serisi için çalışması gerekiyor.

darkside · Dün 17:02 da

Emeğine sağlık. İlettiğin kodların geri dönüşünü paylaşıyorum.

atlntq · Dün 20:12 da

darkside' Alıntı:
Emeğine sağlık. İlettiğin kodların geri dönüşünü paylaşıyorum.

Fan tarafı (SSDT-FANM) yüklenmemiş görünüyor, menüde fan modu çıkmıyor olmalı. İki şeyi kontrol eder misiniz:

config.plist → ACPI → Patch içinde _Q58 → XQ58 rename’i var mı ve Enabled = True mu? (Find 5F513538, Replace 58513538, TableSignature DSDT)
ACPI → Add içinde SSDT-KBLT, SSDT-FANM’den önce mi?

bu arada sana gönderdiğim paketten değil de yeni bu başlıktaki kurulum yardımcısı ile dener misin? birkaç düzenleme yapılmıştı. Hatta yardımcının yeni versiyonunu bir saate kadar bitirip güncelleyeğim. Sonucu paylaşırsan sevinirim

darkside · Dün 20:15 da

KBColor kurulum üzerinden ilerledim ve herşey mükemmel çalışıyor şu anda. Turbo tuşu da aktif.

Çok iyi iş çıkartmışsın. Eline sağlık. Denemelere devam edebilirim kontrol edeceğim bir yer varsa.‚ @atlntq

atlntq · Dün 20:46 da

darkside' Alıntı:
KBColor kurulum üzerinden ilerledim ve herşey mükemmel çalışıyor şu anda. Turbo tuşu da aktif.

Çok iyi iş çıkartmışsın. Eline sağlık. Denemelere devam edebilirim kontrol edeceğim bir yer varsa.

@darkside harika, çok teşekkürler! Gerçek bir Acer Predator'da kurulum yardımcısı ile baştan sona çalıştığını görmek çok iyi oldu.

Önceki sorunların sebebi şunlarmış:

Fan: _Q58 → XQ58 rename'i eksik olduğu için SSDT-FANM yüklenmiyordu.
Kaybolan ışık menüsü: Yeni menü uygulaması, eski paketteki kext ve SSDT'lerle menüyü kuramıyordu. Bunu 2.1.1'de düzelttim, artık eski paketlerle de menüler görünüyor.

Vaktin olursa şu noktaları kontrol edebilirsen çok yardımcı olur, çünkü bunlar simülasyonda test edilemiyordu:

Turbo: Turbo tuşuna ya da menüden Turbo'ya geçince fanlar gerçekten sona kadar hızlanıyor mu, Turbo tuşunun ışığı yanıyor mu? Normal'e dönünce yavaşlıyor mu?
Özel %: Fan modu → Özel'de örneğin %40 ve %90 seçince fan hızı (RPM) buna göre değişiyor mu?
Efektler: Özellikle Dalga ve Kayma: çalışıyor mu, yön seçimi doğru mu (sağdan sola / soldan sağa)?
Bölgeler: Klavyenin 4 bölgesine ayrı renk verince doğru bölgeler mi değişiyor?
Yeniden başlatma: Bilgisayarı yeniden başlatınca son seçtiğin renk ve efekt geri geliyor mu?

Bir de KBColor menüsünden Tanılama raporu… seçeneğiyle (config.plist'i de seçerek) bir rapor alıp eklersen, çalışan bir Acer'ın raporu ileride başka kullanıcılara yardım ederken referans olur.

Güncelleme: 2.1.1
Herkes için iki yenilik var:

Tanılama raporu: KBColor menüsünde Tanılama raporu… ya da KBColor Kurulum'un açılış ekranında Tanılama raporu oluştur…. Rapor sistemi, KBColor.kext'i, açılıştaki ACPI hatalarını ve istersen config.plist'i (SSDT sırası, fan tuşu rename'i, kext girdisi, dosyalar EFI'de mi) kontrol ediyor. Sorunu düz Türkçeyle özetleyip masaüstüne tek bir dosya olarak kaydediyor. Sorun bildirirken lütfen bu dosyayı ekleyin. İlk mesajdaki log komutu yerine bunu kullanın, o komut bu iş için yeterli bilgi vermiyordu.
Eski paketlerle (eski kext ya da GCAP'siz SSDT'ler) ışık menüsünün kaybolması düzeltildi.

İndirme: Release KBColor 2.1.1 — menus with older kexts and SSDTs · atlntq/KBColor

darkside · Dün 20:55 da

Turbo: Turbo tuşuna ya da menüden Turbo'ya geçince fanlar gerçekten sona kadar hızlanıyor mu, Turbo tuşunun ışığı yanıyor mu? Normal'e dönünce yavaşlıyor mu? --- Turbo tuşuna basınca fanlar sona kadar hızlanıyor ve turbo ışığı yanıyor. Normale dönünce yavaşlıyor.
Özel %: Fan modu → Özel'de örneğin %40 ve %90 seçince fan hızı (RPM) buna göre değişiyor mu? --- Burası mükemmel çalışıyor seçtiğim yüzdeye göre fan RPM leri değişiyor.
Efektler: Özellikle Dalga ve Kayma: çalışıyor mu, yön seçimi doğru mu (sağdan sola / soldan sağa)? --- Burasıda doğru çalışıyor. Yön seçimleri doğru.
Bölgeler: Klavyenin 4 bölgesine ayrı renk verince doğru bölgeler mi değişiyor? -- Ayrı renklerde seçiliyor. Her bölge farklı renk olabiliyor.
Yeniden başlatma: Bilgisayarı yeniden başlatınca son seçtiğin renk ve efekt geri geliyor mu? - Yeniden başlayınca mevcut ayarlar korunuyor.

Genel olarak testini yaptım. Her şey kusursuz. Biraz önceki güncellemeni de denemelimiyim. @atlntq

Tanılama raporunuda ekledim. Kolay gelsin. @atlntq

atlntq · Dün 21:12 da

darkside' Alıntı:
Turbo: Turbo tuşuna ya da menüden Turbo'ya geçince fanlar gerçekten sona kadar hızlanıyor mu, Turbo tuşunun ışığı yanıyor mu? Normal'e dönünce yavaşlıyor mu? --- Turbo tuşuna basınca fanlar sona kadar hızlanıyor ve turbo ışığı yanıyor. Normale dönünce yavaşlıyor.

Özel %: Fan modu → Özel'de örneğin %40 ve %90 seçince fan hızı (RPM) buna göre değişiyor mu? --- Burası mükemmel çalışıyor seçtiğim yüzdeye göre fan RPM leri değişiyor.

Efektler: Özellikle Dalga ve Kayma: çalışıyor mu, yön seçimi doğru mu (sağdan sola / soldan sağa)? --- Burasıda doğru çalışıyor. Yön seçimleri doğru.

Bölgeler: Klavyenin 4 bölgesine ayrı renk verince doğru bölgeler mi değişiyor? -- Ayrı renklerde seçiliyor. Her bölge farklı renk olabiliyor.

Yeniden başlatma: Bilgisayarı yeniden başlatınca son seçtiğin renk ve efekt geri geliyor mu? - Yeniden başlayınca mevcut ayarlar korunuyor.

Genel olarak testini yaptım. Her şey kusursuz. Biraz önceki güncellemeni de denemelimiyim. @atlntq

Tanılama raporunuda ekledim. Kolay gelsin. @atlntq

Yok güncellemene gerek yok, kurulum yardımcısı için güncellemeler yaptım. uygulama aynı. Güle güle kullan dostum

darkside · Dün 21:15 da

atlntq' Alıntı:
Yok güncellemene gerek yok, kurulum yardımcısı için güncellemeler yaptım. uygulama aynı. Güle güle kullan dostum

Çok iyi iş çıkarttın kardeşim. Bu tip repolarının artması dileğiyle. Her türlü desteğe hazırım her zaman.
Güncelleme Önerisi : Burada sensörleri hazır gösterirken işlemcinin kaç Mhz çalıştığını gösterse ekstra çok güzel olur. Ayrıca Turbo özellikli işlemciler için bir on-off butonu. İsterse turboyu kapatabilir. @atlntq

	Benzer konular	Forum
	Intel Arc B580 ve UHD 770 macOS - Hackintosh, deneysel sürücü	Grafik
B	Hackintosh kasma sorunu	macOS Tahoe
	RTX 3050 Ve üst modeller için Hackintosh mümkün mü? Buyrun cevabını verelim	Hackintosh Soru-Cevap
A	Hackintosh uyumlu toplama bilgisayar	Hackintosh Uyumlu Donanımlar
A	hackintosh kurmak	Hackintosh Soru-Cevap

Ara

Ara

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)

atlntq

APPRENTICE

AirLife

JEDI

Emrecall

PADAVAN

berkan

APPRENTICE

atlntq

APPRENTICE

darkside

JEDI

Ekli dosyalar

atlntq

APPRENTICE

darkside

JEDI

atlntq

APPRENTICE

darkside

JEDI

Ekli dosyalar

atlntq

APPRENTICE

darkside

JEDI

Ekli dosyalar

Benzer konular