Add complete guide and all config variants

2026-02-05 14:06:25 +00:00
parent 239ee0e593
commit b40c76762c
1053 changed files with 167761 additions and 0 deletions
--- a/hackintosh-guide/docs/AcpiSamples/Source/SSDT-RTC0-RANGE.dsl
+++ b/hackintosh-guide/docs/AcpiSamples/Source/SSDT-RTC0-RANGE.dsl
@@ -0,0 +1,105 @@
+/*
+ * On certain motherboards(mainly Asus X299 boards), not all ports are
+ * mapped in the RTC device. For the majority of the time, users will not notice 
+ * this issue though in extreme circumstances macOS may halt in early booting.
+ * Most prominently seen around the PCI Configuration stage with macOS 11 Big Sur.
+ * 
+ * To resolve this, we'll want to create a new RTC device(PNP0B00) with the correct
+ * range.
+ * 
+ * Note that due to AWAC systems having an _STA method already defined, attempting
+ * to set another _STA method in your RTC device will conflict. To resolve this,
+ * SSDT-AWAC should be removed and instead opt for this SSDT instead.
+ */
+DefinitionBlock ("", "SSDT", 2, "ACDT", "RtcRange", 0x00000000)
+{
+    External (_SB_.PC00.LPC0, DeviceObj)
+    External (_SB_.PC00.LPC0.RTC_, DeviceObj)
+
+    Scope (_SB.PC00.LPC0)
+    {
+       /* 
+        * Uncomment below if your ACPI doesn't have an AWAC device(ACPI000E)
+        */
+       /*
+        Scope (RTC)
+        {
+            Method (_STA, 0, NotSerialized)  // _STA: Status
+            {
+                If (_OSI ("Darwin"))
+                {
+                    Return (Zero)
+                }
+                Else
+                {
+                    Return (0x0F)
+                }
+            }
+        }
+        */
+        
+        Device (RTC0)
+        {
+           /*
+            * Change the below _CSR range to match your hardware.
+            *
+            * For this example, we'll use the Asus Strix X299-E Gaming's ACPI, and show how to correct it.
+            * Within the original RTC device, we see that sections 0x70 through 0x77 are mapped:
+            *
+            *    Name (_CRS, ResourceTemplate ()  // _CRS: Current Resource Settings
+            *    {
+            *        IO (Decode16,
+            *            0x0070,             // Range Minimum 1
+            *            0x0070,             // Range Maximum 1
+            *            0x01,               // Alignment 1
+            *            0x02,               // Length 1
+            *           )
+            *        IO (Decode16,
+            *            0x0074,             // Range Minimum 2
+            *            0x0074,             // Range Maximum 2
+            *            0x01,               // Alignment 2
+            *            0x04,               // Length 2
+            *           )
+            *        IRQNoFlags ()
+            *            {8}
+            *    })
+            *
+            * Though Asus seems to have forgotten to map sections 0x72 and 0x73 in the first bank, so
+            * we'll want to expand the range to include them under Length 1.
+            * Note that not all boards will be the same, verify with your ACPI tables for both the range and 
+            * missing regions.
+            */
+            
+            Name (_HID, EisaId ("PNP0B00"))  // _HID: Hardware ID
+            Name (_CRS, ResourceTemplate ()  // _CRS: Current Resource Settings
+            {
+                IO (Decode16,
+                    0x0070,             // Range Minimum 1
+                    0x0070,             // Range Maximum 1
+                    0x01,               // Alignment 1
+                    0x04,               // Length 1      (Expanded to include 0x72 and 0x73)
+                    )
+                IO (Decode16,
+                    0x0074,             // Range Minimum 2
+                    0x0074,             // Range Maximum 2
+                    0x01,               // Alignment 2
+                    0x04,               // Length 2
+                    )
+                IRQNoFlags ()
+                    {8}
+            })
+            Method (_STA, 0, NotSerialized)  // _STA: Status
+            {
+                If (_OSI ("Darwin"))
+                {
+                    Return (0x0F)
+                }
+                Else
+                {
+                    Return (Zero)
+                }
+            }
+        }
+    }
+}
+