Luminadevapps Posted February 11 Share Posted February 11 (edited) SSDT Maintenance — SSDT Generator + macOS-Support Suite for Hackintosh Free · Open Source (MIT) · by Lumina Dev Apps WHAT IT IS SSDT Maintenance is a native macOS app that generates clean, OpenCore-ready SSDTs and compiles them to .aml locally with iasl — no manual DSL editing. On top of the usual device SSDTs, it includes a full set of macOS-support "maintenance" tables (AWAC, PMC, USBX, EC, SBUS-MCHC and more) that most Alder Lake / Raptor Lake (Z690 / Z790) builds need to boot and stay stable. You pick your ACPI paths and hardware, tick the tables you want, hit Generate ALL SSDTs, and drop the resulting .aml files into EFI/OC/ACPI/. WHAT IT GENERATES Device SSDTs: - SSDT-PLUG — CPU power management, auto-sized to core count - SSDT-DTPG — DTGP helper method - SSDT-HDEF — onboard audio (layout-id injection) - SSDT-IGPU — Intel iGPU (Alder/Raptor Lake, headless) - SSDT-GPU — discrete GPU + HDAU (AMD RDNA2 / Vega) - SSDT-LAN — Aquantia AQC107 / Realtek / Intel I225-I226 - SSDT-WIFI — Intel (itlwm) / Broadcom - SSDT-TB3 — Thunderbolt (Titan Ridge / Maple Ridge) - SSDT-XHCI — USB port maps (15 / 20 / 25 / 30 / Type-C) - SSDT-SATA / SSDT-NVME — storage controllers Maintenance SSDTs (macOS support) — on by default: AWAC, PMC, USBX, EC, SBUS-MCHC. Optional: PNLF, GPRW, RHUB, ALS0, BRG0. - SSDT-AWAC — system clock fix (RTC/AWAC), required on Z690/Z790 - SSDT-PMC — native NVRAM for 300-series and newer - SSDT-USBX — USB sleep/wake power properties - SSDT-EC — fake Embedded Controller - SSDT-SBUS-MCHC — SMBus + Memory Controller Hub - SSDT-PNLF — backlight (iGPU display) - SSDT-GPRW — instant-wake-from-sleep fix - SSDT-RHUB — USB root-hub reset - SSDT-ALS0 — fake ambient light sensor - SSDT-BRG0 — PCI bridge _ADR template (advanced) REQUIREMENTS - macOS 13.0 or later - iasl (the ACPI compiler): brew install acpica HOW TO USE IT 1. Install iasl: brew install acpica 2. Open the app. In the Generator tab, set the ACPI paths for your board. Defaults target the _SB.PC00 layout (Alder/Raptor Lake). Always confirm these against your own disassembled DSDT — if your PCI root is PCI0, or your iGPU is GFX0 instead of IGPU, adjust accordingly. 3. Choose your hardware presets (iGPU, dGPU, LAN, Wi-Fi, TB, USB, SATA, NVMe) and set your audio layout-id. 4. Scroll to Maintenance (macOS Support) and enable the tables you need. The essential five are on by default. 5. Click Output Folder (bottom bar), pick a destination, then Generate ALL SSDTs. Use Show Log / Copy Log to check the iasl output — every table should report 0 Errors. 6. Copy the generated .aml files into EFI/OC/ACPI/ and add each under config.plist → ACPI → Add (ProperTree "Snapshot" does this automatically). REQUIRED ACPI RENAMES Add these under config.plist → ACPI → Patch (Base empty, Count 0): SSDT-EC — only if your board's real EC device is named "EC": Comment : Rename EC to EC0 Find : 45435F5F Replace : 45433000 SSDT-GPRW — required for the instant-wake fix: Comment : Rename _GPRW to XGPW Find : 5F47505257 Replace : 58475057 RECOMMENDED SET For most Z790 builds, install AWAC + PMC + USBX + EC + SBUS-MCHC (add PNLF / ALS0 if wanted). Only add GPRW / RHUB with their renames/edits, and treat BRG0 as a template — edit its path and _ADR before using it. Generating all ten is fine; only deploy the ones your build actually needs. Note: injected SSDTs change how macOS sees your PCI tree. Verify device paths against your own DSDT and test before relying on them. Use at your own risk. DOWNLOAD - Release (DMG): https://github.com/luminadevapps/SSDTMaintenance/releases/tag/v1.1.0 - Source: https://github.com/luminadevapps/SSDTMaintenance First launch: the app is currently unsigned, so macOS Gatekeeper will block it the first time. Right-click the app and choose Open (once), or run: xattr -dr com.apple.quarantine /Applications/SSDTMaintenance.app FEEDBACK Bug reports, board-specific path issues, and suggestions are welcome — reply here or open an issue on GitHub. Mentioning your motherboard model + macOS version helps others too. SSDT Maintenance v1.1.0 · © 2026 Lumina Dev Apps · MIT License Edited 12 hours ago by nmano 6 Link to comment https://www.insanelymac.com/forum/topic/362355-ssdtmaintenance/ Share on other sites More sharing options...
verdazil Posted February 11 Share Posted February 11 (edited) Hi! Attached is the SSDT-XHUB-Real Table I actually used (and it works perfectly), as well as the Table generated by the app. How would you comment on the differences? The first PC in the signature SSDT-XHCI-App.aml SSDT-XHUB-Real.aml Edited February 11 by verdazil 2 Link to comment https://www.insanelymac.com/forum/topic/362355-ssdtmaintenance/#findComment-2847265 Share on other sites More sharing options...
Luminadevapps Posted February 11 Author Share Posted February 11 (edited) 📢 Help Improve SSDT Maintenance – Share Your Working SSDTs Hello everyone 👋 If you are using SSDT Maintenance App and everything is working perfectly on your system, I would really appreciate your help 🙏 I am improving the next version and need real-world working SSDT examples from different hardware setups.Thanks @verdazil ✅ If Your System Is Working 100% Please post the following: 🖥 Hardware Details Motherboard: BIOS Version: CPU: GPU: Audio Codec: Ethernet: WiFi / Bluetooth: Thunderbolt (if any): Storage Type (NVMe/SATA): Your working SSDT .dsl files (if available) Your working SSDT .aml files Edited February 11 by nmano 1 Link to comment https://www.insanelymac.com/forum/topic/362355-ssdtmaintenance/#findComment-2847273 Share on other sites More sharing options...
Max.1974 Posted February 11 Share Posted February 11 (edited) Hi my friend @nmano this ACPI Table is from GA Z790 Elite AX, and is working all... ACPI Table GA Aorus Elite AX (rev. 1.0) BIOS F15 CPU i9-13900K Raptor Lake GPU GA AMD Aorus RX 6900 XT (rev. 2.0) Audio Codec: Realtek ALC897 - 0x10ec0897 Ethernet: Realtek® 2.5GbE LAN chip (2.5 Gbps/1 Gbps/100 Mbps) Intel® Wi-Fi 6E AX211 BLUETOOTH 5.3 Pcie WI-Fi Broadcom BCM64360CD BLUETOOTH 4.0 Storage Nvme / Sata / HDD https://www.gigabyte.com/Motherboard/Z790-AORUS-ELITE-AX-rev-10/sp https://github.com/maxpicelli/EFI-Clover-5165-Aorus-Z790-Elite-AX-Aorus-RX-6900-XT/releases/tag/v5163 Sorry I will extract with your app ACPI Nmano.zip Z790 Edited February 11 by Max.1974 1 Link to comment https://www.insanelymac.com/forum/topic/362355-ssdtmaintenance/#findComment-2847277 Share on other sites More sharing options...
Luminadevapps Posted February 12 Author Share Posted February 12 (edited) 13 hours ago, Max.1974 said: Hi my friend @nmano this ACPI Table is from GA Z790 Elite AX, and is working all... ACPI Table GA Aorus Elite AX (rev. 1.0) BIOS F15 CPU i9-13900K Raptor Lake GPU GA AMD Aorus RX 6900 XT (rev. 2.0) Audio Codec: Realtek ALC897 - 0x10ec0897 Ethernet: Realtek® 2.5GbE LAN chip (2.5 Gbps/1 Gbps/100 Mbps) Intel® Wi-Fi 6E AX211 BLUETOOTH 5.3 Pcie WI-Fi Broadcom BCM64360CD BLUETOOTH 4.0 Storage Nvme / Sata / HDD https://www.gigabyte.com/Motherboard/Z790-AORUS-ELITE-AX-rev-10/sp https://github.com/maxpicelli/EFI-Clover-5165-Aorus-Z790-Elite-AX-Aorus-RX-6900-XT/releases/tag/v5163 Sorry I will extract with your app ACPI Nmano.zip Z790 Thanks My friend. I checked your files missing SSDT.aml Try to install iasl curl -LO https://github.com/acidanthera/MaciASL/raw/master/Dist/iasl-stable chmod +x iasl-stable sudo mv iasl-stable /usr/local/bin/iasl iasl -v Verify If Install: Edited February 12 by nmano 1 Link to comment https://www.insanelymac.com/forum/topic/362355-ssdtmaintenance/#findComment-2847306 Share on other sites More sharing options...
Max.1974 Posted February 12 Share Posted February 12 Thanks @nmano my friend. Here are the ACPIs extracted using your app. I had to manually create the /usr/local/bin directory on Tahoe. ACPI Nmano.zip 1 Link to comment https://www.insanelymac.com/forum/topic/362355-ssdtmaintenance/#findComment-2847317 Share on other sites More sharing options...
Luminadevapps Posted 21 hours ago Author Share Posted 21 hours ago (edited) SSDT Maintenance — SSDT Generator + macOS-Support Suite for Hackintosh Free · Open Source (MIT) · by Lumina Dev Apps WHAT IT IS SSDT Maintenance is a native macOS app that generates clean, OpenCore-ready SSDTs and compiles them to .aml locally with iasl — no manual DSL editing. On top of the usual device SSDTs, it includes a full set of macOS-support "maintenance" tables (AWAC, PMC, USBX, EC, SBUS-MCHC and more) that most Alder Lake / Raptor Lake (Z690 / Z790) builds need to boot and stay stable. You pick your ACPI paths and hardware, tick the tables you want, hit Generate ALL SSDTs, and drop the resulting .aml files into EFI/OC/ACPI/. WHAT IT GENERATES Device SSDTs: - SSDT-PLUG — CPU power management, auto-sized to core count - SSDT-DTPG — DTGP helper method - SSDT-HDEF — onboard audio (layout-id injection) - SSDT-IGPU — Intel iGPU (Alder/Raptor Lake, headless) - SSDT-GPU — discrete GPU + HDAU (AMD RDNA2 / Vega) - SSDT-LAN — Aquantia AQC107 / Realtek / Intel I225-I226 - SSDT-WIFI — Intel (itlwm) / Broadcom - SSDT-TB3 — Thunderbolt (Titan Ridge / Maple Ridge) - SSDT-XHCI — USB port maps (15 / 20 / 25 / 30 / Type-C) - SSDT-SATA / SSDT-NVME — storage controllers Maintenance SSDTs (macOS support) — on by default: AWAC, PMC, USBX, EC, SBUS-MCHC. Optional: PNLF, GPRW, RHUB, ALS0, BRG0. - SSDT-AWAC — system clock fix (RTC/AWAC), required on Z690/Z790 - SSDT-PMC — native NVRAM for 300-series and newer - SSDT-USBX — USB sleep/wake power properties - SSDT-EC — fake Embedded Controller - SSDT-SBUS-MCHC — SMBus + Memory Controller Hub - SSDT-PNLF — backlight (iGPU display) - SSDT-GPRW — instant-wake-from-sleep fix - SSDT-RHUB — USB root-hub reset - SSDT-ALS0 — fake ambient light sensor - SSDT-BRG0 — PCI bridge _ADR template (advanced) REQUIREMENTS - macOS 13.0 or later - iasl (the ACPI compiler): brew install acpica HOW TO USE IT 1. Install iasl: brew install acpica 2. Open the app. In the Generator tab, set the ACPI paths for your board. Defaults target the _SB.PC00 layout (Alder/Raptor Lake). Always confirm these against your own disassembled DSDT — if your PCI root is PCI0, or your iGPU is GFX0 instead of IGPU, adjust accordingly. 3. Choose your hardware presets (iGPU, dGPU, LAN, Wi-Fi, TB, USB, SATA, NVMe) and set your audio layout-id. 4. Scroll to Maintenance (macOS Support) and enable the tables you need. The essential five are on by default. 5. Click Output Folder (bottom bar), pick a destination, then Generate ALL SSDTs. Use Show Log / Copy Log to check the iasl output — every table should report 0 Errors. 6. Copy the generated .aml files into EFI/OC/ACPI/ and add each under config.plist → ACPI → Add (ProperTree "Snapshot" does this automatically). REQUIRED ACPI RENAMES Add these under config.plist → ACPI → Patch (Base empty, Count 0): SSDT-EC — only if your board's real EC device is named "EC": Comment : Rename EC to EC0 Find : 45435F5F Replace : 45433000 SSDT-GPRW — required for the instant-wake fix: Comment : Rename _GPRW to XGPW Find : 5F47505257 Replace : 58475057 RECOMMENDED SET For most Z790 builds, install AWAC + PMC + USBX + EC + SBUS-MCHC (add PNLF / ALS0 if wanted). Only add GPRW / RHUB with their renames/edits, and treat BRG0 as a template — edit its path and _ADR before using it. Generating all ten is fine; only deploy the ones your build actually needs. Note: injected SSDTs change how macOS sees your PCI tree. Verify device paths against your own DSDT and test before relying on them. Use at your own risk. DOWNLOAD - Release (DMG): https://github.com/luminadevapps/SSDTMaintenance/releases/tag/v1.1.0 - Source: https://github.com/luminadevapps/SSDTMaintenance First launch: the app is currently unsigned, so macOS Gatekeeper will block it the first time. Right-click the app and choose Open (once), or run: xattr -dr com.apple.quarantine /Applications/SSDTMaintenance.app FEEDBACK Bug reports, board-specific path issues, and suggestions are welcome — reply here or open an issue on GitHub. Mentioning your motherboard model + macOS version helps others too. SSDT Maintenance v1.1.0 · © 2026 Lumina Dev Apps · MIT License Edited 12 hours ago by nmano Link to comment https://www.insanelymac.com/forum/topic/362355-ssdtmaintenance/#findComment-2852021 Share on other sites More sharing options...
Recommended Posts